@ai-coders/context 0.1.0 → 0.2.1

package/dist/generators/documentationGenerator.js

@@ -40,10 +40,15 @@ exports.DocumentationGenerator = void 0;
 const fs = __importStar(require("fs-extra"));
 const path = __importStar(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
+const moduleGrouper_1 = require("./moduleGrouper");
+const documentationTemplates_1 = require("./documentationTemplates");
+const documentationUtils_1 = require("./documentationUtils");
 class DocumentationGenerator {
     constructor(fileMapper, llmClient) {
         this.fileMapper = fileMapper;
         this.llmClient = llmClient;
+        this.moduleGrouper = new moduleGrouper_1.ModuleGrouper(fileMapper);
+        this.templates = new documentationTemplates_1.DocumentationTemplates(llmClient);
     }
     async generateDocumentation(repoStructure, outputDir, verbose = false) {
         const docsDir = path.join(outputDir, 'docs');
@@ -75,39 +80,8 @@ class DocumentationGenerator {
         if (verbose) {
             console.log(chalk_1.default.blue(`📄 Creating ${fileName}...`));
         }
-        const indexContent = `# Documentation Index
-
-Welcome to the project documentation. This guide is organized into the following sections:
-
-## 📚 Documentation Structure
-
-### [Overview](./overview.md)
-High-level project overview, statistics, and key components.
-
-### [Architecture](./architecture.md)
-System architecture, design patterns, and technical decisions.
-
-### [Modules](./modules/)
-Detailed documentation for each module/component:
-${this.getModuleGroups(repoStructure).map(group => `- [${group.name}](./modules/${this.slugify(group.name)}.md) - ${group.description}`).join('\n')}
-
-### [API Reference](./api-reference.md)
-Complete API documentation for all public interfaces.
-
-### [Configuration](./configuration.md)
-Configuration options, environment variables, and setup guides.
-
-## 🚀 Quick Links
-
-- [Getting Started](#getting-started)
-- [Project Structure](./overview.md#project-structure)
-- [Key Components](./architecture.md#key-components)
-- [Contributing Guidelines](../CONTRIBUTING.md)
-
----
-*Generated by AI Coders Context*
-*Last updated: ${new Date().toISOString()}*
-`;
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
+        const indexContent = this.templates.createMainIndex(repoStructure, moduleGroups);
         const indexPath = path.join(docsDir, fileName);
         await fs.writeFile(indexPath, indexContent);
         if (verbose) {
@@ -119,7 +93,7 @@ Configuration options, environment variables, and setup guides.
         if (verbose) {
             console.log(chalk_1.default.blue(`📄 Creating ${fileName}...`));
         }
-        const overview = await this.createEnhancedProjectOverview(repoStructure);
+        const overview = this.templates.createEnhancedProjectOverview(repoStructure);
         const overviewPath = path.join(docsDir, fileName);
         await fs.writeFile(overviewPath, overview);
         if (verbose) {
@@ -131,7 +105,8 @@ Configuration options, environment variables, and setup guides.
         if (verbose) {
             console.log(chalk_1.default.blue(`📄 Creating ${fileName}...`));
         }
-        const architecture = await this.createArchitectureDocumentation(repoStructure);
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
+        const architecture = this.templates.createArchitectureDocumentation(repoStructure, moduleGroups);
         const archPath = path.join(docsDir, fileName);
         await fs.writeFile(archPath, architecture);
         if (verbose) {
@@ -141,14 +116,14 @@ Configuration options, environment variables, and setup guides.
     async generateModuleDocumentation(repoStructure, docsDir, verbose) {
         const modulesDir = path.join(docsDir, 'modules');
         await fs.ensureDir(modulesDir);
-        const moduleGroups = this.getModuleGroups(repoStructure);
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
         if (verbose) {
             console.log(chalk_1.default.yellow(`📦 Generating documentation for ${moduleGroups.length} modules...`));
         }
         for (const module of moduleGroups) {
             try {
                 const moduleDoc = await this.createModuleDocumentation(module, repoStructure);
-                const modulePath = path.join(modulesDir, `${this.slugify(module.name)}.md`);
+                const modulePath = path.join(modulesDir, `${documentationUtils_1.DocumentationUtils.slugify(module.name)}.md`);
                 await fs.writeFile(modulePath, moduleDoc);
                 if (verbose) {
                     console.log(chalk_1.default.green(`✅ Module documentation generated: ${module.name}`));
@@ -165,7 +140,8 @@ Configuration options, environment variables, and setup guides.
         if (verbose) {
             console.log(chalk_1.default.yellow('🔌 Generating API reference...'));
         }
-        const apiRef = await this.createAPIReference(repoStructure);
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
+        const apiRef = this.templates.createAPIReference(repoStructure, moduleGroups);
         const apiPath = path.join(docsDir, 'api-reference.md');
         await fs.writeFile(apiPath, apiRef);
         if (verbose) {
@@ -176,436 +152,20 @@ Configuration options, environment variables, and setup guides.
         if (verbose) {
             console.log(chalk_1.default.yellow('⚙️ Generating configuration guide...'));
         }
-        const configGuide = await this.createConfigurationGuide(repoStructure);
+        const configGuide = this.templates.createConfigurationGuide(repoStructure);
         const configPath = path.join(docsDir, 'configuration.md');
         await fs.writeFile(configPath, configGuide);
         if (verbose) {
             console.log(chalk_1.default.green(`✅ Configuration guide saved: ${configPath}`));
         }
     }
-    getModuleGroups(repoStructure) {
-        const groups = new Map();
-        // Group files by their top-level directory or logical module
-        repoStructure.files.forEach(file => {
-            if (!this.fileMapper.isTextFile(file.path))
-                return;
-            const parts = file.relativePath.split(path.sep);
-            let groupName = 'Root Files';
-            if (parts.length > 1) {
-                groupName = parts[0];
-                // Special handling for src files
-                if (groupName === 'src' && parts.length > 2) {
-                    groupName = `${parts[1]}`;
-                }
-            }
-            if (!groups.has(groupName)) {
-                groups.set(groupName, []);
-            }
-            groups.get(groupName).push(file);
-        });
-        // Convert to ModuleGroup array with descriptions
-        return Array.from(groups.entries()).map(([name, files]) => ({
-            name: this.formatModuleName(name),
-            description: this.getModuleDescription(name, files),
-            files
-        })).sort((a, b) => a.name.localeCompare(b.name));
-    }
-    formatModuleName(name) {
-        return name
-            .split(/[-_]/)
-            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
-            .join(' ');
-    }
-    getModuleDescription(name, files) {
-        const descriptions = {
-            'generators': 'Code generation utilities for documentation and agents',
-            'services': 'External service integrations and API clients',
-            'utils': 'Utility functions and helper modules',
-            'types': 'TypeScript type definitions and interfaces',
-            'Root Files': 'Main configuration and entry point files'
-        };
-        return descriptions[name] || `${this.formatModuleName(name)} module with ${files.length} files`;
-    }
-    async createModuleDocumentation(module, repoStructure) {
-        const fileContents = [];
-        for (const file of module.files.slice(0, 10)) { // Limit to prevent too large requests
-            const content = await this.fileMapper.readFileContent(file.path);
-            fileContents.push(`File: ${file.relativePath}\n${content.substring(0, 1000)}...`);
-        }
-        const moduleContext = `Module: ${module.name}
-Description: ${module.description}
-Files: ${module.files.map(f => f.relativePath).join(', ')}
-
-Sample content from module files:
-${fileContents.join('\n\n---\n\n')}`;
-        const documentation = await this.llmClient.generateText(`Generate comprehensive documentation for this module. Include:
-1. Module overview and purpose
-2. Key components and their responsibilities
-3. Public APIs and interfaces
-4. Usage examples
-5. Dependencies and relationships
-
-Module context:
-${moduleContext}`, 'You are a technical documentation expert. Create clear, well-structured module documentation.');
-        return `# ${module.name}
-
-${documentation}
-
-## Files in this module
-
-${module.files.map(file => `- \`${file.relativePath}\` - ${this.formatBytes(file.size)}`).join('\n')}
-
----
-*Generated by AI Coders Context*
-`;
-    }
-    async createEnhancedProjectOverview(repoStructure) {
-        const { files, directories, totalFiles, totalSize } = repoStructure;
-        const extensions = new Map();
-        files.forEach(file => {
-            const ext = file.extension || 'no-extension';
-            extensions.set(ext, (extensions.get(ext) || 0) + 1);
-        });
-        const topExtensions = Array.from(extensions.entries())
-            .sort((a, b) => b[1] - a[1])
-            .slice(0, 10);
-        // Try to identify project type
-        const projectType = this.identifyProjectType(repoStructure);
-        const techStack = this.identifyTechStack(repoStructure);
-        return `# Project Overview
-
-## Project Information
-- **Type**: ${projectType}
-- **Technology Stack**: ${techStack.join(', ')}
-- **Total Files**: ${totalFiles}
-- **Total Size**: ${this.formatBytes(totalSize)}
-
-## Project Structure
-
-### Directory Overview
-\`\`\`
-${this.createSimplifiedTree(repoStructure)}
-\`\`\`
-
-### File Distribution
-${topExtensions.map(([ext, count]) => `- **${ext}**: ${count} files (${((count / totalFiles) * 100).toFixed(1)}%)`).join('\n')}
-
-## Key Files
-${this.identifyKeyFiles(repoStructure).map(f => `- \`${f.relativePath}\` - ${f.description}`).join('\n')}
-
-## Development Setup
-
-Refer to the [Configuration Guide](./configuration.md) for detailed setup instructions.
-
----
-*Generated by AI Coders Context*
-`;
-    }
-    async createArchitectureDocumentation(repoStructure) {
-        const modules = this.getModuleGroups(repoStructure);
-        const techStack = this.identifyTechStack(repoStructure);
-        return `# Architecture Documentation
-
-## System Overview
-
-This document describes the high-level architecture of the project.
-
-## Technology Stack
-
-${techStack.map(tech => `- **${tech}**`).join('\n')}
-
-## Component Architecture
-
-### Core Modules
-
-${modules.map(module => `#### ${module.name}
-- **Purpose**: ${module.description}
-- **Files**: ${module.files.length}
-- **Key Responsibilities**: [To be analyzed]
-`).join('\n')}
-
-## Design Patterns
-
-Based on the codebase structure, the following patterns are identified:
-- Command Pattern (CLI structure)
-- Service Layer Pattern (services directory)
-- Factory Pattern (generators)
-
-## Data Flow
-
-1. **Input Processing**: Command-line arguments are parsed
-2. **File Analysis**: Repository structure is mapped
-3. **Content Generation**: LLM-based documentation generation
-4. **Output Generation**: Structured documentation output
-
-## Dependencies
-
-Analyze package.json for detailed dependency information.
-
----
-*Generated by AI Coders Context*
-`;
-    }
-    async createAPIReference(repoStructure) {
-        const apiFiles = repoStructure.files.filter(f => f.relativePath.includes('types') ||
-            f.relativePath.includes('index') ||
-            f.relativePath.endsWith('.ts'));
-        return `# API Reference
-
-## Overview
-
-This document provides a complete reference for all public APIs in the project.
-
-## Core APIs
-
-### CLI Commands
-
-#### \`generate\`
-Generate documentation and agent prompts for a repository.
-
-**Usage:**
-\`\`\`bash
-ai-context generate <repo-path> [options]
-\`\`\`
-
-**Options:**
-- \`-o, --output <dir>\`: Output directory
-- \`-k, --api-key <key>\`: OpenRouter API key
-- \`-m, --model <model>\`: LLM model to use
-- \`--exclude <patterns...>\`: Patterns to exclude
-- \`--include <patterns...>\`: Patterns to include
-
-#### \`analyze\`
-Analyze repository structure without generating content.
-
-**Usage:**
-\`\`\`bash
-ai-context analyze <repo-path> [options]
-\`\`\`
-
-## Module APIs
-
-${this.getModuleGroups(repoStructure).map(module => `### ${module.name}\nSee [${module.name} Module Documentation](./modules/${this.slugify(module.name)}.md)`).join('\n\n')}
-
-## Type Definitions
-
-See the types module for detailed interface definitions.
-
----
-*Generated by AI Coders Context*
-`;
-    }
-    async createConfigurationGuide(repoStructure) {
-        const configFiles = repoStructure.files.filter(f => f.relativePath.includes('config') ||
-            f.relativePath.includes('.json') ||
-            f.relativePath.includes('.env'));
-        return `# Configuration Guide
-
-## Environment Variables
-
-### Required Variables
-
-- \`OPENROUTER_API_KEY\`: Your OpenRouter API key for LLM access
-
-### Optional Variables
-
-- \`OPENROUTER_MODEL\`: Override default model (default: \`google/gemini-2.5-flash-preview-05-20\`)
-- \`OPENROUTER_BASE_URL\`: Custom API endpoint (rarely needed)
-
-## Configuration Files
-
-${configFiles.map(f => `### ${f.relativePath}
-Configuration file for ${this.getConfigDescription(f.relativePath)}`).join('\n\n')}
-
-## Setup Instructions
-
-1. **Clone the repository**
-   \`\`\`bash
-   git clone https://github.com/vinilana/ai-coders-context.git
-   cd ai-coders-context
-   \`\`\`
-
-2. **Install dependencies**
-   \`\`\`bash
-   npm install
-   \`\`\`
-
-3. **Configure environment**
-   \`\`\`bash
-   cp .env.example .env
-   # Edit .env with your API key
-   \`\`\`
-
-4. **Build the project**
-   \`\`\`bash
-   npm run build
-   \`\`\`
-
-## Advanced Configuration
-
-### Custom Model Selection
-
-You can use any model available on OpenRouter:
-- \`anthropic/claude-3-haiku\` - Fast and efficient
-- \`anthropic/claude-3-sonnet\` - Balanced performance
-- \`openai/gpt-4\` - High quality output
-- \`google/gemini-2.5-flash-preview-05-20\` - Google's latest model
-
-### Output Customization
-
-Control what gets generated:
-- \`--docs-only\`: Generate only documentation
-- \`--agents-only\`: Generate only agent prompts
-- \`--exclude\`: Exclude specific file patterns
-- \`--include\`: Include only specific patterns
-
----
-*Generated by AI Coders Context*
-`;
-    }
-    identifyProjectType(repoStructure) {
-        const files = repoStructure.files.map(f => f.relativePath);
-        if (files.some(f => f === 'package.json')) {
-            if (files.some(f => f.includes('react') || f.includes('.jsx') || f.includes('.tsx'))) {
-                return 'React Application';
-            }
-            else if (files.some(f => f.includes('angular.json'))) {
-                return 'Angular Application';
-            }
-            else if (files.some(f => f.includes('vue'))) {
-                return 'Vue Application';
-            }
-            else if (files.some(f => f.includes('next.config'))) {
-                return 'Next.js Application';
-            }
-            return 'Node.js Project';
-        }
-        else if (files.some(f => f === 'requirements.txt' || f === 'setup.py')) {
-            return 'Python Project';
-        }
-        else if (files.some(f => f === 'pom.xml')) {
-            return 'Java Maven Project';
-        }
-        else if (files.some(f => f === 'build.gradle')) {
-            return 'Java Gradle Project';
-        }
-        return 'General Software Project';
-    }
-    identifyTechStack(repoStructure) {
-        const stack = [];
-        const files = repoStructure.files.map(f => f.relativePath);
-        // Languages
-        if (files.some(f => f.endsWith('.ts') || f.endsWith('.tsx')))
-            stack.push('TypeScript');
-        if (files.some(f => f.endsWith('.js') || f.endsWith('.jsx')))
-            stack.push('JavaScript');
-        if (files.some(f => f.endsWith('.py')))
-            stack.push('Python');
-        if (files.some(f => f.endsWith('.java')))
-            stack.push('Java');
-        // Frameworks
-        if (files.some(f => f === 'package.json'))
-            stack.push('Node.js');
-        if (files.some(f => f.includes('react')))
-            stack.push('React');
-        if (files.some(f => f.includes('vue')))
-            stack.push('Vue');
-        if (files.some(f => f.includes('angular')))
-            stack.push('Angular');
-        // Tools
-        if (files.some(f => f === 'tsconfig.json'))
-            stack.push('TypeScript Compiler');
-        if (files.some(f => f === 'jest.config.js'))
-            stack.push('Jest');
-        if (files.some(f => f === 'webpack.config.js'))
-            stack.push('Webpack');
-        return [...new Set(stack)];
-    }
-    identifyKeyFiles(repoStructure) {
-        const keyFiles = [];
-        repoStructure.files.forEach(file => {
-            const basename = path.basename(file.path);
-            const descriptions = {
-                'package.json': 'Node.js project configuration and dependencies',
-                'tsconfig.json': 'TypeScript compiler configuration',
-                'README.md': 'Project documentation and setup guide',
-                '.gitignore': 'Git ignore patterns',
-                'LICENSE': 'Project license information',
-                'index.ts': 'Main entry point',
-                'index.js': 'Main entry point',
-                '.env.example': 'Environment variable template'
-            };
-            if (descriptions[basename]) {
-                keyFiles.push({
-                    relativePath: file.relativePath,
-                    description: descriptions[basename]
-                });
-            }
-        });
-        return keyFiles;
-    }
-    createSimplifiedTree(repoStructure) {
-        const tree = {};
-        // Build directory structure
-        repoStructure.files.forEach(file => {
-            const parts = file.relativePath.split(path.sep);
-            if (parts.length > 1) {
-                const dir = parts[0];
-                if (!tree[dir])
-                    tree[dir] = new Set();
-                if (parts.length === 2) {
-                    tree[dir].add(parts[1]);
-                }
-            }
-        });
-        // Create tree visualization
-        let result = '';
-        const dirs = Object.keys(tree).sort();
-        dirs.forEach((dir, index) => {
-            const isLast = index === dirs.length - 1;
-            result += `${isLast ? '└── ' : '├── '}${dir}/\n`;
-            const files = Array.from(tree[dir]).slice(0, 3);
-            files.forEach((file, fIndex) => {
-                const isLastFile = fIndex === files.length - 1 && tree[dir].size <= 3;
-                result += `${isLast ? '    ' : '│   '}${isLastFile ? '└── ' : '├── '}${file}\n`;
-            });
-            if (tree[dir].size > 3) {
-                result += `${isLast ? '    ' : '│   '}└── ... (${tree[dir].size - 3} more files)\n`;
-            }
-        });
-        return result || 'No subdirectories found';
-    }
-    getConfigDescription(filePath) {
-        const descriptions = {
-            'package.json': 'Node.js dependencies and scripts',
-            'tsconfig.json': 'TypeScript compilation settings',
-            '.env': 'Environment variables',
-            '.env.example': 'Environment variable template',
-            'jest.config.js': 'Jest testing configuration'
-        };
-        const basename = path.basename(filePath);
-        return descriptions[basename] || basename.replace(/\.[^.]+$/, '');
-    }
-    slugify(text) {
-        return text
-            .toLowerCase()
-            .replace(/\s+/g, '-')
-            .replace(/[^a-z0-9-]/g, '');
-    }
-    formatBytes(bytes) {
-        if (bytes === 0)
-            return '0 Bytes';
-        const k = 1024;
-        const sizes = ['Bytes', 'KB', 'MB', 'GB'];
-        const i = Math.floor(Math.log(bytes) / Math.log(k));
-        return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
-    }
     async generateDevelopmentGuide(repoStructure, docsDir, verbose) {
         const fileName = 'DEVELOPMENT.md';
         if (verbose) {
             console.log(chalk_1.default.blue(`📄 Creating ${fileName}...`));
         }
-        const developmentGuide = await this.createDevelopmentGuide(repoStructure);
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
+        const developmentGuide = await this.templates.createDevelopmentGuide(repoStructure, moduleGroups);
         const devPath = path.join(docsDir, fileName);
         await fs.writeFile(devPath, developmentGuide);
         if (verbose) {
@@ -617,7 +177,7 @@ Control what gets generated:
         if (verbose) {
             console.log(chalk_1.default.blue(`📄 Creating ${fileName}...`));
         }
-        const deploymentGuide = await this.createDeploymentGuide(repoStructure);
+        const deploymentGuide = await this.templates.createDeploymentGuide(repoStructure);
         const deployPath = path.join(docsDir, fileName);
         await fs.writeFile(deployPath, deploymentGuide);
         if (verbose) {
@@ -629,157 +189,46 @@ Control what gets generated:
         if (verbose) {
             console.log(chalk_1.default.blue(`📄 Creating ${fileName}...`));
         }
-        const troubleshootingGuide = await this.createTroubleshootingGuide(repoStructure);
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
+        const troubleshootingGuide = await this.templates.createTroubleshootingGuide(repoStructure, moduleGroups);
         const troublePath = path.join(docsDir, fileName);
         await fs.writeFile(troublePath, troubleshootingGuide);
         if (verbose) {
             console.log(chalk_1.default.green(`✅ Created ${fileName}`));
         }
     }
-    async createDevelopmentGuide(repoStructure) {
-        const moduleGroups = this.getModuleGroups(repoStructure);
-        const configFiles = this.getConfigurationFiles(repoStructure);
-        const packageInfo = this.getPackageInfo(repoStructure);
-        const context = `Repository: ${repoStructure.rootPath}
-Total Files: ${repoStructure.totalFiles}
-Modules: ${moduleGroups.map(m => m.name).join(', ')}
-Configuration Files: ${configFiles.map(f => path.basename(f.relativePath)).join(', ')}
-Package Info: ${JSON.stringify(packageInfo, null, 2)}
-
-Module Structure:
-${moduleGroups.map(m => `- ${m.name}: ${m.description} (${m.files.length} files)`).join('\n')}`;
-        return await this.llmClient.generateText(`Create a comprehensive development guide for this project. Include:
+    async createModuleDocumentation(module, repoStructure) {
+        const fileContents = [];
+        for (const file of module.files.slice(0, 10)) { // Limit to prevent too large requests
+            const content = await this.fileMapper.readFileContent(file.path);
+            fileContents.push(`File: ${file.relativePath}\n${content.substring(0, 1000)}...`);
+        }
+        const moduleContext = `Module: ${module.name}
+Description: ${module.description}
+Files: ${module.files.map(f => f.relativePath).join(', ')}
 
-1. Getting Started (setup instructions)
-2. Development Environment Requirements
-3. Project Structure Overview
-4. Development Workflow
-5. Code Style and Standards
-6. Testing Guidelines
-7. Debugging Tips
-8. Build Process
-9. Contributing Guidelines
+Sample content from module files:
+${fileContents.join('\n\n---\n\n')}`;
+        const documentation = await this.llmClient.generateText(`Generate comprehensive documentation for this module. Include:
+1. Module overview and purpose
+2. Key components and their responsibilities
+3. Public APIs and interfaces
+4. Usage examples
+5. Dependencies and relationships
 
-Format as clean Markdown with proper headings and code blocks.`, context);
-    }
-    async createDeploymentGuide(repoStructure) {
-        const packageInfo = this.getPackageInfo(repoStructure);
-        const configFiles = this.getConfigurationFiles(repoStructure);
-        const hasDockerfile = repoStructure.files.some(f => f.relativePath.toLowerCase().includes('dockerfile'));
-        const hasKubernetes = repoStructure.files.some(f => f.relativePath.includes('k8s') || f.relativePath.includes('kubernetes'));
-        const context = `Repository: ${repoStructure.rootPath}
-Package Info: ${JSON.stringify(packageInfo, null, 2)}
-Configuration Files: ${configFiles.map(f => path.basename(f.relativePath)).join(', ')}
-Has Dockerfile: ${hasDockerfile}
-Has Kubernetes: ${hasKubernetes}
-Project Type: ${this.detectProjectType(repoStructure)}`;
-        return await this.llmClient.generateText(`Create a comprehensive deployment guide for this project. Include:
+Module context:
+${moduleContext}`, 'You are a technical documentation expert. Create clear, well-structured module documentation.');
+        return `# ${module.name}
 
-1. Prerequisites and Dependencies
-2. Environment Configuration
-3. Build Process for Production
-4. Deployment Options (based on project type)
-5. Environment Variables and Secrets
-6. Database Setup (if applicable)
-7. Monitoring and Health Checks
-8. Rollback Procedures
-9. Security Considerations
-10. Performance Optimization
+${documentation}
 
-Adapt the guide based on the project type and available configuration files.
-Format as clean Markdown with proper headings and code blocks.`, context);
-    }
-    async createTroubleshootingGuide(repoStructure) {
-        const moduleGroups = this.getModuleGroups(repoStructure);
-        const packageInfo = this.getPackageInfo(repoStructure);
-        const projectType = this.detectProjectType(repoStructure);
-        const context = `Repository: ${repoStructure.rootPath}
-Project Type: ${projectType}
-Package Info: ${JSON.stringify(packageInfo, null, 2)}
-Modules: ${moduleGroups.map(m => `${m.name} (${m.files.length} files)`).join(', ')}`;
-        return await this.llmClient.generateText(`Create a comprehensive troubleshooting guide for this ${projectType} project. Include:
+## Files in this module
 
-1. Common Issues and Solutions
-2. Development Environment Problems
-3. Build and Compilation Errors
-4. Runtime Errors and Debugging
-5. Performance Issues
-6. Dependency Problems
-7. Configuration Issues
-8. Testing Problems
-9. Deployment Issues
-10. Debugging Tools and Techniques
-11. Log Analysis
-12. FAQ Section
+${module.files.map(file => `- \`${file.relativePath}\` - ${documentationUtils_1.DocumentationUtils.formatBytes(file.size)}`).join('\n')}
 
-Focus on practical solutions and include code examples where helpful.
-Format as clean Markdown with proper headings and code blocks.`, context);
-    }
-    detectProjectType(repoStructure) {
-        const packageJson = repoStructure.files.find(f => f.relativePath === 'package.json');
-        if (packageJson) {
-            return 'Node.js/JavaScript';
-        }
-        const cargoToml = repoStructure.files.find(f => f.relativePath === 'Cargo.toml');
-        if (cargoToml) {
-            return 'Rust';
-        }
-        const goMod = repoStructure.files.find(f => f.relativePath === 'go.mod');
-        if (goMod) {
-            return 'Go';
-        }
-        const pythonFiles = repoStructure.files.filter(f => f.extension === '.py');
-        if (pythonFiles.length > 0) {
-            return 'Python';
-        }
-        const javaFiles = repoStructure.files.filter(f => f.extension === '.java');
-        if (javaFiles.length > 0) {
-            return 'Java';
-        }
-        return 'Mixed/Other';
-    }
-    getConfigurationFiles(repoStructure) {
-        const configPatterns = [
-            'package.json',
-            'tsconfig.json',
-            'jest.config.js',
-            'webpack.config.js',
-            '.env',
-            '.env.example',
-            'docker-compose.yml',
-            'Dockerfile',
-            'cargo.toml',
-            'go.mod',
-            'requirements.txt',
-            'pyproject.toml'
-        ];
-        return repoStructure.files.filter((file) => configPatterns.some(pattern => file.relativePath.toLowerCase().includes(pattern.toLowerCase())));
-    }
-    getPackageInfo(repoStructure) {
-        const packageJson = repoStructure.files.find(f => f.relativePath === 'package.json');
-        if (packageJson) {
-            try {
-                // Read package.json content - this is a simplified approach
-                // In practice, you might want to read the actual file content
-                return {
-                    type: 'Node.js project',
-                    configFile: 'package.json',
-                    hasScripts: true
-                };
-            }
-            catch {
-                return { type: 'Node.js project', configFile: 'package.json' };
-            }
-        }
-        const cargoToml = repoStructure.files.find(f => f.relativePath === 'Cargo.toml');
-        if (cargoToml) {
-            return { type: 'Rust project', configFile: 'Cargo.toml' };
-        }
-        const goMod = repoStructure.files.find(f => f.relativePath === 'go.mod');
-        if (goMod) {
-            return { type: 'Go project', configFile: 'go.mod' };
-        }
-        return { type: 'Generic project', configFile: 'none' };
+---
+*Generated by AI Coders Context*
+`;
     }
 }
 exports.DocumentationGenerator = DocumentationGenerator;