WIP almost done with track planning

conductor/tracks/tool_usage_analytics_20260306/spec.md

@@ -1,26 +1,21 @@
-# Track Specification: Tool Usage Analytics
+# Track Specification: Tool Usage Analytics (tool_usage_analytics_20260306)
 
 ## Overview
-Analytics panel for tool usage patterns.
+Analytics panel showing most-used tools, average execution time, and failure rates. Uses existing tool_log_callback data.
 
-## Current State Audit
-### Already Implemented
-- tool_log_callback
-- Tool execution tracking
-
-### Gaps to Fill
-- No analytics UI
-- No aggregation
-
-## Goals
-- Most-used tools ranking
-- Average execution time
-- Failure rate tracking
+## Architectural Constraints
+- **Efficient Aggregation**: Analytics MUST use efficient data structures.
+- **Memory Bounds**: History MUST be bounded to prevent growth.
 
 ## Functional Requirements
-- Usage histograms
-- Time series data
-- Failure logging
+- **Usage Ranking**: Show most-used tools ranked by count.
+- **Avg Time**: Display average execution time per tool.
+- **Failure Rate**: Track and display failure percentage per tool.
+- **Time Series**: Show usage over time.
 
-## Non-Functional Requirements
-- Efficient data aggregation
+## Acceptance Criteria
+- [ ] Tool ranking displayed.
+- [ ] Average times accurate.
+- [ ] Failure rates tracked.
+- [ ] Time series visualization works.
+- [ ] Uses existing tool_log_callback.