docgen-ai 0.1.0

package/README.md

@@ -0,0 +1,101 @@
+# @docgen/cli
+
+> Autonomous Codebase Documentation Platform — AI-powered technical documentation generator
+
+[AI summarization disabled — enable in config to get human-readable descriptions]
+
+## Technology Stack
+
+**Languages:**
+
+- Typescript — 21 files (100%)
+
+**Frameworks & Libraries:**
+
+- Express
+
+**Key Dependencies:**
+
+- **Framework:** express
+- **Logging:** winston
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js >= 18.0.0
+
+### Installation
+
+```bash
+# Clone the repository
+git clone <repository-url>
+cd @docgen/cli
+
+# Install dependencies
+npm install
+```
+
+### Environment Variables
+
+Create a `.env` file in the project root:
+
+```env
+ANTHROPIC_API_KEY=<required>
+DOCGEN_AI_KEY=<required>
+DOCGEN_AI_PROVIDER=<required>
+DOCGEN_AI_MODEL=<required>
+DOCGEN_OUTPUT_DIR=<required>
+DOCGEN_LOG_LEVEL=<required>
+```
+
+### Running the Application
+
+```bash
+# Development
+npm run dev
+
+# Production
+npm start
+```
+
+## API Overview
+
+This project exposes 1 API endpoint.
+
+| Method | Path | Handler | Auth |
+|--------|------|---------|------|
+| `GET` | `*` | anonymous | — |
+
+## Project Structure
+
+```
+ai/  (1 files)
+cli/  (1 files — api)
+config/  (1 files — config)
+core/analyzers/  (1 files)
+core/cache/  (1 files)
+core/generators/  (8 files)
+core/parsers/  (3 files)
+core/  (1 files)
+root/  (1 files)
+types/  (1 files)
+utils/  (2 files — utility)
+```
+
+## Infrastructure
+
+- **.github/workflows** — GitHub Actions CI/CD
+- **tsconfig.json** — TypeScript config
+
+## Testing
+
+Testing framework: jest, ts-jest
+
+```bash
+npm test
+```
+
+---
+
+*Documentation generated by [docgen](https://github.com/docgen) on 2026-03-19*

package/dist/ai/reasoner.d.ts

@@ -0,0 +1,47 @@
+/**
+ * ============================================================================
+ * AI REASONING LAYER
+ * ============================================================================
+ *
+ * CRITICAL ARCHITECTURE DECISION:
+ * The AI layer ONLY summarizes and explains. It never invents facts.
+ *
+ *   AST Analysis → provides FACTS (function names, params, types, imports)
+ *   AI Layer    → provides EXPLANATION (what it does, why it matters)
+ *
+ * This "grounded generation" approach prevents hallucination.
+ * The AI can't claim a function takes 3 params when the AST says it takes 2.
+ *
+ * HOW IT WORKS:
+ * 1. Receive structured data (from analyzers)
+ * 2. Build a prompt that includes the FACTS
+ * 3. Ask the LLM to explain those facts in human-readable form
+ * 4. Return the explanation
+ *
+ * LEARNING: This is the same pattern used in RAG (Retrieval-Augmented
+ * Generation) — you retrieve facts first, then generate based on those facts.
+ */
+import { ProjectAnalysis, ModuleInfo, FunctionInfo, AIConfig } from '../types/definitions';
+/**
+ * Generate a high-level project overview.
+ */
+export declare function summarizeProject(analysis: ProjectAnalysis, config: AIConfig): Promise<string>;
+/**
+ * Generate a module description.
+ */
+export declare function summarizeModule(module: ModuleInfo, config: AIConfig): Promise<string>;
+/**
+ * Generate a function documentation block.
+ */
+export declare function summarizeFunction(func: FunctionInfo, config: AIConfig): Promise<string>;
+/**
+ * Generate architecture explanation.
+ */
+export declare function explainArchitecture(analysis: ProjectAnalysis, config: AIConfig): Promise<string>;
+/**
+ * Batch-summarize when AI is disabled — returns static analysis descriptions.
+ * This ensures the tool is still useful without an API key.
+ */
+export declare function staticModuleSummary(module: ModuleInfo): string;
+export declare function staticFunctionSummary(func: FunctionInfo): string;
+//# sourceMappingURL=reasoner.d.ts.map

package/dist/ai/reasoner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoner.d.ts","sourceRoot":"","sources":["../../src/ai/reasoner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EACL,eAAe,EAAE,UAAU,EAAE,YAAY,EAC5B,QAAQ,EACtB,MAAM,sBAAsB,CAAC;AAkG9B;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAS9D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAOhE"}

package/dist/ai/reasoner.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * ============================================================================
+ * AI REASONING LAYER
+ * ============================================================================
+ *
+ * CRITICAL ARCHITECTURE DECISION:
+ * The AI layer ONLY summarizes and explains. It never invents facts.
+ *
+ *   AST Analysis → provides FACTS (function names, params, types, imports)
+ *   AI Layer    → provides EXPLANATION (what it does, why it matters)
+ *
+ * This "grounded generation" approach prevents hallucination.
+ * The AI can't claim a function takes 3 params when the AST says it takes 2.
+ *
+ * HOW IT WORKS:
+ * 1. Receive structured data (from analyzers)
+ * 2. Build a prompt that includes the FACTS
+ * 3. Ask the LLM to explain those facts in human-readable form
+ * 4. Return the explanation
+ *
+ * LEARNING: This is the same pattern used in RAG (Retrieval-Augmented
+ * Generation) — you retrieve facts first, then generate based on those facts.
+ */
+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.summarizeProject = summarizeProject;
+exports.summarizeModule = summarizeModule;
+exports.summarizeFunction = summarizeFunction;
+exports.explainArchitecture = explainArchitecture;
+exports.staticModuleSummary = staticModuleSummary;
+exports.staticFunctionSummary = staticFunctionSummary;
+const https = __importStar(require("https"));
+const logger_1 = require("../utils/logger");
+const helpers_1 = require("../utils/helpers");
+const log = logger_1.logger.child('AI');
+// ─── AI Client ───────────────────────────────────────────────────────────────
+/**
+ * Simple HTTP client for the Anthropic API.
+ *
+ * WHY not use the SDK? To minimize dependencies and make the AI
+ * layer easy to swap out. The raw API is simple enough.
+ *
+ * For production, you'd use the official @anthropic-ai/sdk package.
+ */
+async function callLLM(prompt, systemPrompt, config) {
+    if (!config.enabled) {
+        return '[AI summarization disabled — enable in config to get human-readable descriptions]';
+    }
+    const apiKey = config.apiKey || process.env.ANTHROPIC_API_KEY || process.env.DOCGEN_AI_KEY;
+    if (!apiKey) {
+        log.warn('No AI API key configured. Set ANTHROPIC_API_KEY or DOCGEN_AI_KEY env var.');
+        return '[No API key configured — summaries unavailable]';
+    }
+    try {
+        const body = JSON.stringify({
+            model: config.model,
+            max_tokens: config.maxTokens,
+            temperature: config.temperature,
+            system: systemPrompt,
+            messages: [{ role: 'user', content: prompt }],
+        });
+        const response = await httpPost('api.anthropic.com', '/v1/messages', body, {
+            'Content-Type': 'application/json',
+            'x-api-key': apiKey,
+            'anthropic-version': '2023-06-01',
+        });
+        const parsed = JSON.parse(response);
+        if (parsed.content && parsed.content[0]) {
+            return parsed.content[0].text;
+        }
+        log.warn('Unexpected AI response format');
+        return '[AI response unavailable]';
+    }
+    catch (err) {
+        log.error('AI call failed', { error: err.message });
+        return '[AI summarization failed — using static analysis only]';
+    }
+}
+function httpPost(hostname, path, body, headers) {
+    return new Promise((resolve, reject) => {
+        const req = https.request({ hostname, path, method: 'POST', headers: { ...headers, 'Content-Length': Buffer.byteLength(body) } }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => (data += chunk));
+            res.on('end', () => resolve(data));
+        });
+        req.on('error', reject);
+        req.write(body);
+        req.end();
+    });
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+const SYSTEM_PROMPT = `You are a technical documentation writer. You write clear, concise, accurate documentation for software engineers.
+
+RULES:
+- Only describe what the code ACTUALLY does based on the provided analysis data
+- Never invent features, parameters, or behaviors not in the data
+- Use precise technical language
+- Be concise — no fluff
+- Write in present tense ("handles", "returns", not "will handle")
+- Use markdown formatting`;
+/**
+ * Generate a high-level project overview.
+ */
+async function summarizeProject(analysis, config) {
+    const prompt = `Generate a concise project overview for "${analysis.name}".
+
+FACTS from analysis:
+- Languages: ${analysis.languages.map(l => `${l.language} (${l.percentage}%)`).join(', ')}
+- Frameworks: ${analysis.frameworks.map(f => f.framework).join(', ') || 'None detected'}
+- Total files: ${analysis.files.length}
+- Modules: ${analysis.modules.map(m => m.name).join(', ')}
+- API endpoints: ${analysis.apiEndpoints.length}
+- External deps: ${analysis.externalDependencies.filter(d => !d.isDev).length} production, ${analysis.externalDependencies.filter(d => d.isDev).length} dev
+- Description from package.json: ${analysis.description || 'Not provided'}
+
+Write a 2-3 paragraph overview explaining what this project is and how it's structured. Only reference what's in the facts above.`;
+    return callLLM(prompt, SYSTEM_PROMPT, config);
+}
+/**
+ * Generate a module description.
+ */
+async function summarizeModule(module, config) {
+    const fileList = module.files.map(f => f.relativePath).join('\n  ');
+    const exports = module.publicAPI.map(e => `${e.type}: ${e.name}`).join(', ');
+    const deps = module.dependencies.join(', ') || 'None';
+    const prompt = `Describe the "${module.name}" module.
+
+FACTS:
+- Files:\n  ${fileList}
+- Role: ${module.role || 'unknown'}
+- Public exports: ${exports || 'None'}
+- Dependencies: ${deps}
+- Dependents: ${module.dependents.join(', ') || 'None'}
+- Lines of code: ${module.totalLines}
+
+Write a 1-2 paragraph description of this module's purpose and responsibilities. Only reference what's in the facts.`;
+    return callLLM(prompt, SYSTEM_PROMPT, config);
+}
+/**
+ * Generate a function documentation block.
+ */
+async function summarizeFunction(func, config) {
+    const params = func.params.map(p => `${p.name}${p.type ? ': ' + p.type : ''}${p.isOptional ? ' (optional)' : ''}${p.defaultValue ? ' = ' + p.defaultValue : ''}`).join(', ');
+    const prompt = `Document the function "${func.name}".
+
+FACTS:
+- Parameters: ${params || 'none'}
+- Returns: ${func.returnType || 'unknown'}
+- Async: ${func.isAsync}
+- Complexity: ${func.complexity}
+- Decorators: ${func.decorators.join(', ') || 'None'}
+${func.className ? `- Class: ${func.className}` : ''}
+${func.existingDoc ? `- Existing doc: ${func.existingDoc}` : ''}
+${func.body ? `- Source:\n\`\`\`\n${(0, helpers_1.truncate)(func.body, 500)}\n\`\`\`` : ''}
+
+Write a brief (2-3 sentences) description of what this function does and when to use it. Only reference what's in the facts and source code.`;
+    return callLLM(prompt, SYSTEM_PROMPT, config);
+}
+/**
+ * Generate architecture explanation.
+ */
+async function explainArchitecture(analysis, config) {
+    const moduleDescriptions = analysis.modules.map(m => `- ${m.name} (${m.role || 'unknown'}): ${m.files.length} files, depends on [${m.dependencies.join(', ')}]`).join('\n');
+    const prompt = `Explain the architecture of "${analysis.name}".
+
+FACTS:
+Modules:
+${moduleDescriptions}
+
+Frameworks: ${analysis.frameworks.map(f => f.framework).join(', ')}
+API endpoints: ${analysis.apiEndpoints.length}
+External services: ${analysis.externalDependencies.filter(d => !d.isDev).map(d => `${d.name} (${d.category})`).join(', ')}
+
+Describe:
+1. The overall architecture pattern (monolith, microservice, layered, etc.)
+2. How the modules relate to each other
+3. The data flow through the system
+
+Only reference what's in the facts above. Be specific.`;
+    return callLLM(prompt, SYSTEM_PROMPT, config);
+}
+/**
+ * Batch-summarize when AI is disabled — returns static analysis descriptions.
+ * This ensures the tool is still useful without an API key.
+ */
+function staticModuleSummary(module) {
+    const fileCount = module.files.length;
+    const exportCount = module.publicAPI.length;
+    const roleStr = module.role ? `Serves as a **${module.role}** layer.` : '';
+    return `The \`${module.name}\` module contains ${fileCount} file${fileCount !== 1 ? 's' : ''} ` +
+        `and exports ${exportCount} public symbol${exportCount !== 1 ? 's' : ''}. ${roleStr} ` +
+        `Dependencies: ${module.dependencies.length > 0 ? module.dependencies.join(', ') : 'none'}. ` +
+        `Used by: ${module.dependents.length > 0 ? module.dependents.join(', ') : 'none'}.`;
+}
+function staticFunctionSummary(func) {
+    const params = func.params.map(p => p.name + (p.type ? `: ${p.type}` : '')).join(', ');
+    const asyncStr = func.isAsync ? 'Async function' : 'Function';
+    const returnStr = func.returnType ? ` Returns \`${func.returnType}\`.` : '';
+    return `${asyncStr} \`${func.name}(${params})\`.${returnStr}` +
+        (func.complexity > 5 ? ' ⚠️ High complexity.' : '');
+}
+//# sourceMappingURL=reasoner.js.map

package/dist/ai/reasoner.js.map

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

package/dist/cli/commands.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * ============================================================================
+ * DOCGEN CLI
+ * ============================================================================
+ *
+ * Command-line interface for the documentation platform.
+ *
+ * COMMANDS:
+ *   docgen init          Create config file in current project
+ *   docgen analyze       Analyze project and print report
+ *   docgen generate      Full pipeline: analyze + generate docs
+ *   docgen watch         Watch for changes and regenerate
+ *   docgen serve         Start local documentation server
+ *
+ * DESIGN: We use Commander.js for CLI parsing. Each command maps
+ * to a handler function that calls the core pipeline.
+ */
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG"}