mcp-code-context 3.9.2 → 7.0.0

package/dist/src/operations/apiRoutes.js

@@ -0,0 +1,170 @@
+/**
+ * Zero-Runtime REST / FastAPI / Express Route Extractor
+ * v7.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";
+/**
+ * Extracts route parameters like :id (Express) or {id} (FastAPI/OpenAPI)
+ */
+function extractPathParams(routePath) {
+    const params = [];
+    // Express style :param
+    const expressMatches = routePath.match(/:([a-zA-Z0-9_]+)/g);
+    if (expressMatches) {
+        for (const m of expressMatches)
+            params.push(m.slice(1));
+    }
+    // OpenAPI / FastAPI style {param}
+    const fastApiMatches = routePath.match(/{([a-zA-Z0-9_]+)}/g);
+    if (fastApiMatches) {
+        for (const m of fastApiMatches)
+            params.push(m.slice(1, -1));
+    }
+    return params;
+}
+/**
+ * Normalizes HTTP method string
+ */
+function normalizeMethod(raw) {
+    const m = raw.toUpperCase();
+    if (m === "GET")
+        return "GET";
+    if (m === "POST")
+        return "POST";
+    if (m === "PUT")
+        return "PUT";
+    if (m === "DELETE")
+        return "DELETE";
+    if (m === "PATCH")
+        return "PATCH";
+    if (m === "ALL" || m === "USE")
+        return "ALL";
+    return "CUSTOM";
+}
+/**
+ * Extracts API routes from AST
+ */
+export async function extractApiRouteMatrix(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);
+        const routes = [];
+        function walkAST(n) {
+            // 1. Python FastAPI / Flask decorators: @app.get("/path"), @router.post("/path")
+            if (n.type === "decorated_definition") {
+                for (let i = 0; i < n.namedChildCount; i++) {
+                    const child = n.namedChild(i);
+                    if (child && child.type === "decorator") {
+                        const decText = child.text;
+                        const match = decText.match(/@(app|router|api|blueprint)\.(get|post|put|delete|patch)\((["'])(.*?)\3/i);
+                        if (match) {
+                            const method = normalizeMethod(match[2]);
+                            const routePath = match[4];
+                            const fnDef = n.childForFieldName("definition") || n.namedChild(n.namedChildCount - 1);
+                            const handlerName = fnDef?.childForFieldName("name")?.text || "anonymous_handler";
+                            routes.push({
+                                method,
+                                path: routePath,
+                                handlerName,
+                                line: child.startPosition.row + 1,
+                                framework: "FastAPI",
+                                pathParams: extractPathParams(routePath),
+                            });
+                        }
+                    }
+                }
+            }
+            // 2. TypeScript / Express call_expression: app.get("/path", ...), router.post("/path", ...)
+            if (n.type === "call_expression") {
+                const fnExpr = n.childForFieldName("function");
+                if (fnExpr && fnExpr.type === "member_expression") {
+                    const obj = fnExpr.childForFieldName("object")?.text || "";
+                    const prop = fnExpr.childForFieldName("property")?.text?.toLowerCase() || "";
+                    if ((obj === "app" || obj === "router" || obj.endsWith("Router") || obj.endsWith("App")) &&
+                        ["get", "post", "put", "delete", "patch", "all", "use"].includes(prop)) {
+                        const args = n.childForFieldName("arguments");
+                        const firstArg = args?.namedChild(0);
+                        if (firstArg && (firstArg.type === "string" || firstArg.type === "string_literal" || firstArg.type === "template_string")) {
+                            const routePath = firstArg.text.replace(/^["'`]|["'`]$/g, "");
+                            const handlerNode = args?.namedChild(1);
+                            const handlerName = handlerNode?.text?.split("(")[0]?.trim() || "anonymous";
+                            routes.push({
+                                method: normalizeMethod(prop),
+                                path: routePath,
+                                handlerName,
+                                line: n.startPosition.row + 1,
+                                framework: "Express",
+                                pathParams: extractPathParams(routePath),
+                            });
+                        }
+                    }
+                }
+            }
+            for (let i = 0; i < n.namedChildCount; i++) {
+                const child = n.namedChild(i);
+                if (child)
+                    walkAST(child);
+            }
+        }
+        walkAST(tree.rootNode);
+        const report = {
+            filePath: params.filePath,
+            totalRoutesFound: routes.length,
+            routes,
+            summary: `Discovered ${routes.length} HTTP routes across AST without runtime execution.`,
+        };
+        return {
+            success: true,
+            content: JSON.stringify(report, null, 2),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `extract_api_route_matrix failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    finally {
+        if (tree) {
+            try {
+                tree.delete();
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+//# sourceMappingURL=apiRoutes.js.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * AST Architectural Boundary Guardrails Engine (v4.6.0)
+ *
+ * Enforces clean architecture / hexagonal boundary rules by analyzing import statements
+ * across layers (e.g. domain entities cannot import infrastructure/database drivers;
+ * React UI components cannot import raw Prisma/ORM models; use cases cannot import Express/HTTP controllers).
+ */
+import type { ReadResult } from "./readCore.js";
+export interface ArchitectureRule {
+    layer: string;
+    pattern: string;
+    disallow: string[];
+    description?: string;
+    suggestion?: string;
+}
+export interface ArchitectureViolation {
+    filePath: string;
+    line: number;
+    layer: string;
+    rulePattern: string;
+    disallowedSource: string;
+    matchedRule: string;
+    message: string;
+    suggestion: string;
+}
+export interface ArchitectureComplianceReport {
+    compliant: boolean;
+    violationsCount: number;
+    filesChecked: number;
+    violations: ArchitectureViolation[];
+    rulesApplied: ArchitectureRule[];
+}
+/**
+ * Standard Clean / Hexagonal Architecture Defaults
+ */
+export declare const DEFAULT_ARCHITECTURE_RULES: ArchitectureRule[];
+/**
+ * Enforces architecture rules across a single file or project directory
+ */
+export declare function enforceArchitectureRules(params: {
+    filePath?: string;
+    projectRoot: string;
+    rules?: ArchitectureRule[];
+    content?: string;
+}): Promise<ReadResult>;

package/dist/src/operations/architectureLinter.js

@@ -0,0 +1,223 @@
+/**
+ * AST Architectural Boundary Guardrails Engine (v4.6.0)
+ *
+ * Enforces clean architecture / hexagonal boundary rules by analyzing import statements
+ * across layers (e.g. domain entities cannot import infrastructure/database drivers;
+ * React UI components cannot import raw Prisma/ORM models; use cases cannot import Express/HTTP controllers).
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { existsSync } from "node:fs";
+import { extractImportStatements } from "./importIntegrity.js";
+/**
+ * Standard Clean / Hexagonal Architecture Defaults
+ */
+export const DEFAULT_ARCHITECTURE_RULES = [
+    {
+        layer: "domain",
+        pattern: "**/domain/**",
+        disallow: [
+            "**/infra/**",
+            "**/infrastructure/**",
+            "**/adapters/**",
+            "**/controllers/**",
+            "**/api/**",
+            "express",
+            "fastify",
+            "@nestjs/common",
+            "react",
+            "next",
+            "next/**",
+            "@prisma/client",
+            "typeorm",
+            "mongoose",
+            "knex",
+            "pg",
+            "mysql2"
+        ],
+        description: "Domain layer must remain pure business logic and cannot import infrastructure, database drivers, web frameworks, or UI.",
+        suggestion: "Define an interface/port in the domain layer and implement it in an infrastructure adapter."
+    },
+    {
+        layer: "ui",
+        pattern: "**/components/**",
+        disallow: [
+            "**/db/**",
+            "**/database/**",
+            "**/models/**",
+            "@prisma/client",
+            "typeorm",
+            "mongoose",
+            "knex",
+            "pg",
+            "mysql2",
+            "sqlite3"
+        ],
+        description: "UI presentation layer cannot directly import database drivers, queries, or raw ORM models.",
+        suggestion: "Fetch data via Server Actions, API routes, or pass DTOs via component props."
+    },
+    {
+        layer: "use_cases",
+        pattern: "**/use-cases/**",
+        disallow: [
+            "**/controllers/**",
+            "**/views/**",
+            "express",
+            "fastify",
+            "react"
+        ],
+        description: "Application use cases cannot depend on transport controllers, HTTP request objects, or UI views.",
+        suggestion: "Accept pure input DTOs and return result objects without HTTP-specific concepts."
+    }
+];
+/**
+ * Converts a glob-like pattern into a regular expression
+ */
+function globToRegex(glob) {
+    const normalized = glob.replace(/\\/g, "/");
+    let reStr = normalized
+        .replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, "\\$&")
+        .replace(/\\\*\\\*/g, ".*")
+        .replace(/(?<!\.)\\\*/g, "[^/]*");
+    return new RegExp(`^${reStr}$`, "i");
+}
+/**
+ * Matches a relative path or package name against a pattern
+ */
+function matchesPattern(target, pattern) {
+    const normTarget = target.replace(/\\/g, "/").replace(/^\.\//, "");
+    const normPattern = pattern.replace(/\\/g, "/");
+    // Direct exact match
+    if (normTarget === normPattern)
+        return true;
+    // Package prefix match (e.g. "next/**" matches "next/server")
+    if (normPattern.endsWith("/**")) {
+        const prefix = normPattern.slice(0, -3);
+        if (normTarget === prefix || normTarget.startsWith(prefix + "/"))
+            return true;
+    }
+    // Regex glob match
+    try {
+        const rx = globToRegex(normPattern);
+        if (rx.test(normTarget))
+            return true;
+        // Check with leading wildcards if pattern didn't specify
+        if (!normPattern.startsWith("**/") && !normPattern.startsWith("/")) {
+            const wildcardRx = globToRegex(`**/${normPattern}`);
+            if (wildcardRx.test(normTarget))
+                return true;
+        }
+    }
+    catch {
+        // Ignore regex compilation issues
+    }
+    return false;
+}
+/**
+ * Loads architecture configuration from disk if available
+ */
+async function loadArchitectureConfig(projectRoot) {
+    const configNames = [
+        ".architecturerc.json",
+        ".architecturerc",
+        "architecture.json",
+        ".architecture.json"
+    ];
+    for (const name of configNames) {
+        const fullPath = path.join(projectRoot, name);
+        if (existsSync(fullPath)) {
+            try {
+                const raw = await fs.readFile(fullPath, "utf-8");
+                const parsed = JSON.parse(raw);
+                if (Array.isArray(parsed)) {
+                    return parsed;
+                }
+                if (parsed.rules && Array.isArray(parsed.rules)) {
+                    return parsed.rules;
+                }
+            }
+            catch {
+                // Fall back to next or default
+            }
+        }
+    }
+    return DEFAULT_ARCHITECTURE_RULES;
+}
+/**
+ * Enforces architecture rules across a single file or project directory
+ */
+export async function enforceArchitectureRules(params) {
+    try {
+        const rules = params.rules && params.rules.length > 0
+            ? params.rules
+            : await loadArchitectureConfig(params.projectRoot);
+        const violations = [];
+        let filesChecked = 0;
+        // Mode 1: Single file check (or proposed in-memory content)
+        if (params.filePath) {
+            const relPath = path.relative(params.projectRoot, params.filePath).replace(/\\/g, "/");
+            let content = params.content;
+            if (!content) {
+                if (!existsSync(params.filePath)) {
+                    return {
+                        success: false,
+                        error: `File does not exist: ${params.filePath}`,
+                    };
+                }
+                content = await fs.readFile(params.filePath, "utf-8");
+            }
+            filesChecked++;
+            const ext = path.extname(params.filePath).toLowerCase();
+            const rawImports = extractImportStatements(content, ext);
+            // Check applicable rules for this file's path
+            for (const rule of rules) {
+                if (matchesPattern(relPath, rule.pattern)) {
+                    for (const imp of rawImports) {
+                        let resolvedSource = imp.source;
+                        // If it's a relative import, resolve it relative to projectRoot
+                        if (imp.source.startsWith("./") || imp.source.startsWith("../")) {
+                            const fileDir = path.dirname(params.filePath);
+                            const resolvedAbs = path.resolve(fileDir, imp.source);
+                            resolvedSource = path.relative(params.projectRoot, resolvedAbs).replace(/\\/g, "/");
+                        }
+                        for (const disallowed of rule.disallow) {
+                            if (matchesPattern(resolvedSource, disallowed) || matchesPattern(imp.source, disallowed)) {
+                                violations.push({
+                                    filePath: relPath,
+                                    line: imp.line,
+                                    layer: rule.layer,
+                                    rulePattern: rule.pattern,
+                                    disallowedSource: imp.source,
+                                    matchedRule: disallowed,
+                                    message: `Layer '${rule.layer}' (${rule.pattern}) is forbidden from importing '${imp.source}'. ${rule.description || ""}`.trim(),
+                                    suggestion: rule.suggestion || "Decouple layer dependencies using interfaces, ports, or DTOs.",
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        const report = {
+            compliant: violations.length === 0,
+            violationsCount: violations.length,
+            filesChecked,
+            violations,
+            rulesApplied: rules,
+        };
+        const footer = violations.length === 0
+            ? "\n\n✅ Architectural Boundary Guardrails: 100% Compliant (Zero Layer Violations)."
+            : `\n\n⚠️ Architectural Boundary Violations: Found ${violations.length} illegal layer imports!`;
+        return {
+            success: true,
+            content: JSON.stringify(report, null, 2) + footer,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `enforce_architecture_rules failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+//# sourceMappingURL=architectureLinter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"architectureLinter.js","sourceRoot":"","sources":["../../../src/operations/architectureLinter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AA8B/D;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAuB;IAC5D;QACE,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE;YACR,aAAa;YACb,sBAAsB;YACtB,gBAAgB;YAChB,mBAAmB;YACnB,WAAW;YACX,SAAS;YACT,SAAS;YACT,gBAAgB;YAChB,OAAO;YACP,MAAM;YACN,SAAS;YACT,gBAAgB;YAChB,SAAS;YACT,UAAU;YACV,MAAM;YACN,IAAI;YACJ,QAAQ;SACT;QACD,WAAW,EAAE,yHAAyH;QACtI,UAAU,EAAE,6FAA6F;KAC1G;IACD;QACE,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,kBAAkB;QAC3B,QAAQ,EAAE;YACR,UAAU;YACV,gBAAgB;YAChB,cAAc;YACd,gBAAgB;YAChB,SAAS;YACT,UAAU;YACV,MAAM;YACN,IAAI;YACJ,QAAQ;YACR,SAAS;SACV;QACD,WAAW,EAAE,4FAA4F;QACzG,UAAU,EAAE,8EAA8E;KAC3F;IACD;QACE,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,iBAAiB;QAC1B,QAAQ,EAAE;YACR,mBAAmB;YACnB,aAAa;YACb,SAAS;YACT,SAAS;YACT,OAAO;SACR;QACD,WAAW,EAAE,kGAAkG;QAC/G,UAAU,EAAE,kFAAkF;KAC/F;CACF,CAAC;AAEF;;GAEG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5C,IAAI,KAAK,GAAG,UAAU;SACnB,OAAO,CAAC,qCAAqC,EAAE,MAAM,CAAC;SACtD,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC;SAC1B,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAEpC,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,MAAc,EAAE,OAAe;IACrD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEhD,qBAAqB;IACrB,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAE5C,8DAA8D;IAC9D,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IAChF,CAAC;IAED,mBAAmB;IACnB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAErC,yDAAyD;QACzD,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACnE,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC;YACpD,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,sBAAsB,CAAC,WAAmB;IACvD,MAAM,WAAW,GAAG;QAClB,sBAAsB;QACtB,iBAAiB;QACjB,mBAAmB;QACnB,oBAAoB;KACrB,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,OAAO,MAA4B,CAAC;gBACtC,CAAC;gBACD,IAAI,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;oBAChD,OAAO,MAAM,CAAC,KAA2B,CAAC;gBAC5C,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,+BAA+B;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,0BAA0B,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,MAK9C;IACC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YACnD,CAAC,CAAC,MAAM,CAAC,KAAK;YACd,CAAC,CAAC,MAAM,sBAAsB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAErD,MAAM,UAAU,GAA4B,EAAE,CAAC;QAC/C,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,4DAA4D;QAC5D,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACvF,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACjC,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,wBAAwB,MAAM,CAAC,QAAQ,EAAE;qBACjD,CAAC;gBACJ,CAAC;gBACD,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACxD,CAAC;YAED,YAAY,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YACxD,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAEzD,8CAA8C;YAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;wBAC7B,IAAI,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC;wBAEhC,gEAAgE;wBAChE,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;4BAChE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;4BAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;4BACtD,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;wBACtF,CAAC;wBAED,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;4BACvC,IAAI,cAAc,CAAC,cAAc,EAAE,UAAU,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;gCACzF,UAAU,CAAC,IAAI,CAAC;oCACd,QAAQ,EAAE,OAAO;oCACjB,IAAI,EAAE,GAAG,CAAC,IAAI;oCACd,KAAK,EAAE,IAAI,CAAC,KAAK;oCACjB,WAAW,EAAE,IAAI,CAAC,OAAO;oCACzB,gBAAgB,EAAE,GAAG,CAAC,MAAM;oCAC5B,WAAW,EAAE,UAAU;oCACvB,OAAO,EAAE,UAAU,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,OAAO,kCAAkC,GAAG,CAAC,MAAM,MAAM,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;oCAChI,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,+DAA+D;iCAC/F,CAAC,CAAC;4BACL,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAiC;YAC3C,SAAS,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;YAClC,eAAe,EAAE,UAAU,CAAC,MAAM;YAClC,YAAY;YACZ,UAAU;YACV,YAAY,EAAE,KAAK;SACpB,CAAC;QAEF,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC;YACpC,CAAC,CAAC,kFAAkF;YACpF,CAAC,CAAC,mDAAmD,UAAU,CAAC,MAAM,yBAAyB,CAAC;QAElG,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,MAAM;SAClD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SACtG,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * AST Complexity Matrix (McCabe Cyclomatic & Sonar Cognitive Complexity)
+ * v5.6.0 Enterprise AST Intelligence
+ */
+import { ParserRegistry } from "../parsers/registry.js";
+import type { ReadResult } from "./readCore.js";
+export interface FunctionComplexityMetric {
+    name: string;
+    kind: "function" | "method" | "arrow_function";
+    startLine: number;
+    endLine: number;
+    cyclomaticComplexity: number;
+    cognitiveComplexity: number;
+    maxNestingDepth: number;
+    riskLevel: "LOW" | "MODERATE" | "HIGH" | "CRITICAL";
+    recommendation: string;
+}
+export interface AstComplexityReport {
+    filePath?: string;
+    totalFunctionsAnalyzed: number;
+    averageCyclomatic: number;
+    averageCognitive: number;
+    highestCognitiveFunction?: string;
+    metrics: FunctionComplexityMetric[];
+    summary: string;
+}
+export interface AstComplexityOptions {
+    filePath?: string;
+    code?: string;
+    content?: string;
+    threshold?: number;
+    projectRoot?: string;
+    registry?: ParserRegistry;
+}
+/**
+ * Computes the AST complexity matrix for a file
+ */
+export declare function getAstComplexityMatrix(params: AstComplexityOptions): Promise<ReadResult>;