Add next chat UX roadmap milestones
Capture the next UX pass after the workspace-core readiness review so the roadmap reflects the remaining friction a new chat-host user still feels. Add milestones for trustworthy use-case smoke coverage, host-specific Claude/Codex/OpenCode MCP onramps, and the planned 4.0 default flip to workspace-core so the bare server entrypoint finally matches the recommended path. This is a docs-only roadmap update based on the live use-case review and integration validation, with the full advanced surface kept as an explicit opt-in rather than the default.
This commit is contained in:
parent
22d284b1f5
commit
d05fba6c15
4 changed files with 192 additions and 0 deletions
|
|
@ -0,0 +1,55 @@
|
|||
# `4.0.0` Workspace-Core Default Profile
|
||||
|
||||
Status: Planned
|
||||
|
||||
## Goal
|
||||
|
||||
Make the default MCP entrypoint match the product's recommended chat-first path
|
||||
instead of preserving a wider compatibility surface by default.
|
||||
|
||||
## Public API Changes
|
||||
|
||||
This is an intentional breaking default change for the next major release:
|
||||
|
||||
- `pyro mcp serve` should default to `workspace-core`
|
||||
- `create_server()` should default to `profile="workspace-core"`
|
||||
- `Pyro.create_server()` should default to `profile="workspace-core"`
|
||||
|
||||
The full advanced surface remains available through explicit opt-in:
|
||||
|
||||
- `pyro mcp serve --profile workspace-full`
|
||||
- `create_server(profile="workspace-full")`
|
||||
- `Pyro.create_server(profile="workspace-full")`
|
||||
|
||||
## Implementation Boundaries
|
||||
|
||||
- keep all three profile names unchanged
|
||||
- do not remove `workspace-full`
|
||||
- make the default flip explicit in docs, changelog, help text, and migration
|
||||
notes
|
||||
- keep bare `vm-run` available as the smallest one-shot profile
|
||||
|
||||
## Non-Goals
|
||||
|
||||
- no silent removal of advanced workspace capabilities
|
||||
- no attempt to infer a profile from the client name
|
||||
- no `3.x` backport that changes the current default behavior
|
||||
|
||||
## Acceptance Scenarios
|
||||
|
||||
- a bare `pyro mcp serve` command now exposes the recommended narrow profile
|
||||
- a bare `create_server()` or `Pyro.create_server()` call matches that same
|
||||
default
|
||||
- advanced hosts can still opt into `workspace-full` explicitly with no loss of
|
||||
functionality
|
||||
- docs no longer need to explain that the recommended path and the default path
|
||||
are different
|
||||
|
||||
## Required Repo Updates
|
||||
|
||||
- help text, public contract, README, install docs, and integrations docs
|
||||
revised to reflect the new default
|
||||
- migration note explaining the default change and the explicit
|
||||
`workspace-full` opt-in path
|
||||
- examples audited so they only mention `--profile workspace-core` when the
|
||||
explicitness is useful rather than compensating for the old default
|
||||
Loading…
Add table
Add a link
Reference in a new issue