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

Complete Phase 3 proposal foundation

Browse Source
This commit is contained in:
Eric Rakestraw
2026-05-11 13:35:15 +00:00
parent 0452a605ad
commit c3087aeda6
3 changed files with 22 additions and 70 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
README.md
View File

@@ -2,28 +2,33 @@
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
## Current Status: Phase 3 Deterministic Foundation
The current `audita process` implementation now includes deterministic input handling and normalization foundations:
The current `audita process` implementation includes deterministic input handling and foundation 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`;
- deterministic token estimation;
- contiguous transcript chunking and section summaries;
- normalized transcript JSON output;
- minimal structured `--report-json` output including normalization summary fields;
- minimal structured `--report-json` output including normalization and chunking summary fields;
- minimal normalization diagnostics artifacts in per-run work directories;
- chunking diagnostics artifacts in per-run work directories;
- subprocess-safe stdout/stderr behavior.
Still not implemented in Phase 2:
The repository also now contains deterministic proposal foundation packages (models, preview, application, skip reporting, and framework contracts) with fixture/golden tests.
- 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.
Still not implemented in the Go CLI runtime path:
- real module execution pipeline;
- real `glossary`, `homophones`, `spoken_word`, or `grammar` module behavior;
- LLM proposal generation;
- validator-chain execution;
- concrete structured LLM client implementation;
- final end-to-end transcript polishing behavior.
## Quick Start (Go)
@@ -40,13 +45,13 @@ go run ./cmd/audita --help
go run ./cmd/audita process --help
```
Run Phase 2 normalization flow:
Run current deterministic flow:
```sh
go run ./cmd/audita process transcript.json --glossary glossary.yaml --output corrected.json
```
Without `--output`, normalized transcript JSON is written to stdout.
Without `--output`, transcript JSON is written to stdout.
## Repository Notes