WIP almost done with track planning

conductor/tracks/session_insights_20260306/spec.md

@@ -1,27 +1,21 @@
-# Track Specification: Session Insights & Efficiency Scores
+# Track Specification: Session Insights & Efficiency Scores (session_insights_20260306)
 
 ## Overview
-Token usage over time, cost projections, efficiency metrics.
+Token usage over time, cost projections, session summary with efficiency scores. Visualize session_logger data.
 
-## Current State Audit
-### Already Implemented
-- session_logger.py
-- Token counting
-
-### Gaps to Fill
-- No visualization
-- No efficiency scoring
-
-## Goals
-- Token usage graphs
-- Cost projections
-- Efficiency scores
+## Architectural Constraints
+- **Efficient Calculation**: Metrics MUST be calculated incrementally.
+- **Real-Time**: Updates SHOULD reflect current session state.
 
 ## Functional Requirements
-- Rolling token history
-- Cost calculation
-- Efficiency algorithm
+- **Token Timeline**: Graph of token usage over session.
+- **Cost Projection**: Estimate remaining budget based on usage.
+- **Efficiency Score**: Calculate tokens-per-useful-change ratio.
+- **Session Summary**: Text summary of session metrics.
 
-## Non-Functional Requirements
-- Session comparison
-- Export capability
+## Acceptance Criteria
+- [ ] Token timeline renders.
+- [ ] Cost projection accurate.
+- [ ] Efficiency score calculated.
+- [ ] Summary displays key metrics.
+- [ ] Uses existing session_logger.