agents-reverse-engineer 0.3.6 → 0.4.1

package/dist/ai/telemetry/logger.js

@@ -0,0 +1,130 @@
+/**
+ * In-memory telemetry logger for AI service calls.
+ *
+ * Accumulates {@link TelemetryEntry} instances during a run and computes
+ * aggregate summaries. The logger is created once per CLI invocation and
+ * finalized when the run completes.
+ *
+ * @module
+ */
+/**
+ * Accumulates per-call telemetry entries in memory and produces a
+ * complete {@link RunLog} when the run finishes.
+ *
+ * @example
+ * ```typescript
+ * const logger = new TelemetryLogger('2026-02-07T12:00:00.000Z');
+ * logger.addEntry(entry);
+ * const summary = logger.getSummary();
+ * const runLog = logger.toRunLog();
+ * ```
+ */
+export class TelemetryLogger {
+    /** Unique identifier for this run (ISO timestamp-based) */
+    runId;
+    /** ISO 8601 timestamp when the run started */
+    startTime;
+    /** Accumulated telemetry entries */
+    entries = [];
+    /**
+     * Create a new telemetry logger for a run.
+     *
+     * @param runId - Unique run identifier (typically an ISO timestamp)
+     */
+    constructor(runId) {
+        this.runId = runId;
+        this.startTime = new Date().toISOString();
+    }
+    /**
+     * Record a telemetry entry for a completed AI call.
+     *
+     * @param entry - The telemetry entry to record
+     */
+    addEntry(entry) {
+        this.entries.push(entry);
+    }
+    /**
+     * Get all recorded entries as a read-only array.
+     *
+     * @returns Immutable view of the accumulated entries
+     */
+    getEntries() {
+        return this.entries;
+    }
+    /**
+     * Update the most recent entry's filesRead array.
+     *
+     * Called by the AI service after the command runner attaches file
+     * metadata to the last call.
+     *
+     * @param filesRead - Array of file-read records to attach
+     */
+    setFilesReadOnLastEntry(filesRead) {
+        if (this.entries.length === 0)
+            return;
+        this.entries[this.entries.length - 1].filesRead = filesRead;
+    }
+    /**
+     * Compute aggregate summary statistics from all recorded entries.
+     *
+     * Totals are computed on every call (not cached) so the summary
+     * always reflects the current state of the entries array.
+     *
+     * @returns Summary with totals for calls, tokens, cost, duration, and errors
+     */
+    getSummary() {
+        let totalInputTokens = 0;
+        let totalOutputTokens = 0;
+        let totalCostUsd = 0;
+        let totalDurationMs = 0;
+        let errorCount = 0;
+        let costAvailable = false;
+        let totalFilesRead = 0;
+        const uniqueFilePaths = new Set();
+        for (const entry of this.entries) {
+            totalInputTokens += entry.inputTokens;
+            totalOutputTokens += entry.outputTokens;
+            totalCostUsd += entry.costUsd;
+            totalDurationMs += entry.latencyMs;
+            if (entry.error !== undefined) {
+                errorCount++;
+            }
+            if (entry.costSource !== 'unavailable') {
+                costAvailable = true;
+            }
+            totalFilesRead += entry.filesRead.length;
+            for (const file of entry.filesRead) {
+                uniqueFilePaths.add(file.path);
+            }
+        }
+        return {
+            totalCalls: this.entries.length,
+            totalInputTokens,
+            totalOutputTokens,
+            totalCostUsd,
+            totalDurationMs,
+            errorCount,
+            costAvailable,
+            totalFilesRead,
+            uniqueFilesRead: uniqueFilePaths.size,
+        };
+    }
+    /**
+     * Assemble the complete {@link RunLog} for this run.
+     *
+     * Sets `endTime` to the current time, includes all entries, and
+     * computes the summary. Call this once when the run is finished.
+     *
+     * @returns Complete run log ready for serialization
+     */
+    toRunLog() {
+        return {
+            runId: this.runId,
+            startTime: this.startTime,
+            endTime: new Date().toISOString(),
+            entries: [...this.entries],
+            summary: this.getSummary(),
+        };
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/ai/telemetry/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/ai/telemetry/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,eAAe;IAC1B,2DAA2D;IAClD,KAAK,CAAS;IAEvB,8CAA8C;IACrC,SAAS,CAAS;IAE3B,oCAAoC;IACnB,OAAO,GAAqB,EAAE,CAAC;IAEhD;;;;OAIG;IACH,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,KAAqB;QAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,uBAAuB,CAAC,SAAqB;QAC3C,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACtC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/D,CAAC;IAED;;;;;;;OAOG;IACH,UAAU;QACR,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACzB,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;QAE1C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,gBAAgB,IAAI,KAAK,CAAC,WAAW,CAAC;YACtC,iBAAiB,IAAI,KAAK,CAAC,YAAY,CAAC;YACxC,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC;YAC9B,eAAe,IAAI,KAAK,CAAC,SAAS,CAAC;YACnC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC9B,UAAU,EAAE,CAAC;YACf,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;gBACvC,aAAa,GAAG,IAAI,CAAC;YACvB,CAAC;YACD,cAAc,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;YACzC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACnC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAED,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC/B,gBAAgB;YAChB,iBAAiB;YACjB,YAAY;YACZ,eAAe;YACf,UAAU;YACV,aAAa;YACb,cAAc;YACd,eAAe,EAAE,eAAe,CAAC,IAAI;SACtC,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ;QACN,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACjC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YAC1B,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;SAC3B,CAAC;IACJ,CAAC;CACF"}

package/dist/ai/telemetry/run-log.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Run log writer for AI telemetry.
+ *
+ * Writes a completed {@link RunLog} to disk as pretty-printed JSON.
+ * Each run produces a single file in `.agents-reverse-engineer/logs/`
+ * with a filename derived from the run's start timestamp.
+ *
+ * @module
+ */
+import type { RunLog } from '../types.js';
+/**
+ * Write a completed run log to disk as pretty-printed JSON.
+ *
+ * Creates the logs directory if it does not exist. The filename is derived
+ * from the run's `startTime` field with `:` and `.` replaced by `-` so
+ * that it forms a valid filename on all platforms.
+ *
+ * @param projectRoot - Absolute path to the project root directory
+ * @param runLog - The completed run log to write
+ * @returns Absolute path to the written file
+ *
+ * @example
+ * ```typescript
+ * const logPath = await writeRunLog('/home/user/project', runLog);
+ * // logPath: /home/user/project/.agents-reverse-engineer/logs/run-2026-02-07T12-00-00-000Z.json
+ * ```
+ */
+export declare function writeRunLog(projectRoot: string, runLog: RunLog): Promise<string>;
+//# sourceMappingURL=run-log.d.ts.map

package/dist/ai/telemetry/run-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-log.d.ts","sourceRoot":"","sources":["../../../src/ai/telemetry/run-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAK1C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAetF"}

package/dist/ai/telemetry/run-log.js

@@ -0,0 +1,43 @@
+/**
+ * Run log writer for AI telemetry.
+ *
+ * Writes a completed {@link RunLog} to disk as pretty-printed JSON.
+ * Each run produces a single file in `.agents-reverse-engineer/logs/`
+ * with a filename derived from the run's start timestamp.
+ *
+ * @module
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/** Directory name for telemetry log files (relative to project root) */
+const LOGS_DIR = '.agents-reverse-engineer/logs';
+/**
+ * Write a completed run log to disk as pretty-printed JSON.
+ *
+ * Creates the logs directory if it does not exist. The filename is derived
+ * from the run's `startTime` field with `:` and `.` replaced by `-` so
+ * that it forms a valid filename on all platforms.
+ *
+ * @param projectRoot - Absolute path to the project root directory
+ * @param runLog - The completed run log to write
+ * @returns Absolute path to the written file
+ *
+ * @example
+ * ```typescript
+ * const logPath = await writeRunLog('/home/user/project', runLog);
+ * // logPath: /home/user/project/.agents-reverse-engineer/logs/run-2026-02-07T12-00-00-000Z.json
+ * ```
+ */
+export async function writeRunLog(projectRoot, runLog) {
+    const logsDir = path.join(projectRoot, LOGS_DIR);
+    // Create the logs directory if it does not exist
+    await fs.mkdir(logsDir, { recursive: true });
+    // Build filename: replace : and . with - so ISO timestamps become valid filenames
+    const safeTimestamp = runLog.startTime.replace(/[:.]/g, '-');
+    const filename = `run-${safeTimestamp}.json`;
+    const filePath = path.join(logsDir, filename);
+    // Write pretty-printed JSON
+    await fs.writeFile(filePath, JSON.stringify(runLog, null, 2), 'utf-8');
+    return filePath;
+}
+//# sourceMappingURL=run-log.js.map

package/dist/ai/telemetry/run-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-log.js","sourceRoot":"","sources":["../../../src/ai/telemetry/run-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,wEAAwE;AACxE,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB,EAAE,MAAc;IACnE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAEjD,iDAAiD;IACjD,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,kFAAkF;IAClF,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,OAAO,aAAa,OAAO,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE9C,4BAA4B;IAC5B,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAEvE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/ai/types.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Shared types for the AI service layer.
+ *
+ * Defines the contract for backends, responses, subprocess results,
+ * retry configuration, and telemetry logging. Every AI service module
+ * imports from this file.
+ */
+/**
+ * Result returned by the subprocess wrapper after a CLI process completes.
+ *
+ * Always populated -- even on error or timeout, the fields are filled
+ * with whatever information was available.
+ */
+export interface SubprocessResult {
+    /** Standard output captured from the child process */
+    stdout: string;
+    /** Standard error captured from the child process */
+    stderr: string;
+    /** Numeric exit code (0 = success, non-zero = failure) */
+    exitCode: number;
+    /** Signal that terminated the process, or `null` if it exited normally */
+    signal: string | null;
+    /** Wall-clock duration in milliseconds */
+    durationMs: number;
+    /** Whether the process was killed because it exceeded its timeout */
+    timedOut: boolean;
+}
+/**
+ * Input options for an AI call.
+ *
+ * Only `prompt` is required; all other fields have backend-specific defaults.
+ */
+export interface AICallOptions {
+    /** The prompt to send to the AI model */
+    prompt: string;
+    /** Optional system prompt to set context/behavior */
+    systemPrompt?: string;
+    /** Model identifier (e.g., "sonnet", "opus") -- backend interprets this */
+    model?: string;
+    /** Subprocess timeout in milliseconds (overrides config default) */
+    timeoutMs?: number;
+    /** Maximum number of agentic turns (backend-specific) */
+    maxTurns?: number;
+}
+/**
+ * Normalized response from any AI CLI backend.
+ *
+ * Every backend adapter must parse its CLI's raw output into this shape
+ * so that callers never need to know which backend was used.
+ */
+export interface AIResponse {
+    /** The AI model's text response */
+    text: string;
+    /** Model identifier as reported by the backend */
+    model: string;
+    /** Number of input tokens consumed */
+    inputTokens: number;
+    /** Number of output tokens generated */
+    outputTokens: number;
+    /** Number of tokens served from cache reads */
+    cacheReadTokens: number;
+    /** Number of tokens written to cache */
+    cacheCreationTokens: number;
+    /** Estimated cost in USD for this call */
+    costUsd: number;
+    /** Wall-clock duration in milliseconds */
+    durationMs: number;
+    /** Process exit code from the CLI */
+    exitCode: number;
+    /** Original CLI JSON output for debugging */
+    raw: unknown;
+}
+/**
+ * Contract for an AI CLI backend adapter.
+ *
+ * Each supported CLI (Claude, Gemini, OpenCode) implements this interface.
+ * The registry selects the appropriate backend at runtime.
+ *
+ * @example
+ * ```typescript
+ * const backend: AIBackend = new ClaudeBackend();
+ * if (await backend.isAvailable()) {
+ *   const args = backend.buildArgs({ prompt: 'Hello' });
+ *   // spawn the process with backend.cliCommand and args
+ * }
+ * ```
+ */
+export interface AIBackend {
+    /** Human-readable backend name (e.g., "Claude", "Gemini") */
+    readonly name: string;
+    /** CLI executable name on PATH (e.g., "claude", "gemini") */
+    readonly cliCommand: string;
+    /** Check whether this backend's CLI is available on PATH */
+    isAvailable(): Promise<boolean>;
+    /** Build the CLI argument array for a given call */
+    buildArgs(options: AICallOptions): string[];
+    /** Parse the CLI's stdout into a normalized {@link AIResponse} */
+    parseResponse(stdout: string, durationMs: number, exitCode: number): AIResponse;
+    /** Get user-facing install instructions when the CLI is not found */
+    getInstallInstructions(): string;
+}
+/**
+ * Configuration for the retry utility.
+ *
+ * Controls exponential backoff timing and which errors are retryable.
+ */
+export interface RetryOptions {
+    /** Maximum number of retries (e.g., 3 means up to 4 total attempts) */
+    maxRetries: number;
+    /** Base delay in milliseconds before first retry */
+    baseDelayMs: number;
+    /** Maximum delay cap in milliseconds */
+    maxDelayMs: number;
+    /** Exponential multiplier applied to the base delay */
+    multiplier: number;
+    /** Predicate that returns `true` if the error is transient and retryable */
+    isRetryable: (error: unknown) => boolean;
+    /** Optional callback invoked before each retry attempt */
+    onRetry?: (attempt: number, error: unknown) => void;
+}
+import type { CostSource } from './pricing.js';
+export type { CostSource } from './pricing.js';
+/**
+ * Record of a single file read that was sent as context to an AI call.
+ */
+export interface FileRead {
+    /** File path relative to project root */
+    path: string;
+    /** File size in bytes at time of read */
+    sizeBytes: number;
+}
+/**
+ * Per-call telemetry log entry.
+ *
+ * Captures everything needed to replay or debug a single AI call
+ * without re-running it.
+ */
+export interface TelemetryEntry {
+    /** ISO 8601 timestamp when the call was initiated */
+    timestamp: string;
+    /** The prompt that was sent */
+    prompt: string;
+    /** The system prompt, if one was used */
+    systemPrompt?: string;
+    /** The AI model's text response */
+    response: string;
+    /** Model identifier */
+    model: string;
+    /** Number of input tokens consumed */
+    inputTokens: number;
+    /** Number of output tokens generated */
+    outputTokens: number;
+    /** Number of tokens served from cache reads */
+    cacheReadTokens: number;
+    /** Number of tokens written to cache */
+    cacheCreationTokens: number;
+    /** Estimated cost in USD */
+    costUsd: number;
+    /** Wall-clock latency in milliseconds */
+    latencyMs: number;
+    /** Process exit code */
+    exitCode: number;
+    /** Error message, if the call failed */
+    error?: string;
+    /** Number of retries that occurred before this result */
+    retryCount: number;
+    /** AI thinking/reasoning content. "not supported" when backend doesn't provide it */
+    thinking: string;
+    /** Files sent as context for this call */
+    filesRead: FileRead[];
+    /** How the cost was determined */
+    costSource: CostSource;
+}
+/**
+ * Per-run log file structure.
+ *
+ * Aggregates all {@link TelemetryEntry} instances for a single CLI run,
+ * plus a computed summary for quick cost/performance review.
+ */
+export interface RunLog {
+    /** Unique run identifier (ISO timestamp-based) */
+    runId: string;
+    /** ISO 8601 timestamp when the run started */
+    startTime: string;
+    /** ISO 8601 timestamp when the run finished */
+    endTime: string;
+    /** All individual call entries */
+    entries: TelemetryEntry[];
+    /** Aggregated summary across all entries */
+    summary: {
+        /** Total number of AI calls made */
+        totalCalls: number;
+        /** Sum of input tokens across all calls */
+        totalInputTokens: number;
+        /** Sum of output tokens across all calls */
+        totalOutputTokens: number;
+        /** Sum of estimated cost across all calls */
+        totalCostUsd: number;
+        /** Total wall-clock duration in milliseconds */
+        totalDurationMs: number;
+        /** Number of calls that resulted in an error */
+        errorCount: number;
+        /** Whether cost data is available for all/most entries */
+        costAvailable: boolean;
+        /** Total file reads across all calls (including duplicates) */
+        totalFilesRead: number;
+        /** Unique files read (deduped by path) */
+        uniqueFilesRead: number;
+    };
+}
+/** Error codes for typed error handling in the AI service layer */
+export type AIServiceErrorCode = 'CLI_NOT_FOUND' | 'TIMEOUT' | 'PARSE_ERROR' | 'SUBPROCESS_ERROR' | 'RATE_LIMIT';
+/**
+ * Typed error for AI service failures.
+ *
+ * Carries a machine-readable {@link AIServiceErrorCode} so callers can
+ * branch on the error type without parsing message strings.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await callAI(options);
+ * } catch (error) {
+ *   if (error instanceof AIServiceError && error.code === 'RATE_LIMIT') {
+ *     // handle rate limiting
+ *   }
+ * }
+ * ```
+ */
+export declare class AIServiceError extends Error {
+    /** Machine-readable error code */
+    readonly code: AIServiceErrorCode;
+    constructor(code: AIServiceErrorCode, message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/types.d.ts.map

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

package/dist/ai/types.js

@@ -0,0 +1,34 @@
+/**
+ * Shared types for the AI service layer.
+ *
+ * Defines the contract for backends, responses, subprocess results,
+ * retry configuration, and telemetry logging. Every AI service module
+ * imports from this file.
+ */
+/**
+ * Typed error for AI service failures.
+ *
+ * Carries a machine-readable {@link AIServiceErrorCode} so callers can
+ * branch on the error type without parsing message strings.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await callAI(options);
+ * } catch (error) {
+ *   if (error instanceof AIServiceError && error.code === 'RATE_LIMIT') {
+ *     // handle rate limiting
+ *   }
+ * }
+ * ```
+ */
+export class AIServiceError extends Error {
+    /** Machine-readable error code */
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'AIServiceError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/ai/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0PH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,kCAAkC;IACzB,IAAI,CAAqB;IAElC,YAAY,IAAwB,EAAE,OAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

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

@@ -1 +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"}
+{"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,CA2Gf"}

package/dist/cli/discover.js

@@ -119,7 +119,5 @@ export async function discoverCommand(targetPath, options) {
             process.exit(1);
         }
     }
-    // Exit with code 0 on success
-    process.exit(0);
 }
 //# sourceMappingURL=discover.js.map

package/dist/cli/discover.js.map

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

package/dist/cli/generate.d.ts

@@ -1,13 +1,15 @@
 /**
  * CLI generate command
  *
- * Creates a documentation generation plan by:
+ * Creates and executes a documentation generation plan by:
  * 1. Discovering files to analyze
- * 2. Detecting file types
- * 3. Creating analysis tasks with prompts
- * 4. Tracking token budget
+ * 2. Detecting file types and creating analysis tasks
+ * 3. Resolving an AI CLI backend
+ * 4. Running concurrent AI analysis via CommandRunner
+ * 5. Producing .sum files, AGENTS.md, and root documents
  *
- * With --execute flag, outputs tasks as JSON for AI agent execution.
+ * With --dry-run, shows the plan without making any AI calls.
+ * With --execute or --stream (deprecated), outputs JSON for external tools.
  */
 /**
  * Options for the generate command.
@@ -21,21 +23,27 @@ export interface GenerateOptions {
     dryRun?: boolean;
     /** Override token budget */
     budget?: number;
-    /** Execute mode - output JSON for AI agent execution */
+    /** Number of concurrent AI calls */
+    concurrency?: number;
+    /** Stop on first file analysis failure */
+    failFast?: boolean;
+    /** Show AI prompts and backend details */
+    debug?: boolean;
+    /** @deprecated Execute mode - output JSON for AI agent execution */
     execute?: boolean;
-    /** Stream mode - output tasks one per line */
+    /** @deprecated Stream mode - output tasks one per line */
     stream?: boolean;
 }
 /**
- * Generate command - creates documentation generation plan.
+ * Generate command - discovers files, plans analysis, and executes AI-driven
+ * documentation generation.
  *
- * This command:
- * 1. Discovers files to analyze
- * 2. Detects file types
- * 3. Creates analysis tasks (prompts)
- * 4. Reports budget and plan
+ * Default behavior: resolves an AI CLI backend, builds an execution plan,
+ * and runs concurrent AI analysis via the CommandRunner. Produces .sum files,
+ * AGENTS.md per directory, and root documents (CLAUDE.md, ARCHITECTURE.md, etc.).
  *
- * The actual analysis is performed by the host LLM using the generated prompts.
+ * @param targetPath - Directory to generate documentation for
+ * @param options - Command options (concurrency, failFast, debug, etc.)
  */
 export declare function generateCommand(targetPath: string, options: GenerateOptions): Promise<void>;
 //# sourceMappingURL=generate.d.ts.map

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

@@ -1 +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;AAuFD;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CA0Hf"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/cli/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAyBH;;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,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAuFD;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CA6Kf"}