@ai-coders/context 0.1.0 → 0.2.1

package/dist/generators/analyzers/codebaseAnalyzer.js

@@ -0,0 +1,293 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodebaseAnalyzer = void 0;
+class CodebaseAnalyzer {
+    constructor(fileMapper) {
+        this.fileMapper = fileMapper;
+    }
+    async analyzeArchitecturalPatterns(repoStructure, moduleGroups) {
+        const patterns = [];
+        // Analyze directory structure for common patterns
+        const directories = this.getDirectoryStructure(repoStructure);
+        // Check for MVC pattern
+        if (this.hasMVCStructure(directories)) {
+            patterns.push({
+                name: 'Model-View-Controller (MVC)',
+                description: 'Separation of concerns into models, views, and controllers',
+                evidence: this.getMVCEvidence(directories),
+                confidence: 0.8
+            });
+        }
+        // Check for layered architecture
+        if (this.hasLayeredArchitecture(directories)) {
+            patterns.push({
+                name: 'Layered Architecture',
+                description: 'Organized into distinct layers (services, controllers, models, etc.)',
+                evidence: this.getLayeredEvidence(directories),
+                confidence: 0.7
+            });
+        }
+        // Check for modular architecture
+        if (this.hasModularStructure(moduleGroups)) {
+            patterns.push({
+                name: 'Modular Architecture',
+                description: 'Code organized into distinct, cohesive modules',
+                evidence: this.getModularEvidence(moduleGroups),
+                confidence: 0.9
+            });
+        }
+        // Check for microservices indicators
+        if (this.hasMicroservicesIndicators(repoStructure)) {
+            patterns.push({
+                name: 'Microservices Architecture',
+                description: 'Multiple independent services with clear boundaries',
+                evidence: this.getMicroservicesEvidence(repoStructure),
+                confidence: 0.6
+            });
+        }
+        return patterns;
+    }
+    async analyzeCodePatterns(repoStructure) {
+        const patterns = [];
+        const sampleFiles = repoStructure.files.slice(0, 20); // Analyze sample for patterns
+        for (const file of sampleFiles) {
+            try {
+                const content = await this.fileMapper.readFileContent(file.path);
+                // Look for common patterns
+                patterns.push(...this.detectDesignPatterns(content, file));
+                patterns.push(...this.detectNamingPatterns(content, file));
+                patterns.push(...this.detectErrorHandlingPatterns(content, file));
+            }
+            catch (error) {
+                // Skip files that can't be read
+            }
+        }
+        return this.consolidatePatterns(patterns);
+    }
+    analyzeDependencyFlow(repoStructure, moduleGroups) {
+        const flows = [];
+        // Analyze module-to-module dependencies
+        for (const module of moduleGroups) {
+            for (const otherModule of moduleGroups) {
+                if (module.name !== otherModule.name) {
+                    const strength = this.calculateDependencyStrength(module, otherModule);
+                    if (strength > 0) {
+                        flows.push({
+                            from: module.name,
+                            to: otherModule.name,
+                            type: 'import',
+                            strength
+                        });
+                    }
+                }
+            }
+        }
+        return flows.sort((a, b) => b.strength - a.strength);
+    }
+    identifyExtensionPoints(repoStructure) {
+        const extensionPoints = [];
+        const directories = this.getDirectoryStructure(repoStructure);
+        // Common extension point patterns
+        if (directories.includes('plugins')) {
+            extensionPoints.push('Plugin system in /plugins directory');
+        }
+        if (directories.includes('extensions')) {
+            extensionPoints.push('Extension system in /extensions directory');
+        }
+        if (directories.includes('hooks')) {
+            extensionPoints.push('Hook system in /hooks directory');
+        }
+        if (directories.includes('middleware')) {
+            extensionPoints.push('Middleware system in /middleware directory');
+        }
+        if (directories.includes('generators')) {
+            extensionPoints.push('Generator system in /generators directory');
+        }
+        // Look for interface/abstract patterns
+        const interfaceFiles = repoStructure.files.filter(f => f.relativePath.includes('interface') ||
+            f.relativePath.includes('abstract') ||
+            f.relativePath.includes('base'));
+        if (interfaceFiles.length > 0) {
+            extensionPoints.push(`Interface-based extension points: ${interfaceFiles.slice(0, 3).map(f => f.relativePath).join(', ')}`);
+        }
+        return extensionPoints;
+    }
+    getDirectoryStructure(repoStructure) {
+        return [...new Set(repoStructure.files
+                .map(f => f.relativePath.split('/')[0])
+                .filter(dir => !dir.includes('.')))];
+    }
+    hasMVCStructure(directories) {
+        const mvcPatterns = ['models', 'views', 'controllers'];
+        return mvcPatterns.filter(pattern => directories.some(dir => dir.toLowerCase().includes(pattern))).length >= 2;
+    }
+    getMVCEvidence(directories) {
+        const evidence = [];
+        if (directories.some(d => d.toLowerCase().includes('model'))) {
+            evidence.push('Models directory found');
+        }
+        if (directories.some(d => d.toLowerCase().includes('view'))) {
+            evidence.push('Views directory found');
+        }
+        if (directories.some(d => d.toLowerCase().includes('controller'))) {
+            evidence.push('Controllers directory found');
+        }
+        return evidence;
+    }
+    hasLayeredArchitecture(directories) {
+        const layers = ['services', 'controllers', 'models', 'repositories', 'utils'];
+        return layers.filter(layer => directories.some(dir => dir.toLowerCase().includes(layer))).length >= 3;
+    }
+    getLayeredEvidence(directories) {
+        const layers = ['services', 'controllers', 'models', 'repositories', 'utils', 'middleware'];
+        return layers
+            .filter(layer => directories.some(dir => dir.toLowerCase().includes(layer)))
+            .map(layer => `${layer.charAt(0).toUpperCase() + layer.slice(1)} layer found`);
+    }
+    hasModularStructure(moduleGroups) {
+        return moduleGroups.length > 2 &&
+            moduleGroups.every(m => m.files.length > 1) &&
+            moduleGroups.some(m => m.files.length > 3);
+    }
+    getModularEvidence(moduleGroups) {
+        return [
+            `${moduleGroups.length} distinct modules identified`,
+            `Average module size: ${Math.round(moduleGroups.reduce((sum, m) => sum + m.files.length, 0) / moduleGroups.length)} files`,
+            `Largest module: ${moduleGroups.reduce((max, m) => m.files.length > max.files.length ? m : max).name}`
+        ];
+    }
+    hasMicroservicesIndicators(repoStructure) {
+        const indicators = [
+            repoStructure.files.some(f => f.relativePath.includes('docker')),
+            repoStructure.files.some(f => f.relativePath.includes('k8s') || f.relativePath.includes('kubernetes')),
+            repoStructure.files.some(f => f.relativePath.includes('service')),
+            repoStructure.files.some(f => f.relativePath.includes('api'))
+        ];
+        return indicators.filter(Boolean).length >= 2;
+    }
+    getMicroservicesEvidence(repoStructure) {
+        const evidence = [];
+        if (repoStructure.files.some(f => f.relativePath.includes('docker'))) {
+            evidence.push('Docker configuration found');
+        }
+        if (repoStructure.files.some(f => f.relativePath.includes('k8s'))) {
+            evidence.push('Kubernetes configuration found');
+        }
+        if (repoStructure.files.some(f => f.relativePath.includes('service'))) {
+            evidence.push('Service-oriented file structure');
+        }
+        return evidence;
+    }
+    detectDesignPatterns(content, file) {
+        const patterns = [];
+        // Factory pattern
+        if (content.includes('createFactory') || content.includes('Factory') || content.match(/create\w+/g)) {
+            patterns.push({
+                type: 'Design Pattern',
+                pattern: 'Factory Pattern',
+                description: 'Object creation through factory methods',
+                examples: [file.relativePath],
+                frequency: 1
+            });
+        }
+        // Observer pattern
+        if (content.includes('addEventListener') || content.includes('subscribe') || content.includes('emit')) {
+            patterns.push({
+                type: 'Design Pattern',
+                pattern: 'Observer Pattern',
+                description: 'Event-driven communication between objects',
+                examples: [file.relativePath],
+                frequency: 1
+            });
+        }
+        // Singleton pattern
+        if (content.includes('getInstance') || content.match(/private\s+constructor/)) {
+            patterns.push({
+                type: 'Design Pattern',
+                pattern: 'Singleton Pattern',
+                description: 'Single instance object creation',
+                examples: [file.relativePath],
+                frequency: 1
+            });
+        }
+        return patterns;
+    }
+    detectNamingPatterns(content, file) {
+        const patterns = [];
+        // Check for naming conventions
+        if (content.match(/\bI[A-Z]\w+/g)) {
+            patterns.push({
+                type: 'Naming Convention',
+                pattern: 'Interface Prefix',
+                description: 'Interfaces prefixed with "I"',
+                examples: [file.relativePath],
+                frequency: 1
+            });
+        }
+        if (content.match(/\b\w+Service\b/g)) {
+            patterns.push({
+                type: 'Naming Convention',
+                pattern: 'Service Suffix',
+                description: 'Services suffixed with "Service"',
+                examples: [file.relativePath],
+                frequency: 1
+            });
+        }
+        return patterns;
+    }
+    detectErrorHandlingPatterns(content, file) {
+        const patterns = [];
+        if (content.includes('try') && content.includes('catch')) {
+            patterns.push({
+                type: 'Error Handling',
+                pattern: 'Try-Catch Blocks',
+                description: 'Structured error handling with try-catch',
+                examples: [file.relativePath],
+                frequency: 1
+            });
+        }
+        if (content.includes('throw new') || content.includes('throw Error')) {
+            patterns.push({
+                type: 'Error Handling',
+                pattern: 'Custom Exceptions',
+                description: 'Custom error throwing patterns',
+                examples: [file.relativePath],
+                frequency: 1
+            });
+        }
+        return patterns;
+    }
+    consolidatePatterns(patterns) {
+        const consolidated = new Map();
+        for (const pattern of patterns) {
+            const key = `${pattern.type}:${pattern.pattern}`;
+            if (consolidated.has(key)) {
+                const existing = consolidated.get(key);
+                existing.frequency += pattern.frequency;
+                existing.examples.push(...pattern.examples);
+            }
+            else {
+                consolidated.set(key, { ...pattern });
+            }
+        }
+        return Array.from(consolidated.values())
+            .sort((a, b) => b.frequency - a.frequency)
+            .slice(0, 10); // Top 10 patterns
+    }
+    calculateDependencyStrength(moduleA, moduleB) {
+        // Simple heuristic: check if moduleA files reference moduleB
+        let strength = 0;
+        // Check for direct path references
+        for (const fileA of moduleA.files) {
+            for (const fileB of moduleB.files) {
+                const bPath = fileB.relativePath.replace(/\.[^/.]+$/, ''); // Remove extension
+                if (fileA.relativePath.includes(bPath) || bPath.includes(fileA.relativePath.replace(/\.[^/.]+$/, ''))) {
+                    strength += 0.1;
+                }
+            }
+        }
+        return Math.min(strength, 1.0); // Cap at 1.0
+    }
+}
+exports.CodebaseAnalyzer = CodebaseAnalyzer;
+//# sourceMappingURL=codebaseAnalyzer.js.map

