create-byan-agent 1.1.3 → 1.2.1

package/lib/yanstaller/index.js

@@ -0,0 +1,93 @@
+/**
+ * YANSTALLER - Main Orchestrator
+ * 
+ * Coordinates all YANSTALLER modules to perform intelligent BYAN installation.
+ * 
+ * @module yanstaller
+ */
+
+const detector = require('./detector');
+const recommender = require('./recommender');
+const installer = require('./installer');
+const validator = require('./validator');
+const troubleshooter = require('./troubleshooter');
+const interviewer = require('./interviewer');
+const backuper = require('./backuper');
+const wizard = require('./wizard');
+const logger = require('../utils/logger');
+
+/**
+ * @typedef {Object} YanInstallerOptions
+ * @property {boolean} [yes] - Skip confirmations (--yes flag)
+ * @property {string} [mode] - Installation mode: 'full' | 'minimal' | 'custom'
+ * @property {boolean} [verbose] - Verbose output
+ * @property {boolean} [quiet] - Minimal output
+ */
+
+/**
+ * Main installation flow
+ * 
+ * @param {YanInstallerOptions} [options={}] - Installation options
+ * @returns {Promise<void>}
+ */
+async function install(options = {}) {
+  let backupPath = null;
+  
+  try {
+    // TODO: Implement Phase 1-8 orchestration
+    // 1. Detect environment
+    // 2. Validate Node version (FAIL FAST)
+    // 3. Recommend configuration
+    // 4. Run interview (unless --yes)
+    // 5. Backup existing installation
+    // backupPath = await backuper.backup('_bmad');
+    // 6. Install agents
+    // 7. Validate installation
+    // 8. Show post-install wizard
+  } catch (error) {
+    // ROLLBACK STRATEGY: Leave partial state + clear message
+    // Rationale (Mantra #37 Ockham's Razor):
+    // - Installation = mostly file copies (low risk)
+    // - User can re-run (idempotent)
+    // - Backup exists for manual restore
+    // - Auto-rollback risks losing working partial install
+    
+    logger.error('Installation failed:', error.message);
+    
+    if (backupPath) {
+      logger.info('\nPartial installation completed.');
+      logger.info(`Backup available at: ${backupPath}`);
+      logger.info('\nOptions:');
+      logger.info('1. Re-run: npx create-byan-agent');
+      logger.info(`2. Restore backup: yanstaller restore ${backupPath}`);
+      logger.info('3. Troubleshoot: yanstaller doctor');
+    }
+    
+    throw error; // Re-throw for exit code handling
+  }
+}
+
+/**
+ * Uninstall BYAN
+ * 
+ * @returns {Promise<void>}
+ */
+async function uninstall() {
+  // TODO: Remove _bmad/, .github/agents/ stubs
+}
+
+/**
+ * Update existing BYAN installation
+ * 
+ * @param {string} version - Target version
+ * @returns {Promise<void>}
+ */
+async function update(version) {
+  // TODO: Backup → Update agents → Merge configs
+}
+
+module.exports = {
+  install,
+  uninstall,
+  update
+};

package/lib/yanstaller/installer.js

