@zeyue0329/xiaoma-cli 1.6.5 → 1.8.0

package/tools/cli/commands/build.js

@@ -1,458 +0,0 @@
-const chalk = require('chalk');
-const path = require('node:path');
-const fs = require('fs-extra');
-const { YamlXmlBuilder } = require('../lib/yaml-xml-builder');
-const { getProjectRoot } = require('../lib/project-root');
-
-const builder = new YamlXmlBuilder();
-
-/**
- * Find .claude directory by searching up from current directory
- */
-async function findClaudeDir(startDir) {
-  let currentDir = startDir;
-  const root = path.parse(currentDir).root;
-
-  while (currentDir !== root) {
-    const claudeDir = path.join(currentDir, '.claude');
-    if (await fs.pathExists(claudeDir)) {
-      return claudeDir;
-    }
-    currentDir = path.dirname(currentDir);
-  }
-
-  return null;
-}
-
-module.exports = {
-  command: 'build [agent]',
-  description: 'Build agent XML files from YAML sources',
-  options: [
-    ['-a, --all', 'Rebuild all agents'],
-    ['-d, --directory <path>', 'Project directory', '.'],
-    ['--force', 'Force rebuild even if up to date'],
-  ],
-  action: async (agentName, options) => {
-    try {
-      let projectDir = path.resolve(options.directory);
-
-      // Auto-detect .claude directory (search up from current dir)
-      const claudeDir = await findClaudeDir(projectDir);
-      if (!claudeDir) {
-        console.log(chalk.yellow('\n⚠️  No .claude directory found'));
-        console.log(chalk.dim('Run this command from your project directory or'));
-        console.log(chalk.dim('use --directory flag to specify location'));
-        console.log(chalk.dim('\nExample: npx xiaoma-cli build pm --directory /path/to/project'));
-        process.exit(1);
-      }
-
-      // Use the directory containing .claude
-      projectDir = path.dirname(claudeDir);
-      console.log(chalk.dim(`Using project: ${projectDir}\n`));
-
-      console.log(chalk.cyan('🔨 Building Agent Files\n'));
-
-      if (options.all) {
-        // Build all agents
-        await buildAllAgents(projectDir, options.force);
-      } else if (agentName) {
-        // Build specific agent
-        await buildAgent(projectDir, agentName, options.force);
-      } else {
-        // No agent specified, check what needs rebuilding
-        await checkBuildStatus(projectDir);
-      }
-
-      process.exit(0);
-    } catch (error) {
-      console.error(chalk.red('\nError:'), error.message);
-      if (process.env.DEBUG) {
-        console.error(error.stack);
-      }
-      process.exit(1);
-    }
-  },
-};
-
-/**
- * Build a specific agent
- */
-async function buildAgent(projectDir, agentName, force = false) {
-  // First check standalone agents in xiaoma/agents/{agentname}/
-  const standaloneAgentDir = path.join(projectDir, 'xiaoma', 'agents', agentName);
-  let standaloneYamlPath = path.join(standaloneAgentDir, `${agentName}.agent.yaml`);
-
-  // If exact match doesn't exist, look for any .agent.yaml file in the directory
-  if (!(await fs.pathExists(standaloneYamlPath)) && (await fs.pathExists(standaloneAgentDir))) {
-    const files = await fs.readdir(standaloneAgentDir);
-    const agentFile = files.find((f) => f.endsWith('.agent.yaml'));
-    if (agentFile) {
-      standaloneYamlPath = path.join(standaloneAgentDir, agentFile);
-    }
-  }
-
-  if (await fs.pathExists(standaloneYamlPath)) {
-    const yamlFileName = path.basename(standaloneYamlPath, '.agent.yaml');
-    const outputPath = path.join(standaloneAgentDir, `${yamlFileName}.md`);
-
-    // Check if rebuild needed
-    if (!force && (await fs.pathExists(outputPath))) {
-      const needsRebuild = await checkIfNeedsRebuild(standaloneYamlPath, outputPath, projectDir, agentName);
-      if (!needsRebuild) {
-        console.log(chalk.dim(`  ${agentName}: already up to date`));
-        return;
-      }
-    }
-
-    // Build the standalone agent
-    console.log(chalk.cyan(`  Building standalone agent ${agentName}...`));
-
-    const customizePath = path.join(projectDir, 'xiaoma', '_cfg', 'agents', `${agentName}.customize.yaml`);
-    const customizeExists = await fs.pathExists(customizePath);
-
-    await builder.buildAgent(standaloneYamlPath, customizeExists ? customizePath : null, outputPath, { includeMetadata: true });
-
-    console.log(chalk.green(`  ✓ ${agentName} built successfully (standalone)`));
-    return;
-  }
-
-  // Find the agent YAML file in .claude/commands/xiaoma/
-  const xiaomaCommandsDir = path.join(projectDir, '.claude', 'commands', 'xiaoma');
-
-  // Search all module directories for the agent
-  const modules = await fs.readdir(xiaomaCommandsDir);
-  let found = false;
-
-  for (const module of modules) {
-    const agentYamlPath = path.join(xiaomaCommandsDir, module, 'agents', `${agentName}.agent.yaml`);
-    const outputPath = path.join(xiaomaCommandsDir, module, 'agents', `${agentName}.md`);
-
-    if (await fs.pathExists(agentYamlPath)) {
-      found = true;
-
-      // Check if rebuild needed
-      if (!force && (await fs.pathExists(outputPath))) {
-        const needsRebuild = await checkIfNeedsRebuild(agentYamlPath, outputPath, projectDir, agentName);
-        if (!needsRebuild) {
-          console.log(chalk.dim(`  ${agentName}: already up to date`));
-          return;
-        }
-      }
-
-      // Build the agent
-      console.log(chalk.cyan(`  Building ${agentName}...`));
-
-      const customizePath = path.join(projectDir, '.claude', '_cfg', 'agents', `${agentName}.customize.yaml`);
-      const customizeExists = await fs.pathExists(customizePath);
-
-      await builder.buildAgent(agentYamlPath, customizeExists ? customizePath : null, outputPath, { includeMetadata: true });
-
-      console.log(chalk.green(`  ✓ ${agentName} built successfully`));
-      return;
-    }
-  }
-
-  if (!found) {
-    console.log(chalk.yellow(`  ⚠️  Agent '${agentName}' not found`));
-    console.log(chalk.dim('     Available agents:'));
-    await listAvailableAgents(projectDir);
-  }
-}
-
-/**
- * Build all agents
- */
-async function buildAllAgents(projectDir, force = false) {
-  let builtCount = 0;
-  let skippedCount = 0;
-
-  // First, build standalone agents in xiaoma/agents/
-  const standaloneAgentsDir = path.join(projectDir, 'xiaoma', 'agents');
-  if (await fs.pathExists(standaloneAgentsDir)) {
-    console.log(chalk.cyan('\nBuilding standalone agents...'));
-    const agentDirs = await fs.readdir(standaloneAgentsDir);
-
-    for (const agentDirName of agentDirs) {
-      const agentDir = path.join(standaloneAgentsDir, agentDirName);
-
-      // Skip if not a directory
-      const stat = await fs.stat(agentDir);
-      if (!stat.isDirectory()) {
-        continue;
-      }
-
-      // Find any .agent.yaml file in the directory
-      const files = await fs.readdir(agentDir);
-      const agentFile = files.find((f) => f.endsWith('.agent.yaml'));
-
-      if (!agentFile) {
-        continue;
-      }
-
-      const agentYamlPath = path.join(agentDir, agentFile);
-      const agentName = path.basename(agentFile, '.agent.yaml');
-      const outputPath = path.join(agentDir, `${agentName}.md`);
-
-      // Check if rebuild needed
-      if (!force && (await fs.pathExists(outputPath))) {
-        const needsRebuild = await checkIfNeedsRebuild(agentYamlPath, outputPath, projectDir, agentName);
-        if (!needsRebuild) {
-          console.log(chalk.dim(`  ${agentName}: up to date`));
-          skippedCount++;
-          continue;
-        }
-      }
-
-      console.log(chalk.cyan(`  Building standalone agent ${agentName}...`));
-
-      const customizePath = path.join(projectDir, 'xiaoma', '_cfg', 'agents', `${agentName}.customize.yaml`);
-      const customizeExists = await fs.pathExists(customizePath);
-
-      await builder.buildAgent(agentYamlPath, customizeExists ? customizePath : null, outputPath, { includeMetadata: true });
-
-      console.log(chalk.green(`  ✓ ${agentName} (standalone)`));
-      builtCount++;
-    }
-  }
-
-  // Then, build module agents in .claude/commands/xiaoma/
-  const xiaomaCommandsDir = path.join(projectDir, '.claude', 'commands', 'xiaoma');
-  if (await fs.pathExists(xiaomaCommandsDir)) {
-    console.log(chalk.cyan('\nBuilding module agents...'));
-    const modules = await fs.readdir(xiaomaCommandsDir);
-
-    for (const module of modules) {
-      const agentsDir = path.join(xiaomaCommandsDir, module, 'agents');
-
-      if (!(await fs.pathExists(agentsDir))) {
-        continue;
-      }
-
-      const files = await fs.readdir(agentsDir);
-
-      for (const file of files) {
-        if (!file.endsWith('.agent.yaml')) {
-          continue;
-        }
-
-        const agentName = file.replace('.agent.yaml', '');
-        const agentYamlPath = path.join(agentsDir, file);
-        const outputPath = path.join(agentsDir, `${agentName}.md`);
-
-        // Check if rebuild needed
-        if (!force && (await fs.pathExists(outputPath))) {
-          const needsRebuild = await checkIfNeedsRebuild(agentYamlPath, outputPath, projectDir, agentName);
-          if (!needsRebuild) {
-            console.log(chalk.dim(`  ${agentName}: up to date`));
-            skippedCount++;
-            continue;
-          }
-        }
-
-        console.log(chalk.cyan(`  Building ${agentName}...`));
-
-        const customizePath = path.join(projectDir, '.claude', '_cfg', 'agents', `${agentName}.customize.yaml`);
-        const customizeExists = await fs.pathExists(customizePath);
-
-        await builder.buildAgent(agentYamlPath, customizeExists ? customizePath : null, outputPath, { includeMetadata: true });
-
-        console.log(chalk.green(`  ✓ ${agentName} (${module})`));
-        builtCount++;
-      }
-    }
-  }
-
-  console.log(chalk.green(`\n✓ Built ${builtCount} agent(s)`));
-  if (skippedCount > 0) {
-    console.log(chalk.dim(`  Skipped ${skippedCount} (already up to date)`));
-  }
-}
-
-/**
- * Check what needs rebuilding
- */
-async function checkBuildStatus(projectDir) {
-  const needsRebuild = [];
-  const upToDate = [];
-
-  // Check standalone agents in xiaoma/agents/
-  const standaloneAgentsDir = path.join(projectDir, 'xiaoma', 'agents');
-  if (await fs.pathExists(standaloneAgentsDir)) {
-    const agentDirs = await fs.readdir(standaloneAgentsDir);
-
-    for (const agentDirName of agentDirs) {
-      const agentDir = path.join(standaloneAgentsDir, agentDirName);
-
-      // Skip if not a directory
-      const stat = await fs.stat(agentDir);
-      if (!stat.isDirectory()) {
-        continue;
-      }
-
-      // Find any .agent.yaml file in the directory
-      const files = await fs.readdir(agentDir);
-      const agentFile = files.find((f) => f.endsWith('.agent.yaml'));
-
-      if (!agentFile) {
-        continue;
-      }
-
-      const agentYamlPath = path.join(agentDir, agentFile);
-      const agentName = path.basename(agentFile, '.agent.yaml');
-      const outputPath = path.join(agentDir, `${agentName}.md`);
-
-      if (!(await fs.pathExists(outputPath))) {
-        needsRebuild.push(`${agentName} (standalone)`);
-      } else if (await checkIfNeedsRebuild(agentYamlPath, outputPath, projectDir, agentName)) {
-        needsRebuild.push(`${agentName} (standalone)`);
-      } else {
-        upToDate.push(`${agentName} (standalone)`);
-      }
-    }
-  }
-
-  // Check module agents in .claude/commands/xiaoma/
-  const xiaomaCommandsDir = path.join(projectDir, '.claude', 'commands', 'xiaoma');
-  if (await fs.pathExists(xiaomaCommandsDir)) {
-    const modules = await fs.readdir(xiaomaCommandsDir);
-
-    for (const module of modules) {
-      const agentsDir = path.join(xiaomaCommandsDir, module, 'agents');
-
-      if (!(await fs.pathExists(agentsDir))) {
-        continue;
-      }
-
-      const files = await fs.readdir(agentsDir);
-
-      for (const file of files) {
-        if (!file.endsWith('.agent.yaml')) {
-          continue;
-        }
-
-        const agentName = file.replace('.agent.yaml', '');
-        const agentYamlPath = path.join(agentsDir, file);
-        const outputPath = path.join(agentsDir, `${agentName}.md`);
-
-        if (!(await fs.pathExists(outputPath))) {
-          needsRebuild.push(`${agentName} (${module})`);
-        } else if (await checkIfNeedsRebuild(agentYamlPath, outputPath, projectDir, agentName)) {
-          needsRebuild.push(`${agentName} (${module})`);
-        } else {
-          upToDate.push(`${agentName} (${module})`);
-        }
-      }
-    }
-  }
-
-  if (needsRebuild.length === 0) {
-    console.log(chalk.green('✓ All agents are up to date'));
-  } else {
-    console.log(chalk.yellow(`${needsRebuild.length} agent(s) need rebuilding:`));
-    for (const agent of needsRebuild) {
-      console.log(chalk.dim(`  - ${agent}`));
-    }
-    console.log(chalk.dim('\nRun "xiaoma build --all" to rebuild all agents'));
-  }
-
-  if (upToDate.length > 0) {
-    console.log(chalk.dim(`\n${upToDate.length} agent(s) up to date`));
-  }
-}
-
-/**
- * Check if an agent needs rebuilding by comparing hashes
- */
-async function checkIfNeedsRebuild(yamlPath, outputPath, projectDir, agentName) {
-  // Read the output file to check its metadata
-  const outputContent = await fs.readFile(outputPath, 'utf8');
-
-  // Extract hash from BUILD-META comment
-  const metaMatch = outputContent.match(/source:.*\(hash: ([a-f0-9]+)\)/);
-  if (!metaMatch) {
-    // No metadata, needs rebuild
-    return true;
-  }
-
-  const storedHash = metaMatch[1];
-
-  // Calculate current hash
-  const currentHash = await builder.calculateFileHash(yamlPath);
-
-  if (storedHash !== currentHash) {
-    return true;
-  }
-
-  // Check customize file if it exists
-  const customizePath = path.join(projectDir, '.claude', '_cfg', 'agents', `${agentName}.customize.yaml`);
-  if (await fs.pathExists(customizePath)) {
-    const customizeMetaMatch = outputContent.match(/customize:.*\(hash: ([a-f0-9]+)\)/);
-    if (!customizeMetaMatch) {
-      return true;
-    }
-
-    const storedCustomizeHash = customizeMetaMatch[1];
-    const currentCustomizeHash = await builder.calculateFileHash(customizePath);
-
-    if (storedCustomizeHash !== currentCustomizeHash) {
-      return true;
-    }
-  }
-
-  return false;
-}
-
-/**
- * List available agents
- */
-async function listAvailableAgents(projectDir) {
-  // List standalone agents first
-  const standaloneAgentsDir = path.join(projectDir, 'xiaoma', 'agents');
-  if (await fs.pathExists(standaloneAgentsDir)) {
-    console.log(chalk.dim('     Standalone agents:'));
-    const agentDirs = await fs.readdir(standaloneAgentsDir);
-
-    for (const agentDirName of agentDirs) {
-      const agentDir = path.join(standaloneAgentsDir, agentDirName);
-
-      // Skip if not a directory
-      const stat = await fs.stat(agentDir);
-      if (!stat.isDirectory()) {
-        continue;
-      }
-
-      // Find any .agent.yaml file in the directory
-      const files = await fs.readdir(agentDir);
-      const agentFile = files.find((f) => f.endsWith('.agent.yaml'));
-
-      if (agentFile) {
-        const agentName = path.basename(agentFile, '.agent.yaml');
-        console.log(chalk.dim(`       - ${agentName} (in ${agentDirName}/)`));
-      }
-    }
-  }
-
-  // List module agents
-  const xiaomaCommandsDir = path.join(projectDir, '.claude', 'commands', 'xiaoma');
-  if (await fs.pathExists(xiaomaCommandsDir)) {
-    console.log(chalk.dim('     Module agents:'));
-    const modules = await fs.readdir(xiaomaCommandsDir);
-
-    for (const module of modules) {
-      const agentsDir = path.join(xiaomaCommandsDir, module, 'agents');
-
-      if (!(await fs.pathExists(agentsDir))) {
-        continue;
-      }
-
-      const files = await fs.readdir(agentsDir);
-
-      for (const file of files) {
-        if (file.endsWith('.agent.yaml')) {
-          const agentName = file.replace('.agent.yaml', '');
-          console.log(chalk.dim(`       - ${agentName} (${module})`));
-        }
-      }
-    }
-  }
-}

