TODO.md — Known issues and bugs

Pre-existing bugs and known issues not yet triaged into the roadmap. Items here are waiting for scheduling or architectural clarity.

Player stack — adjacent correctness/hygiene issues

Surfaced by the same 2026-06-03 analysis (PLAYER_ANALYSIS.md §4). Distinct from the cascade bug.

No JS-module-readiness guard. AudioInteropService.CreatePlayerAsync assumes window.DeepDrftAudio is present; a slow WASM boot / cache miss produces a spurious init failure. Add a readiness guard or load-order guarantee.
Dead legacy buffered path is reachable and silent. The base AudioPlayerService.SelectTrack (non-streaming) path calls InitializeBufferedPlayerAsync / AppendAudioBlockAsync / FinalizeAudioBufferAsync, which are no-ops in index.ts. Any non-streaming player reports success and plays silence. Remove the dead path or make it fail loudly.
Dead TypeScript. Interop/audiobuffermanager.ts (orphaned, missing the live scheduler's isActive_ / playbackOffset fixes) and Interop/webaudio.ts (legacy re-export shim) are not part of the audio/ engine. Delete after confirming no build reference.
Duplicated UI helpers. GetPlayIcon and FormatTime are each implemented twice across AudioPlayerBar and child controls — drift risk. Consolidate.
Misleading minimized-dock affordance. The minimized button shows a play icon but OnClick toggles minimize, not playback.