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

Set initial report designs and lightweight YAML implementation guidance

Browse Source
This commit is contained in:
Eric Rakestraw
2026-11-06 19:00:02 +00:00
parent d15926a878
commit b6a8f1f2cc
2 changed files with 142 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
docs/roadmap/future.md
View File

@@ -55,7 +55,8 @@ These accepted plans do not change the currently implemented behavior.
[Roadmap OD-5](promptkit-v0.19.0.md#od-5-detailed-comparison-selection-and-shape)
selects an optional detailed report while retaining the concise default for
human operators. Both presentations reuse the existing native comparison data;
the detailed layout remains to be designed.
the accepted initial layout is recorded there for implementation and later beta
feedback.
### Configuration inspection extensions
@@ -67,14 +68,18 @@ structured diagnostics belong to `config validate`; the suite retains six
subcommands. The roadmap records the agreed explanation modes and help behavior;
[OD-6](promptkit-v0.19.0.md#od-6-failure-evidence-and-structured-diagnostic-delivery)
selects optional validation details, a concise default, and available evidence
on failure. OD-8 selects focused display, source selection, and report filters;
report shapes and exact filter grammar remain open.
on failure. OD-8 selects focused display, source selection, and report filters.
Initial report formats and filter spellings are selected in the roadmap;
remaining layout details will be evaluated through implementation and beta use.
It also includes focused effective display,
source-ID selection, metadata/diagnostic filters, independent comparison
selectors, and assertion mode. The original four shared proposals had ConfigKit
adoption identifiers OD-3 through OD-6; the new roadmap has its own decision numbering. Implementation
belongs in `ckconfig`, with PromptKit exposing native evidence through its
configuration scope. CLI syntax and report contracts remain subject to review.
configuration scope. The
[initial report implementation approach](promptkit-v0.19.0.md#initial-report-implementation-approach)
favors direct Go-to-YAML serialization, thin projections, and shared output
helpers. Further presentation refinements should follow practical feedback.
Transient acquisition overrides are included as an opt-in loader capability in
[roadmap OD-11](promptkit-v0.19.0.md#od-11-transient-configuration-overrides).