stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
d7c3d5ad622d5d16fbc4a71b7149ec284b43586c
git.stella-ops.org/docs/modules/ui/implementation_plan.md
master d7c3d5ad62 feat(web): derive metric-card into canonical KPI card with semantic delta handling [SPRINT-028] 
Rework MetricCardComponent from a basic label+value+delta card into the
canonical Stella Ops KPI card primitive with:

- deltaDirection input ('up-is-good' | 'up-is-bad' | 'neutral') to control
  green/red semantics per metric context
- severity input ('healthy' | 'warning' | 'critical' | 'unknown') for
  left-border health accents
- unit input for display units (ms, %, /hr, GB)
- loading, empty, and error states with skeleton/placeholder rendering
- ARIA accessibility (role="group", composite aria-label, delta labels)
- Responsive dense-grid support

Adopted on 3 representative dashboards (12 bespoke tiles replaced):
- signals-runtime-dashboard (3 cards)
- search-quality-dashboard (4 cards)
- delivery-analytics (5 cards)

40 focused tests covering delta direction semantics, all states, severity
accents, and accessibility.

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

10 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.

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 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.