Document resilient reports and remove obsolete warning material

docs/migrations/v2.md

@@ -19,8 +19,11 @@ Settings resolve from defaults, main file, optional `--overlay <name>` in
 environment overlays no longer apply. Unknown fields and version-1 files fail;
 there is no automatic converter.
 
-Keep transcript as the positional path and `--glossary`, `--output`, and
-`--report-json` as invocation paths. Keep `pipeline.modules` / `--modules` and
+Keep transcript as the positional path and `--glossary` and `--output` as
+invocation paths. The former `--report-json` output has been replaced by the
+default `errors.yml`, `recoveries.yml`, and `report.md` bundle; use
+`--reporting=false` to disable it or `--report-dir` for stdout output. Keep
+`pipeline.modules` / `--modules` and
 `output.schema` / `--output-schema`. An explicit `pipeline.modules: []` or
 `--modules ''` runs no correction modules; omission uses the default sequence.
 Ordered repetitions still matter.
@@ -73,14 +76,16 @@ The following domain settings and explicit flags retain their meaning:
 | `normalization.max_segment_gap`, `.ellipsis_gap`, `.max_segment_duration`, `.max_segment_tokens` | `--normalize-max-segment-gap`, `--normalize-ellipsis-gap`, `--normalize-max-segment-duration`, `--normalize-max-segment-tokens` |
 | `thresholds.glossary`, `.homophones`, `.spoken_word`, `.grammar` | `--glossary-confidence-threshold`, `--homophones-confidence-threshold`, `--spoken-word-confidence-threshold`, `--grammar-confidence-threshold` |
 | `context.description` | `--transcript-description` |
-| `diagnostics.work_dir`, `.retention` | `--work-dir`, `--work-dir-retention` |
+| `reporting.enabled`, `.stdout_dir` | `--reporting[=true\|false]`, `--report-dir` |
+| `diagnostics.debug`, `.work_dir` | `--debug[=true\|false]`, `--work-dir` |
 
 Normalization gaps and durations are **numeric seconds**, so replace `4s`,
 `3.5s`, and `60s` with `4.0`, `3.5`, and `60.0`. The operation timeout remains a
 Go duration string. `chunking.target_sections` may be omitted or null for
 automatic chunking; zero is invalid. Null is not a general synonym for omission:
 nonoptional scalar settings reject it. Empty `context.description` clears
-context. Retention behavior is unchanged.
+context. Legacy `diagnostics.retention` and `--work-dir-retention` are removed.
+Debug is off by default and its directory is retained whenever enabled.
 
 Remove old implicit variables `AUDITA_MODULES`, `AUDITA_MODEL`,
 `AUDITA_VALIDATION_MODEL`, `AUDITA_BASE_URL`, `AUDITA_VALIDATION_BASE_URL`,
@@ -109,14 +114,14 @@ calling a provider. `--overlay testing` selects the same overlay for validation,
 inspection, and processing. The old effective-config JSON format is replaced by
 YAML; settings YAML alone does not show profile-owned model controls.
 
-The [process report](../integrations/output-files.md#process-report) now uses
-schema `v2` and includes an `llm_summary` when execution observations are
-available. Logical calls are distinct from provider attempts; usage fields carry
-known and complete flags. Utilization is grouped by backend capacity rather than
-old scheduler and active-concurrency fields. Retained runs write
+The [ordinary output contract](../integrations/output-files.md) now uses
+version-1 `audita-errors` and `audita-recoveries` YAML documents plus a fixed
+Markdown overview. Compact outcomes distinguish logical operations from
+provider attempts. With debug enabled, utilization remains grouped by backend
+capacity and usage fields retain known/complete flags. Debug runs write
 `effective-config.redacted.yaml`, `selected-profiles.yaml`,
 `config-origins.yaml`, `utilization-diagnostics.json`, and
 `llm-execution.json`. Request and response artifacts remain redacted debugging
-material. See [operations](../operations.md#diagnostics-directory) for retention
+material. See [operations](../operations.md#diagnostics-directory) for placement
 and paths, [configuration](../config.md) for all settings, and the
 [CLI reference](../cli.md) for current flags.