create-byan-agent 2.7.7 → 2.7.9

package/install/src/byan-v2/index.js

@@ -1,199 +0,0 @@
-const SessionState = require('./context/session-state');
-const TaskRouter = require('./dispatcher/task-router');
-const StateMachine = require('./orchestrator/state-machine');
-const InterviewState = require('./orchestrator/interview-state');
-const AnalysisState = require('./orchestrator/analysis-state');
-const GenerationState = require('./orchestrator/generation-state');
-const Logger = require('./observability/logger');
-const MetricsCollector = require('./observability/metrics-collector');
-const crypto = require('crypto');
-
-class ByanV2 {
-  constructor(config = {}) {
-    this.config = this._loadConfig(config);
-    
-    if (config.sessionState) {
-      this.sessionState = config.sessionState;
-    } else {
-      const sessionId = this.config.sessionId || crypto.randomUUID();
-      this.sessionState = new SessionState(sessionId);
-    }
-    
-    if (config.logger) {
-      this.logger = config.logger;
-    } else {
-      this.logger = new Logger();
-    }
-    
-    this.metrics = new MetricsCollector();
-    this.dispatcher = new TaskRouter();
-    
-    const ErrorTracker = require('./observability/error-tracker');
-    this.errorTracker = new ErrorTracker();
-    
-    if (config.stateMachine) {
-      this.stateMachine = config.stateMachine;
-    } else {
-      this.stateMachine = new StateMachine({
-        logger: this.logger,
-        errorTracker: this.errorTracker
-      });
-      
-      this.interviewState = new InterviewState(this.sessionState);
-      this.analysisState = new AnalysisState(this.sessionState);
-      this.generationState = new GenerationState(this.sessionState);
-    }
-  }
-
-  _loadConfig(customConfig) {
-    const defaults = {
-      maxQuestions: 12,
-      complexityThresholds: {
-        low: 30,
-        medium: 60
-      },
-      outputDir: './_bmad-output/bmb-creations',
-      env: customConfig.env || (process.env.GITHUB_COPILOT ? 'copilot' : 'standalone')
-    };
-
-    return { ...defaults, ...customConfig };
-  }
-
-  isCopilotContext() {
-    return this.config.env === 'copilot' || process.env.GITHUB_COPILOT === 'true';
-  }
-
-  async startSession() {
-    this.logger.info('Starting BYAN session', {
-      event: 'session_start',
-      sessionId: this.sessionState.sessionId
-    });
-
-    this.metrics.increment('sessionsStarted');
-
-    await this.stateMachine.transition('INTERVIEW');
-
-    this.logger.info('State transition', {
-      event: 'state_transition',
-      from: 'INIT',
-      to: 'INTERVIEW'
-    });
-
-    return this.sessionState.sessionId;
-  }
-
-  async getNextQuestion() {
-    const currentState = this.stateMachine.getCurrentState();
-    
-    if (currentState.name !== 'INTERVIEW') {
-      throw new Error('Not in INTERVIEW state');
-    }
-
-    const question = this.interviewState.askNextQuestion();
-    
-    this.metrics.increment('questionsAsked');
-
-    return typeof question === 'string' ? question : question?.text || question;
-  }
-
-  async submitResponse(response) {
-    if (!response || response.trim().length === 0) {
-      this.metrics.increment('errors');
-      throw new Error('Response cannot be empty');
-    }
-
-    const sanitized = response.substring(0, 100);
-    this.logger.info('User response received', {
-      event: 'response_submitted',
-      response: sanitized
-    });
-
-    const currentState = this.stateMachine.getCurrentState();
-    
-    if (currentState.name === 'INTERVIEW') {
-      const isComplete = this.interviewState.processResponse(response);
-      
-      if (isComplete) {
-        await this.stateMachine.transition('ANALYSIS');
-        
-        this.logger.info('State transition', {
-          event: 'state_transition',
-          from: 'INTERVIEW',
-          to: 'ANALYSIS'
-        });
-      }
-    }
-
-    return { success: true };
-  }
-
-  async generateProfile() {
-    const currentState = this.stateMachine.getCurrentState();
-    
-    if (currentState.name === 'INTERVIEW') {
-      await this.stateMachine.transition('ANALYSIS');
-      await this.stateMachine.transition('GENERATION');
-    } else if (currentState.name === 'ANALYSIS') {
-      await this.stateMachine.transition('GENERATION');
-    } else if (currentState.name !== 'GENERATION') {
-      this.metrics.increment('errors');
-      throw new Error('Cannot generate profile in current state');
-    }
-
-    this.logger.info('Generating agent profile', {
-      event: 'profile_generation_start'
-    });
-
-    const profile = await this.generationState.generateProfile();
-
-    this.metrics.increment('profilesGenerated');
-
-    await this.stateMachine.transition('COMPLETED');
-
-    this.logger.info('Profile generation complete', {
-      event: 'profile_generation_complete'
-    });
-
-    return profile;
-  }
-
-  async endSession() {
-    const currentState = this.stateMachine.getCurrentState();
-    
-    if (currentState.name !== 'COMPLETED' && currentState.name !== 'ERROR') {
-      // Force transition through states if needed
-      if (currentState.name === 'INTERVIEW') {
-        await this.stateMachine.transition('ANALYSIS');
-        await this.stateMachine.transition('GENERATION');
-      } else if (currentState.name === 'ANALYSIS') {
-        await this.stateMachine.transition('GENERATION');
-      }
-      
-      if (this.stateMachine.getCurrentState().name === 'GENERATION') {
-        await this.stateMachine.transition('COMPLETED');
-      }
-    }
-
-    this.logger.info('Session ended', {
-      event: 'session_end',
-      sessionId: this.sessionState.sessionId
-    });
-
-    return { success: true };
-  }
-
-  getMetricsSummary() {
-    return this.metrics.getSummary();
-  }
-
-  async getSessionSummary() {
-    return {
-      sessionId: this.sessionState.sessionId,
-      questionsAsked: this.sessionState.userResponses.length,
-      state: this.stateMachine.getCurrentState().name,
-      timestamp: new Date().toISOString()
-    };
-  }
-}
-
-module.exports = ByanV2;

