mcp-code-context 3.6.3 → 3.7.0

package/dist/src/tools/toolDefinitionsCore.js

@@ -0,0 +1,267 @@
+/** Core MCP tool schemas (read + write) */
+export const CORE_TOOLS = [
+    {
+        name: "get_semantic_repo_map",
+        description: "Generate a compressed architectural overview of an entire repository",
+        inputSchema: {
+            type: "object",
+            properties: {
+                directoryPath: { type: "string", description: "Absolute path to repository root" },
+                projectRoot: { type: "string", description: "Project root for security boundary" },
+                format: { type: "string", enum: ["xml", "markdown"], description: "Output format (default: xml)" },
+            },
+            required: ["directoryPath", "projectRoot"],
+        },
+    },
+    {
+        name: "read_file_surgical",
+        description: "Read a file or extract a specific named symbol",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string", description: "Absolute path to file" },
+                projectRoot: { type: "string", description: "Project root (REQUIRED)" },
+                symbolName: { type: "string", description: "Symbol name to extract (optional)" },
+                className: { type: "string", description: "Class name for scoping (optional)" },
+            },
+            required: ["filePath", "projectRoot"],
+        },
+    },
+    {
+        name: "analyze_impact",
+        description: "Find all files that depend on a given file",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string", description: "Absolute path to file" },
+                projectRoot: { type: "string", description: "Project root for security boundary" },
+                rootDir: { type: "string", description: "Repository root (optional, defaults to projectRoot)" },
+            },
+            required: ["filePath", "projectRoot"],
+        },
+    },
+    {
+        name: "read_file_lines",
+        description: "Read specific line ranges from a file",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string", description: "Absolute path to file" },
+                projectRoot: { type: "string", description: "Project root for security boundary" },
+                startLine: { type: "number", description: "Starting line number (1-indexed)" },
+                endLine: { type: "number", description: "Ending line number (1-indexed)" },
+                aroundPattern: { type: "string", description: "Search pattern to find and return surrounding lines" },
+                contextLines: { type: "number", description: "Number of lines before/after pattern (default: 5)" },
+            },
+            required: ["filePath", "projectRoot"],
+        },
+    },
+    {
+        name: "search_code_pattern",
+        description: "Search for code patterns across multiple files",
+        inputSchema: {
+            type: "object",
+            properties: {
+                rootDir: { type: "string", description: "Repository root directory" },
+                projectRoot: { type: "string", description: "Project root for security boundary" },
+                pattern: { type: "string", description: "Regular expression pattern to search" },
+                fileExtensions: { type: "array", items: { type: "string" }, description: "Extensions to search" },
+                excludeDirs: { type: "array", items: { type: "string" }, description: "Directories to exclude" },
+                maxResults: { type: "number", description: "Maximum matches to return (default: 10)" },
+                startIndex: { type: "number", description: "Start index for pagination (default: 0)" },
+                fuzzyMatch: { type: "boolean", description: "Enable fuzzy matching (default: false)" },
+                fuzzyThreshold: { type: "number", description: "Fuzzy match threshold 0-1 (default: 0.4)" },
+            },
+            required: ["rootDir", "projectRoot", "pattern"],
+        },
+    },
+    {
+        name: "parse_file",
+        description: "Parse a file using Tree-sitter and extract symbols",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string", description: "Absolute path to file" },
+                projectRoot: { type: "string", description: "Project root (REQUIRED)" },
+            },
+            required: ["filePath", "projectRoot"],
+        },
+    },
+    {
+        name: "write_file_surgical",
+        description: "Replace a symbol with new code. Phase 1 (dry-run): returns diff + token. Phase 2: confirm with token to apply.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string", description: "Absolute path to file" },
+                projectRoot: { type: "string", description: "Project root (REQUIRED)" },
+                symbolName: { type: "string", description: "Symbol to replace" },
+                newContent: { type: "string", description: "New code (Phase 1 only ΓÇö omit in Phase 2, server uses stored content)" },
+                className: { type: "string", description: "Class name (optional, for scoping)" },
+                confirm: { type: "boolean", description: "Set true to apply a pending operation (Phase 2)" },
+                confirmationToken: { type: "string", description: "Token from Phase 1 dry-run (Phase 2 only)" },
+                diffFormat: { type: "string", enum: ["unified", "compact", "summary", "none"], description: "Diff verbosity in Phase 1 output (default: unified). Use none to skip diff and save tokens." },
+            },
+            required: ["filePath", "projectRoot", "symbolName"],
+        },
+    },
+    {
+        name: "insert_symbol",
+        description: "Insert code at a specific location. Phase 1: returns diff + token. Phase 2: confirm with token to apply.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string", description: "Absolute path to file" },
+                projectRoot: { type: "string", description: "Project root (REQUIRED)" },
+                code: { type: "string", description: "Code to insert (Phase 1 only ΓÇö omit in Phase 2, server uses stored content)" },
+                anchorSymbol: { type: "string", description: "Symbol to position relative to" },
+                position: { type: "string", enum: ["before", "after", "inside_start", "inside_end"], description: "Where to insert" },
+                className: { type: "string", description: "Class name (optional)" },
+                confirm: { type: "boolean", description: "Set true to apply a pending operation (Phase 2)" },
+                confirmationToken: { type: "string", description: "Token from Phase 1 dry-run (Phase 2 only)" },
+                diffFormat: { type: "string", enum: ["unified", "compact", "summary", "none"], description: "Diff verbosity in Phase 1 output (default: unified). Use none to skip diff and save tokens." },
+            },
+            required: ["filePath", "projectRoot"],
+        },
+    },
+    {
+        name: "remove_symbol",
+        description: "Remove a symbol from file. Phase 1: returns diff + token. Phase 2: confirm with token to apply.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string", description: "Absolute path to file" },
+                projectRoot: { type: "string", description: "Project root (REQUIRED)" },
+                symbolName: { type: "string", description: "Symbol to remove" },
+                className: { type: "string", description: "Class name (optional)" },
+                force: { type: "boolean", description: "Skip dependency check" },
+                confirm: { type: "boolean", description: "Set true to apply a pending operation" },
+                confirmationToken: { type: "string", description: "Token from Phase 1 dry-run" },
+            },
+            required: ["filePath", "projectRoot", "symbolName"],
+        },
+    },
+    {
+        name: "rename_symbol",
+        description: "Rename a symbol across the entire repository. Phase 1: returns diff + token. Phase 2: confirm with token to apply.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string", description: "File where symbol is defined" },
+                projectRoot: { type: "string", description: "Project root (REQUIRED)" },
+                oldName: { type: "string", description: "Current name" },
+                newName: { type: "string", description: "New name" },
+                rootDir: { type: "string", description: "Repository root (optional)" },
+                confirm: { type: "boolean", description: "Set true to apply a pending operation" },
+                confirmationToken: { type: "string", description: "Token from Phase 1 dry-run" },
+            },
+            required: ["filePath", "projectRoot", "oldName", "newName"],
+        },
+    },
+    // ── AST Transform (v3.7.0) ──────────────────────────────────────────────
+    {
+        name: "ast_transform",
+        description: "Apply a declarative AST transformation to a symbol. Supports: add_parameter, wrap_with_try_catch, add_decorator, change_return_type, extract_variable. Uses two-phase write (Phase 1: preview diff, Phase 2: confirm with token).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string", description: "Absolute path to file" },
+                projectRoot: { type: "string", description: "Project root (REQUIRED)" },
+                symbolName: { type: "string", description: "Target symbol to transform" },
+                className: { type: "string", description: "Class name (optional, for scoping)" },
+                transform: {
+                    type: "object",
+                    description: "Transform specification",
+                    properties: {
+                        kind: {
+                            type: "string",
+                            enum: ["add_parameter", "wrap_with_try_catch", "add_decorator", "change_return_type", "extract_variable"],
+                            description: "Type of transformation",
+                        },
+                        parameter: { type: "string", description: "For add_parameter: parameter text (e.g. 'timeout: number = 5000')" },
+                        parameterIndex: { type: "number", description: "For add_parameter: insertion index (0-based, default: append)" },
+                        catchBody: { type: "string", description: "For wrap_with_try_catch: catch block body (default: 'throw error;')" },
+                        decorator: { type: "string", description: "For add_decorator: decorator text (e.g. '@deprecated')" },
+                        returnType: { type: "string", description: "For change_return_type: new return type" },
+                        expression: { type: "string", description: "For extract_variable: expression to extract" },
+                        variableName: { type: "string", description: "For extract_variable: name for extracted const" },
+                    },
+                    required: ["kind"],
+                },
+                confirm: { type: "boolean", description: "Set true to apply a pending operation (Phase 2)" },
+                confirmationToken: { type: "string", description: "Token from Phase 1 dry-run (Phase 2 only)" },
+                diffFormat: { type: "string", enum: ["unified", "compact", "summary", "none"], description: "Diff verbosity (default: unified)" },
+            },
+            required: ["filePath", "projectRoot", "symbolName", "transform"],
+        },
+    },
+    // ── NEW TOOLS v3.7.0 ──────────────────────────────────────────────────────ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
+    {
+        name: "search_symbols",
+        description: "Search symbols by name across the repo using AST (not text search). Finds classes, functions, methods by approximate name.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                rootDir: { type: "string", description: "Directory to search in" },
+                projectRoot: { type: "string", description: "Project root for security boundary" },
+                query: { type: "string", description: "Symbol name or partial name to search" },
+                fuzzy: { type: "boolean", description: "Enable fuzzy name matching (default: false)" },
+                types: { type: "array", items: { type: "string" }, description: "Filter by symbol types: class_declaration, function_declaration, method_definition, etc." },
+                fileExtensions: { type: "array", items: { type: "string" }, description: "Extensions to search (default: all supported)" },
+                excludeDirs: { type: "array", items: { type: "string" }, description: "Directories to exclude" },
+                maxResults: { type: "number", description: "Maximum results (default: 20)" },
+            },
+            required: ["rootDir", "projectRoot", "query"],
+        },
+    },
+    {
+        name: "explain_symbol",
+        description: "Get signature, location, and callers of a symbol in one call. More efficient than read_file_surgical + analyze_impact separately.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string", description: "Absolute path to file" },
+                projectRoot: { type: "string", description: "Project root (REQUIRED)" },
+                symbolName: { type: "string", description: "Symbol to explain" },
+                className: { type: "string", description: "Class name (optional, for scoping)" },
+                rootDir: { type: "string", description: "Root dir for caller search (optional, defaults to projectRoot)" },
+            },
+            required: ["filePath", "projectRoot", "symbolName"],
+        },
+    },
+    {
+        name: "batch_read",
+        description: "Read multiple symbols from multiple files in one call. Reduces N round-trips to 1.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                reads: {
+                    type: "array",
+                    description: "List of symbols to read",
+                    items: {
+                        type: "object",
+                        properties: {
+                            filePath: { type: "string", description: "Absolute path to file" },
+                            symbolName: { type: "string", description: "Symbol name to extract" },
+                            className: { type: "string", description: "Class name (optional)" },
+                        },
+                        required: ["filePath", "symbolName"],
+                    },
+                },
+                projectRoot: { type: "string", description: "Project root for security boundary" },
+            },
+            required: ["reads", "projectRoot"],
+        },
+    },
+    {
+        name: "get_rate_limit_status",
+        description: "Get current rate limiter token balance and operation costs. Use before expensive operations to check available budget.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    // ΓöÇΓöÇ END NEW TOOLS ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
+];
+//# sourceMappingURL=toolDefinitionsCore.js.map