@@ -0,0 +1,225 @@
+/**
+ * INSTALLER Module
+ * 
+ * Installs BYAN agents across multiple platforms.
+ * Most complex module: 56h development.
+ * 
+ * Phase 3: 56h development
+ * 
+ * @module yanstaller/installer
+ */
+
+const path = require('path');
+const fileUtils = require('../utils/file-utils');
+const logger = require('../utils/logger');
+
+/**
+ * @typedef {Object} InstallConfig
+ * @property {string} mode - 'full' | 'minimal' | 'custom'
+ * @property {string[]} agents - Agent names to install
+ * @property {string} userName - User's name
+ * @property {string} language - 'Francais' | 'English'
+ * @property {string[]} targetPlatforms - Platforms to install on
+ * @property {string} outputFolder - Output folder path
+ * @property {string} projectRoot - Project root directory
+ */
+
+/**
+ * @typedef {Object} InstallResult
+ * @property {boolean} success
+ * @property {number} agentsInstalled - Number of agents installed
+ * @property {string[]} platforms - Platforms installed on
+ * @property {string[]} errors - Installation errors
+ * @property {number} duration - Duration in ms
+ */
+
+/**
+ * Install BYAN agents
+ * 
+ * @param {InstallConfig} config - Installation configuration
+ * @returns {Promise<InstallResult>}
+ */
+async function install(config) {
+  const startTime = Date.now();
+  const errors = [];
+  let agentsInstalled = 0;
+  
+  try {
+    logger.info(`Installing ${config.agents.length} agents in ${config.mode} mode...`);
+    
+    // 1. Create _bmad/ structure
+    logger.info('Creating _bmad/ directory structure...');
+    await createBmadStructure(config.projectRoot);
+    
+    // 2. Copy agent files from templates/
+    logger.info('Copying agent files...');
+    for (const agentName of config.agents) {
+      try {
+        await copyAgentFile(agentName, config.projectRoot);
+        agentsInstalled++;
+        logger.info(`  ✓ ${agentName}`);
+      } catch (error) {
+        errors.push(`Failed to install ${agentName}: ${error.message}`);
+        logger.warn(`  ✗ ${agentName} - ${error.message}`);
+      }
+    }
+    
+    // 3. Generate platform-specific stubs
+    logger.info('Generating platform stubs...');
+    for (const platform of config.targetPlatforms) {
+      try {
+        await generatePlatformStubs(platform, config);
+        logger.info(`  ✓ ${platform}`);
+      } catch (error) {
+        errors.push(`Failed to generate ${platform} stubs: ${error.message}`);
+        logger.warn(`  ✗ ${platform} - ${error.message}`);
+      }
+    }
+    
+    // 4. Create config files
+    logger.info('Creating configuration files...');
+    await createModuleConfig('bmb', config, config.projectRoot);
+    
+    const success = errors.length === 0;
+    
+    return {
+      success,
+      agentsInstalled,
+      platforms: config.targetPlatforms,
+      errors,
+      duration: Date.now() - startTime
+    };
+  } catch (error) {
+    errors.push(error.message);
+    return {
+      success: false,
+      agentsInstalled,
+      platforms: [],
+      errors,
+      duration: Date.now() - startTime
+    };
+  }
+}
+
+/**
+ * Create _bmad/ directory structure
+ * 
+ * @param {string} projectRoot - Project root directory
+ * @returns {Promise<void>}
+ */
+async function createBmadStructure(projectRoot) {
+  const directories = [
+    '_bmad',
+    '_bmad/_config',
+    '_bmad/_memory',
+    '_bmad/_output',
+    '_bmad/core',
+    '_bmad/core/agents',
+    '_bmad/core/workflows',
+    '_bmad/bmm',
+    '_bmad/bmm/agents',
+    '_bmad/bmm/workflows',
+    '_bmad/bmb',
+    '_bmad/bmb/agents',
+    '_bmad/bmb/workflows',
+    '_bmad/tea',
+    '_bmad/tea/agents',
+    '_bmad/tea/workflows',
+    '_bmad/cis',
+    '_bmad/cis/agents',
+    '_bmad/cis/workflows'
+  ];
+  
+  for (const dir of directories) {
+    const dirPath = path.join(projectRoot, dir);
+    await fileUtils.ensureDir(dirPath);
+  }
+}
+
+/**
+ * Copy agent file from template
+ * 
+ * @param {string} agentName - Agent name
+ * @param {string} projectRoot - Project root directory
+ * @returns {Promise<void>}
+ */
+async function copyAgentFile(agentName, projectRoot) {
+  // Template base path
+  const templateBase = path.join(__dirname, '../../templates/_bmad');
+  
+  // Search for agent in all modules
+  const modules = ['core', 'bmm', 'bmb', 'tea', 'cis'];
+  
+  for (const module of modules) {
+    const sourceFile = path.join(templateBase, module, 'agents', `${agentName}.md`);
+    
+    if (await fileUtils.exists(sourceFile)) {
+      const targetFile = path.join(projectRoot, '_bmad', module, 'agents', `${agentName}.md`);
+      await fileUtils.copy(sourceFile, targetFile);
+      return;
+    }
+  }
+  
+  throw new Error(`Agent template not found: ${agentName}`);
+}
+
+/**
+ * Generate platform stubs for all agents
+ * 
+ * @param {string} platform - Platform name ('copilot-cli' | 'vscode' | 'claude' | 'codex')
+ * @param {InstallConfig} config - Installation config
+ * @returns {Promise<void>}
+ */
+async function generatePlatformStubs(platform, config) {
+  const platformModule = require(`../platforms/${platform}`);
+  
+  if (!platformModule || typeof platformModule.install !== 'function') {
+    throw new Error(`Platform module not found or invalid: ${platform}`);
+  }
+  
+  await platformModule.install(config.projectRoot, config.agents, config);
+}
+
+/**
+ * Create module config file
+ * 
+ * @param {string} moduleName - Module name (core, bmm, bmb, tea, cis)
+ * @param {InstallConfig} config - Installation config
+ * @param {string} projectRoot - Project root directory
+ * @returns {Promise<void>}
+ */
+async function createModuleConfig(moduleName, config, projectRoot) {
+  const yaml = require('js-yaml');
+  
+  const configContent = {
+    user_name: config.userName,
+    communication_language: config.language,
+    document_output_language: config.language,
+    output_folder: config.outputFolder || '{project-root}/_bmad-output',
+    
+    // Installation metadata
+    installed_by: 'yanstaller',
+    installed_at: new Date().toISOString(),
+    version: '1.2.0',
+    mode: config.mode,
+    agents_installed: config.agents
+  };
+  
+  // Add module-specific settings
+  if (moduleName === 'bmb') {
+    configContent.bmb_creations_output_folder = '{project-root}/_bmad-output/bmb-creations';
+  }
+  
+  const configPath = path.join(projectRoot, '_bmad', moduleName, 'config.yaml');
+  const yamlContent = yaml.dump(configContent, { indent: 2 });
+  
+  await fileUtils.writeFile(configPath, yamlContent);
+}
+
+module.exports = {
+  install,
+  createBmadStructure,
+  copyAgentFile,
+  generatePlatformStubs,
+  createModuleConfig
+};

