@ai-coders/context 0.1.0 → 0.2.1

package/dist/generators/documentation/enhancedDocumentationGenerator.js

@@ -0,0 +1,216 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnhancedDocumentationGenerator = void 0;
+const path = __importStar(require("path"));
+const moduleGrouper_1 = require("../moduleGrouper");
+const shared_1 = require("../shared");
+const newDocumentationTemplates_1 = require("./newDocumentationTemplates");
+const documentationTemplates_1 = require("./documentationTemplates");
+const documentationTypes_1 = require("./documentationTypes");
+class EnhancedDocumentationGenerator {
+    constructor(fileMapper, llmClient) {
+        this.fileMapper = fileMapper;
+        this.llmClient = llmClient;
+        this.moduleGrouper = new moduleGrouper_1.ModuleGrouper(fileMapper);
+        this.newTemplates = new newDocumentationTemplates_1.NewDocumentationTemplates(llmClient, fileMapper);
+        this.legacyTemplates = new documentationTemplates_1.DocumentationTemplates(llmClient);
+    }
+    async generateDocumentation(repoStructure, outputDir, config = {}, verbose = false) {
+        const fullConfig = {
+            enableLegacyDocs: false,
+            enableNewDocs: true,
+            focusAreas: [],
+            maxContentLength: 2000,
+            includeExamples: true,
+            ...config
+        };
+        const docsDir = path.join(outputDir, 'docs');
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '📚 Generating enhanced documentation in');
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
+        if (fullConfig.enableNewDocs) {
+            await this.generateNewStyleDocumentation(repoStructure, moduleGroups, docsDir, verbose);
+        }
+        if (fullConfig.enableLegacyDocs) {
+            await this.generateLegacyDocumentation(repoStructure, moduleGroups, docsDir, verbose);
+        }
+        // Generate combined index
+        await this.generateMainIndex(docsDir, fullConfig, verbose);
+    }
+    async generateNewStyleDocumentation(repoStructure, moduleGroups, docsDir, verbose) {
+        shared_1.GeneratorUtils.logProgress('🧠 Generating high-level conceptual documentation...', verbose);
+        const generators = {
+            'mental-model': () => this.newTemplates.createMentalModel(repoStructure, moduleGroups),
+            'architecture-decisions': () => this.newTemplates.createArchitectureDecisions(repoStructure, moduleGroups),
+            'code-organization': () => this.newTemplates.createCodeOrganization(repoStructure, moduleGroups),
+            'development-patterns': () => this.newTemplates.createDevelopmentPatterns(repoStructure, moduleGroups),
+            'ai-guidelines': () => this.newTemplates.createAIGuidelines(repoStructure, moduleGroups),
+            'contributing-workflows': () => this.newTemplates.createContributingWorkflows(repoStructure, moduleGroups),
+            'domain-context': () => this.newTemplates.createDomainContext(repoStructure, moduleGroups)
+        };
+        for (const docType of documentationTypes_1.NEW_DOCUMENTATION_TYPES) {
+            try {
+                const content = await generators[docType]();
+                const fileName = `${docType}.md`;
+                const filePath = path.join(docsDir, fileName);
+                await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, `Generated ${shared_1.GeneratorUtils.formatTitle(docType)}`);
+            }
+            catch (error) {
+                shared_1.GeneratorUtils.logError(`Error generating ${docType}`, error, verbose);
+            }
+        }
+    }
+    async generateLegacyDocumentation(repoStructure, moduleGroups, docsDir, verbose) {
+        shared_1.GeneratorUtils.logProgress('📁 Generating legacy detailed documentation...', verbose);
+        // Create legacy subdirectory
+        const legacyDir = path.join(docsDir, 'legacy');
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(legacyDir, verbose, 'Creating legacy docs directory');
+        // Generate legacy documentation types
+        const legacyGenerators = [
+            { name: 'overview.md', generator: () => this.legacyTemplates.createEnhancedProjectOverview(repoStructure) },
+            { name: 'architecture.md', generator: () => this.legacyTemplates.createArchitectureDocumentation(repoStructure, moduleGroups) },
+            { name: 'api-reference.md', generator: () => this.legacyTemplates.createAPIReference(repoStructure, moduleGroups) },
+            { name: 'configuration.md', generator: () => this.legacyTemplates.createConfigurationGuide(repoStructure) },
+            { name: 'development.md', generator: () => this.legacyTemplates.createDevelopmentGuide(repoStructure, moduleGroups) },
+            { name: 'deployment.md', generator: () => this.legacyTemplates.createDeploymentGuide(repoStructure) },
+            { name: 'troubleshooting.md', generator: () => this.legacyTemplates.createTroubleshootingGuide(repoStructure, moduleGroups) }
+        ];
+        for (const { name, generator } of legacyGenerators) {
+            try {
+                const content = await generator();
+                const filePath = path.join(legacyDir, name);
+                await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, `Generated legacy ${name}`);
+            }
+            catch (error) {
+                shared_1.GeneratorUtils.logError(`Error generating legacy ${name}`, error, verbose);
+            }
+        }
+    }
+    async generateMainIndex(docsDir, config, verbose) {
+        let indexContent;
+        if (config.enableNewDocs && config.enableLegacyDocs) {
+            // Both enabled - create combined index
+            indexContent = this.createCombinedIndex();
+        }
+        else if (config.enableNewDocs) {
+            // Only new docs
+            indexContent = this.newTemplates.createNewDocumentationIndex(documentationTypes_1.NEW_DOCUMENTATION_TYPES);
+        }
+        else {
+            // Only legacy docs
+            indexContent = this.createLegacyOnlyIndex();
+        }
+        const indexPath = path.join(docsDir, 'README.md');
+        await shared_1.GeneratorUtils.writeFileWithLogging(indexPath, indexContent, verbose, 'Generated documentation index');
+    }
+    createCombinedIndex() {
+        return `# Documentation Hub
+
+This project provides two styles of documentation to meet different needs:
+
+## 🧠 High-Level Documentation (Recommended)
+
+**Focus**: Understanding concepts, patterns, and how to work with the codebase
+
+- [**Mental Model**](./mental-model.md) - Core concepts and metaphors
+- [**Architecture Decisions**](./architecture-decisions.md) - Key design choices and rationale  
+- [**Code Organization**](./code-organization.md) - Structure and organization logic
+- [**Development Patterns**](./development-patterns.md) - How to work effectively in this codebase
+- [**AI Guidelines**](./ai-guidelines.md) - Guidance for AI agents
+- [**Contributing Workflows**](./contributing-workflows.md) - Processes and procedures
+- [**Domain Context**](./domain-context.md) - Business and domain knowledge
+
+## 📁 Detailed Documentation (Legacy)
+
+**Focus**: Comprehensive technical details and implementation specifics
+
+- [**Overview**](./legacy/overview.md) - Project statistics and structure
+- [**Architecture**](./legacy/architecture.md) - Technical architecture details
+- [**API Reference**](./legacy/api-reference.md) - Complete API documentation
+- [**Configuration**](./legacy/configuration.md) - Setup and configuration guides
+- [**Development**](./legacy/development.md) - Development environment setup
+- [**Deployment**](./legacy/deployment.md) - Deployment procedures
+- [**Troubleshooting**](./legacy/troubleshooting.md) - Common issues and solutions
+
+## Recommended Reading Order
+
+**For New Team Members:**
+1. Mental Model → Architecture Decisions → Code Organization → Development Patterns
+
+**For AI Agents:**  
+1. Mental Model → AI Guidelines → Development Patterns → Code Organization
+
+**For Detailed Reference:**
+Legacy documentation provides comprehensive technical details when needed.
+
+${shared_1.GeneratorUtils.createGeneratedByFooter('Documentation Hub')}`;
+    }
+    createLegacyOnlyIndex() {
+        return `# Documentation Index
+
+This documentation provides comprehensive technical details about the project.
+
+## Available Documentation
+
+- [**Overview**](./legacy/overview.md) - Project statistics and structure
+- [**Architecture**](./legacy/architecture.md) - Technical architecture details  
+- [**API Reference**](./legacy/api-reference.md) - Complete API documentation
+- [**Configuration**](./legacy/configuration.md) - Setup and configuration guides
+- [**Development**](./legacy/development.md) - Development environment setup
+- [**Deployment**](./legacy/deployment.md) - Deployment procedures
+- [**Troubleshooting**](./legacy/troubleshooting.md) - Common issues and solutions
+
+${shared_1.GeneratorUtils.createGeneratedByFooter('Legacy Documentation Index')}`;
+    }
+    // Convenience methods for specific documentation types
+    async generateMentalModelOnly(repoStructure, outputDir, verbose = false) {
+        const docsDir = path.join(outputDir, 'docs');
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '🧠 Generating mental model documentation');
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
+        const content = await this.newTemplates.createMentalModel(repoStructure, moduleGroups);
+        const filePath = path.join(docsDir, 'mental-model.md');
+        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated Mental Model');
+    }
+    async generateAIGuidelinesOnly(repoStructure, outputDir, verbose = false) {
+        const docsDir = path.join(outputDir, 'docs');
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '🤖 Generating AI guidelines documentation');
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
+        const content = await this.newTemplates.createAIGuidelines(repoStructure, moduleGroups);
+        const filePath = path.join(docsDir, 'ai-guidelines.md');
+        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated AI Guidelines');
+    }
+}
+exports.EnhancedDocumentationGenerator = EnhancedDocumentationGenerator;
+//# sourceMappingURL=enhancedDocumentationGenerator.js.map

