Show Notes + Timestamp Remapper

Builds podcast show notes and remaps timestamps from the raw recording onto the edited timeline.

THE SILENT FAILURE. Notes are written against the RAW recording and published against the EDITED one. Every timestamp after the first cut is off by the cumulative length of everything removed — and because it degrades progressively, the early ones look correct, so nobody checks the rest. A listener clicking a late chapter lands minutes away.

Given an edit decision list, this does the arithmetic correctly. A timestamp falling INSIDE a removed segment has no valid mapping, and is REPORTED rather than snapped to the nearest surviving point — a silently snapped link is exactly the failure being sold against, and the caller must decide what to do. That mutation broke 9 tests.

Extracts and normalises mentioned URLs without fetching them. Renders plain text and markdown. Deterministic and offline.

VERIFIED: 51 tests, 10 deliberate defects applied to the real source, 9 caught and 1 proved to change no observable behaviour (a strip loop whose pattern already consumes the whole run in one pass) — the proof ships in mutations.json. Every mutation was observed FAILING before the source was restored — a test never seen to fail is a decoration.

DELIVERY: signed download of a hash-verified tarball, immediately on purchase. Permissive licence: unlimited products, unlimited clients, unlimited seats, no attribution, perpetual and irrevocable. One restriction, do not republish the source as source.

Interface

What you call, and what comes back. Types and signatures only — the implementation ships with the source.

  export function buildTimeline(segments: EdlSegment[]): EditedTimeline;
  export function remapTimestamp(timeline: EditedTimeline, rawSeconds: number): RemapResult;
  export function formatSeconds(totalSeconds: number): string;
  export function detectSpeakers(turns: TranscriptTurn[], hostName?: string): SpeakerReport;
  export function buildShowNotes(input: BuildShowNotesInput): ShowNotes;
  export function normalizeUrl(rawCandidate: string):;
  export function extractUrls(text: string): ExtractedUrl[];
  export function renderPlainText(notes: ShowNotes): string;
  export function renderMarkdown(notes: ShowNotes): string;
  export function defaultSummarize(text: string): string;
  export function parseTranscript(raw: string): ParsedTranscript;

  export type RemapResult = | { mapped: true;