<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Commands on retrofit</title><link>https://docs.retrofit.sh/current/commands/</link><description>Recent content in Commands on retrofit</description><generator>Hugo</generator><language>en-us</language><atom:link href="https://docs.retrofit.sh/current/commands/index.xml" rel="self" type="application/rss+xml"/><item><title>retrofit</title><link>https://docs.retrofit.sh/current/commands/retrofit/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit/</guid><description>&lt;h1 id="retrofit"&gt;&lt;code&gt;retrofit&lt;/code&gt;&lt;a class="anchor" href="#retrofit" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Schema evolution CLI: an append-only oplog of DDL operators that&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;materializes into canonical SQL.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Bootstrap a new project:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 41ch"&gt; retrofit init # write retrofit.toml (&amp;#43; .gitattributes in a git repo)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 41ch"&gt; retrofit schema create users # register a schema and create its oplog&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 41ch"&gt; retrofit op add CreateTable people # author your first op&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 41ch"&gt; retrofit snapshot # emit canonical DDL&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Bootstrap from an existing schema:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit init&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 55ch"&gt; retrofit import path/to/source.sql --schema users # lazy-creates if unregistered&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Run any subcommand with --help for its flags, or --help-all for its&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;extended reference. `retrofit help --all` prints the full reference for&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;every command at once.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit [command]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Available Commands:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; completion Generate the autocompletion script for the specified shell&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; data Work with the data corpus&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; drift Reconcile an oplog with an out-of-band `.sql`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; element Read the live elements of a schema&amp;#39;s history&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; help Help about any command&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; identify Report which cut a pg_dump --schema-only is at, and how it has diverged&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; import Import one or more `.sql` files into an oplog&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; init Initialize a new retrofit project&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; migrate Emit a one-way migration script between two cuts&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; op Edit the oplog&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; ops Run bulk maintenance over the oplog&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; reconcile Close concurrent forks in the oplog by rebasing onto a linear tail&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; schema Manage registered schemas&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; snapshot Emit the schema at a cut as SQL: DDL plus reference and seed rows&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; validate Validate retrofit.toml, project layout, and the oplog&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -h, --help help for retrofit&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --version version for retrofit&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Use &amp;#34;retrofit [command] --help&amp;#34; for more information about a command.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit --help-all&lt;/code&gt; adds:&lt;/p&gt;</description></item><item><title>retrofit data</title><link>https://docs.retrofit.sh/current/commands/retrofit-data/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-data/</guid><description>&lt;h1 id="retrofit-data-the-data-corpus"&gt;&lt;code&gt;retrofit data&lt;/code&gt;: the data corpus&lt;a class="anchor" href="#retrofit-data-the-data-corpus" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;The &lt;code&gt;data&lt;/code&gt; verb group works on the &lt;strong&gt;data corpus&lt;/strong&gt;: every addressed&#10;&lt;code&gt;*.data.&amp;lt;format&amp;gt;&lt;/code&gt; &lt;a href="#the-data-file"&gt;data file&lt;/a&gt; under a schema&amp;rsquo;s declared&#10;&lt;code&gt;data_root&lt;/code&gt; (written as &lt;code&gt;.data.sql&lt;/code&gt;). Data files hold row data&#10;(reference tables, fixtures, migration backfills) beside the DDL history&#10;the &lt;a href="https://docs.retrofit.sh/current/glossary/#oplog"&gt;oplog&lt;/a&gt; records, and the emit verbs (&lt;code&gt;snapshot&lt;/code&gt;,&#10;&lt;code&gt;migrate&lt;/code&gt;) fold them into a data &lt;a href="https://docs.retrofit.sh/current/glossary/#band"&gt;band&lt;/a&gt; at emit time.&#10;Each verb&amp;rsquo;s flags are on its own page in the Command reference, which&#10;the table links.&lt;/p&gt;</description></item><item><title>retrofit data capture</title><link>https://docs.retrofit.sh/current/commands/retrofit-data-capture/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-data-capture/</guid><description>&lt;h1 id="retrofit-data-capture"&gt;&lt;code&gt;retrofit data capture&lt;/code&gt;&lt;a class="anchor" href="#retrofit-data-capture" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Capture a dump&amp;#39;s observed rows onto the data corpus.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;The verb records what the source&amp;#39;s rows are at the current head, never what&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;changed. Tables declared reference data (`retrofit schema ref-tables add`,&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;or `--ref` on `import`/`drift`) capture on the `ref` band;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`--label` enables the `seed` band for the rest. A table no declaration and no&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;label claims is LISTED, not captured, and the run exits 0.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`--from-label &amp;lt;l&amp;gt;` takes the corpus as the source instead of a file: it folds&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;the label&amp;#39;s `seed` chain for each selected declared table at the current head&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;and captures it on the `ref` band.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Use `retrofit import` for a source that states a CHANGE, and&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`retrofit data retire` to withdraw a table by name.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit data capture &amp;lt;source&amp;gt; [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --data-root &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that overrides the schema&amp;#39;s `data_root`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --dry-run classify and report without writing anything&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --extra-seed-path &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that appends to the declared `seed_paths`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --from-label &amp;lt;label&amp;gt; capture &amp;lt;label&amp;gt;&amp;#39;s seed fold at HEAD onto the ref band (the corpus is the source; no operand)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; -h, --help help for capture&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --label &amp;lt;label&amp;gt; repeatable cohort &amp;lt;label&amp;gt;; enables the seed band for unclaimed tables&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --seed-path &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that replaces the declared `seed_paths`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --skip-manifest &amp;lt;path&amp;gt; write the skip manifest to &amp;lt;path&amp;gt; as JSONL&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --table &amp;lt;pattern&amp;gt; repeatable source &amp;lt;pattern&amp;gt; filter (bare relname or glob)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-data-capture/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit data check</title><link>https://docs.retrofit.sh/current/commands/retrofit-data-check/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-data-check/</guid><description>&lt;h1 id="retrofit-data-check"&gt;&lt;code&gt;retrofit data check&lt;/code&gt;&lt;a class="anchor" href="#retrofit-data-check" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Check data-corpus files against the data-file grammar.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Runs every file-level legality predicate over the working tree, emits no SQL&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;and mints nothing. Reports all findings in one envelope and exits non-zero when&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;any file is refused.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;It also routes data-motion products&amp;#39; floors from their sources and lists each&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;routed record the routing cannot rewrite into its product as a&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;routed-body-unroutable warning, which leaves the exit status unchanged.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;With no operands it walks the configured corpus root; an undeclared root that&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;does not exist is an empty corpus. Operands narrow the walk;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;they do not enable it. A named directory is walked; a named file is checked by&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;the naming itself.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit data check [path...] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --data-root &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that overrides the schema&amp;#39;s `data_root`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; -h, --help help for check&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-data-check/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit data list</title><link>https://docs.retrofit.sh/current/commands/retrofit-data-list/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-data-list/</guid><description>&lt;h1 id="retrofit-data-list"&gt;&lt;code&gt;retrofit data list&lt;/code&gt;&lt;a class="anchor" href="#retrofit-data-list" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;List the data fold the emit verbs would apply.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Read-only: it emits no SQL and mints nothing. With no --label it renders the&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;reference fold plus an inventory of the labels the corpus carries; naming&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;labels renders the fold those layers produce, in argv order.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Run with --help-all for what each field of an item line means.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit data list [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --at &amp;lt;cut&amp;gt; render point &amp;lt;cut&amp;gt;: an opid prefix or root/last/seal anchor, optionally with ^ or ~N (default: last)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --data-root &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that overrides the schema&amp;#39;s `data_root`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --extra-seed-path &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that appends to the declared `seed_paths`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; -h, --help help for list&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --label &amp;lt;label&amp;gt; apply the dataset carrying this exact &amp;lt;label&amp;gt; (repeatable; argv order is layer order; byte-exact)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --seed-path &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that replaces the declared `seed_paths`&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-data-list/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit data list --help-all&lt;/code&gt; adds:&lt;/p&gt;</description></item><item><title>retrofit data reanchor</title><link>https://docs.retrofit.sh/current/commands/retrofit-data-reanchor/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-data-reanchor/</guid><description>&lt;h1 id="retrofit-data-reanchor"&gt;&lt;code&gt;retrofit data reanchor&lt;/code&gt;&lt;a class="anchor" href="#retrofit-data-reanchor" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Re-anchor corpus records onto the op that now holds their place.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;retrofit data reanchor moves a record whose anchor-op is retired (revised or&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;removed) onto the op that replaced it, and a reference record a release left&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;out of range onto the newest Seal line. A witness moves with its record and is&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;stale until retrofit data witness. --dry-run prints would reanchor: and writes&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;nothing; --as=json emits one record per line.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit data reanchor [&amp;lt;file&amp;gt; ...] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --data-root &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that overrides the schema&amp;#39;s `data_root`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --dry-run rehearse the re-anchor without writing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; -h, --help help for reanchor&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-data-reanchor/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit data repin</title><link>https://docs.retrofit.sh/current/commands/retrofit-data-repin/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-data-repin/</guid><description>&lt;h1 id="retrofit-data-repin"&gt;&lt;code&gt;retrofit data repin&lt;/code&gt;&lt;a class="anchor" href="#retrofit-data-repin" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Re-point one corpus data file&amp;#39;s anchor-op at an opid you name.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;A record whose anchor-op was revised or removed moves with&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`retrofit data reanchor`, onto the op that replaced it. This verb is the&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;recourse of `data-file-anchor-unresolved` when the log no longer names the&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;anchor&amp;#39;s fate (a regenerated log), or to pin a file at an opid you choose: an&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;anchor names an opid exactly, so a data file anchored on an opid naming no&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;live op is orphaned and this verb re-points the file. One invocation re-pins&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;every record in that file.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Only an orphaned file is eligible. A file whose anchor still resolves is&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;history-bound at a live op, and moving it is a relocation rather than a&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;repair; capture the rows at the new point instead.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;The target is required: pass the opid, an anchor ref (`last`,&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`seal`, each with optional `^`/`~N`) or a 1-12 hex opid prefix.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;The resolved 12-hex opid is what is written; the literal spelling never is.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;A re-pinned record that carried a witness is re-witnessed: one&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;WitnessReferenceData entry is appended at the new anchor, over the rewritten&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;bytes. An unwitnessed record stays unwitnessed; --dry-run appends nothing.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit data repin &amp;lt;file&amp;gt; [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 29ch"&gt; --anchor-op &amp;lt;target&amp;gt; the &amp;lt;target&amp;gt; opid to re-pin on: an opid, an anchor ref (`last`, `seal`, with `^`/`~N`) or a 1-12 hex prefix&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 29ch"&gt; --data-root &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that overrides the schema&amp;#39;s `data_root`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 29ch"&gt; --dry-run rehearse the re-pin without writing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 29ch"&gt; -h, --help help for repin&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 29ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-data-repin/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit data retire</title><link>https://docs.retrofit.sh/current/commands/retrofit-data-retire/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-data-retire/</guid><description>&lt;h1 id="retrofit-data-retire"&gt;&lt;code&gt;retrofit data retire&lt;/code&gt;&lt;a class="anchor" href="#retrofit-data-retire" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Withdraw a data chain by name, minting an empty floor at the head.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;A retire is a DECLARED withdrawal: it states that a table&amp;#39;s dataset no longer&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;applies, at the current head. Silence never withdraws anything: a source that&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;simply omits a table leaves that table untouched, so this verb is how an&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;emptied production table leaves the corpus.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;With no `--label` it addresses the table&amp;#39;s unlabelled reference chain; one&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;or more labels address the seed chain carrying exactly that label set.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;A reference table&amp;#39;s rows stop being managed when its declaration ends&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;(`retrofit schema ref-tables remove`): an unlabelled retire of a declared table&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;refuses, and one of a table no longer declared mints nothing.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit data retire &amp;lt;schema.table&amp;gt; [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --data-root &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that overrides the schema&amp;#39;s `data_root`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --dry-run rehearse the withdrawal without writing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --extra-seed-path &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that appends to the declared `seed_paths`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; -h, --help help for retire&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --label &amp;lt;label&amp;gt; repeatable &amp;lt;label&amp;gt;; addresses the seed chain with exactly this label set&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --seed-path &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that replaces the declared `seed_paths`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 33ch"&gt; --skip-manifest &amp;lt;path&amp;gt; write the skip manifest to &amp;lt;path&amp;gt; as JSONL&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-data-retire/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit data scaffold</title><link>https://docs.retrofit.sh/current/commands/retrofit-data-scaffold/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-data-scaffold/</guid><description>&lt;h1 id="retrofit-data-scaffold"&gt;&lt;code&gt;retrofit data scaffold&lt;/code&gt;&lt;a class="anchor" href="#retrofit-data-scaffold" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Mint an empty data-corpus file carrying declared metadata axes.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;The minted file holds a v1 header, one section header carrying the axes you&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;declare, guidance comments showing the record form, and the section-end&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;marker. It parses to zero records, so every reader treats it as empty until&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;you hand-author statements into the section.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;The path is derived, not given: the file lands under the target&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;schema&amp;#39;s declared `data_root` at the deterministic path for its mint key.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit data scaffold [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --anchor-op string 12-hex op id the scaffolded records anchor on (default: the reconciled head)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --disposition &amp;lt;append|restate&amp;gt; declared disposition &amp;lt;append|restate&amp;gt; (omitted: no disposition token)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; -h, --help help for scaffold&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --label &amp;lt;label&amp;gt; repeatable declared cohort &amp;lt;label&amp;gt; (the axis is a set; canonicalized on emit)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --purpose &amp;lt;transition|cleanse&amp;gt; declared purpose &amp;lt;transition|cleanse&amp;gt;; both are experimental, refused unless retrofit.toml&amp;#39;s [experimental] purposes lists the value (exclusive with --label, which resolves seed)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --table &amp;lt;schema&amp;gt;.&amp;lt;table&amp;gt; the schema-qualified table this file declares, &amp;lt;schema&amp;gt;.&amp;lt;table&amp;gt; (required)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-data-scaffold/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit data witness</title><link>https://docs.retrofit.sh/current/commands/retrofit-data-witness/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-data-witness/</guid><description>&lt;h1 id="retrofit-data-witness"&gt;&lt;code&gt;retrofit data witness&lt;/code&gt;&lt;a class="anchor" href="#retrofit-data-witness" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Witness reference-data records: bind their bytes to the oplog.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;The verb appends one WitnessReferenceData entry per selected record,&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;carrying the record&amp;#39;s digest over every file at its key&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;{table, label-set, anchor}. A witnessed record whose anchor a seal covers is&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;verified by validate, op seal, migrate and snapshot.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;With no operands it selects every purpose=ref record under data_root whose&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;anchor is in the unsealed tail and which has no witness at its current bytes.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Operands name record files; a directory is refused. A named record outside the&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;selection is refused (witness-band, sealed-anchor); one already witnessed at&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;its current bytes is reported already-witnessed.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;--dry-run renders the same rows and appends nothing.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit data witness [path...] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --dry-run render the rows the run would produce and append nothing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; -h, --help help for witness&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-data-witness/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit drift</title><link>https://docs.retrofit.sh/current/commands/retrofit-drift/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-drift/</guid><description>&lt;h1 id="retrofit-drift"&gt;&lt;code&gt;retrofit drift&lt;/code&gt;&lt;a class="anchor" href="#retrofit-drift" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit drift&lt;/code&gt; reads a &lt;code&gt;.sql&lt;/code&gt; source that states a schema&amp;rsquo;s current&#10;shape, compares it with the schema the &lt;a href="https://docs.retrofit.sh/current/oplog/#the-oplog"&gt;oplog&lt;/a&gt;&#10;records, and appends the ops (operators) that bring the oplog to that&#10;shape, asking a question where a change has more than one reading. It&#10;writes the oplog and the data files of the reference tables it captures,&#10;and never runs a statement against a database.&#10;&lt;a href="https://docs.retrofit.sh/current/record-outside-changes/"&gt;Record a schema changed outside the oplog&lt;/a&gt;&#10;is the task guide.&lt;/p&gt;</description></item><item><title>retrofit element</title><link>https://docs.retrofit.sh/current/commands/retrofit-element/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-element/</guid><description>&lt;h1 id="retrofit-element"&gt;&lt;code&gt;retrofit element&lt;/code&gt;&lt;a class="anchor" href="#retrofit-element" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Read the live elements of a schema&amp;#39;s history&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit element&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit element [command]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Available Commands:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; history List the ops of one element&amp;#39;s history, live or dropped&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; list List every live element with its ID and the ref `op add` accepts&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for element&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Use &amp;#34;retrofit element [command] --help&amp;#34; for more information about a command.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-element/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit element history</title><link>https://docs.retrofit.sh/current/commands/retrofit-element-history/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-element-history/</guid><description>&lt;h1 id="retrofit-element-history"&gt;&lt;code&gt;retrofit element history&lt;/code&gt;&lt;a class="anchor" href="#retrofit-element-history" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit element history &amp;lt;operand&amp;gt;&lt;/code&gt; prints the history of one element: one&#10;record per op of the selected &lt;a href="https://docs.retrofit.sh/current/glossary/#oplog"&gt;oplog&lt;/a&gt; that created,&#10;changed, renamed, moved or ended it, named it from another element, or&#10;belongs to the elements it was derived from. It reads the configuration&#10;and the oplog, reads no data corpus and writes nothing.&#10;&lt;a href="https://docs.retrofit.sh/current/find-an-element/"&gt;Find an element&amp;rsquo;s ID and history&lt;/a&gt; is the task guide.&lt;/p&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;From &lt;code&gt;retrofit element history --help&lt;/code&gt;:&lt;/p&gt;</description></item><item><title>retrofit element list</title><link>https://docs.retrofit.sh/current/commands/retrofit-element-list/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-element-list/</guid><description>&lt;h1 id="retrofit-element-list"&gt;&lt;code&gt;retrofit element list&lt;/code&gt;&lt;a class="anchor" href="#retrofit-element-list" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit element list&lt;/code&gt; prints one record per live element at a&#10;&lt;a href="https://docs.retrofit.sh/current/glossary/#cut"&gt;cut&lt;/a&gt;: its kind, schema, name,&#10;&lt;a href="https://docs.retrofit.sh/current/glossary/#elementid"&gt;ElementID&lt;/a&gt;, the &lt;code&gt;ref&lt;/code&gt; that &lt;code&gt;op add&lt;/code&gt; accepts for it,&#10;its containing element and, for a partition, its partitioned parent. It&#10;reads the configuration and the &lt;a href="https://docs.retrofit.sh/current/glossary/#oplog"&gt;oplog&lt;/a&gt;, reads no data&#10;corpus and writes nothing.&#10;&lt;a href="https://docs.retrofit.sh/current/find-an-element/"&gt;Find an element&amp;rsquo;s ID and history&lt;/a&gt; is the task guide.&lt;/p&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;From &lt;code&gt;retrofit element list --help&lt;/code&gt;:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit element list [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="description"&gt;Description&lt;a class="anchor" href="#description" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;element list replays each covered schema&amp;rsquo;s oplog up to one cut and prints&#10;the elements the replay holds there: the live set that&#10;&lt;a href="https://docs.retrofit.sh/current/commands/retrofit-snapshot/"&gt;&lt;code&gt;retrofit snapshot&lt;/code&gt;&lt;/a&gt; renders at the same cut.&lt;/p&gt;</description></item><item><title>retrofit identify</title><link>https://docs.retrofit.sh/current/commands/retrofit-identify/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-identify/</guid><description>&lt;h1 id="retrofit-identify"&gt;&lt;code&gt;retrofit identify&lt;/code&gt;&lt;a class="anchor" href="#retrofit-identify" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Report which cut a pg_dump --schema-only is at, and how it has diverged&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit identify &amp;lt;dump&amp;gt; [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --expect &amp;lt;cut&amp;gt; assert the dump is at this &amp;lt;cut&amp;gt;: opid prefix or anchor (`last`/`seal`, optional `^`/`~N`), or the placement token `&amp;lt;cut&amp;gt;&amp;#43;&amp;lt;opid&amp;gt;[,&amp;lt;opid&amp;gt;]`; refuse `expect-mismatch` when it resolves elsewhere, measuring the divergence against the named cut when the dump is at no cut and operations follow it&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; -h, --help help for identify&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-identify/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit import</title><link>https://docs.retrofit.sh/current/commands/retrofit-import/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-import/</guid><description>&lt;h1 id="retrofit-import"&gt;&lt;code&gt;retrofit import&lt;/code&gt;&lt;a class="anchor" href="#retrofit-import" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit import&lt;/code&gt; reads one or more &lt;code&gt;.sql&lt;/code&gt; sources and appends an op to&#10;the &lt;a href="https://docs.retrofit.sh/current/oplog/#the-oplog"&gt;oplog&lt;/a&gt; for each statement in retrofit&amp;rsquo;s&#10;vocabulary, in the order the sources state them (a drop a function&#10;body reads, and a function created before what its body binds, can&#10;move; see &lt;a href="#drops-read-by-function-bodies"&gt;Drops read by function&#10;bodies&lt;/a&gt; and &lt;a href="#functions-created-before-what-their-bodies-bind"&gt;Functions created before&#10;what their bodies&#10;bind&lt;/a&gt;). It writes the oplog,&#10;the schema&amp;rsquo;s &lt;code&gt;[[schema]]&lt;/code&gt; row in &lt;code&gt;retrofit.toml&lt;/code&gt; when it registers one,&#10;and the data files it sets preserved DML aside in; it never runs a&#10;statement against a database. &lt;a href="https://docs.retrofit.sh/current/import-existing-sql/"&gt;Import existing SQL&lt;/a&gt; and&#10;&lt;a href="https://docs.retrofit.sh/current/import-a-migration-tree/"&gt;Import a migration tree in order&lt;/a&gt; are the&#10;task guides.&lt;/p&gt;</description></item><item><title>retrofit init</title><link>https://docs.retrofit.sh/current/commands/retrofit-init/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-init/</guid><description>&lt;h1 id="retrofit-init"&gt;&lt;code&gt;retrofit init&lt;/code&gt;&lt;a class="anchor" href="#retrofit-init" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Initialize the current project by writing retrofit.toml at&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;the repo root (the current directory outside a git&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;repository) and, inside a git repository, ensuring&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`.gitattributes` carries the *.oplog merge=union line and&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;the *.data.sql text eol=lf line (the latter keeps a checkout&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;rewrite from disturbing data file line endings). Does not&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;create an oplog (use `retrofit schema create`).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;GitHub&amp;#39;s pull request merges do not read .gitattributes, so&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;an oplog both sides appended to conflicts there.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit init [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --add-search-path append [search_path] section with default schemas = [&amp;#34;public&amp;#34;] when missing (upgrade path for configs written before search_path; idempotent)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --config string destination retrofit.toml path; a relative path anchors to the current directory, not to --dir (default: &amp;lt;repo-root&amp;gt;/retrofit.toml)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --dir string working directory for .git discovery only; does not anchor a relative --config&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --engine &amp;lt;engine&amp;gt; engine identifier &amp;lt;engine&amp;gt; (only `postgres` accepted) (default &amp;#34;postgres&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --engine-version &amp;lt;15|16|17|18&amp;gt; supported major &amp;lt;15|16|17|18&amp;gt; (overrides build-time default) (default &amp;#34;17&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --force overwrite an existing retrofit.toml (init is otherwise idempotent: a second run leaves retrofit.toml alone but still finishes the .gitattributes step)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; -h, --help help for init&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --no-gitattributes skip .gitattributes mutation entirely&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-init/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit migrate</title><link>https://docs.retrofit.sh/current/commands/retrofit-migrate/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-migrate/</guid><description>&lt;h1 id="retrofit-migrate"&gt;&lt;code&gt;retrofit migrate&lt;/code&gt;&lt;a class="anchor" href="#retrofit-migrate" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit migrate&lt;/code&gt; writes to stdout the SQL that takes a database from&#10;one cut of the &lt;a href="https://docs.retrofit.sh/current/oplog/#the-oplog"&gt;oplog&lt;/a&gt; to another: forward by&#10;default, or the reverse with &lt;code&gt;--down&lt;/code&gt;. It reads the oplog, the&#10;configuration, the data files under the schema&amp;rsquo;s &lt;code&gt;data_root&lt;/code&gt; and, with&#10;&lt;code&gt;--from-dump&lt;/code&gt;, a schema-only dump, and writes no file.&#10;&lt;a href="https://docs.retrofit.sh/current/emit-a-migration/"&gt;Emit a migration script&lt;/a&gt; is the task guide, and&#10;&lt;a href="https://docs.retrofit.sh/current/how-a-migration-applies/"&gt;How a migration applies&lt;/a&gt; gives the model&#10;behind the envelope, segments and the lock wait.&lt;/p&gt;</description></item><item><title>retrofit op</title><link>https://docs.retrofit.sh/current/commands/retrofit-op/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op/</guid><description>&lt;h1 id="retrofit-op"&gt;&lt;code&gt;retrofit op&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Edit the oplog&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op [command]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Available Commands:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; add Append a new operator instance to the active oplog&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; compact Drop the oplog&amp;#39;s traces (tombstones, replaces=) to a bound&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; info Print an operator&amp;#39;s reference entry, or the whole catalog with --dump&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; remove Drop one unsealed op, or a contiguous range &amp;lt;from&amp;gt;..&amp;lt;to&amp;gt;, from the oplog&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; revert Append the reversal a down computes to the log&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; revise Patch bound parameters on an unsealed op&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; seal Seal the unsealed tail of the oplog&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; show Render ops from the oplog&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; squash Reduce a range of the unsealed tail to its net effect&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; truncate Rewind the oplog to a checkpoint by removing a suffix of ops&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; unseal Demote the most-recent N Seal record(s), keeping their ops as unsealed tail&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; -h, --help help for op&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Use &amp;#34;retrofit op [command] --help&amp;#34; for more information about a command.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit op add</title><link>https://docs.retrofit.sh/current/commands/retrofit-op-add/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op-add/</guid><description>&lt;h1 id="retrofit-op-add"&gt;&lt;code&gt;retrofit op add&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op-add" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Append a new operator instance to the active oplog.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Each call records one operation (a `DropUnique`, `DropPrimaryKey` or&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`ChangePrimaryKey` that retires a `USING INDEX` constraint also records&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;its companion `DropIndex`).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;The full set of appendable operators is enumerated below; pass&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`retrofit op add &amp;lt;Operator&amp;gt; --help` for the parameter detail of any&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;one of them, or `retrofit op add --examples` for a worked CREATE TABLE&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;recipe.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;CreateSchema and Seal are not listed: `retrofit schema create` writes&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;CreateSchema with its registry entry, and `retrofit op seal` computes&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;a Seal&amp;#39;s range and digest from the unsealed tail.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;AddUnique, AddExclude, AddForeignKey, AddPrimaryKey, and AddCheck each require a&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;non-empty `name=` (the constraint&amp;#39;s name); e.g.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`op add AddUnique &amp;lt;table&amp;gt; --column &amp;lt;t.col&amp;gt; name=t_a_b_key`.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;ChangePrimaryKey requires one too unless it sets backing_index.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`--` ends the verb&amp;#39;s own flags (--as, --dry-run, -q, ...); every token&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;after it is passed to the operator verbatim, so a payload value that&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;is spelled like a flag can be given as `-- --&amp;lt;param&amp;gt; &amp;lt;value&amp;gt;`.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;OPERATORS&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; Table operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; AttachPartition Subordinate a free-standing table as a partition of a partitioned parent (its columns end into the parent&amp;#39;s).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; CopyTable Create a new table that is an independent copy of source.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; CreatePartition Create a partition under a partitioned parent (columns inherited).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; CreateTable Create a new table inside the target schema.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DepartitionTable Flatten a partitioned parent back to a plain heap, tombstoning its partition-children.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DetachPartition Detach a partition into a free-standing table (rows kept).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropTable Consume the target table element.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; ExtractTable Extract columns into new related tables (column-axis split; normalizes a wide table). A child copies the source&amp;#39;s primary key, keeping every row&amp;#39;s data, or designates `key` columns it shares with the source (the lookup: one child row per distinct key, the source rows with a NULL key component losing their moved values). With a remainder the source survives in place holding the unassigned columns; with every live column assigned the source is consumed.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; InlineTable Inline one or more child tables back into a live table along their primary keys (keyed column fold, folding an extracted child back into its survivor). The survivor keeps its identity; each inlined source&amp;#39;s columns reparent onto it and the source is consumed. A survivor row with no inlined row is padded with NULL or the column&amp;#39;s default.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; JoinTable Join two tables&amp;#39; columns into one (denormalize; column-axis join along a recorded key pairing). Identity-preserving at the column level: each source column is reparented to the new target with its existing ElementID. Rejects on column-name collision across sources (resolve via prior RenameColumn). The key_pairs are the ordered column pairs the sources are joined on (each side&amp;#39;s columns a PRIMARY KEY or UNIQUE of that source); kind picks the JOIN flavor (inner/left/right/full).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; MergeTable Move the rows of several tables into a live table of their shape, one predicate recorded per source (row-axis merge).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; MoveColumn Move a column to another table along a recorded key pairing, keeping its identity and carrying each value to its partner row. The column&amp;#39;s ElementID survives the move; only the parent table changes. Renames are a separate operator.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; PartitionTable Convert a plain table to a partitioned parent in place, minting N partitions atomically. (partition_by ∈ {range, list, hash})&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RenameTable Rename the target table to a new name in its schema.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetReferenceData Declare or undeclare the target table as reference data.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetReplicaIdentity Set the table&amp;#39;s REPLICA IDENTITY mode. mode=using_index requires index=&amp;lt;index&amp;gt;, a unique, immediate, non-partial, column-only index on this table over NOT NULL columns. (mode ∈ {default, nothing, full, using_index})&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetTableComment Set or clear a table comment. Empty text clears (mirrors PG `COMMENT ON TABLE … IS NULL`).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SplitTable Move a table&amp;#39;s rows into N new tables of its shape by first-match predicate; the source stays (row-axis split).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; UnjoinTable Take a join apart along the keys its sides hold into two new related tables (keyed table unjoin, undoing a join of any kind). Every live column of the source is assigned to exactly one child and the source is consumed; each child keeps its columns&amp;#39; identities. (kind ∈ {inner, left, right, full})&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; Column operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; AddColumn Add a column to an existing table.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; AddIdentity Promote an existing column to GENERATED { BY DEFAULT | ALWAYS } AS IDENTITY. PG mints a fresh backing sequence starting at identity_start (else PostgreSQL&amp;#39;s default: its minimum value, or its maximum when it counts down) and does NOT advance it past the column&amp;#39;s existing values, so migrate emits a realignment statement after the ALTER; without it the migration applies cleanly and the next insert collides. (generation ∈ {by_default, always})&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; AddNotNull Set the column&amp;#39;s NOT NULL bit on the column vertex.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; CastColumn Change a column&amp;#39;s SQL type in place.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; CopyColumn Duplicate a column on the same parent table: mint a fresh column whose initial values are seeded from an existing source column. Type/default/nullability are inherited from the source unless overridden. The new column is born unconstrained; re-attach PK/FK/UNIQUE/CHECK/index against the new ElementID via separate ops.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropColumn Consume the target column element.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropDefault Clear a column&amp;#39;s DEFAULT expression. Replay rejects against a column with no current default.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 30ch"&gt; DropGeneratedExpression Clear a stored generated column&amp;#39;s expression, converting it to a base column. Replay rejects against a column with no current generated expression or a virtual generated column.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropIdentity Remove the identity property from a column. The implicit NOT NULL is preserved; use DropNotNull to clear it.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropNotNull Clear the column-vertex NOT NULL bit.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RenameColumn Rename the target column inside its containing table.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RenameOwnedSequence Rename the sequence a column owns (its serial or identity sequence) without touching the column.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetColumnComment Set or clear a column comment. Empty text clears.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetDefault Set or replace a column&amp;#39;s DEFAULT expression. Single-slot semantics; overwrites whatever default is in effect.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetIdentityGeneration Swap an identity column&amp;#39;s generation mode between BY DEFAULT and ALWAYS without dropping the underlying sequence. (generation ∈ {by_default, always})&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetIdentityOptions Change an identity column&amp;#39;s sequence options (START, INCREMENT, MINVALUE, MAXVALUE, CACHE, CYCLE); an option it does not name keeps its value, and the sequence keeps its position.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; Constraint operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; AddCheck Declare a CHECK constraint enforcing a row-level predicate.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; AddExclude Declare an EXCLUDE constraint: no two rows&amp;#39; keys may all compare true under the listed operators.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; AddForeignKey Declare a foreign-key constraint to referenced_columns in referenced_table.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; AddPrimaryKey Declare a primary-key constraint over the listed columns.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; AddUnique Declare a UNIQUE constraint over the listed columns.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; ChangePrimaryKey Replace a table&amp;#39;s primary key with a new column set; preserves the cascade genealogy across the PK and every dependent FK constraint via N&amp;#43;1 EdgeKindCrossElement edges minted at replay.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropCheck Consume the target CHECK constraint.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropExclude Consume the target EXCLUDE constraint.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropForeignKey Consume the target foreign-key constraint.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropPrimaryKey Consume the target primary-key constraint.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropUnique Consume the target UNIQUE constraint.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RenameConstraint Rename a constraint without dropping it. Element identity is preserved; the first rename of a PG-default-named constraint assigns the first explicit name.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetConstraintComment Set or clear a constraint comment. Empty text clears (mirrors PG `COMMENT ON CONSTRAINT … ON … IS NULL`).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 30ch"&gt; SetConstraintDeferrable Toggle the DEFERRABLE bit on an FK constraint (PG&amp;#39;s ALTER CONSTRAINT is FK-only; UNIQUE / PK can be born deferrable via AddUnique / AddPrimaryKey but not toggled post-birth). Replay rejects no-op writes.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetConstraintEnforced Toggle the ENFORCED bit on a foreign-key (FK) constraint (PostgreSQL alters the enforceability of foreign keys only). (not available in this build: PostgreSQL 18 syntax)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetConstraintInherit Toggle the NO INHERIT bit on a NOT NULL constraint (PostgreSQL&amp;#39;s per-constraint INHERIT / NO INHERIT applies to NOT NULL only). (not available in this build: PostgreSQL 18 syntax)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 37ch"&gt; SetConstraintInitiallyDeferred Toggle the INITIALLY DEFERRED bit on an FK constraint (PG&amp;#39;s ALTER CONSTRAINT is FK-only; UNIQUE / PK can be born initially-deferred via AddUnique / AddPrimaryKey but not toggled post-birth). Requires the constraint to already be DEFERRABLE; replay rejects no-op writes.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; ValidateConstraint Promote a NOT VALID foreign-key or CHECK constraint to validated.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; Index operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; CreateIndex Create a physical index over the listed columns.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropIndex Consume the target index element.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RenameIndex Rename the target index inside its containing table.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; View operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 29ch"&gt; CreateMaterializedView Create a new materialized view inside the target schema.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; CreateView Create a new view inside the target schema.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropMaterializedView Consume the target materialized view element.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropView Consume the target view element.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 29ch"&gt; RenameMaterializedView Rename the target materialized view to a new name in its schema.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RenameView Rename the target view to a new name in its schema.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 30ch"&gt; ReplaceMaterializedView Replace the body of an existing materialized view (DROP CASCADE &amp;#43; CREATE realization).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; ReplaceView State the view&amp;#39;s whole new definition: query and column list, same element.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; Type operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; AddEnumValue Append a new value to an existing enum type.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; CreateType Create a user-defined type (enum or composite) in the target schema. (kind ∈ {enum, composite})&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropType Consume a user-defined type element. Refused at op-add when any live column binds to it.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RenameEnumValue Rename an existing enum value in place.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RenameType Rename a user-defined type. Element identity (typeRef) is preserved across the rename.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; Policy operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; CreatePolicy Create a row-level-security policy on a table. Identity is (table, name).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropPolicy Consume the target policy element.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RenamePolicy Rename a policy within its owning table.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; ReplacePolicy Replace a policy&amp;#39;s TO / USING / WITH CHECK. Cannot change permissive or command (those are identity-fixed; use Drop&amp;#43;Create).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetRowLevelSecurity Set a table&amp;#39;s ROW LEVEL SECURITY enabled/forced facets (absolute {enabled, forced} payload).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; Function operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; CreateFunction Create a new function inside the target schema. Identity is (schema, composite-name).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropFunction Consume the target function element.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RenameFunction Rename the target function to a new name in its schema.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; ReplaceFunction Replace a function&amp;#39;s body and mutable attributes. Signature is identity-fixed by on= and cannot change.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; SetFunctionComment Set or clear a function comment. Empty text clears (mirrors PG `COMMENT ON FUNCTION … IS NULL`).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; Trigger operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; CreateTrigger Create a trigger on a table or view. Identity is (table, name). (timing ∈ {before, after, instead_of})&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DisableTrigger Disable an enabled trigger.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DropTrigger Consume the target trigger element.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; EnableTrigger Enable a disabled trigger.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RenameTrigger Rename the target trigger.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; Log operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; DeclareReversal Declare how a sealed RunRawScript is undone: a reverse_body, a no-op or forward-only with its reason, or (with no arm) a withdrawal of the declaration it supersedes.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; Raw / escape-hatch operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 28ch"&gt; RunRawScript Run-once raw statement sequence with no catalog identity (a DO $$ … $$; anonymous block). A body or reverse_body whose every name binds is bound to the elements it names: migrate renders each as its element&amp;#39;s name at the script&amp;#39;s position, so a rename before it is followed and a drop before it refuses; dynamic SQL, names as data, or a form the binder does not follow keeps a body opaque, emitted verbatim, with a finding naming the cause. A body whose DO block holds COMMIT or ROLLBACK cannot run inside a transaction block (SQLSTATE 2D000): migrate segments around it under --envelope=own, refuses migrate-tx-incompatible under caller and advises under independent. migrate --down reads its reversal: an optional reverse_body is emitted unchecked, except that one holding COMMIT or ROLLBACK refuses migrate-non-reversible (the down never segments); reverse_noop contributes nothing, reverse_blocked refuses; no structural diff target; drift has no synthesis path. The escape hatch below the Structural/Definitional partition.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op add &amp;lt;operator&amp;gt; [&amp;lt;args&amp;gt;...] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --allow-readers-moved stringArray attest that the readers of the table or column with this qualified old name are handled by the time the rename applies (repeatable; byte-exact, never trimmed); every other rename still warns&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --database-at string the cut the database this op is written for is at, from which apply-risk is judged (else the latest Seal)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --dry-run preview the proposed op without writing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --examples print a worked CREATE TABLE recipe of op add calls&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --explain with --dry-run, accept partial input and report bound vs. missing params&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; -h, --help help for add&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --no-prompt force non-TTY behavior; never prompt&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op-add/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit op compact</title><link>https://docs.retrofit.sh/current/commands/retrofit-op-compact/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op-compact/</guid><description>&lt;h1 id="retrofit-op-compact"&gt;&lt;code&gt;retrofit op compact&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op-compact" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Drop the oplog&amp;#39;s traces (tombstoned lines and replaces= entries) to&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;exactly one bound, rewiring each prev= to its effective value; the render&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;every verb reads is unchanged.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 21ch"&gt; --frontier &amp;lt;file&amp;gt; a trace drops only when &amp;lt;file&amp;gt; holds the same trace&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 21ch"&gt; --unshared &amp;lt;file&amp;gt; a trace drops only when &amp;lt;file&amp;gt; holds no line,&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 23ch"&gt; tombstone or replacement of its opid&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 21ch"&gt; --all every trace outside sealed ranges drops&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;A sealed range compacts only when --seal &amp;lt;opid&amp;gt; names its Seal, to the&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;bound, without resealing. A file holding no trace to drop is not written.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op compact [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 26ch"&gt; --all drop every trace outside sealed ranges (the flag is the attestation no open branch holds them)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 26ch"&gt; --frontier string drop a trace only when this file holds the same trace&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 26ch"&gt; -h, --help help for compact&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 26ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 26ch"&gt; --seal strings also compact the sealed range of each named live Seal, to the bound&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 26ch"&gt; --unshared string drop a trace only when this file holds no line, tombstone or replacement of its opid&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op-compact/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit op info</title><link>https://docs.retrofit.sh/current/commands/retrofit-op-info/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op-info/</guid><description>&lt;h1 id="retrofit-op-info"&gt;&lt;code&gt;retrofit op info&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op-info" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Reasoned reference documentation for an operator, one kind of schema change an oplog records.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; retrofit op info &amp;lt;Operator&amp;gt; one operator&amp;#39;s reference view&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 41ch"&gt; retrofit op info &amp;lt;Operator&amp;gt; --as json that operator&amp;#39;s descriptor as JSON&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; retrofit op info --dump human roll-up of all operators&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; retrofit op info --dump --as json the {&amp;#34;operators&amp;#34;:[...]} document for tooling&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;For an operator&amp;#39;s syntax (usage and positional order), run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`op add &amp;lt;Operator&amp;gt; --help`. The output is plain stdout; pipe it:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op info CreateTable | less&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op info --dump --as json | jq &amp;#39;.operators[].name&amp;#39;&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op info [&amp;lt;operator&amp;gt;] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --dump marshal every registered operator (bulk / machine path)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for info&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op-info/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit op remove</title><link>https://docs.retrofit.sh/current/commands/retrofit-op-remove/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op-remove/</guid><description>&lt;h1 id="retrofit-op-remove"&gt;&lt;code&gt;retrofit op remove&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op-remove" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Drop one unsealed op, or a contiguous range &amp;lt;from&amp;gt;..&amp;lt;to&amp;gt;, from the oplog&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op remove &amp;lt;selector&amp;gt; [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --dry-run preview the opids that would be removed without writing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for remove&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op-remove/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit op remove --help-all&lt;/code&gt; adds:&lt;/p&gt;</description></item><item><title>retrofit op revert</title><link>https://docs.retrofit.sh/current/commands/retrofit-op-revert/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op-revert/</guid><description>&lt;h1 id="retrofit-op-revert"&gt;&lt;code&gt;retrofit op revert&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op-revert" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Append the reversal `migrate --down` computes: the ghost&amp;#39;s ops after the&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;log&amp;#39;s last op, and the reference leg&amp;#39;s records, so the log holds what was undone.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Each appended op carries `reason=&amp;#34;undoes &amp;lt;opid&amp;gt;&amp;#34;`, naming the window op it undoes;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;`reason=&amp;lt;text&amp;gt;` records that text on every appended op instead.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op revert [reason=&amp;lt;text&amp;gt;] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --allow-readers-moved stringArray attest that the readers of the table or column with this qualified old name are handled by the time the rename applies (repeatable; byte-exact, never trimmed); every other rename still warns&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --at string the cut the log is expected to end at; a precondition only&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --data-root &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that overrides the schema&amp;#39;s `data_root`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --dry-run preview what would be appended and write nothing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --extra-seed-path &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that appends to the declared `seed_paths`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --from &amp;lt;cut&amp;gt; start &amp;lt;cut&amp;gt;: from-opid prefix or anchor, read as `migrate --down` reads it; default: latest Seal, or `root` when no Seal exists&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; -h, --help help for revert&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --label stringArray the reference-data label set the ghost reads (repeatable)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --seed-path &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that replaces the declared `seed_paths`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 42ch"&gt; --to string a slice&amp;#39;s end, only beside --at&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op-revert/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit op revise</title><link>https://docs.retrofit.sh/current/commands/retrofit-op-revise/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op-revise/</guid><description>&lt;h1 id="retrofit-op-revise"&gt;&lt;code&gt;retrofit op revise&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op-revise" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Patch bound parameters on an unsealed op&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op revise &amp;lt;opid&amp;gt; [&amp;lt;key&amp;gt;=&amp;lt;value&amp;gt;...] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 22ch"&gt; --batch read newline-separated revise commands from stdin (transactional)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 22ch"&gt; --dry-run preview the proposed tail without writing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 22ch"&gt; -h, --help help for revise&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 22ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 22ch"&gt; -i, --interactive open an editor on the selector&amp;#39;s ops&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op-revise/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit op revise --help-all&lt;/code&gt; adds:&lt;/p&gt;</description></item><item><title>retrofit op seal</title><link>https://docs.retrofit.sh/current/commands/retrofit-op-seal/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op-seal/</guid><description>&lt;h1 id="retrofit-op-seal"&gt;&lt;code&gt;retrofit op seal&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op-seal" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Seal the unsealed tail of the oplog. The Seal covers every op from&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;the first unsealed op through the current tail; subsequent edits to&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;those ops are detected by `retrofit validate`.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Tail-append only: sealing a sub-range of the unsealed tail is out&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;of scope.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;A range that declares reference data seals only when every reference&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;record it covers is witnessed, and only when every declared product&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;born in it that a fresh build cannot route rows into has a record of&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;its own (reference-rows-uncaptured): a JoinTable&amp;#39;s product, a&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;SplitTable&amp;#39;s pieces and its source, a MergeTable&amp;#39;s into table, an&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;InlineTable&amp;#39;s survivor, and an UnjoinTable child that carries no key.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;The op moves the source&amp;#39;s rows into the product in every migrated&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;database, so a fresh build needs them captured. A CopyTable clone, an&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;ExtractTable child and an UnjoinTable keyed child need none: their&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;rows are the source&amp;#39;s at the op, which a fresh build routes into them.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;A data record whose anchor-op names no live op in the log refuses the&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;seal as data check does (data-file-anchor-unresolved). A record whose&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;anchor was revised or removed moves with retrofit data reanchor; after&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;a regenerated log, or to pick the opid yourself, re-pin it with&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;retrofit data repin. Then seal.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Run with --help-all for recovery guidance (e.g. removing a Seal&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;authored on the wrong branch).&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op seal [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --compact string compact the tail to this frontier file, then seal it, in one write&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -h, --help help for seal&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --reason string optional reason text recorded on the Seal&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op-seal/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit op seal --help-all&lt;/code&gt; adds:&lt;/p&gt;</description></item><item><title>retrofit op show</title><link>https://docs.retrofit.sh/current/commands/retrofit-op-show/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op-show/</guid><description>&lt;h1 id="retrofit-op-show"&gt;&lt;code&gt;retrofit op show&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op-show" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Render ops from the oplog&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op show [&amp;lt;selector&amp;gt;] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --annotate annotate every param with kind/enum metadata&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --filter &amp;lt;key&amp;gt;=&amp;lt;value&amp;gt; scalar equality predicate &amp;lt;key&amp;gt;=&amp;lt;value&amp;gt;; repeat for AND&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --findings after each op, print body-bearing Findings&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --framing string grammar shape in text mode: log | add | revise (default log: on-disk record) (default &amp;#34;log&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --head int keep the first N ops after filtering (N &amp;gt; 0)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; -h, --help help for show&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --include-sealed widen scope to include sealed ops&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; -k, --keys strings project only these editable keys (comma-separated; repeatable)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --long one param per line with shell line-continuation&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --raw print one fixed-shape key=value record per AddColumn op (op, name, typ, typeRef); ignores --keys/--framing/--filter/--touching/--tail/--head&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --tail int keep the last N ops after filtering (N &amp;gt; 0)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --touching stringArray match ops referencing this element; repeat for OR&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op-show/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit op show --help-all&lt;/code&gt; adds:&lt;/p&gt;</description></item><item><title>retrofit op squash</title><link>https://docs.retrofit.sh/current/commands/retrofit-op-squash/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op-squash/</guid><description>&lt;h1 id="retrofit-op-squash"&gt;&lt;code&gt;retrofit op squash&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op-squash" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Reduce a range of the unsealed tail to its net effect: the&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;smallest op sequence whose replay leaves the same snapshot. The range takes&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;op remove&amp;#39;s selector; --unshared &amp;lt;file&amp;gt; bounds the squash by the ops that&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;file holds and reduces the whole unsealed tail when no range is given.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op squash [&amp;lt;range&amp;gt;] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 26ch"&gt; --dry-run print the range&amp;#39;s lines as the write would leave them and write nothing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 26ch"&gt; -h, --help help for squash&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 26ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 26ch"&gt; --unshared string never net, re-mint or remove an op this file holds; compact to the same bound&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op-squash/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit op truncate</title><link>https://docs.retrofit.sh/current/commands/retrofit-op-truncate/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op-truncate/</guid><description>&lt;h1 id="retrofit-op-truncate"&gt;&lt;code&gt;retrofit op truncate&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op-truncate" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Rewind the oplog to a checkpoint by removing a suffix of ops&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op truncate [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --drop-seals int also peel back this many Seal records (and everything each covers); the flag is the attestation, and each Seal removed is reported&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --dry-run preview the opids that would be removed without writing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -h, --help help for truncate&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op-truncate/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit op truncate --help-all&lt;/code&gt; adds:&lt;/p&gt;</description></item><item><title>retrofit op unseal</title><link>https://docs.retrofit.sh/current/commands/retrofit-op-unseal/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-op-unseal/</guid><description>&lt;h1 id="retrofit-op-unseal"&gt;&lt;code&gt;retrofit op unseal&lt;/code&gt;&lt;a class="anchor" href="#retrofit-op-unseal" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Demote the most-recent N Seal record(s), keeping their ops as unsealed tail&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit op unseal [N] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --dry-run preview the Seal opids that would be removed without writing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for unseal&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-op-unseal/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit op unseal --help-all&lt;/code&gt; adds:&lt;/p&gt;</description></item><item><title>retrofit ops</title><link>https://docs.retrofit.sh/current/commands/retrofit-ops/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-ops/</guid><description>&lt;h1 id="retrofit-ops"&gt;&lt;code&gt;retrofit ops&lt;/code&gt;&lt;a class="anchor" href="#retrofit-ops" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Run bulk maintenance over the oplog&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit ops&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit ops [command]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Available Commands:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; upgrade-sql-bodies Upgrade LANGUAGE sql opaque function bodies to BEGIN ATOMIC&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for ops&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Use &amp;#34;retrofit ops [command] --help&amp;#34; for more information about a command.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-ops/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit ops upgrade-sql-bodies</title><link>https://docs.retrofit.sh/current/commands/retrofit-ops-upgrade-sql-bodies/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-ops-upgrade-sql-bodies/</guid><description>&lt;h1 id="retrofit-ops-upgrade-sql-bodies"&gt;&lt;code&gt;retrofit ops upgrade-sql-bodies&lt;/code&gt;&lt;a class="anchor" href="#retrofit-ops-upgrade-sql-bodies" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Upgrade LANGUAGE sql opaque function bodies to BEGIN ATOMIC&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit ops upgrade-sql-bodies [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --dry-run preview without writing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; -h, --help help for upgrade-sql-bodies&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-ops-upgrade-sql-bodies/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit reconcile</title><link>https://docs.retrofit.sh/current/commands/retrofit-reconcile/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-reconcile/</guid><description>&lt;h1 id="retrofit-reconcile"&gt;&lt;code&gt;retrofit reconcile&lt;/code&gt;&lt;a class="anchor" href="#retrofit-reconcile" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit reconcile&lt;/code&gt; closes a fork: two or more ops that share a&#10;&lt;code&gt;prev=&lt;/code&gt;, as a merge of two branches that each added ops leaves them&#10;(&lt;a href="https://docs.retrofit.sh/current/branches-and-merges/#when-two-branches-change-the-oplog"&gt;When two branches change the oplog&lt;/a&gt;).&#10;It picks an order for the forked blocks and rewrites &lt;code&gt;prev=&lt;/code&gt; into one&#10;chain, and every op keeps its opid.&#10;&lt;a href="https://docs.retrofit.sh/current/merge-branches/"&gt;Merge branches that change the oplog&lt;/a&gt; is the task&#10;guide.&lt;/p&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;From &lt;code&gt;retrofit reconcile --help&lt;/code&gt;:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit reconcile [&amp;lt;fork-selector&amp;gt;] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="description"&gt;Description&lt;a class="anchor" href="#description" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;With no mode flag, reconcile reports each fork and whether a clean order&#10;exists, and writes nothing. &lt;code&gt;--clean&lt;/code&gt; and&#10;&lt;code&gt;--accept-dirty&lt;/code&gt; write. &lt;code&gt;retrofit reconcile --help-all&lt;/code&gt; gives the bias,&#10;strictness and selection flags, how a fork of three or more blocks&#10;closes, and the three-file mode, and the&#10;&lt;a href="https://docs.retrofit.sh/current/output-contract/"&gt;Output contract&lt;/a&gt; gives each mode&amp;rsquo;s text and JSON.&lt;/p&gt;</description></item><item><title>retrofit schema</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema/</guid><description>&lt;h1 id="retrofit-schema"&gt;&lt;code&gt;retrofit schema&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Manage registered schemas&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema [command]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Available Commands:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; create Create a new oplog and register the schema&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; database-at Write, clear or print the cut the local database is at (the apply-risk pin)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; engine Read or set a schema&amp;#39;s engine version (production pin &amp;#43; emit target)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; form Print or switch the oplog&amp;#39;s form line (merge or compact)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; list List registered schemas (name, path, engine version, default marker)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; move Move a schema&amp;#39;s oplog to another directory&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; ref-tables Read or edit a schema&amp;#39;s reference-data capture policy&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; remove Remove a registered schema (deletes the oplog file by default)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; scope Manage [directory_scope] entries&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; set-default Set or clear default_schema in retrofit.toml&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for schema&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Use &amp;#34;retrofit schema [command] --help&amp;#34; for more information about a command.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema create</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-create/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-create/</guid><description>&lt;h1 id="retrofit-schema-create"&gt;&lt;code&gt;retrofit schema create&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-create" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Create a new oplog and register the schema in retrofit.toml.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 11ch"&gt;&amp;lt;name&amp;gt; schema identifier (SQL-identifier shape).&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&amp;lt;location&amp;gt; optional target DIRECTORY (an existing dir, or a&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 13ch"&gt; trailing-/ path to be created); the oplog file is&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 13ch"&gt; derived as &amp;lt;name&amp;gt;.oplog.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Run with --help-all for the name-charset rules.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema create &amp;lt;name&amp;gt; [&amp;lt;location&amp;gt;] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --engine-version &amp;lt;15|16|17|18&amp;gt; supported major &amp;lt;15|16|17|18&amp;gt; for the new schema (default: project engine_version)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --form &amp;lt;merge|compact&amp;gt; the new oplog&amp;#39;s form &amp;lt;merge|compact&amp;gt; (default &amp;#34;merge&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; -h, --help help for create&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --is-default pin this schema as default_schema&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 39ch"&gt; --scope stringArray directory to scope to this schema (repeatable)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-create/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit schema create --help-all&lt;/code&gt; adds:&lt;/p&gt;</description></item><item><title>retrofit schema database-at</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-database-at/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-database-at/</guid><description>&lt;h1 id="retrofit-schema-database-at"&gt;&lt;code&gt;retrofit schema database-at&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-database-at" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;With &amp;lt;cut&amp;gt;, write the schema&amp;#39;s line of the local pin file .retrofit/database-at; --clear removes it;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;bare, print the pin in force and its carrier. op add, import and drift judge apply-risk from the pin.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema database-at [&amp;lt;cut&amp;gt;] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --clear remove the schema&amp;#39;s line from the pin file&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; -h, --help help for database-at&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-database-at/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema engine</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-engine/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-engine/</guid><description>&lt;h1 id="retrofit-schema-engine"&gt;&lt;code&gt;retrofit schema engine&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-engine" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Read (no &amp;lt;version&amp;gt;) or set (with &amp;lt;version&amp;gt;) a schema&amp;#39;s two&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;engine-version axes: the production pin (oplog header) and&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;the emit target ([[schema]] engine_version). Default form&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;sets both axes. Selects schema via --schema or resolver chain.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema engine [&amp;lt;version&amp;gt;] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --config-only set only the toml target axis (oplog header untouched)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --dry-run report the would-action without writing&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; -h, --help help for engine&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-engine/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit schema engine --help-all&lt;/code&gt; adds:&lt;/p&gt;</description></item><item><title>retrofit schema form</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-form/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-form/</guid><description>&lt;h1 id="retrofit-schema-form"&gt;&lt;code&gt;retrofit schema form&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-form" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Print (no argument) or switch a schema&amp;#39;s oplog form. compact to merge&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;changes the form line; merge to compact compacts every range, sealed&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;ones included, the switch being the attestation. Naming the form the&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;file holds changes no line. Selects schema via --schema or resolver chain.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema form [merge|compact] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; -h, --help help for form&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via chain if omitted)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-form/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema list</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-list/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-list/</guid><description>&lt;h1 id="retrofit-schema-list"&gt;&lt;code&gt;retrofit schema list&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-list" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Enumerate the [[schema]] entries in retrofit.toml: name, oplog&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;path, resolved engine version, and which one is the default_schema&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;pin. An empty registry succeeds with zero rows.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema list [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for list&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-list/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema move</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-move/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-move/</guid><description>&lt;h1 id="retrofit-schema-move"&gt;&lt;code&gt;retrofit schema move&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-move" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Move a schema&amp;#39;s oplog to another directory&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema move &amp;lt;directory&amp;gt; [--schema &amp;lt;name&amp;gt;] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; -h, --help help for move&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-move/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema ref-tables</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-ref-tables/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-ref-tables/</guid><description>&lt;h1 id="retrofit-schema-ref-tables"&gt;&lt;code&gt;retrofit schema ref-tables&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-ref-tables" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Read or edit a schema&amp;#39;s reference-data capture policy.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;A table declared as reference data holds the rows the application reads but&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;never writes, such as currency codes, country lists and status enumerations.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Rows the application writes are seed or transition data and are not declared&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;here.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;The declaration is an attribute of the table&amp;#39;s element, carried in the oplog:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;add and remove append one SetReferenceData op per resolved table. Nothing is&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;stored in retrofit.toml, and the declaration survives a rename because it&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;lives on the element rather than on its name.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;The declared set is the reference capture scope of every producer run: import,&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;data capture, drift and data scaffold each read the set at their own minting&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;cut and capture a declared table&amp;#39;s rows as reference data.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;The bare parent reads and reports the declared set. add and remove edit it and&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;then report the whole result; there is deliberately no list subcommand.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Each argument is an exact relname or a filepath.Match glob, resolved against&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;the live tables of the read cut: HEAD unless --at &amp;lt;opid&amp;gt; names one. A name&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;that resolves to nothing is refused: a declaration names a live element, so&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;the table must exist before it can be declared. A glob is never stored; the&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;resolved table names are what the oplog carries.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema ref-tables [flags]&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema ref-tables [command]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Available Commands:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; add Declare one or more tables as the schema&amp;#39;s reference data&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; remove Undeclare one or more of the schema&amp;#39;s reference-data tables&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --at &amp;lt;opid&amp;gt; read cut &amp;lt;opid&amp;gt; (HEAD when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --data-root &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that overrides the schema&amp;#39;s `data_root`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; -h, --help help for ref-tables&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Use &amp;#34;retrofit schema ref-tables [command] --help&amp;#34; for more information about a command.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-ref-tables/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema ref-tables add</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-ref-tables-add/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-ref-tables-add/</guid><description>&lt;h1 id="retrofit-schema-ref-tables-add"&gt;&lt;code&gt;retrofit schema ref-tables add&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-ref-tables-add" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Declare one or more tables as the schema&amp;#39;s reference data&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema ref-tables add &amp;lt;table&amp;gt;... [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --dry-run report the would-be oplog entries without minting&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for add&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --at &amp;lt;opid&amp;gt; read cut &amp;lt;opid&amp;gt; (HEAD when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --data-root &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that overrides the schema&amp;#39;s `data_root`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-ref-tables-add/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema ref-tables remove</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-ref-tables-remove/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-ref-tables-remove/</guid><description>&lt;h1 id="retrofit-schema-ref-tables-remove"&gt;&lt;code&gt;retrofit schema ref-tables remove&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-ref-tables-remove" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Undeclare one or more of the schema&amp;#39;s reference-data tables&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema ref-tables remove &amp;lt;table&amp;gt;... [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --dry-run report the would-be oplog entries without minting&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for remove&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --at &amp;lt;opid&amp;gt; read cut &amp;lt;opid&amp;gt; (HEAD when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --data-root &amp;lt;path&amp;gt; root &amp;lt;path&amp;gt; that overrides the schema&amp;#39;s `data_root`&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 27ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-ref-tables-remove/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema remove</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-remove/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-remove/</guid><description>&lt;h1 id="retrofit-schema-remove"&gt;&lt;code&gt;retrofit schema remove&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-remove" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Remove a schema&amp;#39;s [[schema]] entry from retrofit.toml and delete&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;its oplog file, whatever it holds, sealed ops included (pass&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;--keep-oplog to keep it). A committed oplog can be restored from git.&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema remove &amp;lt;name&amp;gt; [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 21ch"&gt; -h, --help help for remove&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 21ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 21ch"&gt; --keep-oplog unregister the schema but leave the oplog file on disk&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-remove/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema scope</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-scope/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-scope/</guid><description>&lt;h1 id="retrofit-schema-scope"&gt;&lt;code&gt;retrofit schema scope&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-scope" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Manage [directory_scope] entries&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema scope&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema scope [command]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Available Commands:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; add Add a [directory_scope] entry&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 14ch"&gt; remove Remove a [directory_scope] entry&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for scope&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Use &amp;#34;retrofit schema scope [command] --help&amp;#34; for more information about a command.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-scope/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema scope add</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-scope-add/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-scope-add/</guid><description>&lt;h1 id="retrofit-schema-scope-add"&gt;&lt;code&gt;retrofit schema scope add&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-scope-add" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Add a [directory_scope] entry&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema scope add &amp;lt;dir&amp;gt; [--schema &amp;lt;name&amp;gt;] [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; -h, --help help for add&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 24ch"&gt; --schema &amp;lt;name&amp;gt; registered schema &amp;lt;name&amp;gt; (resolves via the chain when omitted)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-scope-add/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema scope remove</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-scope-remove/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-scope-remove/</guid><description>&lt;h1 id="retrofit-schema-scope-remove"&gt;&lt;code&gt;retrofit schema scope remove&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-scope-remove" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Remove a [directory_scope] entry&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema scope remove &amp;lt;dir&amp;gt; [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for remove&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-scope-remove/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit schema set-default</title><link>https://docs.retrofit.sh/current/commands/retrofit-schema-set-default/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-schema-set-default/</guid><description>&lt;h1 id="retrofit-schema-set-default"&gt;&lt;code&gt;retrofit schema set-default&lt;/code&gt;&lt;a class="anchor" href="#retrofit-schema-set-default" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Set or clear default_schema in retrofit.toml&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit schema set-default &amp;lt;name&amp;gt; | --unset [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; -h, --help help for set-default&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 19ch"&gt; --unset remove default_schema from retrofit.toml&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-schema-set-default/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;</description></item><item><title>retrofit snapshot</title><link>https://docs.retrofit.sh/current/commands/retrofit-snapshot/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-snapshot/</guid><description>&lt;h1 id="retrofit-snapshot"&gt;&lt;code&gt;retrofit snapshot&lt;/code&gt;&lt;a class="anchor" href="#retrofit-snapshot" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit snapshot&lt;/code&gt; writes the schema at one point in the&#10;&lt;a href="https://docs.retrofit.sh/current/oplog/#the-oplog"&gt;oplog&lt;/a&gt; to stdout as SQL: its DDL, the rows of its&#10;reference tables, and the seed datasets &lt;code&gt;--label&lt;/code&gt; names. It reads the&#10;oplog, the configuration and the data files under the schema&amp;rsquo;s&#10;&lt;code&gt;data_root&lt;/code&gt;, and writes no file except a &lt;code&gt;--skip-manifest&lt;/code&gt;.&#10;&lt;a href="https://docs.retrofit.sh/current/emit-the-schema/"&gt;Emit the schema as SQL&lt;/a&gt; is the task guide.&lt;/p&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;From &lt;code&gt;retrofit snapshot --help&lt;/code&gt;:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit snapshot [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="description"&gt;Description&lt;a class="anchor" href="#description" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;snapshot replays the oplog up to one point, the &lt;strong&gt;cut&lt;/strong&gt;, and writes what&#10;the replay builds: the live tables, columns, constraints, indexes and&#10;views, with their names and types at the cut, in the order valid DDL&#10;needs. The schema is the one &lt;code&gt;--schema&lt;/code&gt; names, or the one the&#10;&lt;a href="https://docs.retrofit.sh/current/how-a-command-picks-its-schema/#the-resolver-chain"&gt;resolver chain&lt;/a&gt; selects.&#10;The same oplog, cut, corpus and flags give byte-identical output.&lt;/p&gt;</description></item><item><title>retrofit validate</title><link>https://docs.retrofit.sh/current/commands/retrofit-validate/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/current/commands/retrofit-validate/</guid><description>&lt;h1 id="retrofit-validate"&gt;&lt;code&gt;retrofit validate&lt;/code&gt;&lt;a class="anchor" href="#retrofit-validate" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Validate retrofit.toml, project layout, and the oplog&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="synopsis"&gt;Synopsis&lt;a class="anchor" href="#synopsis" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Usage:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 4ch"&gt; retrofit validate [flags]&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="options"&gt;Options&lt;a class="anchor" href="#options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --allow-database-apply [apply context] with --history, attest that CI applies the range to a database before it lands: the opaque-body check lists its findings as advisory and does not fail&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --allow-unmerged-fork report an unmerged fork as an advisory and exit 0; apply-risk hazards, seal-integrity refusals and standing violations still fail the run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --every-commit with --history, validate every commit of the PR in the bundle, not only the candidate&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --fail-on-apply-risk fail (exit 2) on the apply-risk hazards in the migration window since the latest Seal (or the cut --from names): validating-fk, validating-check, add-not-null and a column-type change (a cast) that rewrites the table or scans it for an index or check, on a table that may hold rows; add-unique stays advisory, and so does a cast whose recovery retrofit does not vouch for&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --from string with the apply-risk gate, judge the window (&amp;lt;cut&amp;gt;, head] in place of (latest Seal, head]; an anchor (root, last, seal, with ^ or ~N) or an opid prefix&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; -h, --help help for validate&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --help-all show extended help (vocabulary, semantics, caveats)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 31ch"&gt; --history string check the history bundle at &amp;lt;dir&amp;gt; (written by the CI snippet; retrofit runs no git)&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;h2 id="global-options"&gt;Global options&lt;a class="anchor" href="#global-options" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Global Flags:&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --as string output mode: text | json (default &amp;#34;text&amp;#34;)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -C, --chdir string treat &amp;lt;dir&amp;gt; as the working directory for the entire run&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --config string retrofit.toml path (overrides discovery; also accepts $RETROFIT_CONFIG)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -f, --file string oplog file path; selects a registered [[schema]] path (overrides discovery)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; --no-consolidate render every advisory occurrence instead of collapsing repeats&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -q, --quiet count suppress the advisory tier on stderr; stack (-qq) to drop it whole (errors and results still print)&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 25ch"&gt; -v, --verbose reveal info-tier advisories on stderr&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;Docs: https://docs.retrofit.sh/current/commands/retrofit-validate/&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit validate --help-all&lt;/code&gt; adds:&lt;/p&gt;</description></item></channel></rss>