package/dist/src/tools/toolDefinitionsCore.js.map

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

package/dist/src/tools/writeHandlers.d.ts

@@ -0,0 +1,37 @@
+/** Tool handlers */
+export declare function handleTwoPhaseWrite(args: Record<string, unknown>, operationName: string, executeWrite: () => Promise<any>): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export declare function handleWriteFileSurgical(args: Record<string, unknown>): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export declare function handleInsertSymbol(args: Record<string, unknown>): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export declare function handleRemoveSymbol(args: Record<string, unknown>): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export declare function handleRenameSymbol(args: Record<string, unknown>): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export declare function handleAstTransform(args: Record<string, unknown>): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/src/tools/writeHandlers.js

@@ -0,0 +1,199 @@
+/** Tool handlers */
+import * as path from "node:path";
+import { SecurityValidator } from "../core/validator.js";
+import { replaceSymbol, insertCode, removeSymbol, writeFile, renameSymbol } from "../operations/write.js";
+import { astTransform } from "../operations/astTransform.js";
+import { BackupManager } from "../utils/backupManager.js";
+import { verifyFileUnchanged } from "../utils/toctou.js";
+import { getSession, getRegistry, SESSION_ID } from "./context.js";
+export async function handleTwoPhaseWrite(args, operationName, executeWrite) {
+    const confirm = Boolean(args.confirm);
+    const token = args.confirmationToken ? String(args.confirmationToken) : undefined;
+    const session = getSession();
+    const projectRoot = args.projectRoot ? String(args.projectRoot) : undefined;
+    // Proactively activate SQLite persistence if projectRoot is provided
+    if (projectRoot && !session.confirmationStore.hasPersistentStore()) {
+        session.confirmationStore.activatePersistence(SESSION_ID, projectRoot);
+    }
+    if (confirm) {
+        if (!token)
+            throw new Error("confirmationToken is required when confirm=true");
+        const pendingOp = await session.confirmationStore.consumePending(token);
+        if (!pendingOp)
+            throw new Error(`Invalid or expired confirmation token: ${token}`);
+        const projectRoot = String(args.projectRoot);
+        const validator = new SecurityValidator(projectRoot);
+        const lockReleases = [];
+        try {
+            if (pendingOp.pendingWrites && pendingOp.pendingWrites.length > 0) {
+                const sortedWrites = [...pendingOp.pendingWrites].sort((a, b) => a.filePath.localeCompare(b.filePath));
+                // TOCTOU fix: Lock-Before-Verify — acquire locks first to prevent race conditions
+                for (const pw of sortedWrites) {
+                    const validation = await validator.validateFilePath(pw.filePath);
+                    if (!validation.valid)
+                        throw new Error(validation.error);
+                    if (!await session.lockManager.isLocked(validation.resolvedPath)) {
+                        lockReleases.push(await session.lockManager.acquireLock(validation.resolvedPath));
+                    }
+                }
+                // Now verify hashes with locks held — no race window
+                const resolvedWrites = [];
+                for (const pw of sortedWrites) {
+                    const resolvedPath = await verifyFileUnchanged(validator, pw.filePath, pw.originalHash);
+                    resolvedWrites.push({ resolvedPath, newContent: pw.newContent });
+                }
+                for (const { resolvedPath, newContent } of resolvedWrites) {
+                    await BackupManager.createBackup(resolvedPath, projectRoot);
+                    await writeFile(resolvedPath, newContent);
+                }
+            }
+            else {
+                // TOCTOU fix: Lock-Before-Verify for single file path
+                const validation = await validator.validateFilePath(pendingOp.filePath);
+                if (!validation.valid)
+                    throw new Error(validation.error);
+                if (!await session.lockManager.isLocked(validation.resolvedPath)) {
+                    lockReleases.push(await session.lockManager.acquireLock(validation.resolvedPath));
+                }
+                const resolvedPath = await verifyFileUnchanged(validator, pendingOp.filePath, pendingOp.originalHash);
+                await BackupManager.createBackup(resolvedPath, projectRoot);
+                await writeFile(resolvedPath, pendingOp.newContent);
+            }
+        }
+        finally {
+            for (const release of lockReleases) {
+                await release();
+            }
+        }
+        const fileCount = pendingOp.pendingWrites?.length || 1;
+        return {
+            content: [{ type: "text", text: `✅ Success. Changes applied to ${fileCount} file(s).` }],
+        };
+    }
+    // Phase 1: Dry-run
+    const result = await executeWrite();
+    if (!result.success)
+        throw new Error(result.error);
+    const hadConflict = session.confirmationStore.hasConflictingPending(String(args.filePath));
+    const newToken = session.confirmationStore.storePending({
+        filePath: String(args.filePath),
+        operation: operationName,
+        symbolName: args.symbolName ? String(args.symbolName) : undefined,
+        newContent: result.newContent,
+        diff: result.diff,
+        originalHash: result.originalHash,
+        pendingWrites: result.pendingWrites,
+    });
+    const conflictWarning = hadConflict
+        ? `\n⚠️  A previous pending token for this file was invalidated. Only this new token is valid.`
+        : "";
+    // ERG-01 + NEW-04: decode diff and apply diffFormat
+    const rawDiff = decodeURIComponent(result.diff);
+    const fmt = args.diffFormat ? String(args.diffFormat) : "unified";
+    let displayDiff;
+    if (fmt === "none") {
+        displayDiff = `(diff omitted — use diffFormat="unified" to see changes)`;
+    }
+    else if (fmt === "summary") {
+        const added = (rawDiff.match(/^\+[^+]/gm) || []).length;
+        const removed = (rawDiff.match(/^-[^-]/gm) || []).length;
+        displayDiff = `+${added} lines, -${removed} lines`;
+    }
+    else if (fmt === "compact") {
+        displayDiff = rawDiff.split("\n").filter(l => l.startsWith("+") || l.startsWith("-")).join("\n");
+    }
+    else {
+        displayDiff = rawDiff;
+    }
+    return {
+        content: [{
+                type: "text",
+                text: `DRY RUN SUCCESSFUL.${conflictWarning}\nTo apply these changes, call this tool again with confirm=true and confirmationToken="${newToken}"\n\nDiff:\n${displayDiff}`
+            }],
+    };
+}
+export async function handleWriteFileSurgical(args) {
+    return handleTwoPhaseWrite(args, "write_file_surgical", async () => {
+        const ext = path.extname(String(args.filePath));
+        const parser = getRegistry().getParser(ext);
+        if (!parser)
+            throw new Error(`No parser available for ${ext} files`);
+        return await replaceSymbol({
+            filePath: String(args.filePath),
+            projectRoot: String(args.projectRoot),
+            symbolName: String(args.symbolName),
+            newContent: String(args.newContent),
+            className: args.className ? String(args.className) : undefined,
+            parser,
+        });
+    });
+}
+export async function handleInsertSymbol(args) {
+    return handleTwoPhaseWrite(args, "insert_symbol", async () => {
+        const ext = path.extname(String(args.filePath));
+        const parser = getRegistry().getParser(ext);
+        if (!parser)
+            throw new Error(`No parser available for ${ext} files`);
+        return await insertCode({
+            filePath: String(args.filePath),
+            projectRoot: String(args.projectRoot),
+            code: String(args.code),
+            anchorSymbol: args.anchorSymbol ? String(args.anchorSymbol) : undefined,
+            position: args.position !== undefined ? String(args.position) : undefined,
+            className: args.className ? String(args.className) : undefined,
+            parser,
+        });
+    });
+}
+export async function handleRemoveSymbol(args) {
+    return handleTwoPhaseWrite(args, "remove_symbol", async () => {
+        const ext = path.extname(String(args.filePath));
+        const parser = getRegistry().getParser(ext);
+        if (!parser)
+            throw new Error(`No parser available for ${ext} files`);
+        return await removeSymbol({
+            filePath: String(args.filePath),
+            projectRoot: String(args.projectRoot),
+            symbolName: String(args.symbolName),
+            className: args.className ? String(args.className) : undefined,
+            parser,
+        });
+    });
+}
+export async function handleRenameSymbol(args) {
+    return handleTwoPhaseWrite(args, "rename_symbol", async () => {
+        const ext = path.extname(String(args.filePath));
+        const parser = getRegistry().getParser(ext);
+        if (!parser)
+            throw new Error(`No parser available for ${ext} files`);
+        return await renameSymbol({
+            filePath: String(args.filePath),
+            projectRoot: String(args.projectRoot),
+            oldName: String(args.oldName),
+            newName: String(args.newName),
+            rootDir: args.rootDir ? String(args.rootDir) : String(args.projectRoot),
+            parser,
+        });
+    });
+}
+export async function handleAstTransform(args) {
+    return handleTwoPhaseWrite(args, "ast_transform", async () => {
+        const ext = path.extname(String(args.filePath));
+        const parser = getRegistry().getParser(ext);
+        if (!parser)
+            throw new Error(`No parser available for ${ext} files`);
+        const transform = args.transform;
+        if (!transform || !transform.kind) {
+            throw new Error('"transform" object with "kind" is required');
+        }
+        return await astTransform({
+            filePath: String(args.filePath),
+            projectRoot: String(args.projectRoot),
+            symbolName: String(args.symbolName),
+            className: args.className ? String(args.className) : undefined,
+            transform,
+            parser,
+        });
+    });
+}
+//# sourceMappingURL=writeHandlers.js.map

