helloagents 1.1.0 → 2.2.8

package/lib/conflict.js

@@ -1,118 +0,0 @@
-/**
- * Conflict - Conflict detection and resolution
- */
-
-'use strict';
-
-const path = require('path');
-const fsPromises = require('fs').promises;
-const { fileExists, dirExists, readFileContent, getTimestamp } = require('./utils');
-
-/**
- * Check if config file exists
- * @param {string} targetPath - Path to config file
- * @param {Object} deps - Dependencies
- * @returns {Promise<boolean>}
- */
-async function checkConfigFile(targetPath, deps = {}) {
-  return fileExists(targetPath, deps);
-}
-
-/**
- * Check if skills directory exists
- * @param {string} targetPath - Path to skills directory
- * @param {Object} deps - Dependencies
- * @returns {Promise<boolean>}
- */
-async function checkSkillsDir(targetPath, deps = {}) {
-  return dirExists(targetPath, deps);
-}
-
-/**
- * Check if .new file exists and compare content
- * @param {string} newFilePath - Path to .new file
- * @param {string} sourceContent - Content to compare
- * @param {Object} deps - Dependencies
- * @returns {Promise<Object>} { exists, sameContent }
- */
-async function checkNewFile(newFilePath, sourceContent, deps = {}) {
-  const exists = await fileExists(newFilePath, deps);
-
-  if (!exists) {
-    return { exists: false, sameContent: false };
-  }
-
-  try {
-    const existingContent = await readFileContent(newFilePath, deps);
-    const sameContent = existingContent === sourceContent;
-    return { exists: true, sameContent };
-  } catch (err) {
-    return { exists: true, sameContent: false };
-  }
-}
-
-/**
- * Backup existing .new file if content is different
- * @param {string} newFilePath - Path to .new file
- * @param {Object} deps - Dependencies
- * @returns {Promise<string|null>} Backup path or null if no backup needed
- */
-async function backupNewFileIfDifferent(newFilePath, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-  const timestamp = getTimestamp(deps);
-
-  const dir = path.dirname(newFilePath);
-  const name = path.basename(newFilePath);
-  const backupPath = path.join(dir, `${name}.backup-${timestamp}`);
-
-  await fsModule.rename(newFilePath, backupPath);
-
-  return backupPath;
-}
-
-/**
- * Determine conflict resolution action
- * @param {Object} options - CLI options
- * @param {string} conflictType - 'config' or 'skills'
- * @param {string} userChoice - User's choice from prompt
- * @returns {string} Action to take
- */
-function resolveConflict(options, conflictType, userChoice = null) {
-  // If user made a choice, use it
-  if (userChoice) {
-    return userChoice;
-  }
-
-  // -y mode: use defaults
-  if (options.yes) {
-    if (conflictType === 'config') {
-      return options.overwrite ? 'overwrite' : 'new';
-    }
-    if (conflictType === 'skills') {
-      return options.noBackup ? 'overwrite' : 'backup';
-    }
-  }
-
-  // --overwrite flag for config
-  if (conflictType === 'config' && options.overwrite) {
-    return options.noBackup ? 'overwrite' : 'backup';
-  }
-
-  // Default actions
-  if (conflictType === 'config') {
-    return 'new';
-  }
-  if (conflictType === 'skills') {
-    return options.noBackup ? 'overwrite' : 'backup';
-  }
-
-  return 'skip';
-}
-
-module.exports = {
-  checkConfigFile,
-  checkSkillsDir,
-  checkNewFile,
-  backupNewFileIfDifferent,
-  resolveConflict,
-};

package/lib/copy.js

