@specforge/mcp 2.6.0 → 3.0.0

package/dist/autopilot/core/failure-handler.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Failure Handler
+ *
+ * Retry logic, systemic failure detection, and pause decisions.
+ */
+import { EventEmitter } from 'events';
+import type { AutopilotConfig } from '../types.js';
+/**
+ * Failure category
+ */
+export type FailureCategory = 'transient' | 'rate_limit' | 'auth' | 'timeout' | 'validation' | 'implementation' | 'systemic' | 'unknown';
+/**
+ * Failure info
+ */
+export interface FailureInfo {
+    ticketId: string;
+    workerId: number;
+    error: string;
+    category: FailureCategory;
+    attempt: number;
+    timestamp: Date;
+    retryable: boolean;
+    retryAfterMs?: number;
+}
+/**
+ * Failure Handler Events
+ */
+export interface FailureHandlerEvents {
+    'failure:recorded': FailureInfo;
+    'failure:systemic': {
+        count: number;
+        recentFailures: FailureInfo[];
+    };
+    'failure:should_pause': {
+        reason: string;
+    };
+    'failure:retry_scheduled': {
+        ticketId: string;
+        retryAfterMs: number;
+    };
+}
+/**
+ * Failure Handler
+ */
+export declare class FailureHandler extends EventEmitter {
+    private failures;
+    private ticketAttempts;
+    private config;
+    constructor(config: AutopilotConfig | Partial<{
+        maxTicketRetries: number;
+        systemicThreshold: number;
+        systemicWindowMs: number;
+    }>);
+    /**
+     * Record a failure
+     */
+    recordFailure(info: Omit<FailureInfo, 'attempt' | 'timestamp' | 'retryable' | 'category'>): FailureInfo;
+    /**
+     * Categorize error message
+     */
+    private categorizeError;
+    /**
+     * Determine if failure is retryable
+     */
+    private isRetryable;
+    /**
+     * Calculate retry delay based on category and attempt
+     */
+    private calculateRetryDelay;
+    /**
+     * Detect systemic failures (many failures in short window)
+     * Excludes rate_limit failures as they are handled separately
+     */
+    private detectSystemicFailure;
+    /**
+     * Get attempt count for a ticket
+     */
+    getAttemptCount(ticketId: string): number;
+    /**
+     * Check if ticket should be retried
+     * Returns false if ticket has no recorded failures (nothing to retry)
+     */
+    shouldRetry(ticketId: string): boolean;
+    /**
+     * Get last failure for a ticket
+     */
+    getLastFailure(ticketId: string): FailureInfo | undefined;
+    /**
+     * Get all failures for a ticket
+     */
+    getTicketFailures(ticketId: string): FailureInfo[];
+    /**
+     * Clear failures for a ticket (e.g., after success)
+     */
+    clearTicketFailures(ticketId: string): void;
+    /**
+     * Get failure statistics
+     */
+    getStats(): {
+        totalFailures: number;
+        byCategory: Record<FailureCategory, number>;
+        recentCount: number;
+        uniqueTickets: number;
+    };
+    /**
+     * Check if should pause due to failures
+     */
+    shouldPause(): {
+        should: boolean;
+        reason?: string;
+    };
+    /**
+     * Reset all failure tracking
+     */
+    reset(): void;
+    /**
+     * Alias for reset - clear all failures
+     */
+    clearAll(): void;
+    /**
+     * Get total failure count
+     */
+    getFailureCount(): number;
+    /**
+     * Get failures within a time window
+     */
+    getRecentFailures(windowMs?: number): FailureInfo[];
+    /**
+     * Get failure rate (failures per minute) within a time window
+     */
+    getFailureRate(windowMs?: number): number;
+    /**
+     * Update configuration
+     */
+    updateConfig(updates: Partial<typeof this.config>): void;
+}
+/**
+ * Create a failure handler
+ */
+export declare function createFailureHandler(config?: Partial<{
+    maxTicketRetries: number;
+    systemicThreshold: number;
+    systemicWindowMs: number;
+}>): FailureHandler;
+//# sourceMappingURL=failure-handler.d.ts.map

package/dist/autopilot/core/failure-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-handler.d.ts","sourceRoot":"","sources":["../../../src/autopilot/core/failure-handler.ts"],"names":[],"mappings":"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"}

package/dist/autopilot/core/failure-handler.js

