Add configuration source reports

This commit is contained in:
2026-10-07 14:05:26 +00:00
parent bbd862311e
commit 25b412ea93
8 changed files with 330 additions and 9 deletions

View File

@@ -1,6 +1,6 @@
# Initial CommandKit implementation plan
Status: implementation underway; Stages 1-9 complete and Stages 10-14 pending.
Status: implementation underway; Stages 1-10 complete and Stages 11-14 pending.
Date: 2026-10-07.
@@ -645,7 +645,7 @@ passes; README, development orientation, and CLI reference describe the feature.
## Stage 10: implement source inventory reports
**Status:** pending. **Prerequisite:** Stage 9.
**Status:** complete. **Prerequisite:** Stage 9.
1. Implement single-scope `config sources`, default text with yaml alternative.
Read the captured SourceReader once. Never reload sources for this report.
@@ -664,6 +664,16 @@ one captured acquisition, YAML field types and import correlation, empty invento
unsupported all usage preflight, writer failure. Update the source-report CLI
reference with the implemented shape.
**Completion evidence:** installed `config sources` for scopes declaring the
capability. The command reads the acquired source facet once and renders explicit
snake-case YAML DTOs or a quoted text inventory, preserving source order, empty
and zero values, synthetic paths, and import locations. Checks use a real
ConfigKit filesystem root, import, overlay, and mapping underlay; they verify the
YAML field types and import correlation, captured acquisition, empty inventory,
text quoting, unsupported aggregate preflight, and partial writer failure.
`go test ./...` passes; README, development orientation, and CLI reference
describe the report.
## Stage 11: implement path explanation reports
**Status:** pending. **Prerequisite:** Stage 10.