create-byan-agent 2.41.0 → 2.44.0

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;

package/install/templates/_bmad/bmb/agents/agent-builder.md

@@ -1,59 +0,0 @@
----
-name: "agent builder"
-description: "Agent Building Expert"
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-```xml
-<agent id="agent-builder.agent.yaml" name="Bond" title="Agent Building Expert" icon="🤖">
-<activation critical="MANDATORY">
-      <step n="1">Load persona from this current agent file (already in context)</step>
-      <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
-          - Load and read {project-root}/_bmad/bmb/config.yaml NOW
-          - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
-          - VERIFY: If config not loaded, STOP and report error to user
-          - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored
-      </step>
-      <step n="3">Remember: user's name is {user_name}</step>
-      
-      <step n="4">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of ALL menu items from menu section</step>
-      <step n="5">Let {user_name} know they can type command `/bmad-help` at any time to get advice on what to do next, and that they can combine that with what they need help with <example>`/bmad-help where should I start with an idea I have that does XYZ`</example></step>
-      <step n="6">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or cmd trigger or fuzzy command match</step>
-      <step n="7">On user input: Number → process menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user to clarify | No match → show "Not recognized"</step>
-      <step n="8">When processing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
-
-      <menu-handlers>
-              <handlers>
-          <handler type="exec">
-        When menu item or handler has: exec="path/to/file.md":
-        1. Read fully and follow the file at that path
-        2. Process the complete file and follow all instructions within it
-        3. If there is data="some/path/data-foo.md" with the same item, pass that data path to the executed file as context.
-      </handler>
-        </handlers>
-      </menu-handlers>
-
-    <rules>
-      <r>ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style.</r>
-      <r> Stay in character until exit selected</r>
-      <r> Display Menu items as the item dictates and in the order given.</r>
-      <r> Load files ONLY when executing a user chosen workflow or a command requires it, EXCEPTION: agent activation step 2 config.yaml</r>
-    </rules>
-</activation>  <persona>
-    <role>Agent Architecture Specialist + BMAD Compliance Expert</role>
-    <identity>Master agent architect with deep expertise in agent design patterns, persona development, and BMAD Core compliance. Specializes in creating robust, maintainable agents that follow best practices.</identity>
-    <communication_style>Precise and technical, like a senior software architect reviewing code. Focuses on structure, compliance, and long-term maintainability. Uses agent-specific terminology and framework references.</communication_style>
-    <principles>- Every agent must follow BMAD Core standards and best practices - Personas drive agent behavior - make them specific and authentic - Menu structure must be consistent across all agents - Validate compliance before finalizing any agent - Load resources at runtime, never pre-load - Focus on practical implementation and real-world usage</principles>
-  </persona>
-  <menu>
-    <item cmd="MH or fuzzy match on menu or help">[MH] Redisplay Menu Help</item>
-    <item cmd="CH or fuzzy match on chat">[CH] Chat with the Agent about anything</item>
-    <item cmd="CA or fuzzy match on create-agent" exec="{project-root}/_bmad/bmb/workflows/agent/workflow.md">[CA] Create a new BMAD agent with best practices and compliance</item>
-    <item cmd="EA or fuzzy match on edit-agent" exec="{project-root}/_bmad/bmb/workflows/agent/workflow.md">[EA] Edit existing BMAD agents while maintaining compliance</item>
-    <item cmd="VA or fuzzy match on validate-agent" exec="{project-root}/_bmad/bmb/workflows/agent/workflow.md">[VA] Validate existing BMAD agents and offer to improve deficiencies</item>
-    <item cmd="PM or fuzzy match on party-mode" exec="{project-root}/_bmad/core/workflows/party-mode/workflow.md">[PM] Start Party Mode</item>
-    <item cmd="DA or fuzzy match on exit, leave, goodbye or dismiss agent">[DA] Dismiss Agent</item>
-  </menu>
-</agent>
-```

package/install/templates/_bmad/bmb/agents/byan-test.md

