base-layer/commandkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

Share flag consumption between parsing and completion

Browse Source
This commit is contained in:
Eric Rakestraw
2026-11-07 15:53:32 +00:00
parent 51a147a6e5
commit 02cd49d6b6
6 changed files with 153 additions and 114 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
docs/roadmap/audit/catalog.md
View File

@@ -1,6 +1,6 @@
# Consolidated audit catalog
Status: **13 distinct open findings: 13 P3**, consolidated from 30
Status: **12 distinct open findings: 12 P3**, consolidated from 30
numbered entries in seven audit documents. Reviewed audit state:
`db732e3a1de55c844f77870e1c6db683c2685d5d`.
@@ -335,6 +335,11 @@ F14 under the decisions recorded there and in F13.
## F16 — P3: Parsing and completion duplicate flag-consumption grammar
**Complete.** A neutral consumption operation is shared by execution parsing
and completion. Focused grammar, provenance and completion tests and available
Bash interactive checks pass; missing-value and partial-input policies remain
with their callers.
Execution parsing and completion separately implement short clusters,
attached/next values, boolean assignments, terminators, and unknown spellings.
Shared classification helpers cover only part of the grammar, leaving changes to
@@ -350,7 +355,7 @@ CLI behavior; no public parser or replacement backend is selected.
Retain caller-specific branches where combining them would require extensive
modes or special cases. Repair F06's completion fixture before validating this
refactor. The [F16 analysis](remediation-analysis.md#f16--shared-flag-consumption)
records the accepted boundary; implementation remains pending.
records the accepted boundary.
**Original:** [03-complexity M3](03-complexity.md#m3--p3-parsing-and-completion-maintain-parallel-flag-consumption-logic).

8
docs/roadmap/implementation.md
View File

@@ -1,6 +1,6 @@
# Audit remediation implementation plan
Status: in progress; Stages 1–13 complete.
Status: in progress; Stages 1–14 complete.
Baseline: `d492c7747175c01a53261206c2b4356e53453621`. Before this sprint,
intervening changes recorded decisions and retired the completed older
@@ -470,6 +470,12 @@ Keep F24 open until the binding wrappers are handled in stage 20.
## Stage 14 — Share internal flag-consumption facts
**Complete.** Parsing and completion share neutral consumption facts while
retaining their separate failure and partial-input policies. Focused parser,
alias, occurrence and completion tests and both interactive Bash checks passed
in the offline aligned Go 1.27.0 workspace. Zsh and Fish remain unavailable as
recorded in Stage 6.
Findings: F16. Sources: `internal/commandmeta/flags.go`,
`internal/cobra/flags.go`, and `completion_flags.go`; stage 6 is prerequisite.