agents-reverse-engineer 0.1.1

package/dist/cli/discover.js.map

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

package/dist/cli/generate.d.ts

@@ -0,0 +1,41 @@
+/**
+ * CLI generate command
+ *
+ * Creates a documentation generation plan by:
+ * 1. Discovering files to analyze
+ * 2. Detecting file types
+ * 3. Creating analysis tasks with prompts
+ * 4. Tracking token budget
+ *
+ * With --execute flag, outputs tasks as JSON for AI agent execution.
+ */
+/**
+ * Options for the generate command.
+ */
+export interface GenerateOptions {
+    /** Suppress output except errors */
+    quiet?: boolean;
+    /** Show detailed task breakdown */
+    verbose?: boolean;
+    /** Dry run - show plan without generating */
+    dryRun?: boolean;
+    /** Override token budget */
+    budget?: number;
+    /** Execute mode - output JSON for AI agent execution */
+    execute?: boolean;
+    /** Stream mode - output tasks one per line */
+    stream?: boolean;
+}
+/**
+ * Generate command - creates documentation generation plan.
+ *
+ * This command:
+ * 1. Discovers files to analyze
+ * 2. Detects file types
+ * 3. Creates analysis tasks (prompts)
+ * 4. Reports budget and plan
+ *
+ * The actual analysis is performed by the host LLM using the generated prompts.
+ */
+export declare function generateCommand(targetPath: string, options: GenerateOptions): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/cli/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAyED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CA8Gf"}

package/dist/cli/generate.js

