CLI reference / registry / pull

stado registry pull

Invocation

stado registry pull [OPTIONS]

Purpose

Print the canonical registry to stdout. Bare, this is the document alone. --with-generation prints one `stado.registry-pull-receipt.v1` object carrying the document and the token `push --if-generation` spends; --generation-only prints just the token. Both come from a single versioned read.

Required inputs and options

Input or optionContract
--with-generationPrint the document and its generation as one typed receipt
--generation-onlyPrint only the generation token, for a reconcile loop

Output and state effect

This is an inspection/reporting operation. It emits the result described above and does not change managed state unless an explicit option in this page says otherwise. Pass `--json` when the command exposes that machine-readable option.

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.