dartmind 17.0.0

package/dist/mcp/MCPHealthChecker.js

@@ -0,0 +1,330 @@
+/**
+ * FlutterAI V16 - MCPHealthChecker
+ * Issue 16.1: MCP Server Startup Verification
+ *
+ * Verify all MCP servers are healthy before operations:
+ * - Health check with timeout
+ * - Retry logic for transient failures
+ * - Block operations until all healthy
+ *
+ * @module mcp/MCPHealthChecker
+ * @version 16.0.0
+ */
+import { EventEmitter } from 'events';
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_CONFIG = {
+    healthCheckTimeoutMs: 5000, // 5 seconds
+    maxRetries: 3,
+    retryDelayMs: 1000,
+    checkIntervalMs: 30000, // 30 seconds
+};
+// Known FlutterAI MCP servers
+const FLUTTERAI_MCP_SERVERS = [
+    { id: 'flutter-patterns', name: 'Flutter Patterns', required: true },
+    { id: 'flutter-project', name: 'Flutter Project', required: true },
+    { id: 'flutter-tools', name: 'Flutter Tools', required: true },
+    { id: 'flutter-safety', name: 'Flutter Safety', required: true },
+    { id: 'flutter-figma', name: 'Flutter Figma', required: false },
+    { id: 'flutter-orchestrator', name: 'Flutter Orchestrator', required: true },
+    { id: 'flutter-memory', name: 'Flutter Memory', required: false },
+    { id: 'flutter-analytics', name: 'Flutter Analytics', required: false },
+    { id: 'flutter-test', name: 'Flutter Test', required: false },
+    { id: 'flutter-deploy', name: 'Flutter Deploy', required: false },
+];
+// ============================================================================
+// MCPHealthChecker Class
+// ============================================================================
+export class MCPHealthChecker extends EventEmitter {
+    config;
+    servers;
+    healthStatus = new Map();
+    checkInterval = null;
+    healthCheckFn = null;
+    constructor(servers, config) {
+        super();
+        this.servers = servers || FLUTTERAI_MCP_SERVERS;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        // Initialize health status
+        for (const server of this.servers) {
+            this.healthStatus.set(server.id, {
+                serverId: server.id,
+                serverName: server.name,
+                healthy: false,
+                lastCheck: new Date(0),
+                consecutiveFailures: 0,
+            });
+        }
+    }
+    /**
+     * Set custom health check function
+     */
+    setHealthCheckFn(fn) {
+        this.healthCheckFn = fn;
+    }
+    /**
+     * Check health of all servers
+     */
+    async checkAll() {
+        const results = await Promise.all(this.servers.map((server) => this.checkServer(server.id)));
+        const unhealthyCount = results.filter((r) => !r.healthy).length;
+        const status = {
+            allHealthy: unhealthyCount === 0,
+            servers: results,
+            unhealthyCount,
+            totalServers: this.servers.length,
+            lastFullCheck: new Date(),
+        };
+        this.emit('health-check-complete', status);
+        if (!status.allHealthy) {
+            this.emit('unhealthy-servers', {
+                unhealthy: results.filter((r) => !r.healthy),
+            });
+        }
+        return status;
+    }
+    /**
+     * Check health of required servers only
+     */
+    async checkRequired() {
+        const requiredServers = this.servers.filter((s) => s.required !== false);
+        const results = await Promise.all(requiredServers.map((server) => this.checkServer(server.id)));
+        const unhealthyCount = results.filter((r) => !r.healthy).length;
+        return {
+            allHealthy: unhealthyCount === 0,
+            servers: results,
+            unhealthyCount,
+            totalServers: requiredServers.length,
+            lastFullCheck: new Date(),
+        };
+    }
+    /**
+     * Check health of a specific server
+     */
+    async checkServer(serverId) {
+        const server = this.servers.find((s) => s.id === serverId);
+        if (!server) {
+            throw new Error(`Unknown server: ${serverId}`);
+        }
+        const startTime = Date.now();
+        let healthy = false;
+        let errorMessage;
+        for (let attempt = 0; attempt < this.config.maxRetries; attempt++) {
+            try {
+                // Attempt health check
+                healthy = await this.performHealthCheck(server);
+                if (healthy)
+                    break;
+            }
+            catch (err) {
+                errorMessage = err instanceof Error ? err.message : String(err);
+                if (attempt < this.config.maxRetries - 1) {
+                    await this.delay(this.config.retryDelayMs);
+                }
+            }
+        }
+        const responseTimeMs = Date.now() - startTime;
+        const existingStatus = this.healthStatus.get(serverId);
+        const newStatus = {
+            serverId,
+            serverName: server.name,
+            healthy,
+            responseTimeMs,
+            lastCheck: new Date(),
+            consecutiveFailures: healthy ? 0 : existingStatus.consecutiveFailures + 1,
+            errorMessage: healthy ? undefined : errorMessage,
+        };
+        this.healthStatus.set(serverId, newStatus);
+        // Emit events for status changes
+        if (existingStatus.healthy !== healthy) {
+            this.emit('server-status-changed', {
+                serverId,
+                serverName: server.name,
+                oldStatus: existingStatus.healthy,
+                newStatus: healthy,
+            });
+        }
+        return newStatus;
+    }
+    /**
+     * Wait until all servers are healthy or timeout
+     */
+    async waitForHealthy(timeoutMs) {
+        const timeout = timeoutMs ?? this.config.healthCheckTimeoutMs * this.servers.length;
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const status = await this.checkAll();
+            if (status.allHealthy) {
+                return true;
+            }
+            await this.delay(1000); // Wait 1 second before retry
+        }
+        return false;
+    }
+    /**
+     * Wait until required servers are healthy or timeout
+     */
+    async waitForRequiredHealthy(timeoutMs) {
+        const requiredServers = this.servers.filter((s) => s.required !== false);
+        const timeout = timeoutMs ?? this.config.healthCheckTimeoutMs * requiredServers.length;
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const status = await this.checkRequired();
+            if (status.allHealthy) {
+                return true;
+            }
+            await this.delay(1000);
+        }
+        return false;
+    }
+    /**
+     * Verify startup - throws if required servers not healthy
+     */
+    async verifyStartup() {
+        const status = await this.checkRequired();
+        if (!status.allHealthy) {
+            const unhealthy = status.servers
+                .filter((s) => !s.healthy)
+                .map((s) => `${s.serverName} (${s.errorMessage || 'unknown error'})`)
+                .join(', ');
+            const error = new Error(`MCP startup verification failed. Unhealthy servers: ${unhealthy}`);
+            error.name = 'MCPStartupError';
+            error.healthStatus = status;
+            throw error;
+        }
+        this.emit('startup-verified', status);
+    }
+    /**
+     * Start periodic health checks
+     */
+    startPeriodicChecks() {
+        if (this.checkInterval)
+            return;
+        this.checkInterval = setInterval(async () => {
+            await this.checkAll();
+        }, this.config.checkIntervalMs);
+        this.emit('periodic-checks-started');
+    }
+    /**
+     * Stop periodic health checks
+     */
+    stopPeriodicChecks() {
+        if (this.checkInterval) {
+            clearInterval(this.checkInterval);
+            this.checkInterval = null;
+            this.emit('periodic-checks-stopped');
+        }
+    }
+    /**
+     * Get current health status
+     */
+    getStatus() {
+        const servers = Array.from(this.healthStatus.values());
+        const unhealthyCount = servers.filter((s) => !s.healthy).length;
+        return {
+            allHealthy: unhealthyCount === 0,
+            servers,
+            unhealthyCount,
+            totalServers: this.servers.length,
+            lastFullCheck: new Date(Math.max(...servers.map((s) => s.lastCheck.getTime()))),
+        };
+    }
+    /**
+     * Get list of registered servers
+     */
+    getRegisteredServers() {
+        return [...this.servers];
+    }
+    /**
+     * Register a new server
+     */
+    registerServer(server) {
+        if (this.servers.some((s) => s.id === server.id)) {
+            throw new Error(`Server ${server.id} already registered`);
+        }
+        this.servers.push(server);
+        this.healthStatus.set(server.id, {
+            serverId: server.id,
+            serverName: server.name,
+            healthy: false,
+            lastCheck: new Date(0),
+            consecutiveFailures: 0,
+        });
+        this.emit('server-registered', server);
+    }
+    /**
+     * Unregister a server
+     */
+    unregisterServer(serverId) {
+        const index = this.servers.findIndex((s) => s.id === serverId);
+        if (index >= 0) {
+            this.servers.splice(index, 1);
+            this.healthStatus.delete(serverId);
+            this.emit('server-unregistered', { serverId });
+        }
+    }
+    /**
+     * Get health summary
+     */
+    getHealth() {
+        const status = this.getStatus();
+        if (status.allHealthy) {
+            return {
+                healthy: true,
+                message: `MCPHealthChecker: All ${status.totalServers} servers healthy`,
+            };
+        }
+        const unhealthyNames = status.servers
+            .filter((s) => !s.healthy)
+            .map((s) => s.serverName)
+            .join(', ');
+        return {
+            healthy: false,
+            message: `MCPHealthChecker: ${status.unhealthyCount}/${status.totalServers} unhealthy (${unhealthyNames})`,
+        };
+    }
+    // ==================== Private Methods ====================
+    async performHealthCheck(server) {
+        // Use custom health check if provided
+        if (this.healthCheckFn) {
+            return this.healthCheckFn(server);
+        }
+        // Default implementation - simulates health check
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error(`Health check timeout for ${server.id}`));
+            }, this.config.healthCheckTimeoutMs);
+            // Simulate health check
+            // In production, this would ping the actual MCP server
+            setTimeout(() => {
+                clearTimeout(timeout);
+                // Assume healthy if server config exists
+                resolve(true);
+            }, 50 + Math.random() * 100);
+        });
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create an MCPHealthChecker with default settings
+ */
+export function createMCPHealthChecker(servers, config) {
+    return new MCPHealthChecker(servers, config);
+}
+/**
+ * Create an MCPHealthChecker for FlutterAI default servers
+ */
+export function createFlutterAIMCPHealthChecker(config) {
+    return new MCPHealthChecker(FLUTTERAI_MCP_SERVERS, config);
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export default MCPHealthChecker;
+//# sourceMappingURL=MCPHealthChecker.js.map

package/dist/mcp/MCPHealthChecker.js.map

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

package/dist/mcp/MCPRecovery.d.ts

@@ -0,0 +1,175 @@
+/**
+ * FlutterAI V16 - MCP Recovery
+ * Issue 16.2: MCP Server Recovery
+ *
+ * Automatic recovery when MCP servers fail:
+ * - Retry with exponential backoff
+ * - Fallback to alternative servers
+ * - Queue calls during recovery
+ * - Track recovery statistics
+ *
+ * @module mcp/MCPRecovery
+ * @version 16.0.0
+ */
+import { EventEmitter } from 'events';
+import { MCPHealthChecker } from './MCPHealthChecker.js';
+export type RecoveryStrategy = 'restart' | 'fallback' | 'queue' | 'fail';
+export interface RecoveryAction {
+    /** Action ID */
+    id: string;
+    /** Server being recovered */
+    serverId: string;
+    /** Strategy used */
+    strategy: RecoveryStrategy;
+    /** When action was taken */
+    timestamp: Date;
+    /** Whether recovery succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Number of retries */
+    retryCount: number;
+    /** Duration of recovery attempt */
+    durationMs: number;
+}
+export interface QueuedCall {
+    /** Call ID */
+    id: string;
+    /** Server to call */
+    serverId: string;
+    /** Tool name */
+    toolName: string;
+    /** Arguments */
+    arguments: Record<string, unknown>;
+    /** When queued */
+    queuedAt: Date;
+    /** Timeout handle */
+    timeout: NodeJS.Timeout;
+    /** Resolve function */
+    resolve: (result: boolean) => void;
+    /** Reject function */
+    reject: (error: Error) => void;
+}
+export interface MCPRecoveryConfig {
+    /** Maximum retry attempts */
+    maxRetries?: number;
+    /** Initial retry delay in ms */
+    retryDelayMs?: number;
+    /** Backoff multiplier */
+    backoffMultiplier?: number;
+    /** Maximum retry delay */
+    maxRetryDelayMs?: number;
+    /** Queue timeout in ms */
+    queueTimeoutMs?: number;
+    /** Fallback server mapping (serverId -> fallbackServerId) */
+    fallbackServers?: Record<string, string>;
+    /** Auto-recover on health check failure */
+    autoRecover?: boolean;
+}
+export declare class MCPRecovery extends EventEmitter {
+    private config;
+    private healthChecker;
+    private recoveryHistory;
+    private activeRecoveries;
+    private queuedCalls;
+    private actionCounter;
+    private totalRecoveries;
+    private successfulRecoveries;
+    private failedRecoveries;
+    constructor(healthChecker: MCPHealthChecker, config?: MCPRecoveryConfig);
+    /**
+     * Initiate recovery for a server
+     */
+    initiateRecovery(serverId: string): Promise<boolean>;
+    /**
+     * Perform recovery with retry and fallback
+     */
+    private performRecovery;
+    /**
+     * Try to restart a server
+     */
+    private tryRestart;
+    /**
+     * Queue a call while server is recovering
+     */
+    queueCall(serverId: string, toolName: string, args: Record<string, unknown>, timeoutMs?: number): Promise<boolean>;
+    /**
+     * Process queued calls after recovery
+     */
+    private processQueue;
+    /**
+     * Remove a specific call from queue
+     */
+    private removeFromQueue;
+    /**
+     * Record recovery action
+     */
+    private recordAction;
+    /**
+     * Set fallback server mapping
+     */
+    setFallback(serverId: string, fallbackId: string): void;
+    /**
+     * Remove fallback mapping
+     */
+    removeFallback(serverId: string): void;
+    /**
+     * Get current fallback mappings
+     */
+    getFallbacks(): Record<string, string>;
+    /**
+     * Check if server is currently recovering
+     */
+    isRecovering(serverId: string): boolean;
+    /**
+     * Get all servers currently recovering
+     */
+    getRecoveringServers(): string[];
+    /**
+     * Get queued calls for a server
+     */
+    getQueuedCalls(serverId: string): number;
+    /**
+     * Get total queued calls
+     */
+    getTotalQueuedCalls(): number;
+    /**
+     * Get recovery history
+     */
+    getHistory(): RecoveryAction[];
+    /**
+     * Get recovery statistics
+     */
+    getStats(): {
+        totalRecoveries: number;
+        successfulRecoveries: number;
+        failedRecoveries: number;
+        successRate: number;
+        averageRetries: number;
+        averageDurationMs: number;
+        byStrategy: Record<RecoveryStrategy, number>;
+        activeRecoveries: number;
+        queuedCalls: number;
+    };
+    /**
+     * Get health status
+     */
+    getHealth(): {
+        healthy: boolean;
+        message: string;
+    };
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Utility delay function
+     */
+    private delay;
+}
+/**
+ * Create MCPRecovery with standard configuration
+ */
+export declare function createMCPRecovery(healthChecker: MCPHealthChecker, config?: MCPRecoveryConfig): MCPRecovery;
+export default MCPRecovery;
+//# sourceMappingURL=MCPRecovery.d.ts.map

package/dist/mcp/MCPRecovery.d.ts.map

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