saphan capture
Signs and records one spark (a short captured idea) or a session transcript, keeping the exact bytes and indexing them in the record.
Signs and records one spark (a short captured idea) or a session transcript, keeping the exact bytes and indexing them in the record. It signs with this workspace's signing key, so it refuses until saphan actor init has created one. When evidence storage is configured, the bytes are also stored durably and the entry is marked acknowledged; if that store write fails the entry stays unacknowledged so you can retry. Capturing bytes already recorded returns the existing entry.
| flag | type | default | what it does |
|---|---|---|---|
--actor | string | The name recorded as capturing; defaults to SAPHAN_ACTOR, then the identity in your configuration. It is recorded, not authenticated. | |
--file | string | The file whose exact bytes are captured, unchanged; - reads standard input. Required. | |
--kind | string | What is captured: spark or transcript. Required. | |
--ref | string | An optional free-text note on where this came from. Never put a secret here. | |
--stream | string | The stream, gate or other context that prompted this capture, if any. | |
--supersedes | int64 | 0 | The id of an earlier spark this capture revises. |
--to | string | The role that should pick this up next; only advisor is accepted. |
saphan capture archive
Archives a spark so it no longer shows as active, without deleting its signed capture. Anyone who can run commands in the workspace can archive any spark.
| flag | type | default | what it does |
|---|---|---|---|
--id | int64 | 0 | The id of the spark to archive. Required. |
saphan capture catch
Records a spark's words directly in the record, without signing it and without storing a separate copy of the bytes; this is what the console's quick-capture uses.
| flag | type | default | what it does |
|---|---|---|---|
--actor | string | The name recorded as catching the spark; defaults to SAPHAN_ACTOR, then the identity in your configuration. It is recorded, not authenticated. | |
--stream | string | The screen or stream the spark was caught on, if any. | |
--supersedes | int64 | 0 | The id of an earlier spark this one revises. |
--text | string | The spark's words. Required. |
saphan capture list
Lists recorded captures in id order.
| flag | type | default | what it does |
|---|---|---|---|
--limit | int | 0 | Show at most this many entries; 0 means no limit. |
--stream | string | Show only captures prompted by this stream. |
saphan capture route
Sends an active spark to the next role that should handle it.
| flag | type | default | what it does |
|---|---|---|---|
--id | int64 | 0 | The id of the spark to route. Required. |
--to | string | The role to send it to; only advisor is accepted. Required. |
saphan capture show
Shows one recorded capture by its id.
Global options apply to every command — see Every command.
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.
saphan ceremony
The owner's key ceremonies when a team is set up: creating the root key, which is kept only on paper, and the intermediate key used to issue machine certificates.