thaloco/pyro-mcp
1
Fork 0
Code Pull requests Releases Packages Activity Actions
pyro-mcp/docs/roadmap/llm-chat-ergonomics/3.7.0-handoff-shortcuts-and-file-input-sources.md
Thales Maciel 788fc4fad4
Add second-pass chat UX milestones 
Extend the chat-ergonomics roadmap with the remaining UX work highlighted by the readiness review.

Document a second pass focused on removing shell glue from canonical CLI handoff flows, making the recommended chat-host profile more obvious without changing 3.x compatibility defaults, and polishing human-mode content reads for cleaner transcripts and copy-paste behavior.

Keep these milestones explicitly workspace-first and scoped to product UX, with CLI-only shortcuts allowed where the SDK and MCP surfaces already provide the structured behavior natively.
2026-03-13 10:44:44 -03:00

1.6 KiB
Raw Blame History

3.7.0 Handoff Shortcuts And File Input Sources

Status: Planned

Goal

Remove the last bits of shell plumbing from the canonical CLI workspace flows so they feel productized instead of hand-assembled.

Public API Changes

Planned additions:

  • pyro workspace create ... --id-only
  • pyro workspace shell open ... --id-only
  • pyro workspace file write WORKSPACE_ID PATH --text-file PATH
  • pyro workspace patch apply WORKSPACE_ID --patch-file PATH

Implementation Boundaries

  • keep existing --json, --text, and --patch stable
  • treat these additions as CLI-only shortcuts over already-structured behavior
  • make --text and --text-file mutually exclusive
  • make --patch and --patch-file mutually exclusive
  • read file-backed text and patch inputs as UTF-8 text
  • keep /workspace scoping and current patch semantics unchanged

Non-Goals

  • no new binary file-write story
  • no new SDK or MCP surface just to mirror CLI shorthand flags
  • no hidden patch normalization beyond the current patch-apply rules
  • no change to the stable workspace_id contract

Acceptance Scenarios

  • README, install docs, and first-run docs can create one workspace ID without python -c output parsing
  • a user can apply a patch from fix.patch without $(cat fix.patch) shell expansion
  • a user can write one text file from a host file directly, without shell-escaped inline text

Required Repo Updates

  • top-level workspace walkthroughs rewritten around the new shortcut flags
  • CLI help text updated so the shortest happy path is copy-paste friendly
  • at least one smoke scenario updated to use a file-backed patch input