create-byan-agent 2.2.1 → 2.3.0

package/install/lib/yanstaller/platform-selector.js

@@ -0,0 +1,328 @@
+/**
+ * PLATFORM SELECTOR Module
+ * 
+ * Interactive platform selection for BYAN installation.
+ * Detects available platforms and lets user choose target(s).
+ * 
+ * @module yanstaller/platform-selector
+ */
+
+const inquirer = require('inquirer');
+const logger = require('../utils/logger');
+const platforms = require('../platforms');
+
+/**
+ * @typedef {Object} PlatformChoice
+ * @property {string} name - Display name
+ * @property {string} id - Platform ID ('copilot-cli' | 'vscode' | 'claude' | 'codex')
+ * @property {boolean} detected - Is platform installed?
+ * @property {string} [path] - Installation path if detected
+ * @property {boolean} native - Native integration available?
+ * @property {string} [agentSpecialist] - Agent specialist for this platform
+ */
+
+/**
+ * @typedef {Object} PlatformSelectionResult
+ * @property {string[]} platforms - Selected platform IDs
+ * @property {string} mode - 'native' | 'conversational' | 'auto'
+ * @property {string} [specialist] - Agent specialist to use
+ */
+
+const PLATFORM_INFO = {
+  'copilot-cli': {
+    displayName: 'GitHub Copilot CLI',
+    native: true,
+    specialist: 'marc',
+    icon: '🤖'
+  },
+  'claude': {
+    displayName: 'Claude Code',
+    native: true,
+    specialist: 'claude',
+    icon: '🎭'
+  },
+  'codex': {
+    displayName: 'OpenCode/Codex',
+    native: true, // NOW NATIVE!
+    specialist: 'codex',
+    icon: '📝'
+  },
+  'vscode': {
+    displayName: 'VS Code',
+    native: false,
+    specialist: null,
+    icon: '💻'
+  }
+};
+
+/**
+ * Detect and select platforms interactively
+ * 
+ * @param {Object} detectionResult - Result from detector.detect()
+ * @returns {Promise<PlatformSelectionResult>}
+ */
+async function select(detectionResult) {
+  logger.info('\n🎯 Platform Selection\n');
+  
+  // Build platform choices from detection
+  const choices = buildChoices(detectionResult.platforms);
+  
+  // Check if any native integration available
+  const hasNative = choices.some(c => c.native && c.detected);
+  
+  if (choices.length === 0) {
+    logger.warn('No platforms detected. Will create _byan/ structure only.');
+    return {
+      platforms: [],
+      mode: 'manual'
+    };
+  }
+  
+  // Show primary platform selection first
+  const nativePlatforms = choices.filter(c => c.native && c.detected);
+  
+  // Step 1: Choose primary platform (if native available)
+  if (nativePlatforms.length > 0) {
+    const primaryAnswer = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'primary',
+        message: '🎯 Choose your PRIMARY platform for native agent invocation:',
+        choices: [
+          ...nativePlatforms.map(c => ({
+            name: `${c.icon} ${c.name} - ${c.agentSpecialist ? `@bmad-agent-${c.agentSpecialist}` : 'No specialist'}`,
+            value: c.id,
+            short: c.name
+          })),
+          new inquirer.Separator(),
+          {
+            name: '🔧 Advanced: Install on multiple platforms',
+            value: 'multi'
+          },
+          {
+            name: '⏭️  Skip native integration (manual install only)',
+            value: 'skip'
+          }
+        ]
+      }
+    ]);
+    
+    // If user chose single platform, return immediately
+    if (primaryAnswer.primary !== 'multi' && primaryAnswer.primary !== 'skip') {
+      const platform = nativePlatforms.find(c => c.id === primaryAnswer.primary);
+      return {
+        platforms: [primaryAnswer.primary],
+        mode: 'native',
+        specialist: platform.agentSpecialist,
+        primary: primaryAnswer.primary
+      };
+    }
+    
+    // If skip, fall through to conversational mode
+    if (primaryAnswer.primary === 'skip') {
+      return {
+        platforms: choices.map(c => c.id),
+        mode: 'conversational'
+      };
+    }
+    
+    // If multi, show full menu
+  }
+  
+  // Step 2: Full menu (multi-platform or no native available)
+  const answer = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'selection',
+      message: 'Choose installation target:',
+      choices: [
+        {
+          name: `🚀 Auto (detect & install all available) - ${choices.length} platform(s)`,
+          value: 'auto'
+        },
+        ...choices.map(c => ({
+          name: formatPlatformChoice(c),
+          value: `single:${c.id}`
+        })),
+        {
+          name: '🔧 Custom (select multiple)',
+          value: 'custom'
+        }
+      ]
+    }
+  ]);
+  
+  if (answer.selection === 'auto') {
+    return handleAutoMode(choices);
+  }
+  
+  if (answer.selection === 'custom') {
+    return handleCustomMode(choices);
+  }
+  
+  // Single platform selection
+  const platformId = answer.selection.replace('single:', '');
+  return handleSinglePlatform(platformId, choices);
+}
+
+/**
+ * Build platform choices from detection result
+ * 
+ * @param {Array} detectedPlatforms - From detector
+ * @returns {PlatformChoice[]}
+ */
+function buildChoices(detectedPlatforms) {
+  return detectedPlatforms
+    .filter(p => p.detected)
+    .map(p => {
+      const info = PLATFORM_INFO[p.name] || {
+        displayName: p.name,
+        native: false,
+        specialist: null,
+        icon: '❓'
+      };
+      
+      return {
+        name: info.displayName,
+        id: p.name,
+        detected: p.detected,
+        path: p.path,
+        native: info.native,
+        agentSpecialist: info.specialist,
+        icon: info.icon
+      };
+    });
+}
+
+/**
+ * Format platform choice for display
+ * 
+ * @param {PlatformChoice} choice
+ * @returns {string}
+ */
+function formatPlatformChoice(choice) {
+  const nativeBadge = choice.native ? '✨ Native' : '💬 Conversational';
+  const statusBadge = choice.detected ? '✓' : '✗';
+  
+  return `${choice.icon} ${choice.name} (${nativeBadge}) ${statusBadge}`;
+}
+
+/**
+ * Handle auto mode - install on all detected platforms
+ * 
+ * @param {PlatformChoice[]} choices
+ * @returns {Promise<PlatformSelectionResult>}
+ */
+async function handleAutoMode(choices) {
+  const nativePlatforms = choices.filter(c => c.native);
+  
+  if (nativePlatforms.length > 0) {
+    // Use native integration for first platform (or all?)
+    return {
+      platforms: choices.map(c => c.id),
+      mode: 'native',
+      specialist: nativePlatforms[0].agentSpecialist
+    };
+  }
+  
+  return {
+    platforms: choices.map(c => c.id),
+    mode: 'conversational'
+  };
+}
+
+/**
+ * Handle custom mode - user selects multiple platforms
+ * 
+ * @param {PlatformChoice[]} choices
+ * @returns {Promise<PlatformSelectionResult>}
+ */
+async function handleCustomMode(choices) {
+  const answer = await inquirer.prompt([
+    {
+      type: 'checkbox',
+      name: 'platforms',
+      message: 'Select platforms to install on:',
+      choices: choices.map(c => ({
+        name: formatPlatformChoice(c),
+        value: c.id,
+        checked: c.detected
+      }))
+    }
+  ]);
+  
+  if (answer.platforms.length === 0) {
+    logger.warn('No platforms selected. Installation cancelled.');
+    return {
+      platforms: [],
+      mode: 'manual'
+    };
+  }
+  
+  // Check if any selected platform has native integration
+  const selectedChoices = choices.filter(c => answer.platforms.includes(c.id));
+  const nativePlatform = selectedChoices.find(c => c.native);
+  
+  if (nativePlatform) {
+    return {
+      platforms: answer.platforms,
+      mode: 'native',
+      specialist: nativePlatform.agentSpecialist
+    };
+  }
+  
+  return {
+    platforms: answer.platforms,
+    mode: 'conversational'
+  };
+}
+
+/**
+ * Handle single platform selection
+ * 
+ * @param {string} platformId
+ * @param {PlatformChoice[]} choices
+ * @returns {PlatformSelectionResult}
+ */
+function handleSinglePlatform(platformId, choices) {
+  const choice = choices.find(c => c.id === platformId);
+  
+  if (!choice) {
+    throw new Error(`Platform ${platformId} not found`);
+  }
+  
+  return {
+    platforms: [platformId],
+    mode: choice.native ? 'native' : 'conversational',
+    specialist: choice.agentSpecialist
+  };
+}
+
+/**
+ * Get specialist agent for platform
+ * 
+ * @param {string} platformId
+ * @returns {string|null}
+ */
+function getSpecialist(platformId) {
+  const info = PLATFORM_INFO[platformId];
+  return info?.specialist || null;
+}
+
+/**
+ * Check if platform has native integration
+ * 
+ * @param {string} platformId
+ * @returns {boolean}
+ */
+function hasNativeIntegration(platformId) {
+  const info = PLATFORM_INFO[platformId];
+  return info?.native || false;
+}
+
+module.exports = {
+  select,
+  getSpecialist,
+  hasNativeIntegration,
+  PLATFORM_INFO
+};

