scai 0.1.178 → 1.0.0

package/dist/agent/search/laneClassifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"laneClassifier.js","sourceRoot":"","sources":["../../../src/agent/search/laneClassifier.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9E;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAA2B;IACxE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC9E,IAAI,mBAAmB,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,cAAc,GAAG,yCAAyC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,kCAAkC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvE,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACvH,MAAM,kBAAkB,GAAG,oDAAoD,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9F,OAAO,cAAc,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,IAAI,CAAC,kBAAkB,CAAC;AACnF,CAAC;AAED,SAAS,2BAA2B,CAAC,OAA2B;IAC9D,OAAO,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,iBAAiB,CAAC,EAAE,UAAU,CAAC;AACzG,CAAC;AAED,SAAS,yBAAyB,CAAC,OAA2B;IAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;IACvG,IAAI,YAAY,EAAE,IAAI,KAAK,eAAe,EAAE,CAAC;QAC3C,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACtD,OAAO,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/E,OAAO,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,2BAA2B,CAAC,OAA2B;IAC9D,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,2BAA2B,CAAC,OAAO,CAAC,IAAI,yBAAyB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,0BAA0B,CAAC,OAA2B;IAC7D,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAClG,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,YAAY,GAAG,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC;QACzD,2HAA2H,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5I,MAAM,oBAAoB,GAAG,yCAAyC,CAAC,IAAI,CAAC,OAAO,CAAC;QAClF,iEAAiE,CAAC,IAAI,CAAC,OAAO,CAAC;QAC/E,gEAAgE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjF,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,KAAK,YAAY,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC;IACzF,OAAO,UAAU,IAAI,CAAC,YAAY,IAAI,oBAAoB,CAAC,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA2B;IAC5D,MAAM,cAAc,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,cAAc,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACjD,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,iCAAiC;YACzC,cAAc,EAAE,cAAc;SAC/B,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,kBAAkB,IAAI,8BAA8B,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1E,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,kDAAkD;YAC1D,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAAC;mBACtD,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,mBAAmB,CAAC;SACvD,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,4CAA4C;YACpD,cAAc,EAAE,YAAY;SAC7B,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,sCAAsC;SAC/C,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAChD,OAAO;YACL,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,0CAA0C;SACnD,CAAC;IACJ,CAAC;IAED,IAAI,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,4DAA4D;YACpE,cAAc,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,IAAI,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,kDAAkD;SAC3D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,kCAAkC;KAC3C,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Owns first-lane choice for the modular agent search area.\n *\n * Why this file exists:\n * - search should have one clear owner for first-lane choice\n * - the route decision should be explainable from one derived context packet\n * - later policy and readiness stages should consume the chosen lane, not recompute it\n */\nimport type { AgentSearchContext } from \"./searchContext.js\";\nimport type { AgentLaneDecision } from \"./types.js\";\nimport { isDirectoryLikeHint, isStrongFileLikeRef } from \"./searchContext.js\";\n\n/**\n * Detects direct folder-content questions before file search runs.\n * Example: `list files in cli/src/agent/search` should use the directory lane.\n */\nexport function looksLikeDirectoryListingQuery(context: AgentSearchContext): boolean {\n  const lowered = String(context.query ?? \"\").toLowerCase();\n  const hasStrongFileTarget = context.explicitTargets.some(isStrongFileLikeRef);\n  if (hasStrongFileTarget) {\n    return false;\n  }\n  const hasListingVerb = /\\b(list|contents?|files|folders|show)\\b/.test(lowered);\n  const hasFolderWord = /\\b(folder|directory|contents?)\\b/.test(lowered);\n  const hasFolderHint = context.softHints.some(isDirectoryLikeHint) || context.explicitTargets.some(isDirectoryLikeHint);\n  const asksForExplanation = /\\b(why|how|what does|explain|trace|summari[sz]e)\\b/.test(lowered);\n  return hasListingVerb && (hasFolderWord || hasFolderHint) && !asksForExplanation;\n}\n\nfunction resolveExplicitFolderTarget(context: AgentSearchContext): string | undefined {\n  return context.resolvedTargets.find((resolution) => resolution.kind === \"resolved-folder\")?.folderPath;\n}\n\nfunction resolveExplicitFileTarget(context: AgentSearchContext): string | undefined {\n  const resolvedFile = context.resolvedTargets.find((resolution) => resolution.kind === \"resolved-file\");\n  if (resolvedFile?.kind === \"resolved-file\") {\n    return resolvedFile.filePath;\n  }\n  if (context.explicitTargets.some(isStrongFileLikeRef)) {\n    return context.explicitTargets.find(isStrongFileLikeRef);\n  }\n  if (context.quotedFragments.length === 0 && context.explicitTargets.length > 0) {\n    return context.explicitTargets[0];\n  }\n  return undefined;\n}\n\nfunction hasUnresolvedExplicitTarget(context: AgentSearchContext): boolean {\n  if (context.explicitTargets.length === 0) {\n    return false;\n  }\n  if (resolveExplicitFolderTarget(context) || resolveExplicitFileTarget(context)) {\n    return false;\n  }\n  return true;\n}\n\n/**\n * Detects broad read-only repo questions that are best served by literal content search first.\n * Example: `where do I set the max count for how many loops the agent can run?` should try grep-like search.\n */\nfunction looksLikeShellContentQuery(context: AgentSearchContext): boolean {\n  if (context.explicitTargets.length > 0 || context.quotedFragments.length > 0 || context.regexLike) {\n    return false;\n  }\n\n  const lowered = String(context.query ?? \"\").toLowerCase();\n  const asksForOwner = /\\b(where|which|what)\\b/.test(lowered) &&\n    /\\b(set|sets|setting|defined|defines|configured|configures|controls|decides|owner|owns|limit|limits|threshold|count|max)\\b/.test(lowered);\n  const asksForSpecificField = /\\bwhere\\b.+\\b(set|defined|configured)\\b/.test(lowered) ||\n    /\\bwhich\\s+file\\b.+\\b(set|defines|configures|controls|decides)\\b/.test(lowered) ||\n    /\\bwhat\\s+file\\b.+\\b(set|defines|configures|controls|decides)\\b/.test(lowered);\n  const broadScope = context.scopeKind === \"broad-repo\" || context.scopeKind === \"general\";\n  return broadScope && (asksForOwner || asksForSpecificField);\n}\n\n/**\n * Chooses one search lane from the shared context packet.\n * Example: a resolved folder target uses `directory`, while a quoted snippet uses `fragment`.\n */\nexport function classifySearchLane(context: AgentSearchContext): AgentLaneDecision {\n  const resolvedFolder = resolveExplicitFolderTarget(context);\n  if (resolvedFolder && context.allowDirectoryLane) {\n    return {\n      lane: \"directory\",\n      reason: \"resolved explicit folder target\",\n      resolvedTarget: resolvedFolder,\n    };\n  }\n\n  if (context.allowDirectoryLane && looksLikeDirectoryListingQuery(context)) {\n    return {\n      lane: \"directory\",\n      reason: \"directory-listing wording with folder-like hints\",\n      resolvedTarget: context.softHints.find(isDirectoryLikeHint)\n        ?? context.explicitTargets.find(isDirectoryLikeHint),\n    };\n  }\n\n  const resolvedFile = resolveExplicitFileTarget(context);\n  if (resolvedFile) {\n    return {\n      lane: \"exact-target\",\n      reason: \"explicit file-like or resolved file target\",\n      resolvedTarget: resolvedFile,\n    };\n  }\n\n  if (context.quotedFragments.length > 0) {\n    return {\n      lane: \"fragment\",\n      reason: \"quoted fragment present in the query\",\n    };\n  }\n\n  if (context.allowRegexLane && context.regexLike) {\n    return {\n      lane: \"regex\",\n      reason: \"regex-like query with regex lane enabled\",\n    };\n  }\n\n  if (hasUnresolvedExplicitTarget(context)) {\n    return {\n      lane: \"exact-target\",\n      reason: \"unresolved explicit target still needs exact-target search\",\n      resolvedTarget: context.explicitTargets[0],\n    };\n  }\n\n  if (looksLikeShellContentQuery(context)) {\n    return {\n      lane: \"shell-content\",\n      reason: \"broad read-only question with no explicit target\",\n    };\n  }\n\n  return {\n    lane: \"semantic\",\n    reason: \"no explicit lane signals matched\",\n  };\n}\n"]}

