retrofit0.10.0-wip.8

retrofit data retire

Withdraw a data chain by name, minting an empty floor at the head.

A retire is a DECLARED withdrawal: it states that a table's dataset no longer
applies, at the current head. Silence never withdraws anything: a source that
simply omits a table leaves that table untouched, so this verb is how an
emptied production table leaves the corpus.

With no `--label` it addresses the table's unlabelled reference chain; one
or more labels address the seed chain carrying exactly that label set.

A reference table's rows stop being managed when its declaration ends
(`retrofit schema ref-tables remove`): an unlabelled retire of a declared table
refuses, and one of a table no longer declared mints nothing.

Usage:
  retrofit data retire <schema.table> [flags]

Flags:
      --data-root data_root          root that overrides the schema's data_root
      --dry-run                      rehearse the withdrawal without writing
      --extra-seed-path seed_paths   root that appends to the declared seed_paths
  -h, --help                         help for retire
      --help-all                     show extended help (vocabulary, semantics, caveats)
      --label <label>                repeatable <label>; addresses the seed chain with exactly this label set
      --seed-path seed_paths         root that replaces the declared seed_paths
      --skip-manifest <path>         write the skip manifest to <path> as JSONL

Global Flags:
      --as string        output mode: text | json (default "text")
  -C, --chdir string     treat <dir> as the working directory for the entire run
      --config string    retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)
  -f, --file string      oplog file path; selects a registered [[schema]] path (overrides discovery)
      --no-consolidate   render every advisory occurrence instead of collapsing repeats
  -q, --quiet count      suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)
  -v, --verbose          reveal info-tier advisories on stderr

Docs: https://docs.retrofit.sh/current/commands/retrofit-data-retire/

Before 1.0, any release may change behavior; the release notes list what changed.