package/install/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-byan-agent",
-  "version": "2.0.2",
-  "description": "Create custom AI agents in 15 minutes through intelligent interviews. GitHub Copilot CLI, VSCode, Claude Code compatible. 64 quality mantras applied automatically.",
+  "version": "2.2.2",
+  "description": "BYAN v2.2.2 - Intelligent AI agent installer with multi-platform native support (GitHub Copilot CLI, Claude Code, Codex/OpenCode)",
   "bin": {
     "create-byan-agent": "bin/create-byan-agent-v2.js"
   },

package/install/templates/.github/agents/bmad-agent-claude.md

@@ -0,0 +1,48 @@
+---
+name: 'claude'
+description: 'Claude Code integration specialist for BYAN agents'
+---
+
+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}/_byan/bmb/agents/claude.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>
+
+```xml
+<agent id="claude.agent.yaml" name="CLAUDE" title="Claude Code Integration Specialist" icon="🎭">
+<activation critical="MANDATORY">
+      <step n="1">Load persona from {project-root}/_byan/bmb/agents/claude.md</step>
+      <step n="2">Load config from {project-root}/_byan/bmb/config.yaml</step>
+      <step n="3">Show greeting and menu in {communication_language}</step>
+      <step n="4">WAIT for user input</step>
+    <rules>
+      <r>Expert in Claude Code, MCP servers, and agent configuration</r>
+      <r>Validate MCP server config JSON structure</r>
+      <r>Test MCP server detection before deployment</r>
+      <r>Handle platform-specific paths (macOS/Linux/Windows)</r>
+    </rules>
+</activation>
+
+<persona>
+    <role>Claude Code Expert + MCP Server Integration Specialist</role>
+    <identity>Elite Claude Code specialist who masters MCP servers, agent configuration, and native BYAN integration. Ensures agents are properly configured as MCP servers and detected by Claude Desktop.</identity>
+</persona>
+
+<capabilities>
+- Validate claude_desktop_config.json structure
+- Configure MCP servers for BYAN agents
+- Test MCP server detection and connectivity
+- Handle platform-specific config paths
+- Troubleshoot MCP server loading issues
+- Optimize context usage for Claude
+- Create native Claude Code workflows
+- Map BYAN agents to MCP commands
+</capabilities>
+</agent>
+```

