Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript

chore: keep the reviewed behavior-change text (the CHANGELOG names the new refusals)

garrytan8f9ed1833286
diff --git a/src/core/behavior-change-notice.ts b/src/core/behavior-change-notice.ts
index 3e6ea04faa..1c7e2a614d 100644
--- a/src/core/behavior-change-notice.ts
+++ b/src/core/behavior-change-notice.ts
@@ -1467,7 +1467,7 @@ export const BEHAVIOR_CHANGES: ReadonlyArray<{ since: string; text: ChangeText;
{ since: '0.60.594.0', id: 'refresh_barrier_prb', text: 'New setting `persistence.refresh_barrier` (off by default): with it on, a single page write (`put_page`, `remember` and the other single-page verbs) that reaches a checkout while `gbrain sources refresh` drains or merges it is journaled and answered `pending` at once (MCP `isError: false`, CLI exit 10) instead of refused `worktree_refreshing`. It commits after the refresh, or ends `revision_conflict` when the refresh changed its file, or `refresh_barrier_expired` after `persistence.refresh_barrier_max_wait_ms` (15 minutes). Syncs, jobs and batches keep the refusal. `gbrain upgrade --check-downgrade` exits 3 `downgrade_blocked_deferred_writes` while such writes wait.' },
{ since: '0.60.596.0', id: 'refresh_barrier_import_gst1582', text: 'With `persistence.refresh_barrier` on, no page write bounces because a sync is running: a `put_page`, `capture`, `remember` or `add_timeline_entry` whose page file holds a committed change managed sync has not imported yet is answered `pending` (receipt `deferred: { pending_import: true }`) instead of refused `pending_import`, and is prepared again once the import lands (a `put_page` with `expected_revision` then ends `revision_conflict` if the import moved the page; a blind one lands and names the revision and commit it replaced in `supersedes`, a `gbrain-supersedes:` commit trailer and the commit ledger), or ends `pending_import_expired` once held past the wait limit (a `remember` ends as its `pending_import` refusal did and is replayed after the import). A write during a refresh in `recovery_required` waits too, and `persistence.refresh_barrier_max_deferred` is no longer read: no write past it is refused. With the barrier off those refusals are unchanged. Wherever `worktree_refreshing` still refuses, `retry_after_ms` is estimated from the refresh (its typical duration minus how long it has run, at least 15 s while syncing and 2 s otherwise) instead of a fixed 1000, the message says the write was not saved and when to retry, and the CLI\'s human output ends with one line saying the same.' },
{ since: '0.60.599.0', id: 'source_changed_origin_gst1601', text: 'A page write refused `source_changed` now records its cause in the receipt\'s `error_detail.origin` (`file_database_drift` for an uncoordinated local edit, `canonical_path_occupied`, `raw_file_changed`, `pinned_git_worktree_conflict`, `unsafe_file_target`, `source_binding_changed` or `unbound_source`), not only for `pending_import`, `sync_held` and `canonical_file_missing`, so `gbrain write-request`, doctor and receipt queries name it. Nothing else about the refusal changed, and none of these is replayed.' },
- { since: '0.60.599.0', id: 'adopt_local_edits_gst1601', text: 'New per-source opt-in `persistence.adopt_local_edits.source.<id>` (off by default): a `remember`, `capture` or `add_timeline_entry` whose page file holds a local edit nobody committed, while Git `HEAD` still holds the database\'s copy (on a repo-less brain, any such edit), is no longer refused `file_database_drift`. Once the file has been unchanged for `persistence.adopt_quiet_ms` (default 5000), the owner commits the edit on its own (only that file, subject `gbrain: adopt local edit to <path>`, trailers `gbrain-adopted:` and `gbrain-author: unknown`, a commit-ledger line; repo-less brains record it in the database only), keeps the replaced revision in page history with reason `adopted_local_edit`, then applies the write on top; its receipt names `adopted: { path, blob, replaced_revision }` and doctor `local_edit_adoptions` lists the last 24 h. An edit to the title, the type or a protected frontmatter key, a file that does not import, an edit on both sides, `put_page` and every other verb keep the refusal; a file changed again during the adoption ends `raw_file_changed` with nothing written, and bytes that are not valid UTF-8, a `HEAD` that moved or that Git cannot read, or a cancelled caller adopt nothing.' },
+ { since: '0.60.599.0', id: 'adopt_local_edits_gst1601', text: 'New per-source opt-in `persistence.adopt_local_edits.source.<id>` (off by default): a `remember`, `capture` or `add_timeline_entry` whose page file holds a local edit nobody committed, while Git `HEAD` still holds the database\'s copy (on a repo-less brain, any such edit), is no longer refused `file_database_drift`. Once the file has been unchanged for `persistence.adopt_quiet_ms` (default 5000), the owner commits the edit on its own (only that file, subject `gbrain: adopt local edit to <path>`, trailers `gbrain-adopted:` and `gbrain-author: unknown`, a commit-ledger line; repo-less brains record it in the database only), keeps the replaced revision in page history with reason `adopted_local_edit`, then applies the write on top; its receipt names `adopted: { path, blob, replaced_revision }` and doctor `local_edit_adoptions` lists the last 24 h. An edit to the title, the type or a protected frontmatter key, a file that does not import, an edit on both sides, `put_page` and every other verb keep the refusal; a file changed again during the adoption ends `raw_file_changed` with nothing written.' },
{ since: '0.60.594.0', id: 'commit_push_base_prb', text: '`gbrain git commit-push` takes `--base <path>=<blob>|absent` (repeatable, each path one the command commits): it refuses `commit_base_moved`, committing nothing, when the file at HEAD is no longer the blob the caller read. Without `--base` nothing changes.' },
{ since: '0.60.594.0', id: 'file_drift_held_needs_prefer_8615', text: '`gbrain repair file-drift` with `--held`, `--side`, `--state`, `--cursor` or `--provenance` and no `--prefer` now refuses with the usage line (`invalid_params`, and `file_drift_state_required` for a deleted side without `--state`) instead of silently running the all-drifted survey, which counted a different set of pages (#8615).' },
{ since: '0.60.594.0', id: 'refresh_source_changed_retry_8617', text: 'A `gbrain sources refresh` run refused `refresh_source_changed` because the checkout HEAD moved (a writer committing) or work reached the checkout after the drain check now retries once from a fresh precheck in the same run, so the tick is not lost (#8617). When the retry is refused too, the run returns the first `refresh_source_changed` refusal with the retry\'s cause appended; ownership or source-membership changes are not retried.' },