package/dist/agent/search/limits.js

@@ -0,0 +1,10 @@
+/**
+ * Defines shared search limits for the modular agent search area.
+ *
+ * Why this file exists:
+ * - visible result limits should stay consistent across lanes
+ * - semantic retrieval may need a wider internal frontier than the UI-facing shortlist
+ */
+export const DEFAULT_VISIBLE_SEARCH_LIMIT = 5;
+export const DEFAULT_INTERNAL_SEMANTIC_LIMIT = 12;
+//# sourceMappingURL=limits.js.map

package/dist/agent/search/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../src/agent/search/limits.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAC9C,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC","sourcesContent":["/**\n * Defines shared search limits for the modular agent search area.\n *\n * Why this file exists:\n * - visible result limits should stay consistent across lanes\n * - semantic retrieval may need a wider internal frontier than the UI-facing shortlist\n */\nexport const DEFAULT_VISIBLE_SEARCH_LIMIT = 5;\nexport const DEFAULT_INTERNAL_SEMANTIC_LIMIT = 12;\n"]}

package/dist/agent/search/ranking.js

@@ -0,0 +1,22 @@
+import { scoreCandidateFiles } from "../../search/sharedRankingPolicy.js";
+export function rankAgentSearchHits(filePaths, relatedFileScores, query, matches = [], hintTerms = []) {
+    const matchesByFile = matches.reduce((acc, match) => {
+        const list = acc[match.filePath] ?? [];
+        list.push({
+            snippet: match.snippet,
+            ...(match.reasons ? { reasons: match.reasons } : {}),
+        });
+        acc[match.filePath] = list;
+        return acc;
+    }, {});
+    return scoreCandidateFiles(filePaths, relatedFileScores, query, {
+        matchesByFile,
+        hintTerms,
+    }).map((hit) => ({
+        filePath: hit.filePath,
+        score: hit.score,
+        ...(typeof hit.bm25Raw === "number" ? { bm25Raw: hit.bm25Raw } : {}),
+        reasons: hit.reasons,
+    }));
+}
+//# sourceMappingURL=ranking.js.map

