@ttfw/envoi 1.0.0

package/dist/lib/diff.js

@@ -0,0 +1,257 @@
+/**
+ * Git diff analysis functions for computing touched set.
+ *
+ * Used by Judge phase to compute the touched set (all files modified by builder)
+ * based on git reality, not builder's self-report.
+ */
+import { execSync } from 'node:child_process';
+/**
+ * Gets tracked files that have changed since a base commit.
+ *
+ * Uses `git diff --name-status` to get all tracked changes.
+ * Parses status codes: A=added, M=modified, D=deleted, R=renamed.
+ *
+ * @param baseCommit - The base commit SHA to diff against
+ * @returns Array of file paths that have changed
+ * @throws {Error} If the diff operation fails
+ *
+ * @example
+ * ```typescript
+ * const paths = getTouchedTracked('abc123');
+ * console.log(`${paths.length} tracked files changed`);
+ * ```
+ */
+export function getTouchedTracked(baseCommit) {
+    try {
+        const output = execSync(`git diff --name-status ${baseCommit}..HEAD`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (!output.trim()) {
+            return [];
+        }
+        return output
+            .trim()
+            .split('\n')
+            .map((line) => {
+            // Parse format: STATUS\tpath or STATUS\told_path\tnew_path (for renames)
+            const parts = line.split('\t');
+            if (parts.length >= 2) {
+                // For renames (R), return the new path
+                // For others, return the path
+                return parts.length === 3 ? parts[2] : parts[1];
+            }
+            return '';
+        })
+            .filter((path) => path.length > 0);
+    }
+    catch (error) {
+        throw new Error(`Failed to get touched tracked files from ${baseCommit}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Gets untracked files that are new or modified.
+ *
+ * Uses `git status --porcelain` and filters for:
+ * - Lines starting with `??` (untracked files)
+ * - Lines starting with `A` (added files in index, but also catches untracked)
+ *
+ * @returns Array of untracked file paths
+ *
+ * @example
+ * ```typescript
+ * const untracked = getTouchedUntracked();
+ * console.log(`${untracked.length} untracked files`);
+ * ```
+ */
+export function getTouchedUntracked() {
+    try {
+        const output = execSync('git status --porcelain', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (!output.trim()) {
+            return [];
+        }
+        return output
+            .trim()
+            .split('\n')
+            .filter((line) => {
+            // Filter for untracked files (??) or added files (A)
+            const status = line.substring(0, 2);
+            return status === '??' || status.startsWith('A');
+        })
+            .map((line) => {
+            // Remove status prefix (2 chars + space)
+            return line.substring(3);
+        })
+            .filter((path) => path.length > 0);
+    }
+    catch {
+        // If git status fails, return empty array
+        return [];
+    }
+}
+/**
+ * Gets line statistics (added/deleted) for changes since a base commit.
+ *
+ * Uses `git diff --numstat` to get line counts.
+ * Handles binary files which show `- -` instead of numbers.
+ *
+ * @param baseCommit - The base commit SHA to diff against
+ * @returns Object with lines_added and lines_deleted totals
+ * @throws {Error} If the diff operation fails
+ *
+ * @example
+ * ```typescript
+ * const stats = getDiffStats('abc123');
+ * console.log(`Added: ${stats.lines_added}, Deleted: ${stats.lines_deleted}`);
+ * ```
+ */
+export function getDiffStats(baseCommit) {
+    try {
+        const output = execSync(`git diff --numstat ${baseCommit}..HEAD`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (!output.trim()) {
+            return { lines_added: 0, lines_deleted: 0 };
+        }
+        let lines_added = 0;
+        let lines_deleted = 0;
+        output
+            .trim()
+            .split('\n')
+            .forEach((line) => {
+            const parts = line.split('\t');
+            if (parts.length >= 2) {
+                const added = parts[0];
+                const deleted = parts[1];
+                // Handle binary files which show "-" instead of numbers
+                if (added !== '-' && !isNaN(Number(added))) {
+                    lines_added += Number(added);
+                }
+                if (deleted !== '-' && !isNaN(Number(deleted))) {
+                    lines_deleted += Number(deleted);
+                }
+            }
+        });
+        return { lines_added, lines_deleted };
+    }
+    catch (error) {
+        throw new Error(`Failed to get diff stats from ${baseCommit}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Analyzes git diff to compute the complete touched set.
+ *
+ * Combines tracked changes, untracked files, and line statistics
+ * into a complete DiffAnalysis object.
+ *
+ * @param baseCommit - The base commit SHA to diff against
+ * @returns Complete DiffAnalysis with all metrics
+ * @throws {Error} If any git operation fails
+ *
+ * @example
+ * ```typescript
+ * const analysis = analyzeDiff('abc123');
+ * console.log(`Touched ${analysis.files_touched} files`);
+ * console.log(`Added ${analysis.lines_added} lines`);
+ * ```
+ */
+export function analyzeDiff(baseCommit) {
+    const trackedPaths = getTouchedTracked(baseCommit);
+    const untrackedPaths = getTouchedUntracked();
+    const stats = getDiffStats(baseCommit);
+    // Combine all touched paths
+    const allPaths = [...new Set([...trackedPaths, ...untrackedPaths])];
+    // Count new files: files that are added (A) in tracked changes
+    // plus all untracked files
+    let newFilesCount = untrackedPaths.length;
+    try {
+        const nameStatusOutput = execSync(`git diff --name-status ${baseCommit}..HEAD`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (nameStatusOutput.trim()) {
+            const addedFiles = nameStatusOutput
+                .trim()
+                .split('\n')
+                .filter((line) => line.startsWith('A\t') || line.startsWith('A\t'))
+                .length;
+            newFilesCount += addedFiles;
+        }
+    }
+    catch {
+        // If this fails, we already have untracked count
+    }
+    return {
+        files_touched: allPaths.length,
+        lines_added: stats.lines_added,
+        lines_deleted: stats.lines_deleted,
+        new_files: newFilesCount,
+        touched_paths: allPaths.sort(),
+    };
+}
+/**
+ * Checks if diff analysis exceeds task diff limits.
+ *
+ * Compares files_touched against max_files_touched and lines_changed
+ * (added + deleted) against max_lines_changed.
+ *
+ * @param analysis - The diff analysis result
+ * @param limits - The diff limits from the task
+ * @returns DiffLimitCheckResult with ok status and violation details
+ *
+ * @example
+ * ```typescript
+ * const analysis = analyzeDiff('abc123');
+ * const limits = { max_files_touched: 10, max_lines_changed: 100 };
+ * const result = checkDiffLimits(analysis, limits);
+ * if (!result.ok) {
+ *   console.error(`Violation: ${result.violation}`);
+ * }
+ * ```
+ */
+export function checkDiffLimits(analysis, limits) {
+    const lines_changed = analysis.lines_added + analysis.lines_deleted;
+    const filesExceeded = analysis.files_touched > limits.max_files_touched;
+    const linesExceeded = lines_changed > limits.max_lines_changed;
+    let violation = null;
+    if (filesExceeded && linesExceeded) {
+        violation = `Files touched (${analysis.files_touched}) exceeds limit (${limits.max_files_touched}) and lines changed (${lines_changed}) exceeds limit (${limits.max_lines_changed})`;
+    }
+    else if (filesExceeded) {
+        violation = `Files touched (${analysis.files_touched}) exceeds limit (${limits.max_files_touched})`;
+    }
+    else if (linesExceeded) {
+        violation = `Lines changed (${lines_changed}) exceeds limit (${limits.max_lines_changed})`;
+    }
+    return {
+        ok: !filesExceeded && !linesExceeded,
+        files_touched: analysis.files_touched,
+        lines_changed,
+        max_files: limits.max_files_touched,
+        max_lines: limits.max_lines_changed,
+        violation,
+    };
+}
+/**
+ * Formats blast radius summary string from diff analysis.
+ *
+ * Format: "<files_touched> files, +<lines_added>/-<lines_deleted>, <new_files> new"
+ *
+ * @param analysis - The diff analysis result
+ * @returns Formatted blast radius summary string
+ *
+ * @example
+ * ```typescript
+ * const analysis = analyzeDiff('abc123');
+ * const summary = formatBlastRadius(analysis);
+ * // "5 files, +120/-30, 2 new"
+ * ```
+ */
+export function formatBlastRadius(analysis) {
+    return `${analysis.files_touched} files, +${analysis.lines_added}/-${analysis.lines_deleted}, ${analysis.new_files} new`;
+}
+//# sourceMappingURL=diff.js.map

package/dist/lib/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/lib/diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAoC9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,0BAA0B,UAAU,QAAQ,EAAE;YACpE,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,MAAM;aACV,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,yEAAyE;YACzE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtB,uCAAuC;gBACvC,8BAA8B;gBAC9B,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,4CAA4C,UAAU,KACpD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,wBAAwB,EAAE;YAChD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,MAAM;aACV,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACf,qDAAqD;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpC,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACnD,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,yCAAyC;YACzC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB;IAI7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,sBAAsB,UAAU,QAAQ,EAAE;YAChE,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QAC9C,CAAC;QAED,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,MAAM;aACH,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACvB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAEzB,wDAAwD;gBACxD,IAAI,KAAK,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;oBAC3C,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;gBACD,IAAI,OAAO,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;oBAC/C,aAAa,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEL,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,iCAAiC,UAAU,KACzC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,MAAM,YAAY,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,mBAAmB,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAEvC,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAEpE,+DAA+D;IAC/D,2BAA2B;IAC3B,IAAI,aAAa,GAAG,cAAc,CAAC,MAAM,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,QAAQ,CAC/B,0BAA0B,UAAU,QAAQ,EAC5C;YACE,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CACF,CAAC;QAEF,IAAI,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,gBAAgB;iBAChC,IAAI,EAAE;iBACN,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;iBAClE,MAAM,CAAC;YACV,aAAa,IAAI,UAAU,CAAC;QAC9B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;IAED,OAAO;QACL,aAAa,EAAE,QAAQ,CAAC,MAAM;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,SAAS,EAAE,aAAa;QACxB,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAsB,EACtB,MAAgE;IAEhE,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,GAAG,QAAQ,CAAC,aAAa,CAAC;IACpE,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACxE,MAAM,aAAa,GAAG,aAAa,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAE/D,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,aAAa,IAAI,aAAa,EAAE,CAAC;QACnC,SAAS,GAAG,kBAAkB,QAAQ,CAAC,aAAa,oBAAoB,MAAM,CAAC,iBAAiB,wBAAwB,aAAa,oBAAoB,MAAM,CAAC,iBAAiB,GAAG,CAAC;IACvL,CAAC;SAAM,IAAI,aAAa,EAAE,CAAC;QACzB,SAAS,GAAG,kBAAkB,QAAQ,CAAC,aAAa,oBAAoB,MAAM,CAAC,iBAAiB,GAAG,CAAC;IACtG,CAAC;SAAM,IAAI,aAAa,EAAE,CAAC;QACzB,SAAS,GAAG,kBAAkB,aAAa,oBAAoB,MAAM,CAAC,iBAAiB,GAAG,CAAC;IAC7F,CAAC;IAED,OAAO;QACL,EAAE,EAAE,CAAC,aAAa,IAAI,CAAC,aAAa;QACpC,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,aAAa;QACb,SAAS,EAAE,MAAM,CAAC,iBAAiB;QACnC,SAAS,EAAE,MAAM,CAAC,iBAAiB;QACnC,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,OAAO,GAAG,QAAQ,CAAC,aAAa,YAAY,QAAQ,CAAC,WAAW,KAAK,QAAQ,CAAC,aAAa,KAAK,QAAQ,CAAC,SAAS,MAAM,CAAC;AAC3H,CAAC"}

package/dist/lib/doctor.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Doctor checks for Envoi configuration and environment.
+ *
+ * Provides functions to verify system health and configuration correctness.
+ */
+import type { EnvoiConfig } from '../types/config.js';
+/**
+ * Result of Codex CLI reviewer doctor check.
+ */
+export interface ReviewerDoctorResult {
+    /** Whether the Codex CLI is available */
+    cli_available: boolean;
+    /** Authentication status: 'api_key_present' if CODEX_API_KEY is set, 'unknown' otherwise */
+    auth_status: 'api_key_present' | 'unknown';
+    /** Version string from codex --version, if available */
+    version?: string;
+    /** Reviewer mode: 'enabled' if reviewer.enabled is true, 'disabled' otherwise */
+    reviewer_mode: 'enabled' | 'disabled';
+    /** Auth mode from config: reviewer.auth.mode, or 'unknown' if not configured */
+    auth_mode: 'auto' | 'api_key' | 'login' | 'unknown';
+}
+/**
+ * Result of Cursor Agent doctor check.
+ */
+export interface CursorAgentDoctorResult {
+    /** Whether the Cursor CLI command is available */
+    cli_available: boolean;
+    /** Cursor CLI version output, if available */
+    version?: string;
+    /** Whether `cursor agent` subcommand appears available */
+    agent_available: boolean;
+    /** Auth status for Cursor Agent */
+    auth_status: 'authenticated' | 'unauthenticated' | 'api_key_present' | 'unknown';
+    /** Optional details for debugging auth / CLI failures */
+    details?: string;
+    /** The command that was checked (e.g. "cursor") */
+    command: string;
+}
+/**
+ * Checks Codex CLI availability and authentication status.
+ *
+ * Performs the following checks:
+ * 1. Spawns 'codex --version' to verify CLI is available
+ * 2. Checks CODEX_API_KEY environment variable presence
+ * 3. Reads reviewer configuration from config (enabled, auth.mode)
+ *
+ * @param config - Envoi configuration (optional, for reading reviewer settings)
+ * @returns Promise resolving to ReviewerDoctorResult with check results
+ *
+ * @example
+ * ```typescript
+ * const result = await checkCodexCli(config);
+ * if (result.cli_available) {
+ *   console.log(`Codex CLI available: ${result.version}`);
+ * }
+ * ```
+ */
+export declare function checkCodexCli(config?: EnvoiConfig): Promise<ReviewerDoctorResult>;
+/**
+ * Checks Cursor CLI + Cursor Agent availability and basic authentication status.
+ *
+ * Heuristics:
+ * - If CURSOR_API_KEY is set, treat as "api_key_present" (preferred: do not store secrets in config)
+ * - Otherwise, attempt `cursor agent whoami` to detect authenticated vs unauthenticated
+ */
+export declare function checkCursorAgent(config?: EnvoiConfig): Promise<CursorAgentDoctorResult>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/lib/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/lib/doctor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,4FAA4F;IAC5F,WAAW,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC3C,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,aAAa,EAAE,SAAS,GAAG,UAAU,CAAC;IACtC,gFAAgF;IAChF,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,eAAe,EAAE,OAAO,CAAC;IACzB,mCAAmC;IACnC,WAAW,EAAE,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACjF,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AA8DD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CACjC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC,CA8D/B;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA4E7F"}

package/dist/lib/doctor.js

@@ -0,0 +1,211 @@
+/**
+ * Doctor checks for Envoi configuration and environment.
+ *
+ * Provides functions to verify system health and configuration correctness.
+ */
+import { spawn } from 'node:child_process';
+async function spawnAndCapture(command, args, timeoutMs) {
+    return await new Promise((resolve) => {
+        let child = null;
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let timeout = null;
+        try {
+            child = spawn(command, args, { shell: false, stdio: ['ignore', 'pipe', 'pipe'] });
+        }
+        catch (error) {
+            resolve({
+                ok: false,
+                code: null,
+                stdout: '',
+                stderr: '',
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return;
+        }
+        child.stdout?.on('data', (chunk) => stdoutChunks.push(chunk));
+        child.stderr?.on('data', (chunk) => stderrChunks.push(chunk));
+        timeout = setTimeout(() => {
+            try {
+                child?.kill('SIGTERM');
+            }
+            catch {
+                // ignore
+            }
+        }, timeoutMs);
+        const finish = (result) => {
+            if (timeout)
+                clearTimeout(timeout);
+            resolve(result);
+        };
+        child.on('error', (error) => {
+            finish({
+                ok: false,
+                code: null,
+                stdout: Buffer.concat(stdoutChunks).toString('utf-8'),
+                stderr: Buffer.concat(stderrChunks).toString('utf-8'),
+                error: error.message,
+            });
+        });
+        child.on('exit', (code) => {
+            const stdout = Buffer.concat(stdoutChunks).toString('utf-8').trim();
+            const stderr = Buffer.concat(stderrChunks).toString('utf-8').trim();
+            finish({ ok: code === 0, code, stdout, stderr });
+        });
+    });
+}
+/**
+ * Checks Codex CLI availability and authentication status.
+ *
+ * Performs the following checks:
+ * 1. Spawns 'codex --version' to verify CLI is available
+ * 2. Checks CODEX_API_KEY environment variable presence
+ * 3. Reads reviewer configuration from config (enabled, auth.mode)
+ *
+ * @param config - Envoi configuration (optional, for reading reviewer settings)
+ * @returns Promise resolving to ReviewerDoctorResult with check results
+ *
+ * @example
+ * ```typescript
+ * const result = await checkCodexCli(config);
+ * if (result.cli_available) {
+ *   console.log(`Codex CLI available: ${result.version}`);
+ * }
+ * ```
+ */
+export async function checkCodexCli(config) {
+    let cli_available = false;
+    let version;
+    // Check CLI availability by spawning 'codex --version'
+    try {
+        const child = spawn('codex', ['--version'], {
+            shell: false,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        child.stdout?.on('data', (chunk) => {
+            stdoutChunks.push(chunk);
+        });
+        child.stderr?.on('data', (chunk) => {
+            stderrChunks.push(chunk);
+        });
+        await new Promise((resolve, reject) => {
+            child.on('error', (error) => {
+                reject(error);
+            });
+            child.on('exit', (code) => {
+                if (code === 0) {
+                    cli_available = true;
+                    const output = Buffer.concat(stdoutChunks).toString('utf-8').trim();
+                    // Extract version from output (e.g., "codex 1.2.3" or just "1.2.3")
+                    version = output || undefined;
+                    resolve();
+                }
+                else {
+                    reject(new Error(`codex --version exited with code ${code}`));
+                }
+            });
+        });
+    }
+    catch {
+        // CLI not available or failed to execute
+        cli_available = false;
+    }
+    // Check auth status: look for CODEX_API_KEY environment variable
+    const apiKey = process.env.CODEX_API_KEY;
+    const auth_status = apiKey && apiKey.trim().length > 0
+        ? 'api_key_present'
+        : 'unknown';
+    // Read reviewer configuration
+    const reviewer_enabled = config?.reviewer?.enabled ?? false;
+    const reviewer_mode = reviewer_enabled ? 'enabled' : 'disabled';
+    const auth_mode = config?.reviewer?.auth?.mode ?? 'unknown';
+    return {
+        cli_available,
+        auth_status,
+        version,
+        reviewer_mode,
+        auth_mode,
+    };
+}
+/**
+ * Checks Cursor CLI + Cursor Agent availability and basic authentication status.
+ *
+ * Heuristics:
+ * - If CURSOR_API_KEY is set, treat as "api_key_present" (preferred: do not store secrets in config)
+ * - Otherwise, attempt `cursor agent whoami` to detect authenticated vs unauthenticated
+ */
+export async function checkCursorAgent(config) {
+    const command = config?.builder?.cursor?.command ?? 'cursor';
+    // 1) Cursor CLI availability + version
+    let version;
+    let cli_available = false;
+    const versionTry1 = await spawnAndCapture(command, ['--version'], 2000);
+    if (versionTry1.ok) {
+        cli_available = true;
+        version = versionTry1.stdout || undefined;
+    }
+    else {
+        const versionTry2 = await spawnAndCapture(command, ['-v'], 2000);
+        if (versionTry2.ok) {
+            cli_available = true;
+            version = versionTry2.stdout || undefined;
+        }
+    }
+    if (!cli_available) {
+        const details = versionTry1.error ?? versionTry1.stderr ?? versionTry1.stdout;
+        return {
+            cli_available: false,
+            version: undefined,
+            agent_available: false,
+            auth_status: 'unknown',
+            details: details ? String(details).trim() : undefined,
+            command,
+        };
+    }
+    // 2) Agent subcommand availability
+    const agentHelp = await spawnAndCapture(command, ['agent', '--help'], 2000);
+    const agent_available = agentHelp.ok;
+    if (!agent_available) {
+        return {
+            cli_available: true,
+            version,
+            agent_available: false,
+            auth_status: 'unknown',
+            details: [agentHelp.stderr, agentHelp.stdout].filter(Boolean).join('\n').trim() || undefined,
+            command,
+        };
+    }
+    // 3) Auth status
+    const apiKey = process.env.CURSOR_API_KEY;
+    if (apiKey && apiKey.trim().length > 0) {
+        return {
+            cli_available: true,
+            version,
+            agent_available: true,
+            auth_status: 'api_key_present',
+            command,
+        };
+    }
+    const whoami = await spawnAndCapture(command, ['agent', 'whoami'], 5000);
+    if (whoami.ok) {
+        return {
+            cli_available: true,
+            version,
+            agent_available: true,
+            auth_status: 'authenticated',
+            command,
+        };
+    }
+    const details = [whoami.stderr, whoami.stdout, whoami.error].filter(Boolean).join('\n').trim();
+    return {
+        cli_available: true,
+        version,
+        agent_available: true,
+        auth_status: 'unauthenticated',
+        details: details || undefined,
+        command,
+    };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/lib/doctor.js.map

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

package/dist/lib/fingerprint.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Task fingerprinting utilities.
+ *
+ * Task fingerprint is used to detect identical re-dispatch loops.
+ * If orchestrator 'retries' without changing the plan, fingerprint stays same and runner stops.
+ */
+/**
+ * Canonicalizes a task object to a stable JSON string.
+ *
+ * The canonical form:
+ * - Has sorted keys (alphabetical order)
+ * - Has trimmed strings
+ * - Excludes task_id, id, v, milestone, and context fields
+ * - Only includes fingerprint-relevant fields
+ *
+ * @param task - The task object to canonicalize
+ * @returns A canonical JSON string representation
+ */
+export declare function canonicalizeTask(task: Record<string, unknown>): string;
+/**
+ * Computes a SHA-256 fingerprint of a task.
+ *
+ * @param task - The task object to fingerprint
+ * @returns A 64-character hexadecimal SHA-256 hash string
+ */
+export declare function computeFingerprint(task: Record<string, unknown>): string;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/lib/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/lib/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2FH;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAUtE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAKxE"}