agents-reverse-engineer 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GeoloeG-IsT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,238 @@
+<div align="center">
+
+# AGENTS REVERSE ENGINEER
+
+**Reverse engineer your codebase into AI-friendly documentation.**
+
+**Generate `.sum` files, `AGENTS.md`, and root docs for Claude Code, OpenCode, and any AI assistant that supports `AGENTS.md`.**
+
+[![npm version](https://img.shields.io/npm/v/agents-reverse-engineer?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/agents-reverse-engineer)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+
+<br>
+
+```bash
+npx agents-reverse-engineer init --integration
+```
+
+**Works on Mac, Windows, and Linux.**
+
+<br>
+
+_"Finally, my AI assistant actually understands my codebase structure."_
+
+_"No more explaining the same architecture in every conversation."_
+
+<br>
+
+[Why This Exists](#why-this-exists) · [How It Works](#how-it-works) · [Commands](#commands) · [Generated Docs](#generated-documentation)
+
+</div>
+
+---
+
+## Why This Exists
+
+AI coding assistants are powerful, but they don't know your codebase. Every session starts fresh. You explain the same architecture, the same patterns, the same file locations — over and over.
+
+**agents-reverse-engineer** fixes that. It generates documentation that AI assistants actually read:
+
+- **`.sum` files** — Per-file summaries with purpose, exports, dependencies
+- **`AGENTS.md`** — Per-directory overviews with file organization (standard format)
+- **`CLAUDE.md`** — Project entry point for Claude Code
+- **`CODEX.md`** — Project entry point for OpenCode *(coming soon)*
+
+The result: Your AI assistant understands your codebase from the first message.
+
+---
+
+## Who This Is For
+
+Developers using AI coding assistants (Claude Code, OpenCode, Gemini CLI, or any tool supporting `AGENTS.md`) who want their assistant to actually understand their project structure — without manually writing documentation or repeating context every session.
+
+---
+
+## Getting Started
+
+```bash
+npx agents-reverse-engineer init --integration
+```
+
+This creates:
+
+1. **Config** — `.agents-reverse-engineer/config.yaml`
+2. **Commands** — `.claude/commands/are/` for Claude Code (other runtimes coming soon)
+
+Then discover your files and create the plan:
+
+```bash
+npx are discover --plan
+```
+
+Finally, in your AI assistant:
+
+```
+/are:generate
+```
+
+The assistant reads the plan and generates all documentation.
+
+> **Note:** The generated `AGENTS.md` files work with any AI assistant that supports this format. The `/are:*` commands currently target Claude Code, with OpenCode and Gemini CLI support planned.
+
+### Staying Updated
+
+```bash
+npx agents-reverse-engineer@latest init --integration
+```
+
+---
+
+## How It Works
+
+### 1. Initialize
+
+```bash
+are init --integration
+```
+
+Creates configuration and Claude Code commands in your project.
+
+---
+
+### 2. Discover & Plan
+
+```bash
+are discover --plan
+```
+
+Scans your codebase (respecting `.gitignore`), detects file types, and creates `GENERATION-PLAN.md` with all files to analyze.
+
+Uses **post-order traversal** — deepest directories first, so child documentation exists before parent directories are documented.
+
+---
+
+### 3. Generate (in your AI assistant)
+
+```
+/are:generate
+```
+
+Your AI assistant executes the plan:
+
+1. **File Analysis** — Creates `.sum` file for each source file
+2. **Directory Docs** — Creates `AGENTS.md` for each directory
+3. **Root Docs** — Creates `CLAUDE.md`, `ARCHITECTURE.md`, `STACK.md`
+
+---
+
+### 4. Update Incrementally
+
+```
+/are:update
+```
+
+Only regenerates documentation for files that changed since last run.
+
+---
+
+## Commands
+
+| Command                        | Description                      |
+| ------------------------------ | -------------------------------- |
+| `are init`                     | Create configuration file        |
+| `are init --integration`       | Also create Claude Code commands |
+| `are discover`                 | List files that will be analyzed |
+| `are discover --plan`          | Create GENERATION-PLAN.md        |
+| `are discover --show-excluded` | Show excluded files with reasons |
+
+### AI Assistant Commands
+
+| Command         | Description                    | Supported Runtimes |
+| --------------- | ------------------------------ | ------------------ |
+| `/are:init`     | Initialize config and commands | Claude Code        |
+| `/are:generate` | Generate all documentation     | Claude Code        |
+| `/are:update`   | Update changed files only      | Claude Code        |
+| `/are:discover` | Rediscover and regenerate plan | Claude Code        |
+| `/are:clean`    | Remove all generated docs      | Claude Code        |
+
+> OpenCode and Gemini CLI command support coming soon.
+
+---
+
+## Generated Documentation
+
+### `.sum` Files (Per File)
+
+```yaml
+---
+file_type: service
+generated_at: 2026-01-30T12:00:00Z
+---
+
+## Purpose
+Handles user authentication via JWT tokens.
+
+## Public Interface
+- `authenticate(token: string): User`
+- `generateToken(user: User): string`
+
+## Dependencies
+- jsonwebtoken: Token signing/verification
+- ./user-repository: User data access
+
+## Implementation Notes
+Tokens expire after 24 hours. Refresh handled by client.
+```
+
+### `AGENTS.md` (Per Directory)
+
+Directory overview with:
+
+- Description of the directory's role
+- Files grouped by purpose (Types, Services, Utils, etc.)
+- Subdirectories with brief descriptions
+
+### Root Documents
+
+- **`CLAUDE.md`** — Project entry point for Claude Code (auto-loaded)
+- **`AGENTS.md`** — Root directory overview (universal format)
+- **`ARCHITECTURE.md`** — System design overview (generated for complex projects)
+- **`STACK.md`** — Technology stack from package.json
+
+---
+
+## Configuration
+
+Edit `.agents-reverse-engineer/config.yaml`:
+
+```yaml
+exclude:
+  patterns: [] # Custom glob patterns
+  vendorDirs: # Directories to skip
+    - node_modules
+    - dist
+    - .git
+  binaryExtensions: # File types to skip
+    - .png
+    - .jpg
+
+options:
+  followSymlinks: false
+  maxFileSize: 1048576 # 1MB
+```
+
+---
+
+## Requirements
+
+- **Node.js 18+**
+- **AI Coding Assistant** — One of:
+  - [Claude Code](https://claude.ai/claude-code) (full support)
+  - [OpenCode](https://github.com/opencode-ai/opencode) (AGENTS.md supported)
+  - Any assistant supporting `AGENTS.md` format
+
+---
+
+## License
+
+MIT

package/dist/change-detection/detector.d.ts

@@ -0,0 +1,24 @@
+import type { ChangeDetectionResult, ChangeDetectionOptions } from './types.js';
+/**
+ * Check if a path is inside a git repository.
+ */
+export declare function isGitRepo(projectRoot: string): Promise<boolean>;
+/**
+ * Get the current HEAD commit hash.
+ */
+export declare function getCurrentCommit(projectRoot: string): Promise<string>;
+/**
+ * Detect files changed since a base commit.
+ *
+ * Uses git diff with --name-status and -M for rename detection.
+ * Optionally includes uncommitted changes (staged + working directory).
+ */
+export declare function getChangedFiles(projectRoot: string, baseCommit: string, options?: ChangeDetectionOptions): Promise<ChangeDetectionResult>;
+/**
+ * Compute SHA-256 hash of a file's content.
+ *
+ * @param filePath - Absolute path to the file
+ * @returns Hex-encoded SHA-256 hash
+ */
+export declare function computeContentHash(filePath: string): Promise<string>;
+//# sourceMappingURL=detector.d.ts.map

package/dist/change-detection/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/change-detection/detector.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAc,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE5F;;GAEG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGrE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3E;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAgFhC;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1E"}

package/dist/change-detection/detector.js

@@ -0,0 +1,114 @@
+/**
+ * Git change detection and content hashing
+ *
+ * Uses simple-git for git operations and Node.js crypto for hashing.
+ */
+import { simpleGit } from 'simple-git';
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+/**
+ * Check if a path is inside a git repository.
+ */
+export async function isGitRepo(projectRoot) {
+    const git = simpleGit(projectRoot);
+    return git.checkIsRepo();
+}
+/**
+ * Get the current HEAD commit hash.
+ */
+export async function getCurrentCommit(projectRoot) {
+    const git = simpleGit(projectRoot);
+    const hash = await git.revparse(['HEAD']);
+    return hash.trim();
+}
+/**
+ * Detect files changed since a base commit.
+ *
+ * Uses git diff with --name-status and -M for rename detection.
+ * Optionally includes uncommitted changes (staged + working directory).
+ */
+export async function getChangedFiles(projectRoot, baseCommit, options = {}) {
+    const git = simpleGit(projectRoot);
+    const currentCommit = await getCurrentCommit(projectRoot);
+    const changes = [];
+    // Get committed changes from baseCommit to HEAD
+    const diff = await git.diff([
+        '--name-status',
+        '-M', // Detect renames (50% similarity threshold)
+        baseCommit,
+        'HEAD',
+    ]);
+    // Parse diff output
+    // Format: STATUS\tFILE (or STATUS\tOLD\tNEW for renames)
+    const lines = diff.trim().split('\n').filter(line => line.length > 0);
+    for (const line of lines) {
+        const parts = line.split('\t');
+        if (parts.length < 2)
+            continue;
+        const status = parts[0];
+        const filePath = parts[parts.length - 1]; // Last part is always the (new) path
+        if (status === 'A') {
+            changes.push({ path: filePath, status: 'added' });
+        }
+        else if (status === 'M') {
+            changes.push({ path: filePath, status: 'modified' });
+        }
+        else if (status === 'D') {
+            changes.push({ path: filePath, status: 'deleted' });
+        }
+        else if (status.startsWith('R')) {
+            // Rename: R100 old new (R followed by similarity percentage)
+            const oldPath = parts[1];
+            changes.push({
+                path: filePath,
+                status: 'renamed',
+                oldPath,
+            });
+        }
+    }
+    // Optionally include uncommitted changes
+    if (options.includeUncommitted) {
+        const status = await git.status();
+        // Modified but not staged
+        for (const file of status.modified) {
+            if (!changes.some(c => c.path === file)) {
+                changes.push({ path: file, status: 'modified' });
+            }
+        }
+        // Staged for deletion
+        for (const file of status.deleted) {
+            if (!changes.some(c => c.path === file)) {
+                changes.push({ path: file, status: 'deleted' });
+            }
+        }
+        // Untracked files (new files not yet added)
+        for (const file of status.not_added) {
+            if (!changes.some(c => c.path === file)) {
+                changes.push({ path: file, status: 'added' });
+            }
+        }
+        // Staged files (new or modified)
+        for (const file of status.staged) {
+            if (!changes.some(c => c.path === file)) {
+                changes.push({ path: file, status: 'added' });
+            }
+        }
+    }
+    return {
+        currentCommit,
+        baseCommit,
+        changes,
+        includesUncommitted: options.includeUncommitted ?? false,
+    };
+}
+/**
+ * Compute SHA-256 hash of a file's content.
+ *
+ * @param filePath - Absolute path to the file
+ * @returns Hex-encoded SHA-256 hash
+ */
+export async function computeContentHash(filePath) {
+    const content = await readFile(filePath);
+    return createHash('sha256').update(content).digest('hex');
+}
+//# sourceMappingURL=detector.js.map

package/dist/change-detection/detector.js.map

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

package/dist/change-detection/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Change detection module
+ *
+ * Provides git-based change detection for incremental updates.
+ * Detects added, modified, deleted, and renamed files.
+ */
+export { isGitRepo, getCurrentCommit, getChangedFiles, computeContentHash, } from './detector.js';
+export type { ChangeType, FileChange, ChangeDetectionResult, ChangeDetectionOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/change-detection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/change-detection/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/change-detection/index.js

@@ -0,0 +1,8 @@
+/**
+ * Change detection module
+ *
+ * Provides git-based change detection for incremental updates.
+ * Detects added, modified, deleted, and renamed files.
+ */
+export { isGitRepo, getCurrentCommit, getChangedFiles, computeContentHash, } from './detector.js';
+//# sourceMappingURL=index.js.map

package/dist/change-detection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/change-detection/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/dist/change-detection/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Types for git change detection
+ */
+/**
+ * Type of change detected for a file
+ */
+export type ChangeType = 'added' | 'modified' | 'deleted' | 'renamed';
+/**
+ * A file change detected from git diff
+ */
+export interface FileChange {
+    /** Relative path to the file (new path for renames) */
+    path: string;
+    /** Type of change */
+    status: ChangeType;
+    /** Original path for renamed files */
+    oldPath?: string;
+}
+/**
+ * Result of change detection
+ */
+export interface ChangeDetectionResult {
+    /** Current commit hash */
+    currentCommit: string;
+    /** Commit hash we're comparing from */
+    baseCommit: string;
+    /** List of changed files */
+    changes: FileChange[];
+    /** Whether uncommitted changes were included */
+    includesUncommitted: boolean;
+}
+/**
+ * Options for change detection
+ */
+export interface ChangeDetectionOptions {
+    /** Include uncommitted (staged and working directory) changes */
+    includeUncommitted?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/change-detection/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/change-detection/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,gDAAgD;IAChD,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}

package/dist/change-detection/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for git change detection
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/change-detection/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/change-detection/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cli/discover.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `are discover` command - Discover files to analyze
+ *
+ * Walks a directory tree and applies filters (gitignore, vendor, binary, custom)
+ * to identify files suitable for analysis.
+ */
+/**
+ * Options for the discover command.
+ */
+export interface DiscoverOptions {
+    /**
+     * Suppress output except errors.
+     * @default false
+     */
+    quiet: boolean;
+    /**
+     * Show each excluded file with reason.
+     * @default false
+     */
+    showExcluded: boolean;
+    /**
+     * Show verbose output (each file as discovered).
+     * Derived: true unless quiet is set.
+     * @default true
+     */
+    verbose: boolean;
+    /**
+     * Generate GENERATION-PLAN.md file.
+     * @default false
+     */
+    plan: boolean;
+}
+/**
+ * Execute the `are discover` command.
+ *
+ * Discovers files in the target directory, applying all configured filters
+ * (gitignore, vendor, binary, custom patterns).
+ *
+ * @param targetPath - Directory to scan (defaults to current working directory)
+ * @param options - Command options
+ *
+ * @example
+ * ```typescript
+ * await discoverCommand('.', {
+ *   quiet: false,
+ *   showExcluded: true,
+ *   verbose: true,
+ * });
+ * ```
+ */
+export declare function discoverCommand(targetPath: string, options: DiscoverOptions): Promise<void>;
+//# sourceMappingURL=discover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/cli/discover.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CA6Gf"}

package/dist/cli/discover.js

@@ -0,0 +1,125 @@
+/**
+ * `are discover` command - Discover files to analyze
+ *
+ * Walks a directory tree and applies filters (gitignore, vendor, binary, custom)
+ * to identify files suitable for analysis.
+ */
+import path from 'node:path';
+import { access, mkdir, writeFile } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { walkDirectory } from '../discovery/walker.js';
+import { applyFilters, createGitignoreFilter, createVendorFilter, createBinaryFilter, createCustomFilter, } from '../discovery/filters/index.js';
+import { loadConfig } from '../config/loader.js';
+import { createLogger } from '../output/logger.js';
+import { createOrchestrator } from '../generation/orchestrator.js';
+import { buildExecutionPlan, formatExecutionPlanAsMarkdown } from '../generation/executor.js';
+/**
+ * Execute the `are discover` command.
+ *
+ * Discovers files in the target directory, applying all configured filters
+ * (gitignore, vendor, binary, custom patterns).
+ *
+ * @param targetPath - Directory to scan (defaults to current working directory)
+ * @param options - Command options
+ *
+ * @example
+ * ```typescript
+ * await discoverCommand('.', {
+ *   quiet: false,
+ *   showExcluded: true,
+ *   verbose: true,
+ * });
+ * ```
+ */
+export async function discoverCommand(targetPath, options) {
+    // Resolve to absolute path (default to cwd)
+    const resolvedPath = path.resolve(targetPath || process.cwd());
+    // Load configuration (uses defaults if no config file)
+    const config = await loadConfig(resolvedPath);
+    // Create logger with options derived from CLI flags and config
+    const logger = createLogger({
+        verbose: options.quiet ? false : (options.verbose ?? config.output.verbose),
+        quiet: options.quiet,
+        colors: config.output.colors,
+        showExcluded: options.showExcluded,
+    });
+    // Verify target path exists
+    try {
+        await access(resolvedPath, constants.R_OK);
+    }
+    catch (err) {
+        const error = err;
+        if (error.code === 'ENOENT') {
+            logger.error(`Directory not found: ${resolvedPath}`);
+            process.exit(1);
+        }
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            logger.error(`Permission denied: ${resolvedPath}`);
+            process.exit(1);
+        }
+        throw error;
+    }
+    logger.info(`Discovering files in ${resolvedPath}...`);
+    logger.info('');
+    // Create filters in order (per DISC requirements)
+    const gitignoreFilter = await createGitignoreFilter(resolvedPath);
+    const vendorFilter = createVendorFilter(config.exclude.vendorDirs);
+    const binaryFilter = createBinaryFilter({
+        maxFileSize: config.options.maxFileSize,
+        additionalExtensions: config.exclude.binaryExtensions,
+    });
+    const customFilter = createCustomFilter(config.exclude.patterns, resolvedPath);
+    const filters = [gitignoreFilter, vendorFilter, binaryFilter, customFilter];
+    // Walk directory
+    const files = await walkDirectory({
+        cwd: resolvedPath,
+        followSymlinks: config.options.followSymlinks,
+    });
+    // Apply filters
+    const result = await applyFilters(files, filters);
+    // Log results
+    // Make paths relative for cleaner output
+    const relativePath = (absPath) => path.relative(resolvedPath, absPath);
+    // Show each included file in verbose mode
+    for (const file of result.included) {
+        logger.file(relativePath(file));
+    }
+    // Show each excluded file if --show-excluded
+    for (const excluded of result.excluded) {
+        logger.excluded(relativePath(excluded.path), excluded.reason, excluded.filter);
+    }
+    // Always show summary (unless quiet)
+    logger.summary(result.included.length, result.excluded.length);
+    // Generate GENERATION-PLAN.md if --plan flag is set
+    if (options.plan) {
+        logger.info('');
+        logger.info('Generating execution plan...');
+        // Create discovery result for orchestrator
+        const discoveryResult = {
+            files: result.included,
+            excluded: result.excluded.map(e => ({ path: e.path, reason: e.reason })),
+        };
+        // Create orchestrator and build generation plan
+        const orchestrator = createOrchestrator(config, resolvedPath, discoveryResult.files.length);
+        const generationPlan = await orchestrator.createPlan(discoveryResult);
+        // Build execution plan with post-order traversal
+        const executionPlan = buildExecutionPlan(generationPlan, resolvedPath);
+        // Format as markdown
+        const markdown = formatExecutionPlanAsMarkdown(executionPlan);
+        // Write to .agents-reverse-engineer/GENERATION-PLAN.md
+        const configDir = path.join(resolvedPath, '.agents-reverse-engineer');
+        const planPath = path.join(configDir, 'GENERATION-PLAN.md');
+        try {
+            await mkdir(configDir, { recursive: true });
+            await writeFile(planPath, markdown, 'utf8');
+            logger.info(`Created ${path.relative(resolvedPath, planPath)}`);
+        }
+        catch (err) {
+            logger.error(`Failed to write plan: ${err.message}`);
+            process.exit(1);
+        }
+    }
+    // Exit with code 0 on success
+    process.exit(0);
+}
+//# sourceMappingURL=discover.js.map