package/dist/generators/analyzers/codebaseAnalyzer.js.map

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

package/dist/generators/analyzers/index.d.ts

@@ -0,0 +1,3 @@
+export { CodebaseAnalyzer } from './codebaseAnalyzer';
+export type { ArchitecturalPattern, CodePattern, DependencyFlow } from './codebaseAnalyzer';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/analyzers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/analyzers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,cAAc,EACf,MAAM,oBAAoB,CAAC"}

package/dist/generators/analyzers/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodebaseAnalyzer = void 0;
+var codebaseAnalyzer_1 = require("./codebaseAnalyzer");
+Object.defineProperty(exports, "CodebaseAnalyzer", { enumerable: true, get: function () { return codebaseAnalyzer_1.CodebaseAnalyzer; } });
+//# sourceMappingURL=index.js.map

package/dist/generators/analyzers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/analyzers/index.ts"],"names":[],"mappings":";;;AAAA,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

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

@@ -0,0 +1,19 @@
+import { RepoStructure } from '../../types';
+import { FileMapper } from '../../utils/fileMapper';
+import { BaseLLMClient } from '../../services/baseLLMClient';
+import { DocumentationConfig } from './documentationTypes';
+export declare class DocumentationGenerator {
+    private fileMapper;
+    private llmClient;
+    private moduleGrouper;
+    private templates;
+    constructor(fileMapper: FileMapper, llmClient: BaseLLMClient);
+    generateDocumentation(repoStructure: RepoStructure, outputDir: string, config?: Partial<DocumentationConfig>, verbose?: boolean): Promise<void>;
+    private generateAllDocumentation;
+    private generateMainIndex;
+    generateMentalModelOnly(repoStructure: RepoStructure, outputDir: string, verbose?: boolean): Promise<void>;
+    generateAIGuidelinesOnly(repoStructure: RepoStructure, outputDir: string, verbose?: boolean): Promise<void>;
+    generateArchitectureDecisionsOnly(repoStructure: RepoStructure, outputDir: string, verbose?: boolean): Promise<void>;
+    generateSoftwareGuidelinesOnly(repoStructure: RepoStructure, outputDir: string, verbose?: boolean): Promise<void>;
+}
+//# sourceMappingURL=documentationGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentationGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/documentation/documentationGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAI7D,OAAO,EAAE,mBAAmB,EAAgD,MAAM,sBAAsB,CAAC;AAEzG,qBAAa,sBAAsB;IAK/B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,SAAS;IALnB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAyB;gBAGhC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,aAAa;IAM5B,qBAAqB,CACzB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM,EACzC,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC;YAkBF,wBAAwB;YAsCxB,iBAAiB;IAWzB,uBAAuB,CAC3B,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAWV,wBAAwB,CAC5B,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAWV,iCAAiC,CACrC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAWV,8BAA8B,CAClC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC;CAUjB"}

