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/