mcp-codebase-intelligence 0.1.0

package/dist/tools/architecture-diagram.d.ts

@@ -0,0 +1,33 @@
+import { CodeGraph } from "../graph/code-graph.js";
+export declare const architectureDiagramTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            scope: {
+                type: string;
+                description: string;
+            };
+            max_depth: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+    };
+};
+export declare function handleArchitectureDiagram(graph: CodeGraph, args: {
+    scope?: string;
+    max_depth?: number;
+    format?: string;
+}, projectRoot?: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};

package/dist/tools/architecture-diagram.js

@@ -0,0 +1,216 @@
+export const architectureDiagramTool = {
+    name: "architecture_diagram",
+    description: "Auto-generate a mermaid diagram of the project's module dependency graph. Shows which files import from which other files, grouped by directory. Useful for understanding project structure at a glance.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            scope: {
+                type: "string",
+                description: "Optional: limit diagram to files under this path prefix (e.g. 'src/api')",
+            },
+            max_depth: {
+                type: "number",
+                description: "Maximum directory nesting depth for subgraph grouping (default: 2)",
+            },
+            format: {
+                type: "string",
+                enum: ["mermaid", "text"],
+                description: "Output format (default: mermaid)",
+            },
+        },
+    },
+};
+export function handleArchitectureDiagram(graph, args, projectRoot) {
+    const db = graph.getDb();
+    const maxDepth = Math.min(Math.max(args.max_depth ?? 2, 1), 5);
+    const format = args.format ?? "mermaid";
+    // Get all files and their imports
+    const scopeFilter = args.scope
+        ? `WHERE f.path LIKE ?`
+        : "";
+    const scopeParam = args.scope ? `${args.scope}%` : undefined;
+    const filesQuery = `
+    SELECT f.path, i.source_path as importSource
+    FROM files f
+    LEFT JOIN imports i ON i.file_id = f.id
+    ${scopeFilter}
+    ORDER BY f.path
+  `;
+    const rows = (scopeParam
+        ? db.prepare(filesQuery).all(scopeParam)
+        : db.prepare(filesQuery).all());
+    if (rows.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: args.scope
+                        ? `No files found under scope "${args.scope}".`
+                        : "No files indexed yet. Run reindex first.",
+                },
+            ],
+        };
+    }
+    // Build file → imports map
+    const fileMap = new Map();
+    const allFiles = new Set();
+    for (const row of rows) {
+        allFiles.add(row.path);
+        if (row.importSource) {
+            const imports = fileMap.get(row.path) ?? new Set();
+            imports.add(row.importSource);
+            fileMap.set(row.path, imports);
+        }
+    }
+    // Resolve relative imports to actual indexed file paths
+    const edges = [];
+    const indexedPaths = [...allFiles];
+    for (const [filePath, importSources] of fileMap) {
+        for (const source of importSources) {
+            const resolved = resolveImport(filePath, source, indexedPaths);
+            if (resolved) {
+                edges.push({ from: filePath, to: resolved });
+            }
+        }
+    }
+    const header = projectRoot ? `Project: ${projectRoot}\n\n` : "";
+    if (format === "text") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: header + buildTextDiagram(allFiles, edges),
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: header + buildMermaidDiagram(allFiles, edges, maxDepth),
+            },
+        ],
+    };
+}
+function resolveImport(fromFile, importSource, indexedPaths) {
+    // If it's a relative import (starts with . or ..)
+    if (importSource.startsWith(".")) {
+        const fromDir = fromFile.substring(0, fromFile.lastIndexOf("/"));
+        const resolved = normalizePath(fromDir + "/" + importSource);
+        // Try exact match and common extensions
+        const extensions = ["", ".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs", ".java"];
+        for (const ext of extensions) {
+            const candidate = resolved + ext;
+            if (indexedPaths.includes(candidate))
+                return candidate;
+        }
+        // Try index files
+        for (const idx of ["/index.ts", "/index.js", "/index.tsx"]) {
+            const candidate = resolved + idx;
+            if (indexedPaths.includes(candidate))
+                return candidate;
+        }
+        return null;
+    }
+    // Absolute/package imports — try suffix match
+    for (const p of indexedPaths) {
+        if (p.endsWith("/" + importSource) || p.endsWith("/" + importSource + ".ts") || p.endsWith("/" + importSource + ".js")) {
+            return p;
+        }
+    }
+    return null;
+}
+function normalizePath(p) {
+    const parts = [];
+    for (const part of p.split("/")) {
+        if (part === "..") {
+            parts.pop();
+        }
+        else if (part !== ".") {
+            parts.push(part);
+        }
+    }
+    return parts.join("/");
+}
+function getDirectory(filePath, depth) {
+    const parts = filePath.split("/");
+    return parts.slice(0, Math.min(depth, parts.length - 1)).join("/");
+}
+function buildMermaidDiagram(allFiles, edges, maxDepth) {
+    const sanitize = (s) => s.replace(/[^a-zA-Z0-9_]/g, "_");
+    const shortName = (p) => {
+        const parts = p.split("/");
+        return parts[parts.length - 1];
+    };
+    // Group files by directory
+    const dirGroups = new Map();
+    for (const file of allFiles) {
+        const dir = getDirectory(file, maxDepth) || "root";
+        const list = dirGroups.get(dir) ?? [];
+        list.push(file);
+        dirGroups.set(dir, list);
+    }
+    const lines = [
+        "# Architecture Diagram\n",
+        "```mermaid",
+        "graph LR",
+    ];
+    // Add subgraphs for each directory
+    for (const [dir, files] of dirGroups) {
+        if (dirGroups.size > 1) {
+            lines.push(`  subgraph ${sanitize(dir)}["${dir}"]`);
+        }
+        for (const file of files) {
+            lines.push(`    ${sanitize(file)}["${shortName(file)}"]`);
+        }
+        if (dirGroups.size > 1) {
+            lines.push("  end");
+        }
+    }
+    // Add edges
+    const seenEdges = new Set();
+    for (const edge of edges) {
+        const key = `${edge.from}->${edge.to}`;
+        if (seenEdges.has(key))
+            continue;
+        seenEdges.add(key);
+        lines.push(`  ${sanitize(edge.from)} --> ${sanitize(edge.to)}`);
+    }
+    lines.push("```");
+    // Add summary
+    const fileCount = allFiles.size;
+    const edgeCount = seenEdges.size;
+    lines.push(`\n**${fileCount} modules, ${edgeCount} dependencies**`);
+    return lines.join("\n");
+}
+function buildTextDiagram(allFiles, edges) {
+    const lines = ["# Module Dependencies\n"];
+    // Group edges by source file
+    const bySource = new Map();
+    for (const edge of edges) {
+        const list = bySource.get(edge.from) ?? [];
+        list.push(edge.to);
+        bySource.set(edge.from, list);
+    }
+    // Files with dependencies
+    for (const [file, deps] of [...bySource].sort((a, b) => a[0].localeCompare(b[0]))) {
+        lines.push(`${file}`);
+        for (const dep of deps.sort()) {
+            lines.push(`  --> ${dep}`);
+        }
+        lines.push("");
+    }
+    // Files with no dependencies
+    const filesWithDeps = new Set(bySource.keys());
+    const filesWithNoDeps = [...allFiles].filter((f) => !filesWithDeps.has(f)).sort();
+    if (filesWithNoDeps.length > 0) {
+        lines.push("## Standalone modules (no imports)");
+        for (const f of filesWithNoDeps) {
+            lines.push(`  ${f}`);
+        }
+    }
+    lines.push(`\n**${allFiles.size} modules, ${edges.length} dependencies**`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=architecture-diagram.js.map

package/dist/tools/architecture-diagram.js.map

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

package/dist/tools/find-implementations.d.ts

@@ -0,0 +1,33 @@
+import { LspManager } from "../lsp/lsp-manager.js";
+export declare const findImplementationsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            file_path: {
+                type: string;
+                description: string;
+            };
+            line: {
+                type: string;
+                description: string;
+            };
+            character: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleFindImplementations(lspManager: LspManager, args: {
+    file_path: string;
+    line: number;
+    character: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/find-implementations.js

@@ -0,0 +1,68 @@
+import { readFileSync } from "fs";
+export const findImplementationsTool = {
+    name: "find_implementations",
+    description: "Find all implementations of an interface or abstract method. Uses LSP for precise type-aware resolution across files.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            file_path: {
+                type: "string",
+                description: "Absolute path to the file containing the interface/abstract method",
+            },
+            line: {
+                type: "number",
+                description: "Line number of the interface/method (1-based)",
+            },
+            character: {
+                type: "number",
+                description: "Column number (0-based)",
+            },
+        },
+        required: ["file_path", "line", "character"],
+    },
+};
+export async function handleFindImplementations(lspManager, args) {
+    const client = lspManager.getClientForFile(args.file_path);
+    if (!client) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No LSP server available for ${args.file_path}. LSP features require a running language server.`,
+                },
+            ],
+        };
+    }
+    const implementations = await client.getImplementations(args.file_path, args.line, args.character);
+    if (implementations.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No implementations found at ${args.file_path}:${args.line}:${args.character}`,
+                },
+            ],
+        };
+    }
+    const results = implementations.map((loc) => {
+        const filePath = loc.uri.replace("file://", "");
+        let lineText = "";
+        try {
+            const lines = readFileSync(filePath, "utf-8").split("\n");
+            lineText = lines[loc.line - 1]?.trim() ?? "";
+        }
+        catch {
+            // ignore read errors
+        }
+        return `  ${filePath}:${loc.line}:${loc.character}  ${lineText}`;
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Found ${implementations.length} implementation(s):\n\n${results.join("\n")}`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=find-implementations.js.map

package/dist/tools/find-implementations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-implementations.js","sourceRoot":"","sources":["../../src/tools/find-implementations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAElC,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,uHAAuH;IACzH,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oEAAoE;aAClF;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yBAAyB;aACvC;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC;KAC7C;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,UAAsB,EACtB,IAA4D;IAE5D,MAAM,MAAM,GAAG,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,+BAA+B,IAAI,CAAC,SAAS,mDAAmD;iBACvG;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,kBAAkB,CACrD,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,SAAS,CACf,CAAC;IAEF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,+BAA+B,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE;iBACrF;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1C,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1D,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;QAED,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,SAAS,eAAe,CAAC,MAAM,0BAA0B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACpF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/find-symbol.d.ts

@@ -0,0 +1,39 @@
+import { CodeGraph } from "../graph/code-graph.js";
+export declare const findSymbolTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            kind: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            scope: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleFindSymbol(graph: CodeGraph, args: {
+    name: string;
+    kind?: string;
+    scope?: string;
+    limit?: number;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};

package/dist/tools/find-symbol.js

@@ -0,0 +1,52 @@
+export const findSymbolTool = {
+    name: "find_symbol",
+    description: "Find symbols (functions, classes, interfaces, types, variables, methods) by name with full type information and location. Supports fuzzy matching.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                description: "Symbol name to search for (supports partial matching)",
+            },
+            kind: {
+                type: "string",
+                enum: ["function", "class", "interface", "type", "variable", "method", "enum", "property"],
+                description: "Optional: filter by symbol kind",
+            },
+            scope: {
+                type: "string",
+                description: "Optional: limit search to files under this path prefix",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum results to return (default: 20)",
+            },
+        },
+        required: ["name"],
+    },
+};
+export function handleFindSymbol(graph, args) {
+    const results = graph.findSymbols({
+        name: args.name,
+        kind: args.kind,
+        scope: args.scope,
+        limit: args.limit ?? 20,
+    });
+    if (results.length === 0) {
+        return { content: [{ type: "text", text: `No symbols found matching "${args.name}"` }] };
+    }
+    const formatted = results.map((s) => {
+        const exported = s.isExported ? " [exported]" : "";
+        const sig = s.signature ? `\n  Signature: ${s.signature}` : "";
+        return `${s.kind} ${s.name}${exported}\n  Location: ${s.filePath}:${s.lineStart}-${s.lineEnd}${sig}`;
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Found ${results.length} symbol(s) matching "${args.name}":\n\n${formatted.join("\n\n")}`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=find-symbol.js.map

package/dist/tools/find-symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-symbol.js","sourceRoot":"","sources":["../../src/tools/find-symbol.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,oJAAoJ;IACtJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;aACrE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC;gBAC1F,WAAW,EAAE,iCAAiC;aAC/C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wDAAwD;aACtE;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAC9B,KAAgB,EAChB,IAAqE;IAErE,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;KACxB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,8BAA8B,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC;IACpG,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,GAAG,QAAQ,iBAAiB,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,SAAS,OAAO,CAAC,MAAM,wBAAwB,IAAI,CAAC,IAAI,SAAS,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;aAChG;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-call-graph.d.ts

@@ -0,0 +1,40 @@
+import { CodeGraph } from "../graph/code-graph.js";
+export declare const getCallGraphTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            function_name: {
+                type: string;
+                description: string;
+            };
+            direction: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleGetCallGraph(graph: CodeGraph, args: {
+    function_name: string;
+    direction?: string;
+    depth?: number;
+    format?: string;
+}): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};