lsp-intelligence 0.1.2 → 0.2.1

package/dist/search/types.d.ts

@@ -0,0 +1,191 @@
+export type StructuralPredicate = 'conditional' | 'returns-function' | 'returns-cleanup' | 'no-cleanup' | 'has-try-catch' | 'no-try-catch' | 'switch-no-default' | 'await-in-loop' | 'inside-hook' | 'hook-callback' | 'functional-state-updater';
+export interface QueryTraits {
+    reactLike: boolean;
+    stateLike: boolean;
+    previousStateLike: boolean;
+    routeLike: boolean;
+    configLike: boolean;
+    implementationRoot: boolean;
+    testIntent: boolean;
+}
+export interface RegExpSpec {
+    id: string;
+    pattern: string;
+    flags?: string;
+}
+export interface SearchRecipe {
+    id: string;
+    adapter: string;
+    retrievers: Array<'behavior' | 'identifier' | 'structural' | 'regex' | 'doc' | 'config'>;
+    exactIdentifiers?: string[];
+    structuralPredicates?: StructuralPredicate[];
+    regexes?: RegExpSpec[];
+    scoreBoost?: number;
+    reasons: string[];
+}
+export interface QueryIR {
+    raw: string;
+    /** Natural-language tokens (lowercased, stop-words removed) */
+    nlTokens: string[];
+    /** Multi-word phrases preserved from the query */
+    phrases: string[];
+    /** Exact identifiers: useEffect, AbortController, useMemo */
+    exactIdentifiers: string[];
+    /** Dotted identifiers: Promise.all, React.useEffect */
+    dottedIdentifiers: string[];
+    /** Code-oriented tokens that aren't exact identifiers: cleanup, callback */
+    codeTokens: string[];
+    /** Per-family relevance scores */
+    familyScores: Record<string, number>;
+    /** Structural predicates inferred from the query */
+    structuralPredicates: StructuralPredicate[];
+    /** Semantic traits inferred from the query */
+    traits: QueryTraits;
+    /** Search recipes compiled from adapters */
+    recipes: SearchRecipe[];
+    /** Routing mode */
+    mode: 'behavior' | 'identifier' | 'structural' | 'mixed';
+    modeConfidence: 'high' | 'medium' | 'low';
+    routingReasons: string[];
+}
+export interface SearchPlan {
+    mode: 'behavior' | 'identifier' | 'structural' | 'mixed';
+    retrievers: Array<'behavior' | 'identifier' | 'structural' | 'regex' | 'doc' | 'config'>;
+    reasons: string[];
+    expandGraph: boolean;
+}
+export interface SearchScope {
+    roots: string[];
+    filePaths?: string[];
+    includeTests: boolean;
+}
+export interface CodeCandidate {
+    candidateType: 'declaration' | 'usage' | 'pattern' | 'doc' | 'config';
+    filePath: string;
+    line: number;
+    column?: number;
+    symbol?: string;
+    enclosingSymbol?: string;
+    enclosingKind?: string;
+    matchedIdentifier?: string;
+    kind?: 'function' | 'class' | 'method' | 'variable' | 'component' | 'file' | 'usage' | 'pattern' | 'config' | 'doc';
+    signature?: string;
+    snippet?: string;
+    context?: string;
+    score: number;
+    confidence?: 'high' | 'medium' | 'low';
+    evidence: string[];
+    sources: Array<'behavior' | 'identifier' | 'structural' | 'doc' | 'config' | 'lsp' | 'graph'>;
+}
+/**
+ * Deduplication key for candidates.
+ * Uses match identity, not just symbol name.
+ */
+export declare function candidateKey(c: CodeCandidate): string;
+export interface DeclarationIndexEntry {
+    symbol: string;
+    kind: string;
+    filePath: string;
+    line: number;
+    column: number;
+    isExported: boolean;
+    pathTokens: string[];
+    symbolTokens: string[];
+}
+export interface UsageIndexEntry {
+    identifier: string;
+    normalizedIdentifier: string;
+    kind: 'call' | 'member-call' | 'identifier' | 'import' | 'jsx-tag' | 'env-usage';
+    filePath: string;
+    line: number;
+    column: number;
+    enclosingSymbol?: string;
+    enclosingKind?: string;
+    pathTokens: string[];
+    metadata?: {
+        envKey?: string;
+    };
+}
+export interface DocIndexEntry {
+    filePath: string;
+    line: number;
+    kind: 'jsdoc' | 'comment' | 'test-title';
+    text: string;
+    tokens: string[];
+    attachedSymbol?: string;
+}
+export interface ConfigIndexEntry {
+    filePath: string;
+    line: number;
+    kind: 'json' | 'yaml' | 'env' | 'route' | 'package' | 'config';
+    keyPath?: string[];
+    text: string;
+    tokens: string[];
+}
+export interface IndexedFile {
+    filePath: string;
+    mtimeMs: number;
+    declarations: DeclarationIndexEntry[];
+    usages: UsageIndexEntry[];
+    docs: DocIndexEntry[];
+}
+export interface WorkspaceIndex {
+    root: string;
+    builtAt: number;
+    files: Map<string, IndexedFile>;
+    declarations: DeclarationIndexEntry[];
+    usages: UsageIndexEntry[];
+    docs: DocIndexEntry[];
+    configs: ConfigIndexEntry[];
+    scopeCapped: boolean;
+    capReason?: 'max-files' | 'max-depth';
+}
+export interface FindCodeDebugInfo {
+    recipes: string[];
+    retrieverStats: Record<string, number>;
+    scoreBreakdown: Array<{
+        candidateKey: string;
+        score: number;
+        evidence: string[];
+    }>;
+}
+export interface FindCodeResult {
+    query: string;
+    ir: QueryIR;
+    plan: SearchPlan;
+    confidence: 'high' | 'medium' | 'low';
+    candidates: CodeCandidate[];
+    stats: {
+        filesIndexed: number;
+        codeFilesIndexed: number;
+        configFilesIndexed: number;
+        scopeCapped: boolean;
+        declarationHits: number;
+        usageHits: number;
+        structuralHits: number;
+        regexHits: number;
+        docHits: number;
+        configHits: number;
+        graphExpanded: number;
+        lspEnriched: number;
+        elapsedMs: number;
+        partialResult: boolean;
+    };
+    warnings: string[];
+    debug?: FindCodeDebugInfo;
+}
+export interface PatternMatch {
+    filePath: string;
+    line: number;
+    column?: number;
+    text: string;
+    context: string;
+}
+export interface FindPatternResult {
+    pattern: string;
+    language: 'typescript' | 'tsx' | 'javascript' | 'jsx';
+    filesScanned: number;
+    matchCount: number;
+    matches: PatternMatch[];
+    warnings: string[];
+}

