eric/narratio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 15 Wiki Activity

Document Seriatim merge integration

Browse Source
This commit is contained in:
Eric Rakestraw
2026-05-03 22:24:27 -05:00
parent 793ed48d13
commit d1802f99f0
3 changed files with 39 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
README.md
View File

@@ -2,7 +2,7 @@
`narratio` is a Go-based orchestration application for processing D&D session audio into transcripts and downstream artifacts.
This repository currently contains a **working scaffold** with strict config loading, local workdir/manifest handling, resumable stage control, a real WhisperX HTTP adapter, and a real `prepare` + `transcribe` path.
This repository currently contains a **working scaffold** with strict config loading, local workdir/manifest handling, resumable stage control, real WhisperX and Seriatim adapters, and real `prepare` + `transcribe` + `merge` stages.
## Expected Config Files
@@ -26,7 +26,7 @@ Seriatim config contract in `pipeline.yml`:
`speakers.yml` note:
- use Seriatim’s documented `match:` format (not the legacy direct mapping style used by older scripts/scaffolds)
- TODO: add a concrete `speakers.yml` example once the Seriatim README/spec is vendored or linked in-repo.
- see [`examples/speakers.yml`](examples/speakers.yml) for a concrete `match:` example.
Decoding is strict (`KnownFields(true)`), so unknown YAML fields fail fast.
@@ -42,13 +42,12 @@ Implemented now:
- strict config load + validation
- local artifact/workdir creation and locking
- manifest create/load/save and stage status tracking
- stage framework with real `prepare` and `transcribe` stages; placeholder downstream stages
- stage framework with real `prepare`, `transcribe`, and `merge` stages; placeholder downstream stages
- resumable run control (`run`, `resume`, `run-stage`, `plan` with run/skip decisions)
- real WhisperX HTTP adapter plus fake/no-op adapters for test/scaffold usage
- real WhisperX HTTP adapter plus real Seriatim subprocess adapter (both with fake/no-op adapters for test/scaffold usage)
Not implemented yet:
- real Seriatim execution
- real Audita execution
- real analyzer integration
- real remote archive/storage backend
@@ -68,9 +67,12 @@ go run ./cmd/narratio plan --config examples/pipeline.minimal.yml --session exam
## Run Pipeline (Current State)
The current `run` command executes `prepare` + real `transcribe` + placeholder downstream stages and records progress in `manifest.json`.
The current `run` command executes `prepare` + real `transcribe` + real `merge` + placeholder downstream stages and records progress in `manifest.json`.
Default CLI wiring builds and uses the real WhisperX HTTP adapter from `pipeline.whisperx` when `whisperx.transcribe_url` is configured.
Default CLI wiring builds and uses:
- real WhisperX HTTP adapter from `pipeline.whisperx`
- real Seriatim subprocess adapter from `pipeline.seriatim`
```bash
go run ./cmd/narratio run --config examples/pipeline.minimal.yml --session examples/session.minimal.yml