create-byan-agent 2.0.1 → 2.1.1

package/install/lib/yanstaller/installer.js

@@ -0,0 +1,140 @@
+/**
+ * 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 = [];
+  
+  try {
+    // TODO: Implement installation
+    // 1. Create _bmad/ structure
+    // 2. Copy agent files from templates/
+    // 3. Generate platform-specific stubs
+    // 4. Create config files
+    
+    logger.info(`Installing ${config.agents.length} agents...`);
+    
+    // Placeholder
+    await new Promise(resolve => setTimeout(resolve, 1000));
+    
+    return {
+      success: true,
+      agentsInstalled: config.agents.length,
+      platforms: config.targetPlatforms,
+      errors,
+      duration: Date.now() - startTime
+    };
+  } catch (error) {
+    errors.push(error.message);
+    return {
+      success: false,
+      agentsInstalled: 0,
+      platforms: [],
+      errors,
+      duration: Date.now() - startTime
+    };
+  }
+}
+
+/**
+ * Create _bmad/ directory structure
+ * 
+ * @param {string} projectRoot - Project root directory
+ * @returns {Promise<void>}
+ */
+async function createBmadStructure(projectRoot) {
+  // TODO: Create directories
+  // _bmad/
+  // ├── _config/
+  // ├── _memory/
+  // ├── core/
+  // ├── bmm/
+  // ├── bmb/
+  // ├── tea/
+  // └── cis/
+}
+
+/**
+ * Copy agent file from template
+ * 
+ * @param {string} agentName - Agent name
+ * @param {string} targetPath - Target directory
+ * @returns {Promise<void>}
+ */
+async function copyAgentFile(agentName, targetPath) {
+  // TODO: Copy from lib/templates/agents/{agentName}.md
+}
+
+/**
+ * Generate platform-specific stub
+ * 
+ * @param {string} agentName - Agent name
+ * @param {string} platform - Platform name
+ * @param {string} targetPath - Target directory
+ * @returns {Promise<void>}
+ */
+async function generateStub(agentName, platform, targetPath) {
+  // TODO: Generate stub based on platform
+  // - Copilot CLI: .github/agents/{agentName}.md with YAML frontmatter
+  // - VSCode: Same as Copilot CLI
+  // - Claude Code: MCP config JSON
+  // - Codex: .codex/prompts/{agentName}.md
+}
+
+/**
+ * Create module config file
+ * 
+ * @param {string} moduleName - Module name (core, bmm, bmb, tea, cis)
+ * @param {InstallConfig} config - Installation config
+ * @param {string} targetPath - Target directory
+ * @returns {Promise<void>}
+ */
+async function createModuleConfig(moduleName, config, targetPath) {
+  // TODO: Generate config.yaml with user settings
+}
+
+module.exports = {
+  install,
+  createBmadStructure,
+  copyAgentFile,
+  generateStub,
+  createModuleConfig
+};

package/install/lib/yanstaller/interviewer.js

