@claude-flow/cli 3.0.0-alpha.79 → 3.0.0-alpha.80

package/dist/src/production/retry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Production Retry Mechanisms
+ *
+ * Provides retry with:
+ * - Exponential backoff
+ * - Jitter
+ * - Per-error-type configuration
+ * - Circuit breaker integration
+ *
+ * @module @claude-flow/cli/production/retry
+ */
+export interface RetryConfig {
+    maxAttempts: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    backoffMultiplier: number;
+    jitter: number;
+    nonRetryableErrors: string[];
+    shouldRetry?: (error: Error, attempt: number) => boolean;
+    onRetry?: (error: Error, attempt: number, delayMs: number) => void;
+}
+export interface RetryResult<T> {
+    success: boolean;
+    result?: T;
+    error?: Error;
+    attempts: number;
+    totalTimeMs: number;
+    retryHistory: Array<{
+        attempt: number;
+        error: string;
+        delayMs: number;
+    }>;
+}
+export type RetryStrategy = 'exponential' | 'linear' | 'constant' | 'fibonacci';
+/**
+ * Execute a function with retry logic
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>, strategy?: RetryStrategy): Promise<RetryResult<T>>;
+/**
+ * Create a retryable version of a function
+ */
+export declare function makeRetryable<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, config?: Partial<RetryConfig>, strategy?: RetryStrategy): (...args: Parameters<T>) => Promise<RetryResult<Awaited<ReturnType<T>>>>;
+/**
+ * Retry decorator for class methods
+ */
+export declare function Retryable(config?: Partial<RetryConfig>, strategy?: RetryStrategy): (_target: unknown, _propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export default withRetry;
+//# sourceMappingURL=retry.d.ts.map

package/dist/src/production/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/production/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,WAAW;IAE1B,WAAW,EAAE,MAAM,CAAC;IAEpB,cAAc,EAAE,MAAM,CAAC;IAEvB,UAAU,EAAE,MAAM,CAAC;IAEnB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,MAAM,EAAE,MAAM,CAAC;IAEf,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAE7B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAEzD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AA4GhF;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,EACjC,QAAQ,GAAE,aAA6B,GACtC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CA+DzB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAC9E,EAAE,EAAE,CAAC,EACL,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,EACjC,QAAQ,GAAE,aAA6B,GACtC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAI1E;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,EACjC,QAAQ,GAAE,aAA6B,IAGrC,SAAS,OAAO,EAChB,cAAc,MAAM,EACpB,YAAY,kBAAkB,wBAoBjC;AAED,eAAe,SAAS,CAAC"}

package/dist/src/production/retry.js

@@ -0,0 +1,179 @@
+/**
+ * Production Retry Mechanisms
+ *
+ * Provides retry with:
+ * - Exponential backoff
+ * - Jitter
+ * - Per-error-type configuration
+ * - Circuit breaker integration
+ *
+ * @module @claude-flow/cli/production/retry
+ */
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    maxAttempts: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+    jitter: 0.1,
+    nonRetryableErrors: [
+        'validation',
+        'authentication',
+        'authorization',
+        'not_found',
+    ],
+};
+// ============================================================================
+// Retry Implementation
+// ============================================================================
+/**
+ * Calculate delay for a given attempt
+ */
+function calculateDelay(attempt, config, strategy = 'exponential') {
+    let delay;
+    switch (strategy) {
+        case 'linear':
+            delay = config.initialDelayMs * attempt;
+            break;
+        case 'constant':
+            delay = config.initialDelayMs;
+            break;
+        case 'fibonacci':
+            delay = config.initialDelayMs * fibonacci(attempt);
+            break;
+        case 'exponential':
+        default:
+            delay = config.initialDelayMs * Math.pow(config.backoffMultiplier, attempt - 1);
+    }
+    // Apply max delay cap
+    delay = Math.min(delay, config.maxDelayMs);
+    // Apply jitter
+    if (config.jitter > 0) {
+        const jitterRange = delay * config.jitter;
+        delay += (Math.random() - 0.5) * 2 * jitterRange;
+    }
+    return Math.round(Math.max(0, delay));
+}
+/**
+ * Fibonacci helper for fibonacci backoff
+ */
+function fibonacci(n) {
+    if (n <= 1)
+        return 1;
+    let a = 1, b = 1;
+    for (let i = 2; i <= n; i++) {
+        [a, b] = [b, a + b];
+    }
+    return b;
+}
+/**
+ * Check if an error should be retried
+ */
+function shouldRetryError(error, attempt, config) {
+    // Check custom retry function
+    if (config.shouldRetry) {
+        return config.shouldRetry(error, attempt);
+    }
+    // Check non-retryable error patterns
+    const message = error.message.toLowerCase();
+    for (const pattern of config.nonRetryableErrors) {
+        if (message.includes(pattern.toLowerCase())) {
+            return false;
+        }
+    }
+    // Default: retry if we haven't exceeded max attempts
+    return attempt < config.maxAttempts;
+}
+/**
+ * Sleep for a given number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Execute a function with retry logic
+ */
+export async function withRetry(fn, config = {}, strategy = 'exponential') {
+    const finalConfig = { ...DEFAULT_CONFIG, ...config };
+    const startTime = Date.now();
+    const retryHistory = [];
+    let lastError;
+    let attempt = 0;
+    while (attempt < finalConfig.maxAttempts) {
+        attempt++;
+        try {
+            const result = await fn();
+            return {
+                success: true,
+                result,
+                attempts: attempt,
+                totalTimeMs: Date.now() - startTime,
+                retryHistory,
+            };
+        }
+        catch (error) {
+            lastError = error;
+            // Check if we should retry
+            if (!shouldRetryError(lastError, attempt, finalConfig)) {
+                return {
+                    success: false,
+                    error: lastError,
+                    attempts: attempt,
+                    totalTimeMs: Date.now() - startTime,
+                    retryHistory,
+                };
+            }
+            // Calculate delay
+            const delay = calculateDelay(attempt, finalConfig, strategy);
+            // Record retry
+            retryHistory.push({
+                attempt,
+                error: lastError.message,
+                delayMs: delay,
+            });
+            // Call retry callback
+            if (finalConfig.onRetry) {
+                finalConfig.onRetry(lastError, attempt, delay);
+            }
+            // Wait before retrying
+            if (attempt < finalConfig.maxAttempts) {
+                await sleep(delay);
+            }
+        }
+    }
+    return {
+        success: false,
+        error: lastError,
+        attempts: attempt,
+        totalTimeMs: Date.now() - startTime,
+        retryHistory,
+    };
+}
+/**
+ * Create a retryable version of a function
+ */
+export function makeRetryable(fn, config = {}, strategy = 'exponential') {
+    return async (...args) => {
+        return withRetry(() => fn(...args), config, strategy);
+    };
+}
+/**
+ * Retry decorator for class methods
+ */
+export function Retryable(config = {}, strategy = 'exponential') {
+    return function (_target, _propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const result = await withRetry(() => originalMethod.apply(this, args), config, strategy);
+            if (result.success) {
+                return result.result;
+            }
+            throw result.error;
+        };
+        return descriptor;
+    };
+}
+export default withRetry;
+//# sourceMappingURL=retry.js.map

package/dist/src/production/retry.js.map

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