nova-terminal-assistant 0.1.0

package/src/cli/utils/ErrorEnhancer.ts

@@ -0,0 +1,429 @@
+// ============================================================================
+// Error Enhancement - 增强的错误提示系统
+// ============================================================================
+
+import { CliUI, Colors, BoxChars } from './CliUI.js';
+
+/**
+ * 增强的错误类型
+ */
+export enum ErrorType {
+  CONFIG = 'CONFIG',
+  AUTH = 'AUTH',
+  NETWORK = 'NETWORK',
+  FILE = 'FILE',
+  MODEL = 'MODEL',
+  TOOL = 'TOOL',
+  VALIDATION = 'VALIDATION',
+  PERMISSION = 'PERMISSION',
+  UNKNOWN = 'UNKNOWN',
+}
+
+/**
+ * 错误建议
+ */
+interface ErrorSuggestion {
+  command?: string;
+  description: string;
+  type: 'fix' | 'info' | 'warning';
+}
+
+/**
+ * 错误详情
+ */
+interface ErrorDetail {
+  type: ErrorType;
+  message: string;
+  suggestions: ErrorSuggestion[];
+  showHelpCommand?: string;
+}
+
+/**
+ * 错误增强器
+ */
+export class ErrorEnhancer {
+  private static errorMap: Map<RegExp, ErrorDetail> = new Map([
+    // 认证错误
+    [
+      /api.?key|auth|credential/i,
+      {
+        type: ErrorType.AUTH,
+        message: 'Authentication failed',
+        suggestions: [
+          {
+            type: 'fix',
+            description: 'Check your API key configuration',
+            command: 'nova auth set <provider>',
+          },
+          {
+            type: 'info',
+            description: 'Ensure your API key is valid and has sufficient permissions',
+          },
+        ],
+      },
+    ],
+    // 配置错误
+    [
+      /config|yaml|json/i,
+      {
+        type: ErrorType.CONFIG,
+        message: 'Configuration error',
+        suggestions: [
+          {
+            type: 'fix',
+            description: 'Validate your configuration file',
+            command: 'nova config edit',
+          },
+          {
+            type: 'info',
+            description: 'Check syntax and required fields',
+          },
+        ],
+      },
+    ],
+    // 网络错误
+    [
+      /network|connection|timeout|econnrefused/i,
+      {
+        type: ErrorType.NETWORK,
+        message: 'Network error',
+        suggestions: [
+          {
+            type: 'fix',
+            description: 'Check your internet connection',
+          },
+          {
+            type: 'info',
+            description: 'Try again later or use a different provider',
+          },
+        ],
+      },
+    ],
+    // 文件错误
+    [
+      /file|directory|path|not found|enoent/i,
+      {
+        type: ErrorType.FILE,
+        message: 'File system error',
+        suggestions: [
+          {
+            type: 'fix',
+            description: 'Check file path and permissions',
+          },
+          {
+            type: 'info',
+            description: 'Ensure the file or directory exists',
+          },
+        ],
+      },
+    ],
+    // 模型错误
+    [
+      /model|llm|anthropic|openai|gpt|claude/i,
+      {
+        type: ErrorType.MODEL,
+        message: 'Model error',
+        suggestions: [
+          {
+            type: 'fix',
+            description: 'Check available models',
+            command: 'nova model list',
+          },
+          {
+            type: 'info',
+            description: 'Verify model name and provider support',
+          },
+        ],
+      },
+    ],
+    // 权限错误
+    [
+      /permission|access|denied|eacces/i,
+      {
+        type: ErrorType.PERMISSION,
+        message: 'Permission denied',
+        suggestions: [
+          {
+            type: 'fix',
+            description: 'Check file and directory permissions',
+          },
+          {
+            type: 'info',
+            description: 'Run with appropriate permissions',
+          },
+        ],
+      },
+    ],
+  ]);
+
+  /**
+   * 分析错误并生成增强的错误信息
+   */
+  static enhance(error: Error | string): ErrorDetail {
+    const message = error instanceof Error ? error.message : error;
+
+    // 查找匹配的错误模式
+    for (const [pattern, detail] of this.errorMap.entries()) {
+      if (pattern.test(message)) {
+        return {
+          ...detail,
+          message: message,
+        };
+      }
+    }
+
+    // 默认错误
+    return {
+      type: ErrorType.UNKNOWN,
+      message: message,
+      suggestions: [
+        {
+          type: 'info',
+          description: 'An unexpected error occurred',
+        },
+        {
+          type: 'fix',
+          description: 'Check the logs for more details',
+        },
+      ],
+      showHelpCommand: 'nova --help',
+    };
+  }
+
+  /**
+   * 显示增强的错误信息
+   */
+  static showError(error: Error | string, context?: string): void {
+    const detail = this.enhance(error);
+    const width = CliUI.getWidth(60, 100);
+
+    // 打印错误框
+    console.error('');
+    console.error(
+      `${Colors.error}${BoxChars.tl}${BoxChars.hThick.repeat(width - 2)}${BoxChars.tr}${Colors.reset}`
+    );
+    console.error(
+      `${Colors.error}${BoxChars.v}${Colors.reset}  ${Colors.primary}Error: ${detail.message}${' '.repeat(Math.max(0, width - detail.message.length - 12))}${Colors.error}${BoxChars.v}${Colors.reset}`
+    );
+
+    if (context) {
+      console.error(
+        `${Colors.error}${BoxChars.v}${Colors.reset}  ${Colors.dim}Context: ${context}${' '.repeat(Math.max(0, width - context.length - 13))}${Colors.error}${BoxChars.v}${Colors.reset}`
+      );
+    }
+
+    console.error(
+      `${Colors.error}${BoxChars.v}${Colors.reset}  ${Colors.dim}Type: ${detail.type}${' '.repeat(Math.max(0, width - detail.type.length - 11))}${Colors.error}${BoxChars.v}${Colors.reset}`
+    );
+
+    console.error(
+      `${Colors.error}${BoxChars.bl}${BoxChars.hThick.repeat(width - 2)}${BoxChars.br}${Colors.reset}`
+    );
+
+    // 打印建议
+    if (detail.suggestions.length > 0) {
+      console.error('');
+      console.error(`${Colors.primary}  Suggestions:${Colors.reset}`);
+      console.error('');
+
+      detail.suggestions.forEach((suggestion, index) => {
+        const icon = suggestion.type === 'fix' ? Colors.success + BoxChars.check : Colors.info + BoxChars.circle;
+        const prefix = `${icon} ${Colors.reset}`;
+
+        if (suggestion.command) {
+          console.error(`  ${prefix}${Colors.info}${suggestion.command}${Colors.reset}`);
+          console.error(`    ${Colors.dim}${suggestion.description}${Colors.reset}`);
+        } else {
+          console.error(`  ${prefix}${suggestion.description}${Colors.reset}`);
+        }
+        console.error('');
+      });
+    }
+
+    // 打印帮助命令
+    if (detail.showHelpCommand) {
+      console.error(`${Colors.muted}  Run ${Colors.info}${detail.showHelpCommand}${Colors.muted} for more information${Colors.reset}`);
+      console.error('');
+    }
+  }
+
+  /**
+   * 显示使用错误
+   */
+  static showUsageError(command: string, error: string, correctUsage: string, examples?: string[]): void {
+    const width = CliUI.getWidth(60, 100);
+
+    console.error('');
+    console.error(
+      `${Colors.warning}${BoxChars.tl}${BoxChars.hThick.repeat(width - 2)}${BoxChars.tr}${Colors.reset}`
+    );
+    console.error(
+      `${Colors.warning}${BoxChars.v}${Colors.reset}  ${Colors.primary}Usage Error${' '.repeat(width - 16)}${Colors.warning}${BoxChars.v}${Colors.reset}`
+    );
+    console.error(
+      `${Colors.warning}${BoxChars.v}${Colors.reset}  ${Colors.dim}Command: ${command}${' '.repeat(width - command.length - 14)}${Colors.warning}${BoxChars.v}${Colors.reset}`
+    );
+    console.error(
+      `${Colors.warning}${BoxChars.bl}${BoxChars.hThick.repeat(width - 2)}${BoxChars.br}${Colors.reset}`
+    );
+
+    console.error('');
+    console.error(`${Colors.error}  ${BoxChars.cross} ${error}${Colors.reset}`);
+    console.error('');
+    console.error(`${Colors.primary}  Correct Usage:${Colors.reset}`);
+    console.error(`${Colors.muted}  ${correctUsage}${Colors.reset}`);
+
+    if (examples && examples.length > 0) {
+      console.error('');
+      console.error(`${Colors.info}  Examples:${Colors.reset}`);
+      examples.forEach((ex) => {
+        console.error(`${Colors.muted}  ${ex}${Colors.reset}`);
+      });
+    }
+
+    console.error('');
+  }
+
+  /**
+   * 添加自定义错误模式
+   */
+  static addErrorPattern(pattern: RegExp, detail: ErrorDetail): void {
+    this.errorMap.set(pattern, detail);
+  }
+
+  /**
+   * 显示警告
+   */
+  static showWarning(message: string, suggestion?: string): void {
+    console.warn('');
+    console.warn(`${Colors.warning}  ${BoxChars.diamond} ${message}${Colors.reset}`);
+    if (suggestion) {
+      console.warn(`  ${Colors.dim}${suggestion}${Colors.reset}`);
+    }
+    console.warn('');
+  }
+
+  /**
+   * 显示成功消息
+   */
+  static showSuccess(message: string): void {
+    console.log('');
+    console.log(`${Colors.success}  ${BoxChars.check} ${message}${Colors.reset}`);
+    console.log('');
+  }
+
+  /**
+   * 显示信息消息
+   */
+  static showInfo(message: string): void {
+    console.log('');
+    console.log(`${Colors.info}  ${BoxChars.circle} ${message}${Colors.reset}`);
+    console.log('');
+  }
+}
+
+/**
+ * 进度提示
+ */
+export class TaskProgressIndicator {
+  private static startTime: number = 0;
+  private static message: string = '';
+
+  /**
+   * 开始任务
+   */
+  static start(message: string): void {
+    this.startTime = Date.now();
+    this.message = message;
+    console.log('');
+    console.log(`${Colors.info}  ${BoxChars.spinner[0]} ${message}${Colors.reset}`);
+  }
+
+  /**
+   * 更新进度
+   */
+  static update(message?: string): void {
+    if (message) {
+      this.message = message;
+    }
+    // 在实际使用中,这里会显示旋转的spinner
+  }
+
+  /**
+   * 完成任务
+   */
+  static complete(message?: string): void {
+    const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(2);
+    const msg = message || this.message;
+    console.log(`${Colors.success}  ${BoxChars.check} ${msg} ${Colors.dim}(${elapsed}s)${Colors.reset}`);
+    console.log('');
+  }
+
+  /**
+   * 任务失败
+   */
+  static fail(error: Error | string): void {
+    const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(2);
+    const errorMsg = error instanceof Error ? error.message : error;
+    console.log(`${Colors.error}  ${BoxChars.cross} ${this.message} ${Colors.dim}(${elapsed}s)${Colors.reset}`);
+    console.log(`  ${Colors.dim}${errorMsg}${Colors.reset}`);
+    console.log('');
+  }
+}
+
+/**
+ * 表格输出
+ */
+export class TableRenderer {
+  /**
+   * 渲染表格
+   */
+  static render(headers: string[], rows: (string | number)[][]): void {
+    const colWidths = headers.map((h, i) => {
+      const maxWidth = Math.max(
+        h.length,
+        ...rows.map(r => String(r[i] || '').length)
+      );
+      return maxWidth + 2;
+    });
+
+    // 渲染表头
+    console.log('');
+    const headerRow = headers.map((h, i) =>
+      `${Colors.primary}${h.padEnd(colWidths[i])}${Colors.reset}`
+    ).join('');
+    console.log(headerRow);
+
+    // 渲染分隔线
+    const separator = colWidths.map(w =>
+      Colors.dim + BoxChars.h.repeat(w - 1) + BoxChars.ht
+    ).join('') + BoxChars.h;
+    console.log(separator);
+
+    // 渲染数据行
+    rows.forEach(row => {
+      const cells = row.map((cell, i) =>
+        `${Colors.reset}${String(cell).padEnd(colWidths[i])}`
+      ).join('');
+      console.log(cells);
+    });
+
+    console.log('');
+  }
+
+  /**
+   * 渲染键值对列表
+   */
+  static renderKeyValue(pairs: Record<string, string | number>): void {
+    const maxLength = Math.max(...Object.keys(pairs).map(k => k.length));
+    const width = maxLength + 4;
+
+    console.log('');
+    Object.entries(pairs).forEach(([key, value]) => {
+      const paddedKey = Colors.primary + key + ':'.padEnd(width) + Colors.reset;
+      const paddedValue = Colors.muted + String(value) + Colors.reset;
+      console.log(`  ${paddedKey}${paddedValue}`);
+    });
+    console.log('');
+  }
+}

