create-byan-agent 2.7.1 → 2.7.2

package/lib/yanstaller/recommender.js

@@ -0,0 +1,102 @@
+/**
+ * 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 = ['hermes', 'byan', 'rachid', 'marc', 'patnote', 'carmack'];
+  const FULL_AGENTS = [
+    // Dispatcher (1)
+    'hermes',
+    // 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':
+    case 'manual':
+      // Ensure hermes is always included
+      return [...new Set(['hermes', ...customAgents])];
+    default:
+      return MINIMAL_AGENTS;
+  }
+}
+
+module.exports = {
+  recommend,
+  analyzePackageJson,
+  getAgentList
+};

package/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/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
+};

package/lib/yanstaller/wizard.js

@@ -0,0 +1,109 @@
+/**
+ * WIZARD Module
+ * 
+ * Post-installation wizard with 3 options: Create agent / Test / Exit.
+ * 
+ * Phase 7: 16h development
+ * 
+ * @module yanstaller/wizard
+ */
+
+const inquirer = require('inquirer');
+const logger = require('../utils/logger');
+
+/**
+ * Show post-install wizard
+ * 
+ * @param {import('./installer').InstallConfig} config - Installation config
+ * @returns {Promise<void>}
+ */
+async function show(config) {
+  logger.success('\n✅ BYAN installed successfully!\n');
+  
+  const choices = [
+    { name: '🎨 Create your first agent (BYAN interview)', value: 'create' },
+    { name: '🧪 Test an installed agent', value: 'test' },
+    { name: '🚪 Exit (start using BYAN)', value: 'exit' }
+  ];
+  
+  const answer = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'action',
+      message: 'What would you like to do next?',
+      choices
+    }
+  ]);
+  
+  switch (answer.action) {
+    case 'create':
+      await launchByanInterview();
+      break;
+    case 'test':
+      await testAgent(config);
+      break;
+    case 'exit':
+      showExitMessage(config);
+      break;
+  }
+}
+
+/**
+ * Launch BYAN intelligent interview
+ * 
+ * @returns {Promise<void>}
+ */
+async function launchByanInterview() {
+  logger.info('\nLaunching BYAN intelligent interview...');
+  // TODO: Exec `@bmad-agent-byan` or similar
+  logger.info('To create an agent, run: @bmad-agent-byan');
+}
+
+/**
+ * Test installed agent
+ * 
+ * @param {import('./installer').InstallConfig} config - Installation config
+ * @returns {Promise<void>}
+ */
+async function testAgent(config) {
+  const agentChoices = config.agents.map(name => ({
+    name: `@bmad-agent-${name}`,
+    value: name
+  }));
+  
+  const answer = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'agent',
+      message: 'Which agent would you like to test?',
+      choices: agentChoices
+    }
+  ]);
+  
+  logger.info(`\nTo activate ${answer.agent}, run: @bmad-agent-${answer.agent}`);
+}
+
+/**
+ * Show exit message with next steps
+ * 
+ * @param {import('./installer').InstallConfig} config - Installation config
+ */
+function showExitMessage(config) {
+  logger.info('\n🎉 You\'re all set! Here\'s how to get started:\n');
+  logger.info('1. Activate an agent:');
+  logger.info('   @bmad-agent-byan    (Create new agents)');
+  logger.info('   @bmad-agent-bmm-pm  (Project management)');
+  logger.info('   @bmad-agent-bmm-dev (Development)\n');
+  logger.info('2. Get help anytime:');
+  logger.info('   /bmad-help\n');
+  logger.info('3. Documentation:');
+  logger.info('   Check _bmad/README.md\n');
+  logger.info('Happy building! 🚀\n');
+}
+
+module.exports = {
+  show,
+  launchByanInterview,
+  testAgent,
+  showExitMessage
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-byan-agent",
-  "version": "2.7.1",
+  "version": "2.7.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"
@@ -51,8 +51,10 @@
   },
   "files": [
     "bin/",
+    "lib/",
     "src/",
     "templates/",
+    "setup-turbo-whisper.js",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"