package/tools/cli/commands/cleanup.js

@@ -1,144 +0,0 @@
-const chalk = require('chalk');
-const fs = require('fs-extra');
-const nodePath = require('node:path');
-const yaml = require('js-yaml');
-const { Installer } = require('../installers/lib/core/installer');
-
-module.exports = {
-  command: 'cleanup',
-  description: 'Clean up obsolete files from XIAOMA installation',
-  options: [
-    ['-d, --dry-run', 'Show what would be deleted without actually deleting'],
-    ['-a, --auto-delete', 'Automatically delete non-retained files without prompts'],
-    ['-l, --list-retained', 'List currently retained files'],
-    ['-c, --clear-retained', 'Clear retained files list'],
-  ],
-  action: async (options) => {
-    try {
-      // Create installer and let it find the XIAOMA directory
-      const installer = new Installer();
-      const { xiaomaDir } = await installer.findXiaomaDir(process.cwd());
-
-      if (!xiaomaDir) {
-        console.error(chalk.red('❌ XIAOMA installation not found'));
-        process.exit(1);
-      }
-
-      // Check that the directory actually exists (findXiaomaDir always returns a path)
-      if (!(await fs.pathExists(xiaomaDir))) {
-        console.error(chalk.red('❌ XIAOMA installation not found in this directory'));
-        process.exit(1);
-      }
-
-      const retentionPath = nodePath.join(xiaomaDir, '_cfg', 'user-retained-files.yaml');
-
-      // Handle list-retained option
-      if (options.listRetained) {
-        if (await fs.pathExists(retentionPath)) {
-          const retentionContent = await fs.readFile(retentionPath, 'utf8');
-          const retentionData = yaml.load(retentionContent) || { retainedFiles: [] };
-
-          if (retentionData.retainedFiles.length > 0) {
-            console.log(chalk.cyan('\n📋 Retained Files:\n'));
-            for (const file of retentionData.retainedFiles) {
-              console.log(chalk.dim(`  - ${file}`));
-            }
-            console.log();
-          } else {
-            console.log(chalk.yellow('\n✨ No retained files found\n'));
-          }
-        } else {
-          console.log(chalk.yellow('\n✨ No retained files found\n'));
-        }
-
-        return;
-      }
-
-      // Handle clear-retained option
-      if (options.clearRetained) {
-        if (await fs.pathExists(retentionPath)) {
-          await fs.remove(retentionPath);
-          console.log(chalk.green('\n✅ Cleared retained files list\n'));
-        } else {
-          console.log(chalk.yellow('\n✨ No retained files list to clear\n'));
-        }
-
-        return;
-      }
-
-      // Handle cleanup operations
-      if (options.dryRun) {
-        console.log(chalk.cyan('\n🔍 Legacy File Scan (Dry Run)\n'));
-
-        const legacyFiles = await installer.scanForLegacyFiles(xiaomaDir);
-        const allLegacyFiles = [
-          ...legacyFiles.backup,
-          ...legacyFiles.documentation,
-          ...legacyFiles.deprecated_task,
-          ...legacyFiles.unknown,
-        ];
-
-        if (allLegacyFiles.length === 0) {
-          console.log(chalk.green('✨ No legacy files found\n'));
-          return;
-        }
-
-        // Group files by category
-        const categories = [];
-        if (legacyFiles.backup.length > 0) {
-          categories.push({ name: 'Backup Files (.bak)', files: legacyFiles.backup });
-        }
-        if (legacyFiles.documentation.length > 0) {
-          categories.push({ name: 'Documentation', files: legacyFiles.documentation });
-        }
-        if (legacyFiles.deprecated_task.length > 0) {
-          categories.push({ name: 'Deprecated Task Files', files: legacyFiles.deprecated_task });
-        }
-        if (legacyFiles.unknown.length > 0) {
-          categories.push({ name: 'Unknown Files', files: legacyFiles.unknown });
-        }
-
-        for (const category of categories) {
-          console.log(chalk.yellow(`${category.name}:`));
-          for (const file of category.files) {
-            const size = (file.size / 1024).toFixed(1);
-            const date = file.mtime.toLocaleDateString();
-            let line = `  - ${file.relativePath} (${size}KB, ${date})`;
-            if (file.suggestedAlternative) {
-              line += chalk.dim(` → ${file.suggestedAlternative}`);
-            }
-            console.log(chalk.dim(line));
-          }
-          console.log();
-        }
-
-        console.log(chalk.cyan(`Found ${allLegacyFiles.length} legacy file(s) that could be cleaned up.\n`));
-        console.log(chalk.dim('Run "xiaoma cleanup" to actually delete these files.\n'));
-
-        return;
-      }
-
-      // Perform actual cleanup
-      console.log(chalk.cyan('\n🧹 Cleaning up legacy files...\n'));
-
-      const result = await installer.performCleanup(xiaomaDir, options.autoDelete);
-
-      if (result.message) {
-        console.log(chalk.dim(result.message));
-      } else {
-        if (result.deleted > 0) {
-          console.log(chalk.green(`✅ Deleted ${result.deleted} legacy file(s)`));
-        }
-        if (result.retained > 0) {
-          console.log(chalk.yellow(`⏭️  Retained ${result.retained} file(s)`));
-          console.log(chalk.dim('Run "xiaoma cleanup --list-retained" to see retained files\n'));
-        }
-      }
-
-      console.log();
-    } catch (error) {
-      console.error(chalk.red(`❌ Error: ${error.message}`));
-      process.exit(1);
-    }
-  },
-};

