Add workspace handoff shortcuts and file-backed inputs

Remove the remaining shell glue from the canonical CLI workspace flows so users can hand off IDs and host-authored text files directly.

Add --id-only on workspace create and shell open, plus --text-file and --patch-file for workspace file write and patch apply, while keeping the underlying SDK, MCP, and backend behavior unchanged.

Update the top walkthroughs, contract docs, roadmap status, and use-case smoke runner to use the new shortcuts, and verify the milestone with uv lock, make check, make dist-check, focused CLI tests, and a real guest-backed smoke for create, file write, patch apply, and shell open/read.

docs/roadmap/llm-chat-ergonomics.md

@@ -6,7 +6,7 @@ goal:
 make the core agent-workspace use cases feel trivial from a chat-driven LLM
 interface.
 
-Current baseline is `3.6.0`:
+Current baseline is `3.7.0`:
 
 - the stable workspace contract exists across CLI, SDK, and MCP
 - one-shot `pyro run` still exists as the narrow entrypoint
@@ -37,8 +37,8 @@ The remaining UX friction for a technically strong new user is now narrower:
 
 - the best chat-host profile is recommended in docs, but not yet obvious enough
   from the default live `mcp serve` path
-- canonical CLI walkthroughs still need small amounts of shell glue such as
-  `python -c` extraction of `workspace_id` and `$(cat fix.patch)` expansion
+- canonical CLI walkthroughs are cleaner now, but the recommended chat-host
+  entrypoint still needs to be more obvious from the default docs and help
 - human-mode file reads are functional, but still need final transcript polish
   for copy-paste and chat logs
 
@@ -61,7 +61,7 @@ The remaining UX friction for a technically strong new user is now narrower:
 3. [`3.4.0` Tool Profiles And Canonical Chat Flows](llm-chat-ergonomics/3.4.0-tool-profiles-and-canonical-chat-flows.md) - Done
 4. [`3.5.0` Chat-Friendly Shell Output](llm-chat-ergonomics/3.5.0-chat-friendly-shell-output.md) - Done
 5. [`3.6.0` Use-Case Recipes And Smoke Packs](llm-chat-ergonomics/3.6.0-use-case-recipes-and-smoke-packs.md) - Done
-6. [`3.7.0` Handoff Shortcuts And File Input Sources](llm-chat-ergonomics/3.7.0-handoff-shortcuts-and-file-input-sources.md) - Planned
+6. [`3.7.0` Handoff Shortcuts And File Input Sources](llm-chat-ergonomics/3.7.0-handoff-shortcuts-and-file-input-sources.md) - Done
 7. [`3.8.0` Chat-Host Onramp And Recommended Defaults](llm-chat-ergonomics/3.8.0-chat-host-onramp-and-recommended-defaults.md) - Planned
 8. [`3.9.0` Content-Only Reads And Human Output Polish](llm-chat-ergonomics/3.9.0-content-only-reads-and-human-output-polish.md) - Planned
 
@@ -80,11 +80,12 @@ Completed so far:
 - `3.6.0` added recipe docs and real guest-backed smoke packs for the five core workspace use
   cases so the stable product is now demonstrated as repeatable end-to-end stories instead of
   only isolated feature surfaces.
+- `3.7.0` removed the remaining shell glue from canonical CLI workspace flows with `--id-only`,
+  `--text-file`, and `--patch-file`, so the shortest handoff path no longer depends on `python -c`
+  extraction or `$(cat ...)` expansion.
 
 Planned next:
 
-- `3.7.0` removes the remaining shell glue from canonical CLI flows with shortcut flags for
-  identifier handoff and file-backed text inputs.
 - `3.8.0` makes the recommended chat-host entrypoint obvious from the top-level docs, help text,
   and shipped MCP examples without changing the `3.x` compatibility default.
 - `3.9.0` makes human-mode file reads cleaner in terminals and chat logs, with explicit

docs/roadmap/llm-chat-ergonomics/3.7.0-handoff-shortcuts-and-file-input-sources.md

@@ -1,6 +1,6 @@
 # `3.7.0` Handoff Shortcuts And File Input Sources
 
-Status: Planned
+Status: Done
 
 ## Goal