@kaitranntt/ccs 4.4.0 → 5.0.0

package/bin/utils/delegation-validator.js

@@ -1,154 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-/**
- * Validates delegation profiles for CCS delegation system
- * Ensures profiles exist and have valid API keys configured
- */
-class DelegationValidator {
-  /**
-   * Validate a delegation profile
-   * @param {string} profileName - Name of profile to validate (e.g., 'glm', 'kimi')
-   * @returns {Object} Validation result { valid: boolean, error?: string, settingsPath?: string }
-   */
-  static validate(profileName) {
-    const homeDir = os.homedir();
-    const settingsPath = path.join(homeDir, '.ccs', `${profileName}.settings.json`);
-
-    // Check if profile directory exists
-    if (!fs.existsSync(settingsPath)) {
-      return {
-        valid: false,
-        error: `Profile not found: ${profileName}`,
-        suggestion: `Profile settings missing at: ${settingsPath}\n\n` +
-                   `To set up ${profileName} profile:\n` +
-                   `  1. Copy base settings: cp config/base-${profileName}.settings.json ~/.ccs/${profileName}.settings.json\n` +
-                   `  2. Edit settings: Edit ~/.ccs/${profileName}.settings.json\n` +
-                   `  3. Set your API key in ANTHROPIC_AUTH_TOKEN field`
-      };
-    }
-
-    // Read and parse settings.json
-    let settings;
-    try {
-      const settingsContent = fs.readFileSync(settingsPath, 'utf8');
-      settings = JSON.parse(settingsContent);
-    } catch (error) {
-      return {
-        valid: false,
-        error: `Failed to parse settings.json for ${profileName}`,
-        suggestion: `Settings file is corrupted or invalid JSON.\n\n` +
-                   `Location: ${settingsPath}\n` +
-                   `Parse error: ${error.message}\n\n` +
-                   `Fix: Restore from base config:\n` +
-                   `  cp config/base-${profileName}.settings.json ~/.ccs/${profileName}.settings.json`
-      };
-    }
-
-    // Validate API key exists and is not default
-    const apiKey = settings.env?.ANTHROPIC_AUTH_TOKEN;
-
-    if (!apiKey) {
-      return {
-        valid: false,
-        error: `API key not configured for ${profileName}`,
-        suggestion: `Missing ANTHROPIC_AUTH_TOKEN in settings.\n\n` +
-                   `Edit: ${settingsPath}\n` +
-                   `Set: env.ANTHROPIC_AUTH_TOKEN to your API key`
-      };
-    }
-
-    // Check for default placeholder values
-    const defaultPlaceholders = [
-      'YOUR_GLM_API_KEY_HERE',
-      'YOUR_KIMI_API_KEY_HERE',
-      'YOUR_API_KEY_HERE',
-      'your-api-key-here',
-      'PLACEHOLDER'
-    ];
-
-    if (defaultPlaceholders.some(placeholder => apiKey.includes(placeholder))) {
-      return {
-        valid: false,
-        error: `Default API key placeholder detected for ${profileName}`,
-        suggestion: `API key is still set to default placeholder.\n\n` +
-                   `To configure your profile:\n` +
-                   `  1. Edit: ${settingsPath}\n` +
-                   `  2. Replace ANTHROPIC_AUTH_TOKEN with your actual API key\n\n` +
-                   `Get API key:\n` +
-                   `  GLM: https://z.ai/manage-apikey/apikey-list\n` +
-                   `  Kimi: https://platform.moonshot.cn/console/api-keys`
-      };
-    }
-
-    // Validation passed
-    return {
-      valid: true,
-      settingsPath,
-      apiKey: apiKey.substring(0, 8) + '...' // Show first 8 chars for verification
-    };
-  }
-
-  /**
-   * Format validation error for display
-   * @param {Object} result - Validation result from validate()
-   * @returns {string} Formatted error message
-   */
-  static formatError(result) {
-    if (result.valid) {
-      return '';
-    }
-
-    let message = `\n[X] ${result.error}\n\n`;
-
-    if (result.suggestion) {
-      message += `${result.suggestion}\n`;
-    }
-
-    return message;
-  }
-
-  /**
-   * Check if profile is delegation-ready (shorthand)
-   * @param {string} profileName - Profile to check
-   * @returns {boolean} True if ready for delegation
-   */
-  static isReady(profileName) {
-    const result = this.validate(profileName);
-    return result.valid;
-  }
-
-  /**
-   * Get all delegation-ready profiles
-   * @returns {Array<string>} List of profile names ready for delegation
-   */
-  static getReadyProfiles() {
-    const homeDir = os.homedir();
-    const ccsDir = path.join(homeDir, '.ccs');
-
-    if (!fs.existsSync(ccsDir)) {
-      return [];
-    }
-
-    const profiles = [];
-    const entries = fs.readdirSync(ccsDir, { withFileTypes: true });
-
-    // Look for *.settings.json files
-    for (const entry of entries) {
-      if (entry.isFile() && entry.name.endsWith('.settings.json')) {
-        const profileName = entry.name.replace('.settings.json', '');
-        if (this.isReady(profileName)) {
-          profiles.push(profileName);
-        }
-      }
-    }
-
-    return profiles;
-  }
-}
-
-module.exports = { DelegationValidator };

