codetree-claude 1.0.0

package/dist/server/tools/codetree-search.d.ts

@@ -0,0 +1,59 @@
+import { type CodeTreeConfig } from "../../config.js";
+import type { Indexer } from "../../indexer/indexer.js";
+import type { Database } from "../../storage/database.js";
+export interface SearchParams {
+    query: string;
+    kind?: string;
+    file_pattern?: string;
+    limit?: number;
+    content_search?: boolean;
+}
+export interface SearchResult {
+    symbols: Array<{
+        name: string;
+        kind: string;
+        file_path: string;
+        line_start: number | null;
+        signature: string | null;
+        exported: boolean;
+    }>;
+    content_matches?: Array<{
+        file_path: string;
+        line_number: number;
+        line_content: string;
+    }>;
+    totalResults: number;
+    source: "index";
+}
+export declare function createSearchTool(config: CodeTreeConfig, indexer: Indexer, db: Database): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            kind: {
+                type: string;
+                description: string;
+            };
+            file_pattern: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            content_search: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: SearchParams) => Promise<SearchResult>;
+};
+//# sourceMappingURL=codetree-search.d.ts.map

package/dist/server/tools/codetree-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codetree-search.d.ts","sourceRoot":"","sources":["../../../src/server/tools/codetree-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAiC3D,YAAY,KAAG,OAAO,CAAC,YAAY,CAAC;EA+D/D"}

package/dist/server/tools/codetree-search.js

@@ -0,0 +1,92 @@
+export function createSearchTool(config, indexer, db) {
+    return {
+        name: "codetree_search",
+        description: "Search the codebase using the CodeTree index. Searches symbol names (functions, classes, types, etc.) " +
+            "and optionally file contents. Much faster than Grep for symbol lookups. " +
+            "Use kind filter to narrow: 'function', 'class', 'interface', 'type', 'variable', 'method', 'enum', 'import'.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query — matches against symbol names and optionally content",
+                },
+                kind: {
+                    type: "string",
+                    description: "Filter by symbol kind: function, class, interface, type, variable, method, enum, import",
+                },
+                file_pattern: {
+                    type: "string",
+                    description: "Filter by file path pattern (e.g., 'src/api' to only search in src/api/)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum number of results. Default: 50",
+                },
+                content_search: {
+                    type: "boolean",
+                    description: "Also search file contents (slower). Default: false",
+                },
+            },
+            required: ["query"],
+        },
+        handler: async (params) => {
+            const limit = params.limit ?? 50;
+            // Search symbol index
+            let symbols = db.searchSymbols(params.query, params.kind, limit);
+            // Filter by file pattern if specified
+            if (params.file_pattern) {
+                const pattern = params.file_pattern.toLowerCase();
+                symbols = symbols.filter((s) => s.file_path.toLowerCase().includes(pattern));
+            }
+            const result = {
+                symbols: symbols.map((s) => ({
+                    name: s.name,
+                    kind: s.kind,
+                    file_path: s.file_path,
+                    line_start: s.line_start,
+                    signature: s.signature,
+                    exported: s.exported,
+                })),
+                totalResults: symbols.length,
+                source: "index",
+            };
+            // Optional content search
+            if (params.content_search) {
+                const contentMatches = [];
+                const files = db.getAllFiles();
+                const regex = new RegExp(escapeRegex(params.query), "gi");
+                for (const file of files) {
+                    if (params.file_pattern && !file.path.toLowerCase().includes(params.file_pattern.toLowerCase())) {
+                        continue;
+                    }
+                    const content = indexer.readCached(file.path);
+                    if (!content)
+                        continue;
+                    const lines = content.split("\n");
+                    for (let i = 0; i < lines.length; i++) {
+                        if (regex.test(lines[i])) {
+                            contentMatches.push({
+                                file_path: file.path,
+                                line_number: i + 1,
+                                line_content: lines[i].trim().slice(0, 200),
+                            });
+                            if (contentMatches.length >= limit)
+                                break;
+                        }
+                        regex.lastIndex = 0;
+                    }
+                    if (contentMatches.length >= limit)
+                        break;
+                }
+                result.content_matches = contentMatches;
+                result.totalResults += contentMatches.length;
+            }
+            return result;
+        },
+    };
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=codetree-search.js.map

package/dist/server/tools/codetree-search.js.map

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

package/dist/server/tools/codetree-structure.d.ts

@@ -0,0 +1,55 @@
+import { type CodeTreeConfig } from "../../config.js";
+import type { Database } from "../../storage/database.js";
+export interface StructureParams {
+    path?: string;
+    depth?: number;
+    include_symbols?: boolean;
+    pattern?: string;
+}
+interface TreeNode {
+    name: string;
+    type: "file" | "directory";
+    language?: string | null;
+    size?: number;
+    lineCount?: number;
+    symbols?: Array<{
+        name: string;
+        kind: string;
+        exported: boolean;
+    }>;
+    children?: TreeNode[];
+}
+export interface StructureResult {
+    tree: TreeNode[];
+    totalFiles: number;
+    totalDirectories: number;
+    languages: Record<string, number>;
+}
+export declare function createStructureTool(config: CodeTreeConfig, db: Database): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+            include_symbols: {
+                type: string;
+                description: string;
+            };
+            pattern: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    handler: (params: StructureParams) => Promise<StructureResult>;
+};
+export {};
+//# sourceMappingURL=codetree-structure.d.ts.map

