codetree-claude 1.0.0

package/dist/server/ipc.js

@@ -0,0 +1,212 @@
+import { createServer } from "node:http";
+import { writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { normalizePath } from "../config.js";
+import { relative } from "node:path";
+/**
+ * Lightweight HTTP server for hook->MCP server IPC.
+ * The PreToolUse hook queries this to check cache status before deciding to allow/deny.
+ */
+export class IpcServer {
+    server = null;
+    port = 0;
+    config;
+    indexer;
+    db;
+    // Telemetry
+    stats = {
+        cacheHits: 0,
+        cacheMisses: 0,
+        hookQueries: 0,
+        tokensSaved: 0, // Rough estimate: chars that weren't re-read
+    };
+    constructor(config, indexer, db) {
+        this.config = config;
+        this.indexer = indexer;
+        this.db = db;
+    }
+    async start() {
+        return new Promise((resolve, reject) => {
+            this.server = createServer((req, res) => this.handleRequest(req, res));
+            this.server.listen(this.config.ipc.port, this.config.ipc.host, () => {
+                const addr = this.server.address();
+                if (addr && typeof addr === "object") {
+                    this.port = addr.port;
+                    // Write port file so the hook can find us
+                    this.writePortFile();
+                    resolve(this.port);
+                }
+                else {
+                    reject(new Error("Failed to get server address"));
+                }
+            });
+            this.server.on("error", reject);
+        });
+    }
+    getPort() {
+        return this.port;
+    }
+    stop() {
+        if (this.server) {
+            this.server.close();
+            this.server = null;
+        }
+        this.persistStats();
+    }
+    writePortFile() {
+        const portFilePath = join(this.config.projectRoot, ".codetree", "ipc.port");
+        const dir = dirname(portFilePath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(portFilePath, String(this.port), "utf-8");
+    }
+    handleRequest(req, res) {
+        const url = new URL(req.url || "/", `http://${req.headers.host}`);
+        res.setHeader("Content-Type", "application/json");
+        switch (url.pathname) {
+            case "/check":
+                this.handleCheck(url, res);
+                break;
+            case "/check-search":
+                this.handleCheckSearch(url, res);
+                break;
+            case "/check-glob":
+                this.handleCheckGlob(url, res);
+                break;
+            case "/status":
+                this.handleStatus(res);
+                break;
+            case "/stats":
+                this.handleStats(res);
+                break;
+            default:
+                res.writeHead(404);
+                res.end(JSON.stringify({ error: "Not found" }));
+        }
+    }
+    /**
+     * Check if a file Read can be served from cache.
+     * Returns { cached: true, tool: "codetree_read", path: "..." } or { cached: false }
+     */
+    handleCheck(url, res) {
+        this.stats.hookQueries++;
+        const filePath = url.searchParams.get("path");
+        if (!filePath) {
+            res.writeHead(400);
+            res.end(JSON.stringify({ error: "Missing path parameter" }));
+            return;
+        }
+        const relPath = normalizePath(relative(this.config.projectRoot, filePath));
+        if (this.indexer.isCacheValid(filePath)) {
+            this.stats.cacheHits++;
+            const record = this.db.getFile(relPath);
+            if (record) {
+                this.stats.tokensSaved += Math.ceil(record.size / 4); // ~4 chars per token
+            }
+            res.writeHead(200);
+            res.end(JSON.stringify({
+                cached: true,
+                tool: "codetree_read",
+                path: relPath,
+                size: record?.size,
+                lineCount: record?.line_count,
+            }));
+        }
+        else {
+            this.stats.cacheMisses++;
+            res.writeHead(200);
+            res.end(JSON.stringify({ cached: false }));
+        }
+    }
+    /**
+     * Check if a Grep search can be answered from the index.
+     */
+    handleCheckSearch(url, res) {
+        this.stats.hookQueries++;
+        const pattern = url.searchParams.get("pattern");
+        const searchPath = url.searchParams.get("path");
+        if (!pattern) {
+            res.writeHead(400);
+            res.end(JSON.stringify({ error: "Missing pattern parameter" }));
+            return;
+        }
+        // We can answer symbol searches from the index
+        const symbols = this.db.searchSymbols(pattern, undefined, 20);
+        if (symbols.length > 0) {
+            this.stats.cacheHits++;
+            res.writeHead(200);
+            res.end(JSON.stringify({
+                cached: true,
+                tool: "codetree_search",
+                resultCount: symbols.length,
+                hint: `Found ${symbols.length} symbols matching "${pattern}". Use codetree_search for full results.`,
+            }));
+        }
+        else {
+            this.stats.cacheMisses++;
+            res.writeHead(200);
+            res.end(JSON.stringify({ cached: false }));
+        }
+    }
+    /**
+     * Check if a Glob can be answered from the file tree.
+     */
+    handleCheckGlob(url, res) {
+        this.stats.hookQueries++;
+        const pattern = url.searchParams.get("pattern");
+        if (!pattern) {
+            res.writeHead(400);
+            res.end(JSON.stringify({ error: "Missing pattern parameter" }));
+            return;
+        }
+        // We have the full file tree if indexing is complete
+        if (this.indexer.isReady()) {
+            this.stats.cacheHits++;
+            res.writeHead(200);
+            res.end(JSON.stringify({
+                cached: true,
+                tool: "codetree_structure",
+                hint: `Project structure is indexed. Use codetree_structure to browse files matching "${pattern}".`,
+            }));
+        }
+        else {
+            this.stats.cacheMisses++;
+            res.writeHead(200);
+            res.end(JSON.stringify({ cached: false }));
+        }
+    }
+    handleStatus(res) {
+        res.writeHead(200);
+        res.end(JSON.stringify({
+            ready: this.indexer.isReady(),
+            indexing: this.indexer.isIndexing(),
+            fileCount: this.db.getFileCount(),
+            port: this.port,
+        }));
+    }
+    handleStats(res) {
+        res.writeHead(200);
+        res.end(JSON.stringify({
+            ...this.stats,
+            estimatedTokensSaved: this.stats.tokensSaved,
+            hitRate: this.stats.hookQueries > 0
+                ? this.stats.cacheHits / this.stats.hookQueries
+                : 0,
+        }));
+    }
+    persistStats() {
+        if (!this.config.telemetry.enabled)
+            return;
+        try {
+            const statsPath = this.config.telemetry.statsFile;
+            const dir = dirname(statsPath);
+            if (!existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+            writeFileSync(statsPath, JSON.stringify(this.stats, null, 2), "utf-8");
+        }
+        catch {
+            // Non-critical, ignore
+        }
+    }
+}
+//# sourceMappingURL=ipc.js.map

package/dist/server/ipc.js.map

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

package/dist/server/mcp-server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/server/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/server/mcp-server.ts"],"names":[],"mappings":""}

package/dist/server/mcp-server.js

@@ -0,0 +1,133 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { loadConfig } from "../config.js";
+import { Database } from "../storage/database.js";
+import { ContentCache } from "../storage/cache.js";
+import { Indexer } from "../indexer/indexer.js";
+import { FileWatcher } from "../indexer/watcher.js";
+import { IpcServer } from "./ipc.js";
+import { createReadTool } from "./tools/codetree-read.js";
+import { createSearchTool } from "./tools/codetree-search.js";
+import { createStructureTool } from "./tools/codetree-structure.js";
+import { createFindRefsTool } from "./tools/codetree-find-refs.js";
+import { createSummaryTool } from "./tools/codetree-summary.js";
+async function main() {
+    // Load config
+    const projectRoot = process.env.CODETREE_PROJECT_ROOT || process.cwd();
+    const config = loadConfig(projectRoot);
+    // Initialize components
+    const db = new Database(config);
+    await db.init();
+    const cache = new ContentCache(config.cache.memoryLimitMB);
+    const indexer = new Indexer(config, db, cache);
+    await indexer.init();
+    // Start IPC server for hook communication
+    const ipc = new IpcServer(config, indexer, db);
+    const ipcPort = await ipc.start();
+    logToStderr(`[codetree] IPC server listening on port ${ipcPort}`);
+    // Start file watcher
+    const watcher = new FileWatcher(config, indexer);
+    if (config.watch.enabled) {
+        watcher.start();
+        logToStderr("[codetree] File watcher started");
+    }
+    // Run initial index in background
+    logToStderr("[codetree] Starting initial index scan...");
+    indexer.fullScan({
+        onProgress: (indexed, total) => {
+            if (indexed % 500 === 0) {
+                logToStderr(`[codetree] Indexed ${indexed}/${total} files...`);
+            }
+        },
+        onError: (path, err) => {
+            logToStderr(`[codetree] Error indexing ${path}: ${err.message}`);
+        },
+        onComplete: (stats) => {
+            logToStderr(`[codetree] Index complete: ${stats.indexedFiles}/${stats.totalFiles} files, ` +
+                `${stats.symbolCount} symbols, ${stats.indexTimeMs}ms`);
+        },
+    }).catch((err) => {
+        logToStderr(`[codetree] Index scan failed: ${err.message}`);
+    });
+    // Create MCP tool handlers
+    const readTool = createReadTool(config, indexer, db);
+    const searchTool = createSearchTool(config, indexer, db);
+    const structureTool = createStructureTool(config, db);
+    const findRefsTool = createFindRefsTool(config, indexer, db);
+    const summaryTool = createSummaryTool(config, db);
+    const tools = [readTool, searchTool, structureTool, findRefsTool, summaryTool];
+    const toolMap = new Map(tools.map((t) => [t.name, t]));
+    // Create MCP server
+    const server = new Server({
+        name: "codetree",
+        version: "1.0.0",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // List tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+    }));
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const tool = toolMap.get(name);
+        if (!tool) {
+            return {
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                isError: true,
+            };
+        }
+        try {
+            const result = await tool.handler(args);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Connect via stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logToStderr("[codetree] MCP server connected via stdio");
+    // Graceful shutdown
+    const shutdown = () => {
+        logToStderr("[codetree] Shutting down...");
+        watcher.stop();
+        ipc.stop();
+        db.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    process.on("SIGHUP", shutdown);
+}
+/**
+ * Log to stderr so it doesn't interfere with MCP stdio protocol on stdout.
+ */
+function logToStderr(msg) {
+    process.stderr.write(msg + "\n");
+}
+main().catch((err) => {
+    process.stderr.write(`[codetree] Fatal error: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=mcp-server.js.map

package/dist/server/mcp-server.js.map

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

package/dist/server/tools/codetree-find-refs.d.ts

@@ -0,0 +1,46 @@
+import type { CodeTreeConfig } from "../../config.js";
+import type { Indexer } from "../../indexer/indexer.js";
+import type { Database } from "../../storage/database.js";
+export interface FindRefsParams {
+    symbol: string;
+    kind?: string;
+}
+export interface FindRefsResult {
+    definitions: Array<{
+        file_path: string;
+        line_start: number | null;
+        signature: string | null;
+        kind: string;
+        exported: boolean;
+    }>;
+    dependents: Array<{
+        source_path: string;
+        import_spec: string;
+    }>;
+    content_references: Array<{
+        file_path: string;
+        line_number: number;
+        line_content: string;
+    }>;
+    totalReferences: number;
+}
+export declare function createFindRefsTool(config: CodeTreeConfig, indexer: Indexer, db: Database): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            symbol: {
+                type: string;
+                description: string;
+            };
+            kind: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: FindRefsParams) => Promise<FindRefsResult>;
+};
+//# sourceMappingURL=codetree-find-refs.d.ts.map

package/dist/server/tools/codetree-find-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codetree-find-refs.d.ts","sourceRoot":"","sources":["../../../src/server/tools/codetree-find-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,KAAK,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,UAAU,EAAE,KAAK,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,kBAAkB,EAAE,KAAK,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ;;;;;;;;;;;;;;;;;sBAqB7D,cAAc,KAAG,OAAO,CAAC,cAAc,CAAC;EA4DnE"}

package/dist/server/tools/codetree-find-refs.js

@@ -0,0 +1,83 @@
+export function createFindRefsTool(config, indexer, db) {
+    return {
+        name: "codetree_find_refs",
+        description: "Find all references to a symbol across the codebase. Shows: where it's defined, " +
+            "which files import/depend on the defining file, and content occurrences. " +
+            "Use this to understand impact before refactoring.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                symbol: {
+                    type: "string",
+                    description: "Symbol name to find references for (e.g., 'UserService', 'handleAuth', 'ApiConfig')",
+                },
+                kind: {
+                    type: "string",
+                    description: "Filter definitions by kind: function, class, interface, type, variable",
+                },
+            },
+            required: ["symbol"],
+        },
+        handler: async (params) => {
+            // Find definitions in symbol index
+            const definitions = db.searchSymbols(params.symbol, params.kind, 20)
+                .filter((s) => s.name === params.symbol || s.name.endsWith(`.${params.symbol}`));
+            // Find files that depend on the defining files
+            const dependentSet = new Map();
+            for (const def of definitions) {
+                const deps = db.findDependents(def.file_path);
+                for (const dep of deps) {
+                    if (!dependentSet.has(dep.source_path)) {
+                        dependentSet.set(dep.source_path, dep.target_spec);
+                    }
+                }
+            }
+            // Content search for the symbol name across all cached files
+            const contentRefs = [];
+            const files = db.getAllFiles();
+            const symbolRegex = new RegExp(`\\b${escapeRegex(params.symbol)}\\b`, "g");
+            for (const file of files) {
+                // Skip definition files (already captured above)
+                if (definitions.some((d) => d.file_path === file.path))
+                    continue;
+                const content = indexer.readCached(file.path);
+                if (!content)
+                    continue;
+                const lines = content.split("\n");
+                for (let i = 0; i < lines.length; i++) {
+                    if (symbolRegex.test(lines[i])) {
+                        contentRefs.push({
+                            file_path: file.path,
+                            line_number: i + 1,
+                            line_content: lines[i].trim().slice(0, 200),
+                        });
+                        if (contentRefs.length >= 30)
+                            break;
+                    }
+                    symbolRegex.lastIndex = 0;
+                }
+                if (contentRefs.length >= 30)
+                    break;
+            }
+            return {
+                definitions: definitions.map((d) => ({
+                    file_path: d.file_path,
+                    line_start: d.line_start,
+                    signature: d.signature,
+                    kind: d.kind,
+                    exported: d.exported,
+                })),
+                dependents: Array.from(dependentSet.entries()).map(([source, spec]) => ({
+                    source_path: source,
+                    import_spec: spec,
+                })),
+                content_references: contentRefs,
+                totalReferences: definitions.length + dependentSet.size + contentRefs.length,
+            };
+        },
+    };
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=codetree-find-refs.js.map

package/dist/server/tools/codetree-find-refs.js.map

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

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

@@ -0,0 +1,46 @@
+import { type CodeTreeConfig } from "../../config.js";
+import type { Indexer } from "../../indexer/indexer.js";
+import type { Database } from "../../storage/database.js";
+export interface ReadParams {
+    file_path: string;
+    offset?: number;
+    limit?: number;
+}
+export interface ReadResult {
+    content: string;
+    source: "memory_cache" | "disk_cache" | "direct_read";
+    path: string;
+    lineCount: number;
+    size: number;
+    language: string | null;
+    symbols: Array<{
+        name: string;
+        kind: string;
+        line: number | null;
+        signature: string | null;
+    }>;
+}
+export declare function createReadTool(config: CodeTreeConfig, indexer: Indexer, db: Database): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            file_path: {
+                type: string;
+                description: string;
+            };
+            offset: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: ReadParams) => Promise<ReadResult>;
+};
+//# sourceMappingURL=codetree-read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codetree-read.d.ts","sourceRoot":"","sources":["../../../src/server/tools/codetree-read.ts"],"names":[],"mappings":"AAEA,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,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC/F;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;sBAyBzD,UAAU,KAAG,OAAO,CAAC,UAAU,CAAC;EAyD3D"}

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

@@ -0,0 +1,82 @@
+import { resolve, relative } from "node:path";
+import { readFileSync } from "node:fs";
+import { normalizePath } from "../../config.js";
+export function createReadTool(config, indexer, db) {
+    return {
+        name: "codetree_read",
+        description: "Read a file from the CodeTree cache. Much faster and more token-efficient than the native Read tool. " +
+            "Returns the file content along with metadata (symbols, language, line count). " +
+            "Use this instead of Read when CodeTree has cached the file.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_path: {
+                    type: "string",
+                    description: "Absolute or project-relative path to the file",
+                },
+                offset: {
+                    type: "number",
+                    description: "Line number to start reading from (0-indexed). Default: 0",
+                },
+                limit: {
+                    type: "number",
+                    description: "Number of lines to read. Default: all lines",
+                },
+            },
+            required: ["file_path"],
+        },
+        handler: async (params) => {
+            // Resolve the path
+            let absPath;
+            let relPath;
+            if (params.file_path.startsWith("/") || params.file_path.match(/^[A-Za-z]:/)) {
+                absPath = resolve(params.file_path);
+                relPath = normalizePath(relative(config.projectRoot, absPath));
+            }
+            else {
+                relPath = normalizePath(params.file_path);
+                absPath = resolve(config.projectRoot, relPath);
+            }
+            // Try cache first
+            let content = indexer.readCached(relPath);
+            let source = "memory_cache";
+            if (!content) {
+                // Direct read as fallback
+                try {
+                    content = readFileSync(absPath, "utf-8");
+                    source = "direct_read";
+                    // Trigger background indexing of this file
+                    indexer.indexFile(absPath);
+                }
+                catch (err) {
+                    throw new Error(`Failed to read file: ${absPath}`);
+                }
+            }
+            // Apply offset/limit
+            if (params.offset !== undefined || params.limit !== undefined) {
+                const lines = content.split("\n");
+                const start = params.offset ?? 0;
+                const end = params.limit ? start + params.limit : lines.length;
+                content = lines.slice(start, end).join("\n");
+            }
+            // Get metadata
+            const fileRecord = db.getFile(relPath);
+            const symbols = db.getSymbolsForFile(relPath);
+            return {
+                content,
+                source,
+                path: relPath,
+                lineCount: fileRecord?.line_count ?? content.split("\n").length,
+                size: fileRecord?.size ?? Buffer.byteLength(content, "utf-8"),
+                language: fileRecord?.language ?? null,
+                symbols: symbols.map((s) => ({
+                    name: s.name,
+                    kind: s.kind,
+                    line: s.line_start,
+                    signature: s.signature,
+                })),
+            };
+        },
+    };
+}
+//# sourceMappingURL=codetree-read.js.map

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

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