codeguardian-mcp 1.0.0

package/dist/analyzers/usagePatterns.js

@@ -0,0 +1,75 @@
+/**
+ * Usage Pattern Analyzer
+ *
+ * Secret #5: Usage Pattern Consistency (The Helpfulness Pattern)
+ *
+ * Learns "rituals" from the codebase:
+ * - Co-occurrence: Which functions are almost always called together?
+ * - Argument Rituals: Common arguments passed to specific functions.
+ * - Call Ordering: (Heuristic) Which symbols often appear in sequence.
+ *
+ * @format
+ */
+import { logger } from "../utils/logger.js";
+export class UsagePatternAnalyzer {
+    patterns = new Map();
+    /**
+     * Analyze the symbol graph to discover patterns
+     */
+    async analyze(graph) {
+        logger.debug(`Analyzing usage patterns for ${graph.usage.size} symbols...`);
+        for (const [symbolName, usage] of graph.usage.entries()) {
+            // We only care about symbols used at least 3 times to establish a pattern
+            if (usage.usageCount < 3)
+                continue;
+            const coOccurring = this.extractCoOccurrence(symbolName, graph);
+            // If we found significant co-occurrence, store the pattern
+            if (coOccurring.length > 0) {
+                this.patterns.set(symbolName, {
+                    symbol: symbolName,
+                    coOccurringSymbols: coOccurring,
+                    commonArguments: [], // To be implemented with deeper AST mining
+                    callConfidence: usage.usageCount > 10 ? 0.9 : 0.7,
+                });
+            }
+        }
+        logger.debug(`Established ${this.patterns.size} usage pattern rituals.`);
+    }
+    /**
+     * Check if new code deviates from established patterns
+     */
+    checkDeviations(symbolName, surroundingSymbols) {
+        const pattern = this.patterns.get(symbolName);
+        if (!pattern)
+            return [];
+        const deviations = [];
+        const surroundingSet = new Set(surroundingSymbols);
+        // If a symbol has a high co-occurrence (e.g. > 80% usage), 
+        // it should probably be present
+        for (const ritual of pattern.coOccurringSymbols) {
+            if (ritual.frequency > 0.8 && !surroundingSet.has(ritual.name)) {
+                deviations.push(`When using '${symbolName}', projects usually also call '${ritual.name}'.`);
+            }
+        }
+        return deviations;
+    }
+    /**
+     * Extract co-occurrence statistics for a symbol
+     */
+    extractCoOccurrence(symbolName, graph) {
+        const results = [];
+        const coChanges = graph.coOccurrence.get(symbolName);
+        if (!coChanges)
+            return results;
+        const totalUsage = graph.usage.get(symbolName)?.usageCount || 1;
+        for (const [otherName, count] of coChanges.entries()) {
+            const frequency = count / totalUsage;
+            if (frequency > 0.5) { // Significant ritual if seen in >50% of cases
+                results.push({ name: otherName, frequency });
+            }
+        }
+        return results.sort((a, b) => b.frequency - a.frequency);
+    }
+}
+export const usagePatternAnalyzer = new UsagePatternAnalyzer();
+//# sourceMappingURL=usagePatterns.js.map

package/dist/analyzers/usagePatterns.js.map

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

package/dist/api-contract/context/backend.d.ts

@@ -0,0 +1,19 @@
+/**
+ * API Contract Guardian - Backend Context Builder
+ *
+ * Builds the backend context by extracting routes, models, and configuration.
+ *
+ * @format
+ */
+import type { BackendContext, BackendProject } from "../types.js";
+/**
+ * Build backend context from a project path
+ * Extracts routes, models, and API configuration
+ */
+export declare function buildBackendContext(project: BackendProject): Promise<BackendContext>;
+/**
+ * Incrementally update backend context when a file changes
+ * Only re-extracts from the changed file
+ */
+export declare function updateBackendContext(context: BackendContext, projectPath: string, changedFile: string): Promise<BackendContext>;
+//# sourceMappingURL=backend.d.ts.map

package/dist/api-contract/context/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/api-contract/context/backend.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOlE;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,CAAC,CAyBzB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,CAwCzB"}

package/dist/api-contract/context/backend.js

