2026-05-18 22:03:59 -05:00
|
|
|
# Stage: transcribe
|
|
|
|
|
|
|
|
|
|
## Purpose
|
2026-05-23 12:57:59 +00:00
|
|
|
Generate raw per-speaker transcripts from prepared audio using WhisperX.
|
2026-05-18 22:03:59 -05:00
|
|
|
|
2026-05-23 12:57:59 +00:00
|
|
|
## Inputs
|
|
|
|
|
- `audio/*.flac` from `prepare`
|
2026-05-18 22:03:59 -05:00
|
|
|
|
2026-05-23 12:57:59 +00:00
|
|
|
## Outputs
|
|
|
|
|
- `transcripts/raw/<speaker>.json`
|
2026-05-18 22:03:59 -05:00
|
|
|
|
2026-05-23 12:57:59 +00:00
|
|
|
## 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.
|
2026-05-18 22:03:59 -05:00
|
|
|
|
2026-05-23 12:57:59 +00:00
|
|
|
## Invariants
|
|
|
|
|
- speaker basenames must be unique.
|
|
|
|
|
- output path returned by adapter must match requested output path.
|
|
|
|
|
- each successful output is validated before stage success.
|
