create-byan-agent 2.7.1 → 2.7.2

package/lib/platforms/claude-code.js

@@ -0,0 +1,196 @@
+/**
+ * Claude Code Platform Support
+ * 
+ * Detects and installs MCP server config for Claude Code.
+ * Uses agent Claude for native integration via MCP protocol.
+ * 
+ * @module platforms/claude-code
+ */
+
+const path = require('path');
+const os = require('os');
+const fileUtils = require('../utils/file-utils');
+const logger = require('../utils/logger');
+
+const PLATFORM_NAME = 'Claude Code';
+const MCP_SERVER_FILENAME = 'byan-mcp-server.js';
+
+/**
+ * Get config path for current platform
+ * 
+ * @returns {string|null}
+ */
+function getConfigPath() {
+  const platform = os.platform();
+  const home = os.homedir();
+  
+  switch (platform) {
+    case 'darwin':
+      return path.join(home, 'Library/Application Support/Claude/claude_desktop_config.json');
+    case 'win32':
+      return path.join(home, 'AppData/Roaming/Claude/claude_desktop_config.json');
+    case 'linux':
+      return path.join(home, '.config/Claude/claude_desktop_config.json');
+    default:
+      return null;
+  }
+}
+
+/**
+ * Detect if Claude Code is installed
+ * 
+ * @returns {Promise<boolean>}
+ */
+async function detect() {
+  const configPath = getConfigPath();
+  if (!configPath) return false;
+  
+  return fileUtils.exists(configPath);
+}
+
+/**
+ * Install MCP server config for Claude Code
+ * 
+ * Delegates to agent Claude for native integration.
+ * Falls back to basic JSON update if agent unavailable.
+ * 
+ * @param {string} projectRoot - Project root directory
+ * @param {string[]} agents - Agent names to install
+ * @param {Object} config - Installation config
+ * @param {Object} [options] - Installation options
+ * @param {string} [options.specialist] - Specialist agent to use (e.g., 'claude')
+ * @param {boolean} [options.useAgent] - Use specialist agent if available (default: true)
+ * @returns {Promise<{success: boolean, installed: number, method: string}>}
+ */
+async function install(projectRoot, agents, config, options = {}) {
+  const configPath = getConfigPath();
+  
+  if (!configPath) {
+    throw new Error(`Unsupported platform: ${os.platform()}`);
+  }
+  
+  const useAgent = options.useAgent !== false && options.specialist === 'claude';
+  
+  if (useAgent) {
+    logger.info('Using agent Claude for native MCP integration...');
+    return await installViaCopilotAgent(projectRoot, agents, config);
+  } else {
+    logger.info('Using direct MCP configuration...');
+    return await installDirectMCP(projectRoot, agents, config);
+  }
+}
+
+/**
+ * Install via agent Claude (native integration)
+ * 
+ * @param {string} projectRoot
+ * @param {string[]} agents
+ * @param {Object} config
+ * @returns {Promise<{success: boolean, installed: number, method: string}>}
+ */
+async function installViaCopilotAgent(projectRoot, agents, config) {
+  const agentLauncher = require('../yanstaller/agent-launcher');
+  
+  // Check if native launch is available
+  if (agentLauncher.supportsNativeLaunch('claude')) {
+    logger.info('\n🚀 Launching agent Claude for MCP integration...');
+    
+    // Launch agent Claude with create-mcp-server action
+    const result = await agentLauncher.launch({
+      agent: 'claude',
+      platform: 'claude',
+      prompt: 'create-mcp-server'
+    });
+    
+    if (result.success) {
+      return {
+        success: true,
+        installed: agents.length,
+        method: 'agent-claude-native'
+      };
+    } else {
+      logger.warn(`Native launch failed: ${result.error}`);
+      logger.info('Falling back to manual instructions...');
+    }
+  }
+  
+  // Fallback: Manual instructions
+  logger.info('\n📝 To complete Claude Code integration:');
+  logger.info('   1. Run: @bmad-agent-claude');
+  logger.info('   2. Select option 1: Create MCP server for BYAN agents');
+  logger.info('   3. Follow the guided setup\n');
+  
+  return {
+    success: true,
+    installed: agents.length,
+    method: 'agent-claude-guided'
+  };
+}
+
+/**
+ * Install via direct MCP config update
+ * 
+ * @param {string} projectRoot
+ * @param {string[]} agents
+ * @param {Object} config
+ * @returns {Promise<{success: boolean, installed: number, method: string}>}
+ */
+async function installDirectMCP(projectRoot, agents, config) {
+  const configPath = getConfigPath();
+  const mcpServerPath = path.join(projectRoot, MCP_SERVER_FILENAME);
+  
+  // Check if MCP server exists
+  if (!await fileUtils.exists(mcpServerPath)) {
+    logger.warn(`MCP server not found at: ${mcpServerPath}`);
+    logger.warn('Run @bmad-agent-claude to generate MCP server first.');
+    
+    return {
+      success: false,
+      installed: 0,
+      method: 'direct-mcp-failed'
+    };
+  }
+  
+  // Backup existing config
+  const backupPath = `${configPath}.backup`;
+  await fileUtils.copy(configPath, backupPath);
+  logger.info(`Backed up config to: ${backupPath}`);
+  
+  // Read and update config
+  const existingConfig = await fileUtils.readJson(configPath);
+  existingConfig.mcpServers = existingConfig.mcpServers || {};
+  
+  existingConfig.mcpServers.byan = {
+    command: 'node',
+    args: [mcpServerPath],
+    env: {
+      PROJECT_ROOT: projectRoot
+    }
+  };
+  
+  // Write updated config
+  await fileUtils.writeJson(configPath, existingConfig, { spaces: 2 });
+  logger.info(`Updated MCP config: ${configPath}`);
+  
+  return {
+    success: true,
+    installed: agents.length,
+    method: 'direct-mcp'
+  };
+}
+
+/**
+ * Get platform installation path
+ * 
+ * @returns {string}
+ */
+function getPath() {
+  return getConfigPath() || 'unknown';
+}
+
+module.exports = {
+  name: PLATFORM_NAME,
+  detect,
+  install,
+  getPath
+};

