lsp-intelligence 0.1.2 → 0.2.1

package/dist/git/getChangedHunks.js

@@ -0,0 +1,56 @@
+import { execSync } from 'child_process';
+import * as path from 'path';
+import { getGitContext, toRepoRelativePath } from './getGitRoot.js';
+/**
+ * Parse git diff to extract changed line ranges per file.
+ * Uses repo-relative paths for git commands.
+ */
+export function getChangedHunks(workspaceRoot, base) {
+    try {
+        const ctx = getGitContext(workspaceRoot);
+        const cwd = ctx?.repoRoot ?? workspaceRoot;
+        const diff = execSync(`git diff ${base} --unified=0`, { cwd, encoding: 'utf-8' });
+        return parseHunks(diff, cwd, workspaceRoot);
+    }
+    catch {
+        return [];
+    }
+}
+function parseHunks(diff, gitRoot, workspaceRoot) {
+    const hunks = [];
+    let currentFile = '';
+    for (const line of diff.split('\n')) {
+        const fileMatch = line.match(/^\+\+\+ b\/(.+)/);
+        if (fileMatch) {
+            currentFile = path.resolve(gitRoot, fileMatch[1]);
+            continue;
+        }
+        const hunkMatch = line.match(/^@@ .+ \+(\d+)(?:,(\d+))? @@/);
+        if (hunkMatch && currentFile.match(/\.(ts|tsx|js|jsx|mjs|cjs)$/) && currentFile.startsWith(workspaceRoot)) {
+            const start = parseInt(hunkMatch[1]);
+            const count = parseInt(hunkMatch[2] ?? '1');
+            hunks.push({ file: currentFile, startLine: start, endLine: start + count - 1 });
+        }
+    }
+    return hunks;
+}
+/**
+ * Check if a specific file changed between base and HEAD.
+ */
+export function fileChangedInBranch(filePath, base, workspaceRoot) {
+    try {
+        const ctx = getGitContext(workspaceRoot);
+        if (!ctx)
+            return false;
+        const repoRelPath = toRepoRelativePath(filePath, ctx);
+        const diff = execSync(`git diff ${base} --name-only -- "${repoRelPath}"`, {
+            cwd: ctx.repoRoot,
+            encoding: 'utf-8',
+        });
+        return diff.trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=getChangedHunks.js.map

package/dist/git/getChangedHunks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getChangedHunks.js","sourceRoot":"","sources":["../../src/git/getChangedHunks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAQpE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,aAAqB,EAAE,IAAY;IACjE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,GAAG,EAAE,QAAQ,IAAI,aAAa,CAAC;QAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,IAAI,cAAc,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAClF,OAAO,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,OAAe,EAAE,aAAqB;IACtE,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,IAAI,WAAW,GAAG,EAAE,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAChD,IAAI,SAAS,EAAE,CAAC;YACd,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC7D,IAAI,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,4BAA4B,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC1G,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,IAAY,EAAE,aAAqB;IACvF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QACvB,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,IAAI,oBAAoB,WAAW,GAAG,EAAE;YACxE,GAAG,EAAE,GAAG,CAAC,QAAQ;YACjB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/git/getGitRoot.d.ts

@@ -0,0 +1,15 @@
+export interface GitContext {
+    repoRoot: string;
+    workspaceRoot: string;
+}
+/**
+ * Resolve the git repo root and workspace root.
+ * The workspace root may be a subdirectory of the repo root (nested workspace).
+ * Cached for the session.
+ */
+export declare function getGitContext(workspaceRoot: string): GitContext | null;
+/**
+ * Convert a workspace-relative or absolute path to a repo-relative path.
+ * This is what git commands (git show, git diff) need.
+ */
+export declare function toRepoRelativePath(filePath: string, ctx: GitContext): string;

package/dist/git/getGitRoot.js

@@ -0,0 +1,33 @@
+import { execSync } from 'child_process';
+import * as path from 'path';
+let cachedContext = null;
+/**
+ * Resolve the git repo root and workspace root.
+ * The workspace root may be a subdirectory of the repo root (nested workspace).
+ * Cached for the session.
+ */
+export function getGitContext(workspaceRoot) {
+    if (cachedContext && cachedContext.workspaceRoot === workspaceRoot)
+        return cachedContext;
+    try {
+        const repoRoot = execSync('git rev-parse --show-toplevel', {
+            cwd: workspaceRoot,
+            encoding: 'utf-8',
+            timeout: 5000,
+        }).trim();
+        cachedContext = { repoRoot, workspaceRoot };
+        return cachedContext;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Convert a workspace-relative or absolute path to a repo-relative path.
+ * This is what git commands (git show, git diff) need.
+ */
+export function toRepoRelativePath(filePath, ctx) {
+    const abs = path.isAbsolute(filePath) ? filePath : path.join(ctx.workspaceRoot, filePath);
+    return path.relative(ctx.repoRoot, abs);
+}
+//# sourceMappingURL=getGitRoot.js.map

package/dist/git/getGitRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getGitRoot.js","sourceRoot":"","sources":["../../src/git/getGitRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAO7B,IAAI,aAAa,GAAsB,IAAI,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,aAAqB;IACjD,IAAI,aAAa,IAAI,aAAa,CAAC,aAAa,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IAEzF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,+BAA+B,EAAE;YACzD,GAAG,EAAE,aAAa;YAClB,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,aAAa,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAC5C,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,GAAe;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC1F,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC"}

package/dist/git/getMergeBase.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Get the merge-base between HEAD and the target branch.
+ * Tries main, then master, then falls back to HEAD~1.
+ */
+export declare function getMergeBase(workspaceRoot: string, target?: string): string;

package/dist/git/getMergeBase.js

@@ -0,0 +1,23 @@
+import { execSync } from 'child_process';
+/**
+ * Get the merge-base between HEAD and the target branch.
+ * Tries main, then master, then falls back to HEAD~1.
+ */
+export function getMergeBase(workspaceRoot, target) {
+    if (target) {
+        try {
+            return execSync(`git merge-base HEAD ${target}`, { cwd: workspaceRoot, encoding: 'utf-8' }).trim();
+        }
+        catch {
+            return target;
+        }
+    }
+    for (const branch of ['main', 'master', 'develop']) {
+        try {
+            return execSync(`git merge-base HEAD ${branch}`, { cwd: workspaceRoot, encoding: 'utf-8' }).trim();
+        }
+        catch { }
+    }
+    return 'HEAD~1';
+}
+//# sourceMappingURL=getMergeBase.js.map

package/dist/git/getMergeBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMergeBase.js","sourceRoot":"","sources":["../../src/git/getMergeBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,aAAqB,EAAE,MAAe;IACjE,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,uBAAuB,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrG,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,uBAAuB,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrG,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/index.js

@@ -27,6 +27,10 @@ import { impactTrace } from './tools/composites/impactTrace.js';
 import { semanticDiff } from './tools/composites/semanticDiff.js';
 import { findTestFiles } from './tools/composites/findTestFiles.js';
 import { explainError } from './tools/composites/explainError.js';
+import { findPattern } from './tools/composites/findPattern.js';
+import { findCode } from './tools/composites/findCode.js';
+import { apiGuard } from './tools/composites/apiGuard.js';
+import { rootCauseTrace } from './tools/composites/rootCauseTrace.js';
 // Context
 import { outline } from './tools/context/outline.js';
 import { gatherContext } from './tools/context/gatherContext.js';
@@ -34,6 +38,7 @@ import { gatherContext } from './tools/context/gatherContext.js';
 import { liveDiagnostics } from './tools/live/liveDiagnostics.js';
 import { findUnusedExports } from './tools/live/findUnusedExports.js';
 import { autoImport } from './tools/live/autoImport.js';
+import { clearIndex } from './tools/live/clearIndex.js';
 const workspaceRoot = process.env.LSP_WORKSPACE_ROOT || process.cwd();
 async function main() {
     console.error(`[lsp-intelligence] Starting with workspace: ${workspaceRoot}`);
@@ -61,6 +66,10 @@ async function main() {
         semanticDiff,
         findTestFiles,
         explainError,
+        findPattern,
+        findCode,
+        apiGuard,
+        rootCauseTrace,
         // Layer 3: Context
         outline,
         gatherContext,
@@ -68,6 +77,7 @@ async function main() {
         liveDiagnostics,
         findUnusedExports,
         autoImport,
+        clearIndex,
     ]);
     engine.initialize().catch((err) => {
         console.error(`[lsp-intelligence] Engine initialization failed: ${err.message}`);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/resolve/searchScope.d.ts

@@ -0,0 +1,17 @@
+import type { SearchScope } from '../search/types.js';
+/**
+ * Resolve a search scope from user input.
+ * This scope is applied to ALL retrieval backends — declarations, usages, structural, pattern.
+ */
+export declare function resolveSearchScope(workspaceRoot: string, paths?: string[], includeTests?: boolean): SearchScope;
+/**
+ * Collect all code files (TS/TSX/JS/JSX/MJS/CJS) within the search scope.
+ * Skips dot-prefixed dirs, build output, minified/bundled files, and oversized files.
+ */
+export interface ScopeCollectionResult {
+    files: string[];
+    capped: boolean;
+    capReason?: 'max-files' | 'max-depth';
+}
+export declare function collectScopeFiles(scope: SearchScope, maxFiles?: number): string[];
+export declare function collectScopeFilesWithMeta(scope: SearchScope, maxFiles?: number): ScopeCollectionResult;

package/dist/resolve/searchScope.js

@@ -0,0 +1,64 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { isCodeFile, isTestFile, shouldSkipDir, shouldSkipFile } from '../search/fileKinds.js';
+/**
+ * Resolve a search scope from user input.
+ * This scope is applied to ALL retrieval backends — declarations, usages, structural, pattern.
+ */
+export function resolveSearchScope(workspaceRoot, paths, includeTests) {
+    const roots = paths && paths.length > 0
+        ? paths.map((p) => path.isAbsolute(p) ? p : path.join(workspaceRoot, p))
+        : [workspaceRoot];
+    return {
+        roots,
+        includeTests: includeTests ?? false,
+    };
+}
+export function collectScopeFiles(scope, maxFiles = 2000) {
+    const result = collectScopeFilesWithMeta(scope, maxFiles);
+    return result.files;
+}
+export function collectScopeFilesWithMeta(scope, maxFiles = 2000) {
+    const files = [];
+    let hitDepthLimit = false;
+    for (const root of scope.roots) {
+        const depthHit = walkDir(root, files, scope.includeTests, maxFiles, 0);
+        if (depthHit)
+            hitDepthLimit = true;
+        if (files.length >= maxFiles)
+            break;
+    }
+    return {
+        files,
+        capped: files.length >= maxFiles || hitDepthLimit,
+        capReason: files.length >= maxFiles ? 'max-files' : hitDepthLimit ? 'max-depth' : undefined,
+    };
+}
+function walkDir(dir, files, includeTests, maxFiles, depth) {
+    if (depth > 8)
+        return true;
+    if (files.length >= maxFiles)
+        return false;
+    let hitDepth = false;
+    try {
+        for (const entry of fs.readdirSync(dir)) {
+            if (shouldSkipDir(entry))
+                continue;
+            const full = path.join(dir, entry);
+            const stat = fs.statSync(full);
+            if (stat.isDirectory()) {
+                const sub = walkDir(full, files, includeTests, maxFiles, depth + 1);
+                if (sub)
+                    hitDepth = true;
+            }
+            else if (isCodeFile(full) && !shouldSkipFile(full, stat.size)) {
+                if (!includeTests && isTestFile(full))
+                    continue;
+                files.push(full);
+            }
+        }
+    }
+    catch { }
+    return hitDepth;
+}
+//# sourceMappingURL=searchScope.js.map

package/dist/resolve/searchScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchScope.js","sourceRoot":"","sources":["../../src/resolve/searchScope.ts"],"names":[],"mappings":"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"}

package/dist/resolve/targetResolver.d.ts

@@ -0,0 +1,33 @@
+import type { LspEngine } from '../engine/LspEngine.js';
+import type { Diagnostic } from 'vscode-languageserver-protocol';
+export interface ToolTargetInput {
+    symbol?: string;
+    file_path?: string;
+    line?: number;
+    column?: number;
+    diagnostic_code?: string;
+}
+export interface ResolvedTarget {
+    symbol?: string;
+    uri: string;
+    filePath: string;
+    position: {
+        line: number;
+        character: number;
+    };
+    definitionFilePath?: string;
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Resolve a tool input into a canonical target with file + position.
+ * Priority: symbol+file_path > symbol > file_path+line > file_path+diagnostic_code > file_path alone
+ */
+export declare function resolveTarget(input: ToolTargetInput, engine: LspEngine): Promise<ResolvedTarget>;
+/**
+ * Pick the best diagnostic near a position.
+ * Priority: exact code match > exact line > nearest ±2 > first error
+ */
+export declare function pickDiagnostic(diagnostics: Diagnostic[], position: {
+    line: number;
+    character: number;
+}, diagnosticCode?: string): Diagnostic | undefined;

package/dist/resolve/targetResolver.js

@@ -0,0 +1,84 @@
+import { toPosition, uriToPath } from '../engine/positions.js';
+/**
+ * Resolve a tool input into a canonical target with file + position.
+ * Priority: symbol+file_path > symbol > file_path+line > file_path+diagnostic_code > file_path alone
+ */
+export async function resolveTarget(input, engine) {
+    // Priority 1: symbol (with optional file hint)
+    if (input.symbol) {
+        const resolved = await engine.resolveSymbol(input.symbol, input.file_path);
+        return {
+            symbol: resolved.name,
+            uri: resolved.uri,
+            filePath: uriToPath(resolved.uri),
+            position: resolved.position,
+            confidence: 'high',
+        };
+    }
+    // Priority 2: file_path + line
+    if (input.file_path && input.line) {
+        const { uri } = await engine.prepareFile(input.file_path);
+        const position = toPosition(input.line, input.column ?? 1);
+        return {
+            uri,
+            filePath: input.file_path,
+            position,
+            confidence: 'medium',
+        };
+    }
+    // Priority 3: file_path + diagnostic_code
+    if (input.file_path && input.diagnostic_code) {
+        const { uri } = await engine.prepareFile(input.file_path);
+        const { waitForDiagnostics } = await import('../engine/waitForDiagnostics.js');
+        await waitForDiagnostics(engine.docManager, uri, 800);
+        const diags = engine.docManager.getCachedDiagnostics(uri);
+        const match = diags.find((d) => `TS${d.code}` === input.diagnostic_code || String(d.code) === input.diagnostic_code);
+        if (match) {
+            return {
+                uri,
+                filePath: input.file_path,
+                position: match.range.start,
+                confidence: 'high',
+            };
+        }
+    }
+    // Priority 4: file_path alone
+    if (input.file_path) {
+        const { uri } = await engine.prepareFile(input.file_path);
+        return {
+            uri,
+            filePath: input.file_path,
+            position: { line: 0, character: 0 },
+            confidence: 'low',
+        };
+    }
+    throw new Error('Provide at least a symbol name or file_path.');
+}
+/**
+ * Pick the best diagnostic near a position.
+ * Priority: exact code match > exact line > nearest ±2 > first error
+ */
+export function pickDiagnostic(diagnostics, position, diagnosticCode) {
+    const errors = diagnostics.filter((d) => d.severity === 1);
+    if (errors.length === 0)
+        return undefined;
+    // Exact diagnostic code match
+    if (diagnosticCode) {
+        const byCode = errors.find((d) => `TS${d.code}` === diagnosticCode || String(d.code) === diagnosticCode);
+        if (byCode)
+            return byCode;
+    }
+    // Exact line match
+    const byLine = errors.find((d) => d.range.start.line === position.line);
+    if (byLine)
+        return byLine;
+    // Nearest line within ±2
+    const nearby = errors
+        .filter((d) => Math.abs(d.range.start.line - position.line) <= 2)
+        .sort((a, b) => Math.abs(a.range.start.line - position.line) - Math.abs(b.range.start.line - position.line));
+    if (nearby.length > 0)
+        return nearby[0];
+    // First error
+    return errors[0];
+}
+//# sourceMappingURL=targetResolver.js.map

package/dist/resolve/targetResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targetResolver.js","sourceRoot":"","sources":["../../src/resolve/targetResolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAmB/D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAsB,EAAE,MAAiB;IAC3E,+CAA+C;IAC/C,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3E,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,IAAI;YACrB,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;YACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;QAC3D,OAAO;YACL,GAAG;YACH,QAAQ,EAAE,KAAK,CAAC,SAAS;YACzB,QAAQ;YACR,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC7C,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1D,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;QAC/E,MAAM,kBAAkB,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7B,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,eAAe,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,eAAe,CACpF,CAAC;QACF,IAAI,KAAK,EAAE,CAAC;YACV,OAAO;gBACL,GAAG;gBACH,QAAQ,EAAE,KAAK,CAAC,SAAS;gBACzB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK;gBAC3B,UAAU,EAAE,MAAM;aACnB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1D,OAAO;YACL,GAAG;YACH,QAAQ,EAAE,KAAK,CAAC,SAAS;YACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACnC,UAAU,EAAE,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAyB,EACzB,QAA6C,EAC7C,cAAuB;IAEvB,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE1C,8BAA8B;IAC9B,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,cAAc,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,cAAc,CACtE,CAAC;QACF,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAED,mBAAmB;IACnB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,yBAAyB;IACzB,MAAM,MAAM,GAAG,MAAM;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAChE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/G,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAExC,cAAc;IACd,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/search/adapters/config.d.ts

@@ -0,0 +1,5 @@
+import type { SearchAdapter } from './types.js';
+/**
+ * Config adapter — emits recipes for feature flag, env var, and config queries.
+ */
+export declare const configAdapter: SearchAdapter;

package/dist/search/adapters/config.js

@@ -0,0 +1,56 @@
+/**
+ * Config adapter — emits recipes for feature flag, env var, and config queries.
+ */
+export const configAdapter = {
+    id: 'config',
+    detect(ir) {
+        if (!ir.traits.configLike)
+            return [];
+        const recipes = [];
+        // Feature flag queries
+        if (ir.nlTokens.some((t) => ['flag', 'toggle', 'feature', 'experiment', 'gate'].includes(t))) {
+            recipes.push({
+                id: 'config.feature-flag',
+                adapter: 'config',
+                retrievers: ['config', 'regex', 'behavior'],
+                regexes: [
+                    { id: 'feature-flag-def', pattern: '(?:feature|flag|toggle|gate|experiment)\\w*\\s*[:=]', flags: 'gi' },
+                    { id: 'launchdarkly', pattern: 'useFeatureFlag|useLDClient|ldClient|variation\\(', flags: 'g' },
+                    { id: 'feature-enum', pattern: 'FeatureFlag\\b|Feature\\w*Flag', flags: 'g' },
+                ],
+                scoreBoost: 2,
+                reasons: ['Config adapter: feature flag query'],
+            });
+        }
+        // Env var queries
+        if (ir.nlTokens.some((t) => ['env', 'environment', 'variable', 'secret'].includes(t))) {
+            recipes.push({
+                id: 'config.env-var',
+                adapter: 'config',
+                retrievers: ['config', 'regex'],
+                regexes: [
+                    { id: 'process-env', pattern: 'process\\.env\\.\\w+', flags: 'g' },
+                    { id: 'env-import', pattern: 'import\\.meta\\.env\\.\\w+', flags: 'g' },
+                    { id: 'dotenv', pattern: 'dotenv|loadEnv|env\\w*Config', flags: 'gi' },
+                ],
+                scoreBoost: 2,
+                reasons: ['Config adapter: env variable query'],
+            });
+        }
+        // General config queries
+        if (recipes.length === 0) {
+            recipes.push({
+                id: 'config.general',
+                adapter: 'config',
+                retrievers: ['config', 'behavior'],
+                regexes: [
+                    { id: 'config-object', pattern: '(?:config|settings|options)\\s*[:=]\\s*\\{', flags: 'gi' },
+                ],
+                scoreBoost: 1,
+                reasons: ['Config adapter: general config query'],
+            });
+        }
+        return recipes;
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/search/adapters/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/search/adapters/config.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,EAAE,EAAE,QAAQ;IAEZ,MAAM,CAAC,EAAW;QAChB,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,EAAE,CAAC;QAErC,MAAM,OAAO,GAAmB,EAAE,CAAC;QAEnC,uBAAuB;QACvB,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7F,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,qBAAqB;gBACzB,OAAO,EAAE,QAAQ;gBACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC;gBAC3C,OAAO,EAAE;oBACP,EAAE,EAAE,EAAE,kBAAkB,EAAE,OAAO,EAAE,qDAAqD,EAAE,KAAK,EAAE,IAAI,EAAE;oBACvG,EAAE,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,kDAAkD,EAAE,KAAK,EAAE,GAAG,EAAE;oBAC/F,EAAE,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,gCAAgC,EAAE,KAAK,EAAE,GAAG,EAAE;iBAC9E;gBACD,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC,oCAAoC,CAAC;aAChD,CAAC,CAAC;QACL,CAAC;QAED,kBAAkB;QAClB,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,gBAAgB;gBACpB,OAAO,EAAE,QAAQ;gBACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAC/B,OAAO,EAAE;oBACP,EAAE,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAAE;oBAClE,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,4BAA4B,EAAE,KAAK,EAAE,GAAG,EAAE;oBACvE,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,8BAA8B,EAAE,KAAK,EAAE,IAAI,EAAE;iBACvE;gBACD,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC,oCAAoC,CAAC;aAChD,CAAC,CAAC;QACL,CAAC;QAED,yBAAyB;QACzB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,gBAAgB;gBACpB,OAAO,EAAE,QAAQ;gBACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAClC,OAAO,EAAE;oBACP,EAAE,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,4CAA4C,EAAE,KAAK,EAAE,IAAI,EAAE;iBAC5F;gBACD,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC,sCAAsC,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC"}

package/dist/search/adapters/http.d.ts

@@ -0,0 +1,6 @@
+import type { SearchAdapter } from './types.js';
+/**
+ * HTTP/API adapter — emits recipes for endpoint, route, and fetch queries.
+ * Distinguishes between route DEFINITIONS and outbound API CALLS.
+ */
+export declare const httpAdapter: SearchAdapter;

package/dist/search/adapters/http.js

@@ -0,0 +1,58 @@
+/**
+ * HTTP/API adapter — emits recipes for endpoint, route, and fetch queries.
+ * Distinguishes between route DEFINITIONS and outbound API CALLS.
+ */
+export const httpAdapter = {
+    id: 'http',
+    detect(ir) {
+        if (!ir.traits.routeLike)
+            return [];
+        const recipes = [];
+        const isDefinitionQuery = ir.nlTokens.some((t) => ['endpoint', 'route', 'handler', 'defined', 'registered'].includes(t));
+        const isCallQuery = ir.nlTokens.some((t) => ['fetch', 'request', 'http', 'call', 'calls'].includes(t));
+        // Route/endpoint DEFINITION queries — server-side handler registration
+        if (isDefinitionQuery) {
+            recipes.push({
+                id: 'http.route-definition',
+                adapter: 'http',
+                retrievers: ['behavior', 'regex', 'config'],
+                regexes: [
+                    // Express/Fastify/Koa-style route registration
+                    { id: 'express-route', pattern: '(?:app|router)\\.(get|post|put|delete|patch|use)\\s*\\(', flags: 'gi' },
+                    // Next.js API route handlers
+                    { id: 'next-api-handler', pattern: 'export\\s+(?:default\\s+)?(?:async\\s+)?function\\s+(?:GET|POST|PUT|DELETE|PATCH|handler)', flags: 'g' },
+                    // Route config objects
+                    { id: 'route-config', pattern: '(?:routes|endpoints)\\s*[:=]\\s*[\\[{]', flags: 'gi' },
+                ],
+                scoreBoost: 3,
+                reasons: ['HTTP adapter: route/endpoint definition query'],
+            });
+        }
+        // Outbound API CALL queries — client-side fetch/request
+        if (isCallQuery && !isDefinitionQuery) {
+            recipes.push({
+                id: 'http.api-call',
+                adapter: 'http',
+                retrievers: ['behavior', 'regex'],
+                regexes: [
+                    { id: 'fetch-call', pattern: '(?:fetch|axios|request)\\s*\\(', flags: 'g' },
+                    { id: 'http-method', pattern: '\\.(get|post|put|delete|patch)\\s*\\(', flags: 'g' },
+                ],
+                scoreBoost: 1,
+                reasons: ['HTTP adapter: outbound API call query'],
+            });
+        }
+        // Ambiguous — both definition and call traits
+        if (!isDefinitionQuery && !isCallQuery) {
+            recipes.push({
+                id: 'http.general',
+                adapter: 'http',
+                retrievers: ['behavior', 'config'],
+                scoreBoost: 1,
+                reasons: ['HTTP adapter: general route/API query'],
+            });
+        }
+        return recipes;
+    },
+};
+//# sourceMappingURL=http.js.map

package/dist/search/adapters/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/search/adapters/http.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,EAAE,EAAE,MAAM;IAEV,MAAM,CAAC,EAAW;QAChB,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAEpC,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,MAAM,iBAAiB,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACzH,MAAM,WAAW,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvG,uEAAuE;QACvE,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,uBAAuB;gBAC3B,OAAO,EAAE,MAAM;gBACf,UAAU,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC;gBAC3C,OAAO,EAAE;oBACP,+CAA+C;oBAC/C,EAAE,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,yDAAyD,EAAE,KAAK,EAAE,IAAI,EAAE;oBACxG,6BAA6B;oBAC7B,EAAE,EAAE,EAAE,kBAAkB,EAAE,OAAO,EAAE,2FAA2F,EAAE,KAAK,EAAE,GAAG,EAAE;oBAC5I,uBAAuB;oBACvB,EAAE,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,wCAAwC,EAAE,KAAK,EAAE,IAAI,EAAE;iBACvF;gBACD,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC,+CAA+C,CAAC;aAC3D,CAAC,CAAC;QACL,CAAC;QAED,wDAAwD;QACxD,IAAI,WAAW,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,eAAe;gBACnB,OAAO,EAAE,MAAM;gBACf,UAAU,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;gBACjC,OAAO,EAAE;oBACP,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,gCAAgC,EAAE,KAAK,EAAE,GAAG,EAAE;oBAC3E,EAAE,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,uCAAuC,EAAE,KAAK,EAAE,GAAG,EAAE;iBACpF;gBACD,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC,uCAAuC,CAAC;aACnD,CAAC,CAAC;QACL,CAAC;QAED,8CAA8C;QAC9C,IAAI,CAAC,iBAAiB,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,cAAc;gBAClB,OAAO,EAAE,MAAM;gBACf,UAAU,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;gBAClC,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC,uCAAuC,CAAC;aACnD,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC"}

package/dist/search/adapters/react.d.ts

@@ -0,0 +1,12 @@
+import type { SearchAdapter } from './types.js';
+/**
+ * React adapter — emits search recipes for React hook/component queries.
+ *
+ * Recipes:
+ * - react.useeffect.conditional-cleanup
+ * - react.useeffect.functional-state-updater
+ * - react.usememo.computation
+ * - react.usecallback.memoized-handler
+ * - react.hook.general (fallback for any hook query)
+ */
+export declare const reactAdapter: SearchAdapter;