47 lines
2.2 KiB
Markdown
47 lines
2.2 KiB
Markdown
# 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`
|