docgen-ai 0.1.0

package/dist/core/generators/architecture.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * ============================================================================
+ * ARCHITECTURE GENERATOR
+ * ============================================================================
+ *
+ * Generates architecture documentation including:
+ * - System overview
+ * - Module relationship diagram (Mermaid)
+ * - Dependency graph
+ * - Data flow description
+ *
+ * The Mermaid diagrams render on GitHub, GitLab, and most doc platforms,
+ * making them ideal for auto-generated architecture docs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateArchitectureDocs = generateArchitectureDocs;
+const reasoner_1 = require("../../ai/reasoner");
+const helpers_1 = require("../../utils/helpers");
+const logger_1 = require("../../utils/logger");
+const log = logger_1.logger.child('ArchGen');
+async function generateArchitectureDocs(analysis, config) {
+    log.info('Generating architecture documentation...');
+    const sections = [];
+    // ── Header ───────────────────────────────────────────────────────────
+    sections.push(`# Architecture — ${analysis.name}\n`);
+    // AI-generated architecture explanation
+    const explanation = await (0, reasoner_1.explainArchitecture)(analysis, config.ai);
+    sections.push('## Overview\n');
+    sections.push(explanation + '\n');
+    // ── Module Diagram ───────────────────────────────────────────────────
+    sections.push('## Module Relationships\n');
+    sections.push(generateMermaidModuleDiagram(analysis) + '\n');
+    // ── Module Details ───────────────────────────────────────────────────
+    sections.push('## Modules\n');
+    for (const module of analysis.modules) {
+        sections.push(`### ${module.name}\n`);
+        sections.push(`- **Role:** ${module.role || 'General'}`);
+        sections.push(`- **Files:** ${module.files.length}`);
+        sections.push(`- **Lines:** ${module.totalLines}`);
+        sections.push(`- **Exports:** ${module.publicAPI.map(e => `\`${e.name}\``).join(', ') || 'None'}`);
+        if (module.dependencies.length > 0) {
+            sections.push(`- **Depends on:** ${module.dependencies.map(d => `\`${d}\``).join(', ')}`);
+        }
+        if (module.dependents.length > 0) {
+            sections.push(`- **Used by:** ${module.dependents.map(d => `\`${d}\``).join(', ')}`);
+        }
+        sections.push('');
+    }
+    // ── Dependency Graph ─────────────────────────────────────────────────
+    sections.push('## Dependency Graph\n');
+    sections.push(generateMermaidDependencyGraph(analysis) + '\n');
+    // ── External Integrations ────────────────────────────────────────────
+    const nonDevDeps = analysis.externalDependencies.filter(d => !d.isDev);
+    const categories = [...new Set(nonDevDeps.map(d => d.category))].filter(c => c !== 'utility');
+    if (categories.length > 0) {
+        sections.push('## External Integrations\n');
+        for (const cat of categories) {
+            const deps = nonDevDeps.filter(d => d.category === cat);
+            sections.push(`### ${capitalize(cat)}\n`);
+            for (const dep of deps) {
+                sections.push(`- **${dep.name}** ${dep.version || ''}`);
+            }
+            sections.push('');
+        }
+    }
+    // ── Technology Layer Diagram ──────────────────────────────────────────
+    sections.push('## Technology Stack\n');
+    sections.push(generateStackDiagram(analysis) + '\n');
+    const content = sections.join('\n');
+    return {
+        filePath: 'docs/architecture.md',
+        content,
+        generator: 'architecture',
+        generatedAt: new Date(),
+        inputHash: (0, helpers_1.hashContent)(JSON.stringify(analysis.modules.map(m => m.name))),
+    };
+}
+// ─── Mermaid Diagram Generators ──────────────────────────────────────────────
+/**
+ * Generate a Mermaid flowchart showing module relationships.
+ *
+ * LEARNING: Mermaid is a markdown-based diagramming tool. You write
+ * text like `A --> B` and it renders as a diagram. GitHub and GitLab
+ * render Mermaid blocks natively in markdown files.
+ */
+function generateMermaidModuleDiagram(analysis) {
+    const lines = ['```mermaid', 'graph TD'];
+    // Style definitions
+    const roleStyles = {
+        api: ':::api',
+        service: ':::service',
+        model: ':::model',
+        utility: ':::util',
+        config: ':::config',
+        ui: ':::ui',
+        middleware: ':::mw',
+    };
+    // Add nodes
+    for (const module of analysis.modules) {
+        const id = sanitizeMermaidId(module.name);
+        const label = `${module.name}\\n(${module.files.length} files)`;
+        const style = module.role ? roleStyles[module.role] || '' : '';
+        lines.push(`  ${id}["${label}"]${style}`);
+    }
+    // Add edges
+    const addedEdges = new Set();
+    for (const module of analysis.modules) {
+        for (const dep of module.dependencies) {
+            const fromId = sanitizeMermaidId(module.name);
+            const toId = sanitizeMermaidId(dep);
+            const edgeKey = `${fromId}-${toId}`;
+            if (!addedEdges.has(edgeKey)) {
+                lines.push(`  ${fromId} --> ${toId}`);
+                addedEdges.add(edgeKey);
+            }
+        }
+    }
+    // Class definitions for styling
+    lines.push('');
+    lines.push('  classDef api fill:#e1f5fe,stroke:#0288d1');
+    lines.push('  classDef service fill:#f3e5f5,stroke:#7b1fa2');
+    lines.push('  classDef model fill:#e8f5e9,stroke:#388e3c');
+    lines.push('  classDef util fill:#fff3e0,stroke:#f57c00');
+    lines.push('  classDef config fill:#fce4ec,stroke:#c62828');
+    lines.push('  classDef ui fill:#e0f2f1,stroke:#00695c');
+    lines.push('  classDef mw fill:#f1f8e9,stroke:#558b2f');
+    lines.push('```');
+    return lines.join('\n');
+}
+function generateMermaidDependencyGraph(analysis) {
+    const lines = ['```mermaid', 'graph LR'];
+    // Only show unique module-level dependencies
+    const edges = new Set();
+    for (const edge of analysis.dependencyGraph) {
+        const from = edge.from.split('/').slice(0, 2).join('/');
+        const to = edge.to.split('/').slice(0, 2).join('/');
+        if (from !== to) {
+            edges.add(`${from}|${to}`);
+        }
+    }
+    for (const edge of edges) {
+        const [from, to] = edge.split('|');
+        lines.push(`  ${sanitizeMermaidId(from)} --> ${sanitizeMermaidId(to)}`);
+    }
+    lines.push('```');
+    return lines.join('\n');
+}
+function generateStackDiagram(analysis) {
+    const lines = ['```mermaid', 'graph TB'];
+    // Build layer diagram
+    const hasAPI = analysis.apiEndpoints.length > 0;
+    const hasDB = analysis.externalDependencies.some(d => d.category === 'database');
+    const hasAuth = analysis.externalDependencies.some(d => d.category === 'auth');
+    if (hasAPI) {
+        lines.push('  Client["Client"] --> API["API Layer"]');
+    }
+    if (hasAuth) {
+        lines.push('  API --> Auth["Authentication"]');
+    }
+    lines.push('  API --> Services["Business Logic"]');
+    if (hasDB) {
+        const dbDeps = analysis.externalDependencies.filter(d => d.category === 'database');
+        lines.push(`  Services --> DB["Database\\n(${dbDeps.map(d => d.name).join(', ')})"]`);
+    }
+    const cloudDeps = analysis.externalDependencies.filter(d => d.category === 'cloud');
+    if (cloudDeps.length > 0) {
+        lines.push(`  Services --> Cloud["Cloud Services\\n(${cloudDeps.map(d => d.name).join(', ')})"]`);
+    }
+    lines.push('```');
+    return lines.join('\n');
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function sanitizeMermaidId(name) {
+    return name.replace(/[^a-zA-Z0-9]/g, '_');
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=architecture.js.map

package/dist/core/generators/architecture.js.map

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

package/dist/core/generators/functions.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ============================================================================
+ * FUNCTION & CLASS DOCUMENTATION GENERATOR
+ * ============================================================================
+ *
+ * Generates detailed documentation for all exported functions and classes.
+ * Also optionally generates JSDoc/docstring inserts for source code.
+ */
+import { ProjectAnalysis, DocgenConfig, GeneratedDoc } from '../../types/definitions';
+export declare function generateFunctionDocs(analysis: ProjectAnalysis, config: DocgenConfig): Promise<GeneratedDoc[]>;
+//# sourceMappingURL=functions.d.ts.map

package/dist/core/generators/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../../src/core/generators/functions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAA2B,MAAM,yBAAyB,CAAC;AAI/G,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CAsDzB"}

package/dist/core/generators/functions.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * ============================================================================
+ * FUNCTION & CLASS DOCUMENTATION GENERATOR
+ * ============================================================================
+ *
+ * Generates detailed documentation for all exported functions and classes.
+ * Also optionally generates JSDoc/docstring inserts for source code.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFunctionDocs = generateFunctionDocs;
+const reasoner_1 = require("../../ai/reasoner");
+async function generateFunctionDocs(analysis, config) {
+    const docs = [];
+    // Group functions and classes by file
+    for (const file of analysis.files) {
+        const exportedFuncs = file.functions.filter(f => f.isExported);
+        const exportedClasses = file.classes.filter(c => c.isExported);
+        if (exportedFuncs.length === 0 && exportedClasses.length === 0)
+            continue;
+        const sections = [];
+        sections.push(`# ${file.relativePath}\n`);
+        sections.push(`**Language:** ${file.language} | **Lines:** ${file.lineCount}\n`);
+        // Imports summary
+        if (file.imports.length > 0) {
+            const external = file.imports.filter(i => !i.isRelative);
+            const internal = file.imports.filter(i => i.isRelative);
+            if (external.length > 0) {
+                sections.push(`**External imports:** ${external.map(i => `\`${i.source}\``).join(', ')}`);
+            }
+            if (internal.length > 0) {
+                sections.push(`**Internal imports:** ${internal.map(i => `\`${i.source}\``).join(', ')}`);
+            }
+            sections.push('');
+        }
+        // Functions
+        if (exportedFuncs.length > 0) {
+            sections.push('## Functions\n');
+            for (const func of exportedFuncs) {
+                sections.push(formatFunctionDoc(func));
+            }
+        }
+        // Classes
+        if (exportedClasses.length > 0) {
+            sections.push('## Classes\n');
+            for (const cls of exportedClasses) {
+                sections.push(formatClassDoc(cls));
+            }
+        }
+        const safeName = file.relativePath.replace(/[^a-zA-Z0-9]/g, '-').replace(/-+/g, '-');
+        docs.push({
+            filePath: `docs/functions/${safeName}.md`,
+            content: sections.join('\n'),
+            generator: 'functions',
+            generatedAt: new Date(),
+            inputHash: file.contentHash,
+        });
+    }
+    return docs;
+}
+function formatFunctionDoc(func) {
+    const lines = [];
+    const asyncPrefix = func.isAsync ? 'async ' : '';
+    const params = func.params.map(p => {
+        let s = p.name;
+        if (p.type)
+            s += `: ${p.type}`;
+        if (p.isOptional)
+            s += '?';
+        if (p.defaultValue)
+            s += ` = ${p.defaultValue}`;
+        return s;
+    }).join(', ');
+    lines.push(`### \`${asyncPrefix}${func.name}(${params})\`\n`);
+    if (func.returnType) {
+        lines.push(`**Returns:** \`${func.returnType}\`\n`);
+    }
+    if (func.decorators.length > 0) {
+        lines.push(`**Decorators:** ${func.decorators.join(', ')}\n`);
+    }
+    if (func.complexity > 5) {
+        lines.push(`**Complexity:** ${func.complexity} ⚠️ (consider refactoring)\n`);
+    }
+    // Description
+    if (func.existingDoc) {
+        lines.push(`${cleanDoc(func.existingDoc)}\n`);
+    }
+    else {
+        lines.push(`${(0, reasoner_1.staticFunctionSummary)(func)}\n`);
+    }
+    // Parameters table
+    if (func.params.length > 0) {
+        lines.push('**Parameters:**\n');
+        lines.push('| Name | Type | Optional | Default | Description |');
+        lines.push('|------|------|:--------:|---------|-------------|');
+        for (const p of func.params) {
+            const opt = p.isOptional ? '✓' : '—';
+            const def = p.defaultValue || '—';
+            const desc = p.description || '—';
+            lines.push(`| \`${p.name}\` | \`${p.type || 'any'}\` | ${opt} | ${def} | ${desc} |`);
+        }
+        lines.push('');
+    }
+    lines.push(`📍 Defined at line ${func.startLine}–${func.endLine}\n`);
+    lines.push('---\n');
+    return lines.join('\n');
+}
+function formatClassDoc(cls) {
+    const lines = [];
+    lines.push(`### \`class ${cls.name}\`\n`);
+    if (cls.superClass)
+        lines.push(`**Extends:** \`${cls.superClass}\`\n`);
+    if (cls.implements.length > 0)
+        lines.push(`**Implements:** ${cls.implements.map(i => `\`${i}\``).join(', ')}\n`);
+    if (cls.decorators.length > 0)
+        lines.push(`**Decorators:** ${cls.decorators.join(', ')}\n`);
+    if (cls.existingDoc)
+        lines.push(`${cleanDoc(cls.existingDoc)}\n`);
+    // Properties
+    if (cls.properties.length > 0) {
+        lines.push('**Properties:**\n');
+        for (const prop of cls.properties) {
+            const vis = prop.isPrivate ? '🔒' : '🔓';
+            const stat = prop.isStatic ? ' (static)' : '';
+            lines.push(`- ${vis} \`${prop.name}\`: \`${prop.type || 'any'}\`${stat}`);
+        }
+        lines.push('');
+    }
+    // Methods
+    if (cls.methods.length > 0) {
+        lines.push('**Methods:**\n');
+        for (const method of cls.methods) {
+            const params = method.params.map(p => p.name).join(', ');
+            const ret = method.returnType ? ` → \`${method.returnType}\`` : '';
+            const asyncStr = method.isAsync ? 'async ' : '';
+            lines.push(`- \`${asyncStr}${method.name}(${params})\`${ret}`);
+        }
+        lines.push('');
+    }
+    lines.push(`📍 Defined at line ${cls.startLine}–${cls.endLine}\n`);
+    lines.push('---\n');
+    return lines.join('\n');
+}
+/** Clean up JSDoc/docstring formatting */
+function cleanDoc(doc) {
+    return doc
+        .replace(/^\s*\*\s?/gm, '') // Remove JSDoc * prefixes
+        .replace(/@\w+/g, '') // Remove @tags (handled separately)
+        .trim();
+}
+//# sourceMappingURL=functions.js.map

