mcp-code-context 3.0.4 → 3.4.0

package/dist/src/parsers/registry.d.ts

@@ -1,5 +1,5 @@
 /**
- * Parser Registry - v3.0.0
+ * Parser Registry - v3.4.0
  * Manages all language parsers
  */
 import { BaseParser } from "./base.js";

package/dist/src/parsers/registry.js

@@ -1,5 +1,5 @@
 /**
- * Parser Registry - v3.0.0
+ * Parser Registry - v3.4.0
  * Manages all language parsers
  */
 import { TypeScriptParser } from "./typescript.js";
@@ -57,7 +57,7 @@ export class ParserRegistry {
         const dartParser = new DartTreeSitterParser();
         await dartParser.init(this.engine.createParser(), dartLang);
         this.parsers.set("dart", dartParser);
-        console.log("✅ Parsers loaded: TS/Python/PHP/Dart (WASM)");
+        console.error("✅ Parsers loaded: TS/Python/PHP/Dart (WASM)");
     }
     getParser(fileExtension) {
         const language = this.extensionMap.get(fileExtension);

package/dist/src/parsers/registry.js.map

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

package/dist/src/parsers/typescript.d.ts

@@ -1,13 +1,13 @@
 /**
- * TypeScript Parser - v3.0.0
+ * TypeScript Parser - v3.4.0
  * Tree-sitter based TS/JS parser
+ * CLEANUP: replaceSymbol removed (inherited from BaseParser)
  */
 import { Tree } from "web-tree-sitter";
 import { BaseParser, SymbolInfo } from "./base.js";
 export declare class TypeScriptParser extends BaseParser {
     constructor();
     extractSymbol(tree: Tree, symbolName: string, className?: string): string | null;
-    replaceSymbol(content: string, tree: Tree, symbolName: string, newContent: string, className?: string): string;
     findSymbols(tree: Tree): SymbolInfo[];
     private findParentClass;
 }

package/dist/src/parsers/typescript.js

@@ -1,6 +1,7 @@
 /**
- * TypeScript Parser - v3.0.0
+ * TypeScript Parser - v3.4.0
  * Tree-sitter based TS/JS parser
+ * CLEANUP: replaceSymbol removed (inherited from BaseParser)
  */
 import { BaseParser } from "./base.js";
 export class TypeScriptParser extends BaseParser {
@@ -15,7 +16,10 @@ export class TypeScriptParser extends BaseParser {
                 node.type === "class_declaration" ||
                 node.type === "interface_declaration" ||
                 node.type === "type_alias_declaration" ||
-                node.type === "method_definition") {
+                node.type === "method_definition" ||
+                node.type === "lexical_declaration" ||
+                node.type === "variable_declaration" ||
+                node.type === "export_statement") {
                 const nameNode = node.childForFieldName("name");
                 if (nameNode && nameNode.text === symbolName) {
                     if (className) {
@@ -44,17 +48,6 @@ export class TypeScriptParser extends BaseParser {
         };
         return search();
     }
-    replaceSymbol(content, tree, symbolName, newContent, className) {
-        const extracted = this.extractSymbol(tree, symbolName, className);
-        if (!extracted) {
-            throw new Error(`Symbol "${symbolName}" not found`);
-        }
-        const index = content.indexOf(extracted);
-        if (index === -1) {
-            throw new Error("Could not locate symbol in content");
-        }
-        return content.substring(0, index) + newContent + content.substring(index + extracted.length);
-    }
     findSymbols(tree) {
         const symbols = [];
         const cursor = tree.walk();
@@ -67,11 +60,13 @@ export class TypeScriptParser extends BaseParser {
                 node.type === "method_definition") {
                 const nameNode = node.childForFieldName("name");
                 if (nameNode) {
+                    const parentClass = this.findParentClass(node);
                     symbols.push({
                         name: nameNode.text,
                         type: node.type,
                         startIndex: node.startIndex,
                         endIndex: node.endIndex,
+                        className: parentClass?.childForFieldName("name")?.text,
                     });
                 }
             }

package/dist/src/parsers/typescript.js.map

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

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

@@ -0,0 +1,90 @@
+/**
+ * Audit Logger - v3.4.0
+ * Comprehensive audit trail for all operations
+ */
+export interface AuditEntry {
+    timestamp: number;
+    level: "info" | "warn" | "error" | "security";
+    operation: string;
+    clientId?: string;
+    filePath?: string;
+    details: Record<string, any>;
+    result: "success" | "failure";
+    error?: string;
+    duration?: number;
+}
+export interface AuditLogConfig {
+    logDir: string;
+    maxFileSize: number;
+    maxFiles: number;
+    enableConsole: boolean;
+    enableFile: boolean;
+}
+export declare class AuditLogger {
+    private config;
+    private currentLogFile;
+    private currentLogSize;
+    private logBuffer;
+    private flushInterval;
+    private _ready;
+    constructor(config?: Partial<AuditLogConfig>);
+    /**
+     * Log an audit entry
+     */
+    log(entry: Omit<AuditEntry, "timestamp">): Promise<void>;
+    /**
+     * Log security event
+     */
+    logSecurity(operation: string, details: Record<string, any>, result: "success" | "failure", error?: string): Promise<void>;
+    /**
+     * Log write operation
+     */
+    logWrite(operation: string, filePath: string, clientId: string, result: "success" | "failure", details?: Record<string, any>, error?: string): Promise<void>;
+    /**
+     * Log read operation
+     */
+    logRead(operation: string, filePath: string, clientId: string, duration: number, result: "success" | "failure", error?: string): Promise<void>;
+    /**
+     * Flush buffer to file
+     */
+    flush(): Promise<void>;
+    /**
+     * Query audit logs
+     */
+    query(filters: {
+        startTime?: number;
+        endTime?: number;
+        level?: AuditEntry["level"];
+        operation?: string;
+        clientId?: string;
+        result?: "success" | "failure";
+        limit?: number;
+    }): Promise<AuditEntry[]>;
+    /**
+     * Get audit statistics
+     */
+    getStats(timeRange?: {
+        start: number;
+        end: number;
+    }): Promise<{
+        totalEntries: number;
+        byLevel: Record<string, number>;
+        byOperation: Record<string, number>;
+        byResult: Record<string, number>;
+        securityEvents: number;
+    }>;
+    /**
+     * Stop logger and flush
+     */
+    stop(): Promise<void>;
+    private initLogDir;
+    private ensureLogFile;
+    private rotateLog;
+    private getLogFiles;
+    private logToConsole;
+    private startFlushInterval;
+}
+/**
+ * Global audit logger instance
+ */
+export declare const globalAuditLogger: AuditLogger;

package/dist/src/utils/auditLogger.js

@@ -0,0 +1,271 @@
+/**
+ * Audit Logger - v3.4.0
+ * Comprehensive audit trail for all operations
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+export class AuditLogger {
+    config;
+    currentLogFile = null;
+    currentLogSize = 0;
+    logBuffer = [];
+    flushInterval = null;
+    _ready = Promise.resolve();
+    constructor(config = {}) {
+        this.config = {
+            logDir: config.logDir || "./.mcp-audit-logs",
+            maxFileSize: config.maxFileSize || 10 * 1024 * 1024, // 10MB
+            maxFiles: config.maxFiles || 10,
+            enableConsole: config.enableConsole ?? true,
+            enableFile: config.enableFile ?? true,
+        };
+        if (this.config.enableFile) {
+            // Properly await dir creation before any writes
+            this._ready = this.initLogDir();
+            this.startFlushInterval();
+        }
+    }
+    /**
+     * Log an audit entry
+     */
+    async log(entry) {
+        const fullEntry = {
+            ...entry,
+            timestamp: Date.now(),
+        };
+        // Console output
+        if (this.config.enableConsole) {
+            this.logToConsole(fullEntry);
+        }
+        // File output
+        if (this.config.enableFile) {
+            this.logBuffer.push(fullEntry);
+            // Flush if buffer is large
+            if (this.logBuffer.length >= 100) {
+                await this.flush();
+            }
+        }
+    }
+    /**
+     * Log security event
+     */
+    async logSecurity(operation, details, result, error) {
+        await this.log({
+            level: "security",
+            operation,
+            details,
+            result,
+            error,
+        });
+    }
+    /**
+     * Log write operation
+     */
+    async logWrite(operation, filePath, clientId, result, details = {}, error) {
+        await this.log({
+            level: result === "success" ? "info" : "error",
+            operation,
+            clientId,
+            filePath,
+            details,
+            result,
+            error,
+        });
+    }
+    /**
+     * Log read operation
+     */
+    async logRead(operation, filePath, clientId, duration, result, error) {
+        await this.log({
+            level: "info",
+            operation,
+            clientId,
+            filePath,
+            details: {},
+            result,
+            error,
+            duration,
+        });
+    }
+    /**
+     * Flush buffer to file
+     */
+    async flush() {
+        if (this.logBuffer.length === 0)
+            return;
+        await this._ready;
+        try {
+            await this.ensureLogFile();
+            const logLines = this.logBuffer.map((entry) => JSON.stringify(entry)).join("\n") + "\n";
+            const logSize = Buffer.byteLength(logLines, "utf-8");
+            await fs.appendFile(this.currentLogFile, logLines, "utf-8");
+            this.currentLogSize += logSize;
+            this.logBuffer = [];
+            // Rotate if needed
+            if (this.currentLogSize >= this.config.maxFileSize) {
+                await this.rotateLog();
+            }
+        }
+        catch (error) {
+            console.error("Failed to flush audit log:", error);
+        }
+    }
+    /**
+     * Query audit logs
+     */
+    async query(filters) {
+        const results = [];
+        const limit = filters.limit || 1000;
+        try {
+            const files = await this.getLogFiles();
+            for (const file of files.reverse()) {
+                if (results.length >= limit)
+                    break;
+                const content = await fs.readFile(file, "utf-8");
+                const lines = content.split("\n").filter((line) => line.trim());
+                for (const line of lines.reverse()) {
+                    if (results.length >= limit)
+                        break;
+                    try {
+                        const entry = JSON.parse(line);
+                        // Apply filters
+                        if (filters.startTime && entry.timestamp < filters.startTime)
+                            continue;
+                        if (filters.endTime && entry.timestamp > filters.endTime)
+                            continue;
+                        if (filters.level && entry.level !== filters.level)
+                            continue;
+                        if (filters.operation && entry.operation !== filters.operation)
+                            continue;
+                        if (filters.clientId && entry.clientId !== filters.clientId)
+                            continue;
+                        if (filters.result && entry.result !== filters.result)
+                            continue;
+                        results.push(entry);
+                    }
+                    catch {
+                        // Skip invalid lines
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error("Failed to query audit logs:", error);
+        }
+        return results;
+    }
+    /**
+     * Get audit statistics
+     */
+    async getStats(timeRange) {
+        const entries = await this.query({
+            startTime: timeRange?.start,
+            endTime: timeRange?.end,
+            limit: 100000,
+        });
+        const stats = {
+            totalEntries: entries.length,
+            byLevel: {},
+            byOperation: {},
+            byResult: {},
+            securityEvents: 0,
+        };
+        for (const entry of entries) {
+            stats.byLevel[entry.level] = (stats.byLevel[entry.level] || 0) + 1;
+            stats.byOperation[entry.operation] = (stats.byOperation[entry.operation] || 0) + 1;
+            stats.byResult[entry.result] = (stats.byResult[entry.result] || 0) + 1;
+            if (entry.level === "security") {
+                stats.securityEvents++;
+            }
+        }
+        return stats;
+    }
+    /**
+     * Stop logger and flush
+     */
+    async stop() {
+        if (this.flushInterval) {
+            clearInterval(this.flushInterval);
+            this.flushInterval = null;
+        }
+        await this.flush();
+    }
+    // Private methods
+    async initLogDir() {
+        try {
+            await fs.mkdir(this.config.logDir, { recursive: true });
+        }
+        catch (error) {
+            console.error("Failed to create audit log directory:", error);
+        }
+    }
+    async ensureLogFile() {
+        if (!this.currentLogFile) {
+            const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+            this.currentLogFile = path.join(this.config.logDir, `audit-${timestamp}.log`);
+            this.currentLogSize = 0;
+        }
+    }
+    async rotateLog() {
+        this.currentLogFile = null;
+        this.currentLogSize = 0;
+        // Cleanup old logs
+        const files = await this.getLogFiles();
+        if (files.length > this.config.maxFiles) {
+            const toDelete = files.slice(0, files.length - this.config.maxFiles);
+            for (const file of toDelete) {
+                try {
+                    await fs.unlink(file);
+                }
+                catch {
+                    // Ignore errors
+                }
+            }
+        }
+    }
+    async getLogFiles() {
+        try {
+            const entries = await fs.readdir(this.config.logDir);
+            const files = entries
+                .filter((name) => name.startsWith("audit-") && name.endsWith(".log"))
+                .map((name) => path.join(this.config.logDir, name));
+            // Sort by creation time
+            const stats = await Promise.all(files.map(async (file) => ({
+                file,
+                mtime: (await fs.stat(file)).mtime.getTime(),
+            })));
+            return stats.sort((a, b) => a.mtime - b.mtime).map((s) => s.file);
+        }
+        catch {
+            return [];
+        }
+    }
+    logToConsole(entry) {
+        const emoji = {
+            info: "ℹ️",
+            warn: "⚠️",
+            error: "❌",
+            security: "🔒",
+        }[entry.level];
+        const timestamp = new Date(entry.timestamp).toISOString();
+        const message = `${emoji} [${timestamp}] ${entry.operation} - ${entry.result}`;
+        if (entry.level === "error" || entry.level === "security") {
+            console.error(message, entry.error || "");
+        }
+        else {
+            console.error(message);
+        }
+    }
+    startFlushInterval() {
+        this.flushInterval = setInterval(() => {
+            this.flush().catch((error) => {
+                console.error("Failed to flush audit log:", error);
+            });
+        }, 5000); // Flush every 5 seconds
+    }
+}
+/**
+ * Global audit logger instance
+ */
+export const globalAuditLogger = new AuditLogger();
+//# sourceMappingURL=auditLogger.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * Backup Manager - v3.4.0
+ * Handles rolling backups for file modifications
+ */
+export declare class BackupManager {
+    private static readonly MAX_BACKUPS;
+    private static readonly BACKUP_DIR_NAME;
+    /**
+     * Creates a backup of the specified file before it gets modified
+     */
+    static createBackup(filePath: string, projectRoot: string): Promise<void>;
+    /**
+     * Restores a file to its previous state
+     * @param steps How many versions to go back (1 = last version)
+     */
+    static rollback(filePath: string, projectRoot: string, steps?: number): Promise<{
+        success: boolean;
+        error?: string;
+        restoredFrom?: string;
+    }>;
+    /**
+     * Deletes all backups for a project
+     */
+    static clean(projectRoot: string): Promise<{
+        success: boolean;
+        error?: string;
+        deletedCount?: number;
+    }>;
+    /**
+     * Private helper to delete oldest backups if exceeding limit
+     */
+    private static enforceBackupLimit;
+}

package/dist/src/utils/backupManager.js

@@ -0,0 +1,130 @@
+/**
+ * Backup Manager - v3.4.0
+ * Handles rolling backups for file modifications
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as crypto from "node:crypto";
+export class BackupManager {
+    static MAX_BACKUPS = 5;
+    static BACKUP_DIR_NAME = ".mcp-backups";
+    /**
+     * Creates a backup of the specified file before it gets modified
+     */
+    static async createBackup(filePath, projectRoot) {
+        try {
+            // Check if original file exists before backing up
+            await fs.access(filePath);
+        }
+        catch {
+            // File doesn't exist yet (it's a new file), no backup needed
+            return;
+        }
+        const backupDir = path.join(projectRoot, this.BACKUP_DIR_NAME);
+        await fs.mkdir(backupDir, { recursive: true });
+        // Generate a safe identifier for the file (hash of its path to avoid deep nesting in backup dir)
+        const relativePath = path.relative(projectRoot, filePath);
+        const safeName = crypto.createHash('md5').update(relativePath).digest('hex').substring(0, 8) + "_" + path.basename(filePath);
+        // Save backup with timestamp
+        const timestamp = Date.now();
+        const backupFileName = `${safeName}_${timestamp}.bak`;
+        const backupFilePath = path.join(backupDir, backupFileName);
+        // Copy original file to backup
+        await fs.copyFile(filePath, backupFilePath);
+        // Enforce rolling backup limit per file
+        await this.enforceBackupLimit(backupDir, safeName);
+    }
+    /**
+     * Restores a file to its previous state
+     * @param steps How many versions to go back (1 = last version)
+     */
+    static async rollback(filePath, projectRoot, steps = 1) {
+        try {
+            const backupDir = path.join(projectRoot, this.BACKUP_DIR_NAME);
+            const relativePath = path.relative(projectRoot, filePath);
+            const safeName = crypto.createHash('md5').update(relativePath).digest('hex').substring(0, 8) + "_" + path.basename(filePath);
+            let files;
+            try {
+                files = await fs.readdir(backupDir);
+            }
+            catch {
+                return { success: false, error: "No backups found for this project." };
+            }
+            // Filter backups for this specific file and sort by timestamp descending (newest first)
+            const fileBackups = files
+                .filter(f => f.startsWith(safeName + "_") && f.endsWith(".bak"))
+                .sort((a, b) => b.localeCompare(a)); // String comparison of timestamps works because they are unix ms
+            if (fileBackups.length === 0) {
+                return { success: false, error: `No backups found for file: ${path.basename(filePath)}` };
+            }
+            // Determine which backup to restore
+            const targetIndex = Math.min(steps - 1, fileBackups.length - 1);
+            const targetBackup = fileBackups[targetIndex];
+            const backupFilePath = path.join(backupDir, targetBackup);
+            // Restore: copy backup back to original location
+            await fs.copyFile(backupFilePath, filePath);
+            return { success: true, restoredFrom: targetBackup };
+        }
+        catch (error) {
+            return { success: false, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    /**
+     * Deletes all backups for a project
+     */
+    static async clean(projectRoot) {
+        try {
+            const backupDir = path.join(projectRoot, this.BACKUP_DIR_NAME);
+            try {
+                const files = await fs.readdir(backupDir);
+                let deletedCount = 0;
+                for (const file of files) {
+                    const filePath = path.join(backupDir, file);
+                    const stat = await fs.stat(filePath);
+                    if (stat.isDirectory()) {
+                        await fs.rm(filePath, { recursive: true, force: true });
+                    }
+                    else {
+                        await fs.unlink(filePath);
+                    }
+                    deletedCount++;
+                }
+                await fs.rmdir(backupDir);
+                return { success: true, deletedCount };
+            }
+            catch (e) {
+                if (e.code === 'ENOENT') {
+                    // Directory doesn't exist
+                    return { success: true, deletedCount: 0 };
+                }
+                throw e;
+            }
+        }
+        catch (error) {
+            return { success: false, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    /**
+     * Private helper to delete oldest backups if exceeding limit
+     */
+    static async enforceBackupLimit(backupDir, safeName) {
+        try {
+            const files = await fs.readdir(backupDir);
+            const fileBackups = files
+                .filter(f => f.startsWith(safeName + "_") && f.endsWith(".bak"))
+                .sort((a, b) => b.localeCompare(a)); // Newest first
+            // If we have more than MAX_BACKUPS, delete the oldest ones
+            if (fileBackups.length > this.MAX_BACKUPS) {
+                const backupsToDelete = fileBackups.slice(this.MAX_BACKUPS);
+                for (const backup of backupsToDelete) {
+                    await fs.unlink(path.join(backupDir, backup));
+                }
+            }
+        }
+        catch (error) {
+            // Non-fatal, just logging silently
+            console.error(`Failed to enforce backup limits in ${backupDir}`, error);
+        }
+    }
+}
+//# sourceMappingURL=backupManager.js.map