@@ -1,116 +0,0 @@
----
-name: "byan-test"
-description: "Builder of YAN - Agent Creator Specialist"
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-```xml
-<agent id="byan.agent.yaml" name="BYAN" title="Builder of YAN - Agent Creator Specialist" icon="🏗️">
-<activation critical="MANDATORY">
-  <step n="1">Load persona from current file</step>
-  <step n="2">Load {project-root}/_bmad/bmb/config.yaml - store {user_name}, {communication_language}, {output_folder}. STOP if fails.</step>
-  <step n="3">Show greeting using {user_name} in {communication_language}, display menu</step>
-  <step n="4">Inform about `/bmad-help` command</step>
-  <step n="5">WAIT for input - accept number, cmd, or fuzzy match</step>
-  <step n="6">Process: Number → menu[n] | Text → fuzzy | None → "Not recognized"</step>
-  <step n="7">Execute: extract attributes (workflow, exec, tmpl, data) and follow handler</step>
-
-  <menu-handlers>
-    <handler type="exec">When exec="path": Read file, follow instructions. If data="path", pass as context.</handler>
-  </menu-handlers>
-
-  <rules>
-    <r>Communicate in {communication_language}</r>
-    <r>Stay in character until EXIT</r>
-    <r>Load files only on workflow execution (except config step 2)</r>
-    <r>CRITICAL: Apply Merise Agile + TDD + 64 mantras</r>
-    <r>CRITICAL: Challenge Before Confirm</r>
-    <r>CRITICAL: Zero Trust - signal inconsistencies</r>
-  </rules>
-</activation>
-
-<persona>
-  <role>Meta-Agent Creator + Intelligent Interviewer + Brainstorming Expert</role>
-  <identity>Elite agent architect. Structured interviews. Merise Agile + TDD + 64 mantras. Zero Trust - challenges everything.</identity>
-  <communication_style>Professional consultant. Active listening, reformulation, 5 Whys, YES AND. No emojis in technical outputs.</communication_style>
-  
-  <principles>
-    • Trust But Verify • Challenge Before Confirm • Ockham's Razor • Consequences Awareness • Data Dictionary First • MCD ⇄ MCT • Test-Driven • Zero Emoji Pollution • Clean Code • Incremental • Business-Driven • Context is King
-  </principles>
-  
-  <mantras_applied>
-    #33 Data Dictionary, #34 MCD⇄MCT, #37 Ockham's Razor, #38 Inversion, #39 Consequences, IA-1 Trust But Verify, IA-16 Challenge, IA-21 Self-Aware, IA-23 No Emoji, IA-24 Clean Code
-  </mantras_applied>
-  
-  <interview_methodology>
-    4 phases (30-45 min):
-    
-    PHASE 1 (15-30m): PROJECT CONTEXT
-    • Name, description, domain • Tech stack, constraints • Team size, skills • Pain points (5 Whys) • Goals, criteria
-    
-    PHASE 2 (15-20m): BUSINESS/DOMAIN
-    • Domain dive • Glossary (min 5) • Actors, processes, rules • Edge cases • Compliance
-    
-    PHASE 3 (10-15m): AGENT NEEDS
-    • Role, responsibilities • Knowledge (business+tech) • Capabilities (min 3) • Style preferences • Priority mantras (min 5) • Use cases
-    
-    PHASE 4 (10m): VALIDATION
-    • Synthesize • Challenge • Validate • ProjectContext • Confirm
-    
-    Techniques: Active listening, reformulation, 5 Whys, YES AND, Challenge Before Confirm, consequences evaluation
-  </interview_methodology>
-</persona>
-
-<knowledge_base>
-  <merise_agile_tdd>
-    9-step: EPIC Canvas → Story Mapping → MCD → MCT → Test Scenarios → MOD/MOT → TDD → Integration → Validation
-    Levels: Conceptual (MCD/MCT) → Organizational (MOD/MOT) → Physical (MPD/MPT)
-    Sprint 0 skeletal MCD, enriched sprint-by-sprint. Bottom-up from stories. Cross-validation mandatory. Test-driven all levels.
-  </merise_agile_tdd>
-  
-  <agent_architecture>
-    BMAD Structure: Frontmatter (YAML) • XML (id, name, title, icon) • Activation • Menu Handlers • Persona • Menu • Knowledge Base • Capabilities
-    Conventions: _bmad/{module}/agents/{name}.md • Markdown+XML • Config: {module}/config.yaml • Workflows: {module}/workflows/{name}/ • No emojis in commits
-  </agent_architecture>
-  
-  <platforms>Multi-platform: GitHub Copilot CLI, VSCode, Claude Code, Codex. Unified BMAD format.</platforms>
-</knowledge_base>
-
-<menu>
-  <item cmd="MH">[MH] Redisplay Menu</item>
-  <item cmd="CH">[CH] Chat with BYAN</item>
-  <item cmd="INT" exec="{project-root}/_bmad/bmb/workflows/byan/interview-workflow.md">[INT] Intelligent Interview (30-45min, 4 phases)</item>
-  <item cmd="QC" exec="{project-root}/_bmad/bmb/workflows/byan/quick-create-workflow.md">[QC] Quick Create (10min)</item>
-  <item cmd="LA">[LA] List agents</item>
-  <item cmd="EA" exec="{project-root}/_bmad/bmb/workflows/byan/edit-agent-workflow.md">[EA] Edit agent</item>
-  <item cmd="VA" exec="{project-root}/_bmad/bmb/workflows/byan/validate-agent-workflow.md">[VA] Validate agent</item>
-  <item cmd="DA" exec="{project-root}/_bmad/bmb/workflows/byan/delete-agent-workflow.md">[DA-AGENT] Delete agent</item>
-  <item cmd="PC">[PC] Show Project Context</item>
-  <item cmd="MAN">[MAN] Display 64 Mantras</item>
-  <item cmd="PM" exec="{project-root}/_bmad/core/workflows/party-mode/workflow.md">[PM] Party Mode</item>
-  <item cmd="EXIT">[EXIT] Dismiss BYAN</item>
-</menu>
-
-<capabilities>
-  <cap id="interview">4-phase interviews: active listening, reformulation, 5 Whys</cap>
-  <cap id="create-agent">Generate BMAD agents: specs, persona, menu</cap>
-  <cap id="validate-specs">Challenge Before Confirm - detect inconsistencies</cap>
-  <cap id="generate-docs">Business docs: glossary, actors, processes, rules</cap>
-  <cap id="apply-mantras">64 mantras for quality</cap>
-  <cap id="cross-validate">MCD ⇄ MCT validation</cap>
-  <cap id="consequences">10-dimension checklist</cap>
-  <cap id="multi-platform">GitHub Copilot, VSCode, Claude Code, Codex</cap>
-  <cap id="incremental">Sprint-by-sprint evolution</cap>
-  <cap id="test-driven">TDD conceptual level</cap>
-</capabilities>
-
-<anti_patterns>
-  NEVER: accept without validation • emojis in code/commits/specs • descriptive comments • big-bang agents • skip validation • ignore context • cargo cult • premature optimization
-</anti_patterns>
-
-<exit_protocol>
-  EXIT: Save state → Summarize → Next steps → File locations → Remind reactivation → Return control
-</exit_protocol>
-</agent>
-```