codedev-mcp 3.2.0

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

@@ -0,0 +1,46 @@
+/**
+ * API Contract Analysis
+ * Parses OpenAPI/Swagger specs, GraphQL schemas, tRPC routers,
+ * and Express/FastAPI route definitions.
+ */
+export interface ApiEndpoint {
+    /** GET, POST, PUT, DELETE, QUERY, MUTATION, SUBSCRIPTION */
+    method: string;
+    /** /api/users/:id or User.name */
+    path: string;
+    file: string;
+    line: number;
+    parameters?: {
+        name: string;
+        in: string;
+        type: string;
+        required?: boolean;
+    }[];
+    requestBody?: string;
+    responseType?: string;
+    description?: string;
+    source: 'openapi' | 'graphql' | 'trpc' | 'express' | 'fastapi' | 'nestjs';
+}
+export interface ApiContractResult {
+    endpoints: ApiEndpoint[];
+    totalEndpoints: number;
+    sources: string[];
+    specFiles: string[];
+    summary: {
+        get: number;
+        post: number;
+        put: number;
+        delete: number;
+        query: number;
+        mutation: number;
+        other: number;
+    };
+    scannedPatterns: string[];
+}
+/**
+ * Main API contract analysis function.
+ * @param cwd - The working directory to scan.
+ * @returns The API contract analysis result.
+ */
+export declare function analyzeApiContracts(cwd: string): Promise<ApiContractResult>;
+//# sourceMappingURL=api-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-contract.d.ts","sourceRoot":"","sources":["../../src/analyzers/api-contract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC3E;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpH,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AA2MD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+HjF"}

package/dist/analyzers/api-contract.js

