Address twelfth review: type annotations, version examples, streaming docs, requires

- Fix workflow_search type annotations (str | None)
- PUBLISHING.md: speckit_version >=0.15.0 → >=0.6.1
- Document that exit_code is captured and referenceable by later steps
- Mark requires as declared-but-not-enforced (planned enhancement)
- Note full stdout/stderr capture as planned enhancement

Author: mnriem

src/specify_cli/__init__.py

@@ -4537,8 +4537,8 @@ def workflow_remove(
 
 @workflow_app.command("search")
 def workflow_search(
-    query: str = typer.Argument(None, help="Search query"),
-    tag: str = typer.Option(None, "--tag", help="Filter by tag"),
+    query: str | None = typer.Argument(None, help="Search query"),
+    tag: str | None = typer.Option(None, "--tag", help="Filter by tag"),
 ):
     """Search workflow catalogs."""
     from .workflows.catalog import WorkflowCatalog, WorkflowCatalogError

src/specify_cli/workflows/engine.py

@@ -45,7 +45,8 @@ def __init__(self, data: dict[str, Any], source_path: Path | None = None) -> Non
         self.default_model: str | None = workflow.get("model")
         self.default_options: dict[str, Any] = workflow.get("options", {})
 
-        # Requirements
+        # Requirements (declared but not yet enforced at runtime;
+        # enforcement is a planned enhancement)
         self.requires: dict[str, Any] = data.get("requires", {})
 
         # Inputs

src/specify_cli/workflows/steps/command/__init__.py

@@ -17,6 +17,13 @@ class CommandStep(StepBase):
     the integration's directory on disk.  This step tells the CLI to
     execute the command by name (e.g. ``/speckit.specify`` or
     ``/speckit-specify``) rather than reading the file contents.
+
+    .. note::
+
+        CLI output is streamed to the terminal for live progress.
+        ``output.exit_code`` is always captured and can be referenced
+        by later steps (e.g. ``{{ steps.specify.output.exit_code }}``).
+        Full ``stdout``/``stderr`` capture is a planned enhancement.
     """
 
     type_key = "command"

src/specify_cli/workflows/steps/prompt/__init__.py

@@ -19,6 +19,13 @@ class PromptStep(StepBase):
     directly to the CLI.  This is useful for ad-hoc instructions
     that don't map to a registered command.
 
+    .. note::
+
+        CLI output is streamed to the terminal for live progress.
+        ``output.exit_code`` is always captured and can be referenced
+        by later steps.  Full response text capture is a planned
+        enhancement.
+
     Example YAML::
 
         - id: review-security

workflows/PUBLISHING.md

@@ -57,7 +57,7 @@ workflow:
   model: "claude-sonnet-4-20250514"         # Default model (optional)
 
 requires:
-  speckit_version: ">=0.15.0"
+  speckit_version: ">=0.6.1"
   integrations:
     any: ["claude", "gemini"]      # At least one required