@litmers/cursorflow-orchestrator 0.1.20 → 0.1.28

package/dist/utils/retry.js

@@ -0,0 +1,374 @@
+"use strict";
+/**
+ * Enhanced retry logic with exponential backoff and circuit breaker
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreaker = exports.CircuitState = exports.DEFAULT_CIRCUIT_BREAKER_CONFIG = exports.DEFAULT_RETRY_CONFIG = void 0;
+exports.getCircuitBreaker = getCircuitBreaker;
+exports.calculateDelay = calculateDelay;
+exports.sleep = sleep;
+exports.withTimeout = withTimeout;
+exports.withEnhancedRetry = withEnhancedRetry;
+exports.isTransientError = isTransientError;
+exports.isPermanentError = isPermanentError;
+exports.defaultShouldRetry = defaultShouldRetry;
+const logger = __importStar(require("./logger"));
+exports.DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffFactor: 2,
+    jitter: true,
+    attemptTimeoutMs: undefined,
+};
+exports.DEFAULT_CIRCUIT_BREAKER_CONFIG = {
+    failureThreshold: 5,
+    resetTimeoutMs: 60000,
+    successThreshold: 2,
+};
+var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (exports.CircuitState = CircuitState = {}));
+/**
+ * Circuit breaker implementation for managing service availability
+ */
+class CircuitBreaker {
+    state = CircuitState.CLOSED;
+    failureCount = 0;
+    successCount = 0;
+    lastFailureTime = 0;
+    config;
+    name;
+    constructor(name, config = {}) {
+        this.name = name;
+        this.config = { ...exports.DEFAULT_CIRCUIT_BREAKER_CONFIG, ...config };
+    }
+    /**
+     * Check if circuit allows a call
+     */
+    canCall() {
+        if (this.state === CircuitState.CLOSED) {
+            return true;
+        }
+        if (this.state === CircuitState.OPEN) {
+            // Check if enough time has passed to try again
+            if (Date.now() - this.lastFailureTime >= this.config.resetTimeoutMs) {
+                this.state = CircuitState.HALF_OPEN;
+                this.successCount = 0;
+                logger.info(`[CircuitBreaker:${this.name}] Transitioning to HALF_OPEN`);
+                return true;
+            }
+            return false;
+        }
+        // HALF_OPEN - allow limited calls
+        return true;
+    }
+    /**
+     * Record a successful call
+     */
+    recordSuccess() {
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.successCount++;
+            if (this.successCount >= this.config.successThreshold) {
+                this.state = CircuitState.CLOSED;
+                this.failureCount = 0;
+                logger.info(`[CircuitBreaker:${this.name}] Circuit CLOSED after recovery`);
+            }
+        }
+        else if (this.state === CircuitState.CLOSED) {
+            // Reset failure count on success
+            this.failureCount = Math.max(0, this.failureCount - 1);
+        }
+    }
+    /**
+     * Record a failed call
+     */
+    recordFailure() {
+        this.failureCount++;
+        this.lastFailureTime = Date.now();
+        if (this.state === CircuitState.HALF_OPEN) {
+            // Immediately open circuit on failure in half-open state
+            this.state = CircuitState.OPEN;
+            logger.warn(`[CircuitBreaker:${this.name}] Circuit OPEN (failure in half-open state)`);
+        }
+        else if (this.state === CircuitState.CLOSED && this.failureCount >= this.config.failureThreshold) {
+            this.state = CircuitState.OPEN;
+            logger.warn(`[CircuitBreaker:${this.name}] Circuit OPEN (threshold reached: ${this.failureCount} failures)`);
+        }
+    }
+    /**
+     * Get current circuit state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get time until circuit might close (for OPEN state)
+     */
+    getTimeUntilRetry() {
+        if (this.state !== CircuitState.OPEN) {
+            return 0;
+        }
+        return Math.max(0, this.config.resetTimeoutMs - (Date.now() - this.lastFailureTime));
+    }
+    /**
+     * Force reset the circuit breaker
+     */
+    reset() {
+        this.state = CircuitState.CLOSED;
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.lastFailureTime = 0;
+    }
+    /**
+     * Get circuit breaker status for monitoring
+     */
+    getStatus() {
+        return {
+            state: this.state,
+            failureCount: this.failureCount,
+            timeUntilRetry: this.getTimeUntilRetry(),
+        };
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+/**
+ * Global circuit breaker registry
+ */
+const circuitBreakers = new Map();
+/**
+ * Get or create a circuit breaker by name
+ */
+function getCircuitBreaker(name, config) {
+    let breaker = circuitBreakers.get(name);
+    if (!breaker) {
+        breaker = new CircuitBreaker(name, config);
+        circuitBreakers.set(name, breaker);
+    }
+    return breaker;
+}
+/**
+ * Calculate delay with exponential backoff and optional jitter
+ */
+function calculateDelay(attempt, config) {
+    let delay = config.baseDelayMs * Math.pow(config.backoffFactor, attempt);
+    delay = Math.min(delay, config.maxDelayMs);
+    if (config.jitter) {
+        // Add random jitter of ±25%
+        const jitterRange = delay * 0.25;
+        delay = delay - jitterRange + Math.random() * jitterRange * 2;
+    }
+    return Math.round(delay);
+}
+/**
+ * Sleep for specified milliseconds
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Wrap a promise with timeout
+ */
+function withTimeout(promise, timeoutMs, message) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(message || `Operation timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        promise
+            .then(result => {
+            clearTimeout(timer);
+            resolve(result);
+        })
+            .catch(error => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+/**
+ * Execute a function with enhanced retry logic
+ */
+async function withEnhancedRetry(fn, options = {}) {
+    const config = { ...exports.DEFAULT_RETRY_CONFIG, ...options.config };
+    const label = options.label || 'operation';
+    const startTime = Date.now();
+    // Get circuit breaker if specified
+    let breaker;
+    if (options.circuitBreaker) {
+        breaker = typeof options.circuitBreaker === 'string'
+            ? getCircuitBreaker(options.circuitBreaker)
+            : options.circuitBreaker;
+    }
+    // Check circuit breaker before starting
+    if (breaker && !breaker.canCall()) {
+        const waitTime = breaker.getTimeUntilRetry();
+        return {
+            success: false,
+            error: new Error(`Circuit breaker is OPEN. Retry in ${Math.round(waitTime / 1000)}s`),
+            attempts: 0,
+            totalTimeMs: Date.now() - startTime,
+        };
+    }
+    let lastError;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        try {
+            // Execute with optional timeout
+            let result;
+            if (config.attemptTimeoutMs) {
+                result = await withTimeout(fn(), config.attemptTimeoutMs, `${label} timed out`);
+            }
+            else {
+                result = await fn();
+            }
+            // Success - record in circuit breaker
+            if (breaker) {
+                breaker.recordSuccess();
+            }
+            return {
+                success: true,
+                result,
+                attempts: attempt + 1,
+                totalTimeMs: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            lastError = error;
+            // Record failure in circuit breaker
+            if (breaker) {
+                breaker.recordFailure();
+                if (!breaker.canCall()) {
+                    logger.warn(`[${label}] Circuit breaker opened, stopping retries`);
+                    break;
+                }
+            }
+            // Check if we should retry
+            if (options.shouldRetry && !options.shouldRetry(error, attempt)) {
+                logger.warn(`[${label}] Error is not retryable: ${error.message}`);
+                break;
+            }
+            // Check if we have more retries
+            if (attempt >= config.maxRetries) {
+                logger.error(`[${label}] All ${config.maxRetries + 1} attempts failed`);
+                break;
+            }
+            // Calculate delay
+            const delay = calculateDelay(attempt, config);
+            // Notify on retry
+            if (options.onRetry) {
+                options.onRetry(error, attempt, delay);
+            }
+            else {
+                logger.warn(`[${label}] Attempt ${attempt + 1} failed: ${error.message}. Retrying in ${delay}ms...`);
+            }
+            await sleep(delay);
+        }
+    }
+    return {
+        success: false,
+        error: lastError,
+        attempts: config.maxRetries + 1,
+        totalTimeMs: Date.now() - startTime,
+    };
+}
+/**
+ * Check if an error is transient and worth retrying
+ */
+function isTransientError(error) {
+    const message = error.message.toLowerCase();
+    // Network errors
+    if (message.includes('econnreset') ||
+        message.includes('econnrefused') ||
+        message.includes('etimedout') ||
+        message.includes('enotfound') ||
+        message.includes('socket hang up')) {
+        return true;
+    }
+    // Service unavailable
+    if (message.includes('unavailable') ||
+        message.includes('503') ||
+        message.includes('502') ||
+        message.includes('504')) {
+        return true;
+    }
+    // Rate limiting (should retry after delay)
+    if (message.includes('rate limit') ||
+        message.includes('429') ||
+        message.includes('too many requests')) {
+        return true;
+    }
+    // Temporary server errors
+    if (message.includes('internal server error') ||
+        message.includes('500') ||
+        message.includes('temporarily')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if an error is permanent and should not be retried
+ */
+function isPermanentError(error) {
+    const message = error.message.toLowerCase();
+    // Authentication errors
+    if (message.includes('unauthorized') ||
+        message.includes('401') ||
+        message.includes('forbidden') ||
+        message.includes('403') ||
+        message.includes('not authenticated')) {
+        return true;
+    }
+    // Configuration/setup errors
+    if (message.includes('not found') ||
+        message.includes('404') ||
+        message.includes('invalid configuration') ||
+        message.includes('invalid api key')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Default retry predicate
+ */
+function defaultShouldRetry(error, attempt) {
+    if (isPermanentError(error)) {
+        return false;
+    }
+    return isTransientError(error);
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/dist/utils/run-service.d.ts

@@ -0,0 +1,88 @@
+/**
+ * RunService - Manages CursorFlow run history and active processes
+ *
+ * Provides:
+ * - List all runs (with filtering by status)
+ * - Get detailed run information
+ * - Stop running processes
+ * - Delete run resources
+ */
+import { RunStatus, RunInfo } from './types';
+export interface RunFilter {
+    status?: RunStatus;
+    limit?: number;
+    taskName?: string;
+}
+export interface RunResources {
+    branches: string[];
+    worktrees: string[];
+    logSize: number;
+}
+export declare class RunService {
+    private logsDir;
+    private runsDir;
+    constructor(logsDir: string);
+    /**
+     * List all runs with optional filtering
+     */
+    listRuns(filter?: RunFilter): RunInfo[];
+    /**
+     * Get detailed information about a specific run
+     */
+    getRunInfo(runId: string): RunInfo | null;
+    /**
+     * Get currently active (running) runs
+     */
+    getActiveRuns(): RunInfo[];
+    /**
+     * Calculate overall run status based on lane statuses
+     */
+    private calculateRunStatus;
+    /**
+     * Extract timestamp from run ID (format: run-TIMESTAMP)
+     */
+    private extractTimestampFromRunId;
+    /**
+     * Extract task name from run ID or directory structure
+     */
+    private extractTaskNameFromRunId;
+    /**
+     * Get run end time from lane states
+     */
+    private getRunEndTime;
+    /**
+     * Get resources linked to a run (branches, worktrees)
+     */
+    getLinkedResources(runId: string): RunResources;
+    /**
+     * Stop a running workflow
+     */
+    stopRun(runId: string): boolean;
+    /**
+     * Stop all running workflows
+     */
+    stopAllRuns(): number;
+    /**
+     * Delete a run and optionally its associated resources
+     */
+    deleteRun(runId: string, options?: {
+        includeBranches?: boolean;
+        force?: boolean;
+    }): void;
+    /**
+     * Calculate directory size in bytes
+     */
+    private getDirectorySize;
+    /**
+     * Format duration for display
+     */
+    static formatDuration(ms: number): string;
+    /**
+     * Format bytes for display
+     */
+    static formatBytes(bytes: number): string;
+}
+/**
+ * Create a RunService instance with default paths
+ */
+export declare function createRunService(projectRoot?: string): RunService;