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.
1.2 KiB
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 runis 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