helloagents 1.1.0 → 2.2.8

package/lib/output.js

@@ -1,220 +0,0 @@
-/**
- * Output - Formatted output with ANSI colors
- */
-
-'use strict';
-
-// Check if colors should be disabled
-const NO_COLOR = process.env.NO_COLOR !== undefined || process.argv.includes('--no-color');
-
-// ANSI color codes
-const colors = {
-  reset: NO_COLOR ? '' : '\x1b[0m',
-  bold: NO_COLOR ? '' : '\x1b[1m',
-  dim: NO_COLOR ? '' : '\x1b[2m',
-
-  // Foreground colors
-  red: NO_COLOR ? '' : '\x1b[31m',
-  green: NO_COLOR ? '' : '\x1b[32m',
-  yellow: NO_COLOR ? '' : '\x1b[33m',
-  blue: NO_COLOR ? '' : '\x1b[34m',
-  magenta: NO_COLOR ? '' : '\x1b[35m',
-  cyan: NO_COLOR ? '' : '\x1b[36m',
-  white: NO_COLOR ? '' : '\x1b[37m',
-};
-
-// Symbols
-const symbols = {
-  success: NO_COLOR ? '[OK]' : '✔',
-  error: NO_COLOR ? '[ERROR]' : '✖',
-  warning: NO_COLOR ? '[WARN]' : '⚠',
-  info: NO_COLOR ? '[INFO]' : 'ℹ',
-  arrow: NO_COLOR ? '->' : '→',
-  bullet: NO_COLOR ? '*' : '•',
-};
-
-/**
- * Create output functions with injectable stdout
- * @param {Object} deps - Dependencies
- * @returns {Object} Output functions
- */
-function createOutput(deps = {}) {
-  const stdout = deps.stdout || process.stdout;
-  const stderr = deps.stderr || process.stderr;
-
-  function write(stream, message) {
-    stream.write(message + '\n');
-  }
-
-  return {
-    /**
-     * Print success message
-     * @param {string} message
-     */
-    success(message) {
-      write(stdout, `${colors.green}${symbols.success}${colors.reset} ${message}`);
-    },
-
-    /**
-     * Print error message
-     * @param {string} message
-     */
-    error(message) {
-      write(stderr, `${colors.red}${symbols.error}${colors.reset} ${message}`);
-    },
-
-    /**
-     * Print warning message
-     * @param {string} message
-     */
-    warn(message) {
-      write(stdout, `${colors.yellow}${symbols.warning}${colors.reset} ${message}`);
-    },
-
-    /**
-     * Print info message
-     * @param {string} message
-     */
-    info(message) {
-      write(stdout, `${colors.cyan}${symbols.info}${colors.reset} ${message}`);
-    },
-
-    /**
-     * Print plain message
-     * @param {string} message
-     */
-    log(message) {
-      write(stdout, message);
-    },
-
-    /**
-     * Print empty line
-     */
-    newline() {
-      write(stdout, '');
-    },
-
-    /**
-     * Print header
-     * @param {string} title
-     */
-    header(title) {
-      write(stdout, `\n${colors.bold}${colors.cyan}${title}${colors.reset}\n`);
-    },
-
-    /**
-     * Print divider
-     */
-    divider() {
-      write(stdout, `${colors.dim}${'─'.repeat(40)}${colors.reset}`);
-    },
-
-    /**
-     * Print operation item
-     * @param {string} source
-     * @param {string} target
-     * @param {string} action
-     */
-    operation(source, target, action) {
-      write(stdout, `\n源: ${colors.cyan}${source}${colors.reset}`);
-      write(stdout, `  ${symbols.arrow} 目标: ${colors.cyan}${target}${colors.reset}`);
-      write(stdout, `  ${symbols.arrow} 操作: ${action}`);
-    },
-
-    /**
-     * Print dry-run summary
-     * @param {Object} stats - { write, backup, newFile, skip }
-     */
-    printDryRunSummary(stats) {
-      write(stdout, '');
-      write(stdout, `${colors.dim}${'─'.repeat(40)}${colors.reset}`);
-      write(stdout, `汇总: 写入 ${stats.write || 0} | 备份 ${stats.backup || 0} | 生成.new ${stats.newFile || 0} | 跳过 ${stats.skip || 0}`);
-      write(stdout, '');
-      write(stdout, `${colors.yellow}${symbols.warning}${colors.reset}  Dry Run 模式：不会做任何写入`);
-    },
-
-    /**
-     * Print final summary
-     * @param {Object} stats - { write, backup, newFile, skip }
-     * @param {Array} backups - List of backup paths
-     */
-    printSummary(stats, backups = []) {
-      write(stdout, '');
-      write(stdout, `${colors.dim}${'─'.repeat(40)}${colors.reset}`);
-      write(stdout, `${colors.green}${symbols.success}${colors.reset} 安装完成！`);
-      write(stdout, '');
-      write(stdout, `汇总: 写入 ${stats.write || 0} | 备份 ${stats.backup || 0} | 生成.new ${stats.newFile || 0} | 跳过 ${stats.skip || 0}`);
-
-      if (backups.length > 0) {
-        write(stdout, '');
-        write(stdout, `${colors.cyan}已创建的备份:${colors.reset}`);
-        for (const backup of backups) {
-          write(stdout, `  ${symbols.bullet} ${backup}`);
-        }
-      }
-    },
-
-    /**
-     * Print welcome message
-     */
-    printWelcome() {
-      write(stdout, '');
-      write(stdout, `${colors.bold}${colors.cyan}HelloAGENTS${colors.reset} - AI编程模块化技能系统`);
-      write(stdout, `${colors.dim}配置工具 v1.0.0${colors.reset}`);
-      write(stdout, '');
-    },
-
-    /**
-     * Print recovery instructions on failure
-     * @param {string} errorMessage
-     * @param {Array} backups - List of backup paths
-     * @param {string} platform - 'claude' or 'codex'
-     */
-    printRecoveryInstructions(errorMessage, backups, platform) {
-      const configDir = platform === 'claude' ? '.claude' : '.codex';
-
-      write(stderr, '');
-      write(stderr, `${colors.red}${symbols.error} 复制失败: ${errorMessage}${colors.reset}`);
-
-      if (backups.length > 0) {
-        write(stderr, '');
-        write(stderr, `${colors.cyan}已创建的备份:${colors.reset}`);
-        for (const backup of backups) {
-          write(stderr, `  ${backup}`);
-        }
-
-        write(stderr, '');
-        write(stderr, `${colors.cyan}恢复命令（如需回滚）:${colors.reset}`);
-        write(stderr, '');
-        write(stderr, `# macOS/Linux`);
-        for (const backup of backups) {
-          const original = backup.replace(/\.backup-\d{8}-\d{6}\/?$/, '');
-          const name = original.split('/').pop() || original.split('\\').pop();
-          write(stderr, `rm -rf ${original}`);
-          write(stderr, `mv ${backup} ${original}`);
-        }
-        write(stderr, '');
-        write(stderr, `# Windows PowerShell`);
-        for (const backup of backups) {
-          const original = backup.replace(/\.backup-\d{8}-\d{6}\/?$/, '');
-          const name = original.split('/').pop() || original.split('\\').pop();
-          write(stderr, `Remove-Item "${original}" -Recurse -Force`);
-          write(stderr, `Rename-Item "${backup}" "${name}"`);
-        }
-      }
-
-      write(stderr, '');
-      write(stderr, `请修复问题后重新运行，或使用上述命令手动恢复。`);
-    },
-  };
-}
-
-// Default instance
-const defaultOutput = createOutput();
-
-module.exports = {
-  colors,
-  symbols,
-  createOutput,
-  ...defaultOutput,
-};

