@zeyue0329/xiaoma-cli 1.0.48 → 1.6.4

package/tools/cli/installers/lib/ide/platform-codes.yaml

@@ -0,0 +1,321 @@
+# XiaoMa Platform Codes Configuration
+# Central configuration for all platform/IDE codes used in the XiaoMa system
+#
+# This file defines:
+# 1. Platform metadata (name, preferred status, category, description)
+# 2. Installer configuration (target directories, templates, artifact types)
+#
+# Format:
+#   code: Platform identifier used internally
+#   name: Display name shown to users
+#   preferred: Whether this platform is shown as a recommended option on install
+#   category: Type of platform (ide, cli, tool, service)
+#   description: Brief description of the platform
+#   installer: Installation configuration (optional - omit for custom installers)
+
+platforms:
+  antigravity:
+    name: "Google Antigravity"
+    preferred: false
+    category: ide
+    description: "Google's AI development environment"
+    installer:
+      legacy_targets:
+        - .agent/workflows
+      target_dir: .agent/skills
+      template_type: antigravity
+      skill_format: true
+
+  auggie:
+    name: "Auggie"
+    preferred: false
+    category: cli
+    description: "AI development tool"
+    installer:
+      legacy_targets:
+        - .augment/commands
+      target_dir: .augment/skills
+      template_type: default
+      skill_format: true
+
+  claude-code:
+    name: "Claude Code"
+    preferred: true
+    category: cli
+    description: "Anthropic's official CLI for Claude"
+    installer:
+      legacy_targets:
+        - .claude/commands
+      target_dir: .claude/skills
+      template_type: default
+      skill_format: true
+      ancestor_conflict_check: true
+
+  cline:
+    name: "Cline"
+    preferred: false
+    category: ide
+    description: "AI coding assistant"
+    installer:
+      legacy_targets:
+        - .clinerules/workflows
+      target_dir: .cline/skills
+      template_type: default
+      skill_format: true
+
+  codex:
+    name: "Codex"
+    preferred: false
+    category: cli
+    description: "OpenAI Codex integration"
+    installer:
+      legacy_targets:
+        - .codex/prompts
+        - ~/.codex/prompts
+      target_dir: .agents/skills
+      template_type: default
+      skill_format: true
+      ancestor_conflict_check: true
+      artifact_types: [agents, workflows, tasks]
+
+  codebuddy:
+    name: "CodeBuddy"
+    preferred: false
+    category: ide
+    description: "Tencent Cloud Code Assistant - AI-powered coding companion"
+    installer:
+      legacy_targets:
+        - .codebuddy/commands
+      target_dir: .codebuddy/skills
+      template_type: default
+      skill_format: true
+
+  crush:
+    name: "Crush"
+    preferred: false
+    category: ide
+    description: "AI development assistant"
+    installer:
+      legacy_targets:
+        - .crush/commands
+      target_dir: .crush/skills
+      template_type: default
+      skill_format: true
+
+  cursor:
+    name: "Cursor"
+    preferred: true
+    category: ide
+    description: "AI-first code editor"
+    installer:
+      legacy_targets:
+        - .cursor/commands
+      target_dir: .cursor/skills
+      template_type: default
+      skill_format: true
+
+  gemini:
+    name: "Gemini CLI"
+    preferred: false
+    category: cli
+    description: "Google's CLI for Gemini"
+    installer:
+      legacy_targets:
+        - .gemini/commands
+      target_dir: .gemini/skills
+      template_type: default
+      skill_format: true
+
+  github-copilot:
+    name: "GitHub Copilot"
+    preferred: false
+    category: ide
+    description: "GitHub's AI pair programmer"
+    installer:
+      legacy_targets:
+        - .github/agents
+        - .github/prompts
+      target_dir: .github/skills
+      template_type: default
+      skill_format: true
+
+  iflow:
+    name: "iFlow"
+    preferred: false
+    category: ide
+    description: "AI workflow automation"
+    installer:
+      legacy_targets:
+        - .iflow/commands
+      target_dir: .iflow/skills
+      template_type: default
+      skill_format: true
+
+  kilo:
+    name: "KiloCoder"
+    preferred: false
+    category: ide
+    description: "AI coding platform"
+    suspended: "Kilo Code does not yet support the Agent Skills standard. Support is paused until they implement it. See https://github.com/kilocode/kilo-code/issues for updates."
+    installer:
+      legacy_targets:
+        - .kilocode/workflows
+      target_dir: .kilocode/skills
+      template_type: default
+      skill_format: true
+
+  kiro:
+    name: "Kiro"
+    preferred: false
+    category: ide
+    description: "Amazon's AI-powered IDE"
+    installer:
+      legacy_targets:
+        - .kiro/steering
+      target_dir: .kiro/skills
+      template_type: kiro
+      skill_format: true
+
+  opencode:
+    name: "OpenCode"
+    preferred: false
+    category: ide
+    description: "OpenCode terminal coding assistant"
+    installer:
+      legacy_targets:
+        - .opencode/agents
+        - .opencode/commands
+        - .opencode/agent
+        - .opencode/command
+      target_dir: .opencode/skills
+      template_type: opencode
+      skill_format: true
+      ancestor_conflict_check: true
+
+  pi:
+    name: "Pi"
+    preferred: false
+    category: cli
+    description: "Provider-agnostic terminal-native AI coding agent"
+    installer:
+      target_dir: .pi/skills
+      template_type: default
+      skill_format: true
+
+  qwen:
+    name: "QwenCoder"
+    preferred: false
+    category: ide
+    description: "Qwen AI coding assistant"
+    installer:
+      legacy_targets:
+        - .qwen/commands
+      target_dir: .qwen/skills
+      template_type: default
+      skill_format: true
+
+  roo:
+    name: "Roo Code"
+    preferred: false
+    category: ide
+    description: "Enhanced Cline fork"
+    installer:
+      legacy_targets:
+        - .roo/commands
+      target_dir: .roo/skills
+      template_type: default
+      skill_format: true
+
+  rovo-dev:
+    name: "Rovo Dev"
+    preferred: false
+    category: ide
+    description: "Atlassian's Rovo development environment"
+    installer:
+      legacy_targets:
+        - .rovodev/workflows
+      target_dir: .rovodev/skills
+      template_type: default
+      skill_format: true
+
+  trae:
+    name: "Trae"
+    preferred: false
+    category: ide
+    description: "AI coding tool"
+    installer:
+      legacy_targets:
+        - .trae/rules
+      target_dir: .trae/skills
+      template_type: default
+      skill_format: true
+
+  windsurf:
+    name: "Windsurf"
+    preferred: false
+    category: ide
+    description: "AI-powered IDE with cascade flows"
+    installer:
+      legacy_targets:
+        - .windsurf/workflows
+      target_dir: .windsurf/skills
+      template_type: windsurf
+      skill_format: true
+
+# ============================================================================
+# Installer Config Schema
+# ============================================================================
+#
+# installer:
+#   target_dir: string                    # Directory where artifacts are installed
+#   template_type: string                 # Default template type to use
+#   header_template: string (optional)    # Override for header/frontmatter template
+#   body_template: string (optional)      # Override for body/content template
+#   legacy_targets: array (optional)      # Old target dirs to clean up on reinstall (migration)
+#     - string                            # Relative path, e.g. .opencode/agent
+#   targets: array (optional)             # For multi-target installations
+#     - target_dir: string
+#       template_type: string
+#       artifact_types: [agents, workflows, tasks, tools]
+#   artifact_types: array (optional)      # Filter which artifacts to install (default: all)
+#   skip_existing: boolean (optional)     # Skip files that already exist (default: false)
+#   skill_format: boolean (optional)   # Use directory-per-skill output: <name>/SKILL.md
+#                                     # with clean frontmatter (name + description, unquoted)
+#   ancestor_conflict_check: boolean (optional) # Refuse install when ancestor dir has XiaoMa files
+#                                                # in the same target_dir (for IDEs that inherit
+#                                                # skills from parent directories)
+
+# ============================================================================
+# Platform Categories
+# ============================================================================
+
+categories:
+  ide:
+    name: "Integrated Development Environment"
+    description: "Full-featured code editors with AI assistance"
+
+  cli:
+    name: "Command Line Interface"
+    description: "Terminal-based tools"
+
+  tool:
+    name: "Development Tool"
+    description: "Standalone development utilities"
+
+  service:
+    name: "Cloud Service"
+    description: "Cloud-based development platforms"
+
+  extension:
+    name: "Editor Extension"
+    description: "Plugins for existing editors"
+
+# ============================================================================
+# Naming Conventions and Rules
+# ============================================================================
+
+conventions:
+  code_format: "lowercase-kebab-case"
+  name_format: "Title Case"
+  max_code_length: 20
+  allowed_characters: "a-z0-9-"

