fix: stabilize cli help and skill examples

skills/wf-cli/SKILL.md

@@ -63,8 +63,8 @@ wf draft set-workflow-output <workspace_id> --revision <n> \
 wf draft branch <workspace_id> --revision <n> --step <step_id> --route ok=__end__ --route error=fail
 wf draft handle <workspace_id> --revision <n> --to fail --branch lookup:error --branch transform:error
 wf draft compile <workspace_id>
-wf draft bind <workspace_id> --revision <n> --step <step_id> --from local.report.markdown --to state.report.markdown
+wf draft bind <workspace_id> --revision <n> --step <step_id> --from local.document.markdown --to state.document.markdown
-wf draft bind <workspace_id> --revision <n> --step <step_id> --from input.title --to local.report.title
+wf draft bind <workspace_id> --revision <n> --step <step_id> --from input.title --to local.document.title
 wf draft add capability <workspace_id> --revision <n> --step <step_id> --capability <qualified_name> --from-step <prev> --from-outcome ok --route ok=__end__ --route error=fail --input input.title=report.title --bind-output result=state.result
 wf draft add interrupt <workspace_id> --revision <n> --step review --kind issue_review \
   --request-schema-file request.schema.json --resume-schema-file resume.schema.json \
@@ -95,7 +95,7 @@ compatibility map-only edit when the workflow schema is already declared.
 `wf draft bind` names both endpoints explicitly, so local paths keep the
 `local.` root. `set-input` and `draft add capability --input` already imply the
 local side, so their targets are rootless paths: write
-`input.title=report.title`, not `input.title=local.report.title`.
+`input.title=document.title`, not `input.title=local.document.title`.
 
 `wf draft set-workflow-output` replaces the complete ordered public output
 projection. Nested `input.*` and `state.*` sources can project missing nested

skills/wf-workflow/references/draft-workspaces.md

@@ -121,8 +121,8 @@ wf draft set-workflow-output <workspace_id> --revision <n> \
 wf draft branch <workspace_id> --revision <n> --step <step_id> --route ok=__end__ --route error=fail
 wf draft handle <workspace_id> --revision <n> --to fail --branch lookup:error --branch transform:error
 wf draft compile <workspace_id>
-wf draft bind <workspace_id> --revision <n> --step <step_id> --from local.report.markdown --to state.report.markdown
+wf draft bind <workspace_id> --revision <n> --step <step_id> --from local.document.markdown --to state.document.markdown
-wf draft bind <workspace_id> --revision <n> --step <step_id> --from input.title --to local.report.title
+wf draft bind <workspace_id> --revision <n> --step <step_id> --from input.title --to local.document.title
 wf draft add capability <workspace_id> --revision <n> --step <step_id> --capability <qualified_name> --from-step <prev> --from-outcome ok --route ok=__end__ --route error=fail --input input.title=report.title --bind-output result=state.result
 wf draft add interrupt <workspace_id> --revision <n> --step review --kind issue_review --request-schema-file request.schema.json --resume-schema-file resume.schema.json --outcome submitted --outcome cancelled --route submitted=next --route cancelled=revise
 wf draft add when <workspace_id> --revision <n> --step decide --condition-file condition.json --then next --otherwise revise
@@ -136,8 +136,8 @@ project missing output-schema fields from their declared source schemas.
 Literal values and `context.*` paths require declared output targets, and
 literal values are validated against those targets rather than inferred.
 
-`set-input` direction: `input.title=report.title` means graph source
+`set-input` direction: `input.title=document.title` means graph source
-`input.title` maps to node-local target `local.report.title`. Targets are
+`input.title` maps to node-local target `local.document.title`. Targets are
 rootless node-local paths; never prefix the target with `local.`. Existing
 single-field targets such as `input.text=text` remain valid. Repeated graph
 sources are allowed and preserve fan-out to distinct local targets.
