web/docs/migration-policy-v1-to-v2.md

Migration Policy: v1 to v2

Rules

1. v1 interfaces evolve additively only.
2. Breaking changes require v2 namespace.
3. v1 deprecation requires migration guide and overlap window.

Required v2 Deliverables

1. Side-by-side API spec (/v2).
2. Schema migration map.
3. Backward compatibility notes.
4. Evidence continuity guarantees.