Defer appended-message flags and preserve operator use cases

This commit is contained in:
2026-11-06 16:39:51 +00:00
parent 111f963c67
commit f63af12097
2 changed files with 35 additions and 17 deletions

View File

@@ -88,10 +88,9 @@ commands, composed through existing core bindings.
[Roadmap OD-2](promptkit-v0.19.0.md#od-2-request-controls-and-provider-parameter-grammar)
records the agreed canonical naming, scoped convenience aliases, integration
installation collection, and selected text/file input forms; no core extension
is required. Appended-message flags remain open for individual review. These
are CLI features;
general-purpose helpers for application-internal PromptKit use are outside
CommandKit's ownership boundary.
is required. Output-contract overrides and appended-message flags are deferred
below. These are CLI features; general-purpose helpers for application-internal
PromptKit use are outside CommandKit's ownership boundary.
- **Focused backend inspection.** Defer a standard backend detail command
until a released PromptKit version provides a suitable public backend
@@ -112,11 +111,22 @@ CommandKit's ownership boundary.
application builders remain available. Revisit when the standard `promptkit`
commands have a demonstrated need for this workflow.
Appended-message flags remain a scope choice under
[roadmap OD-2](promptkit-v0.19.0.md#od-2-request-controls-and-provider-parameter-grammar).
Inline text and explicit file input are now selected there for single-prompt
validation and preview. Native API availability alone does not select further
CLI syntax or require a convenience API for application execution.
- **Appended-message flags.** Deferred from the current adoption. The potential
operator task is reproducing a single request with application-added messages
through `promptkit show prepared` or `promptkit requirements validate`, to
inspect roles, ordering, and content or check preparation. These commands do
not test model responses or application workflows. Appended messages follow
definition messages in supplied order; they are already rendered and do not
satisfy missing named prompt inputs. Revisit when request reproduction is a
demonstrated operator requirement. An ordered message-list file is a candidate,
but no flag syntax, file format, or supported-role selection is decided.
Deferring flags does not remove native appended messages from preview reports
when an application builder supplies them.
[Roadmap OD-2](promptkit-v0.19.0.md#od-2-request-controls-and-provider-parameter-grammar)
selects inline text and explicit file input for single-prompt validation and
preview. Native API availability alone does not select further CLI syntax or
require a convenience API for application execution.
### Alias completion and discovery