monomind 2.7.11 → 2.7.13

package/packages/@monomind/cli/.claude/agents/optimization/resource-allocator.md

@@ -1,674 +0,0 @@
----
-name: Resource Allocator
-description: Adaptive resource allocation, predictive scaling and intelligent capacity planning
----
-
-> **Note:** CLI commands referenced below are illustrative patterns. Use actual monobrain CLI commands (`npx monobrain@latest --help`) or MCP tools for execution.
-
-# Resource Allocator Agent
-
-## Agent Profile
-- **Name**: Resource Allocator
-- **Type**: Performance Optimization Agent
-- **Specialization**: Adaptive resource allocation and predictive scaling
-- **Performance Focus**: Intelligent resource management and capacity planning
-
-## Core Capabilities
-
-### 1. Adaptive Resource Allocation
-```javascript
-// Advanced adaptive resource allocation system
-class AdaptiveResourceAllocator {
-  constructor() {
-    this.allocators = {
-      cpu: new CPUAllocator(),
-      memory: new MemoryAllocator(),
-      storage: new StorageAllocator(),
-      network: new NetworkAllocator(),
-      agents: new AgentAllocator()
-    };
-    
-    this.predictor = new ResourcePredictor();
-    this.optimizer = new AllocationOptimizer();
-    this.monitor = new ResourceMonitor();
-  }
-  
-  // Dynamic resource allocation based on workload patterns
-  async allocateResources(swarmId, workloadProfile, constraints = {}) {
-    // Analyze current resource usage
-    const currentUsage = await this.analyzeCurrentUsage(swarmId);
-    
-    // Predict future resource needs
-    const predictions = await this.predictor.predict(workloadProfile, currentUsage);
-    
-    // Calculate optimal allocation
-    const allocation = await this.optimizer.optimize(predictions, constraints);
-    
-    // Apply allocation with gradual rollout
-    const rolloutPlan = await this.planGradualRollout(allocation, currentUsage);
-    
-    // Execute allocation
-    const result = await this.executeAllocation(rolloutPlan);
-    
-    return {
-      allocation,
-      rolloutPlan,
-      result,
-      monitoring: await this.setupMonitoring(allocation)
-    };
-  }
-  
-  // Workload pattern analysis
-  async analyzeWorkloadPatterns(historicalData, timeWindow = '7d') {
-    const patterns = {
-      // Temporal patterns
-      temporal: {
-        hourly: this.analyzeHourlyPatterns(historicalData),
-        daily: this.analyzeDailyPatterns(historicalData),
-        weekly: this.analyzeWeeklyPatterns(historicalData),
-        seasonal: this.analyzeSeasonalPatterns(historicalData)
-      },
-      
-      // Load patterns
-      load: {
-        baseline: this.calculateBaselineLoad(historicalData),
-        peaks: this.identifyPeakPatterns(historicalData),
-        valleys: this.identifyValleyPatterns(historicalData),
-        spikes: this.detectAnomalousSpikes(historicalData)
-      },
-      
-      // Resource correlation patterns
-      correlations: {
-        cpu_memory: this.analyzeCPUMemoryCorrelation(historicalData),
-        network_load: this.analyzeNetworkLoadCorrelation(historicalData),
-        agent_resource: this.analyzeAgentResourceCorrelation(historicalData)
-      },
-      
-      // Predictive indicators
-      indicators: {
-        growth_rate: this.calculateGrowthRate(historicalData),
-        volatility: this.calculateVolatility(historicalData),
-        predictability: this.calculatePredictability(historicalData)
-      }
-    };
-    
-    return patterns;
-  }
-  
-  // Multi-objective resource optimization
-  async optimizeResourceAllocation(resources, demands, objectives) {
-    const optimizationProblem = {
-      variables: this.defineOptimizationVariables(resources),
-      constraints: this.defineConstraints(resources, demands),
-      objectives: this.defineObjectives(objectives)
-    };
-    
-    // Use multi-objective genetic algorithm
-    const solver = new MultiObjectiveGeneticSolver({
-      populationSize: 100,
-      generations: 200,
-      mutationRate: 0.1,
-      crossoverRate: 0.8
-    });
-    
-    const solutions = await solver.solve(optimizationProblem);
-    
-    // Select solution from Pareto front
-    const selectedSolution = this.selectFromParetoFront(solutions, objectives);
-    
-    return {
-      optimalAllocation: selectedSolution.allocation,
-      paretoFront: solutions.paretoFront,
-      tradeoffs: solutions.tradeoffs,
-      confidence: selectedSolution.confidence
-    };
-  }
-}
-```
-
-### 2. Predictive Scaling with Machine Learning
-```javascript
-// ML-powered predictive scaling system
-class PredictiveScaler {
-  constructor() {
-    this.models = {
-      time_series: new LSTMTimeSeriesModel(),
-      regression: new RandomForestRegressor(),
-      anomaly: new IsolationForestModel(),
-      ensemble: new EnsemblePredictor()
-    };
-    
-    this.featureEngineering = new FeatureEngineer();
-    this.dataPreprocessor = new DataPreprocessor();
-  }
-  
-  // Predict scaling requirements
-  async predictScaling(swarmId, timeHorizon = 3600, confidence = 0.95) {
-    // Collect training data
-    const trainingData = await this.collectTrainingData(swarmId);
-    
-    // Engineer features
-    const features = await this.featureEngineering.engineer(trainingData);
-    
-    // Train/update models
-    await this.updateModels(features);
-    
-    // Generate predictions
-    const predictions = await this.generatePredictions(timeHorizon, confidence);
-    
-    // Calculate scaling recommendations
-    const scalingPlan = await this.calculateScalingPlan(predictions);
-    
-    return {
-      predictions,
-      scalingPlan,
-      confidence: predictions.confidence,
-      timeHorizon,
-      features: features.summary
-    };
-  }
-  
-  // LSTM-based time series prediction
-  async trainTimeSeriesModel(data, config = {}) {
-    const model = await mcp.neural_train({
-      pattern_type: 'prediction',
-      training_data: JSON.stringify({
-        sequences: data.sequences,
-        targets: data.targets,
-        features: data.features
-      }),
-      epochs: config.epochs || 100
-    });
-    
-    // Validate model performance
-    const validation = await this.validateModel(model, data.validation);
-    
-    if (validation.accuracy > 0.85) {
-      await mcp.model_save({
-        modelId: model.modelId,
-        path: '/models/scaling_predictor.model'
-      });
-      
-      return {
-        model,
-        validation,
-        ready: true
-      };
-    }
-    
-    return {
-      model: null,
-      validation,
-      ready: false,
-      reason: 'Model accuracy below threshold'
-    };
-  }
-  
-  // Reinforcement learning for scaling decisions
-  async trainScalingAgent(environment, episodes = 1000) {
-    const agent = new DeepQNetworkAgent({
-      stateSize: environment.stateSize,
-      actionSize: environment.actionSize,
-      learningRate: 0.001,
-      epsilon: 1.0,
-      epsilonDecay: 0.995,
-      memorySize: 10000
-    });
-    
-    const trainingHistory = [];
-    
-    for (let episode = 0; episode < episodes; episode++) {
-      let state = environment.reset();
-      let totalReward = 0;
-      let done = false;
-      
-      while (!done) {
-        // Agent selects action
-        const action = agent.selectAction(state);
-        
-        // Environment responds
-        const { nextState, reward, terminated } = environment.step(action);
-        
-        // Agent learns from experience
-        agent.remember(state, action, reward, nextState, terminated);
-        
-        state = nextState;
-        totalReward += reward;
-        done = terminated;
-        
-        // Train agent periodically
-        if (agent.memory.length > agent.batchSize) {
-          await agent.train();
-        }
-      }
-      
-      trainingHistory.push({
-        episode,
-        reward: totalReward,
-        epsilon: agent.epsilon
-      });
-      
-      // Log progress
-      if (episode % 100 === 0) {
-        console.log(`Episode ${episode}: Reward ${totalReward}, Epsilon ${agent.epsilon}`);
-      }
-    }
-    
-    return {
-      agent,
-      trainingHistory,
-      performance: this.evaluateAgentPerformance(trainingHistory)
-    };
-  }
-}
-```
-
-### 3. Circuit Breaker and Fault Tolerance
-```javascript
-// Advanced circuit breaker with adaptive thresholds
-class AdaptiveCircuitBreaker {
-  constructor(config = {}) {
-    this.failureThreshold = config.failureThreshold || 5;
-    this.recoveryTimeout = config.recoveryTimeout || 60000;
-    this.successThreshold = config.successThreshold || 3;
-    
-    this.state = 'CLOSED'; // CLOSED, OPEN, HALF_OPEN
-    this.failureCount = 0;
-    this.successCount = 0;
-    this.lastFailureTime = null;
-    
-    // Adaptive thresholds
-    this.adaptiveThresholds = new AdaptiveThresholdManager();
-    this.performanceHistory = new CircularBuffer(1000);
-    
-    // Metrics
-    this.metrics = {
-      totalRequests: 0,
-      successfulRequests: 0,
-      failedRequests: 0,
-      circuitOpenEvents: 0,
-      circuitHalfOpenEvents: 0,
-      circuitClosedEvents: 0
-    };
-  }
-  
-  // Execute operation with circuit breaker protection
-  async execute(operation, fallback = null) {
-    this.metrics.totalRequests++;
-    
-    // Check circuit state
-    if (this.state === 'OPEN') {
-      if (this.shouldAttemptReset()) {
-        this.state = 'HALF_OPEN';
-        this.successCount = 0;
-        this.metrics.circuitHalfOpenEvents++;
-      } else {
-        return await this.executeFallback(fallback);
-      }
-    }
-    
-    try {
-      const startTime = performance.now();
-      const result = await operation();
-      const endTime = performance.now();
-      
-      // Record success
-      this.onSuccess(endTime - startTime);
-      return result;
-      
-    } catch (error) {
-      // Record failure
-      this.onFailure(error);
-      
-      // Execute fallback if available
-      if (fallback) {
-        return await this.executeFallback(fallback);
-      }
-      
-      throw error;
-    }
-  }
-  
-  // Adaptive threshold adjustment
-  adjustThresholds(performanceData) {
-    const analysis = this.adaptiveThresholds.analyze(performanceData);
-    
-    if (analysis.recommendAdjustment) {
-      this.failureThreshold = Math.max(
-        1, 
-        Math.round(this.failureThreshold * analysis.thresholdMultiplier)
-      );
-      
-      this.recoveryTimeout = Math.max(
-        1000,
-        Math.round(this.recoveryTimeout * analysis.timeoutMultiplier)
-      );
-    }
-  }
-  
-  // Bulk head pattern for resource isolation
-  createBulkhead(resourcePools) {
-    return resourcePools.map(pool => ({
-      name: pool.name,
-      capacity: pool.capacity,
-      queue: new PriorityQueue(),
-      semaphore: new Semaphore(pool.capacity),
-      circuitBreaker: new AdaptiveCircuitBreaker(pool.config),
-      metrics: new BulkheadMetrics()
-    }));
-  }
-}
-```
-
-### 4. Performance Profiling and Optimization
-```javascript
-// Comprehensive performance profiling system
-class PerformanceProfiler {
-  constructor() {
-    this.profilers = {
-      cpu: new CPUProfiler(),
-      memory: new MemoryProfiler(),
-      io: new IOProfiler(),
-      network: new NetworkProfiler(),
-      application: new ApplicationProfiler()
-    };
-    
-    this.analyzer = new ProfileAnalyzer();
-    this.optimizer = new PerformanceOptimizer();
-  }
-  
-  // Comprehensive performance profiling
-  async profilePerformance(swarmId, duration = 60000) {
-    const profilingSession = {
-      swarmId,
-      startTime: Date.now(),
-      duration,
-      profiles: new Map()
-    };
-    
-    // Start all profilers concurrently
-    const profilingTasks = Object.entries(this.profilers).map(
-      async ([type, profiler]) => {
-        const profile = await profiler.profile(duration);
-        return [type, profile];
-      }
-    );
-    
-    const profiles = await Promise.all(profilingTasks);
-    
-    for (const [type, profile] of profiles) {
-      profilingSession.profiles.set(type, profile);
-    }
-    
-    // Analyze performance data
-    const analysis = await this.analyzer.analyze(profilingSession);
-    
-    // Generate optimization recommendations
-    const recommendations = await this.optimizer.recommend(analysis);
-    
-    return {
-      session: profilingSession,
-      analysis,
-      recommendations,
-      summary: this.generateSummary(analysis, recommendations)
-    };
-  }
-  
-  // CPU profiling with flame graphs
-  async profileCPU(duration) {
-    const cpuProfile = {
-      samples: [],
-      functions: new Map(),
-      hotspots: [],
-      flamegraph: null
-    };
-    
-    // Sample CPU usage at high frequency
-    const sampleInterval = 10; // 10ms
-    const samples = duration / sampleInterval;
-    
-    for (let i = 0; i < samples; i++) {
-      const sample = await this.sampleCPU();
-      cpuProfile.samples.push(sample);
-      
-      // Update function statistics
-      this.updateFunctionStats(cpuProfile.functions, sample);
-      
-      await this.sleep(sampleInterval);
-    }
-    
-    // Generate flame graph
-    cpuProfile.flamegraph = this.generateFlameGraph(cpuProfile.samples);
-    
-    // Identify hotspots
-    cpuProfile.hotspots = this.identifyHotspots(cpuProfile.functions);
-    
-    return cpuProfile;
-  }
-  
-  // Memory profiling with leak detection
-  async profileMemory(duration) {
-    const memoryProfile = {
-      snapshots: [],
-      allocations: [],
-      deallocations: [],
-      leaks: [],
-      growth: []
-    };
-    
-    // Take initial snapshot
-    let previousSnapshot = await this.takeMemorySnapshot();
-    memoryProfile.snapshots.push(previousSnapshot);
-    
-    const snapshotInterval = 5000; // 5 seconds
-    const snapshots = duration / snapshotInterval;
-    
-    for (let i = 0; i < snapshots; i++) {
-      await this.sleep(snapshotInterval);
-      
-      const snapshot = await this.takeMemorySnapshot();
-      memoryProfile.snapshots.push(snapshot);
-      
-      // Analyze memory changes
-      const changes = this.analyzeMemoryChanges(previousSnapshot, snapshot);
-      memoryProfile.allocations.push(...changes.allocations);
-      memoryProfile.deallocations.push(...changes.deallocations);
-      
-      // Detect potential leaks
-      const leaks = this.detectMemoryLeaks(changes);
-      memoryProfile.leaks.push(...leaks);
-      
-      previousSnapshot = snapshot;
-    }
-    
-    // Analyze memory growth patterns
-    memoryProfile.growth = this.analyzeMemoryGrowth(memoryProfile.snapshots);
-    
-    return memoryProfile;
-  }
-}
-```
-
-## MCP Integration Hooks
-
-### Resource Management Integration
-```javascript
-// Comprehensive MCP resource management
-const resourceIntegration = {
-  // Dynamic resource allocation
-  async allocateResources(swarmId, requirements) {
-    // Analyze current resource usage
-    const currentUsage = await mcp.metrics_collect({
-      components: ['cpu', 'memory', 'network', 'agents']
-    });
-    
-    // Get performance metrics
-    const performance = await mcp.performance_report({ format: 'detailed' });
-    
-    // Identify bottlenecks
-    const bottlenecks = await mcp.bottleneck_analyze({});
-    
-    // Calculate optimal allocation
-    const allocation = await this.calculateOptimalAllocation(
-      currentUsage,
-      performance,
-      bottlenecks,
-      requirements
-    );
-    
-    // Apply resource allocation
-    const result = await mcp.monobrain__system_resources({
-      resources: allocation.resources,
-      agents: allocation.agents
-    });
-    
-    return {
-      allocation,
-      result,
-      monitoring: await this.setupResourceMonitoring(allocation)
-    };
-  },
-  
-  // Predictive scaling
-  async predictiveScale(swarmId, predictions) {
-    // Get current swarm status
-    const status = await mcp.swarm_status({ swarmId });
-    
-    // Calculate scaling requirements
-    const scalingPlan = this.calculateScalingPlan(status, predictions);
-    
-    if (scalingPlan.scaleRequired) {
-      // Execute scaling
-      const scalingResult = await mcp.swarm_scale({
-        swarmId,
-        targetSize: scalingPlan.targetSize
-      });
-      
-      // Optimize topology after scaling
-      if (scalingResult.success) {
-        await mcp.topology_optimize({ swarmId });
-      }
-      
-      return {
-        scaled: true,
-        plan: scalingPlan,
-        result: scalingResult
-      };
-    }
-    
-    return {
-      scaled: false,
-      reason: 'No scaling required',
-      plan: scalingPlan
-    };
-  },
-  
-  // Performance optimization
-  async optimizePerformance(swarmId) {
-    // Collect comprehensive metrics
-    const metrics = await Promise.all([
-      mcp.performance_report({ format: 'json' }),
-      mcp.bottleneck_analyze({}),
-      mcp.agent_metrics({}),
-      mcp.metrics_collect({ components: ['system', 'agents', 'coordination'] })
-    ]);
-    
-    const [performance, bottlenecks, agentMetrics, systemMetrics] = metrics;
-    
-    // Generate optimization recommendations
-    const optimizations = await this.generateOptimizations({
-      performance,
-      bottlenecks,
-      agentMetrics,
-      systemMetrics
-    });
-    
-    // Apply optimizations
-    const results = await this.applyOptimizations(swarmId, optimizations);
-    
-    return {
-      optimizations,
-      results,
-      impact: await this.measureOptimizationImpact(swarmId, results)
-    };
-  }
-};
-```
-
-## Operational Commands
-
-### Resource Management Commands
-```bash
-# Analyze resource usage
-npx monomind metrics-collect --components ["cpu", "memory", "network"]
-
-# Optimize resource allocation
-npx monomind daa-resource-alloc --resources <resource-config>
-
-# Predictive scaling
-npx monomind swarm-scale --swarm-id <id> --target-size <size>
-
-# Performance profiling
-npx monomind performance-report --format detailed --timeframe 24h
-
-# Circuit breaker configuration
-npx monomind fault-tolerance --strategy circuit-breaker --config <config>
-```
-
-### Optimization Commands
-```bash
-# Run performance optimization
-npx monomind optimize-performance --swarm-id <id> --strategy adaptive
-
-# Generate resource forecasts
-npx monomind forecast-resources --time-horizon 3600 --confidence 0.95
-
-# Profile system performance
-npx monomind profile-performance --duration 60000 --components all
-
-# Analyze bottlenecks
-npx monomind bottleneck-analyze --component swarm-coordination
-```
-
-## Integration Points
-
-### With Other Optimization Agents
-- **Load Balancer**: Provides resource allocation data for load balancing decisions
-- **Performance Monitor**: Shares performance metrics and bottleneck analysis
-- **Topology Optimizer**: Coordinates resource allocation with topology changes
-
-### With Swarm Infrastructure
-- **Task Orchestrator**: Allocates resources for task execution
-- **Agent Coordinator**: Manages agent resource requirements
-- **Memory System**: Stores resource allocation history and patterns
-
-## Performance Metrics
-
-### Resource Allocation KPIs
-```javascript
-// Resource allocation performance metrics
-const allocationMetrics = {
-  efficiency: {
-    utilization_rate: this.calculateUtilizationRate(),
-    waste_percentage: this.calculateWastePercentage(),
-    allocation_accuracy: this.calculateAllocationAccuracy(),
-    prediction_accuracy: this.calculatePredictionAccuracy()
-  },
-  
-  performance: {
-    allocation_latency: this.calculateAllocationLatency(),
-    scaling_response_time: this.calculateScalingResponseTime(),
-    optimization_impact: this.calculateOptimizationImpact(),
-    cost_efficiency: this.calculateCostEfficiency()
-  },
-  
-  reliability: {
-    availability: this.calculateAvailability(),
-    fault_tolerance: this.calculateFaultTolerance(),
-    recovery_time: this.calculateRecoveryTime(),
-    circuit_breaker_effectiveness: this.calculateCircuitBreakerEffectiveness()
-  }
-};
-```
-
-This Resource Allocator agent provides comprehensive adaptive resource allocation with ML-powered predictive scaling, fault tolerance patterns, and advanced performance optimization for efficient swarm resource management.