package/tools/cli/installers/lib/ide/qwen.js

@@ -0,0 +1,372 @@
+const path = require('node:path');
+const fs = require('fs-extra');
+const { BaseIdeSetup } = require('./_base-ide');
+const chalk = require('chalk');
+const { getAgentsFromXiaoma, getTasksFromXiaoma } = require('./shared/xiaoma-artifacts');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
+
+/**
+ * Qwen Code setup handler
+ * Creates TOML command files in .qwen/commands/XiaoMa/
+ */
+class QwenSetup extends BaseIdeSetup {
+  constructor() {
+    super('qwen', 'Qwen Code');
+    this.configDir = '.qwen';
+    this.commandsDir = 'commands';
+    this.xiaomaDir = 'xiaoma';
+  }
+
+  /**
+   * Setup Qwen Code configuration
+   * @param {string} projectDir - Project directory
+   * @param {string} xiaomaDir - XIAOMA installation directory
+   * @param {Object} options - Setup options
+   */
+  async setup(projectDir, xiaomaDir, options = {}) {
+    console.log(chalk.cyan(`Setting up ${this.name}...`));
+
+    // Create .qwen/commands/XiaoMa directory structure
+    const qwenDir = path.join(projectDir, this.configDir);
+    const commandsDir = path.join(qwenDir, this.commandsDir);
+    const xiaomaCommandsDir = path.join(commandsDir, this.xiaomaDir);
+
+    await this.ensureDir(xiaomaCommandsDir);
+
+    // Update existing settings.json if present
+    await this.updateSettings(qwenDir);
+
+    // Clean up old configuration if exists
+    await this.cleanupOldConfig(qwenDir);
+
+    // Generate agent launchers
+    const agentGen = new AgentCommandGenerator(this.xiaomaFolderName);
+    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(xiaomaDir, options.selectedModules || []);
+
+    // Get tasks, tools, and workflows (standalone only for tools/workflows)
+    const tasks = await getTasksFromXiaoma(xiaomaDir, options.selectedModules || []);
+    const tools = await this.getTools(xiaomaDir, true);
+    const workflows = await this.getWorkflows(xiaomaDir, true);
+
+    // Create directories for each module (including standalone)
+    const modules = new Set();
+    for (const item of [...agentArtifacts, ...tasks, ...tools, ...workflows]) modules.add(item.module);
+
+    for (const module of modules) {
+      await this.ensureDir(path.join(xiaomaCommandsDir, module));
+      await this.ensureDir(path.join(xiaomaCommandsDir, module, 'agents'));
+      await this.ensureDir(path.join(xiaomaCommandsDir, module, 'tasks'));
+      await this.ensureDir(path.join(xiaomaCommandsDir, module, 'tools'));
+      await this.ensureDir(path.join(xiaomaCommandsDir, module, 'workflows'));
+    }
+
+    // Create TOML files for each agent launcher
+    let agentCount = 0;
+    for (const artifact of agentArtifacts) {
+      // Convert markdown launcher content to TOML format
+      const tomlContent = this.processAgentLauncherContent(artifact.content, {
+        module: artifact.module,
+        name: artifact.name,
+      });
+
+      const targetPath = path.join(xiaomaCommandsDir, artifact.module, 'agents', `${artifact.name}.toml`);
+
+      await this.writeFile(targetPath, tomlContent);
+
+      agentCount++;
+      console.log(chalk.green(`  ✓ Added agent: /xiaoma:${artifact.module}:agents:${artifact.name}`));
+    }
+
+    // Create TOML files for each task
+    let taskCount = 0;
+    for (const task of tasks) {
+      const content = await this.readAndProcess(task.path, {
+        module: task.module,
+        name: task.name,
+      });
+
+      const targetPath = path.join(xiaomaCommandsDir, task.module, 'tasks', `${task.name}.toml`);
+
+      await this.writeFile(targetPath, content);
+
+      taskCount++;
+      console.log(chalk.green(`  ✓ Added task: /xiaoma:${task.module}:tasks:${task.name}`));
+    }
+
+    // Create TOML files for each tool
+    let toolCount = 0;
+    for (const tool of tools) {
+      const content = await this.readAndProcess(tool.path, {
+        module: tool.module,
+        name: tool.name,
+      });
+
+      const targetPath = path.join(xiaomaCommandsDir, tool.module, 'tools', `${tool.name}.toml`);
+
+      await this.writeFile(targetPath, content);
+
+      toolCount++;
+      console.log(chalk.green(`  ✓ Added tool: /xiaoma:${tool.module}:tools:${tool.name}`));
+    }
+
+    // Create TOML files for each workflow
+    let workflowCount = 0;
+    for (const workflow of workflows) {
+      const content = await this.readAndProcess(workflow.path, {
+        module: workflow.module,
+        name: workflow.name,
+      });
+
+      const targetPath = path.join(xiaomaCommandsDir, workflow.module, 'workflows', `${workflow.name}.toml`);
+
+      await this.writeFile(targetPath, content);
+
+      workflowCount++;
+      console.log(chalk.green(`  ✓ Added workflow: /xiaoma:${workflow.module}:workflows:${workflow.name}`));
+    }
+
+    console.log(chalk.green(`✓ ${this.name} configured:`));
+    console.log(chalk.dim(`  - ${agentCount} agents configured`));
+    console.log(chalk.dim(`  - ${taskCount} tasks configured`));
+    console.log(chalk.dim(`  - ${toolCount} tools configured`));
+    console.log(chalk.dim(`  - ${workflowCount} workflows configured`));
+    console.log(chalk.dim(`  - Commands directory: ${path.relative(projectDir, xiaomaCommandsDir)}`));
+
+    return {
+      success: true,
+      agents: agentCount,
+      tasks: taskCount,
+      tools: toolCount,
+      workflows: workflowCount,
+    };
+  }
+
+  /**
+   * Update settings.json to remove old agent references
+   */
+  async updateSettings(qwenDir) {
+    const fs = require('fs-extra');
+    const settingsPath = path.join(qwenDir, 'settings.json');
+
+    if (await fs.pathExists(settingsPath)) {
+      try {
+        const settingsContent = await fs.readFile(settingsPath, 'utf8');
+        const settings = JSON.parse(settingsContent);
+        let updated = false;
+
+        // Remove agent file references from contextFileName
+        if (settings.contextFileName && Array.isArray(settings.contextFileName)) {
+          const originalLength = settings.contextFileName.length;
+          settings.contextFileName = settings.contextFileName.filter(
+            (fileName) => !fileName.startsWith('agents/') && !fileName.startsWith('xiaoma-cli/'),
+          );
+
+          if (settings.contextFileName.length !== originalLength) {
+            updated = true;
+          }
+        }
+
+        if (updated) {
+          await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2));
+          console.log(chalk.green('  ✓ Updated .qwen/settings.json'));
+        }
+      } catch (error) {
+        console.warn(chalk.yellow('  ⚠ Could not update settings.json:'), error.message);
+      }
+    }
+  }
+
+  /**
+   * Clean up old configuration directories
+   */
+  async cleanupOldConfig(qwenDir) {
+    const fs = require('fs-extra');
+    const agentsDir = path.join(qwenDir, 'agents');
+    const xiaomaMethodDir = path.join(qwenDir, 'xiaoma-cli');
+    const xiaomaDir = path.join(qwenDir, 'xiaomaDir');
+
+    if (await fs.pathExists(agentsDir)) {
+      await fs.remove(agentsDir);
+      console.log(chalk.green('  ✓ Removed old agents directory'));
+    }
+
+    if (await fs.pathExists(xiaomaMethodDir)) {
+      await fs.remove(xiaomaMethodDir);
+      console.log(chalk.green('  ✓ Removed old xiaoma-cli directory'));
+    }
+
+    if (await fs.pathExists(xiaomaDir)) {
+      await fs.remove(xiaomaDir);
+      console.log(chalk.green('  ✓ Removed old XiaoMa directory'));
+    }
+  }
+
+  /**
+   * Read and process file content
+   */
+  async readAndProcess(filePath, metadata) {
+    const fs = require('fs-extra');
+    const content = await fs.readFile(filePath, 'utf8');
+    return this.processContent(content, metadata);
+  }
+
+  /**
+   * Process agent launcher content and convert to TOML format
+   * @param {string} launcherContent - Launcher markdown content
+   * @param {Object} metadata - File metadata
+   * @returns {string} TOML formatted content
+   */
+  processAgentLauncherContent(launcherContent, metadata = {}) {
+    // Strip frontmatter from launcher content
+    const frontmatterRegex = /^---\s*\n[\s\S]*?\n---\s*\n/;
+    const contentWithoutFrontmatter = launcherContent.replace(frontmatterRegex, '');
+
+    // Extract title for TOML description
+    const titleMatch = launcherContent.match(/description:\s*"([^"]+)"/);
+    const title = titleMatch ? titleMatch[1] : metadata.name;
+
+    // Create TOML with launcher content (without frontmatter)
+    return `description = "XIAOMA ${metadata.module.toUpperCase()} Agent: ${title}"
+prompt = """
+${contentWithoutFrontmatter.trim()}
+"""
+`;
+  }
+
+  /**
+   * Override processContent to add TOML metadata header for Qwen
+   * @param {string} content - File content
+   * @param {Object} metadata - File metadata
+   * @returns {string} Processed content with Qwen template
+   */
+  processContent(content, metadata = {}) {
+    // First apply base processing (includes activation injection for agents)
+    let prompt = super.processContent(content, metadata);
+
+    // Determine the type and description based on content
+    const isAgent = content.includes('<agent');
+    const isTask = content.includes('<task');
+    const isTool = content.includes('<tool');
+    const isWorkflow = content.includes('workflow:') || content.includes('name:');
+
+    let description = '';
+
+    if (isAgent) {
+      // Extract agent title if available
+      const titleMatch = content.match(/title="([^"]+)"/);
+      const title = titleMatch ? titleMatch[1] : metadata.name;
+      description = `XIAOMA ${metadata.module.toUpperCase()} Agent: ${title}`;
+    } else if (isTask) {
+      // Extract task name if available
+      const nameMatch = content.match(/name="([^"]+)"/);
+      const taskName = nameMatch ? nameMatch[1] : metadata.name;
+      description = `XIAOMA ${metadata.module.toUpperCase()} Task: ${taskName}`;
+    } else if (isTool) {
+      // Extract tool name if available
+      const nameMatch = content.match(/name="([^"]+)"/);
+      const toolName = nameMatch ? nameMatch[1] : metadata.name;
+      description = `XIAOMA ${metadata.module.toUpperCase()} Tool: ${toolName}`;
+    } else if (isWorkflow) {
+      // Workflow
+      description = `XIAOMA ${metadata.module.toUpperCase()} Workflow: ${metadata.name}`;
+    } else {
+      description = `XIAOMA ${metadata.module.toUpperCase()}: ${metadata.name}`;
+    }
+
+    return `description = "${description}"
+prompt = """
+${prompt}
+"""
+`;
+  }
+
+  /**
+   * Format name as title
+   */
+  formatTitle(name) {
+    return name
+      .split('-')
+      .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+      .join(' ');
+  }
+
+  /**
+   * Cleanup Qwen configuration
+   */
+  async cleanup(projectDir) {
+    const fs = require('fs-extra');
+    const xiaomaCommandsDir = path.join(projectDir, this.configDir, this.commandsDir, this.xiaomaDir);
+    const oldXiaomaMethodDir = path.join(projectDir, this.configDir, 'xiaoma-cli');
+    const oldXiaoMaDir = path.join(projectDir, this.configDir, 'XiaoMa');
+
+    if (await fs.pathExists(xiaomaCommandsDir)) {
+      await fs.remove(xiaomaCommandsDir);
+      console.log(chalk.dim(`Removed XIAOMA configuration from Qwen Code`));
+    }
+
+    if (await fs.pathExists(oldXiaomaMethodDir)) {
+      await fs.remove(oldXiaomaMethodDir);
+      console.log(chalk.dim(`Removed old XIAOMA configuration from Qwen Code`));
+    }
+
+    if (await fs.pathExists(oldXiaoMaDir)) {
+      await fs.remove(oldXiaoMaDir);
+      console.log(chalk.dim(`Removed old XIAOMA configuration from Qwen Code`));
+    }
+  }
+
+  /**
+   * Install a custom agent launcher for Qwen
+   * @param {string} projectDir - Project directory
+   * @param {string} agentName - Agent name (e.g., "fred-commit-poet")
+   * @param {string} agentPath - Path to compiled agent (relative to project root)
+   * @param {Object} metadata - Agent metadata
+   * @returns {Object} Installation result
+   */
+  async installCustomAgentLauncher(projectDir, agentName, agentPath, metadata) {
+    const qwenDir = path.join(projectDir, this.configDir);
+    const commandsDir = path.join(qwenDir, this.commandsDir);
+    const xiaomaCommandsDir = path.join(commandsDir, this.xiaomaDir);
+
+    // Create .qwen/commands/XiaoMa directory if it doesn't exist
+    await fs.ensureDir(xiaomaCommandsDir);
+
+    // Create custom agent launcher in TOML format (same pattern as regular agents)
+    const launcherContent = `# ${agentName} Custom Agent
+
+**⚠️ IMPORTANT**: Run @${agentPath} first to load the complete agent!
+
+This is a launcher for the custom XIAOMA agent "${agentName}".
+
+## Usage
+1. First run: \`${agentPath}\` to load the complete agent
+2. Then use this command to activate ${agentName}
+
+The agent will follow the persona and instructions from the main agent file.
+
+---
+
+*Generated by XIAOMA Method*`;
+
+    // Use Qwen's TOML conversion method
+    const tomlContent = this.processAgentLauncherContent(launcherContent, {
+      name: agentName,
+      module: 'custom',
+    });
+
+    const fileName = `custom-${agentName.toLowerCase()}.toml`;
+    const launcherPath = path.join(xiaomaCommandsDir, fileName);
+
+    // Write the launcher file
+    await fs.writeFile(launcherPath, tomlContent, 'utf8');
+
+    return {
+      ide: 'qwen',
+      path: path.relative(projectDir, launcherPath),
+      command: agentName,
+      type: 'custom-agent-launcher',
+    };
+  }
+}
+
+module.exports = { QwenSetup };