[dben]

Fixes a bumper played before a short notice cutting everything up to the next break (BtB, "Part Two: Peter Attia and the Cult of Longevity": 26:59–38:16 cut where only 34:01–38:13 was a break), and adds a check that cuts what a feed's transcript leaves out.

Break detection

• Longest ad break is a per-show setting, 8 minutes by default (it was a fixed 10). --max-break for the CLI.
• A second bumper-in starts a break over. A break never holds two, so the first was a false start, or its bumper-out was missed.
• A bumper-out with a bumper-in within 15 s of it leads into a break, unless known ads came since the break opened. In the Attia episode the false break ended at the closing half of a back-to-back sting pair (#46, #47) going into the real break.

Missing from the transcript (podblock/app/missing.py)

Shows with inserted ads usually make their feed's transcript before the ads go in. For those shows, each download is transcribed too and lined up with the feed's transcript word for word.

• Stretches of 20 s or more get cut when whisper heard speech the transcript doesn't have, or when the download runs much longer than the transcript between the same two words. They show on the timeline as Not in transcript and in chapters as ad breaks.
• A break found from bumpers that is mostly what the transcript has is dropped. This only applies once the transcript has been seen to leave ads out.
• Once checked, whisper's captions are served in place of the feed's transcript, whose times run behind after each ad. The feed's transcript stays on the episode, unserved, to check against.
• Each stretch has Don't cut this on the timeline, kept for that episode.
• Settings checkbox, on by default. It shows only when the transcriber is set and the feed lists transcripts in its newest 20 items, or the check was turned on.

Schema

• 18: podcasts.max_break
• 19: podcasts.transcript_check, episodes.missing_cuts, episodes.missing_kept

Main's timings table keeps step 17.

Testing

• 249 tests pass, ruff clean.
• New tests cover the break rules (one built from the Attia episode's timings), the alignment, the captions check, the per-episode keep and the settings checkbox.
• Not yet run against real feeds or seen in a browser.

---

Generated by Claude Code