# Roadmap: vmcluster-mcp

## Milestones

- ✅ **v1.0 MVP** — Phases 1–10 (shipped 2026-03-24) → [archive](.planning/milestones/v1.0-ROADMAP.md)
- 🚧 **v1.1 Installation Ease-of-Use** — Phases 11–12 (in progress)

## Phases

<details>
<summary>✅ v1.0 MVP (Phases 1–10) — SHIPPED 2026-03-24</summary>

- [x] Phase 1: Foundation (3/3 plans) — completed 2026-03-22
- [x] Phase 2: Core VM Lifecycle (4/4 plans) — completed 2026-03-22
- [x] Phase 3: SSH Execution (3/3 plans) — completed 2026-03-23
- [x] Phase 4: Snapshot Management (2/2 plans) — completed 2026-03-23
- [x] Phase 5: Artifact Pipeline (3/3 plans) — completed 2026-03-23
- [x] Phase 6: Kernel Observability (2/2 plans) — completed 2026-03-23
- [x] Phase 7: Network & Node Fault Injection (5/5 plans) — completed 2026-03-24
- [x] Phase 8: Retroactive Phase Verification (2/2 plans) — completed 2026-03-24
- [x] Phase 9: Requirements & Roadmap Metadata Closure (3/3 plans) — completed 2026-03-24
- [x] Phase 10: Nyquist Validation Coverage (3/3 plans) — completed 2026-03-24

Full phase details: [.planning/milestones/v1.0-ROADMAP.md](.planning/milestones/v1.0-ROADMAP.md)

</details>

---

### 🚧 v1.1 Installation Ease-of-Use (In Progress)

**Milestone Goal:** Users can go from zero to a fully operational vmcluster-mcp setup with a single command.

- [ ] **Phase 11: PyPI Packaging** — Make vmcluster-mcp publishable and installable from PyPI
- [ ] **Phase 12: Setup Wizard** — `vmcluster-mcp setup` command: dep checks, config generation, image download, MCP client config

## Phase Details

### Phase 11: PyPI Packaging
**Goal**: vmcluster-mcp is published to PyPI and installable with a single command
**Depends on**: Phase 10 (v1.0 complete)
**Requirements**: INST-01
**Success Criteria** (what must be TRUE):
  1. User can run `pip install vmcluster-mcp` and the package installs without errors
  2. User can run `uvx vmcluster-mcp` to execute the server directly without a prior install step
  3. The installed package exposes the `vmcluster-mcp` console script entry point
  4. Package builds cleanly as both sdist and wheel from `pyproject.toml` with no missing files
**Plans**: 2 plans

Plans:
- [x] 11-01-PLAN.md — Test scaffold, main() wrapper, pyproject.toml metadata, LICENSE
- [ ] 11-02-PLAN.md — README update, uv build, wheel verification, PyPI publish

### Phase 12: Setup Wizard
**Goal**: Users can run `vmcluster-mcp setup` to validate their environment, generate a config file, download a base image, and register the server with their MCP client — all in one guided session
**Depends on**: Phase 11
**Requirements**: INST-02, INST-03, INST-04, INST-05, INST-06
**Success Criteria** (what must be TRUE):
  1. User can run `vmcluster-mcp setup` and be guided through all required configuration prompts
  2. Setup wizard detects missing host dependencies (libvirt, QEMU/KVM, libvirt-python) and prints distro-specific install commands (apt, dnf, pacman) for each missing one
  3. After completing the wizard, a valid `config.yaml` exists at the user-specified path with all required fields populated
  4. Setup wizard offers to download a known-good Ubuntu/Debian cloud image, fetches it, and verifies its sha256 checksum before accepting it
  5. Setup wizard detects the user's MCP client config (claude-code `~/.claude.json` or Claude Desktop config) and writes the vmcluster-mcp server entry, leaving all existing entries intact
**Plans**: TBD

---

## Progress

| Phase | Milestone | Plans Complete | Status | Completed |
|-------|-----------|----------------|--------|-----------|
| 1. Foundation | v1.0 | 3/3 | Complete | 2026-03-22 |
| 2. Core VM Lifecycle | v1.0 | 4/4 | Complete | 2026-03-22 |
| 3. SSH Execution | v1.0 | 3/3 | Complete | 2026-03-23 |
| 4. Snapshot Management | v1.0 | 2/2 | Complete | 2026-03-23 |
| 5. Artifact Pipeline | v1.0 | 3/3 | Complete | 2026-03-23 |
| 6. Kernel Observability | v1.0 | 2/2 | Complete | 2026-03-23 |
| 7. Network & Node Fault Injection | v1.0 | 5/5 | Complete | 2026-03-24 |
| 8. Retroactive Phase Verification | v1.0 | 2/2 | Complete | 2026-03-24 |
| 9. Requirements & Roadmap Metadata Closure | v1.0 | 3/3 | Complete | 2026-03-24 |
| 10. Nyquist Validation Coverage | v1.0 | 3/3 | Complete | 2026-03-24 |
| 11. PyPI Packaging | v1.1 | 1/2 | In Progress|  |
| 12. Setup Wizard | v1.1 | 0/TBD | Not started | - |
