UI Implementation Plan

Purpose

Provide a living plan for UI deliverables, dependencies, and evidence.

Active work

• Track current sprints under docs/implplan/SPRINT_*.md for this module.
• Update this file when new scoped work is approved.
• Sprint 025 is active for safe cleanup of approved dead leaves and committed generated/debug artifacts in the Web workspace.
• Sprint 026 shipped Settings IA rationalization: the Settings shell now owns only personal preferences (appearance, language, layout, AI assistant). All admin, tenant, and operations configuration leaves redirect to their canonical owners (Administration, Setup, Ops). See docs/features/checked/web/settings-ia-rationalization-ui.md.
• Sprint 027 is DONE: derived PageHeaderComponent into canonical ContextHeaderComponent with unified header contract (configurable heading level, testId, ARIA), adopted on 4 target pages (RegistryAdmin, PackRegistryBrowser, DeadLetterDashboard, OfflineKit), 15 focused tests.
• Sprint 031 (Witness Viewer Evidence Derivation) is DONE. Derived the orphan WitnessViewerComponent into 4 reusable proof-inspection sections (VerificationSummary, SignatureInspector, AttestationDetail, EvidencePayload) adopted on Reachability WitnessPage and Evidence PacketPage. See docs/implplan/SPRINT_20260308_031_FE_witness_viewer_evidence_derivation.md.

Near-term deliverables

• No active UI deliverables are currently staged in docs/implplan.
• The next queued batch is docs/modules/ui/orphan-revival-batch/README.md, which stages independent review-ready sprints for orphan shared-component adoption and disconnected-route integration.
• The queued orphan batch currently spans SPRINT_20260308_013 through SPRINT_20260308_023 and is intentionally not marked active until product review approves staffing.
• Newly queued follow-on planning sprints cover Settings information architecture rationalization plus UX derivation tracks for the orphan PageHeaderComponent, MetricCardComponent, TimelineListComponent, SplitPaneComponent, and WitnessViewerComponent (SPRINT_20260308_026 through SPRINT_20260308_031).
• Sprint 028 (MetricCardComponent derivation into canonical KPI card) is DONE. The shared MetricCardComponent now supports semantic delta direction (up-is-good / up-is-bad / neutral), severity accents, loading/empty/error states, and ARIA accessibility. Adopted on signals-runtime, search-quality, and delivery-analytics dashboards. See docs/implplan/SPRINT_20260308_028_FE_metric_card_dashboard_card_derivation.md.
• Sprint 029 (TimelineListComponent derivation) is DONE. Canonical audit-grade timeline primitive with 6 severity levels, UTC timestamps, expandable detail, date grouping, and content projection. Adopted on incident-timeline, audit-timeline-search, and releases-activity. See docs/implplan/SPRINT_20260308_029_FE_timeline_list_audit_timeline_derivation.md.
• Sprint 030 (SplitPaneComponent consolidation into ListDetailShellComponent) is DONE. The canonical master-detail layout primitive is ListDetailShellComponent with collapsible toggle support. SplitPaneComponent is deprecated. Adopted on signing-key-dashboard (trust-admin). See sprint file for contract details.
• Sprint 014 (CopyToClipboard, InlineCode, TruncatePipe adoption) is DONE. See docs/features/checked/web/orphan-copy-inline-truncate-adoption.md.
• Sprint 015 (FilterBarComponent adoption) shipped, then was partially rolled back on audit-family pages to restore lost filter semantics. See docs/features/checked/web/filter-bar-unification.md and docs/features/checked/web/orphan-revival-regression-remediation-ui.md.
• Sprint 020 (FindingListComponent consolidation) shipped, then was rolled back on mounted findings and release-security hosts because the shared contract required fabricated data. See docs/features/checked/web/orphan-finding-list-consolidation.md and docs/features/checked/web/orphan-revival-regression-remediation-ui.md.
• Sprint 021 (Evidence thread and persona workspace reconnection) shipped, and its internal thread navigation was completed in the remediation sprint. See docs/features/checked/web/evidence-thread-persona-workspaces-routes.md and docs/features/checked/web/orphan-revival-regression-remediation-ui.md.

Latest evidence

