2026-05-18 22:03:59 -05:00
|
|
|
# Stage: transcribe
|
|
|
|
|
|
|
|
|
|
## Purpose
|
2026-08-09 21:50:21 +00:00
|
|
|
|
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
|
2026-08-09 21:50:21 +00:00
|
|
|
|
2026-05-23 12:57:59 +00:00
|
|
|
- `audio/*.flac` from `prepare`
|
2026-05-18 22:03:59 -05:00
|
|
|
|
2026-05-23 12:57:59 +00:00
|
|
|
## Outputs
|
2026-08-09 21:50:21 +00:00
|
|
|
|
2026-05-23 12:57:59 +00:00
|
|
|
- `transcripts/raw/<speaker>.json`
|
2026-05-18 22:03:59 -05:00
|
|
|
|
2026-05-23 12:57:59 +00:00
|
|
|
## Key Behavior
|
2026-08-09 21:50:21 +00:00
|
|
|
|
2026-05-23 12:57:59 +00:00
|
|
|
- discovers prepared audio from manifest inputs or canonical audio directory.
|
|
|
|
|
- derives speaker ID from `.flac` basename.
|
2026-08-09 21:50:21 +00:00
|
|
|
- dispatches WhisperX requests through a bounded worker pool.
|
2026-05-23 12:57:59 +00:00
|
|
|
- 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
|
2026-08-09 21:50:21 +00:00
|
|
|
|
2026-05-23 12:57:59 +00:00
|
|
|
- speaker basenames must be unique.
|
|
|
|
|
- output path returned by adapter must match requested output path.
|
|
|
|
|
- each successful output is validated before stage success.
|
2026-08-09 21:50:21 +00:00
|
|
|
|
|
|
|
|
## Related Contracts And Tests
|
|
|
|
|
|
|
|
|
|
- [WhisperX](../integrations/whisperx.md) owns HTTP, retry, timeout, and
|
|
|
|
|
cancellation semantics.
|
|
|
|
|
- [Configuration](../config.md#pipeline) owns concurrency and other
|
|
|
|
|
operator-selected values.
|
|
|
|
|
- Implementation and tests: `internal/stage/transcribe.go`,
|
|
|
|
|
`internal/stage/transcribe_test.go`
|