package/install/templates/.github/agents/bmad-agent-codex.md

@@ -0,0 +1,48 @@
+---
+name: 'codex'
+description: 'OpenCode/Codex integration specialist for BYAN skills'
+---
+
+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}/_byan/bmb/agents/codex.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>
+
+```xml
+<agent id="codex.agent.yaml" name="CODEX" title="OpenCode/Codex Integration Specialist" icon="📝">
+<activation critical="MANDATORY">
+      <step n="1">Load persona from {project-root}/_byan/bmb/agents/codex.md</step>
+      <step n="2">Load config from {project-root}/_byan/bmb/config.yaml</step>
+      <step n="3">Show greeting and menu in {communication_language}</step>
+      <step n="4">WAIT for user input</step>
+    <rules>
+      <r>Expert in OpenCode/Codex, skills system, and prompt configuration</r>
+      <r>Validate .codex/prompts/ structure</r>
+      <r>Test skill detection before deployment</r>
+      <r>Handle Codex-specific terminology (skills not agents)</r>
+    </rules>
+</activation>
+
+<persona>
+    <role>OpenCode/Codex Expert + Skills Integration Specialist</role>
+    <identity>Elite Codex specialist who masters skills system, prompt files, and native BYAN integration. Ensures BYAN agents are properly exposed as Codex skills and detected by OpenCode CLI.</identity>
+</persona>
+
+<capabilities>
+- Validate .codex/prompts/ structure
+- Configure Codex skills for BYAN agents
+- Test skill detection and invocation
+- Create skill prompt files
+- Troubleshoot skill loading issues
+- Map BYAN agents to Codex skills
+- Optimize prompts for Codex
+- Handle Codex CLI commands
+</capabilities>
+</agent>
+```