package/dist/search/types.js

@@ -0,0 +1,11 @@
+// ============================================================================
+// Query IR — the parsed representation of a user's search query
+// ============================================================================
+/**
+ * Deduplication key for candidates.
+ * Uses match identity, not just symbol name.
+ */
+export function candidateKey(c) {
+    return `${c.candidateType}:${c.filePath}:${c.line}:${c.column ?? 0}:${c.matchedIdentifier ?? c.symbol ?? ''}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gEAAgE;AAChE,+EAA+E;AA+H/E;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,CAAgB;IAC3C,OAAO,GAAG,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;AAChH,CAAC"}

package/dist/tools/composites/apiGuard.d.ts

@@ -0,0 +1 @@
+export declare const apiGuard: import("../registry.js").ToolDef;

package/dist/tools/composites/apiGuard.js

@@ -0,0 +1,172 @@
+import { z } from 'zod';
+import * as fs from 'fs';
+import { defineTool } from '../registry.js';
+import { relativePath, uriToPath, getPackageName } from '../../engine/positions.js';
+import { parseSource } from '../../ast/parseFile.js';
+import { extractExportDeclarations } from '../../ast/extractExportDeclarations.js';
+import { diffExportDeclarations } from '../../ast/diffDeclarationShapes.js';
+import { getMergeBase } from '../../git/getMergeBase.js';
+import { getChangedFiles } from '../../git/getChangedFiles.js';
+import { getBaseFileContent } from '../../git/getBaseFileContent.js';
+import { LspError, LspErrorCode, DEFAULT_TIMEOUTS } from '../../engine/types.js';
+import { collectScopeFiles } from '../../resolve/searchScope.js';
+// File collection uses shared searchScope (supports JS/TS/JSX/MJS/CJS)
+export const apiGuard = defineTool({
+    name: 'api_guard',
+    description: 'Detect public API contract changes: what exports changed, how they changed structurally, who consumes them, and the semver impact. Use before merging to catch accidental breaking changes.',
+    schema: z.object({
+        base: z.string().optional().describe('Git base ref. Defaults to merge-base with main.'),
+        scope: z.enum(['changed', 'all']).default('changed').describe('"changed" = only diff-modified files, "all" = scan all source files'),
+        symbol: z.string().optional().describe('Optional: narrow to a specific export name'),
+        file_path: z.string().optional().describe('Optional: narrow to a specific file'),
+    }),
+    async handler(params, engine) {
+        if (!engine.gitAvailable && params.scope === 'changed') {
+            throw new LspError(LspErrorCode.GIT_UNAVAILABLE, 'Git required for scope "changed". Use scope "all" instead.');
+        }
+        const timeout = DEFAULT_TIMEOUTS.composite;
+        const warnings = [];
+        let astUsed = false;
+        // Step 0: Resolve base ref
+        const base = engine.gitAvailable ? getMergeBase(engine.workspaceRoot, params.base) : undefined;
+        // Step 1: Get files in scope
+        let scopeFiles;
+        if (params.file_path) {
+            scopeFiles = [params.file_path];
+        }
+        else if (params.scope === 'changed' && base) {
+            scopeFiles = getChangedFiles(engine.workspaceRoot, base);
+        }
+        else {
+            scopeFiles = collectScopeFiles({ roots: [engine.workspaceRoot], includeTests: false }, 500);
+        }
+        if (scopeFiles.length === 0) {
+            return { summary: { exportsChecked: 0, changedExports: 0, breaking: 0, risky: 0, safe: 0, recommendedSemver: 'patch' }, entries: [], stats: { astUsed: false, filesParsed: 0, baseUsed: !!base, partialResult: false }, warnings: ['No files in scope'] };
+        }
+        // Step 2+3: Parse exports, diff
+        const entries = [];
+        let filesParsed = 0;
+        let totalExportsChecked = 0;
+        for (const filePath of scopeFiles) {
+            try {
+                const currentContent = fs.readFileSync(filePath, 'utf-8');
+                const currentRoot = parseSource(currentContent, filePath);
+                const currentExports = currentRoot
+                    ? (astUsed = true, extractExportDeclarations(currentRoot, currentContent))
+                    : extractExportDeclarations(null, currentContent);
+                totalExportsChecked += currentExports.length;
+                // Get base exports
+                let baseExports = extractExportDeclarations(null, '');
+                if (base) {
+                    const baseContent = getBaseFileContent(filePath, base, engine.workspaceRoot);
+                    if (baseContent) {
+                        const baseRoot = parseSource(baseContent, filePath);
+                        baseExports = baseRoot
+                            ? extractExportDeclarations(baseRoot, baseContent)
+                            : extractExportDeclarations(null, baseContent);
+                    }
+                }
+                const diffs = diffExportDeclarations(baseExports, currentExports);
+                for (const d of diffs) {
+                    if (params.symbol && d.name !== params.symbol)
+                        continue;
+                    entries.push({
+                        exportName: d.name,
+                        filePath,
+                        line: d.currentDecl?.line ?? d.baseDecl?.line,
+                        declarationKind: d.baseDecl?.declarationKind ?? d.currentDecl?.declarationKind,
+                        kind: d.kind,
+                        risk: d.risk,
+                        reason: d.reason,
+                        currentSignature: d.currentDecl?.signatureText,
+                        baseSignature: d.baseDecl?.signatureText,
+                        structuralDiff: d.structuralDiff,
+                        consumers: { samePackage: 0, crossPackage: 0, sampleFiles: [] },
+                        evidence: [],
+                    });
+                }
+                filesParsed++;
+            }
+            catch { }
+        }
+        // Step 4: Find consumers using declaration line data (no raw text rescanning)
+        let consumerChecks = 0;
+        for (const entry of entries.filter((e) => e.risk !== 'safe')) {
+            if (consumerChecks >= 15) {
+                warnings.push('Consumer lookup capped at 15 entries');
+                break;
+            }
+            try {
+                const { uri } = await engine.prepareFile(entry.filePath);
+                const exportLine0 = Math.max(0, (entry.line ?? 1) - 1);
+                const refs = await engine.request('textDocument/references', {
+                    textDocument: { uri },
+                    position: { line: exportLine0, character: 0 },
+                    context: { includeDeclaration: false },
+                }, timeout).catch((err) => { warnings.push(`Consumer lookup failed for ${entry.exportName}: ${err instanceof Error ? err.message : String(err)}`); return null; });
+                if (refs) {
+                    const currentPkg = getPackageName(entry.filePath);
+                    const samePackage = refs.filter((r) => getPackageName(uriToPath(r.uri)) === currentPkg).length;
+                    const crossPackage = refs.length - samePackage;
+                    const sampleFiles = [...new Set(refs.map((r) => relativePath(uriToPath(r.uri), engine.workspaceRoot)))].slice(0, 5);
+                    entry.consumers = { samePackage, crossPackage, sampleFiles };
+                    entry.evidence.push(`${crossPackage} cross-package, ${samePackage} same-package consumers`);
+                    // Populate diagnosticsInConsumers (sample up to 3 consumer files)
+                    let diagCount = 0;
+                    for (const fp of sampleFiles.slice(0, 3)) {
+                        try {
+                            const abs = fp.startsWith('/') ? fp : `${engine.workspaceRoot}/${fp}`;
+                            const { uri: consumerUri } = await engine.prepareFile(abs);
+                            const { waitForDiagnostics: waitDiag } = await import('../../engine/waitForDiagnostics.js');
+                            await waitDiag(engine.docManager, consumerUri, 500);
+                            diagCount += engine.docManager.getCachedDiagnostics(consumerUri).filter((d) => d.severity === 1).length;
+                        }
+                        catch (err) {
+                            warnings.push(`Consumer diagnostics failed for ${fp}: ${err instanceof Error ? err.message : String(err)}`);
+                        }
+                    }
+                    entry.diagnosticsInConsumers = diagCount;
+                    // Downgrade risk if no cross-package consumers
+                    if (crossPackage === 0 && entry.risk === 'risky') {
+                        entry.risk = 'safe';
+                        entry.reason += ' (no cross-package consumers)';
+                    }
+                }
+                consumerChecks++;
+            }
+            catch (err) {
+                warnings.push(`Consumer analysis failed for ${entry.exportName}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Step 5: Classify and summarize
+        const breaking = entries.filter((e) => e.risk === 'breaking').length;
+        const risky = entries.filter((e) => e.risk === 'risky').length;
+        const safe = entries.filter((e) => e.risk === 'safe').length;
+        // Semver: breaking → major, additive-only → minor, else patch
+        const hasAdditive = entries.some((e) => e.kind === 'added' && e.risk === 'safe');
+        const semver = breaking > 0 ? 'major' : hasAdditive ? 'minor' : 'patch';
+        const result = {
+            summary: {
+                exportsChecked: totalExportsChecked,
+                changedExports: entries.length,
+                breaking,
+                risky,
+                safe,
+                recommendedSemver: semver,
+            },
+            entries: entries.sort((a, b) => {
+                const riskOrder = { breaking: 0, risky: 1, safe: 2 };
+                return riskOrder[a.risk] - riskOrder[b.risk];
+            }),
+            stats: {
+                astUsed,
+                filesParsed,
+                baseUsed: !!base,
+                partialResult: consumerChecks >= 15,
+            },
+            warnings,
+        };
+        return result;
+    },
+});
+//# sourceMappingURL=apiGuard.js.map

