narratio/docs/internal/stage-polish.md

Stage: polish

Purpose

Run Audita polishing on base transcript and produce polished transcript.

Inputs

• transcripts/base.json
• inputs/glossary.yml

Outputs

• transcripts/polished.json
• optional artifacts/audita.report.json

Key Behavior

• resolves base transcript from merge outputs/canonical fallback.
• invokes an Audita runner configured with static model/runtime options; the invocation supplies paths and modules.
• validates processed transcript structure (segments array required).
• validates optional report JSON.
• materializes canonical outputs; records logs/generated config and adapter metadata.

Invariants

• polished transcript schema validation is mandatory.
• report output is config-gated.

Related Contracts And Tests

• Audita owns subprocess, validation, and failure semantics.
• Configuration owns operator-selected Audita values.
• Implementation and tests: internal/stage/polish.go, internal/stage/polish_test.go