package/install/src/byan-v2/observability/error-tracker.js

@@ -1,105 +0,0 @@
-/**
- * ErrorTracker - Track and store errors with context
- * 
- * Error Types:
- * - ROUTING_ERROR: Errors during task routing
- * - EXECUTION_ERROR: Errors during task execution
- * - VALIDATION_ERROR: Errors during validation
- * 
- * Features:
- * - Store up to maxErrors (default 100) in FIFO order
- * - Track error type, message, stack, context, timestamp
- * - Filter errors by type
- * - Get error statistics
- * 
- * Methods:
- * - trackError(errorData)
- * - getErrors()
- * - getErrorsByType(type)
- * - getErrorStats()
- * - clearErrors()
- */
-
-class ErrorTracker {
-  constructor(options = {}) {
-    this.maxErrors = options.maxErrors || 100;
-    this.errors = [];
-  }
-
-  /**
-   * Track an error with full context
-   * @param {Object} errorData - Error data with type, message, error, context
-   */
-  trackError(errorData) {
-    if (!errorData) return;
-
-    const { type, message, error, context } = errorData;
-
-    // Build error entry
-    const errorEntry = {
-      type,
-      message: message || error?.message,
-      stack: error?.stack,
-      context,
-      timestamp: new Date().toISOString()
-    };
-
-    // Add to errors array
-    this.errors.push(errorEntry);
-
-    // Enforce max size (FIFO)
-    if (this.errors.length > this.maxErrors) {
-      this.errors.shift(); // Remove oldest
-    }
-  }
-
-  /**
-   * Get all tracked errors
-   * @returns {Array} Array of error objects
-   */
-  getErrors() {
-    // Return copy to prevent external modification
-    return [...this.errors];
-  }
-
-  /**
-   * Get errors filtered by type
-   * @param {string} type - Error type to filter by
-   * @returns {Array} Array of errors matching type
-   */
-  getErrorsByType(type) {
-    return this.errors.filter(error => error.type === type);
-  }
-
-  /**
-   * Get error statistics
-   * @returns {Object} Statistics with total and breakdown by type
-   */
-  getErrorStats() {
-    const stats = {
-      total: this.errors.length,
-      byType: {
-        ROUTING_ERROR: 0,
-        EXECUTION_ERROR: 0,
-        VALIDATION_ERROR: 0
-      }
-    };
-
-    this.errors.forEach(error => {
-      if (stats.byType[error.type] !== undefined) {
-        stats.byType[error.type]++;
-      }
-    });
-
-    return stats;
-  }
-
-  /**
-   * Clear all tracked errors
-   */
-  clearErrors() {
-    this.errors = [];
-  }
-}
-
-module.exports = ErrorTracker;

package/install/src/byan-v2/observability/logger.js

