Thales Maciel
d0cf6d8f21
Introduce explicit repro-fix, inspect, cold-start, and review-eval modes across the MCP server, CLI, and host helpers, with canonical mode-to-tool mappings, narrowed schemas, and mode-specific tool descriptions on top of the existing workspace runtime. Reposition the docs, host onramps, and use-case recipes so named modes are the primary user-facing startup story while the generic no-mode workspace-core path remains the escape hatch, and update the shared smoke runner to validate repro-fix and cold-start through mode-backed servers. Validation: UV_OFFLINE=1 UV_CACHE_DIR=.uv-cache uv run pytest --no-cov tests/test_api.py tests/test_server.py tests/test_host_helpers.py tests/test_public_contract.py tests/test_cli.py tests/test_workspace_use_case_smokes.py; UV_OFFLINE=1 UV_CACHE_DIR=.uv-cache make check; UV_OFFLINE=1 UV_CACHE_DIR=.uv-cache make dist-check; real guest-backed make smoke-repro-fix-loop smoke-cold-start-validation outside the sandbox.
38 lines
1.7 KiB
Markdown
38 lines
1.7 KiB
Markdown
# Workspace Use-Case Recipes
|
|
|
|
These recipes turn the chat-host workspace path into five concrete agent flows.
|
|
They are the canonical next step after the quickstart in [install.md](../install.md)
|
|
or [first-run.md](../first-run.md).
|
|
|
|
Run all real guest-backed scenarios locally with:
|
|
|
|
```bash
|
|
make smoke-use-cases
|
|
```
|
|
|
|
Recipe matrix:
|
|
|
|
| Use case | Recommended mode | Smoke target | Recipe |
|
|
| --- | --- | --- | --- |
|
|
| Cold-start repo validation | `cold-start` | `make smoke-cold-start-validation` | [cold-start-repo-validation.md](cold-start-repo-validation.md) |
|
|
| Repro plus fix loop | `repro-fix` | `make smoke-repro-fix-loop` | [repro-fix-loop.md](repro-fix-loop.md) |
|
|
| Parallel isolated workspaces | `repro-fix` | `make smoke-parallel-workspaces` | [parallel-workspaces.md](parallel-workspaces.md) |
|
|
| Unsafe or untrusted code inspection | `inspect` | `make smoke-untrusted-inspection` | [untrusted-inspection.md](untrusted-inspection.md) |
|
|
| Review and evaluation workflows | `review-eval` | `make smoke-review-eval` | [review-eval-workflows.md](review-eval-workflows.md) |
|
|
|
|
All five recipes use the same real Firecracker-backed smoke runner:
|
|
|
|
```bash
|
|
uv run python scripts/workspace_use_case_smoke.py --scenario all --environment debian:12
|
|
```
|
|
|
|
That runner generates its own host fixtures, creates real guest-backed workspaces,
|
|
verifies the intended flow, exports one concrete result when relevant, and cleans
|
|
up on both success and failure. Treat `make smoke-use-cases` as the trustworthy
|
|
guest-backed verification path for the advertised workspace workflows.
|
|
|
|
For a concise review before exporting, resetting, or handing work off, use:
|
|
|
|
```bash
|
|
pyro workspace summary WORKSPACE_ID
|
|
```
|