package/src/cli/utils/OutputFormatter.ts

@@ -0,0 +1,193 @@
+// ============================================================================
+// Output Formatter - Structured output for Agent consumption
+// ============================================================================
+
+/**
+ * Output format mode
+ */
+export type OutputFormat = 'text' | 'json';
+
+/**
+ * Global output configuration
+ */
+export interface OutputConfig {
+  format: OutputFormat;
+  noColor: boolean;
+  compact: boolean;
+}
+
+/**
+ * Global output formatter instance
+ */
+let globalConfig: OutputConfig = {
+  format: 'text',
+  noColor: false,
+  compact: false,
+};
+
+/**
+ * Initialize output formatter with CLI args
+ */
+export function initOutputFormatter(config: Partial<OutputConfig>): void {
+  globalConfig = { ...globalConfig, ...config };
+}
+
+/**
+ * Get current output config
+ */
+export function getOutputConfig(): OutputConfig {
+  return { ...globalConfig };
+}
+
+/**
+ * Check if JSON mode is enabled
+ */
+export function isJsonMode(): boolean {
+  return globalConfig.format === 'json';
+}
+
+/**
+ * Check if colors should be disabled
+ */
+export function shouldDisableColors(): boolean {
+  return globalConfig.noColor || isJsonMode() || !process.stdout.isTTY;
+}
+
+/**
+ * Format a single item for output
+ */
+export function formatOutput<T>(data: T): string {
+  if (isJsonMode()) {
+    return JSON.stringify(data, null, globalConfig.compact ? 0 : 2);
+  }
+  return String(data);
+}
+
+/**
+ * Format a list of items for output
+ */
+export function formatList<T>(
+  items: T[],
+  formatter: (item: T) => Record<string, unknown>
+): string {
+  if (isJsonMode()) {
+    return JSON.stringify(items.map(formatter), null, globalConfig.compact ? 0 : 2);
+  }
+  return items.map(item => formatOutput(formatter(item))).join('\n');
+}
+
+/**
+ * Format an error for output
+ */
+export function formatError(error: {
+  type: string;
+  message: string;
+  code?: string;
+  suggestions?: Array<{ description: string; command?: string }>;
+  context?: string;
+}): string {
+  if (isJsonMode()) {
+    return JSON.stringify({
+      error: true,
+      type: error.type,
+      code: error.code,
+      message: error.message,
+      context: error.context,
+      suggestions: error.suggestions,
+    }, null, globalConfig.compact ? 0 : 2);
+  }
+  
+  // Text format
+  const lines: string[] = [];
+  lines.push(`\x1b[31m╭──────────────────────────────────────────────────────────────────╮\x1b[0m`);
+  lines.push(`\x1b[31m│\x1b[0m  Error: ${error.message.slice(0, 55).padEnd(55)}\x1b[31m│\x1b[0m`);
+  if (error.context) {
+    lines.push(`\x1b[31m│\x1b[0m  Context: ${error.context.slice(0, 52).padEnd(52)}\x1b[31m│\x1b[0m`);
+  }
+  lines.push(`\x1b[31m╰──────────────────────────────────────────────────────────────────╯\x1b[0m`);
+  
+  if (error.suggestions && error.suggestions.length > 0) {
+    lines.push('');
+    lines.push('  Suggestions:');
+    error.suggestions.forEach(s => {
+      if (s.command) {
+        lines.push(`    \x1b[32m✓\x1b[0m ${s.command}`);
+        lines.push(`      ${s.description}`);
+      } else {
+        lines.push(`    • ${s.description}`);
+      }
+    });
+  }
+  
+  return lines.join('\n');
+}
+
+/**
+ * Format a success result for output
+ */
+export function formatSuccess(data: {
+  message: string;
+  details?: Record<string, unknown>;
+}): string {
+  if (isJsonMode()) {
+    return JSON.stringify({
+      success: true,
+      message: data.message,
+      details: data.details,
+    }, null, globalConfig.compact ? 0 : 2);
+  }
+  
+  const lines: string[] = [];
+  lines.push(`\x1b[32m  ✓ ${data.message}\x1b[0m`);
+  if (data.details) {
+    Object.entries(data.details).forEach(([key, value]) => {
+      lines.push(`    ${key}: ${value}`);
+    });
+  }
+  return lines.join('\n');
+}
+
+/**
+ * Format a list result with truncation hint
+ */
+export function formatListWithTruncation<T>(
+  items: T[],
+  total: number,
+  formatter: (item: T) => Record<string, unknown>,
+  hint?: string
+): string {
+  const showing = items.length;
+  const hasMore = showing < total;
+  
+  if (isJsonMode()) {
+    return JSON.stringify({
+      items: items.map(formatter),
+      pagination: {
+        showing,
+        total,
+        hasMore,
+        hint: hasMore ? hint : undefined,
+      },
+    }, null, globalConfig.compact ? 0 : 2);
+  }
+  
+  const lines: string[] = items.map(item => formatOutput(formatter(item)));
+  
+  if (hasMore) {
+    lines.push('');
+    lines.push(`  Showing ${showing} of ${total} items.`);
+    if (hint) {
+      lines.push(`  Hint: ${hint}`);
+    }
+  }
+  
+  return lines.join('\n');
+}
+
+/**
+ * Strip ANSI codes from string (for JSON mode)
+ */
+export function stripAnsi(str: string): string {
+  // eslint-disable-next-line no-control-regex
+  return str.replace(/\x1b\[[0-9;]*m/g, '');
+}

package/src/cli/utils/index.ts

@@ -0,0 +1,9 @@
+// ============================================================================
+// Utils Index - 统一导出所有工具函数
+// ============================================================================
+
+export * from './CliUI.js';
+export * from './ErrorEnhancer.js';
+export * from './CompletionHelper.js';
+export * from './OutputFormatter.js';
+