package/dist/generators/documentation/enhancedDocumentationGenerator.js.map

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

package/dist/generators/documentation/incrementalDocumentationGenerator.d.ts

@@ -0,0 +1,33 @@
+import { RepoStructure } from '../../types';
+import { FileMapper } from '../../utils/fileMapper';
+import { BaseLLMClient } from '../../services/baseLLMClient';
+import { GitService, GitChanges } from '../../utils/gitService';
+export declare class IncrementalDocumentationGenerator {
+    private fileMapper;
+    private llmClient;
+    private gitService;
+    constructor(fileMapper: FileMapper, llmClient: BaseLLMClient, gitService: GitService);
+    updateDocumentation(repoStructure: RepoStructure, outputDir: string, changes: GitChanges, verbose?: boolean): Promise<{
+        updated: number;
+        removed: number;
+        updatedFiles: string[];
+        removedFiles: string[];
+        overviewUpdated: boolean;
+    }>;
+    private getAffectedModules;
+    private getModuleNameForFile;
+    private getModuleKey;
+    private getModuleGroups;
+    private formatModuleName;
+    private getModuleDescription;
+    private updateModuleDocumentation;
+    private createModuleDocumentation;
+    private cleanupEmptyModules;
+    private updateOverviewDocuments;
+    private displayChangeSummary;
+    private createEnhancedProjectOverview;
+    private createDocumentationIndex;
+    private slugify;
+    private formatBytes;
+}
+//# sourceMappingURL=incrementalDocumentationGenerator.d.ts.map

