@jterrats/smart-deployment 1.0.3

package/lib/ai/circuit-breaker.d.ts

@@ -0,0 +1,115 @@
+/**
+ * AI Circuit Breaker - US-060
+ * Circuit breaker pattern for AI calls to handle service failures
+ *
+ * @ac US-060-AC-1: Track failure rate
+ * @ac US-060-AC-2: Open circuit after N failures
+ * @ac US-060-AC-3: Automatic fallback to static analysis
+ * @ac US-060-AC-4: Reset after timeout
+ * @ac US-060-AC-5: Monitor circuit state
+ * @ac US-060-AC-6: Alert on circuit open
+ * @issue #60
+ */
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export type CircuitBreakerOptions = {
+    failureThreshold: number;
+    successThreshold: number;
+    timeout: number;
+    monitoringWindow: number;
+};
+export type CircuitBreakerStats = {
+    state: CircuitState;
+    failures: number;
+    successes: number;
+    consecutiveFailures: number;
+    lastFailureTime?: Date;
+    lastSuccessTime?: Date;
+    tripCount: number;
+};
+/**
+ * @ac US-060-AC-1: Track failure rate
+ * @ac US-060-AC-2: Open circuit after N failures
+ * @ac US-060-AC-5: Monitor circuit state
+ */
+export declare class CircuitBreaker {
+    private state;
+    private failures;
+    private successes;
+    private consecutiveFailures;
+    private lastFailureTime?;
+    private lastSuccessTime?;
+    private tripCount;
+    private readonly options;
+    constructor(options?: Partial<CircuitBreakerOptions>);
+    /**
+     * @ac US-060-AC-2: Open circuit after N failures
+     * @ac US-060-AC-3: Automatic fallback to static analysis
+     * Execute function with circuit breaker protection
+     */
+    execute<T>(fn: () => Promise<T>, fallback?: () => T | Promise<T>): Promise<T>;
+    /**
+     * @ac US-060-AC-1: Track failure rate
+     * Record successful execution
+     */
+    private onSuccess;
+    /**
+     * @ac US-060-AC-1: Track failure rate
+     * @ac US-060-AC-2: Open circuit after N failures
+     * Record failed execution
+     */
+    private onFailure;
+    /**
+     * @ac US-060-AC-2: Open circuit after N failures
+     * @ac US-060-AC-6: Alert on circuit open
+     * Open the circuit
+     */
+    private openCircuit;
+    /**
+     * Close the circuit
+     */
+    private closeCircuit;
+    /**
+     * @ac US-060-AC-4: Reset after timeout
+     * Check if circuit should transition to half-open
+     */
+    private checkStateTransition;
+    /**
+     * @ac US-060-AC-5: Monitor circuit state
+     * Get current statistics
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * @ac US-060-AC-1: Track failure rate
+     * Get failure rate within monitoring window
+     */
+    getFailureRate(): number;
+    /**
+     * Get current state
+     */
+    getState(): CircuitState;
+    /**
+     * Check if circuit is allowing requests
+     */
+    isOpen(): boolean;
+    /**
+     * Manual reset (for testing or manual intervention)
+     */
+    reset(): void;
+    /**
+     * @ac US-060-AC-6: Alert on circuit open
+     * Send alert (integration point for monitoring)
+     */
+    private sendAlert;
+    /**
+     * Format monitoring report
+     */
+    formatReport(): string;
+    /**
+     * Get state icon
+     */
+    private getStateIcon;
+    /**
+     * Get time until half-open state
+     */
+    private getTimeUntilHalfOpen;
+}

package/lib/ai/circuit-breaker.js

