Development record
abcd-s-verbs-consolidate-ahoy-s-three-modes-become-flags
specclosedspc-2609212139587510
Summary
The design record for itd-2609212130136102: the verb consolidation, one breaking change beside the four renames.
Scope
- Flags on
ahoywith the three sub-verbs kept one release as deprecated stubs that print the flag form and exit 2 (criterion 1). --versionon the root;update --check;intent newdeleted (criterion 2).linttargets:lintgains sub-verbsdocs,outbound,site,identitythat call the existing functions; the old verbs become stubs for one release;docskeepscite,sitekeepsbuild(criterion 3).- The snapshot gains
moved_toper stub; pages and brief chapters regenerated and edited; the intent'simpact: breakingderives the cut (criterion 4). - The count test over the rendered default help (criterion 5).
Out of scope
- The agent block; record-family verbs.
Approach
Stubs for one release keep muscle memory from failing silently; the release after removes them (a follow-on remainder spec, minted at close).
Footprint
- packages: internal/surface/cli, internal/core/surface, commands/, .abcd/development/brief/04-surfaces
- tests: each stub's message and exit; each flag and target's behaviour equal to the old verb; the snapshot's moved_to; the count
How the criteria are satisfied
| Criterion | Where |
|---|---|
| 1 ahoy flags | scope 1 |
| 2 --version, update --check, no intent new | scope 2 |
| 3 one lint | scope 3 |
| 4 snapshot, pages, breaking | scope 4 |
| 5 fourteen at most | scope 5 |
Frontmatter
| id | spc-2609212139587510 |
|---|---|
| type | spec |
| lifecycle | closed |
.abcd/development/specs/closed/spc-2609212139587510-abcd-s-verbs-consolidate-ahoy-s-three.md
open on GitHub ↗ · commit history ↗
References1
- itd-2609212130136102abcd's verbs consolidate: modes become flags and five checks become one lintimplements