Development record
The shipped terminal help for the ingest verb states three things the code does not do, and because the CLI reference page is generated from the command's own long description, the false text is what an operator reads at the terminal and in the docs alike. It says nothing durable is written until the whole payload validates, which the orphan sweep contradicts by deleting a committed record during a refused run. It describes the orphan sweep in wording that omits the committed-tier delete, which is the exact sentence the code's own comment warns must stay true. And it says each regime has reserved names, which is false at the generative position, where there are none and no signature refusal either. A generated page inherits whatever the source string claims, so one wrong sentence in a Long field becomes a wrong sentence in two shipped surfaces at once.
The shipped terminal help for the ingest verb states three things the code does not do, and because the CLI reference page is generated from the command's own long description, the false text is what an operator reads at the terminal and in the docs alike. It says nothing durable is written until the whole payload validates, which the orphan sweep contradicts by deleting a committed record during a refused run. It describes the orphan sweep in wording that omits the committed-tier delete, which is the exact sentence the code's own comment warns must stay true. And it says each regime has reserved names, which is false at the generative position, where there are none and no signature refusal either. A generated page inherits whatever the source string claims, so one wrong sentence in a Long field becomes a wrong sentence in two shipped surfaces at once.
Grounds
- pursued: a generated reference page inherits whatever its source string claims, so a wrong sentence in a long description is wrong in two shipped surfaces at once and the fix belongs in the string; a help sentence contradicted by the verb's own behaviour would show this wrong
Frontmatter
| id | iss-2608311518199679 |
|---|---|
| type | issue |
| lifecycle | resolved |
| severity | major |
.abcd/work/issues/resolved/iss-2608311518199679-the-shipped-terminal-help-for-the-ingest.md
open on GitHub ↗ · commit history ↗
mentions1
- iss-2609020843067458The ingest verb's terminal help still claims a refusal deletes nothing, and gives the orphan sweep one outcome where the code has two. iss-2608311518199679 named three false sentences in the same Long field and its fix reaches two of them; the durability sentence reads "written or deleted" without the qualification that makes it true, and the sweep sentence carries the committed-tier delete without the case in which there is none. A refusal after the run's identity is proven calls rollbackThisRun on every path, which removes the never-committed reading records of an earlier attempt at the same run id from the committed ledger — so "leaves its refusal record and nothing else" describes a verb that makes no delete, and the verb makes one. rollbackRun returns without touching anything when the run's commit marker is present, and sweepOrphanStages clears the stage regardless, so a sweep over a leftover stage rolls nothing back and the help promises a rollback that does not come. The neighbouring "before that point nothing is written anywhere" is false of the stage root and its lock, which are created before the payload is read; the claim is about the durable tier. Because docs/reference/cli/commands.md is generated from the Long field, each of these is wrong at the terminal and on the reference page at once.