lsp-intelligence 0.1.2 → 0.2.0

package/dist/ast/findNodeAtPosition.js

@@ -0,0 +1,75 @@
+/**
+ * Find the smallest AST node covering a given line (0-indexed).
+ */
+export function findNodeAtLine(root, line0) {
+    let best = null;
+    let bestSize = Infinity;
+    const walk = (node) => {
+        const range = node.range();
+        if (range.start.line <= line0 && range.end.line >= line0) {
+            const size = range.end.line - range.start.line;
+            if (size < bestSize) {
+                best = node;
+                bestSize = size;
+            }
+            for (const child of node.children()) {
+                walk(child);
+            }
+        }
+    };
+    walk(root);
+    if (!best)
+        return null;
+    return { node: best, kind: classifyNodeKind(best) };
+}
+function classifyNodeKind(node) {
+    const kind = String(node.kind());
+    if (kind.includes('call'))
+        return 'call_expression';
+    if (kind.includes('member') || kind.includes('property_access'))
+        return 'property_access';
+    if (kind.includes('variable') || kind.includes('lexical'))
+        return 'variable_declaration';
+    if (kind.includes('return'))
+        return 'return_statement';
+    if (kind.includes('switch'))
+        return 'switch_case';
+    if (kind.includes('object'))
+        return 'object_literal';
+    if (kind.includes('function') || kind.includes('arrow'))
+        return 'function';
+    if (kind.includes('class'))
+        return 'class';
+    if (kind.includes('if'))
+        return 'conditional';
+    if (kind.includes('import'))
+        return 'import';
+    if (kind.includes('export'))
+        return 'export';
+    return kind;
+}
+/**
+ * Classify the error site based on the enclosing AST node.
+ */
+export function classifyErrorSite(root, line0) {
+    const result = findNodeAtLine(root, line0);
+    if (!result)
+        return null;
+    const { kind } = result;
+    if (kind === 'call_expression')
+        return 'bad_call_argument';
+    if (kind === 'property_access')
+        return 'missing_property_access';
+    if (kind === 'switch_case')
+        return 'unhandled_enum_member';
+    if (kind === 'import')
+        return 'bad_import_usage';
+    if (kind === 'return_statement')
+        return 'wrong_return_type';
+    if (kind === 'variable_declaration')
+        return 'incompatible_assignment';
+    if (kind === 'object_literal')
+        return 'missing_object_property';
+    return kind;
+}
+//# sourceMappingURL=findNodeAtPosition.js.map

package/dist/ast/findNodeAtPosition.js.map

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

package/dist/ast/parseFile.d.ts

@@ -0,0 +1,10 @@
+import { type SgNode } from '@ast-grep/napi';
+/**
+ * Parse a TypeScript/TSX file into an ast-grep root node.
+ * Returns null if parsing fails.
+ */
+export declare function parseFile(filePath: string): SgNode | null;
+/**
+ * Parse source content directly.
+ */
+export declare function parseSource(content: string, isTsx?: boolean): SgNode | null;

package/dist/ast/parseFile.js