package/lib/yanstaller/interviewer.js

@@ -0,0 +1,250 @@
+/**
+ * INTERVIEWER Module
+ * 
+ * Conducts quick interview (5-7 questions, <5 min) to personalize installation.
+ * 
+ * Phase 7: 16h development
+ * 
+ * @module yanstaller/interviewer
+ */
+
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const logger = require('../utils/logger');
+
+/**
+ * @typedef {Object} InterviewResult
+ * @property {string} userName
+ * @property {string} language - 'Francais' | 'English'
+ * @property {string} mode - 'full' | 'minimal' | 'custom'
+ * @property {string[]} agents - Selected agents (if custom mode)
+ * @property {string[]} targetPlatforms - Platforms to install on
+ * @property {boolean} createSampleAgent - Whether to create sample agent after install
+ */
+
+/**
+ * Run quick interview
+ * 
+ * @param {import('./recommender').Recommendation} recommendation - Recommended config
+ * @returns {Promise<InterviewResult>}
+ */
+async function ask(recommendation) {
+  logger.info(chalk.bold('\n🎙️  YANSTALLER Quick Interview\n'));
+  logger.info('Just 5-7 questions to personalize your BYAN installation (<5 min)\n');
+  
+  // Q1: Your name
+  const nameAnswer = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'userName',
+      message: 'What\'s your name?',
+      default: 'Developer',
+      validate: (input) => input.trim().length > 0 || 'Name cannot be empty'
+    }
+  ]);
+  
+  // Q2: Preferred language
+  const langAnswer = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'language',
+      message: 'Preferred communication language?',
+      choices: [
+        { name: 'English', value: 'English' },
+        { name: 'Français', value: 'Francais' }
+      ],
+      default: 'English'
+    }
+  ]);
+  
+  // Q3: Installation mode (with recommendation)
+  const recommendedMode = recommendation ? recommendation.mode : 'recommended';
+  const modeChoices = [
+    {
+      name: `Recommended - Based on your project (${recommendation ? recommendation.agents.length : 7} agents)`,
+      value: 'recommended',
+      description: 'Best for most users'
+    },
+    {
+      name: 'Minimal - Essential agents only (4 agents)',
+      value: 'minimal',
+      description: 'Fastest installation'
+    },
+    {
+      name: 'Full - All 29 agents',
+      value: 'full',
+      description: 'Complete BMAD platform'
+    },
+    {
+      name: 'Custom - Choose specific agents',
+      value: 'custom',
+      description: 'Advanced users'
+    }
+  ];
+  
+  const modeAnswer = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'mode',
+      message: 'Installation mode?',
+      choices: modeChoices,
+      default: recommendedMode
+    }
+  ]);
+  
+  // Q4: Agent selection (if custom mode)
+  let selectedAgents = [];
+  if (modeAnswer.mode === 'custom') {
+    const agentAnswer = await inquirer.prompt([
+      {
+        type: 'checkbox',
+        name: 'agents',
+        message: 'Select agents to install:',
+        choices: getAgentChoices(),
+        pageSize: 15,
+        validate: (input) => input.length > 0 || 'Select at least one agent'
+      }
+    ]);
+    selectedAgents = agentAnswer.agents;
+  } else if (modeAnswer.mode === 'recommended' && recommendation) {
+    selectedAgents = recommendation.agents;
+  } else if (modeAnswer.mode === 'minimal') {
+    selectedAgents = ['byan', 'rachid', 'dev', 'tech-writer'];
+  } else if (modeAnswer.mode === 'full') {
+    selectedAgents = getAllAgents();
+  }
+  
+  // Q5: Target platforms
+  const platformAnswer = await inquirer.prompt([
+    {
+      type: 'checkbox',
+      name: 'platforms',
+      message: 'Which platforms to install on?',
+      choices: [
+        { name: 'GitHub Copilot CLI (.github/agents/)', value: 'copilot-cli', checked: true },
+        { name: 'VSCode Copilot Extension', value: 'vscode', checked: true },
+        { name: 'Codex (.codex/prompts/)', value: 'codex', checked: false },
+        { name: 'Claude Code (MCP server)', value: 'claude-code', checked: false }
+      ],
+      validate: (input) => input.length > 0 || 'Select at least one platform'
+    }
+  ]);
+  
+  // Q6: Create sample agent
+  const sampleAnswer = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'createSample',
+      message: 'Launch BYAN agent creator after installation?',
+      default: false
+    }
+  ]);
+  
+  // Q7: Create backup (optional)
+  const backupAnswer = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'createBackup',
+      message: 'Create backup of existing _bmad/ directory? (if exists)',
+      default: true
+    }
+  ]);
+  
+  logger.info('');
+  
+  return {
+    userName: nameAnswer.userName,
+    language: langAnswer.language,
+    mode: modeAnswer.mode,
+    agents: selectedAgents,
+    targetPlatforms: platformAnswer.platforms,
+    createSampleAgent: sampleAnswer.createSample,
+    createBackup: backupAnswer.createBackup
+  };
+}
+
+/**
+ * Ask single question
+ * 
+ * @param {string} question - Question text
+ * @param {string} type - 'input' | 'list' | 'confirm' | 'checkbox'
+ * @param {Array} [choices] - Choices for list/checkbox
+ * @returns {Promise<any>}
+ */
+async function askQuestion(question, type, choices = []) {
+  // TODO: Use inquirer
+  const answer = await inquirer.prompt([
+    {
+      type,
+      name: 'answer',
+      message: question,
+      choices
+    }
+  ]);
+  
+  return answer.answer;
+}
+
+/**
+ * Get available agents list for custom selection
+ * 
+ * @returns {Array<{name: string, value: string, checked: boolean}>}
+ */
+function getAgentChoices() {
+  return [
+    // BMB Module - Builders
+    { name: '🏗️  BYAN - Agent Creator & Intelligent Interview', value: 'byan', checked: true },
+    { name: '📦 RACHID - NPM/NPX Deployment Specialist', value: 'rachid', checked: true },
+    { name: '🔧 Agent Builder - Direct agent creation', value: 'agent-builder', checked: false },
+    { name: '📋 Module Builder - Module scaffolding', value: 'module-builder', checked: false },
+    { name: '🔄 Workflow Builder - Workflow creation', value: 'workflow-builder', checked: false },
+    
+    // BMM Module - Development Team
+    { name: '🔍 MARY (Analyst) - Requirements & Domain Expert', value: 'analyst', checked: false },
+    { name: '📊 JOHN (PM) - Product Management', value: 'pm', checked: false },
+    { name: '🏛️  WINSTON (Architect) - System Architecture', value: 'architect', checked: false },
+    { name: '💻 AMELIA (Dev) - Implementation Specialist', value: 'dev', checked: true },
+    { name: '📋 BOB (SM) - Scrum Master', value: 'sm', checked: false },
+    { name: '🧪 QUINN (QA) - Quality Assurance', value: 'quinn', checked: false },
+    { name: '🎨 SALLY (UX) - UX/UI Design', value: 'ux-designer', checked: false },
+    { name: '📝 PAIGE (Tech Writer) - Documentation', value: 'tech-writer', checked: true },
+    
+    // TEA Module - Testing
+    { name: '🧬 MURAT (TEA) - Test Architecture Expert', value: 'tea', checked: false },
+    
+    // CIS Module - Innovation
+    { name: '💡 CARSON - Brainstorming Coach', value: 'brainstorming-coach', checked: false },
+    { name: '🎯 DR. QUINN - Design Thinking Coach', value: 'design-thinking-coach', checked: false },
+    { name: '🧩 MAYA - Creative Problem Solver', value: 'creative-problem-solver', checked: false },
+    { name: '🚀 VICTOR - Innovation Strategist', value: 'innovation-strategist', checked: false },
+    { name: '📽️  Presentation Master', value: 'presentation-master', checked: false },
+    { name: '📖 Storyteller', value: 'storyteller', checked: false },
+    
+    // Core Module
+    { name: '🎭 Party Mode - Multi-agent orchestration', value: 'party-mode', checked: false },
+    { name: '🧠 BMAD Master - Platform orchestrator', value: 'bmad-master', checked: false },
+    
+    // Specialized
+    { name: '🔌 MARC - GitHub Copilot CLI Integration', value: 'marc', checked: false },
+    { name: '📌 PATNOTE - Update Manager', value: 'patnote', checked: false },
+    
+    // Quick Flow Variants
+    { name: '⚡ Quick Flow Solo Dev', value: 'quick-flow-solo-dev', checked: false }
+  ];
+}
+
+/**
+ * Get all agent names
+ * 
+ * @returns {string[]}
+ */
+function getAllAgents() {
+  return getAgentChoices().map(choice => choice.value);
+}
+
+module.exports = {
+  ask,
+  askQuestion,
+  getAgentChoices,
+  getAllAgents
+};