agents-reverse-engineer 0.1.1

package/dist/cli/update.js

@@ -0,0 +1,296 @@
+/**
+ * CLI update command
+ *
+ * Updates documentation incrementally based on git changes since last run.
+ * Integrates with generation module to analyze changed files and update .sum files.
+ * Regenerates AGENTS.md for affected directories.
+ */
+import * as path from 'node:path';
+import { readFile } from 'node:fs/promises';
+import pc from 'picocolors';
+import { loadConfig } from '../config/loader.js';
+import { createLogger } from '../output/logger.js';
+import { createUpdateOrchestrator, } from '../update/index.js';
+import { detectFileType } from '../generation/detection/detector.js';
+import { countTokens } from '../generation/budget/index.js';
+import { buildPrompt } from '../generation/prompts/index.js';
+import { writeSumFile } from '../generation/writers/sum.js';
+import { writeAgentsMd } from '../generation/writers/agents-md.js';
+import { computeContentHash } from '../change-detection/index.js';
+/**
+ * Format cleanup results for display.
+ */
+function formatCleanup(plan) {
+    const lines = [];
+    if (plan.cleanup.deletedSumFiles.length > 0) {
+        lines.push(pc.yellow('Cleanup (deleted .sum files):'));
+        for (const file of plan.cleanup.deletedSumFiles) {
+            lines.push(`  ${pc.red('-')} ${file}`);
+        }
+    }
+    if (plan.cleanup.deletedAgentsMd.length > 0) {
+        lines.push(pc.yellow('Cleanup (deleted AGENTS.md from empty dirs):'));
+        for (const file of plan.cleanup.deletedAgentsMd) {
+            lines.push(`  ${pc.red('-')} ${file}`);
+        }
+    }
+    return lines;
+}
+/**
+ * Format the update plan for display.
+ */
+function formatPlan(plan, verbose) {
+    const lines = [];
+    // Header
+    lines.push('');
+    lines.push(pc.bold('=== Update Plan ==='));
+    lines.push('');
+    // Baseline info
+    if (plan.isFirstRun) {
+        lines.push(pc.yellow('First run detected. Use "are generate" for initial documentation.'));
+        lines.push('');
+    }
+    else {
+        lines.push(`Base commit: ${pc.dim(plan.baseCommit.slice(0, 7))}`);
+        lines.push(`Current commit: ${pc.dim(plan.currentCommit.slice(0, 7))}`);
+        lines.push('');
+    }
+    // Summary
+    const analyzeCount = plan.filesToAnalyze.length;
+    const skipCount = plan.filesToSkip.length;
+    const cleanupCount = plan.cleanup.deletedSumFiles.length + plan.cleanup.deletedAgentsMd.length;
+    if (analyzeCount === 0 && skipCount === 0 && cleanupCount === 0) {
+        lines.push(pc.green('No changes detected since last run.'));
+        lines.push('');
+        return lines.join('\n');
+    }
+    lines.push(`Files to analyze: ${pc.cyan(String(analyzeCount))}`);
+    lines.push(`Files unchanged: ${pc.dim(String(skipCount))}`);
+    if (cleanupCount > 0) {
+        lines.push(`Cleanup actions: ${pc.yellow(String(cleanupCount))}`);
+    }
+    lines.push('');
+    // File list with status markers
+    if (plan.filesToAnalyze.length > 0) {
+        lines.push(pc.cyan('Files to analyze:'));
+        for (const file of plan.filesToAnalyze) {
+            const status = file.status === 'added' ? pc.green('+') :
+                file.status === 'renamed' ? pc.blue('R') :
+                    pc.yellow('M');
+            lines.push(`  ${status} ${file.path}`);
+            if (file.status === 'renamed' && file.oldPath) {
+                lines.push(`    ${pc.dim(`(was: ${file.oldPath})`)}`);
+            }
+        }
+        lines.push('');
+    }
+    // Show skipped files in verbose mode
+    if (verbose && plan.filesToSkip.length > 0) {
+        lines.push(pc.dim('Files unchanged (skipped):'));
+        for (const file of plan.filesToSkip) {
+            lines.push(`  ${pc.dim('=')} ${pc.dim(file)}`);
+        }
+        lines.push('');
+    }
+    // Cleanup
+    lines.push(...formatCleanup(plan));
+    // Affected directories
+    if (plan.affectedDirs.length > 0 && verbose) {
+        lines.push('');
+        lines.push(pc.cyan('Directories for AGENTS.md regeneration:'));
+        for (const dir of plan.affectedDirs) {
+            lines.push(`  ${dir}`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Analyze a single changed file and generate its .sum file.
+ *
+ * Uses the generation module's prompt builder and sum writer.
+ * Note: This generates a placeholder summary since the actual LLM analysis
+ * requires host integration. The prompt is generated for potential future use.
+ */
+async function analyzeFile(projectRoot, change, verbose) {
+    const filePath = path.join(projectRoot, change.path);
+    try {
+        // Read file content
+        const content = await readFile(filePath, 'utf-8');
+        const tokens = countTokens(content);
+        // Detect file type and build prompt
+        const fileType = detectFileType(filePath, content);
+        const prompt = buildPrompt({
+            filePath: change.path,
+            content,
+            fileType,
+        });
+        // Generate summary content
+        // In a full implementation, this would call an LLM with the prompt.
+        // For now, we create a structured summary placeholder that captures
+        // the file's purpose and key elements.
+        const sumContent = {
+            summary: `## Purpose\n\nFile at \`${change.path}\`.\n\n## Analysis Pending\n\nThis summary was generated during incremental update. Full analysis requires LLM integration.`,
+            metadata: {
+                purpose: `File at ${change.path}`,
+                publicInterface: [],
+                dependencies: [],
+                patterns: [],
+            },
+            fileType,
+            generatedAt: new Date().toISOString(),
+        };
+        // Write .sum file
+        await writeSumFile(filePath, sumContent);
+        if (verbose) {
+            console.log(`  ${pc.green('\u2713')} ${change.path} (${tokens} tokens)`);
+        }
+        return {
+            path: change.path,
+            success: true,
+            tokensUsed: tokens,
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        if (verbose) {
+            console.log(`  ${pc.red('\u2717')} ${change.path}: ${errorMsg}`);
+        }
+        return {
+            path: change.path,
+            success: false,
+            tokensUsed: 0,
+            error: errorMsg,
+        };
+    }
+}
+/**
+ * Regenerate AGENTS.md for affected directories.
+ *
+ * Reads existing .sum files in each directory and creates/updates AGENTS.md.
+ */
+async function regenerateAgentsMd(projectRoot, directories, verbose) {
+    for (const dir of directories) {
+        const dirPath = dir === '.' ? projectRoot : path.join(projectRoot, dir);
+        try {
+            await writeAgentsMd(dirPath, projectRoot);
+            if (verbose) {
+                console.log(`  ${pc.green('\u2713')} AGENTS.md: ${dir || '.'}`);
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            if (verbose) {
+                console.log(`  ${pc.yellow('!')} AGENTS.md: ${dir || '.'}: ${errorMsg}`);
+            }
+        }
+    }
+}
+/**
+ * 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 async function updateCommand(targetPath, options) {
+    const absolutePath = path.resolve(targetPath);
+    const verbose = options.verbose ?? false;
+    const quiet = options.quiet ?? false;
+    const logger = createLogger({
+        colors: true,
+        verbose,
+        quiet,
+        showExcluded: false,
+    });
+    logger.info(`Checking for updates in: ${absolutePath}`);
+    // Load configuration
+    const config = await loadConfig(absolutePath);
+    // Override budget if specified
+    if (options.budget) {
+        config.generation.tokenBudget = options.budget;
+    }
+    // Create orchestrator
+    const orchestrator = createUpdateOrchestrator(config, absolutePath);
+    try {
+        // Prepare update plan
+        const plan = await orchestrator.preparePlan({
+            includeUncommitted: options.uncommitted,
+            dryRun: options.dryRun,
+        });
+        // Display plan
+        if (!quiet) {
+            console.log(formatPlan(plan, verbose));
+        }
+        // Handle first run
+        if (plan.isFirstRun) {
+            console.log(pc.yellow('Hint: Run "are generate" first to create initial documentation.'));
+            console.log(pc.yellow('Then run "are update" after making changes.'));
+            return;
+        }
+        // Handle no changes
+        if (plan.filesToAnalyze.length === 0 &&
+            plan.cleanup.deletedSumFiles.length === 0 &&
+            plan.cleanup.deletedAgentsMd.length === 0) {
+            const lastRun = await orchestrator.getLastRun();
+            if (lastRun) {
+                console.log(pc.dim(`Last run: ${lastRun.completed_at}`));
+                console.log(pc.dim(`Commit: ${lastRun.commit_hash.slice(0, 7)}`));
+            }
+            return;
+        }
+        if (options.dryRun) {
+            logger.info('Dry run complete. No files written.');
+            return;
+        }
+        // === Execute the update workflow ===
+        let totalTokens = 0;
+        let filesAnalyzed = 0;
+        let filesFailed = 0;
+        // Step 1: Analyze changed files and generate .sum files
+        if (plan.filesToAnalyze.length > 0) {
+            console.log('');
+            console.log(pc.bold('=== Analyzing Changed Files ==='));
+            for (const change of plan.filesToAnalyze) {
+                const result = await analyzeFile(absolutePath, change, verbose);
+                if (result.success) {
+                    filesAnalyzed++;
+                    totalTokens += result.tokensUsed;
+                    // Update state for this file
+                    const contentHash = await computeContentHash(path.join(absolutePath, change.path));
+                    await orchestrator.recordFileAnalyzed(change.path, contentHash, plan.currentCommit);
+                }
+                else {
+                    filesFailed++;
+                }
+            }
+        }
+        // Step 2: Regenerate AGENTS.md for affected directories
+        if (plan.affectedDirs.length > 0) {
+            console.log('');
+            console.log(pc.bold('=== Regenerating AGENTS.md ==='));
+            await regenerateAgentsMd(absolutePath, plan.affectedDirs, verbose);
+        }
+        // Step 3: Record completed run
+        const filesSkipped = plan.filesToSkip.length;
+        await orchestrator.recordRun(plan.currentCommit, filesAnalyzed, filesSkipped);
+        // Summary
+        console.log('');
+        console.log(pc.bold('=== Update Complete ==='));
+        console.log(`  Files analyzed: ${pc.green(String(filesAnalyzed))}`);
+        if (filesFailed > 0) {
+            console.log(`  Files failed: ${pc.red(String(filesFailed))}`);
+        }
+        console.log(`  Files skipped: ${pc.dim(String(filesSkipped))}`);
+        console.log(`  Directories updated: ${pc.cyan(String(plan.affectedDirs.length))}`);
+        console.log(`  Token budget used: ${pc.yellow(totalTokens.toLocaleString())} / ${config.generation.tokenBudget.toLocaleString()}`);
+    }
+    finally {
+        orchestrator.close();
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/cli/update.js.map

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

package/dist/config/defaults.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Default configuration values for agents-reverse
+ */
+/**
+ * Default vendor directories to exclude from analysis.
+ * These are typically package managers, build outputs, or version control directories.
+ */
+export declare const DEFAULT_VENDOR_DIRS: readonly ["node_modules", "vendor", ".git", "dist", "build", "__pycache__", ".next", "venv", ".venv", "target", ".cargo", ".gradle", ".planning", ".claude", ".opencode"];
+/**
+ * Default binary file extensions to exclude from analysis.
+ * These files cannot be meaningfully analyzed as text.
+ */
+export declare const DEFAULT_BINARY_EXTENSIONS: readonly [".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".webp", ".zip", ".tar", ".gz", ".rar", ".7z", ".exe", ".dll", ".so", ".dylib", ".mp3", ".mp4", ".wav", ".pdf", ".woff", ".woff2", ".ttf", ".eot", ".class", ".pyc"];
+/**
+ * Default maximum file size in bytes (1MB).
+ * Files larger than this will be skipped with a warning.
+ */
+export declare const DEFAULT_MAX_FILE_SIZE: number;
+/**
+ * Default configuration object matching the schema structure.
+ * This is used when no config file is present or for missing fields.
+ */
+export declare const DEFAULT_CONFIG: {
+    readonly exclude: {
+        readonly patterns: string[];
+        readonly vendorDirs: readonly ["node_modules", "vendor", ".git", "dist", "build", "__pycache__", ".next", "venv", ".venv", "target", ".cargo", ".gradle", ".planning", ".claude", ".opencode"];
+        readonly binaryExtensions: readonly [".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".webp", ".zip", ".tar", ".gz", ".rar", ".7z", ".exe", ".dll", ".so", ".dylib", ".mp3", ".mp4", ".wav", ".pdf", ".woff", ".woff2", ".ttf", ".eot", ".class", ".pyc"];
+    };
+    readonly options: {
+        readonly followSymlinks: false;
+        readonly maxFileSize: number;
+    };
+    readonly output: {
+        readonly colors: true;
+        readonly verbose: true;
+    };
+};
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,2KAiBtB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,yBAAyB,iOAkC5B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAc,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,cAAc;;2BAEP,MAAM,EAAE;;;;;;;;;;;;CAYlB,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,89 @@
+/**
+ * Default configuration values for agents-reverse
+ */
+/**
+ * Default vendor directories to exclude from analysis.
+ * These are typically package managers, build outputs, or version control directories.
+ */
+export const DEFAULT_VENDOR_DIRS = [
+    'node_modules',
+    'vendor',
+    '.git',
+    'dist',
+    'build',
+    '__pycache__',
+    '.next',
+    'venv',
+    '.venv',
+    'target',
+    '.cargo',
+    '.gradle',
+    // AI assistant tooling directories
+    '.planning',
+    '.claude',
+    '.opencode',
+];
+/**
+ * Default binary file extensions to exclude from analysis.
+ * These files cannot be meaningfully analyzed as text.
+ */
+export const DEFAULT_BINARY_EXTENSIONS = [
+    // Images
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.bmp',
+    '.ico',
+    '.webp',
+    // Archives
+    '.zip',
+    '.tar',
+    '.gz',
+    '.rar',
+    '.7z',
+    // Executables
+    '.exe',
+    '.dll',
+    '.so',
+    '.dylib',
+    // Media
+    '.mp3',
+    '.mp4',
+    '.wav',
+    // Documents
+    '.pdf',
+    // Fonts
+    '.woff',
+    '.woff2',
+    '.ttf',
+    '.eot',
+    // Compiled
+    '.class',
+    '.pyc',
+];
+/**
+ * Default maximum file size in bytes (1MB).
+ * Files larger than this will be skipped with a warning.
+ */
+export const DEFAULT_MAX_FILE_SIZE = 1024 * 1024;
+/**
+ * Default configuration object matching the schema structure.
+ * This is used when no config file is present or for missing fields.
+ */
+export const DEFAULT_CONFIG = {
+    exclude: {
+        patterns: [],
+        vendorDirs: [...DEFAULT_VENDOR_DIRS],
+        binaryExtensions: [...DEFAULT_BINARY_EXTENSIONS],
+    },
+    options: {
+        followSymlinks: false,
+        maxFileSize: DEFAULT_MAX_FILE_SIZE,
+    },
+    output: {
+        colors: true,
+        verbose: true,
+    },
+};
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,cAAc;IACd,QAAQ;IACR,MAAM;IACN,MAAM;IACN,OAAO;IACP,aAAa;IACb,OAAO;IACP,MAAM;IACN,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,mCAAmC;IACnC,WAAW;IACX,SAAS;IACT,WAAW;CACH,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,WAAW;IACX,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,cAAc;IACd,MAAM;IACN,MAAM;IACN,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,MAAM;IACN,MAAM;IACN,YAAY;IACZ,MAAM;IACN,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,MAAM;IACN,MAAM;IACN,WAAW;IACX,QAAQ;IACR,MAAM;CACE,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE;QACP,QAAQ,EAAE,EAAc;QACxB,UAAU,EAAE,CAAC,GAAG,mBAAmB,CAAC;QACpC,gBAAgB,EAAE,CAAC,GAAG,yBAAyB,CAAC;KACjD;IACD,OAAO,EAAE;QACP,cAAc,EAAE,KAAK;QACrB,WAAW,EAAE,qBAAqB;KACnC;IACD,MAAM,EAAE;QACN,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,IAAI;KACd;CACO,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Configuration loader for agents-reverse
+ *
+ * Loads and validates configuration from `.agents-reverse/config.yaml`.
+ * Returns sensible defaults when no config file exists.
+ */
+import { Config } from './schema.js';
+/** Directory name for agents-reverse-engineer configuration */
+export declare const CONFIG_DIR = ".agents-reverse-engineer";
+/** Configuration file name */
+export declare const CONFIG_FILE = "config.yaml";
+/**
+ * Error thrown when configuration parsing or validation fails
+ */
+export declare class ConfigError extends Error {
+    readonly filePath: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, filePath: string, cause?: Error | undefined);
+}
+/**
+ * Load configuration from `.agents-reverse/config.yaml`.
+ *
+ * If the file doesn't exist, returns default configuration.
+ * If the file exists but is invalid, throws a ConfigError with details.
+ *
+ * @param root - Root directory containing `.agents-reverse/` folder
+ * @returns Validated configuration object with all defaults applied
+ * @throws ConfigError if the config file exists but is invalid
+ *
+ * @example
+ * ```typescript
+ * const config = await loadConfig('/path/to/project');
+ * console.log(config.exclude.vendorDirs);
+ * ```
+ */
+export declare function loadConfig(root: string): Promise<Config>;
+/**
+ * Check if a configuration file exists.
+ *
+ * @param root - Root directory to check
+ * @returns true if `.agents-reverse/config.yaml` exists
+ *
+ * @example
+ * ```typescript
+ * if (!await configExists('.')) {
+ *   console.log('Run `are init` to create configuration');
+ * }
+ * ```
+ */
+export declare function configExists(root: string): Promise<boolean>;
+/**
+ * Write a default configuration file with helpful comments.
+ *
+ * Creates the `.agents-reverse/` directory if it doesn't exist.
+ * The generated file includes comments explaining each option.
+ *
+ * @param root - Root directory where `.agents-reverse/` will be created
+ *
+ * @example
+ * ```typescript
+ * await writeDefaultConfig('/path/to/project');
+ * // Creates /path/to/project/.agents-reverse/config.yaml
+ * ```
+ */
+export declare function writeDefaultConfig(root: string): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAgB,MAAM,EAAE,MAAM,aAAa,CAAC;AAGnD,+DAA+D;AAC/D,eAAO,MAAM,UAAU,6BAA6B,CAAC;AAErD,8BAA8B;AAC9B,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAGlB,QAAQ,EAAE,MAAM;aAChB,KAAK,CAAC,EAAE,KAAK;gBAF7B,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwC9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CpE"}

package/dist/config/loader.js

@@ -0,0 +1,158 @@
+/**
+ * Configuration loader for agents-reverse
+ *
+ * Loads and validates configuration from `.agents-reverse/config.yaml`.
+ * Returns sensible defaults when no config file exists.
+ */
+import { readFile, writeFile, mkdir, access } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import path from 'node:path';
+import { parse } from 'yaml';
+import { ZodError } from 'zod';
+import { ConfigSchema } from './schema.js';
+import { DEFAULT_VENDOR_DIRS, DEFAULT_BINARY_EXTENSIONS, DEFAULT_MAX_FILE_SIZE } from './defaults.js';
+/** Directory name for agents-reverse-engineer configuration */
+export const CONFIG_DIR = '.agents-reverse-engineer';
+/** Configuration file name */
+export const CONFIG_FILE = 'config.yaml';
+/**
+ * Error thrown when configuration parsing or validation fails
+ */
+export class ConfigError extends Error {
+    filePath;
+    cause;
+    constructor(message, filePath, cause) {
+        super(message);
+        this.filePath = filePath;
+        this.cause = cause;
+        this.name = 'ConfigError';
+    }
+}
+/**
+ * Load configuration from `.agents-reverse/config.yaml`.
+ *
+ * If the file doesn't exist, returns default configuration.
+ * If the file exists but is invalid, throws a ConfigError with details.
+ *
+ * @param root - Root directory containing `.agents-reverse/` folder
+ * @returns Validated configuration object with all defaults applied
+ * @throws ConfigError if the config file exists but is invalid
+ *
+ * @example
+ * ```typescript
+ * const config = await loadConfig('/path/to/project');
+ * console.log(config.exclude.vendorDirs);
+ * ```
+ */
+export async function loadConfig(root) {
+    const configPath = path.join(root, CONFIG_DIR, CONFIG_FILE);
+    try {
+        const content = await readFile(configPath, 'utf-8');
+        const raw = parse(content);
+        try {
+            return ConfigSchema.parse(raw);
+        }
+        catch (err) {
+            if (err instanceof ZodError) {
+                const issues = err.issues
+                    .map((issue) => `  - ${issue.path.join('.')}: ${issue.message}`)
+                    .join('\n');
+                throw new ConfigError(`Invalid configuration in ${configPath}:\n${issues}`, configPath, err);
+            }
+            throw err;
+        }
+    }
+    catch (err) {
+        // File not found - return defaults
+        if (err.code === 'ENOENT') {
+            return ConfigSchema.parse({});
+        }
+        // Re-throw ConfigError as-is
+        if (err instanceof ConfigError) {
+            throw err;
+        }
+        // YAML parse error
+        throw new ConfigError(`Failed to parse ${configPath}: ${err.message}`, configPath, err);
+    }
+}
+/**
+ * Check if a configuration file exists.
+ *
+ * @param root - Root directory to check
+ * @returns true if `.agents-reverse/config.yaml` exists
+ *
+ * @example
+ * ```typescript
+ * if (!await configExists('.')) {
+ *   console.log('Run `are init` to create configuration');
+ * }
+ * ```
+ */
+export async function configExists(root) {
+    const configPath = path.join(root, CONFIG_DIR, CONFIG_FILE);
+    try {
+        await access(configPath, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Write a default configuration file with helpful comments.
+ *
+ * Creates the `.agents-reverse/` directory if it doesn't exist.
+ * The generated file includes comments explaining each option.
+ *
+ * @param root - Root directory where `.agents-reverse/` will be created
+ *
+ * @example
+ * ```typescript
+ * await writeDefaultConfig('/path/to/project');
+ * // Creates /path/to/project/.agents-reverse/config.yaml
+ * ```
+ */
+export async function writeDefaultConfig(root) {
+    const configDir = path.join(root, CONFIG_DIR);
+    const configPath = path.join(configDir, CONFIG_FILE);
+    // Create directory if needed
+    await mkdir(configDir, { recursive: true });
+    // Generate config content with comments
+    const configContent = `# agents-reverse configuration
+# https://github.com/GeoloeG-IsT/agents-reverse
+
+# Exclusion rules for files and directories
+exclude:
+  # Custom glob patterns to exclude (e.g., ["*.log", "temp/**"])
+  patterns: []
+
+  # Vendor directories to exclude from analysis
+  # These are typically package managers, build outputs, or version control
+  vendorDirs:
+${DEFAULT_VENDOR_DIRS.map((dir) => `    - ${dir}`).join('\n')}
+
+  # Binary file extensions to exclude from analysis
+  # These files cannot be meaningfully analyzed as text
+  binaryExtensions:
+${DEFAULT_BINARY_EXTENSIONS.map((ext) => `    - ${ext}`).join('\n')}
+
+# Discovery options
+options:
+  # Whether to follow symbolic links during traversal
+  followSymlinks: false
+
+  # Maximum file size in bytes (files larger than this are skipped)
+  # Default: ${DEFAULT_MAX_FILE_SIZE} (1MB)
+  maxFileSize: ${DEFAULT_MAX_FILE_SIZE}
+
+# Output formatting options
+output:
+  # Whether to use colors in terminal output
+  colors: true
+
+  # Whether to show verbose output (each file as processed)
+  verbose: true
+`;
+    await writeFile(configPath, configContent, 'utf-8');
+}
+//# sourceMappingURL=loader.js.map