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:

```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)
- 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)
- Remaining documentation migration work: [docs/roadmap/documentation.md](docs/roadmap/documentation.md)
Initial commit 2026-04-26 12:41:15 +00:00			`# seriatim`

Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			`seriatim` is a Go CLI for transcript artifact processing.
Updated documentation to reflect the current CLI interface 2026-04-26 18:43:43 -05:00
Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			`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.`
Updated documentation to reflect the current CLI interface 2026-04-26 18:43:43 -05:00
Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			`## Quickstart`
Updated documentation to reflect the current CLI interface 2026-04-26 18:43:43 -05:00
Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			`Shortest useful merge command:`
Updated documentation to reflect the current CLI interface 2026-04-26 18:43:43 -05:00
			```sh
			`go run ./cmd/seriatim merge \`
Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			`--input-file speaker-a.json \`
			`--input-file speaker-b.json \`
Updated documentation to reflect the current CLI interface 2026-04-26 18:43:43 -05:00			`--output-file merged.json`
			```

Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			`## Commands`
Updated documentation to reflect the current CLI interface 2026-04-26 18:43:43 -05:00
Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			- `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.
Implemented a module to detect backchannel segments, and updated the coalesce module to ignore them when coalescing same-speaker turns 2026-04-27 19:49:25 -05:00
Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			`## Documentation`
Implemented an autocorrect module at the postprocessing stage 2026-04-26 19:33:23 -05:00
Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			`- CLI reference: [docs/cli.md](docs/cli.md)`
			`- Configuration reference: [docs/config.md](docs/config.md)`
Add operations and troubleshooting documentation 2026-05-24 13:34:51 +00:00			`- Operations guide: [docs/operations.md](docs/operations.md)`
			`- Troubleshooting: [docs/troubleshooting.md](docs/troubleshooting.md)`
Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			`- Development architecture policy: [docs/policy/architecture.md](docs/policy/architecture.md)`
Add development policy and internal implementation documentation 2026-05-24 13:38:27 +00:00			`- Contributor workflow: [docs/policy/development.md](docs/policy/development.md)`
Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			`- Documentation policy: [docs/policy/documentation.md](docs/policy/documentation.md)`
Add development policy and internal implementation documentation 2026-05-24 13:38:27 +00:00			`- 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)`
Create canonical CLI and config docs and simplify README 2026-05-24 13:31:17 +00:00			`- 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)`
			`- Remaining documentation migration work: [docs/roadmap/documentation.md](docs/roadmap/documentation.md)`