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

Add focused configuration reports

Browse Source
This commit is contained in:
Eric Rakestraw
2026-11-07 04:47:23 +00:00
parent b38130548e
commit 65b454b2ab
7 changed files with 221 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/cli.md
View File

@@ -358,6 +358,7 @@ YAML for structured values; `--format` selects text, YAML, or JSON.
example config show
example config show --scope promptkit
example config show --scope all
example config show --path /server/addr --format json
```
`--scope all` acquires every selected scope before producing one mapping keyed
@@ -365,12 +366,21 @@ by scope name, including when only one scope is registered. A single selected
scope is unwrapped. A provider failure prevents report output. Conversion or
output failures are recorded in `Outcome.Presentation.Output`.
For a scope that supports path-selected show, `--path POINTER` displays only
that safe effective value. An explicitly empty pointer selects the root, and a
present null remains a value. Missing and historical-only paths fail; path
selection cannot be combined with `--scope all`.
### List configuration sources
`config sources` reports the source inventory captured during the selected
scope's acquisition. It reads the source facet once and does not reload
configuration. The default scope is `app`; `--scope all` is unsupported. Text is
the automatic format, and `--format yaml` or `--format json` returns a structured report:
the automatic format, and `--format yaml` or `--format json` returns a structured report.
`--source-id ID` selects one entry by the ID from that acquisition; an unknown
ID fails. If acquisition fails but returns a captured source inventory, the
command reports that evidence and preserves the acquisition error. Unavailable
inventory is reported as such.
```yaml
scope: app

7
docs/roadmap/implementation.md
View File

@@ -1,6 +1,6 @@
# Shared reporting and PromptKit v0.20.0 implementation plan
Status: implementation in progress; Stages 1–17 complete.
Status: implementation in progress; Stages 1–18 complete.
## Scope, authority, and execution
@@ -648,6 +648,11 @@ capabilities, historical-only evidence, and result delivery.
## Stage 18: Focused effective values and source evidence
**Complete.** Focused show and source selection use native safe evidence,
including source inventories returned with acquisition failures. Root,
ckconfig, and ckprompt workspace suites passed with Go 1.27.0, including null,
historical-only paths, missing evidence, and delivery failures.
Add `config show --path POINTER` for one scope with PathShow support. Parse the
pointer before loading, call the acquired native `Explain`, and select its safe
effective snapshot. An absent effective path is operational failure; explicitly