diff --git a/docs/roadmap/commandkit-adoption.md b/docs/roadmap/commandkit-adoption.md index f486c1d..52ae382 100644 --- a/docs/roadmap/commandkit-adoption.md +++ b/docs/roadmap/commandkit-adoption.md @@ -241,7 +241,9 @@ invocation-error envelope is part of this migration. Adopt CommandKit's quiet and verbosity semantics, including rendering and presentation failures. Console results use the invocation reporter; diagnostics -use its diagnostic channel. An explicit `--report` write is an application +use its diagnostic channel. `--verbose` preserves the selected stdout result +and exposes emitted Info and Warning messages on stderr under native rules. +An explicit `--report` write is an application effect rendered through the writer API and still occurs in quiet mode. Quiet does not cancel generation; it suppresses the main result even when stdout is redirected, while failure explanations remain visible. Move any diff --git a/docs/roadmap/implementation.md b/docs/roadmap/implementation.md index 7ac0e60..a70f191 100644 --- a/docs/roadmap/implementation.md +++ b/docs/roadmap/implementation.md @@ -219,6 +219,9 @@ and CLI application-loading/source-selector helpers. through `promptkit.DirectoryInputs`, no implicit main, existing schema base and engine retry setting, and the default upstream bundle. Do not change collection traversal, peer composition, or whole-record replacement. + `DirectoryInputs` retains explicit directory-selector support; collection + discovery continues through the file source's ConfigKit import globs for + `collection.yml` and `collection.yaml`. 6. Use fresh application input per comparison side and invocation-owned state under the native factory lifecycle; comparison may share that state without sharing either side's selected values. Start without an engine/config cache: @@ -366,6 +369,9 @@ qualified IDs and independent namespaces, raw byte output, native structured serialization, completed invalid content/status 4, and resultless operational failure/status 1. Include a small typed-error mapping table rather than parsing error prose. Use native config classification for representative load failures. +Verify `--verbose` leaves artifact stdout unchanged and routes emitted Info and +Warning messages to stderr under native visibility rules, without fixing their +wording or requiring a particular generation summary. ## Stage 6: Add Separate Native Report Delivery