package/lib/platforms/codex.js

@@ -0,0 +1,92 @@
+/**
+ * Codex Platform Support
+ * 
+ * Detects and installs agents for Codex.
+ * 
+ * @module platforms/codex
+ */
+
+const path = require('path');
+const fileUtils = require('../utils/file-utils');
+
+const PLATFORM_NAME = 'Codex';
+const PROMPTS_DIR = '.codex/prompts';
+
+/**
+ * Detect if Codex is configured
+ * 
+ * @returns {Promise<boolean>}
+ */
+async function detect() {
+  // Check if .codex/prompts/ directory exists
+  return fileUtils.exists(PROMPTS_DIR);
+}
+
+/**
+ * Install agents for Codex
+ * 
+ * @param {string} projectRoot - Project root directory
+ * @param {string[]} agents - Agent names to install
+ * @param {Object} config - Installation config
+ * @returns {Promise<{success: boolean, installed: number}>}
+ */
+async function install(projectRoot, agents, config) {
+  const promptsDir = path.join(projectRoot, PROMPTS_DIR);
+  await fileUtils.ensureDir(promptsDir);
+  
+  let installed = 0;
+  
+  for (const agentName of agents) {
+    await generatePrompt(promptsDir, agentName, config);
+    installed++;
+  }
+  
+  return {
+    success: true,
+    installed
+  };
+}
+
+/**
+ * Generate Codex prompt file
+ * 
+ * @param {string} promptsDir - Prompts directory path
+ * @param {string} agentName - Agent name
+ * @param {Object} config - Installation config
+ * @returns {Promise<void>}
+ */
+async function generatePrompt(promptsDir, agentName, config) {
+  const promptPath = path.join(promptsDir, `${agentName}.md`);
+  
+  const content = `# ${agentName} Agent
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/*/agents/${agentName}.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
+`;
+  
+  await fileUtils.writeFile(promptPath, content);
+}
+
+/**
+ * Get platform installation path
+ * 
+ * @returns {string}
+ */
+function getPath() {
+  return PROMPTS_DIR;
+}
+
+module.exports = {
+  name: PLATFORM_NAME,
+  detect,
+  install,
+  getPath
+};

package/lib/platforms/copilot-cli.js

