docs: clarify draft bind input behavior

2026-06-29 19:36:04 +07:00
parent ca299e6fa0
commit af7452a794
6 changed files with 26 additions and 9 deletions
@@ -129,6 +129,11 @@ the whole map for that step or output scope. Use repeated `--map` flags in one
 command for a complete replacement. Use `--merge` only when adding/updating
 entries over multiple revisions.

+`bind input.x -> local.x` is schema-aware and idempotent when `input.x` is
+already declared. Use it for repair hints or schema projection. Use
+`set-input --merge --map input.x=x` when you only need to update a step input
+map.
+
 - `bind_draft`

  Declares a workflow input/state/output schema field from a capability local