@mcp-graph-workflow/mcp-graph 5.28.1 → 5.29.1

package/dist/core/code/treesitter/treesitter-analyzer.js

@@ -0,0 +1,414 @@
+/**
+ * TreeSitterAnalyzer — Multi-language code analyzer using web-tree-sitter.
+ * Implements CodeAnalyzer interface. Extracts symbols, relations,
+ * docstrings, visibility, and source snippets from any supported language.
+ *
+ * Uses LANGUAGE_REFERENCES for deterministic, rule-based extraction.
+ * AI is never used here — pure AST parsing.
+ */
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { logger } from "../../utils/logger.js";
+import { TreeSitterManager, resetTreeSitterLoader } from "./treesitter-manager.js";
+import { LANGUAGE_REFERENCES, SUPPORTED_LANGUAGES } from "./reference-content.js";
+export { resetTreeSitterLoader };
+// ── Extension → language mapping ─────────────────────────
+function buildExtensionMap() {
+    const map = new Map();
+    for (const ref of Object.values(LANGUAGE_REFERENCES)) {
+        for (const ext of ref.extensions) {
+            map.set(ext, ref.languageId);
+        }
+    }
+    return map;
+}
+const EXTENSION_MAP = buildExtensionMap();
+// ── Symbol extraction helpers ────────────────────────────
+function getNodeName(node) {
+    // Try common field names for the symbol name
+    const nameNode = node.childForFieldName?.("name");
+    if (nameNode)
+        return nameNode.text;
+    return null;
+}
+function getSourceSnippet(node, maxLines = 20) {
+    const text = node.text;
+    const lines = text.split("\n");
+    return lines.slice(0, maxLines).join("\n");
+}
+function getPrecedingComment(node, languageId) {
+    const ref = LANGUAGE_REFERENCES[languageId];
+    if (!ref)
+        return null;
+    let sibling = node.previousNamedSibling;
+    const commentLines = [];
+    while (sibling) {
+        const type = sibling.type;
+        if (type === "comment" || type === "line_comment" || type === "block_comment") {
+            const text = sibling.text;
+            if (ref.docstringPattern.commentRegex.test(text)) {
+                commentLines.unshift(text);
+                sibling = sibling.previousNamedSibling;
+                continue;
+            }
+        }
+        break;
+    }
+    if (commentLines.length === 0)
+        return null;
+    // Clean comment markers
+    return commentLines
+        .map((line) => line.replace(/^\/\/\/?\s?|^\/\*\*?\s?|\*\/\s?$|^\s*\*\s?|^#\s?|^---?\s?/gm, "").trim())
+        .filter(Boolean)
+        .join("\n");
+}
+function getPythonDocstring(node) {
+    // Python docstrings: first expression_statement > string in body block
+    const body = node.childForFieldName?.("body");
+    if (!body)
+        return null;
+    const firstChild = body.firstNamedChild;
+    if (!firstChild)
+        return null;
+    if (firstChild.type === "expression_statement") {
+        const stringNode = firstChild.firstNamedChild;
+        if (stringNode && stringNode.type === "string") {
+            const text = stringNode.text;
+            // Strip triple quotes
+            return text.replace(/^["']{3}\s*|["']{3}\s*$/g, "").trim();
+        }
+    }
+    return null;
+}
+function detectVisibility(name, node, languageId) {
+    const ref = LANGUAGE_REFERENCES[languageId];
+    if (!ref)
+        return "public";
+    switch (ref.visibilityRules.exportDetection) {
+        case "underscore_prefix":
+            if (name.startsWith("__") && !name.endsWith("__"))
+                return "private";
+            if (name.startsWith("_"))
+                return "private";
+            return "public";
+        case "uppercase_first":
+            return /^[A-Z]/.test(name) ? "public" : "package";
+        case "pub_keyword": {
+            // Check for visibility_modifier child
+            const visMod = node.children?.find((c) => c.type === "visibility_modifier");
+            if (visMod) {
+                const text = visMod.text;
+                if (text === "pub")
+                    return "public";
+                if (text.includes("crate"))
+                    return "internal";
+                if (text.includes("super"))
+                    return "protected";
+            }
+            return "private";
+        }
+        case "modifier_keyword": {
+            // Check for modifiers node or direct visibility_modifier
+            const mods = node.children?.find((c) => c.type === "modifiers" || c.type === "modifier" || c.type === "visibility_modifier");
+            if (mods) {
+                const text = mods.text;
+                if (text.includes("public"))
+                    return "public";
+                if (text.includes("private"))
+                    return "private";
+                if (text.includes("protected"))
+                    return "protected";
+                if (text.includes("internal"))
+                    return "internal";
+            }
+            return ref.visibilityRules.defaultVisibility;
+        }
+        case "access_specifier":
+        case "static_keyword":
+        case "return_table":
+        case "visibility_section":
+            return ref.visibilityRules.defaultVisibility;
+        default:
+            return "public";
+    }
+}
+function detectExported(name, languageId, visibility) {
+    const ref = LANGUAGE_REFERENCES[languageId];
+    if (!ref)
+        return true;
+    switch (ref.visibilityRules.exportDetection) {
+        case "uppercase_first":
+            return /^[A-Z]/.test(name);
+        case "underscore_prefix":
+            return !name.startsWith("_");
+        case "pub_keyword":
+            return visibility === "public";
+        case "modifier_keyword":
+            return visibility === "public";
+        default:
+            return true;
+    }
+}
+function extractSymbolsFromNode(node, ctx) {
+    const type = node.type;
+    const ref = LANGUAGE_REFERENCES[ctx.languageId];
+    // ── Symbol extraction by node type ─────────────────
+    let symbolKind = null;
+    // Map node types to symbol kinds using reference
+    if (ref) {
+        for (const [kind, nodeType] of Object.entries(ref.symbolNodeTypes)) {
+            if (type === nodeType) {
+                symbolKind = kind;
+                break;
+            }
+        }
+    }
+    // Special handling for type_spec in Go (wraps struct_type, interface_type)
+    if (ctx.languageId === "go" && type === "type_spec") {
+        const typeChild = node.childForFieldName?.("type");
+        if (typeChild) {
+            if (typeChild.type === "struct_type")
+                symbolKind = "struct";
+            else if (typeChild.type === "interface_type")
+                symbolKind = "interface";
+            else
+                symbolKind = "type_alias";
+        }
+    }
+    // Go: type_declaration wraps type_spec
+    if (ctx.languageId === "go" && type === "type_declaration") {
+        for (const child of node.namedChildren ?? []) {
+            extractSymbolsFromNode(child, ctx);
+        }
+        return;
+    }
+    // Python decorated_definition — extract the inner definition
+    if (ctx.languageId === "python" && type === "decorated_definition") {
+        const defNode = node.childForFieldName?.("definition");
+        if (defNode) {
+            extractSymbolsFromNode(defNode, ctx);
+        }
+        return;
+    }
+    if (symbolKind) {
+        const name = getNodeName(node);
+        if (name) {
+            const visibility = detectVisibility(name, node, ctx.languageId);
+            const exported = detectExported(name, ctx.languageId, visibility);
+            // Docstring extraction
+            let docstring = null;
+            if (ctx.languageId === "python") {
+                docstring = getPythonDocstring(node);
+            }
+            if (!docstring) {
+                docstring = getPrecedingComment(node, ctx.languageId);
+            }
+            const startLine = (node.startPosition?.row ?? 0) + 1;
+            const endLine = (node.endPosition?.row ?? 0) + 1;
+            // Determine if it's a method (function inside class)
+            let resolvedKind = symbolKind;
+            if (symbolKind === "function" && ctx.parentName) {
+                resolvedKind = "method";
+            }
+            ctx.symbols.push({
+                name,
+                kind: resolvedKind,
+                file: ctx.file,
+                startLine,
+                endLine,
+                exported,
+                language: ctx.languageId,
+                docstring: docstring ?? undefined,
+                sourceSnippet: getSourceSnippet(node),
+                visibility,
+            });
+            // Recurse into class/struct bodies for methods
+            if (["class", "struct"].includes(symbolKind)) {
+                const body = node.childForFieldName?.("body");
+                if (body) {
+                    for (const child of body.namedChildren ?? []) {
+                        extractSymbolsFromNode(child, { ...ctx, parentName: name });
+                    }
+                }
+                return;
+            }
+            // Recurse into function body for call detection
+            const body = node.childForFieldName?.("body");
+            if (body) {
+                extractRelationsFromSubtree(body, ctx, name);
+            }
+            return;
+        }
+    }
+    // ── Relation extraction ────────────────────────────
+    // Imports
+    if (ref && ref.importNodeTypes.includes(type)) {
+        const importTarget = extractImportTarget(node, ctx.languageId);
+        if (importTarget) {
+            ctx.relations.push({
+                fromSymbol: ctx.file,
+                toSymbol: importTarget,
+                type: "imports",
+                file: ctx.file,
+                line: (node.startPosition?.row ?? 0) + 1,
+            });
+        }
+    }
+    // Calls (function/method invocations)
+    if (type === "call" || type === "call_expression" || type === "method_invocation" || type === "function_call") {
+        const callTarget = extractCallTarget(node);
+        if (callTarget) {
+            ctx.relations.push({
+                fromSymbol: ctx.parentName ?? ctx.file,
+                toSymbol: callTarget,
+                type: "calls",
+                file: ctx.file,
+                line: (node.startPosition?.row ?? 0) + 1,
+            });
+        }
+    }
+    // ── Recurse into children ──────────────────────────
+    for (const child of node.namedChildren ?? []) {
+        extractSymbolsFromNode(child, ctx);
+    }
+}
+/** Recursively extract only relations (calls) from a subtree — used for function bodies. */
+function extractRelationsFromSubtree(node, ctx, scopeName) {
+    const type = node.type;
+    if (type === "call" || type === "call_expression" || type === "method_invocation" || type === "function_call") {
+        const callTarget = extractCallTarget(node);
+        if (callTarget) {
+            ctx.relations.push({
+                fromSymbol: scopeName,
+                toSymbol: callTarget,
+                type: "calls",
+                file: ctx.file,
+                line: (node.startPosition?.row ?? 0) + 1,
+            });
+        }
+    }
+    for (const child of node.namedChildren ?? []) {
+        extractRelationsFromSubtree(child, ctx, scopeName);
+    }
+}
+function extractImportTarget(node, languageId) {
+    if (languageId === "python") {
+        // import os → module_name field or name
+        const moduleName = node.childForFieldName?.("module_name");
+        if (moduleName)
+            return moduleName.text;
+        const nameNode = node.childForFieldName?.("name");
+        if (nameNode)
+            return nameNode.text;
+    }
+    if (languageId === "go") {
+        // import_spec → path field
+        for (const child of node.namedChildren ?? []) {
+            if (child.type === "import_spec") {
+                const pathNode = child.childForFieldName?.("path");
+                if (pathNode)
+                    return pathNode.text.replace(/"/g, "");
+            }
+        }
+    }
+    if (languageId === "rust") {
+        const arg = node.childForFieldName?.("argument");
+        if (arg)
+            return arg.text;
+    }
+    if (languageId === "java" || languageId === "kotlin") {
+        const nameNode = node.childForFieldName?.("name") ?? node.namedChildren?.[0];
+        if (nameNode)
+            return nameNode.text;
+    }
+    // Generic fallback: first named child text
+    const first = node.firstNamedChild;
+    if (first)
+        return first.text;
+    return null;
+}
+function extractCallTarget(node) {
+    const funcNode = node.childForFieldName?.("function");
+    if (funcNode) {
+        // Simple identifier: foo()
+        if (funcNode.type === "identifier")
+            return funcNode.text;
+        // Attribute access: obj.method() — extract method name
+        const attr = funcNode.childForFieldName?.("attribute");
+        if (attr)
+            return attr.text;
+        // Property: obj.method → field
+        const field = funcNode.childForFieldName?.("field");
+        if (field)
+            return field.text;
+    }
+    // Java: method_invocation has "name" field
+    const nameNode = node.childForFieldName?.("name");
+    if (nameNode && nameNode.type === "identifier")
+        return nameNode.text;
+    return null;
+}
+// ── TreeSitterAnalyzer class ─────────────────────────────
+export class TreeSitterAnalyzer {
+    manager;
+    languages;
+    extensions;
+    constructor() {
+        this.manager = new TreeSitterManager();
+        this.languages = [...SUPPORTED_LANGUAGES];
+        this.extensions = [...new Set(Object.values(LANGUAGE_REFERENCES).flatMap((r) => r.extensions))];
+    }
+    /** Initialize the tree-sitter WASM runtime. Must be called before analyzeFile. */
+    async initialize() {
+        await this.manager.initialize();
+    }
+    async analyzeFile(filePath, basePath) {
+        const relativePath = path.relative(basePath, filePath);
+        const ext = path.extname(filePath);
+        const languageId = EXTENSION_MAP.get(ext);
+        if (!languageId) {
+            return { file: relativePath, symbols: [], relations: [] };
+        }
+        const parser = await this.manager.getParser(languageId);
+        if (!parser) {
+            logger.debug("treesitter-analyzer:no-parser", { languageId, file: relativePath });
+            return { file: relativePath, symbols: [], relations: [] };
+        }
+        let content;
+        try {
+            content = readFileSync(filePath, "utf-8");
+        }
+        catch {
+            logger.debug("treesitter-analyzer:read-error", { file: relativePath });
+            return { file: relativePath, symbols: [], relations: [] };
+        }
+        const tree = parser.parse(content);
+        if (!tree) {
+            return { file: relativePath, symbols: [], relations: [] };
+        }
+        const ctx = {
+            languageId,
+            file: relativePath,
+            symbols: [],
+            relations: [],
+            content,
+            parentName: null,
+        };
+        // Walk the AST root
+        for (const child of tree.rootNode.namedChildren ?? []) {
+            extractSymbolsFromNode(child, ctx);
+        }
+        logger.debug("treesitter-analyzer:analyzed", {
+            file: relativePath,
+            languageId,
+            symbols: String(ctx.symbols.length),
+            relations: String(ctx.relations.length),
+        });
+        return {
+            file: relativePath,
+            symbols: ctx.symbols,
+            relations: ctx.relations,
+        };
+    }
+}
+//# sourceMappingURL=treesitter-analyzer.js.map

package/dist/core/code/treesitter/treesitter-analyzer.js.map

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

package/dist/core/code/treesitter/treesitter-manager.d.ts

@@ -0,0 +1,32 @@
+/**
+ * TreeSitterManager — Lazy-loads web-tree-sitter WASM runtime and
+ * caches Parser instances per language. Grammars are loaded on-demand
+ * from npm packages (tree-sitter-{lang}).
+ *
+ * Pattern: same lazy-loading approach as ts-analyzer.ts loadTypeScript().
+ * Graceful degradation: missing grammar → returns null, never throws.
+ */
+type ParserInstance = any;
+/** Check if web-tree-sitter is available at runtime. */
+export declare function isTreeSitterAvailable(): Promise<boolean>;
+/** Reset loader state (for testing). */
+export declare function resetTreeSitterLoader(): void;
+export declare class TreeSitterManager {
+    private parsers;
+    private failedLanguages;
+    /** Initialize the WASM runtime. Safe to call multiple times. */
+    initialize(): Promise<void>;
+    /**
+     * Get a parser for a specific language. Returns null if:
+     * - web-tree-sitter is not available
+     * - Grammar WASM not installed for this language
+     * - Language is not in the registry
+     */
+    getParser(languageId: string): Promise<ParserInstance | null>;
+    /** Check if a language has a grammar registered. */
+    isLanguageSupported(languageId: string): boolean;
+    /** Get list of all registered language IDs. */
+    getSupportedLanguages(): string[];
+}
+export {};
+//# sourceMappingURL=treesitter-manager.d.ts.map

package/dist/core/code/treesitter/treesitter-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treesitter-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/code/treesitter/treesitter-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,KAAK,cAAc,GAAG,GAAG,CAAC;AAsD1B,wDAAwD;AACxD,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAG9D;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AA4BD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,eAAe,CAA0B;IAEjD,gEAAgE;IAC1D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;;;OAKG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAqDnE,oDAAoD;IACpD,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhD,+CAA+C;IAC/C,qBAAqB,IAAI,MAAM,EAAE;CAGlC"}

package/dist/core/code/treesitter/treesitter-manager.js

@@ -0,0 +1,155 @@
+/**
+ * TreeSitterManager — Lazy-loads web-tree-sitter WASM runtime and
+ * caches Parser instances per language. Grammars are loaded on-demand
+ * from npm packages (tree-sitter-{lang}).
+ *
+ * Pattern: same lazy-loading approach as ts-analyzer.ts loadTypeScript().
+ * Graceful degradation: missing grammar → returns null, never throws.
+ */
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { logger } from "../../utils/logger.js";
+// ── Grammar registry ─────────────────────────────────────
+/** Maps languageId → npm package name + wasm file name */
+const GRAMMAR_REGISTRY = {
+    python: { pkg: "tree-sitter-python", wasm: "tree-sitter-python.wasm" },
+    go: { pkg: "tree-sitter-go", wasm: "tree-sitter-go.wasm" },
+    rust: { pkg: "tree-sitter-rust", wasm: "tree-sitter-rust.wasm" },
+    java: { pkg: "tree-sitter-java", wasm: "tree-sitter-java.wasm" },
+    c: { pkg: "tree-sitter-c", wasm: "tree-sitter-c.wasm" },
+    cpp: { pkg: "tree-sitter-cpp", wasm: "tree-sitter-cpp.wasm" },
+    ruby: { pkg: "tree-sitter-ruby", wasm: "tree-sitter-ruby.wasm" },
+    php: { pkg: "tree-sitter-php", wasm: "tree-sitter-php.wasm" },
+    csharp: { pkg: "tree-sitter-c-sharp", wasm: "tree-sitter-c_sharp.wasm" },
+    lua: { pkg: "tree-sitter-lua", wasm: "tree-sitter-lua.wasm" },
+};
+let tsModule = null;
+let initAttempted = false;
+async function loadWebTreeSitter() {
+    if (tsModule)
+        return tsModule;
+    if (initAttempted)
+        return null;
+    initAttempted = true;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = await import("web-tree-sitter");
+        // web-tree-sitter exports { Parser, Language, ... } — init() is on Parser
+        const ParserClass = mod.Parser ?? mod.default;
+        const LanguageClass = mod.Language;
+        await ParserClass.init();
+        tsModule = { ParserClass, LanguageClass };
+        logger.info("treesitter-manager:init", { message: "web-tree-sitter WASM runtime loaded" });
+        return tsModule;
+    }
+    catch (err) {
+        logger.warn("treesitter-manager:unavailable", {
+            message: "web-tree-sitter not found — multi-language code analysis disabled",
+            error: String(err),
+        });
+        return null;
+    }
+}
+/** Check if web-tree-sitter is available at runtime. */
+export async function isTreeSitterAvailable() {
+    const result = await loadWebTreeSitter();
+    return result !== null;
+}
+/** Reset loader state (for testing). */
+export function resetTreeSitterLoader() {
+    tsModule = null;
+    initAttempted = false;
+}
+// ── Resolve grammar WASM path ────────────────────────────
+function resolveGrammarPath(languageId) {
+    const entry = GRAMMAR_REGISTRY[languageId];
+    if (!entry)
+        return null;
+    try {
+        // Resolve the package path via require.resolve
+        const pkgMain = require.resolve(`${entry.pkg}/package.json`);
+        const pkgDir = pkgMain.replace(/[/\\]package\.json$/, "");
+        const wasmPath = join(pkgDir, entry.wasm);
+        if (existsSync(wasmPath)) {
+            return wasmPath;
+        }
+        logger.debug("treesitter-manager:wasm-not-found", { languageId, wasmPath });
+        return null;
+    }
+    catch {
+        logger.debug("treesitter-manager:pkg-not-found", { languageId, pkg: entry.pkg });
+        return null;
+    }
+}
+// ── TreeSitterManager class ──────────────────────────────
+export class TreeSitterManager {
+    parsers = new Map();
+    failedLanguages = new Set();
+    /** Initialize the WASM runtime. Safe to call multiple times. */
+    async initialize() {
+        await loadWebTreeSitter();
+    }
+    /**
+     * Get a parser for a specific language. Returns null if:
+     * - web-tree-sitter is not available
+     * - Grammar WASM not installed for this language
+     * - Language is not in the registry
+     */
+    async getParser(languageId) {
+        // Check cache
+        const cached = this.parsers.get(languageId);
+        if (cached)
+            return cached;
+        // Already failed for this language — don't retry
+        if (this.failedLanguages.has(languageId))
+            return null;
+        // Not in registry
+        if (!GRAMMAR_REGISTRY[languageId]) {
+            this.failedLanguages.add(languageId);
+            return null;
+        }
+        // Load WASM runtime
+        const wts = await loadWebTreeSitter();
+        if (!wts)
+            return null;
+        // Resolve grammar path
+        const wasmPath = resolveGrammarPath(languageId);
+        if (!wasmPath) {
+            this.failedLanguages.add(languageId);
+            logger.info("treesitter-manager:grammar-unavailable", {
+                languageId,
+                message: `Grammar for ${languageId} not installed — skipping`,
+            });
+            return null;
+        }
+        try {
+            const language = await wts.LanguageClass.load(wasmPath);
+            const parser = new wts.ParserClass();
+            parser.setLanguage(language);
+            // Cache the parser
+            this.parsers.set(languageId, parser);
+            logger.info("treesitter-manager:parser-loaded", {
+                languageId,
+                wasmPath,
+            });
+            return parser;
+        }
+        catch (err) {
+            this.failedLanguages.add(languageId);
+            logger.warn("treesitter-manager:parser-load-failed", {
+                languageId,
+                error: String(err),
+            });
+            return null;
+        }
+    }
+    /** Check if a language has a grammar registered. */
+    isLanguageSupported(languageId) {
+        return languageId in GRAMMAR_REGISTRY;
+    }
+    /** Get list of all registered language IDs. */
+    getSupportedLanguages() {
+        return Object.keys(GRAMMAR_REGISTRY);
+    }
+}
+//# sourceMappingURL=treesitter-manager.js.map

package/dist/core/code/treesitter/treesitter-manager.js.map

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

package/dist/core/planner/lifecycle-phase.js

@@ -412,7 +412,7 @@ export const PHASE_PREREQUISITES = {
             triggerCondition: (args) => args.status === "done",
             requiredTools: [
                 { tool: "context", scope: "node" },
-                { tool: "rag_context", scope: "node" },
+                { tool: "rag_context", scope: "project" },
                 { tool: "analyze", args: "implement_done", scope: "node" },
             ],
             description: "Antes de done: chamar `context` + `rag_context` + `analyze(implement_done)`",