Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
docs: say how to rename a non-credential key the storage shelf refuses
garrytan34dedc921b23
diff --git a/docs/guides/write-refusals.md b/docs/guides/write-refusals.mdindex ae91c8cebf..5b871f2654 100644--- a/docs/guides/write-refusals.md+++ b/docs/guides/write-refusals.md@@ -1123,7 +1123,7 @@ An adopt or import apply whose plan changed since its preview refuses `preview_c|---|---|---|| `storage_source_managed` | `put_page`, `remember` or another page writer targeted the shelf. | Register with `gbrain storage-register`, change with `gbrain storage-update`. || `storage_record_invalid` | A card field is missing or malformed, names a command (`command`, `script`, `exec` and similar), or is one gbrain sets itself (`registered_by`, `origin`). On adopt, reason `access_unpreservable` means an interim page's `readable_by` and the folder rules over it share no reader, and `access_pending` that a rule over it is still being applied, so no card could carry the same restriction; on import, `labels` means a line's `labels` holds something other than access labels; `remote_written` means a remote (MCP) client last wrote the interim page, so adopt never registers it (check it and use `gbrain storage-register`). `storage_get` refuses it too for a stored card that breaks these rules, such as a hand-edited card file. | Fix the field the message names. Restore runs through `restore.skill` and `restore.args`. For `access_pending`, finish the rule change (`gbrain access status`) and preview again; for `access_unpreservable`, give the page readers its folder rules also list. For a stored card, `gbrain doctor --only storage_manifest` lists the invalid cards, and the refusal carries the card's revision for `gbrain storage-update <id> --expected-revision <rev> --patch '<json>'`. |-| `storage_record_secret` | A field looks like a secret or has a credential shape: an environment assignment, a credential-named variable, a URL password or a signed-URL parameter. The value is not echoed. | Remove it; the restore skill reads credentials from its own environment. |+| `storage_record_secret` | A field looks like a secret or has a credential shape: an environment assignment, a credential-named variable, a URL password, a signed-URL parameter, or a value under a credential-named key such as `password` or `token_value`. The value is not echoed. | Remove it; the restore skill reads credentials from its own environment. A key that holds no credential can be renamed to end in `_id`, `_ref`, `_name`, `_path`, `_file`, `_env`, `_var` or `_variable`. || `storage_card_exists` | A card with that id is already registered. | Update it with the revision `storage_get` returns, or use another id. || `storage_revision_conflict` | The card changed since its revision was read; `detail` holds the current revision. | Read it again, apply the change, update once. || `storage_manifest_missing` | No shelf yet on a brain with a Git checkout, or the `storage` source ID belongs to another source. | Preview `gbrain storage init --dir <path> --dry-run` and apply it after the user agrees (it needs managed persistence). |