@@ -0,0 +1,88 @@
+/**
+ * INTERVIEWER Module
+ * 
+ * Conducts quick interview (5-7 questions, <5 min) to personalize installation.
+ * 
+ * Phase 6 (part of 7): 16h development
+ * 
+ * @module yanstaller/interviewer
+ */
+
+const inquirer = require('inquirer');
+
+/**
+ * @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) {
+  // TODO: Implement inquirer prompts
+  // Q1: Your name?
+  // Q2: Preferred language?
+  // Q3: Installation mode? (with recommendation)
+  // Q4: (if custom) Which agents?
+  // Q5: Which platforms to install on?
+  // Q6: Create sample agent after install?
+  
+  return {
+    userName: 'User',
+    language: 'English',
+    mode: recommendation.mode,
+    agents: recommendation.agents,
+    targetPlatforms: ['copilot-cli'],
+    createSampleAgent: false
+  };
+}
+
+/**
+ * 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() {
+  // TODO: Return all 29 agents with descriptions
+  return [
+    { name: 'BYAN - Agent Creator', value: 'byan', checked: true },
+    { name: 'RACHID - NPM Deployment', value: 'rachid', checked: true },
+    // ... 27 more
+  ];
+}
+
+module.exports = {
+  ask,
+  askQuestion,
+  getAgentChoices
+};

package/install/lib/yanstaller/recommender.js

@@ -0,0 +1,98 @@
+/**
+ * RECOMMENDER Module
+ * 
+ * Analyzes project and recommends optimal BYAN configuration.
+ * 
+ * Phase 2: 24h development
+ * 
+ * @module yanstaller/recommender
+ */
+
+/**
+ * @typedef {Object} Recommendation
+ * @property {string} mode - 'full' | 'minimal' | 'custom'
+ * @property {string[]} agents - Recommended agent names
+ * @property {string} reason - Why this recommendation
+ * @property {string} projectType - 'frontend' | 'backend' | 'fullstack' | 'library' | 'unknown'
+ */
+
+/**
+ * Analyze project and recommend configuration
+ * 
+ * @param {import('./detector').DetectionResult} detection - Detection results
+ * @returns {Promise<Recommendation>}
+ */
+async function recommend(detection) {
+  // TODO: Implement recommendation logic
+  // - Analyze package.json, requirements.txt, go.mod, etc.
+  // - Detect project type (frontend/backend/fullstack)
+  // - Recommend agents based on stack
+  
+  return {
+    mode: 'minimal',
+    agents: ['byan', 'rachid', 'marc', 'patnote', 'carmack'],
+    reason: 'Default minimal installation for new users',
+    projectType: 'unknown'
+  };
+}
+
+/**
+ * Analyze package.json to detect stack
+ * 
+ * @param {string} packageJsonPath - Path to package.json
+ * @returns {Promise<{isFrontend: boolean, isBackend: boolean, framework: string}>}
+ */
+async function analyzePackageJson(packageJsonPath) {
+  // TODO: Read package.json, check dependencies
+  // - React/Vue/Angular → frontend
+  // - Express/Fastify/Nest → backend
+  
+  return {
+    isFrontend: false,
+    isBackend: false,
+    framework: 'unknown'
+  };
+}
+
+/**
+ * Get agent list for installation mode
+ * 
+ * @param {string} mode - 'full' | 'minimal' | 'custom'
+ * @param {string[]} [customAgents] - Custom agent selection
+ * @returns {string[]}
+ */
+function getAgentList(mode, customAgents = []) {
+  const MINIMAL_AGENTS = ['byan', 'rachid', 'marc', 'patnote', 'carmack'];
+  const FULL_AGENTS = [
+    // Core (5)
+    'byan', 'rachid', 'marc', 'patnote', 'carmack',
+    // BMM (9)
+    'analyst', 'pm', 'architect', 'dev', 'sm', 'quinn', 'ux-designer', 'tech-writer', 'quick-flow-solo-dev',
+    // BMB (3)
+    'agent-builder', 'module-builder', 'workflow-builder',
+    // TEA (1)
+    'tea',
+    // CIS (6)
+    'brainstorming-coach', 'creative-problem-solver', 'design-thinking-coach', 
+    'innovation-strategist', 'presentation-master', 'storyteller',
+    // BYAN Test (1)
+    'byan-test'
+  ];
+  
+  switch (mode) {
+    case 'full':
+      return FULL_AGENTS;
+    case 'minimal':
+      return MINIMAL_AGENTS;
+    case 'custom':
+      return customAgents;
+    default:
+      return MINIMAL_AGENTS;
+  }
+}
+
+module.exports = {
+  recommend,
+  analyzePackageJson,
+  getAgentList
+};

package/install/lib/yanstaller/troubleshooter.js

@@ -0,0 +1,89 @@
+/**
+ * TROUBLESHOOTER Module
+ * 
+ * Diagnoses and fixes common installation errors.
+ * 
+ * Phase 5: 40h development
+ * 
+ * @module yanstaller/troubleshooter
+ */
+
+/**
+ * @typedef {Object} DiagnosticResult
+ * @property {string} error - Error type
+ * @property {string} cause - Root cause
+ * @property {string} solution - Recommended solution
+ * @property {boolean} canAutoFix - Whether auto-fix is available
+ * @property {Function} [autoFix] - Auto-fix function
+ */
+
+/**
+ * Diagnose installation error
+ * 
+ * @param {Error} error - Installation error
+ * @param {Object} context - Installation context
+ * @returns {Promise<DiagnosticResult>}
+ */
+async function diagnose(error, context) {
+  // TODO: Pattern match error and return diagnostic
+  // Common errors:
+  // - Node version too old
+  // - Permission denied
+  // - Git not found
+  // - Platform not detected
+  // - Network error (template download)
+  
+  return {
+    error: error.message,
+    cause: 'Unknown',
+    solution: 'Please check logs',
+    canAutoFix: false
+  };
+}
+
+/**
+ * Auto-fix permission error
+ * 
+ * @param {string} path - File path with permission issue
+ * @returns {Promise<void>}
+ */
+async function fixPermissions(path) {
+  // TODO: chmod/chown on Unix, icacls on Windows
+}
+
+/**
+ * Suggest Node.js upgrade
+ * 
+ * @param {string} currentVersion - Current Node version
+ * @param {string} requiredVersion - Required Node version
+ * @returns {string} - Upgrade instructions
+ */
+function suggestNodeUpgrade(currentVersion, requiredVersion) {
+  // TODO: OS-specific instructions
+  return `Please upgrade Node.js from ${currentVersion} to ${requiredVersion}+`;
+}
+
+/**
+ * Check common issues
+ * 
+ * @returns {Promise<string[]>} - List of detected issues
+ */
+async function checkCommonIssues() {
+  const issues = [];
+  
+  // TODO: Check for:
+  // - Old Node version
+  // - Missing Git
+  // - Write permission in project root
+  // - Disk space
+  // - Network connectivity
+  
+  return issues;
+}
+
+module.exports = {
+  diagnose,
+  fixPermissions,
+  suggestNodeUpgrade,
+  checkCommonIssues
+};

package/install/lib/yanstaller/validator.js