package/bin/utils/error-codes.js

@@ -1,59 +0,0 @@
-// CCS Error Codes
-// Documentation: ../../docs/errors/README.md
-
-const ERROR_CODES = {
-  // Configuration Errors (E100-E199)
-  CONFIG_MISSING: 'E101',
-  CONFIG_INVALID_JSON: 'E102',
-  CONFIG_INVALID_PROFILE: 'E103',
-
-  // Profile Management Errors (E200-E299)
-  PROFILE_NOT_FOUND: 'E104',
-  PROFILE_ALREADY_EXISTS: 'E105',
-  PROFILE_CANNOT_DELETE_DEFAULT: 'E106',
-  PROFILE_INVALID_NAME: 'E107',
-
-  // Claude CLI Detection Errors (E300-E399)
-  CLAUDE_NOT_FOUND: 'E301',
-  CLAUDE_VERSION_INCOMPATIBLE: 'E302',
-  CLAUDE_EXECUTION_FAILED: 'E303',
-
-  // Network/API Errors (E400-E499)
-  GLMT_PROXY_TIMEOUT: 'E401',
-  API_KEY_MISSING: 'E402',
-  API_AUTH_FAILED: 'E403',
-  API_RATE_LIMIT: 'E404',
-
-  // File System Errors (E500-E599)
-  FS_CANNOT_CREATE_DIR: 'E501',
-  FS_CANNOT_WRITE_FILE: 'E502',
-  FS_CANNOT_READ_FILE: 'E503',
-  FS_INSTANCE_NOT_FOUND: 'E504',
-
-  // Internal Errors (E900-E999)
-  INTERNAL_ERROR: 'E900',
-  INVALID_STATE: 'E901'
-};
-
-// Error code documentation URL generator
-function getErrorDocUrl(errorCode) {
-  return `https://github.com/kaitranntt/ccs/blob/main/docs/errors/README.md#${errorCode.toLowerCase()}`;
-}
-
-// Get error category from code
-function getErrorCategory(errorCode) {
-  const code = parseInt(errorCode.substring(1));
-  if (code >= 100 && code < 200) return 'Configuration';
-  if (code >= 200 && code < 300) return 'Profile Management';
-  if (code >= 300 && code < 400) return 'Claude CLI Detection';
-  if (code >= 400 && code < 500) return 'Network/API';
-  if (code >= 500 && code < 600) return 'File System';
-  if (code >= 900 && code < 1000) return 'Internal';
-  return 'Unknown';
-}
-
-module.exports = {
-  ERROR_CODES,
-  getErrorDocUrl,
-  getErrorCategory
-};

package/bin/utils/error-manager.js

