Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
v0.60.571.0 chore(release): restamp onto master v0.60.570.0
garrytan39437e03b78d
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.jsonindex b3840513fc..3e2fe7a2cd 100644--- a/.claude-plugin/plugin.json+++ b/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "gbrain",- "version": "0.60.570.0",+ "version": "0.60.571.0","description": "Personal knowledge brain for your coding agent — hybrid search, synthesis, graph traversal, and durable cross-session memory over Postgres/PGLite with pgvector, plus a curated brain-first skill set.","author": {"name": "Garry Tan",diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.jsonindex 4aec8c47a6..8d9c0feb8f 100644--- a/.codex-plugin/plugin.json+++ b/.codex-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "gbrain",- "version": "0.60.570.0",+ "version": "0.60.571.0","description": "Personal knowledge brain for your coding agent — hybrid search, synthesis, graph traversal, and durable cross-session memory over Postgres/PGLite with pgvector, plus a curated brain-first skill set.","author": {"name": "Garry Tan",diff --git a/BOOTSTRAP_FOR_AGENTS.md b/BOOTSTRAP_FOR_AGENTS.mdindex a36de8c802..596774dd87 100644--- a/BOOTSTRAP_FOR_AGENTS.md+++ b/BOOTSTRAP_FOR_AGENTS.md@@ -1,4 +1,4 @@-<!-- gbrain-runbook-stamp: 0.60.570.0 -->+<!-- gbrain-runbook-stamp: 0.60.571.0 --><!-- This stamp must equal the VERSION file at every release; CI enforces it(scripts/check-bootstrap-tag.sh). `gbrain bootstrap status` compares it tothe installed binary and warns on skew. -->diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 450cdf261f..050fec55d6 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -10,7 +10,7 @@ credits are retained; no result has been reassigned to another provider. Originaidentifiers and attribution are available in the pre-removal Git revision`6040075c6cb95be5881cc2e1b76ef7d71f4e5d29` (retained on 2026-09-23).-## [Unreleased]+## [0.60.571.0] - 2026-11-04**Memory train (GBRA-286): `forget` edits the page files first, pasted documents ingest into pages and facts, `recall` can weigh how far a fact deserves belief, page versions carry a human reason and can be read by date, and agents can read and switch the saving rule. Every new mode is off by default, and every feature works on a brain with no Git repository.**diff --git a/VERSION b/VERSIONindex 98ceaea3bd..144516378b 100644--- a/VERSION+++ b/VERSION@@ -1 +1 @@-0.60.570.0+0.60.571.0diff --git a/openclaw.plugin.json b/openclaw.plugin.jsonindex c7193993c6..575e0fc920 100644--- a/openclaw.plugin.json+++ b/openclaw.plugin.json@@ -1,7 +1,7 @@{"id": "gbrain-context-engine","name": "gbrain",- "version": "0.60.570.0",+ "version": "0.60.571.0","description": "Personal knowledge brain with Postgres + pgvector hybrid search","family": "bundle-plugin","kind": "context-engine",diff --git a/package.json b/package.jsonindex ba00bcab6d..f4fb31e004 100644--- a/package.json+++ b/package.json@@ -249,7 +249,7 @@"bun": ">=1.4.4"},"license": "MIT",- "version": "0.60.570.0",+ "version": "0.60.571.0","overrides": {"@ai-sdk/provider-utils": "4.0.56","@hono/node-server": "^2.0.5",diff --git a/plugin-variants/gbrain-coding/.claude-plugin/plugin.json b/plugin-variants/gbrain-coding/.claude-plugin/plugin.jsonindex 67a83c26a8..ab3f98c6f2 100644--- a/plugin-variants/gbrain-coding/.claude-plugin/plugin.json+++ b/plugin-variants/gbrain-coding/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "gbrain-coding",- "version": "0.60.570.0",+ "version": "0.60.571.0","description": "Brain-first coding agent working inside a repo: retrieval, routing, ingest discipline, correction hygiene. Default persona for the claude-code harness bridge; also published as the gbrain-coding marketplace variant. (persona variant of the gbrain plugin — 21 skills)","author": {"name": "Garry Tan",diff --git a/plugin-variants/gbrain-coding/.codex-plugin/plugin.json b/plugin-variants/gbrain-coding/.codex-plugin/plugin.jsonindex 89f8034df5..2543d9cf6d 100644--- a/plugin-variants/gbrain-coding/.codex-plugin/plugin.json+++ b/plugin-variants/gbrain-coding/.codex-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "gbrain-coding",- "version": "0.60.570.0",+ "version": "0.60.571.0","description": "Brain-first coding agent working inside a repo: retrieval, routing, ingest discipline, correction hygiene. Default persona for the claude-code harness bridge; also published as the gbrain-coding marketplace variant. (persona variant of the gbrain plugin — 21 skills)","author": {"name": "Garry Tan",diff --git a/plugin-variants/gbrain-coding/README.md b/plugin-variants/gbrain-coding/README.mdindex 32baf983e7..d6ac839d86 100644--- a/plugin-variants/gbrain-coding/README.md+++ b/plugin-variants/gbrain-coding/README.md@@ -1,4 +1,4 @@-<!-- gbrain-plugin-tree-stamp: 0.60.570.0 -->+<!-- gbrain-plugin-tree-stamp: 0.60.571.0 --># gbrain-coding (generated persona variant — do not hand-edit)Brain-first coding agent working inside a repo: retrieval, routing, ingest discipline, correction hygiene. Default persona for the claude-code harness bridge; also published as the gbrain-coding marketplace variant.diff --git a/plugin-variants/gbrain-daily/.claude-plugin/plugin.json b/plugin-variants/gbrain-daily/.claude-plugin/plugin.jsonindex f3c83cf459..885b19f9c5 100644--- a/plugin-variants/gbrain-daily/.claude-plugin/plugin.json+++ b/plugin-variants/gbrain-daily/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "gbrain-daily",- "version": "0.60.570.0",+ "version": "0.60.571.0","description": "Personal knowledge-brain daily use: meetings, tasks, briefings, reading, research. Published as the gbrain-daily marketplace variant. (persona variant of the gbrain plugin — 20 skills)","author": {"name": "Garry Tan",diff --git a/plugin-variants/gbrain-daily/.codex-plugin/plugin.json b/plugin-variants/gbrain-daily/.codex-plugin/plugin.jsonindex 047b12b16d..2048e5c01e 100644--- a/plugin-variants/gbrain-daily/.codex-plugin/plugin.json+++ b/plugin-variants/gbrain-daily/.codex-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "gbrain-daily",- "version": "0.60.570.0",+ "version": "0.60.571.0","description": "Personal knowledge-brain daily use: meetings, tasks, briefings, reading, research. Published as the gbrain-daily marketplace variant. (persona variant of the gbrain plugin — 20 skills)","author": {"name": "Garry Tan",diff --git a/plugin-variants/gbrain-daily/README.md b/plugin-variants/gbrain-daily/README.mdindex 223ebd3d9e..ec57f57e90 100644--- a/plugin-variants/gbrain-daily/README.md+++ b/plugin-variants/gbrain-daily/README.md@@ -1,4 +1,4 @@-<!-- gbrain-plugin-tree-stamp: 0.60.570.0 -->+<!-- gbrain-plugin-tree-stamp: 0.60.571.0 --># gbrain-daily (generated persona variant — do not hand-edit)Personal knowledge-brain daily use: meetings, tasks, briefings, reading, research. Published as the gbrain-daily marketplace variant.diff --git a/plugin/README.md b/plugin/README.mdindex def6fadbc5..2cab8dae87 100644--- a/plugin/README.md+++ b/plugin/README.md@@ -1,4 +1,4 @@-<!-- gbrain-plugin-tree-stamp: 0.60.570.0 -->+<!-- gbrain-plugin-tree-stamp: 0.60.571.0 --># gbrain plugin skill tree (generated — do not hand-edit)This tree is the curated skill set for the gbrain Codex and Claude Codediff --git a/src/core/behavior-change-notice.ts b/src/core/behavior-change-notice.tsindex a988a7be69..1264859acb 100644--- a/src/core/behavior-change-notice.ts+++ b/src/core/behavior-change-notice.ts@@ -1424,21 +1424,21 @@ export const BEHAVIOR_CHANGES: ReadonlyArray<{ since: string; text: ChangeText;// GBRA-280 (GBEV-30 re-read) get_page window-selector precedence; release:restamp stamps since at the merge slot.{ since: '0.60.570.0', id: 'get_page_selector_precedence_gbra280', text: 'get_page given several window selectors now reads one window instead of refusing with invalid_params: cursor, then around_chunk_id, then lines, then bytes, and a cursor that cannot read the page or an around_chunk_id no longer on it gives way to the next. body full, include_content and content_only beside a selector are set aside, so the read stays a window and never returns the whole page. The response\'s window_selector names what applied and what was ignored; a call with one selector is unchanged.' },// GBRA-190 G4 wave 2 (#7616). `since` is stamped at the merge slot.- { since: '0.60.570.0', text: 'An `extract_facts` run whose empty-fence guard holds a page (a fact row of it is not in the page\'s `## Facts` table yet) is now booked in `gbrain extract status` and doctor `extract_health` as a completed round instead of an `integrity_guard` halt. The guard holds only that page while every other page reconciles, so one held page no longer reads as a facts halt on every cycle; doctor `fence_integrity` still names the held rows (GBRA-190).' },- { since: '0.60.570.0', text: 'Doctor `fence_integrity` now points a legacy fact row that copies a claim its page\'s `## Facts` table already carries (`duplicate_claim`) at the read-only `gbrain repair duplicate-facts --source <id>` preview, which keeps the fence row and supersedes the copy onto it after the user agrees. Before, every unadoptable row got only a report with no command (GBRA-190).' },- { since: '0.60.570.0', text: '`forget` and `forget_fact` now write the page files first: every page whose `## Facts` table carries the claim has its row struck (`~~claim~~`, a `valid_until` date and `forgotten: <reason>`) and all of them publish in one write, one Git commit on a source that commits through gbrain, before the withdrawal commits in the same transaction. Before, the database withdrew the fact at once and a later effect rewrote the files. A forget now waits for the source\'s writer like `remember`: while that writer is unavailable it returns the pending-write receipt and the fact is still recalled until it publishes. The page history gets one change for the withdrawal instead of a second materialization change. Withdrawals queued by an older release still drain (GBRA-190).' },- { since: '0.60.570.0', text: 'A fact remembered without an entity is now a row of the `memory/unattributed` page\'s `## Facts` table (created on first use) instead of a database-only row, so it is in Git, `recall` and search can return that page, and a forget of it strikes the row there. Remembering the same claim with an entity links it and strikes the `memory/unattributed` row in the same write. No placeholder entity page is created (GBRA-190).' },- { since: '0.60.570.0', text: 'A brain rebuilt from Git keeps its withdrawals: a sync or import from the owner\'s checkout, or a local page write, of a struck `## Facts` row with a `valid_until` date and a `forgotten:` context records that withdrawal again (for the page\'s entity, or every entity on `memory/unattributed`), so the claim cannot be remembered again. The same row arriving in a remote page write only imports as an expired row and withdraws nothing; remote callers still withdraw through `forget` (GBRA-190).' },+ { since: '0.60.571.0', text: 'An `extract_facts` run whose empty-fence guard holds a page (a fact row of it is not in the page\'s `## Facts` table yet) is now booked in `gbrain extract status` and doctor `extract_health` as a completed round instead of an `integrity_guard` halt. The guard holds only that page while every other page reconciles, so one held page no longer reads as a facts halt on every cycle; doctor `fence_integrity` still names the held rows (GBRA-190).' },+ { since: '0.60.571.0', text: 'Doctor `fence_integrity` now points a legacy fact row that copies a claim its page\'s `## Facts` table already carries (`duplicate_claim`) at the read-only `gbrain repair duplicate-facts --source <id>` preview, which keeps the fence row and supersedes the copy onto it after the user agrees. Before, every unadoptable row got only a report with no command (GBRA-190).' },+ { since: '0.60.571.0', text: '`forget` and `forget_fact` now write the page files first: every page whose `## Facts` table carries the claim has its row struck (`~~claim~~`, a `valid_until` date and `forgotten: <reason>`) and all of them publish in one write, one Git commit on a source that commits through gbrain, before the withdrawal commits in the same transaction. Before, the database withdrew the fact at once and a later effect rewrote the files. A forget now waits for the source\'s writer like `remember`: while that writer is unavailable it returns the pending-write receipt and the fact is still recalled until it publishes. The page history gets one change for the withdrawal instead of a second materialization change. Withdrawals queued by an older release still drain (GBRA-190).' },+ { since: '0.60.571.0', text: 'A fact remembered without an entity is now a row of the `memory/unattributed` page\'s `## Facts` table (created on first use) instead of a database-only row, so it is in Git, `recall` and search can return that page, and a forget of it strikes the row there. Remembering the same claim with an entity links it and strikes the `memory/unattributed` row in the same write. No placeholder entity page is created (GBRA-190).' },+ { since: '0.60.571.0', text: 'A brain rebuilt from Git keeps its withdrawals: a sync or import from the owner\'s checkout, or a local page write, of a struck `## Facts` row with a `valid_until` date and a `forgotten:` context records that withdrawal again (for the page\'s entity, or every entity on `memory/unattributed`), so the claim cannot be remembered again. The same row arriving in a remote page write only imports as an expired row and withdraws nothing; remote callers still withdraw through `forget` (GBRA-190).' },// GBRA-216 PR B (keyless claim-conflict lane). `since` is stamped at the merge slot.- { since: '0.60.570.0', id: 'recall_decide_contested_gbra216', text: '`recall` now marks a fact `contested` (proposal_ref `dp<id>`, role, fact_id; the CLI prints `(contested by #<id>)`) when it is in a pending `gbrain decide` supersede proposal and both facts are still active, as it already did for trust proposals. The label appears only when the caller can read the other fact (remote callers see world facts only; private provenance and the trust floor apply). If the lookup fails, recall still answers and reports `facts_degraded: {reason: "contested_unavailable"}`.' },- { since: '0.60.570.0', id: 'trust_review_contradictions_gbra216', text: '`gbrain trust review` now lists pending `gbrain decide` proposals whose two facts are both active as kind `contradiction` (`dp<id>`), with supersede, forget, confirm and drop commands and who runs each. `--kind contradiction` filters them, `counts.contradiction` counts them, and `gbrain trust review --accept-all` never decides them: each one appears under `skipped` with reason `contradiction`.' },+ { since: '0.60.571.0', id: 'recall_decide_contested_gbra216', text: '`recall` now marks a fact `contested` (proposal_ref `dp<id>`, role, fact_id; the CLI prints `(contested by #<id>)`) when it is in a pending `gbrain decide` supersede proposal and both facts are still active, as it already did for trust proposals. The label appears only when the caller can read the other fact (remote callers see world facts only; private provenance and the trust floor apply). If the lookup fails, recall still answers and reports `facts_degraded: {reason: "contested_unavailable"}`.' },+ { since: '0.60.571.0', id: 'trust_review_contradictions_gbra216', text: '`gbrain trust review` now lists pending `gbrain decide` proposals whose two facts are both active as kind `contradiction` (`dp<id>`), with supersede, forget, confirm and drop commands and who runs each. `--kind contradiction` filters them, `counts.contradiction` counts them, and `gbrain trust review --accept-all` never decides them: each one appears under `skipped` with reason `contradiction`.' },// GBRA-217 valid time (#7804, GBRA-286 lane D). since is stamped at the merge slot.- { since: '0.60.570.0', id: 'valid_time_plain_read', text: 'A plain get_page (and `gbrain get`) of a page whose own `valid_from` is after today, or whose `valid_until` has passed, now carries an additive `valid_time` block (`status: not_yet_in_force` or `not_in_force`, `as_of` today, both dates); `gbrain get` also prints it on stderr. The page text is returned as before, and a page without those dates reads exactly as before. New: get_page `as_of: YYYY-MM-DD` returns the edition in force on that date (docs/guides/page-history.md#valid-time).' },- { since: '0.60.570.0', id: 'extraction_pending_review_lists', text: '`extraction_pending` (CLI `gbrain extraction-pending`) now also returns `unattributed`: active facts saved without an entity, newest first (world facts only for remote callers), each with the relink action (remember the same claim with `entity` and `replaces`). `pending` and `count` are unchanged; the result adds `include` and `unattributed`. Pass `include` to choose lists, and add `possible_duplicates` to it to list entity pages created in the last 30 days whose name is one edit or one acronym letter away from another entity, for review only (nothing is merged).' },- { since: '0.60.570.0', id: 'extraction_review_page_door', text: '`extraction_review` (CLI `gbrain extraction-review`) promote and reject now write through the page door instead of changing the database row alone: on a source with a repository the decision is committed to Git (promote rewrites the stub\'s file with `status: verified`, reject removes the file), and on a repo-less source the database is the record. Each decision re-reads the page under a source-scoped guard and writes with the revision it read, so a page that changed in between reports `changed` (run the command again), and two decisions on one stub never both land. The result adds `write_requests` (request id and state per written page). A new `distinct` action (`gbrain extraction-review distinct --slugs <new> --of <existing>`, owner-only) records `distinct_from` the same way, and `possible_duplicates` rows carry it.' },- { since: '0.60.570.0', id: 'ingest_starter_listing', text: 'New `ingest` and `ingest_undo` tools (CLI `gbrain ingest`, `gbrain ingest-show`, `gbrain ingest-undo`) are listed on the starter and full MCP surfaces: `ingest` saves a pasted document (source page, proposed pages for new entities, each fact on the entities it names) and returns one report; `ingest_undo` previews, then retracts what one attempt created. Generic page writes are now refused `ingest_namespace_reserved` on ingest report pages (type `ingest-report`, slugs `ingest/<attempt_id>`); other slugs under `ingest/` are unchanged unless `ingest.reserve_namespace` is set. The seven-verb surface is unchanged.' },+ { since: '0.60.571.0', id: 'valid_time_plain_read', text: 'A plain get_page (and `gbrain get`) of a page whose own `valid_from` is after today, or whose `valid_until` has passed, now carries an additive `valid_time` block (`status: not_yet_in_force` or `not_in_force`, `as_of` today, both dates); `gbrain get` also prints it on stderr. The page text is returned as before, and a page without those dates reads exactly as before. New: get_page `as_of: YYYY-MM-DD` returns the edition in force on that date (docs/guides/page-history.md#valid-time).' },+ { since: '0.60.571.0', id: 'extraction_pending_review_lists', text: '`extraction_pending` (CLI `gbrain extraction-pending`) now also returns `unattributed`: active facts saved without an entity, newest first (world facts only for remote callers), each with the relink action (remember the same claim with `entity` and `replaces`). `pending` and `count` are unchanged; the result adds `include` and `unattributed`. Pass `include` to choose lists, and add `possible_duplicates` to it to list entity pages created in the last 30 days whose name is one edit or one acronym letter away from another entity, for review only (nothing is merged).' },+ { since: '0.60.571.0', id: 'extraction_review_page_door', text: '`extraction_review` (CLI `gbrain extraction-review`) promote and reject now write through the page door instead of changing the database row alone: on a source with a repository the decision is committed to Git (promote rewrites the stub\'s file with `status: verified`, reject removes the file), and on a repo-less source the database is the record. Each decision re-reads the page under a source-scoped guard and writes with the revision it read, so a page that changed in between reports `changed` (run the command again), and two decisions on one stub never both land. The result adds `write_requests` (request id and state per written page). A new `distinct` action (`gbrain extraction-review distinct --slugs <new> --of <existing>`, owner-only) records `distinct_from` the same way, and `possible_duplicates` rows carry it.' },+ { since: '0.60.571.0', id: 'ingest_starter_listing', text: 'New `ingest` and `ingest_undo` tools (CLI `gbrain ingest`, `gbrain ingest-show`, `gbrain ingest-undo`) are listed on the starter and full MCP surfaces: `ingest` saves a pasted document (source page, proposed pages for new entities, each fact on the entities it names) and returns one report; `ingest_undo` previews, then retracts what one attempt created. Generic page writes are now refused `ingest_namespace_reserved` on ingest report pages (type `ingest-report`, slugs `ingest/<attempt_id>`); other slugs under `ingest/` are unchanged unless `ingest.reserve_namespace` is set. The seven-verb surface is unchanged.' },// GBRA-219 memory writeback settings over MCP (#7795). since stamped at the merge slot.- { since: '0.60.570.0', id: 'memory_conversation_mode_gbra219', text: 'The starter and full MCP surfaces now include `memory_conversation_mode` (any connection that can call `remember`; it returns the saving rule for the rest of the conversation and stores nothing), and the MCP instructions gain one line after the governing writeback rule telling the agent to call it when the user asks to save everything from here or to stop saving. `get_memory_settings` (read) and `set_memory_writeback` (admin scope, only after `gbrain config set mcp.publish_memory_settings true`, off by default) are new. The new `memory.agent_writeback` key changes only what agents are told; the host capture lanes still follow `memory.auto_writeback`.' },+ { since: '0.60.571.0', id: 'memory_conversation_mode_gbra219', text: 'The starter and full MCP surfaces now include `memory_conversation_mode` (any connection that can call `remember`; it returns the saving rule for the rest of the conversation and stores nothing), and the MCP instructions gain one line after the governing writeback rule telling the agent to call it when the user asks to save everything from here or to stop saving. `get_memory_settings` (read) and `set_memory_writeback` (admin scope, only after `gbrain config set mcp.publish_memory_settings true`, off by default) are new. The new `memory.agent_writeback` key changes only what agents are told; the host capture lanes still follow `memory.auto_writeback`.' },];/** The newest disclosed change's release: the notice id moves only when a release adds rows. */diff --git a/templates/bootstrap/template-repo/README.md b/templates/bootstrap/template-repo/README.mdindex 29fb315995..c6291d00b4 100644--- a/templates/bootstrap/template-repo/README.md+++ b/templates/bootstrap/template-repo/README.md@@ -1,6 +1,6 @@# gbrain agent workspace — template-<!-- gbrain-template-stamp: 0.60.570.0 -->+<!-- gbrain-template-stamp: 0.60.571.0 -->This repository is the **"Use this template"** distribution artifact for a[gbrain](https://github.com/garrytan/gbrain) personal-agent workspace — the same