@@ -1,154 +0,0 @@
-/**
- * Logger - Winston-based structured logging
- * 
- * Features:
- * - JSON format logging
- * - File + Console output
- * - Methods: logTaskRouting(), logTaskExecution(), logError()
- */
-
-const winston = require('winston');
-const fs = require('fs');
-const path = require('path');
-
-class Logger {
-  constructor(options = {}) {
-    const {
-      logDir = path.join(process.cwd(), 'logs'),
-      logFile = 'byan.log',
-      consoleOutput = true,
-      level = 'info'
-    } = options;
-
-    this.logDir = logDir;
-    this.logFile = logFile;
-    this.logPath = path.join(logDir, logFile);
-
-    // Ensure log directory exists
-    if (!fs.existsSync(logDir)) {
-      fs.mkdirSync(logDir, { recursive: true });
-    }
-
-    // Configure transports
-    const transports = [
-      new winston.transports.File({
-        filename: this.logPath,
-        format: winston.format.json()
-      })
-    ];
-
-    if (consoleOutput) {
-      transports.push(
-        new winston.transports.Console({
-          format: winston.format.combine(
-            winston.format.colorize(),
-            winston.format.simple()
-          )
-        })
-      );
-    }
-
-    // Create Winston logger
-    this.logger = winston.createLogger({
-      level,
-      format: winston.format.combine(
-        winston.format.timestamp(),
-        winston.format.json()
-      ),
-      transports
-    });
-  }
-
-  /**
-   * Log task routing decision
-   * @param {Object} routingData - Routing decision data
-   */
-  logTaskRouting(routingData) {
-    if (!routingData) return;
-
-    const { task, executor, complexity, canFallback, reasoning } = routingData;
-
-    this.logger.info('Task routing decision', {
-      taskType: task?.type,
-      prompt: task?.prompt,
-      metadata: task?.metadata,
-      executor,
-      complexity,
-      canFallback,
-      reasoning
-    });
-  }
-
-  /**
-   * Log task execution result
-   * @param {Object} executionData - Execution result data
-   */
-  logTaskExecution(executionData) {
-    if (!executionData) return;
-
-    const { task, executor, duration, success, result, error, tokens } = executionData;
-
-    this.logger.info('Task execution completed', {
-      taskType: task?.type,
-      prompt: task?.prompt,
-      executor,
-      duration,
-      success,
-      result,
-      error,
-      tokens
-    });
-  }
-
-  /**
-   * Log error with context
-   * @param {Object} errorData - Error data with type, message, error, context
-   */
-  logError(errorData) {
-    if (!errorData) return;
-
-    const { type, message, error, context } = errorData;
-
-    this.logger.error(message || 'Error occurred', {
-      errorType: type,
-      stack: error?.stack,
-      context
-    });
-  }
-
-  /**
-   * Generic info log
-   * @param {string} message - Log message
-   * @param {Object} data - Additional data
-   */
-  info(message, data = {}) {
-    this.logger.info(message, data);
-  }
-
-  /**
-   * Generic warn log
-   * @param {string} message - Log message
-   * @param {Object} data - Additional data
-   */
-  warn(message, data = {}) {
-    this.logger.warn(message, data);
-  }
-
-  /**
-   * Generic error log
-   * @param {string} message - Log message
-   * @param {Object} data - Additional data
-   */
-  error(message, data = {}) {
-    this.logger.error(message, data);
-  }
-
-  /**
-   * Close logger and flush transports
-   */
-  close() {
-    this.logger.close();
-  }
-}
-
-module.exports = Logger;

package/install/src/byan-v2/observability/metrics-collector.js

