<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>retrofit</title><link>https://docs.retrofit.sh/wip/</link><description>Recent content on retrofit</description><generator>Hugo</generator><language>en-us</language><atom:link href="https://docs.retrofit.sh/wip/index.xml" rel="self" type="application/rss+xml"/><item><title>Install</title><link>https://docs.retrofit.sh/wip/install/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/install/</guid><description>&lt;h1 id="install"&gt;Install&lt;a class="anchor" href="#install" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Releases are prebuilt binaries for Linux with glibc 2.34 or later (Ubuntu 22.04, Debian 12, RHEL 9 and newer)&#10;and for macOS 13 Ventura or later, on amd64 and arm64.&#10;Other platforms, Windows included, have no release build.&lt;/p&gt;&#10;&lt;h2 id="install-script"&gt;Install script&lt;a class="anchor" href="#install-script" 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-sh" data-lang="sh"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;curl -fsSL https://retrofit.sh/install | sh&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;The script installs the latest release to &lt;code&gt;$RETROFIT_INSTALL_DIR&lt;/code&gt;, else&#10;&lt;code&gt;~/.local/bin&lt;/code&gt;, without sudo. It checks the archive&amp;rsquo;s SHA-256 against the&#10;release&amp;rsquo;s &lt;code&gt;checksums.txt&lt;/code&gt; before extracting anything. Pass flags after&#10;&lt;code&gt;sh -s --&lt;/code&gt;:&lt;/p&gt;</description></item><item><title>Create a project</title><link>https://docs.retrofit.sh/wip/create-a-project/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/create-a-project/</guid><description>&lt;h1 id="create-a-project"&gt;Create a project&lt;a class="anchor" href="#create-a-project" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;A 5-minute walkthrough: build (or bootstrap) a small schema, look at the&#10;&lt;a href="https://docs.retrofit.sh/wip/glossary/#oplog"&gt;oplog&lt;/a&gt; file you just created, and emit DDL. It starts&#10;from an installed retrofit; &lt;a href="https://docs.retrofit.sh/wip/install/"&gt;Install&lt;/a&gt; covers that.&lt;/p&gt;&#10;&lt;p&gt;There are two ways to start an oplog:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;From scratch&lt;/strong&gt;: register a schema and type each DDL change as a&#10;command, one at a time. Best when you&amp;rsquo;re designing a new schema or&#10;learning retrofit. Jump to&#10;&lt;a href="#start-from-scratch"&gt;Start from scratch&lt;/a&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;From an existing &lt;code&gt;.sql&lt;/code&gt; file&lt;/strong&gt;: bootstrap an oplog from&#10;hand-written DDL or a &lt;code&gt;pg_dump --schema-only&lt;/code&gt;. &lt;code&gt;import&lt;/code&gt; walks the&#10;SQL and records the same changes as an oplog you can evolve from&#10;there. Jump to&#10;&lt;a href="#start-from-existing-sql"&gt;Start from existing SQL&lt;/a&gt;.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;The two paths share &lt;code&gt;init&lt;/code&gt;, &lt;code&gt;snapshot&lt;/code&gt;, and &lt;code&gt;op seal&lt;/code&gt;; only the&#10;middle differs.&lt;/p&gt;</description></item><item><title>What's next</title><link>https://docs.retrofit.sh/wip/whats-next/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/whats-next/</guid><description>&lt;h1 id="whats-next"&gt;What&amp;rsquo;s next&lt;a class="anchor" href="#whats-next" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;You have a project, an &lt;a href="https://docs.retrofit.sh/wip/glossary/#oplog"&gt;oplog&lt;/a&gt; (the file of schema&#10;changes) you can read, and the DDL it emits. These pages take it further.&lt;/p&gt;&#10;&lt;h2 id="learn-the-model"&gt;Learn the model&lt;a class="anchor" href="#learn-the-model" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/oplog/"&gt;The oplog&lt;/a&gt;: what retrofit records, element identity, and&#10;replay.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/sealing-and-deploying/"&gt;Sealing and deploying&lt;/a&gt;:&#10;&lt;a href="https://docs.retrofit.sh/wip/glossary/#seal"&gt;sealed&lt;/a&gt; and unsealed ops, where each database is,&#10;and drift.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/branches-and-merges/"&gt;Branches and merges&lt;/a&gt;: what a merge does to&#10;the oplog.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/data-files/"&gt;Data files&lt;/a&gt;: where rows live beside the oplog.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/principles/"&gt;Principles&lt;/a&gt;: the rules retrofit upholds.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="ship-a-change"&gt;Ship a change&lt;a class="anchor" href="#ship-a-change" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/emit-a-migration/"&gt;Emit a migration script&lt;/a&gt;: the script that takes a&#10;database from one point in the oplog to another.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/merge-branches/"&gt;Merge branches that change the oplog&lt;/a&gt;: two branches that&#10;each added changes.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/check-a-pull-request/"&gt;Check a pull request in CI&lt;/a&gt;: fail a pull request whose&#10;changes are risky to apply.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/record-outside-changes/"&gt;Record a schema changed outside the oplog&lt;/a&gt;: catch the oplog&#10;up with a database someone altered by hand.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="shape-the-project"&gt;Shape the project&lt;a class="anchor" href="#shape-the-project" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/several-schemas/"&gt;Work with several schemas&lt;/a&gt;: register more&#10;schemas, scope them to directories, and pick one for a command.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/exclude-objects/"&gt;Exclude objects the project does not own&lt;/a&gt;: keep a&#10;provider&amp;rsquo;s tables, extensions and schemas out of the oplog.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://docs.retrofit.sh/wip/row-data/"&gt;Work with row data&lt;/a&gt;: list the rows the emit commands&#10;apply, and write a record by hand.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="look-a-command-up"&gt;Look a command up&lt;a class="anchor" href="#look-a-command-up" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Run any command with &lt;code&gt;--help&lt;/code&gt; for its grammar and flags, or &lt;code&gt;--help-all&lt;/code&gt;&#10;for the extended vocabulary and caveats. The same text is on each&#10;command&amp;rsquo;s page in the Command reference, and these pages cover the&#10;rest:&lt;/p&gt;</description></item><item><title>The oplog</title><link>https://docs.retrofit.sh/wip/oplog/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/oplog/</guid><description>&lt;h1 id="the-oplog"&gt;The oplog&lt;a class="anchor" href="#the-oplog" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;What retrofit records: an oplog of schema changes, each change an op on&#10;one line, each element it names known by an identity that outlasts its&#10;name, and the schema replay builds from them.&#10;&lt;a href="https://docs.retrofit.sh/wip/principles/"&gt;Principles&lt;/a&gt; has the rules retrofit upholds.&lt;/p&gt;&#10;&lt;h2 id="the-premise"&gt;The premise&lt;a class="anchor" href="#the-premise" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;What retrofit records is &lt;strong&gt;how the schema changes&lt;/strong&gt;. You record semantic&#10;operations (&lt;em&gt;rename this column&lt;/em&gt;, &lt;em&gt;cast this type&lt;/em&gt;, &lt;em&gt;extract this wide&#10;table into two narrower ones&lt;/em&gt;), and retrofit writes the SQL from them.&lt;/p&gt;</description></item><item><title>Sealing and deploying</title><link>https://docs.retrofit.sh/wip/sealing-and-deploying/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/sealing-and-deploying/</guid><description>&lt;h1 id="sealing-and-deploying"&gt;Sealing and deploying&lt;a class="anchor" href="#sealing-and-deploying" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;How a range of the oplog becomes stable history, how you track where&#10;each database is, and what to do when one changes outside the oplog.&lt;/p&gt;&#10;&lt;h2 id="sealed-and-unsealed-ops"&gt;Sealed and unsealed ops&lt;a class="anchor" href="#sealed-and-unsealed-ops" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;The oplog has two regions: &lt;strong&gt;sealed&lt;/strong&gt; and &lt;strong&gt;unsealed&lt;/strong&gt;.&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Unsealed tail&lt;/strong&gt;: the working surface. You can append (&lt;code&gt;op add&lt;/code&gt;),&#10;edit (&lt;code&gt;op revise&lt;/code&gt;), or remove (&lt;code&gt;op remove&lt;/code&gt;) ops freely. You can open&#10;the editor buffer (&lt;code&gt;op revise -i&lt;/code&gt;) and delete lines. No confirmation&#10;step guards it, because no database has applied it. That holds only&#10;while nobody has, so a tail shared through git is sealed before&#10;anyone applies it.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Sealed range&lt;/strong&gt;: frozen history. Once you &lt;code&gt;op seal&lt;/code&gt;, the range is&#10;locked: a Merkle digest over the sealed ops&amp;rsquo; canonical bytes is&#10;recorded, and any in-place edit to a sealed op breaks verification.&#10;A seal is the team&amp;rsquo;s agreement that the range is stable, because&#10;branches and databases build on it; it records no deployment.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;Seal a range before anyone else applies it. New work goes on a fresh&#10;unsealed tail behind the seal. &lt;code&gt;migrate&lt;/code&gt; starts from the latest seal by&#10;default, because the agreement makes it the expected baseline; a&#10;database behind it names its cut with &lt;code&gt;--from&lt;/code&gt;.&lt;/p&gt;</description></item><item><title>Branches and merges</title><link>https://docs.retrofit.sh/wip/branches-and-merges/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/branches-and-merges/</guid><description>&lt;h1 id="branches-and-merges"&gt;Branches and merges&lt;a class="anchor" href="#branches-and-merges" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;What a merge of two branches does to the oplog, and how the oplog&amp;rsquo;s form&#10;decides what a merge can be resolved by.&lt;/p&gt;&#10;&lt;h2 id="when-two-branches-change-the-oplog"&gt;When two branches change the oplog&lt;a class="anchor" href="#when-two-branches-change-the-oplog" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Two branches that each add ops after the same op merge into an oplog&#10;where two ops share one &lt;code&gt;prev=&lt;/code&gt;: a &lt;strong&gt;fork&lt;/strong&gt;. git&amp;rsquo;s &lt;code&gt;merge=union&lt;/code&gt; rule&#10;keeps both sides&amp;rsquo; lines, so no op is lost. What is lost is the order.&lt;/p&gt;</description></item><item><title>Data files</title><link>https://docs.retrofit.sh/wip/data-files/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/data-files/</guid><description>&lt;h1 id="data-files"&gt;Data files&lt;a class="anchor" href="#data-files" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;The oplog records schema changes. The rows a schema&amp;rsquo;s tables hold, as&#10;&lt;code&gt;INSERT&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;DELETE&lt;/code&gt; and &lt;code&gt;MERGE&lt;/code&gt; statements, are kept beside&#10;it in data files: runnable &lt;code&gt;.sql&lt;/code&gt; files, one table each, under the&#10;schema&amp;rsquo;s &lt;code&gt;data_root&lt;/code&gt; (&lt;code&gt;data&lt;/code&gt; by default). You commit them with the&#10;oplog.&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;import&lt;/code&gt; writes a data file for each row statement it finds in a&#10;source, and &lt;code&gt;data capture&lt;/code&gt;, &lt;code&gt;drift&lt;/code&gt; and &lt;code&gt;data scaffold&lt;/code&gt; write them too.&#10;&lt;a href="https://docs.retrofit.sh/wip/row-data/"&gt;Work with row data&lt;/a&gt; shows how to write one by hand.&lt;/p&gt;</description></item><item><title>Kinds of operators</title><link>https://docs.retrofit.sh/wip/kinds-of-operators/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/kinds-of-operators/</guid><description>&lt;h1 id="kinds-of-operators"&gt;Kinds of operators&lt;a class="anchor" href="#kinds-of-operators" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;The kinds of change an operator records, and the two commands that write&#10;ops from SQL.&lt;/p&gt;&#10;&lt;h2 id="operators-by-category"&gt;Operators by category&lt;a class="anchor" href="#operators-by-category" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;The operator catalog is grouped by what kind of change the op&#10;expresses. &lt;a href="https://docs.retrofit.sh/wip/operators/"&gt;Operators&lt;/a&gt; lists every operator with its&#10;category and which commands handle it. The categories:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Schema&lt;/strong&gt;: &lt;code&gt;CreateSchema&lt;/code&gt;. Root element.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Table&lt;/strong&gt;: &lt;code&gt;CreateTable&lt;/code&gt;, &lt;code&gt;DropTable&lt;/code&gt;, &lt;code&gt;RenameTable&lt;/code&gt;, &lt;code&gt;CopyTable&lt;/code&gt;,&#10;&lt;code&gt;ExtractTable&lt;/code&gt; / &lt;code&gt;JoinTable&lt;/code&gt; (column-axis split/merge),&#10;&lt;code&gt;InlineTable&lt;/code&gt; / &lt;code&gt;UnjoinTable&lt;/code&gt; (fold an extracted child back in, take&#10;a join apart), &lt;code&gt;SplitTable&lt;/code&gt; / &lt;code&gt;MergeTable&lt;/code&gt; (row-axis split/merge),&#10;&lt;code&gt;MoveColumn&lt;/code&gt;, &lt;code&gt;SetReplicaIdentity&lt;/code&gt;, &lt;code&gt;SetTableComment&lt;/code&gt;, the&#10;reference-data ops (&lt;code&gt;SetReferenceData&lt;/code&gt;, &lt;code&gt;WitnessReferenceData&lt;/code&gt;), and&#10;the declarative &lt;strong&gt;partitioning&lt;/strong&gt; ops below.&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;em&gt;Partitioning&lt;/em&gt;: &lt;code&gt;CreatePartition&lt;/code&gt;&#10;(born-as-child &lt;code&gt;PARTITION OF&lt;/code&gt;), &lt;code&gt;AttachPartition&lt;/code&gt; /&#10;&lt;code&gt;DetachPartition&lt;/code&gt; (subordinate an existing table, emancipate one&#10;back), &lt;code&gt;PartitionTable&lt;/code&gt; / &lt;code&gt;DepartitionTable&lt;/code&gt; (identity-preserving&#10;convert between a plain heap and a partitioned parent). These are&#10;Table-category ops, not a category of their own: partitioning is a&#10;&lt;em&gt;physical storage attribute&lt;/em&gt; of a table that persists across the&#10;change, so the op acts on a table the way a rename or a comment&#10;does.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Column&lt;/strong&gt;: &lt;code&gt;AddColumn&lt;/code&gt;, &lt;code&gt;DropColumn&lt;/code&gt;, &lt;code&gt;RenameColumn&lt;/code&gt;, &lt;code&gt;CastColumn&lt;/code&gt;,&#10;&lt;code&gt;CopyColumn&lt;/code&gt;, &lt;code&gt;SetDefault&lt;/code&gt; / &lt;code&gt;DropDefault&lt;/code&gt;, identity ops&#10;(&lt;code&gt;AddIdentity&lt;/code&gt;, &lt;code&gt;DropIdentity&lt;/code&gt;, &lt;code&gt;SetIdentityGeneration&lt;/code&gt;,&#10;&lt;code&gt;SetIdentityOptions&lt;/code&gt;), &lt;code&gt;RenameOwnedSequence&lt;/code&gt;,&#10;NOT NULL ops (&lt;code&gt;AddNotNull&lt;/code&gt;, &lt;code&gt;DropNotNull&lt;/code&gt;),&#10;&lt;code&gt;DropGeneratedExpression&lt;/code&gt;, &lt;code&gt;SetColumnComment&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Constraint&lt;/strong&gt;: &lt;code&gt;AddPrimaryKey&lt;/code&gt;, &lt;code&gt;ChangePrimaryKey&lt;/code&gt;,&#10;&lt;code&gt;DropPrimaryKey&lt;/code&gt;, &lt;code&gt;AddForeignKey&lt;/code&gt;, &lt;code&gt;DropForeignKey&lt;/code&gt;, &lt;code&gt;AddUnique&lt;/code&gt;,&#10;&lt;code&gt;DropUnique&lt;/code&gt;, &lt;code&gt;AddCheck&lt;/code&gt;, &lt;code&gt;DropCheck&lt;/code&gt;, &lt;code&gt;AddExclude&lt;/code&gt;, &lt;code&gt;DropExclude&lt;/code&gt;,&#10;&lt;code&gt;RenameConstraint&lt;/code&gt;, &lt;code&gt;ValidateConstraint&lt;/code&gt;, &lt;code&gt;SetConstraintDeferrable&lt;/code&gt;,&#10;&lt;code&gt;SetConstraintInitiallyDeferred&lt;/code&gt;, &lt;code&gt;SetConstraintEnforced&lt;/code&gt;,&#10;&lt;code&gt;SetConstraintInherit&lt;/code&gt;, &lt;code&gt;SetConstraintComment&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Index&lt;/strong&gt;: &lt;code&gt;CreateIndex&lt;/code&gt;, &lt;code&gt;DropIndex&lt;/code&gt;, &lt;code&gt;RenameIndex&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;View&lt;/strong&gt;: &lt;code&gt;CreateView&lt;/code&gt;, &lt;code&gt;ReplaceView&lt;/code&gt;, &lt;code&gt;RenameView&lt;/code&gt;, &lt;code&gt;DropView&lt;/code&gt;,&#10;and the materialized-view ops (&lt;code&gt;CreateMaterializedView&lt;/code&gt;,&#10;&lt;code&gt;ReplaceMaterializedView&lt;/code&gt;, &lt;code&gt;RenameMaterializedView&lt;/code&gt;,&#10;&lt;code&gt;DropMaterializedView&lt;/code&gt;).&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Type&lt;/strong&gt;: &lt;code&gt;CreateType&lt;/code&gt;, &lt;code&gt;DropType&lt;/code&gt;, &lt;code&gt;RenameType&lt;/code&gt;, &lt;code&gt;AddEnumValue&lt;/code&gt;,&#10;&lt;code&gt;RenameEnumValue&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Policy&lt;/strong&gt;: &lt;code&gt;CreatePolicy&lt;/code&gt;, &lt;code&gt;ReplacePolicy&lt;/code&gt;, &lt;code&gt;RenamePolicy&lt;/code&gt;,&#10;&lt;code&gt;DropPolicy&lt;/code&gt;, &lt;code&gt;SetRowLevelSecurity&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Function&lt;/strong&gt;: &lt;code&gt;CreateFunction&lt;/code&gt;, &lt;code&gt;ReplaceFunction&lt;/code&gt;,&#10;&lt;code&gt;RenameFunction&lt;/code&gt;, &lt;code&gt;DropFunction&lt;/code&gt;, &lt;code&gt;SetFunctionComment&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Trigger&lt;/strong&gt;: &lt;code&gt;CreateTrigger&lt;/code&gt;, &lt;code&gt;RenameTrigger&lt;/code&gt;, &lt;code&gt;DropTrigger&lt;/code&gt;,&#10;&lt;code&gt;EnableTrigger&lt;/code&gt;, &lt;code&gt;DisableTrigger&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Extension&lt;/strong&gt;: &lt;code&gt;CreateExtension&lt;/code&gt;, &lt;code&gt;DropExtension&lt;/code&gt; (under the&#10;schema-root category).&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Raw&lt;/strong&gt;: &lt;code&gt;RunRawScript&lt;/code&gt; (&lt;code&gt;DO $$ … $$;&lt;/code&gt; escape hatch).&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Log&lt;/strong&gt;: &lt;code&gt;Seal&lt;/code&gt;, which pins log integrity, and &lt;code&gt;DeclareReversal&lt;/code&gt;,&#10;which declares how a sealed raw script is undone. Neither is a&#10;schema operation.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;The &lt;strong&gt;change operators&lt;/strong&gt; (Rename, Cast, Extract/Join,&#10;Split/Merge, the partition converts, Copy, Move) are the ones a&#10;migration tool can&amp;rsquo;t express. Create/Add/Drop exist to bootstrap and&#10;trim the schema; the change operators are what drives architectural&#10;evolution.&lt;/p&gt;</description></item><item><title>How a command picks its schema</title><link>https://docs.retrofit.sh/wip/how-a-command-picks-its-schema/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/how-a-command-picks-its-schema/</guid><description>&lt;h1 id="how-a-command-picks-its-schema"&gt;How a command picks its schema&lt;a class="anchor" href="#how-a-command-picks-its-schema" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;A retrofit project can hold one schema or many. Every schema has&#10;four properties; the CLI&amp;rsquo;s job is to map a verb invocation to a&#10;single registered schema by reading those properties.&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Name&lt;/strong&gt;: the registry key. Case-insensitive (PostgreSQL&#10;unquoted-identifier rule).&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Oplog root&lt;/strong&gt;: the directory holding the schema&amp;rsquo;s &lt;code&gt;&amp;lt;name&amp;gt;.oplog&lt;/code&gt;&#10;file. It is &lt;code&gt;[[schema]].oplog_root&lt;/code&gt; in &lt;code&gt;retrofit.toml&lt;/code&gt;, else&#10;&lt;code&gt;[project].oplog_root&lt;/code&gt;, else the project root.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Scope&lt;/strong&gt;: directories that resolve to this schema. &lt;em&gt;Implicit&lt;/em&gt;&#10;from the oplog root, plus optional explicit overlays in the&#10;top-level &lt;code&gt;[directory_scope]&lt;/code&gt; TOML table.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Default pin&lt;/strong&gt;: &lt;code&gt;default_schema&lt;/code&gt; in &lt;code&gt;retrofit.toml&lt;/code&gt;. Last&#10;resort for schema-context verbs.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="the-resolver-chain"&gt;The resolver chain&lt;a class="anchor" href="#the-resolver-chain" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Every schema-context verb (&lt;code&gt;op*&lt;/code&gt;, &lt;code&gt;snapshot&lt;/code&gt;, &lt;code&gt;migrate&lt;/code&gt;,&#10;&lt;code&gt;reconcile&lt;/code&gt;, &lt;code&gt;drift&lt;/code&gt;, &lt;code&gt;import&lt;/code&gt;, &lt;code&gt;schema move&lt;/code&gt;, &lt;code&gt;schema engine&lt;/code&gt;,&#10;&lt;code&gt;schema scope add&lt;/code&gt;, &lt;code&gt;schema set-default&lt;/code&gt;) runs the same six-step&#10;chain. The first step that returns a schema wins:&lt;/p&gt;</description></item><item><title>Consents</title><link>https://docs.retrofit.sh/wip/consents/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/consents/</guid><description>&lt;h1 id="consents"&gt;Consents&lt;a class="anchor" href="#consents" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;A &lt;em&gt;consent&lt;/em&gt; is an input that clears a refusal a verb would otherwise raise.&#10;Every consent is one spelling, naming one fact, in one kind, and the spelling&#10;is the same token on every verb that takes the fact. There are two kinds:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;apply context&lt;/strong&gt;: a standing fact about where the script runs. The flag&#10;takes no value.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;sealed history&lt;/strong&gt;: operations a Seal attested are rewritten. The side-effect&#10;arm (&lt;code&gt;reconcile&lt;/code&gt;, &lt;code&gt;import --force&lt;/code&gt;) is attested one Seal at a time, by opid:&#10;&lt;code&gt;--allow-sealed-rewrite=&amp;lt;seal opid&amp;gt;&lt;/code&gt;, repeatable and comma-separated. A value&#10;attests the Seal it names and selects nothing; a Seal left unnamed refuses&#10;&lt;code&gt;seal-removal-refused&lt;/code&gt;. The same kind, as the command&amp;rsquo;s own named act, is&#10;taken by &lt;code&gt;op unseal&lt;/code&gt;, &lt;code&gt;op truncate --drop-seals&lt;/code&gt; and &lt;code&gt;schema remove&lt;/code&gt; (unless&#10;&lt;code&gt;--keep-oplog&lt;/code&gt;), which take no spelling: the command is the attestation.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;No consent is needed to emit an authored drop, whatever it drops. No consent&#10;is asked, either, for rows a rendered step loses (a down that drops a column&#10;written since, or narrows a type and rounds) or for a rule a rendered step&#10;re-imposes for PostgreSQL to check at apply; the render&amp;rsquo;s report and&#10;script name each.&lt;/p&gt;</description></item><item><title>How a migration applies</title><link>https://docs.retrofit.sh/wip/how-a-migration-applies/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/how-a-migration-applies/</guid><description>&lt;h1 id="how-a-migration-applies"&gt;How a migration applies&lt;a class="anchor" href="#how-a-migration-applies" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;A migration script is the difference between two points in the&#10;&lt;a href="https://docs.retrofit.sh/wip/oplog/#the-oplog"&gt;oplog&lt;/a&gt;, written as SQL. Each point is a &lt;strong&gt;cut&lt;/strong&gt;:&#10;the schema as it stands after one operation. The script holds the&#10;statements that turn a database at one cut into a database at another.&#10;Writing it is where &lt;code&gt;retrofit migrate&lt;/code&gt; stops: your runner, or &lt;code&gt;psql&lt;/code&gt;,&#10;sends it to PostgreSQL, and the shell is what connects. This&#10;page gives the model behind the choices that follow from that split:&#10;what a script assumes, who owns its transaction, why some scripts&#10;commit in parts, why a lock wait is worth bounding, and how a reverse&#10;script is built. &lt;a href="https://docs.retrofit.sh/wip/commands/retrofit-migrate/"&gt;&lt;code&gt;retrofit migrate&lt;/code&gt;&lt;/a&gt; is the reference, and&#10;&lt;a href="https://docs.retrofit.sh/wip/emit-a-migration/"&gt;Emit a migration script&lt;/a&gt; is the task guide.&lt;/p&gt;</description></item><item><title>Principles</title><link>https://docs.retrofit.sh/wip/principles/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/principles/</guid><description>&lt;h1 id="principles"&gt;Principles&lt;a class="anchor" href="#principles" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;The rules retrofit upholds. They explain why the tool behaves the way&#10;it does, and why a few things you might expect to be configurable&#10;aren&amp;rsquo;t.&lt;/p&gt;&#10;&lt;p&gt;Each is enforced in code, tests or review.&lt;/p&gt;&#10;&lt;p&gt;For the mental model the principles act on, see&#10;&lt;a href="https://docs.retrofit.sh/wip/oplog/"&gt;The oplog&lt;/a&gt;. For a hands-on tour see&#10;&lt;a href="https://docs.retrofit.sh/wip/create-a-project/"&gt;Create a project&lt;/a&gt;.&lt;/p&gt;&#10;&lt;h2 id="1-rows-in-the-target-database-are-the-asset"&gt;1. Rows in the target database are the asset&lt;a class="anchor" href="#1-rows-in-the-target-database-are-the-asset" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;The tool emits schema changes for live databases, whose rows have to&#10;survive the change. Five things follow.&lt;/p&gt;</description></item><item><title>Import existing SQL</title><link>https://docs.retrofit.sh/wip/import-existing-sql/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/import-existing-sql/</guid><description>&lt;h1 id="import-existing-sql"&gt;Import existing SQL&lt;a class="anchor" href="#import-existing-sql" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit import&lt;/code&gt; turns &lt;code&gt;.sql&lt;/code&gt; files you already have (a schema file, a&#10;&lt;code&gt;pg_dump --schema-only&lt;/code&gt;, a set of migration scripts) into an&#10;&lt;a href="https://docs.retrofit.sh/wip/oplog/#the-oplog"&gt;oplog&lt;/a&gt;, the log of operators (ops) your schema&#10;is recorded in. Each statement it understands becomes an op, in the&#10;order the files state them (a drop a function body reads, and a&#10;function created before what its body binds, can move; see &lt;a href="https://docs.retrofit.sh/wip/commands/retrofit-import/#drops-read-by-function-bodies"&gt;Drops read&#10;by function&#10;bodies&lt;/a&gt; and&#10;&lt;a href="https://docs.retrofit.sh/wip/commands/retrofit-import/#functions-created-before-what-their-bodies-bind"&gt;Functions created before what their bodies&#10;bind&lt;/a&gt;); it&#10;reads the files and never changes them, and never touches a database.&lt;/p&gt;</description></item><item><title>Import a migration tree in order</title><link>https://docs.retrofit.sh/wip/import-a-migration-tree/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/import-a-migration-tree/</guid><description>&lt;h1 id="import-a-migration-tree-in-order"&gt;Import a migration tree in order&lt;a class="anchor" href="#import-a-migration-tree-in-order" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit import&lt;/code&gt; records a tree of migration files as one history,&#10;each file&amp;rsquo;s changes after the ones before it, when you pass the files&#10;in the order they were applied. import reads its sources in the order&#10;you pass them and never sorts them, so the order is yours to give. This&#10;page covers passing that order, checking it before anything is written,&#10;and &lt;a href="https://docs.retrofit.sh/wip/glossary/#seal"&gt;sealing&lt;/a&gt; each migration.&lt;/p&gt;</description></item><item><title>Exclude objects the project does not own</title><link>https://docs.retrofit.sh/wip/exclude-objects/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/exclude-objects/</guid><description>&lt;h1 id="exclude-objects-the-project-does-not-own"&gt;Exclude objects the project does not own&lt;a class="anchor" href="#exclude-objects-the-project-does-not-own" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;A dump from a managed database holds objects your application does not&#10;author: a migration runner&amp;rsquo;s history table (Diesel&amp;rsquo;s&#10;&lt;code&gt;__diesel_schema_migrations&lt;/code&gt;), extensions the hosting provider installs&#10;(&lt;code&gt;pg_stat_statements&lt;/code&gt;), schemas it creates (&lt;code&gt;auth&lt;/code&gt;, &lt;code&gt;vault&lt;/code&gt;). Declare them&#10;once in &lt;code&gt;retrofit.toml&lt;/code&gt;, and every command that reads SQL sets them aside&#10;before it reads the rest.&lt;/p&gt;&#10;&lt;p&gt;&lt;a href="https://docs.retrofit.sh/wip/output-contract/#project-exclusions-exclude"&gt;Project exclusions&lt;/a&gt; is&#10;the reference: what each command prints for an entry, and each refusal.&lt;/p&gt;</description></item><item><title>Work with several schemas</title><link>https://docs.retrofit.sh/wip/several-schemas/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/several-schemas/</guid><description>&lt;h1 id="work-with-several-schemas"&gt;Work with several schemas&lt;a class="anchor" href="#work-with-several-schemas" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;A project can hold any number of schemas. Each is a &lt;code&gt;[[schema]]&lt;/code&gt; row in&#10;&lt;code&gt;retrofit.toml&lt;/code&gt; with its own &lt;a href="https://docs.retrofit.sh/wip/oplog/#the-oplog"&gt;oplog&lt;/a&gt;, the log of&#10;operators the schema is recorded in, in a file named &lt;code&gt;&amp;lt;name&amp;gt;.oplog&lt;/code&gt;. A&#10;command that works on one schema picks it the way every command does&#10;(&lt;a href="https://docs.retrofit.sh/wip/how-a-command-picks-its-schema/#the-resolver-chain"&gt;The resolver chain&lt;/a&gt;), and in the common&#10;layouts you type nothing to choose it.&lt;/p&gt;&#10;&lt;h2 id="add-a-schema"&gt;Add a schema&lt;a class="anchor" href="#add-a-schema" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;schema create&lt;/code&gt; registers a schema and writes its oplog. Pass an optional&#10;directory (an existing one, or a path ending in &lt;code&gt;/&lt;/code&gt; to create) and any&#10;project-setup flags:&lt;/p&gt;</description></item><item><title>Record a schema changed outside the oplog</title><link>https://docs.retrofit.sh/wip/record-outside-changes/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/record-outside-changes/</guid><description>&lt;h1 id="record-a-schema-changed-outside-the-oplog"&gt;Record a schema changed outside the oplog&lt;a class="anchor" href="#record-a-schema-changed-outside-the-oplog" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;When a database&amp;rsquo;s schema changes outside the&#10;&lt;a href="https://docs.retrofit.sh/wip/oplog/#the-oplog"&gt;oplog&lt;/a&gt; (a hotfix applied by hand, a change made&#10;in a console), &lt;code&gt;retrofit drift&lt;/code&gt; reads a dump of that database, works out&#10;what changed since the oplog&amp;rsquo;s last op, and appends the ops (operators)&#10;that record it. Where a change has more than one reading, such as a&#10;rename or a drop and an add, it asks you which one.&lt;/p&gt;</description></item><item><title>Emit the schema as SQL</title><link>https://docs.retrofit.sh/wip/emit-the-schema/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/emit-the-schema/</guid><description>&lt;h1 id="emit-the-schema-as-sql"&gt;Emit the schema as SQL&lt;a class="anchor" href="#emit-the-schema-as-sql" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit snapshot&lt;/code&gt; prints your schema as SQL: its DDL, the rows of its&#10;reference tables, and any seed datasets you name. It reads the&#10;&lt;a href="https://docs.retrofit.sh/wip/oplog/#the-oplog"&gt;oplog&lt;/a&gt;, the log of operators (ops) your schema&#10;is recorded in, and never changes it. Pipe the output to &lt;code&gt;psql&lt;/code&gt; to build a&#10;database, or keep the file as a schema dump.&lt;/p&gt;&#10;&lt;p&gt;&lt;a href="https://docs.retrofit.sh/wip/commands/retrofit-snapshot/"&gt;&lt;code&gt;retrofit snapshot&lt;/code&gt;&lt;/a&gt; is the reference: every flag, the&#10;order of the output, and each refusal and exit code.&lt;/p&gt;</description></item><item><title>Find an element's ID and history</title><link>https://docs.retrofit.sh/wip/find-an-element/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/find-an-element/</guid><description>&lt;h1 id="find-an-elements-id-and-history"&gt;Find an element&amp;rsquo;s ID and history&lt;a class="anchor" href="#find-an-elements-id-and-history" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Every table, column, constraint and other object of a schema is an&#10;element, and each has an ID, its &lt;a href="https://docs.retrofit.sh/wip/glossary/#elementid"&gt;ElementID&lt;/a&gt;, that&#10;stays the same when the element is renamed. &lt;code&gt;retrofit element list&lt;/code&gt; prints&#10;the live elements with their IDs, and &lt;code&gt;retrofit element history&lt;/code&gt; prints the&#10;ops that changed one of them.&lt;/p&gt;&#10;&lt;p&gt;&lt;a href="https://docs.retrofit.sh/wip/commands/retrofit-element-list/"&gt;&lt;code&gt;retrofit element list&lt;/code&gt;&lt;/a&gt; and &lt;a href="https://docs.retrofit.sh/wip/commands/retrofit-element-history/"&gt;&lt;code&gt;retrofit element history&lt;/code&gt;&lt;/a&gt; are&#10;the reference: every flag, each record&amp;rsquo;s fields, and each refusal and exit&#10;code.&lt;/p&gt;</description></item><item><title>Emit a migration script</title><link>https://docs.retrofit.sh/wip/emit-a-migration/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/emit-a-migration/</guid><description>&lt;h1 id="emit-a-migration-script"&gt;Emit a migration script&lt;a class="anchor" href="#emit-a-migration-script" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit migrate&lt;/code&gt; prints the SQL that takes a database from one point&#10;in the &lt;a href="https://docs.retrofit.sh/wip/oplog/#the-oplog"&gt;oplog&lt;/a&gt;, the log of operators (ops) your&#10;schema is recorded in, to another: the &lt;code&gt;ALTER&lt;/code&gt;, &lt;code&gt;CREATE&lt;/code&gt; and &lt;code&gt;DROP&lt;/code&gt;&#10;statements, with the data rows recorded between the two points. It&#10;reads the oplog and never changes it. Pipe the output to&#10;&lt;code&gt;psql&lt;/code&gt;, or keep the file for your deploy pipeline to apply.&lt;/p&gt;&#10;&lt;p&gt;&lt;a href="https://docs.retrofit.sh/wip/commands/retrofit-migrate/"&gt;&lt;code&gt;retrofit migrate&lt;/code&gt;&lt;/a&gt; is the reference: every flag, the shape&#10;of the output, and each refusal and exit code.&#10;&lt;a href="https://docs.retrofit.sh/wip/how-a-migration-applies/"&gt;How a migration applies&lt;/a&gt; gives the model.&lt;/p&gt;</description></item><item><title>Choose who opens the transaction</title><link>https://docs.retrofit.sh/wip/choose-who-opens-the-transaction/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/choose-who-opens-the-transaction/</guid><description>&lt;h1 id="choose-who-opens-the-transaction"&gt;Choose who opens the transaction&lt;a class="anchor" href="#choose-who-opens-the-transaction" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;A migration script applies best as one transaction, and either the&#10;script opens it or your runner does. You tell &lt;code&gt;retrofit migrate&lt;/code&gt; which&#10;with &lt;code&gt;--envelope&lt;/code&gt;, and it writes the file to match: its own &lt;code&gt;BEGIN;&lt;/code&gt; and&#10;&lt;code&gt;COMMIT;&lt;/code&gt;, or none. The value is the file&amp;rsquo;s &lt;a href="https://docs.retrofit.sh/wip/glossary/#envelope"&gt;envelope&lt;/a&gt;. migrate cannot&#10;see how your runner sends the file, so the value is yours to state.&#10;&lt;a href="https://docs.retrofit.sh/wip/commands/retrofit-migrate/#the-envelope"&gt;The envelope&lt;/a&gt; is the reference, and&#10;&lt;a href="https://docs.retrofit.sh/wip/how-a-migration-applies/#who-owns-the-transaction"&gt;Who owns the transaction&lt;/a&gt;&#10;gives the model.&lt;/p&gt;</description></item><item><title>Bound how long a migration waits for a lock</title><link>https://docs.retrofit.sh/wip/bound-the-lock-wait/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/bound-the-lock-wait/</guid><description>&lt;h1 id="bound-how-long-a-migration-waits-for-a-lock"&gt;Bound how long a migration waits for a lock&lt;a class="anchor" href="#bound-how-long-a-migration-waits-for-a-lock" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;A migration statement that waits for a table lock queues every later&#10;query on that table behind it. &lt;code&gt;retrofit migrate --lock-timeout&lt;/code&gt; writes&#10;PostgreSQL&amp;rsquo;s &lt;code&gt;lock_timeout&lt;/code&gt; setting into the script, so a statement that&#10;cannot get its lock within the bound gives up instead of waiting, and&#10;its transaction rolls back. &lt;a href="https://docs.retrofit.sh/wip/commands/retrofit-migrate/#the-lock-timeout"&gt;The lock timeout&lt;/a&gt;&#10;is the reference, and &lt;a href="https://docs.retrofit.sh/wip/how-a-migration-applies/#why-bound-the-lock-wait"&gt;Why bound the lock&#10;wait&lt;/a&gt; gives the&#10;reason.&lt;/p&gt;</description></item><item><title>Recover after a failed apply or a merge</title><link>https://docs.retrofit.sh/wip/recover/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/recover/</guid><description>&lt;h1 id="recover-after-a-failed-apply-or-a-merge"&gt;Recover after a failed apply or a merge&lt;a class="anchor" href="#recover-after-a-failed-apply-or-a-merge" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Two things can leave work half done: a migration script that stopped&#10;part way through, and a merge that left two histories side by side in&#10;the &lt;a href="https://docs.retrofit.sh/wip/oplog/#the-oplog"&gt;oplog&lt;/a&gt;. This page gets you from each back to&#10;a state every command accepts.&lt;/p&gt;&#10;&lt;h2 id="find-out-what-a-failed-apply-left"&gt;Find out what a failed apply left&lt;a class="anchor" href="#find-out-what-a-failed-apply-left" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;What a failure leaves depends on whether the script applied as one&#10;transaction:&lt;/p&gt;</description></item><item><title>Merge branches that change the oplog</title><link>https://docs.retrofit.sh/wip/merge-branches/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/merge-branches/</guid><description>&lt;h1 id="merge-branches-that-change-the-oplog"&gt;Merge branches that change the oplog&lt;a class="anchor" href="#merge-branches-that-change-the-oplog" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Two branches that each change an &lt;a href="https://docs.retrofit.sh/wip/glossary/#oplog"&gt;oplog&lt;/a&gt; meet when&#10;one is integrated into the other. This page brings main into your&#10;branch: resolving conflict markers, the three-file merge, a property&#10;both sides set, jj, bisecting over the commits a rebase replayed,&#10;squashing your work before each commit, and a pull request GitHub&#10;reports as conflicted.&lt;/p&gt;&#10;&lt;p&gt;The examples use one schema, &lt;code&gt;sales&lt;/code&gt;, whose oplog is &lt;code&gt;sales.oplog&lt;/code&gt; at&#10;the repository root. Resolve on your branch, so main only receives an&#10;oplog &lt;code&gt;validate&lt;/code&gt; passes. &lt;a href="https://docs.retrofit.sh/wip/branches-and-merges/#when-two-branches-change-the-oplog"&gt;When two branches change the oplog&lt;/a&gt; explains the&#10;&lt;a href="https://docs.retrofit.sh/wip/glossary/#fork"&gt;fork&lt;/a&gt; a merge leaves, and&#10;&lt;a href="https://docs.retrofit.sh/wip/branches-and-merges/#the-two-forms"&gt;The two forms&lt;/a&gt; the oplog&amp;rsquo;s merge and compact&#10;forms. A hotfix shipped to production ahead of a&#10;&lt;a href="https://docs.retrofit.sh/wip/glossary/#seal"&gt;sealed&lt;/a&gt; release has a page of its own:&#10;&lt;a href="https://docs.retrofit.sh/wip/ship-a-hotfix/"&gt;Ship a hotfix ahead of the next release&lt;/a&gt;.&lt;/p&gt;</description></item><item><title>Ship a hotfix ahead of the next release</title><link>https://docs.retrofit.sh/wip/ship-a-hotfix/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/ship-a-hotfix/</guid><description>&lt;h1 id="ship-a-hotfix-ahead-of-the-next-release"&gt;Ship a hotfix ahead of the next release&lt;a class="anchor" href="#ship-a-hotfix-ahead-of-the-next-release" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Production runs release 6. Release 7 is&#10;&lt;a href="https://docs.retrofit.sh/wip/sealing-and-deploying/#sealed-and-unsealed-ops"&gt;sealed&lt;/a&gt; on main and applied to a test&#10;database, and production needs a fix now, before release 7. This&#10;page takes the fix from production&amp;rsquo;s release to production, brings it&#10;into main ahead of release 7, then re-tests release 7 on top of it and&#10;seals it again.&lt;/p&gt;&#10;&lt;p&gt;The &lt;a href="https://docs.retrofit.sh/wip/oplog/#the-oplog"&gt;oplog&lt;/a&gt; is the log of operations (ops) your&#10;schema is recorded in. A Seal, written by &lt;code&gt;op seal&lt;/code&gt;, marks the ops before&#10;it as the team&amp;rsquo;s stable range (&lt;a href="https://docs.retrofit.sh/wip/sealing-and-deploying/#sealed-and-unsealed-ops"&gt;Sealed and unsealed ops&lt;/a&gt;). Each op and each Seal has an &lt;a href="https://docs.retrofit.sh/wip/glossary/#opid"&gt;opid&lt;/a&gt;,&#10;the 12-character hex id the commands print. The examples use one schema,&#10;&lt;code&gt;sales&lt;/code&gt;, whose oplog is &lt;code&gt;sales.oplog&lt;/code&gt;. Release 6&amp;rsquo;s Seal is&#10;&lt;code&gt;c00a2d6a0f6a&lt;/code&gt; and release 7&amp;rsquo;s is &lt;code&gt;6653dfb40f55&lt;/code&gt;; your opids differ.&lt;/p&gt;</description></item><item><title>Check a pull request in CI</title><link>https://docs.retrofit.sh/wip/check-a-pull-request/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/check-a-pull-request/</guid><description>&lt;h1 id="check-a-pull-request-in-ci"&gt;Check a pull request in CI&lt;a class="anchor" href="#check-a-pull-request-in-ci" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;A pull request&amp;rsquo;s check runs five steps over a project: the history&#10;checks over the commits the pull request brings, a merge of main&amp;rsquo;s tip&#10;with the pull request&amp;rsquo;s head, &lt;code&gt;data check&lt;/code&gt; on every schema, the&#10;migration applied to a scratch database, and the findings turned into&#10;the host&amp;rsquo;s annotations. Each step below is a shell script a CI job runs&#10;at the project root, in a full clone, with &lt;code&gt;retrofit&lt;/code&gt; and &lt;code&gt;jq&lt;/code&gt; on its&#10;path. &lt;a href="https://docs.retrofit.sh/wip/gate-merges/"&gt;Gate merges on GitHub and GitLab&lt;/a&gt; wires the steps&#10;into each host&amp;rsquo;s jobs.&lt;/p&gt;</description></item><item><title>Gate merges on GitHub and GitLab</title><link>https://docs.retrofit.sh/wip/gate-merges/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/gate-merges/</guid><description>&lt;h1 id="gate-merges-on-github-and-gitlab"&gt;Gate merges on GitHub and GitLab&lt;a class="anchor" href="#gate-merges-on-github-and-gitlab" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;The steps in &lt;a href="https://docs.retrofit.sh/wip/check-a-pull-request/"&gt;Check a pull request in CI&lt;/a&gt; gate what reaches main&#10;only when they run on the commit the host merges. This page sets them up&#10;on each host: the GitHub Actions triggers and their merge queue, a job&#10;that tells a conflicted pull request what to do, a job that merges each&#10;open pull request with main when main moves, a scheduled job that&#10;supplies &lt;code&gt;op compact --frontier&lt;/code&gt;, the GitLab pipeline, and a deploy from&#10;a &lt;a href="https://docs.retrofit.sh/wip/glossary/#seal"&gt;Seal&lt;/a&gt;.&lt;/p&gt;</description></item><item><title>Work with row data</title><link>https://docs.retrofit.sh/wip/row-data/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/row-data/</guid><description>&lt;h1 id="work-with-row-data"&gt;Work with row data&lt;a class="anchor" href="#work-with-row-data" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Row data (the rows of reference tables, test fixtures, migration&#10;backfills) is kept in data files beside the&#10;&lt;a href="https://docs.retrofit.sh/wip/oplog/#the-oplog"&gt;oplog&lt;/a&gt;, the log of operators your schema is&#10;recorded in. &lt;code&gt;snapshot&lt;/code&gt; and &lt;code&gt;migrate&lt;/code&gt; add those rows to the SQL they&#10;emit. A label names a dataset, such as &lt;code&gt;env:dev&lt;/code&gt;, and its rows apply&#10;only when you name it.&lt;/p&gt;&#10;&lt;p&gt;&lt;a href="https://docs.retrofit.sh/wip/commands/retrofit-data/"&gt;&lt;code&gt;retrofit data&lt;/code&gt;&lt;/a&gt; is the reference: every &lt;code&gt;data&lt;/code&gt; command, each field it&#10;prints, the data file&amp;rsquo;s format and each refusal.&lt;/p&gt;</description></item><item><title>FAQ</title><link>https://docs.retrofit.sh/wip/faq/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/faq/</guid><description>&lt;h1 id="faq"&gt;FAQ&lt;a class="anchor" href="#faq" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Short questions that come up where a migration tree&amp;rsquo;s naming meets&#10;&lt;code&gt;import&lt;/code&gt;&amp;rsquo;s input. Each answer shows a command that checks it on your own&#10;tree.&lt;/p&gt;&#10;&lt;h2 id="my-migrations-imported-out-of-order-what-happened"&gt;My migrations imported out of order. What happened?&lt;a class="anchor" href="#my-migrations-imported-out-of-order-what-happened" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;import&lt;/code&gt; reads its sources in the order you pass them and never re-sorts&#10;them. A bare glob over files numbered without padding can pass &lt;code&gt;V10&lt;/code&gt;&#10;before &lt;code&gt;V2&lt;/code&gt;. Print the order the shell passes:&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="rf-code"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;echo V*.sql&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;p&gt;If the order is not the order the files applied in, pass them sorted or&#10;through &lt;code&gt;--from-file&lt;/code&gt; (see &lt;a href="https://docs.retrofit.sh/wip/import-a-migration-tree/"&gt;Import a migration tree in order&lt;/a&gt;),&#10;and run the import with &lt;code&gt;--dry-run&lt;/code&gt; first:&lt;/p&gt;</description></item><item><title>retrofit</title><link>https://docs.retrofit.sh/wip/commands/retrofit/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/&#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/wip/commands/retrofit-data/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/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/wip/commands/retrofit-data-capture/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-data-check/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-data-list/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-data-reanchor/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-data-repin/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-data-retire/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-data-scaffold/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-data-witness/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-drift/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/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/wip/commands/retrofit-element/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-element-history/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/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/wip/commands/retrofit-element-list/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/glossary/#cut"&gt;cut&lt;/a&gt;: its kind, schema, name,&#10;&lt;a href="https://docs.retrofit.sh/wip/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/wip/glossary/#oplog"&gt;oplog&lt;/a&gt;, reads no data&#10;corpus and writes nothing.&#10;&lt;a href="https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-identify/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-import/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/import-existing-sql/"&gt;Import existing SQL&lt;/a&gt; and&#10;&lt;a href="https://docs.retrofit.sh/wip/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/wip/commands/retrofit-init/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-migrate/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/emit-a-migration/"&gt;Emit a migration script&lt;/a&gt; is the task guide, and&#10;&lt;a href="https://docs.retrofit.sh/wip/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/wip/commands/retrofit-op/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-op-add/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-op-compact/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-op-info/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-op-remove/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-op-revert/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-op-revise/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-op-seal/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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;The run seals each schema in its scope: each --schema names one, and&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;with no --schema every registered schema is in scope (the working&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;directory and default_schema do not narrow it). It writes all of&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;their Seals or none: a refusal in one schema writes nothing to any.&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;A schema in scope with no unsealed tail is skipped. A run over&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;several schemas opens its report with its scope and prints one&#10;&lt;/span&gt;&lt;span class="rf-code-line" style="--hang: 2ch"&gt;&amp;#34;sealed&amp;#34; line per schema. --compact takes one 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: 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/wip/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/wip/commands/retrofit-op-show/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-op-squash/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-op-truncate/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-op-unseal/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-ops/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-ops-upgrade-sql-bodies/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-reconcile/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/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/wip/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/wip/commands/retrofit-schema/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-create/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-database-at/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-engine/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-form/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-list/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-move/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-ref-tables/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-ref-tables-add/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-ref-tables-remove/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-remove/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-scope/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-scope-add/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-scope-remove/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-schema-set-default/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/commands/retrofit-snapshot/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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/wip/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/wip/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/wip/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/wip/commands/retrofit-validate/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/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; --all report every registered schema, as with no --schema (and satisfying RETROFIT_REQUIRE_EXPLICIT_SCHEMA)&#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;span class="rf-code-line" style="--hang: 31ch"&gt; --schema &amp;lt;name&amp;gt; report only registered schema &amp;lt;name&amp;gt;&amp;#39;s findings; repeat it for each schema to report (every registered oplog is still read)&#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/wip/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><item><title>Operators</title><link>https://docs.retrofit.sh/wip/operators/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/operators/</guid><description>&lt;h1 id="operators"&gt;Operators&lt;a class="anchor" href="#operators" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Every schema modification operator, by name, with its category and a one-line summary.&#10;The last five columns name the commands that work with operators and say, for each, whether&#10;it handles the operator in this version: available or not available. For an operator&amp;rsquo;s full&#10;reference, run &lt;code&gt;retrofit op info &amp;lt;operator&amp;gt;&lt;/code&gt;.&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Operator&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Category&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Summary&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;&lt;code&gt;op add&lt;/code&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;&lt;code&gt;import&lt;/code&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;&lt;code&gt;drift&lt;/code&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;&lt;code&gt;snapshot&lt;/code&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;&lt;code&gt;migrate&lt;/code&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;AddCheck&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Declare a CHECK constraint enforcing a row-level predicate.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;AddColumn&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Add a column to an existing table.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;AddEnumValue&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;type&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Append a new value to an existing enum type.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;AddExclude&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Declare an EXCLUDE constraint: no two rows&amp;rsquo; keys may all compare true under the listed operators.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;AddForeignKey&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Declare a foreign-key constraint to referenced_columns in referenced_table.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;AddIdentity&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Promote an existing column to GENERATED { BY DEFAULT | ALWAYS } AS IDENTITY. PG mints a fresh backing sequence starting at identity_start (else PostgreSQL&amp;rsquo;s default: its minimum value, or its maximum when it counts down) and does NOT advance it past the column&amp;rsquo;s existing values, so migrate emits a realignment statement after the ALTER; without it the migration applies cleanly and the next insert collides.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;AddNotNull&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Set the column&amp;rsquo;s NOT NULL bit on the column vertex.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;AddPrimaryKey&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Declare a primary-key constraint over the listed columns.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;AddUnique&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Declare a UNIQUE constraint over the listed columns.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;AttachPartition&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Subordinate a free-standing table as a partition of a partitioned parent (its columns end into the parent&amp;rsquo;s).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CastColumn&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Change a column&amp;rsquo;s SQL type in place.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ChangePrimaryKey&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Replace a table&amp;rsquo;s primary key with a new column set; preserves the cascade genealogy across the PK and every dependent FK constraint via N+1 EdgeKindCrossElement edges minted at replay.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CopyColumn&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;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.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CopyTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Create a new table that is an independent copy of source.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CreateExtension&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;root&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Install a PostgreSQL extension at the cluster (database) level.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CreateFunction&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;function&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Create a new function inside the target schema. Identity is (schema, composite-name).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CreateIndex&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;index&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Create a physical index over the listed columns.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CreateMaterializedView&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;view&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Create a new materialized view inside the target schema.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CreatePartition&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Create a partition under a partitioned parent (columns inherited).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CreatePolicy&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;policy&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Create a row-level-security policy on a table. Identity is (table, name).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CreateSchema&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;root&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Mint the root schema element.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CreateTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Create a new table inside the target schema.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CreateTrigger&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;trigger&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Create a trigger on a table or view. Identity is (table, name).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CreateType&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;type&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Create a user-defined type (enum or composite) in the target schema.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;CreateView&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;view&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Create a new view inside the target schema.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DeclareReversal&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;log&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;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.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DepartitionTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Flatten a partitioned parent back to a plain heap, tombstoning its partition-children.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DetachPartition&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Detach a partition into a free-standing table (rows kept).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DisableTrigger&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;trigger&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Disable an enabled trigger.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropCheck&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target CHECK constraint.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropColumn&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target column element.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropDefault&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Clear a column&amp;rsquo;s DEFAULT expression. Replay rejects against a column with no current default.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropExclude&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target EXCLUDE constraint.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropExtension&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;root&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Drop a PostgreSQL extension.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropForeignKey&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target foreign-key constraint.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropFunction&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;function&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target function element.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropGeneratedExpression&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Clear a stored generated column&amp;rsquo;s expression, converting it to a base column. Replay rejects against a column with no current generated expression or a virtual generated column.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropIdentity&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Remove the identity property from a column. The implicit NOT NULL is preserved; use DropNotNull to clear it.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropIndex&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;index&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target index element.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropMaterializedView&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;view&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target materialized view element.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropNotNull&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Clear the column-vertex NOT NULL bit.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropPolicy&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;policy&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target policy element.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropPrimaryKey&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target primary-key constraint.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target table element.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropTrigger&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;trigger&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target trigger element.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropType&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;type&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume a user-defined type element. Refused at op-add when any live column binds to it.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropUnique&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target UNIQUE constraint.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;DropView&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;view&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Consume the target view element.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;EnableTrigger&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;trigger&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Enable a disabled trigger.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ExtractTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Extract columns into new related tables (column-axis split; normalizes a wide table). A child copies the source&amp;rsquo;s primary key, keeping every row&amp;rsquo;s data, or designates &lt;code&gt;key&lt;/code&gt; 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.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;InlineTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;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;rsquo;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;rsquo;s default.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;JoinTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Join two tables&amp;rsquo; 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;rsquo;s columns a PRIMARY KEY or UNIQUE of that source); kind picks the JOIN flavor (inner/left/right/full).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;MergeTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Move the rows of several tables into a live table of their shape, one predicate recorded per source (row-axis merge).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;MoveColumn&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;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;rsquo;s ElementID survives the move; only the parent table changes. Renames are a separate operator.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;PartitionTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Convert a plain table to a partitioned parent in place, minting N partitions atomically.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenameColumn&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename the target column inside its containing table.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenameConstraint&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename a constraint without dropping it. Element identity is preserved; the first rename of a PG-default-named constraint assigns the first explicit name.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenameEnumValue&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;type&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename an existing enum value in place.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenameFunction&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;function&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename the target function to a new name in its schema.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenameIndex&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;index&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename the target index inside its containing table.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenameMaterializedView&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;view&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename the target materialized view to a new name in its schema.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenameOwnedSequence&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename the sequence a column owns (its serial or identity sequence) without touching the column.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenamePolicy&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;policy&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename a policy within its owning table.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenameTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename the target table to a new name in its schema.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenameTrigger&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;trigger&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename the target trigger.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenameType&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;type&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename a user-defined type. Element identity (typeRef) is preserved across the rename.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RenameView&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;view&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Rename the target view to a new name in its schema.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ReplaceFunction&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;function&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Replace a function&amp;rsquo;s body and mutable attributes. Signature is identity-fixed by on= and cannot change.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ReplaceMaterializedView&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;view&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Replace the body of an existing materialized view (DROP CASCADE + CREATE realization).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ReplacePolicy&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;policy&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Replace a policy&amp;rsquo;s TO / USING / WITH CHECK. Cannot change permissive or command (those are identity-fixed; use Drop+Create).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ReplaceView&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;view&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;State the view&amp;rsquo;s whole new definition: query and column list, same element.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;RunRawScript&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;opaque&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;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;rsquo;s name at the script&amp;rsquo;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.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Seal&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;log&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Mark a range of prior ops as sealed (immutable, Merkle-digested).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetColumnComment&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Set or clear a column comment. Empty text clears.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetConstraintComment&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Set or clear a constraint comment. Empty text clears (mirrors PG &lt;code&gt;COMMENT ON CONSTRAINT … ON … IS NULL&lt;/code&gt;).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetConstraintDeferrable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Toggle the DEFERRABLE bit on an FK constraint (PG&amp;rsquo;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.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetConstraintEnforced&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Toggle the ENFORCED bit on a foreign-key (FK) constraint (PostgreSQL alters the enforceability of foreign keys only).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetConstraintInherit&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Toggle the NO INHERIT bit on a NOT NULL constraint (PostgreSQL&amp;rsquo;s per-constraint INHERIT / NO INHERIT applies to NOT NULL only).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetConstraintInitiallyDeferred&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Toggle the INITIALLY DEFERRED bit on an FK constraint (PG&amp;rsquo;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.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetDefault&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Set or replace a column&amp;rsquo;s DEFAULT expression. Single-slot semantics; overwrites whatever default is in effect.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetFunctionComment&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;function&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Set or clear a function comment. Empty text clears (mirrors PG &lt;code&gt;COMMENT ON FUNCTION … IS NULL&lt;/code&gt;).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetIdentityGeneration&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Swap an identity column&amp;rsquo;s generation mode between BY DEFAULT and ALWAYS without dropping the underlying sequence.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetIdentityOptions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;column&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Change an identity column&amp;rsquo;s sequence options (START, INCREMENT, MINVALUE, MAXVALUE, CACHE, CYCLE); an option it does not name keeps its value, and the sequence keeps its position.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetReferenceData&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Declare or undeclare the target table as reference data.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetReplicaIdentity&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Set the table&amp;rsquo;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.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetRowLevelSecurity&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;policy&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Set a table&amp;rsquo;s ROW LEVEL SECURITY enabled/forced facets (absolute {enabled, forced} payload).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SetTableComment&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Set or clear a table comment. Empty text clears (mirrors PG &lt;code&gt;COMMENT ON TABLE … IS NULL&lt;/code&gt;).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SplitTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Move a table&amp;rsquo;s rows into N new tables of its shape by first-match predicate; the source stays (row-axis split).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;UnjoinTable&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;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;rsquo; identities.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ValidateConstraint&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;constraint&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Promote a NOT VALID foreign-key or CHECK constraint to validated.&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;WitnessReferenceData&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;table&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Attest a reference-data record&amp;rsquo;s bytes at its key (written by &lt;code&gt;retrofit data witness&lt;/code&gt;).&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;not available&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;</description></item><item><title>Output contract</title><link>https://docs.retrofit.sh/wip/output-contract/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/output-contract/</guid><description>&lt;h1 id="cli-output-contract"&gt;CLI output contract&lt;a class="anchor" href="#cli-output-contract" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;This document is the canonical reference for what the retrofit CLI&#10;prints, where, and in what shape. It is the contract you script&#10;against.&lt;/p&gt;&#10;&lt;p&gt;The persistent root flag &lt;code&gt;--as=text|json&lt;/code&gt; selects the output mode.&#10;Stdout carries the disposition (a terminal envelope under JSON mode);&#10;stderr carries advisories. Errors normally land on stdout under JSON so&#10;a single &lt;code&gt;jq&lt;/code&gt; filter handles both ok and error paths.&#10;&lt;a href="#channel-exceptions"&gt;Channel exceptions&lt;/a&gt; lists the records that depart&#10;from this rule.&lt;/p&gt;</description></item><item><title>Advisory codes</title><link>https://docs.retrofit.sh/wip/advisory-codes/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/advisory-codes/</guid><description>&lt;h1 id="advisory-codes"&gt;Advisory codes&lt;a class="anchor" href="#advisory-codes" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Every advisory retrofit prints, by code. The register is the word a text line opens with and&#10;the JSON &lt;code&gt;level&lt;/code&gt;: &lt;code&gt;warning&lt;/code&gt; or &lt;code&gt;note&lt;/code&gt;. A braced name such as &lt;code&gt;{table}&lt;/code&gt; is a value the printed&#10;line fills in. A message that varies with a field shows each form on its own line, led by the&#10;field&amp;rsquo;s value. Where the message is only such a value, its detail and hint lines follow it.&lt;/p&gt;</description></item><item><title>Refusal codes</title><link>https://docs.retrofit.sh/wip/refusal-codes/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/refusal-codes/</guid><description>&lt;h1 id="refusal-codes"&gt;Refusal codes&lt;a class="anchor" href="#refusal-codes" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Every code retrofit prints outside the advisories, by code. The kind says where a code comes&#10;from: &lt;code&gt;refusal&lt;/code&gt;, a command refusing; &lt;code&gt;parse&lt;/code&gt;, an oplog that does not parse; &lt;code&gt;validate-check&lt;/code&gt;, a&#10;history check &lt;code&gt;retrofit validate --history&lt;/code&gt; fails; &lt;code&gt;witness-finding&lt;/code&gt;, a data witness finding.&#10;The exit status is what a command exits with when it fails with the code; a code raised in&#10;more than one way lists each. An exit status of none means no command fails with the code&#10;itself: it is printed as a warning, or inside another refusal. The commands are each one that&#10;can print the code; every command means each command in this reference.&lt;/p&gt;</description></item><item><title>pg_dump parity</title><link>https://docs.retrofit.sh/wip/pg_dump-parity/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/pg_dump-parity/</guid><description>&lt;h1 id="pg_dump---schema-only-parity"&gt;pg_dump &lt;code&gt;--schema-only&lt;/code&gt; parity&lt;a class="anchor" href="#pg_dump---schema-only-parity" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;snapshot&lt;/code&gt; emits DDL shaped like &lt;code&gt;pg_dump --schema-only&lt;/code&gt;. This page audits&#10;that claim option by option: for each &lt;code&gt;pg_dump&lt;/code&gt; option that affects a&#10;schema-only dump, what &lt;code&gt;snapshot&lt;/code&gt; does, whether the name is discoverable&#10;from &lt;code&gt;pg_dump&lt;/code&gt;, and whether &lt;code&gt;import&lt;/code&gt; accepts the option&amp;rsquo;s effect on output.&lt;/p&gt;&#10;&lt;p&gt;Options are from the PostgreSQL 18 &lt;code&gt;pg_dump&lt;/code&gt; reference:&#10;&lt;a href="https://www.postgresql.org/docs/18/app-pgdump.html"&gt;https://www.postgresql.org/docs/18/app-pgdump.html&lt;/a&gt;.&lt;/p&gt;&#10;&lt;h2 id="status-legend"&gt;Status legend&lt;a class="anchor" href="#status-legend" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;covered&lt;/strong&gt;: retrofit has an explicit flag or a fixed behavior&#10;matching &lt;code&gt;pg_dump&lt;/code&gt;&amp;rsquo;s contract.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;implicit&lt;/strong&gt;: retrofit never emits the relevant DDL, so the&#10;&lt;code&gt;pg_dump&lt;/code&gt; flag&amp;rsquo;s &amp;ldquo;do not emit X&amp;rdquo; semantics hold trivially.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;gap&lt;/strong&gt;: &lt;code&gt;pg_dump&lt;/code&gt; has it and &lt;code&gt;snapshot&lt;/code&gt; has no counterpart.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;out-of-scope&lt;/strong&gt;: the option does not fit an oplog-in, one-stream-out&#10;emitter.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="snapshot-side-retrofit-snapshot-vs-pg_dump---schema-only"&gt;Snapshot side (&lt;code&gt;retrofit snapshot&lt;/code&gt; vs &lt;code&gt;pg_dump --schema-only&lt;/code&gt;)&lt;a class="anchor" href="#snapshot-side-retrofit-snapshot-vs-pg_dump---schema-only" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;&lt;code&gt;pg_dump&lt;/code&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;&lt;code&gt;snapshot&lt;/code&gt; today&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;status&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;round-trip via &lt;code&gt;import&lt;/code&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;-s, --schema-only&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--ddl-only&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;covered&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a (input shape)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;-c, --clean&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--include-drop=scoped|schema&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;covered (no alias)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;DROP statements skipped (gap below)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--if-exists&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;folded into &lt;code&gt;--include-drop=scoped|schema&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;covered (contract)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a (DROPs skipped)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;-C, --create&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;none (schema-scoped, never &lt;code&gt;CREATE DATABASE&lt;/code&gt;)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;out-of-scope&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;-O, --no-owner&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit (no owner concept in vocab)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a (OWNER TO is skipped)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;-x, --no-privileges&lt;/code&gt; / &lt;code&gt;--no-acl&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit (no GRANT/REVOKE)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a (GRANT/REVOKE is skipped)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--no-comments&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--no-comments&lt;/code&gt; suppresses &lt;code&gt;COMMENT ON&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;covered&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;tolerant (in vocab)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--no-tablespaces&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit (no &lt;code&gt;TABLESPACE …&lt;/code&gt;)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--no-table-access-method&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit (no &lt;code&gt;USING &amp;lt;method&amp;gt;&lt;/code&gt; on CREATE TABLE)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--quote-all-identifiers&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;always quotes every identifier&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;covered (contract)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;tolerant (parser is quote-agnostic)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;-n, --schema=&amp;lt;pattern&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--schema &amp;lt;registered-name&amp;gt;&lt;/code&gt; (single, not pattern)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;covered (different shape)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;-N, --exclude-schema&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--exclude-schema=&amp;lt;name&amp;gt;&lt;/code&gt; (repeatable, exact-match)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;covered (exact-match)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;-t, --table&lt;/code&gt; / &lt;code&gt;-T, --exclude-table&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--table=&amp;lt;name&amp;gt;&lt;/code&gt; / &lt;code&gt;--exclude-table=&amp;lt;name&amp;gt;&lt;/code&gt; (repeatable, exact-match)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;covered (exact-match)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;tolerant (output is a strict subset)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--section=pre-data|post-data&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;none (single-stream emit)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;gap&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;tolerant either way&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--no-statistics&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit (no &lt;code&gt;ANALYZE&lt;/code&gt; or stats emission)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;-f, --file=&amp;lt;path&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;none (stdout only)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;out-of-scope (pipe-only)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--no-policies&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;none (&lt;code&gt;CREATE POLICY&lt;/code&gt; is emitted; no suppression flag)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;gap&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;tolerant (in vocab)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--no-publications&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit (no &lt;code&gt;CREATE PUBLICATION&lt;/code&gt;)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--no-subscriptions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit (no &lt;code&gt;CREATE SUBSCRIPTION&lt;/code&gt;)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--no-security-labels&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit (no &lt;code&gt;SECURITY LABEL&lt;/code&gt;)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--use-set-session-authorization&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit (no owner concept)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;implicit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;-e, --extension&lt;/code&gt; / &lt;code&gt;--exclude-extension&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;none (&lt;code&gt;CREATE EXTENSION&lt;/code&gt; is emitted; no include/exclude filter)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;gap&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;extensions in vocab on import&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--strict-names&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a (single-name lookup, no pattern matching)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;out-of-scope&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--filter=&amp;lt;file&amp;gt;&lt;/code&gt;, &lt;code&gt;--table-and-children&lt;/code&gt;, &lt;code&gt;--exclude-table-and-children&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;none (filtering machinery)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;out-of-scope&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;-F, --format&lt;/code&gt;, &lt;code&gt;-Z, --compress&lt;/code&gt;, &lt;code&gt;--no-sync&lt;/code&gt;, &lt;code&gt;--sync-method&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;plain stream only&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;out-of-scope&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;--binary-upgrade&lt;/code&gt;, &lt;code&gt;--snapshot&lt;/code&gt;, &lt;code&gt;--serializable-deferrable&lt;/code&gt;, &lt;code&gt;--lock-wait-timeout&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;live-DB-only knobs&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;out-of-scope (retrofit emits from the oplog, not a live DB)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;n/a&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;h3 id="notes-on-individual-rows"&gt;Notes on individual rows&lt;a class="anchor" href="#notes-on-individual-rows" aria-label="Link"&gt;&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;&lt;strong&gt;&lt;code&gt;-c, --clean&lt;/code&gt; (no alias).&lt;/strong&gt; The &lt;code&gt;--include-drop=none|scoped|schema&lt;/code&gt; flag&#10;encodes a blast-radius choice that &lt;code&gt;pg_dump&lt;/code&gt;&amp;rsquo;s single &lt;code&gt;--clean&lt;/code&gt; switch&#10;does not. Aliasing &lt;code&gt;--clean&lt;/code&gt; to one of the three modes (most naturally&#10;&lt;code&gt;scoped&lt;/code&gt;) would let a user paste muscle memory from &lt;code&gt;pg_dump&lt;/code&gt; and silently&#10;pick the wrong radius. &lt;code&gt;--include-drop=scoped&lt;/code&gt; is the nearest match for&#10;&lt;code&gt;pg_dump --clean --if-exists&lt;/code&gt;; there is no &lt;code&gt;--clean&lt;/code&gt; alias.&lt;/p&gt;</description></item><item><title>PostgreSQL versions</title><link>https://docs.retrofit.sh/wip/postgresql-versions/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/postgresql-versions/</guid><description>&lt;h1 id="postgresql-versions"&gt;PostgreSQL versions&lt;a class="anchor" href="#postgresql-versions" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;This page says which PostgreSQL majors this build supports, what it reads&#10;and writes at each one, and what the engine version governs. Only the&#10;major is modeled. Each guide states its own verb&amp;rsquo;s row and links here.&lt;/p&gt;&#10;&lt;h2 id="supported-majors"&gt;Supported majors&lt;a class="anchor" href="#supported-majors" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Major&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Tested on a live server&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Reads its &lt;code&gt;pg_dump&lt;/code&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Writes SQL it runs&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Reads its new syntax&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Writes its new syntax&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;15&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;16&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;17 (default)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;18&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Yes&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;No&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;No&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;This build reads and writes PostgreSQL 17 syntax at every engine version.&#10;PostgreSQL 18&amp;rsquo;s own syntax (&lt;code&gt;VIRTUAL&lt;/code&gt; generated columns, &lt;code&gt;NOT ENFORCED&lt;/code&gt;&#10;constraints, &lt;code&gt;WITHOUT OVERLAPS&lt;/code&gt; and &lt;code&gt;PERIOD&lt;/code&gt; keys, and &lt;code&gt;ALTER CONSTRAINT … [NO] INHERIT&lt;/code&gt;) is not available: &lt;code&gt;op add&lt;/code&gt; and &lt;code&gt;op revise&lt;/code&gt; refuse it with&#10;&lt;code&gt;syntax-not-available&lt;/code&gt; at every engine version, a verb that reads a log&#10;holding it refuses with the same code, and &lt;code&gt;import&lt;/code&gt; and &lt;code&gt;drift&lt;/code&gt; exit 1 with&#10;&lt;code&gt;parse-error&lt;/code&gt; on it.&lt;/p&gt;</description></item><item><title>Versions and compatibility</title><link>https://docs.retrofit.sh/wip/versions-and-compatibility/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/versions-and-compatibility/</guid><description>&lt;h1 id="versions-and-compatibility"&gt;Versions and compatibility&lt;a class="anchor" href="#versions-and-compatibility" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;This page says how a build is numbered, what may change between two&#10;releases, and which lines of the &lt;a href="https://docs.retrofit.sh/wip/oplog/#the-oplog"&gt;oplog&lt;/a&gt; and&#10;&lt;code&gt;retrofit.toml&lt;/code&gt; decide whether a build reads a project.&lt;/p&gt;&#10;&lt;h2 id="version-numbers"&gt;Version numbers&lt;a class="anchor" href="#version-numbers" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Version&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Build&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;X.Y.Z&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;a release, such as &lt;code&gt;0.10.0&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;X.Y.Z-wip.N&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;a WIP build toward the release &lt;code&gt;X.Y.Z&lt;/code&gt;, such as &lt;code&gt;0.11.0-wip.33&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;Before 1.0 each release raises the minor and sets the patch to 0: the&#10;release after &lt;code&gt;0.10.0&lt;/code&gt; is &lt;code&gt;0.11.0&lt;/code&gt;, and the WIP builds toward it are&#10;&lt;code&gt;0.11.0-wip.N&lt;/code&gt;. &lt;code&gt;N&lt;/code&gt; counts WIP builds across every release and is never&#10;reset: &lt;code&gt;0.10.0-wip.31&lt;/code&gt; was followed by &lt;code&gt;0.11.0-wip.32&lt;/code&gt;.&lt;/p&gt;</description></item><item><title>History checks</title><link>https://docs.retrofit.sh/wip/history-checks/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/history-checks/</guid><description>&lt;h1 id="history-checks"&gt;History checks&lt;a class="anchor" href="#history-checks" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;code&gt;retrofit validate --history &amp;lt;dir&amp;gt;&lt;/code&gt; runs the history checks: it reads the&#10;commits a pull request&amp;rsquo;s integration made from a history bundle, a&#10;directory a CI job writes, and checks each commit&amp;rsquo;s&#10;&lt;a href="https://docs.retrofit.sh/wip/glossary/#oplog"&gt;oplog&lt;/a&gt; against what the oplog&amp;rsquo;s form promises. It&#10;runs no git, and it writes nothing. &lt;a href="https://docs.retrofit.sh/wip/check-a-pull-request/"&gt;Check a pull request in CI&lt;/a&gt;&#10;is the task guide, and &lt;a href="https://docs.retrofit.sh/wip/gate-merges/"&gt;Gate merges on GitHub and GitLab&lt;/a&gt;&#10;sets the checks up on each host.&lt;/p&gt;</description></item><item><title>Glossary</title><link>https://docs.retrofit.sh/wip/glossary/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/glossary/</guid><description>&lt;h1 id="glossary"&gt;Glossary&lt;a class="anchor" href="#glossary" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;The terms retrofit coins, one entry each. An entry uses the words of&#10;&lt;code&gt;--help&lt;/code&gt; where &lt;code&gt;--help&lt;/code&gt; defines the term, and links to the section that&#10;explains it.&lt;/p&gt;&#10;&lt;h2 id="anchor"&gt;anchor&lt;a class="anchor" href="#anchor" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;A canonical anchor, &lt;code&gt;root&lt;/code&gt;, &lt;code&gt;last&lt;/code&gt; or &lt;code&gt;seal&lt;/code&gt;, names a &lt;a href="#cut"&gt;cut&lt;/a&gt; by&#10;position, with an optional &lt;code&gt;^&lt;/code&gt; or &lt;code&gt;~N&lt;/code&gt; &lt;a href="#decrement"&gt;decrement&lt;/a&gt;; a data&#10;record&amp;rsquo;s anchor is the op it is filed under, its anchor-op&#10;(&lt;a href="https://docs.retrofit.sh/wip/data-files/#stale-data-references-and-repair"&gt;Stale data references and repair&lt;/a&gt;).&lt;/p&gt;&#10;&lt;h2 id="attestation"&gt;attestation&lt;a class="anchor" href="#attestation" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;A fact you state that retrofit cannot observe, made by a flag that names&#10;the fact (&lt;code&gt;--allow-external-atomicity&lt;/code&gt; attests that the apply context&#10;owns transaction atomicity) or by running a command that is the&#10;attestation itself (&lt;code&gt;op unseal&lt;/code&gt;), which answers an advisory or clears a&#10;refusal&#10;(&lt;a href="https://docs.retrofit.sh/wip/output-contract/#attestation-answering-an-advisory-instead-of-silencing-it"&gt;Attestation&lt;/a&gt;).&lt;/p&gt;</description></item><item><title>Release notes</title><link>https://docs.retrofit.sh/wip/release-notes/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.retrofit.sh/wip/release-notes/</guid><description>&lt;h1 id="changelog"&gt;Changelog&lt;a class="anchor" href="#changelog" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;All notable changes to retrofit are recorded here, newest first, in the&#10;categories of &lt;a href="https://keepachangelog.com/en/1.1.0/"&gt;Keep a Changelog&lt;/a&gt;.&#10;Before 1.0 retrofit promises no compatibility: a change is disclosed here,&#10;not prevented.&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;[Unreleased]&lt;/code&gt; records what the builds since the last release changed; a&#10;release renames it to its version. Its fixed &lt;strong&gt;Log format&lt;/strong&gt; heading records&#10;every change to the oplog&amp;rsquo;s vocabulary, parameters, headers or seal bytes:&#10;what changed and what a user does, usually regenerating the log. CI fails a&#10;commit that changes &lt;code&gt;internal/oplog/catalog/*.golden.json&lt;/code&gt;,&#10;&lt;code&gt;internal/oplog/serialize/&lt;/code&gt; outside its tests, or&#10;&lt;code&gt;internal/seal/testdata/leafbytes_*.golden&lt;/code&gt; but adds no item under that&#10;heading itself (&lt;code&gt;make logformat-check&lt;/code&gt;); with &lt;code&gt;make hooks&lt;/code&gt;, the&#10;commit-msg hook refuses it at &lt;code&gt;git commit&lt;/code&gt;. A commit whose serializer edit&#10;changes none of the vocabulary, parameters, headers or seal bytes may&#10;instead end its message with a &lt;code&gt;Log-format: unchanged&lt;/code&gt; trailer; a reader&#10;refusing a log it used to accept is a format change. A change to either set&#10;of goldens always needs the item.&lt;/p&gt;</description></item></channel></rss>