2026-04-26 12:41:15 +00:00
|
|
|
# seriatim
|
|
|
|
|
|
2026-05-24 13:31:17 +00:00
|
|
|
`seriatim` is a Go CLI for transcript artifact processing.
|
2026-04-26 18:43:43 -05:00
|
|
|
|
2026-05-24 22:55:56 +00:00
|
|
|
It merges per-speaker WhisperX-style JSON into deterministic seriatim JSON,
|
|
|
|
|
trims existing seriatim artifacts by segment ID, normalizes transcript-like JSON
|
|
|
|
|
into supported output schemas, and renders existing seriatim artifacts as
|
|
|
|
|
human-readable Markdown.
|
2026-04-26 18:43:43 -05:00
|
|
|
|
2026-05-24 13:31:17 +00:00
|
|
|
## Quickstart
|
2026-04-26 18:43:43 -05:00
|
|
|
|
2026-05-24 13:31:17 +00:00
|
|
|
Shortest useful merge command:
|
2026-04-26 18:43:43 -05:00
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
go run ./cmd/seriatim merge \
|
2026-05-24 13:31:17 +00:00
|
|
|
--input-file speaker-a.json \
|
|
|
|
|
--input-file speaker-b.json \
|
2026-04-26 18:43:43 -05:00
|
|
|
--output-file merged.json
|
|
|
|
|
```
|
|
|
|
|
|
2026-05-24 13:31:17 +00:00
|
|
|
## Commands
|
2026-04-26 18:43:43 -05:00
|
|
|
|
2026-05-24 13:31:17 +00:00
|
|
|
- `merge`: merge one or more input transcript JSON files.
|
|
|
|
|
- `trim`: keep/remove segment IDs from an existing seriatim artifact.
|
|
|
|
|
- `normalize`: canonicalize transcript-like JSON into a seriatim artifact.
|
2026-05-24 22:55:56 +00:00
|
|
|
- `render`: render an existing seriatim artifact as Markdown.
|
2026-04-27 19:49:25 -05:00
|
|
|
|
2026-05-24 13:31:17 +00:00
|
|
|
## Documentation
|
2026-04-26 19:33:23 -05:00
|
|
|
|
2026-05-24 13:31:17 +00:00
|
|
|
- CLI reference: [docs/cli.md](docs/cli.md)
|
|
|
|
|
- Configuration reference: [docs/config.md](docs/config.md)
|
2026-05-24 13:34:51 +00:00
|
|
|
- Operations guide: [docs/operations.md](docs/operations.md)
|
|
|
|
|
- Troubleshooting: [docs/troubleshooting.md](docs/troubleshooting.md)
|
2026-05-24 15:11:11 +00:00
|
|
|
- Integration references:
|
2026-05-24 13:43:47 +00:00
|
|
|
- [docs/integrations/whisperx-json.md](docs/integrations/whisperx-json.md)
|
|
|
|
|
- [docs/integrations/output-schemas.md](docs/integrations/output-schemas.md)
|
2026-05-24 15:11:11 +00:00
|
|
|
- Development policies:
|
|
|
|
|
- [docs/policy/architecture.md](docs/policy/architecture.md)
|
|
|
|
|
- [docs/policy/development.md](docs/policy/development.md)
|
|
|
|
|
- [docs/policy/documentation.md](docs/policy/documentation.md)
|
|
|
|
|
- Internal implementation references:
|
2026-05-24 13:38:27 +00:00
|
|
|
- [docs/internal/pipeline.md](docs/internal/pipeline.md)
|
|
|
|
|
- [docs/internal/artifacts.md](docs/internal/artifacts.md)
|
|
|
|
|
- [docs/internal/modules.md](docs/internal/modules.md)
|
2026-05-24 15:11:11 +00:00
|
|
|
- Public JSON schema files:
|
2026-05-24 13:31:17 +00:00
|
|
|
- [schema/minimal-output.schema.json](schema/minimal-output.schema.json)
|
|
|
|
|
- [schema/intermediate-output.schema.json](schema/intermediate-output.schema.json)
|
|
|
|
|
- [schema/full-output.schema.json](schema/full-output.schema.json)
|
2026-05-24 13:43:47 +00:00
|
|
|
- Synthetic examples: [examples/README.md](examples/README.md)
|