@@ -1,165 +0,0 @@
-'use strict';
-
-const { colored } = require('./helpers');
-const { ERROR_CODES, getErrorDocUrl } = require('./error-codes');
-
-/**
- * Error types with structured messages (Legacy - kept for compatibility)
- */
-const ErrorTypes = {
-  NO_CLAUDE_CLI: 'NO_CLAUDE_CLI',
-  MISSING_SETTINGS: 'MISSING_SETTINGS',
-  INVALID_CONFIG: 'INVALID_CONFIG',
-  UNKNOWN_PROFILE: 'UNKNOWN_PROFILE',
-  PERMISSION_DENIED: 'PERMISSION_DENIED',
-  GENERIC: 'GENERIC'
-};
-
-/**
- * Enhanced error manager with context-aware messages
- */
-class ErrorManager {
-  /**
-   * Show error code and documentation URL
-   * @param {string} errorCode - Error code (e.g., E301)
-   */
-  static showErrorCode(errorCode) {
-    console.error(colored(`Error: ${errorCode}`, 'yellow'));
-    console.error(colored(getErrorDocUrl(errorCode), 'yellow'));
-    console.error('');
-  }
-
-  /**
-   * Show Claude CLI not found error
-   */
-  static showClaudeNotFound() {
-    console.error('');
-    console.error(colored('[X] Claude CLI not found', 'red'));
-    console.error('');
-    console.error('CCS requires Claude CLI to be installed and available in PATH.');
-    console.error('');
-    console.error(colored('Solutions:', 'yellow'));
-    console.error('  1. Install Claude CLI:');
-    console.error('     https://docs.claude.com/en/docs/claude-code/installation');
-    console.error('');
-    console.error('  2. Verify installation:');
-    console.error('     command -v claude   (Unix)');
-    console.error('     Get-Command claude  (Windows)');
-    console.error('');
-    console.error('  3. Custom path (if installed elsewhere):');
-    console.error('     export CCS_CLAUDE_PATH="/path/to/claude"');
-    console.error('');
-    this.showErrorCode(ERROR_CODES.CLAUDE_NOT_FOUND);
-  }
-
-  /**
-   * Show settings file not found error
-   * @param {string} settingsPath - Path to missing settings file
-   */
-  static showSettingsNotFound(settingsPath) {
-    const isClaudeSettings = settingsPath.includes('.claude') && settingsPath.endsWith('settings.json');
-
-    console.error('');
-    console.error(colored('[X] Settings file not found', 'red'));
-    console.error('');
-    console.error(`File: ${settingsPath}`);
-    console.error('');
-
-    if (isClaudeSettings) {
-      console.error('This file is auto-created when you login to Claude CLI.');
-      console.error('');
-      console.error(colored('Solutions:', 'yellow'));
-      console.error(`  echo '{}' > ${settingsPath}`);
-      console.error('  claude /login');
-      console.error('');
-      console.error('Why: Newer Claude CLI versions require explicit login.');
-    } else {
-      console.error(colored('Solutions:', 'yellow'));
-      console.error('  npm install -g @kaitranntt/ccs --force');
-      console.error('');
-      console.error('This will recreate missing profile settings.');
-    }
-
-    console.error('');
-    this.showErrorCode(ERROR_CODES.CONFIG_INVALID_PROFILE);
-  }
-
-  /**
-   * Show invalid configuration error
-   * @param {string} configPath - Path to invalid config
-   * @param {string} errorDetail - JSON parse error detail
-   */
-  static showInvalidConfig(configPath, errorDetail) {
-    console.error('');
-    console.error(colored('[X] Configuration invalid', 'red'));
-    console.error('');
-    console.error(`File: ${configPath}`);
-    console.error(`Issue: ${errorDetail}`);
-    console.error('');
-    console.error(colored('Solutions:', 'yellow'));
-    console.error('  # Backup corrupted file');
-    console.error(`  mv ${configPath} ${configPath}.backup`);
-    console.error('');
-    console.error('  # Reinstall CCS');
-    console.error('  npm install -g @kaitranntt/ccs --force');
-    console.error('');
-    console.error('Your profile settings will be preserved.');
-    console.error('');
-    this.showErrorCode(ERROR_CODES.CONFIG_INVALID_JSON);
-  }
-
-  /**
-   * Show profile not found error
-   * @param {string} profileName - Requested profile name
-   * @param {string[]} availableProfiles - List of available profiles
-   * @param {string[]} suggestions - Suggested profile names (fuzzy match)
-   */
-  static showProfileNotFound(profileName, availableProfiles, suggestions = []) {
-    console.error('');
-    console.error(colored(`[X] Profile '${profileName}' not found`, 'red'));
-    console.error('');
-
-    if (suggestions && suggestions.length > 0) {
-      console.error(colored('Did you mean:', 'yellow'));
-      suggestions.forEach(s => console.error(`  ${s}`));
-      console.error('');
-    }
-
-    console.error(colored('Available profiles:', 'cyan'));
-    availableProfiles.forEach(line => console.error(`  ${line}`));
-    console.error('');
-    console.error(colored('Solutions:', 'yellow'));
-    console.error('  # Use existing profile');
-    console.error('  ccs <profile> "your prompt"');
-    console.error('');
-    console.error('  # Create new account profile');
-    console.error('  ccs auth create <name>');
-    console.error('');
-    this.showErrorCode(ERROR_CODES.PROFILE_NOT_FOUND);
-  }
-
-  /**
-   * Show permission denied error
-   * @param {string} path - Path with permission issue
-   */
-  static showPermissionDenied(path) {
-    console.error('');
-    console.error(colored('[X] Permission denied', 'red'));
-    console.error('');
-    console.error(`Cannot write to: ${path}`);
-    console.error('');
-    console.error(colored('Solutions:', 'yellow'));
-    console.error('  # Fix ownership');
-    console.error('  sudo chown -R $USER ~/.ccs ~/.claude');
-    console.error('');
-    console.error('  # Fix permissions');
-    console.error('  chmod 755 ~/.ccs ~/.claude');
-    console.error('');
-    console.error('  # Retry installation');
-    console.error('  npm install -g @kaitranntt/ccs --force');
-    console.error('');
-    this.showErrorCode(ERROR_CODES.FS_CANNOT_WRITE_FILE);
-  }
-}
-
-module.exports = { ErrorManager, ErrorTypes };

