seriatim/README.md

seriatim

seriatim is a Go CLI for transcript artifact processing.

It merges per-speaker WhisperX-style JSON into one deterministic transcript, trims existing seriatim artifacts by segment ID, and normalizes transcript-like JSON into standard seriatim output schemas.

Quickstart

Shortest useful merge command:

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.

Documentation

• CLI reference: docs/cli.md
• Configuration reference: docs/config.md
• Operations guide: docs/operations.md
• Troubleshooting: docs/troubleshooting.md
• Development architecture policy: docs/policy/architecture.md
• Documentation policy: docs/policy/documentation.md
• Public JSON schemas:
  • schema/minimal-output.schema.json
  • schema/intermediate-output.schema.json
  • schema/full-output.schema.json
• Remaining documentation migration work: docs/roadmap/documentation.md