@@ -0,0 +1,123 @@
+/**
+ * GitHub Copilot CLI Platform Support
+ * 
+ * Detects and installs agents for GitHub Copilot CLI.
+ * 
+ * @module platforms/copilot-cli
+ */
+
+const path = require('path');
+const fileUtils = require('../utils/file-utils');
+const yamlUtils = require('../utils/yaml-utils');
+const { execSync } = require('child_process');
+
+const PLATFORM_NAME = 'GitHub Copilot CLI';
+const STUB_DIR = '.github/agents';
+
+/**
+ * Detect if Copilot CLI is installed
+ * 
+ * With 10s timeout protection to prevent hanging.
+ * 
+ * @returns {Promise<boolean|{detected: boolean, error: string}>}
+ */
+async function detect() {
+  // Timeout promise (10 seconds)
+  const timeoutPromise = new Promise((resolve) =>
+    setTimeout(() => resolve({
+      detected: false,
+      error: 'Detection timeout after 10s'
+    }), 10000)
+  );
+
+  // Detection promise
+  const detectionPromise = (async () => {
+    try {
+      // Check if github-copilot-cli is installed
+      execSync('which github-copilot-cli', { encoding: 'utf8', stdio: 'ignore' });
+      return true;
+    } catch {
+      // Also check for .github/agents/ directory
+      return fileUtils.exists(STUB_DIR);
+    }
+  })();
+
+  // Race between detection and timeout
+  return Promise.race([detectionPromise, timeoutPromise]);
+}
+
+/**
+ * Install agents for Copilot CLI
+ * 
+ * @param {string} projectRoot - Project root directory
+ * @param {string[]} agents - Agent names to install
+ * @param {Object} config - Installation config
+ * @returns {Promise<{success: boolean, installed: number}>}
+ */
+async function install(projectRoot, agents, config) {
+  const stubsDir = path.join(projectRoot, STUB_DIR);
+  await fileUtils.ensureDir(stubsDir);
+  
+  let installed = 0;
+  
+  for (const agentName of agents) {
+    await generateStub(stubsDir, agentName, config);
+    installed++;
+  }
+  
+  return {
+    success: true,
+    installed
+  };
+}
+
+/**
+ * Generate Copilot CLI stub with YAML frontmatter
+ * 
+ * @param {string} stubsDir - Stubs directory path
+ * @param {string} agentName - Agent name
+ * @param {Object} config - Installation config
+ * @returns {Promise<void>}
+ */
+async function generateStub(stubsDir, agentName, config) {
+  const stubPath = path.join(stubsDir, `${agentName}.md`);
+  
+  const frontmatter = {
+    name: agentName,
+    description: `${agentName} agent from BYAN platform`
+  };
+  
+  const content = `---
+${yamlUtils.dump(frontmatter).trim()}
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/*/agents/${agentName}.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
+`;
+  
+  await fileUtils.writeFile(stubPath, content);
+}
+
+/**
+ * Get platform installation path
+ * 
+ * @returns {string}
+ */
+function getPath() {
+  return STUB_DIR;
+}
+
+module.exports = {
+  name: PLATFORM_NAME,
+  detect,
+  install,
+  getPath
+};

package/lib/platforms/index.js

@@ -0,0 +1,14 @@
+/**
+ * Platforms Index
+ * 
+ * Exports all platform modules.
+ * 
+ * @module platforms
+ */
+
+module.exports = {
+  'copilot-cli': require('./copilot-cli'),
+  'vscode': require('./vscode'),
+  'claude': require('./claude-code'),
+  'codex': require('./codex')
+};

package/lib/platforms/vscode.js

@@ -0,0 +1,51 @@
+/**
+ * VSCode Copilot Extension Platform Support
+ * 
+ * Detects and installs agents for VSCode Copilot Extension.
+ * Same format as Copilot CLI.
+ * 
+ * @module platforms/vscode
+ */
+
+const copilotCli = require('./copilot-cli');
+
+const PLATFORM_NAME = 'VSCode Copilot Extension';
+
+/**
+ * Detect if VSCode with Copilot extension is installed
+ * 
+ * @returns {Promise<boolean>}
+ */
+async function detect() {
+  // VSCode uses same stub format as Copilot CLI
+  return copilotCli.detect();
+}
+
+/**
+ * Install agents for VSCode
+ * 
+ * @param {string} projectRoot - Project root directory
+ * @param {string[]} agents - Agent names to install
+ * @param {Object} config - Installation config
+ * @returns {Promise<{success: boolean, installed: number}>}
+ */
+async function install(projectRoot, agents, config) {
+  // Reuse Copilot CLI installation (same format)
+  return copilotCli.install(projectRoot, agents, config);
+}
+
+/**
+ * Get platform installation path
+ * 
+ * @returns {string}
+ */
+function getPath() {
+  return copilotCli.getPath();
+}
+
+module.exports = {
+  name: PLATFORM_NAME,
+  detect,
+  install,
+  getPath
+};