Consents
A consent is an input that clears a refusal a verb would otherwise raise. Every consent is one spelling, naming one fact, in one kind, and the spelling is the same token on every verb that takes the fact. There are two kinds:
- apply context: a standing fact about where the script runs. The flag takes no value.
- sealed history: operations a Seal attested are rewritten. The side-effect
arm (
reconcile,import --force) is attested one Seal at a time, by opid:--allow-sealed-rewrite=<seal opid>, repeatable and comma-separated. A value attests the Seal it names and selects nothing; a Seal left unnamed refusesseal-removal-refused. The same kind, as the command’s own named act, is taken byop unseal,op truncate --drop-sealsandschema remove(unless--keep-oplog), which take no spelling: the command is the attestation.
No consent is needed to emit an authored drop, whatever it drops. No consent is asked, either, for rows a rendered step loses (a down that drops a column written since, or narrows a type and rounds) or for a rule a rendered step re-imposes for PostgreSQL to check at apply; the render’s report and script name each.
The table below holds every consent and every outside row, each with its class.
An outside row clears a refusal, or answers a warning as
--allow-unnamed-label does, but accepts no fact of a kind above. The code
holds the same table; a test checks this one against it.
| Kind or class | Fact or what it does | Spelling | Verbs |
|---|---|---|---|
| missing input | supplies what the request left open; clears only the refusal naming it missing | [directory_scope] | config key |
| resource bound | a project property bounding what a run reads | data_band_max_bytes | config key |
| missing input | supplies what the request left open; clears only the refusal naming it missing | default_schema | config key |
| apply-context declaration | declares where the script runs, selecting what the render emits; not a fact accepted | engine_version | config key |
| apply-context declaration | declares where the script runs, selecting what the render emits; not a fact accepted | envelope | config key |
| inverse polarity | an opt-in refusal; turning it on adds a refusal | lock_timeout | config key |
| missing input | supplies what the request left open; clears only the refusal naming it missing | EDITOR | environment variable |
| starting-state attestation | attests the cut the database is at, from which apply-risk is judged in place of the latest Seal; clears no refusal | RETROFIT_DATABASE_AT | environment variable |
| missing input | supplies what the request left open; clears only the refusal naming it missing | RETROFIT_NOEDITOR | environment variable |
| inverse polarity | an opt-in refusal; turning it on adds a refusal | RETROFIT_REQUIRE_EXPLICIT_SCHEMA | environment variable |
| missing input | supplies what the request left open; clears only the refusal naming it missing | VISUAL | environment variable |
| missing input | supplies what the request left open; clears only the refusal naming it missing | --chdir | every verb (root flag) |
| missing input | supplies what the request left open; clears only the refusal naming it missing | --schema | every verb that resolves a schema |
| ingest coverage | covers DDL retrofit cannot represent on ingest | --allow-capability-gaps | drift |
| readers moved | attests that the readers of the renamed table or column a value names are handled by the time the rename applies; answers the apply-risk-rename-in-use warning for that name, clears no refusal | --allow-readers-moved | drift |
| starting-state attestation | attests the cut the database is at, from which apply-risk is judged in place of the latest Seal; clears no refusal | --database-at | drift |
| mode or selector | selects a mode or a subset of the run | --ignore-drops | drift |
| missing input | supplies what the request left open; clears only the refusal naming it missing | --interactive | drift |
| mode or selector | selects a mode or a subset of the run | --on-question | drift |
| ingest coverage | covers DDL retrofit cannot represent on ingest | --allow-capability-gaps | import |
| readers moved | attests that the readers of the renamed table or column a value names are handled by the time the rename applies; answers the apply-risk-rename-in-use warning for that name, clears no refusal | --allow-readers-moved | import |
| starting-state attestation | attests the cut the database is at, from which apply-risk is judged in place of the latest Seal; clears no refusal | --database-at | import |
| mode or selector | selects a mode or a subset of the run | --force | import |
| corpus disposition at oplog replacement | removes the corpus records a replaced oplog orphans; attests no Seal | --purge-orphaned-corpus | import |
| mode or selector | selects a mode or a subset of the run | --force | init |
| apply context | the apply context owns atomicity | --allow-external-atomicity | migrate |
| authored data-corpus content | accepts authored data-corpus content, as shipped | --allow-reading-replace-body | migrate |
| authored data-corpus content | accepts authored data-corpus content, as shipped | --allow-stale-dml | migrate |
| authored data-corpus content | accepts authored data-corpus content, as shipped | --allow-unclassified-dml | migrate |
| dataset left unnamed | attests that a labelled dataset is left out of the run on purpose; answers the not-named warning, clears no refusal | --allow-unnamed-label | migrate |
| authored data-corpus content | accepts authored data-corpus content, as shipped | --allow-unscreened-dml | migrate |
| apply-context declaration | declares where the script runs, selecting what the render emits; not a fact accepted | --envelope | migrate |
| inverse polarity | an opt-in refusal; turning it on adds a refusal | --lock-timeout | migrate |
| apply-context declaration | declares where the script runs, selecting what the render emits; not a fact accepted | --using | migrate |
| readers moved | attests that the readers of the renamed table or column a value names are handled by the time the rename applies; answers the apply-risk-rename-in-use warning for that name, clears no refusal | --allow-readers-moved | op add |
| starting-state attestation | attests the cut the database is at, from which apply-risk is judged in place of the latest Seal; clears no refusal | --database-at | op add |
| readers moved | attests that the readers of the renamed table or column a value names are handled by the time the rename applies; answers the apply-risk-rename-in-use warning for that name, clears no refusal | --allow-readers-moved | op revert |
| missing input | supplies what the request left open; clears only the refusal naming it missing | --interactive | op revise |
| mode or selector | selects a mode or a subset of the run | --accept-dirty | reconcile |
| authored data-corpus content | accepts authored data-corpus content, as shipped | --allow-reading-replace-body | snapshot |
| authored data-corpus content | accepts authored data-corpus content, as shipped | --allow-stale-dml | snapshot |
| dataset left unnamed | attests that a labelled dataset is left out of the run on purpose; answers the not-named warning, clears no refusal | --allow-unnamed-label | snapshot |
| mode or selector | selects a mode or a subset of the run | --include-drop | snapshot |
| apply-context declaration | declares where the script runs, selecting what the render emits; not a fact accepted | --using | snapshot |
| apply context | CI applies the range to a database before it lands | --allow-database-apply | validate |
| read-only gate disposition | a read-only gate reports without failing | --allow-unmerged-fork | validate |
| inverse polarity | an opt-in refusal; turning it on adds a refusal | --fail-on-apply-risk | validate |
| sealed history | operations a seal attested are rewritten | --allow-sealed-rewrite | reconcile |
| sealed history | operations a seal attested are rewritten | --allow-sealed-rewrite | import |
| sealed history | the same, as the command’s named act | none: the command | op unseal, op truncate --drop-seals, schema remove (unless --keep-oplog) |