pyro-mcp/docs/roadmap/task-workspace-ga.md
Thales Maciel dbb71a3174
Add chat-first workspace roadmap
Document the post-3.1 milestones needed to make the stable workspace product feel natural in chat-driven LLM interfaces.

Add a follow-on roadmap for model-native file ops, workspace naming and discovery, tool profiles, shell output cleanup, and use-case recipes with smoke coverage. Link it from the README, vision doc, and completed workspace GA roadmap so the next phase is explicit.

Keep the sequence anchored to the workspace-first vision and continue to treat disk tools as secondary rather than the main chat-facing surface.
2026-03-12 21:06:14 -03:00

2.5 KiB

Task Workspace GA Roadmap

This roadmap turns the agent-workspace vision into release-sized milestones.

Current baseline is 3.1.0:

  • workspace persistence exists and the public surface is now workspace-first
  • host crossing currently covers create-time seeding, later sync push, and explicit export
  • persistent PTY shell sessions exist alongside one-shot workspace exec
  • immutable create-time baselines now power whole-workspace diff
  • multi-service lifecycle exists with typed readiness and aggregate workspace status counts
  • named snapshots and full workspace reset now exist
  • explicit secrets now exist for guest-backed workspaces
  • explicit workspace network policy and localhost published service ports now exist

Locked roadmap decisions:

  • no backward compatibility goal for the current task_* naming
  • workspace-first naming lands first, before later features
  • snapshots are real named snapshots, not only reset-to-baseline

Every milestone below must update CLI, SDK, and MCP together. Each milestone is also expected to update:

  • README.md
  • install/first-run docs
  • docs/public-contract.md
  • help text and runnable examples
  • at least one real Firecracker smoke scenario

Milestones

  1. 2.4.0 Workspace Contract Pivot - Done
  2. 2.5.0 PTY Shell Sessions - Done
  3. 2.6.0 Structured Export And Baseline Diff - Done
  4. 2.7.0 Service Lifecycle And Typed Readiness - Done
  5. 2.8.0 Named Snapshots And Reset - Done
  6. 2.9.0 Secrets - Done
  7. 2.10.0 Network Policy And Host Port Publication - Done
  8. 3.0.0 Stable Workspace Product - Done
  9. 3.1.0 Secondary Disk Tools - Done

Roadmap Status

The planned workspace roadmap is complete.

  • 3.1.0 added secondary stopped-workspace disk export and offline inspection helpers without changing the stable workspace-first core contract.
  • The next follow-on milestones now live in llm-chat-ergonomics.md and focus on making the stable workspace product feel trivial from chat-driven LLM interfaces.