aicodeman 0.2.8 → 0.3.0

package/dist/ralph-stall-detector.js

@@ -0,0 +1,139 @@
+/**
+ * @fileoverview RalphStallDetector - Iteration stall detection
+ *
+ * Monitors iteration progress and emits warnings when the loop
+ * appears to be stalled (no iteration changes for extended periods).
+ *
+ * Extracted from ralph-tracker.ts as part of domain splitting.
+ *
+ * @module ralph-stall-detector
+ */
+import { EventEmitter } from 'node:events';
+/**
+ * RalphStallDetector - Detects iteration stalls in the Ralph loop.
+ *
+ * Events emitted:
+ * - `iterationStallWarning` - When iteration hasn't changed for warning threshold
+ * - `iterationStallCritical` - When iteration hasn't changed for critical threshold
+ */
+export class RalphStallDetector extends EventEmitter {
+    /** Timestamp when iteration count last changed */
+    _lastIterationChangeTime = 0;
+    /** Last observed iteration count for stall detection */
+    _lastObservedIteration = 0;
+    /** Timer for iteration stall detection */
+    _iterationStallTimer = null;
+    /** Iteration stall warning threshold (ms) - default 10 minutes */
+    _iterationStallWarningMs = 10 * 60 * 1000;
+    /** Iteration stall critical threshold (ms) - default 20 minutes */
+    _iterationStallCriticalMs = 20 * 60 * 1000;
+    /** Whether stall warning has been emitted */
+    _iterationStallWarned = false;
+    /** Whether the loop is currently active */
+    _loopActive = false;
+    constructor() {
+        super();
+        this._lastIterationChangeTime = Date.now();
+    }
+    /**
+     * Start iteration stall detection timer.
+     * Should be called when the loop becomes active.
+     */
+    startIterationStallDetection() {
+        this.stopIterationStallDetection();
+        this._lastIterationChangeTime = Date.now();
+        this._iterationStallWarned = false;
+        // Check every minute
+        this._iterationStallTimer = setInterval(() => {
+            this.checkIterationStall();
+        }, 60 * 1000);
+    }
+    /**
+     * Stop iteration stall detection timer.
+     */
+    stopIterationStallDetection() {
+        if (this._iterationStallTimer) {
+            clearInterval(this._iterationStallTimer);
+            this._iterationStallTimer = null;
+        }
+    }
+    /**
+     * Notify the detector that the iteration has changed.
+     * Resets stall tracking state.
+     */
+    notifyIterationChanged(iteration) {
+        this._lastIterationChangeTime = Date.now();
+        this._lastObservedIteration = iteration;
+        this._iterationStallWarned = false;
+    }
+    /**
+     * Set whether the loop is currently active.
+     * Stall detection only fires when loop is active.
+     */
+    setLoopActive(active) {
+        this._loopActive = active;
+    }
+    /**
+     * Check for iteration stall and emit appropriate events.
+     */
+    checkIterationStall() {
+        if (!this._loopActive)
+            return;
+        const stallDurationMs = Date.now() - this._lastIterationChangeTime;
+        // Critical stall (longer duration)
+        if (stallDurationMs >= this._iterationStallCriticalMs) {
+            this.emit('iterationStallCritical', {
+                iteration: this._lastObservedIteration,
+                stallDurationMs,
+            });
+            return;
+        }
+        // Warning stall
+        if (stallDurationMs >= this._iterationStallWarningMs && !this._iterationStallWarned) {
+            this._iterationStallWarned = true;
+            this.emit('iterationStallWarning', {
+                iteration: this._lastObservedIteration,
+                stallDurationMs,
+            });
+        }
+    }
+    /**
+     * Get iteration stall metrics for monitoring.
+     */
+    getIterationStallMetrics() {
+        return {
+            lastIterationChangeTime: this._lastIterationChangeTime,
+            stallDurationMs: Date.now() - this._lastIterationChangeTime,
+            warningThresholdMs: this._iterationStallWarningMs,
+            criticalThresholdMs: this._iterationStallCriticalMs,
+            isWarned: this._iterationStallWarned,
+            currentIteration: this._lastObservedIteration,
+        };
+    }
+    /**
+     * Configure iteration stall thresholds.
+     * @param warningMs - Warning threshold in milliseconds
+     * @param criticalMs - Critical threshold in milliseconds
+     */
+    configureIterationStallThresholds(warningMs, criticalMs) {
+        this._iterationStallWarningMs = warningMs;
+        this._iterationStallCriticalMs = criticalMs;
+    }
+    /**
+     * Reset stall detector state.
+     */
+    reset() {
+        this._lastIterationChangeTime = Date.now();
+        this._lastObservedIteration = 0;
+        this._iterationStallWarned = false;
+        this._loopActive = false;
+    }
+    /**
+     * Clean up all resources.
+     */
+    destroy() {
+        this.stopIterationStallDetection();
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=ralph-stall-detector.js.map

package/dist/ralph-stall-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-stall-detector.js","sourceRoot":"","sources":["../src/ralph-stall-detector.ts"],"names":[],"mappings":"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"}

package/dist/ralph-status-parser.d.ts

@@ -0,0 +1,141 @@
+/**
+ * @fileoverview RalphStatusParser - RALPH_STATUS block parsing and circuit breaker
+ *
+ * Parses structured RALPH_STATUS blocks from Claude Code output
+ * and manages the circuit breaker state machine.
+ *
+ * Extracted from ralph-tracker.ts as part of domain splitting.
+ *
+ * @module ralph-status-parser
+ */
+import { EventEmitter } from 'node:events';
+import type { RalphStatusBlock, CircuitBreakerStatus } from './types.js';
+/**
+ * RalphStatusParser - Parses RALPH_STATUS blocks and manages circuit breaker.
+ *
+ * Events emitted:
+ * - `statusBlockDetected` - When a complete RALPH_STATUS block is parsed
+ * - `circuitBreakerUpdate` - When circuit breaker state changes
+ * - `exitGateMet` - When dual-condition exit gate is met
+ */
+export declare class RalphStatusParser extends EventEmitter {
+    /** Circuit breaker state tracking */
+    private _circuitBreaker;
+    /** Buffer for RALPH_STATUS block lines */
+    private _statusBlockBuffer;
+    /** Flag indicating we're inside a RALPH_STATUS block */
+    private _inStatusBlock;
+    /** Last parsed RALPH_STATUS block */
+    private _lastStatusBlock;
+    /** Count of completion indicators detected (for dual-condition exit) */
+    private _completionIndicators;
+    /** Whether dual-condition exit gate has been met */
+    private _exitGateMet;
+    /** Cumulative files modified across all iterations */
+    private _totalFilesModified;
+    /** Cumulative tasks completed across all iterations */
+    private _totalTasksCompleted;
+    /** Current cycle count (fed by parent) */
+    private _cycleCount;
+    constructor();
+    /**
+     * Process a line for status block detection and completion indicators.
+     * Main entry point - call this for each trimmed line.
+     */
+    processLine(line: string): void;
+    /**
+     * Set the current cycle count (fed by parent for circuit breaker tracking).
+     */
+    setCycleCount(cycleCount: number): void;
+    /**
+     * Notify of iteration progress (for circuit breaker reset on progress).
+     * Called by parent when iteration count changes.
+     */
+    notifyIterationProgress(currentIteration: number): void;
+    /**
+     * Get current circuit breaker status.
+     */
+    get circuitBreakerStatus(): CircuitBreakerStatus;
+    /**
+     * Get last parsed RALPH_STATUS block.
+     */
+    get lastStatusBlock(): RalphStatusBlock | null;
+    /**
+     * Get cumulative stats from status blocks.
+     */
+    get cumulativeStats(): {
+        filesModified: number;
+        tasksCompleted: number;
+        completionIndicators: number;
+    };
+    /**
+     * Whether dual-condition exit gate has been met.
+     */
+    get exitGateMet(): boolean;
+    /**
+     * Manually reset circuit breaker to CLOSED state.
+     * Use when user acknowledges the issue is resolved.
+     *
+     * @fires circuitBreakerUpdate
+     */
+    resetCircuitBreaker(): void;
+    /**
+     * Reset status parser state (soft reset).
+     * Clears status block buffer and completion indicators.
+     * Keeps circuit breaker state (it tracks across iterations).
+     */
+    reset(): void;
+    /**
+     * Full reset - clears all state including circuit breaker.
+     */
+    fullReset(): void;
+    /**
+     * Clean up all resources.
+     */
+    destroy(): void;
+    /**
+     * Process a line for RALPH_STATUS block detection.
+     * Buffers lines between ---RALPH_STATUS--- and ---END_RALPH_STATUS---
+     * then parses the complete block.
+     *
+     * @param line - Single line to process (already trimmed)
+     * @fires statusBlockDetected - When a complete block is parsed
+     */
+    private processStatusBlockLine;
+    /**
+     * Parse buffered RALPH_STATUS block lines into structured data.
+     *
+     * P1-004: Enhanced with schema validation and error recovery
+     *
+     * @param lines - Array of lines between block markers
+     * @fires statusBlockDetected - When parsing succeeds
+     */
+    private parseStatusBlock;
+    /**
+     * Handle a parsed RALPH_STATUS block.
+     * Updates circuit breaker, checks exit conditions.
+     *
+     * @param block - Parsed status block
+     * @fires statusBlockDetected - With the block data
+     * @fires circuitBreakerUpdate - If state changes
+     * @fires exitGateMet - If dual-condition exit triggered
+     */
+    private handleStatusBlock;
+    /**
+     * Update circuit breaker state based on iteration results.
+     *
+     * @param hasProgress - Whether this iteration made progress
+     * @param testsStatus - Current test status
+     * @param status - Overall status from RALPH_STATUS
+     * @fires circuitBreakerUpdate - If state changes
+     */
+    private updateCircuitBreaker;
+    /**
+     * Check line for completion indicators (natural language patterns).
+     * Used for dual-condition exit gate.
+     *
+     * @param line - Line to check
+     */
+    private detectCompletionIndicators;
+}
+//# sourceMappingURL=ralph-status-parser.d.ts.map

package/dist/ralph-status-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-status-parser.d.ts","sourceRoot":"","sources":["../src/ralph-status-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,gBAAgB,EAIhB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AA2EpB;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,qCAAqC;IACrC,OAAO,CAAC,eAAe,CAAuB;IAE9C,0CAA0C;IAC1C,OAAO,CAAC,kBAAkB,CAAgB;IAE1C,wDAAwD;IACxD,OAAO,CAAC,cAAc,CAAkB;IAExC,qCAAqC;IACrC,OAAO,CAAC,gBAAgB,CAAiC;IAEzD,wEAAwE;IACxE,OAAO,CAAC,qBAAqB,CAAa;IAE1C,oDAAoD;IACpD,OAAO,CAAC,YAAY,CAAkB;IAEtC,sDAAsD;IACtD,OAAO,CAAC,mBAAmB,CAAa;IAExC,uDAAuD;IACvD,OAAO,CAAC,oBAAoB,CAAa;IAEzC,0CAA0C;IAC1C,OAAO,CAAC,WAAW,CAAa;;IAOhC;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIvC;;;OAGG;IACH,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAmBvD;;OAEG;IACH,IAAI,oBAAoB,IAAI,oBAAoB,CAE/C;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,gBAAgB,GAAG,IAAI,CAE7C;IAED;;OAEG;IACH,IAAI,eAAe,IAAI;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAMA;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;;OAKG;IACH,mBAAmB,IAAI,IAAI;IAO3B;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAWb;;OAEG;IACH,SAAS,IAAI,IAAI;IAKjB;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAqIxB;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAgE5B;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;CAQnC"}