docs: record draft CLI diagnostic guidance
This commit is contained in:
@@ -297,16 +297,15 @@ stable.
|
||||
only; optional inputs are surfaced in wrapper-hint notes for explicit binding.
|
||||
Implementation plan:
|
||||
[`required-only wrapper inputs`](historical/superpowers/plans/2026-06-29-required-only-wrapper-inputs.md).
|
||||
- Completed: `wf draft set-input` rejects `local.x` targets before RPC and
|
||||
shows the equivalent bare-target mapping.
|
||||
- Completed: `wf draft add-step --route` errors include declared outcomes and
|
||||
direct add/remove repair guidance.
|
||||
- Completed: repeated idempotent `wf draft bind input/state -> local` behavior
|
||||
is covered by regression tests.
|
||||
|
||||
Planned challenge-driven UX follow-ups:
|
||||
|
||||
- Improve `wf draft set-input` diagnostics when agents write local targets as
|
||||
`local.x`; the command expects bare local field names such as `x`.
|
||||
- Improve `wf draft add-step --route` diagnostics when agents route undeclared
|
||||
outcomes, for example `error=fail` on a single-`ok` capability. The error
|
||||
should include declared outcomes and a compact repair hint.
|
||||
- Add an explicit re-invocation regression for idempotent
|
||||
`wf draft bind input.x -> local.x` / `state.x -> local.x` repairs.
|
||||
- Design a separate composite-binding/data-shaping slice for cases such as
|
||||
mapping state fields into a structured `report` object. Do not hide this
|
||||
behind the existing path binding syntax without a deliberate model.
|
||||
|
||||
Reference in New Issue
Block a user