CLI reference / ci

stado ci

Invocation

stado ci <COMMAND>

Purpose

What the forge's continuous integration last did for a product: each workflow its repository declares, the newest run (of one revision with --revision) with its conclusion, and the failed job and step of a run that did not pass

Required inputs and options

This command has no command-specific inputs or options.

Output and state effect

This command group selects one of the subcommands listed below; use its exact child invocation to perform an operation.

Refusals

• Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.

Subcommands

• status — The newest run of every workflow the product's repository declares, with its conclusion and, for a run that did not pass, each failed job and the step that failed in it, and the delivery routine: its plan, the step it is installing and for how long, the refused step with every refusal and its defects, and what each step last delivered. Reads the forge's API as the identity Stado's GitHub declaration names in Skarbiec; refuses by name when Skarbiec, the declaration or the forge does not answer
• run — One pass of the delivery routine, which Stado's scheduler runs on the cadence the operator declares (`stado schedule create --cron … 'stado ci run'`): check every new commit of each step's `main` with the product's declared gates, recording each green or red (a red one in Oko, found in that commit), then install each step's last green commit, never `main` HEAD, in order, then — with `--push` declared — push `main` of every checkout. A refused install stops the pass, is recorded in Oko, exits non-zero, and resumes once a newer commit is green
• delivery — Whether the path that delivers repairs stands on this machine: the routine's running and refused steps, each step's main check (every commit checked, its last green one), who holds the pass lock, which product operations hold build trees, and this machine's Stado unit. `stalled` names every way the path is down, a red `main` among them, one sentence each; Oko orders work by it. Reads only
• plan — The delivery routine's declared plan