@@ -0,0 +1,308 @@
+/**
+ * Failure Handler
+ *
+ * Retry logic, systemic failure detection, and pause decisions.
+ */
+import { EventEmitter } from 'events';
+/**
+ * Failure Handler
+ */
+export class FailureHandler extends EventEmitter {
+    failures = [];
+    ticketAttempts = new Map();
+    config;
+    constructor(config) {
+        super();
+        this.config = {
+            maxTicketRetries: config?.maxTicketRetries ?? 2,
+            systemicThreshold: ('systemicThreshold' in config ? config.systemicThreshold : undefined) ?? 5,
+            systemicWindowMs: ('systemicWindowMs' in config ? config.systemicWindowMs : undefined) ?? 5 * 60 * 1000,
+        };
+    }
+    /**
+     * Record a failure
+     */
+    recordFailure(info) {
+        // Get current attempt count
+        const currentAttempt = (this.ticketAttempts.get(info.ticketId) || 0) + 1;
+        this.ticketAttempts.set(info.ticketId, currentAttempt);
+        // Categorize the failure
+        const category = this.categorizeError(info.error);
+        // Determine if retryable
+        const retryable = this.isRetryable(category, currentAttempt);
+        // Calculate retry delay if applicable
+        const retryAfterMs = retryable ? this.calculateRetryDelay(category, currentAttempt) : undefined;
+        const failure = {
+            ...info,
+            category,
+            attempt: currentAttempt,
+            timestamp: new Date(),
+            retryable,
+            retryAfterMs,
+        };
+        this.failures.push(failure);
+        this.emit('failure:recorded', failure);
+        // Check for systemic failures
+        if (this.detectSystemicFailure()) {
+            const recentFailures = this.getRecentFailures();
+            this.emit('failure:systemic', {
+                count: recentFailures.length,
+                recentFailures,
+            });
+            this.emit('failure:should_pause', {
+                reason: `Systemic failure detected: ${recentFailures.length} failures in last 5 minutes`,
+            });
+        }
+        // Schedule retry if applicable
+        if (retryable && retryAfterMs) {
+            this.emit('failure:retry_scheduled', {
+                ticketId: info.ticketId,
+                retryAfterMs,
+            });
+        }
+        return failure;
+    }
+    /**
+     * Categorize error message
+     */
+    categorizeError(error) {
+        const errorLower = error.toLowerCase();
+        // Rate limit
+        if (errorLower.includes('rate limit') ||
+            errorLower.includes('quota') ||
+            errorLower.includes('too many requests')) {
+            return 'rate_limit';
+        }
+        // Authentication
+        if (errorLower.includes('auth') ||
+            errorLower.includes('unauthorized') ||
+            errorLower.includes('not logged in')) {
+            return 'auth';
+        }
+        // Timeout
+        if (errorLower.includes('timeout') || errorLower.includes('timed out')) {
+            return 'timeout';
+        }
+        // Transient network errors
+        if (errorLower.includes('network') ||
+            errorLower.includes('econnrefused') ||
+            errorLower.includes('econnreset') ||
+            errorLower.includes('etimedout') ||
+            errorLower.includes('connection')) {
+            return 'transient';
+        }
+        // Validation failures (includes compilation errors)
+        if (errorLower.includes('test') ||
+            errorLower.includes('lint') ||
+            errorLower.includes('type error') ||
+            errorLower.includes('validation') ||
+            errorLower.includes('compile') ||
+            errorLower.includes('compilation')) {
+            return 'validation';
+        }
+        // Implementation errors (syntax, build failures)
+        if (errorLower.includes('syntax') ||
+            errorLower.includes('build')) {
+            return 'implementation';
+        }
+        return 'unknown';
+    }
+    /**
+     * Determine if failure is retryable
+     */
+    isRetryable(category, attempt) {
+        // Never retry auth failures
+        if (category === 'auth') {
+            return false;
+        }
+        // Check attempt count
+        if (attempt >= this.config.maxTicketRetries) {
+            return false;
+        }
+        // Transient and timeout are always retryable if under limit
+        if (category === 'transient' || category === 'timeout') {
+            return true;
+        }
+        // Rate limit is retryable after backoff
+        if (category === 'rate_limit') {
+            return true;
+        }
+        // Validation and implementation might be retried once
+        if (category === 'validation' || category === 'implementation') {
+            return attempt < 2;
+        }
+        // Unknown errors get one retry
+        return attempt < 2;
+    }
+    /**
+     * Calculate retry delay based on category and attempt
+     */
+    calculateRetryDelay(category, attempt) {
+        // Base delay with exponential backoff
+        const baseDelay = 1000; // 1 second
+        const maxDelay = 60000; // 1 minute
+        const exponentialDelay = Math.min(baseDelay * Math.pow(2, attempt - 1), maxDelay);
+        // Add jitter (10%)
+        const jitter = exponentialDelay * 0.1 * Math.random();
+        // Category-specific adjustments
+        switch (category) {
+            case 'rate_limit':
+                // Rate limits need longer backoff
+                return Math.min(exponentialDelay * 2 + 30000, 5 * 60 * 1000);
+            case 'transient':
+                // Quick retry for transient errors
+                return exponentialDelay + jitter;
+            case 'timeout':
+                // Moderate delay for timeouts
+                return exponentialDelay * 1.5 + jitter;
+            default:
+                return exponentialDelay + jitter;
+        }
+    }
+    /**
+     * Detect systemic failures (many failures in short window)
+     * Excludes rate_limit failures as they are handled separately
+     */
+    detectSystemicFailure() {
+        const recentFailures = this.getRecentFailures();
+        // Exclude rate limit failures from systemic detection
+        const nonRateLimitFailures = recentFailures.filter(f => f.category !== 'rate_limit');
+        return nonRateLimitFailures.length >= this.config.systemicThreshold;
+    }
+    /**
+     * Get attempt count for a ticket
+     */
+    getAttemptCount(ticketId) {
+        return this.ticketAttempts.get(ticketId) || 0;
+    }
+    /**
+     * Check if ticket should be retried
+     * Returns false if ticket has no recorded failures (nothing to retry)
+     */
+    shouldRetry(ticketId) {
+        const attempts = this.getAttemptCount(ticketId);
+        // Must have at least one failure to retry, and be under the retry limit
+        if (attempts === 0) {
+            return false;
+        }
+        // Also check if the last failure was marked as retryable
+        const lastFailure = this.getLastFailure(ticketId);
+        return lastFailure?.retryable ?? false;
+    }
+    /**
+     * Get last failure for a ticket
+     */
+    getLastFailure(ticketId) {
+        const ticketFailures = this.failures.filter(f => f.ticketId === ticketId);
+        return ticketFailures[ticketFailures.length - 1];
+    }
+    /**
+     * Get all failures for a ticket
+     */
+    getTicketFailures(ticketId) {
+        return this.failures.filter(f => f.ticketId === ticketId);
+    }
+    /**
+     * Clear failures for a ticket (e.g., after success)
+     */
+    clearTicketFailures(ticketId) {
+        this.failures = this.failures.filter(f => f.ticketId !== ticketId);
+        this.ticketAttempts.delete(ticketId);
+    }
+    /**
+     * Get failure statistics
+     */
+    getStats() {
+        const byCategory = {
+            transient: 0,
+            rate_limit: 0,
+            auth: 0,
+            timeout: 0,
+            validation: 0,
+            implementation: 0,
+            systemic: 0,
+            unknown: 0,
+        };
+        const uniqueTickets = new Set();
+        for (const failure of this.failures) {
+            byCategory[failure.category]++;
+            uniqueTickets.add(failure.ticketId);
+        }
+        return {
+            totalFailures: this.failures.length,
+            byCategory,
+            recentCount: this.getRecentFailures().length,
+            uniqueTickets: uniqueTickets.size,
+        };
+    }
+    /**
+     * Check if should pause due to failures
+     */
+    shouldPause() {
+        // Check for auth failure - always pause
+        const authFailures = this.failures.filter(f => f.category === 'auth');
+        if (authFailures.length > 0) {
+            return { should: true, reason: 'Authentication failure' };
+        }
+        // Check for rate limit
+        const rateLimitFailures = this.getRecentFailures().filter(f => f.category === 'rate_limit');
+        if (rateLimitFailures.length >= 2) {
+            return { should: true, reason: 'Rate limit hit multiple times' };
+        }
+        // Check for systemic failure
+        if (this.detectSystemicFailure()) {
+            return {
+                should: true,
+                reason: `Systemic failure: ${this.getRecentFailures().length} failures in 5 minutes`,
+            };
+        }
+        return { should: false };
+    }
+    /**
+     * Reset all failure tracking
+     */
+    reset() {
+        this.failures = [];
+        this.ticketAttempts.clear();
+    }
+    /**
+     * Alias for reset - clear all failures
+     */
+    clearAll() {
+        this.reset();
+    }
+    /**
+     * Get total failure count
+     */
+    getFailureCount() {
+        return this.failures.length;
+    }
+    /**
+     * Get failures within a time window
+     */
+    getRecentFailures(windowMs = this.config.systemicWindowMs) {
+        const cutoff = Date.now() - windowMs;
+        return this.failures.filter(f => f.timestamp.getTime() > cutoff);
+    }
+    /**
+     * Get failure rate (failures per minute) within a time window
+     */
+    getFailureRate(windowMs = this.config.systemicWindowMs) {
+        const recentFailures = this.getRecentFailures(windowMs);
+        const windowMinutes = windowMs / (60 * 1000);
+        return recentFailures.length / windowMinutes;
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(updates) {
+        Object.assign(this.config, updates);
+    }
+}
+/**
+ * Create a failure handler
+ */
+export function createFailureHandler(config) {
+    return new FailureHandler(config ?? {});
+}
+//# sourceMappingURL=failure-handler.js.map

package/dist/autopilot/core/failure-handler.js.map

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

package/dist/autopilot/core/rate-limit-handler.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Rate Limit Handler
+ *
+ * Handles rate limit events from AI Provider and pauses workers.
+ */
+import { EventEmitter } from 'events';
+import type { RateLimitInfo } from '../types.js';
+/**
+ * Rate Limit Handler Events
+ */
+export interface RateLimitHandlerEvents {
+    'rate_limit:detected': RateLimitInfo;
+    'rate_limit:cleared': void;
+    'rate_limit:workers_should_pause': void;
+    'rate_limit:workers_can_resume': void;
+}
+/**
+ * Rate Limit Handler
+ */
+export declare class RateLimitHandler extends EventEmitter {
+    private isRateLimited;
+    private rateLimitInfo?;
+    private autoResumeTimeout?;
+    private resumeCheckInterval?;
+    private subscribed;
+    /**
+     * Default backoff time when rate limited (5 minutes)
+     */
+    private backoffMs;
+    /**
+     * Bound event handlers (stored to enable proper unsubscription)
+     */
+    private boundHandleRateLimitHit;
+    private boundHandleRateLimitCleared;
+    /**
+     * Subscribe to AI Provider rate limit events
+     */
+    subscribe(): void;
+    /**
+     * Unsubscribe from AI Provider events
+     */
+    unsubscribe(): void;
+    /**
+     * Handle rate limit hit event
+     */
+    private handleRateLimitHit;
+    /**
+     * Handle rate limit cleared event
+     */
+    private handleRateLimitCleared;
+    /**
+     * Schedule a check to see if we can resume
+     */
+    private scheduleResumeCheck;
+    /**
+     * Attempt to resume after backoff
+     */
+    private attemptResume;
+    /**
+     * Clear rate limit state
+     */
+    clearRateLimit(): void;
+    /**
+     * Clear all timers
+     */
+    private clearTimers;
+    /**
+     * Manually trigger rate limit (e.g., from failure detection)
+     */
+    triggerRateLimit(message: string, backoffMs?: number): void;
+    /**
+     * Check if currently rate limited
+     */
+    isCurrentlyRateLimited(): boolean;
+    /**
+     * Get rate limit info
+     */
+    getRateLimitInfo(): RateLimitInfo | undefined;
+    /**
+     * Get estimated time until resume
+     */
+    getEstimatedResumeTime(): Date | undefined;
+    /**
+     * Get remaining backoff time in ms
+     */
+    getRemainingBackoffMs(): number;
+    /**
+     * Update backoff duration
+     */
+    setBackoffMs(ms: number): void;
+    /**
+     * Get backoff duration
+     */
+    getBackoffMs(): number;
+    /**
+     * Force resume (skip backoff)
+     */
+    forceResume(): void;
+    /**
+     * Destroy handler and cleanup
+     */
+    destroy(): void;
+}
+/**
+ * Create a rate limit handler instance
+ */
+export declare function createRateLimitHandler(): RateLimitHandler;
+//# sourceMappingURL=rate-limit-handler.d.ts.map

package/dist/autopilot/core/rate-limit-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-handler.d.ts","sourceRoot":"","sources":["../../../src/autopilot/core/rate-limit-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,EAAE,aAAa,CAAC;IACrC,oBAAoB,EAAE,IAAI,CAAC;IAC3B,iCAAiC,EAAE,IAAI,CAAC;IACxC,+BAA+B,EAAE,IAAI,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,iBAAiB,CAAC,CAAiB;IAC3C,OAAO,CAAC,mBAAmB,CAAC,CAAiB;IAC7C,OAAO,CAAC,UAAU,CAAkB;IAEpC;;OAEG;IACH,OAAO,CAAC,SAAS,CAAyB;IAE1C;;OAEG;IACH,OAAO,CAAC,uBAAuB,CAAsC;IACrE,OAAO,CAAC,2BAA2B,CAA0C;IAE7E;;OAEG;IACH,SAAS,IAAI,IAAI;IASjB;;OAEG;IACH,WAAW,IAAI,IAAI;IAUnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAI9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,cAAc,IAAI,IAAI;IAatB;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAW3D;;OAEG;IACH,sBAAsB,IAAI,OAAO;IAIjC;;OAEG;IACH,gBAAgB,IAAI,aAAa,GAAG,SAAS;IAI7C;;OAEG;IACH,sBAAsB,IAAI,IAAI,GAAG,SAAS;IAI1C;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAO/B;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD"}