package/dist/generators/documentation/incrementalDocumentationGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incrementalDocumentationGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/documentation/incrementalDocumentationGenerator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,aAAa,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAShE,qBAAa,iCAAiC;IAE1C,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,UAAU;gBAFV,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,aAAa,EACxB,UAAU,EAAE,UAAU;IAG1B,mBAAmB,CACvB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IA+FF,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,oBAAoB;YAYd,yBAAyB;YAyBzB,yBAAyB;YA2DzB,mBAAmB;YA6BnB,uBAAuB;IAkCrC,OAAO,CAAC,oBAAoB;YAad,6BAA6B;IAoC3C,OAAO,CAAC,wBAAwB;IAmChC,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,WAAW;CAOpB"}

package/dist/generators/documentation/incrementalDocumentationGenerator.js

@@ -0,0 +1,400 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IncrementalDocumentationGenerator = void 0;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+class IncrementalDocumentationGenerator {
+    constructor(fileMapper, llmClient, gitService) {
+        this.fileMapper = fileMapper;
+        this.llmClient = llmClient;
+        this.gitService = gitService;
+    }
+    async updateDocumentation(repoStructure, outputDir, changes, verbose = false) {
+        const docsDir = path.join(outputDir, 'docs');
+        await fs.ensureDir(docsDir);
+        if (verbose) {
+            console.log(chalk_1.default.blue(`📚 Updating documentation in: ${docsDir}`));
+            this.displayChangeSummary(changes);
+        }
+        let updated = 0;
+        let removed = 0;
+        const updatedFiles = [];
+        const removedFiles = [];
+        let overviewUpdated = false;
+        // Get all changed files
+        const allChangedFiles = [
+            ...changes.added,
+            ...changes.modified,
+            ...changes.deleted,
+            ...changes.renamed.map(r => r.from),
+            ...changes.renamed.map(r => r.to)
+        ];
+        // Filter for tracked and relevant files only
+        const trackedChangedFiles = this.gitService.filterTrackedFiles(allChangedFiles);
+        const relevantChangedFiles = trackedChangedFiles.filter(file => {
+            const fullPath = path.join(repoStructure.rootPath, file);
+            return this.fileMapper.isTextFile(fullPath);
+        });
+        if (verbose) {
+            const untrackedFiles = allChangedFiles.filter(file => !trackedChangedFiles.includes(file));
+            if (untrackedFiles.length > 0) {
+                console.log(chalk_1.default.gray(`📎 Skipping ${untrackedFiles.length} untracked files`));
+            }
+        }
+        if (relevantChangedFiles.length === 0) {
+            if (verbose) {
+                console.log(chalk_1.default.yellow('📄 No relevant tracked file changes detected'));
+            }
+            return {
+                updated: 0,
+                removed: 0,
+                updatedFiles: [],
+                removedFiles: [],
+                overviewUpdated: false
+            };
+        }
+        // Determine which modules are affected by the changes
+        const affectedModules = this.getAffectedModules(relevantChangedFiles, repoStructure);
+        if (verbose) {
+            console.log(chalk_1.default.yellow(`📦 Updating ${affectedModules.length} affected modules...`));
+            affectedModules.forEach(module => {
+                console.log(chalk_1.default.gray(`  - ${module.name} (${module.files.length} files)`));
+            });
+        }
+        // Update affected modules
+        for (const module of affectedModules) {
+            try {
+                const updatedFile = await this.updateModuleDocumentation(module, repoStructure, docsDir, verbose);
+                updatedFiles.push(updatedFile);
+                updated++;
+            }
+            catch (error) {
+                if (verbose) {
+                    console.log(chalk_1.default.red(`❌ Error updating module ${module.name}: ${error}`));
+                }
+            }
+        }
+        // Handle deleted files by checking if any modules became empty
+        const cleanedUpFiles = await this.cleanupEmptyModules(docsDir, repoStructure, verbose);
+        removedFiles.push(...cleanedUpFiles);
+        removed += cleanedUpFiles.length;
+        // Update overview documents if there were significant changes
+        if (updated > 0 || removed > 0) {
+            await this.updateOverviewDocuments(repoStructure, docsDir, verbose);
+            overviewUpdated = true;
+            updatedFiles.push('README.md', 'overview.md');
+        }
+        return {
+            updated,
+            removed,
+            updatedFiles,
+            removedFiles,
+            overviewUpdated
+        };
+    }
+    getAffectedModules(changedFiles, repoStructure) {
+        // Get all modules
+        const allModules = this.getModuleGroups(repoStructure);
+        // Find which modules contain changed files
+        const affectedModuleNames = new Set();
+        changedFiles.forEach(changedFile => {
+            const moduleName = this.getModuleNameForFile(changedFile);
+            affectedModuleNames.add(moduleName);
+        });
+        // Return only the affected modules
+        return allModules.filter(module => affectedModuleNames.has(this.getModuleKey(module.name)));
+    }
+    getModuleNameForFile(relativePath) {
+        const parts = 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];
+            }
+        }
+        return groupName;
+    }
+    getModuleKey(moduleName) {
+        return moduleName.toLowerCase().replace(/\s+/g, '-');
+    }
+    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 updateModuleDocumentation(module, repoStructure, docsDir, verbose) {
+        const modulesDir = path.join(docsDir, 'modules');
+        await fs.ensureDir(modulesDir);
+        const fileName = `${this.slugify(module.name)}.md`;
+        if (verbose) {
+            console.log(chalk_1.default.blue(`📄 Updating modules/${fileName}...`));
+        }
+        const moduleDoc = await this.createModuleDocumentation(module, repoStructure);
+        const modulePath = path.join(modulesDir, fileName);
+        await fs.writeFile(modulePath, moduleDoc);
+        if (verbose) {
+            console.log(chalk_1.default.green(`✅ Updated modules/${fileName}`));
+        }
+        return path.relative(docsDir, modulePath);
+    }
+    async createModuleDocumentation(module, _repoStructure) {
+        const fileContents = [];
+        for (const file of module.files.slice(0, 10)) { // Limit to prevent too large requests
+            try {
+                const content = await this.fileMapper.readFileContent(file.path);
+                fileContents.push(`File: ${file.relativePath}\n${content.substring(0, 1000)}...`);
+            }
+            catch (error) {
+                fileContents.push(`File: ${file.relativePath}\n[Error reading file: ${error}]`);
+            }
+        }
+        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.');
+        // Add metadata header
+        const history = this.gitService.getFileHistory(module.files[0]?.relativePath || '', 1);
+        const lastModified = history[0]?.date || new Date().toISOString();
+        return `---
+module: ${module.name}
+files: ${module.files.length}
+last_modified: ${lastModified}
+generated: ${new Date().toISOString()}
+---
+
+# ${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 cleanupEmptyModules(docsDir, repoStructure, verbose) {
+        const modulesDir = path.join(docsDir, 'modules');
+        if (!await fs.pathExists(modulesDir))
+            return [];
+        const existingModuleFiles = await fs.readdir(modulesDir);
+        const currentModules = new Set(this.getModuleGroups(repoStructure).map(m => `${this.slugify(m.name)}.md`));
+        const removedFiles = [];
+        for (const moduleFile of existingModuleFiles) {
+            if (!currentModules.has(moduleFile)) {
+                const modulePath = path.join(modulesDir, moduleFile);
+                await fs.remove(modulePath);
+                removedFiles.push(path.join('modules', moduleFile));
+                if (verbose) {
+                    console.log(chalk_1.default.red(`🗑️  Removed empty module: ${moduleFile}`));
+                }
+            }
+        }
+        return removedFiles;
+    }
+    async updateOverviewDocuments(repoStructure, docsDir, verbose) {
+        // Update project overview
+        const overviewFileName = 'overview.md';
+        if (verbose) {
+            console.log(chalk_1.default.blue(`📄 Updating ${overviewFileName}...`));
+        }
+        const overview = await this.createEnhancedProjectOverview(repoStructure);
+        const overviewPath = path.join(docsDir, overviewFileName);
+        await fs.writeFile(overviewPath, overview);
+        if (verbose) {
+            console.log(chalk_1.default.green(`✅ Updated ${overviewFileName}`));
+        }
+        // Update main README
+        const indexFileName = 'README.md';
+        if (verbose) {
+            console.log(chalk_1.default.blue(`📄 Updating ${indexFileName}...`));
+        }
+        const indexContent = this.createDocumentationIndex(repoStructure);
+        const indexPath = path.join(docsDir, indexFileName);
+        await fs.writeFile(indexPath, indexContent);
+        if (verbose) {
+            console.log(chalk_1.default.green(`✅ Updated ${indexFileName}`));
+        }
+    }
+    displayChangeSummary(changes) {
+        const total = changes.added.length + changes.modified.length + changes.deleted.length + changes.renamed.length;
+        console.log(chalk_1.default.bold('\n📋 Change Summary:'));
+        console.log(chalk_1.default.gray('─'.repeat(50)));
+        console.log(`${chalk_1.default.green('Added:')} ${changes.added.length} files`);
+        console.log(`${chalk_1.default.yellow('Modified:')} ${changes.modified.length} files`);
+        console.log(`${chalk_1.default.red('Deleted:')} ${changes.deleted.length} files`);
+        console.log(`${chalk_1.default.blue('Renamed:')} ${changes.renamed.length} files`);
+        console.log(`${chalk_1.default.bold('Total:')} ${total} changes`);
+        console.log(chalk_1.default.gray('─'.repeat(50)) + '\n');
+    }
+    async createEnhancedProjectOverview(repoStructure) {
+        const { files, directories, totalFiles, totalSize } = repoStructure;
+        const branch = this.gitService.getBranchName();
+        const lastCommit = this.gitService.getCurrentCommit().substring(0, 7);
+        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);
+        return `# Project Overview
+
+## Git Information
+- **Branch**: ${branch}
+- **Last Commit**: ${lastCommit}
+- **Last Updated**: ${new Date().toISOString()}
+
+## Project Statistics
+- **Total Files**: ${totalFiles}
+- **Total Directories**: ${directories.length}
+- **Total Size**: ${this.formatBytes(totalSize)}
+
+## File Distribution
+${topExtensions.map(([ext, count]) => `- **${ext}**: ${count} files (${((count / totalFiles) * 100).toFixed(1)}%)`).join('\n')}
+
+---
+*Generated by AI Coders Context*
+*Incremental update: ${new Date().toISOString()}*
+`;
+    }
+    createDocumentationIndex(_repoStructure) {
+        const state = this.gitService.getState();
+        const branch = this.gitService.getBranchName();
+        return `# Documentation Index
+
+This documentation was generated automatically from the codebase.
+
+## Documentation Structure
+
+### [Overview](./overview.md)
+High-level project overview, statistics, and git information.
+
+### [Architecture](./architecture.md)
+System architecture, design patterns, and technical decisions.
+
+### [Modules](./modules/)
+Detailed documentation organized by module and directory structure.
+
+### [API Reference](./api-reference.md)
+Complete API documentation for all public interfaces.
+
+### [Configuration](./configuration.md)
+Configuration options, environment variables, and setup guides.
+
+## Generation Info
+- **Branch**: ${branch}
+- **Generated**: ${new Date().toISOString()}
+- **Last Processed Commit**: ${state?.lastCommit ? state.lastCommit.substring(0, 7) : 'None'}
+
+---
+*Generated by AI Coders Context*
+`;
+    }
+    slugify(text) {
+        return text
+            .toLowerCase()
+            .replace(/\s+/g, '-')
+            .replace(/[^\w-]/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];
+    }
+}
+exports.IncrementalDocumentationGenerator = IncrementalDocumentationGenerator;
+//# sourceMappingURL=incrementalDocumentationGenerator.js.map