saphan golden-delivery
Copies reference artifacts ('goldens') into a goldens directory, one subdirectory per stream, and adds a README to each stream directory that lacks one; it writes files only and commits nothing.
Copies reference artifacts ("goldens") into a goldens directory, one subdirectory per stream, and adds a README to each stream directory that lacks one; it writes files only and commits nothing. Every pattern must match at least one file and every artifact must map to exactly one stream; otherwise the command stops before writing anything. ⚠ An existing golden whose content differs is overwritten without a copy of the old one; an existing README is never overwritten.
| flag | type | default | what it does |
|---|---|---|---|
--artifacts | string | Space-separated glob patterns, relative to --source, naming the files to deliver; required. | |
--config | string | A project configuration file to read these settings from; a flag given on the command line overrides the file. | |
--goldens-repo | string | The root of the goldens repository the artifacts are copied into; required. | |
--readme-note | string | An extra paragraph to include in each README the command creates. | |
--source | string | The directory the artifact patterns are resolved against; required. | |
--stream-map | string | Comma-separated pattern=stream entries that assign every artifact to a stream, for example reports/*.md=reports, media/*.png=media; required. |
Global options apply to every command — see Every command.
saphan gates
Lists the recorded gate decisions — time, stream, gate, actor, decision, reference and detail — and checks each row's signature.
saphan grammar
Prints the document formats compiled into this binary, so an agent or operator on a remote machine can read them without a source checkout, and manages the list of declared document keys.