feat(search): add opt-in fuzzy matching to cross-session search

package.json

@@ -57,6 +57,7 @@
     "date-fns": "^3.6.0",
     "electron-updater": "^6.7.3",
     "fastify": "^5.7.4",
+    "fuse.js": "^7.4.2",
     "idb-keyval": "^6.2.2",
     "lucide-react": "^0.562.0",
     "mdast-util-to-hast": "^13.2.1",

src/main/http/search.ts

@@ -23,7 +23,7 @@ const logger = createLogger('HTTP:search');
 export function registerSearchRoutes(app: FastifyInstance, services: HttpServices): void {
   app.get<{
     Params: { projectId: string };
-    Querystring: { q?: string; maxResults?: string };
+    Querystring: { q?: string; maxResults?: string; fuzzy?: string };
   }>('/api/projects/:projectId/search', async (request) => {
     const query = request.query.q ?? '';
 
@@ -45,7 +45,8 @@ export function registerSearchRoutes(app: FastifyInstance, services: HttpService
       const result = await services.projectScanner.searchSessions(
         validatedProject.value!,
         validatedQuery.value!,
-        maxResults
+        maxResults,
+        request.query.fuzzy === '1' || request.query.fuzzy === 'true'
       );
       return result;
     } catch (error) {
@@ -55,7 +56,7 @@ export function registerSearchRoutes(app: FastifyInstance, services: HttpService
   });
 
   app.get<{
-    Querystring: { q?: string; maxResults?: string };
+    Querystring: { q?: string; maxResults?: string; fuzzy?: string };
   }>('/api/search', async (request) => {
     const query = request.query.q ?? '';
 
@@ -73,7 +74,8 @@ export function registerSearchRoutes(app: FastifyInstance, services: HttpService
 
       const result = await services.projectScanner.searchAllProjects(
         validatedQuery.value!,
-        maxResults
+        maxResults,
+        request.query.fuzzy === '1' || request.query.fuzzy === 'true'
       );
       return result;
     } catch (error) {

src/main/ipc/search.ts

@@ -72,7 +72,8 @@ async function handleSearchSessions(
   _event: IpcMainInvokeEvent,
   projectId: string,
   query: string,
-  maxResults?: number
+  maxResults?: number,
+  fuzzy?: boolean
 ): Promise<SearchSessionsResult> {
   try {
     const validatedProject = validateProjectId(projectId);
@@ -89,7 +90,8 @@ async function handleSearchSessions(
     const result = await projectScanner.searchSessions(
       validatedProject.value!,
       validatedQuery.value!,
-      safeMaxResults
+      safeMaxResults,
+      fuzzy === true
     );
     return result;
   } catch (error) {
@@ -105,7 +107,8 @@ async function handleSearchSessions(
 async function handleSearchAllProjects(
   _event: IpcMainInvokeEvent,
   query: string,
-  maxResults?: number
+  maxResults?: number,
+  fuzzy?: boolean
 ): Promise<SearchSessionsResult> {
   try {
     const validatedQuery = validateSearchQuery(query);
@@ -116,7 +119,11 @@ async function handleSearchAllProjects(
 
     const { projectScanner } = registry.getActive();
     const safeMaxResults = coerceSearchMaxResults(maxResults, 50);
-    const result = await projectScanner.searchAllProjects(validatedQuery.value!, safeMaxResults);
+    const result = await projectScanner.searchAllProjects(
+      validatedQuery.value!,
+      safeMaxResults,
+      fuzzy === true
+    );
     return result;
   } catch (error) {
     logger.error('Error in search-all-projects:', error);

src/main/services/discovery/ProjectScanner.ts

@@ -1096,9 +1096,10 @@ export class ProjectScanner {
   async searchSessions(
     projectId: string,
     query: string,
-    maxResults: number = 50
+    maxResults: number = 50,
+    fuzzy: boolean = false
   ): Promise<SearchSessionsResult> {
-    return this.sessionSearcher.searchSessions(projectId, query, maxResults);
+    return this.sessionSearcher.searchSessions(projectId, query, maxResults, fuzzy);
   }
 
   /**
@@ -1108,7 +1109,11 @@ export class ProjectScanner {
    * @param query - Search query string
    * @param maxResults - Maximum number of results to return (default 50)
    */
-  async searchAllProjects(query: string, maxResults: number = 50): Promise<SearchSessionsResult> {
+  async searchAllProjects(
+    query: string,
+    maxResults: number = 50,
+    fuzzy: boolean = false
+  ): Promise<SearchSessionsResult> {
     const startedAt = Date.now();
     try {
       if (!query || query.trim().length === 0) {
@@ -1138,7 +1143,9 @@ export class ProjectScanner {
       for (let i = 0; i < projects.length; i += searchBatchSize) {
         const batch = projects.slice(i, i + searchBatchSize);
         const batchResults = await Promise.allSettled(
-          batch.map((project) => this.sessionSearcher.searchSessions(project.id, query, maxResults))
+          batch.map((project) =>
+            this.sessionSearcher.searchSessions(project.id, query, maxResults, fuzzy)
+          )
         );
 
         for (const result of batchResults) {
@@ -1147,9 +1154,7 @@ export class ProjectScanner {
           }
         }
 
-        // Check if we have enough results already
-        const totalMatches = allResults.reduce((sum, r) => sum + r.totalMatches, 0);
-        if (totalMatches >= maxResults) {
+        if (!fuzzy && allResults.reduce((sum, r) => sum + r.totalMatches, 0) >= maxResults) {
           break;
         }
       }
@@ -1158,8 +1163,11 @@ export class ProjectScanner {
       const mergedResults = allResults.flatMap((r) => r.results);
       const totalSessionsSearched = allResults.reduce((sum, r) => sum + r.sessionsSearched, 0);
 
-      // Sort by timestamp (most recent first) and limit to maxResults
-      mergedResults.sort((a, b) => b.timestamp - a.timestamp);
+      mergedResults.sort((a, b) =>
+        fuzzy
+          ? (a.matchScore ?? 1) - (b.matchScore ?? 1) || b.timestamp - a.timestamp
+          : b.timestamp - a.timestamp
+      );
       const limitedResults = mergedResults.slice(0, maxResults);
 
       logger.debug(