codeguardian-mcp 1.0.0

package/dist/api-contract/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/api-contract/detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EACV,gBAAgB,EAGhB,iBAAiB,EACjB,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAkBpB;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CA8F3B;AA6RD;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAC1D,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,gBAAgB,CAAA;KAAE,CAAC;CACzD,GAAG,gBAAgB,CA8BnB"}

package/dist/api-contract/detector.js

@@ -0,0 +1,393 @@
+/**
+ * API Contract Guardian - Project Detector
+ *
+ * Auto-detects project structure (frontend/backend) without configuration.
+ *
+ * @format
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+import { logger } from "../utils/logger.js";
+// ============================================================================
+// Main Detection Function
+// ============================================================================
+/**
+ * Detect project structure automatically
+ * Scans for frontend and backend projects in the given root path
+ */
+export async function detectProjectStructure(rootPath) {
+    logger.info(`Detecting project structure in ${rootPath}...`);
+    const result = {
+        relationship: "frontend-only",
+    };
+    // Check for common folder structures
+    const commonFrontendPaths = ["frontend", "client", "web", "app", "src"];
+    const commonBackendPaths = ["backend", "server", "api", "services"];
+    let frontendPath = null;
+    let backendPath = null;
+    // Try to find frontend in common locations
+    for (const dir of commonFrontendPaths) {
+        const fullPath = path.join(rootPath, dir);
+        if (await isDirectory(fullPath)) {
+            const detection = await detectFrontend(fullPath);
+            if (detection.confidence > 0.5) {
+                frontendPath = fullPath;
+                break;
+            }
+        }
+    }
+    // Try to find backend in common locations
+    for (const dir of commonBackendPaths) {
+        const fullPath = path.join(rootPath, dir);
+        if (await isDirectory(fullPath)) {
+            const detection = await detectBackend(fullPath);
+            if (detection.confidence > 0.5) {
+                backendPath = fullPath;
+                break;
+            }
+        }
+    }
+    // If not found in common locations, check root
+    if (!frontendPath) {
+        const rootDetection = await detectFrontend(rootPath);
+        if (rootDetection.confidence > 0.5) {
+            frontendPath = rootPath;
+        }
+    }
+    if (!backendPath) {
+        const rootDetection = await detectBackend(rootPath);
+        if (rootDetection.confidence > 0.5) {
+            backendPath = rootPath;
+        }
+    }
+    // Build result
+    if (frontendPath) {
+        const detection = await detectFrontend(frontendPath);
+        result.frontend = {
+            path: frontendPath,
+            framework: detection.framework,
+            apiPattern: detection.apiPattern || "rest",
+            httpClient: detection.httpClient || "fetch",
+            apiBaseUrl: detection.apiBaseUrl,
+        };
+    }
+    if (backendPath) {
+        const detection = await detectBackend(backendPath);
+        result.backend = {
+            path: backendPath,
+            framework: detection.framework,
+            apiPattern: detection.apiPattern || "rest",
+            apiPrefix: "/api",
+        };
+    }
+    // Determine relationship
+    if (result.frontend && result.backend) {
+        result.relationship =
+            frontendPath === rootPath || backendPath === rootPath
+                ? "monorepo"
+                : "separate";
+    }
+    else if (result.backend) {
+        result.relationship = "backend-only";
+    }
+    else if (result.frontend) {
+        result.relationship = "frontend-only";
+    }
+    logger.info(`Project structure detected: ${result.relationship}` +
+        (result.frontend ? ` (frontend: ${result.frontend.framework})` : "") +
+        (result.backend ? ` (backend: ${result.backend.framework})` : ""));
+    return result;
+}
+// ============================================================================
+// Frontend Detection
+// ============================================================================
+async function detectFrontend(projectPath) {
+    let confidence = 0;
+    let framework;
+    let apiPattern = "rest";
+    let httpClient = "fetch";
+    let apiBaseUrl;
+    // Check for package.json
+    const packageJsonPath = path.join(projectPath, "package.json");
+    const hasPackageJson = await fileExists(packageJsonPath);
+    if (!hasPackageJson) {
+        return { confidence: 0 };
+    }
+    confidence += 0.3; // Has package.json
+    try {
+        const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf-8"));
+        const deps = {
+            ...packageJson.dependencies,
+            ...packageJson.devDependencies,
+        };
+        // Detect framework
+        if (deps["next"]) {
+            framework = "nextjs";
+            confidence += 0.4;
+        }
+        else if (deps["react"]) {
+            framework = "react";
+            confidence += 0.3;
+        }
+        else if (deps["vue"]) {
+            framework = "vue";
+            confidence += 0.3;
+        }
+        else if (deps["@angular/core"]) {
+            framework = "angular";
+            confidence += 0.3;
+        }
+        else if (deps["svelte"]) {
+            framework = "svelte";
+            confidence += 0.3;
+        }
+        // Detect HTTP client
+        if (deps["axios"]) {
+            httpClient = "axios";
+        }
+        else if (deps["@tanstack/react-query"] || deps["react-query"]) {
+            httpClient = "react-query";
+            apiPattern = "rest";
+        }
+        else if (deps["swr"]) {
+            httpClient = "swr";
+        }
+        // Detect API pattern
+        if (deps["@trpc/client"] || deps["@trpc/server"]) {
+            apiPattern = "trpc";
+        }
+        else if (deps["graphql"] || deps["apollo-client"]) {
+            apiPattern = "graphql";
+        }
+        else if (deps["socket.io-client"]) {
+            apiPattern = "websocket";
+        }
+        // Check for services folder
+        const servicesPaths = [
+            path.join(projectPath, "src/services"),
+            path.join(projectPath, "services"),
+            path.join(projectPath, "app/services"),
+            path.join(projectPath, "lib/services"),
+        ];
+        for (const servicesPath of servicesPaths) {
+            if (await isDirectory(servicesPath)) {
+                confidence += 0.2;
+                break;
+            }
+        }
+        // Check for API config
+        const configPaths = [
+            path.join(projectPath, "src/config/api.ts"),
+            path.join(projectPath, "src/lib/api.ts"),
+            path.join(projectPath, "lib/api.ts"),
+            path.join(projectPath, "utils/api.ts"),
+        ];
+        for (const configPath of configPaths) {
+            if (await fileExists(configPath)) {
+                confidence += 0.1;
+                // Try to extract API base URL
+                apiBaseUrl = await extractApiBaseUrl(configPath);
+                break;
+            }
+        }
+    }
+    catch (err) {
+        logger.debug(`Failed to parse package.json in ${projectPath}`);
+    }
+    return {
+        confidence: Math.min(confidence, 1),
+        framework,
+        apiPattern,
+        httpClient,
+        apiBaseUrl,
+    };
+}
+// ============================================================================
+// Backend Detection
+// ============================================================================
+async function detectBackend(projectPath) {
+    let confidence = 0;
+    let framework;
+    let apiPattern = "rest";
+    // Check for Python backend
+    const requirementsPath = path.join(projectPath, "requirements.txt");
+    const pyprojectPath = path.join(projectPath, "pyproject.toml");
+    const hasPython = (await fileExists(requirementsPath)) || (await fileExists(pyprojectPath));
+    if (hasPython) {
+        confidence += 0.3;
+        // Detect Python framework
+        try {
+            let deps = "";
+            if (await fileExists(requirementsPath)) {
+                deps = await fs.readFile(requirementsPath, "utf-8");
+            }
+            else if (await fileExists(pyprojectPath)) {
+                deps = await fs.readFile(pyprojectPath, "utf-8");
+            }
+            if (deps.includes("fastapi")) {
+                framework = "fastapi";
+                confidence += 0.4;
+            }
+            else if (deps.includes("flask")) {
+                framework = "flask";
+                confidence += 0.4;
+            }
+            else if (deps.includes("django")) {
+                framework = "django";
+                confidence += 0.4;
+            }
+            if (deps.includes("graphene") || deps.includes("strawberry")) {
+                apiPattern = "graphql";
+            }
+        }
+        catch (err) {
+            logger.debug(`Failed to read Python deps in ${projectPath}`);
+        }
+    }
+    // Check for Node.js backend
+    const packageJsonPath = path.join(projectPath, "package.json");
+    const hasNode = await fileExists(packageJsonPath);
+    if (hasNode) {
+        confidence += 0.3;
+        try {
+            const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf-8"));
+            const deps = {
+                ...packageJson.dependencies,
+                ...packageJson.devDependencies,
+            };
+            if (deps["express"]) {
+                framework = "express";
+                confidence += 0.4;
+            }
+            else if (deps["@nestjs/core"]) {
+                framework = "nestjs";
+                confidence += 0.4;
+            }
+            if (deps["apollo-server"] || deps["graphql"]) {
+                apiPattern = "graphql";
+            }
+            else if (deps["socket.io"]) {
+                apiPattern = "websocket";
+            }
+        }
+        catch (err) {
+            logger.debug(`Failed to parse package.json in ${projectPath}`);
+        }
+    }
+    // Check for routes folder
+    const routesPaths = [
+        path.join(projectPath, "app/routes"),
+        path.join(projectPath, "routes"),
+        path.join(projectPath, "src/routes"),
+        path.join(projectPath, "api"),
+        path.join(projectPath, "routers"),
+    ];
+    for (const routesPath of routesPaths) {
+        if (await isDirectory(routesPath)) {
+            confidence += 0.2;
+            break;
+        }
+    }
+    // Check for main app file
+    const mainPaths = [
+        path.join(projectPath, "app/main.py"),
+        path.join(projectPath, "main.py"),
+        path.join(projectPath, "server.py"),
+        path.join(projectPath, "app.py"),
+        path.join(projectPath, "src/index.ts"),
+        path.join(projectPath, "index.ts"),
+        path.join(projectPath, "server.ts"),
+        path.join(projectPath, "app.ts"),
+    ];
+    for (const mainPath of mainPaths) {
+        if (await fileExists(mainPath)) {
+            confidence += 0.1;
+            break;
+        }
+    }
+    return {
+        confidence: Math.min(confidence, 1),
+        framework,
+        apiPattern,
+    };
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+async function fileExists(filePath) {
+    try {
+        const stats = await fs.stat(filePath);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function isDirectory(dirPath) {
+    try {
+        const stats = await fs.stat(dirPath);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function extractApiBaseUrl(configPath) {
+    try {
+        const content = await fs.readFile(configPath, "utf-8");
+        // Look for common patterns
+        const patterns = [
+            /baseURL\s*[:=]\s*["']([^"']+)["']/,
+            /baseUrl\s*[:=]\s*["']([^"']+)["']/,
+            /API_BASE_URL\s*[:=]\s*["']([^"']+)["']/,
+            /apiBaseUrl\s*[:=]\s*["']([^"']+)["']/,
+            /createAxios\s*\(\s*["']([^"']+)["']/,
+        ];
+        for (const pattern of patterns) {
+            const match = content.match(pattern);
+            if (match) {
+                return match[1];
+            }
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return undefined;
+}
+// ============================================================================
+// Manual Configuration
+// ============================================================================
+/**
+ * Create project structure from manual configuration
+ * Used when auto-detection fails or is disabled
+ */
+export function createProjectStructureFromConfig(config) {
+    const result = {
+        relationship: "frontend-only",
+    };
+    if (config.frontend) {
+        result.frontend = {
+            path: config.frontend.path,
+            framework: config.frontend.framework,
+            apiPattern: "rest",
+            httpClient: "fetch",
+        };
+    }
+    if (config.backend) {
+        result.backend = {
+            path: config.backend.path,
+            framework: config.backend.framework,
+            apiPattern: "rest",
+            apiPrefix: "/api",
+        };
+    }
+    if (result.frontend && result.backend) {
+        result.relationship = "separate";
+    }
+    else if (result.backend) {
+        result.relationship = "backend-only";
+    }
+    return result;
+}
+//# sourceMappingURL=detector.js.map

package/dist/api-contract/detector.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * API Contract Guardian - Python Extractor
+ *
+ * Extracts API routes and Pydantic models from Python backend code.
+ *
+ * @format
+ */
+import type { RouteDefinition, ModelDefinition, BackendFramework } from "../types.js";
+/**
+ * Extract all API routes from a Python project
+ */
+export declare function extractRoutes(projectPath: string, framework: BackendFramework): Promise<RouteDefinition[]>;
+/**
+ * Extract routes from a Python file
+ */
+export declare function extractRoutesFromFile(content: string, filePath: string, framework: BackendFramework): RouteDefinition[];
+/**
+ * Extract all Pydantic models from a Python project
+ */
+export declare function extractModels(projectPath: string): Promise<ModelDefinition[]>;
+/**
+ * Extract Pydantic models from a Python file
+ */
+export declare function extractModelsFromFile(content: string, filePath: string): ModelDefinition[];
+/**
+ * Extract API configuration from a Python project
+ */
+export declare function extractApiConfig(projectPath: string): Promise<{
+    apiPrefix: string;
+    framework: string;
+}>;
+//# sourceMappingURL=python.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../../src/api-contract/extractors/python.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAUrB;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,eAAe,EAAE,CAAC,CAmC5B;AAyCD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,gBAAgB,GAC1B,eAAe,EAAE,CA8FnB;AAsKD;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,EAAE,CAAC,CAyC5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,eAAe,EAAE,CAwHnB;AA2CD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CA6CD"}