# 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:

```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.

## 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)
- Integrations:
  - [docs/integrations/whisperx-json.md](docs/integrations/whisperx-json.md)
  - [docs/integrations/output-schemas.md](docs/integrations/output-schemas.md)
- Development architecture policy: [docs/policy/architecture.md](docs/policy/architecture.md)
- Contributor workflow: [docs/policy/development.md](docs/policy/development.md)
- Documentation policy: [docs/policy/documentation.md](docs/policy/documentation.md)
- Internal implementation docs:
  - [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 schemas:
  - [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)
- Remaining documentation migration work: [docs/roadmap/documentation.md](docs/roadmap/documentation.md)