retrofit0.10.0-wip.8

retrofit op seal

Seal the unsealed tail of the oplog. The Seal covers every op from
the first unsealed op through the current tail; subsequent edits to
those ops are detected by `retrofit validate`.

Tail-append only: sealing a sub-range of the unsealed tail is out
of scope.

A range that declares reference data seals only when every reference
record it covers is witnessed, and only when every ExtractTable
child or CopyTable clone of a declared table born in it has a record
of its own (reference-rows-uncaptured): the op moves the source's
rows into the product in every migrated database, so a fresh build
needs them captured.

Run with --help-all for recovery guidance (e.g. removing a Seal
authored on the wrong branch).

Usage:
  retrofit op seal [flags]

Flags:
      --compact string   compact the tail to this frontier file, then seal it, in one write
  -h, --help             help for seal
      --help-all         show extended help (vocabulary, semantics, caveats)
      --reason string    optional reason text recorded on the Seal

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)
      --schema <name>    registered schema <name> (resolves via the chain when omitted)
  -v, --verbose          reveal info-tier advisories on stderr

Docs: https://docs.retrofit.sh/current/commands/retrofit-op-seal/

retrofit op seal --help-all adds:

Extended help:

If you authored a Seal on the wrong git branch and want to keep
its covered ops, recover with:

    retrofit op unseal

This removes the most-recent Seal record and keeps the covered ops as
the unsealed tail, ready to edit or re-seal.

For an intentional destructive rewind that discards the Seal and the
ops it covers, use:

    retrofit op truncate --drop-seals 1

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