saphan round
Records facts about a round — one pass of work on a stream, normally carried out by an agent run — when part of that round was done by hand.
Records facts about a round — one pass of work on a stream, normally carried out by an agent run — when part of that round was done by hand.
saphan round declare
Declares a round that was done by hand, with no agent run: it writes the registry entry that saphan absorb and saphan merge rely on and files a round document recording the worktree's current commit. The stream must already have an order on record; otherwise the declaration is refused and names saphan channel put --kind master-order as the fix. A round that an agent run has already returned cannot be declared, and the worktree must sit in the workspace's worktrees layout (<repo>/wt-<stream>).
| flag | type | default | what it does |
|---|---|---|---|
--base | string | The branch or commit the round was cut from and lands on. Required. | |
--branch | string | The round's branch; defaults to the branch checked out in --worktree. | |
--by | string | The seat that did the work, recorded as its author; a declared name that is not verified. Required. | |
--landed-by-hand | string | The commit of a merge already made by hand, when declaring after the fact; it must resolve in the worktree and is recorded. | |
--move-worktree | bool | false | Confirm that the stream's registered worktree is deliberately moving to --worktree; without it, a different worktree is refused. |
--round | int | 0 | The round number. Required and positive. |
--self-authored | bool | false | Declare a round that no agent run carried out. Required. |
--stream | string | The stream. Required. | |
--worktree | string | The round's worktree. Required. |
saphan round retip
Files the status document in the stream's worktree as a new status for the round, after a commit made by hand moved the branch past the commit the record holds. It is refused unless the commit the document names is the branch's current tip and a descendant of the recorded commit, so the recorded tip can only move forward. The status document in the worktree is rewritten with a stamp naming the filer and the commit it supersedes. It does not check that the document describes the new commits; the rehearsal (saphan dry-run round retip) lists their subjects so you can.
| flag | type | default | what it does |
|---|---|---|---|
--by | string | The seat filing the new status, stamped into it; a declared name that is not verified. Required. | |
--stream | string | The stream. |
Global options apply to every command — see Every command.