@@ -0,0 +1,179 @@
+/**
+ * CLI generate command
+ *
+ * Creates a documentation generation plan by:
+ * 1. Discovering files to analyze
+ * 2. Detecting file types
+ * 3. Creating analysis tasks with prompts
+ * 4. Tracking token budget
+ *
+ * With --execute flag, outputs tasks as JSON for AI agent execution.
+ */
+import * as path from 'node:path';
+import { loadConfig } from '../config/loader.js';
+import { createLogger } from '../output/logger.js';
+import { walkDirectory } from '../discovery/walker.js';
+import { applyFilters, createGitignoreFilter, createVendorFilter, createBinaryFilter, createCustomFilter, } from '../discovery/filters/index.js';
+import { createOrchestrator } from '../generation/orchestrator.js';
+import { buildExecutionPlan, formatExecutionPlanAsJson, streamTasks } from '../generation/executor.js';
+/**
+ * Format file type distribution for display.
+ */
+function formatTypeDistribution(plan) {
+    const typeCounts = new Map();
+    for (const file of plan.files) {
+        const count = typeCounts.get(file.fileType) ?? 0;
+        typeCounts.set(file.fileType, count + 1);
+    }
+    return Array.from(typeCounts.entries())
+        .sort((a, b) => b[1] - a[1])
+        .map(([type, count]) => `  ${type}: ${count}`)
+        .join('\n');
+}
+/**
+ * Format the generation plan for display.
+ */
+function formatPlan(plan) {
+    const lines = [];
+    lines.push(`\n=== Generation Plan ===\n`);
+    // File summary
+    lines.push(`Files to analyze: ${plan.files.length}`);
+    lines.push(`Tasks to execute: ${plan.tasks.length}`);
+    lines.push('');
+    // File type distribution
+    lines.push('File types:');
+    lines.push(formatTypeDistribution(plan));
+    lines.push('');
+    // Budget
+    lines.push('Token budget:');
+    lines.push(`  Total: ${plan.budget.total.toLocaleString()}`);
+    lines.push(`  Estimated: ${plan.budget.estimated.toLocaleString()}`);
+    lines.push(`  Remaining: ${plan.budget.remaining.toLocaleString()}`);
+    lines.push('');
+    // Complexity
+    lines.push('Complexity:');
+    lines.push(`  Files: ${plan.complexity.fileCount}`);
+    lines.push(`  Directory depth: ${plan.complexity.directoryDepth}`);
+    if (plan.complexity.architecturalPatterns.length > 0) {
+        lines.push(`  Patterns: ${plan.complexity.architecturalPatterns.join(', ')}`);
+    }
+    lines.push('');
+    // Supplementary docs
+    lines.push('Supplementary docs:');
+    lines.push(`  ARCHITECTURE.md: ${plan.generateArchitecture ? 'yes' : 'no'}`);
+    lines.push(`  STACK.md: ${plan.generateStack ? 'yes' : 'no'}`);
+    lines.push('');
+    // Skipped files
+    if (plan.skippedFiles.length > 0) {
+        lines.push(`Skipped (budget): ${plan.skippedFiles.length} files`);
+        if (plan.skippedFiles.length <= 5) {
+            for (const file of plan.skippedFiles) {
+                lines.push(`  - ${file}`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate command - creates documentation generation plan.
+ *
+ * This command:
+ * 1. Discovers files to analyze
+ * 2. Detects file types
+ * 3. Creates analysis tasks (prompts)
+ * 4. Reports budget and plan
+ *
+ * The actual analysis is performed by the host LLM using the generated prompts.
+ */
+export async function generateCommand(targetPath, options) {
+    const absolutePath = path.resolve(targetPath);
+    // In execute/stream mode, suppress all non-JSON output
+    const isJsonMode = options.execute || options.stream;
+    const logger = createLogger({
+        colors: !isJsonMode,
+        verbose: options.verbose ?? false,
+        quiet: isJsonMode || (options.quiet ?? false),
+        showExcluded: false,
+    });
+    logger.info(`Generating documentation plan for: ${absolutePath}`);
+    // Load configuration
+    const config = await loadConfig(absolutePath);
+    // Override budget if specified
+    if (options.budget) {
+        config.generation.tokenBudget = options.budget;
+    }
+    // Discover files
+    logger.info('Discovering files...');
+    // Create filters in order (same as discover command)
+    const gitignoreFilter = await createGitignoreFilter(absolutePath);
+    const vendorFilter = createVendorFilter(config.exclude.vendorDirs);
+    const binaryFilter = createBinaryFilter({
+        maxFileSize: config.options.maxFileSize,
+        additionalExtensions: config.exclude.binaryExtensions,
+    });
+    const customFilter = createCustomFilter(config.exclude.patterns, absolutePath);
+    const filters = [gitignoreFilter, vendorFilter, binaryFilter, customFilter];
+    // Walk directory
+    const files = await walkDirectory({
+        cwd: absolutePath,
+        followSymlinks: config.options.followSymlinks,
+    });
+    // Apply filters
+    const filterResult = await applyFilters(files, filters);
+    // Create discovery result for orchestrator
+    const discoveryResult = {
+        files: filterResult.included,
+        excluded: filterResult.excluded.map(e => ({ path: e.path, reason: e.reason })),
+    };
+    logger.info(`Found ${discoveryResult.files.length} files to analyze`);
+    // Create generation plan
+    logger.info('Creating generation plan...');
+    const orchestrator = createOrchestrator(config, absolutePath, discoveryResult.files.length);
+    const plan = await orchestrator.createPlan(discoveryResult);
+    // Display plan (skip in JSON mode)
+    if (!options.quiet && !isJsonMode) {
+        console.log(formatPlan(plan));
+    }
+    if (options.dryRun) {
+        logger.info('Dry run complete. No files written.');
+        return;
+    }
+    // Execute mode - output JSON for AI agent execution
+    if (options.execute || options.stream) {
+        const executionPlan = buildExecutionPlan(plan, absolutePath);
+        if (options.stream) {
+            // Stream mode - one task per line for incremental processing
+            for (const line of streamTasks(executionPlan)) {
+                console.log(line);
+            }
+        }
+        else {
+            // Full JSON output
+            console.log(formatExecutionPlanAsJson(executionPlan));
+        }
+        return;
+    }
+    // Default: Output task instructions for the host LLM
+    console.log('\n=== Ready for Analysis ===\n');
+    console.log(`This plan contains ${plan.tasks.length} analysis tasks.`);
+    console.log('The host LLM will process each file and generate summaries.');
+    console.log('\nTo proceed, the host should:');
+    console.log('1. Read each file and its prompt');
+    console.log('2. Generate summaries following the prompt guidelines');
+    console.log('3. Write .sum files alongside source files');
+    console.log('4. Generate AGENTS.md for each directory');
+    console.log('5. Generate CLAUDE.md at the project root');
+    if (plan.generateArchitecture) {
+        console.log('6. Generate ARCHITECTURE.md (complexity threshold met)');
+    }
+    if (plan.generateStack) {
+        console.log('7. Generate STACK.md (package.json found)');
+    }
+    console.log('\nRun with --execute to get JSON output for AI agent execution.');
+    console.log('Run with --stream for streaming task output.');
+    // Summary
+    const budgetReport = orchestrator.getBudgetReport();
+    logger.info(`\nPlan ready. Estimated tokens: ${budgetReport.used.toLocaleString()}`);
+}
+//# sourceMappingURL=generate.js.map

package/dist/cli/generate.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for agents-reverse
+ *
+ * Commands:
+ *   init              Create default configuration
+ *   discover [path]   Discover files to analyze
+ *   generate [path]   Generate documentation plan
+ *   update [path]     Update docs incrementally
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cli/index.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for agents-reverse
+ *
+ * Commands:
+ *   init              Create default configuration
+ *   discover [path]   Discover files to analyze
+ *   generate [path]   Generate documentation plan
+ *   update [path]     Update docs incrementally
+ */
+import { initCommand } from './init.js';
+import { discoverCommand } from './discover.js';
+import { generateCommand } from './generate.js';
+import { updateCommand } from './update.js';
+const USAGE = `
+agents-reverse-engineer - AI-friendly codebase documentation
+
+Commands:
+  init              Create default configuration
+  discover [path]   Discover files to analyze (default: current directory)
+  generate [path]   Generate documentation plan (default: current directory)
+  update [path]     Update docs incrementally (default: current directory)
+
+Options:
+  --quiet, -q       Suppress output except errors
+  --verbose, -v     Show detailed output
+  --show-excluded   List each excluded file (discover only)
+  --plan            Generate GENERATION-PLAN.md file (discover only)
+  --dry-run         Show plan without writing files (generate, update)
+  --budget <n>      Override token budget (generate, update)
+  --execute         Output JSON execution plan for AI agents (generate)
+  --stream          Output tasks as streaming JSON, one per line (generate)
+  --uncommitted     Include uncommitted changes (update only)
+  --integration     Generate AI assistant command files (init only)
+  --help, -h        Show this help
+
+Examples:
+  are init
+  are init --integration
+  are discover
+  are discover --plan
+  are generate --dry-run
+  are generate --execute
+  are generate ./my-project --budget 50000
+  are update
+  are update --uncommitted --verbose
+`;
+/**
+ * Parse command-line arguments.
+ *
+ * Extracts the command, positional arguments, and flags.
+ * Handles global flags (--help, -h) that may appear before the command.
+ */
+function parseArgs(args) {
+    let command;
+    const positional = [];
+    const flags = new Set();
+    const values = new Map();
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            const flagName = arg.slice(2);
+            // Check if next arg is a value (not starting with -)
+            if (i + 1 < args.length && !args[i + 1].startsWith('-')) {
+                values.set(flagName, args[i + 1]);
+                i++; // Skip the value
+            }
+            else {
+                flags.add(flagName);
+            }
+        }
+        else if (arg.startsWith('-')) {
+            // Handle short flags (e.g., -q, -h, -v)
+            for (const char of arg.slice(1)) {
+                switch (char) {
+                    case 'q':
+                        flags.add('quiet');
+                        break;
+                    case 'h':
+                        flags.add('help');
+                        break;
+                    case 'v':
+                        flags.add('verbose');
+                        break;
+                    default:
+                        // Unknown short flag - ignore
+                        break;
+                }
+            }
+        }
+        else if (!command) {
+            // First non-flag argument is the command
+            command = arg;
+        }
+        else {
+            // Subsequent non-flag arguments are positional
+            positional.push(arg);
+        }
+    }
+    return { command, positional, flags, values };
+}
+/**
+ * Show usage information and exit.
+ */
+function showHelp() {
+    console.log(USAGE);
+    process.exit(0);
+}
+/**
+ * Show error for unknown command and exit.
+ */
+function showUnknownCommand(command) {
+    console.error(`Unknown command: ${command}`);
+    console.error(`Run 'are --help' for usage information.`);
+    process.exit(1);
+}
+/**
+ * Main CLI entry point.
+ */
+async function main() {
+    const args = process.argv.slice(2);
+    const { command, positional, flags, values } = parseArgs(args);
+    // Handle help flag anywhere
+    if (flags.has('help') || args.length === 0) {
+        showHelp();
+    }
+    // Route to command handlers
+    switch (command) {
+        case 'init': {
+            const options = {
+                interactive: flags.has('interactive'),
+                integration: flags.has('integration'),
+            };
+            await initCommand(positional[0] || '.', options);
+            break;
+        }
+        case 'discover': {
+            const options = {
+                quiet: flags.has('quiet'),
+                showExcluded: flags.has('show-excluded'),
+                verbose: !flags.has('quiet'),
+                plan: flags.has('plan'),
+            };
+            await discoverCommand(positional[0] || '.', options);
+            break;
+        }
+        case 'generate': {
+            const options = {
+                quiet: flags.has('quiet'),
+                verbose: flags.has('verbose'),
+                dryRun: flags.has('dry-run'),
+                budget: values.has('budget') ? parseInt(values.get('budget'), 10) : undefined,
+                execute: flags.has('execute'),
+                stream: flags.has('stream'),
+            };
+            await generateCommand(positional[0] || '.', options);
+            break;
+        }
+        case 'update': {
+            const options = {
+                uncommitted: flags.has('uncommitted'),
+                quiet: flags.has('quiet'),
+                verbose: flags.has('verbose'),
+                dryRun: flags.has('dry-run'),
+                budget: values.has('budget') ? parseInt(values.get('budget'), 10) : undefined,
+            };
+            await updateCommand(positional[0] || '.', options);
+            break;
+        }
+        default:
+            if (command) {
+                showUnknownCommand(command);
+            }
+            showHelp();
+    }
+}
+// Run main and handle any uncaught errors
+main().catch((err) => {
+    console.error(`Error: ${err.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAoB,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAwB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,eAAe,EAAwB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,aAAa,EAA6B,MAAM,aAAa,CAAC;AAEvE,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCb,CAAC;AAEF;;;;;GAKG;AACH,SAAS,SAAS,CAAC,IAAc;IAM/B,IAAI,OAA2B,CAAC;IAChC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9B,qDAAqD;YACrD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxD,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAClC,CAAC,EAAE,CAAC,CAAC,iBAAiB;YACxB,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,wCAAwC;YACxC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChC,QAAQ,IAAI,EAAE,CAAC;oBACb,KAAK,GAAG;wBACN,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;wBACnB,MAAM;oBACR,KAAK,GAAG;wBACN,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;wBAClB,MAAM;oBACR,KAAK,GAAG;wBACN,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;wBACrB,MAAM;oBACR;wBACE,8BAA8B;wBAC9B,MAAM;gBACV,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACpB,yCAAyC;YACzC,OAAO,GAAG,GAAG,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,+CAA+C;YAC/C,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE/D,4BAA4B;IAC5B,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,4BAA4B;IAC5B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,OAAO,GAAgB;gBAC3B,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;gBACrC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;aACtC,CAAC;YACF,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM;QACR,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,OAAO,GAAoB;gBAC/B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;gBACzB,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC;gBACxC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC5B,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;aACxB,CAAC;YACF,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM;QACR,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,OAAO,GAAoB;gBAC/B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;gBACzB,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;gBAC7B,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;gBAC5B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC9E,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;gBAC7B,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;aAC5B,CAAC;YACF,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM;QACR,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,OAAO,GAAyB;gBACpC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;gBACrC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;gBACzB,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;gBAC7B,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;gBAC5B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;aAC/E,CAAC;YACF,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM;QACR,CAAC;QAED;YACE,IAAI,OAAO,EAAE,CAAC;gBACZ,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;YACD,QAAQ,EAAE,CAAC;IACf,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;IAC1B,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/init.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `are init` command - Create default configuration
+ *
+ * Creates the `.agents-reverse/config.yaml` file with documented defaults.
+ * Warns if configuration already exists.
+ */
+/**
+ * Options for the init command.
+ */
+export interface InitOptions {
+    /**
+     * Run in interactive mode (reserved for future --interactive flag).
+     * @default false
+     */
+    interactive?: boolean;
+    /**
+     * Generate integration files for detected AI assistant environments.
+     * @default false
+     */
+    integration?: boolean;
+}
+/**
+ * Execute the `are init` command.
+ *
+ * Creates a default configuration file at `.agents-reverse/config.yaml`.
+ * If the file already exists, logs a warning and returns without modification.
+ *
+ * @param root - Root directory where config will be created
+ * @param options - Command options
+ *
+ * @example
+ * ```typescript
+ * await initCommand('.', { interactive: false });
+ * // Creates .agents-reverse/config.yaml in current directory
+ * ```
+ */
+export declare function initCommand(root: string, options: InitOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyEnF"}

package/dist/cli/init.js

@@ -0,0 +1,94 @@
+/**
+ * `are init` command - Create default configuration
+ *
+ * Creates the `.agents-reverse/config.yaml` file with documented defaults.
+ * Warns if configuration already exists.
+ */
+import path from 'node:path';
+import { configExists, writeDefaultConfig, CONFIG_DIR, CONFIG_FILE } from '../config/loader.js';
+import { createLogger } from '../output/logger.js';
+/**
+ * Execute the `are init` command.
+ *
+ * Creates a default configuration file at `.agents-reverse/config.yaml`.
+ * If the file already exists, logs a warning and returns without modification.
+ *
+ * @param root - Root directory where config will be created
+ * @param options - Command options
+ *
+ * @example
+ * ```typescript
+ * await initCommand('.', { interactive: false });
+ * // Creates .agents-reverse/config.yaml in current directory
+ * ```
+ */
+export async function initCommand(root, options) {
+    const resolvedRoot = path.resolve(root);
+    const configPath = path.join(resolvedRoot, CONFIG_DIR, CONFIG_FILE);
+    const logger = createLogger({
+        verbose: true,
+        quiet: false,
+        colors: true,
+        showExcluded: false,
+    });
+    try {
+        // Check if config already exists
+        if (await configExists(resolvedRoot)) {
+            logger.warn(`Config already exists at ${configPath}`);
+            logger.info('Edit the file to customize exclusions and options.');
+            return;
+        }
+        // Create default config
+        await writeDefaultConfig(resolvedRoot);
+        logger.info(`Created configuration at ${configPath}`);
+        logger.info('');
+        logger.info('Edit the file to customize:');
+        logger.info('  - exclude.patterns: Add custom glob patterns to exclude');
+        logger.info('  - exclude.vendorDirs: Modify vendor directories list');
+        logger.info('  - options.maxFileSize: Adjust large file threshold');
+        // Handle integration file generation
+        if (options.integration) {
+            const { generateIntegrationFiles } = await import('../integration/generate.js');
+            const results = await generateIntegrationFiles(resolvedRoot);
+            if (results.length === 0) {
+                logger.info('');
+                logger.info('No AI assistant environments detected.');
+                logger.info('Integration files will be created when .claude/ or .opencode/ exists.');
+            }
+            else {
+                for (const result of results) {
+                    logger.info('');
+                    logger.info(`${result.environment} integration:`);
+                    if (result.filesCreated.length > 0) {
+                        logger.info(`  Created: ${result.filesCreated.join(', ')}`);
+                    }
+                    if (result.filesSkipped.length > 0) {
+                        logger.info(`  Skipped (already exist): ${result.filesSkipped.join(', ')}`);
+                    }
+                    if (result.environment === 'claude') {
+                        logger.info('');
+                        logger.info('Note: Add SessionEnd hook to .claude/settings.json manually:');
+                        logger.info('  "hooks": { "SessionEnd": [".claude/hooks/ar-session-end.js"] }');
+                    }
+                }
+            }
+        }
+        else {
+            logger.info('');
+            logger.info('Run with --integration to set up AI assistant commands');
+        }
+    }
+    catch (err) {
+        const error = err;
+        // Permission error
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            logger.error(`Permission denied: Cannot create ${configPath}`);
+            logger.info('Check that you have write permissions to this directory.');
+            process.exit(1);
+        }
+        // Other error
+        logger.error(`Failed to create configuration: ${error.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/cli/update.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Options for the update command.
+ */
+export interface UpdateCommandOptions {
+    /** Include uncommitted changes (staged + working directory) */
+    uncommitted?: boolean;
+    /** Suppress output except errors */
+    quiet?: boolean;
+    /** Show detailed output */
+    verbose?: boolean;
+    /** Dry run - show plan without making changes */
+    dryRun?: boolean;
+    /** Override token budget */
+    budget?: number;
+}
+/**
+ * Update command - incrementally updates documentation based on git changes.
+ *
+ * This command:
+ * 1. Checks git repository status
+ * 2. Detects files changed since last run
+ * 3. Cleans up orphaned .sum files
+ * 4. Analyzes changed files and generates .sum files
+ * 5. Regenerates AGENTS.md for affected directories
+ * 6. Records update state for next run
+ */
+export declare function updateCommand(targetPath: string, options: UpdateCommandOptions): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/cli/update.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAkND;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA0Hf"}