package/dist/generators/documentation/documentationGenerator.js

@@ -0,0 +1,127 @@
+"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.DocumentationGenerator = void 0;
+const path = __importStar(require("path"));
+const moduleGrouper_1 = require("../moduleGrouper");
+const shared_1 = require("../shared");
+const documentationTemplates_1 = require("./documentationTemplates");
+const documentationTypes_1 = require("./documentationTypes");
+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, fileMapper);
+    }
+    async generateDocumentation(repoStructure, outputDir, config = {}, verbose = false) {
+        const fullConfig = {
+            focusAreas: [],
+            maxContentLength: 2000,
+            includeExamples: true,
+            enabledTypes: documentationTypes_1.DOCUMENTATION_TYPES_ARRAY,
+            ...config
+        };
+        const docsDir = path.join(outputDir, 'docs');
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '📚 Generating documentation in');
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
+        await this.generateAllDocumentation(repoStructure, moduleGroups, docsDir, fullConfig.enabledTypes || documentationTypes_1.DOCUMENTATION_TYPES_ARRAY, verbose);
+        await this.generateMainIndex(docsDir, fullConfig.enabledTypes || documentationTypes_1.DOCUMENTATION_TYPES_ARRAY, verbose);
+    }
+    async generateAllDocumentation(repoStructure, moduleGroups, docsDir, enabledTypes, verbose) {
+        shared_1.GeneratorUtils.logProgress('🧠 Generating high-level conceptual documentation...', verbose);
+        const generators = {
+            'mental-model': () => this.templates.createMentalModel(repoStructure, moduleGroups),
+            'architecture-decisions': () => this.templates.createArchitectureDecisions(repoStructure, moduleGroups),
+            'code-organization': () => this.templates.createCodeOrganization(repoStructure, moduleGroups),
+            'development-patterns': () => this.templates.createDevelopmentPatterns(repoStructure, moduleGroups),
+            'ai-guidelines': () => this.templates.createAIGuidelines(repoStructure, moduleGroups),
+            'contributing-workflows': () => this.templates.createContributingWorkflows(repoStructure, moduleGroups),
+            'domain-context': () => this.templates.createDomainContext(repoStructure, moduleGroups),
+            'software-guidelines': () => this.templates.createSoftwareGuidelines(repoStructure, moduleGroups)
+        };
+        for (const docType of enabledTypes) {
+            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 generateMainIndex(docsDir, enabledTypes, verbose) {
+        const indexContent = this.templates.createDocumentationIndex(enabledTypes);
+        const indexPath = path.join(docsDir, 'README.md');
+        await shared_1.GeneratorUtils.writeFileWithLogging(indexPath, indexContent, verbose, 'Generated 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.templates.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.templates.createAIGuidelines(repoStructure, moduleGroups);
+        const filePath = path.join(docsDir, 'ai-guidelines.md');
+        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated AI Guidelines');
+    }
+    async generateArchitectureDecisionsOnly(repoStructure, outputDir, verbose = false) {
+        const docsDir = path.join(outputDir, 'docs');
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '🏗️ Generating architecture decisions documentation');
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
+        const content = await this.templates.createArchitectureDecisions(repoStructure, moduleGroups);
+        const filePath = path.join(docsDir, 'architecture-decisions.md');
+        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated Architecture Decisions');
+    }
+    async generateSoftwareGuidelinesOnly(repoStructure, outputDir, verbose = false) {
+        const docsDir = path.join(outputDir, 'docs');
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(docsDir, verbose, '📋 Generating software development guidelines');
+        const moduleGroups = this.moduleGrouper.getModuleGroups(repoStructure);
+        const content = await this.templates.createSoftwareGuidelines(repoStructure, moduleGroups);
+        const filePath = path.join(docsDir, 'software-guidelines.md');
+        await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, 'Generated Software Development Guidelines');
+    }
+}
+exports.DocumentationGenerator = DocumentationGenerator;
+//# sourceMappingURL=documentationGenerator.js.map

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

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

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