@@ -0,0 +1,198 @@
+/**
+ * VALIDATOR Module
+ * 
+ * Validates BYAN installation with 10 automated checks.
+ * 
+ * Phase 4: 32h development
+ * 
+ * @module yanstaller/validator
+ */
+
+/**
+ * @typedef {Object} ValidationResult
+ * @property {boolean} success - All checks passed
+ * @property {CheckResult[]} checks - Individual check results
+ * @property {string[]} errors - Critical errors
+ * @property {string[]} warnings - Non-critical issues
+ */
+
+/**
+ * @typedef {Object} CheckResult
+ * @property {string} id - Check identifier
+ * @property {string} name - Human-readable check name
+ * @property {boolean} passed
+ * @property {string} [message] - Error/warning message if failed
+ * @property {string} severity - 'critical' | 'warning'
+ */
+
+/**
+ * Validate BYAN installation
+ * 
+ * @param {import('./installer').InstallConfig} config - Installation config
+ * @returns {Promise<ValidationResult>}
+ */
+async function validate(config) {
+  const checks = [];
+  const errors = [];
+  const warnings = [];
+  
+  // TODO: Run all 10 checks
+  checks.push(await checkBmadStructure(config));
+  checks.push(await checkAgentFiles(config));
+  checks.push(await checkStubsYamlFrontmatter(config));
+  checks.push(await checkConfigFiles(config));
+  checks.push(await checkPlatformDetection(config));
+  checks.push(await checkFilePermissions(config));
+  checks.push(await checkManifests(config));
+  checks.push(await checkWorkflows(config));
+  checks.push(await checkTemplates(config));
+  checks.push(await checkDependencies(config));
+  
+  const allPassed = checks.every(c => c.passed || c.severity === 'warning');
+  
+  return {
+    success: allPassed,
+    checks,
+    errors,
+    warnings
+  };
+}
+
+/**
+ * Check 1: _bmad/ structure exists
+ */
+async function checkBmadStructure(config) {
+  // TODO: Verify directories exist
+  return {
+    id: 'bmad-structure',
+    name: '_bmad/ structure',
+    passed: true,
+    severity: 'critical'
+  };
+}
+
+/**
+ * Check 2: Agent files copied correctly
+ */
+async function checkAgentFiles(config) {
+  // TODO: Verify all agent .md files exist
+  return {
+    id: 'agent-files',
+    name: 'Agent files',
+    passed: true,
+    severity: 'critical'
+  };
+}
+
+/**
+ * Check 3: Platform stubs have valid YAML frontmatter
+ */
+async function checkStubsYamlFrontmatter(config) {
+  // TODO: Parse YAML frontmatter in .github/agents/*.md
+  return {
+    id: 'yaml-frontmatter',
+    name: 'YAML frontmatter',
+    passed: true,
+    severity: 'critical'
+  };
+}
+
+/**
+ * Check 4: Module config files valid
+ */
+async function checkConfigFiles(config) {
+  // TODO: Verify config.yaml files
+  return {
+    id: 'config-files',
+    name: 'Config files',
+    passed: true,
+    severity: 'critical'
+  };
+}
+
+/**
+ * Check 5: Platform detection works
+ */
+async function checkPlatformDetection(config) {
+  // TODO: Test agent detection on each platform
+  return {
+    id: 'platform-detection',
+    name: 'Platform detection',
+    passed: true,
+    severity: 'critical'
+  };
+}
+
+/**
+ * Check 6: File permissions correct
+ */
+async function checkFilePermissions(config) {
+  // TODO: Verify read/write permissions
+  return {
+    id: 'file-permissions',
+    name: 'File permissions',
+    passed: true,
+    severity: 'warning'
+  };
+}
+
+/**
+ * Check 7: Manifest files valid
+ */
+async function checkManifests(config) {
+  // TODO: Verify agent-manifest.csv, workflow-manifest.csv
+  return {
+    id: 'manifests',
+    name: 'Manifest files',
+    passed: true,
+    severity: 'warning'
+  };
+}
+
+/**
+ * Check 8: Workflows accessible
+ */
+async function checkWorkflows(config) {
+  // TODO: Verify workflow files exist
+  return {
+    id: 'workflows',
+    name: 'Workflow files',
+    passed: true,
+    severity: 'warning'
+  };
+}
+
+/**
+ * Check 9: Templates valid
+ */
+async function checkTemplates(config) {
+  // TODO: Verify templates/ structure
+  return {
+    id: 'templates',
+    name: 'Template files',
+    passed: true,
+    severity: 'warning'
+  };
+}
+
+/**
+ * Check 10: Dependencies installed
+ */
+async function checkDependencies(config) {
+  // TODO: Verify npm dependencies
+  return {
+    id: 'dependencies',
+    name: 'Dependencies',
+    passed: true,
+    severity: 'critical'
+  };
+}
+
+module.exports = {
+  validate,
+  checkBmadStructure,
+  checkAgentFiles,
+  checkStubsYamlFrontmatter,
+  checkConfigFiles,
+  checkPlatformDetection
+};