mcp-codebase-intelligence 0.1.0

package/dist/lsp/lsp-client.d.ts

@@ -0,0 +1,45 @@
+export declare class LspClient {
+    private rootPath;
+    private serverCommand;
+    private serverArgs;
+    private process;
+    private nextId;
+    private pending;
+    private buffer;
+    private contentLength;
+    private ready;
+    private initPromise;
+    private openedFiles;
+    constructor(rootPath: string, serverCommand: string, serverArgs: string[]);
+    start(): Promise<void>;
+    private _start;
+    stop(): Promise<void>;
+    isReady(): boolean;
+    private ensureFileOpen;
+    getDefinition(filePath: string, line: number, character: number): Promise<Array<{
+        uri: string;
+        line: number;
+        character: number;
+    }>>;
+    getReferences(filePath: string, line: number, character: number, includeDeclaration?: boolean): Promise<Array<{
+        uri: string;
+        line: number;
+        character: number;
+    }>>;
+    getHover(filePath: string, line: number, character: number): Promise<string | null>;
+    getTypeDefinition(filePath: string, line: number, character: number): Promise<Array<{
+        uri: string;
+        line: number;
+        character: number;
+    }>>;
+    getImplementations(filePath: string, line: number, character: number): Promise<Array<{
+        uri: string;
+        line: number;
+        character: number;
+    }>>;
+    private normalizeLocations;
+    private sendRequest;
+    private sendNotification;
+    private writeMessage;
+    private handleData;
+}

package/dist/lsp/lsp-client.js

