git.stella-ops.org/docs/modules/ui/evidence-capsules-canonical-cutover

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