@@ -0,0 +1,319 @@
+/**
+ * API Contract Analysis
+ * Parses OpenAPI/Swagger specs, GraphQL schemas, tRPC routers,
+ * and Express/FastAPI route definitions.
+ */
+import { listFiles } from '../search/fast-search.js';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { logger } from '../utils/logger.js';
+/**
+ * Parse OpenAPI/Swagger JSON/YAML.
+ * @param content - The file content to parse.
+ * @param file - The file path.
+ * @returns Parsed API endpoints.
+ */
+function parseOpenAPI(content, file) {
+    const endpoints = [];
+    try {
+        const spec = JSON.parse(content);
+        const paths = spec.paths || {};
+        for (const [urlPath, methods] of Object.entries(paths)) {
+            for (const [method, rawDetails] of Object.entries(methods)) {
+                if (['get', 'post', 'put', 'delete', 'patch', 'options', 'head'].includes(method)) {
+                    const details = rawDetails;
+                    const paramsList = (details.parameters || []);
+                    const params = paramsList.map((p) => ({
+                        name: p.name,
+                        in: p.in,
+                        type: p.schema?.type || 'unknown',
+                        required: p.required,
+                    }));
+                    const requestBody = details.requestBody;
+                    const responses = details.responses;
+                    endpoints.push({
+                        method: method.toUpperCase(),
+                        path: urlPath,
+                        file,
+                        line: 0,
+                        parameters: params,
+                        requestBody: requestBody?.content?.['application/json']?.schema?.$ref || undefined,
+                        responseType: responses?.['200']?.content?.['application/json']?.schema?.$ref || undefined,
+                        description: (details.summary || details.description),
+                        source: 'openapi',
+                    });
+                }
+            }
+        }
+    }
+    catch (error) {
+        logger.debug(`Failed to parse OpenAPI spec: ${file}`, { error });
+    }
+    return endpoints;
+}
+/**
+ * Parse GraphQL schema definitions.
+ * @param content - The file content to parse.
+ * @param file - The file path.
+ * @returns Parsed API endpoints.
+ */
+function parseGraphQL(content, file) {
+    const endpoints = [];
+    // Find type Query, Mutation, Subscription blocks
+    const typeBlockRegex = /type\s+(Query|Mutation|Subscription)\s*\{([^}]+)\}/gs;
+    let match;
+    while ((match = typeBlockRegex.exec(content)) !== null) {
+        const blockType = match[1];
+        const body = match[2];
+        const blockLine = content.substring(0, match.index).split('\n').length;
+        const methodMap = { Query: 'QUERY', Mutation: 'MUTATION', Subscription: 'SUBSCRIPTION' };
+        for (const fieldLine of body.split('\n')) {
+            const trimmed = fieldLine.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const fieldMatch = trimmed.match(/(\w+)\s*(?:\(([^)]*)\))?\s*:\s*(.+)/);
+            if (fieldMatch) {
+                const params = fieldMatch[2]
+                    ? fieldMatch[2].split(',').map((p) => {
+                        const [name, type] = p.trim().split(/\s*:\s*/);
+                        return {
+                            name: name.replace('!', ''),
+                            in: 'argument',
+                            type: (type || 'unknown').replace('!', ''),
+                            required: p.includes('!'),
+                        };
+                    })
+                    : [];
+                endpoints.push({
+                    method: methodMap[blockType] || 'QUERY',
+                    path: `${blockType}.${fieldMatch[1]}`,
+                    file,
+                    line: blockLine,
+                    parameters: params,
+                    responseType: fieldMatch[3].trim().replace('!', ''),
+                    source: 'graphql',
+                });
+            }
+        }
+    }
+    return endpoints;
+}
+/**
+ * Parse Express/Fastify route definitions.
+ * @param content - The file content to parse.
+ * @param file - The file path.
+ * @returns Parsed API endpoints.
+ */
+function parseExpressRoutes(content, file) {
+    const endpoints = [];
+    const routeRegex = /(?:app|router)\.(get|post|put|delete|patch)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
+    let match;
+    while ((match = routeRegex.exec(content)) !== null) {
+        const line = content.substring(0, match.index).split('\n').length;
+        endpoints.push({
+            method: match[1].toUpperCase(),
+            path: match[2],
+            file,
+            line,
+            source: 'express',
+        });
+    }
+    return endpoints;
+}
+/**
+ * Parse FastAPI route decorators.
+ * @param content - The file content to parse.
+ * @param file - The file path.
+ * @returns Parsed API endpoints.
+ */
+function parseFastAPIRoutes(content, file) {
+    const endpoints = [];
+    const routeRegex = /@(?:app|router)\.(get|post|put|delete|patch)\s*\(\s*['"]([^'"]+)['"]/gi;
+    let match;
+    while ((match = routeRegex.exec(content)) !== null) {
+        const line = content.substring(0, match.index).split('\n').length;
+        // Try to extract the function signature
+        const afterDeco = content.substring(match.index + match[0].length);
+        const funcMatch = afterDeco.match(/(?:async\s+)?def\s+\w+\s*\(([^)]*)\)/);
+        const params = funcMatch?.[1]
+            ?.split(',')
+            .map((p) => p.trim())
+            .filter((p) => p && !p.startsWith('self') && !p.startsWith('request'))
+            .map((p) => {
+            const [name, type] = p.split(/\s*:\s*/);
+            return { name, in: 'parameter', type: type || 'unknown' };
+        }) || [];
+        endpoints.push({
+            method: match[1].toUpperCase(),
+            path: match[2],
+            file,
+            line,
+            parameters: params,
+            source: 'fastapi',
+        });
+    }
+    return endpoints;
+}
+/**
+ * Parse NestJS controller decorators.
+ * @param content - The file content to parse.
+ * @param file - The file path.
+ * @returns Parsed API endpoints.
+ */
+function parseNestJSRoutes(content, file) {
+    const endpoints = [];
+    if (!/@Controller/.test(content))
+        return endpoints;
+    const controllerPath = content.match(/@Controller\s*\(\s*['"]([^'"]*)['"]\s*\)/)?.[1] || '';
+    const routeRegex = /@(Get|Post|Put|Delete|Patch)\s*\(\s*(?:['"]([^'"]*)['"]\s*)?\)/gi;
+    let match;
+    while ((match = routeRegex.exec(content)) !== null) {
+        const line = content.substring(0, match.index).split('\n').length;
+        const methodPath = match[2] || '';
+        endpoints.push({
+            method: match[1].toUpperCase(),
+            path: `/${controllerPath}/${methodPath}`.replace(/\/+/g, '/'),
+            file,
+            line,
+            source: 'nestjs',
+        });
+    }
+    return endpoints;
+}
+/**
+ * Main API contract analysis function.
+ * @param cwd - The working directory to scan.
+ * @returns The API contract analysis result.
+ */
+export async function analyzeApiContracts(cwd) {
+    const allEndpoints = [];
+    const specFiles = [];
+    const sources = new Set();
+    // Find spec files
+    const jsonFiles = await listFiles(cwd, { glob: '**/*.{json,yaml,yml}' });
+    const gqlFiles = await listFiles(cwd, { glob: '**/*.{graphql,gql}' });
+    const tsFiles = await listFiles(cwd, { glob: '**/*.{ts,tsx,js,jsx}' });
+    const pyFiles = await listFiles(cwd, { glob: '**/*.py' });
+    // OpenAPI specs
+    for (const f of jsonFiles.filter((f) => /swagger|openapi/i.test(f)).slice(0, 10)) {
+        try {
+            const content = await readFile(path.join(cwd, f), 'utf-8');
+            const eps = parseOpenAPI(content, f);
+            if (eps.length > 0) {
+                allEndpoints.push(...eps);
+                specFiles.push(f);
+                sources.add('openapi');
+            }
+        }
+        catch (error) {
+            logger.debug(`Failed to parse possible OpenAPI spec: ${f}`, { error });
+        }
+    }
+    // GraphQL schemas
+    for (const f of gqlFiles.slice(0, 20)) {
+        try {
+            const content = await readFile(path.join(cwd, f), 'utf-8');
+            const eps = parseGraphQL(content, f);
+            if (eps.length > 0) {
+                allEndpoints.push(...eps);
+                specFiles.push(f);
+                sources.add('graphql');
+            }
+        }
+        catch (error) {
+            logger.debug(`Failed to parse possible OpenAPI spec: ${f}`, { error });
+        }
+    }
+    // Express/NestJS routes
+    for (const f of tsFiles.slice(0, 300)) {
+        try {
+            const content = await readFile(path.join(cwd, f), 'utf-8');
+            if (/(?:app|router)\.(get|post|put|delete|patch)\s*\(/i.test(content)) {
+                const eps = parseExpressRoutes(content, f);
+                if (eps.length > 0) {
+                    allEndpoints.push(...eps);
+                    specFiles.push(f);
+                    sources.add('express');
+                }
+            }
+            if (/@Controller/.test(content)) {
+                const eps = parseNestJSRoutes(content, f);
+                if (eps.length > 0) {
+                    allEndpoints.push(...eps);
+                    specFiles.push(f);
+                    sources.add('nestjs');
+                }
+            }
+        }
+        catch (error) {
+            logger.debug(`Failed to parse possible OpenAPI spec: ${f}`, { error });
+        }
+    }
+    // FastAPI routes
+    for (const f of pyFiles.slice(0, 200)) {
+        try {
+            const content = await readFile(path.join(cwd, f), 'utf-8');
+            if (/@(?:app|router)\.(get|post|put|delete)/.test(content)) {
+                const eps = parseFastAPIRoutes(content, f);
+                if (eps.length > 0) {
+                    allEndpoints.push(...eps);
+                    specFiles.push(f);
+                    sources.add('fastapi');
+                }
+            }
+        }
+        catch (error) {
+            logger.debug(`Failed to parse possible OpenAPI spec: ${f}`, { error });
+        }
+    }
+    // Also check for GraphQL in TS/JS files
+    for (const f of tsFiles.filter((f) => /schema|graphql|typeDefs/i.test(f)).slice(0, 20)) {
+        try {
+            const content = await readFile(path.join(cwd, f), 'utf-8');
+            if (/type\s+(?:Query|Mutation)\s*\{/.test(content)) {
+                const eps = parseGraphQL(content, f);
+                if (eps.length > 0) {
+                    allEndpoints.push(...eps);
+                    specFiles.push(f);
+                    sources.add('graphql');
+                }
+            }
+        }
+        catch (error) {
+            logger.debug(`Failed to parse possible OpenAPI spec: ${f}`, { error });
+        }
+    }
+    const summary = { get: 0, post: 0, put: 0, delete: 0, query: 0, mutation: 0, other: 0 };
+    for (const ep of allEndpoints) {
+        const m = ep.method.toLowerCase();
+        if (m === 'get')
+            summary.get++;
+        else if (m === 'post')
+            summary.post++;
+        else if (m === 'put' || m === 'patch')
+            summary.put++;
+        else if (m === 'delete')
+            summary.delete++;
+        else if (m === 'query')
+            summary.query++;
+        else if (m === 'mutation')
+            summary.mutation++;
+        else
+            summary.other++;
+    }
+    const scannedPatterns = [
+        '**/*.{json,yaml,yml} (OpenAPI/Swagger containing swagger|openapi)',
+        '**/*.{graphql,gql} (GraphQL schemas)',
+        '**/*.{ts,tsx,js,jsx} (Express/NestJS routes with router.get/post/decorators)',
+        '**/*.py (FastAPI routes with @app.get/post)',
+    ];
+    return {
+        endpoints: allEndpoints,
+        totalEndpoints: allEndpoints.length,
+        sources: Array.from(sources),
+        specFiles: [...new Set(specFiles)],
+        summary,
+        scannedPatterns,
+    };
+}
+//# sourceMappingURL=api-contract.js.map

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

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

package/dist/analyzers/architecture.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Architecture Rule Enforcement
+ * Verify layer boundaries, dependency constraints, circular imports.
+ */
+export interface ArchViolation {
+    rule: string;
+    file: string;
+    line?: number;
+    message: string;
+    severity: 'error' | 'warning';
+    importPath?: string;
+}
+export interface ArchResult {
+    violations: ArchViolation[];
+    rulesChecked: number;
+    filesTested: number;
+    passed: boolean;
+    summary: {
+        errors: number;
+        warnings: number;
+    };
+}
+/**
+ * Check architecture rules and detect violations.
+ * @param cwd - The working directory to scan.
+ * @param options - Configuration options.
+ * @param options.builtinRules - Whether to use built-in rules.
+ * @param options.directory - The directory to check.
+ * @param options.fileGlob - Glob pattern for files to check.
+ * @returns The architecture check result with any violations.
+ */
+export declare function checkArchitecture(cwd: string, options?: {
+    builtinRules?: boolean;
+    directory?: string;
+    fileGlob?: string;
+}): Promise<ArchResult>;
+//# sourceMappingURL=architecture.d.ts.map

package/dist/analyzers/architecture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../src/analyzers/architecture.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAgGD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E,OAAO,CAAC,UAAU,CAAC,CAmDrB"}

package/dist/analyzers/architecture.js

@@ -0,0 +1,149 @@
+/**
+ * Architecture Rule Enforcement
+ * Verify layer boundaries, dependency constraints, circular imports.
+ */
+import { listFiles } from '../search/fast-search.js';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+const BUILTIN_RULES = [
+    { name: 'no-circular-imports', type: 'no-circular', description: 'No circular import chains' },
+    {
+        name: 'controllers-no-direct-db',
+        type: 'no-import',
+        description: 'Controllers should not import from database layer',
+        source: '**/controllers/**',
+        forbidden: ['models', 'database', 'db/', 'repositories'],
+    },
+    {
+        name: 'utils-no-domain',
+        type: 'no-import',
+        description: 'Utils should not import domain logic',
+        source: '**/utils/**',
+        forbidden: ['services', 'controllers', 'routes', 'handlers'],
+    },
+];
+function matchGlob(p, pattern) {
+    const re = pattern.replace(/\*\*/g, '.*').replace(/\*/g, '[^/]*');
+    return new RegExp(re).test(p);
+}
+function parseFileImports(content) {
+    const imports = [];
+    const jsMatches = content.matchAll(/(?:import|from)\s+['"]([^'"]+)['"]/g);
+    for (const m of jsMatches)
+        imports.push(m[1]);
+    const pyMatches = content.matchAll(/(?:from\s+(\S+)\s+import|import\s+(\S+))/g);
+    for (const m of pyMatches)
+        imports.push(m[1] || m[2]);
+    return imports;
+}
+async function detectCircular(dir, files) {
+    const violations = [];
+    const graph = new Map();
+    for (const file of files.slice(0, 300)) {
+        try {
+            const content = await readFile(path.resolve(dir, file), 'utf-8');
+            const imports = parseFileImports(content)
+                .filter((i) => i.startsWith('.'))
+                .map((i) => path
+                .normalize(path.join(path.dirname(file), i))
+                .replace(/\\/g, '/')
+                .replace(/\.[^.]+$/, ''));
+            graph.set(file.replace(/\.[^.]+$/, ''), imports);
+        }
+        catch {
+            /* skip */
+        }
+    }
+    const visited = new Set();
+    const stack = new Set();
+    function dfs(node, trail) {
+        if (stack.has(node)) {
+            const idx = trail.indexOf(node);
+            if (idx >= 0) {
+                violations.push({
+                    rule: 'no-circular-imports',
+                    file: node,
+                    message: `Circular: ${trail.slice(idx).join(' → ')} → ${node}`,
+                    severity: 'error',
+                });
+            }
+            return;
+        }
+        if (visited.has(node))
+            return;
+        visited.add(node);
+        stack.add(node);
+        for (const dep of graph.get(node) || []) {
+            if (graph.has(dep))
+                dfs(dep, [...trail, node]);
+        }
+        stack.delete(node);
+    }
+    for (const node of graph.keys()) {
+        visited.clear();
+        stack.clear();
+        dfs(node, []);
+    }
+    return violations.slice(0, 20);
+}
+/**
+ * Check architecture rules and detect violations.
+ * @param cwd - The working directory to scan.
+ * @param options - Configuration options.
+ * @param options.builtinRules - Whether to use built-in rules.
+ * @param options.directory - The directory to check.
+ * @param options.fileGlob - Glob pattern for files to check.
+ * @returns The architecture check result with any violations.
+ */
+export async function checkArchitecture(cwd, options) {
+    const dir = path.resolve(cwd, options?.directory || '.');
+    const files = await listFiles(dir, { glob: options?.fileGlob || '**/*.{ts,tsx,js,jsx,py,java,go,rs}' });
+    const rules = options?.builtinRules !== false ? BUILTIN_RULES : [];
+    const violations = [];
+    for (const rule of rules) {
+        if (rule.type === 'no-circular') {
+            violations.push(...(await detectCircular(dir, files)));
+            continue;
+        }
+        if (rule.type === 'no-import' && rule.forbidden) {
+            for (const file of files.slice(0, 300)) {
+                if (rule.source && !matchGlob(file, rule.source))
+                    continue;
+                try {
+                    const content = await readFile(path.resolve(dir, file), 'utf-8');
+                    const imports = parseFileImports(content);
+                    const lines = content.split('\n');
+                    for (const imp of imports) {
+                        for (const fb of rule.forbidden) {
+                            if (imp.includes(fb)) {
+                                const line = lines.findIndex((l) => l.includes(imp)) + 1;
+                                violations.push({
+                                    rule: rule.name,
+                                    file,
+                                    line,
+                                    message: `${rule.description}: "${file}" imports "${imp}"`,
+                                    severity: 'error',
+                                    importPath: imp,
+                                });
+                            }
+                        }
+                    }
+                }
+                catch {
+                    /* skip */
+                }
+            }
+        }
+    }
+    return {
+        violations: violations.slice(0, 100),
+        rulesChecked: rules.length,
+        filesTested: Math.min(files.length, 300),
+        passed: violations.filter((v) => v.severity === 'error').length === 0,
+        summary: {
+            errors: violations.filter((v) => v.severity === 'error').length,
+            warnings: violations.filter((v) => v.severity === 'warning').length,
+        },
+    };
+}
+//# sourceMappingURL=architecture.js.map

package/dist/analyzers/architecture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.js","sourceRoot":"","sources":["../../src/analyzers/architecture.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AA4B7B,MAAM,aAAa,GAAe;IAChC,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,2BAA2B,EAAE;IAC9F;QACE,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,mDAAmD;QAChE,MAAM,EAAE,mBAAmB;QAC3B,SAAS,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,CAAC;KACzD;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,sCAAsC;QACnD,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC;KAC7D;CACF,CAAC;AAEF,SAAS,SAAS,CAAC,CAAS,EAAE,OAAe;IAC3C,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAClE,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,qCAAqC,CAAC,CAAC;IAC1E,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,2CAA2C,CAAC,CAAC;IAChF,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,KAAe;IACxD,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACjE,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC;iBACtC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;iBAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,IAAI;iBACD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;iBAC3C,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;iBACnB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAC3B,CAAC;YACJ,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,UAAU;QACZ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,SAAS,GAAG,CAAC,IAAY,EAAE,KAAe;QACxC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;gBACb,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,qBAAqB;oBAC3B,IAAI,EAAE,IAAI;oBACV,OAAO,EAAE,aAAa,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE;oBAC9D,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;YACL,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC9B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACxC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAW,EACX,OAA2E;IAE3E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,IAAI,GAAG,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,IAAI,oCAAoC,EAAE,CAAC,CAAC;IACxG,MAAM,KAAK,GAAG,OAAO,EAAE,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,UAAU,GAAoB,EAAE,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAChC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;YACvD,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;gBACvC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;oBAAE,SAAS;gBAC3D,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;oBACjE,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;oBAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAClC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;wBAC1B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAU,EAAE,CAAC;4BACjC,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gCACrB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;gCACzD,UAAU,CAAC,IAAI,CAAC;oCACd,IAAI,EAAE,IAAI,CAAC,IAAI;oCACf,IAAI;oCACJ,IAAI;oCACJ,OAAO,EAAE,GAAG,IAAI,CAAC,WAAW,MAAM,IAAI,cAAc,GAAG,GAAG;oCAC1D,QAAQ,EAAE,OAAO;oCACjB,UAAU,EAAE,GAAG;iCAChB,CAAC,CAAC;4BACL,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,UAAU;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACpC,YAAY,EAAE,KAAK,CAAC,MAAM;QAC1B,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC;QACxC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;QACrE,OAAO,EAAE;YACP,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;YAC/D,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM;SACpE;KACF,CAAC;AACJ,CAAC"}

package/dist/analyzers/branch-compare.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Branch Compare
+ * Structural diff between two git branches — new files, changed symbols,
+ * removed exports, stats summary.
+ */
+export interface BranchCompareResult {
+    base: string;
+    compare: string;
+    stats: {
+        filesAdded: number;
+        filesModified: number;
+        filesDeleted: number;
+        filesRenamed: number;
+        totalChanges: number;
+    };
+    added: string[];
+    modified: string[];
+    deleted: string[];
+    renamed: {
+        from: string;
+        to: string;
+    }[];
+    diffStat: {
+        file: string;
+        insertions: number;
+        deletions: number;
+    }[];
+    commitsBehind: number;
+    commitsAhead: number;
+    conflictFiles: string[];
+}
+/**
+ * Compare two git branches and return structural diff information.
+ * @param cwd - The working directory of the git repository.
+ * @param base - The base branch name.
+ * @param compare - The comparison branch name.
+ * @param options - Configuration options.
+ * @param options.includeStats - Whether to include diff stats.
+ * @param options.showConflicts - Whether to detect potential merge conflicts.
+ * @returns The branch comparison result.
+ */
+export declare function compareBranches(cwd: string, base: string, compare?: string, options?: {
+    includeStats?: boolean;
+    showConflicts?: boolean;
+}): Promise<BranchCompareResult>;
+//# sourceMappingURL=branch-compare.d.ts.map

package/dist/analyzers/branch-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-compare.d.ts","sourceRoot":"","sources":["../../src/analyzers/branch-compare.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5D,OAAO,CAAC,mBAAmB,CAAC,CAiH9B"}