@@ -192,10 +192,10 @@ fallback. `--merge --map` is compatibility-only and may collapse existing
 fan-out; it cannot preserve literals or canonical ordering. Use it only when a
 lossy map edit is acceptable.
 
-`bind input.title -> local.report.title` is schema-aware and idempotent when
+`bind input.title -> local.document.title` is schema-aware and idempotent when
 `input.title` is already declared. Bind names both rooted endpoints explicitly.
 Use it for repair hints or schema projection. Use
-`set-input --merge --map input.title=report.title` when you only need to update
+`set-input --merge --map input.title=document.title` when you only need to update
 a compatibility step input map; that command already implies the local side.
 
 - `bind_draft`
@@ -212,9 +212,9 @@ a compatibility step input map; that command already implies the local side.
   workflow boundary.
 
 ```bash
-wf draft bind <workspace_id> --revision <n> --step <step_id> --from local.report.markdown --to state.report.markdown
+wf draft bind <workspace_id> --revision <n> --step <step_id> --from local.document.markdown --to state.document.markdown
-wf draft bind <workspace_id> --revision <n> --step <step_id> --from input.title --to local.report.title
+wf draft bind <workspace_id> --revision <n> --step <step_id> --from input.title --to local.document.title
-wf draft bind <workspace_id> --revision <n> --step <step_id> --from local.report.markdown --to output.report.markdown
+wf draft bind <workspace_id> --revision <n> --step <step_id> --from local.document.markdown --to output.document.markdown
 wf draft validate <workspace_id>
 ```
 

src/wf_cli/commands/source_registry.py

@@ -59,7 +59,13 @@ def list_registry_entries(
 @app.command("inspect")
 def inspect_registry_entry(
     ctx: typer.Context,
-    source_id: Annotated[str, typer.Argument(help="Source registry entry id.")],
+    source_id: Annotated[
+        str,
+        typer.Argument(
+            help="Source registry entry id.",
+            metavar="SOURCE_ID",
+        ),
+    ],
 ) -> None:
     """Inspect one desired persisted source registry entry."""
     context = load_cli_context_from_typer(ctx)
@@ -93,7 +99,10 @@ def add_registry_entry(
 @app.command("update")
 def update_registry_entry(
     ctx: typer.Context,
-    source_id: Annotated[str, typer.Argument(help="Source ID to update.")],
+    source_id: Annotated[
+        str,
+        typer.Argument(help="Source ID to update.", metavar="SOURCE_ID"),
+    ],
     patch_json: Annotated[
         str | None, typer.Option("--patch", help="JSON patch to apply.")
     ] = None,
@@ -115,7 +124,10 @@ def update_registry_entry(
 @app.command("enable")
 def enable_registry_entry(
     ctx: typer.Context,
-    source_id: Annotated[str, typer.Argument(help="Source ID to enable.")],
+    source_id: Annotated[
+        str,
+        typer.Argument(help="Source ID to enable.", metavar="SOURCE_ID"),
+    ],
 ) -> None:
     """Enable a desired source registry entry."""
     context = load_cli_context_from_typer(ctx)
@@ -130,7 +142,10 @@ def enable_registry_entry(
 @app.command("disable")
 def disable_registry_entry(
     ctx: typer.Context,
-    source_id: Annotated[str, typer.Argument(help="Source ID to disable.")],
+    source_id: Annotated[
+        str,
+        typer.Argument(help="Source ID to disable.", metavar="SOURCE_ID"),
+    ],
 ) -> None:
     """Disable a desired source registry entry."""
     context = load_cli_context_from_typer(ctx)
@@ -145,7 +160,10 @@ def disable_registry_entry(
 @app.command("remove")
 def remove_registry_entry(
     ctx: typer.Context,
-    source_id: Annotated[str, typer.Argument(help="Source ID to remove.")],
+    source_id: Annotated[
+        str,
+        typer.Argument(help="Source ID to remove.", metavar="SOURCE_ID"),
+    ],
     confirm: Annotated[
         bool, typer.Option("--confirm", help="Confirm removal.")
     ] = False,