Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

Checkpoint: File edits

rUv9d11dadc739b
diff --git a/v3/@claude-flow/cli/src/production/circuit-breaker.ts b/v3/@claude-flow/cli/src/production/circuit-breaker.ts
new file mode 100644
index 0000000000..ce7bf6ae09
--- /dev/null
+++ b/v3/@claude-flow/cli/src/production/circuit-breaker.ts
@@ -0,0 +1,322 @@
+/**
+ * Production Circuit Breaker
+ *
+ * Implements the circuit breaker pattern to prevent cascading failures:
+ * - Closed: Normal operation
+ * - Open: Failing fast, not calling service
+ * - Half-Open: Testing if service recovered
+ *
+ * @module @claude-flow/cli/production/circuit-breaker
+ */
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type CircuitState = 'closed' | 'open' | 'half-open';
+
+export interface CircuitBreakerConfig {
+ // Number of failures before opening circuit
+ failureThreshold: number;
+ // Time to wait before transitioning to half-open (ms)
+ resetTimeoutMs: number;
+ // Number of successes needed in half-open to close
+ successThreshold: number;
+ // Time window for counting failures (ms)
+ failureWindowMs: number;
+ // Percentage of requests to let through in half-open
+ halfOpenRequestPercentage: number;
+ // Called when state changes
+ onStateChange?: (from: CircuitState, to: CircuitState) => void;
+ // Called when circuit opens
+ onOpen?: (failures: number) => void;
+ // Called when circuit closes
+ onClose?: () => void;
+}
+
+export interface CircuitStats {
+ state: CircuitState;
+ failures: number;
+ successes: number;
+ lastFailure: Date | null;
+ lastSuccess: Date | null;
+ stateChangedAt: Date;
+ totalRequests: number;
+ totalFailures: number;
+ totalSuccesses: number;
+}
+
+// ============================================================================
+// Default Configuration
+// ============================================================================
+
+const DEFAULT_CONFIG: CircuitBreakerConfig = {
+ failureThreshold: 5,
+ resetTimeoutMs: 30000,
+ successThreshold: 3,
+ failureWindowMs: 60000,
+ halfOpenRequestPercentage: 0.1,
+};
+
+// ============================================================================
+// Circuit Breaker Implementation
+// ============================================================================
+
+export class CircuitBreaker {
+ private config: CircuitBreakerConfig;
+ private state: CircuitState = 'closed';
+ private failures: number[] = [];
+ private successCount = 0;
+ private stateChangedAt = Date.now();
+ private totalRequests = 0;
+ private totalFailures = 0;
+ private totalSuccesses = 0;
+ private lastFailure: Date | null = null;
+ private lastSuccess: Date | null = null;
+
+ constructor(config: Partial<CircuitBreakerConfig> = {}) {
+ this.config = { ...DEFAULT_CONFIG, ...config };
+ }
+
+ /**
+ * Get current circuit state
+ */
+ getState(): CircuitState {
+ this.checkStateTransition();
+ return this.state;
+ }
+
+ /**
+ * Check if request is allowed
+ */
+ isAllowed(): boolean {
+ this.checkStateTransition();
+
+ switch (this.state) {
+ case 'closed':
+ return true;
+
+ case 'open':
+ return false;
+
+ case 'half-open':
+ // Allow a percentage of requests through
+ return Math.random() < this.config.halfOpenRequestPercentage;
+
+ default:
+ return true;
+ }
+ }
+
+ /**
+ * Execute a function through the circuit breaker
+ */
+ async execute<T>(fn: () => Promise<T>): Promise<T> {
+ if (!this.isAllowed()) {
+ throw new Error('Circuit breaker is open. Service temporarily unavailable.');
+ }
+
+ this.totalRequests++;
+
+ try {
+ const result = await fn();
+ this.recordSuccess();
+ return result;
+ } catch (error) {
+ this.recordFailure();
+ throw error;
+ }
+ }
+
+ /**
+ * Record a successful operation
+ */
+ recordSuccess(): void {
+ this.totalSuccesses++;
+ this.lastSuccess = new Date();
+
+ if (this.state === 'half-open') {
+ this.successCount++;
+
+ if (this.successCount >= this.config.successThreshold) {
+ this.transitionTo('closed');
+ }
+ }
+
+ // Reset failure count on success in closed state
+ if (this.state === 'closed') {
+ this.failures = [];
+ }
+ }
+
+ /**
+ * Record a failed operation
+ */
+ recordFailure(): void {
+ const now = Date.now();
+ this.totalFailures++;
+ this.lastFailure = new Date();
+
+ // Add failure timestamp
+ this.failures.push(now);
+
+ // Clean old failures outside window
+ this.failures = this.failures.filter(
+ t => t > now - this.config.failureWindowMs
+ );
+
+ // Check if we should open the circuit
+ if (this.state === 'closed' && this.failures.length >= this.config.failureThreshold) {
+ this.transitionTo('open');
+ if (this.config.onOpen) {
+ this.config.onOpen(this.failures.length);
+ }
+ }
+
+ // If half-open and we fail, go back to open
+ if (this.state === 'half-open') {
+ this.transitionTo('open');
+ }
+ }
+
+ /**
+ * Manually open the circuit
+ */
+ open(): void {
+ if (this.state !== 'open') {
+ this.transitionTo('open');
+ }
+ }
+
+ /**
+ * Manually close the circuit
+ */
+ close(): void {
+ if (this.state !== 'closed') {
+ this.transitionTo('closed');
+ }
+ }
+
+ /**
+ * Reset the circuit breaker
+ */
+ reset(): void {
+ this.state = 'closed';
+ this.failures = [];
+ this.successCount = 0;
+ this.stateChangedAt = Date.now();
+ this.totalRequests = 0;
+ this.totalFailures = 0;
+ this.totalSuccesses = 0;
+ this.lastFailure = null;
+ this.lastSuccess = null;
+ }
+
+ /**
+ * Get circuit statistics
+ */
+ getStats(): CircuitStats {
+ return {
+ state: this.state,
+ failures: this.failures.length,
+ successes: this.successCount,
+ lastFailure: this.lastFailure,
+ lastSuccess: this.lastSuccess,
+ stateChangedAt: new Date(this.stateChangedAt),
+ totalRequests: this.totalRequests,
+ totalFailures: this.totalFailures,
+ totalSuccesses: this.totalSuccesses,
+ };
+ }
+
+ /**
+ * Get failure rate
+ */
+ getFailureRate(): number {
+ if (this.totalRequests === 0) return 0;
+ return this.totalFailures / this.totalRequests;
+ }
+
+ // ============================================================================
+ // Private Methods
+ // ============================================================================
+
+ private checkStateTransition(): void {
+ const now = Date.now();
+
+ if (this.state === 'open') {
+ // Check if we should transition to half-open
+ if (now - this.stateChangedAt >= this.config.resetTimeoutMs) {
+ this.transitionTo('half-open');
+ }
+ }
+ }
+
+ private transitionTo(newState: CircuitState): void {
+ const oldState = this.state;
+
+ if (oldState === newState) return;
+
+ this.state = newState;
+ this.stateChangedAt = Date.now();
+
+ // Reset counters on state change
+ if (newState === 'half-open') {
+ this.successCount = 0;
+ }
+
+ if (newState === 'closed') {
+ this.failures = [];
+ this.successCount = 0;
+ if (this.config.onClose) {
+ this.config.onClose();
+ }
+ }
+
+ // Notify state change
+ if (this.config.onStateChange) {
+ this.config.onStateChange(oldState, newState);
+ }
+ }
+}
+
+// ============================================================================
+// Circuit Breaker Registry
+// ============================================================================
+
+const circuitBreakers = new Map<string, CircuitBreaker>();
+
+/**
+ * Get or create a circuit breaker by name
+ */
+export function getCircuitBreaker(
+ name: string,
+ config?: Partial<CircuitBreakerConfig>
+): CircuitBreaker {
+ if (!circuitBreakers.has(name)) {
+ circuitBreakers.set(name, new CircuitBreaker(config));
+ }
+ return circuitBreakers.get(name)!;
+}
+
+/**
+ * Get all circuit breaker stats
+ */
+export function getAllCircuitStats(): Record<string, CircuitStats> {
+ const stats: Record<string, CircuitStats> = {};
+ for (const [name, breaker] of circuitBreakers) {
+ stats[name] = breaker.getStats();
+ }
+ return stats;
+}
+
+/**
+ * Reset all circuit breakers
+ */
+export function resetAllCircuits(): void {
+ for (const breaker of circuitBreakers.values()) {
+ breaker.reset();
+ }
+}
+
+export default CircuitBreaker;