Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
Docs: dream runs now leave a read-only mirror's checkout alone
garrytan953bf07d87f1
diff --git a/behavior-changes.d/mirror_read_only_legacy_writers_7098.md b/behavior-changes.d/mirror_read_only_legacy_writers_7098.mdindex 0f87bae509..4fc759b384 100644--- a/behavior-changes.d/mirror_read_only_legacy_writers_7098.md+++ b/behavior-changes.d/mirror_read_only_legacy_writers_7098.md@@ -1 +1 @@-On a brain without managed persistence, a source marked `gbrain sources mirror-readonly` is now left untouched by the legacy disk writers below (#7098): `sync --full` no longer re-exports never-committed database pages into its checkout, `brainstorm --save`, page write-through, timeline entries and fact fences keep the write in the database (write-through and timeline report `skipped: mirror_read_only`), `forget` expires a fenced fact in the database without rewriting the file, and the extract cycle neither fences its database-only facts into the file nor counts them in its legacy-row guard. An owner trust repair (`gbrain repair provenance`, `trust backfill`) lists such a page `needs_review` with detail `mirror_read_only` instead of rewriting its file. The dream cycle's reverse-written synthesis, patterns and cycle-summary pages are not gated yet. Before, only managed publication honored the flag, so these writers gave the mirror local changes that could stop its `git pull --ff-only`.+On a brain without managed persistence, a source marked `gbrain sources mirror-readonly` is now left untouched by the legacy disk writers below (#7098): `sync --full` no longer re-exports never-committed database pages into its checkout, `brainstorm --save`, page write-through, timeline entries and fact fences keep the write in the database (write-through and timeline report `skipped: mirror_read_only`), `forget` expires a fenced fact in the database without rewriting the file, and the extract cycle neither fences its database-only facts into the file nor counts them in its legacy-row guard. An owner trust repair (`gbrain repair provenance`, `trust backfill`) lists such a page `needs_review` with detail `mirror_read_only` instead of rewriting its file. The dream cycle leaves such a checkout alone too: its reverse-written synthesis, patterns and cycle-summary pages stay in the database (#8935). Before, only managed publication honored the flag, so these writers gave the mirror local changes that could stop its `git pull --ff-only`.diff --git a/docs/guides/multi-source-brains.md b/docs/guides/multi-source-brains.mdindex e8891fa1f2..ddd6ccffa5 100644--- a/docs/guides/multi-source-brains.md+++ b/docs/guides/multi-source-brains.md@@ -491,7 +491,9 @@ write-through (`sync --full` re-exports, `brainstorm --save`), fact fences,timeline entries, `forget`, the extract cycle's fence pass and owner trustrepairs leave the checkout untouched and keep the write in the database (atrust repair is listed `needs_review` instead), reporting `mirror_read_only`-(#7098). The dream cycle's reverse-written pages are not gated yet.+(#7098). The dream cycle leaves such a checkout alone too: its synthesis,+patterns and cycle-summary pages stay in the database, retired pages' files+are kept, and no fallback file is written under `.sources/` inside it (#8935).A managed brain never pulls inside a cycle. Advance a managed checkout withone command on its owner host: