agents-reverse-engineer 0.1.1

package/dist/generation/orchestrator.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Generation orchestrator
+ *
+ * Coordinates the documentation generation workflow:
+ * - Discovers and prepares files for analysis
+ * - Detects file types
+ * - Creates analysis tasks with prompts
+ * - Tracks token budget
+ * - Creates directory-summary tasks for LLM-generated descriptions
+ */
+import type { Config } from '../config/schema.js';
+import type { DiscoveryResult } from '../types/index.js';
+import type { FileType } from './types.js';
+import type { ComplexityMetrics } from './complexity.js';
+/**
+ * A file prepared for analysis.
+ */
+export interface PreparedFile {
+    /** Absolute path to the file */
+    filePath: string;
+    /** Relative path from project root */
+    relativePath: string;
+    /** File content */
+    content: string;
+    /** Detected file type */
+    fileType: FileType;
+    /** Token count of content */
+    tokens: number;
+    /** Whether file needs chunking */
+    needsChunking: boolean;
+}
+/**
+ * Analysis task for a file or chunk.
+ */
+export interface AnalysisTask {
+    /** Type of task */
+    type: 'file' | 'chunk' | 'synthesis' | 'directory-summary';
+    /** File or directory path */
+    filePath: string;
+    /** System prompt */
+    systemPrompt: string;
+    /** User prompt */
+    userPrompt: string;
+    /** Estimated tokens for this task */
+    estimatedTokens: number;
+    /** Chunk info if applicable */
+    chunkInfo?: {
+        index: number;
+        total: number;
+        startLine: number;
+        endLine: number;
+    };
+    /** Directory info for directory-summary tasks */
+    directoryInfo?: {
+        /** Paths of .sum files in this directory */
+        sumFiles: string[];
+        /** Number of files analyzed */
+        fileCount: number;
+    };
+}
+/**
+ * Result of the generation planning process.
+ */
+export interface GenerationPlan {
+    /** Files to be analyzed */
+    files: PreparedFile[];
+    /** Analysis tasks to execute */
+    tasks: AnalysisTask[];
+    /** Complexity metrics */
+    complexity: ComplexityMetrics;
+    /** Whether to generate ARCHITECTURE.md */
+    generateArchitecture: boolean;
+    /** Whether to generate STACK.md */
+    generateStack: boolean;
+    /** Budget tracker state */
+    budget: {
+        total: number;
+        estimated: number;
+        remaining: number;
+    };
+    /** Files skipped due to budget */
+    skippedFiles: string[];
+}
+/**
+ * Orchestrates the documentation generation workflow.
+ */
+export declare class GenerationOrchestrator {
+    private config;
+    private projectRoot;
+    private budgetTracker;
+    constructor(config: Config, projectRoot: string, totalFiles: number);
+    /**
+     * Prepare files for analysis by reading content and detecting types.
+     */
+    prepareFiles(discoveryResult: DiscoveryResult): Promise<PreparedFile[]>;
+    /**
+     * Create analysis tasks for files within budget.
+     */
+    createTasks(files: PreparedFile[]): {
+        tasks: AnalysisTask[];
+        skipped: string[];
+    };
+    /**
+     * Create directory-summary tasks for LLM-generated directory descriptions.
+     * These tasks run after all files in a directory are analyzed, allowing
+     * the LLM to synthesize a richer directory overview from the .sum files.
+     */
+    createDirectorySummaryTasks(files: PreparedFile[]): AnalysisTask[];
+    /**
+     * Create a complete generation plan.
+     */
+    createPlan(discoveryResult: DiscoveryResult): Promise<GenerationPlan>;
+    /**
+     * Check if package.json exists in project root.
+     */
+    private hasPackageJson;
+    /**
+     * Get budget report.
+     */
+    getBudgetReport(): import("./budget/tracker.js").BudgetReport;
+}
+/**
+ * Create a generation orchestrator with default config.
+ */
+export declare function createOrchestrator(config: Config, projectRoot: string, totalFiles: number): GenerationOrchestrator;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/generation/orchestrator.d.ts.map

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