package/bin/utils/helpers.js

@@ -1,136 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-// TTY-aware color detection (matches lib/ccs bash logic)
-function getColors() {
-  const forcedColors = process.env.FORCE_COLOR;
-  const noColor = process.env.NO_COLOR;
-  const isTTY = process.stdout.isTTY === true;  // Must be explicitly true
-
-  const useColors = forcedColors || (isTTY && !noColor);
-
-  if (useColors) {
-    return {
-      red: '\x1b[0;31m',
-      yellow: '\x1b[1;33m',
-      cyan: '\x1b[0;36m',
-      green: '\x1b[0;32m',
-      bold: '\x1b[1m',
-      reset: '\x1b[0m'
-    };
-  }
-
-  return { red: '', yellow: '', cyan: '', green: '', bold: '', reset: '' };
-}
-
-
-// Colors object (dynamic)
-const colors = getColors();
-
-// Helper: Apply color to text (returns plain text if colors disabled)
-function colored(text, colorName = 'reset') {
-  const currentColors = getColors();
-  const color = currentColors[colorName] || '';
-  return color ? `${color}${text}${currentColors.reset}` : text;
-}
-
-// Simple error formatting
-function error(message) {
-  console.error(`ERROR: ${message}`);
-  console.error('Try: npm install -g @kaitranntt/ccs --force');
-  process.exit(1);
-}
-
-// Path expansion (~ and env vars)
-function expandPath(pathStr) {
-  // Handle tilde expansion
-  if (pathStr.startsWith('~/') || pathStr.startsWith('~\\')) {
-    pathStr = path.join(os.homedir(), pathStr.slice(2));
-  }
-
-  // Expand environment variables (Windows and Unix)
-  pathStr = pathStr.replace(/\$\{([^}]+)\}/g, (_, name) => process.env[name] || '');
-  pathStr = pathStr.replace(/\$([A-Z_][A-Z0-9_]*)/gi, (_, name) => process.env[name] || '');
-
-  // Windows %VAR% style
-  if (process.platform === 'win32') {
-    pathStr = pathStr.replace(/%([^%]+)%/g, (_, name) => process.env[name] || '');
-  }
-
-  return path.normalize(pathStr);
-}
-
-/**
- * Calculate Levenshtein distance between two strings
- * @param {string} a - First string
- * @param {string} b - Second string
- * @returns {number} Edit distance
- */
-function levenshteinDistance(a, b) {
-  if (a.length === 0) return b.length;
-  if (b.length === 0) return a.length;
-
-  const matrix = [];
-
-  // Initialize first row and column
-  for (let i = 0; i <= b.length; i++) {
-    matrix[i] = [i];
-  }
-
-  for (let j = 0; j <= a.length; j++) {
-    matrix[0][j] = j;
-  }
-
-  // Fill in the rest of the matrix
-  for (let i = 1; i <= b.length; i++) {
-    for (let j = 1; j <= a.length; j++) {
-      if (b.charAt(i - 1) === a.charAt(j - 1)) {
-        matrix[i][j] = matrix[i - 1][j - 1];
-      } else {
-        matrix[i][j] = Math.min(
-          matrix[i - 1][j - 1] + 1, // substitution
-          matrix[i][j - 1] + 1,     // insertion
-          matrix[i - 1][j] + 1      // deletion
-        );
-      }
-    }
-  }
-
-  return matrix[b.length][a.length];
-}
-
-/**
- * Find similar strings using fuzzy matching
- * @param {string} target - Target string
- * @param {string[]} candidates - List of candidate strings
- * @param {number} maxDistance - Maximum edit distance (default: 2)
- * @returns {string[]} Similar strings sorted by distance
- */
-function findSimilarStrings(target, candidates, maxDistance = 2) {
-  const targetLower = target.toLowerCase();
-
-  const matches = candidates
-    .map(candidate => ({
-      name: candidate,
-      distance: levenshteinDistance(targetLower, candidate.toLowerCase())
-    }))
-    .filter(item => item.distance <= maxDistance && item.distance > 0)
-    .sort((a, b) => a.distance - b.distance)
-    .slice(0, 3)  // Show at most 3 suggestions
-    .map(item => item.name);
-
-  return matches;
-}
-
-
-module.exports = {
-  colors,
-  colored,
-  error,
-  expandPath,
-  levenshteinDistance,
-  findSimilarStrings
-};