@@ -1,194 +0,0 @@
-/**
- * MetricsCollector - Track task execution metrics
- * 
- * Tracks:
- * - tasksRouted, taskToolCalls, localExecutions
- * - totalTokens, totalDuration
- * - successfulTasks, failedTasks
- * - Averages (duration, tokens)
- * 
- * Methods:
- * - recordTaskRouting(routingData)
- * - recordTaskExecution(executionData)
- * - getMetrics()
- * - reset()
- */
-
-class MetricsCollector {
-  constructor() {
-    this.metrics = {
-      tasksRouted: 0,
-      taskToolCalls: 0,
-      localExecutions: 0,
-      totalTokens: 0,
-      totalDuration: 0,
-      successfulTasks: 0,
-      failedTasks: 0
-    };
-
-    this.counters = {
-      sessionsStarted: 0,
-      questionsAsked: 0,
-      analysesCompleted: 0,
-      profilesGenerated: 0,
-      errors: 0
-    };
-
-    this.taskHistory = [];
-  }
-
-  /**
-   * Increment a counter by name
-   * @param {string} counterName - Name of counter to increment
-   * @param {number} amount - Amount to increment by (default 1)
-   */
-  increment(counterName, amount = 1) {
-    if (this.counters.hasOwnProperty(counterName)) {
-      this.counters[counterName] += amount;
-    } else if (this.metrics.hasOwnProperty(counterName)) {
-      this.metrics[counterName] += amount;
-    } else {
-      this.counters[counterName] = amount;
-    }
-  }
-
-  /**
-   * Get summary of all metrics
-   * @returns {Object} Metrics summary
-   */
-  getSummary() {
-    const totalTasks = this.metrics.successfulTasks + this.metrics.failedTasks;
-    
-    return {
-      totalSessions: this.counters.sessionsStarted,
-      avgQuestionsPerSession: this.counters.sessionsStarted > 0
-        ? Math.round(this.counters.questionsAsked / this.counters.sessionsStarted)
-        : 0,
-      successRate: totalTasks > 0
-        ? Math.round((this.metrics.successfulTasks / totalTasks) * 100)
-        : 0,
-      delegationRate: this.metrics.tasksRouted > 0
-        ? Math.round((this.metrics.taskToolCalls / this.metrics.tasksRouted) * 100)
-        : 0,
-      ...this.counters,
-      ...this.metrics
-    };
-  }
-
-
-  /**
-   * Record task routing decision
-   * @param {Object} routingData - Routing decision data
-   */
-  recordTaskRouting(routingData) {
-    if (!routingData) return;
-
-    const { executor, complexity, task } = routingData;
-
-    // Increment counters
-    this.metrics.tasksRouted++;
-
-    if (executor === 'task-tool') {
-      this.metrics.taskToolCalls++;
-    } else if (executor === 'local') {
-      this.metrics.localExecutions++;
-    }
-
-    // Store in history
-    this.taskHistory.push({
-      type: 'routing',
-      timestamp: new Date().toISOString(),
-      executor,
-      complexity,
-      task
-    });
-  }
-
-  /**
-   * Record task execution result
-   * @param {Object} executionData - Execution result data
-   */
-  recordTaskExecution(executionData) {
-    if (!executionData) return;
-
-    const { duration, success, tokens, error } = executionData;
-
-    // Validate and record duration (reject negative)
-    if (duration !== undefined && duration >= 0) {
-      this.metrics.totalDuration += duration;
-    }
-
-    // Validate and record tokens (reject negative)
-    if (tokens !== undefined && tokens >= 0) {
-      this.metrics.totalTokens += tokens;
-    }
-
-    // Record success/failure
-    if (success === true) {
-      this.metrics.successfulTasks++;
-    } else if (success === false) {
-      this.metrics.failedTasks++;
-    }
-
-    // Store in history
-    this.taskHistory.push({
-      type: 'execution',
-      timestamp: new Date().toISOString(),
-      duration,
-      success,
-      tokens,
-      error
-    });
-  }
-
-  /**
-   * Get current metrics snapshot
-   * @returns {Object} Current metrics
-   */
-  getMetrics() {
-    const totalTasks = this.metrics.successfulTasks + this.metrics.failedTasks;
-
-    return {
-      tasksRouted: this.metrics.tasksRouted,
-      taskToolCalls: this.metrics.taskToolCalls,
-      localExecutions: this.metrics.localExecutions,
-      totalTokens: this.metrics.totalTokens,
-      totalDuration: this.metrics.totalDuration,
-      successfulTasks: this.metrics.successfulTasks,
-      failedTasks: this.metrics.failedTasks,
-      averageDuration: totalTasks > 0 
-        ? Math.round(this.metrics.totalDuration / totalTasks) 
-        : 0,
-      averageTokens: totalTasks > 0 
-        ? Math.round(this.metrics.totalTokens / totalTasks) 
-        : 0
-    };
-  }
-
-  /**
-   * Reset all metrics and history
-   */
-  reset() {
-    this.metrics = {
-      tasksRouted: 0,
-      taskToolCalls: 0,
-      localExecutions: 0,
-      totalTokens: 0,
-      totalDuration: 0,
-      successfulTasks: 0,
-      failedTasks: 0
-    };
-
-    this.counters = {
-      sessionsStarted: 0,
-      questionsAsked: 0,
-      analysesCompleted: 0,
-      profilesGenerated: 0,
-      errors: 0
-    };
-
-    this.taskHistory = [];
-  }
-}
-
-module.exports = MetricsCollector;