Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
docs: url-clone-fences apply does not import a held HEAD (#7897)
garrytan76a25dea5f71
diff --git a/docs/architecture/system-of-record.md b/docs/architecture/system-of-record.mdindex bdf09741aa..067bca3fae 100644--- a/docs/architecture/system-of-record.md+++ b/docs/architecture/system-of-record.md@@ -308,7 +308,7 @@ or a physical projection that leaves attribution untouched):- `src/core/repair/stale-atoms.ts` (1): the retirement stamp. On managed brains it runs in the `managed_maintenance_retire_stale_atoms` request's apply; on unmanaged brains the retirement is an approved atom generation (`publishGeneration`, one `maintenanceTransaction`) and the stamp runs in its `onRetired` callback inside that transaction.- `src/core/repair/take-supersession.ts` (1): `gbrain repair take-supersession` reprojection: a receipted `managed_maintenance_take_reproject` request on managed brains, `maintenanceTransaction` on unmanaged ones; fence edits go through a revision-bound `put_page`.- `src/core/repair/timeline-comments.ts` (1): `gbrain repair timeline-comments` row cleanup: `withCoordinatedWrite` under the page key on managed brains, `maintenanceTransaction` otherwise.-- `src/core/repair/url-clone-fences.ts` (2): `gbrain repair url-clone-fences` (#6946), unmanaged brains only (a managed brain previews nothing); keeping the appended fence rows database-only (clearing `row_num`, inserting a row the database lost) runs in one `maintenanceTransaction` under the page lock after the preview recheck; HEAD's bytes then import through `importFromContent`.+- `src/core/repair/url-clone-fences.ts` (2): `gbrain repair url-clone-fences` (#6946), unmanaged brains only (a managed brain previews nothing); keeping the appended fence rows database-only (clearing `row_num`, inserting a row the database lost) runs in one `maintenanceTransaction` under the page lock after the preview recheck; HEAD's bytes then import through `importFromContent` (a HEAD that asks for private in a spelling page privacy does not read is held: not imported, and the apply reports `held`, #7897).- `src/core/repair/visibility.ts` (1): `gbrain repair visibility --apply` tightening of database-only world facts from a private source: a receipted `managed_maintenance_tighten_fact_visibility` request on managed brains, `maintenanceTransaction` on unmanaged ones; fenced rows change through a revision-bound `put_page`.- `src/core/schema-pack/page-to-alias.ts` (1): the page-to-alias conversion soft-deletes each converted page in `maintenanceTransaction`.- `src/core/schema-pack/page-to-link.ts` (1): the page-to-link conversion soft-deletes each converted page in `maintenanceTransaction`.diff --git a/docs/guides/repair.md b/docs/guides/repair.mdindex 2b2a89808e..ab7c8e22f8 100644--- a/docs/guides/repair.md+++ b/docs/guides/repair.md@@ -2312,7 +2312,7 @@ HEAD so the clone can pull the upstream fix, but does not import HEAD, reportsholds the file until upstream fixes it (#7897). Each restored file is first backed up under`~/.gbrain/backups/url-clone-fences/`. Its rows stay active and recallable asdatabase-only facts, HEAD's bytes are imported as the page (as sync would-import them), and only then is the file restored; each step is idempotent, so+import them, except for a held file above), and only then is the file restored; each step is idempotent, soa stopped run previews the same file again. A file that changed since the previewreports `changed_since_preview` and is kept. The hash is bound to the `--source`selection, each source's incarnation and clone root, and each file's page: an