package/dist/server/tools/codetree-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codetree-structure.d.ts","sourceRoot":"","sources":["../../../src/server/tools/codetree-structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACnE,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;sBA4B5C,eAAe,KAAG,OAAO,CAAC,eAAe,CAAC;EAqHrE"}

package/dist/server/tools/codetree-structure.js

@@ -0,0 +1,137 @@
+import { normalizePath } from "../../config.js";
+export function createStructureTool(config, db) {
+    return {
+        name: "codetree_structure",
+        description: "Get the project file structure as a tree. Replaces Glob for directory exploration. " +
+            "Returns file tree with optional symbol information. " +
+            "Use path filter to narrow to a subdirectory. Use pattern to match file names (glob-like).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Subdirectory to explore (relative to project root). Default: entire project",
+                },
+                depth: {
+                    type: "number",
+                    description: "Maximum directory depth to return. Default: unlimited",
+                },
+                include_symbols: {
+                    type: "boolean",
+                    description: "Include exported symbols for each file. Default: false",
+                },
+                pattern: {
+                    type: "string",
+                    description: "Filter files by name pattern (e.g., '*.ts', 'api', 'test'). Simple substring/extension match.",
+                },
+            },
+        },
+        handler: async (params) => {
+            const files = db.getAllFiles();
+            const prefix = params.path ? normalizePath(params.path) : "";
+            // Filter files
+            let filtered = files;
+            if (prefix) {
+                filtered = filtered.filter((f) => f.path.startsWith(prefix));
+            }
+            if (params.pattern) {
+                const pattern = params.pattern.toLowerCase();
+                if (pattern.startsWith("*.")) {
+                    const ext = pattern.slice(1);
+                    filtered = filtered.filter((f) => f.path.toLowerCase().endsWith(ext));
+                }
+                else {
+                    filtered = filtered.filter((f) => f.path.toLowerCase().includes(pattern));
+                }
+            }
+            // Build tree
+            const root = new Map();
+            const languages = {};
+            let totalDirectories = 0;
+            for (const file of filtered) {
+                const parts = file.path.split("/");
+                // Track languages
+                if (file.language) {
+                    languages[file.language] = (languages[file.language] || 0) + 1;
+                }
+                // Apply depth limit
+                if (params.depth !== undefined && parts.length > params.depth + 1) {
+                    continue;
+                }
+                // Build directory nodes
+                let currentPath = "";
+                for (let i = 0; i < parts.length - 1; i++) {
+                    const parentPath = currentPath;
+                    currentPath = currentPath ? `${currentPath}/${parts[i]}` : parts[i];
+                    if (!root.has(currentPath)) {
+                        const dirNode = {
+                            name: parts[i],
+                            type: "directory",
+                            children: [],
+                        };
+                        root.set(currentPath, dirNode);
+                        totalDirectories++;
+                        // Attach to parent
+                        if (parentPath && root.has(parentPath)) {
+                            root.get(parentPath).children.push(dirNode);
+                        }
+                    }
+                }
+                // Create file node
+                const fileNode = {
+                    name: parts[parts.length - 1],
+                    type: "file",
+                    language: file.language,
+                    size: file.size,
+                    lineCount: file.line_count,
+                };
+                if (params.include_symbols) {
+                    const symbols = db.getSymbolsForFile(file.path);
+                    fileNode.symbols = symbols
+                        .filter((s) => s.exported)
+                        .map((s) => ({
+                        name: s.name,
+                        kind: s.kind,
+                        exported: s.exported,
+                    }));
+                }
+                // Attach to parent directory
+                const parentPath = parts.slice(0, -1).join("/");
+                if (parentPath && root.has(parentPath)) {
+                    root.get(parentPath).children.push(fileNode);
+                }
+                else {
+                    // Top-level file
+                    root.set(file.path, fileNode);
+                }
+            }
+            // Collect top-level nodes
+            const tree = [];
+            for (const [path, node] of root) {
+                if (!path.includes("/") || (prefix && path === prefix.split("/")[0])) {
+                    tree.push(node);
+                }
+            }
+            // Sort: directories first, then alphabetically
+            const sortTree = (nodes) => {
+                nodes.sort((a, b) => {
+                    if (a.type !== b.type)
+                        return a.type === "directory" ? -1 : 1;
+                    return a.name.localeCompare(b.name);
+                });
+                for (const node of nodes) {
+                    if (node.children)
+                        sortTree(node.children);
+                }
+            };
+            sortTree(tree);
+            return {
+                tree,
+                totalFiles: filtered.length,
+                totalDirectories,
+                languages,
+            };
+        },
+    };
+}
+//# sourceMappingURL=codetree-structure.js.map

package/dist/server/tools/codetree-structure.js.map

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

package/dist/server/tools/codetree-summary.d.ts

