0xray 4.0.13 → 4.0.15

package/dist/delegation/codebase-context-analyzer.js

@@ -0,0 +1,1040 @@
+import * as fs from "fs";
+import * as path from "path";
+import { frameworkLogger } from "../core/framework-logger.js";
+export class CodebaseContextAnalyzer {
+    projectRoot;
+    memoryConfig;
+    analysisCache = new Map();
+    ignorePatterns = [
+        /node_modules/,
+        /\.git/,
+        /dist/,
+        /build/,
+        /\.next/,
+        /\.nuxt/,
+        /\.vuepress/,
+        /\.cache/,
+        /\.temp/,
+        /coverage/,
+        /\.nyc_output/,
+        /logs/,
+        /\.DS_Store/,
+        /Thumbs\.db/,
+    ];
+    supportedLanguages = {
+        ".ts": "typescript",
+        ".tsx": "typescript",
+        ".js": "javascript",
+        ".jsx": "javascript",
+        ".py": "python",
+        ".java": "java",
+        ".cpp": "cpp",
+        ".c": "c",
+        ".cs": "csharp",
+        ".php": "php",
+        ".rb": "ruby",
+        ".go": "go",
+        ".rs": "rust",
+        ".swift": "swift",
+        ".kt": "kotlin",
+        ".scala": "scala",
+        ".clj": "clojure",
+        ".hs": "haskell",
+        ".ml": "ocaml",
+        ".fs": "fsharp",
+        ".elm": "elm",
+        ".dart": "dart",
+        ".vue": "vue",
+        ".svelte": "svelte",
+        ".astro": "astro",
+    };
+    constructor(projectRoot, memoryConfig) {
+        this.projectRoot = projectRoot || process.cwd();
+        // Default memory configuration for performance optimization
+        this.memoryConfig = {
+            maxFilesInMemory: 100, // Process max 100 files simultaneously
+            maxFileSizeBytes: 1024 * 1024, // 1MB max file size to load
+            enableStreaming: true, // Enable streaming for large files
+            batchSize: 20, // Process 20 files per batch
+            enableCaching: true, // Enable result caching
+            cacheTtlMs: 5 * 60 * 1000, // 5 minute cache TTL
+            enableConcurrentProcessing: true, // Enable concurrent processing
+            concurrencyLimit: 10, // Max 10 concurrent file operations
+            ...memoryConfig, // Override with user config
+        };
+    }
+    /**
+     * Perform comprehensive codebase analysis with memory optimization
+     */
+    async analyzeCodebase() {
+        const jobId = `codebase-analysis-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+        await frameworkLogger.log("codebase-context-analyzer", "analysis-start", "info", {
+            jobId,
+            message: "Starting comprehensive codebase analysis",
+            memoryConfig: this.memoryConfig,
+        });
+        const startTime = Date.now();
+        const initialMemoryUsage = process.memoryUsage().heapUsed;
+        try {
+            const structure = await this.buildCodebaseStructure(jobId);
+            const metrics = this.calculateContextMetrics(structure);
+            const insights = this.generateInsights(structure, metrics);
+            const recommendations = this.generateRecommendations(structure, metrics);
+            const risks = this.identifyRisks(structure, metrics);
+            const analysis = {
+                structure,
+                metrics,
+                insights,
+                recommendations,
+                risks,
+                scannedAt: new Date(),
+            };
+            const endTime = Date.now();
+            const finalMemoryUsage = process.memoryUsage().heapUsed;
+            const memoryDelta = finalMemoryUsage - initialMemoryUsage;
+            await frameworkLogger.log("codebase-context-analyzer", "analysis-complete", "success", {
+                jobId,
+                files: structure.totalFiles,
+                loc: structure.totalLinesOfCode,
+                languages: Array.from(structure.languages.keys()),
+                qualityScore: metrics.qualityScore,
+                duration: endTime - startTime,
+                memoryDeltaMB: Math.round((memoryDelta / 1024 / 1024) * 100) / 100,
+                cacheHits: this.analysisCache.size,
+            });
+            return analysis;
+        }
+        catch (error) {
+            const endTime = Date.now();
+            const finalMemoryUsage = process.memoryUsage().heapUsed;
+            await frameworkLogger.log("codebase-context-analyzer", "analysis-failed", "error", {
+                jobId,
+                error: error instanceof Error ? error.message : String(error),
+                duration: endTime - startTime,
+                finalMemoryMB: Math.round((finalMemoryUsage / 1024 / 1024) * 100) / 100,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Get cached analysis result with intelligent invalidation
+     */
+    getCachedAnalysis(cacheKey) {
+        if (!this.memoryConfig.enableCaching)
+            return null;
+        const cached = this.analysisCache.get(cacheKey);
+        if (!cached)
+            return null;
+        // Check TTL
+        if (Date.now() - cached.timestamp > this.memoryConfig.cacheTtlMs) {
+            this.analysisCache.delete(cacheKey);
+            return null;
+        }
+        // Intelligent cache validation - check if file still exists and hasn't changed
+        const filePath = this.extractFilePathFromCacheKey(cacheKey);
+        if (filePath) {
+            try {
+                const currentStats = fs.statSync(filePath);
+                const cachedMtime = cached.lastModified?.getTime() || 0;
+                if (currentStats.mtime.getTime() !== cachedMtime) {
+                    // File has changed, invalidate cache
+                    this.analysisCache.delete(cacheKey);
+                    return null;
+                }
+            }
+            catch (error) {
+                // File no longer exists or inaccessible, remove from cache
+                this.analysisCache.delete(cacheKey);
+                return null;
+            }
+        }
+        return cached;
+    }
+    /**
+     * Set cached analysis result with size limits
+     */
+    setCachedAnalysis(cacheKey, data) {
+        if (!this.memoryConfig.enableCaching)
+            return;
+        // Prevent cache from growing too large (keep last 1000 entries)
+        if (this.analysisCache.size >= 1000) {
+            const oldestKey = Array.from(this.analysisCache.keys())[0];
+            if (oldestKey) {
+                this.analysisCache.delete(oldestKey);
+            }
+        }
+        this.analysisCache.set(cacheKey, {
+            ...data,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Extract file path from cache key for validation
+     */
+    extractFilePathFromCacheKey(cacheKey) {
+        const match = cacheKey.match(/^file:(.+?:\d+)$/);
+        if (match && match[1]) {
+            const parts = match[1].split(":");
+            return parts[0] || null;
+        }
+        return null;
+    }
+    /**
+     * Stream file content for large files to reduce memory usage
+     */
+    async streamFileContent(filePath) {
+        return new Promise((resolve, reject) => {
+            let content = "";
+            const stream = fs.createReadStream(filePath, { encoding: "utf8" });
+            stream.on("data", (chunk) => {
+                content += chunk;
+                // Prevent excessive memory usage during streaming
+                if (content.length > this.memoryConfig.maxFileSizeBytes) {
+                    stream.destroy();
+                    reject(new Error("File too large for streaming"));
+                }
+            });
+            stream.on("end", () => resolve(content));
+            stream.on("error", reject);
+        });
+    }
+    /**
+     * Build complete codebase structure map with batching for memory efficiency
+     */
+    async buildCodebaseStructure(jobId) {
+        const fileGraph = new Map();
+        const modules = new Map();
+        const dependencyGraph = new Map();
+        const languages = new Map();
+        const scanDirectory = async (dirPath, relativePath = "") => {
+            try {
+                const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+                // Process files in batches to control memory usage
+                const fileEntries = [];
+                const dirEntries = [];
+                // Separate files and directories for batch processing
+                for (const entry of entries) {
+                    const entryPath = path.join(dirPath, entry.name);
+                    const entryRelativePath = path.join(relativePath, entry.name);
+                    // Skip ignored patterns
+                    if (this.ignorePatterns.some((pattern) => pattern.test(entryPath))) {
+                        continue;
+                    }
+                    if (entry.isDirectory()) {
+                        const isModule = this.isModuleDirectory(entryPath);
+                        dirEntries.push({
+                            path: entryPath,
+                            relativePath: entryRelativePath,
+                            isModule,
+                        });
+                    }
+                    else if (entry.isFile()) {
+                        fileEntries.push({
+                            path: entryPath,
+                            relativePath: entryRelativePath,
+                        });
+                    }
+                }
+                // Process directories first (may contain modules)
+                for (const dirEntry of dirEntries) {
+                    if (dirEntry.isModule) {
+                        const moduleInfo = await this.analyzeModule(dirEntry.path, dirEntry.relativePath, jobId);
+                        modules.set(dirEntry.relativePath, moduleInfo);
+                    }
+                    else {
+                        await scanDirectory(dirEntry.path, dirEntry.relativePath);
+                    }
+                }
+                // Process files with concurrent processing for better performance
+                const concurrencyLimit = this.memoryConfig.enableConcurrentProcessing
+                    ? Math.min(this.memoryConfig.concurrencyLimit || 10, this.memoryConfig.maxFilesInMemory)
+                    : 1; // Sequential processing if concurrent disabled
+                for (let i = 0; i < fileEntries.length; i += concurrencyLimit) {
+                    const batch = fileEntries.slice(i, i + concurrencyLimit);
+                    // Process batch concurrently with controlled parallelism
+                    const batchPromises = batch.map(async ({ path: filePath, relativePath: fileRelativePath }) => {
+                        try {
+                            const fileInfo = await this.analyzeFile(filePath, fileRelativePath, jobId);
+                            if (fileInfo) {
+                                fileGraph.set(fileRelativePath, fileInfo);
+                                // Update language counts
+                                const lang = fileInfo.language;
+                                languages.set(lang, (languages.get(lang) || 0) + 1);
+                            }
+                        }
+                        catch (error) {
+                            await frameworkLogger.log("codebase-context-analyzer", "batch-file-processing-error", "info", {
+                                jobId,
+                                filePath,
+                                error: error instanceof Error ? error.message : String(error),
+                            });
+                        }
+                    });
+                    await Promise.all(batchPromises);
+                    // Yield control periodically to prevent blocking the event loop
+                    if (i + concurrencyLimit < fileEntries.length) {
+                        await new Promise((resolve) => setImmediate(resolve));
+                    }
+                }
+            }
+            catch (error) {
+                await frameworkLogger.log("codebase-context-analyzer", "scan-directory-failed", "error", {
+                    jobId,
+                    dirPath,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        };
+        await scanDirectory(this.projectRoot);
+        // Build dependency relationships
+        await this.buildDependencyGraph(fileGraph, dependencyGraph);
+        const architecture = this.detectArchitecture(fileGraph, modules);
+        return {
+            rootPath: this.projectRoot,
+            totalFiles: fileGraph.size,
+            totalLinesOfCode: Array.from(fileGraph.values()).reduce((sum, file) => sum + file.linesOfCode, 0),
+            languages,
+            modules,
+            fileGraph,
+            dependencyGraph,
+            architecture,
+        };
+    }
+    /**
+     * Analyze individual file for structure and dependencies with memory optimization
+     */
+    async analyzeFile(filePath, relativePath, jobId) {
+        try {
+            const stats = fs.statSync(filePath);
+            const extension = path.extname(filePath).toLowerCase();
+            const language = this.supportedLanguages[extension] || "other";
+            const isSourceCode = language !== "other";
+            if (!isSourceCode && !this.isConfigFile(relativePath)) {
+                return null;
+            }
+            // Memory optimization: Check file size before loading
+            if (stats.size > this.memoryConfig.maxFileSizeBytes) {
+                await frameworkLogger.log("codebase-context-analyzer", "large-file-skipped", "info", {
+                    jobId,
+                    filePath,
+                    size: stats.size,
+                    maxSize: this.memoryConfig.maxFileSizeBytes,
+                });
+                // For large files, analyze metadata only (no content loading)
+                return {
+                    path: filePath,
+                    relativePath,
+                    size: stats.size,
+                    extension,
+                    language,
+                    isSourceCode,
+                    linesOfCode: Math.floor(stats.size / 50), // Rough estimate
+                    imports: [],
+                    exports: [],
+                    dependencies: [],
+                    lastModified: stats.mtime,
+                };
+            }
+            // Lazy load content only when needed and within memory limits
+            let content;
+            let linesOfCode = 0;
+            let imports = [];
+            let exports = [];
+            try {
+                // Check cache first for performance
+                const cacheKey = `file:${relativePath}:${stats.mtime.getTime()}`;
+                const cached = this.getCachedAnalysis(cacheKey);
+                if (cached) {
+                    return {
+                        path: filePath,
+                        relativePath,
+                        size: stats.size,
+                        extension,
+                        language,
+                        isSourceCode,
+                        linesOfCode: cached.linesOfCode,
+                        imports: cached.imports,
+                        exports: cached.exports,
+                        dependencies: cached.imports,
+                        lastModified: stats.mtime,
+                        content: cached.content ?? undefined,
+                    };
+                }
+                // Load content with streaming for large files if enabled
+                content =
+                    this.memoryConfig.enableStreaming && stats.size > 100 * 1024
+                        ? await this.streamFileContent(filePath)
+                        : fs.readFileSync(filePath, "utf8");
+                linesOfCode = content.split("\n").length;
+                const importExportData = await this.extractImportsExports(content, language, jobId);
+                imports = importExportData.imports;
+                exports = importExportData.exports;
+                // Cache the analysis result
+                if (this.memoryConfig.enableCaching) {
+                    this.setCachedAnalysis(cacheKey, {
+                        linesOfCode,
+                        imports,
+                        exports,
+                        content,
+                        timestamp: Date.now(),
+                    });
+                }
+            }
+            catch (contentError) {
+                await frameworkLogger.log("codebase-context-analyzer", "content-loading-failed", "info", {
+                    jobId,
+                    filePath,
+                    error: contentError instanceof Error
+                        ? contentError.message
+                        : String(contentError),
+                });
+                // Continue with metadata-only analysis
+            }
+            const result = {
+                path: filePath,
+                relativePath,
+                size: stats.size,
+                extension,
+                language,
+                isSourceCode,
+                linesOfCode,
+                imports,
+                exports,
+                dependencies: imports, // For now, imports are dependencies
+                lastModified: stats.mtime,
+            };
+            // Only set content if it was successfully loaded
+            if (content !== undefined) {
+                result.content = content;
+            }
+            return result;
+        }
+        catch (error) {
+            await frameworkLogger.log("codebase-context-analyzer", "file-analysis-failed", "error", {
+                jobId,
+                filePath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    }
+    /**
+     * Analyze module directory structure
+     */
+    async analyzeModule(dirPath, relativePath, jobId) {
+        const files = [];
+        const dependencies = new Set();
+        const dependents = new Set();
+        const scanModuleFiles = async (modulePath, moduleRelativePath) => {
+            try {
+                const entries = fs.readdirSync(modulePath, { withFileTypes: true });
+                for (const entry of entries) {
+                    const entryPath = path.join(modulePath, entry.name);
+                    const entryRelativePath = path.join(moduleRelativePath, entry.name);
+                    if (entry.isFile()) {
+                        const fileInfo = await this.analyzeFile(entryPath, entryRelativePath, jobId);
+                        if (fileInfo) {
+                            files.push(fileInfo);
+                            fileInfo.imports.forEach((dep) => dependencies.add(dep));
+                            fileInfo.exports.forEach((exp) => dependents.add(exp));
+                        }
+                    }
+                    else if (entry.isDirectory() &&
+                        !this.ignorePatterns.some((pattern) => pattern.test(entry.name))) {
+                        await scanModuleFiles(entryPath, entryRelativePath);
+                    }
+                }
+            }
+            catch (error) {
+                await frameworkLogger.log("codebase-context-analyzer", "module-scan-failed", "error", {
+                    jobId,
+                    modulePath,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        };
+        await scanModuleFiles(dirPath, relativePath);
+        // Determine module type
+        const moduleType = this.classifyModule(relativePath, files);
+        // Find entry point
+        const entryPoint = this.findEntryPoint(files);
+        return {
+            name: path.basename(relativePath),
+            path: dirPath,
+            files,
+            entryPoint,
+            dependencies: Array.from(dependencies),
+            dependents: Array.from(dependents),
+            type: moduleType,
+        };
+    }
+    /**
+     * Extract imports and exports from source code
+     */
+    async extractImportsExports(content, language, jobId) {
+        const imports = [];
+        const exports = [];
+        try {
+            switch (language) {
+                case "typescript":
+                case "javascript":
+                    return this.extractJsTsImportsExports(content);
+                case "python":
+                    return this.extractPythonImportsExports(content);
+                case "java":
+                    return this.extractJavaImportsExports(content);
+                default:
+                    return { imports: [], exports: [] };
+            }
+        }
+        catch (error) {
+            await frameworkLogger.log("codebase-context-analyzer", "import-export-extraction-failed", "error", {
+                jobId,
+                language,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return { imports: [], exports: [] };
+        }
+    }
+    extractJsTsImportsExports(content) {
+        const imports = [];
+        const exports = [];
+        // Import patterns
+        const importPatterns = [
+            /import\s+.*?\s+from\s+['"]([^'"]+)['"]/g,
+            /import\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
+            /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
+        ];
+        importPatterns.forEach((pattern) => {
+            let match;
+            while ((match = pattern.exec(content)) !== null) {
+                if (match[1]) {
+                    imports.push(match[1]);
+                }
+            }
+        });
+        // Export patterns
+        const exportPatterns = [
+            /export\s+(?:const|let|var|function|class|interface|type)\s+(\w+)/g,
+            /export\s+{\s*([^}]+)\s*}/g,
+            /export\s+default/g,
+        ];
+        exportPatterns.forEach((pattern) => {
+            let match;
+            while ((match = pattern.exec(content)) !== null) {
+                if (match[1]) {
+                    const exportsList = match[1]
+                        .split(",")
+                        .map((e) => {
+                        const trimmed = e.trim();
+                        const asSplit = trimmed.split(" as ");
+                        return asSplit[0] || trimmed;
+                    })
+                        .filter(Boolean);
+                    exports.push(...exportsList);
+                }
+                else {
+                    exports.push("default");
+                }
+            }
+        });
+        return {
+            imports: Array.from(new Set(imports)),
+            exports: Array.from(new Set(exports)),
+        };
+    }
+    extractPythonImportsExports(content) {
+        const imports = [];
+        const exports = [];
+        // Import patterns
+        const importPatterns = [/from\s+([^\s]+)\s+import/g, /import\s+([^\s]+)/g];
+        importPatterns.forEach((pattern) => {
+            let match;
+            while ((match = pattern.exec(content)) !== null) {
+                if (match[1]) {
+                    imports.push(match[1]);
+                }
+            }
+        });
+        // Export patterns (Python doesn't have explicit exports, but __all__ can indicate public API)
+        const allMatch = content.match(/__all__\s*=\s*\[([^\]]+)\]/);
+        if (allMatch && allMatch[1]) {
+            const exportsList = allMatch[1]
+                .split(",")
+                .map((e) => e.trim().replace(/['"]/g, ""))
+                .filter(Boolean);
+            exports.push(...exportsList);
+        }
+        return {
+            imports: Array.from(new Set(imports)),
+            exports: Array.from(new Set(exports)),
+        };
+    }
+    extractJavaImportsExports(content) {
+        const imports = [];
+        const exports = [];
+        // Import patterns
+        const importPattern = /^import\s+([^;]+);/gm;
+        let match;
+        while ((match = importPattern.exec(content)) !== null) {
+            if (match[1]) {
+                imports.push(match[1]);
+            }
+        }
+        // Export patterns (public classes/interfaces)
+        const exportPattern = /(?:public\s+)?(?:class|interface|enum)\s+(\w+)/g;
+        while ((match = exportPattern.exec(content)) !== null) {
+            if (match[1]) {
+                exports.push(match[1]);
+            }
+        }
+        return {
+            imports: Array.from(new Set(imports)),
+            exports: Array.from(new Set(exports)),
+        };
+    }
+    /**
+     * Build dependency graph between files
+     */
+    async buildDependencyGraph(fileGraph, dependencyGraph) {
+        for (const [filePath, fileInfo] of Array.from(fileGraph)) {
+            const dependencies = new Set();
+            for (const importPath of fileInfo.imports) {
+                // Resolve relative imports
+                if (importPath.startsWith("./") || importPath.startsWith("../")) {
+                    try {
+                        const resolvedPath = path.resolve(path.dirname(fileInfo.path), importPath);
+                        const resolvedRelative = path.relative(this.projectRoot, resolvedPath);
+                        // Check for file extensions
+                        const possibleExtensions = [
+                            "",
+                            ".ts",
+                            ".tsx",
+                            ".js",
+                            ".jsx",
+                            ".py",
+                            ".java",
+                        ];
+                        let foundFile = null;
+                        for (const ext of possibleExtensions) {
+                            const testPath = resolvedRelative + ext;
+                            if (fileGraph.has(testPath) ||
+                                fs.existsSync(path.join(this.projectRoot, testPath))) {
+                                foundFile = testPath;
+                                break;
+                            }
+                        }
+                        if (foundFile) {
+                            dependencies.add(foundFile);
+                        }
+                    }
+                    catch (error) {
+                        // Import resolution failed, skip
+                    }
+                }
+                else {
+                    // External dependency, add to graph for tracking
+                    dependencies.add(importPath);
+                }
+            }
+            dependencyGraph.set(filePath, dependencies);
+        }
+    }
+    /**
+     * Detect architectural patterns and framework usage
+     */
+    detectArchitecture(fileGraph, modules) {
+        const frameworks = [];
+        const patterns = [];
+        let structure = "monolithic";
+        const entryPoints = [];
+        // Framework detection
+        if (this.hasFramework(fileGraph, "react"))
+            frameworks.push("React");
+        if (this.hasFramework(fileGraph, "vue"))
+            frameworks.push("Vue.js");
+        if (this.hasFramework(fileGraph, "angular"))
+            frameworks.push("Angular");
+        if (this.hasFramework(fileGraph, "svelte"))
+            frameworks.push("Svelte");
+        if (this.hasFramework(fileGraph, "express"))
+            frameworks.push("Express.js");
+        if (this.hasFramework(fileGraph, "nestjs"))
+            frameworks.push("NestJS");
+        if (this.hasFramework(fileGraph, "nextjs"))
+            frameworks.push("Next.js");
+        if (this.hasFramework(fileGraph, "nuxt"))
+            frameworks.push("Nuxt.js");
+        // Pattern detection
+        if (this.detectMVCPattern(fileGraph))
+            patterns.push("MVC");
+        if (this.detectRepositoryPattern(fileGraph))
+            patterns.push("Repository");
+        if (this.detectObserverPattern(fileGraph))
+            patterns.push("Observer");
+        if (this.detectFactoryPattern(fileGraph))
+            patterns.push("Factory");
+        // Structure detection
+        if (modules.size > 5 && this.hasMicroservicesIndicators(fileGraph)) {
+            structure = "microservices";
+        }
+        else if (modules.size > 0) {
+            structure = "modular";
+        }
+        // Entry points detection
+        for (const [filePath, fileInfo] of Array.from(fileGraph)) {
+            if (this.isEntryPoint(filePath, fileInfo)) {
+                entryPoints.push(filePath);
+            }
+        }
+        return {
+            framework: frameworks,
+            patterns,
+            structure,
+            entryPoints,
+        };
+    }
+    /**
+     * Calculate comprehensive context metrics
+     */
+    calculateContextMetrics(structure) {
+        const fileCount = structure.totalFiles;
+        const linesOfCode = structure.totalLinesOfCode;
+        const languages = Array.from(structure.languages.keys());
+        // Calculate complexity based on various factors
+        const complexity = this.calculateComplexityScore(structure);
+        // Calculate coupling (interdependencies)
+        const coupling = this.calculateCouplingScore(structure);
+        // Calculate cohesion (internal dependencies within modules)
+        const cohesion = this.calculateCohesionScore(structure);
+        // Estimate test coverage (rough heuristic)
+        const testCoverage = this.estimateTestCoverage(structure);
+        // Architectural patterns
+        const architecturalPatterns = structure.architecture.patterns;
+        // Overall quality score
+        const qualityScore = this.calculateQualityScore({
+            fileCount,
+            linesOfCode,
+            complexity,
+            coupling,
+            cohesion,
+            testCoverage,
+            patterns: architecturalPatterns.length,
+        });
+        return {
+            fileCount,
+            linesOfCode,
+            languages,
+            complexity,
+            coupling,
+            cohesion,
+            testCoverage,
+            architecturalPatterns,
+            qualityScore,
+        };
+    }
+    calculateComplexityScore(structure) {
+        let score = 0;
+        // File count factor
+        score += Math.min(structure.totalFiles / 10, 20);
+        // Language diversity factor
+        score += Math.min(structure.languages.size * 5, 15);
+        // Module complexity
+        score += Math.min(structure.modules.size * 2, 20);
+        // Dependency complexity
+        const totalDeps = Array.from(structure.dependencyGraph.values()).reduce((sum, deps) => sum + deps.size, 0);
+        score += Math.min(totalDeps / 20, 25);
+        // Framework complexity
+        score += Math.min(structure.architecture.framework.length * 10, 20);
+        return Math.min(Math.max(score, 0), 100);
+    }
+    calculateCouplingScore(structure) {
+        const totalDeps = Array.from(structure.dependencyGraph.values()).reduce((sum, deps) => sum + deps.size, 0);
+        const avgDeps = totalDeps / structure.totalFiles;
+        // Normalize to 0-100 scale (higher coupling = higher score)
+        return Math.min(avgDeps * 20, 100);
+    }
+    calculateCohesionScore(structure) {
+        let totalCohesion = 0;
+        let moduleCount = 0;
+        for (const module of Array.from(structure.modules.values())) {
+            if (module.files.length > 1) {
+                // Calculate internal dependencies within module
+                const internalDeps = module.files.reduce((sum, file) => {
+                    const fileDeps = structure.dependencyGraph.get(file.relativePath) || new Set();
+                    const internalCount = Array.from(fileDeps).filter((dep) => module.files.some((f) => f.relativePath === dep)).length;
+                    return sum + internalCount;
+                }, 0);
+                const cohesion = internalDeps / (module.files.length * (module.files.length - 1));
+                totalCohesion += Math.min(cohesion, 1);
+                moduleCount++;
+            }
+        }
+        return moduleCount > 0 ? (totalCohesion / moduleCount) * 100 : 50;
+    }
+    estimateTestCoverage(structure) {
+        const testFiles = Array.from(structure.fileGraph.values()).filter((file) => file.relativePath.includes("test") ||
+            file.relativePath.includes("spec")).length;
+        const srcFiles = Array.from(structure.fileGraph.values()).filter((file) => file.isSourceCode &&
+            !file.relativePath.includes("test") &&
+            !file.relativePath.includes("spec")).length;
+        if (srcFiles === 0)
+            return 0;
+        // Rough heuristic: assume 1 test file covers 3-5 source files
+        const estimatedCoverage = Math.min(((testFiles * 4) / srcFiles) * 100, 100);
+        return Math.round(estimatedCoverage);
+    }
+    calculateQualityScore(metrics) {
+        // Weighted scoring system
+        const weights = {
+            complexity: -0.2, // Lower complexity is better
+            coupling: -0.25, // Lower coupling is better
+            cohesion: 0.2, // Higher cohesion is better
+            testCoverage: 0.25, // Higher coverage is better
+            patterns: 0.1, // More patterns is better
+        };
+        let score = 50; // Base score
+        score += weights.complexity * Math.min(metrics.complexity, 50);
+        score += weights.coupling * (100 - metrics.coupling);
+        score += weights.cohesion * metrics.cohesion;
+        score += weights.testCoverage * metrics.testCoverage;
+        score += weights.patterns * Math.min(metrics.patterns * 10, 20);
+        return Math.min(Math.max(Math.round(score), 0), 100);
+    }
+    /**
+     * Generate insights based on analysis
+     */
+    generateInsights(structure, metrics) {
+        const insights = [];
+        // Size insights
+        if (structure.totalFiles > 1000) {
+            insights.push(`Large codebase with ${structure.totalFiles} files - consider modularization`);
+        }
+        else if (structure.totalFiles < 10) {
+            insights.push("Small codebase - good candidate for rapid development");
+        }
+        // Language insights
+        if (structure.languages.size > 3) {
+            insights.push(`Polyglot codebase with ${structure.languages.size} languages`);
+        }
+        else if (structure.languages.size === 1) {
+            insights.push("Single-language codebase - easier maintenance but potential skill limitations");
+        }
+        // Architecture insights
+        if (structure.architecture.framework.length > 0) {
+            insights.push(`Uses ${structure.architecture.framework.join(", ")} framework(s)`);
+        }
+        if (structure.architecture.patterns.length > 0) {
+            insights.push(`Follows ${structure.architecture.patterns.join(", ")} architectural pattern(s)`);
+        }
+        // Quality insights
+        if (metrics.qualityScore > 80) {
+            insights.push("High-quality codebase with strong architectural foundations");
+        }
+        else if (metrics.qualityScore < 40) {
+            insights.push("Codebase may benefit from refactoring and quality improvements");
+        }
+        if (metrics.testCoverage > 80) {
+            insights.push("Excellent test coverage provides strong confidence in changes");
+        }
+        else if (metrics.testCoverage < 20) {
+            insights.push("Low test coverage increases risk of undetected regressions");
+        }
+        return insights;
+    }
+    /**
+     * Generate recommendations for improvement
+     */
+    generateRecommendations(structure, metrics) {
+        const recommendations = [];
+        if (metrics.testCoverage < 70) {
+            recommendations.push("Increase test coverage to reduce regression risk");
+        }
+        if (metrics.coupling > 70) {
+            recommendations.push("Reduce coupling through better separation of concerns");
+        }
+        if (metrics.cohesion < 30) {
+            recommendations.push("Improve cohesion by grouping related functionality");
+        }
+        if (structure.modules.size === 0 && structure.totalFiles > 50) {
+            recommendations.push("Consider modularizing the codebase for better maintainability");
+        }
+        if (structure.architecture.framework.length === 0 &&
+            structure.totalFiles > 20) {
+            recommendations.push("Consider adopting a framework to standardize development patterns");
+        }
+        if (metrics.complexity > 80) {
+            recommendations.push("Consider breaking down complex components into smaller, focused units");
+        }
+        return recommendations;
+    }
+    /**
+     * Identify potential risks and issues
+     */
+    identifyRisks(structure, metrics) {
+        const risks = [];
+        if (metrics.coupling > 80) {
+            risks.push("High coupling increases change risk and maintenance complexity");
+        }
+        if (metrics.testCoverage < 30) {
+            risks.push("Low test coverage poses significant risk for safe refactoring");
+        }
+        if (structure.dependencyGraph.size > 0) {
+            // Check for circular dependencies (simplified check)
+            const circularDeps = this.detectCircularDependencies(structure.dependencyGraph);
+            if (circularDeps.length > 0) {
+                risks.push(`${circularDeps.length} potential circular dependencies detected`);
+            }
+        }
+        if (structure.languages.size > 5) {
+            risks.push("High language diversity may complicate team composition and maintenance");
+        }
+        if (metrics.complexity > 90) {
+            risks.push("Very high complexity indicates potential maintainability issues");
+        }
+        return risks;
+    }
+    // Helper methods
+    isModuleDirectory(dirPath) {
+        try {
+            const entries = fs.readdirSync(dirPath);
+            return (entries.some((entry) => {
+                const ext = path.extname(entry);
+                return this.supportedLanguages[ext];
+            }) &&
+                entries.some((entry) => entry === "package.json" ||
+                    entry === "index.ts" ||
+                    entry === "index.js"));
+        }
+        catch {
+            return false;
+        }
+    }
+    isConfigFile(filePath) {
+        const configPatterns = [
+            /package\.json$/,
+            /tsconfig\.json$/,
+            /webpack\.config\./,
+            /\.eslintrc/,
+            /\.prettierrc/,
+            /Dockerfile/,
+            /docker-compose\.yml/,
+            /\.env/,
+        ];
+        return configPatterns.some((pattern) => pattern.test(filePath));
+    }
+    classifyModule(relativePath, files) {
+        if (relativePath.includes("test") || relativePath.includes("spec")) {
+            return "test";
+        }
+        if (relativePath.includes("docs") ||
+            files.some((f) => f.extension === ".md")) {
+            return "docs";
+        }
+        if (files.some((f) => ["package.json", "Dockerfile", "docker-compose.yml"].includes(path.basename(f.relativePath)))) {
+            return "infrastructure";
+        }
+        if (files.some((f) => f.relativePath.includes("config") || f.relativePath.includes(".env"))) {
+            return "config";
+        }
+        return "source";
+    }
+    findEntryPoint(files) {
+        const entryCandidates = [
+            "index.ts",
+            "index.js",
+            "main.ts",
+            "main.js",
+            "app.ts",
+            "app.js",
+        ];
+        for (const candidate of entryCandidates) {
+            const file = files.find((f) => path.basename(f.relativePath) === candidate);
+            if (file)
+                return file.relativePath;
+        }
+        // Fallback to first source file
+        const sourceFile = files.find((f) => f.isSourceCode);
+        return sourceFile?.relativePath;
+    }
+    hasFramework(fileGraph, framework) {
+        for (const file of Array.from(fileGraph.values())) {
+            if (file.content?.toLowerCase().includes(framework.toLowerCase())) {
+                return true;
+            }
+        }
+        return false;
+    }
+    detectMVCPattern(fileGraph) {
+        const hasControllers = Array.from(fileGraph.keys()).some((path) => path.includes("controller"));
+        const hasModels = Array.from(fileGraph.keys()).some((path) => path.includes("model"));
+        const hasViews = Array.from(fileGraph.keys()).some((path) => path.includes("view"));
+        return hasControllers && hasModels && hasViews;
+    }
+    detectRepositoryPattern(fileGraph) {
+        return Array.from(fileGraph.keys()).some((path) => path.includes("repository"));
+    }
+    detectObserverPattern(fileGraph) {
+        return Array.from(fileGraph.values()).some((file) => file.content?.includes("subscribe") ||
+            file.content?.includes("observe"));
+    }
+    detectFactoryPattern(fileGraph) {
+        return Array.from(fileGraph.keys()).some((path) => path.includes("factory"));
+    }
+    hasMicroservicesIndicators(fileGraph) {
+        return Array.from(fileGraph.keys()).some((path) => path.includes("docker") ||
+            path.includes("kubernetes") ||
+            path.includes("service"));
+    }
+    isEntryPoint(filePath, fileInfo) {
+        const entryIndicators = [
+            "index.ts",
+            "index.js",
+            "main.ts",
+            "main.js",
+            "app.ts",
+            "app.js",
+            "server.ts",
+            "server.js",
+            "cli.ts",
+            "cli.js",
+        ];
+        return (entryIndicators.includes(path.basename(filePath)) ||
+            Boolean(fileInfo.content?.includes("#!/usr/bin/env")) ||
+            Boolean(fileInfo.content?.includes("process.argv")));
+    }
+    detectCircularDependencies(dependencyGraph) {
+        const circularDeps = [];
+        const visited = new Set();
+        const recursionStack = new Set();
+        const dfs = (node) => {
+            visited.add(node);
+            recursionStack.add(node);
+            const dependencies = dependencyGraph.get(node) || new Set();
+            for (const dep of Array.from(dependencies)) {
+                if (!visited.has(dep)) {
+                    if (dfs(dep)) {
+                        circularDeps.push(`${node} -> ${dep}`);
+                        return true;
+                    }
+                }
+                else if (recursionStack.has(dep)) {
+                    circularDeps.push(`${node} -> ${dep}`);
+                    return true;
+                }
+            }
+            recursionStack.delete(node);
+            return false;
+        };
+        for (const node of Array.from(dependencyGraph.keys())) {
+            if (!visited.has(node)) {
+                dfs(node);
+            }
+        }
+        return circularDeps;
+    }
+}
+// Export factory function for optimized analyzers
+export const createCodebaseContextAnalyzer = (projectRoot, memoryConfig) => {
+    return new CodebaseContextAnalyzer(projectRoot, memoryConfig);
+};