@@ -0,0 +1,277 @@
+/**
+ * AI Circuit Breaker - US-060
+ * Circuit breaker pattern for AI calls to handle service failures
+ *
+ * @ac US-060-AC-1: Track failure rate
+ * @ac US-060-AC-2: Open circuit after N failures
+ * @ac US-060-AC-3: Automatic fallback to static analysis
+ * @ac US-060-AC-4: Reset after timeout
+ * @ac US-060-AC-5: Monitor circuit state
+ * @ac US-060-AC-6: Alert on circuit open
+ * @issue #60
+ */
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('CircuitBreaker');
+/**
+ * @ac US-060-AC-1: Track failure rate
+ * @ac US-060-AC-2: Open circuit after N failures
+ * @ac US-060-AC-5: Monitor circuit state
+ */
+export class CircuitBreaker {
+    state = 'closed';
+    failures = 0;
+    successes = 0;
+    consecutiveFailures = 0;
+    lastFailureTime;
+    lastSuccessTime;
+    tripCount = 0;
+    options;
+    constructor(options) {
+        this.options = {
+            failureThreshold: options?.failureThreshold ?? 5,
+            successThreshold: options?.successThreshold ?? 2,
+            timeout: options?.timeout ?? 60_000, // 1 minute
+            monitoringWindow: options?.monitoringWindow ?? 300_000, // 5 minutes
+        };
+        logger.info('Circuit breaker initialized', {
+            failureThreshold: this.options.failureThreshold,
+            timeout: this.options.timeout,
+        });
+    }
+    /**
+     * @ac US-060-AC-2: Open circuit after N failures
+     * @ac US-060-AC-3: Automatic fallback to static analysis
+     * Execute function with circuit breaker protection
+     */
+    async execute(fn, fallback) {
+        // Check if circuit should transition states
+        this.checkStateTransition();
+        if (this.state === 'open') {
+            logger.warn('Circuit breaker is OPEN, using fallback');
+            if (fallback) {
+                return Promise.resolve(fallback());
+            }
+            throw new Error('Circuit breaker is OPEN and no fallback provided');
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            // If circuit just opened, use fallback
+            // Re-check state after onFailure() which may have changed it
+            if (this.getState() === 'open' && fallback) {
+                logger.info('Circuit opened, using fallback');
+                return Promise.resolve(fallback());
+            }
+            throw error;
+        }
+    }
+    /**
+     * @ac US-060-AC-1: Track failure rate
+     * Record successful execution
+     */
+    onSuccess() {
+        this.successes++;
+        this.consecutiveFailures = 0;
+        this.lastSuccessTime = new Date();
+        logger.debug('Circuit breaker: success recorded', {
+            state: this.state,
+            successes: this.successes,
+        });
+        // If half-open and enough successes, close circuit
+        if (this.state === 'half-open' && this.successes >= this.options.successThreshold) {
+            this.closeCircuit();
+        }
+    }
+    /**
+     * @ac US-060-AC-1: Track failure rate
+     * @ac US-060-AC-2: Open circuit after N failures
+     * Record failed execution
+     */
+    onFailure() {
+        this.failures++;
+        this.consecutiveFailures++;
+        this.lastFailureTime = new Date();
+        logger.warn('Circuit breaker: failure recorded', {
+            state: this.state,
+            failures: this.failures,
+            consecutiveFailures: this.consecutiveFailures,
+        });
+        // Open circuit if threshold reached
+        if (this.consecutiveFailures >= this.options.failureThreshold) {
+            this.openCircuit();
+        }
+    }
+    /**
+     * @ac US-060-AC-2: Open circuit after N failures
+     * @ac US-060-AC-6: Alert on circuit open
+     * Open the circuit
+     */
+    openCircuit() {
+        if (this.state === 'open')
+            return;
+        this.state = 'open';
+        this.tripCount++;
+        logger.error('🔴 CIRCUIT BREAKER OPENED', {
+            tripCount: this.tripCount,
+            consecutiveFailures: this.consecutiveFailures,
+            timeout: this.options.timeout,
+        });
+        // Alert (in production, this would send to monitoring system)
+        this.sendAlert('Circuit breaker opened due to repeated failures');
+    }
+    /**
+     * Close the circuit
+     */
+    closeCircuit() {
+        this.state = 'closed';
+        this.consecutiveFailures = 0;
+        this.successes = 0;
+        logger.info('🟢 Circuit breaker CLOSED', {
+            tripCount: this.tripCount,
+        });
+    }
+    /**
+     * @ac US-060-AC-4: Reset after timeout
+     * Check if circuit should transition to half-open
+     */
+    checkStateTransition() {
+        if (this.state !== 'open')
+            return;
+        if (!this.lastFailureTime)
+            return;
+        const timeSinceLastFailure = Date.now() - this.lastFailureTime.getTime();
+        if (timeSinceLastFailure >= this.options.timeout) {
+            this.state = 'half-open';
+            this.successes = 0; // Reset success counter for half-open test
+            logger.info('🟡 Circuit breaker HALF-OPEN (testing)', {
+                timeout: this.options.timeout,
+                timeSinceLastFailure,
+            });
+        }
+    }
+    /**
+     * @ac US-060-AC-5: Monitor circuit state
+     * Get current statistics
+     */
+    getStats() {
+        return {
+            state: this.state,
+            failures: this.failures,
+            successes: this.successes,
+            consecutiveFailures: this.consecutiveFailures,
+            lastFailureTime: this.lastFailureTime,
+            lastSuccessTime: this.lastSuccessTime,
+            tripCount: this.tripCount,
+        };
+    }
+    /**
+     * @ac US-060-AC-1: Track failure rate
+     * Get failure rate within monitoring window
+     */
+    getFailureRate() {
+        if (!this.lastFailureTime)
+            return 0;
+        const windowStart = Date.now() - this.options.monitoringWindow;
+        const lastFailureTime = this.lastFailureTime.getTime();
+        if (lastFailureTime < windowStart) {
+            return 0; // Failures outside window
+        }
+        const total = this.failures + this.successes;
+        return total > 0 ? this.failures / total : 0;
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        this.checkStateTransition();
+        return this.state;
+    }
+    /**
+     * Check if circuit is allowing requests
+     */
+    isOpen() {
+        this.checkStateTransition();
+        return this.state === 'open';
+    }
+    /**
+     * Manual reset (for testing or manual intervention)
+     */
+    reset() {
+        this.state = 'closed';
+        this.failures = 0;
+        this.successes = 0;
+        this.consecutiveFailures = 0;
+        this.lastFailureTime = undefined;
+        this.lastSuccessTime = undefined;
+        logger.info('Circuit breaker manually reset');
+    }
+    /**
+     * @ac US-060-AC-6: Alert on circuit open
+     * Send alert (integration point for monitoring)
+     */
+    sendAlert(message) {
+        // In production, this would integrate with:
+        // - PagerDuty
+        // - Slack
+        // - CloudWatch Alarms
+        // - Datadog
+        // etc.
+        logger.error('🚨 ALERT:', { message, stats: this.getStats() });
+        // For now, just log. In production, implement actual alerting.
+    }
+    /**
+     * Format monitoring report
+     */
+    formatReport() {
+        const stats = this.getStats();
+        const failureRate = (this.getFailureRate() * 100).toFixed(1);
+        const lines = [];
+        lines.push('⚡ Circuit Breaker Status');
+        lines.push('═══════════════════════════════════════');
+        lines.push(`State: ${this.getStateIcon()} ${stats.state.toUpperCase()}`);
+        lines.push(`Failure Rate: ${failureRate}%`);
+        lines.push(`Consecutive Failures: ${stats.consecutiveFailures}/${this.options.failureThreshold}`);
+        lines.push(`Trip Count: ${stats.tripCount}`);
+        lines.push('');
+        lines.push(`Total Successes: ${stats.successes}`);
+        lines.push(`Total Failures: ${stats.failures}`);
+        if (stats.lastFailureTime) {
+            const timeSince = Date.now() - stats.lastFailureTime.getTime();
+            lines.push(`Last Failure: ${Math.floor(timeSince / 1000)}s ago`);
+        }
+        if (this.state === 'open') {
+            lines.push('');
+            lines.push(`⏰ Reset in: ${this.getTimeUntilHalfOpen()}ms`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get state icon
+     */
+    getStateIcon() {
+        switch (this.state) {
+            case 'closed':
+                return '🟢';
+            case 'open':
+                return '🔴';
+            case 'half-open':
+                return '🟡';
+            default:
+                return '⚪';
+        }
+    }
+    /**
+     * Get time until half-open state
+     */
+    getTimeUntilHalfOpen() {
+        if (this.state !== 'open' || !this.lastFailureTime)
+            return 0;
+        const timeSinceFailure = Date.now() - this.lastFailureTime.getTime();
+        return Math.max(0, this.options.timeout - timeSinceFailure);
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/lib/ai/circuit-breaker.js.map

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

package/lib/ai/dependency-inference-service.d.ts

@@ -0,0 +1,76 @@
+/**
+ * AI Dependency Inference Service - US-055
+ * Uses Agentforce to infer non-obvious dependencies
+ *
+ * @ac US-055-AC-1: Send component context to Agentforce
+ * @ac US-055-AC-2: Receive dependency inferences
+ * @ac US-055-AC-3: Parse AI responses
+ * @ac US-055-AC-4: Confidence scoring
+ * @ac US-055-AC-5: Fallback to static analysis if AI fails
+ * @ac US-055-AC-6: Cache AI results
+ * @issue #55
+ */
+import type { MetadataComponent } from '../types/metadata.js';
+import type { DependencyGraph } from '../types/dependency.js';
+import type { LLMProvider } from './llm-provider.js';
+export type InferredDependency = {
+    from: string;
+    to: string;
+    type: 'implicit' | 'dynamic' | 'runtime' | 'business-logic';
+    confidence: number;
+    reason: string;
+    lineNumber?: number;
+};
+export type InferenceResult = {
+    dependencies: InferredDependency[];
+    totalInferred: number;
+    highConfidenceCount: number;
+    executionTime: number;
+    usedCache: boolean;
+    fallbackToStatic: boolean;
+};
+export type DependencyInferenceServiceOptions = {
+    baseDir?: string;
+};
+/**
+ * @ac US-055-AC-1: Send component context to Agentforce
+ * @ac US-055-AC-2: Receive dependency inferences
+ */
+export declare class DependencyInferenceService {
+    private readonly llmProvider;
+    private readonly cache;
+    private readonly confidenceThreshold;
+    constructor(llmProviderOrOptions?: LLMProvider | DependencyInferenceServiceOptions, confidenceThreshold?: number);
+    private resolveProvider;
+    /**
+     * @ac US-055-AC-1: Send component context to Agentforce
+     * Infer dependencies for components
+     */
+    inferDependencies(components: MetadataComponent[], existingGraph?: DependencyGraph): Promise<InferenceResult>;
+    /**
+     * Build prompt for dependency inference
+     */
+    private buildInferencePrompt;
+    /**
+     * @ac US-055-AC-3: Parse AI responses
+     * Parse Agentforce response into structured data
+     */
+    private parseInferenceResponse;
+    /**
+     * @ac US-055-AC-6: Cache AI results
+     * Generate cache key for components
+     */
+    private getCacheKey;
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache size
+     */
+    getCacheSize(): number;
+    /**
+     * Get confidence threshold
+     */
+    getConfidenceThreshold(): number;
+}