package/lib/prompts.js

@@ -1,173 +0,0 @@
-/**
- * Prompts - Interactive prompts using native readline
- */
-
-'use strict';
-
-const readline = require('readline');
-
-/**
- * Create readline interface
- * @returns {readline.Interface}
- */
-function createReadline() {
-  return readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-}
-
-/**
- * Ask a question and get answer
- * @param {readline.Interface} rl - Readline interface
- * @param {string} question - Question to ask
- * @returns {Promise<string>}
- */
-function ask(rl, question) {
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      resolve(answer.trim());
-    });
-  });
-}
-
-/**
- * Ask for platform selection
- * @param {readline.Interface} rl - Readline interface
- * @param {string} defaultPlatform - Default platform
- * @param {string} reason - Reason for default
- * @returns {Promise<string>} 'claude' or 'codex'
- */
-async function askPlatform(rl, defaultPlatform = 'claude', reason = '') {
-  const defaultNum = defaultPlatform === 'claude' ? '1' : '2';
-  const reasonText = reason ? ` (${reason})` : '';
-
-  console.log('');
-  console.log('选择目标平台:');
-  console.log(`  1. Claude Code${defaultPlatform === 'claude' ? ` [默认]${reasonText}` : ''}`);
-  console.log(`  2. Codex${defaultPlatform === 'codex' ? ` [默认]${reasonText}` : ''}`);
-  console.log('');
-
-  const answer = await ask(rl, `请输入选项 (1-2) [${defaultNum}]: `);
-
-  if (answer === '' || answer === defaultNum) {
-    return defaultPlatform;
-  }
-
-  if (answer === '1') {
-    return 'claude';
-  }
-
-  if (answer === '2') {
-    return 'codex';
-  }
-
-  // Invalid input, ask again
-  console.log('无效输入，请输入 1 或 2');
-  return askPlatform(rl, defaultPlatform, reason);
-}
-
-/**
- * Ask for language selection
- * @param {readline.Interface} rl - Readline interface
- * @param {string} defaultLang - Default language
- * @returns {Promise<string>} 'cn' or 'en'
- */
-async function askLanguage(rl, defaultLang = 'cn') {
-  const defaultNum = defaultLang === 'cn' ? '1' : '2';
-
-  console.log('');
-  console.log('选择语言版本:');
-  console.log(`  1. 中文${defaultLang === 'cn' ? ' [默认]' : ''}`);
-  console.log(`  2. English${defaultLang === 'en' ? ' [默认]' : ''}`);
-  console.log('');
-
-  const answer = await ask(rl, `请输入选项 (1-2) [${defaultNum}]: `);
-
-  if (answer === '' || answer === defaultNum) {
-    return defaultLang;
-  }
-
-  if (answer === '1') {
-    return 'cn';
-  }
-
-  if (answer === '2') {
-    return 'en';
-  }
-
-  // Invalid input, ask again
-  console.log('无效输入，请输入 1 或 2');
-  return askLanguage(rl, defaultLang);
-}
-
-/**
- * Ask for config file conflict resolution
- * @param {readline.Interface} rl - Readline interface
- * @param {string} fileName - Name of the config file
- * @returns {Promise<string>} 'new' | 'backup' | 'overwrite' | 'skip'
- */
-async function askConfigConflict(rl, fileName) {
-  console.log('');
-  console.log(`检测到 ${fileName} 已存在，请选择处理方式:`);
-  console.log('  1. 生成 .helloagents.new 文件（保留原文件）[默认]');
-  console.log('  2. 备份后覆盖');
-  console.log('  3. 直接覆盖（不备份）');
-  console.log('  4. 跳过');
-  console.log('');
-
-  const answer = await ask(rl, '请输入选项 (1-4) [1]: ');
-
-  switch (answer) {
-    case '':
-    case '1':
-      return 'new';
-    case '2':
-      return 'backup';
-    case '3':
-      return 'overwrite';
-    case '4':
-      return 'skip';
-    default:
-      console.log('无效输入，请输入 1-4');
-      return askConfigConflict(rl, fileName);
-  }
-}
-
-/**
- * Ask for skills directory conflict resolution
- * @param {readline.Interface} rl - Readline interface
- * @returns {Promise<string>} 'backup' | 'overwrite' | 'skip'
- */
-async function askSkillsConflict(rl) {
-  console.log('');
-  console.log('检测到 skills/helloagents 目录已存在，请选择处理方式:');
-  console.log('  1. 备份后覆盖 [默认]');
-  console.log('  2. 直接覆盖（不备份）');
-  console.log('  3. 跳过');
-  console.log('');
-
-  const answer = await ask(rl, '请输入选项 (1-3) [1]: ');
-
-  switch (answer) {
-    case '':
-    case '1':
-      return 'backup';
-    case '2':
-      return 'overwrite';
-    case '3':
-      return 'skip';
-    default:
-      console.log('无效输入，请输入 1-3');
-      return askSkillsConflict(rl);
-  }
-}
-
-module.exports = {
-  createReadline,
-  ask,
-  askPlatform,
-  askLanguage,
-  askConfigConflict,
-  askSkillsConflict,
-};

