Record completed configuration outcome remediation
This commit is contained in:
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user