CAT-C10, CAT-V1: the modules' readmes say the rename, the retirement and retire

Claude-Session: https://claude.ai/code/session_01JG73KJNrH5EgFXMKKYSrig
This commit is contained in:
2026-11-04 11:59:46 +01:00
parent 553cf50da7
commit e1a182bf09
2 changed files with 29 additions and 0 deletions
+20
View File
@@ -56,6 +56,26 @@ value as a set does, keeps who approved it beside the value (`approved`), and as
warrant in its hand-act log. A Decline, an expiry or the router's refusal sets nothing. `action` `proposals` lists
them, newest first; with `proposal`, one read whole, with whether the router's ask is the one composed from it.
## A value renamed, a value no longer read (design 32, novox/hq ADR 0609)
- A declaration's `renamed-from` moves the value set under the old name to the new one on each node, with its trust (it
moves whole, and a trusted new name over a value set without the Approve is refused), saying `renamed`
(module, from, to, at) once. A **rename window** opens per node and keeps the old name answering the new value in
`mesh-config_resolved` until that node's node-engine runs a build that reads the new name: judged at start, on the
status view's `delivered`, and for a returning node-engine on the node-engine seat's `manifest-reads-changed` after
`manifest-reads` answers (one that does not serve it states nothing, and its window stays open). State `renames`.
- The seat verb `renames` answers the open renames and the nodes holding each open (the checker asks it); the tools
`config_renames` (all, with the closed windows), `config_rename_again` (move by hand after a refusal) and
`config_rename_close` (drop a node by hand, a hand act).
- On the indexer's `manifest-accepted` it asks the indexer's `indexer_config_readers`; an indexer that does not serve
it answers "not known" and nothing retires. A value (or secret) nobody reads is **retiring** once no node runs a
build that reads it: `retiring` is said and the operator is asked once; the value is removed only on the Approve
(a secret through the seat mesh-vault's `retire`, with a hand act naming node, module, name and ask), `retired`
said per node. State `retiring`; the tool `config_retiring` lists, asks again and cancels.
- Findings (state `findings`, read by the condition keeper): `rename-refused`, `rename-window-held` and
`retirement-held` (seven days, naming the node), `retiring-unanswered` (asked twice).
- The events `renamed`, `retiring` and `retired` are carried by the stream `config-events`, kept seven days.
## Files it does not know
Each directory or archive this module declares says how it treats a file it did not write (ADR 0422, ADR 0416).