package/dist/agent/search/ranking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.js","sourceRoot":"","sources":["../../../src/agent/search/ranking.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAS1E,MAAM,UAAU,mBAAmB,CACjC,SAAmB,EACnB,iBAAyC,EACzC,KAAa,EACb,UAA8B,EAAE,EAChC,YAAsB,EAAE;IAExB,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAiE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAClH,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC;YACR,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAC,CAAC;QACH,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QAC3B,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,mBAAmB,CAAC,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE;QAC9D,aAAa;QACb,SAAS;KACV,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACf,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC,CAAC,CAAC;AACN,CAAC","sourcesContent":["/**\n * Adapts the shared scorer into the modular agent search hit shape.\n *\n * Why this file exists:\n * - the modular agent should not own a second scorer implementation\n * - search tools and retention need one small local adapter type\n */\nimport type { AgentSearchMatch } from \"../types.js\";\nimport { scoreCandidateFiles } from \"../../search/sharedRankingPolicy.js\";\n\nexport interface AgentScoredSearchHit {\n  filePath: string;\n  score: number;\n  bm25Raw?: number;\n  reasons: string[];\n}\n\nexport function rankAgentSearchHits(\n  filePaths: string[],\n  relatedFileScores: Record<string, number>,\n  query: string,\n  matches: AgentSearchMatch[] = [],\n  hintTerms: string[] = []\n): AgentScoredSearchHit[] {\n  const matchesByFile = matches.reduce<Record<string, Array<{ snippet: string; reasons?: string[] }>>>((acc, match) => {\n    const list = acc[match.filePath] ?? [];\n    list.push({\n      snippet: match.snippet,\n      ...(match.reasons ? { reasons: match.reasons } : {}),\n    });\n    acc[match.filePath] = list;\n    return acc;\n  }, {});\n\n  return scoreCandidateFiles(filePaths, relatedFileScores, query, {\n    matchesByFile,\n    hintTerms,\n  }).map((hit) => ({\n    filePath: hit.filePath,\n    score: hit.score,\n    ...(typeof hit.bm25Raw === \"number\" ? { bm25Raw: hit.bm25Raw } : {}),\n    reasons: hit.reasons,\n  }));\n}\n"]}

package/dist/agent/search/regex.js

