CLI reference / errors

stado errors

Invocation

stado errors <COMMAND>

Purpose

Every way an operation can fail, as the operation declares it: `list` the operations with a failure catalogue, `show` one operation's causes (what failed, why, the state shown, the fix, the code and exit status, the test), `check` the catalogues and the source for generic error messages

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

  • list — The operations that declare a failure catalogue, with how many causes each declares; with --markdown, every operation's documentation section
  • show — One operation's causes: what failed, why, the state the refusal shows, what fixes it, its code, its exit status and the test that provokes it
  • check — Refuse a catalogue that is not one, and an error message in the source under each --source directory that holds a generic sentence ("did not succeed", "something went wrong") beyond what --baseline allows. Exits non-zero naming each finding