diff --git a/docs/internal/overview.md b/docs/internal/overview.md index dbf1bc1..0073154 100644 --- a/docs/internal/overview.md +++ b/docs/internal/overview.md @@ -13,18 +13,21 @@ provider adapters. Configuration reports adapt ConfigKit's public records and writers. PromptKit scope and definition handlers use PromptKit's public inspection methods and map their results to CommandKit-owned reports. -The root package imports `internal/cobra` to bridge its command declarations and -invocations to Cobra parsing and routing. Application callbacks, output streams, -context, and supported error identity cross that bridge through the root's typed -contracts. +The root lowers registered command metadata into the internal adapter's neutral +bridge. The adapter returns raw parsed values and neutral syntax-failure data; +the root prepares typed input, invokes application/standard handlers, and +coordinates outcomes and diagnostic delivery. Application callbacks and their +supported error identity remain in the root's typed contracts rather than +crossing the backend bridge. Context and streams are passed to the adapter for +its parsing and help operations. ## `internal/cobra` -This package owns the Cobra-specific command tree and argument/flag parsing -adapter. It translates neutral command metadata and parsed values into a bridge +This package owns the Cobra-specific command tree, argument/flag parsing, +and help rendering. It translates neutral command metadata and parsed values into a bridge result consumed by the root package. It does not import `commandkit` and does not -own registry policy, public command declarations, provider loading, or report -rendering. +own registry policy, public command declarations, provider loading, or standard +inspection report rendering. ## External implementation boundaries diff --git a/docs/roadmap/remediation.md b/docs/roadmap/remediation.md index 50e8598..b9b8289 100644 --- a/docs/roadmap/remediation.md +++ b/docs/roadmap/remediation.md @@ -186,12 +186,14 @@ Owners: [testing.md](../policy/testing.md) and [oss.md](../policy/oss.md). Owner: [internal/overview.md](../internal/overview.md). -- [ ] Correct the claim that application callbacks cross the adapter bridge. +- [x] Correct the claim that application callbacks cross the adapter bridge. Handler callbacks and typed invocation coordination remain in the root; the adapter exchanges neutral metadata and parse results. -- [ ] Keep inventory/mechanics here and normative responsibility boundaries in +- [x] Keep inventory/mechanics here and normative responsibility boundaries in the architecture policy. +**Completion:** Corrected neutral metadata/results flow and root callback ownership; distinguished adapter help rendering from standard inspection reports. + ## D-10: reconcile navigation and reading guidance Owners: [development.md](../development.md) and [README.md](../../README.md).