# Evidence Capsules Canonical Cutover

## Purpose
- Keep Decision Capsules owned by the live `Evidence` shell instead of splitting them across canonical routes, stale legacy bookmarks, and context-specific dead ends.
- Finish the usable workflow, not just the references: list, detail, back-navigation, related-run handoff, and bookmark repair all need to work for operators.

## Canonical Routes
- `/evidence/capsules`
- `/evidence/capsules/:capsuleId`

## Alias Policy
- Preserve `/evidence-packs`
- Preserve `/evidence-packs/:capsuleId`
- Redirect aliases into the canonical `/evidence/capsules*` subtree while preserving query params and fragments.

## Shell Ownership
- `Evidence` remains the only operator-facing owner of Decision Capsule browsing.
- The capsule list uses Decision Capsule terminology consistently and opens detail pages inside the canonical Evidence shell.
- Capsule detail exposes a back action that prefers the originating context and falls back to the canonical capsule list.

## Cross-Shell Handoffs
- `Ops > Operations > AI Runs` opens canonical capsule detail routes with a deterministic `returnTo` contract.
- Capsule detail routes related AI-generated evidence back into `/ops/operations/ai-runs/:runId`.
- Capsule detail routes release evidence into `/releases/runs/:runId/evidence`.
- Related-run handoffs always preserve a valid return path back to the canonical capsule detail page.

## Merge Notes From Dropped Surfaces
- The stale `/evidence-packs*` surface was not preserved as a second owner route.
- The useful behavior from the half-wired pack flow was merged into the canonical Evidence shell:
  - bookmark-safe alias repair
  - context-aware back navigation
  - live owner-route jumps for AI and release contexts

## Verification
- Angular tests cover:
  - canonical capsule route ownership
  - legacy alias redirects
  - list/detail navigation behavior
  - capsule viewer `returnTo` and related-run handoffs
- Playwright covers:
  - a live AI Runs entry point into capsule detail and back
  - a legacy `/evidence-packs/:capsuleId` bookmark that cuts over into the live release evidence workspace

## Related
- `docs/features/checked/web/evidence-capsules-canonical-cutover-ui.md`
- `docs/modules/ui/component-preservation-map/RESTORATION_PRIORITIES.md`