@@ -1,125 +0,0 @@
-/**
- * Copy - File copying with near-atomic writes
- */
-
-'use strict';
-
-const path = require('path');
-const fsPromises = require('fs').promises;
-const { randomSuffix, ensureDir, readFileContent } = require('./utils');
-
-/**
- * Copy a file with near-atomic write
- * @param {string} src - Source file path
- * @param {string} dest - Destination file path
- * @param {Object} deps - Dependencies
- * @returns {Promise<void>}
- */
-async function copyFile(src, dest, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-  const suffix = randomSuffix(deps);
-
-  // Ensure destination directory exists
-  await ensureDir(path.dirname(dest), deps);
-
-  // Write to temporary file first
-  const tempPath = `${dest}.tmp-${suffix}`;
-
-  try {
-    // Copy to temp file
-    await fsModule.copyFile(src, tempPath);
-
-    // Verify copy by comparing sizes
-    const srcStat = await fsModule.stat(src);
-    const tempStat = await fsModule.stat(tempPath);
-
-    if (srcStat.size !== tempStat.size) {
-      throw new Error('File copy verification failed: size mismatch');
-    }
-
-    // Rename temp to final destination (atomic on most filesystems)
-    await fsModule.rename(tempPath, dest);
-
-  } catch (err) {
-    // Clean up temp file on failure
-    try {
-      await fsModule.unlink(tempPath);
-    } catch (cleanupErr) {
-      // Ignore cleanup errors
-    }
-    throw err;
-  }
-}
-
-/**
- * Copy a directory recursively
- * @param {string} src - Source directory path
- * @param {string} dest - Destination directory path
- * @param {Object} deps - Dependencies
- * @returns {Promise<void>}
- */
-async function copyDir(src, dest, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-
-  await ensureDir(dest, deps);
-
-  const entries = await fsModule.readdir(src, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      await copyDir(srcPath, destPath, deps);
-    } else {
-      await copyFile(srcPath, destPath, deps);
-    }
-  }
-}
-
-/**
- * Write content to .new file
- * @param {string} src - Source file path
- * @param {string} dest - Destination .new file path
- * @param {Object} deps - Dependencies
- * @returns {Promise<void>}
- */
-async function writeNewFile(src, dest, deps = {}) {
-  await copyFile(src, dest, deps);
-}
-
-/**
- * Get list of files in a directory recursively
- * @param {string} dir - Directory path
- * @param {Object} deps - Dependencies
- * @returns {Promise<string[]>} List of relative file paths
- */
-async function listFiles(dir, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-  const files = [];
-
-  async function walk(currentDir, relativePath = '') {
-    const entries = await fsModule.readdir(currentDir, { withFileTypes: true });
-
-    for (const entry of entries) {
-      const fullPath = path.join(currentDir, entry.name);
-      const relPath = path.join(relativePath, entry.name);
-
-      if (entry.isDirectory()) {
-        await walk(fullPath, relPath);
-      } else {
-        files.push(relPath);
-      }
-    }
-  }
-
-  await walk(dir);
-  return files;
-}
-
-module.exports = {
-  copyFile,
-  copyDir,
-  writeNewFile,
-  listFiles,
-};

package/lib/defaults.js

@@ -1,47 +0,0 @@
-/**
- * Defaults - Default value detection for platform and language
- */
-
-'use strict';
-
-const path = require('path');
-const { dirExists, getHomeDir } = require('./utils');
-
-/**
- * Detect default platform based on existing directories
- * @param {Object} deps - Dependencies
- * @returns {Promise<Object>} { platform, reason }
- */
-async function detectDefaultPlatform(deps = {}) {
-  const homeDir = getHomeDir(deps);
-
-  const claudeDir = path.join(homeDir, '.claude');
-  const codexDir = path.join(homeDir, '.codex');
-
-  const claudeExists = await dirExists(claudeDir, deps);
-  const codexExists = await dirExists(codexDir, deps);
-
-  if (codexExists && !claudeExists) {
-    return { platform: 'codex', reason: '检测到 ~/.codex' };
-  }
-
-  if (claudeExists && !codexExists) {
-    return { platform: 'claude', reason: '检测到 ~/.claude' };
-  }
-
-  // Both exist or neither exists -> default to claude
-  return { platform: 'claude', reason: '默认选择' };
-}
-
-/**
- * Get default language
- * @returns {Object} { lang, reason }
- */
-function getDefaultLang() {
-  return { lang: 'cn', reason: '默认选择' };
-}
-
-module.exports = {
-  detectDefaultPlatform,
-  getDefaultLang,
-};

package/lib/index.js

