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

Route executions through neutral snapshots

Browse Source
This commit is contained in:
Eric Rakestraw
2026-10-11 01:25:45 +00:00
parent 24e8cd8629
commit 7e5f84bf16
12 changed files with 217 additions and 191 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
docs/roadmap/implementation.md
View File

@@ -1,6 +1,6 @@
# Implement the optional integration modules and captured registration API
Status: implementation in progress. Stages 1 through 6 are complete; subsequent work follows the ordered roadmap.
Status: implementation in progress. Stages 1 through 7 are complete; subsequent work follows the ordered roadmap.
Execute the stages in order. Each stage is sized as a separate Luna coding-agent
assignment. This document authorizes no publication or changes to sibling
repositories.
@@ -357,10 +357,16 @@ help/usage presentation.
7. Preserve local flags after the complete command path, interspersed operands,
`--`, short help, malformed-input behavior, and public error isolation.
**Completion evidence:** run the now-complete core and adapter suites. Exercise
registration followed by help, callback-driven metadata refresh without replay,
runnable parents, repeated execution with fresh values, cancellation, and public
outcome delivery. No concurrency or snapshot-isolation guarantee is added.
**Completion evidence — complete:** neutral command, binding, parse, and failure
records now live in `internal/commandmeta`; Cobra owns only its mutable session
and adapter logic. One cached snapshot projects sorted metadata and keys to its
runner table. Parsing returns a snapshot-local key, and execution selects from
that same snapshot without a second path lookup. Each invocation creates one
session reused by parse/help/usage; presentation refreshes after registration
without reinterpreting the original key or replaying callbacks. Core and adapter
tests pass, including registration/help refresh, runner-key pairing, runnable
parents, fresh input, cancellation, and outcome delivery. No concurrency or
snapshot-isolation guarantee is added.
## Stage 8: Implement configuration contracts and native ConfigKit adapters