Prepare scanner branch for merge

src/features/scan/hooks/useScanViewActions.ts

@@ -5,6 +5,7 @@ import {
   initializeLearningState,
   loadReviewQueue as loadReviewQueueFromRepo,
   persistParsedArtifact as persistParsedArtifactHelper,
+  persistParsedArtifactsBatch as persistParsedArtifactsBatchHelper,
   saveReviewSample as saveReviewSampleHelper,
 } from "./scanViewReviewHelpers";
 import { createReviewContext, createScanActionContext } from "./scanViewControllerService";
@@ -186,6 +187,15 @@ export function useScanViewActions(input: ScanViewActionInput): ScanViewActionRe
     [reviewContext],
   );
 
+  const parseArtifactsAndPersistBatch = useCallback(
+    async function parseArtifactsAndPersistBatch(
+      items: Array<{ capture: CaptureResult | null; parsed: ParsedArtifactCandidate; source: string; needsReview: boolean }>,
+    ) {
+      return persistParsedArtifactsBatchHelper(items, reviewContext);
+    },
+    [reviewContext],
+  );
+
   const handleSaveReviewSample = useCallback(
     async function handleSaveReviewSample(
       capture: CaptureResult | null = latestCapture,
@@ -227,6 +237,7 @@ export function useScanViewActions(input: ScanViewActionInput): ScanViewActionRe
         appendDiagnosticEvent,
         parseArtifact,
         persistParsedArtifact: parseArtifactAndPersist,
+        persistParsedArtifactsBatch: parseArtifactsAndPersistBatch,
         saveReviewSample: handleSaveReviewSample,
         focusDashboard,
         captureSelectedSource: (delayMs = 0, focusGenshin = false, options) => captureSelectedSource(delayMs, focusGenshin, {
@@ -265,6 +276,7 @@ export function useScanViewActions(input: ScanViewActionInput): ScanViewActionRe
       appendDiagnosticEvent,
       parseArtifact,
       parseArtifactAndPersist,
+      parseArtifactsAndPersistBatch,
       handleSaveReviewSample,
       focusDashboard,
       captureSelectedSource,
@@ -317,13 +329,17 @@ export function useScanViewActions(input: ScanViewActionInput): ScanViewActionRe
       severity: visibleInventoryReady ? "ok" : "info",
       message: visibleInventoryReady
         ? "Artifact inventory detail view already visible; starting scan directly."
-        : "Artifact detail view is not ready; trying direct inventory entry, then Inventory Kamera fallback.",
+        : "Artifact detail view is not ready; guided scan waits for a visible artifact detail card instead of navigating.",
       capture: preflightCapture,
     });
+    if (!visibleInventoryReady) {
+      setReviewStatus("Auto-Scan wartet: Bitte Artifact-Inventar mit sichtbarer Detailkarte oeffnen und erneut starten.");
+      return;
+    }
     await runVisibleGridScanAction(scanActionContext, {
       scanLimit: options.scanLimit,
-      scanEntryMode: visibleInventoryReady ? "visible-inventory" : "auto-entry",
-      processInitialSelection: visibleInventoryReady,
+      scanEntryMode: "visible-inventory",
+      processInitialSelection: true,
       ocrEngine: options.ocrEngine,
     });
   }, [