claude-flow 2.0.0-alpha.71 → 2.0.0-alpha.73

package/.claude/agents/consensus/README.md

@@ -0,0 +1,246 @@
+# Distributed Consensus Builder Agents
+
+## Overview
+
+This directory contains specialized agents for implementing advanced distributed consensus mechanisms and fault-tolerant coordination protocols. These agents work together to provide robust, scalable consensus capabilities for distributed swarm systems.
+
+## Agent Collection
+
+### Core Consensus Protocols
+
+#### 1. **Byzantine Consensus Coordinator** (`byzantine-coordinator.md`)
+- **Mission**: Implement Byzantine fault-tolerant consensus algorithms for secure decision-making
+- **Key Features**:
+  - PBFT (Practical Byzantine Fault Tolerance) implementation
+  - Malicious agent detection and isolation
+  - Threshold signature schemes
+  - Network partition recovery protocols
+  - DoS protection and rate limiting
+
+#### 2. **Raft Consensus Manager** (`raft-manager.md`)
+- **Mission**: Implement Raft consensus algorithm with leader election and log replication
+- **Key Features**:
+  - Leader election with randomized timeouts
+  - Log replication and consistency guarantees
+  - Follower synchronization and catch-up mechanisms
+  - Snapshot creation and log compaction
+  - Leadership transfer protocols
+
+#### 3. **Gossip Protocol Coordinator** (`gossip-coordinator.md`)
+- **Mission**: Implement epidemic information dissemination for scalable communication
+- **Key Features**:
+  - Push/Pull/Hybrid gossip protocols
+  - Anti-entropy state synchronization
+  - Membership management and failure detection
+  - Network topology discovery
+  - Adaptive gossip parameter tuning
+
+### Security and Cryptography
+
+#### 4. **Security Manager** (`security-manager.md`)
+- **Mission**: Provide comprehensive security mechanisms for consensus protocols
+- **Key Features**:
+  - Threshold cryptography and signature schemes
+  - Zero-knowledge proof systems
+  - Attack detection and mitigation (Byzantine, Sybil, Eclipse, DoS)
+  - Secure key management and distribution
+  - End-to-end encryption for consensus traffic
+
+### State Synchronization
+
+#### 5. **CRDT Synchronizer** (`crdt-synchronizer.md`)
+- **Mission**: Implement Conflict-free Replicated Data Types for eventual consistency
+- **Key Features**:
+  - State-based and operation-based CRDTs
+  - G-Counter, PN-Counter, OR-Set, LWW-Register implementations
+  - RGA (Replicated Growable Array) for sequences
+  - Delta-state CRDT optimization
+  - Causal consistency tracking
+
+### Performance and Optimization
+
+#### 6. **Performance Benchmarker** (`performance-benchmarker.md`)
+- **Mission**: Comprehensive performance analysis and optimization for consensus protocols
+- **Key Features**:
+  - Throughput and latency measurement
+  - Resource utilization monitoring
+  - Comparative protocol analysis
+  - Adaptive performance tuning
+  - Real-time optimization recommendations
+
+#### 7. **Quorum Manager** (`quorum-manager.md`)
+- **Mission**: Dynamic quorum adjustment based on network conditions and fault tolerance
+- **Key Features**:
+  - Network-based quorum strategies
+  - Performance-optimized quorum sizing
+  - Fault tolerance analysis and optimization
+  - Intelligent membership management
+  - Predictive quorum adjustments
+
+## Architecture Integration
+
+### MCP Integration Points
+
+All consensus agents integrate with the MCP (Model Context Protocol) coordination system:
+
+```javascript
+// Memory coordination for persistent state
+await this.mcpTools.memory_usage({
+  action: 'store',
+  key: 'consensus_state',
+  value: JSON.stringify(consensusData),
+  namespace: 'distributed_consensus'
+});
+
+// Performance monitoring
+await this.mcpTools.metrics_collect({
+  components: ['consensus_latency', 'throughput', 'fault_tolerance']
+});
+
+// Task orchestration
+await this.mcpTools.task_orchestrate({
+  task: 'consensus_round',
+  strategy: 'parallel',
+  priority: 'high'
+});
+```
+
+### Swarm Coordination
+
+Agents coordinate with the broader swarm infrastructure:
+
+- **Node Discovery**: Integration with swarm node discovery mechanisms
+- **Health Monitoring**: Consensus participation in distributed health checks  
+- **Load Balancing**: Dynamic load distribution across consensus participants
+- **Fault Recovery**: Coordinated recovery from node and network failures
+
+## Usage Patterns
+
+### Basic Consensus Setup
+
+```javascript
+// Initialize Byzantine consensus for high-security scenarios
+const byzantineConsensus = new ByzantineConsensusCoordinator('node-1', 7, 2);
+await byzantineConsensus.initializeNode();
+
+// Initialize Raft for leader-based coordination
+const raftConsensus = new RaftConsensusManager('node-1', ['node-1', 'node-2', 'node-3']);
+await raftConsensus.initialize();
+
+// Initialize Gossip for scalable information dissemination
+const gossipCoordinator = new GossipProtocolCoordinator('node-1', ['seed-1', 'seed-2']);
+await gossipCoordinator.initialize();
+```
+
+### Security-Enhanced Consensus
+
+```javascript
+// Add security layer to consensus protocols
+const securityManager = new SecurityManager();
+await securityManager.generateDistributedKeys(participants, threshold);
+
+const secureConsensus = new SecureConsensusWrapper(
+  byzantineConsensus, 
+  securityManager
+);
+```
+
+### Performance Optimization
+
+```javascript
+// Benchmark and optimize consensus performance
+const benchmarker = new ConsensusPerformanceBenchmarker();
+const results = await benchmarker.runComprehensiveBenchmarks(
+  ['byzantine', 'raft', 'gossip'],
+  scenarios
+);
+
+// Apply adaptive optimizations
+const optimizer = new AdaptiveOptimizer();
+await optimizer.optimizeBasedOnResults(results);
+```
+
+### State Synchronization
+
+```javascript
+// Set up CRDT-based state synchronization
+const crdtSynchronizer = new CRDTSynchronizer('node-1', replicationGroup);
+const counter = crdtSynchronizer.registerCRDT('request_counter', 'G_COUNTER');
+const userSet = crdtSynchronizer.registerCRDT('active_users', 'OR_SET');
+
+await crdtSynchronizer.synchronize();
+```
+
+## Advanced Features
+
+### Fault Tolerance
+
+- **Byzantine Fault Tolerance**: Handles up to f < n/3 malicious nodes
+- **Crash Fault Tolerance**: Recovers from node failures and network partitions
+- **Network Partition Tolerance**: Maintains consistency during network splits
+- **Graceful Degradation**: Continues operation with reduced functionality
+
+### Scalability
+
+- **Horizontal Scaling**: Add/remove nodes dynamically
+- **Load Distribution**: Distribute consensus load across available resources
+- **Gossip-based Dissemination**: Logarithmic message complexity
+- **Delta Synchronization**: Efficient incremental state updates
+
+### Security
+
+- **Cryptographic Primitives**: Ed25519 signatures, threshold cryptography
+- **Attack Mitigation**: Protection against Byzantine, Sybil, Eclipse, and DoS attacks
+- **Zero-Knowledge Proofs**: Privacy-preserving consensus verification
+- **Secure Communication**: TLS 1.3 with forward secrecy
+
+### Performance
+
+- **Adaptive Optimization**: Real-time parameter tuning based on performance
+- **Resource Monitoring**: CPU, memory, network, and storage utilization
+- **Bottleneck Detection**: Automatic identification of performance constraints
+- **Predictive Scaling**: Anticipate resource needs before bottlenecks occur
+
+## Testing and Validation
+
+### Consensus Correctness
+- **Safety Properties**: Verify agreement and validity properties
+- **Liveness Properties**: Ensure progress under normal conditions
+- **Fault Injection**: Test behavior under various failure scenarios
+- **Formal Verification**: Mathematical proofs of correctness
+
+### Performance Testing
+- **Load Testing**: High-throughput consensus scenarios
+- **Latency Analysis**: End-to-end latency measurement and optimization
+- **Scalability Testing**: Performance with varying cluster sizes
+- **Resource Efficiency**: Optimize resource utilization
+
+### Security Validation
+- **Penetration Testing**: Simulated attacks on consensus protocols
+- **Cryptographic Verification**: Validate security of cryptographic schemes
+- **Threat Modeling**: Analyze potential attack vectors
+- **Compliance Testing**: Ensure adherence to security standards
+
+## Deployment Considerations
+
+### Network Requirements
+- **Bandwidth**: Sufficient bandwidth for consensus message traffic
+- **Latency**: Low-latency network connections between nodes
+- **Reliability**: Stable network connectivity for consensus participants
+- **Security**: Encrypted communication channels
+
+### Resource Requirements
+- **CPU**: Adequate processing power for cryptographic operations
+- **Memory**: Sufficient RAM for consensus state and message buffers
+- **Storage**: Persistent storage for consensus logs and state
+- **Redundancy**: Multiple nodes for fault tolerance
+
+### Monitoring and Observability
+- **Metrics Collection**: Real-time performance and health metrics
+- **Alerting**: Notifications for consensus failures or degraded performance
+- **Logging**: Comprehensive audit trails for consensus operations
+- **Dashboards**: Visual monitoring of consensus health and performance
+
+## Integration Examples
+
+See individual agent files for detailed implementation examples and integration patterns with specific consensus protocols and use cases.