@@ -0,0 +1,64 @@
+/**
+ * API Contract Guardian - Backend Context Builder
+ *
+ * Builds the backend context by extracting routes, models, and configuration.
+ *
+ * @format
+ */
+import { logger } from "../../utils/logger.js";
+import { extractRoutes, extractModels, extractApiConfig, } from "../extractors/python.js";
+/**
+ * Build backend context from a project path
+ * Extracts routes, models, and API configuration
+ */
+export async function buildBackendContext(project) {
+    logger.info(`Building backend context for ${project.framework} project...`);
+    const startTime = Date.now();
+    // Extract routes and models in parallel
+    const [routes, models, config] = await Promise.all([
+        extractRoutes(project.path, project.framework),
+        extractModels(project.path),
+        extractApiConfig(project.path),
+    ]);
+    const context = {
+        framework: project.framework,
+        routes,
+        models,
+        apiPrefix: config.apiPrefix,
+    };
+    logger.info(`Backend context built in ${Date.now() - startTime}ms ` +
+        `(${routes.length} routes, ${models.length} models)`);
+    return context;
+}
+/**
+ * Incrementally update backend context when a file changes
+ * Only re-extracts from the changed file
+ */
+export async function updateBackendContext(context, projectPath, changedFile) {
+    logger.debug(`Updating backend context for changed file: ${changedFile}`);
+    // Remove old entries from this file
+    context.routes = context.routes.filter((r) => !r.file.includes(changedFile));
+    context.models = context.models.filter((m) => !m.file.includes(changedFile));
+    // Re-extract from changed file if it's a relevant file
+    if (changedFile.includes("/routes/") ||
+        changedFile.includes("/routers/") ||
+        changedFile.includes("/api/") ||
+        changedFile.includes("/models/") ||
+        changedFile.includes("/schemas/")) {
+        try {
+            const fs = await import("fs/promises");
+            const content = await fs.readFile(changedFile, "utf-8");
+            // Import extractors dynamically to avoid circular dependencies
+            const { extractRoutesFromFile, extractModelsFromFile, } = await import("../extractors/python.js");
+            const newRoutes = extractRoutesFromFile(content, changedFile, context.framework);
+            const newModels = extractModelsFromFile(content, changedFile);
+            context.routes.push(...newRoutes);
+            context.models.push(...newModels);
+        }
+        catch (err) {
+            logger.debug(`Failed to update context for ${changedFile}`);
+        }
+    }
+    return context;
+}
+//# sourceMappingURL=backend.js.map

package/dist/api-contract/context/backend.js.map

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

package/dist/api-contract/context/contract.d.ts

@@ -0,0 +1,34 @@
+/**
+ * API Contract Guardian - Contract Context Builder
+ *
+ * Links frontend and backend contexts to create a unified contract view.
+ *
+ * @format
+ */
+import type { FrontendContext, BackendContext, ContractContext, EndpointMapping, TypeMapping, ServiceDefinition, RouteDefinition } from "../types.js";
+/**
+ * Build contract context by linking frontend and backend
+ * Matches services to routes and types to models
+ */
+export declare function buildContractContext(frontendContext: FrontendContext, backendContext: BackendContext): Promise<ContractContext>;
+/**
+ * Get contract context for a specific endpoint
+ */
+export declare function getEndpointContract(context: ContractContext, endpoint: string): EndpointMapping | undefined;
+/**
+ * Get type mapping for a specific type
+ */
+export declare function getTypeContract(context: ContractContext, typeName: string): TypeMapping | undefined;
+/**
+ * Check if a service has a matching backend route
+ */
+export declare function hasMatchingRoute(context: ContractContext, service: ServiceDefinition): boolean;
+/**
+ * Get all unmatched frontend services
+ */
+export declare function getUnmatchedFrontendServices(context: ContractContext): ServiceDefinition[];
+/**
+ * Get all unmatched backend routes
+ */
+export declare function getUnmatchedBackendRoutes(context: ContractContext): RouteDefinition[];
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/api-contract/context/contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,eAAe,EAIhB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,eAAe,CAAC,CA8D1B;AA0SD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAE7B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,MAAM,GACf,WAAW,GAAG,SAAS,CAEzB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,eAAe,GACvB,iBAAiB,EAAE,CAErB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,GACvB,eAAe,EAAE,CAEnB"}

package/dist/api-contract/context/contract.js

