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