package/dist/tools/composites/apiGuard.js.map

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

package/dist/tools/composites/explainError.js

@@ -14,8 +14,9 @@ export const explainError = defineTool({
     async handler(params, engine) {
         const { uri } = await engine.prepareFile(params.file_path);
         const timeout = DEFAULT_TIMEOUTS.composite;
-        // Wait for diagnostics
-        await new Promise((r) => setTimeout(r, 500));
+        // Wait for diagnostics (poll instead of fixed sleep)
+        const { waitForDiagnostics } = await import('../../engine/waitForDiagnostics.js');
+        await waitForDiagnostics(engine.docManager, uri, 800);
         const diags = engine.docManager.getCachedDiagnostics(uri);
         // Find diagnostic at or near the specified line
         const targetLine = params.line - 1; // 0-indexed

package/dist/tools/composites/explainError.js.map

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

package/dist/tools/composites/findCode.d.ts

@@ -0,0 +1 @@
+export declare const findCode: import("../registry.js").ToolDef;

package/dist/tools/composites/findCode.js

@@ -0,0 +1,145 @@
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+import { resolveSearchScope } from '../../resolve/searchScope.js';
+import { parseQuery } from '../../search/query/parseQuery.js';
+import { planQuery } from '../../search/query/planQuery.js';
+import { getWorkspaceIndex } from '../../search/index/workspaceIndex.js';
+import { retrieveBehaviorCandidates } from '../../search/retrievers/behaviorRetriever.js';
+import { retrieveIdentifierCandidates } from '../../search/retrievers/identifierRetriever.js';
+import { retrieveStructuralCandidates } from '../../search/retrievers/structuralRetriever.js';
+import { retrieveDocCandidates } from '../../search/retrievers/docRetriever.js';
+import { retrieveConfigCandidates } from '../../search/retrievers/configRetriever.js';
+import { mergeCandidates } from '../../search/ranking/mergeCandidates.js';
+import { coalesceCandidates } from '../../search/ranking/coalesceCandidates.js';
+import { rankCandidates } from '../../search/ranking/rankCandidates.js';
+import { assessConfidence } from '../../search/ranking/assessConfidence.js';
+import { retrieveTextPatternCandidates } from '../../search/retrievers/textPatternRetriever.js';
+import { compileEffectiveSearchSpec } from '../../search/query/compileEffectiveSearchSpec.js';
+import { expandToImplementationRoots } from '../../search/expand/graphExpansion.js';
+import { absoluteCandidateKey } from '../../search/ranking/candidateIdentity.js';
+import { buildDebugTrace } from '../../search/debug/trace.js';
+import { relativePath } from '../../engine/positions.js';
+export const findCode = defineTool({
+    name: 'find_code',
+    description: 'High-level code search: behavior discovery, identifier/API usage search, structural queries, config/route lookup, and implementation-root discovery. Routes automatically — the agent does not need to choose the backend.',
+    schema: z.object({
+        query: z.string().describe('Natural-language or code-oriented search query'),
+        paths: z.array(z.string()).optional().describe('Optional directories/files to narrow search'),
+        max_results: z.number().default(10),
+        include_tests: z.boolean().default(false),
+        focus: z.enum(['auto', 'implementation', 'usage', 'pattern', 'config']).default('auto'),
+        debug: z.boolean().optional().describe('Include debug trace in output'),
+    }),
+    async handler(params, engine) {
+        const startTime = Date.now();
+        const warnings = [];
+        const scope = resolveSearchScope(engine.workspaceRoot, params.paths, params.include_tests);
+        const ir = parseQuery(params.query, { forcedFocus: params.focus });
+        const plan = planQuery(ir);
+        const index = getWorkspaceIndex(scope);
+        const spec = compileEffectiveSearchSpec(ir, plan);
+        const behavior = plan.retrievers.includes('behavior')
+            ? retrieveBehaviorCandidates(ir, scope, index, spec)
+            : [];
+        const identifier = plan.retrievers.includes('identifier')
+            ? retrieveIdentifierCandidates(ir, scope, index, spec)
+            : [];
+        const structural = plan.retrievers.includes('structural')
+            ? retrieveStructuralCandidates(ir, scope, index, spec)
+            : [];
+        const doc = plan.retrievers.includes('doc')
+            ? retrieveDocCandidates(ir, scope, index, spec)
+            : [];
+        const config = plan.retrievers.includes('config')
+            ? retrieveConfigCandidates(ir, scope, index, spec)
+            : [];
+        const regex = plan.retrievers.includes('regex')
+            ? retrieveTextPatternCandidates(ir, scope, index, spec)
+            : [];
+        const merged = mergeCandidates({ behavior, identifier, structural, regex, doc, config });
+        const coalesced = coalesceCandidates(merged);
+        const ranked = await rankCandidates(coalesced, { ir, plan, engine, scope });
+        // Graph expansion for implementation-root promotion
+        let graphExpanded = 0;
+        if (plan.expandGraph && ranked.length > 0) {
+            try {
+                const expansion = await expandToImplementationRoots(ranked, engine);
+                graphExpanded = expansion.promoted.size;
+                // Apply score promotions/demotions using canonical keys
+                for (const [key, promo] of expansion.promoted) {
+                    for (const c of ranked) {
+                        if (absoluteCandidateKey(c) === key) {
+                            c.score += promo.scoreDelta;
+                            c.evidence.push(...promo.evidence);
+                            if (!c.sources.includes('graph'))
+                                c.sources.push('graph');
+                        }
+                    }
+                }
+                // Merge derived candidates (implementation roots found by LSP)
+                for (const derived of expansion.derived) {
+                    derived.filePath = relativePath(derived.filePath, engine.workspaceRoot);
+                    ranked.push(derived);
+                }
+                ranked.sort((a, b) => b.score - a.score);
+                warnings.push(...expansion.warnings);
+            }
+            catch (err) {
+                warnings.push(`graph-expansion failed: ${err?.message ?? 'unknown'}`);
+            }
+        }
+        const confidence = assessConfidence(ranked, ir, plan);
+        const topResults = ranked.slice(0, params.max_results);
+        const lspEnriched = ranked.filter((c) => c.sources.includes('lsp')).length;
+        // Track partial results
+        let partialResult = false;
+        const hasConfigResults = config.length > 0;
+        if (index.files.size === 0 && !hasConfigResults) {
+            warnings.push('no files found in scope');
+            partialResult = true;
+        }
+        if (index.scopeCapped) {
+            partialResult = true;
+            warnings.push(`scope capped: ${index.capReason ?? 'unknown'} — results may be incomplete`);
+        }
+        // Debug info
+        let debug;
+        if (params.debug) {
+            debug = buildDebugTrace(ir, plan, topResults, {
+                behavior: behavior.length,
+                identifier: identifier.length,
+                structural: structural.length,
+                regex: regex.length,
+                doc: doc.length,
+                config: config.length,
+            });
+        }
+        const result = {
+            query: params.query,
+            ir,
+            plan,
+            confidence,
+            candidates: topResults,
+            stats: {
+                filesIndexed: index.files.size,
+                codeFilesIndexed: index.files.size,
+                configFilesIndexed: index.configs.length,
+                scopeCapped: index.scopeCapped,
+                declarationHits: behavior.length,
+                usageHits: identifier.length,
+                structuralHits: structural.length,
+                regexHits: regex.length,
+                docHits: doc.length,
+                configHits: config.length,
+                graphExpanded,
+                lspEnriched,
+                elapsedMs: Date.now() - startTime,
+                partialResult,
+            },
+            warnings,
+            debug,
+        };
+        return result;
+    },
+});
+//# sourceMappingURL=findCode.js.map

package/dist/tools/composites/findCode.js.map

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

package/dist/tools/composites/findPattern.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Thin wrapper over runPatternSearch().
+ * No duplicated file collection or parse loops.
+ */
+export declare const findPattern: import("../registry.js").ToolDef;

package/dist/tools/composites/findPattern.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+import { resolveSearchScope } from '../../resolve/searchScope.js';
+import { runPatternSearch } from '../../analysis/pattern/runPatternSearch.js';
+/**
+ * Thin wrapper over runPatternSearch().
+ * No duplicated file collection or parse loops.
+ */
+export const findPattern = defineTool({
+    name: 'find_pattern',
+    description: 'Search for AST structural patterns across the codebase using ast-grep. Use $VAR for single node, $$$ for multiple nodes. Example: "useEffect($$$)" finds all useEffect calls.',
+    schema: z.object({
+        pattern: z.string().describe('ast-grep pattern. Use $VAR for single node, $$$ for any sequence.'),
+        language: z.enum(['typescript', 'tsx', 'javascript', 'jsx']).default('typescript'),
+        paths: z.array(z.string()).optional().describe('Limit search to specific directories (absolute paths)'),
+        max_results: z.number().default(50),
+        context_lines: z.number().default(1),
+        include_tests: z.boolean().default(true).describe('Include test/spec files in results'),
+    }),
+    async handler(params, engine) {
+        const scope = resolveSearchScope(engine.workspaceRoot, params.paths, params.include_tests);
+        const { filesScanned, matches, warnings } = runPatternSearch({
+            pattern: params.pattern,
+            language: params.language,
+            scope,
+            maxResults: params.max_results,
+            contextLines: params.context_lines,
+            workspaceRoot: engine.workspaceRoot,
+        });
+        const result = {
+            pattern: params.pattern,
+            language: params.language,
+            filesScanned,
+            matchCount: matches.length,
+            matches,
+            warnings,
+        };
+        return result;
+    },
+});
+//# sourceMappingURL=findPattern.js.map

package/dist/tools/composites/findPattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findPattern.js","sourceRoot":"","sources":["../../../src/tools/composites/findPattern.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAG9E;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;IACpC,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,+KAA+K;IACjL,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;QACjG,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;QAClF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;QACvG,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QACpC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;KACxF,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM;QAC1B,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;QAE3F,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC;YAC3D,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK;YACL,UAAU,EAAE,MAAM,CAAC,WAAW;YAC9B,YAAY,EAAE,MAAM,CAAC,aAAa;YAClC,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAsB;YAChC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY;YACZ,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,OAAO;YACP,QAAQ;SACT,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/composites/rootCauseTrace.d.ts

@@ -0,0 +1 @@
+export declare const rootCauseTrace: import("../registry.js").ToolDef;