@@ -0,0 +1,36 @@
+import type { CodeTreeConfig } from "../../config.js";
+import type { Database } from "../../storage/database.js";
+export interface SummaryResult {
+    projectRoot: string;
+    totalFiles: number;
+    languages: Record<string, {
+        files: number;
+        totalLines: number;
+        totalSize: number;
+    }>;
+    topLevelDirectories: string[];
+    exportedSymbols: {
+        functions: number;
+        classes: number;
+        interfaces: number;
+        types: number;
+        enums: number;
+        variables: number;
+    };
+    keyFiles: Array<{
+        path: string;
+        symbolCount: number;
+        language: string | null;
+        lineCount: number;
+    }>;
+}
+export declare function createSummaryTool(config: CodeTreeConfig, db: Database): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+    handler: () => Promise<SummaryResult>;
+};
+//# sourceMappingURL=codetree-summary.d.ts.map

package/dist/server/tools/codetree-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codetree-summary.d.ts","sourceRoot":"","sources":["../../../src/server/tools/codetree-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpF,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE,QAAQ;;;;;;;mBAW/C,OAAO,CAAC,aAAa,CAAC;EA8E5C"}

package/dist/server/tools/codetree-summary.js

@@ -0,0 +1,94 @@
+export function createSummaryTool(config, db) {
+    return {
+        name: "codetree_summary",
+        description: "Get a high-level summary of the entire project. Returns: language breakdown, " +
+            "directory structure, symbol counts, and key files (files with the most exports/symbols). " +
+            "Use this at the start of a session to understand the codebase without reading any files.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+        handler: async () => {
+            const files = db.getAllFiles();
+            // Language breakdown
+            const languages = {};
+            const topDirs = new Set();
+            for (const file of files) {
+                const lang = file.language || "other";
+                if (!languages[lang]) {
+                    languages[lang] = { files: 0, totalLines: 0, totalSize: 0 };
+                }
+                languages[lang].files++;
+                languages[lang].totalLines += file.line_count;
+                languages[lang].totalSize += file.size;
+                // Track top-level directories
+                const firstSlash = file.path.indexOf("/");
+                if (firstSlash > 0) {
+                    topDirs.add(file.path.slice(0, firstSlash));
+                }
+            }
+            // Symbol counts
+            const symbolCounts = {
+                functions: 0,
+                classes: 0,
+                interfaces: 0,
+                types: 0,
+                enums: 0,
+                variables: 0,
+            };
+            // Find key files (most symbols)
+            const fileSymbolCounts = [];
+            for (const file of files) {
+                const symbols = db.getSymbolsForFile(file.path);
+                const exportedSymbols = symbols.filter((s) => s.exported);
+                fileSymbolCounts.push({
+                    path: file.path,
+                    count: exportedSymbols.length,
+                    language: file.language,
+                    lineCount: file.line_count,
+                });
+                for (const sym of exportedSymbols) {
+                    switch (sym.kind) {
+                        case "function":
+                        case "method":
+                            symbolCounts.functions++;
+                            break;
+                        case "class":
+                            symbolCounts.classes++;
+                            break;
+                        case "interface":
+                            symbolCounts.interfaces++;
+                            break;
+                        case "type":
+                            symbolCounts.types++;
+                            break;
+                        case "enum":
+                            symbolCounts.enums++;
+                            break;
+                        case "variable":
+                        case "constant":
+                            symbolCounts.variables++;
+                            break;
+                    }
+                }
+            }
+            // Sort by symbol count, take top 20
+            fileSymbolCounts.sort((a, b) => b.count - a.count);
+            const keyFiles = fileSymbolCounts.slice(0, 20).filter((f) => f.count > 0);
+            return {
+                projectRoot: config.projectRoot,
+                totalFiles: files.length,
+                languages,
+                topLevelDirectories: Array.from(topDirs).sort(),
+                exportedSymbols: symbolCounts,
+                keyFiles: keyFiles.map((f) => ({
+                    path: f.path,
+                    symbolCount: f.count,
+                    language: f.language,
+                    lineCount: f.lineCount,
+                })),
+            };
+        },
+    };
+}
+//# sourceMappingURL=codetree-summary.js.map

package/dist/server/tools/codetree-summary.js.map

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

package/dist/setup/install.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Register CodeTree hook in Claude Code settings.
+ */
+export declare function installHook(projectRoot: string, hookScriptPath: string): {
+    success: boolean;
+    message: string;
+};
+/**
+ * Register CodeTree MCP server.
+ */
+export declare function installMcpServer(projectRoot: string, serverScriptPath: string): {
+    success: boolean;
+    message: string;
+};
+/**
+ * Create default .codetreerc.json if it doesn't exist.
+ */
+export declare function createDefaultConfig(projectRoot: string): {
+    success: boolean;
+    path: string;
+};
+/**
+ * Add .codetree/ to .gitignore.
+ */
+export declare function updateGitignore(projectRoot: string): void;
+//# sourceMappingURL=install.d.ts.map

package/dist/setup/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/setup/install.ts"],"names":[],"mappings":"AAiCA;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA8C9G;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiCrH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAiC3F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAYzD"}