test(gui_2): add 2 Phase 12 invariant tests + Phase 12 checkpoint

Two Phase 12 invariant tests in tests/test_gui_2_result.py verify
UNCLEAR count for src/gui_2.py is 0 after the lazy-loading sentinel
fallback heuristic:

- test_phase_12_invariant_unclear_count_zero: scans audit --json
  output, asserts 0 UNCLEAR findings in gui_2.py (the 2 lazy-loading
  sites in _LazyModule._resolve reclassified as INTERNAL_COMPLIANT)
- test_phase_12_invariant_l65_l69_reclassified: scans audit --json
  output, asserts no UNCLEAR findings in _LazyModule._resolve
  method context

State.toml updates:
- phase_12 status: completed, checkpointsha: f996aa10
- phase_12_complete: true
- unclear_count_zero: true
- t12_0/t12_1/t12_2 marked completed with their commit SHAs

Pre-Phase 12: gui_2.py had 2 UNCLEAR sites (L65 + L69 in
_LazyModule._resolve). Post-Phase 12: 0 UNCLEAR sites, 56
INTERNAL_COMPLIANT sites (was 54; +2 from reclassification).

Phase 12 result_migration_gui_2_20260619.

conductor/tracks/result_migration_gui_2_20260619/state.toml

@@ -30,7 +30,7 @@ phase_8 = { status = "completed", checkpointsha = "7ec512c", name = "Property se
 phase_9 = { status = "completed", checkpointsha = "6b02f49", name = "Helper / utility sites (<=5 sites) — 0 sites in this track (L1398 is SILENT_SWALLOW, Phase 10)" }
 phase_10 = { status = "completed", checkpointsha = "df481f7", name = "INTERNAL_SILENT_SWALLOW migrations (<=13 sites; logging NOT a drain)" }
 phase_11 = { status = "completed", checkpointsha = "6e03f5a", name = "INTERNAL_RETHROW classification (audit heuristic fix)" }
-phase_12 = { status = "pending", checkpointsha = "", name = "UNCLEAR classification (<=2 sites)" }
+phase_12 = { status = "completed", checkpointsha = "f996aa10", name = "UNCLEAR classification (lazy-loading fallback heuristic)" }
 phase_13 = { status = "pending", checkpointsha = "", name = "Audit gate + end-of-track report (5 tasks; --strict exits 0; 11/11 tiers PASS)" }
 
 [tasks]
@@ -151,11 +151,11 @@ t11_1 = { status = "completed", commit_sha = "6e03f5ae", description = "Add dund
 t11_2 = { status = "completed", commit_sha = "a5a06f85", description = "Add 5 regression-guard tests in tests/test_audit_heuristics.py" }
 t11_3 = { status = "in_progress", commit_sha = "", description = "Add Phase 11 invariant test; Phase 11 checkpoint" }
 
-# Phase 12: UNCLEAR classification (<=2)
-t12_0 = { status = "pending", commit_sha = "", description = "Phase 12 styleguide re-read + ack commit" }
-t12_1 = { status = "pending", commit_sha = "", description = "Classify UNCLEAR site 1 (or migrate if non-compliant)" }
-t12_2 = { status = "pending", commit_sha = "", description = "Classify UNCLEAR site 2" }
-t12_3 = { status = "pending", commit_sha = "", description = "Add Phase 12 invariant test; Phase 12 checkpoint" }
+# Phase 12: UNCLEAR classification (<=2) — lazy-loading sentinel fallback heuristic
+t12_0 = { status = "completed", commit_sha = "4edd6a95", description = "Phase 12 styleguide re-read (Re-Raise Patterns lines 625-690 + lazy-loading fallback guidance) + ack commit" }
+t12_1 = { status = "completed", commit_sha = "f996aa10", description = "Add lazy-loading sentinel fallback heuristic to scripts/audit_exception_handling.py:_try_compliant_pattern (reclassifies the 2 sites in _LazyModule._resolve as INTERNAL_COMPLIANT)" }
+t12_2 = { status = "completed", commit_sha = "28a55ea5", description = "Add 3 regression-guard tests in tests/test_audit_heuristics.py" }
+t12_3 = { status = "completed", commit_sha = "", description = "Add Phase 12 invariant test; Phase 12 checkpoint" }
 
 # Phase 13: Audit gate + end-of-track report (5 tasks)
 t13_1 = { status = "pending", commit_sha = "", description = "Run audit --src src/gui_2.py --strict; verify exit 0" }
@@ -177,7 +177,7 @@ phase_8_complete = false
 phase_9_complete = false
 phase_10_complete = true
 phase_11_complete = true
-phase_12_complete = false
+phase_12_complete = true
 phase_13_complete = false
 audit_strict_exits_0 = false
 batched_suite_11_of_11_pass = false
@@ -185,5 +185,5 @@ site_inventory_has_42_rows = true
 drain_plane_render_functions_exist = true
 silent_swallow_count_zero = true
 rethrow_count_zero = true
-unclear_count_zero = false
+unclear_count_zero = true
 broad_catch_count_zero = false

tests/test_gui_2_result.py

@@ -2478,3 +2478,93 @@ def test_phase_11_invariant_l757_l760_reclassified():
   f"__setattr__/__delattr__); found {len(rethrows)}. "
   f"Sites: {[(f.get('line'), f.get('context'), f.get('snippet')) for f in rethrows]}"
  )
+
+
+# =============================================================================
+# Phase 12 Invariant Tests (result_migration_gui_2_20260619)
+# Lock the UNCLEAR count: 2 sites in _LazyModule._resolve (L65, L69) reclassified
+# as INTERNAL_COMPLIANT via the lazy-loading sentinel fallback heuristic in
+# scripts/audit_exception_handling.py:_try_compliant_pattern (heuristic B).
+# The 2 sites are the lazy-loading sentinel fallback pattern in src/gui_2.py
+# where a proxy class defers a heavy import (numpy, tkinter, etc.) and falls
+# back to a documented sentinel class instance (_FiledialogStub) with an
+# `available: bool = False` flag when the import or attribute access fails.
+# Per the styleguide (error_handling.md:625-690, Re-Raise Patterns) and the
+# lazy-loading pattern guidance, this is the canonical graceful-degradation
+# pattern — NOT silent sliming.
+# =============================================================================
+
+
+def test_phase_12_invariant_unclear_count_zero():
+ """
+ Phase 12 invariant: the audit's UNCLEAR count for src/gui_2.py is now 0.
+ The 2 sites in _LazyModule._resolve (L65, L69) have been reclassified as
+ INTERNAL_COMPLIANT via the new lazy-loading sentinel fallback heuristic
+ in scripts/audit_exception_handling.py:_try_compliant_pattern (heuristic B).
+
+ The heuristic recognizes the canonical pattern:
+   - Enclosing function is in LAZY_LOADER_METHOD_NAMES
+     ({_resolve, _load, _get, _try_load}) — the standard naming for
+     proxy classes that defer a heavy import until first use.
+   - The except body does NOT re-raise.
+   - The except set is in {AttributeError, ImportError, ModuleNotFoundError}.
+   - The except body assigns to a self.<attr> (directly or via nested try).
+
+ Pre-Phase 12 baseline: 2. Post-Phase 12 baseline: 0.
+ """
+ result = subprocess.run(
+  ["uv", "run", "python", "scripts/audit_exception_handling.py", "--src", "src", "--json"],
+  capture_output=True,
+  text=True,
+ )
+ assert result.returncode == 0, (
+  f"audit_exception_handling.py exited {result.returncode}; stderr:\n"
+  f"{result.stderr[:2000]}"
+ )
+ data = json.loads(result.stdout)
+ gui2 = [f for f in data.get("files", []) if "gui_2" in f.get("filename", "")][0]
+ unclear = [f for f in gui2.get("findings", []) if f.get("category") == "UNCLEAR"]
+ assert len(unclear) == 0, (
+  f"Phase 12 invariant: expected 0 UNCLEAR sites in src/gui_2.py "
+  f"(post-Phase 12 baseline; the 2 lazy-loading sentinel fallback sites "
+  f"in _LazyModule._resolve reclassified as INTERNAL_COMPLIANT); "
+  f"found {len(unclear)}. "
+  f"Lines: {[f.get('line') for f in unclear]}"
+ )
+
+
+def test_phase_12_invariant_l65_l69_reclassified():
+ """
+ Phase 12 invariant: the 2 lazy-loading sentinel fallback sites at L65 and
+ L69 in src/gui_2.py (the _LazyModule._resolve method) are no longer UNCLEAR.
+
+ The heuristic reclassifies except sites in methods named
+ _resolve/_load/_get/_try_load that fall back to a documented sentinel
+ class instance as INTERNAL_COMPLIANT. The audit must NOT report the
+ _LazyModule._resolve sites (L65, L69) as UNCLEAR after Phase 12.
+
+ Note: the line numbers may shift with future edits to src/gui_2.py.
+ This test scans ALL gui_2.py findings and asserts that no finding in
+ the _LazyModule._resolve method context is UNCLEAR.
+ """
+ result = subprocess.run(
+  ["uv", "run", "python", "scripts/audit_exception_handling.py", "--src", "src", "--json"],
+  capture_output=True,
+  text=True,
+ )
+ assert result.returncode == 0, (
+  f"audit_exception_handling.py exited {result.returncode}; stderr:\n"
+  f"{result.stderr[:2000]}"
+ )
+ data = json.loads(result.stdout)
+ gui2 = [f for f in data.get("files", []) if "gui_2" in f.get("filename", "")][0]
+ unclear_in_resolve = [
+  f for f in gui2.get("findings", [])
+  if f.get("category") == "UNCLEAR"
+  and f.get("context") == "_resolve"
+ ]
+ assert len(unclear_in_resolve) == 0, (
+  f"Phase 12 invariant: expected 0 UNCLEAR findings in "
+  f"_LazyModule._resolve method context; found {len(unclear_in_resolve)}. "
+  f"Sites: {[(f.get('line'), f.get('context'), f.get('snippet')) for f in unclear_in_resolve]}"
+ )