fix: address workflow authoring review findings

This commit is contained in:
lda
2026-06-29 11:04:22 +07:00 Verified
parent 628fbbae7b
commit 746e4f7a2a
20 changed files with 349 additions and 75 deletions
+5 -4
View File
@@ -59,10 +59,11 @@ reported in wrapper-hint notes; bind them explicitly with `wf draft bind` or
`wf draft set-input --merge` only when the workflow should expose them.
When `wf draft validate` returns a `repair_hint`, run that exact focused command
before writing JSON Patch manually. Use `wf draft bind local.x -> output.y` when
one capability output should become public workflow output; it creates the
required state intermediary and projects the field schema into both state and
output schemas atomically. Re-run `wf draft validate` after the repair.
before writing JSON Patch manually. To make one capability output public, use
`wf draft bind <workspace_id> --revision <n> --step <step_id> --from local.x
--to output.y`; it creates the required state intermediary and projects the
field schema into both state and output schemas atomically. Re-run
`wf draft validate` after the repair.
wf artifact create-from-plan workflow.plan.json --artifact <artifact_id> --version <n> --title <title>
wf deploy save <deployment_id> --artifact <artifact_id> --version <n> --binding <logical>=<concrete>
+2 -1
View File
@@ -18,7 +18,8 @@ low-level escape hatch or you already have a complete compiler/generated plan.
2. Inspect one candidate with `wf cap inspect`.
3. Call one candidate with `wf cap call` when payload shape or upstream source
reachability is uncertain.
4. Create a patchable draft workspace with `wf draft create --capability`.
4. Create a patchable draft workspace with
`wf draft create <workspace_id> --capability <qualified_name>`.
5. Patch targeted fields with focused draft commands or JSON Patch.
6. Validate with `wf draft validate`.
7. Save an artifact with `wf draft save`, or import a complete raw plan with