pyro-mcp/docs/roadmap/task-workspace-ga/3.0.0-stable-workspace-product.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

1.2 KiB

3.0.0 Stable Workspace Product

Status: Done

Goal

Freeze the workspace-first public contract and promote the product from a one-shot runner with extras to a stable agent workspace.

Public API Changes

No new capability is required in this milestone. The main change is stability:

  • workspace-first names are the only public contract
  • shell, sync, export, diff, services, snapshots, reset, secrets, and network policy are all part of the stable product surface

Implementation Boundaries

  • remove remaining beta/alpha language from workspace docs
  • rewrite landing docs so the workspace product is first-class and pyro run is the entry point rather than the center
  • lock the stable contract in docs/public-contract.md

Non-Goals

  • no new secondary tooling
  • no job-runner, queue, or CI abstractions

Acceptance Scenarios

  • all core vision workflows are documented and runnable from CLI, SDK, and MCP
  • the repo no longer presents the workspace model as provisional

Required Repo Updates

  • top-level README repositioning around the workspace product
  • stable public contract doc for 3.x
  • changelog entry that frames the workspace product as stable