WIP almost done with track planning

conductor/tracks/session_insights_20260306/index.md

@@ -0,0 +1,9 @@
+# Session Insights & Efficiency Scores
+
+**Track ID:** session_insights_20260306
+
+**Status:** Planned
+
+**See Also:**
+- [Spec](./spec.md)
+- [Plan](./plan.md)

conductor/tracks/session_insights_20260306/metadata.json

@@ -0,0 +1,9 @@
+{
+  "id": "session_insights_20260306",
+  "name": "Session Insights & Efficiency Scores",
+  "status": "planned",
+  "created_at": "2026-03-06T00:00:00Z",
+  "updated_at": "2026-03-06T00:00:00Z",
+  "type": "feature",
+  "priority": "medium"
+}

conductor/tracks/session_insights_20260306/plan.md

@@ -1,16 +1,28 @@
-# Implementation Plan: Session Insights & Efficiency Scores (session_insights)
+# Implementation Plan: Session Insights (session_insights_20260306)
 
-## Phase 1: Research & Design
-- [ ] Task: Analyze existing backend implementation
-- [ ] Task: Design GUI/UX approach
-- [ ] Task: Conductor - User Manual Verification
+## Phase 1: Session Data
+- [ ] Task: Initialize MMA Environment
+- [ ] Task: Review session_logger
+    - WHERE: src/session_logger.py
+    - WHAT: Check existing data
 
-## Phase 2: Implementation
-- [ ] Task: Implement feature
-- [ ] Task: Write tests
-- [ ] Task: Conductor - User Manual Verification
+## Phase 2: Metrics Calculation
+- [ ] Task: Implement token timeline
+    - WHERE: src/gui_2.py
+    - WHAT: Token usage over time
+    - HOW: Graph from history
+- [ ] Task: Implement cost projection
+    - WHERE: src/gui_2.py
+    - WHAT: Estimate remaining budget
+    - HOW: Linear extrapolation
 
-## Phase 3: Verification
-- [ ] Task: Run test suite
-- [ ] Task: Verify coverage
-- [ ] Task: Conductor - Phase Completion Verification
+## Phase 3: UI
+- [ ] Task: Render insights panel
+    - WHERE: src/gui_2.py
+    - WHAT: Timeline, projection, summary
+    - HOW: imgui widgets
+    - SAFETY: Handle zero session
+
+## Phase 4: Verification
+- [ ] Task: Test insights
+- [ ] Task: Conductor - Phase Verification

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.