57 lines
1.7 KiB
Markdown
57 lines
1.7 KiB
Markdown
# Audita (Go Rewrite)
|
|
|
|
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:
|
|
|
|
```sh
|
|
go test ./...
|
|
```
|
|
|
|
Run help:
|
|
|
|
```sh
|
|
go run ./cmd/audita --help
|
|
go run ./cmd/audita process --help
|
|
```
|
|
|
|
Run Phase 2 normalization flow:
|
|
|
|
```sh
|
|
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`
|