eric/audita
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

Complete Phase 2 Go normalization foundation

Browse Source
This commit is contained in:
Eric Rakestraw
2026-05-11 00:41:29 +00:00
parent d847168ecd
commit 10377876e4
11 changed files with 480 additions and 1241 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
README.md
View File

@@ -1,26 +1,29 @@
# Audita (Go Rewrite)
Audita is a transcript polishing CLI. The Go implementation at the repository root is the canonical implementation going forward, with a compatibility-first rewrite strategy.
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 1 Skeleton
## Current Status: Phase 2 Foundation
The current Go `audita process` command is a passthrough skeleton:
The current `audita process` implementation now includes deterministic input handling and normalization foundations:
- loads transcript and glossary files;
- validates transcript as well-formed JSON;
- writes transcript JSON back unchanged to `--output` or stdout;
- writes an early minimal `--report-json` report when requested;
- preserves subprocess-safe stdout/stderr behavior.
- 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.
Not implemented yet in Phase 1:
Still not implemented in Phase 2:
- transcript/glossary schema validation;
- normalization;
- chunking/proposals;
- validators;
- LLM calls;
- module execution;
- full diagnostics retention/report model.
- 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)
@@ -37,17 +40,17 @@ go run ./cmd/audita --help
go run ./cmd/audita process --help
```
Run minimal passthrough:
Run Phase 2 normalization flow:
```sh
go run ./cmd/audita process transcript.json --glossary glossary.yaml --output corrected.json
```
Without `--output`, corrected transcript JSON is written to stdout.
Without `--output`, normalized transcript JSON is written to stdout.
## Repository Notes
- `python/` contains the frozen Python implementation retained as behavioral reference during the port.
- Go architecture and rewrite guidance:
- `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`