Complete Phase 19 Go rollout documentation

This commit is contained in:
2026-05-12 13:46:14 +00:00
parent 68e2d9b549
commit fb59cb21b9
5 changed files with 345 additions and 65 deletions

View File

@@ -29,9 +29,19 @@ The Go rewrite is complete when both of the following are true:
- Strict stdout/stderr discipline for subprocess callers.
- No hidden service dependency; the CLI remains the primary integration surface.
## Final status (Phase 19 complete)
The Go rewrite definition of done is met, with documented parity caveats tracked in `docs/python-parity.md`.
- Phase 19 is complete.
- Go Audita is the active implementation.
- The default full module pipeline is implemented (`glossary,homophones,glossary,spoken_word,grammar`).
- Parity fixtures and operational hardening coverage exist in normal `go test ./...`.
- Python is retained as a legacy/reference implementation and is not the primary operational path.
## Current implementation status
The Go rewrite now has feature-complete runtime behavior for the module pipeline plus Phase 18 operational hardening coverage.
The Go rewrite is complete and feature-complete for the intended CLI runtime architecture.
Implemented:
- CLI command surface for `audita process`.
@@ -97,8 +107,11 @@ Implemented:
- validation override behavior when validation fields are set.
- Generic JSON diagnostics primitives for LLM interactions (request metadata, request payload, response payload, optional error payload) with secret redaction.
Not yet implemented:
- Phase 19 rollout and Python retirement/documentation transition work.
Phase 19 documentation and rollout items are implemented:
- Go-first README/build/test/usage guidance.
- subprocess/orchestrator operational guidance.
- Python-to-Go migration guidance.
- explicit legacy/reference Python status documentation.
## Completed phases
@@ -234,10 +247,6 @@ Not implemented in Phase 8 (by design):
- Prompt/response diagnostics runtime wiring.
- End-to-end transcript polishing.
## Remaining work plan
Next recommended phase: **Phase 19 (documentation, rollout, and Python retirement)**.
## Phase 9: Structured LLM client and scheduler infrastructure
### Status
@@ -656,8 +665,8 @@ Implemented:
- permit release on error/cancellation.
- Added focused subprocess-caller operational guidance in `docs/subprocess-operations.md`.
Intentionally deferred:
- Phase 19 documentation/rollout/Python-retirement transitions.
Historical note:
- Phase 19 documentation/rollout/Python-retirement transitions were deferred at the end of Phase 18 and completed in Phase 19.
## Phase 19: Documentation, rollout, and Python retirement
@@ -689,9 +698,23 @@ The repository clearly presents the Go implementation as the active Audita imple
- Users can build, test, and run the Go implementation from docs alone.
- `go test ./...` passes.
### Phase 19 completion status
Completed.
Implemented:
- README is Go-first and documents active full-pipeline runtime behavior.
- Build/install/test usage guidance is Go-primary and operationally oriented.
- Subprocess/orchestrator behavior is documented in `docs/subprocess-operations.md`.
- Migration guidance from Python to Go is documented in `docs/migration-from-python.md`.
- Python parity notes and open parity gaps remain documented in `docs/python-parity.md`.
- Python implementation status is explicitly legacy/reference in primary docs and `python/README.md`.
- Documentation no longer routes normal operations to Python.
- Normal `go test ./...` remains independent of real LLM credentials and Python dependencies.
## Cross-phase compatibility requirements
These constraints apply to every remaining phase:
These constraints were used across implementation phases and remain useful maintenance checks:
- Preserve subprocess-safe stdout/stderr behavior.
- Preserve CLI-over-env precedence.