@@ -0,0 +1,83 @@
+/**
+ * Runs validated regex search for modular-agent search.
+ */
+import { classifyFileRulePath } from "../../fileRules/searchPathClassification.js";
+import { collectRegexMatches, collectSearchablePaths, dedupeStrings } from "./shared.js";
+function safeCreateRegex(pattern, flags = "i") {
+    try {
+        return new RegExp(pattern, flags);
+    }
+    catch {
+        return null;
+    }
+}
+export function runRegexSearch(rootDir, pattern, target, flags) {
+    const regex = safeCreateRegex(pattern, flags ?? "i");
+    if (!regex) {
+        return {
+            lane: "regex",
+            query: pattern,
+            filePaths: [],
+            failure: {
+                status: "failed",
+                failureClass: "invalid-regex",
+                message: "Regex pattern could not be compiled.",
+                pattern,
+                flags,
+            },
+        };
+    }
+    const files = collectSearchablePaths(rootDir, { allowIgnoredPaths: true }).filter((filePath) => {
+        const classification = classifyFileRulePath(filePath);
+        return !classification.isGeneratedBuild
+            && !classification.isArtifact
+            && !classification.isLogLike
+            && !classification.isSourceMap
+            && !classification.isHarnessLike;
+    });
+    const hits = [];
+    let matchCount = 0;
+    const matches = target === "content" || target === "both"
+        ? collectRegexMatches(files, pattern, flags ?? "i", {
+            maxPerFile: 2,
+            maxTotal: 10,
+        })
+        : [];
+    const matchedFiles = new Set(matches.map((match) => match.filePath));
+    for (const filePath of files) {
+        let matched = false;
+        if (target === "path" || target === "both") {
+            if (regex.test(filePath)) {
+                matched = true;
+                matchCount += 1;
+            }
+            regex.lastIndex = 0;
+        }
+        if (!matched && matchedFiles.has(filePath)) {
+            matched = true;
+            matchCount += matches.filter((match) => match.filePath === filePath).length;
+        }
+        if (matched) {
+            hits.push(filePath);
+        }
+    }
+    return {
+        lane: "regex",
+        query: pattern,
+        filePaths: dedupeStrings(hits).slice(0, 5),
+        matches,
+        matchCount,
+        ...(hits.length === 0
+            ? {
+                failure: {
+                    status: "failed",
+                    failureClass: "no-match",
+                    message: "Regex search found no matches in scope.",
+                    pattern,
+                    flags,
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=regex.js.map

package/dist/agent/search/regex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex.js","sourceRoot":"","sources":["../../../src/agent/search/regex.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Runs validated regex search for modular-agent search.\n */\nimport { classifyFileRulePath } from \"../../fileRules/searchPathClassification.js\";\nimport type { AgentSearchPacket } from \"./types.js\";\nimport { collectRegexMatches, collectSearchablePaths, dedupeStrings } from \"./shared.js\";\n\nfunction safeCreateRegex(pattern: string, flags = \"i\"): RegExp | null {\n  try {\n    return new RegExp(pattern, flags);\n  } catch {\n    return null;\n  }\n}\n\nexport function runRegexSearch(\n  rootDir: string,\n  pattern: string,\n  target: \"path\" | \"content\" | \"both\",\n  flags?: string\n): AgentSearchPacket {\n  const regex = safeCreateRegex(pattern, flags ?? \"i\");\n  if (!regex) {\n    return {\n      lane: \"regex\",\n      query: pattern,\n      filePaths: [],\n      failure: {\n        status: \"failed\",\n        failureClass: \"invalid-regex\",\n        message: \"Regex pattern could not be compiled.\",\n        pattern,\n        flags,\n      },\n    };\n  }\n\n  const files = collectSearchablePaths(rootDir, { allowIgnoredPaths: true }).filter((filePath) => {\n    const classification = classifyFileRulePath(filePath);\n    return !classification.isGeneratedBuild\n      && !classification.isArtifact\n      && !classification.isLogLike\n      && !classification.isSourceMap\n      && !classification.isHarnessLike;\n  });\n  const hits: string[] = [];\n  let matchCount = 0;\n  const matches = target === \"content\" || target === \"both\"\n    ? collectRegexMatches(files, pattern, flags ?? \"i\", {\n        maxPerFile: 2,\n        maxTotal: 10,\n      })\n    : [];\n  const matchedFiles = new Set(matches.map((match) => match.filePath));\n\n  for (const filePath of files) {\n    let matched = false;\n    if (target === \"path\" || target === \"both\") {\n      if (regex.test(filePath)) {\n        matched = true;\n        matchCount += 1;\n      }\n      regex.lastIndex = 0;\n    }\n    if (!matched && matchedFiles.has(filePath)) {\n      matched = true;\n      matchCount += matches.filter((match) => match.filePath === filePath).length;\n    }\n    if (matched) {\n      hits.push(filePath);\n    }\n  }\n\n  return {\n    lane: \"regex\",\n    query: pattern,\n    filePaths: dedupeStrings(hits).slice(0, 5),\n    matches,\n    matchCount,\n    ...(hits.length === 0\n      ? {\n          failure: {\n            status: \"failed\" as const,\n            failureClass: \"no-match\" as const,\n            message: \"Regex search found no matches in scope.\",\n            pattern,\n            flags,\n          },\n        }\n      : {}),\n  };\n}\n"]}

package/dist/agent/search/routePolicy.js

@@ -0,0 +1,11 @@
+import { classifySearchLane } from "./laneClassifier.js";
+export { extractQuotedFragments } from "./searchContext.js";
+export { looksLikeDirectoryListingQuery } from "./laneClassifier.js";
+/**
+ * Chooses one search lane from the derived pre-search packet.
+ * Example: path-like targets go to `exact-target`, while quoted snippets go to `fragment`.
+ */
+export function chooseSearchRoute(context) {
+    return classifySearchLane(context).lane;
+}
+//# sourceMappingURL=routePolicy.js.map

package/dist/agent/search/routePolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routePolicy.js","sourceRoot":"","sources":["../../../src/agent/search/routePolicy.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAkC,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAErE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC","sourcesContent":["/**\n * Chooses the search lane for the modular agent search area.\n *\n * Why this file exists:\n * - lane choice is a search concern and should have one owner\n * - the search facade should delegate route decisions instead of inlining them\n * - route rules should stay separate from retention and ranking\n * - lane choice should consume one pre-search fact packet instead of raw task state\n */\nimport type { AgentSearchLane } from \"./types.js\";\nimport type { AgentSearchContext } from \"./searchContext.js\";\nimport { classifySearchLane, looksLikeDirectoryListingQuery } from \"./laneClassifier.js\";\nexport { extractQuotedFragments } from \"./searchContext.js\";\nexport { looksLikeDirectoryListingQuery } from \"./laneClassifier.js\";\n\n/**\n * Chooses one search lane from the derived pre-search packet.\n * Example: path-like targets go to `exact-target`, while quoted snippets go to `fragment`.\n */\nexport function chooseSearchRoute(context: AgentSearchContext): AgentSearchLane {\n  return classifySearchLane(context).lane;\n}\n"]}

package/dist/agent/search/searchContext.js

@@ -0,0 +1,128 @@
+/**
+ * Builds one derived pre-search fact packet for first-lane choice.
+ *
+ * Why this file exists:
+ * - search should gather its facts once instead of rediscovering them in several modules
+ * - route choice should consume one stable packet before later policy stages run
+ * - resolved target meaning should come from the resolver, not fresh path guessing in search
+ */
+import path from "path";
+import { queryNeedsRegexMode } from "../../fileRules/queryTokenRules.js";
+import { uniqueStrings } from "../evidence/index.js";
+import { resolveTargetResolutions } from "../policy/resolutionPipeline.js";
+function resolveBootstrapSearchMode(query) {
+    const trimmed = String(query ?? "").trim();
+    if (!trimmed) {
+        return "semantic";
+    }
+    if (/["'`][^"'`\n]{4,}["'`]/.test(trimmed)) {
+        return "auto";
+    }
+    if (trimmed.includes("|") || /[\[\]{}()+\\.^$]/.test(trimmed)) {
+        return "auto";
+    }
+    return "semantic";
+}
+export function isDirectoryLikeHint(value) {
+    const trimmed = String(value ?? "").trim();
+    if (!trimmed) {
+        return false;
+    }
+    if (trimmed === "." || trimmed === "..") {
+        return true;
+    }
+    if (trimmed.endsWith(path.sep) || trimmed.endsWith("/")) {
+        return true;
+    }
+    if (!(trimmed.includes("/") || trimmed.includes("\\"))) {
+        return false;
+    }
+    return !/\.[A-Za-z0-9_]{1,10}$/.test(path.basename(trimmed));
+}
+export function isStrongFileLikeRef(value) {
+    const trimmed = String(value ?? "").trim();
+    if (!trimmed) {
+        return false;
+    }
+    return trimmed.includes("/") || trimmed.includes("\\") || /\.[A-Za-z0-9_]{1,10}$/.test(trimmed);
+}
+/**
+ * Finds raw quoted fragments that should stay in fixed-string search.
+ * Example: `"const run ="` should prefer the fragment lane over semantic search.
+ */
+export function extractQuotedFragments(query) {
+    const out = new Set();
+    const patterns = [
+        /"([^"\n]{4,})"/g,
+        /'([^'\n]{4,})'/g,
+        /`([^`\n]{4,})`/g,
+    ];
+    for (const pattern of patterns) {
+        let match = null;
+        while ((match = pattern.exec(query)) !== null) {
+            const fragment = String(match[1] ?? "").trim();
+            if (fragment.length >= 4) {
+                out.add(fragment);
+            }
+        }
+    }
+    return Array.from(out);
+}
+function looksFolderShapedQuery(query, explicitTargets, softHints, resolvedTargets) {
+    const lowered = String(query ?? "").toLowerCase();
+    if (/\b(folder|directory|contents?|files)\b/.test(lowered)) {
+        return true;
+    }
+    if (resolvedTargets.some((resolution) => resolution.kind === "resolved-folder")) {
+        return true;
+    }
+    if (explicitTargets.some(isDirectoryLikeHint) || softHints.some(isDirectoryLikeHint)) {
+        return true;
+    }
+    return /^(check|inspect|review|show|list)\b/.test(lowered)
+        && explicitTargets.length === 1
+        && !isStrongFileLikeRef(explicitTargets[0]);
+}
+/**
+ * Builds one stable packet for search lane selection and search logging.
+ * Example: `check guards` becomes a targeted, folder-shaped packet even before a lane is chosen.
+ */
+export function buildSearchContext(memory, query, options = {}) {
+    const explicitTargets = uniqueStrings(memory.task.explicitTargets);
+    const resolutionMemory = {
+        ...memory,
+        task: {
+            ...memory.task,
+            explicitTargets,
+        },
+    };
+    const resolvedTargets = resolveTargetResolutions(resolutionMemory);
+    const quotedFragments = extractQuotedFragments(query);
+    const normalizedQuery = String(memory.task.normalizedQuery ?? query).trim() || query;
+    const hardFileTargets = uniqueStrings([
+        ...memory.task.hardFileTargets,
+        ...resolvedTargets
+            .filter((resolution) => resolution.kind === "resolved-file")
+            .map((resolution) => resolution.filePath),
+    ]);
+    const softHints = uniqueStrings(memory.task.softHints);
+    const regexLike = resolveBootstrapSearchMode(query) === "auto" && queryNeedsRegexMode(query);
+    const folderShaped = looksFolderShapedQuery(query, explicitTargets, softHints, resolvedTargets);
+    return {
+        query,
+        normalizedQuery,
+        taskKind: "ask",
+        scopeKind: memory.task.queryScope,
+        explicitTargets,
+        quotedFragments,
+        regexLike,
+        folderShaped,
+        resolvedTargets,
+        hardFileTargets,
+        softHints,
+        searchTermGroups: memory.task.searchTermGroups,
+        allowDirectoryLane: options.allowDirectoryLane ?? false,
+        allowRegexLane: options.allowRegexLane ?? false,
+    };
+}
+//# sourceMappingURL=searchContext.js.map

package/dist/agent/search/searchContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchContext.js","sourceRoot":"","sources":["../../../src/agent/search/searchContext.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Builds one derived pre-search fact packet for first-lane choice.\n *\n * Why this file exists:\n * - search should gather its facts once instead of rediscovering them in several modules\n * - route choice should consume one stable packet before later policy stages run\n * - resolved target meaning should come from the resolver, not fresh path guessing in search\n */\nimport path from \"path\";\nimport { queryNeedsRegexMode } from \"../../fileRules/queryTokenRules.js\";\nimport { uniqueStrings } from \"../evidence/index.js\";\nimport { resolveTargetResolutions } from \"../policy/resolutionPipeline.js\";\nimport type { TargetResolution } from \"../policy/contracts.js\";\nimport type { AgentMemory, AgentQueryScope, AgentSearchTermGroup } from \"../types.js\";\n\nexport type AgentSearchScopeKind = AgentQueryScope;\n\nexport interface AgentSearchContext {\n  query: string;\n  normalizedQuery: string;\n  taskKind: \"ask\";\n  scopeKind: AgentSearchScopeKind;\n  explicitTargets: string[];\n  quotedFragments: string[];\n  regexLike: boolean;\n  folderShaped: boolean;\n  resolvedTargets: TargetResolution[];\n  hardFileTargets: string[];\n  softHints: string[];\n  searchTermGroups: AgentSearchTermGroup[];\n  allowDirectoryLane: boolean;\n  allowRegexLane: boolean;\n}\n\nexport interface BuildSearchContextOptions {\n  allowDirectoryLane?: boolean;\n  allowRegexLane?: boolean;\n}\n\nfunction resolveBootstrapSearchMode(query: string): \"semantic\" | \"auto\" {\n  const trimmed = String(query ?? \"\").trim();\n  if (!trimmed) {\n    return \"semantic\";\n  }\n  if (/[\"'`][^\"'`\\n]{4,}[\"'`]/.test(trimmed)) {\n    return \"auto\";\n  }\n  if (trimmed.includes(\"|\") || /[\\[\\]{}()+\\\\.^$]/.test(trimmed)) {\n    return \"auto\";\n  }\n  return \"semantic\";\n}\n\nexport function isDirectoryLikeHint(value: string): boolean {\n  const trimmed = String(value ?? \"\").trim();\n  if (!trimmed) {\n    return false;\n  }\n  if (trimmed === \".\" || trimmed === \"..\") {\n    return true;\n  }\n  if (trimmed.endsWith(path.sep) || trimmed.endsWith(\"/\")) {\n    return true;\n  }\n  if (!(trimmed.includes(\"/\") || trimmed.includes(\"\\\\\"))) {\n    return false;\n  }\n  return !/\\.[A-Za-z0-9_]{1,10}$/.test(path.basename(trimmed));\n}\n\nexport function isStrongFileLikeRef(value: string): boolean {\n  const trimmed = String(value ?? \"\").trim();\n  if (!trimmed) {\n    return false;\n  }\n  return trimmed.includes(\"/\") || trimmed.includes(\"\\\\\") || /\\.[A-Za-z0-9_]{1,10}$/.test(trimmed);\n}\n\n/**\n * Finds raw quoted fragments that should stay in fixed-string search.\n * Example: `\"const run =\"` should prefer the fragment lane over semantic search.\n */\nexport function extractQuotedFragments(query: string): string[] {\n  const out = new Set<string>();\n  const patterns = [\n    /\"([^\"\\n]{4,})\"/g,\n    /'([^'\\n]{4,})'/g,\n    /`([^`\\n]{4,})`/g,\n  ];\n  for (const pattern of patterns) {\n    let match: RegExpExecArray | null = null;\n    while ((match = pattern.exec(query)) !== null) {\n      const fragment = String(match[1] ?? \"\").trim();\n      if (fragment.length >= 4) {\n        out.add(fragment);\n      }\n    }\n  }\n  return Array.from(out);\n}\n\nfunction looksFolderShapedQuery(\n  query: string,\n  explicitTargets: string[],\n  softHints: string[],\n  resolvedTargets: TargetResolution[]\n): boolean {\n  const lowered = String(query ?? \"\").toLowerCase();\n  if (/\\b(folder|directory|contents?|files)\\b/.test(lowered)) {\n    return true;\n  }\n  if (resolvedTargets.some((resolution) => resolution.kind === \"resolved-folder\")) {\n    return true;\n  }\n  if (explicitTargets.some(isDirectoryLikeHint) || softHints.some(isDirectoryLikeHint)) {\n    return true;\n  }\n  return /^(check|inspect|review|show|list)\\b/.test(lowered)\n    && explicitTargets.length === 1\n    && !isStrongFileLikeRef(explicitTargets[0]);\n}\n\n/**\n * Builds one stable packet for search lane selection and search logging.\n * Example: `check guards` becomes a targeted, folder-shaped packet even before a lane is chosen.\n */\nexport function buildSearchContext(\n  memory: AgentMemory,\n  query: string,\n  options: BuildSearchContextOptions = {}\n): AgentSearchContext {\n  const explicitTargets = uniqueStrings(memory.task.explicitTargets);\n  const resolutionMemory: AgentMemory = {\n    ...memory,\n    task: {\n      ...memory.task,\n      explicitTargets,\n    },\n  };\n  const resolvedTargets = resolveTargetResolutions(resolutionMemory);\n  const quotedFragments = extractQuotedFragments(query);\n  const normalizedQuery = String(memory.task.normalizedQuery ?? query).trim() || query;\n  const hardFileTargets = uniqueStrings([\n    ...memory.task.hardFileTargets,\n    ...resolvedTargets\n      .filter((resolution): resolution is Extract<TargetResolution, { kind: \"resolved-file\" }> => resolution.kind === \"resolved-file\")\n      .map((resolution) => resolution.filePath),\n  ]);\n  const softHints = uniqueStrings(memory.task.softHints);\n  const regexLike = resolveBootstrapSearchMode(query) === \"auto\" && queryNeedsRegexMode(query);\n  const folderShaped = looksFolderShapedQuery(query, explicitTargets, softHints, resolvedTargets);\n\n  return {\n    query,\n    normalizedQuery,\n    taskKind: \"ask\",\n    scopeKind: memory.task.queryScope,\n    explicitTargets,\n    quotedFragments,\n    regexLike,\n    folderShaped,\n    resolvedTargets,\n    hardFileTargets,\n    softHints,\n    searchTermGroups: memory.task.searchTermGroups,\n    allowDirectoryLane: options.allowDirectoryLane ?? false,\n    allowRegexLane: options.allowRegexLane ?? false,\n  };\n}\n"]}

package/dist/agent/search/semantic.js

@@ -0,0 +1,113 @@
+/**
+ * Runs indexed semantic retrieval for modular-agent search.
+ *
+ * Why this file exists:
+ * - DB retrieval and local fallback stay in one semantic owner
+ * - snippet extraction should use the same effective search terms that retrieval used
+ * - deterministic local fallback should only run after search-owned DB recovery
+ * - semantic hits must stay inside the active repo before ranking can trust them
+ */
+import fs from "fs";
+import path from "path";
+import { classifyFileRulePath } from "../../fileRules/searchPathClassification.js";
+import { DEFAULT_VISIBLE_SEARCH_LIMIT } from "./limits.js";
+import { runSemanticIndexSearch } from "./semanticIndexSearch.js";
+import { collectFixedStringMatches, collectSearchablePaths, tokenizeSearchTerms, } from "./shared.js";
+function resolveLocalSearchTerms(query) {
+    return tokenizeSearchTerms(query);
+}
+function getSemanticPathPenalty(filePath) {
+    const classification = classifyFileRulePath(filePath);
+    let penalty = 0;
+    if (classification.isGeneratedBuild || classification.isArtifact || classification.isLogLike || classification.isSourceMap || classification.isHarnessLike) {
+        penalty += 12;
+    }
+    if (classification.isDocumentation) {
+        penalty += 3;
+    }
+    return penalty;
+}
+/**
+ * Keeps semantic DB hits scoped to the active repo/worktree.
+ * Example: a temp test repo should not inherit hits from the main repo index.
+ */
+function isWithinRootDir(rootDir, filePath) {
+    const relative = path.relative(rootDir, filePath);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+function runLocalFallbackSearch(rootDir, terms, limit) {
+    const scored = collectSearchablePaths(rootDir).map((filePath) => {
+        const loweredPath = filePath.toLowerCase();
+        let score = 0;
+        for (const term of terms) {
+            if (loweredPath.includes(term)) {
+                score += 4;
+            }
+        }
+        try {
+            const code = fs.readFileSync(filePath, "utf-8").toLowerCase();
+            for (const term of terms) {
+                if (code.includes(term)) {
+                    score += 2;
+                }
+            }
+        }
+        catch {
+            return { filePath, score: 0 };
+        }
+        return { filePath, score: score - getSemanticPathPenalty(filePath) };
+    }).filter((entry) => entry.score > 0);
+    const selected = scored
+        .sort((left, right) => right.score - left.score)
+        .slice(0, limit);
+    return {
+        filePaths: selected.map((entry) => entry.filePath),
+        relatedFileScores: Object.fromEntries(selected.map((entry) => [entry.filePath, -entry.score])),
+    };
+}
+export async function runSemanticSearch(rootDir, query, limit = DEFAULT_VISIBLE_SEARCH_LIMIT) {
+    let filePaths = [];
+    let relatedFileScores = {};
+    let debug;
+    let matchTerms = resolveLocalSearchTerms(query);
+    try {
+        const results = await runSemanticIndexSearch(query, limit);
+        filePaths = results.hits
+            .map((result) => result.path)
+            .filter((filePath) => isWithinRootDir(rootDir, filePath));
+        relatedFileScores = Object.fromEntries(Object.entries(results.relatedFileScores).filter(([filePath]) => isWithinRootDir(rootDir, filePath)));
+        matchTerms = results.matchTerms.length > 0 ? results.matchTerms : matchTerms;
+        debug = {
+            queriesRun: results.debug.queriesRun,
+            recoveryUsed: results.debug.recoveryUsed,
+            ...(results.debug.recoveryReason ? { recoveryReason: results.debug.recoveryReason } : {}),
+            matchTerms: results.matchTerms,
+        };
+    }
+    catch {
+        filePaths = [];
+        relatedFileScores = {};
+        debug = undefined;
+    }
+    const localSearchTerms = resolveLocalSearchTerms(query);
+    const fallback = filePaths.length > 0
+        ? {
+            filePaths,
+            relatedFileScores: Object.fromEntries(Object.entries(relatedFileScores).map(([filePath, score]) => [filePath, score + getSemanticPathPenalty(filePath)])),
+        }
+        : runLocalFallbackSearch(rootDir, localSearchTerms, limit);
+    const matches = collectFixedStringMatches(fallback.filePaths, matchTerms, "semantic-content", {
+        caseSensitive: false,
+        maxPerFile: 2,
+        maxTotal: Math.max(limit * 2, DEFAULT_VISIBLE_SEARCH_LIMIT * 2),
+    });
+    return {
+        lane: "semantic",
+        query,
+        filePaths: fallback.filePaths,
+        matches,
+        ...(Object.keys(fallback.relatedFileScores).length > 0 ? { relatedFileScores: fallback.relatedFileScores } : {}),
+        ...(debug ? { debug } : {}),
+    };
+}
+//# sourceMappingURL=semantic.js.map

package/dist/agent/search/semantic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.js","sourceRoot":"","sources":["../../../src/agent/search/semantic.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Runs indexed semantic retrieval for modular-agent search.\n *\n * Why this file exists:\n * - DB retrieval and local fallback stay in one semantic owner\n * - snippet extraction should use the same effective search terms that retrieval used\n * - deterministic local fallback should only run after search-owned DB recovery\n * - semantic hits must stay inside the active repo before ranking can trust them\n */\nimport fs from \"fs\";\nimport path from \"path\";\nimport { classifyFileRulePath } from \"../../fileRules/searchPathClassification.js\";\nimport type { AgentSearchPacket } from \"./types.js\";\nimport { DEFAULT_VISIBLE_SEARCH_LIMIT } from \"./limits.js\";\nimport { runSemanticIndexSearch } from \"./semanticIndexSearch.js\";\nimport {\n  collectFixedStringMatches,\n  collectSearchablePaths,\n  tokenizeSearchTerms,\n} from \"./shared.js\";\n\nfunction resolveLocalSearchTerms(query: string): string[] {\n  return tokenizeSearchTerms(query);\n}\n\nfunction getSemanticPathPenalty(filePath: string): number {\n  const classification = classifyFileRulePath(filePath);\n  let penalty = 0;\n  if (classification.isGeneratedBuild || classification.isArtifact || classification.isLogLike || classification.isSourceMap || classification.isHarnessLike) {\n    penalty += 12;\n  }\n  if (classification.isDocumentation) {\n    penalty += 3;\n  }\n  return penalty;\n}\n\n/**\n * Keeps semantic DB hits scoped to the active repo/worktree.\n * Example: a temp test repo should not inherit hits from the main repo index.\n */\nfunction isWithinRootDir(rootDir: string, filePath: string): boolean {\n  const relative = path.relative(rootDir, filePath);\n  return relative === \"\" || (!relative.startsWith(\"..\") && !path.isAbsolute(relative));\n}\n\nfunction runLocalFallbackSearch(\n  rootDir: string,\n  terms: string[],\n  limit: number\n): { filePaths: string[]; relatedFileScores: Record<string, number> } {\n  const scored = collectSearchablePaths(rootDir).map((filePath) => {\n    const loweredPath = filePath.toLowerCase();\n    let score = 0;\n\n    for (const term of terms) {\n      if (loweredPath.includes(term)) {\n        score += 4;\n      }\n    }\n\n    try {\n      const code = fs.readFileSync(filePath, \"utf-8\").toLowerCase();\n      for (const term of terms) {\n        if (code.includes(term)) {\n          score += 2;\n        }\n      }\n    } catch {\n      return { filePath, score: 0 };\n    }\n\n    return { filePath, score: score - getSemanticPathPenalty(filePath) };\n  }).filter((entry) => entry.score > 0);\n\n  const selected = scored\n    .sort((left, right) => right.score - left.score)\n    .slice(0, limit);\n\n  return {\n    filePaths: selected.map((entry) => entry.filePath),\n    relatedFileScores: Object.fromEntries(selected.map((entry) => [entry.filePath, -entry.score])),\n  };\n}\n\nexport async function runSemanticSearch(\n  rootDir: string,\n  query: string,\n  limit = DEFAULT_VISIBLE_SEARCH_LIMIT\n): Promise<AgentSearchPacket> {\n  let filePaths: string[] = [];\n  let relatedFileScores: Record<string, number> = {};\n  let debug: AgentSearchPacket[\"debug\"] | undefined;\n  let matchTerms = resolveLocalSearchTerms(query);\n  try {\n    const results = await runSemanticIndexSearch(query, limit);\n    filePaths = results.hits\n      .map((result) => result.path)\n      .filter((filePath) => isWithinRootDir(rootDir, filePath));\n    relatedFileScores = Object.fromEntries(\n      Object.entries(results.relatedFileScores).filter(([filePath]) => isWithinRootDir(rootDir, filePath))\n    );\n    matchTerms = results.matchTerms.length > 0 ? results.matchTerms : matchTerms;\n    debug = {\n      queriesRun: results.debug.queriesRun,\n      recoveryUsed: results.debug.recoveryUsed,\n      ...(results.debug.recoveryReason ? { recoveryReason: results.debug.recoveryReason } : {}),\n      matchTerms: results.matchTerms,\n    };\n  } catch {\n    filePaths = [];\n    relatedFileScores = {};\n    debug = undefined;\n  }\n  const localSearchTerms = resolveLocalSearchTerms(query);\n  const fallback = filePaths.length > 0\n    ? {\n        filePaths,\n        relatedFileScores: Object.fromEntries(\n          Object.entries(relatedFileScores).map(([filePath, score]) => [filePath, score + getSemanticPathPenalty(filePath)])\n        ),\n      }\n    : runLocalFallbackSearch(rootDir, localSearchTerms, limit);\n  const matches = collectFixedStringMatches(\n    fallback.filePaths,\n    matchTerms,\n    \"semantic-content\",\n    {\n      caseSensitive: false,\n      maxPerFile: 2,\n      maxTotal: Math.max(limit * 2, DEFAULT_VISIBLE_SEARCH_LIMIT * 2),\n    }\n  );\n  return {\n    lane: \"semantic\",\n    query,\n    filePaths: fallback.filePaths,\n    matches,\n    ...(Object.keys(fallback.relatedFileScores).length > 0 ? { relatedFileScores: fallback.relatedFileScores } : {}),\n    ...(debug ? { debug } : {}),\n  };\n}\n"]}