Skip to content

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.md
index 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.md
index 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 trust
repairs leave the checkout untouched and keep the write in the database (a
trust 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 with
one command on its owner host: