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
• Integration references:
  • docs/integrations/whisperx-json.md
  • docs/integrations/output-schemas.md
• Development policies:
  • docs/policy/architecture.md
  • docs/policy/development.md
  • docs/policy/documentation.md
• Internal implementation references:
  • docs/internal/pipeline.md
  • docs/internal/artifacts.md
  • docs/internal/modules.md
• Public JSON schema files:
  • schema/minimal-output.schema.json
  • schema/intermediate-output.schema.json
  • schema/full-output.schema.json
• Synthetic examples: examples/README.md