@@ -0,0 +1,21 @@
+import { RepoStructure } from '../../types';
+import { BaseLLMClient } from '../../services/baseLLMClient';
+import { ModuleGroup } from '../moduleGrouper';
+import { DocumentationType } from './documentationTypes';
+export declare class DocumentationTemplates {
+    private llmClient;
+    private analyzer;
+    private guidelinesGenerator;
+    constructor(llmClient: BaseLLMClient, fileMapper?: any);
+    createMentalModel(repoStructure: RepoStructure, moduleGroups: ModuleGroup[]): Promise<string>;
+    createArchitectureDecisions(repoStructure: RepoStructure, moduleGroups: ModuleGroup[]): Promise<string>;
+    createCodeOrganization(repoStructure: RepoStructure, moduleGroups: ModuleGroup[]): Promise<string>;
+    createDevelopmentPatterns(repoStructure: RepoStructure, moduleGroups: ModuleGroup[]): Promise<string>;
+    createAIGuidelines(repoStructure: RepoStructure, moduleGroups: ModuleGroup[]): Promise<string>;
+    createContributingWorkflows(repoStructure: RepoStructure, moduleGroups: ModuleGroup[]): Promise<string>;
+    createDomainContext(repoStructure: RepoStructure, moduleGroups: ModuleGroup[]): Promise<string>;
+    createSoftwareGuidelines(repoStructure: RepoStructure, moduleGroups: ModuleGroup[]): Promise<string>;
+    createDocumentationIndex(enabledTypes: DocumentationType[]): string;
+    private buildRepoContext;
+}
+//# sourceMappingURL=documentationTemplates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentationTemplates.d.ts","sourceRoot":"","sources":["../../../src/generators/documentation/documentationTemplates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIzD,qBAAa,sBAAsB;IAIrB,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,mBAAmB,CAAsB;gBAE7B,SAAS,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,GAAG;IAKxD,iBAAiB,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA0B7F,2BAA2B,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgDvG,sBAAsB,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgDlG,yBAAyB,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA4CrG,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B9F,2BAA2B,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BvG,mBAAmB,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B/F,wBAAwB,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAmD1G,wBAAwB,CAAC,YAAY,EAAE,iBAAiB,EAAE,GAAG,MAAM;IAiEnE,OAAO,CAAC,gBAAgB;CA2BzB"}