package/bin/utils/progress-indicator.js

@@ -1,111 +0,0 @@
-'use strict';
-
-/**
- * Simple Progress Indicator (no external dependencies)
- *
- * Features:
- * - ASCII-only spinner frames (cross-platform compatible)
- * - TTY detection (no spinners in pipes/logs)
- * - Elapsed time display
- * - CI environment detection
- */
-
-class ProgressIndicator {
-  /**
-   * Create a progress indicator
-   * @param {string} message - Message to display
-   * @param {Object} options - Options
-   * @param {string[]} options.frames - Spinner frames (default: ASCII)
-   * @param {number} options.interval - Frame interval in ms (default: 80)
-   */
-  constructor(message, options = {}) {
-    this.message = message;
-    // ASCII-only frames for cross-platform compatibility
-    this.frames = options.frames || ['|', '/', '-', '\\'];
-    this.frameIndex = 0;
-    this.interval = null;
-    this.startTime = Date.now();
-
-    // TTY detection: only animate if stderr is TTY and not in CI
-    this.isTTY = process.stderr.isTTY === true && !process.env.CI && !process.env.NO_COLOR;
-  }
-
-  /**
-   * Start the spinner
-   */
-  start() {
-    if (!this.isTTY) {
-      // Non-TTY: just print message once
-      process.stderr.write(`[i] ${this.message}...\n`);
-      return;
-    }
-
-    // TTY: animate spinner
-    this.interval = setInterval(() => {
-      const frame = this.frames[this.frameIndex];
-      const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(1);
-      process.stderr.write(`\r[${frame}] ${this.message}... (${elapsed}s)`);
-      this.frameIndex = (this.frameIndex + 1) % this.frames.length;
-    }, 80); // 12.5fps for smooth animation
-  }
-
-  /**
-   * Stop spinner with success message
-   * @param {string} message - Optional success message (defaults to original message)
-   */
-  succeed(message) {
-    this.stop();
-    const finalMessage = message || this.message;
-    const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(1);
-
-    if (this.isTTY) {
-      // Clear spinner line and show success
-      process.stderr.write(`\r[OK] ${finalMessage} (${elapsed}s)\n`);
-    } else {
-      // Non-TTY: just show completion
-      process.stderr.write(`[OK] ${finalMessage}\n`);
-    }
-  }
-
-  /**
-   * Stop spinner with failure message
-   * @param {string} message - Optional failure message (defaults to original message)
-   */
-  fail(message) {
-    this.stop();
-    const finalMessage = message || this.message;
-
-    if (this.isTTY) {
-      // Clear spinner line and show failure
-      process.stderr.write(`\r[X] ${finalMessage}\n`);
-    } else {
-      // Non-TTY: just show failure
-      process.stderr.write(`[X] ${finalMessage}\n`);
-    }
-  }
-
-  /**
-   * Update spinner message (while running)
-   * @param {string} newMessage - New message to display
-   */
-  update(newMessage) {
-    this.message = newMessage;
-  }
-
-  /**
-   * Stop the spinner without showing success/failure
-   */
-  stop() {
-    if (this.interval) {
-      clearInterval(this.interval);
-      this.interval = null;
-
-      if (this.isTTY) {
-        // Clear the spinner line
-        process.stderr.write('\r\x1b[K');
-      }
-    }
-  }
-}
-
-module.exports = { ProgressIndicator };