package/tools/cli/commands/list.js

@@ -1,43 +0,0 @@
-const chalk = require('chalk');
-const { Installer } = require('../installers/lib/core/installer');
-
-const installer = new Installer();
-
-module.exports = {
-  command: 'list',
-  description: 'List available modules',
-  options: [],
-  action: async () => {
-    try {
-      const { modules, customModules } = await installer.getAvailableModules();
-      console.log(chalk.cyan('\n📦 Available XIAOMA Modules:\n'));
-
-      if (modules.length === 0 && customModules.length === 0) {
-        console.log(chalk.yellow('  No modules found.\n'));
-        process.exit(0);
-      }
-
-      for (const module of modules) {
-        console.log(chalk.bold(`  ${module.id}`));
-        if (module.description) console.log(chalk.dim(`    ${module.description}`));
-        if (module.version) console.log(chalk.dim(`    Version: ${module.version}`));
-        console.log();
-      }
-
-      if (customModules.length > 0) {
-        console.log(chalk.cyan('📦 Custom Modules:\n'));
-        for (const module of customModules) {
-          console.log(chalk.bold(`  ${module.id}`));
-          if (module.description) console.log(chalk.dim(`    ${module.description}`));
-          if (module.version) console.log(chalk.dim(`    Version: ${module.version}`));
-          console.log();
-        }
-      }
-
-      process.exit(0);
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  },
-};

package/tools/cli/commands/update.js

@@ -1,28 +0,0 @@
-const chalk = require('chalk');
-const { Installer } = require('../installers/lib/core/installer');
-
-const installer = new Installer();
-
-module.exports = {
-  command: 'update',
-  description: 'Update existing XIAOMA installation',
-  options: [
-    ['-d, --directory <path>', 'Installation directory', '.'],
-    ['--force', 'Force update, overwriting modified files'],
-    ['--dry-run', 'Show what would be updated without making changes'],
-  ],
-  action: async (options) => {
-    try {
-      await installer.update({
-        directory: options.directory,
-        force: options.force,
-        dryRun: options.dryRun,
-      });
-      console.log(chalk.green('\n✨ Update complete!'));
-      process.exit(0);
-    } catch (error) {
-      console.error(chalk.red('Update failed:'), error.message);
-      process.exit(1);
-    }
-  },
-};