package/dist/core/generators/functions.js.map

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

package/dist/core/generators/integrations.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ============================================================================
+ * INTEGRATIONS DOCUMENTATION GENERATOR
+ * ============================================================================
+ */
+import { ProjectAnalysis, DocgenConfig, GeneratedDoc } from '../../types/definitions';
+export declare function generateIntegrationsDocs(analysis: ProjectAnalysis, config: DocgenConfig): Promise<GeneratedDoc>;
+//# sourceMappingURL=integrations.d.ts.map

package/dist/core/generators/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../../src/core/generators/integrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGtF,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,CAAC,CA+CvB"}

package/dist/core/generators/integrations.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * ============================================================================
+ * INTEGRATIONS DOCUMENTATION GENERATOR
+ * ============================================================================
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateIntegrationsDocs = generateIntegrationsDocs;
+const helpers_1 = require("../../utils/helpers");
+async function generateIntegrationsDocs(analysis, config) {
+    const sections = [];
+    sections.push(`# Integrations & Dependencies — ${analysis.name}\n`);
+    const nonDevDeps = analysis.externalDependencies.filter(d => !d.isDev);
+    const categories = [...new Set(nonDevDeps.map(d => d.category))];
+    const priorityOrder = ['database', 'auth', 'payment', 'cloud', 'messaging', 'http', 'framework'];
+    categories.sort((a, b) => {
+        const ai = priorityOrder.indexOf(a);
+        const bi = priorityOrder.indexOf(b);
+        return (ai === -1 ? 99 : ai) - (bi === -1 ? 99 : bi);
+    });
+    for (const category of categories) {
+        const deps = nonDevDeps.filter(d => d.category === category);
+        sections.push(`## ${category.charAt(0).toUpperCase() + category.slice(1)}\n`);
+        for (const dep of deps) {
+            sections.push(`- **${dep.name}** ${dep.version || ''}`);
+        }
+        sections.push('');
+    }
+    const devDeps = analysis.externalDependencies.filter(d => d.isDev);
+    if (devDeps.length > 0) {
+        sections.push('## Dev Dependencies\n');
+        for (const dep of devDeps) {
+            sections.push(`- \`${dep.name}\` (${dep.category})`);
+        }
+        sections.push('');
+    }
+    const infraConfigs = analysis.configFiles.filter(c => ['docker', 'ci', 'infrastructure'].includes(c.type));
+    if (infraConfigs.length > 0) {
+        sections.push('## Infrastructure\n');
+        for (const cfg of infraConfigs) {
+            sections.push(`- **${cfg.path}** — ${cfg.description}`);
+        }
+        sections.push('');
+    }
+    return {
+        filePath: 'docs/integrations.md',
+        content: sections.join('\n'),
+        generator: 'integrations',
+        generatedAt: new Date(),
+        inputHash: (0, helpers_1.hashContent)(analysis.externalDependencies.map(d => d.name).join(',')),
+    };
+}
+//# sourceMappingURL=integrations.js.map

