Audita is a transcript polishing CLI. The Go implementation at the repository root is canonical going forward, and is being delivered compatibility-first against the frozen Python reference in python/.

Current Status: Phase 2 Foundation

The current audita process implementation now includes deterministic input handling and normalization foundations:

typed transcript parsing for both accepted top-level forms ([] and { "segments": [...] });
typed glossary YAML parsing;
transcript and glossary schema validation with actionable errors;
deterministic same-speaker normalization;
sequential normalized segment IDs starting at 1;
normalized transcript JSON output;
minimal structured --report-json output including normalization summary fields;
minimal normalization diagnostics artifacts in per-run work directories;
subprocess-safe stdout/stderr behavior.

Still not implemented in Phase 2:

transcript-polishing correction modules;
chunking/proposal generation and application;
deterministic and LLM validators;
structured LLM client execution;
module pipeline execution;
full long-term diagnostics retention/reporting model.

Quick Start (Go)

Run tests:

go test ./...

Run help:

go run ./cmd/audita --help
go run ./cmd/audita process --help

Run Phase 2 normalization flow:

go run ./cmd/audita process transcript.json --glossary glossary.yaml --output corrected.json

Without --output, normalized transcript JSON is written to stdout.

Repository Notes

python/ contains the frozen Python implementation used as behavioral reference during the Go port.
Architecture and rewrite guidance:
- docs/architecture.md
- docs/rewrite-notes.md