lsp-intelligence 0.1.0

package/dist/index.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+import { createRequire } from 'module';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+import { LspEngine } from './engine/LspEngine.js';
+import { registerAll } from './tools/registry.js';
+// Primitives
+import { findReferences } from './tools/primitives/findReferences.js';
+import { gotoDefinition } from './tools/primitives/gotoDefinition.js';
+import { gotoTypeDefinition } from './tools/primitives/gotoTypeDefinition.js';
+import { hover } from './tools/primitives/hover.js';
+import { findImplementations } from './tools/primitives/findImplementations.js';
+import { documentSymbols } from './tools/primitives/documentSymbols.js';
+import { workspaceSymbols } from './tools/primitives/workspaceSymbols.js';
+import { callHierarchy } from './tools/primitives/callHierarchy.js';
+import { typeHierarchy } from './tools/primitives/typeHierarchy.js';
+import { rename } from './tools/primitives/rename.js';
+import { diagnostics } from './tools/primitives/diagnostics.js';
+import { completions } from './tools/primitives/completions.js';
+import { fileImports } from './tools/primitives/fileImports.js';
+import { fileExports } from './tools/primitives/fileExports.js';
+// Composites
+import { inspectSymbol } from './tools/composites/inspectSymbol.js';
+import { batchQuery } from './tools/composites/batchQuery.js';
+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';
+// Context
+import { outline } from './tools/context/outline.js';
+import { gatherContext } from './tools/context/gatherContext.js';
+// Live
+import { liveDiagnostics } from './tools/live/liveDiagnostics.js';
+import { findUnusedExports } from './tools/live/findUnusedExports.js';
+import { autoImport } from './tools/live/autoImport.js';
+const workspaceRoot = process.env.LSP_WORKSPACE_ROOT || process.cwd();
+async function main() {
+    console.error(`[lsp-intelligence] Starting with workspace: ${workspaceRoot}`);
+    const engine = new LspEngine(workspaceRoot);
+    const server = new McpServer({ name: 'lsp-intelligence', version }, { capabilities: { tools: {} } });
+    registerAll(server, engine, [
+        // Layer 1: Primitives
+        findReferences,
+        gotoDefinition,
+        gotoTypeDefinition,
+        hover,
+        findImplementations,
+        documentSymbols,
+        workspaceSymbols,
+        callHierarchy,
+        typeHierarchy,
+        rename,
+        diagnostics,
+        completions,
+        fileImports,
+        fileExports,
+        // Layer 2: Composites
+        inspectSymbol,
+        batchQuery,
+        impactTrace,
+        semanticDiff,
+        findTestFiles,
+        explainError,
+        // Layer 3: Context
+        outline,
+        gatherContext,
+        // Layer 4: Live
+        liveDiagnostics,
+        findUnusedExports,
+        autoImport,
+    ]);
+    engine.initialize().catch((err) => {
+        console.error(`[lsp-intelligence] Engine initialization failed: ${err.message}`);
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[lsp-intelligence] MCP server running on stdio');
+    process.on('SIGTERM', async () => { await engine.shutdown(); process.exit(0); });
+    process.on('SIGINT', async () => { await engine.shutdown(); process.exit(0); });
+}
+main().catch((err) => {
+    console.error(`[lsp-intelligence] Fatal: ${err.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

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

package/dist/tools/composites/batchQuery.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+import { formatHover } from '../../format/markdown.js';
+import { DEFAULT_TIMEOUTS } from '../../engine/types.js';
+export const batchQuery = defineTool({
+    name: 'batch_query',
+    description: 'Look up multiple symbols in one call. Returns hover + reference count for each. Saves multiple round-trips when exploring a file.',
+    schema: z.object({
+        symbols: z.array(z.string()).describe('List of symbol names to look up'),
+        include_references: z.boolean().default(true).describe('Include reference counts'),
+    }),
+    async handler(params, engine) {
+        const timeout = DEFAULT_TIMEOUTS.composite;
+        const results = [`# Batch Query: ${params.symbols.length} symbols\n`];
+        for (const symbol of params.symbols) {
+            try {
+                const resolved = await engine.resolveSymbol(symbol);
+                const uri = resolved.uri;
+                const position = resolved.position;
+                const hover = await engine.request('textDocument/hover', { textDocument: { uri }, position }, timeout).catch(() => null);
+                let refCount = 0;
+                if (params.include_references) {
+                    const refs = await engine.request('textDocument/references', {
+                        textDocument: { uri }, position, context: { includeDeclaration: false },
+                    }, timeout).catch(() => null);
+                    refCount = refs?.length ?? 0;
+                }
+                const hoverText = formatHover(hover);
+                const sig = hoverText.length > 200 ? hoverText.substring(0, 200) + '...' : hoverText;
+                results.push(`## ${symbol}${refCount > 0 ? ` (${refCount} refs)` : ''}\n\n${sig}\n`);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                results.push(`## ${symbol}\n\n*Error: ${msg}*\n`);
+            }
+        }
+        return results.join('\n');
+    },
+});
+//# sourceMappingURL=batchQuery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batchQuery.js","sourceRoot":"","sources":["../../../src/tools/composites/batchQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAoB,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;IACnC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,mIAAmI;IAChJ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACxE,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;KACnF,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM;QAC1B,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC;QAC3C,MAAM,OAAO,GAAa,CAAC,kBAAkB,MAAM,CAAC,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC;QAEhF,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;gBACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;gBACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;gBAEnC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAChC,oBAAoB,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,CACnE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;gBAEpB,IAAI,QAAQ,GAAG,CAAC,CAAC;gBACjB,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;oBAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAC/B,yBAAyB,EAAE;wBACzB,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE;qBACxE,EAAE,OAAO,CACX,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;oBACpB,QAAQ,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC;gBAC/B,CAAC;gBAED,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;gBACrC,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;gBACrF,OAAO,CAAC,IAAI,CAAC,MAAM,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;YACvF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO,CAAC,IAAI,CAAC,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC,CAAC"}

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

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

package/dist/tools/composites/explainError.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+import { fromPosition, relativePath } from '../../engine/positions.js';
+import { formatHover } from '../../format/markdown.js';
+import { DEFAULT_TIMEOUTS } from '../../engine/types.js';
+export const explainError = defineTool({
+    name: 'explain_error',
+    description: 'Explain a TypeScript error with full context: what type was expected, what was provided, and why. Turns cryptic TS errors into actionable fixes.',
+    schema: z.object({
+        file_path: z.string().describe('Absolute file path containing the error'),
+        line: z.number().describe('1-indexed line number of the error'),
+        column: z.number().optional().default(1).describe('1-indexed column number (defaults to 1)'),
+    }),
+    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));
+        const diags = engine.docManager.getCachedDiagnostics(uri);
+        // Find diagnostic at or near the specified line
+        const targetLine = params.line - 1; // 0-indexed
+        const diag = diags.find((d) => d.range.start.line === targetLine)
+            ?? diags.find((d) => Math.abs(d.range.start.line - targetLine) <= 2);
+        if (!diag) {
+            const rel = relativePath(params.file_path, engine.workspaceRoot);
+            return `No error found at ${rel}:${params.line}. File may be clean or diagnostics haven't been pushed yet.`;
+        }
+        const errorPos = { line: diag.range.start.line, character: diag.range.start.character };
+        // Get hover info at the error position (type information)
+        const hoverResult = await engine.request('textDocument/hover', { textDocument: { uri }, position: errorPos }, timeout).catch(() => null);
+        // Get type definition to understand expected type
+        const typeDef = await engine.request('textDocument/typeDefinition', { textDocument: { uri }, position: errorPos }, timeout).catch(() => null);
+        const rel = relativePath(params.file_path, engine.workspaceRoot);
+        const pos = fromPosition(diag.range.start);
+        const severity = diag.severity === 1 ? 'Error' : diag.severity === 2 ? 'Warning' : 'Info';
+        const code = diag.code ? `TS${diag.code}` : '';
+        const lines = [`# ${severity}: ${rel}:${pos.line}\n`];
+        lines.push(`**${code}**: ${diag.message}\n`);
+        if (hoverResult) {
+            const hoverText = formatHover(hoverResult);
+            if (hoverText && !hoverText.includes('No hover')) {
+                lines.push(`## Type at error location\n\n${hoverText}\n`);
+            }
+        }
+        if (diag.relatedInformation) {
+            lines.push('## Related\n');
+            for (const related of diag.relatedInformation) {
+                const relPath = relativePath(related.location.uri, engine.workspaceRoot);
+                const relPos = fromPosition(related.location.range.start);
+                lines.push(`- ${relPath}:${relPos.line}: ${related.message}`);
+            }
+        }
+        return lines.join('\n');
+    },
+});
+//# sourceMappingURL=explainError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explainError.js","sourceRoot":"","sources":["../../../src/tools/composites/explainError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAa,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;IACrC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,kJAAkJ;IAC/J,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACzE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAC/D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;KAC7F,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM;QAC1B,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC;QAE3C,uBAAuB;QACvB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAE1D,gDAAgD;QAChD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,YAAY;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;eAC5D,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAEvE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;YACjE,OAAO,qBAAqB,GAAG,IAAI,MAAM,CAAC,IAAI,6DAA6D,CAAC;QAC9G,CAAC;QAED,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAExF,0DAA0D;QAC1D,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,OAAO,CACtC,oBAAoB,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,OAAO,CAC7E,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAEpB,kDAAkD;QAClD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAClC,6BAA6B,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,OAAO,CACtF,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAEpB,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE/C,MAAM,KAAK,GAAG,CAAC,KAAK,QAAQ,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAE7C,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;YAC3C,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,gCAAgC,SAAS,IAAI,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC3B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;gBACzE,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC1D,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC,CAAC"}

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

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

