thaloco/pyro-mcp
1
Fork 0
Code Pull requests Releases Packages Activity Actions
pyro-mcp/docs/roadmap/task-workspace-ga.md
Thales Maciel f2d20ef30a Promote stable workspace product for 3.0.0 
Freeze the current workspace-first surface as the stable 3.0 contract and reposition the
landing docs, CLI help, and public contract around the stable workspace path after the
one-shot proof.

Bump the package and catalog compatibility to 3.0.0, add a dedicated workspace walkthrough
tape/GIF, and mark the 3.0.0 roadmap milestone done while keeping runtime capability
unchanged in this release.

Validation: uv lock; UV_CACHE_DIR=.uv-cache make check; UV_CACHE_DIR=.uv-cache make dist-check;
UV_CACHE_DIR=.uv-cache uv build; UV_CACHE_DIR=.uv-cache uvx --from twine twine check dist/*;
built-wheel CLI smoke for pyro --help and pyro workspace --help; vhs validate plus rendered
workspace-first-run.gif outside the sandbox because vhs crashes when sandboxed.
2026-03-12 18:59:09 -03:00

2.4 KiB
Raw Blame History

Task Workspace GA Roadmap

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

Current baseline is 3.0.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

Remaining Follow-Up

The core workspace product is now stable. The remaining planned follow-up is intentionally secondary:

  • 3.1.0 secondary disk tools for offline inspection and disk-level workflows
  • no further roadmap milestone changes the stable workspace-first core contract