create-byan-agent 2.42.0 → 2.45.0

package/install/lib/yanstaller/troubleshooter.js

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

@@ -1,198 +0,0 @@
-/**
- * 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/install/lib/yanstaller/wizard.js

@@ -1,109 +0,0 @@
-/**
- * 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/install/src/byan-v2/dispatcher/task-tool-interface-mock.js

@@ -1,134 +0,0 @@
-/**
- * MockTaskToolInterface - Test double for TaskToolInterface
- * 
- * Simulates GitHub Copilot Task Tool behavior for testing:
- * - Predefined responses
- * - Configurable delays
- * - Call history tracking
- * - Error simulation
- */
-
-const VALID_AGENT_TYPES = ['task', 'explore', 'general-purpose'];
-
-class MockTaskToolInterface {
-  constructor(options = {}) {
-    this.delay = options.delay !== undefined ? options.delay : this._randomDelay();
-    this.responses = options.responses || {};
-    this.behavior = options.behavior || null;
-    this.callHistory = [];
-    this.maxRetries = options.maxRetries !== undefined ? options.maxRetries : 1;
-  }
-
-  /**
-   * Mock delegateTask - simulates Task Tool call
-   */
-  async delegateTask(taskPrompt, agentType) {
-    // Validation (same as real implementation)
-    if (!taskPrompt || taskPrompt.trim() === '') {
-      throw new Error('taskPrompt cannot be empty');
-    }
-
-    if (!agentType) {
-      throw new Error('agentType is required');
-    }
-
-    if (!VALID_AGENT_TYPES.includes(agentType)) {
-      throw new Error(`Invalid agent type: ${agentType}. Valid types: ${VALID_AGENT_TYPES.join(', ')}`);
-    }
-
-    // Record call
-    const call = {
-      prompt: taskPrompt,
-      agentType: agentType,
-      timestamp: Date.now()
-    };
-    this.callHistory.push(call);
-
-    // Simulate delay
-    await this._sleep(this.delay);
-
-    // Use custom behavior if provided (with retry logic for transient errors)
-    if (this.behavior) {
-      const TRANSIENT_ERRORS = ['ECONNRESET', 'ETIMEDOUT', 'ECONNREFUSED'];
-      let lastError;
-      
-      for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
-        try {
-          return this.behavior(taskPrompt, agentType);
-        } catch (error) {
-          lastError = error;
-          
-          // Only retry on transient errors and if we have retries left
-          const isTransient = TRANSIENT_ERRORS.some(errCode => error.message.includes(errCode));
-          if (isTransient && attempt < this.maxRetries) {
-            await this._sleep(this.delay);
-            continue;
-          }
-          
-          // Non-transient error or out of retries - throw immediately
-          break;
-        }
-      }
-      
-      throw lastError;
-    }
-
-    // Check for predefined response
-    if (this.responses[taskPrompt]) {
-      return this.responses[taskPrompt];
-    }
-
-    // Generate default response
-    return this._generateDefaultResponse(taskPrompt, agentType);
-  }
-
-  /**
-   * Generate realistic mock response
-   */
-  _generateDefaultResponse(taskPrompt, agentType) {
-    const outputMap = {
-      'task': `Task completed: ${taskPrompt}`,
-      'explore': `Exploration results for: ${taskPrompt}`,
-      'general-purpose': `General analysis: ${taskPrompt}`
-    };
-
-    return {
-      output: outputMap[agentType] || `Response for: ${taskPrompt}`,
-      metadata: {
-        tokens: Math.floor(Math.random() * 1000) + 100,
-        duration: Math.floor(Math.random() * 2000) + 500,
-        agentType: agentType
-      }
-    };
-  }
-
-  /**
-   * Random delay between 100-500ms
-   */
-  _randomDelay() {
-    return Math.floor(Math.random() * 400) + 100;
-  }
-
-  /**
-   * Sleep utility
-   */
-  _sleep(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
-  }
-
-  /**
-   * Get call history
-   */
-  getCallHistory() {
-    return [...this.callHistory];
-  }
-
-  /**
-   * Clear call history
-   */
-  clearHistory() {
-    this.callHistory = [];
-  }
-}
-
-module.exports = MockTaskToolInterface;

package/install/src/byan-v2/dispatcher/task-tool-interface.js

