WIP almost done with track planning

conductor/tracks/cache_analytics_20260306/spec.md

@@ -1,26 +1,21 @@
-# Track Specification: Cache Analytics Display
+# Track Specification: Cache Analytics Display (cache_analytics_20260306)
 
 ## Overview
-Gemini cache hit/miss visualization and TTL status.
+Gemini cache hit/miss visualization, memory usage, TTL status display. Uses existing ai_client.get_gemini_cache_stats() which is not displayed in GUI.
 
-## Current State Audit
-### Already Implemented
-- get_gemini_cache_stats() in ai_client.py
-- Cache creation/deletion
-
-### Gaps to Fill
-- No GUI display
-- No hit/miss tracking
-
-## Goals
-- Cache status panel
-- Hit/miss ratio
-- TTL countdown
+## Architectural Constraints
+- **Non-Blocking**: Cache queries MUST NOT block UI.
+- **Efficient Polling**: Cache stats SHOULD be polled, not pushed.
 
 ## Functional Requirements
-- Cache size display
-- TTL visualization
-- Manual cache clear
+- **Cache Status**: Display active cache count and size.
+- **Hit/Miss Ratio**: Calculate and display cache efficiency.
+- **TTL Countdown**: Show time until next cache rebuild.
+- **Manual Clear**: Button to manually clear cache.
 
-## Non-Functional Requirements
-- Non-blocking UI updates
+## Acceptance Criteria
+- [ ] Cache panel displays in GUI.
+- [ ] Hit/miss ratio calculated correctly.
+- [ ] TTL countdown visible.
+- [ ] Manual clear button works.
+- [ ] Uses existing get_gemini_cache_stats().