Scan root folders automatically, add a Library Import page, fix release-name matching

client/__tests__/AppSidebar.test.tsx

@@ -60,4 +60,10 @@ describe("AppSidebar library counts", () => {
     expect(screen.queryByTestId("badge-playing")).not.toBeInTheDocument();
     expect(screen.getByRole("button", { name: "Playing" })).toBeInTheDocument();
   });
+
+  it("lists Library Import under Library", () => {
+    renderSidebar([]);
+
+    expect(screen.getByRole("button", { name: "Library Import" })).toBeInTheDocument();
+  });
 });

client/__tests__/MobileBottomNav.test.tsx

@@ -15,6 +15,7 @@ vi.mock("lucide-react", () => {
     Compass: Icon,
     Database: Icon,
     Download: Icon,
+    FolderInput: Icon,
     Gamepad2: Icon,
     HardDrive: Icon,
     Home: Icon,

client/__tests__/RootFolderDiscovery.test.tsx

@@ -1,6 +1,6 @@
 /** @vitest-environment jsdom */
 import React from "react";
-import { fireEvent, render, screen, waitFor } from "@testing-library/react";
+import { act, fireEvent, render, screen, waitFor } from "@testing-library/react";
 import "@testing-library/jest-dom";
 import { QueryClientProvider } from "@tanstack/react-query";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
@@ -9,6 +9,11 @@ import { createTestQueryClient, getRequestUrl } from "./test-utils";
 import { RootFolderDiscovery } from "../src/components/RootFolderDiscovery";
 import type { RootFolder } from "@shared/schema";
 
+const mockSocket = vi.hoisted(() => ({ on: vi.fn(), off: vi.fn() }));
+vi.mock("@/lib/socket", () => ({
+  getSocket: () => mockSocket,
+}));
+
 const mockToast = vi.fn();
 vi.mock("@/hooks/use-toast", () => ({
   useToast: () => ({ toast: mockToast }),
@@ -67,6 +72,147 @@ describe("RootFolderDiscovery", () => {
     vi.restoreAllMocks();
   });
 
+  it("refreshes the library and Needs Review list once scan progress is known", async () => {
+    mockFetch(
+      [folder],
+      [
+        {
+          rootFolderId: "rf-1",
+          rootFolderPath: "/mnt/old-library",
+          startedAt: new Date().toISOString(),
+          finishedAt: new Date().toISOString(),
+          status: "completed",
+          totalCandidates: 3,
+          processedCandidates: 3,
+          matched: 2,
+          unmatched: 1,
+          errors: 0,
+        },
+      ]
+    );
+    const client = createTestQueryClient();
+    const invalidate = vi.spyOn(client, "invalidateQueries");
+    render(
+      <QueryClientProvider client={client}>
+        <RootFolderDiscovery />
+      </QueryClientProvider>
+    );
+
+    await waitFor(() => expect(invalidate).toHaveBeenCalledWith({ queryKey: ["/api/games"] }));
+    expect(invalidate).toHaveBeenCalledWith({ queryKey: ["/api/library/scan/unmatched"] });
+  });
+
+  it("keeps polling scan status after Scan All even if the first status is empty", async () => {
+    // The first status fetch lands before the server registers the scan.
+    let statusCalls = 0;
+    vi.spyOn(globalThis, "fetch").mockImplementation(async (url: RequestInfo | URL) => {
+      const u = getRequestUrl(url);
+      if (u.includes("/api/library/scan/status")) {
+        statusCalls += 1;
+        return createJsonResponse(
+          statusCalls === 1
+            ? []
+            : [
+                {
+                  rootFolderId: "rf-1",
+                  rootFolderPath: "/mnt/old-library",
+                  startedAt: new Date().toISOString(),
+                  status: "running",
+                  totalCandidates: 3,
+                  processedCandidates: 1,
+                  matched: 1,
+                  unmatched: 0,
+                  errors: 0,
+                },
+              ]
+        );
+      }
+      if (u.includes("/api/root-folders")) return createJsonResponse([folder]);
+      return createJsonResponse([]);
+    });
+    const client = createTestQueryClient();
+    const invalidate = vi.spyOn(client, "invalidateQueries");
+    render(
+      <QueryClientProvider client={client}>
+        <RootFolderDiscovery />
+      </QueryClientProvider>
+    );
+    fireEvent.click(await screen.findByRole("button", { name: /scan all/i }));
+
+    await waitFor(() => expect(statusCalls).toBeGreaterThan(1), { timeout: 4000 });
+    await waitFor(() => expect(invalidate).toHaveBeenCalledWith({ queryKey: ["/api/games"] }));
+  });
+
+  it("shows scan progress pushed by the server without waiting for a poll", async () => {
+    mockFetch([folder]);
+    renderComponent();
+    await screen.findByText("/mnt/old-library");
+
+    const handler = mockSocket.on.mock.calls.find(
+      ([event]) => event === "library-scan-progress"
+    )?.[1];
+    expect(handler).toBeDefined();
+    act(() => {
+      handler({
+        rootFolderId: "rf-1",
+        rootFolderPath: "/mnt/scan-pushed",
+        startedAt: new Date().toISOString(),
+        status: "running",
+        totalCandidates: 4,
+        processedCandidates: 1,
+        matched: 1,
+        unmatched: 0,
+        errors: 0,
+      });
+    });
+
+    expect(await screen.findByText("/mnt/scan-pushed")).toBeInTheDocument();
+    expect(screen.getByText("running")).toBeInTheDocument();
+  });
+
+  it("lets the user search IGDB under their own name when no candidate fits", async () => {
+    const { apiRequest } = await import("@/lib/queryClient");
+    mockFetch(
+      [folder],
+      [],
+      [
+        {
+          rootFolderId: "rf-1",
+          rootFolderPath: "/mnt/old-library",
+          folderName: "Absolum v1.01 [CUSA53342] [EUR]",
+          absolutePath: "/mnt/old-library/Absolum v1.01 [CUSA53342] [EUR]",
+          candidates: [{ igdbId: 314, name: "Wrong Game", releaseYear: 2001 }],
+        },
+      ]
+    );
+    vi.mocked(apiRequest).mockResolvedValueOnce({
+      json: async () => [{ igdbId: 777, name: "Absolum", releaseYear: 2025 }],
+    } as Response);
+    renderComponent();
+
+    const input = await screen.findByLabelText("Search IGDB for Absolum v1.01 [CUSA53342] [EUR]");
+    fireEvent.change(input, { target: { value: "Absolum" } });
+    fireEvent.click(screen.getByRole("button", { name: "Search" }));
+
+    await waitFor(() =>
+      expect(apiRequest).toHaveBeenCalledWith("POST", "/api/library/scan/unmatched/search", {
+        rootFolderId: "rf-1",
+        folderName: "Absolum v1.01 [CUSA53342] [EUR]",
+        query: "Absolum",
+      })
+    );
+    // The searched result replaces the scan's guess and can be picked.
+    fireEvent.click(await screen.findByRole("button", { name: "Absolum (2025)" }));
+    expect(screen.queryByRole("button", { name: "Wrong Game (2001)" })).not.toBeInTheDocument();
+    await waitFor(() =>
+      expect(apiRequest).toHaveBeenCalledWith("POST", "/api/library/scan/unmatched/match", {
+        rootFolderId: "rf-1",
+        folderName: "Absolum v1.01 [CUSA53342] [EUR]",
+        igdbId: 777,
+      })
+    );
+  });
+
   it("shows an empty state when there are no root folders", async () => {
     renderComponent();
     expect(await screen.findByText("No root folders configured yet")).toBeInTheDocument();

client/src/App.tsx

@@ -32,6 +32,7 @@ const NotFound = lazy(() => import("@/pages/not-found"));
 const CalendarPage = lazy(() => import("@/pages/calendar"));
 const WishlistPage = lazy(() => import("@/pages/wishlist"));
 const PlayingPage = lazy(() => import("@/pages/playing"));
+const LibraryImportPage = lazy(() => import("@/pages/library-import"));
 const XrelReleasesPage = lazy(() => import("@/pages/xrel-releases"));
 const RssPage = lazy(() => import("@/pages/rss"));
 const LoginPage = lazy(() => import("@/pages/auth/login"));
@@ -132,6 +133,7 @@ function Router() {
         <Route path={routePaths.calendar} component={CalendarPage} />
         <Route path={routePaths.wishlist} component={WishlistPage} />
         <Route path={routePaths.playing} component={PlayingPage} />
+        <Route path={routePaths.libraryImport} component={LibraryImportPage} />
         <Route path={routePaths.xrel} component={XrelReleasesPage} />
         <Route path={routePaths.rss} component={RssPage} />
         <Route path={routePaths.stats} component={StatsPage} />

client/src/components/ImportSettings.tsx

@@ -21,7 +21,6 @@ import type { ImportConfig, UserSettings } from "@shared/schema";
 import { selectedPlatformNames as resolveSelectedPlatformNames } from "@shared/platforms";
 import { PathMappingSettings } from "./PathMappingSettings";
 import { FileBrowser } from "./FileBrowser";
-import { RootFolderDiscovery } from "./RootFolderDiscovery";
 import SecurityScanSettings from "./SecurityScanSettings";
 
 type HardlinkPairCheck = {
@@ -104,10 +103,21 @@ export default function ImportSettings() {
       const { importPlatformIds: _unused, ...rest } = data;
       await apiRequest("PATCH", "/api/imports/config", rest);
     },
-    onSuccess: () => {
-      toast({ title: "Settings Saved", description: "Import configuration updated." });
+    onSuccess: (_data, saved) => {
+      // Switching post-processing on starts a scan of every enabled root folder.
+      const scanStarted = saved.enablePostProcessing && !config?.enablePostProcessing;
+      toast({
+        title: "Settings Saved",
+        description: scanStarted
+          ? "Import configuration updated. Scanning your root folders for games now."
+          : "Import configuration updated.",
+      });
       queryClient.invalidateQueries({ queryKey: ["/api/imports/config"] });
       queryClient.invalidateQueries({ queryKey: ["/api/imports/hardlink/check"] });
+      if (scanStarted) {
+        queryClient.invalidateQueries({ queryKey: ["/api/library/scan/status"] });
+        queryClient.invalidateQueries({ queryKey: ["/api/library/scan/unmatched"] });
+      }
     },
     onError: () => {
       if (config) setLocalConfig(config);
@@ -134,7 +144,6 @@ export default function ImportSettings() {
           <TabsTrigger value="config">General Config</TabsTrigger>
           <TabsTrigger value="paths">Path Mappings</TabsTrigger>
           <TabsTrigger value="security">Security & Scanning</TabsTrigger>
-          <TabsTrigger value="discover">Discover</TabsTrigger>
           <TabsTrigger value="help">Help</TabsTrigger>
         </TabsList>
 
@@ -379,10 +388,6 @@ export default function ImportSettings() {
           <SecurityScanSettings />
         </TabsContent>
 
-        <TabsContent value="discover" className="space-y-4">
-          <RootFolderDiscovery />
-        </TabsContent>
-
         <TabsContent value="help" className="space-y-4">
           <Card>
             <CardContent className="pt-6 space-y-6 text-sm">