@@ -1,123 +0,0 @@
-/**
- * TaskToolInterface - Interface to GitHub Copilot CLI Task Tool
- * 
- * IMPORTANT: GitHub Copilot CLI does NOT expose a programmatic API for Task Tool.
- * This is a conceptual interface for BYAN v2.0 architecture design.
- * 
- * In production, this would:
- * 1. Use future Copilot SDK when available
- * 2. Or shell out to `gh copilot` CLI commands
- * 3. Or use inter-process communication with Copilot CLI
- * 
- * For MVP, this is a stub with comprehensive tests using MockTaskToolInterface.
- */
-
-const VALID_AGENT_TYPES = ['task', 'explore', 'general-purpose'];
-const DEFAULT_TIMEOUT = 30000; // 30 seconds
-const TRANSIENT_ERRORS = ['ECONNRESET', 'ETIMEDOUT', 'ECONNREFUSED'];
-
-class TaskToolInterface {
-  constructor(options = {}) {
-    this.timeout = options.timeout || DEFAULT_TIMEOUT;
-    this.maxRetries = options.maxRetries || 1;
-  }
-
-  /**
-   * Delegate task to GitHub Copilot agent via Task Tool
-   * 
-   * @param {string} taskPrompt - The task description for the agent
-   * @param {string} agentType - Agent type: 'task', 'explore', or 'general-purpose'
-   * @returns {Promise<{output: string, metadata: {tokens: number, duration: number}}>}
-   */
-  async delegateTask(taskPrompt, agentType) {
-    // Validation
-    if (!taskPrompt || taskPrompt.trim() === '') {
-      throw new Error('taskPrompt cannot be empty');
-    }
-
-    if (!agentType) {
-      throw new Error('agentType is required');
-    }
-
-    if (!VALID_AGENT_TYPES.includes(agentType)) {
-      throw new Error(`Invalid agent type: ${agentType}. Valid types: ${VALID_AGENT_TYPES.join(', ')}`);
-    }
-
-    // Attempt execution with retry logic
-    let lastError;
-    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
-      try {
-        return await this._executeTaskWithTimeout(taskPrompt, agentType);
-      } catch (error) {
-        lastError = error;
-        
-        // Only retry on transient errors and if we have retries left
-        const isTransient = TRANSIENT_ERRORS.some(errCode => error.message.includes(errCode));
-        if (isTransient && attempt < this.maxRetries) {
-          continue;
-        }
-        
-        // Non-transient error or out of retries - throw immediately
-        break;
-      }
-    }
-
-    throw lastError;
-  }
-
-  async _executeTaskWithTimeout(taskPrompt, agentType) {
-    return new Promise((resolve, reject) => {
-      const timeoutId = setTimeout(() => {
-        reject(new Error(`Task execution timeout after ${this.timeout}ms`));
-      }, this.timeout);
-
-      // TODO: Actual implementation would call Copilot Task Tool here
-      // For now, this is a stub that throws to force use of Mock in tests
-      clearTimeout(timeoutId);
-      reject(new Error('TaskToolInterface is a stub. Use MockTaskToolInterface for testing.'));
-    });
-  }
-
-  /**
-   * Build the call syntax for Task Tool (documentation)
-   * Format: Uses GitHub Copilot CLI agent invocation syntax
-   * 
-   * @param {string} prompt - Task prompt
-   * @param {string} agentType - Agent type
-   * @returns {string} - Call syntax string
-   */
-  static buildTaskCallSyntax(prompt, agentType) {
-    // Escape and sanitize prompt
-    const sanitizedPrompt = prompt
-      .replace(/\n/g, ' ')
-      .replace(/"/g, '\\"');
-
-    // Documented syntax format (conceptual - actual CLI syntax may vary)
-    return `@${agentType} "${sanitizedPrompt}"`;
-  }
-
-  /**
-   * Get documentation for Task Tool call syntax
-   * @returns {string} - Documentation
-   */
-  static getCallSyntaxDocumentation() {
-    return `
-GitHub Copilot CLI Task Tool Syntax (Conceptual):
-
-@<agent_type> "<prompt>"
-
-Where:
-- agent_type: 'task' | 'explore' | 'general-purpose'
-- prompt: Natural language task description
-
-Examples:
-- @task "Run all unit tests and report results"
-- @explore "Find all API endpoint definitions"
-- @general-purpose "Refactor authentication logic"
-
-Note: Actual implementation depends on Copilot CLI SDK availability.
-    `.trim();
-  }
-}
-
-module.exports = TaskToolInterface;