Improve IK-style artifact scanner pipeline

src/features/scan/hooks/useScanViewController.ts

@@ -14,6 +14,7 @@ import { useScanSnapshotPublisher } from "./useScanSnapshotPublisher";
 import { useScanViewActions } from "./useScanViewActions";
 import { useScanViewStateSync } from "./useScanViewStateSync";
 import { emptyAutoScanStats, resolveScanTargetCount, type AutoScanStats, type ScanSummary } from "../../../lib/scannerSession";
+import { createScanDiagnosticEvent, summarizeClickResult, type ScanDiagnosticEvent } from "../../../lib/scanDiagnosticsLog";
 import type { ScanViewProps, ScanViewControllerResult } from "../types";
 import type { CaptureResult, ClickResult, ReviewSampleRecord } from "../../../types/global";
 import type { StoredArtifactRecord } from "../../../types/storage";
@@ -56,6 +57,7 @@ export function useScanViewController({
   const [scanLimitTouched, setScanLimitTouched] = useState(false);
   const [skipRows, setSkipRows] = useState(0);
   const [automationLog, setAutomationLog] = useState<string[]>([]);
+  const [diagnosticEvents, setDiagnosticEvents] = useState<ScanDiagnosticEvent[]>([]);
   const [storedTotal, setStoredTotal] = useState<number | null>(null);
   const [devMode, setDevMode] = useState(() => localStorage.getItem("gaa-dev-mode") === "1");
   const [scannerLearningRules, setScannerLearningRules] = useState<ScannerLearningRules>({ textReplacements: {} });
@@ -92,12 +94,28 @@ export function useScanViewController({
     setAutomationLog((previous) => [...previous.slice(-11), `${new Date().toLocaleTimeString()} ${line}`]);
   }, []);
 
+  const appendDiagnosticEvent = useCallback((event: Omit<Parameters<typeof createScanDiagnosticEvent>[0], "includeFullScreenshot">) => {
+    setDiagnosticEvents((previous) => [
+      ...previous.slice(-23),
+      createScanDiagnosticEvent({
+        ...event,
+        includeFullScreenshot: false,
+      }),
+    ]);
+  }, []);
+
   const appendClickDiagnostics = useCallback((result: ClickResult, prefix = "input") => {
     const cursor = `${result.cursorX ?? "?"},${result.cursorY ?? "?"}`;
     const focus = result.focused ? `fg:${result.foregroundProcess || "Genshin"}` : `fg-miss:${result.foregroundProcess || "?"}`;
     const blocked = result.inputBlocked ? " input:blocked" : "";
     appendAutomationLog(`${prefix}: ${focus}${blocked} cursor ${cursor} moved:${result.moved ? "yes" : "no"} clicked:${result.clicked ? "yes" : "no"}`);
-  }, [appendAutomationLog]);
+    appendDiagnosticEvent({
+      phase: "input",
+      severity: result.inputBlocked || result.clicked === false || result.moved === false ? "warn" : "ok",
+      message: `${prefix}: click ${result.clicked ? "sent" : "not sent"}`,
+      details: summarizeClickResult(result),
+    });
+  }, [appendAutomationLog, appendDiagnosticEvent]);
 
   const toggleDevMode = useCallback(() => {
     setDevMode((previous) => {
@@ -118,6 +136,7 @@ export function useScanViewController({
     loadReviewQueue: loadReviewQueueAction,
     openReviewQueue: openReviewQueueModal,
     runAutoReviewScan,
+    runGuidedAutoScan,
     runVisibleGridScan,
   } = useScanViewActions({
     autoScanRunning,
@@ -137,6 +156,7 @@ export function useScanViewController({
     setReviewStatus,
     appendAutomationLog,
     appendClickDiagnostics,
+    appendDiagnosticEvent,
     parseArtifact,
     artifactRepo,
     reviewSamplesRepo,
@@ -209,6 +229,7 @@ export function useScanViewController({
     snapshot,
     latestInventoryGrid: latestCapture?.inventoryGrid ?? null,
     automationLog,
+    diagnosticEvents,
     runtimeInfo,
     storedTotal,
     learningRuleCount,
@@ -230,6 +251,7 @@ export function useScanViewController({
     scanLimitTouched,
     skipRows,
     automationLog,
+    diagnosticEvents,
     storedTotal,
     devMode,
     scannerLearningRules,
@@ -267,6 +289,7 @@ export function useScanViewController({
     loadReviewQueue: loadReviewQueueAction,
     openReviewQueue: openReviewQueueModal,
     runAutoReviewScan,
+    runGuidedAutoScan,
     runVisibleGridScan,
     canGoodInterop,
     exportGoodFromStore,