bktide 1.0.1755266193 → 1.0.1755547716

package/dist/ui/theme.js

@@ -0,0 +1,280 @@
+/**
+ * Enhanced Visual Design System for bktide CLI
+ *
+ * This module implements a comprehensive color and typography system
+ * that enhances information hierarchy and accessibility.
+ */
+import chalk from 'chalk';
+import { getSymbols } from './symbols.js';
+function isTTY() {
+    return Boolean(process.stdout.isTTY);
+}
+function colorEnabled() {
+    if (process.env.NO_COLOR)
+        return false;
+    const mode = process.env.BKTIDE_COLOR_MODE || 'auto';
+    if (mode === 'never')
+        return false;
+    if (mode === 'always')
+        return true;
+    return isTTY();
+}
+/**
+ * Semantic color system for different information types
+ * Using colorblind-safe palette
+ */
+export const SEMANTIC_COLORS = {
+    // Status colors (colorblind-safe)
+    success: (s) => colorEnabled() ? chalk.blue(s) : s,
+    error: (s) => colorEnabled() ? chalk.rgb(255, 140, 0)(s) : s,
+    warning: (s) => colorEnabled() ? chalk.yellow(s) : s,
+    info: (s) => colorEnabled() ? chalk.cyan(s) : s,
+    // Typography emphasis levels
+    heading: (s) => colorEnabled() ? chalk.bold.underline(s) : `== ${s} ==`,
+    subheading: (s) => colorEnabled() ? chalk.bold(s) : `** ${s} **`,
+    label: (s) => colorEnabled() ? chalk.bold(s) : s.toUpperCase(),
+    // Data type highlighting
+    identifier: (s) => colorEnabled() ? chalk.cyan(s) : s,
+    count: (s) => colorEnabled() ? chalk.magenta(s) : s,
+    url: (s) => colorEnabled() ? chalk.underline.cyan(s) : `<${s}>`,
+    // De-emphasis (auxiliary information)
+    dim: (s) => colorEnabled() ? chalk.dim(s) : s,
+    muted: (s) => colorEnabled() ? chalk.gray(s) : s,
+    tip: (s) => colorEnabled() ? chalk.dim(s) : `(${s})`,
+    help: (s) => colorEnabled() ? chalk.dim.italic(s) : `[${s}]`,
+    // Special formatting
+    highlight: (s) => colorEnabled() ? chalk.magenta(s) : s,
+    code: (s) => colorEnabled() ? chalk.bgGray.white(` ${s} `) : `\`${s}\``,
+};
+/**
+ * Build status specific theming
+ * Matches conventions from GitHub Actions, CircleCI, Jenkins
+ */
+export const BUILD_STATUS_THEME = {
+    // Success states
+    PASSED: {
+        color: SEMANTIC_COLORS.success,
+        symbol: '✓',
+        ascii: '[OK]',
+    },
+    // Failure states
+    FAILED: {
+        color: SEMANTIC_COLORS.error,
+        symbol: '✖',
+        ascii: '[FAIL]',
+    },
+    FAILING: {
+        color: (s) => colorEnabled() ? chalk.rgb(255, 165, 0)(s) : s,
+        symbol: '⚠',
+        ascii: '[FAILING]',
+    },
+    // Warning states
+    BLOCKED: {
+        color: SEMANTIC_COLORS.warning,
+        symbol: '⚠',
+        ascii: '[BLOCKED]',
+    },
+    CANCELED: {
+        color: SEMANTIC_COLORS.warning,
+        symbol: '⊘',
+        ascii: '[CANCEL]',
+    },
+    CANCELING: {
+        color: SEMANTIC_COLORS.warning,
+        symbol: '⊘',
+        ascii: '[...]',
+    },
+    // Active states
+    RUNNING: {
+        color: SEMANTIC_COLORS.info,
+        symbol: '↻',
+        ascii: '[RUN]',
+    },
+    SCHEDULED: {
+        color: SEMANTIC_COLORS.info,
+        symbol: '⏱',
+        ascii: '[QUEUE]',
+    },
+    // Inactive states
+    SKIPPED: {
+        color: SEMANTIC_COLORS.muted,
+        symbol: '−',
+        ascii: '[SKIP]',
+    },
+    NOT_RUN: {
+        color: SEMANTIC_COLORS.muted,
+        symbol: '○',
+        ascii: '[--]',
+    },
+};
+/**
+ * Format a build status with appropriate color and symbol
+ */
+export function formatBuildStatus(status, options) {
+    // Normalize status to uppercase for theme lookup
+    const normalizedStatus = status.toUpperCase();
+    const theme = BUILD_STATUS_THEME[normalizedStatus];
+    if (!theme) {
+        return SEMANTIC_COLORS.muted(status);
+    }
+    const useSymbol = options?.useSymbol ?? true;
+    const ascii = options?.ascii ?? false;
+    if (useSymbol) {
+        const symbol = ascii ? theme.ascii : theme.symbol;
+        // Keep original casing for display
+        return `${symbol} ${theme.color(status)}`;
+    }
+    // Keep original casing for display
+    return theme.color(status);
+}
+/**
+ * Tip display styles for different contexts
+ */
+export var TipStyle;
+(function (TipStyle) {
+    TipStyle["GROUPED"] = "grouped";
+    TipStyle["INDIVIDUAL"] = "individual";
+    TipStyle["ACTIONS"] = "actions";
+    TipStyle["FIXES"] = "fixes";
+    TipStyle["BOX"] = "box"; // Fancy box with arrows (wide terminals)
+})(TipStyle || (TipStyle = {}));
+/**
+ * Format tips with consistent styling based on context
+ */
+export function formatTips(tips, style = TipStyle.GROUPED) {
+    if (tips.length === 0)
+        return '';
+    switch (style) {
+        case TipStyle.GROUPED:
+            return formatGroupedTips(tips);
+        case TipStyle.INDIVIDUAL:
+            return formatIndividualTips(tips);
+        case TipStyle.ACTIONS:
+            return formatActionTips(tips);
+        case TipStyle.FIXES:
+            return formatFixTips(tips);
+        case TipStyle.BOX:
+            return formatTipBox(tips); // Use existing function
+        default:
+            return formatGroupedTips(tips);
+    }
+}
+function formatGroupedTips(tips) {
+    const lines = [];
+    lines.push(SEMANTIC_COLORS.dim('Tips:'));
+    tips.forEach(tip => {
+        lines.push(SEMANTIC_COLORS.dim(`  → ${tip}`));
+    });
+    return lines.join('\n');
+}
+function formatIndividualTips(tips) {
+    return tips
+        .map(tip => SEMANTIC_COLORS.dim(`→ ${tip}`))
+        .join('\n');
+}
+function formatActionTips(tips) {
+    const lines = [];
+    lines.push(SEMANTIC_COLORS.dim('Next steps:'));
+    tips.forEach(tip => {
+        lines.push(SEMANTIC_COLORS.dim(`  → ${tip}`));
+    });
+    return lines.join('\n');
+}
+function formatFixTips(tips) {
+    const lines = [];
+    lines.push(SEMANTIC_COLORS.subheading('To fix this:'));
+    tips.forEach((tip, i) => {
+        lines.push(`  ${i + 1}. ${tip}`);
+    });
+    return lines.join('\n');
+}
+/**
+ * Create a formatted tip box for better visual separation
+ * Only used in wide terminals
+ */
+export function formatTipBox(tips, width) {
+    const termWidth = width || process.stdout.columns || 80;
+    // Only use fancy box in wide terminals
+    if (termWidth < 80 || !colorEnabled()) {
+        return formatGroupedTips(tips);
+    }
+    const lines = [];
+    const boxWidth = Math.min(termWidth - 4, 60);
+    const border = '─'.repeat(boxWidth - 10);
+    lines.push(SEMANTIC_COLORS.dim(`┌─ Tips ${border}`));
+    tips.forEach(tip => {
+        lines.push(SEMANTIC_COLORS.dim(`│ → ${tip}`));
+    });
+    lines.push(SEMANTIC_COLORS.dim(`└${'─'.repeat(boxWidth - 1)}`));
+    return lines.join('\n');
+}
+/**
+ * Format an error message with consistent styling
+ */
+export function formatError(error, options) {
+    const lines = [];
+    const symbols = getSymbols();
+    // Error header
+    lines.push(`${SEMANTIC_COLORS.error(symbols.error)} ${chalk.bold('Error')}`);
+    lines.push('');
+    // Error message
+    const message = typeof error === 'string' ? error : error.message;
+    lines.push(message);
+    // Suggestions if provided
+    if (options?.suggestions && options.suggestions.length > 0) {
+        lines.push('');
+        lines.push(formatTips(options.suggestions, TipStyle.FIXES));
+    }
+    // Help command
+    if (options?.showHelp && options?.helpCommand) {
+        lines.push('');
+        lines.push(SEMANTIC_COLORS.help(`Need help? Run: ${options.helpCommand}`));
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a success message (subtle, not redundant)
+ */
+export function formatSuccess(message, count) {
+    const symbols = getSymbols();
+    if (count !== undefined) {
+        return `${SEMANTIC_COLORS.success(symbols.success)} ${message} ${SEMANTIC_COLORS.count(count.toString())}`;
+    }
+    return `${SEMANTIC_COLORS.success(symbols.success)} ${message}`;
+}
+/**
+ * Format empty state messages
+ */
+export function formatEmptyState(message, suggestions) {
+    const lines = [];
+    lines.push(SEMANTIC_COLORS.dim(message));
+    if (suggestions && suggestions.length > 0) {
+        lines.push('');
+        suggestions.forEach(s => {
+            // Make commands stand out from the dimmed text
+            const formatted = s.replace(/--\w+[^ ]*/g, match => chalk.reset(match));
+            lines.push(SEMANTIC_COLORS.dim(formatted));
+        });
+    }
+    return lines.join('\n');
+}
+/**
+ * Legacy color exports for backward compatibility
+ * @deprecated Use SEMANTIC_COLORS instead
+ */
+export const COLORS = {
+    error: SEMANTIC_COLORS.error,
+    warn: SEMANTIC_COLORS.warning,
+    success: SEMANTIC_COLORS.success,
+    info: SEMANTIC_COLORS.info,
+    muted: SEMANTIC_COLORS.muted,
+    highlight: SEMANTIC_COLORS.highlight,
+    dim: SEMANTIC_COLORS.dim,
+};
+// Export symbols from the symbols module
+export const SYMBOLS = getSymbols();
+export function shouldDecorate(format) {
+    const f = (format || '').toLowerCase();
+    return f !== 'json' && f !== 'alfred' && colorEnabled();
+}
+//# sourceMappingURL=theme.js.map

package/dist/ui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"/","sources":["ui/theme.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Enhanced Visual Design System for bktide CLI\n * \n * This module implements a comprehensive color and typography system\n * that enhances information hierarchy and accessibility.\n */\nimport chalk from 'chalk';\nimport { getSymbols } from './symbols.js';\n\nfunction isTTY(): boolean {\n  return Boolean(process.stdout.isTTY);\n}\n\nfunction colorEnabled(): boolean {\n  if (process.env.NO_COLOR) return false;\n  const mode = process.env.BKTIDE_COLOR_MODE || 'auto';\n  if (mode === 'never') return false;\n  if (mode === 'always') return true;\n  return isTTY();\n}\n\n/**\n * Semantic color system for different information types\n * Using colorblind-safe palette\n */\nexport const SEMANTIC_COLORS = {\n  // Status colors (colorblind-safe)\n  success: (s: string) => colorEnabled() ? chalk.blue(s) : s,\n  error: (s: string) => colorEnabled() ? chalk.rgb(255, 140, 0)(s) : s,\n  warning: (s: string) => colorEnabled() ? chalk.yellow(s) : s,\n  info: (s: string) => colorEnabled() ? chalk.cyan(s) : s,\n  \n  // Typography emphasis levels\n  heading: (s: string) => colorEnabled() ? chalk.bold.underline(s) : `== ${s} ==`,\n  subheading: (s: string) => colorEnabled() ? chalk.bold(s) : `** ${s} **`,\n  label: (s: string) => colorEnabled() ? chalk.bold(s) : s.toUpperCase(),\n  \n  // Data type highlighting\n  identifier: (s: string) => colorEnabled() ? chalk.cyan(s) : s,\n  count: (s: string) => colorEnabled() ? chalk.magenta(s) : s,\n  url: (s: string) => colorEnabled() ? chalk.underline.cyan(s) : `<${s}>`,\n  \n  // De-emphasis (auxiliary information)\n  dim: (s: string) => colorEnabled() ? chalk.dim(s) : s,\n  muted: (s: string) => colorEnabled() ? chalk.gray(s) : s,\n  tip: (s: string) => colorEnabled() ? chalk.dim(s) : `(${s})`,\n  help: (s: string) => colorEnabled() ? chalk.dim.italic(s) : `[${s}]`,\n  \n  // Special formatting\n  highlight: (s: string) => colorEnabled() ? chalk.magenta(s) : s,\n  code: (s: string) => colorEnabled() ? chalk.bgGray.white(` ${s} `) : `\\`${s}\\``,\n};\n\n/**\n * Build status specific theming\n * Matches conventions from GitHub Actions, CircleCI, Jenkins\n */\nexport const BUILD_STATUS_THEME = {\n  // Success states\n  PASSED: {\n    color: SEMANTIC_COLORS.success,\n    symbol: '✓',\n    ascii: '[OK]',\n  },\n  \n  // Failure states\n  FAILED: {\n    color: SEMANTIC_COLORS.error,\n    symbol: '✖',\n    ascii: '[FAIL]',\n  },\n  FAILING: {\n    color: (s: string) => colorEnabled() ? chalk.rgb(255, 165, 0)(s) : s,\n    symbol: '⚠',\n    ascii: '[FAILING]',\n  },\n  \n  // Warning states\n  BLOCKED: {\n    color: SEMANTIC_COLORS.warning,\n    symbol: '⚠',\n    ascii: '[BLOCKED]',\n  },\n  CANCELED: {\n    color: SEMANTIC_COLORS.warning,\n    symbol: '⊘',\n    ascii: '[CANCEL]',\n  },\n  CANCELING: {\n    color: SEMANTIC_COLORS.warning,\n    symbol: '⊘',\n    ascii: '[...]',\n  },\n  \n  // Active states\n  RUNNING: {\n    color: SEMANTIC_COLORS.info,\n    symbol: '↻',\n    ascii: '[RUN]',\n  },\n  SCHEDULED: {\n    color: SEMANTIC_COLORS.info,\n    symbol: '⏱',\n    ascii: '[QUEUE]',\n  },\n  \n  // Inactive states\n  SKIPPED: {\n    color: SEMANTIC_COLORS.muted,\n    symbol: '−',\n    ascii: '[SKIP]',\n  },\n  NOT_RUN: {\n    color: SEMANTIC_COLORS.muted,\n    symbol: '○',\n    ascii: '[--]',\n  },\n};\n\n/**\n * Format a build status with appropriate color and symbol\n */\nexport function formatBuildStatus(\n  status: string, \n  options?: { useSymbol?: boolean; ascii?: boolean }\n): string {\n  // Normalize status to uppercase for theme lookup\n  const normalizedStatus = status.toUpperCase();\n  const theme = BUILD_STATUS_THEME[normalizedStatus as keyof typeof BUILD_STATUS_THEME];\n  if (!theme) {\n    return SEMANTIC_COLORS.muted(status);\n  }\n  \n  const useSymbol = options?.useSymbol ?? true;\n  const ascii = options?.ascii ?? false;\n  \n  if (useSymbol) {\n    const symbol = ascii ? theme.ascii : theme.symbol;\n    // Keep original casing for display\n    return `${symbol} ${theme.color(status)}`;\n  }\n  \n  // Keep original casing for display\n  return theme.color(status);\n}\n\n/**\n * Tip display styles for different contexts\n */\nexport enum TipStyle {\n  GROUPED = 'grouped',      // Tips: with arrows\n  INDIVIDUAL = 'individual', // → Individual arrows\n  ACTIONS = 'actions',      // Next steps: with arrows\n  FIXES = 'fixes',          // To fix this: numbered\n  BOX = 'box'              // Fancy box with arrows (wide terminals)\n}\n\n/**\n * Format tips with consistent styling based on context\n */\nexport function formatTips(\n  tips: string[], \n  style: TipStyle = TipStyle.GROUPED\n): string {\n  if (tips.length === 0) return '';\n  \n  switch (style) {\n    case TipStyle.GROUPED:\n      return formatGroupedTips(tips);\n    case TipStyle.INDIVIDUAL:\n      return formatIndividualTips(tips);\n    case TipStyle.ACTIONS:\n      return formatActionTips(tips);\n    case TipStyle.FIXES:\n      return formatFixTips(tips);\n    case TipStyle.BOX:\n      return formatTipBox(tips); // Use existing function\n    default:\n      return formatGroupedTips(tips);\n  }\n}\n\nfunction formatGroupedTips(tips: string[]): string {\n  const lines: string[] = [];\n  lines.push(SEMANTIC_COLORS.dim('Tips:'));\n  tips.forEach(tip => {\n    lines.push(SEMANTIC_COLORS.dim(`  → ${tip}`));\n  });\n  return lines.join('\\n');\n}\n\nfunction formatIndividualTips(tips: string[]): string {\n  return tips\n    .map(tip => SEMANTIC_COLORS.dim(`→ ${tip}`))\n    .join('\\n');\n}\n\nfunction formatActionTips(tips: string[]): string {\n  const lines: string[] = [];\n  lines.push(SEMANTIC_COLORS.dim('Next steps:'));\n  tips.forEach(tip => {\n    lines.push(SEMANTIC_COLORS.dim(`  → ${tip}`));\n  });\n  return lines.join('\\n');\n}\n\nfunction formatFixTips(tips: string[]): string {\n  const lines: string[] = [];\n  lines.push(SEMANTIC_COLORS.subheading('To fix this:'));\n  tips.forEach((tip, i) => {\n    lines.push(`  ${i + 1}. ${tip}`);\n  });\n  return lines.join('\\n');\n}\n\n/**\n * Create a formatted tip box for better visual separation\n * Only used in wide terminals\n */\nexport function formatTipBox(tips: string[], width?: number): string {\n  const termWidth = width || process.stdout.columns || 80;\n  \n  // Only use fancy box in wide terminals\n  if (termWidth < 80 || !colorEnabled()) {\n    return formatGroupedTips(tips);\n  }\n  \n  const lines: string[] = [];\n  const boxWidth = Math.min(termWidth - 4, 60);\n  const border = '─'.repeat(boxWidth - 10);\n  \n  lines.push(SEMANTIC_COLORS.dim(`┌─ Tips ${border}`));\n  tips.forEach(tip => {\n    lines.push(SEMANTIC_COLORS.dim(`│ → ${tip}`));\n  });\n  lines.push(SEMANTIC_COLORS.dim(`└${'─'.repeat(boxWidth - 1)}`));\n  \n  return lines.join('\\n');\n}\n\n/**\n * Format an error message with consistent styling\n */\nexport function formatError(\n  error: string | Error, \n  options?: { \n    showHelp?: boolean; \n    helpCommand?: string;\n    suggestions?: string[];\n  }\n): string {\n  const lines: string[] = [];\n  const symbols = getSymbols();\n  \n  // Error header\n  lines.push(`${SEMANTIC_COLORS.error(symbols.error)} ${chalk.bold('Error')}`);\n  lines.push('');\n  \n  // Error message\n  const message = typeof error === 'string' ? error : error.message;\n  lines.push(message);\n  \n  // Suggestions if provided\n  if (options?.suggestions && options.suggestions.length > 0) {\n    lines.push('');\n    lines.push(formatTips(options.suggestions, TipStyle.FIXES));\n  }\n  \n  // Help command\n  if (options?.showHelp && options?.helpCommand) {\n    lines.push('');\n    lines.push(SEMANTIC_COLORS.help(`Need help? Run: ${options.helpCommand}`));\n  }\n  \n  return lines.join('\\n');\n}\n\n/**\n * Format a success message (subtle, not redundant)\n */\nexport function formatSuccess(message: string, count?: number): string {\n  const symbols = getSymbols();\n  \n  if (count !== undefined) {\n    return `${SEMANTIC_COLORS.success(symbols.success)} ${message} ${SEMANTIC_COLORS.count(count.toString())}`;\n  }\n  \n  return `${SEMANTIC_COLORS.success(symbols.success)} ${message}`;\n}\n\n/**\n * Format empty state messages\n */\nexport function formatEmptyState(\n  message: string,\n  suggestions?: string[]\n): string {\n  const lines: string[] = [];\n  \n  lines.push(SEMANTIC_COLORS.dim(message));\n  \n  if (suggestions && suggestions.length > 0) {\n    lines.push('');\n    suggestions.forEach(s => {\n      // Make commands stand out from the dimmed text\n      const formatted = s.replace(/--\\w+[^ ]*/g, match => chalk.reset(match));\n      lines.push(SEMANTIC_COLORS.dim(formatted));\n    });\n  }\n  \n  return lines.join('\\n');\n}\n\n/**\n * Legacy color exports for backward compatibility\n * @deprecated Use SEMANTIC_COLORS instead\n */\nexport const COLORS = {\n  error: SEMANTIC_COLORS.error,\n  warn: SEMANTIC_COLORS.warning,\n  success: SEMANTIC_COLORS.success,\n  info: SEMANTIC_COLORS.info,\n  muted: SEMANTIC_COLORS.muted,\n  highlight: SEMANTIC_COLORS.highlight,\n  dim: SEMANTIC_COLORS.dim,\n};\n\n// Export symbols from the symbols module\nexport const SYMBOLS = getSymbols();\n\nexport function shouldDecorate(format?: string): boolean {\n  const f = (format || '').toLowerCase();\n  return f !== 'json' && f !== 'alfred' && colorEnabled();\n}\n\n\n"]}

package/dist/ui/width.js

@@ -0,0 +1,111 @@
+/**
+ * Terminal width utilities for responsive display
+ */
+/**
+ * Strip ANSI escape codes from a string
+ * Used for accurate length calculations
+ */
+export function stripAnsi(str) {
+    // Comprehensive regex for ANSI escape codes
+    const ansiRegex = /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
+    return str.replace(ansiRegex, '');
+}
+/**
+ * Get the current terminal width
+ * Falls back to 80 columns if not available
+ */
+export function termWidth() {
+    // Check environment variable first (for testing)
+    const envColumns = process.env.COLUMNS ? parseInt(process.env.COLUMNS, 10) : undefined;
+    const columns = envColumns || process.stdout.columns || 80;
+    // Ensure minimum width of 40 for readability
+    return Math.max(40, columns);
+}
+/**
+ * Truncate text to fit within a maximum width
+ * Adds ellipsis if text is truncated
+ */
+export function truncate(text, maxWidth) {
+    if (text.length <= maxWidth)
+        return text;
+    if (maxWidth <= 1)
+        return text[0] || '';
+    return text.slice(0, Math.max(0, maxWidth - 1)) + '…';
+}
+/**
+ * Wrap text to fit within a maximum width
+ * Returns an array of lines
+ */
+export function wrapText(text, maxWidth) {
+    if (maxWidth <= 0)
+        return [text];
+    if (text.length <= maxWidth)
+        return [text];
+    const words = text.split(/\s+/);
+    const lines = [];
+    let currentLine = '';
+    for (const word of words) {
+        // If a single word is longer than maxWidth, we need to break it
+        if (word.length > maxWidth) {
+            // Finish current line if it has content
+            if (currentLine) {
+                lines.push(currentLine.trim());
+                currentLine = '';
+            }
+            // Break the long word into chunks
+            let remaining = word;
+            while (remaining.length > maxWidth) {
+                lines.push(remaining.slice(0, maxWidth - 1) + '-');
+                remaining = remaining.slice(maxWidth - 1);
+            }
+            currentLine = remaining;
+        }
+        else if ((currentLine + ' ' + word).trim().length > maxWidth) {
+            // Start a new line
+            if (currentLine)
+                lines.push(currentLine.trim());
+            currentLine = word;
+        }
+        else {
+            // Add word to current line
+            currentLine += (currentLine ? ' ' : '') + word;
+        }
+    }
+    // Add any remaining text
+    if (currentLine)
+        lines.push(currentLine.trim());
+    return lines.length > 0 ? lines : [''];
+}
+/**
+ * Calculate column widths for a table based on terminal width
+ * Distributes available width evenly among columns
+ */
+export function calculateColumnWidths(numColumns, terminalWidth, padding = 2) {
+    if (numColumns <= 0)
+        return [];
+    // Account for padding between columns (not after last column)
+    const totalPadding = padding * (numColumns - 1);
+    const availableWidth = Math.max(numColumns, terminalWidth - totalPadding);
+    // Distribute width evenly
+    const baseWidth = Math.floor(availableWidth / numColumns);
+    const remainder = availableWidth % numColumns;
+    // Create array with base widths
+    const widths = new Array(numColumns).fill(baseWidth);
+    // Distribute remainder to first columns
+    for (let i = 0; i < remainder; i++) {
+        widths[i]++;
+    }
+    return widths;
+}
+/**
+ * Format a table row with proper column widths and truncation
+ */
+export function formatTableRow(cells, columnWidths, separator = '  ') {
+    return cells
+        .map((cell, i) => {
+        const width = columnWidths[i] || 10;
+        return truncate(cell ?? '', width).padEnd(width);
+    })
+        .join(separator);
+}
+//# sourceMappingURL=width.js.map

package/dist/ui/width.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"width.js","sourceRoot":"/","sources":["ui/width.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Terminal width utilities for responsive display\n */\n\n/**\n * Strip ANSI escape codes from a string\n * Used for accurate length calculations\n */\nexport function stripAnsi(str: string): string {\n  // Comprehensive regex for ANSI escape codes\n  const ansiRegex = /[\\u001b\\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;\n  return str.replace(ansiRegex, '');\n}\n\n/**\n * Get the current terminal width\n * Falls back to 80 columns if not available\n */\nexport function termWidth(): number {\n  // Check environment variable first (for testing)\n  const envColumns = process.env.COLUMNS ? parseInt(process.env.COLUMNS, 10) : undefined;\n  const columns = envColumns || process.stdout.columns || 80;\n  \n  // Ensure minimum width of 40 for readability\n  return Math.max(40, columns);\n}\n\n/**\n * Truncate text to fit within a maximum width\n * Adds ellipsis if text is truncated\n */\nexport function truncate(text: string, maxWidth: number): string {\n  if (text.length <= maxWidth) return text;\n  if (maxWidth <= 1) return text[0] || '';\n  return text.slice(0, Math.max(0, maxWidth - 1)) + '…';\n}\n\n/**\n * Wrap text to fit within a maximum width\n * Returns an array of lines\n */\nexport function wrapText(text: string, maxWidth: number): string[] {\n  if (maxWidth <= 0) return [text];\n  if (text.length <= maxWidth) return [text];\n  \n  const words = text.split(/\\s+/);\n  const lines: string[] = [];\n  let currentLine = '';\n  \n  for (const word of words) {\n    // If a single word is longer than maxWidth, we need to break it\n    if (word.length > maxWidth) {\n      // Finish current line if it has content\n      if (currentLine) {\n        lines.push(currentLine.trim());\n        currentLine = '';\n      }\n      // Break the long word into chunks\n      let remaining = word;\n      while (remaining.length > maxWidth) {\n        lines.push(remaining.slice(0, maxWidth - 1) + '-');\n        remaining = remaining.slice(maxWidth - 1);\n      }\n      currentLine = remaining;\n    } else if ((currentLine + ' ' + word).trim().length > maxWidth) {\n      // Start a new line\n      if (currentLine) lines.push(currentLine.trim());\n      currentLine = word;\n    } else {\n      // Add word to current line\n      currentLine += (currentLine ? ' ' : '') + word;\n    }\n  }\n  \n  // Add any remaining text\n  if (currentLine) lines.push(currentLine.trim());\n  \n  return lines.length > 0 ? lines : [''];\n}\n\n/**\n * Calculate column widths for a table based on terminal width\n * Distributes available width evenly among columns\n */\nexport function calculateColumnWidths(\n  numColumns: number,\n  terminalWidth: number,\n  padding = 2\n): number[] {\n  if (numColumns <= 0) return [];\n  \n  // Account for padding between columns (not after last column)\n  const totalPadding = padding * (numColumns - 1);\n  const availableWidth = Math.max(numColumns, terminalWidth - totalPadding);\n  \n  // Distribute width evenly\n  const baseWidth = Math.floor(availableWidth / numColumns);\n  const remainder = availableWidth % numColumns;\n  \n  // Create array with base widths\n  const widths = new Array(numColumns).fill(baseWidth);\n  \n  // Distribute remainder to first columns\n  for (let i = 0; i < remainder; i++) {\n    widths[i]++;\n  }\n  \n  return widths;\n}\n\n/**\n * Format a table row with proper column widths and truncation\n */\nexport function formatTableRow(\n  cells: string[],\n  columnWidths: number[],\n  separator = '  '\n): string {\n  return cells\n    .map((cell, i) => {\n      const width = columnWidths[i] || 10;\n      return truncate(cell ?? '', width).padEnd(width);\n    })\n    .join(separator);\n}\n"]}