package/dist/core/generators/integrations.js.map

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

package/dist/core/generators/modules.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ============================================================================
+ * MODULE DOCUMENTATION GENERATOR
+ * ============================================================================
+ *
+ * Generates a documentation page for each significant module.
+ * Output: docs/modules/{module-name}.md
+ */
+import { ProjectAnalysis, DocgenConfig, GeneratedDoc } from '../../types/definitions';
+export declare function generateModuleDocs(analysis: ProjectAnalysis, config: DocgenConfig): Promise<GeneratedDoc[]>;
+//# sourceMappingURL=modules.d.ts.map

package/dist/core/generators/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../../src/core/generators/modules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAc,MAAM,yBAAyB,CAAC;AAOlG,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,EAAE,CAAC,CAiBzB"}

package/dist/core/generators/modules.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * ============================================================================
+ * MODULE DOCUMENTATION GENERATOR
+ * ============================================================================
+ *
+ * Generates a documentation page for each significant module.
+ * Output: docs/modules/{module-name}.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateModuleDocs = generateModuleDocs;
+const reasoner_1 = require("../../ai/reasoner");
+const helpers_1 = require("../../utils/helpers");
+const logger_1 = require("../../utils/logger");
+const log = logger_1.logger.child('ModuleGen');
+async function generateModuleDocs(analysis, config) {
+    log.info(`Generating documentation for ${analysis.modules.length} modules...`);
+    const docs = [];
+    // Generate index page
+    docs.push(generateModuleIndex(analysis));
+    // Generate per-module docs
+    for (const module of analysis.modules) {
+        if (module.files.length < 1)
+            continue; // Skip empty modules
+        const doc = await generateSingleModuleDoc(module, config);
+        docs.push(doc);
+    }
+    return docs;
+}
+function generateModuleIndex(analysis) {
+    const sections = [];
+    sections.push('# Modules\n');
+    sections.push('This project is organized into the following modules:\n');
+    sections.push('| Module | Role | Files | Lines | Dependencies |');
+    sections.push('|--------|------|-------|-------|-------------|');
+    for (const module of analysis.modules) {
+        const link = `[${module.name}](./modules/${sanitizeFilename(module.name)}.md)`;
+        const role = module.role || '—';
+        const deps = module.dependencies.length || 0;
+        sections.push(`| ${link} | ${role} | ${module.files.length} | ${module.totalLines} | ${deps} |`);
+    }
+    return {
+        filePath: 'docs/modules/index.md',
+        content: sections.join('\n'),
+        generator: 'modules',
+        generatedAt: new Date(),
+        inputHash: (0, helpers_1.hashContent)(analysis.modules.map(m => m.name).join(',')),
+    };
+}
+async function generateSingleModuleDoc(module, config) {
+    const sections = [];
+    // Header
+    sections.push(`# Module: ${module.name}\n`);
+    // Role badge
+    if (module.role) {
+        sections.push(`> **Role:** ${module.role}\n`);
+    }
+    // Description
+    const description = config.ai.enabled
+        ? await (0, reasoner_1.summarizeModule)(module, config.ai)
+        : (0, reasoner_1.staticModuleSummary)(module);
+    sections.push('## Overview\n');
+    sections.push(description + '\n');
+    // Files
+    sections.push('## Files\n');
+    for (const file of module.files) {
+        const funcCount = file.functions.length;
+        const classCount = file.classes.length;
+        const meta = [];
+        if (funcCount > 0)
+            meta.push(`${funcCount} functions`);
+        if (classCount > 0)
+            meta.push(`${classCount} classes`);
+        sections.push(`- \`${file.relativePath}\` — ${meta.join(', ') || `${file.lineCount} lines`}`);
+    }
+    sections.push('');
+    // Public API
+    if (module.publicAPI.length > 0) {
+        sections.push('## Public API\n');
+        for (const exp of module.publicAPI) {
+            sections.push(`- \`${exp.type}\` **${exp.name}**${exp.isDefault ? ' (default)' : ''}`);
+        }
+        sections.push('');
+    }
+    // Key Functions
+    const allFunctions = module.files.flatMap(f => f.functions).filter(f => f.isExported);
+    if (allFunctions.length > 0) {
+        sections.push('## Key Functions\n');
+        for (const func of allFunctions.slice(0, 20)) {
+            const params = func.params.map(p => `${p.name}${p.type ? ': ' + p.type : ''}`).join(', ');
+            sections.push(`### \`${func.name}(${params})\`\n`);
+            if (func.returnType) {
+                sections.push(`**Returns:** \`${func.returnType}\`\n`);
+            }
+            const summary = (0, reasoner_1.staticFunctionSummary)(func);
+            sections.push(summary + '\n');
+        }
+    }
+    // Classes
+    const allClasses = module.files.flatMap(f => f.classes);
+    if (allClasses.length > 0) {
+        sections.push('## Classes\n');
+        for (const cls of allClasses) {
+            sections.push(`### \`${cls.name}\`\n`);
+            if (cls.superClass)
+                sections.push(`**Extends:** \`${cls.superClass}\`\n`);
+            if (cls.implements.length > 0)
+                sections.push(`**Implements:** ${cls.implements.map(i => `\`${i}\``).join(', ')}\n`);
+            if (cls.methods.length > 0) {
+                sections.push('**Methods:**\n');
+                for (const method of cls.methods) {
+                    const params = method.params.map(p => p.name).join(', ');
+                    const vis = method.name.startsWith('_') ? '🔒' : '🔓';
+                    sections.push(`- ${vis} \`${method.name}(${params})\`${method.returnType ? ` → \`${method.returnType}\`` : ''}`);
+                }
+                sections.push('');
+            }
+        }
+    }
+    // Dependencies
+    if (module.dependencies.length > 0) {
+        sections.push('## Dependencies\n');
+        sections.push('This module depends on:\n');
+        for (const dep of module.dependencies) {
+            sections.push(`- [\`${dep}\`](./modules/${sanitizeFilename(dep)}.md)`);
+        }
+        sections.push('');
+    }
+    // Dependents
+    if (module.dependents.length > 0) {
+        sections.push('## Used By\n');
+        for (const dep of module.dependents) {
+            sections.push(`- [\`${dep}\`](./modules/${sanitizeFilename(dep)}.md)`);
+        }
+        sections.push('');
+    }
+    return {
+        filePath: `docs/modules/${sanitizeFilename(module.name)}.md`,
+        content: sections.join('\n'),
+        generator: 'modules',
+        generatedAt: new Date(),
+        inputHash: (0, helpers_1.hashContent)(module.files.map(f => f.contentHash).join(',')),
+    };
+}
+function sanitizeFilename(name) {
+    return name.replace(/[^a-zA-Z0-9-]/g, '-').replace(/-+/g, '-');
+}
+//# sourceMappingURL=modules.js.map

package/dist/core/generators/modules.js.map

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