@@ -0,0 +1,315 @@
+import { spawn } from "child_process";
+import { readFileSync } from "fs";
+import { logger } from "../utils/logger.js";
+export class LspClient {
+    rootPath;
+    serverCommand;
+    serverArgs;
+    process = null;
+    nextId = 1;
+    pending = new Map();
+    buffer = "";
+    contentLength = -1;
+    ready = false;
+    initPromise = null;
+    openedFiles = new Set();
+    constructor(rootPath, serverCommand, serverArgs) {
+        this.rootPath = rootPath;
+        this.serverCommand = serverCommand;
+        this.serverArgs = serverArgs;
+    }
+    async start() {
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this._start();
+        return this.initPromise;
+    }
+    async _start() {
+        logger.info(`Starting LSP server: ${this.serverCommand} ${this.serverArgs.join(" ")}`);
+        this.process = spawn(this.serverCommand, this.serverArgs, {
+            stdio: ["pipe", "pipe", "pipe"],
+            cwd: this.rootPath,
+        });
+        this.process.stdout.on("data", (data) => this.handleData(data));
+        this.process.stderr.on("data", (data) => {
+            // tsserver logs to stderr — ignore or log at debug level
+            logger.debug(`LSP stderr: ${data.toString().trim()}`);
+        });
+        this.process.on("exit", (code) => {
+            logger.warn(`LSP server exited with code ${code}`);
+            this.ready = false;
+            this.process = null;
+        });
+        // Send initialize
+        const initParams = {
+            processId: process.pid,
+            rootUri: `file://${this.rootPath}`,
+            capabilities: {
+                textDocument: {
+                    definition: { dynamicRegistration: false },
+                    references: { dynamicRegistration: false },
+                    hover: { contentFormat: ["plaintext", "markdown"] },
+                    typeDefinition: { dynamicRegistration: false },
+                    implementation: { dynamicRegistration: false },
+                },
+            },
+            workspaceFolders: [
+                {
+                    uri: `file://${this.rootPath}`,
+                    name: "root",
+                },
+            ],
+        };
+        const result = (await this.sendRequest("initialize", initParams));
+        logger.info(`LSP initialized: ${result.capabilities ? "OK" : "no capabilities"}`);
+        // Send initialized notification
+        this.sendNotification("initialized", {});
+        this.ready = true;
+    }
+    async stop() {
+        if (this.process) {
+            try {
+                await this.sendRequest("shutdown", null);
+                this.sendNotification("exit", null);
+            }
+            catch {
+                // ignore errors during shutdown
+            }
+            this.process.kill();
+            this.process = null;
+            this.ready = false;
+        }
+    }
+    isReady() {
+        return this.ready;
+    }
+    async ensureFileOpen(filePath) {
+        if (this.openedFiles.has(filePath))
+            return;
+        try {
+            const content = readFileSync(filePath, "utf-8");
+            const uri = `file://${filePath}`;
+            // Determine language ID
+            let languageId = "typescript";
+            if (filePath.endsWith(".js") || filePath.endsWith(".mjs") || filePath.endsWith(".cjs")) {
+                languageId = "javascript";
+            }
+            else if (filePath.endsWith(".tsx")) {
+                languageId = "typescriptreact";
+            }
+            else if (filePath.endsWith(".jsx")) {
+                languageId = "javascriptreact";
+            }
+            const params = {
+                textDocument: {
+                    uri,
+                    languageId,
+                    version: 1,
+                    text: content,
+                },
+            };
+            this.sendNotification("textDocument/didOpen", params);
+            this.openedFiles.add(filePath);
+        }
+        catch (err) {
+            logger.debug(`Failed to open file in LSP: ${filePath}`, err);
+        }
+    }
+    async getDefinition(filePath, line, character) {
+        if (!this.ready)
+            return [];
+        await this.ensureFileOpen(filePath);
+        const params = {
+            textDocument: { uri: `file://${filePath}` },
+            position: { line: line - 1, character }, // LSP is 0-based
+        };
+        try {
+            const result = await this.sendRequest("textDocument/definition", params);
+            return this.normalizeLocations(result);
+        }
+        catch (err) {
+            logger.debug(`Definition request failed for ${filePath}:${line}:${character}`, err);
+            return [];
+        }
+    }
+    async getReferences(filePath, line, character, includeDeclaration = false) {
+        if (!this.ready)
+            return [];
+        await this.ensureFileOpen(filePath);
+        const params = {
+            textDocument: { uri: `file://${filePath}` },
+            position: { line: line - 1, character },
+            context: { includeDeclaration },
+        };
+        try {
+            const result = await this.sendRequest("textDocument/references", params);
+            return this.normalizeLocations(result);
+        }
+        catch (err) {
+            logger.debug(`References request failed for ${filePath}:${line}:${character}`, err);
+            return [];
+        }
+    }
+    async getHover(filePath, line, character) {
+        if (!this.ready)
+            return null;
+        await this.ensureFileOpen(filePath);
+        const params = {
+            textDocument: { uri: `file://${filePath}` },
+            position: { line: line - 1, character },
+        };
+        try {
+            const result = (await this.sendRequest("textDocument/hover", params));
+            if (!result || !result.contents)
+                return null;
+            if (typeof result.contents === "string")
+                return result.contents;
+            if ("value" in result.contents)
+                return result.contents.value;
+            if (Array.isArray(result.contents)) {
+                return result.contents
+                    .map((c) => (typeof c === "string" ? c : c.value))
+                    .join("\n");
+            }
+            return null;
+        }
+        catch (err) {
+            logger.debug(`Hover request failed for ${filePath}:${line}:${character}`, err);
+            return null;
+        }
+    }
+    async getTypeDefinition(filePath, line, character) {
+        if (!this.ready)
+            return [];
+        await this.ensureFileOpen(filePath);
+        const params = {
+            textDocument: { uri: `file://${filePath}` },
+            position: { line: line - 1, character },
+        };
+        try {
+            const result = await this.sendRequest("textDocument/typeDefinition", params);
+            return this.normalizeLocations(result);
+        }
+        catch (err) {
+            logger.debug(`Type definition request failed for ${filePath}:${line}:${character}`, err);
+            return [];
+        }
+    }
+    async getImplementations(filePath, line, character) {
+        if (!this.ready)
+            return [];
+        await this.ensureFileOpen(filePath);
+        try {
+            const result = await this.sendRequest("textDocument/implementation", {
+                textDocument: { uri: `file://${filePath}` },
+                position: { line: line - 1, character },
+            });
+            return this.normalizeLocations(result);
+        }
+        catch (err) {
+            logger.debug(`Implementation request failed for ${filePath}:${line}:${character}`, err);
+            return [];
+        }
+    }
+    // --- Protocol internals ---
+    normalizeLocations(result) {
+        if (!result)
+            return [];
+        const locations = [];
+        if (Array.isArray(result)) {
+            for (const item of result) {
+                if ("uri" in item && "range" in item) {
+                    // Location
+                    locations.push({
+                        uri: item.uri,
+                        line: item.range.start.line + 1,
+                        character: item.range.start.character,
+                    });
+                }
+                else if ("targetUri" in item) {
+                    // LocationLink
+                    locations.push({
+                        uri: item.targetUri,
+                        line: item.targetRange.start.line + 1,
+                        character: item.targetRange.start.character,
+                    });
+                }
+            }
+        }
+        else if (result && typeof result === "object" && "uri" in result) {
+            const loc = result;
+            locations.push({
+                uri: loc.uri,
+                line: loc.range.start.line + 1,
+                character: loc.range.start.character,
+            });
+        }
+        return locations;
+    }
+    sendRequest(method, params) {
+        return new Promise((resolve, reject) => {
+            const id = this.nextId++;
+            this.pending.set(id, { resolve, reject });
+            const message = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+            this.writeMessage(message);
+            // Timeout after 30s
+            setTimeout(() => {
+                if (this.pending.has(id)) {
+                    this.pending.delete(id);
+                    reject(new Error(`LSP request timed out: ${method}`));
+                }
+            }, 30000);
+        });
+    }
+    sendNotification(method, params) {
+        const message = JSON.stringify({ jsonrpc: "2.0", method, params });
+        this.writeMessage(message);
+    }
+    writeMessage(body) {
+        if (!this.process?.stdin?.writable)
+            return;
+        const header = `Content-Length: ${Buffer.byteLength(body)}\r\n\r\n`;
+        this.process.stdin.write(header + body);
+    }
+    handleData(data) {
+        this.buffer += data.toString();
+        while (true) {
+            if (this.contentLength === -1) {
+                const headerEnd = this.buffer.indexOf("\r\n\r\n");
+                if (headerEnd === -1)
+                    return;
+                const header = this.buffer.substring(0, headerEnd);
+                const match = header.match(/Content-Length:\s*(\d+)/i);
+                if (!match) {
+                    this.buffer = this.buffer.substring(headerEnd + 4);
+                    continue;
+                }
+                this.contentLength = parseInt(match[1], 10);
+                this.buffer = this.buffer.substring(headerEnd + 4);
+            }
+            if (Buffer.byteLength(this.buffer) < this.contentLength)
+                return;
+            const body = this.buffer.substring(0, this.contentLength);
+            this.buffer = this.buffer.substring(this.contentLength);
+            this.contentLength = -1;
+            try {
+                const msg = JSON.parse(body);
+                if ("id" in msg && this.pending.has(msg.id)) {
+                    const pending = this.pending.get(msg.id);
+                    this.pending.delete(msg.id);
+                    if (msg.error) {
+                        pending.reject(new Error(msg.error.message));
+                    }
+                    else {
+                        pending.resolve(msg.result);
+                    }
+                }
+                // Ignore notifications and server-initiated requests
+            }
+            catch {
+                logger.debug("Failed to parse LSP message");
+            }
+        }
+    }
+}
+//# sourceMappingURL=lsp-client.js.map

