feat(ui): ship evidence capsules cutover
This commit is contained in:
@@ -0,0 +1,46 @@
|
||||
# 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`
|
||||
Reference in New Issue
Block a user