subwave-log-analysis

What problem does it solve?

SUB/WAVE operators need to understand what the radio is doing at runtime—especially when it’s slow, repetitive, or malfunctioning—without manually parsing large JSONL log files.

Core Features & Use Cases

• Unified event-log diagnostics: Translates state/logs/events-*.jsonl into a structured diagnostic report focused on Navidrome usage, picker/DJ quality, and health anomalies.
• Actionable operational recommendations: Interprets log patterns and pairs findings with concrete knob-turning recommendations (e.g., pool breadth, LLM/provider issues, Navidrome URL misrouting).
• Trace-grounded root cause analysis: Uses shared traceId to help connect symptoms to the specific decisions and API calls that caused them.

Use this when you want to answer questions like “analyse the subwave logs”, “check the radio’s behaviour”, “why does it keep playing the same artists”, “is the station healthy”, or “how are the Navidrome calls looking”.

Quick Start

Ask: analyse the subwave logs for the last 24 hours using the SUB/WAVE state directory.