package/lib/utils.js

@@ -1,225 +0,0 @@
-/**
- * Utils - Utility functions with dependency injection support
- */
-
-'use strict';
-
-const fs = require('fs');
-const fsPromises = require('fs').promises;
-const path = require('path');
-const os = require('os');
-
-/**
- * Get home directory (injectable for testing)
- * @param {Object} deps - Dependencies
- * @returns {string} Home directory path
- */
-function getHomeDir(deps = {}) {
-  if (deps.homeDir) {
-    return deps.homeDir;
-  }
-  return os.homedir();
-}
-
-/**
- * Get timestamp string (injectable for testing)
- * @param {Object} deps - Dependencies
- * @returns {string} Timestamp in YYYYMMDD-HHmmss format
- */
-function getTimestamp(deps = {}) {
-  const now = deps.now ? deps.now() : new Date();
-  const year = now.getFullYear();
-  const month = String(now.getMonth() + 1).padStart(2, '0');
-  const day = String(now.getDate()).padStart(2, '0');
-  const hours = String(now.getHours()).padStart(2, '0');
-  const minutes = String(now.getMinutes()).padStart(2, '0');
-  const seconds = String(now.getSeconds()).padStart(2, '0');
-  return `${year}${month}${day}-${hours}${minutes}${seconds}`;
-}
-
-/**
- * Generate random suffix (injectable for testing)
- * @param {Object} deps - Dependencies
- * @returns {string} Random 6-character string
- */
-function randomSuffix(deps = {}) {
-  if (deps.randomSuffix) {
-    return deps.randomSuffix();
-  }
-  return Math.random().toString(36).slice(2, 8);
-}
-
-/**
- * Check if file exists
- * @param {string} filePath - Path to check
- * @param {Object} deps - Dependencies
- * @returns {Promise<boolean>}
- */
-async function fileExists(filePath, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-  try {
-    const stat = await fsModule.stat(filePath);
-    return stat.isFile();
-  } catch (err) {
-    if (err.code === 'ENOENT') {
-      return false;
-    }
-    throw err;
-  }
-}
-
-/**
- * Check if directory exists
- * @param {string} dirPath - Path to check
- * @param {Object} deps - Dependencies
- * @returns {Promise<boolean>}
- */
-async function dirExists(dirPath, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-  try {
-    const stat = await fsModule.stat(dirPath);
-    return stat.isDirectory();
-  } catch (err) {
-    if (err.code === 'ENOENT') {
-      return false;
-    }
-    throw err;
-  }
-}
-
-/**
- * Read file content
- * @param {string} filePath - Path to read
- * @param {Object} deps - Dependencies
- * @returns {Promise<string>}
- */
-async function readFileContent(filePath, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-  return fsModule.readFile(filePath, 'utf8');
-}
-
-/**
- * Recursive delete (compatible with Node 16)
- * @param {string} targetPath - Path to delete
- * @param {Object} deps - Dependencies
- * @returns {Promise<void>}
- */
-async function rmrf(targetPath, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-
-  // Check if path exists
-  try {
-    await fsModule.stat(targetPath);
-  } catch (err) {
-    if (err.code === 'ENOENT') {
-      return; // Already doesn't exist
-    }
-    throw err;
-  }
-
-  // Try fs.rm first (Node 16+)
-  if (fsModule.rm) {
-    try {
-      await fsModule.rm(targetPath, { recursive: true, force: true });
-      return;
-    } catch (err) {
-      // Fall through to rmdir
-    }
-  }
-
-  // Fallback to fs.rmdir with recursive (Node 16+)
-  if (fsModule.rmdir) {
-    await fsModule.rmdir(targetPath, { recursive: true });
-    return;
-  }
-
-  // Manual recursive delete as last resort
-  const stat = await fsModule.stat(targetPath);
-  if (stat.isDirectory()) {
-    const entries = await fsModule.readdir(targetPath);
-    for (const entry of entries) {
-      await rmrf(path.join(targetPath, entry), deps);
-    }
-    await fsModule.rmdir(targetPath);
-  } else {
-    await fsModule.unlink(targetPath);
-  }
-}
-
-/**
- * Ensure directory exists (create if not)
- * @param {string} dirPath - Directory path
- * @param {Object} deps - Dependencies
- * @returns {Promise<void>}
- */
-async function ensureDir(dirPath, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-  try {
-    await fsModule.mkdir(dirPath, { recursive: true });
-  } catch (err) {
-    if (err.code !== 'EEXIST') {
-      throw err;
-    }
-  }
-}
-
-/**
- * Get package root directory (where package.json is)
- * @returns {string}
- */
-function getPackageRoot() {
-  return path.resolve(__dirname, '..');
-}
-
-/**
- * Get source path for platform and language
- * @param {string} platform - 'claude' or 'codex'
- * @param {string} lang - 'cn' or 'en'
- * @returns {Object} { configFile, skillsDir }
- */
-function getSourcePaths(platform, lang) {
-  const root = getPackageRoot();
-  const platformDir = platform === 'claude' ? 'Claude' : 'Codex';
-  const langDir = lang === 'cn' ? 'CN' : 'EN';
-  const configFileName = platform === 'claude' ? 'CLAUDE.md' : 'AGENTS.md';
-
-  return {
-    configFile: path.join(root, platformDir, 'Skills', langDir, configFileName),
-    skillsDir: path.join(root, platformDir, 'Skills', langDir, 'skills', 'helloagents'),
-  };
-}
-
-/**
- * Get target path for platform
- * @param {string} platform - 'claude' or 'codex'
- * @param {Object} deps - Dependencies
- * @returns {Object} { targetDir, configFile, skillsDir, newFile }
- */
-function getTargetPaths(platform, deps = {}) {
-  const homeDir = getHomeDir(deps);
-  const targetDir = platform === 'claude'
-    ? path.join(homeDir, '.claude')
-    : path.join(homeDir, '.codex');
-  const configFileName = platform === 'claude' ? 'CLAUDE.md' : 'AGENTS.md';
-
-  return {
-    targetDir,
-    configFile: path.join(targetDir, configFileName),
-    skillsDir: path.join(targetDir, 'skills', 'helloagents'),
-    newFile: path.join(targetDir, '.helloagents.new'),
-  };
-}
-
-module.exports = {
-  getHomeDir,
-  getTimestamp,
-  randomSuffix,
-  fileExists,
-  dirExists,
-  readFileContent,
-  rmrf,
-  ensureDir,
-  getPackageRoot,
-  getSourcePaths,
-  getTargetPaths,
-};