saphan bus
Reads the stream status files in the workspace's worktrees into the record, and reads the record's event log.
Reads the stream status files in the workspace's worktrees into the record, and reads the record's event log.
saphan bus events
Prints events from the record (time, stream, source, kind and detail), including the entries written whenever something is removed, which name who removed what, why and when. It opens the record read-only and cannot change it. When nothing matches, it says which part of the record it read, how many rows it held, and which filter left nothing.
| flag | type | default | what it does |
|---|---|---|---|
--event-kind | string | Show only events of this kind; removal-witness shows the removals. | |
--since | string | Show only events at or after this time, given as RFC 3339 or a bare UTC date meaning that day's midnight UTC (inclusive). | |
--stream | string | Show only this stream's events. By default every stream in scope is shown. | |
--until | string | Show only events at or before this time, given as RFC 3339 or a bare UTC date; ⚠ a bare date means that day's midnight UTC, so the rest of that day is excluded. |
saphan bus reconcile
Scans every directory under the workspace's worktrees directory (worktrees/ unless SAPHAN_WORKTREES_DIR names another), reads the status files the roles leave there (order, executor status, review status), adds any new events to the record and refreshes the list of streams. A directory is recognised by its contents, not its name. It is safe to run repeatedly and never fetches or changes git. A scan error is printed on standard error but does not change the exit status. By default it prints counts by state; saphan fleet show gives the full view.
| flag | type | default | what it does |
|---|---|---|---|
--all | bool | false | List every stream as its own row instead of only the counts by state. |
Global options apply to every command — see Every command.
saphan build-orchestrate
Runs a project's platform builds one at a time, in the order a build-matrix file gives, starting, health-checking and stopping any emulators each build needs, and making sure every process it started
saphan canon
Delivers the canon a seat must obey (its standing rules, governing documents and a slice of the fleet's state) to the machine the seat runs on, as a signed pack.