@@ -0,0 +1,29 @@
+import * as fs from 'fs';
+import { parse, Lang } from '@ast-grep/napi';
+/**
+ * Parse a TypeScript/TSX file into an ast-grep root node.
+ * Returns null if parsing fails.
+ */
+export function parseFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lang = filePath.endsWith('.tsx') ? Lang.Tsx : Lang.TypeScript;
+        return parse(lang, content).root();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse source content directly.
+ */
+export function parseSource(content, isTsx = false) {
+    try {
+        const lang = isTsx ? Lang.Tsx : Lang.TypeScript;
+        return parse(lang, content).root();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=parseFile.js.map

package/dist/ast/parseFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseFile.js","sourceRoot":"","sources":["../../src/ast/parseFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAe,MAAM,gBAAgB,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QACpE,OAAO,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,KAAK,GAAG,KAAK;IACxD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAChD,OAAO,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/engine/waitForDiagnostics.d.ts

@@ -0,0 +1,7 @@
+import type { DocumentManager } from './DocumentManager.js';
+/**
+ * Wait for diagnostics to be pushed for a URI.
+ * Polls every 100ms, returns as soon as diagnostics arrive or timeout hit.
+ * Much faster than a fixed sleep when diagnostics arrive quickly.
+ */
+export declare function waitForDiagnostics(docManager: DocumentManager, uri: string, timeoutMs?: number): Promise<void>;

package/dist/engine/waitForDiagnostics.js

@@ -0,0 +1,16 @@
+/**
+ * Wait for diagnostics to be pushed for a URI.
+ * Polls every 100ms, returns as soon as diagnostics arrive or timeout hit.
+ * Much faster than a fixed sleep when diagnostics arrive quickly.
+ */
+export async function waitForDiagnostics(docManager, uri, timeoutMs = 1000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        const diags = docManager.getCachedDiagnostics(uri);
+        if (diags.length > 0)
+            return;
+        await new Promise((r) => setTimeout(r, 100));
+    }
+    // Timeout — diagnostics may still arrive later, but we don't block further
+}
+//# sourceMappingURL=waitForDiagnostics.js.map

package/dist/engine/waitForDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForDiagnostics.js","sourceRoot":"","sources":["../../src/engine/waitForDiagnostics.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAA2B,EAC3B,GAAW,EACX,YAAoB,IAAI;IAExB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACnD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO;QAC7B,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,2EAA2E;AAC7E,CAAC"}

package/dist/git/getBaseFileContent.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Get file content at a specific git ref.
+ * Returns null if file didn't exist at that ref.
+ */
+export declare function getBaseFileContent(filePath: string, base: string, workspaceRoot: string): string | null;

package/dist/git/getBaseFileContent.js

@@ -0,0 +1,16 @@
+import { execSync } from 'child_process';
+import { relativePath } from '../engine/positions.js';
+/**
+ * Get file content at a specific git ref.
+ * Returns null if file didn't exist at that ref.
+ */
+export function getBaseFileContent(filePath, base, workspaceRoot) {
+    try {
+        const relPath = relativePath(filePath, workspaceRoot);
+        return execSync(`git show ${base}:${relPath}`, { cwd: workspaceRoot, encoding: 'utf-8' });
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=getBaseFileContent.js.map

package/dist/git/getBaseFileContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBaseFileContent.js","sourceRoot":"","sources":["../../src/git/getBaseFileContent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,IAAY,EACZ,aAAqB;IAErB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACtD,OAAO,QAAQ,CAAC,YAAY,IAAI,IAAI,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/git/getChangedFiles.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Get list of changed TypeScript files between base and HEAD.
+ */
+export declare function getChangedFiles(workspaceRoot: string, base: string, filter?: (f: string) => boolean): string[];

package/dist/git/getChangedFiles.js

@@ -0,0 +1,21 @@
+import { execSync } from 'child_process';
+import * as path from 'path';
+import * as fs from 'fs';
+/**
+ * Get list of changed TypeScript files between base and HEAD.
+ */
+export function getChangedFiles(workspaceRoot, base, filter = (f) => /\.tsx?$/.test(f) && !f.endsWith('.d.ts')) {
+    try {
+        const diff = execSync(`git diff ${base} --name-only`, { cwd: workspaceRoot, encoding: 'utf-8' });
+        return diff
+            .trim()
+            .split('\n')
+            .filter((f) => f && filter(f))
+            .map((f) => path.join(workspaceRoot, f))
+            .filter((f) => fs.existsSync(f));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=getChangedFiles.js.map

package/dist/git/getChangedFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getChangedFiles.js","sourceRoot":"","sources":["../../src/git/getChangedFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,aAAqB,EACrB,IAAY,EACZ,SAAiC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IAEjF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,IAAI,cAAc,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACjG,OAAO,IAAI;aACR,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;aAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;aACvC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/git/getChangedHunks.d.ts

@@ -0,0 +1,13 @@
+export interface ChangedHunk {
+    file: string;
+    startLine: number;
+    endLine: number;
+}
+/**
+ * Parse git diff to extract changed line ranges per file.
+ */
+export declare function getChangedHunks(workspaceRoot: string, base: string): ChangedHunk[];
+/**
+ * Check if a specific file changed between base and HEAD.
+ */
+export declare function fileChangedInBranch(filePath: string, base: string, workspaceRoot: string): boolean;

package/dist/git/getChangedHunks.js

@@ -0,0 +1,51 @@
+import { execSync } from 'child_process';
+import * as path from 'path';
+/**
+ * Parse git diff to extract changed line ranges per file.
+ */
+export function getChangedHunks(workspaceRoot, base) {
+    try {
+        const diff = execSync(`git diff ${base} --unified=0`, { cwd: workspaceRoot, encoding: 'utf-8' });
+        return parseHunks(diff, workspaceRoot);
+    }
+    catch {
+        return [];
+    }
+}
+function parseHunks(diff, workspaceRoot) {
+    const hunks = [];
+    let currentFile = '';
+    for (const line of diff.split('\n')) {
+        const fileMatch = line.match(/^\+\+\+ b\/(.+)/);
+        if (fileMatch) {
+            currentFile = path.join(workspaceRoot, fileMatch[1]);
+            continue;
+        }
+        const hunkMatch = line.match(/^@@ .+ \+(\d+)(?:,(\d+))? @@/);
+        if (hunkMatch && currentFile.match(/\.tsx?$/)) {
+            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 relPath = filePath.startsWith(workspaceRoot)
+            ? filePath.slice(workspaceRoot.length + 1)
+            : filePath;
+        const diff = execSync(`git diff ${base} --name-only -- "${relPath}"`, {
+            cwd: workspaceRoot,
+            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;AAQ7B;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,aAAqB,EAAE,IAAY;IACjE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,IAAI,cAAc,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACjG,OAAO,UAAU,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,aAAqB;IACrD,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,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACrD,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC7D,IAAI,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9C,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,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC;YAChD,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1C,CAAC,CAAC,QAAQ,CAAC;QACb,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,IAAI,oBAAoB,OAAO,GAAG,EAAE;YACpE,GAAG,EAAE,aAAa;YAClB,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/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';
@@ -61,6 +65,10 @@ async function main() {
         semanticDiff,
         findTestFiles,
         explainError,
+        findPattern,
+        findCode,
+        apiGuard,
+        rootCauseTrace,
         // Layer 3: Context
         outline,
         gatherContext,

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,11 @@
+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 TypeScript/TSX files within the search scope.
+ * Respects includeTests and SKIP_DIRS.
+ */
+export declare function collectScopeFiles(scope: SearchScope, maxFiles?: number): string[];

package/dist/resolve/searchScope.js

@@ -0,0 +1,52 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { SKIP_DIRS } from '../engine/types.js';
+const TEST_PATTERN = /\.(spec|test|stories)\.(ts|tsx|js|jsx)$/;
+/**
+ * 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,
+    };
+}
+/**
+ * Collect all TypeScript/TSX files within the search scope.
+ * Respects includeTests and SKIP_DIRS.
+ */
+export function collectScopeFiles(scope, maxFiles = 2000) {
+    const files = [];
+    for (const root of scope.roots) {
+        walkDir(root, files, scope.includeTests, maxFiles, 0);
+        if (files.length >= maxFiles)
+            break;
+    }
+    return files;
+}
+function walkDir(dir, files, includeTests, maxFiles, depth) {
+    if (depth > 8 || files.length >= maxFiles)
+        return;
+    try {
+        for (const entry of fs.readdirSync(dir)) {
+            if (SKIP_DIRS.has(entry))
+                continue;
+            const full = path.join(dir, entry);
+            const stat = fs.statSync(full);
+            if (stat.isDirectory()) {
+                walkDir(full, files, includeTests, maxFiles, depth + 1);
+            }
+            else if ((entry.endsWith('.ts') || entry.endsWith('.tsx')) && !entry.endsWith('.d.ts')) {
+                if (!includeTests && TEST_PATTERN.test(entry))
+                    continue;
+                files.push(full);
+            }
+        }
+    }
+    catch { }
+}
+//# 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":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,YAAY,GAAG,yCAAyC,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,aAAqB,EACrB,KAAgB,EAChB,YAAsB;IAEtB,MAAM,KAAK,GAAG,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QACrC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAEpB,OAAO;QACL,KAAK;QACL,YAAY,EAAE,YAAY,IAAI,KAAK;KACpC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAkB,EAAE,WAAmB,IAAI;IAC3E,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;YAAE,MAAM;IACtC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CACd,GAAW,EACX,KAAe,EACf,YAAqB,EACrB,QAAgB,EAChB,KAAa;IAEb,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO;IAClD,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC1D,CAAC;iBAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzF,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACxD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC"}

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":"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"}

package/dist/search/families/behaviorFamilies.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Behavior families — redesigned with classifier/expansion split.
+ *
+ * classifierTerms: strong terms only. Weak words (use, get, set, call, run, make)
+ * must NEVER appear here. These drive mode routing.
+ *
+ * expansionTerms: broader lexical expansion for recall. May include weaker terms.
+ */
+export interface BehaviorFamily {
+    id: string;
+    classifierTerms: string[];
+    expansionTerms: string[];
+    fileHints: string[];
+    symbolHints: string[];
+}
+export declare const BEHAVIOR_FAMILIES: BehaviorFamily[];
+/**
+ * Score a set of tokens against all families.
+ * Uses only classifierTerms for strong matching.
+ * Returns per-family scores.
+ */
+export declare function scoreFamilies(tokens: string[]): Record<string, number>;