@soulcraft/brainy 4.10.2 → 4.10.4

package/dist/utils/adaptiveBackpressure.d.ts

@@ -27,33 +27,40 @@ export declare class AdaptiveBackpressure {
     private metrics;
     private config;
     private patterns;
-    private circuitState;
-    private circuitOpenTime;
-    private circuitFailures;
-    private circuitThreshold;
-    private circuitTimeout;
+    private circuits;
     private operationTimes;
     private completedOps;
     private errorOps;
     private lastAdaptation;
     /**
      * Request permission to proceed with an operation
+     * @param operationId Unique ID for this operation
+     * @param priority Priority level (higher = more important)
+     * @param operationType Type of operation (read or write) for circuit breaker isolation
      */
-    requestPermission(operationId: string, priority?: number): Promise<void>;
+    requestPermission(operationId: string, priority?: number, operationType?: 'read' | 'write'): Promise<void>;
     /**
      * Release permission after operation completes
+     * @param operationId Unique ID for this operation
+     * @param success Whether the operation succeeded
+     * @param operationType Type of operation (read or write) for circuit breaker tracking
      */
-    releasePermission(operationId: string, success?: boolean): void;
+    releasePermission(operationId: string, success?: boolean, operationType?: 'read' | 'write'): void;
     /**
-     * Check if circuit breaker is open
+     * Check if circuit breaker is open for a specific operation type
+     * @param circuit The circuit to check (read or write)
      */
     private isCircuitOpen;
     /**
-     * Open the circuit breaker
+     * Open the circuit breaker for a specific operation type
+     * @param circuit The circuit to open (read or write)
+     * @param operationType The operation type name for logging
      */
     private openCircuit;
     /**
-     * Close the circuit breaker
+     * Close the circuit breaker for a specific operation type
+     * @param circuit The circuit to close (read or write)
+     * @param operationType The operation type name for logging
      */
     private closeCircuit;
     /**

package/dist/utils/adaptiveBackpressure.js

@@ -32,12 +32,24 @@ export class AdaptiveBackpressure {
         };
         // Historical patterns for learning
         this.patterns = [];
-        // Circuit breaker state
-        this.circuitState = 'closed';
-        this.circuitOpenTime = 0;
-        this.circuitFailures = 0;
-        this.circuitThreshold = 5;
-        this.circuitTimeout = 30000; // 30 seconds
+        // Separate circuit breakers for read vs write operations
+        // This allows reads to continue even when writes are throttled
+        this.circuits = {
+            read: {
+                state: 'closed',
+                failures: 0,
+                openTime: 0,
+                threshold: 10, // More lenient for reads
+                timeout: 30000
+            },
+            write: {
+                state: 'closed',
+                failures: 0,
+                openTime: 0,
+                threshold: 5, // Stricter for writes
+                timeout: 30000
+            }
+        };
         // Performance tracking
         this.operationTimes = new Map();
         this.completedOps = [];
@@ -46,11 +58,22 @@ export class AdaptiveBackpressure {
     }
     /**
      * Request permission to proceed with an operation
+     * @param operationId Unique ID for this operation
+     * @param priority Priority level (higher = more important)
+     * @param operationType Type of operation (read or write) for circuit breaker isolation
      */
-    async requestPermission(operationId, priority = 1) {
-        // Check circuit breaker
-        if (this.isCircuitOpen()) {
-            throw new Error('Circuit breaker is open - system is recovering');
+    async requestPermission(operationId, priority = 1, operationType = 'write') {
+        const circuit = this.circuits[operationType];
+        // Check circuit breaker for this operation type
+        if (this.isCircuitOpen(circuit)) {
+            // KEY: Allow reads even if write circuit is open
+            if (operationType === 'read' && this.circuits.write.state === 'open') {
+                // Write circuit is open but read circuit is fine - allow read
+                this.activeOperations.add(operationId);
+                this.operationTimes.set(operationId, Date.now());
+                return;
+            }
+            throw new Error(`Circuit breaker is open for ${operationType} operations - system is recovering`);
         }
         // Fast path for low load
         if (this.activeOperations.size < this.maxConcurrent * 0.5 && this.queue.length === 0) {
@@ -84,8 +107,11 @@ export class AdaptiveBackpressure {
     }
     /**
      * Release permission after operation completes
+     * @param operationId Unique ID for this operation
+     * @param success Whether the operation succeeded
+     * @param operationType Type of operation (read or write) for circuit breaker tracking
      */
-    releasePermission(operationId, success = true) {
+    releasePermission(operationId, success = true, operationType = 'write') {
         // Remove from active operations
         this.activeOperations.delete(operationId);
         // Track completion time
@@ -99,19 +125,20 @@ export class AdaptiveBackpressure {
                 this.completedOps = this.completedOps.slice(-500);
             }
         }
-        // Track errors for circuit breaker
+        // Track errors for circuit breaker per operation type
+        const circuit = this.circuits[operationType];
         if (!success) {
             this.errorOps++;
-            this.circuitFailures++;
-            // Check if we should open circuit
-            if (this.circuitFailures >= this.circuitThreshold) {
-                this.openCircuit();
+            circuit.failures++;
+            // Check if we should open circuit for this operation type
+            if (circuit.failures >= circuit.threshold) {
+                this.openCircuit(circuit, operationType);
             }
         }
         else {
             // Reset circuit failures on success
-            if (this.circuitState === 'half-open') {
-                this.closeCircuit();
+            if (circuit.state === 'half-open') {
+                this.closeCircuit(circuit, operationType);
             }
         }
         // Process queue if there are waiting operations
@@ -129,13 +156,14 @@ export class AdaptiveBackpressure {
         this.adaptIfNeeded();
     }
     /**
-     * Check if circuit breaker is open
+     * Check if circuit breaker is open for a specific operation type
+     * @param circuit The circuit to check (read or write)
      */
-    isCircuitOpen() {
-        if (this.circuitState === 'open') {
+    isCircuitOpen(circuit) {
+        if (circuit.state === 'open') {
             // Check if timeout has passed
-            if (Date.now() - this.circuitOpenTime > this.circuitTimeout) {
-                this.circuitState = 'half-open';
+            if (Date.now() - circuit.openTime > circuit.timeout) {
+                circuit.state = 'half-open';
                 this.logger.info('Circuit breaker entering half-open state');
                 return false;
             }
@@ -144,26 +172,34 @@ export class AdaptiveBackpressure {
         return false;
     }
     /**
-     * Open the circuit breaker
+     * Open the circuit breaker for a specific operation type
+     * @param circuit The circuit to open (read or write)
+     * @param operationType The operation type name for logging
      */
-    openCircuit() {
-        if (this.circuitState !== 'open') {
-            this.circuitState = 'open';
-            this.circuitOpenTime = Date.now();
-            this.logger.warn('Circuit breaker opened due to high error rate');
-            // Reduce load immediately
-            this.maxConcurrent = Math.max(10, Math.floor(this.maxConcurrent * 0.3));
+    openCircuit(circuit, operationType) {
+        if (circuit.state !== 'open') {
+            circuit.state = 'open';
+            circuit.openTime = Date.now();
+            this.logger.warn(`Circuit breaker opened for ${operationType} operations due to high error rate`);
+            // Reduce load immediately for write operations
+            if (operationType === 'write') {
+                this.maxConcurrent = Math.max(10, Math.floor(this.maxConcurrent * 0.3));
+            }
         }
     }
     /**
-     * Close the circuit breaker
+     * Close the circuit breaker for a specific operation type
+     * @param circuit The circuit to close (read or write)
+     * @param operationType The operation type name for logging
      */
-    closeCircuit() {
-        this.circuitState = 'closed';
-        this.circuitFailures = 0;
-        this.logger.info('Circuit breaker closed - system recovered');
-        // Gradually increase capacity
-        this.maxConcurrent = Math.min(500, Math.floor(this.maxConcurrent * 1.5));
+    closeCircuit(circuit, operationType) {
+        circuit.state = 'closed';
+        circuit.failures = 0;
+        this.logger.info(`Circuit breaker closed for ${operationType} - system recovered`);
+        // Gradually increase capacity for write operations
+        if (operationType === 'write') {
+            this.maxConcurrent = Math.min(500, Math.floor(this.maxConcurrent * 1.5));
+        }
     }
     /**
      * Adapt configuration based on metrics
@@ -262,13 +298,8 @@ export class AdaptiveBackpressure {
             // Allow queue depth to be 10 seconds worth of throughput
             this.config.maxQueueDepth = Math.max(100, Math.min(10000, Math.floor(this.metrics.throughput * 10)));
         }
-        // Adapt circuit breaker threshold based on error patterns
-        if (this.metrics.errorRate < 0.01 && this.circuitThreshold > 5) {
-            this.circuitThreshold = Math.max(5, this.circuitThreshold - 1);
-        }
-        else if (this.metrics.errorRate > 0.05 && this.circuitThreshold < 20) {
-            this.circuitThreshold = Math.min(20, this.circuitThreshold + 1);
-        }
+        // Note: Circuit breaker thresholds are now fixed per operation type (read/write)
+        // and do not adapt dynamically to maintain predictable behavior
     }
     /**
      * Predict future load based on patterns
@@ -303,10 +334,24 @@ export class AdaptiveBackpressure {
      * Get current configuration and metrics
      */
     getStatus() {
+        // Combined circuit status for backward compatibility
+        let circuitStatus = 'closed';
+        if (this.circuits.read.state === 'open' && this.circuits.write.state === 'open') {
+            circuitStatus = 'open';
+        }
+        else if (this.circuits.write.state === 'open') {
+            circuitStatus = 'write-circuit-open';
+        }
+        else if (this.circuits.read.state === 'open') {
+            circuitStatus = 'read-circuit-open';
+        }
+        else if (this.circuits.read.state === 'half-open' || this.circuits.write.state === 'half-open') {
+            circuitStatus = 'half-open';
+        }
         return {
             config: { ...this.config },
             metrics: { ...this.metrics },
-            circuit: this.circuitState,
+            circuit: circuitStatus,
             maxConcurrent: this.maxConcurrent,
             activeOps: this.activeOperations.size,
             queueLength: this.queue.length
@@ -322,8 +367,13 @@ export class AdaptiveBackpressure {
         this.completedOps = [];
         this.errorOps = 0;
         this.patterns = [];
-        this.circuitState = 'closed';
-        this.circuitFailures = 0;
+        // Reset both circuit breakers
+        this.circuits.read.state = 'closed';
+        this.circuits.read.failures = 0;
+        this.circuits.read.openTime = 0;
+        this.circuits.write.state = 'closed';
+        this.circuits.write.failures = 0;
+        this.circuits.write.openTime = 0;
         this.maxConcurrent = 100;
         this.logger.info('Backpressure system reset to defaults');
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "4.10.2",
+  "version": "4.10.4",
   "description": "Universal Knowledge Protocol™ - World's first Triple Intelligence database unifying vector, graph, and document search in one API. 31 nouns × 40 verbs for infinite expressiveness.",
   "main": "dist/index.js",
   "module": "dist/index.js",