CLI reference
Commands, options and exit codes.
| Command | What it does |
|---|---|
validate | Checks config, sources and links; writes nothing |
build | Writes a complete candidate to .specistry/artifacts |
check | Runs the quality gate on the candidate |
diff --from v1 --to v2 | Structured diff between releases |
release <v> | Promotes the candidate to an immutable release |
current <v> | Moves the current pointer — your rollback |
deprecate <v> | Marks a release deprecated |
Global options
| Option | Meaning |
|---|---|
--root <path> | Project root; defaults to the current directory |
--json | Exactly one machine-readable result on stdout |
release options
| Option | Meaning |
|---|---|
--current | Select after promotion |
--from <v> | Comparison base for changelog candidates |
--no-diff | No comparison, no changelog required |
--label <text> | 1–40 characters shown in the version menu |
--date <YYYY-MM-DD> | Release date |