package/dist/lsp/lsp-client.js.map

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

package/dist/lsp/lsp-manager.d.ts

@@ -0,0 +1,13 @@
+import { LspClient } from "./lsp-client.js";
+export declare class LspManager {
+    private rootPath;
+    private clients;
+    private extMap;
+    constructor(rootPath: string);
+    start(): Promise<void>;
+    getClientForFile(filePath: string): LspClient | undefined;
+    hasAnyClient(): boolean;
+    getActiveServers(): string[];
+    stop(): Promise<void>;
+    private isCommandAvailable;
+}

package/dist/lsp/lsp-manager.js

@@ -0,0 +1,96 @@
+import { existsSync } from "fs";
+import { execFile } from "child_process";
+import path from "path";
+import { LspClient } from "./lsp-client.js";
+import { logger } from "../utils/logger.js";
+const KNOWN_SERVERS = [
+    {
+        id: "typescript",
+        command: "typescript-language-server",
+        args: ["--stdio"],
+        extensions: [".ts", ".tsx", ".js", ".jsx", ".mts", ".cts", ".mjs", ".cjs"],
+        detect: (root) => existsSync(path.join(root, "tsconfig.json")) ||
+            existsSync(path.join(root, "jsconfig.json")) ||
+            existsSync(path.join(root, "package.json")),
+    },
+];
+export class LspManager {
+    rootPath;
+    clients = new Map();
+    extMap = new Map(); // extension -> server id
+    constructor(rootPath) {
+        this.rootPath = rootPath;
+    }
+    async start() {
+        for (const config of KNOWN_SERVERS) {
+            if (!config.detect(this.rootPath)) {
+                logger.debug(`LSP ${config.id}: skipped (no project markers found)`);
+                continue;
+            }
+            // Check if the server binary is available (direct or via npx)
+            let command = config.command;
+            let args = config.args;
+            const available = await this.isCommandAvailable(config.command);
+            if (!available) {
+                // Try via npx
+                const npxAvailable = await this.isCommandAvailable("npx");
+                if (npxAvailable) {
+                    command = "npx";
+                    args = [config.command, ...config.args];
+                    logger.info(`LSP ${config.id}: using npx to run ${config.command}`);
+                }
+                else {
+                    logger.info(`LSP ${config.id}: ${config.command} not found, skipping`);
+                    continue;
+                }
+            }
+            try {
+                const client = new LspClient(this.rootPath, command, args);
+                await client.start();
+                this.clients.set(config.id, client);
+                for (const ext of config.extensions) {
+                    this.extMap.set(ext, config.id);
+                }
+                logger.info(`LSP ${config.id}: started`);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logger.warn(`LSP ${config.id}: failed to start — ${msg}`);
+            }
+        }
+    }
+    getClientForFile(filePath) {
+        for (const [ext, serverId] of this.extMap) {
+            if (filePath.endsWith(ext)) {
+                return this.clients.get(serverId);
+            }
+        }
+        return undefined;
+    }
+    hasAnyClient() {
+        return this.clients.size > 0;
+    }
+    getActiveServers() {
+        return Array.from(this.clients.keys());
+    }
+    async stop() {
+        for (const [id, client] of this.clients) {
+            try {
+                await client.stop();
+                logger.info(`LSP ${id}: stopped`);
+            }
+            catch (err) {
+                logger.debug(`LSP ${id}: error during stop`, err);
+            }
+        }
+        this.clients.clear();
+    }
+    isCommandAvailable(command) {
+        return new Promise((resolve) => {
+            execFile("which", [command], (err) => {
+                resolve(!err);
+            });
+        });
+    }
+}
+//# sourceMappingURL=lsp-manager.js.map

