Development record
Five 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.
Five 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.
Frontmatter
| id | iss-2610251559136898 |
|---|---|
| type | issue |
| lifecycle | open |
| severity | minor |
.abcd/work/issues/open/iss-2610251559136898-five-sentences-in-internal-core-surface.md
open on GitHub ↗ · commit history ↗
mentions2
- iss-2610160608444348The 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'.
- iss-2610252211476480Two intent sentences name less than the verb writes. intent audit (internal/core/surface/sentences.go:242-243; page line 3061) says 'Writes an OWED stub only for --owed or an id', but --issue-drift leaves a report under .abcd/.work.local/logs/audit/issue-drift-<ts>/ (internal/core/capture/drift.go:68-73,179), and on a provider route audit <itd-N> sends the request and ingests the verdict into the shipped intent's Audit Notes (internal/surface/cli/cli.go:3446-3448, dispatch.go:179-211). intent consistency (sentences.go:248-249; page line 3123) says 'Writes the request locally', but on a provider route it sends each request and ingests the answers, writing the dated review and one capture per finding (internal/surface/cli/intent_consistency.go:105-121). Both sentences predate provider dispatch (51c7a9744). Same class as iss-2610251559136898, which holds five other sentences.