WIP almost done with track planning

conductor/tracks/performance_dashboard_20260306/spec.md

@@ -1,29 +1,21 @@
-# Track Specification: Performance Dashboard
+# Track Specification: Performance Dashboard (performance_dashboard_20260306)
 
 ## Overview
-Expand performance metrics with CPU/RAM, frame time, input lag graphs.
+Expand performance metrics panel with CPU/RAM usage, frame time, input lag with historical graphs. Uses existing performance_monitor.py which has basic metrics but no visualization.
 
-## Current State Audit
-### Already Implemented
-- performance_monitor.py
-- get_metrics() method
-- Basic FPS display
-
-### Gaps to Fill
-- No historical graphs
-- No input lag tracking
-- No CPU/RAM visualization
-
-## Goals
-- Historical performance graphs
-- CPU/RAM usage display
-- Input lag metrics
+## Architectural Constraints
+- **60fps Constraint**: Metrics collection MUST NOT impact frame rate.
+- **Thread Safety**: Cross-thread metrics MUST use proper synchronization.
 
 ## Functional Requirements
-- Rolling metrics history
-- Graph rendering
-- Alert thresholds
+- **CPU/RAM Graphs**: Display rolling CPU and RAM usage over time.
+- **Frame Time**: Show frame time histogram.
+- **Input Lag**: Track and display input-to-response latency.
+- **Historical Data**: Maintain rolling window of metrics history.
 
-## Non-Functional Requirements
-- 60fps UI during metrics collection
-- Configurable history length
+## Acceptance Criteria
+- [ ] CPU graph shows rolling history.
+- [ ] RAM graph shows rolling history.
+- [ ] Frame time histogram displays.
+- [ ] Input lag metrics tracked.
+- [ ] Uses existing performance_monitor.py.