Implemented invocation-level failure diagnostics

tests/test_new_cli.py

@@ -1,6 +1,8 @@
+import json
 import pytest
 
 from audita.cli import main
+from audita.core.errors import AuditaConfigError
 from audita.core.reporting import ProcessResult, RunReport
 from audita.core.schemas import parse_transcript_json
 
@@ -501,3 +503,69 @@ def test_cli_process_passes_min_section_tokens_override_to_config(monkeypatch, t
 
     assert exit_code == 0
     assert captured["min_section_tokens"] == 5000
+
+
+def test_cli_process_writes_failure_diagnostics_and_keeps_stdout_empty(monkeypatch, tmp_path, capsys):
+    monkeypatch.setattr(
+        "audita.cli.AuditaConfig.from_sources",
+        lambda overrides=None: (_ for _ in ()).throw(AuditaConfigError("bad config")),
+    )
+
+    report_path = tmp_path / "external-report.json"
+    exit_code = main(
+        [
+            "process",
+            "transcript.json",
+            "--glossary",
+            "glossary.yaml",
+            "--work-dir",
+            str(tmp_path / "work"),
+            "--report-json",
+            str(report_path),
+        ]
+    )
+
+    captured = capsys.readouterr()
+    assert exit_code == 1
+    assert captured.out == ""
+    assert "audita: error: bad config" in captured.err
+    assert "audita: exit code: 1" in captured.err
+    run_dir = next((tmp_path / "work").iterdir())
+    assert f"audita: run directory: {run_dir}" in captured.err
+    assert f"audita: error log: {run_dir / 'error.log'}" in captured.err
+    assert f"audita: report: {run_dir / 'report.json'}" in captured.err
+    assert (run_dir / "error.log").exists()
+    report = json.loads((run_dir / "report.json").read_text(encoding="utf-8"))
+    assert report["status"] == "failed"
+    assert report["error"] == "bad config"
+    assert report["error_details"]["phase"] == "config"
+    assert report["error_details"]["type"] == "AuditaConfigError"
+    external = json.loads(report_path.read_text(encoding="utf-8"))
+    assert external["error"] == "bad config"
+
+
+def test_cli_process_writes_failure_diagnostics_for_unexpected_exceptions(monkeypatch, tmp_path, capsys):
+    monkeypatch.setattr("audita.cli.AuditaConfig.from_sources", lambda overrides=None: object())
+    monkeypatch.setattr("audita.cli.load_transcript", lambda path: (_ for _ in ()).throw(RuntimeError("boom")))
+
+    exit_code = main(
+        [
+            "process",
+            "transcript.json",
+            "--glossary",
+            "glossary.yaml",
+            "--work-dir",
+            str(tmp_path / "work"),
+        ]
+    )
+
+    captured = capsys.readouterr()
+    assert exit_code == 1
+    assert captured.out == ""
+    assert "audita: error: boom" in captured.err
+    run_dir = next((tmp_path / "work").iterdir())
+    report = json.loads((run_dir / "report.json").read_text(encoding="utf-8"))
+    assert report["status"] == "failed"
+    assert report["error_details"]["phase"] == "transcript_load"
+    assert report["error_details"]["type"] == "RuntimeError"
+    assert "RuntimeError: boom" in (run_dir / "error.log").read_text(encoding="utf-8")