manual_slop/conductor/tracks/cache_analytics_20260306/spec.md

Track Specification: Cache Analytics Display (cache_analytics_20260306)

Overview

Gemini cache hit/miss visualization, memory usage, TTL status display. Uses existing ai_client.get_gemini_cache_stats() which is not displayed in GUI.

Architectural Constraints

• Non-Blocking: Cache queries MUST NOT block UI.
• Efficient Polling: Cache stats SHOULD be polled, not pushed.

Functional Requirements

• 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.

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().