saphan stop2
Closes a round of work you authored yourself, in one command, from inside that round's worktree.
Closes a round of work you authored yourself, in one command, from inside that round's worktree. It declares the round at the current commit, returns its status, records the coordinating agent's verification document, brings the event record up to date and shows the stream, stopping at the first step that refuses and printing that refusal unchanged; steps already completed stay recorded. The worktree must sit under the workspace's worktrees directory and carry the status and verification documents at its root, and a stream that has spawned agent runs is refused (those rounds close with saphan return). Every value is worked out from the worktree you are standing in, and each flag overrides one of them. On success it prints the owner's next command, saphan accept <stream>.
| flag | type | default | what it does |
|---|---|---|---|
--base | string | The base branch of the round; defaults to the stream's registered base, otherwise develop, so give it when your trunk has another name. | |
--branch | string | The branch to close; defaults to the branch checked out in this worktree. | |
--by | string | Who authored the round, recorded as given and not checked against who runs the command; defaults to your configured identity.actor. | |
--continue | bool | false | Use when this branch's stream is already merged and the workspace is set to open later rounds as new streams: creates <stream>-r<N> with a new branch and worktree and the order carried over, then runs the same steps there. |
--move-worktree | bool | false | Confirm that this stream's registered worktree has moved on purpose; without it a moved worktree is refused. |
--round | int | 0 | The round number; defaults to the next unused one. |
--stream | string | The stream to close; defaults to the stream registered on this branch. | |
--worktree | string | The worktree to close; defaults to the top of the git checkout you are in. |
Global options apply to every command — see Every command.
saphan show
Prints a registered order — the instruction document a piece of agent work runs under — exactly as it was registered, read from the commit recorded with its registration.
saphan store
Inspects the workspace's state store on disk: which processes hold its files, how its schema level compares with this binary's, and whether it is marked shared or scratch.