create-byan-agent 1.2.6 → 2.0.0-alpha.1

package/lib/yanstaller/index.js

@@ -1,93 +0,0 @@
-/**
- * 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

@@ -1,226 +0,0 @@
-/**
- * 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-code' | 'codex')
- * @param {InstallConfig} config - Installation config
- * @returns {Promise<void>}
- */
-async function generatePlatformStubs(platform, config) {
-  const normalized = platform === 'claude' ? 'claude-code' : platform;
-  const platformModule = require(`../platforms/${normalized}`);
-  
-  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

@@ -1,301 +0,0 @@
-/**
- * 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');
-
-function normalizePlatformName(name) {
-  if (!name) return name;
-  const lower = String(name).toLowerCase();
-  if (lower === 'claude') return 'claude-code';
-  return lower;
-}
-
-function buildDefaultPlatforms(options = {}) {
-  const preferred = Array.isArray(options.preferredPlatforms)
-    ? options.preferredPlatforms.map(normalizePlatformName).filter(Boolean)
-    : [];
-  
-  if (preferred.length > 0) return preferred;
-  
-  const detected = (options.detection && Array.isArray(options.detection.platforms))
-    ? options.detection.platforms
-        .filter(p => p.detected)
-        .map(p => normalizePlatformName(p.name))
-        .filter(Boolean)
-    : [];
-  
-  return detected;
-}
-
-/**
- * @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, options = {}) {
-  const defaults = options.defaults || {};
-  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: defaults.userName || '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: (defaults.language === 'Francais' || defaults.language === 'English') ? defaults.language : 'English'
-    }
-  ]);
-  
-  // Q3: Installation mode (with recommendation)
-  const recommendedMode = recommendation ? recommendation.mode : 'recommended';
-  const defaultMode = defaults.mode || recommendedMode;
-  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: defaultMode
-    }
-  ]);
-  
-  // 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(defaults.agents),
-        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 defaultPlatforms = buildDefaultPlatforms(options);
-  const useDefaultPlatforms = defaultPlatforms.length > 0;
-  const isDefault = (value, fallback) => useDefaultPlatforms ? defaultPlatforms.includes(value) : fallback;
-  
-  const platformAnswer = await inquirer.prompt([
-    {
-      type: 'checkbox',
-      name: 'platforms',
-      message: 'Which platforms to install on?',
-      choices: [
-        { name: 'All detected platforms', value: '__all_detected__', checked: false },
-        { name: 'GitHub Copilot CLI (.github/agents/)', value: 'copilot-cli', checked: isDefault('copilot-cli', true) },
-        { name: 'VSCode Copilot Extension', value: 'vscode', checked: isDefault('vscode', true) },
-        { name: 'Codex (.codex/prompts/)', value: 'codex', checked: isDefault('codex', false) },
-        { name: 'Claude Code (MCP server)', value: 'claude-code', checked: isDefault('claude-code', false) }
-      ],
-      validate: (input) => input.length > 0 || 'Select at least one platform'
-    }
-  ]);
-
-  let selectedPlatforms = platformAnswer.platforms;
-  if (selectedPlatforms.includes('__all_detected__')) {
-    const detected = buildDefaultPlatforms(options);
-    selectedPlatforms = detected.length > 0
-      ? detected
-      : ['copilot-cli', 'vscode', 'codex', 'claude-code'];
-  }
-  
-  const isFrench = langAnswer.language === 'Francais';
-  const platformSummary = selectedPlatforms.join(', ');
-  if (isFrench) {
-    logger.info(`Plateformes retenues: ${platformSummary}`);
-  } else {
-    logger.info(`Selected platforms: ${platformSummary}`);
-  }
-  
-  // Q6: Create sample agent
-  const sampleAnswer = await inquirer.prompt([
-    {
-      type: 'confirm',
-      name: 'createSample',
-      message: 'Launch BYAN agent creator after installation?',
-      default: typeof defaults.createSampleAgent === 'boolean' ? defaults.createSampleAgent : false
-    }
-  ]);
-  
-  // Q7: Create backup (optional)
-  const backupAnswer = await inquirer.prompt([
-    {
-      type: 'confirm',
-      name: 'createBackup',
-      message: 'Create backup of existing _bmad/ directory? (if exists)',
-      default: typeof defaults.createBackup === 'boolean' ? defaults.createBackup : true
-    }
-  ]);
-  
-  logger.info('');
-  
-  return {
-    userName: nameAnswer.userName,
-    language: langAnswer.language,
-    mode: modeAnswer.mode,
-    agents: selectedAgents,
-    targetPlatforms: selectedPlatforms,
-    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(checkedAgents = []) {
-  const choices = [
-    // 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 }
-  ];
-  
-  if (Array.isArray(checkedAgents) && checkedAgents.length > 0) {
-    return choices.map(choice => ({
-      ...choice,
-      checked: checkedAgents.includes(choice.value)
-    }));
-  }
-  
-  return choices;
-}
-
-function getAllAgents() {
-  return getAgentChoices().map(choice => choice.value);
-}
-
-module.exports = {
-  ask,
-  askQuestion,
-  getAgentChoices,
-  getAllAgents
-};