package/.claude/agents/consensus/byzantine-coordinator.md

@@ -0,0 +1,63 @@
+---
+name: byzantine-coordinator
+type: coordinator
+color: "#9C27B0"
+description: Coordinates Byzantine fault-tolerant consensus protocols with malicious actor detection
+capabilities:
+  - pbft_consensus
+  - malicious_detection
+  - message_authentication
+  - view_management
+  - attack_mitigation
+priority: high
+hooks:
+  pre: |
+    echo "🛡️  Byzantine Coordinator initiating: $TASK"
+    # Verify network integrity before consensus
+    if [[ "$TASK" == *"consensus"* ]]; then
+      echo "🔍 Checking for malicious actors..."
+    fi
+  post: |
+    echo "✅ Byzantine consensus complete"
+    # Validate consensus results
+    echo "🔐 Verifying message signatures and ordering"
+---
+
+# Byzantine Consensus Coordinator
+
+Coordinates Byzantine fault-tolerant consensus protocols ensuring system integrity and reliability in the presence of malicious actors.
+
+## Core Responsibilities
+
+1. **PBFT Protocol Management**: Execute three-phase practical Byzantine fault tolerance
+2. **Malicious Actor Detection**: Identify and isolate Byzantine behavior patterns
+3. **Message Authentication**: Cryptographic verification of all consensus messages
+4. **View Change Coordination**: Handle leader failures and protocol transitions
+5. **Attack Mitigation**: Defend against known Byzantine attack vectors
+
+## Implementation Approach
+
+### Byzantine Fault Tolerance
+- Deploy PBFT three-phase protocol for secure consensus
+- Maintain security with up to f < n/3 malicious nodes
+- Implement threshold signature schemes for message validation
+- Execute view changes for primary node failure recovery
+
+### Security Integration
+- Apply cryptographic signatures for message authenticity
+- Implement zero-knowledge proofs for vote verification
+- Deploy replay attack prevention with sequence numbers
+- Execute DoS protection through rate limiting
+
+### Network Resilience
+- Detect network partitions automatically
+- Reconcile conflicting states after partition healing
+- Adjust quorum size dynamically based on connectivity
+- Implement systematic recovery protocols
+
+## Collaboration
+
+- Coordinate with Security Manager for cryptographic validation
+- Interface with Quorum Manager for fault tolerance adjustments
+- Integrate with Performance Benchmarker for optimization metrics
+- Synchronize with CRDT Synchronizer for state consistency