stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
a5a5c6a8543d006d151f9463da6adb379881f5c2
git.stella-ops.org/docs/modules/ui/implementation_plan.md
master d27d68d8c6 feat(web): derive timeline-list into canonical audit-grade event-stream timeline [SPRINT-029] 
Rework the orphan TimelineListComponent into a canonical audit-grade
event-stream primitive for all mounted chronology surfaces.

Canonical event model (FE-TLD-001):
- TimelineEvent with id, timestamp (ISO-8601 UTC), title, description,
  actor, eventKind (info/success/warning/error/critical/neutral), icon,
  evidenceLink, metadata key-value pairs, and expandable detail payload
- Relative time for <24h, absolute UTC for >=24h, full ISO on tooltip
- Date grouping when events span multiple days

Derived primitive (FE-TLD-002):
- Vertical timeline with colored severity markers
- Deterministic UTC timestamp formatting
- Expandable detail sections with expand/collapse toggle
- Optional actor, metadata chips, and evidence links
- Loading skeleton and empty state
- Accessibility: role="feed", role="article", aria-labels, datetime attrs
- Content projection via ng-template for domain-specific rendering

Adopted on 3 surfaces (FE-TLD-003):
- incident-timeline: replaces bespoke inline timeline markers with shared
  component; preserves affected-services chips and correlated-events via
  expandable and content projection
- audit-timeline-search: replaces bespoke timeline rendering; preserves
  module/action badges via content projection
- releases-activity: replaces timeline view mode (was rendering duplicate
  table) with canonical timeline; preserves lane/env/outcome chips

Tests (FE-TLD-004): 32 focused tests covering event rendering, severity
markers, timestamp formatting, expandable toggle, loading/empty states,
date grouping, accessibility, and default fallbacks.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 23:23:23 +02:00

12 KiB
Raw Blame History

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.