package/dist/tools/composites/findTestFiles.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+import { relativePath, uriToPath } from '../../engine/positions.js';
+import { DEFAULT_TIMEOUTS } from '../../engine/types.js';
+const TEST_PATTERNS = /\.(spec|test|stories)\.(ts|tsx|js|jsx)$/;
+export const findTestFiles = defineTool({
+    name: 'find_test_files',
+    description: 'Find all test files (spec, test, stories) that reference a symbol. Use before modifying code to know which tests to update.',
+    schema: z.object({
+        symbol: z.string().optional().describe('Symbol name. Use this OR file_path+line+column.'),
+        file_path: z.string().optional().describe('Absolute file path'),
+        line: z.number().optional().describe('1-indexed line number'),
+        column: z.number().optional().describe('1-indexed column number'),
+    }),
+    async handler(params, engine) {
+        let uri, position, name;
+        if (params.symbol) {
+            const resolved = await engine.resolveSymbol(params.symbol, params.file_path);
+            uri = resolved.uri;
+            position = resolved.position;
+            name = resolved.name ?? params.symbol;
+        }
+        else if (params.file_path && params.line && params.column) {
+            const { toPosition } = await import('../../engine/positions.js');
+            const prepared = await engine.prepareFile(params.file_path);
+            uri = prepared.uri;
+            position = toPosition(params.line, params.column);
+            name = 'symbol';
+        }
+        else {
+            return 'Error: Provide either symbol name or file_path + line + column.';
+        }
+        const refs = await engine.request('textDocument/references', {
+            textDocument: { uri }, position, context: { includeDeclaration: false },
+        }, DEFAULT_TIMEOUTS.composite);
+        if (!refs || refs.length === 0)
+            return `No references found for ${name}.`;
+        // Filter to test files
+        const testRefs = refs.filter((r) => TEST_PATTERNS.test(uriToPath(r.uri)));
+        if (testRefs.length === 0)
+            return `No test files reference ${name}. Consider adding tests.`;
+        // Group by file
+        const byFile = new Map();
+        for (const ref of testRefs) {
+            const file = uriToPath(ref.uri);
+            byFile.set(file, (byFile.get(file) ?? 0) + 1);
+        }
+        const lines = [`# Test Files for ${name}\n\n${byFile.size} test files, ${testRefs.length} references\n`];
+        for (const [file, count] of [...byFile.entries()].sort()) {
+            const rel = relativePath(file, engine.workspaceRoot);
+            const type = file.includes('.stories.') ? 'story' : file.includes('.spec.') ? 'spec' : 'test';
+            lines.push(`- **${rel}** (${count} refs, ${type})`);
+        }
+        return lines.join('\n');
+    },
+});
+//# sourceMappingURL=findTestFiles.js.map

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

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

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

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

