agents-reverse-engineer 0.1.1

package/dist/generation/writers/supplementary.js

@@ -0,0 +1,195 @@
+import { writeFile, readFile, mkdir } from 'node:fs/promises';
+import * as path from 'node:path';
+/**
+ * Build ARCHITECTURE.md content from complexity metrics.
+ *
+ * This generates a template that the host LLM will expand with actual
+ * architectural analysis.
+ */
+export function buildArchitectureMd(metrics, projectName) {
+    const sections = [];
+    // Header
+    sections.push(`# Architecture: ${projectName}\n`);
+    sections.push(`> Auto-generated architecture overview. ${metrics.fileCount} files analyzed.\n`);
+    // Detected patterns
+    if (metrics.architecturalPatterns.length > 0) {
+        sections.push('## Architectural Patterns\n');
+        for (const pattern of metrics.architecturalPatterns) {
+            sections.push(`- **${formatPatternName(pattern)}**`);
+        }
+        sections.push('');
+    }
+    // Directory structure (high-level)
+    sections.push('## Directory Structure\n');
+    sections.push('```');
+    const topLevelDirs = getTopLevelDirectories(metrics.directories);
+    for (const dir of topLevelDirs.sort()) {
+        sections.push(`${dir}/`);
+    }
+    sections.push('```\n');
+    // Layers section (placeholder for LLM expansion)
+    sections.push('## Layers\n');
+    sections.push('<!-- This section describes the architectural layers -->\n');
+    // Data flow section (placeholder)
+    sections.push('## Data Flow\n');
+    sections.push('<!-- This section describes how data flows through the system -->\n');
+    // Key abstractions (placeholder)
+    sections.push('## Key Abstractions\n');
+    sections.push('<!-- This section describes important interfaces and patterns -->\n');
+    return sections.join('\n');
+}
+/**
+ * Format pattern name for display.
+ */
+function formatPatternName(pattern) {
+    return pattern
+        .split('-')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/**
+ * Get top-level directories from all directories.
+ */
+function getTopLevelDirectories(directories) {
+    const topLevel = [];
+    for (const dir of directories) {
+        const parts = dir.split(path.sep);
+        if (parts.length === 1 || (parts.length === 2 && parts[0] === '.')) {
+            topLevel.push(parts[parts.length - 1]);
+        }
+    }
+    return [...new Set(topLevel)];
+}
+/**
+ * Build STACK.md content from package.json analysis.
+ */
+export function buildStackMd(stackInfo, projectName) {
+    const sections = [];
+    // Header
+    sections.push(`# Technology Stack: ${projectName}\n`);
+    // Runtime
+    sections.push('## Runtime\n');
+    sections.push(`- **Environment**: ${stackInfo.runtime}`);
+    if (stackInfo.framework) {
+        sections.push(`- **Framework**: ${stackInfo.framework}`);
+    }
+    sections.push('');
+    // Dependencies by category
+    for (const [category, deps] of Object.entries(stackInfo.dependencies)) {
+        if (deps.length === 0)
+            continue;
+        sections.push(`## ${category}\n`);
+        for (const dep of deps) {
+            const purpose = dep.purpose ? ` - ${dep.purpose}` : '';
+            sections.push(`- **${dep.name}** (${dep.version})${purpose}`);
+        }
+        sections.push('');
+    }
+    // Dev tools
+    if (stackInfo.devTools.length > 0) {
+        sections.push('## Development Tools\n');
+        for (const tool of stackInfo.devTools) {
+            sections.push(`- ${tool}`);
+        }
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+/**
+ * Parse package.json to extract stack information.
+ */
+export async function analyzePackageJson(packageJsonPath) {
+    try {
+        const content = await readFile(packageJsonPath, 'utf-8');
+        const pkg = JSON.parse(content);
+        const stackInfo = {
+            runtime: 'Node.js',
+            dependencies: {
+                'Core': [],
+                'Framework': [],
+                'Database': [],
+                'Testing': [],
+                'Build Tools': [],
+                'Other': [],
+            },
+            devTools: [],
+        };
+        // Detect framework
+        const frameworkDeps = ['next', 'react', 'vue', 'angular', 'svelte', 'express', 'fastify', 'nestjs'];
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        for (const fw of frameworkDeps) {
+            if (deps[fw]) {
+                stackInfo.framework = fw.charAt(0).toUpperCase() + fw.slice(1);
+                break;
+            }
+        }
+        // Categorize dependencies
+        const categoryRules = [
+            { category: 'Framework', patterns: ['react', 'vue', 'angular', 'svelte', 'next', 'nuxt', 'express', 'fastify', 'nestjs'] },
+            { category: 'Database', patterns: ['prisma', 'mongoose', 'typeorm', 'sequelize', 'pg', 'mysql', 'redis', 'drizzle'] },
+            { category: 'Testing', patterns: ['jest', 'vitest', 'mocha', 'chai', 'cypress', 'playwright', '@testing-library'] },
+            { category: 'Build Tools', patterns: ['typescript', 'esbuild', 'vite', 'webpack', 'rollup', 'parcel', 'tsup'] },
+        ];
+        for (const [name, version] of Object.entries(pkg.dependencies ?? {})) {
+            let categorized = false;
+            for (const rule of categoryRules) {
+                if (rule.patterns.some(p => name.toLowerCase().includes(p))) {
+                    stackInfo.dependencies[rule.category].push({ name, version: version });
+                    categorized = true;
+                    break;
+                }
+            }
+            if (!categorized) {
+                stackInfo.dependencies['Other'].push({ name, version: version });
+            }
+        }
+        // Dev tools
+        const devToolPatterns = ['eslint', 'prettier', 'husky', 'lint-staged'];
+        for (const [name] of Object.entries(pkg.devDependencies ?? {})) {
+            if (devToolPatterns.some(p => name.includes(p))) {
+                stackInfo.devTools.push(name);
+            }
+        }
+        return stackInfo;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write ARCHITECTURE.md to the configured location.
+ */
+export async function writeArchitectureMd(projectRoot, metrics, config) {
+    if (!config.generateArchitecture)
+        return null;
+    const outputDir = config.outputDir
+        ? path.join(projectRoot, config.outputDir)
+        : projectRoot;
+    await mkdir(outputDir, { recursive: true });
+    const projectName = path.basename(projectRoot);
+    const content = buildArchitectureMd(metrics, projectName);
+    const filePath = path.join(outputDir, 'ARCHITECTURE.md');
+    await writeFile(filePath, content, 'utf-8');
+    return filePath;
+}
+/**
+ * Write STACK.md to the configured location.
+ */
+export async function writeStackMd(projectRoot, config) {
+    if (!config.generateStack)
+        return null;
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    const stackInfo = await analyzePackageJson(packageJsonPath);
+    if (!stackInfo)
+        return null;
+    const outputDir = config.outputDir
+        ? path.join(projectRoot, config.outputDir)
+        : projectRoot;
+    await mkdir(outputDir, { recursive: true });
+    const projectName = path.basename(projectRoot);
+    const content = buildStackMd(stackInfo, projectName);
+    const filePath = path.join(outputDir, 'STACK.md');
+    await writeFile(filePath, content, 'utf-8');
+    return filePath;
+}
+//# sourceMappingURL=supplementary.js.map

package/dist/generation/writers/supplementary.js.map

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

package/dist/integration/detect.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Environment detection for AI coding assistants
+ *
+ * Detects which AI coding assistant environments are present in a project
+ * by checking for their configuration directories and files.
+ */
+import type { DetectedEnvironment, EnvironmentType } from './types.js';
+/**
+ * Detect all AI coding assistant environments present in a project
+ *
+ * Checks for:
+ * - Claude Code: .claude/ directory OR CLAUDE.md file
+ * - OpenCode: .opencode/ directory
+ * - Aider: .aider.conf.yml file OR .aider/ directory
+ *
+ * @param projectRoot - Root directory to check for environments
+ * @returns Array of detected environments (may include multiple)
+ */
+export declare function detectEnvironments(projectRoot: string): DetectedEnvironment[];
+/**
+ * Check if a specific AI coding assistant environment is present
+ *
+ * @param projectRoot - Root directory to check
+ * @param type - Environment type to check for
+ * @returns true if the environment is detected
+ */
+export declare function hasEnvironment(projectRoot: string, type: EnvironmentType): boolean;
+//# sourceMappingURL=detect.d.ts.map

package/dist/integration/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/integration/detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEvE;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAoC7E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,eAAe,GACpB,OAAO,CAGT"}

package/dist/integration/detect.js

@@ -0,0 +1,64 @@
+/**
+ * Environment detection for AI coding assistants
+ *
+ * Detects which AI coding assistant environments are present in a project
+ * by checking for their configuration directories and files.
+ */
+import { existsSync } from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Detect all AI coding assistant environments present in a project
+ *
+ * Checks for:
+ * - Claude Code: .claude/ directory OR CLAUDE.md file
+ * - OpenCode: .opencode/ directory
+ * - Aider: .aider.conf.yml file OR .aider/ directory
+ *
+ * @param projectRoot - Root directory to check for environments
+ * @returns Array of detected environments (may include multiple)
+ */
+export function detectEnvironments(projectRoot) {
+    const environments = [];
+    // Check for Claude Code
+    const claudeDir = path.join(projectRoot, '.claude');
+    const claudeMd = path.join(projectRoot, 'CLAUDE.md');
+    if (existsSync(claudeDir) || existsSync(claudeMd)) {
+        environments.push({
+            type: 'claude',
+            configDir: '.claude',
+            detected: true,
+        });
+    }
+    // Check for OpenCode
+    const openCodeDir = path.join(projectRoot, '.opencode');
+    if (existsSync(openCodeDir)) {
+        environments.push({
+            type: 'opencode',
+            configDir: '.opencode',
+            detected: true,
+        });
+    }
+    // Check for Aider
+    const aiderConfig = path.join(projectRoot, '.aider.conf.yml');
+    const aiderDir = path.join(projectRoot, '.aider');
+    if (existsSync(aiderConfig) || existsSync(aiderDir)) {
+        environments.push({
+            type: 'aider',
+            configDir: '.aider',
+            detected: true,
+        });
+    }
+    return environments;
+}
+/**
+ * Check if a specific AI coding assistant environment is present
+ *
+ * @param projectRoot - Root directory to check
+ * @param type - Environment type to check for
+ * @returns true if the environment is detected
+ */
+export function hasEnvironment(projectRoot, type) {
+    const environments = detectEnvironments(projectRoot);
+    return environments.some((env) => env.type === type);
+}
+//# sourceMappingURL=detect.js.map

package/dist/integration/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/integration/detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,MAAM,YAAY,GAA0B,EAAE,CAAC;IAE/C,wBAAwB;IACxB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACrD,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,YAAY,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,SAAS;YACpB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC;IAED,qBAAqB;IACrB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACxD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,YAAY,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,WAAW;YACtB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB;IAClB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClD,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,YAAY,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,IAAqB;IAErB,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/integration/generate.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Integration file generation for AI coding assistants
+ *
+ * Generates command files and hooks for detected AI assistant environments.
+ * Handles file creation with directory creation and skip-if-exists behavior.
+ */
+import type { IntegrationResult } from './types.js';
+/**
+ * Options for generating integration files
+ */
+export interface GenerateOptions {
+    /** If true, don't actually write files - just report what would be done */
+    dryRun?: boolean;
+    /** If true, overwrite existing files instead of skipping them */
+    force?: boolean;
+}
+/**
+ * Generate integration files for all detected AI assistant environments
+ *
+ * For each detected environment:
+ * - Gets appropriate templates (command files)
+ * - Creates files if they don't exist (or if force=true)
+ * - For Claude: also creates the session-end hook
+ *
+ * @param projectRoot - Root directory of the project
+ * @param options - Generation options
+ * @returns Array of results, one per environment
+ *
+ * @example
+ * ```typescript
+ * const results = await generateIntegrationFiles('/path/to/project');
+ * // [{ environment: 'claude', filesCreated: ['...'], filesSkipped: [] }]
+ * ```
+ */
+export declare function generateIntegrationFiles(projectRoot: string, options?: GenerateOptions): Promise<IntegrationResult[]>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/integration/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/integration/generate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,YAAY,CAAC;AAQrE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAcD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsD9B"}

package/dist/integration/generate.js

@@ -0,0 +1,107 @@
+/**
+ * Integration file generation for AI coding assistants
+ *
+ * Generates command files and hooks for detected AI assistant environments.
+ * Handles file creation with directory creation and skip-if-exists behavior.
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import * as path from 'node:path';
+import { detectEnvironments } from './detect.js';
+import { getClaudeTemplates, getOpenCodeTemplates, getHookTemplate, } from './templates.js';
+/**
+ * Ensure parent directories exist for a file path
+ *
+ * @param filePath - Full path to the file
+ */
+function ensureDir(filePath) {
+    const dir = path.dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Generate integration files for all detected AI assistant environments
+ *
+ * For each detected environment:
+ * - Gets appropriate templates (command files)
+ * - Creates files if they don't exist (or if force=true)
+ * - For Claude: also creates the session-end hook
+ *
+ * @param projectRoot - Root directory of the project
+ * @param options - Generation options
+ * @returns Array of results, one per environment
+ *
+ * @example
+ * ```typescript
+ * const results = await generateIntegrationFiles('/path/to/project');
+ * // [{ environment: 'claude', filesCreated: ['...'], filesSkipped: [] }]
+ * ```
+ */
+export async function generateIntegrationFiles(projectRoot, options = {}) {
+    const { dryRun = false, force = false } = options;
+    const results = [];
+    // Detect which environments are present
+    const environments = detectEnvironments(projectRoot);
+    for (const env of environments) {
+        const result = {
+            environment: env.type,
+            filesCreated: [],
+            filesSkipped: [],
+        };
+        // Get templates for this environment
+        const templates = getTemplatesForEnvironment(env.type);
+        // Process each template
+        for (const template of templates) {
+            const fullPath = path.join(projectRoot, template.path);
+            if (existsSync(fullPath) && !force) {
+                // File exists and force is not set - skip it
+                result.filesSkipped.push(template.path);
+            }
+            else {
+                // Create the file
+                if (!dryRun) {
+                    ensureDir(fullPath);
+                    writeFileSync(fullPath, template.content, 'utf-8');
+                }
+                result.filesCreated.push(template.path);
+            }
+        }
+        // For Claude, also generate the hook file
+        if (env.type === 'claude') {
+            const hookPath = '.claude/hooks/ar-session-end.js';
+            const fullHookPath = path.join(projectRoot, hookPath);
+            if (existsSync(fullHookPath) && !force) {
+                result.filesSkipped.push(hookPath);
+            }
+            else {
+                if (!dryRun) {
+                    ensureDir(fullHookPath);
+                    writeFileSync(fullHookPath, getHookTemplate(), 'utf-8');
+                }
+                result.filesCreated.push(hookPath);
+            }
+        }
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Get templates for a specific environment type
+ *
+ * @param type - Environment type
+ * @returns Array of templates for that environment
+ */
+function getTemplatesForEnvironment(type) {
+    switch (type) {
+        case 'claude':
+            return getClaudeTemplates();
+        case 'opencode':
+            return getOpenCodeTemplates();
+        case 'aider':
+            // Aider doesn't have command files yet - return empty
+            return [];
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/integration/generate.js.map

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

package/dist/integration/templates.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Template generators for AI coding assistant integration files
+ *
+ * Generates command file templates for Claude Code, OpenCode, and session hooks.
+ */
+import type { IntegrationTemplate } from './types.js';
+/**
+ * Get Claude Code command file templates
+ *
+ * Returns templates for:
+ * - generate.md: Full documentation generation command
+ * - update.md: Incremental documentation update command
+ * - init.md: Initialize agents-reverse-engineer in a project
+ *
+ * @returns Array of Claude Code command templates
+ */
+export declare function getClaudeTemplates(): IntegrationTemplate[];
+/**
+ * Get OpenCode command file templates
+ *
+ * Returns templates for:
+ * - are-generate.md: Full documentation generation command
+ * - are-update.md: Incremental documentation update command
+ *
+ * @returns Array of OpenCode command templates
+ */
+export declare function getOpenCodeTemplates(): IntegrationTemplate[];
+/**
+ * Get session-end hook template for automatic documentation updates
+ *
+ * The hook:
+ * - Checks ARE_DISABLE_HOOK env var for temporary disable
+ * - Checks config file for permanent disable (hook_enabled: false)
+ * - Checks git status and exits silently if no changes
+ * - Spawns are update --quiet in background (detached, unref'd)
+ *
+ * Uses CommonJS (require) since hooks run via node directly.
+ *
+ * @returns JavaScript hook code as a string
+ */
+export declare function getHookTemplate(): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/integration/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/integration/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,EAAE,CAkF1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,mBAAmB,EAAE,CAuC5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAyCxC"}