Improve IK-style artifact scanner pipeline

docs/DECISIONS.md

@@ -16,6 +16,7 @@ This document contains Architecture Decision Records.
 | ADR-008 | Replace the PowerShell input/capture helper with a C# sidecar | Accepted | 2026-07-05 |
 | ADR-009 | Resolution-anchored layout profiles and OCR preprocessing over color detection | Accepted | 2026-07-05 |
 | ADR-010 | Elevated dev runner and bounded live automation probes | Accepted | 2026-07-07 |
+| ADR-011 | Quality-gated Inventory Kamera comparison before OCR default changes | Accepted | 2026-07-07 |
 
 ## ADR-001: Build A Local Electron App First
 
@@ -286,3 +287,49 @@ Document the workflow in [AUTOMATION_LIVE_SCAN.md](AUTOMATION_LIVE_SCAN.md).
 - The implementation remains inside the allowed safety boundary: no memory
   reads, hooks, injection, game-file modification, deleting, feeding, enhancing,
   locking/unlocking, or spending resources.
+
+## ADR-011: Quality-Gated Inventory Kamera Comparison Before OCR Default Changes
+
+### Status
+
+Accepted
+
+### Context
+
+The product target is not merely to click through 100 artifacts quickly. It is
+to scan the first 100 artifacts with accuracy at least as good as Inventory
+Kamera and speed equal to or better than Inventory Kamera. A faster scan that
+creates too many misses, review samples, or false positives is worse than a
+slower qualified run.
+
+The app can now compare the current OCR path with Inventory Kamera's
+`genshin_fast_09_04_21.traineddata` through the same visible crop set. It also
+has hot-loop timing fields for capture, OCR, card readiness, scroll readiness,
+active scan time, and projected 100-artifact time.
+
+### Decision
+
+Use a quality-gated live soak and benchmark before changing the default OCR
+engine or claiming IK parity. A qualified scan result must:
+
+- finish cleanly,
+- parse at least the requested count,
+- keep miss rate at or below 2%,
+- keep review rate at or below 15%,
+- report active scan timing and bottlenecks,
+- come from a runtime whose `/health.appBuild.signature` matches the current
+  source.
+
+`scripts/live-soak.ps1` writes the evidence bundle and
+`scan-performance-assessment.json`. `npm run scan:assessment:test` verifies that
+the ranking logic rejects fast but low-quality synthetic runs without needing
+Genshin.
+
+### Consequences
+
+- Speed claims cannot be based on click count or elapsed time alone.
+- A new OCR engine cannot become the default just because it is theoretically
+  closer to IK; it must win the same-capture benchmark and a qualified live run.
+- Stale elevated Electron instances are treated as invalid evidence, not as a
+  harmless warning.
+- The goal remains open until the 100-artifact qualified comparison is captured.