package/dist/lsp/lsp-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-manager.js","sourceRoot":"","sources":["../../src/lsp/lsp-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAU5C,MAAM,aAAa,GAAsB;IACvC;QACE,EAAE,EAAE,YAAY;QAChB,OAAO,EAAE,4BAA4B;QACrC,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC1E,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CACf,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YAC5C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YAC5C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;KAC9C;CACF,CAAC;AAEF,MAAM,OAAO,UAAU;IAID;IAHZ,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IACvC,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,yBAAyB;IAErE,YAAoB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAExC,KAAK,CAAC,KAAK;QACT,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,EAAE,sCAAsC,CAAC,CAAC;gBACrE,SAAS;YACX,CAAC;YAED,8DAA8D;YAC9D,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAC7B,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACvB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAChE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,cAAc;gBACd,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBAC1D,IAAI,YAAY,EAAE,CAAC;oBACjB,OAAO,GAAG,KAAK,CAAC;oBAChB,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;oBACxC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,EAAE,sBAAsB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtE,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;oBACvE,SAAS;gBACX,CAAC;YACH,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC3D,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBACpC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;oBACpC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;gBAClC,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,EAAE,uBAAuB,GAAG,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;IACH,CAAC;IAED,gBAAgB,CAAC,QAAgB;QAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1C,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,gBAAgB;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAEO,kBAAkB,CAAC,OAAe;QACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;gBACnC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/tools/analyze-impact.d.ts

