mcp-code-context 3.9.2 → 7.0.1

package/dist/src/operations/astComplexity.js

@@ -0,0 +1,243 @@
+/**
+ * AST Complexity Matrix (McCabe Cyclomatic & Sonar Cognitive Complexity)
+ * v5.6.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";
+/** Node types that introduce branching in Cyclomatic Complexity */
+const CYCLOMATIC_BRANCH_TYPES = new Set([
+    "if_statement",
+    "ternary_expression",
+    "conditional_expression",
+    "for_statement",
+    "for_in_statement",
+    "for_of_statement",
+    "while_statement",
+    "do_statement",
+    "switch_case",
+    "case_clause",
+    "catch_clause",
+]);
+/**
+ * Calculates Cyclomatic Complexity of an AST subtree
+ */
+function calculateCyclomatic(node) {
+    let complexity = 1;
+    function traverse(n) {
+        if (CYCLOMATIC_BRANCH_TYPES.has(n.type)) {
+            complexity++;
+        }
+        else if (n.type === "binary_expression") {
+            const op = n.childForFieldName("operator")?.text;
+            if (op === "&&" || op === "||" || op === "??") {
+                complexity++;
+            }
+        }
+        for (let i = 0; i < n.namedChildCount; i++) {
+            const child = n.namedChild(i);
+            if (child &&
+                child.type !== "function_declaration" &&
+                child.type !== "function_definition" &&
+                child.type !== "method_definition" &&
+                child.type !== "arrow_function") {
+                traverse(child);
+            }
+        }
+    }
+    traverse(node);
+    return complexity;
+}
+/**
+ * Calculates Cognitive Complexity with nesting penalties
+ */
+function calculateCognitive(node) {
+    let score = 0;
+    let maxNesting = 0;
+    function traverse(n, nesting) {
+        if (nesting > maxNesting)
+            maxNesting = nesting;
+        let isNestingConstruct = false;
+        let increments = 0;
+        switch (n.type) {
+            case "if_statement":
+            case "switch_statement":
+            case "switch_case":
+            case "for_statement":
+            case "for_in_statement":
+            case "for_of_statement":
+            case "while_statement":
+            case "do_statement":
+            case "catch_clause":
+                increments = 1 + nesting;
+                isNestingConstruct = true;
+                break;
+            case "ternary_expression":
+            case "conditional_expression":
+                increments = 1 + nesting;
+                break;
+            case "binary_expression": {
+                const op = n.childForFieldName("operator")?.text;
+                if (op === "&&" || op === "||" || op === "??") {
+                    increments = 1;
+                }
+                break;
+            }
+        }
+        score += increments;
+        const nextNesting = isNestingConstruct ? nesting + 1 : nesting;
+        for (let i = 0; i < n.namedChildCount; i++) {
+            const child = n.namedChild(i);
+            if (child &&
+                child.type !== "function_declaration" &&
+                child.type !== "function_definition" &&
+                child.type !== "method_definition" &&
+                child.type !== "arrow_function") {
+                traverse(child, nextNesting);
+            }
+        }
+    }
+    traverse(node, 0);
+    return { score, maxNesting };
+}
+/**
+ * Finds all functions and methods within AST
+ */
+function extractFunctions(root) {
+    const list = [];
+    function walk(n) {
+        if (n.type === "function_declaration" ||
+            n.type === "function_definition" ||
+            n.type === "method_definition") {
+            const name = n.childForFieldName("name")?.text || "anonymous";
+            const kind = n.type === "method_definition" ? "method" : "function";
+            list.push({ node: n, name, kind });
+        }
+        else if (n.type === "arrow_function") {
+            let name = "anonymous_arrow";
+            if (n.parent?.type === "variable_declarator") {
+                name = n.parent.childForFieldName("name")?.text || name;
+            }
+            list.push({ node: n, name, kind: "arrow_function" });
+        }
+        for (let i = 0; i < n.namedChildCount; i++) {
+            const child = n.namedChild(i);
+            if (child)
+                walk(child);
+        }
+    }
+    walk(root);
+    return list;
+}
+/**
+ * Computes the AST complexity matrix for a file
+ */
+export async function getAstComplexityMatrix(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 Tree-sitter parser available for extension: ${ext}`,
+            };
+        }
+        tree = parser.parse(content);
+        const functions = extractFunctions(tree.rootNode);
+        const threshold = params.threshold || 0;
+        const metrics = [];
+        let totalCyclomatic = 0;
+        let totalCognitive = 0;
+        for (const fn of functions) {
+            const cyclomatic = calculateCyclomatic(fn.node);
+            const { score: cognitive, maxNesting } = calculateCognitive(fn.node);
+            totalCyclomatic += cyclomatic;
+            totalCognitive += cognitive;
+            let riskLevel = "LOW";
+            let recommendation = "Function is concise and straightforward.";
+            if (cognitive >= 25 || cyclomatic >= 20) {
+                riskLevel = "CRITICAL";
+                recommendation = "Decompose immediately. High probability of hidden bugs and testing resistance.";
+            }
+            else if (cognitive >= 15 || cyclomatic >= 10) {
+                riskLevel = "HIGH";
+                recommendation = "Extract nested control structures and early return guard clauses.";
+            }
+            else if (cognitive >= 8 || cyclomatic >= 6) {
+                riskLevel = "MODERATE";
+                recommendation = "Consider simplifying nested conditions or ternary operators.";
+            }
+            if (cognitive >= threshold) {
+                metrics.push({
+                    name: fn.name,
+                    kind: fn.kind,
+                    startLine: fn.node.startPosition.row + 1,
+                    endLine: fn.node.endPosition.row + 1,
+                    cyclomaticComplexity: cyclomatic,
+                    cognitiveComplexity: cognitive,
+                    maxNestingDepth: maxNesting,
+                    riskLevel,
+                    recommendation,
+                });
+            }
+        }
+        // Sort by cognitive complexity descending
+        metrics.sort((a, b) => b.cognitiveComplexity - a.cognitiveComplexity);
+        const count = functions.length;
+        const avgCyclomatic = count > 0 ? Number((totalCyclomatic / count).toFixed(2)) : 0;
+        const avgCognitive = count > 0 ? Number((totalCognitive / count).toFixed(2)) : 0;
+        const report = {
+            filePath: params.filePath,
+            totalFunctionsAnalyzed: count,
+            averageCyclomatic: avgCyclomatic,
+            averageCognitive: avgCognitive,
+            highestCognitiveFunction: metrics.length > 0 ? `${metrics[0].name} (Score: ${metrics[0].cognitiveComplexity})` : undefined,
+            metrics,
+            summary: `Analyzed ${count} functions. Avg Cyclomatic: ${avgCyclomatic}, Avg Cognitive: ${avgCognitive}. Identified ${metrics.filter(m => m.riskLevel === "HIGH" || m.riskLevel === "CRITICAL").length} high-risk functions.`,
+        };
+        return {
+            success: true,
+            content: JSON.stringify(report, null, 2),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `get_ast_complexity_matrix failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    finally {
+        if (tree) {
+            try {
+                tree.delete();
+            }
+            catch {
+                // ignore disposal errors
+            }
+        }
+    }
+}
+//# sourceMappingURL=astComplexity.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * Zero-Hallucination AST Mock Generator
+ * v5.6.0 Enterprise AST Intelligence
+ */
+import { ParserRegistry } from "../parsers/registry.js";
+import type { ReadResult } from "./readCore.js";
+export interface MockProperty {
+    name: string;
+    type: string;
+    optional: boolean;
+    defaultValue: string;
+}
+export interface AstMockReport {
+    symbolName: string;
+    kind: "interface" | "type" | "class";
+    propertiesCount: number;
+    properties: MockProperty[];
+    mockCode: string;
+    format: "factory" | "fixture" | "inline_json";
+    summary: string;
+}
+export interface AstMockOptions {
+    filePath?: string;
+    symbolName: string;
+    code?: string;
+    content?: string;
+    format?: "factory" | "fixture" | "inline_json";
+    projectRoot?: string;
+    registry?: ParserRegistry;
+}
+/**
+ * Generates typed mocks from AST definitions
+ */
+export declare function generateAstMocks(params: AstMockOptions): Promise<ReadResult>;

