Roadmap

// ROADMAP

What's working now, and what's next.

A coarse map of what Vivarium currently provides toward the goal of reproducing bugs in a browser. The forward-looking direction is being written up separately and will land here later.

15
Recipes shipped
3
Execution layers
12
MCP tools
2
Locales (EN / JA)

// 01 · NOW

What's working today.

Roughly in the order features were added. Each works independently — the fastest way to try something is to open the Reproductions, Guide, or Spec pages.

Three execution layers

  • Layer 1 — in-browser WebAssembly. Python (Pyodide) / Ruby.wasm / php-wasm / Rust (wasm32-wasip1). No account, no install — open the page and it runs.
  • Layer 2 — Docker catalogue. Pinned Dockerfile + GHCR-published image. Visitor reproduces locally with one docker run.
  • Layer 3 — record-replay. Self-contained GHCR images with the rr trace baked in. rr replay rewinds deterministically.

Reproduction catalogue

  • 15 recipes shipped across the three layers, from browser-native WASM pages to Docker and record-replay snapshots.
  • Faceted gallery, paste-an-error candidate matcher, project-level landing pages.

Public spec + CI integration

  • Contract v1 — the verdict.json wire shape published as JSON Schema.
  • Manifest v1 — TOML manifest letting an external repo declare a Vivarium-runnable reproduction with one .vivarium/manifest.toml file.
  • Reusable verdict-capture GitHub Actions workflow, weekly cron drift detection, interactive manifest scaffolder.

AI agent integration

  • Vivarium MCP server12 tools covering recipe discovery, verdict lookup, error-to-recipe matching, branch-fix verification, and authoring scaffolders (see the package README for the full surface).
  • AI-slop verification flow — match the error → open a recipe → paste a candidate fix → re-run → compare verdicts side-by-side, end-to-end.

User interface

  • Full EN ⇄ JA i18n with a symmetric URL tree and locale switcher.
  • Persona-route guide (5 minutes / repo integration / AI agent / write a reproduction / verify a branch fix / run on a fork / glossary).
  • Branch-fix verdict capture pipeline + side-by-side comparison page.

// 02 · NEXT

What's next.

The forward-looking direction is being written up by the maintainer; details will land here at a separate moment.

For now this page captures "what's been built so far." If you have a use case or a "this is how I'd want to use it" request, drop it on GitHub Issues — those become the inputs when the forward map gets drawn up.

// NEXT

Try it yourself

Opening one recipe in a browser tab and reading the verdict is the fastest way to see how Vivarium feels.

VIVARIUM is part of ALETHEIA-WORKS · See the source on GitHub →