Files
audita/docs/migrations/v3.md

24 lines
1.4 KiB
Markdown

# Migrating to application configuration v3
Audita v3 is a hard cutover. Move application settings to `version: 3` and use
[the configuration reference](../config.md) and [maintained examples](../../examples/)
to construct the new files. The previous configuration and standalone glossary
formats are not loaded by the new processing path.
- Replace `pipeline.modules` with ordered `pipeline.stages` records containing
`module` and any per-entry overrides. An explicit empty list runs normalization.
- Define named `glossary_collections` in configuration or its companion imports;
select them using `glossaries` and `protected_terms`. Remove `--glossary` and
`--modules` from invocations.
- Move profiles and backends out of the application configuration and retired
`profiles_dir` layout into PromptKit resources. Use its current list records,
IDs, credential sources, and backend admission settings. Select proposal and
validation profiles in application `llm` settings.
- Use the shared `--debug` flag for capture; `diagnostics.work_dir` remains the
parent directory. Review report and output destinations before running.
Inspect configuration and resources before processing, then try a controlled
small transcript. Processing preflight checks every glossary correction and
selected role before preparing outputs or invoking a model. See [operations](../operations.md)
for lifecycle and recovery.