forked from Furumi/furumi-tui
Episodes stream from the publisher through the prototype's bounded HTTP Range reader (ported, URL queries redacted from errors). The audio URL and resume position come from the store at play time; a 4xx on the audio URL refreshes the feed once and retries with the address it now lists, and a stream that cannot seek refuses to start at a saved position instead of playing from the wrong place. Prepared sources reach the audio thread with the player's source generation, so a slow stream never replaces a newer start or stop, and with their start offset for position reporting. Progress follows the FRID contract through one ordered writer thread: start_session or restart on start, checkpoints every 20 s and on pause, explicit seeks, complete_session near the end or at end of stream, and a final save with the last seen position on stop, track change, handoff and exit. A superseded session stops checkpointing until the next explicit action; listening sessions are recorded at pause, completion and end. Enter on an episode plays it after the current item, b starts it over, a/A queue it, and mark played goes through the same writer. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>