audita/docs/migrations/v3.md

Migrating to application configuration v3

Audita v3 is a hard cutover. Move application settings to version: 3 and use the configuration reference and maintained 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 for lifecycle and recovery.