@@ -1,297 +0,0 @@
-/**
- * Index - Main flow implementation
- */
-
-'use strict';
-
-const path = require('path');
-const fsPromises = require('fs').promises;
-
-const { getHomeDir, getSourcePaths, getTargetPaths, fileExists, dirExists, readFileContent, rmrf, ensureDir } = require('./utils');
-const { detectDefaultPlatform, getDefaultLang } = require('./defaults');
-const { createReadline, askPlatform, askLanguage, askConfigConflict, askSkillsConflict } = require('./prompts');
-const { backupFile, backupDir } = require('./backup');
-const { checkConfigFile, checkSkillsDir, checkNewFile, backupNewFileIfDifferent, resolveConflict } = require('./conflict');
-const { copyFile, copyDir, writeNewFile, listFiles } = require('./copy');
-const { createOutput, printWelcome, printSummary, printDryRunSummary, printRecoveryInstructions, info, success, warn, error, log, newline, header, divider, operation } = require('./output');
-
-/**
- * Main run function
- * @param {Object} options - CLI options
- * @param {Object} deps - Dependencies for testing
- * @returns {Promise<void>}
- */
-async function run(options, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-  const homeDir = getHomeDir(deps);
-  const output = deps.output || createOutput(deps);
-
-  // Track stats and backups
-  const stats = { write: 0, backup: 0, newFile: 0, skip: 0 };
-  const backups = [];
-
-  // Readline interface (only created if needed)
-  let rl = null;
-
-  try {
-    // Print welcome message
-    output.printWelcome();
-
-    // Determine platform
-    let platform = options.platform;
-    let platformReason = '';
-
-    if (!platform) {
-      if (options.yes) {
-        // Auto-detect in -y mode
-        const detected = await detectDefaultPlatform(deps);
-        platform = detected.platform;
-        platformReason = detected.reason;
-        output.info(`[默认] ${platformReason}，使用 ${platform === 'claude' ? 'Claude Code' : 'Codex'}`);
-      } else {
-        // Interactive mode
-        rl = createReadline();
-        const detected = await detectDefaultPlatform(deps);
-        platform = await askPlatform(rl, detected.platform, detected.reason);
-      }
-    } else {
-      output.info(`使用指定平台: ${platform === 'claude' ? 'Claude Code' : 'Codex'}`);
-    }
-
-    // Determine language
-    let lang = options.lang;
-
-    if (!lang) {
-      if (options.yes) {
-        // Use default in -y mode
-        const defaultLang = getDefaultLang();
-        lang = defaultLang.lang;
-        output.info(`[默认] 使用语言: ${lang === 'cn' ? '中文' : 'English'}`);
-      } else {
-        // Interactive mode
-        if (!rl) {
-          rl = createReadline();
-        }
-        const defaultLang = getDefaultLang();
-        lang = await askLanguage(rl, defaultLang.lang);
-      }
-    } else {
-      output.info(`使用指定语言: ${lang === 'cn' ? '中文' : 'English'}`);
-    }
-
-    // Get source and target paths
-    const sourcePaths = getSourcePaths(platform, lang);
-    const targetPaths = getTargetPaths(platform, deps);
-
-    // Validate source files exist
-    const sourceConfigExists = await fileExists(sourcePaths.configFile, deps);
-    const sourceSkillsExists = await dirExists(sourcePaths.skillsDir, deps);
-
-    if (!sourceConfigExists) {
-      throw new Error(`源配置文件不存在: ${sourcePaths.configFile}`);
-    }
-
-    if (!sourceSkillsExists) {
-      throw new Error(`源技能目录不存在: ${sourcePaths.skillsDir}`);
-    }
-
-    // Ensure target directory exists
-    await ensureDir(targetPaths.targetDir, deps);
-
-    // Dry run mode
-    if (options.dryRun) {
-      output.header('[Dry Run] 以下操作不会实际执行：');
-
-      // Check config file
-      if (!options.skillsOnly) {
-        const configExists = await checkConfigFile(targetPaths.configFile, deps);
-        const configFileName = platform === 'claude' ? 'CLAUDE.md' : 'AGENTS.md';
-
-        if (configExists) {
-          if (options.overwrite) {
-            output.operation(sourcePaths.configFile, targetPaths.configFile, '备份后覆盖');
-            stats.backup++;
-            stats.write++;
-          } else {
-            output.operation(sourcePaths.configFile, targetPaths.newFile, `生成 .helloagents.new（${configFileName} 已存在）`);
-            stats.newFile++;
-          }
-        } else {
-          output.operation(sourcePaths.configFile, targetPaths.configFile, '写入');
-          stats.write++;
-        }
-      }
-
-      // Check skills directory
-      const skillsExists = await checkSkillsDir(targetPaths.skillsDir, deps);
-
-      if (skillsExists) {
-        if (options.noBackup) {
-          output.operation(sourcePaths.skillsDir, targetPaths.skillsDir, '直接覆盖');
-        } else {
-          output.operation(sourcePaths.skillsDir, targetPaths.skillsDir, '备份后覆盖');
-          stats.backup++;
-        }
-        stats.write++;
-      } else {
-        output.operation(sourcePaths.skillsDir, targetPaths.skillsDir, '写入');
-        stats.write++;
-      }
-
-      output.printDryRunSummary(stats);
-      return;
-    }
-
-    // Process config file (unless --skills-only)
-    if (!options.skillsOnly) {
-      const configExists = await checkConfigFile(targetPaths.configFile, deps);
-      const configFileName = platform === 'claude' ? 'CLAUDE.md' : 'AGENTS.md';
-
-      if (configExists) {
-        // Determine action
-        let action;
-        if (options.yes) {
-          action = resolveConflict(options, 'config');
-        } else {
-          if (!rl) {
-            rl = createReadline();
-          }
-          action = await askConfigConflict(rl, configFileName);
-        }
-
-        switch (action) {
-          case 'new': {
-            // Check if .new file already exists
-            const sourceContent = await readFileContent(sourcePaths.configFile, deps);
-            const newFileStatus = await checkNewFile(targetPaths.newFile, sourceContent, deps);
-
-            if (newFileStatus.exists) {
-              if (newFileStatus.sameContent) {
-                output.info(`.helloagents.new 已是最新，跳过`);
-                stats.skip++;
-              } else {
-                // Backup existing .new file
-                const newBackupPath = await backupNewFileIfDifferent(targetPaths.newFile, deps);
-                backups.push(newBackupPath);
-                output.info(`已备份旧的 .helloagents.new 至 ${path.basename(newBackupPath)}`);
-                stats.backup++;
-
-                // Write new .new file
-                await writeNewFile(sourcePaths.configFile, targetPaths.newFile, deps);
-                output.success(`已生成 .helloagents.new`);
-                stats.newFile++;
-              }
-            } else {
-              await writeNewFile(sourcePaths.configFile, targetPaths.newFile, deps);
-              output.success(`已生成 .helloagents.new`);
-              stats.newFile++;
-            }
-            break;
-          }
-
-          case 'backup': {
-            const backupPath = await backupFile(targetPaths.configFile, deps);
-            backups.push(backupPath);
-            output.info(`已备份 ${configFileName} 至 ${path.basename(backupPath)}`);
-            stats.backup++;
-
-            await copyFile(sourcePaths.configFile, targetPaths.configFile, deps);
-            output.success(`已覆盖 ${configFileName}`);
-            stats.write++;
-            break;
-          }
-
-          case 'overwrite': {
-            await copyFile(sourcePaths.configFile, targetPaths.configFile, deps);
-            output.success(`已覆盖 ${configFileName}`);
-            stats.write++;
-            break;
-          }
-
-          case 'skip': {
-            output.info(`跳过 ${configFileName}`);
-            stats.skip++;
-            break;
-          }
-        }
-      } else {
-        // No conflict, just copy
-        await copyFile(sourcePaths.configFile, targetPaths.configFile, deps);
-        output.success(`已写入 ${configFileName}`);
-        stats.write++;
-      }
-    }
-
-    // Process skills directory
-    const skillsExists = await checkSkillsDir(targetPaths.skillsDir, deps);
-
-    if (skillsExists) {
-      // Determine action
-      let action;
-      if (options.yes) {
-        action = resolveConflict(options, 'skills');
-      } else {
-        if (!rl) {
-          rl = createReadline();
-        }
-        action = await askSkillsConflict(rl);
-      }
-
-      switch (action) {
-        case 'backup': {
-          const backupPath = await backupDir(targetPaths.skillsDir, deps);
-          backups.push(backupPath);
-          output.info(`已备份 skills/helloagents 至 ${path.basename(backupPath)}`);
-          stats.backup++;
-
-          // Remove old directory and copy new
-          await rmrf(targetPaths.skillsDir, deps);
-          await copyDir(sourcePaths.skillsDir, targetPaths.skillsDir, deps);
-          output.success(`已更新 skills/helloagents`);
-          stats.write++;
-          break;
-        }
-
-        case 'overwrite': {
-          await rmrf(targetPaths.skillsDir, deps);
-          await copyDir(sourcePaths.skillsDir, targetPaths.skillsDir, deps);
-          output.success(`已覆盖 skills/helloagents`);
-          stats.write++;
-          break;
-        }
-
-        case 'skip': {
-          output.info(`跳过 skills/helloagents`);
-          stats.skip++;
-          break;
-        }
-      }
-    } else {
-      // No conflict, ensure parent directory exists and copy
-      await ensureDir(path.dirname(targetPaths.skillsDir), deps);
-      await copyDir(sourcePaths.skillsDir, targetPaths.skillsDir, deps);
-      output.success(`已写入 skills/helloagents`);
-      stats.write++;
-    }
-
-    // Print summary
-    output.printSummary(stats, backups);
-
-  } catch (err) {
-    // Print recovery instructions if we have backups
-    if (backups.length > 0) {
-      output.printRecoveryInstructions(err.message, backups, options.platform || 'claude');
-    }
-    throw err;
-
-  } finally {
-    // Close readline if opened
-    if (rl) {
-      rl.close();
-    }
-  }
-}
-
-module.exports = {
-  run,
-};