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