@@ -0,0 +1,38 @@
+import { CodeGraph } from "../graph/code-graph.js";
+export declare const analyzeChangeImpactTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            file_path: {
+                type: string;
+                description: string;
+            };
+            line_start: {
+                type: string;
+                description: string;
+            };
+            line_end: {
+                type: string;
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleAnalyzeChangeImpact(graph: CodeGraph, args: {
+    file_path: string;
+    line_start: number;
+    line_end: number;
+    depth?: number;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};

package/dist/tools/analyze-impact.js

@@ -0,0 +1,126 @@
+export const analyzeChangeImpactTool = {
+    name: "analyze_change_impact",
+    description: "Analyze the impact of changing lines in a file. Returns all symbols affected by the change and their dependents (callers/users) at configurable depth.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            file_path: {
+                type: "string",
+                description: "Absolute path to the file being modified",
+            },
+            line_start: {
+                type: "number",
+                description: "Starting line number of the change (inclusive)",
+            },
+            line_end: {
+                type: "number",
+                description: "Ending line number of the change (inclusive)",
+            },
+            depth: {
+                type: "number",
+                description: "How many levels of transitive dependents to follow (1 = direct only, default: 2, max: 10)",
+            },
+        },
+        required: ["file_path", "line_start", "line_end"],
+    },
+};
+export function handleAnalyzeChangeImpact(graph, args) {
+    const depth = args.depth ?? 2;
+    const clampedDepth = Math.min(Math.max(depth, 1), 10);
+    // Find all symbols in the file that overlap with the line range
+    const affectedSymbols = findSymbolsInRange(graph, args.file_path, args.line_start, args.line_end);
+    if (affectedSymbols.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No symbols found in ${args.file_path} at lines ${args.line_start}-${args.line_end}\n\nThe change may affect code outside of symbol definitions (e.g., module-level code, imports).`,
+                },
+            ],
+        };
+    }
+    // For each affected symbol, get its references (dependents)
+    const impactReport = [];
+    for (const sym of affectedSymbols) {
+        const refs = graph.getReferences(sym.name, clampedDepth);
+        const directRefs = refs.filter((r) => r.depth === 1);
+        impactReport.push({
+            symbol: sym.name,
+            kind: sym.kind,
+            lines: `${sym.lineStart}-${sym.lineEnd}`,
+            signature: sym.signature,
+            directDependents: directRefs.length,
+            totalDependents: refs.length,
+            references: refs,
+        });
+    }
+    // Build the report
+    const sections = [];
+    // Summary section
+    const totalDirect = impactReport.reduce((sum, r) => sum + r.directDependents, 0);
+    const totalAll = impactReport.reduce((sum, r) => sum + r.totalDependents, 0);
+    sections.push(`IMPACT ANALYSIS: ${args.file_path} lines ${args.line_start}-${args.line_end}\n` +
+        `\nAffected symbols: ${affectedSymbols.length}` +
+        `\nDirect dependents: ${totalDirect}` +
+        `\nTotal dependents (depth ${clampedDepth}): ${totalAll}`);
+    // Affected symbols section
+    const affectedList = affectedSymbols.map((s) => {
+        const sig = s.signature ? `\n    Signature: ${s.signature}` : "";
+        return `  ${s.kind} ${s.name} (lines ${s.lineStart}-${s.lineEnd})${sig}`;
+    });
+    sections.push(`\nAFFECTED SYMBOLS:\n${affectedList.join("\n")}`);
+    // Dependents breakdown
+    if (totalAll > 0) {
+        const dependentSections = [];
+        for (const impact of impactReport) {
+            if (impact.references.length === 0) {
+                continue;
+            }
+            const header = `\n${impact.kind} ${impact.symbol}:`;
+            const byDepth = new Map();
+            for (const ref of impact.references) {
+                const list = byDepth.get(ref.depth) ?? [];
+                list.push(ref);
+                byDepth.set(ref.depth, list);
+            }
+            const depthSections = [];
+            for (const [d, depthRefs] of byDepth) {
+                const label = d === 1 ? "  Direct callers/users" : `  Depth ${d} (transitive)`;
+                const lines = depthRefs.map((r) => `    ${r.fromKind} ${r.fromSymbol} (${r.fromFile}:${r.fromLine}) --[${r.refKind}]--> line ${r.refLine}`);
+                depthSections.push(`${label}:\n${lines.join("\n")}`);
+            }
+            dependentSections.push(header + "\n" + depthSections.join("\n"));
+        }
+        sections.push(`\nDEPENDENTS:${dependentSections.join("\n")}`);
+    }
+    else {
+        sections.push(`\nDEPENDENTS:\nNo references found. The affected symbols are not used elsewhere in the indexed codebase.`);
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: sections.join("\n"),
+            },
+        ],
+    };
+}
+// Helper function to find symbols that overlap with a line range
+function findSymbolsInRange(graph, filePath, lineStart, lineEnd) {
+    // Query the database directly for symbols in the file that overlap with the range
+    const fileId = graph.getFileId(filePath);
+    if (!fileId) {
+        return [];
+    }
+    const sql = `
+    SELECT s.name, s.kind, s.line_start as lineStart, s.line_end as lineEnd, s.signature
+    FROM symbols s
+    WHERE s.file_id = ?
+      AND s.line_start <= ?
+      AND s.line_end >= ?
+    ORDER BY s.line_start
+  `;
+    const db = graph.getDb();
+    return db.prepare(sql).all(fileId, lineEnd, lineStart);
+}
+//# sourceMappingURL=analyze-impact.js.map

package/dist/tools/analyze-impact.js.map

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