narratio/docs/internal/stage-transcribe.md

Stage: transcribe

Purpose

Generate raw per-speaker transcripts from prepared audio using WhisperX.

Inputs

• audio/*.flac from prepare

Outputs

• transcripts/raw/<speaker>.json

Key Behavior

• discovers prepared audio from manifest inputs or canonical audio directory.
• derives speaker ID from .flac basename.
• runs WhisperX with configured concurrency/retry settings.
• validates each output as JSON.
• writes run-local outputs then materializes canonical transcript outputs.

Invariants

• speaker basenames must be unique.
• output path returned by adapter must match requested output path.
• each successful output is validated before stage success.