mcp-code-context 3.9.2 → 7.0.0

package/dist/src/operations/contextCompactor.js

@@ -0,0 +1,348 @@
+/**
+ * Lossless AST Snapshot Context Compactor (v4.7.0)
+ *
+ * Compresses source files into pure AST contract outlines (interfaces, type definitions,
+ * class structures, field types, and method signatures) while dropping implementation bodies.
+ * Preserves 100% of structural and type fidelity for AI LLMs while saving 80% to 90% of tokens.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { existsSync } from "node:fs";
+import { ParserRegistry } from "../parsers/registry.js";
+import { CodeContextEngine } from "../core/engine.js";
+/**
+ * Estimates token count from string length (~4 characters per token)
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Compacts a TypeScript/JavaScript AST node into signatures
+ */
+function compactTypeScriptNode(node, dropPrivate, includeDocstrings) {
+    const lines = [];
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const child = node.namedChild(i);
+        if (!child)
+            continue;
+        // Comments / JSDoc
+        if (child.type === "comment") {
+            if (includeDocstrings && (child.text.startsWith("/**") || child.text.startsWith("/*"))) {
+                lines.push(child.text);
+            }
+            continue;
+        }
+        // Exported or plain interface / type alias / enum
+        if (child.type === "interface_declaration" ||
+            child.type === "type_alias_declaration" ||
+            child.type === "enum_declaration") {
+            lines.push(child.text);
+            lines.push("");
+            continue;
+        }
+        // Export statement wrapping an interface, type, class, or function
+        if (child.type === "export_statement") {
+            const decl = child.childForFieldName("declaration");
+            if (decl) {
+                if (decl.type === "interface_declaration" ||
+                    decl.type === "type_alias_declaration" ||
+                    decl.type === "enum_declaration") {
+                    lines.push(child.text);
+                    lines.push("");
+                    continue;
+                }
+                else if (decl.type === "class_declaration") {
+                    lines.push(...compactClassDeclaration(decl, "export ", dropPrivate));
+                    lines.push("");
+                    continue;
+                }
+                else if (decl.type === "function_declaration") {
+                    const fnSig = compactFunctionSignature(decl, "export ");
+                    if (fnSig) {
+                        lines.push(fnSig);
+                        lines.push("");
+                    }
+                    continue;
+                }
+            }
+            else {
+                // export { a, b }
+                lines.push(child.text);
+                continue;
+            }
+        }
+        // Standalone class declaration
+        if (child.type === "class_declaration") {
+            lines.push(...compactClassDeclaration(child, "", dropPrivate));
+            lines.push("");
+            continue;
+        }
+        // Standalone function declaration
+        if (child.type === "function_declaration") {
+            const fnSig = compactFunctionSignature(child, "");
+            if (fnSig) {
+                lines.push(fnSig);
+                lines.push("");
+            }
+            continue;
+        }
+        // Top-level const / variable export
+        if (child.type === "lexical_declaration" || child.type === "variable_declaration") {
+            for (let j = 0; j < child.namedChildCount; j++) {
+                const vd = child.namedChild(j);
+                if (vd && vd.type === "variable_declarator") {
+                    const name = vd.childForFieldName("name")?.text || "";
+                    const typeAnn = vd.childForFieldName("type")?.text || "";
+                    lines.push(`const ${name}${typeAnn ? `: ${typeAnn}` : ""};`);
+                }
+            }
+        }
+    }
+    return lines;
+}
+/**
+ * Compacts TypeScript class declaration into signatures
+ */
+function compactClassDeclaration(classNode, prefix, dropPrivate) {
+    const result = [];
+    const className = classNode.childForFieldName("name")?.text || "AnonymousClass";
+    const body = classNode.childForFieldName("body");
+    // Heritage: extends / implements
+    let heritage = "";
+    for (let i = 0; i < classNode.childCount; i++) {
+        const c = classNode.child(i);
+        if (c && (c.type === "class_heritage" || c.type === "heritage_clause")) {
+            heritage += ` ${c.text}`;
+        }
+    }
+    result.push(`${prefix}class ${className}${heritage} {`);
+    if (body) {
+        for (let i = 0; i < body.namedChildCount; i++) {
+            const member = body.namedChild(i);
+            if (!member)
+                continue;
+            const isPrivate = member.text.startsWith("private ") || member.text.startsWith("#");
+            if (dropPrivate && isPrivate)
+                continue;
+            if (member.type === "field_definition" || member.type === "public_field_definition") {
+                const fieldName = member.childForFieldName("property")?.text || member.text.split("=")[0].trim();
+                const typeNode = member.childForFieldName("type");
+                const typeStr = typeNode ? `: ${typeNode.text}` : "";
+                result.push(`  ${fieldName}${typeStr};`);
+            }
+            else if (member.type === "method_definition") {
+                const methodBody = member.childForFieldName("body");
+                if (methodBody) {
+                    const sig = member.text.slice(0, methodBody.startIndex - member.startIndex).trim();
+                    result.push(`  ${sig} { /* ... */ }`);
+                }
+                else {
+                    result.push(`  ${member.text.trim()};`);
+                }
+            }
+        }
+    }
+    result.push("}");
+    return result;
+}
+/**
+ * Extracts signature of a function declaration, replacing body with stub
+ */
+function compactFunctionSignature(fnNode, prefix) {
+    const body = fnNode.childForFieldName("body");
+    if (body) {
+        const sig = fnNode.text.slice(0, body.startIndex - fnNode.startIndex).trim();
+        return `${prefix}${sig} { /* ... */ }`;
+    }
+    return `${prefix}${fnNode.text.trim()};`;
+}
+/**
+ * Compacts a Python AST module into signatures
+ */
+function compactPythonNode(node, dropPrivate, includeDocstrings) {
+    const lines = [];
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const child = node.namedChild(i);
+        if (!child)
+            continue;
+        // Docstrings
+        if (child.type === "expression_statement") {
+            const expr = child.namedChild(0);
+            if (expr && expr.type === "string" && includeDocstrings) {
+                lines.push(child.text);
+            }
+            continue;
+        }
+        // Imports
+        if (child.type === "import_statement" || child.type === "import_from_statement") {
+            lines.push(child.text);
+            continue;
+        }
+        // Class definition
+        if (child.type === "class_definition") {
+            const className = child.childForFieldName("name")?.text || "Anonymous";
+            const superClasses = child.childForFieldName("superclasses")?.text || "";
+            const classHeader = `class ${className}${superClasses ? `(${superClasses})` : ""}:`;
+            lines.push(classHeader);
+            const body = child.childForFieldName("body");
+            if (body) {
+                let hasMembers = false;
+                for (let j = 0; j < body.namedChildCount; j++) {
+                    const m = body.namedChild(j);
+                    if (!m)
+                        continue;
+                    if (m.type === "function_definition") {
+                        const mName = m.childForFieldName("name")?.text || "";
+                        if (dropPrivate && mName.startsWith("_") && !mName.startsWith("__init__"))
+                            continue;
+                        const mBody = m.childForFieldName("body");
+                        if (mBody) {
+                            const sig = m.text.slice(0, mBody.startIndex - m.startIndex).trim();
+                            lines.push(`    ${sig}`);
+                            lines.push("        ...");
+                            hasMembers = true;
+                        }
+                    }
+                    else if (m.type === "expression_statement") {
+                        // Type annotated field e.g. id: int
+                        if (m.text.includes(":")) {
+                            lines.push(`    ${m.text}`);
+                            hasMembers = true;
+                        }
+                    }
+                }
+                if (!hasMembers) {
+                    lines.push("    pass");
+                }
+            }
+            else {
+                lines.push("    pass");
+            }
+            lines.push("");
+            continue;
+        }
+        // Function definition
+        if (child.type === "function_definition") {
+            const fnName = child.childForFieldName("name")?.text || "";
+            if (dropPrivate && fnName.startsWith("_"))
+                continue;
+            const body = child.childForFieldName("body");
+            if (body) {
+                const sig = child.text.slice(0, body.startIndex - child.startIndex).trim();
+                lines.push(sig);
+                lines.push("    ...");
+                lines.push("");
+            }
+            continue;
+        }
+    }
+    return lines;
+}
+/**
+ * Main compactContextLedger operation
+ */
+export async function compactContextLedger(params) {
+    try {
+        const rawPaths = Array.isArray(params.filePaths)
+            ? params.filePaths
+            : params.filePaths.split(",").map(p => p.trim()).filter(Boolean);
+        if (rawPaths.length === 0) {
+            return {
+                success: false,
+                error: "filePaths is required for compact_context_ledger",
+            };
+        }
+        const dropPrivate = params.dropPrivate ?? false;
+        const includeDocstrings = params.includeDocstrings ?? true;
+        // Initialize Parser Registry
+        let registry = params.registry;
+        if (!registry) {
+            const engine = new CodeContextEngine();
+            await engine.init();
+            registry = new ParserRegistry(engine);
+            await registry.init();
+        }
+        const compactedEntries = [];
+        let totalOriginalTokens = 0;
+        let totalCompactedTokens = 0;
+        const ledgerSections = [];
+        for (const rawPath of rawPaths) {
+            const absPath = path.isAbsolute(rawPath) ? rawPath : path.resolve(params.projectRoot, rawPath);
+            let content = params.content;
+            if (!content) {
+                if (!existsSync(absPath)) {
+                    continue; // Skip non-existent files gracefully
+                }
+                content = await fs.readFile(absPath, "utf-8");
+            }
+            const ext = path.extname(absPath).toLowerCase();
+            const parser = registry.getParser(ext === ".py" ? ".py" : ".ts");
+            if (!parser)
+                continue;
+            let tree = null;
+            try {
+                tree = parser.parse(content);
+                const rootNode = tree.rootNode;
+                let outlineLines = [];
+                if (ext === ".py") {
+                    outlineLines = compactPythonNode(rootNode, dropPrivate, includeDocstrings);
+                }
+                else {
+                    outlineLines = compactTypeScriptNode(rootNode, dropPrivate, includeDocstrings);
+                }
+                const astOutline = outlineLines.join("\n").trim();
+                const origChars = content.length;
+                const compChars = astOutline.length;
+                const origTokens = estimateTokens(content);
+                const compTokens = estimateTokens(astOutline);
+                const savingsPct = origTokens > 0
+                    ? Number((((origTokens - compTokens) / origTokens) * 100).toFixed(1))
+                    : 0;
+                totalOriginalTokens += origTokens;
+                totalCompactedTokens += compTokens;
+                const relPath = path.relative(params.projectRoot, absPath).replace(/\\/g, "/");
+                compactedEntries.push({
+                    filePath: relPath,
+                    language: ext === ".py" ? "python" : "typescript",
+                    originalChars: origChars,
+                    compactedChars: compChars,
+                    originalTokensEst: origTokens,
+                    compactedTokensEst: compTokens,
+                    savingsPercentage: savingsPct,
+                    astOutline,
+                });
+                const langFence = ext === ".py" ? "python" : "typescript";
+                ledgerSections.push(`### File: \`${relPath}\` (${savingsPct}% token reduction)\n\`\`\`${langFence}\n${astOutline}\n\`\`\``);
+            }
+            finally {
+                // SRE Guardrail: Strict WASM Linear Memory Disposal
+                try {
+                    tree?.delete();
+                }
+                catch { }
+            }
+        }
+        const overallSavings = totalOriginalTokens > 0
+            ? Number((((totalOriginalTokens - totalCompactedTokens) / totalOriginalTokens) * 100).toFixed(1))
+            : 0;
+        const report = {
+            filesCount: compactedEntries.length,
+            totalOriginalTokensEst: totalOriginalTokens,
+            totalCompactedTokensEst: totalCompactedTokens,
+            overallSavingsPercentage: overallSavings,
+            files: compactedEntries,
+            combinedLedger: ledgerSections.join("\n\n"),
+        };
+        return {
+            success: true,
+            content: JSON.stringify(report, null, 2),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `compact_context_ledger failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+//# sourceMappingURL=contextCompactor.js.map

package/dist/src/operations/contextCompactor.js.map

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

package/dist/src/operations/cstCodemod.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Lossless CST Structural Codemod Engine
+ * v6.0.0 Enterprise AST Intelligence
+ */
+import { ParserRegistry } from "../parsers/registry.js";
+import type { ReadResult } from "./readCore.js";
+export type CodemodRule = "cjs-to-esm" | "strip-console" | "named-to-arrow";
+export interface CodemodChange {
+    rule: string;
+    startLine: number;
+    endLine: number;
+    originalSnippet: string;
+    transformedSnippet: string;
+}
+export interface CstCodemodReport {
+    filePath?: string;
+    ruleApplied: string;
+    changesApplied: number;
+    changes: CodemodChange[];
+    transformedCode: string;
+    summary: string;
+}
+export interface CstCodemodOptions {
+    filePath?: string;
+    code?: string;
+    content?: string;
+    rule: CodemodRule;
+    projectRoot?: string;
+    registry?: ParserRegistry;
+}
+/**
+ * Main CST Codemod Transpile Operation
+ */
+export declare function astCodemodTranspile(params: CstCodemodOptions): Promise<ReadResult>;

package/dist/src/operations/cstCodemod.js

@@ -0,0 +1,205 @@
+/**
+ * Lossless CST Structural Codemod Engine
+ * v6.0.0 Enterprise AST Intelligence
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { existsSync } from "node:fs";
+import { ParserRegistry } from "../parsers/registry.js";
+import { CodeContextEngine } from "../core/engine.js";
+/**
+ * Transforms CommonJS require statements into ESM import statements
+ */
+function applyCjsToEsm(root, source) {
+    const changes = [];
+    const replacements = [];
+    function walk(n) {
+        // const x = require('x');
+        if (n.type === "lexical_declaration" ||
+            n.type === "variable_declaration") {
+            for (let i = 0; i < n.namedChildCount; i++) {
+                const decl = n.namedChild(i);
+                if (decl && decl.type === "variable_declarator") {
+                    const init = decl.childForFieldName("value");
+                    if (init &&
+                        init.type === "call_expression" &&
+                        init.childForFieldName("function")?.text === "require") {
+                        const varName = decl.childForFieldName("name")?.text;
+                        const args = init.childForFieldName("arguments");
+                        const modPath = args?.namedChild(0)?.text;
+                        if (varName && modPath) {
+                            const esm = `import ${varName} from ${modPath};`;
+                            replacements.push({
+                                start: n.startIndex,
+                                end: n.endIndex,
+                                text: esm,
+                            });
+                            changes.push({
+                                rule: "cjs-to-esm",
+                                startLine: n.startPosition.row + 1,
+                                endLine: n.endPosition.row + 1,
+                                originalSnippet: n.text,
+                                transformedSnippet: esm,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        // module.exports = x;
+        if (n.type === "expression_statement") {
+            const expr = n.namedChild(0);
+            if (expr && expr.type === "assignment_expression") {
+                const left = expr.childForFieldName("left")?.text;
+                const right = expr.childForFieldName("right")?.text;
+                if (left === "module.exports" && right) {
+                    const esm = `export default ${right};`;
+                    replacements.push({
+                        start: n.startIndex,
+                        end: n.endIndex,
+                        text: esm,
+                    });
+                    changes.push({
+                        rule: "cjs-to-esm",
+                        startLine: n.startPosition.row + 1,
+                        endLine: n.endPosition.row + 1,
+                        originalSnippet: n.text,
+                        transformedSnippet: esm,
+                    });
+                }
+            }
+        }
+        for (let i = 0; i < n.namedChildCount; i++) {
+            const child = n.namedChild(i);
+            if (child)
+                walk(child);
+        }
+    }
+    walk(root);
+    // Apply replacements from end to start to maintain indices
+    replacements.sort((a, b) => b.start - a.start);
+    let transformed = source;
+    for (const r of replacements) {
+        transformed = transformed.slice(0, r.start) + r.text + transformed.slice(r.end);
+    }
+    return { transformed, changes };
+}
+/**
+ * Strips console.log calls
+ */
+function applyStripConsole(root, source) {
+    const changes = [];
+    const replacements = [];
+    function walk(n) {
+        if (n.type === "expression_statement") {
+            const expr = n.namedChild(0);
+            if (expr &&
+                expr.type === "call_expression" &&
+                expr.childForFieldName("function")?.text?.startsWith("console.")) {
+                replacements.push({
+                    start: n.startIndex,
+                    end: n.endIndex,
+                    text: "",
+                });
+                changes.push({
+                    rule: "strip-console",
+                    startLine: n.startPosition.row + 1,
+                    endLine: n.endPosition.row + 1,
+                    originalSnippet: n.text,
+                    transformedSnippet: "/* removed */",
+                });
+            }
+        }
+        for (let i = 0; i < n.namedChildCount; i++) {
+            const child = n.namedChild(i);
+            if (child)
+                walk(child);
+        }
+    }
+    walk(root);
+    replacements.sort((a, b) => b.start - a.start);
+    let transformed = source;
+    for (const r of replacements) {
+        transformed = transformed.slice(0, r.start) + r.text + transformed.slice(r.end);
+    }
+    return { transformed, changes };
+}
+/**
+ * Main CST Codemod Transpile Operation
+ */
+export async function astCodemodTranspile(params) {
+    let tree = null;
+    try {
+        const targetPath = params.filePath || "in_memory.ts";
+        let content = params.code ?? params.content;
+        if (content === undefined) {
+            if (params.filePath && existsSync(params.filePath)) {
+                content = await fs.readFile(params.filePath, "utf-8");
+            }
+            else {
+                return {
+                    success: false,
+                    error: `File does not exist: ${params.filePath || "none"}`,
+                };
+            }
+        }
+        const ext = path.extname(targetPath).toLowerCase();
+        let registry = params.registry;
+        if (!registry) {
+            const engine = new CodeContextEngine();
+            await engine.init();
+            registry = new ParserRegistry(engine);
+            await registry.init();
+        }
+        const parser = registry.getParser(ext === ".py" ? ".py" : ".ts");
+        if (!parser) {
+            return {
+                success: false,
+                error: `No parser available for extension: ${ext}`,
+            };
+        }
+        tree = parser.parse(content);
+        let result = { transformed: content, changes: [] };
+        if (params.rule === "cjs-to-esm") {
+            result = applyCjsToEsm(tree.rootNode, content);
+        }
+        else if (params.rule === "strip-console") {
+            result = applyStripConsole(tree.rootNode, content);
+        }
+        else {
+            return {
+                success: false,
+                error: `Unsupported codemod rule: '${params.rule}'. Supported: 'cjs-to-esm', 'strip-console'.`,
+            };
+        }
+        const report = {
+            filePath: params.filePath,
+            ruleApplied: params.rule,
+            changesApplied: result.changes.length,
+            changes: result.changes,
+            transformedCode: result.transformed,
+            summary: `Successfully applied codemod '${params.rule}'. Performed ${result.changes.length} lossless CST transformations.`,
+        };
+        return {
+            success: true,
+            content: JSON.stringify(report, null, 2),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `ast_codemod_transpile failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    finally {
+        if (tree) {
+            try {
+                tree.delete();
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+//# sourceMappingURL=cstCodemod.js.map

package/dist/src/operations/cstCodemod.js.map

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

package/dist/src/operations/deadSymbols.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AST Reachability & Zombie Export Eliminator
+ * v5.7.0 Enterprise AST Intelligence
+ */
+import { ParserRegistry } from "../parsers/registry.js";
+import type { ReadResult } from "./readCore.js";
+export interface DeadSymbolItem {
+    name: string;
+    kind: "function" | "class" | "interface" | "variable" | "export";
+    line: number;
+    column: number;
+    reason: "UNUSED_EXPORT" | "UNUSED_INTERNAL" | "UNREACHABLE_AFTER_RETURN";
+    snippet: string;
+}
+export interface DeadSymbolsReport {
+    filePath?: string;
+    totalSymbolsScanned: number;
+    deadSymbolsCount: number;
+    deadSymbols: DeadSymbolItem[];
+    summary: string;
+}
+export interface DeadSymbolsOptions {
+    filePath?: string;
+    code?: string;
+    content?: string;
+    projectRoot?: string;
+    registry?: ParserRegistry;
+}
+/**
+ * Extracts declared symbols and counts their identifier references
+ */
+export declare function detectDeadAstSymbols(params: DeadSymbolsOptions): Promise<ReadResult>;