@@ -0,0 +1,306 @@
+/**
+ * API Contract Guardian - Contract Context Builder
+ *
+ * Links frontend and backend contexts to create a unified contract view.
+ *
+ * @format
+ */
+import { logger } from "../../utils/logger.js";
+/**
+ * Build contract context by linking frontend and backend
+ * Matches services to routes and types to models
+ */
+export async function buildContractContext(frontendContext, backendContext) {
+    logger.info("Building contract context...");
+    const startTime = Date.now();
+    const endpoints = new Map();
+    const types = new Map();
+    const unmatchedFrontend = [];
+    const unmatchedBackend = [];
+    // Match frontend services to backend routes
+    for (const service of frontendContext.services) {
+        const matchingRoute = findMatchingRoute(service, backendContext.routes);
+        if (matchingRoute) {
+            const score = calculateEndpointMatchScore(service, matchingRoute);
+            endpoints.set(service.endpoint, {
+                frontend: service,
+                backend: matchingRoute,
+                score,
+            });
+        }
+        else {
+            unmatchedFrontend.push(service);
+        }
+    }
+    // Find unmatched backend routes
+    for (const route of backendContext.routes) {
+        const isMatched = Array.from(endpoints.values()).some((mapping) => mapping.backend === route);
+        if (!isMatched) {
+            unmatchedBackend.push(route);
+        }
+    }
+    // Match frontend types to backend models
+    for (const type of frontendContext.types) {
+        const matchingModel = findMatchingModel(type, backendContext.models);
+        if (matchingModel) {
+            const compatibility = calculateTypeCompatibility(type, matchingModel);
+            types.set(type.name, {
+                frontend: type,
+                backend: matchingModel,
+                compatibility,
+            });
+        }
+    }
+    const context = {
+        endpoints,
+        types,
+        unmatchedFrontend,
+        unmatchedBackend,
+    };
+    logger.info(`Contract context built in ${Date.now() - startTime}ms ` +
+        `(${endpoints.size} matched endpoints, ${types.size} matched types, ` +
+        `${unmatchedFrontend.length} unmatched frontend, ${unmatchedBackend.length} unmatched backend)`);
+    return context;
+}
+// ============================================================================
+// Endpoint Matching
+// ============================================================================
+/**
+ * Find a matching backend route for a frontend service
+ */
+function findMatchingRoute(service, routes) {
+    // Normalize the service endpoint
+    const normalizedEndpoint = normalizePath(service.endpoint);
+    // First try exact match
+    const exactMatch = routes.find((route) => {
+        const normalizedRoute = normalizePath(route.path);
+        return (normalizedRoute === normalizedEndpoint &&
+            route.method.toUpperCase() === service.method.toUpperCase());
+    });
+    if (exactMatch) {
+        return exactMatch;
+    }
+    // Try fuzzy match (handle API prefix differences)
+    // Frontend: /clients, Backend: /api/clients
+    const fuzzyMatch = routes.find((route) => {
+        const normalizedRoute = normalizePath(route.path);
+        const routeWithoutPrefix = removeApiPrefix(normalizedRoute);
+        const serviceWithoutPrefix = removeApiPrefix(normalizedEndpoint);
+        return (routeWithoutPrefix === serviceWithoutPrefix &&
+            route.method.toUpperCase() === service.method.toUpperCase());
+    });
+    return fuzzyMatch;
+}
+/**
+ * Calculate match score for endpoint mapping
+ */
+function calculateEndpointMatchScore(service, route) {
+    let score = 100;
+    // Method match is critical
+    if (service.method.toUpperCase() !== route.method.toUpperCase()) {
+        score -= 50;
+    }
+    // Path match
+    const normalizedService = normalizePath(service.endpoint);
+    const normalizedRoute = normalizePath(route.path);
+    if (normalizedService === normalizedRoute) {
+        score += 10;
+    }
+    else if (removeApiPrefix(normalizedService) === removeApiPrefix(normalizedRoute)) {
+        score += 5;
+    }
+    // Type name match bonus
+    if (service.requestType && service.requestType === route.requestModel) {
+        score += 10;
+    }
+    if (service.responseType && service.responseType === route.responseModel) {
+        score += 10;
+    }
+    return Math.max(0, Math.min(100, score));
+}
+// ============================================================================
+// Type Matching
+// ============================================================================
+/**
+ * Find a matching backend model for a frontend type
+ */
+function findMatchingModel(type, models) {
+    // Try exact name match first
+    const exactMatch = models.find((m) => m.name === type.name);
+    if (exactMatch) {
+        return exactMatch;
+    }
+    // Try normalized name match (handle naming conventions)
+    // ClientCreate -> client_create, clientCreate
+    const normalizedTypeName = normalizeName(type.name);
+    const normalizedMatch = models.find((m) => normalizeName(m.name) === normalizedTypeName);
+    if (normalizedMatch) {
+        return normalizedMatch;
+    }
+    // Try fuzzy match based on field similarity
+    let bestMatch;
+    let bestScore = 0;
+    for (const model of models) {
+        const score = calculateFieldSimilarity(type, model);
+        if (score > bestScore && score > 0.7) {
+            // 70% threshold
+            bestScore = score;
+            bestMatch = model;
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Calculate type compatibility between frontend and backend
+ */
+function calculateTypeCompatibility(type, model) {
+    const issues = [];
+    let score = 100;
+    // Check for missing required fields in frontend
+    for (const modelField of model.fields) {
+        if (modelField.required) {
+            const frontendField = type.fields.find((f) => normalizeName(f.name) === normalizeName(modelField.name));
+            if (!frontendField) {
+                score -= 15;
+                issues.push(`Missing required field: ${modelField.name}`);
+            }
+        }
+    }
+    // Check for naming convention mismatches
+    for (const frontendField of type.fields) {
+        const backendField = model.fields.find((f) => normalizeName(f.name) === normalizeName(frontendField.name));
+        if (backendField && frontendField.name !== backendField.name) {
+            score -= 5;
+            issues.push(`Naming convention mismatch: ${frontendField.name} vs ${backendField.name}`);
+        }
+    }
+    // Check type compatibility
+    for (const frontendField of type.fields) {
+        const backendField = model.fields.find((f) => normalizeName(f.name) === normalizeName(frontendField.name));
+        if (backendField) {
+            const typeCompatible = areTypesCompatible(frontendField.type, backendField.type);
+            if (!typeCompatible) {
+                score -= 10;
+                issues.push(`Type mismatch: ${frontendField.name} (${frontendField.type} vs ${backendField.type})`);
+            }
+        }
+    }
+    return {
+        score: Math.max(0, score),
+        issues,
+    };
+}
+/**
+ * Calculate field similarity between type and model
+ */
+function calculateFieldSimilarity(type, model) {
+    if (type.fields.length === 0 || model.fields.length === 0) {
+        return 0;
+    }
+    const typeFieldNames = new Set(type.fields.map((f) => normalizeName(f.name)));
+    const modelFieldNames = new Set(model.fields.map((f) => normalizeName(f.name)));
+    // Calculate Jaccard similarity
+    const intersection = new Set([...typeFieldNames].filter((x) => modelFieldNames.has(x)));
+    const union = new Set([...typeFieldNames, ...modelFieldNames]);
+    return intersection.size / union.size;
+}
+// ============================================================================
+// Type Compatibility
+// ============================================================================
+/**
+ * Check if TypeScript and Python types are compatible
+ */
+function areTypesCompatible(tsType, pyType) {
+    const typeMap = {
+        string: ["str", "String", "text"],
+        number: ["int", "float", "Number", "integer", "decimal"],
+        boolean: ["bool", "Boolean"],
+        Date: ["datetime", "date", "time"],
+        "string[]": ["list[str]", "List[str]", "Sequence[str]"],
+        "number[]": ["list[int]", "list[float]", "List[int]", "List[float]"],
+        object: ["dict", "Dict", "Mapping"],
+        "any[]": ["list", "List", "Sequence"],
+    };
+    // Normalize types
+    const normalizedTsType = tsType.toLowerCase().replace(/\s+/g, "");
+    const normalizedPyType = pyType.toLowerCase().replace(/\s+/g, "");
+    // Direct match
+    if (normalizedTsType === normalizedPyType) {
+        return true;
+    }
+    // Check type map
+    const compatibleTypes = typeMap[normalizedTsType] || [];
+    if (compatibleTypes.some((t) => normalizedPyType.includes(t.toLowerCase().replace(/\s+/g, "")))) {
+        return true;
+    }
+    // Handle optional types
+    if (tsType.includes("?") || tsType.includes("undefined")) {
+        return true; // Optional fields are always compatible
+    }
+    if (pyType.toLowerCase().includes("optional")) {
+        return true;
+    }
+    return false;
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Normalize a path for comparison
+ * Removes trailing slashes and ensures consistent format
+ */
+function normalizePath(path) {
+    return path
+        .replace(/\/+/g, "/") // Remove duplicate slashes
+        .replace(/\/$/, "") // Remove trailing slash
+        .replace(/^\//, ""); // Remove leading slash
+}
+/**
+ * Remove API prefix from path for fuzzy matching
+ */
+function removeApiPrefix(path) {
+    return path.replace(/^(api|v\d+|rest)\//, "");
+}
+/**
+ * Normalize a name for comparison
+ * Handles different naming conventions (camelCase, snake_case, PascalCase)
+ */
+function normalizeName(name) {
+    return (name
+        // Convert camelCase/PascalCase to snake_case
+        .replace(/([a-z])([A-Z])/g, "$1_$2")
+        .toLowerCase()
+        // Remove underscores for comparison
+        .replace(/_/g, ""));
+}
+/**
+ * Get contract context for a specific endpoint
+ */
+export function getEndpointContract(context, endpoint) {
+    return context.endpoints.get(endpoint);
+}
+/**
+ * Get type mapping for a specific type
+ */
+export function getTypeContract(context, typeName) {
+    return context.types.get(typeName);
+}
+/**
+ * Check if a service has a matching backend route
+ */
+export function hasMatchingRoute(context, service) {
+    return context.endpoints.has(service.endpoint);
+}
+/**
+ * Get all unmatched frontend services
+ */
+export function getUnmatchedFrontendServices(context) {
+    return context.unmatchedFrontend;
+}
+/**
+ * Get all unmatched backend routes
+ */
+export function getUnmatchedBackendRoutes(context) {
+    return context.unmatchedBackend;
+}
+//# sourceMappingURL=contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/api-contract/context/contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAc/C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,eAAgC,EAChC,cAA8B;IAE9B,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAE5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC7C,MAAM,iBAAiB,GAAwB,EAAE,CAAC;IAClD,MAAM,gBAAgB,GAAsB,EAAE,CAAC;IAE/C,4CAA4C;IAC5C,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE,CAAC;QAC/C,MAAM,aAAa,GAAG,iBAAiB,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;QACxE,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,2BAA2B,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAClE,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE;gBAC9B,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,aAAa;gBACtB,KAAK;aACN,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACnD,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK,CACvC,CAAC;QACF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,KAAK,EAAE,CAAC;QACzC,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,aAAa,GAAG,0BAA0B,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;YACtE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;gBACnB,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,aAAa;gBACtB,aAAa;aACd,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAoB;QAC/B,SAAS;QACT,KAAK;QACL,iBAAiB;QACjB,gBAAgB;KACjB,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,6BAA6B,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,KAAK;QACtD,IAAI,SAAS,CAAC,IAAI,uBAAuB,KAAK,CAAC,IAAI,kBAAkB;QACrE,GAAG,iBAAiB,CAAC,MAAM,wBAAwB,gBAAgB,CAAC,MAAM,qBAAqB,CAClG,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,iBAAiB,CACxB,OAA0B,EAC1B,MAAyB;IAEzB,iCAAiC;IACjC,MAAM,kBAAkB,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3D,wBAAwB;IACxB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QACvC,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,CACL,eAAe,KAAK,kBAAkB;YACtC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAC5D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,kDAAkD;IAClD,4CAA4C;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QACvC,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,kBAAkB,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;QAC5D,MAAM,oBAAoB,GAAG,eAAe,CAAC,kBAAkB,CAAC,CAAC;QAEjE,OAAO,CACL,kBAAkB,KAAK,oBAAoB;YAC3C,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAC5D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,2BAA2B,CAClC,OAA0B,EAC1B,KAAsB;IAEtB,IAAI,KAAK,GAAG,GAAG,CAAC;IAEhB,2BAA2B;IAC3B,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QAChE,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IAED,aAAa;IACb,MAAM,iBAAiB,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElD,IAAI,iBAAiB,KAAK,eAAe,EAAE,CAAC;QAC1C,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;SAAM,IAAI,eAAe,CAAC,iBAAiB,CAAC,KAAK,eAAe,CAAC,eAAe,CAAC,EAAE,CAAC;QACnF,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;QACtE,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IACD,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,KAAK,KAAK,CAAC,aAAa,EAAE,CAAC;QACzE,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,iBAAiB,CACxB,IAAoB,EACpB,MAAyB;IAEzB,6BAA6B;IAC7B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,wDAAwD;IACxD,8CAA8C;IAC9C,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,kBAAkB,CACpD,CAAC;IAEF,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,4CAA4C;IAC5C,IAAI,SAAsC,CAAC;IAC3C,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,wBAAwB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACpD,IAAI,KAAK,GAAG,SAAS,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YACrC,gBAAgB;YAChB,SAAS,GAAG,KAAK,CAAC;YAClB,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CACjC,IAAoB,EACpB,KAAsB;IAEtB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,GAAG,CAAC;IAEhB,gDAAgD;IAChD,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACtC,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YACxB,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CAChE,CAAC;YAEF,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,KAAK,IAAI,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,2BAA2B,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,KAAK,MAAM,aAAa,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CACnE,CAAC;QAEF,IAAI,YAAY,IAAI,aAAa,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,EAAE,CAAC;YAC7D,KAAK,IAAI,CAAC,CAAC;YACX,MAAM,CAAC,IAAI,CACT,+BAA+B,aAAa,CAAC,IAAI,OAAO,YAAY,CAAC,IAAI,EAAE,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,KAAK,MAAM,aAAa,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CACnE,CAAC;QAEF,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,cAAc,GAAG,kBAAkB,CACvC,aAAa,CAAC,IAAI,EAClB,YAAY,CAAC,IAAI,CAClB,CAAC;YACF,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,KAAK,IAAI,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CACT,kBAAkB,aAAa,CAAC,IAAI,KAAK,aAAa,CAAC,IAAI,OAAO,YAAY,CAAC,IAAI,GAAG,CACvF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC;QACzB,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAC/B,IAAoB,EACpB,KAAsB;IAEtB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEhF,+BAA+B;IAC/B,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,CAAC,GAAG,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAC1D,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,cAAc,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC;IAE/D,OAAO,YAAY,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;AACxC,CAAC;AAED,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,kBAAkB,CAAC,MAAc,EAAE,MAAc;IACxD,MAAM,OAAO,GAA6B;QACxC,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;QACjC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;QACxD,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;QAC5B,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC;QAClC,UAAU,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,eAAe,CAAC;QACvD,UAAU,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,CAAC;QACpE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;QACnC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC;KACtC,CAAC;IAEF,kBAAkB;IAClB,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClE,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAElE,eAAe;IACf,IAAI,gBAAgB,KAAK,gBAAgB,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB;IACjB,MAAM,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IACxD,IACE,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACzB,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAC/D,EACD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wBAAwB;IACxB,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC,CAAC,wCAAwC;IACvD,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;GAGG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI;SACR,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,2BAA2B;SAChD,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,wBAAwB;SAC3C,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,uBAAuB;AAChD,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,CACL,IAAI;QACF,6CAA6C;SAC5C,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,WAAW,EAAE;QACd,oCAAoC;SACnC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAwB,EACxB,QAAgB;IAEhB,OAAO,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAwB,EACxB,QAAgB;IAEhB,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAwB,EACxB,OAA0B;IAE1B,OAAO,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAwB;IAExB,OAAO,OAAO,CAAC,iBAAiB,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAwB;IAExB,OAAO,OAAO,CAAC,gBAAgB,CAAC;AAClC,CAAC"}

package/dist/api-contract/context/frontend.d.ts

@@ -0,0 +1,19 @@
+/**
+ * API Contract Guardian - Frontend Context Builder
+ *
+ * Builds the frontend context by extracting services, types, and configuration.
+ *
+ * @format
+ */
+import type { FrontendContext, FrontendProject } from "../types.js";
+/**
+ * Build frontend context from a project path
+ * Extracts services, types, and API configuration
+ */
+export declare function buildFrontendContext(project: FrontendProject): Promise<FrontendContext>;
+/**
+ * Incrementally update frontend context when a file changes
+ * Only re-extracts from the changed file
+ */
+export declare function updateFrontendContext(context: FrontendContext, projectPath: string, changedFile: string): Promise<FrontendContext>;
+//# sourceMappingURL=frontend.d.ts.map

package/dist/api-contract/context/frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend.d.ts","sourceRoot":"","sources":["../../../src/api-contract/context/frontend.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAOpE;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC,CA0B1B;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CAoC1B"}

package/dist/api-contract/context/frontend.js

@@ -0,0 +1,64 @@
+/**
+ * API Contract Guardian - Frontend Context Builder
+ *
+ * Builds the frontend context by extracting services, types, and configuration.
+ *
+ * @format
+ */
+import { logger } from "../../utils/logger.js";
+import { extractServices, extractTypes, extractApiConfig, } from "../extractors/typescript.js";
+/**
+ * Build frontend context from a project path
+ * Extracts services, types, and API configuration
+ */
+export async function buildFrontendContext(project) {
+    logger.info(`Building frontend context for ${project.framework} project...`);
+    const startTime = Date.now();
+    // Extract services and types in parallel
+    const [services, types, config] = await Promise.all([
+        extractServices(project.path),
+        extractTypes(project.path),
+        extractApiConfig(project.path),
+    ]);
+    const context = {
+        framework: project.framework,
+        services,
+        types,
+        apiBaseUrl: config.apiBaseUrl,
+        httpClient: config.httpClient,
+    };
+    logger.info(`Frontend context built in ${Date.now() - startTime}ms ` +
+        `(${services.length} services, ${types.length} types)`);
+    return context;
+}
+/**
+ * Incrementally update frontend context when a file changes
+ * Only re-extracts from the changed file
+ */
+export async function updateFrontendContext(context, projectPath, changedFile) {
+    logger.debug(`Updating frontend context for changed file: ${changedFile}`);
+    // Remove old entries from this file
+    context.services = context.services.filter((s) => !s.file.includes(changedFile));
+    context.types = context.types.filter((t) => !t.file.includes(changedFile));
+    // Re-extract from changed file if it's a relevant file
+    if (changedFile.includes("/services/") ||
+        changedFile.includes("/api/") ||
+        changedFile.includes("/types/") ||
+        changedFile.includes("/interfaces/")) {
+        try {
+            const fs = await import("fs/promises");
+            const content = await fs.readFile(changedFile, "utf-8");
+            // Import extractors dynamically to avoid circular dependencies
+            const { extractServicesFromFile, extractTypesFromFile } = await import("../extractors/typescript.js");
+            const newServices = extractServicesFromFile(content, changedFile);
+            const newTypes = extractTypesFromFile(content, changedFile);
+            context.services.push(...newServices);
+            context.types.push(...newTypes);
+        }
+        catch (err) {
+            logger.debug(`Failed to update context for ${changedFile}`);
+        }
+    }
+    return context;
+}
+//# sourceMappingURL=frontend.js.map

package/dist/api-contract/context/frontend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend.js","sourceRoot":"","sources":["../../../src/api-contract/context/frontend.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAwB;IAExB,MAAM,CAAC,IAAI,CAAC,iCAAiC,OAAO,CAAC,SAAS,aAAa,CAAC,CAAC;IAE7E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,yCAAyC;IACzC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAClD,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC;QAC7B,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC;QAC1B,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC;KAC/B,CAAC,CAAC;IAEH,MAAM,OAAO,GAAoB;QAC/B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ;QACR,KAAK;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,6BAA6B,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,KAAK;QACtD,IAAI,QAAQ,CAAC,MAAM,cAAc,KAAK,CAAC,MAAM,SAAS,CACzD,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAwB,EACxB,WAAmB,EACnB,WAAmB;IAEnB,MAAM,CAAC,KAAK,CAAC,+CAA+C,WAAW,EAAE,CAAC,CAAC;IAE3E,oCAAoC;IACpC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CACrC,CAAC;IACF,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAE3E,uDAAuD;IACvD,IACE,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC;QAClC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC7B,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC/B,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,EACpC,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAExD,+DAA+D;YAC/D,MAAM,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CACpE,6BAA6B,CAC9B,CAAC;YAEF,MAAM,WAAW,GAAG,uBAAuB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAClE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAE5D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * API Contract Guardian - Project Detector
+ *
+ * Auto-detects project structure (frontend/backend) without configuration.
+ *
+ * @format
+ */
+import type { ProjectStructure, FrontendFramework, BackendFramework } from "./types.js";
+/**
+ * Detect project structure automatically
+ * Scans for frontend and backend projects in the given root path
+ */
+export declare function detectProjectStructure(rootPath: string): Promise<ProjectStructure>;
+/**
+ * Create project structure from manual configuration
+ * Used when auto-detection fails or is disabled
+ */
+export declare function createProjectStructureFromConfig(config: {
+    frontend?: {
+        path: string;
+        framework: FrontendFramework;
+    };
+    backend?: {
+        path: string;
+        framework: BackendFramework;
+    };
+}): ProjectStructure;
+//# sourceMappingURL=detector.d.ts.map