codeguardian-mcp 1.0.0

package/dist/api-contract/extractors/pythonAstUtils.js

@@ -0,0 +1,489 @@
+/**
+ * API Contract Guardian - Python AST Utilities
+ *
+ * Tree-sitter powered extraction for Python backends.
+ *
+ * Goals:
+ * - Prefer AST for correctness (avoid matching commented code)
+ * - Provide a shared implementation for both legacy api-contract module and
+ *   integrated context extraction.
+ * - Keep a regex fallback in callers for patterns not yet covered.
+ *
+ * @format
+ */
+import { getParser } from "../../tools/validation/parser.js";
+export function extractRoutesFromPythonAST(content, filePath, framework) {
+    // Only frameworks with decorator-based routing are supported here.
+    if (framework !== "fastapi" && framework !== "flask")
+        return [];
+    const parser = getParser("python");
+    const tree = parser.parse(content);
+    const root = tree.rootNode;
+    const routerPrefixByVar = framework === "fastapi" ? extractRouterPrefixesAST(root, content) : new Map();
+    const routes = [];
+    const visit = (node) => {
+        if (!node)
+            return;
+        if (node.type === "function_definition") {
+            const decorators = getDecorators(node, content);
+            if (decorators.length > 0) {
+                const fnNameNode = node.childForFieldName?.("name");
+                const handler = fnNameNode ? getNodeText(fnNameNode, content) : "";
+                const line = (node.startPosition?.row ?? 0) + 1;
+                for (const decoratorNode of decorators) {
+                    const route = extractRouteFromDecorator(decoratorNode, node, content, framework, routerPrefixByVar, handler, line);
+                    if (route)
+                        routes.push(route);
+                }
+            }
+        }
+        for (const child of node.children || [])
+            visit(child);
+    };
+    visit(root);
+    // Attach filePath late to keep util generic; callers may use filePath separately.
+    // Here we embed it into the path-normalization step only (no file field on ExtractedRoute).
+    return routes;
+}
+export function extractPydanticModelsFromPythonAST(content, filePath) {
+    const parser = getParser("python");
+    const tree = parser.parse(content);
+    const root = tree.rootNode;
+    const models = [];
+    const visit = (node) => {
+        if (!node)
+            return;
+        if (node.type === "class_definition") {
+            const nameNode = node.childForFieldName?.("name");
+            const name = nameNode ? getNodeText(nameNode, content) : "";
+            const line = (node.startPosition?.row ?? 0) + 1;
+            const baseClasses = getClassBaseClasses(node, content);
+            if (!isPydanticBaseClass(baseClasses)) {
+                for (const child of node.children || [])
+                    visit(child);
+                return;
+            }
+            const fields = extractPydanticFieldsFromClass(node, content);
+            models.push({ name, fields, baseClasses, line });
+            // Still recurse to catch nested classes
+            for (const child of node.children || [])
+                visit(child);
+            return;
+        }
+        for (const child of node.children || [])
+            visit(child);
+    };
+    visit(root);
+    return models;
+}
+// ============================================================================
+// Route extraction helpers
+// ============================================================================
+function extractRouterPrefixesAST(root, content) {
+    const prefixes = new Map();
+    const visit = (node) => {
+        if (!node)
+            return;
+        if (node.type === "assignment") {
+            const left = node.childForFieldName?.("left");
+            const right = node.childForFieldName?.("right");
+            if (left?.type === "identifier" && right?.type === "call") {
+                const funcNode = right.childForFieldName?.("function");
+                const funcText = funcNode ? getNodeText(funcNode, content) : "";
+                if (funcText.endsWith("APIRouter")) {
+                    const args = right.childForFieldName?.("arguments");
+                    const kw = collectKeywordArgs(args, content);
+                    const prefixNode = kw.get("prefix");
+                    const prefix = prefixNode ? extractPythonString(prefixNode, content) : null;
+                    if (prefix) {
+                        prefixes.set(getNodeText(left, content), prefix);
+                    }
+                }
+            }
+        }
+        for (const child of node.children || [])
+            visit(child);
+    };
+    visit(root);
+    return prefixes;
+}
+function extractRouteFromDecorator(decoratorNode, functionNode, content, framework, routerPrefixByVar, handler, line) {
+    const callNode = findFirstNodeOfType(decoratorNode, "call");
+    if (!callNode)
+        return null;
+    const fn = callNode.childForFieldName?.("function");
+    const argsNode = callNode.childForFieldName?.("arguments");
+    if (!fn || !argsNode)
+        return null;
+    // FastAPI: @app.get("/x") / @router.post("/x")
+    if (framework === "fastapi" && fn.type === "attribute") {
+        const objNode = fn.childForFieldName?.("object");
+        const attrNode = fn.childForFieldName?.("attribute");
+        if (!objNode || !attrNode)
+            return null;
+        const objName = getNodeText(objNode, content);
+        const methodName = getNodeText(attrNode, content);
+        const mapped = mapToHttpMethod(methodName);
+        if (!mapped)
+            return null;
+        const pathArg = extractDecoratorPathArg(argsNode, content);
+        if (!pathArg)
+            return null;
+        const routerPrefix = routerPrefixByVar.get(objName) || "";
+        const path = normalizePath(routerPrefix + pathArg);
+        const { requestModel, responseModel, queryParams } = extractTypeInfoFromFunction(functionNode, content, mapped, path);
+        return {
+            method: mapped,
+            path,
+            handler,
+            requestModel,
+            responseModel,
+            queryParams,
+            line,
+        };
+    }
+    // Flask: @app.route("/x", methods=["POST"])
+    if (framework === "flask" && fn.type === "attribute") {
+        const objNode = fn.childForFieldName?.("object");
+        const attrNode = fn.childForFieldName?.("attribute");
+        if (!objNode || !attrNode)
+            return null;
+        const attr = getNodeText(attrNode, content);
+        if (attr !== "route")
+            return null;
+        const pathArg = extractDecoratorPathArg(argsNode, content);
+        if (!pathArg)
+            return null;
+        const methods = extractFlaskMethodsArg(argsNode, content);
+        const method = (methods[0] || "GET");
+        const path = normalizePath(pathArg);
+        return {
+            method,
+            path,
+            handler,
+            line,
+        };
+    }
+    return null;
+}
+function extractDecoratorPathArg(argsNode, content) {
+    // Prefer keyword path=..., else first positional string.
+    const kw = collectKeywordArgs(argsNode, content);
+    const pathNode = kw.get("path") || kw.get("url") || null;
+    if (pathNode) {
+        const s = extractPythonString(pathNode, content);
+        if (s)
+            return s;
+    }
+    for (const node of collectPositionalArgs(argsNode)) {
+        const s = extractPythonString(node, content);
+        if (s)
+            return s;
+    }
+    return null;
+}
+function extractFlaskMethodsArg(argsNode, content) {
+    const kw = collectKeywordArgs(argsNode, content);
+    const methodsNode = kw.get("methods");
+    if (!methodsNode)
+        return [];
+    const listNode = findFirstNodeOfType(methodsNode, "list") || methodsNode;
+    const methods = [];
+    for (const child of listNode.children || []) {
+        const s = extractPythonString(child, content);
+        if (s)
+            methods.push(s.toUpperCase());
+    }
+    return methods;
+}
+function extractTypeInfoFromFunction(functionNode, content, method, path) {
+    const paramsNode = functionNode.childForFieldName?.("parameters");
+    const returnTypeNode = functionNode.childForFieldName?.("return_type");
+    const pathParamNames = new Set();
+    for (const pm of path.matchAll(/\{(\w+)(?::\w+)?\}/g)) {
+        pathParamNames.add(pm[1]);
+    }
+    const skipNames = new Set([
+        "db",
+        "session",
+        "request",
+        "response",
+        "user",
+        "current_user",
+    ]);
+    let responseModel;
+    if (returnTypeNode) {
+        const top = extractTopLevelTypeName(returnTypeNode, content);
+        if (top && !isPrimitiveType(top))
+            responseModel = top;
+    }
+    const queryParams = [];
+    let requestModel;
+    const params = paramsNode ? collectFunctionParams(paramsNode, content) : [];
+    for (const p of params) {
+        if (!p.name || skipNames.has(p.name))
+            continue;
+        if (pathParamNames.has(p.name))
+            continue;
+        if (!p.type)
+            continue;
+        // primitives become query params
+        if (isPrimitiveType(p.type)) {
+            queryParams.push({
+                name: p.name,
+                type: p.type,
+                required: p.required,
+            });
+            continue;
+        }
+        // request model: first non-primitive param (for write methods)
+        if (!requestModel && (method === "POST" || method === "PUT" || method === "PATCH")) {
+            requestModel = p.type;
+        }
+    }
+    return {
+        requestModel,
+        responseModel,
+        queryParams: queryParams.length > 0 ? queryParams : undefined,
+    };
+}
+function collectFunctionParams(paramsNode, content) {
+    const out = [];
+    for (const child of paramsNode.children || []) {
+        if (!child)
+            continue;
+        // typed_parameter / typed_default_parameter
+        if (child.type === "typed_parameter" || child.type === "typed_default_parameter") {
+            // tree-sitter-python:
+            // - typed_parameter: (typed_parameter (identifier) type: (type ...))  (no name field)
+            // - typed_default_parameter: (typed_default_parameter name: (identifier) type: ... value: ...)
+            const nameNode = child.childForFieldName?.("name") ||
+                (child.children || []).find((c) => c?.type === "identifier");
+            const typeNode = child.childForFieldName?.("type");
+            const valueNode = child.childForFieldName?.("value");
+            const name = nameNode ? getNodeText(nameNode, content) : "";
+            const type = typeNode ? normalizeTypeText(getNodeText(typeNode, content)) : undefined;
+            const required = !valueNode;
+            out.push({ name, type, required });
+            continue;
+        }
+        // default_parameter
+        if (child.type === "default_parameter") {
+            const nameNode = child.childForFieldName?.("name");
+            const name = nameNode ? getNodeText(nameNode, content) : "";
+            out.push({ name, required: false });
+            continue;
+        }
+        // identifier
+        if (child.type === "identifier") {
+            out.push({ name: getNodeText(child, content), required: true });
+            continue;
+        }
+    }
+    return out.filter((p) => p.name && p.name !== "self" && p.name !== "cls");
+}
+// ============================================================================
+// Model extraction helpers
+// ============================================================================
+function getClassBaseClasses(classNode, content) {
+    const bases = [];
+    const args = classNode.childForFieldName?.("superclasses");
+    // tree-sitter-python uses `argument_list` as the superclass list
+    const argList = args || findFirstNodeOfType(classNode, "argument_list");
+    if (!argList)
+        return bases;
+    for (const child of argList.children || []) {
+        if (!child)
+            continue;
+        if (child.type === "identifier" || child.type === "attribute") {
+            bases.push(getNodeText(child, content));
+        }
+    }
+    return bases;
+}
+function isPydanticBaseClass(baseClasses) {
+    return baseClasses.some((b) => b === "BaseModel" || b.endsWith(".BaseModel"));
+}
+function extractPydanticFieldsFromClass(classNode, content) {
+    const fields = [];
+    const bodyNode = classNode.childForFieldName?.("body");
+    if (!bodyNode)
+        return fields;
+    const visit = (node) => {
+        if (!node)
+            return;
+        // Only consider assignments directly within the class body block.
+        if (node.type === "assignment") {
+            const left = node.childForFieldName?.("left");
+            const typeNode = node.childForFieldName?.("type") || findFirstNodeOfType(node, "type");
+            const right = node.childForFieldName?.("right");
+            if (left?.type === "identifier" && typeNode) {
+                const name = getNodeText(left, content);
+                const typeText = normalizeTypeText(getNodeText(typeNode, content));
+                const defaultText = right ? getNodeText(right, content).trim() : undefined;
+                let required = true;
+                if (isOptionalType(typeText)) {
+                    required = false;
+                }
+                else if (defaultText) {
+                    // Field(...) with ellipsis stays required, otherwise default implies optional
+                    if (/\bField\s*\(\s*\.\.\.\s*\)/.test(defaultText) || defaultText.includes("...")) {
+                        required = true;
+                    }
+                    else if (defaultText === "None") {
+                        required = false;
+                    }
+                    else {
+                        required = false;
+                    }
+                }
+                fields.push({
+                    name,
+                    type: typeText,
+                    required,
+                    default: defaultText,
+                });
+            }
+        }
+        for (const child of node.children || [])
+            visit(child);
+    };
+    visit(bodyNode);
+    return fields;
+}
+// ============================================================================
+// Generic helpers
+// ============================================================================
+function findFirstNodeOfType(node, type) {
+    if (!node)
+        return null;
+    if (node.type === type)
+        return node;
+    for (const child of node.children || []) {
+        const found = findFirstNodeOfType(child, type);
+        if (found)
+            return found;
+    }
+    return null;
+}
+function getDecorators(node, content) {
+    const decorators = [];
+    const parent = node.parent;
+    if (parent?.type === "decorated_definition") {
+        for (const child of parent.children || []) {
+            if (child?.type === "decorator")
+                decorators.push(child);
+        }
+    }
+    return decorators;
+}
+function collectKeywordArgs(argsNode, content) {
+    const kw = new Map();
+    for (const child of argsNode?.children || []) {
+        if (child?.type !== "keyword_argument")
+            continue;
+        const nameNode = child.childForFieldName?.("name");
+        const valueNode = child.childForFieldName?.("value");
+        if (nameNode && valueNode) {
+            const k = getNodeText(nameNode, content);
+            kw.set(k, valueNode);
+        }
+    }
+    return kw;
+}
+function collectPositionalArgs(argsNode) {
+    const out = [];
+    for (const child of argsNode?.children || []) {
+        if (!child)
+            continue;
+        if (child.type === "," || child.type === "(" || child.type === ")")
+            continue;
+        if (child.type === "keyword_argument")
+            continue;
+        out.push(child);
+    }
+    return out;
+}
+export function getNodeText(node, content) {
+    if (!node)
+        return "";
+    return content.slice(node.startIndex, node.endIndex);
+}
+function extractPythonString(node, content) {
+    if (!node)
+        return null;
+    // Accept plain string literals only (skip f-strings for now)
+    if (node.type !== "string")
+        return null;
+    const raw = getNodeText(node, content).trim();
+    const m = raw.match(/^[rubfRUBF]*(['\"]{1,3})([\s\S]*)\1$/);
+    if (!m)
+        return null;
+    return m[2];
+}
+function mapToHttpMethod(name) {
+    const n = name.toLowerCase();
+    if (n === "get")
+        return "GET";
+    if (n === "post")
+        return "POST";
+    if (n === "put")
+        return "PUT";
+    if (n === "patch")
+        return "PATCH";
+    if (n === "delete")
+        return "DELETE";
+    return null;
+}
+function normalizePath(p) {
+    // Ensure leading slash and collapse duplicate slashes.
+    let out = p || "";
+    if (!out.startsWith("/"))
+        out = "/" + out;
+    out = out.replace(/\/+?/g, "/");
+    // remove trailing slash (except root)
+    out = out.length > 1 ? out.replace(/\/$/, "") : out;
+    return out;
+}
+function normalizeTypeText(text) {
+    // Strip leading ':' (type nodes sometimes include it depending on slice)
+    let t = text.trim();
+    t = t.replace(/^:\s*/, "");
+    t = t.replace(/^typing\./, "");
+    return t;
+}
+function extractTopLevelTypeName(typeNode, content) {
+    const visit = (n) => {
+        if (!n)
+            return null;
+        if (n.type === "identifier")
+            return getNodeText(n, content);
+        if (n.type === "attribute")
+            return getNodeText(n, content);
+        for (const child of n.children || []) {
+            const r = visit(child);
+            if (r)
+                return r;
+        }
+        return null;
+    };
+    return visit(typeNode);
+}
+function isOptionalType(typeText) {
+    return /\bOptional\b/.test(typeText) || /\bNone\b/.test(typeText) || typeText.includes("|");
+}
+function isPrimitiveType(typeName) {
+    const t = typeName.toLowerCase();
+    return (t === "str" ||
+        t === "int" ||
+        t === "float" ||
+        t === "bool" ||
+        t === "uuid" ||
+        t === "datetime" ||
+        t === "date" ||
+        t === "dict" ||
+        t === "list" ||
+        t === "tuple" ||
+        t === "set");
+}
+//# sourceMappingURL=pythonAstUtils.js.map

package/dist/api-contract/extractors/pythonAstUtils.js.map

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

package/dist/api-contract/extractors/tsAstUtils.d.ts

@@ -0,0 +1,47 @@
+/**
+ * API Contract Guardian - TypeScript AST Utilities
+ *
+ * Shared Tree-sitter helpers for extracting:
+ * - HTTP methods from call expressions
+ * - endpoints from string/template_string arguments
+ * - enclosing function/property names
+ *
+ * Used by both:
+ * - `src/api-contract/extractors/typescript.ts`
+ * - `src/context/apiContractExtraction.ts`
+ *
+ * @format
+ */
+import type { QueryParam } from "../types.js";
+export type { QueryParam } from "../types.js";
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export declare function getNodeText(node: any, content: string): string;
+export declare function mapToHttpMethod(methodName: string): HttpMethod | null;
+export declare function extractHttpMethodFromArguments(argumentsNode: any, content: string): HttpMethod | null;
+export declare function extractEndpointFromArguments(argumentsNode: any, content: string): {
+    endpoint: string;
+    queryParams: QueryParam[];
+} | null;
+/**
+ * Extract a URL/endpoint from a string or template_string node.
+ *
+ * For template strings, reconstruct a stable path with placeholders.
+ * Examples:
+ * - `/api/clients/${id}` -> `/api/clients/{id}`
+ * - `/pantry${category ? '?cat=...' : ''}` -> `/pantry`
+ */
+export declare function extractStringValue(node: any, content: string): {
+    endpoint: string;
+    queryParams: QueryParam[];
+} | null;
+/**
+ * Find the nearest enclosing function-like name for an AST node.
+ *
+ * Supports:
+ * - function_declaration
+ * - variable_declarator (arrow function assigned to const)
+ * - method_definition
+ * - object properties (pair/property_definition)
+ */
+export declare function findEnclosingFunctionName(node: any, content: string): string | null;
+//# sourceMappingURL=tsAstUtils.d.ts.map

package/dist/api-contract/extractors/tsAstUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsAstUtils.d.ts","sourceRoot":"","sources":["../../../src/api-contract/extractors/tsAstUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CASrE;AAED,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,GAAG,EAClB,OAAO,EAAE,MAAM,GACd,UAAU,GAAG,IAAI,CAOnB;AAmBD,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,GAAG,EAClB,OAAO,EAAE,MAAM,GACd;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAA;CAAE,GAAG,IAAI,CASxD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,MAAM,GACd;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAA;CAAE,GAAG,IAAI,CAiDxD;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6BnF"}