Development record
The drain sentence at internal/core/surface/sentences.go:130, 'Writes its state and user-visible drafts', shown by abcd drain --help, commands/drain.md:3 and docs/reference/cli/commands.md, omits a remote write: in a checkout with origin, drain reserves each issue it takes by pushing abcd-reserved/<iss-N> to origin (commands/drain.md:146-162), and the 81-line help never mentions origin or a reservation. build's sentence already says 'Writes the run's state and its reservation'.
issueopenminoriss-2610160608444348
The drain sentence at internal/core/surface/sentences.go:130, 'Writes its state and user-visible drafts', shown by abcd drain --help, commands/drain.md:3 and docs/reference/cli/commands.md, omits a remote write: in a checkout with origin, drain reserves each issue it takes by pushing abcd-reserved/<iss-N> to origin (commands/drain.md:146-162), and the 81-line help never mentions origin or a reservation. build's sentence already says 'Writes the run's state and its reservation'.
Frontmatter
| id | iss-2610160608444348 |
|---|---|
| type | issue |
| lifecycle | open |
| severity | minor |
.abcd/work/issues/open/iss-2610160608444348-the-drain-sentence-at-internal-core.md
open on GitHub ↗ · commit history ↗
mentions1
- iss-2610251559136898Five sentences in internal/core/surface/sentences.go name less than the verb writes; each renders on the verb's help and on docs/reference/cli/commands.md. (1) ahoy uninstall (sentences.go:47; page 158) says 'Writes the removal of the marker block, PATH copy, and provenance record'. Uninstall also removes the README parts (internal/core/ahoy/apply.go:2196, readme_apply.go:454) and restores the harness's status-line command (apply.go:2201, statusline_apply.go:280-310). (2) capture resolve and (3) capture wontfix (sentences.go:88, 92; page 672, 714) say 'Writes the moved record'. The transition also repoints every relative markdown link in the working tree that named the old path (internal/core/capture/workflow.go:715; internal/core/relink/relink.go:1-4). (4) build next (sentences.go:63; page 411) leaves out the reservation its start pushes to origin (internal/core/implement/loop/loop.go:412), which build's own sentence names. (5) docs fidelity (sentences.go:125; page 1141) says 'Writes drafted edits only with --apply', yet --autonomous applies them too (internal/surface/cli/docfidelity.go:128). Same class as iss-2610160608444348, which holds the drain sentence.