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

Record universal report formats and optional command defaults

Browse Source
This commit is contained in:
Eric Rakestraw
2026-11-06 19:49:36 +00:00
parent 756954f056
commit ffe568b6f0
2 changed files with 173 additions and 100 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
docs/roadmap/future.md
View File

@@ -70,7 +70,8 @@ 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.
Initial report formats and filter spellings are selected in the roadmap;
Initial report content, default preferences, and filter spellings are selected
in the roadmap; core owns universal format selection. The
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
@@ -161,12 +162,14 @@ steps. No delivery date or final API is selected here.
### Reporting extensions
The [shared core report output prerequisite](promptkit-v0.19.0.md#shared-core-report-output-prerequisite)
is now part of the working adoption roadmap. It records the agreed command
output declarations, format-independent reporting operation, and centralized
representation rules, initially targeting YAML. Human-oriented/native rendering
and format availability remain open discussions there. Additional renderers such
as JSON, XML, and Markdown remain future work; planning for them does not select
their mappings, command coverage, or delivery dates.
is now part of the working adoption roadmap. It records application-owned
content selection, core-owned rendering, a text fallback with optional templates,
universal format availability, and optional command defaults that otherwise
defer to core policy. Plain text, YAML, and JSON are the target formats;
representation, template, native-document, and delivery-staging details remain
there. XML is removed from current consideration. Markdown and other potential
formats are not selected for this adoption; new core formats will work with
existing commands without per-command adoption.
Error-conversion helpers such as `WarnError` remain deferred pending demonstrated
value; applications can already use `report.Warn(err.Error())`. Terminal redraw