saphan owner-block-discharge
Writes off a stream's outstanding owner-block debt, with a stated reason, when no run on that stream can ever settle it, typically because the stream is already merged or closed.
Writes off a stream's outstanding owner-block debt, with a stated reason, when no run on that stream can ever settle it, typically because the stream is already merged or closed. An owner block is the structured list of what needs the owner's attention (gates, questions, alerts) that an agent run is expected to return; a run that returned without one leaves a debt that blocks the stream's next dispatch. This is the owner's recorded decision: it never claims the missing block was delivered, any owner-block item still open on the stream is closed as discharged, and the reason stays on the record. It is an owner act: it prints a one-time six-character code on the terminal and waits for it to be typed back, and is refused with no terminal (scripts, CI), inside the console's browser terminal (use the passkey there) and after five wrong codes; the code is asked before the stream is checked. It refuses and writes nothing when the stream still has a live run, when there is nothing to write off, or when --ground or --actor is empty; saphan dry-run owner-block-discharge runs the same check, asks for no code and shows what would be written.
| flag | type | default | what it does |
|---|---|---|---|
--actor | string | The name recorded as discharging the debt; defaults to SAPHAN_ACTOR, then identity.actor in your configuration. It is a label, not a credential: the presence code is what is checked. | |
--ground | string | Why the debt is written off rather than settled. Required; recorded as its own fact on the record. |
Global options apply to every command — see Every command.