package/dist/utils/alfred.js

@@ -0,0 +1,6 @@
+export function isRunningInAlfred() {
+    return Boolean(process.env.alfred_version ||
+        process.env.ALFRED_VERSION ||
+        process.env.alfred_workflow_bundleid);
+}
+//# sourceMappingURL=alfred.js.map

package/dist/utils/alfred.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alfred.js","sourceRoot":"/","sources":["utils/alfred.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CACZ,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1B,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1B,OAAO,CAAC,GAAG,CAAC,wBAAwB,CACrC,CAAC;AACJ,CAAC","sourcesContent":["export function isRunningInAlfred(): boolean {\n  return Boolean(\n    process.env.alfred_version ||\n    process.env.ALFRED_VERSION ||\n    process.env.alfred_workflow_bundleid\n  );\n}\n\n\n"]}

package/dist/utils/cli-error-handler.js

@@ -34,13 +34,26 @@ export function displayCLIError(error, debug = false, format) {
     // Format the error using the selected formatter
     const formattedError = formatter.formatError(error, { debug });
     // Print the formatted output
-    if (outputFormat === 'plain') {
-        logger.error(formattedError);
+    try {
+        if (outputFormat === 'plain') {
+            // Route plain errors to stderr for CLI best practices
+            process.stderr.write(formattedError + '\n');
+        }
+        else {
+            // Machine-readable formats to stdout
+            process.stdout.write(formattedError + '\n');
+        }
     }
-    else {
-        logger.console(formattedError);
+    catch {
+        // Fallback to logger if direct write fails
+        if (outputFormat === 'plain') {
+            logger.error(formattedError);
+        }
+        else {
+            logger.console(formattedError);
+        }
     }
-    process.exit(1);
+    process.exitCode = 1;
 }
 /**
  * Get the current global error output format
@@ -59,21 +72,21 @@ export function getErrorFormat() {
  */
 export function formatErrorForCLI(error, debug = false) {
     let output = '';
-    // Add a separator and heading
-    output += '\n\x1b[31m════════════════════════ ERROR ════════════════════════\x1b[0m\n\n';
+    // Add a separator and heading (plain text, no inline ANSI)
+    output += '\nERROR\n\n';
     if (error instanceof Error) {
         // Handle standard Error objects
-        output += `\x1b[31m${error.name}: ${error.message}\x1b[0m\n\n`;
+        output += `${error.name}: ${error.message}\n\n`;
         if (error.stack) {
             const stackLines = error.stack.split('\n');
             // First line usually contains the error message, which we've already displayed
             const stackTrace = stackLines.slice(1).join('\n');
-            output += `\x1b[33mStack Trace:\x1b[0m\n${stackTrace}\n\n`;
+            output += `Stack Trace:\n${stackTrace}\n\n`;
         }
         // Handle additional properties that might be present in API errors
         const apiError = error;
         if (apiError.response?.errors) {
-            output += '\x1b[33mAPI Errors:\x1b[0m\n';
+            output += 'API Errors:\n';
             apiError.response.errors.forEach((e, i) => {
                 output += `  Error ${i + 1}: ${e.message || 'Unknown error'}\n`;
                 if (e.path)
@@ -84,20 +97,20 @@ export function formatErrorForCLI(error, debug = false) {
             });
         }
         if (debug && apiError.request) {
-            output += '\x1b[36mRequest Details:\x1b[0m\n';
+            output += 'Request Details:\n';
             output += `  URL: ${apiError.request.url || 'N/A'}\n`;
             output += `  Method: ${apiError.request.method || 'N/A'}\n\n`;
         }
         // If error has a cause, include it
         if (apiError.cause) {
-            output += '\x1b[33mCaused by:\x1b[0m\n';
+            output += 'Caused by:\n';
             output += formatErrorForCLI(apiError.cause, debug);
         }
     }
     else if (error && typeof error === 'object') {
         // Handle non-Error objects
         try {
-            output += '\x1b[31mError Object:\x1b[0m\n';
+            output += 'Error Object:\n';
             output += JSON.stringify(error, null, 2) + '\n\n';
             // Try to extract more detailed information
             const errorObj = error;
@@ -105,7 +118,7 @@ export function formatErrorForCLI(error, debug = false) {
                 output += `Message: ${errorObj.message}\n`;
             }
             if (debug) {
-                output += '\x1b[36mProperties:\x1b[0m\n';
+                output += 'Properties:\n';
                 for (const key in errorObj) {
                     try {
                         if (key !== 'stack' && key !== 'message') {
@@ -121,16 +134,16 @@ export function formatErrorForCLI(error, debug = false) {
             }
         }
         catch {
-            output += '\x1b[31mUnable to stringify error object\x1b[0m\n\n';
+            output += 'Unable to stringify error object\n\n';
         }
     }
     else {
         // Handle primitive values
-        output += `\x1b[31m${String(error)}\x1b[0m\n\n`;
+        output += `${String(error)}\n\n`;
     }
     if (debug) {
         // Add debug information
-        output += '\x1b[36mDebug Information:\x1b[0m\n';
+        output += 'Debug Information:\n';
         output += `  Timestamp: ${new Date().toISOString()}\n`;
         output += `  Node Version: ${process.version}\n`;
         output += `  Platform: ${process.platform} (${process.arch})\n`;
@@ -139,7 +152,7 @@ export function formatErrorForCLI(error, debug = false) {
             const stack = new Error().stack;
             if (stack) {
                 const stackLines = stack.split('\n').slice(2); // Skip the Error creation line and this function
-                output += '\n\x1b[36mCurrent Stack:\x1b[0m\n';
+                output += '\nCurrent Stack:\n';
                 output += stackLines.join('\n') + '\n';
             }
         }
@@ -148,7 +161,7 @@ export function formatErrorForCLI(error, debug = false) {
         }
     }
     // Add a closing separator
-    output += '\n\x1b[31m═══════════════════════════════════════════════════════\x1b[0m\n';
+    output += '\n';
     return output;
 }
 /**
@@ -165,7 +178,9 @@ export function withCLIErrorHandling(fn, options = {}) {
         }
         catch (error) {
             displayCLIError(error, options.debugMode || false, options.format);
-            process.exit(1);
+            process.exitCode = 1;
+            // Return void to satisfy TypeScript
+            return;
         }
     };
 }

package/dist/utils/cli-error-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-error-handler.js","sourceRoot":"/","sources":["utils/cli-error-handler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CLI Error Handler - Provides error display for CLI applications\n */\n\nimport { logger } from '../services/logger.js';\nimport { FormatterFactory, FormatterType } from '../formatters/FormatterFactory.js';\nimport { ErrorFormatter } from '../formatters/errors/index.js';\n\n// Default format to use for error output\nlet globalErrorFormat = 'plain';\n\n/**\n * Set the global error output format\n * @param format The format to use ('plain', 'json', 'alfred')\n */\nexport function setErrorFormat(format: string): void {\n  const normalizedFormat = format.toLowerCase().trim();\n  if (['plain', 'json', 'alfred'].includes(normalizedFormat)) {\n    globalErrorFormat = normalizedFormat;\n    logger.debug(`Error output format set to ${normalizedFormat}`);\n  } else {\n    logger.warn(`Unknown format '${format}', error output format remains as ${globalErrorFormat}`);\n  }\n}\n\n/**\n * Display a formatted error message\n * \n * @param error The error to display\n * @param debug Whether to include debug information\n * @param format Output format (plain, json, alfred), defaults to global setting\n */\nexport function displayCLIError(\n  error: unknown, \n  debug = false, \n  format?: string\n): void {\n  // Use provided format or fall back to global format\n  const outputFormat = format || globalErrorFormat;\n  \n  // Get the appropriate formatter based on format\n  const formatter = FormatterFactory.getFormatter(FormatterType.ERROR, outputFormat) as ErrorFormatter;\n  \n  // Format the error using the selected formatter\n  const formattedError = formatter.formatError(error, { debug });\n  \n  // Print the formatted output\n  if (outputFormat === 'plain') {\n    logger.error(formattedError);\n  } else {\n    logger.console(formattedError);\n  }\n  \n  process.exit(1);\n}\n\n/**\n * Get the current global error output format\n * @returns The current format\n */\nexport function getErrorFormat(): string {\n  return globalErrorFormat;\n}\n\n/**\n * Format an error object for display in the CLI\n * Extracts as much useful information as possible, including stack traces\n * \n * @param error The error object to format\n * @param debug Whether to include debug information\n * @returns Formatted error message\n */\nexport function formatErrorForCLI(error: unknown, debug = false): string {\n  let output = '';\n  \n  // Add a separator and heading\n  output += '\\n\\x1b[31m════════════════════════ ERROR ════════════════════════\\x1b[0m\\n\\n';\n  \n  if (error instanceof Error) {\n    // Handle standard Error objects\n    output += `\\x1b[31m${error.name}: ${error.message}\\x1b[0m\\n\\n`;\n    \n    if (error.stack) {\n      const stackLines = error.stack.split('\\n');\n      // First line usually contains the error message, which we've already displayed\n      const stackTrace = stackLines.slice(1).join('\\n');\n      output += `\\x1b[33mStack Trace:\\x1b[0m\\n${stackTrace}\\n\\n`;\n    }\n    \n    // Handle additional properties that might be present in API errors\n    const apiError = error as any;\n    if (apiError.response?.errors) {\n      output += '\\x1b[33mAPI Errors:\\x1b[0m\\n';\n      apiError.response.errors.forEach((e: any, i: number) => {\n        output += `  Error ${i + 1}: ${e.message || 'Unknown error'}\\n`;\n        if (e.path) output += `  Path: ${e.path.join('.')}\\n`;\n        if (e.locations) output += `  Locations: ${JSON.stringify(e.locations)}\\n`;\n        output += '\\n';\n      });\n    }\n    \n    if (debug && apiError.request) {\n      output += '\\x1b[36mRequest Details:\\x1b[0m\\n';\n      output += `  URL: ${apiError.request.url || 'N/A'}\\n`;\n      output += `  Method: ${apiError.request.method || 'N/A'}\\n\\n`;\n    }\n    \n    // If error has a cause, include it\n    if (apiError.cause) {\n      output += '\\x1b[33mCaused by:\\x1b[0m\\n';\n      output += formatErrorForCLI(apiError.cause, debug);\n    }\n  } else if (error && typeof error === 'object') {\n    // Handle non-Error objects\n    try {\n      output += '\\x1b[31mError Object:\\x1b[0m\\n';\n      output += JSON.stringify(error, null, 2) + '\\n\\n';\n      \n      // Try to extract more detailed information\n      const errorObj = error as Record<string, any>;\n      if (errorObj.message) {\n        output += `Message: ${errorObj.message}\\n`;\n      }\n      \n      if (debug) {\n        output += '\\x1b[36mProperties:\\x1b[0m\\n';\n        for (const key in errorObj) {\n          try {\n            if (key !== 'stack' && key !== 'message') {\n              const value = errorObj[key];\n              output += `  ${key}: ${typeof value === 'object' ? JSON.stringify(value) : value}\\n`;\n            }\n          } catch {\n            output += `  ${key}: [Cannot stringify]\\n`;\n          }\n        }\n        output += '\\n';\n      }\n    } catch {\n      output += '\\x1b[31mUnable to stringify error object\\x1b[0m\\n\\n';\n    }\n  } else {\n    // Handle primitive values\n    output += `\\x1b[31m${String(error)}\\x1b[0m\\n\\n`;\n  }\n  \n  if (debug) {\n    // Add debug information\n    output += '\\x1b[36mDebug Information:\\x1b[0m\\n';\n    output += `  Timestamp: ${new Date().toISOString()}\\n`;\n    output += `  Node Version: ${process.version}\\n`;\n    output += `  Platform: ${process.platform} (${process.arch})\\n`;\n    \n    try {\n      // Get the current call stack\n      const stack = new Error().stack;\n      if (stack) {\n        const stackLines = stack.split('\\n').slice(2); // Skip the Error creation line and this function\n        output += '\\n\\x1b[36mCurrent Stack:\\x1b[0m\\n';\n        output += stackLines.join('\\n') + '\\n';\n      }\n    } catch {\n      // Ignore stack trace errors\n    }\n  }\n  \n  // Add a closing separator\n  output += '\\n\\x1b[31m═══════════════════════════════════════════════════════\\x1b[0m\\n';\n  \n  return output;\n}\n\n/**\n * Wraps a function with CLI error handling\n * \n * @param fn The function to wrap\n * @param options Error handling options\n * @returns A wrapped function with error handling\n */\nexport function withCLIErrorHandling<T extends (...args: any[]) => Promise<any>>(\n  fn: T,\n  options: {\n    debugMode?: boolean;\n    format?: string;\n  } = {}\n): (...args: Parameters<T>) => Promise<ReturnType<T>> {\n  return async function(...args: Parameters<T>): Promise<ReturnType<T>> {\n    try {\n      return await fn(...args);\n    } catch (error) {\n      displayCLIError(\n        error, \n        options.debugMode || false, \n        options.format\n      );\n      process.exit(1);\n    }\n  };\n} "]}
+{"version":3,"file":"cli-error-handler.js","sourceRoot":"/","sources":["utils/cli-error-handler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CLI Error Handler - Provides error display for CLI applications\n */\n\nimport { logger } from '../services/logger.js';\nimport { FormatterFactory, FormatterType } from '../formatters/FormatterFactory.js';\nimport { ErrorFormatter } from '../formatters/errors/index.js';\n\n// Default format to use for error output\nlet globalErrorFormat = 'plain';\n\n/**\n * Set the global error output format\n * @param format The format to use ('plain', 'json', 'alfred')\n */\nexport function setErrorFormat(format: string): void {\n  const normalizedFormat = format.toLowerCase().trim();\n  if (['plain', 'json', 'alfred'].includes(normalizedFormat)) {\n    globalErrorFormat = normalizedFormat;\n    logger.debug(`Error output format set to ${normalizedFormat}`);\n  } else {\n    logger.warn(`Unknown format '${format}', error output format remains as ${globalErrorFormat}`);\n  }\n}\n\n/**\n * Display a formatted error message\n * \n * @param error The error to display\n * @param debug Whether to include debug information\n * @param format Output format (plain, json, alfred), defaults to global setting\n */\nexport function displayCLIError(\n  error: unknown, \n  debug = false, \n  format?: string\n): void {\n  // Use provided format or fall back to global format\n  const outputFormat = format || globalErrorFormat;\n  \n  // Get the appropriate formatter based on format\n  const formatter = FormatterFactory.getFormatter(FormatterType.ERROR, outputFormat) as ErrorFormatter;\n  \n  // Format the error using the selected formatter\n  const formattedError = formatter.formatError(error, { debug });\n  \n  // Print the formatted output\n  try {\n    if (outputFormat === 'plain') {\n      // Route plain errors to stderr for CLI best practices\n      process.stderr.write(formattedError + '\\n');\n    } else {\n      // Machine-readable formats to stdout\n      process.stdout.write(formattedError + '\\n');\n    }\n  } catch {\n    // Fallback to logger if direct write fails\n    if (outputFormat === 'plain') {\n      logger.error(formattedError);\n    } else {\n      logger.console(formattedError);\n    }\n  }\n  \n  process.exitCode = 1;\n}\n\n/**\n * Get the current global error output format\n * @returns The current format\n */\nexport function getErrorFormat(): string {\n  return globalErrorFormat;\n}\n\n/**\n * Format an error object for display in the CLI\n * Extracts as much useful information as possible, including stack traces\n * \n * @param error The error object to format\n * @param debug Whether to include debug information\n * @returns Formatted error message\n */\nexport function formatErrorForCLI(error: unknown, debug = false): string {\n  let output = '';\n  \n  // Add a separator and heading (plain text, no inline ANSI)\n  output += '\\nERROR\\n\\n';\n  \n  if (error instanceof Error) {\n    // Handle standard Error objects\n    output += `${error.name}: ${error.message}\\n\\n`;\n    \n    if (error.stack) {\n      const stackLines = error.stack.split('\\n');\n      // First line usually contains the error message, which we've already displayed\n      const stackTrace = stackLines.slice(1).join('\\n');\n      output += `Stack Trace:\\n${stackTrace}\\n\\n`;\n    }\n    \n    // Handle additional properties that might be present in API errors\n    const apiError = error as any;\n    if (apiError.response?.errors) {\n      output += 'API Errors:\\n';\n      apiError.response.errors.forEach((e: any, i: number) => {\n        output += `  Error ${i + 1}: ${e.message || 'Unknown error'}\\n`;\n        if (e.path) output += `  Path: ${e.path.join('.')}\\n`;\n        if (e.locations) output += `  Locations: ${JSON.stringify(e.locations)}\\n`;\n        output += '\\n';\n      });\n    }\n    \n    if (debug && apiError.request) {\n      output += 'Request Details:\\n';\n      output += `  URL: ${apiError.request.url || 'N/A'}\\n`;\n      output += `  Method: ${apiError.request.method || 'N/A'}\\n\\n`;\n    }\n    \n    // If error has a cause, include it\n    if (apiError.cause) {\n      output += 'Caused by:\\n';\n      output += formatErrorForCLI(apiError.cause, debug);\n    }\n  } else if (error && typeof error === 'object') {\n    // Handle non-Error objects\n    try {\n      output += 'Error Object:\\n';\n      output += JSON.stringify(error, null, 2) + '\\n\\n';\n      \n      // Try to extract more detailed information\n      const errorObj = error as Record<string, any>;\n      if (errorObj.message) {\n        output += `Message: ${errorObj.message}\\n`;\n      }\n      \n      if (debug) {\n        output += 'Properties:\\n';\n        for (const key in errorObj) {\n          try {\n            if (key !== 'stack' && key !== 'message') {\n              const value = errorObj[key];\n              output += `  ${key}: ${typeof value === 'object' ? JSON.stringify(value) : value}\\n`;\n            }\n          } catch {\n            output += `  ${key}: [Cannot stringify]\\n`;\n          }\n        }\n        output += '\\n';\n      }\n    } catch {\n      output += 'Unable to stringify error object\\n\\n';\n    }\n  } else {\n    // Handle primitive values\n    output += `${String(error)}\\n\\n`;\n  }\n  \n  if (debug) {\n    // Add debug information\n    output += 'Debug Information:\\n';\n    output += `  Timestamp: ${new Date().toISOString()}\\n`;\n    output += `  Node Version: ${process.version}\\n`;\n    output += `  Platform: ${process.platform} (${process.arch})\\n`;\n    \n    try {\n      // Get the current call stack\n      const stack = new Error().stack;\n      if (stack) {\n        const stackLines = stack.split('\\n').slice(2); // Skip the Error creation line and this function\n        output += '\\nCurrent Stack:\\n';\n        output += stackLines.join('\\n') + '\\n';\n      }\n    } catch {\n      // Ignore stack trace errors\n    }\n  }\n  \n  // Add a closing separator\n  output += '\\n';\n  \n  return output;\n}\n\n/**\n * Wraps a function with CLI error handling\n * \n * @param fn The function to wrap\n * @param options Error handling options\n * @returns A wrapped function with error handling\n */\nexport function withCLIErrorHandling<T extends (...args: any[]) => Promise<any>>(\n  fn: T,\n  options: {\n    debugMode?: boolean;\n    format?: string;\n  } = {}\n): (...args: Parameters<T>) => Promise<ReturnType<T> | void> {\n  return async function(...args: Parameters<T>): Promise<ReturnType<T> | void> {\n    try {\n      return await fn(...args);\n    } catch (error) {\n      displayCLIError(\n        error, \n        options.debugMode || false, \n        options.format\n      );\n      process.exitCode = 1;\n      // Return void to satisfy TypeScript\n      return;\n    }\n  };\n} "]}