@oddessentials/odd-ai-reviewers 1.0.0

package/dist/cli/output/colors.d.ts

@@ -0,0 +1,154 @@
+/**
+ * ANSI Color Utilities
+ *
+ * Provides ANSI color codes for terminal output with support for:
+ * - NO_COLOR environment variable (standard convention)
+ * - FORCE_COLOR environment variable (force colors even without TTY)
+ * - TTY detection for automatic color support
+ *
+ * Reference: https://no-color.org/
+ */
+/**
+ * ANSI escape codes for colors and formatting
+ */
+export declare const ANSI: {
+    readonly reset: "\u001B[0m";
+    readonly bold: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly italic: "\u001B[3m";
+    readonly underline: "\u001B[4m";
+    readonly inverse: "\u001B[7m";
+    readonly strikethrough: "\u001B[9m";
+    readonly black: "\u001B[30m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly magenta: "\u001B[35m";
+    readonly cyan: "\u001B[36m";
+    readonly white: "\u001B[37m";
+    readonly gray: "\u001B[90m";
+    readonly bgBlack: "\u001B[40m";
+    readonly bgRed: "\u001B[41m";
+    readonly bgGreen: "\u001B[42m";
+    readonly bgYellow: "\u001B[43m";
+    readonly bgBlue: "\u001B[44m";
+    readonly bgMagenta: "\u001B[45m";
+    readonly bgCyan: "\u001B[46m";
+    readonly bgWhite: "\u001B[47m";
+};
+export type AnsiCode = keyof typeof ANSI;
+/**
+ * Check if terminal supports colors.
+ *
+ * Priority:
+ * 1. NO_COLOR set (any value) -> false
+ * 2. FORCE_COLOR set (any value) -> true
+ * 3. Otherwise -> check if stdout is TTY
+ *
+ * @param env - Environment variables (defaults to process.env)
+ * @param isTTY - Whether stdout is a TTY (defaults to process.stdout.isTTY)
+ * @returns true if colors should be used
+ */
+export declare function supportsColor(env?: Record<string, string | undefined>, isTTY?: boolean): boolean;
+/**
+ * Apply ANSI color code to text, respecting color support.
+ *
+ * @param text - Text to colorize
+ * @param code - ANSI code to apply (from ANSI object)
+ * @param colored - Whether colors are enabled
+ * @returns Colorized text or plain text if colors disabled
+ */
+export declare function colorize(text: string, code: string, colored: boolean): string;
+/**
+ * Apply multiple ANSI codes to text.
+ *
+ * @param text - Text to colorize
+ * @param codes - Array of ANSI codes to apply
+ * @param colored - Whether colors are enabled
+ * @returns Colorized text or plain text if colors disabled
+ */
+export declare function colorizeMulti(text: string, codes: string[], colored: boolean): string;
+/**
+ * Severity levels for findings
+ */
+export type Severity = 'error' | 'warning' | 'info';
+/**
+ * Get ANSI color code for a severity level.
+ *
+ * @param severity - Finding severity
+ * @returns ANSI color code
+ */
+export declare function getSeverityColor(severity: Severity): string;
+/**
+ * Colorize text based on severity.
+ *
+ * @param text - Text to colorize
+ * @param severity - Finding severity
+ * @param colored - Whether colors are enabled
+ * @returns Colorized text
+ */
+export declare function colorizeSeverity(text: string, severity: Severity, colored: boolean): string;
+/**
+ * Get severity label with appropriate color.
+ *
+ * @param severity - Finding severity
+ * @param colored - Whether colors are enabled
+ * @returns Formatted severity label
+ */
+export declare function formatSeverityLabel(severity: Severity, colored: boolean): string;
+/**
+ * Create a colorizer function bound to a specific color state.
+ *
+ * @param colored - Whether colors are enabled
+ * @returns Object with color functions
+ */
+export declare function createColorizer(colored: boolean): {
+    red: (text: string) => string;
+    green: (text: string) => string;
+    yellow: (text: string) => string;
+    blue: (text: string) => string;
+    cyan: (text: string) => string;
+    magenta: (text: string) => string;
+    gray: (text: string) => string;
+    white: (text: string) => string;
+    bold: (text: string) => string;
+    dim: (text: string) => string;
+    italic: (text: string) => string;
+    underline: (text: string) => string;
+    inverse: (text: string) => string;
+    error: (text: string) => string;
+    warning: (text: string) => string;
+    info: (text: string) => string;
+};
+/**
+ * Strip ANSI codes from text.
+ *
+ * @param text - Text potentially containing ANSI codes
+ * @returns Text with ANSI codes removed
+ */
+export declare function stripAnsi(text: string): string;
+/**
+ * Get the visible length of text (excluding ANSI codes).
+ *
+ * @param text - Text potentially containing ANSI codes
+ * @returns Visible character count
+ */
+export declare function visibleLength(text: string): number;
+/**
+ * Check if terminal supports Unicode characters (for box drawing, etc.).
+ *
+ * Detection logic:
+ * 1. Windows Terminal (WT_SESSION env) -> true
+ * 2. ConEmu terminal (ConEmuANSI=ON) -> true
+ * 3. TERM contains 'xterm', '256color', 'truecolor' -> true
+ * 4. LC_ALL, LC_CTYPE, or LANG contains 'UTF-8' or 'utf8' (case-insensitive) -> true
+ * 5. TERM is 'dumb' -> false
+ * 6. CI environments (CI=true, GITHUB_ACTIONS, etc.) -> true (most CI supports UTF-8)
+ * 7. Default: false (fall back to ASCII for safety)
+ *
+ * @param env - Environment variables (defaults to process.env)
+ * @returns true if Unicode characters should be used
+ */
+export declare function supportsUnicode(env?: Record<string, string | undefined>): boolean;
+//# sourceMappingURL=colors.d.ts.map

package/dist/cli/output/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/cli/output/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;GAEG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;CAgCP,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,IAAI,CAAC;AAMzC;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,KAAK,GAAE,OAAwC,GAC9C,OAAO,CAaT;AAMD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAK7E;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAKrF;AAMD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAW3D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAE3F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAShF;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO;gBAEhC,MAAM;kBACJ,MAAM;mBACL,MAAM;iBACR,MAAM;iBACN,MAAM;oBACH,MAAM;iBACT,MAAM;kBACL,MAAM;iBACP,MAAM;gBACP,MAAM;mBACH,MAAM;sBACH,MAAM;oBACR,MAAM;kBACR,MAAM;oBACJ,MAAM;iBACT,MAAM;EAEtB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,OAAO,CA8C9F"}

package/dist/cli/output/colors.js

@@ -0,0 +1,255 @@
+/**
+ * ANSI Color Utilities
+ *
+ * Provides ANSI color codes for terminal output with support for:
+ * - NO_COLOR environment variable (standard convention)
+ * - FORCE_COLOR environment variable (force colors even without TTY)
+ * - TTY detection for automatic color support
+ *
+ * Reference: https://no-color.org/
+ */
+// =============================================================================
+// ANSI Color Codes
+// =============================================================================
+/**
+ * ANSI escape codes for colors and formatting
+ */
+export const ANSI = {
+    // Reset
+    reset: '\x1b[0m',
+    // Formatting
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    italic: '\x1b[3m',
+    underline: '\x1b[4m',
+    inverse: '\x1b[7m',
+    strikethrough: '\x1b[9m',
+    // Foreground colors
+    black: '\x1b[30m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+    gray: '\x1b[90m',
+    // Background colors
+    bgBlack: '\x1b[40m',
+    bgRed: '\x1b[41m',
+    bgGreen: '\x1b[42m',
+    bgYellow: '\x1b[43m',
+    bgBlue: '\x1b[44m',
+    bgMagenta: '\x1b[45m',
+    bgCyan: '\x1b[46m',
+    bgWhite: '\x1b[47m',
+};
+// =============================================================================
+// Color Support Detection
+// =============================================================================
+/**
+ * Check if terminal supports colors.
+ *
+ * Priority:
+ * 1. NO_COLOR set (any value) -> false
+ * 2. FORCE_COLOR set (any value) -> true
+ * 3. Otherwise -> check if stdout is TTY
+ *
+ * @param env - Environment variables (defaults to process.env)
+ * @param isTTY - Whether stdout is a TTY (defaults to process.stdout.isTTY)
+ * @returns true if colors should be used
+ */
+export function supportsColor(env = process.env, isTTY = process.stdout?.isTTY ?? false) {
+    // NO_COLOR takes precedence (standard convention)
+    if (env['NO_COLOR'] !== undefined) {
+        return false;
+    }
+    // FORCE_COLOR forces colors even without TTY
+    if (env['FORCE_COLOR'] !== undefined) {
+        return true;
+    }
+    // Fall back to TTY detection
+    return isTTY;
+}
+// =============================================================================
+// Colorization Utilities
+// =============================================================================
+/**
+ * Apply ANSI color code to text, respecting color support.
+ *
+ * @param text - Text to colorize
+ * @param code - ANSI code to apply (from ANSI object)
+ * @param colored - Whether colors are enabled
+ * @returns Colorized text or plain text if colors disabled
+ */
+export function colorize(text, code, colored) {
+    if (!colored) {
+        return text;
+    }
+    return `${code}${text}${ANSI.reset}`;
+}
+/**
+ * Apply multiple ANSI codes to text.
+ *
+ * @param text - Text to colorize
+ * @param codes - Array of ANSI codes to apply
+ * @param colored - Whether colors are enabled
+ * @returns Colorized text or plain text if colors disabled
+ */
+export function colorizeMulti(text, codes, colored) {
+    if (!colored || codes.length === 0) {
+        return text;
+    }
+    return `${codes.join('')}${text}${ANSI.reset}`;
+}
+/**
+ * Get ANSI color code for a severity level.
+ *
+ * @param severity - Finding severity
+ * @returns ANSI color code
+ */
+export function getSeverityColor(severity) {
+    switch (severity) {
+        case 'error':
+            return ANSI.red;
+        case 'warning':
+            return ANSI.yellow;
+        case 'info':
+            return ANSI.blue;
+        default:
+            return '';
+    }
+}
+/**
+ * Colorize text based on severity.
+ *
+ * @param text - Text to colorize
+ * @param severity - Finding severity
+ * @param colored - Whether colors are enabled
+ * @returns Colorized text
+ */
+export function colorizeSeverity(text, severity, colored) {
+    return colorize(text, getSeverityColor(severity), colored);
+}
+/**
+ * Get severity label with appropriate color.
+ *
+ * @param severity - Finding severity
+ * @param colored - Whether colors are enabled
+ * @returns Formatted severity label
+ */
+export function formatSeverityLabel(severity, colored) {
+    const labels = {
+        error: 'error',
+        warning: 'warning',
+        info: 'info',
+    };
+    const label = labels[severity] ?? severity;
+    return colorize(label, getSeverityColor(severity), colored);
+}
+// =============================================================================
+// Convenience Functions
+// =============================================================================
+/**
+ * Create a colorizer function bound to a specific color state.
+ *
+ * @param colored - Whether colors are enabled
+ * @returns Object with color functions
+ */
+export function createColorizer(colored) {
+    return {
+        red: (text) => colorize(text, ANSI.red, colored),
+        green: (text) => colorize(text, ANSI.green, colored),
+        yellow: (text) => colorize(text, ANSI.yellow, colored),
+        blue: (text) => colorize(text, ANSI.blue, colored),
+        cyan: (text) => colorize(text, ANSI.cyan, colored),
+        magenta: (text) => colorize(text, ANSI.magenta, colored),
+        gray: (text) => colorize(text, ANSI.gray, colored),
+        white: (text) => colorize(text, ANSI.white, colored),
+        bold: (text) => colorize(text, ANSI.bold, colored),
+        dim: (text) => colorize(text, ANSI.dim, colored),
+        italic: (text) => colorize(text, ANSI.italic, colored),
+        underline: (text) => colorize(text, ANSI.underline, colored),
+        inverse: (text) => colorize(text, ANSI.inverse, colored),
+        error: (text) => colorizeSeverity(text, 'error', colored),
+        warning: (text) => colorizeSeverity(text, 'warning', colored),
+        info: (text) => colorizeSeverity(text, 'info', colored),
+    };
+}
+/**
+ * Strip ANSI codes from text.
+ *
+ * @param text - Text potentially containing ANSI codes
+ * @returns Text with ANSI codes removed
+ */
+export function stripAnsi(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1b\[[0-9;]*m/g, '');
+}
+/**
+ * Get the visible length of text (excluding ANSI codes).
+ *
+ * @param text - Text potentially containing ANSI codes
+ * @returns Visible character count
+ */
+export function visibleLength(text) {
+    return stripAnsi(text).length;
+}
+// =============================================================================
+// Unicode Support Detection
+// =============================================================================
+/**
+ * Check if terminal supports Unicode characters (for box drawing, etc.).
+ *
+ * Detection logic:
+ * 1. Windows Terminal (WT_SESSION env) -> true
+ * 2. ConEmu terminal (ConEmuANSI=ON) -> true
+ * 3. TERM contains 'xterm', '256color', 'truecolor' -> true
+ * 4. LC_ALL, LC_CTYPE, or LANG contains 'UTF-8' or 'utf8' (case-insensitive) -> true
+ * 5. TERM is 'dumb' -> false
+ * 6. CI environments (CI=true, GITHUB_ACTIONS, etc.) -> true (most CI supports UTF-8)
+ * 7. Default: false (fall back to ASCII for safety)
+ *
+ * @param env - Environment variables (defaults to process.env)
+ * @returns true if Unicode characters should be used
+ */
+export function supportsUnicode(env = process.env) {
+    // Windows Terminal explicitly supports Unicode
+    if (env['WT_SESSION'] !== undefined) {
+        return true;
+    }
+    // ConEmu supports Unicode when ANSI is enabled
+    if (env['ConEmuANSI'] === 'ON') {
+        return true;
+    }
+    // Check TERM for modern terminal indicators
+    const term = env['TERM']?.toLowerCase() ?? '';
+    // Dumb terminals don't support Unicode
+    if (term === 'dumb') {
+        return false;
+    }
+    // xterm variants and color terminals typically support Unicode
+    if (term.includes('xterm') || term.includes('256color') || term.includes('truecolor')) {
+        return true;
+    }
+    // Check locale settings for UTF-8
+    const localeVars = [env['LC_ALL'], env['LC_CTYPE'], env['LANG']].filter(Boolean);
+    for (const locale of localeVars) {
+        if (locale && /utf-?8/i.test(locale)) {
+            return true;
+        }
+    }
+    // CI environments typically support UTF-8
+    if (env['CI'] === 'true' ||
+        env['GITHUB_ACTIONS'] !== undefined ||
+        env['GITLAB_CI'] !== undefined ||
+        env['CIRCLECI'] !== undefined ||
+        env['TRAVIS'] !== undefined ||
+        env['TF_BUILD'] !== undefined // Azure DevOps
+    ) {
+        return true;
+    }
+    // Default to false for safety (ASCII fallback)
+    return false;
+}
+//# sourceMappingURL=colors.js.map

package/dist/cli/output/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../../src/cli/output/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,QAAQ;IACR,KAAK,EAAE,SAAS;IAEhB,aAAa;IACb,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,SAAS;IAExB,oBAAoB;IACpB,KAAK,EAAE,UAAU;IACjB,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU;IAEhB,oBAAoB;IACpB,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,UAAU;IACnB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,UAAU;IACrB,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,UAAU;CACX,CAAC;AAIX,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA0C,OAAO,CAAC,GAAG,EACrD,QAAiB,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,KAAK;IAE/C,kDAAkD;IAClD,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6CAA6C;IAC7C,IAAI,GAAG,CAAC,aAAa,CAAC,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6BAA6B;IAC7B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,IAAY,EAAE,OAAgB;IACnE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAe,EAAE,OAAgB;IAC3E,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;AACjD,CAAC;AAWD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,GAAG,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAkB,EAAE,OAAgB;IACjF,OAAO,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAkB,EAAE,OAAgB;IACtE,MAAM,MAAM,GAA6B;QACvC,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM;KACb,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;IAC3C,OAAO,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO;QACL,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC;QACxD,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;QAC5D,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;QAC9D,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;QAC1D,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;QAC1D,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;QAChE,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;QAC1D,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;QAC5D,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;QAC1D,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC;QACxD,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;QAC9D,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;QACpE,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;QAChE,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC;QACjE,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC;QACrE,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;KAChE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,4CAA4C;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAChC,CAAC;AAED,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0C,OAAO,CAAC,GAAG;IACnF,+CAA+C;IAC/C,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+CAA+C;IAC/C,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAE9C,uCAAuC;IACvC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+DAA+D;IAC/D,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACtF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjF,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,IACE,GAAG,CAAC,IAAI,CAAC,KAAK,MAAM;QACpB,GAAG,CAAC,gBAAgB,CAAC,KAAK,SAAS;QACnC,GAAG,CAAC,WAAW,CAAC,KAAK,SAAS;QAC9B,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS;QAC7B,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS;QAC3B,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC,eAAe;MAC7C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+CAA+C;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli/output/errors.d.ts

@@ -0,0 +1,157 @@
+/**
+ * CLI Error Types and Formatters
+ *
+ * Provides user-facing error types and formatting for terminal output.
+ * All error messages include actionable guidance.
+ */
+/**
+ * CLI-specific error codes
+ */
+export declare const CLIErrorCode: {
+    readonly NOT_GIT_REPO: "CLI_NOT_GIT_REPO";
+    readonly GIT_NOT_FOUND: "CLI_GIT_NOT_FOUND";
+    readonly INVALID_PATH: "CLI_INVALID_PATH";
+    readonly NO_CREDENTIALS: "CLI_NO_CREDENTIALS";
+    readonly NO_CHANGES: "CLI_NO_CHANGES";
+    readonly INVALID_CONFIG: "CLI_INVALID_CONFIG";
+    readonly CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND";
+    readonly INVALID_OPTIONS: "CLI_INVALID_OPTIONS";
+    readonly EXECUTION_FAILED: "CLI_EXECUTION_FAILED";
+};
+export type CLIErrorCode = (typeof CLIErrorCode)[keyof typeof CLIErrorCode];
+/**
+ * Base class for CLI errors
+ */
+export declare abstract class CLIError extends Error {
+    abstract readonly code: CLIErrorCode;
+    abstract readonly hint?: string;
+    constructor(message: string);
+}
+/**
+ * Error when not in a git repository
+ */
+export declare class NotAGitRepoError extends CLIError {
+    readonly code: "CLI_NOT_GIT_REPO";
+    readonly hint: string;
+    readonly path?: string;
+    constructor(path?: string);
+}
+/**
+ * Error when git is not available in PATH
+ */
+export declare class GitNotFoundError extends CLIError {
+    readonly code: "CLI_GIT_NOT_FOUND";
+    readonly hint: string;
+    constructor(message?: string);
+}
+/**
+ * Error when the provided path is invalid or inaccessible
+ */
+export declare class InvalidPathError extends CLIError {
+    readonly code: "CLI_INVALID_PATH";
+    readonly hint: string;
+    readonly path?: string;
+    constructor(message: string, path?: string);
+}
+/**
+ * Error when no API credentials are found
+ */
+export declare class NoCredentialsError extends CLIError {
+    readonly code: "CLI_NO_CREDENTIALS";
+    readonly hint: string;
+    constructor();
+}
+/**
+ * Error when no changes are found to review
+ */
+export declare class NoChangesError extends CLIError {
+    readonly code: "CLI_NO_CHANGES";
+    readonly hint: string;
+    readonly base?: string;
+    readonly head?: string;
+    constructor(base?: string, head?: string);
+}
+/**
+ * Error when configuration is invalid
+ */
+export declare class InvalidConfigError extends CLIError {
+    readonly code: "CLI_INVALID_CONFIG";
+    readonly hint: string;
+    readonly configPath: string;
+    readonly details: string[];
+    constructor(configPath: string, details: string[]);
+}
+/**
+ * Error when config file is not found
+ */
+export declare class ConfigNotFoundError extends CLIError {
+    readonly code: "CLI_CONFIG_NOT_FOUND";
+    readonly hint: string;
+    readonly configPath: string;
+    constructor(configPath: string);
+}
+/**
+ * Error for invalid CLI options
+ */
+export declare class InvalidOptionsError extends CLIError {
+    readonly code: "CLI_INVALID_OPTIONS";
+    readonly hint: string;
+    readonly option: string;
+    readonly reason: string;
+    constructor(option: string, reason: string, hint: string);
+}
+/**
+ * Error for execution failures
+ */
+export declare class ExecutionFailedError extends CLIError {
+    readonly code: "CLI_EXECUTION_FAILED";
+    readonly hint?: string;
+    readonly stage: string;
+    readonly originalCause?: Error;
+    constructor(stage: string, message: string, originalCause?: Error);
+}
+/**
+ * Format a CLI error for terminal display
+ *
+ * @param error - CLI error to format
+ * @param colored - Whether to use ANSI colors
+ * @returns Formatted error string
+ */
+export declare function formatCLIError(error: CLIError | Error, colored?: boolean): string;
+/**
+ * Format NotAGitRepoError with guidance
+ */
+export declare function formatNotAGitRepoError(error: NotAGitRepoError, colored: boolean): string;
+/**
+ * Format NoCredentialsError with env var instructions
+ */
+export declare function formatNoCredentialsError(error: NoCredentialsError, colored: boolean): string;
+/**
+ * Format NoChangesError with success styling (not actually an error state)
+ */
+export declare function formatNoChangesError(error: NoChangesError, colored: boolean): string;
+/**
+ * Format InvalidConfigError with validation details
+ */
+export declare function formatInvalidConfigError(error: InvalidConfigError, colored: boolean): string;
+/**
+ * Type guard for CLIError
+ */
+export declare function isCLIError(error: unknown): error is CLIError;
+/**
+ * Type guard for NotAGitRepoError
+ */
+export declare function isNotAGitRepoError(error: unknown): error is NotAGitRepoError;
+/**
+ * Type guard for NoCredentialsError
+ */
+export declare function isNoCredentialsError(error: unknown): error is NoCredentialsError;
+/**
+ * Type guard for NoChangesError
+ */
+export declare function isNoChangesError(error: unknown): error is NoChangesError;
+/**
+ * Type guard for InvalidConfigError
+ */
+export declare function isInvalidConfigError(error: unknown): error is InvalidConfigError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/cli/output/errors.d.ts.map

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