• docs/modules/ui/component-preservation-map/README.md - root index for the first-pass preservation map.
• docs/modules/ui/component-preservation-map/SUMMARY_TREE.md - branch-level keep / merge / wire / archive guidance.
• docs/modules/ui/component-preservation-map/inventory.json - deterministic machine-readable inventory for 303 candidate components.
• docs/modules/ui/policy-decisioning-studio/README.md - shipped Decisioning Studio product shape, canonical routes, alias coverage, and release-context entry-point contract.
• docs/modules/ui/restoration-topics/README.md - detailed placement notes for the next restoration topics after Decisioning Studio.
• docs/modules/ui/watchlist-operations/README.md - detailed watchlist UX dossier and owner-shell contract.
• docs/features/checked/web/reachability-witnessing-ui.md - shipped verification note for the canonical Reachability witness and PoE shell.
• docs/features/checked/web/identity-watchlist-management-ui.md - shipped verification note for the Trust & Signing watchlist shell and its Mission Control / Notifications handoffs.
• docs/features/checked/web/operations-consolidation-ui.md - shipped verification note for the canonical Operations shell, overview grouping, and legacy alias cutover.
• docs/features/checked/web/policy-decisioning-studio-ui.md - shipped verification note for the canonical Decisioning Studio shell, redirect cutover, release-context deep links, and VEX ownership merge.
• docs/features/checked/web/triage-explainability-workspace-ui.md - shipped verification note for the canonical triage artifact workspace, explainability rail, audit bundles, and security alias cutover.
• docs/features/checked/web/workflow-visualization-replay-ui.md - shipped verification note for the canonical run-detail graph, timeline, replay, evidence tabs, and workflow-editor preview reuse boundary.
• docs/features/checked/web/contextual-actions-patterns-ui.md - shipped verification note for the shared contextual route-state, headers, drawers, list-detail shells, grouped overview cards, and first adopted restoration surfaces.
• docs/features/checked/web/unified-audit-surfaces-ui.md - shipped verification note for the Evidence-owned audit shell, admin bookmark redirects, repaired audit subview links, and secondary handoff entry points.
• docs/features/checked/web/offline-operations-ui.md - shipped verification note for the canonical Offline Kit and Feeds & Airgap owner routes, repaired stale aliases, and completed offline shell actions.
• docs/features/checked/web/quota-health-aoc-operations-ui.md - shipped verification note for canonical quota, health, and AOC owner routes, repaired deep links, route-backed filters, and completed operator actions.
• docs/features/checked/web/execution-operations-ui.md - shipped verification note for canonical execution routes, repaired jobengine and scheduler aliases, completed dead-letter actions, and usable scanner-support workflows.
• docs/features/checked/web/topology-trust-administration-ui.md - shipped verification note for canonical topology and trust setup shells, repaired settings/admin/platform aliases, and platform-setup handoffs.
• docs/features/checked/web/security-operations-leaves-ui.md - shipped verification note for mission alerts/activity surfacing, unknowns route repair, notifications ownership, and legacy security alias cutover.
• docs/features/checked/web/findings-compare-baseline-availability-ui.md - shipped verification note for the truthful no-baseline findings compare state, disabled export behavior, live findings detail list, and removed stale audit export action.
• docs/features/checked/web/search-readiness-degraded-answer-state-ui.md - shipped verification note for truthful degraded-readiness search copy when suggestion viability is unavailable and the active response reports zero indexed matches.
• docs/features/checked/web/platform-setup-canonical-route-preservation-ui.md - shipped verification note for preserved /ops/platform-setup/* URLs during the shared setup/topology cutover.
• docs/features/checked/web/release-promotions-cutover-ui.md - shipped verification note for canonical release promotions routing, alias cutover, release-context wizard handoff, and end-to-end request submission.
• docs/features/checked/web/evidence-capsules-canonical-cutover-ui.md - shipped verification note for canonical Evidence-owned capsule routes, /evidence-packs* bookmark repair, and AI/release context handoffs.
• docs/modules/ui/reachability-witnessing/README.md - detailed witness and proof UX dossier plus cross-shell deep-link contract.
• docs/modules/ui/platform-ops-consolidation/README.md - detailed Operations overview taxonomy and legacy absorption plan.
• docs/modules/ui/offline-operations/README.md - detailed owner-shell contract for Offline Kit, Feeds & Airgap, Evidence handoffs, and stale alias policy.
• docs/modules/ui/quota-health-aoc-operations/README.md - canonical owner-shell contract for quota, health, and AOC operations cutover plus alias and action rules.
• docs/modules/ui/execution-operations/README.md - canonical execution owner-shell contract for JobEngine, Scheduler, Dead-Letter, and companion Scanner Ops workflows.
• docs/modules/ui/topology-trust-administration/README.md - canonical setup owner contract for topology inventory, trust administration, legacy trust redirects, and platform-setup handoffs.
• docs/modules/ui/security-operations-leaves/README.md - canonical owner contract for mission alerts/activity, security unknowns, notifications, and stale /analyze//notify handoffs.
• docs/modules/ui/platform-setup-canonical-route-preservation/README.md - preserved route contract for canonical /ops/platform-setup/* leaves during the shared setup/topology cutover.
• docs/modules/ui/release-promotions-cutover/README.md - canonical promotions owner contract, alias rules, and release-context handoff for the Releases shell.
• docs/modules/ui/evidence-capsules-canonical-cutover/README.md - canonical Evidence owner contract for Decision Capsule list/detail browsing, legacy bookmark aliases, and related-run handoffs.
• docs/modules/ui/triage-explainability-workspace/README.md - detailed artifact workspace and audit-bundle UX dossier.
• docs/modules/ui/workflow-visualization-replay/README.md - detailed run-detail graph, timeline, replay, and evidence UX dossier.
• docs/modules/ui/contextual-actions-patterns/README.md - shared placement contract for stray actions, pages, drawers, and tabs.
• docs/modules/ui/unified-audit-surfaces/README.md - shipped canonical audit owner, alias contract, and secondary entry-point rules for cross-module audit browsing.
• docs/modules/ui/orphan-revival-batch/README.md - queued execution batch for reviving selected orphan shared components and reconnecting disconnected route families without reopening duplicate top-level products.
• docs/features/checked/web/filter-bar-unification.md - shipped verification note for the shared FilterBarComponent adoption, now superseded on audit-family pages by the remediation rollback that restored missing filter semantics.
• docs/features/checked/web/orphan-revival-regression-remediation-ui.md - shipped verification note for the orphan-revival regression remediation, including the audit/trust filter rollback, truthful findings/release rollback, policy build fixes, and canonical evidence-thread navigation repair.

Dependencies

• docs/modules/ui/architecture.md
• docs/modules/ui/README.md
• docs/modules/platform/architecture-overview.md

Evidence of completion

• Code changes under src/Web/**.
• Tests and fixtures under the module’s __Tests / __Libraries.
• Docs and runbooks under docs/modules/ui/**.

Notes

• Keep deterministic and offline-first expectations aligned with module AGENTS.