package/dist/src/tools/writeHandlers.js.map

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

package/dist/src/utils/appDir.d.ts

@@ -0,0 +1,19 @@
+/**
+ * App Directory - v3.7.0
+ * Centralizes ~/.mcp-code-context/ path resolution across all OS.
+ * Fallback to os.tmpdir() in environments without HOME (CI, Docker).
+ */
+/**
+ * Returns an absolute path under ~/.mcp-code-context/{subdir}
+ * and ensures the directory exists.
+ *
+ * @example
+ * getAppDir("cache/abc123")   // ~/.mcp-code-context/cache/abc123/
+ * getAppDir("backups/abc123") // ~/.mcp-code-context/backups/abc123/
+ * getAppDir("index/abc123")   // ~/.mcp-code-context/index/abc123/
+ */
+export declare function getAppDir(subdir: string): string;
+/**
+ * Returns the base ~/.mcp-code-context/ directory (no subdir).
+ */
+export declare function getBaseAppDir(): string;

package/dist/src/utils/appDir.js

@@ -0,0 +1,50 @@
+/**
+ * App Directory - v3.7.0
+ * Centralizes ~/.mcp-code-context/ path resolution across all OS.
+ * Fallback to os.tmpdir() in environments without HOME (CI, Docker).
+ */
+import * as path from "node:path";
+import * as os from "node:os";
+import { mkdirSync, existsSync } from "node:fs";
+const APP_DIR_NAME = ".mcp-code-context";
+/**
+ * Resolves the base ~/.mcp-code-context/ directory.
+ * Windows : %USERPROFILE%\.mcp-code-context\
+ * Mac/Linux: ~/.mcp-code-context/
+ * Fallback : os.tmpdir()/.mcp-code-context/  (CI/Docker without HOME)
+ */
+function resolveBaseDir() {
+    const home = os.homedir();
+    if (home && home !== os.tmpdir()) {
+        return path.join(home, APP_DIR_NAME);
+    }
+    // Fallback for environments without a real home directory
+    return path.join(os.tmpdir(), APP_DIR_NAME);
+}
+const BASE_DIR = resolveBaseDir();
+/**
+ * Returns an absolute path under ~/.mcp-code-context/{subdir}
+ * and ensures the directory exists.
+ *
+ * @example
+ * getAppDir("cache/abc123")   // ~/.mcp-code-context/cache/abc123/
+ * getAppDir("backups/abc123") // ~/.mcp-code-context/backups/abc123/
+ * getAppDir("index/abc123")   // ~/.mcp-code-context/index/abc123/
+ */
+export function getAppDir(subdir) {
+    const fullPath = path.join(BASE_DIR, subdir);
+    if (!existsSync(fullPath)) {
+        mkdirSync(fullPath, { recursive: true });
+    }
+    return fullPath;
+}
+/**
+ * Returns the base ~/.mcp-code-context/ directory (no subdir).
+ */
+export function getBaseAppDir() {
+    if (!existsSync(BASE_DIR)) {
+        mkdirSync(BASE_DIR, { recursive: true });
+    }
+    return BASE_DIR;
+}
+//# sourceMappingURL=appDir.js.map

package/dist/src/utils/appDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appDir.js","sourceRoot":"","sources":["../../../src/utils/appDir.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEzC;;;;;GAKG;AACH,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,IAAI,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACvC,CAAC;IACD,0DAA0D;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/utils/auditLogWriter.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Audit log file I/O helpers
+ */
+export declare function initLogDir(logDir: string): Promise<void>;
+export declare function ensureLogFile(logDir: string, currentLogFile: string | null): Promise<{
+    file: string;
+}>;
+export declare function rotateLog(logDir: string, maxFiles: number): Promise<void>;
+export declare function getLogFiles(logDir: string): Promise<string[]>;