50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
# seriatim
|
|
|
|
`seriatim` is a Go CLI for transcript artifact processing.
|
|
|
|
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.
|
|
|
|
## Quickstart
|
|
|
|
Shortest useful merge command:
|
|
|
|
```sh
|
|
go run ./cmd/seriatim merge \
|
|
--input-file speaker-a.json \
|
|
--input-file speaker-b.json \
|
|
--output-file merged.json
|
|
```
|
|
|
|
## Commands
|
|
|
|
- `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.
|
|
- `render`: render an existing seriatim artifact as Markdown.
|
|
|
|
## Documentation
|
|
|
|
- CLI reference: [docs/cli.md](docs/cli.md)
|
|
- Configuration reference: [docs/config.md](docs/config.md)
|
|
- Operations guide: [docs/operations.md](docs/operations.md)
|
|
- Troubleshooting: [docs/troubleshooting.md](docs/troubleshooting.md)
|
|
- Integration references:
|
|
- [docs/integrations/whisperx-json.md](docs/integrations/whisperx-json.md)
|
|
- [docs/integrations/output-schemas.md](docs/integrations/output-schemas.md)
|
|
- 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:
|
|
- [docs/internal/pipeline.md](docs/internal/pipeline.md)
|
|
- [docs/internal/artifacts.md](docs/internal/artifacts.md)
|
|
- [docs/internal/modules.md](docs/internal/modules.md)
|
|
- Public JSON schema files:
|
|
- [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)
|
|
- Synthetic examples: [examples/README.md](examples/README.md)
|