| Milestone | Scope | Status | Target |
|---|---|---|---|
| M1 | Stabilize v1 mounted versioning and docs isolation | Completed | 2026-Q1 |
| M2 | Expand v2 endpoint surface with parity planning | In Progress | 2026-Q2 |
| M3 | Add compatibility strategy for legacy path consumers | Planned | 2026-Q2 |
| M4 | Improve operational runbooks and incident playbooks | Planned | 2026-Q3 |
| M5 | Harden deployment automation and release checks | Planned | 2026-Q3 |
- Priority 1: Preserve contract clarity between v1 and v2.
- Priority 2: Keep docs and tests in lockstep with API behavior.
- Priority 3: Prevent architecture drift across layers and middleware.