Record completed configuration outcome remediation

This commit is contained in:
2026-11-16 19:03:21 +00:00
parent 21dac4f89e
commit 735b35a0a1
2 changed files with 30 additions and 22 deletions

View File

@@ -1,9 +1,10 @@
# Invalid configuration outcomes
Status — accepted feature roadmap, pending implementation. The user has
accepted the targeted behavior and both design decisions below. The
[implementation plan](implementation.md) owns the ordered work, exact code
mapping, shared API signature, and verification.
Status — implemented, with review remediation complete. The
[implementation plan](implementation.md) and [remediation record](remediation.md)
record the completed work and verification. Publication and downstream dependency
alignment remain in the [release handoff](future.md#configuration-outcome-release-handoff).
The accepted behavior and design decisions are recorded below.
## Purpose
@@ -17,7 +18,7 @@ validation, diagnostic meaning, and their public error contracts. Application
commands own their domain outcomes. These responsibilities follow the
[architecture policy](../policy/architecture.md#ownership-boundaries).
## Current baseline
## Historical baseline
The reviewed baseline is CommandKit commit
`1e92a87706e44684ee34395245e5b633474677e0`, following the publication of
@@ -32,19 +33,20 @@ while Audita's processing command returned the same diagnostic with status `2`.
The report's reproduction is retained in Audita's
[upstream handoff](https://forge.maximumdirect.net/eric/audita/src/commit/a355f05a273d6ac9d577eab8d30caa60cb74eee8/docs/roadmap/implementation.md).
The review confirmed the behavior through Audita's existing regression tests and
a temporary public-API reproduction against the aligned CommandKit workspace.
The initial review confirmed the baseline behavior through Audita's existing
regression tests and a temporary public-API reproduction against the aligned
CommandKit workspace.
The latter covered catalog listing and all five configuration operations in both
the application and PromptKit scopes, including wrapped ConfigKit loading errors
and already-canceled contexts.
- [FromConfigKit](../../integrations/ckconfig/configkit_adapter.go) and
[the PromptKit adapters](../../integrations/ckprompt/adapters.go) preserve the
ConfigKit loading error and adapt its diagnostic evidence.
[the PromptKit adapters](../../integrations/ckprompt/adapters.go) preserved the
ConfigKit loading error and adapted its diagnostic evidence.
- [configFailure](../../integrations/ckconfig/operations.go) and
[definitionFailure](../../integrations/ckprompt/command.go) construct operational
[definitionFailure](../../integrations/ckprompt/command.go) constructed operational
outcomes for the affected failures. Configuration comparison and validation
also reach the former helper.
also reached the former helper.
- ConfigKit's public `LoadError` represents several kinds of loading failure,
including malformed YAML, acquisition errors, and schema or callback problems.
Its public diagnostic codes provide the classification evidence. Its error
@@ -54,10 +56,10 @@ and already-canceled contexts.
and `config validate` can report failed validation. Cancellation observed
before acquisition leaves stdout empty in the reviewed command paths.
The current [CLI contract](../cli.md#outcome-status) assigns loading failures
status `1`, with more specific statements in the configuration comparison,
requirements, validation, and smoke sections. This roadmap proposes a deliberate
change to that published status behavior.
At that baseline, the published CLI contract assigned loading failures status
`1`. The implemented change classifies identifiable invalid configuration as
usage status `2`, with operational fallback, as described in the
[current CLI contract](../cli.md#configuration-failure-classification).
## Targeted end state