@zeyue0329/xiaoma-cli 1.0.49 → 6.0.0-alpha.13

package/tools/cli/commands/build.js

@@ -0,0 +1,458 @@
+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

@@ -0,0 +1,141 @@
+const chalk = require('chalk');
+const nodePath = require('node:path');
+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.findBmadDir(process.cwd());
+
+      if (!xiaomaDir) {
+        console.error(chalk.red('❌ XIAOMA installation not found'));
+        process.exit(1);
+      }
+
+      const retentionPath = nodePath.join(xiaomaDir, '_cfg', 'user-retained-files.yaml');
+
+      // Handle list-retained option
+      if (options.listRetained) {
+        const fs = require('fs-extra');
+        const yaml = require('js-yaml');
+
+        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) {
+        const fs = require('fs-extra');
+
+        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);
+    }
+  },
+};