package/dist/tools/composites/impactTrace.js

@@ -0,0 +1,149 @@
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+import { toPosition, relativePath, uriToPath } from '../../engine/positions.js';
+import { DEFAULT_TIMEOUTS } from '../../engine/types.js';
+export const impactTrace = defineTool({
+    name: 'impact_trace',
+    description: 'Follow a symbol through type aliases and re-exports to find ALL transitive usages. Returns a dependency graph with affected files ranked by distance. Answers "what breaks if I change X?" in one call.',
+    schema: z.object({
+        symbol: z.string().optional().describe('Symbol name. Use this OR file_path+line+column.'),
+        file_path: z.string().optional().describe('Absolute file path'),
+        line: z.number().optional().describe('1-indexed line number'),
+        column: z.number().optional().describe('1-indexed column number'),
+        max_depth: z.number().default(3).describe('Max depth to trace through aliases'),
+        verbosity: z.enum(['summary', 'normal', 'detailed']).default('normal'),
+    }),
+    async handler(params, engine) {
+        let uri, position, name;
+        if (params.symbol) {
+            const resolved = await engine.resolveSymbol(params.symbol, params.file_path);
+            uri = resolved.uri;
+            position = resolved.position;
+            name = resolved.name ?? params.symbol;
+        }
+        else if (params.file_path && params.line && params.column) {
+            const prepared = await engine.prepareFile(params.file_path);
+            uri = prepared.uri;
+            position = toPosition(params.line, params.column);
+            name = 'symbol';
+        }
+        else {
+            return 'Error: Provide either symbol name or file_path + line + column.';
+        }
+        const timeout = DEFAULT_TIMEOUTS.composite;
+        const visited = new Map();
+        const queue = [
+            { uri, position, name, depth: 0 },
+        ];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            if (current.depth > params.max_depth)
+                continue;
+            const key = `${current.uri}:${current.position.line}:${current.position.character}`;
+            if (visited.has(key))
+                continue;
+            // Get references for this node
+            const refs = await engine.request('textDocument/references', {
+                textDocument: { uri: current.uri },
+                position: current.position,
+                context: { includeDeclaration: false },
+            }, timeout).catch(() => null);
+            const refCount = refs?.length ?? 0;
+            // Check if this is a type alias (has a type definition different from itself)
+            let isTypeAlias = false;
+            const typeDef = await engine.request('textDocument/typeDefinition', {
+                textDocument: { uri: current.uri },
+                position: current.position,
+            }, timeout).catch(() => null);
+            if (typeDef) {
+                const defs = Array.isArray(typeDef) ? typeDef : [typeDef];
+                for (const def of defs) {
+                    const defKey = `${def.uri}:${def.range.start.line}:${def.range.start.character}`;
+                    if (defKey !== key && !visited.has(defKey)) {
+                        isTypeAlias = true;
+                        // Enqueue the type definition target
+                        queue.push({
+                            uri: def.uri,
+                            position: def.range.start,
+                            name: current.name,
+                            depth: current.depth + 1,
+                        });
+                    }
+                }
+            }
+            visited.set(key, {
+                uri: current.uri,
+                name: current.name,
+                depth: current.depth,
+                refCount,
+                isTypeAlias,
+            });
+            // Check for re-exports among references
+            if (refs) {
+                for (const ref of refs) {
+                    const refPath = uriToPath(ref.uri);
+                    const content = engine.docManager.getContent(ref.uri);
+                    if (content) {
+                        const line = content.split('\n')[ref.range.start.line];
+                        if (line && /export\s/.test(line)) {
+                            const refKey = `${ref.uri}:${ref.range.start.line}:${ref.range.start.character}`;
+                            if (!visited.has(refKey)) {
+                                queue.push({
+                                    uri: ref.uri,
+                                    position: ref.range.start,
+                                    name: current.name,
+                                    depth: current.depth + 1,
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        // Aggregate results
+        const allRefs = new Set();
+        const allFiles = new Set();
+        let directCallers = 0;
+        let typeAnnotations = 0;
+        let transitiveRefs = 0;
+        for (const node of visited.values()) {
+            allRefs.add(`${node.uri}:${node.refCount}`);
+            if (node.refCount > 0) {
+                if (node.depth === 0)
+                    directCallers += node.refCount;
+                else if (node.isTypeAlias)
+                    typeAnnotations += node.refCount;
+                else
+                    transitiveRefs += node.refCount;
+            }
+        }
+        // Collect all unique referenced files across all depths
+        const filesByDepth = new Map();
+        for (const node of visited.values()) {
+            const rel = relativePath(uriToPath(node.uri), engine.workspaceRoot);
+            if (!filesByDepth.has(rel) || filesByDepth.get(rel) > node.depth) {
+                filesByDepth.set(rel, node.depth);
+            }
+        }
+        const totalRefs = directCallers + typeAnnotations + transitiveRefs;
+        const totalFiles = filesByDepth.size;
+        const lines = [`# Impact Trace: ${name}\n`];
+        lines.push(`${totalRefs} total references across ${totalFiles} nodes`);
+        if (directCallers > 0)
+            lines.push(`- ${directCallers} direct references`);
+        if (typeAnnotations > 0)
+            lines.push(`- ${typeAnnotations} via type aliases`);
+        if (transitiveRefs > 0)
+            lines.push(`- ${transitiveRefs} transitive (re-exports)`);
+        lines.push('');
+        if (params.verbosity !== 'summary') {
+            const sorted = [...filesByDepth.entries()].sort((a, b) => a[1] - b[1]);
+            for (const [file, depth] of sorted) {
+                const depthLabel = depth === 0 ? '(direct)' : `(depth ${depth})`;
+                lines.push(`- ${file} ${depthLabel}`);
+            }
+        }
+        return lines.join('\n');
+    },
+});
+//# sourceMappingURL=impactTrace.js.map

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

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

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

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

package/dist/tools/composites/inspectSymbol.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { defineTool } from '../registry.js';
+import { toPosition } from '../../engine/positions.js';
+import { formatHover, formatReferences, formatDefinitions } from '../../format/markdown.js';
+import { DEFAULT_TIMEOUTS } from '../../engine/types.js';
+export const inspectSymbol = defineTool({
+    name: 'inspect_symbol',
+    description: 'Get complete information about a symbol in one call: hover (type signature), definition location, and all references. Use when you need full context about a symbol.',
+    schema: z.object({
+        symbol: z.string().optional().describe('Symbol name. Use this OR file_path+line+column.'),
+        file_path: z.string().optional().describe('Absolute file path'),
+        line: z.number().optional().describe('1-indexed line number'),
+        column: z.number().optional().describe('1-indexed column number'),
+        verbosity: z.enum(['summary', 'normal', 'detailed']).default('normal'),
+    }),
+    async handler(params, engine) {
+        let uri, position;
+        if (params.symbol) {
+            const resolved = await engine.resolveSymbol(params.symbol, params.file_path);
+            uri = resolved.uri;
+            position = resolved.position;
+        }
+        else if (params.file_path && params.line && params.column) {
+            const prepared = await engine.prepareFile(params.file_path);
+            uri = prepared.uri;
+            position = toPosition(params.line, params.column);
+        }
+        else {
+            return 'Error: Provide either symbol name or file_path + line + column.';
+        }
+        const timeout = DEFAULT_TIMEOUTS.composite;
+        // Run hover, definition, references in parallel
+        const [hoverResult, defResult, refsResult] = await Promise.all([
+            engine.request('textDocument/hover', { textDocument: { uri }, position }, timeout).catch(() => null),
+            engine.request('textDocument/definition', { textDocument: { uri }, position }, timeout).catch(() => null),
+            engine.request('textDocument/references', {
+                textDocument: { uri }, position, context: { includeDeclaration: false },
+            }, timeout).catch(() => null),
+        ]);
+        const name = params.symbol ?? 'symbol';
+        const sections = [`# Inspect: ${name}\n`];
+        // Hover / type signature
+        const hoverText = formatHover(hoverResult);
+        if (hoverText && !hoverText.includes('No hover')) {
+            sections.push(`## Type\n\n${hoverText}\n`);
+        }
+        // Definition
+        const defText = formatDefinitions(defResult, engine.workspaceRoot);
+        if (!defText.includes('No definition')) {
+            sections.push(defText.replace('# Definition', '## Definition'));
+        }
+        // References
+        const refsText = formatReferences(refsResult, engine.workspaceRoot, params.verbosity);
+        if (!refsText.includes('No references')) {
+            sections.push(refsText.replace('# References', '## References'));
+        }
+        return sections.join('\n');
+    },
+});
+//# sourceMappingURL=inspectSymbol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspectSymbol.js","sourceRoot":"","sources":["../../../src/tools/composites/inspectSymbol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAyC,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,sKAAsK;IACnL,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;QACzF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAC/D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACjE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;KACvE,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM;QAC1B,IAAI,GAAW,EAAE,QAA6C,CAAC;QAC/D,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7E,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;YAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QACnD,CAAC;aAAM,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAC5D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC5D,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;YAAC,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,OAAO,iEAAiE,CAAC;QAC3E,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC;QAE3C,gDAAgD;QAChD,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC7D,MAAM,CAAC,OAAO,CAAe,oBAAoB,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YAClH,MAAM,CAAC,OAAO,CAA+B,yBAAyB,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YACvI,MAAM,CAAC,OAAO,CAAoB,yBAAyB,EAAE;gBAC3D,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE;aACxE,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;SAC9B,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC;QACvC,MAAM,QAAQ,GAAa,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC;QAEpD,yBAAyB;QACzB,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QAC3C,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACjD,QAAQ,CAAC,IAAI,CAAC,cAAc,SAAS,IAAI,CAAC,CAAC;QAC7C,CAAC;QAED,aAAa;QACb,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;QAClE,CAAC;QAED,aAAa;QACb,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,SAAgB,CAAC,CAAC;QAC7F,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YACxC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC,CAAC"}

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

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