# narratio

Narratio is a stage-driven Go orchestrator for turning D&D session audio into
polished transcripts, validated Notarius extraction lanes, and generated
artifacts.

It runs a deterministic workflow with manifest-driven continuation, remote
publish, and restore support.

```sh
narratio run 2026-04-04
```

This requires resolvable `pipeline.yml`, `campaign.yml`, and concrete
`session.yml` files or their explicit command-line alternatives.

## Documentation

- [CLI reference](docs/cli.md) — commands, arguments, flags, and invocation
  behavior.
- [Configuration](docs/config.md) — discovery, fields, defaults, and
  validation.
- [Operations](docs/operations.md) — runtime workflow, state, publishing,
  recovery, and cleanup.
- [Troubleshooting](docs/troubleshooting.md) — symptom-driven diagnosis and
  safe remedies.
- [Integration contracts](docs/integrations/) — external tools, formats, and
  compatibility expectations.
- [Maintained examples](examples/README.md) — complete copyable configuration
  and input files.

## Maintainer Documentation

- [Development guide](docs/development.md) — first-read orientation and
  task-specific reading routes.
- [Internal overview](docs/internal/overview.md) — implemented component map.
- [Architecture](docs/policy/architecture.md) — normative boundaries and
  invariants.
- [Documentation policy](docs/policy/documentation.md) — canonical ownership
  and maintenance rules.
- [Testing policy](docs/policy/testing.md) — test value, boundaries, and
  sufficiency.