manual_slop/conductor/tracks/tool_usage_analytics_20260306/spec.md

Track Specification: Tool Usage Analytics (tool_usage_analytics_20260306)

Overview

Analytics panel showing most-used tools, average execution time, and failure rates. Uses existing tool_log_callback data.

Architectural Constraints

• Efficient Aggregation: Analytics MUST use efficient data structures.
• Memory Bounds: History MUST be bounded to prevent growth.

Functional Requirements

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

Acceptance Criteria

• Tool ranking displayed.
• Average times accurate.
• Failure rates tracked.
• Time series visualization works.
• Uses existing tool_log_callback.