package/dist/src/operations/astMockGenerator.js

@@ -0,0 +1,203 @@
+/**
+ * Zero-Hallucination AST Mock Generator
+ * v5.6.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";
+/**
+ * Derives a deterministic mock value for a given TypeScript/JavaScript type
+ */
+function deriveDefaultValue(propName, rawType) {
+    const t = rawType.trim().toLowerCase();
+    if (t === "string")
+        return `"mock_${propName}"`;
+    if (t === "number")
+        return "100";
+    if (t === "boolean")
+        return "true";
+    if (t === "date")
+        return 'new Date("2026-01-01T00:00:00.000Z")';
+    if (t.endsWith("[]") || t.startsWith("array<"))
+        return "[]";
+    if (t.startsWith("record<") || t.startsWith("{"))
+        return "{}";
+    if (t.includes("null") && !t.includes("string") && !t.includes("number"))
+        return "null";
+    if (t.includes("|")) {
+        const firstOption = rawType.split("|")[0].trim();
+        if (firstOption.startsWith('"') || firstOption.startsWith("'")) {
+            return firstOption;
+        }
+        return deriveDefaultValue(propName, firstOption);
+    }
+    return `{} as ${rawType}`;
+}
+/**
+ * Extracts properties from an interface, type alias, or class node
+ */
+function extractProperties(targetNode) {
+    const props = [];
+    function findMembers(n) {
+        if (n.type === "property_signature" || n.type === "field_definition") {
+            const nameNode = n.childForFieldName("name");
+            const typeNode = n.childForFieldName("type");
+            if (nameNode) {
+                const name = nameNode.text;
+                const optional = n.text.includes("?") || Boolean(n.children.some(c => Boolean(c && c.type === "?")));
+                const rawType = typeNode?.text?.replace(/^:\s*/, "") || "any";
+                props.push({
+                    name,
+                    type: rawType,
+                    optional,
+                    defaultValue: deriveDefaultValue(name, rawType),
+                });
+            }
+        }
+        for (let i = 0; i < n.namedChildCount; i++) {
+            const child = n.namedChild(i);
+            if (child)
+                findMembers(child);
+        }
+    }
+    findMembers(targetNode);
+    return props;
+}
+/**
+ * Generates formatted mock code from extracted properties
+ */
+function formatMockCode(symbolName, props, format) {
+    const indent = "  ";
+    if (format === "inline_json") {
+        const obj = {};
+        for (const p of props) {
+            if (p.defaultValue.startsWith('"')) {
+                obj[p.name] = p.defaultValue.replace(/^"|"$/g, "");
+            }
+            else if (p.defaultValue === "true" || p.defaultValue === "false") {
+                obj[p.name] = p.defaultValue === "true";
+            }
+            else if (!isNaN(Number(p.defaultValue))) {
+                obj[p.name] = Number(p.defaultValue);
+            }
+            else if (p.defaultValue === "[]") {
+                obj[p.name] = [];
+            }
+            else {
+                obj[p.name] = p.defaultValue;
+            }
+        }
+        return JSON.stringify(obj, null, 2);
+    }
+    if (format === "fixture") {
+        const lines = props.map(p => `${indent}${p.name}: ${p.defaultValue},`);
+        return `export const mock${symbolName}: ${symbolName} = {\n${lines.join("\n")}\n};`;
+    }
+    // Factory format (default)
+    const lines = props.map(p => `${indent}${p.name}: ${p.defaultValue},`);
+    return `export const createMock${symbolName} = (overrides?: Partial<${symbolName}>): ${symbolName} => ({\n${lines.join("\n")}\n  ...overrides,\n});`;
+}
+/**
+ * Generates typed mocks from AST definitions
+ */
+export async function generateAstMocks(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);
+        // Locate symbol
+        let targetNode = null;
+        let targetKind = "interface";
+        function findSymbol(n) {
+            if (n.type === "interface_declaration" ||
+                n.type === "type_alias_declaration" ||
+                n.type === "class_declaration") {
+                const nameNode = n.childForFieldName("name");
+                if (nameNode?.text === params.symbolName) {
+                    targetNode = n;
+                    if (n.type === "class_declaration")
+                        targetKind = "class";
+                    else if (n.type === "type_alias_declaration")
+                        targetKind = "type";
+                    return;
+                }
+            }
+            for (let i = 0; i < n.namedChildCount; i++) {
+                if (!targetNode) {
+                    const child = n.namedChild(i);
+                    if (child)
+                        findSymbol(child);
+                }
+            }
+        }
+        findSymbol(tree.rootNode);
+        if (!targetNode) {
+            return {
+                success: false,
+                error: `Symbol '${params.symbolName}' not found in AST. Checked interface, type, and class declarations.`,
+            };
+        }
+        const props = extractProperties(targetNode);
+        const format = params.format || "factory";
+        const mockCode = formatMockCode(params.symbolName, props, format);
+        const report = {
+            symbolName: params.symbolName,
+            kind: targetKind,
+            propertiesCount: props.length,
+            properties: props,
+            mockCode,
+            format,
+            summary: `Generated ${format} mock for ${targetKind} '${params.symbolName}' with ${props.length} typed fields.`,
+        };
+        return {
+            success: true,
+            content: JSON.stringify(report, null, 2),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `generate_ast_mocks failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    finally {
+        if (tree) {
+            try {
+                tree.delete();
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+//# sourceMappingURL=astMockGenerator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"astMockGenerator.js","sourceRoot":"","sources":["../../../src/operations/astMockGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA8BtD;;GAEG;AACH,SAAS,kBAAkB,CAAC,QAAgB,EAAE,OAAe;IAC3D,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEvC,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,SAAS,QAAQ,GAAG,CAAC;IAChD,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACnC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,sCAAsC,CAAC;IAChE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5D,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAC;IACxF,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/D,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,OAAO,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,SAAS,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,UAAgB;IACzC,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,SAAS,WAAW,CAAC,CAAO;QAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,oBAAoB,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACrE,MAAM,QAAQ,GAAG,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAC7C,MAAM,QAAQ,GAAG,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;gBAC3B,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;gBACrG,MAAM,OAAO,GAAG,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI;oBACJ,IAAI,EAAE,OAAO;oBACb,QAAQ;oBACR,YAAY,EAAE,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC;iBAChD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,KAAK;gBAAE,WAAW,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,WAAW,CAAC,UAAU,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,UAAkB,EAAE,KAAqB,EAAE,MAA6C;IAC9G,MAAM,MAAM,GAAG,IAAI,CAAC;IAEpB,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAwB,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACrD,CAAC;iBAAM,IAAI,CAAC,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;gBACnE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,KAAK,MAAM,CAAC;YAC1C,CAAC;iBAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;gBAC1C,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;YACvC,CAAC;iBAAM,IAAI,CAAC,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;gBACnC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC;QACvE,OAAO,oBAAoB,UAAU,KAAK,UAAU,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IACtF,CAAC;IAED,2BAA2B;IAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC;IACvE,OAAO,0BAA0B,UAAU,2BAA2B,UAAU,OAAO,UAAU,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC;AACvJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAsB;IAC3D,IAAI,IAAI,GAAgB,IAAI,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,IAAI,cAAc,CAAC;QACrD,IAAI,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC;QAE5C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,MAAM,CAAC,QAAQ,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnD,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,wBAAwB,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE;iBAC3D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QAEnD,IAAI,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;YACvC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,QAAQ,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,sCAAsC,GAAG,EAAE;aACnD,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE7B,gBAAgB;QAChB,IAAI,UAAU,GAAgB,IAAI,CAAC;QACnC,IAAI,UAAU,GAA0B,WAAW,CAAC;QAEpD,SAAS,UAAU,CAAC,CAAO;YACzB,IACE,CAAC,CAAC,IAAI,KAAK,uBAAuB;gBAClC,CAAC,CAAC,IAAI,KAAK,wBAAwB;gBACnC,CAAC,CAAC,IAAI,KAAK,mBAAmB,EAC9B,CAAC;gBACD,MAAM,QAAQ,GAAG,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBAC7C,IAAI,QAAQ,EAAE,IAAI,KAAK,MAAM,CAAC,UAAU,EAAE,CAAC;oBACzC,UAAU,GAAG,CAAC,CAAC;oBACf,IAAI,CAAC,CAAC,IAAI,KAAK,mBAAmB;wBAAE,UAAU,GAAG,OAAO,CAAC;yBACpD,IAAI,CAAC,CAAC,IAAI,KAAK,wBAAwB;wBAAE,UAAU,GAAG,MAAM,CAAC;oBAClE,OAAO;gBACT,CAAC;YACH,CAAC;YACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;oBAC9B,IAAI,KAAK;wBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE1B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,WAAW,MAAM,CAAC,UAAU,sEAAsE;aAC1G,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC;QAC1C,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAElE,MAAM,MAAM,GAAkB;YAC5B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,IAAI,EAAE,UAAU;YAChB,eAAe,EAAE,KAAK,CAAC,MAAM;YAC7B,UAAU,EAAE,KAAK;YACjB,QAAQ;YACR,MAAM;YACN,OAAO,EAAE,aAAa,MAAM,aAAa,UAAU,KAAK,MAAM,CAAC,UAAU,UAAU,KAAK,CAAC,MAAM,gBAAgB;SAChH,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;SACzC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SAC9F,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Tree-sitter Native S-Expression Query DSL Engine (v5.5.0)
+ *
+ * Executes native Scheme / S-Expression AST queries against source code using
+ * web-tree-sitter compiled to WebAssembly. Enables complex syntactic pattern matching
+ * (e.g. empty catch blocks, excessive parameters, nested ternaries, unhandled promises)
+ * with zero regex fragility and sub-millisecond execution.
+ */
+import { ParserRegistry } from "../parsers/registry.js";
+import type { ReadResult } from "./readCore.js";
+export interface AstQueryCapture {
+    captureName: string;
+    nodeType: string;
+    text: string;
+    startLine: number;
+    endLine: number;
+    startColumn: number;
+    endColumn: number;
+    snippet: string;
+}
+export type AstQueryTemplate = "empty-catch" | "excessive-params" | "nested-ternary" | "eval-call" | "todo-comment" | "console-log" | "print-call" | string;
+export interface AstQueryReport {
+    filePath?: string;
+    language: string;
+    queryPattern: string;
+    matchesCount: number;
+    captures: AstQueryCapture[];
+}
+/**
+ * Built-in query templates for common AST anti-patterns
+ */
+export declare const PREDEFINED_QUERY_TEMPLATES: Record<string, Record<string, string>>;
+export interface AstQueryOptions {
+    filePath?: string;
+    query?: string;
+    template?: AstQueryTemplate;
+    code?: string;
+    content?: string;
+    limit?: number;
+    maxMatches?: number;
+    projectRoot?: string;
+    registry?: ParserRegistry;
+}
+/**
+ * Executes a Tree-sitter S-Expression query against a file
+ */
+export declare function queryCodeAst(params: AstQueryOptions): Promise<ReadResult>;