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

Add invocation coordination and diagnostics

Browse Source
This commit is contained in:
Eric Rakestraw
2026-10-07 13:30:24 +00:00
parent f206c531f1
commit c3448a2ebe
5 changed files with 462 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/roadmap/implementation.md
View File

@@ -1,6 +1,6 @@
# Initial CommandKit implementation plan
Status: implementation underway; Stages 1-4 complete and Stages 5-14 pending.
Status: implementation underway; Stages 1-5 complete and Stages 6-14 pending.
Date: 2026-10-07.
@@ -346,7 +346,7 @@ only the internal adapter and not Cobra or pflag.
## Stage 5: implement invocation and diagnostic delivery
**Status:** pending. **Prerequisite:** Stage 4.
**Status:** complete. **Prerequisite:** Stage 4.
Add `func (a *App) Execute(ctx context.Context, args []string, streams Streams) Outcome`.
It consumes argv without the executable name. Use the supplied nonnil context;
@@ -393,6 +393,12 @@ warning-only success; diagnostic failure after operation failure retains both;
report failure marks incomplete delivery; no duplicate root diagnostics; no process
exit. Include a consecutive run that omits previously supplied flags/operands.
**Completion evidence:** external-package tests exercise real parsing and dispatch,
typed state freshness, usage and input-check causes, domain outcomes, warning-only
success, completed diagnostic suppression, checked short writes, and combined
operation/delivery failures. `go test ./...` passes. Report-writing implementations
will set `ReportIncomplete` when introduced with the standard reports.
## Stage 6: complete help and version
**Status:** pending. **Prerequisite:** Stage 5.