package/dist/generation/orchestrator.js

@@ -0,0 +1,222 @@
+/**
+ * Generation orchestrator
+ *
+ * Coordinates the documentation generation workflow:
+ * - Discovers and prepares files for analysis
+ * - Detects file types
+ * - Creates analysis tasks with prompts
+ * - Tracks token budget
+ * - Creates directory-summary tasks for LLM-generated descriptions
+ */
+import { readFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { detectFileType } from './detection/detector.js';
+import { BudgetTracker, countTokens, needsChunking, chunkFile } from './budget/index.js';
+import { buildPrompt, buildChunkPrompt } from './prompts/index.js';
+import { analyzeComplexity, shouldGenerateArchitecture, shouldGenerateStack } from './complexity.js';
+/**
+ * Orchestrates the documentation generation workflow.
+ */
+export class GenerationOrchestrator {
+    config;
+    projectRoot;
+    budgetTracker;
+    constructor(config, projectRoot, totalFiles) {
+        this.config = config;
+        this.projectRoot = projectRoot;
+        this.budgetTracker = new BudgetTracker(config.generation.tokenBudget, totalFiles);
+    }
+    /**
+     * Prepare files for analysis by reading content and detecting types.
+     */
+    async prepareFiles(discoveryResult) {
+        const prepared = [];
+        for (const filePath of discoveryResult.files) {
+            try {
+                const content = await readFile(filePath, 'utf-8');
+                const tokens = countTokens(content);
+                const fileType = detectFileType(filePath, content);
+                const relativePath = path.relative(this.projectRoot, filePath);
+                prepared.push({
+                    filePath,
+                    relativePath,
+                    content,
+                    fileType,
+                    tokens,
+                    needsChunking: needsChunking(content, this.config.generation.chunkSize),
+                });
+            }
+            catch {
+                // Skip files that can't be read (permission errors, etc.)
+                // Silently ignore - these files won't appear in the plan
+            }
+        }
+        // Sort by token count (smaller files first for breadth-first coverage)
+        return prepared.sort((a, b) => a.tokens - b.tokens);
+    }
+    /**
+     * Create analysis tasks for files within budget.
+     */
+    createTasks(files) {
+        const tasks = [];
+        const skipped = [];
+        for (const file of files) {
+            const promptOverhead = 600; // Approximate overhead for prompts
+            const estimatedTotal = file.tokens + promptOverhead;
+            if (!this.budgetTracker.canProcess(estimatedTotal)) {
+                this.budgetTracker.recordSkipped(file.relativePath);
+                skipped.push(file.relativePath);
+                continue;
+            }
+            if (file.needsChunking) {
+                // Create chunk tasks
+                const chunks = chunkFile(file.content, {
+                    chunkSize: this.config.generation.chunkSize,
+                });
+                for (const chunk of chunks) {
+                    const chunkPrompt = buildChunkPrompt({
+                        filePath: file.filePath,
+                        content: chunk.content,
+                        fileType: file.fileType,
+                        chunkIndex: chunk.index,
+                        totalChunks: chunks.length,
+                        lineRange: { start: chunk.startLine, end: chunk.endLine },
+                    });
+                    tasks.push({
+                        type: 'chunk',
+                        filePath: file.relativePath,
+                        systemPrompt: chunkPrompt.system,
+                        userPrompt: chunkPrompt.user,
+                        estimatedTokens: chunk.tokens + promptOverhead,
+                        chunkInfo: {
+                            index: chunk.index,
+                            total: chunks.length,
+                            startLine: chunk.startLine,
+                            endLine: chunk.endLine,
+                        },
+                    });
+                }
+                // Add synthesis task (will be executed after chunks)
+                tasks.push({
+                    type: 'synthesis',
+                    filePath: file.relativePath,
+                    systemPrompt: '', // Will be set during execution
+                    userPrompt: `Synthesize summaries for ${file.relativePath}`,
+                    estimatedTokens: promptOverhead,
+                });
+            }
+            else {
+                // Single file task
+                const prompt = buildPrompt({
+                    filePath: file.filePath,
+                    content: file.content,
+                    fileType: file.fileType,
+                });
+                tasks.push({
+                    type: 'file',
+                    filePath: file.relativePath,
+                    systemPrompt: prompt.system,
+                    userPrompt: prompt.user,
+                    estimatedTokens: estimatedTotal,
+                });
+            }
+            this.budgetTracker.recordProcessed(file.relativePath, estimatedTotal);
+        }
+        return { tasks, skipped };
+    }
+    /**
+     * Create directory-summary tasks for LLM-generated directory descriptions.
+     * These tasks run after all files in a directory are analyzed, allowing
+     * the LLM to synthesize a richer directory overview from the .sum files.
+     */
+    createDirectorySummaryTasks(files) {
+        const tasks = [];
+        // Group files by directory
+        const filesByDir = new Map();
+        for (const file of files) {
+            const dir = path.dirname(file.relativePath);
+            const dirFiles = filesByDir.get(dir) ?? [];
+            dirFiles.push(file);
+            filesByDir.set(dir, dirFiles);
+        }
+        // Create a directory-summary task for each directory with analyzed files
+        for (const [dir, dirFiles] of Array.from(filesByDir.entries())) {
+            const sumFilePaths = dirFiles.map(f => `${f.relativePath}.sum`);
+            const promptOverhead = 800; // Overhead for directory summary prompts
+            tasks.push({
+                type: 'directory-summary',
+                filePath: dir || '.',
+                systemPrompt: `You are generating a directory description for documentation.
+Analyze the provided .sum file contents to create a concise, informative directory overview.
+Focus on:
+1. The primary purpose of this directory
+2. How the files work together
+3. Key patterns or conventions used
+Keep the description to 1-3 sentences.`,
+                userPrompt: `Generate a directory description for "${dir || 'root'}" based on ${dirFiles.length} analyzed files.
+The .sum files contain individual file summaries - synthesize them into a cohesive directory overview.`,
+                estimatedTokens: promptOverhead,
+                directoryInfo: {
+                    sumFiles: sumFilePaths,
+                    fileCount: dirFiles.length,
+                },
+            });
+        }
+        return tasks;
+    }
+    /**
+     * Create a complete generation plan.
+     */
+    async createPlan(discoveryResult) {
+        const files = await this.prepareFiles(discoveryResult);
+        const complexity = analyzeComplexity(files.map(f => f.filePath), this.projectRoot);
+        const { tasks: fileTasks, skipped } = this.createTasks(files);
+        // Add directory-summary tasks for LLM-generated directory descriptions
+        // These run after file analysis to synthesize richer directory overviews
+        const dirTasks = this.createDirectorySummaryTasks(files);
+        const tasks = [...fileTasks, ...dirTasks];
+        // Check for package.json to determine STACK.md generation
+        const hasPackageJson = await this.hasPackageJson();
+        return {
+            files,
+            tasks,
+            complexity,
+            generateArchitecture: this.config.generation.generateArchitecture &&
+                shouldGenerateArchitecture(complexity),
+            generateStack: this.config.generation.generateStack &&
+                hasPackageJson &&
+                shouldGenerateStack(hasPackageJson),
+            budget: {
+                total: this.config.generation.tokenBudget,
+                estimated: this.budgetTracker.getReport().used,
+                remaining: this.budgetTracker.remaining,
+            },
+            skippedFiles: skipped,
+        };
+    }
+    /**
+     * Check if package.json exists in project root.
+     */
+    async hasPackageJson() {
+        try {
+            await readFile(path.join(this.projectRoot, 'package.json'), 'utf-8');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get budget report.
+     */
+    getBudgetReport() {
+        return this.budgetTracker.getReport();
+    }
+}
+/**
+ * Create a generation orchestrator with default config.
+ */
+export function createOrchestrator(config, projectRoot, totalFiles) {
+    return new GenerationOrchestrator(config, projectRoot, totalFiles);
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/generation/orchestrator.js.map

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

package/dist/generation/prompts/builder.d.ts

@@ -0,0 +1,31 @@
+import type { PromptContext, ChunkContext, SynthesisContext } from './types.js';
+/**
+ * Detect language from file extension for syntax highlighting.
+ */
+export declare function detectLanguage(filePath: string): string;
+/**
+ * Detect framework from file content for component templates.
+ */
+export declare function detectFramework(content: string): string;
+/**
+ * Build a complete prompt for file analysis.
+ */
+export declare function buildPrompt(context: PromptContext): {
+    system: string;
+    user: string;
+};
+/**
+ * Build a prompt for summarizing a chunk of a large file.
+ */
+export declare function buildChunkPrompt(context: ChunkContext): {
+    system: string;
+    user: string;
+};
+/**
+ * Build a prompt for synthesizing chunk summaries into final summary.
+ */
+export declare function buildSynthesisPrompt(context: SynthesisContext): {
+    system: string;
+    user: string;
+};
+//# sourceMappingURL=builder.d.ts.map

package/dist/generation/prompts/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/generation/prompts/builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhF;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2BvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CA0BA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CA2BA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAgCA"}

package/dist/generation/prompts/builder.js

@@ -0,0 +1,136 @@
+import * as path from 'node:path';
+import { getTemplate } from './templates.js';
+/**
+ * Detect language from file extension for syntax highlighting.
+ */
+export function detectLanguage(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const langMap = {
+        '.ts': 'typescript',
+        '.tsx': 'tsx',
+        '.js': 'javascript',
+        '.jsx': 'jsx',
+        '.py': 'python',
+        '.rb': 'ruby',
+        '.go': 'go',
+        '.rs': 'rust',
+        '.java': 'java',
+        '.kt': 'kotlin',
+        '.swift': 'swift',
+        '.cs': 'csharp',
+        '.php': 'php',
+        '.vue': 'vue',
+        '.svelte': 'svelte',
+        '.json': 'json',
+        '.yaml': 'yaml',
+        '.yml': 'yaml',
+        '.md': 'markdown',
+        '.css': 'css',
+        '.scss': 'scss',
+        '.html': 'html',
+    };
+    return langMap[ext] ?? 'text';
+}
+/**
+ * Detect framework from file content for component templates.
+ */
+export function detectFramework(content) {
+    if (content.includes("from 'react'") || content.includes('from "react"')) {
+        return 'React';
+    }
+    if (content.includes("from 'vue'") || content.includes('from "vue"')) {
+        return 'Vue';
+    }
+    if (content.includes("from 'svelte'") || content.includes('.svelte')) {
+        return 'Svelte';
+    }
+    if (content.includes('@angular')) {
+        return 'Angular';
+    }
+    return 'JavaScript';
+}
+/**
+ * Build a complete prompt for file analysis.
+ */
+export function buildPrompt(context) {
+    const template = getTemplate(context.fileType);
+    const lang = detectLanguage(context.filePath);
+    const framework = detectFramework(context.content);
+    let userPrompt = template.userPrompt
+        .replace(/\{\{FILE_PATH\}\}/g, context.filePath)
+        .replace(/\{\{CONTENT\}\}/g, context.content)
+        .replace(/\{\{LANG\}\}/g, lang)
+        .replace(/\{\{FRAMEWORK\}\}/g, framework);
+    // Add context files if provided
+    if (context.contextFiles && context.contextFiles.length > 0) {
+        const contextSection = context.contextFiles
+            .map((f) => `\n### ${f.path}\n\`\`\`${detectLanguage(f.path)}\n${f.content}\n\`\`\``)
+            .join('\n');
+        userPrompt += `\n\n## Related Files\n${contextSection}`;
+    }
+    return {
+        system: template.systemPrompt,
+        user: userPrompt,
+    };
+}
+/**
+ * Build a prompt for summarizing a chunk of a large file.
+ */
+export function buildChunkPrompt(context) {
+    const template = getTemplate(context.fileType);
+    const lang = detectLanguage(context.filePath);
+    const system = `${template.systemPrompt}
+
+This is chunk ${context.chunkIndex + 1} of ${context.totalChunks} from a large file.
+Focus on what THIS chunk contains. The chunks will be synthesized later.`;
+    const user = `Analyze this code chunk and generate a partial summary.
+
+File: ${context.filePath} (lines ${context.lineRange.start}-${context.lineRange.end})
+Chunk: ${context.chunkIndex + 1} of ${context.totalChunks}
+
+\`\`\`${lang}
+${context.content}
+\`\`\`
+
+Summarize what this chunk contains:
+- Functions/classes defined
+- Key logic and patterns
+- Dependencies used
+- Notable details
+
+Keep it concise - this will be combined with other chunks.`;
+    return { system, user };
+}
+/**
+ * Build a prompt for synthesizing chunk summaries into final summary.
+ */
+export function buildSynthesisPrompt(context) {
+    const template = getTemplate(context.fileType);
+    const system = `${template.systemPrompt}
+
+You are synthesizing chunk summaries into a final, cohesive summary.`;
+    const chunkSection = context.chunkSummaries
+        .map((summary, i) => `### Chunk ${i + 1}\n${summary}`)
+        .join('\n\n');
+    const user = `Synthesize these chunk summaries into a final summary for the file.
+
+File: ${context.filePath}
+File Type: ${context.fileType}
+
+## Chunk Summaries
+
+${chunkSection}
+
+## Instructions
+
+Create a unified summary (300-500 words) that:
+1. Combines insights from all chunks
+2. Eliminates redundancy
+3. Presents a coherent overview of the entire file
+4. Follows the format for ${context.fileType} files
+
+Focus on:
+${template.focusAreas.map((area) => `- ${area}`).join('\n')}`;
+    return { system, user };
+}
+//# sourceMappingURL=builder.js.map

package/dist/generation/prompts/builder.js.map

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

package/dist/generation/prompts/index.d.ts

@@ -0,0 +1,5 @@
+export type { PromptTemplate, PromptContext, ChunkContext, SynthesisContext, } from './types.js';
+export { SUMMARY_GUIDELINES } from './types.js';
+export { TEMPLATES, getTemplate } from './templates.js';
+export { buildPrompt, buildChunkPrompt, buildSynthesisPrompt, detectLanguage, detectFramework, } from './builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generation/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generation/prompts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/generation/prompts/index.js

@@ -0,0 +1,4 @@
+export { SUMMARY_GUIDELINES } from './types.js';
+export { TEMPLATES, getTemplate } from './templates.js';
+export { buildPrompt, buildChunkPrompt, buildSynthesisPrompt, detectLanguage, detectFramework, } from './builder.js';
+//# sourceMappingURL=index.js.map

package/dist/generation/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generation/prompts/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/generation/prompts/templates.d.ts

@@ -0,0 +1,11 @@
+import type { FileType } from '../types.js';
+import type { PromptTemplate } from './types.js';
+/**
+ * Map of file types to their prompt templates.
+ */
+export declare const TEMPLATES: Record<FileType, PromptTemplate>;
+/**
+ * Get the prompt template for a file type.
+ */
+export declare function getTemplate(fileType: FileType): PromptTemplate;
+//# sourceMappingURL=templates.d.ts.map

package/dist/generation/prompts/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/generation/prompts/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA8OjD;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,cAAc,CAYtD,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAE9D"}