claude-flow 2.7.0-alpha.8 → 2.7.0

package/dist/coordination/metrics.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Metrics and monitoring for coordination performance
+ */
+import type { ILogger } from '../core/logger.js';
+import type { IEventBus } from '../core/event-bus.js';
+export interface CoordinationMetrics {
+    timestamp: Date;
+    taskMetrics: {
+        totalTasks: number;
+        activeTasks: number;
+        completedTasks: number;
+        failedTasks: number;
+        cancelledTasks: number;
+        avgTaskDuration: number;
+        taskThroughput: number;
+        tasksByPriority: Record<string, number>;
+        tasksByType: Record<string, number>;
+    };
+    agentMetrics: {
+        totalAgents: number;
+        activeAgents: number;
+        idleAgents: number;
+        busyAgents: number;
+        agentUtilization: number;
+        avgTasksPerAgent: number;
+        agentsByType: Record<string, number>;
+    };
+    resourceMetrics: {
+        totalResources: number;
+        lockedResources: number;
+        freeResources: number;
+        resourceUtilization: number;
+        avgLockDuration: number;
+        lockContention: number;
+        deadlockCount: number;
+    };
+    coordinationMetrics: {
+        messagesSent: number;
+        messagesReceived: number;
+        messageLatency: number;
+        conflictsDetected: number;
+        conflictsResolved: number;
+        workStealingEvents: number;
+        circuitBreakerTrips: number;
+    };
+    performanceMetrics: {
+        coordinationLatency: number;
+        schedulingLatency: number;
+        memoryUsage: number;
+        cpuUsage: number;
+        errorRate: number;
+    };
+}
+export interface MetricsSample {
+    timestamp: Date;
+    metric: string;
+    value: number;
+    tags?: Record<string, string>;
+}
+/**
+ * Metrics collector for coordination system
+ */
+export declare class CoordinationMetricsCollector {
+    private logger;
+    private eventBus;
+    private collectionIntervalMs;
+    private samples;
+    private taskStartTimes;
+    private messageStartTimes;
+    private lockStartTimes;
+    private collectionInterval?;
+    private counters;
+    private gauges;
+    private histograms;
+    constructor(logger: ILogger, eventBus: IEventBus, collectionIntervalMs?: number);
+    /**
+     * Start metrics collection
+     */
+    start(): void;
+    /**
+     * Stop metrics collection
+     */
+    stop(): void;
+    /**
+     * Record a metric sample
+     */
+    recordMetric(metric: string, value: number, tags?: Record<string, string>): void;
+    /**
+     * Get current metrics snapshot
+     */
+    getCurrentMetrics(): CoordinationMetrics;
+    /**
+     * Get metric history for a specific metric
+     */
+    getMetricHistory(metric: string, since?: Date): MetricsSample[];
+    /**
+     * Get top metrics by value
+     */
+    getTopMetrics(limit?: number): Array<{
+        metric: string;
+        value: number;
+        timestamp: Date;
+    }>;
+    /**
+     * Set up event handlers to collect metrics
+     */
+    private setupEventHandlers;
+    /**
+     * Collect comprehensive metrics
+     */
+    private collectMetrics;
+    /**
+     * Calculate average from array of numbers
+     */
+    private average;
+    /**
+     * Get tasks grouped by priority
+     */
+    private getTasksByPriority;
+    /**
+     * Get tasks grouped by type
+     */
+    private getTasksByType;
+    /**
+     * Get agents grouped by type
+     */
+    private getAgentsByType;
+    /**
+     * Calculate agent utilization percentage
+     */
+    private calculateAgentUtilization;
+    /**
+     * Calculate average tasks per agent
+     */
+    private calculateAvgTasksPerAgent;
+    /**
+     * Calculate resource utilization percentage
+     */
+    private calculateResourceUtilization;
+    /**
+     * Get current memory usage in MB
+     */
+    private getMemoryUsage;
+    /**
+     * Get current CPU usage percentage
+     */
+    private getCpuUsage;
+    /**
+     * Clear all metrics data
+     */
+    clearMetrics(): void;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/coordination/metrics.d.ts.map

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

package/dist/coordination/metrics.js

@@ -0,0 +1,436 @@
+/**
+ * Metrics and monitoring for coordination performance
+ */
+import { SystemEvents } from '../utils/types.js';
+/**
+ * Metrics collector for coordination system
+ */
+export class CoordinationMetricsCollector {
+    logger;
+    eventBus;
+    collectionIntervalMs;
+    samples = [];
+    taskStartTimes = new Map();
+    messageStartTimes = new Map();
+    lockStartTimes = new Map();
+    collectionInterval;
+    // Counters
+    counters = {
+        totalTasks: 0,
+        completedTasks: 0,
+        failedTasks: 0,
+        cancelledTasks: 0,
+        messagesSent: 0,
+        messagesReceived: 0,
+        conflictsDetected: 0,
+        conflictsResolved: 0,
+        workStealingEvents: 0,
+        circuitBreakerTrips: 0,
+        deadlockCount: 0,
+        errors: 0,
+    };
+    // Gauges
+    gauges = {
+        activeTasks: 0,
+        activeAgents: 0,
+        idleAgents: 0,
+        busyAgents: 0,
+        lockedResources: 0,
+        freeResources: 0,
+        lockContention: 0,
+    };
+    // Histograms (for calculating averages)
+    histograms = {
+        taskDurations: [],
+        messageDurations: [],
+        lockDurations: [],
+        coordinationLatencies: [],
+        schedulingLatencies: [],
+    };
+    constructor(logger, eventBus, collectionIntervalMs = 30000) {
+        this.logger = logger;
+        this.eventBus = eventBus;
+        this.collectionIntervalMs = collectionIntervalMs;
+        this.setupEventHandlers();
+    }
+    /**
+     * Start metrics collection
+     */
+    start() {
+        this.logger.info('Starting coordination metrics collection');
+        this.collectionInterval = setInterval(() => {
+            this.collectMetrics();
+        }, this.collectionIntervalMs);
+    }
+    /**
+     * Stop metrics collection
+     */
+    stop() {
+        if (this.collectionInterval) {
+            clearInterval(this.collectionInterval);
+            delete this.collectionInterval;
+        }
+        this.logger.info('Stopped coordination metrics collection');
+    }
+    /**
+     * Record a metric sample
+     */
+    recordMetric(metric, value, tags) {
+        const sample = {
+            timestamp: new Date(),
+            metric,
+            value,
+        };
+        if (tags !== undefined) {
+            sample.tags = tags;
+        }
+        this.samples.push(sample);
+        // Keep only last 10000 samples to prevent memory bloat
+        if (this.samples.length > 10000) {
+            this.samples = this.samples.slice(-5000);
+        }
+    }
+    /**
+     * Get current metrics snapshot
+     */
+    getCurrentMetrics() {
+        const now = new Date();
+        const minuteAgo = new Date(now.getTime() - 60000);
+        // Calculate throughput (items per minute)
+        const recentSamples = this.samples.filter((s) => s.timestamp >= minuteAgo);
+        const taskCompletions = recentSamples.filter((s) => s.metric === 'task.completed').length;
+        const errorCount = recentSamples.filter((s) => s.metric === 'error').length;
+        return {
+            timestamp: now,
+            taskMetrics: {
+                totalTasks: this.counters.totalTasks,
+                activeTasks: this.gauges.activeTasks,
+                completedTasks: this.counters.completedTasks,
+                failedTasks: this.counters.failedTasks,
+                cancelledTasks: this.counters.cancelledTasks,
+                avgTaskDuration: this.average(this.histograms.taskDurations),
+                taskThroughput: taskCompletions,
+                tasksByPriority: this.getTasksByPriority(),
+                tasksByType: this.getTasksByType(),
+            },
+            agentMetrics: {
+                totalAgents: this.gauges.activeAgents + this.gauges.idleAgents,
+                activeAgents: this.gauges.activeAgents,
+                idleAgents: this.gauges.idleAgents,
+                busyAgents: this.gauges.busyAgents,
+                agentUtilization: this.calculateAgentUtilization(),
+                avgTasksPerAgent: this.calculateAvgTasksPerAgent(),
+                agentsByType: this.getAgentsByType(),
+            },
+            resourceMetrics: {
+                totalResources: this.gauges.lockedResources + this.gauges.freeResources,
+                lockedResources: this.gauges.lockedResources,
+                freeResources: this.gauges.freeResources,
+                resourceUtilization: this.calculateResourceUtilization(),
+                avgLockDuration: this.average(this.histograms.lockDurations),
+                lockContention: this.gauges.lockContention,
+                deadlockCount: this.counters.deadlockCount,
+            },
+            coordinationMetrics: {
+                messagesSent: this.counters.messagesSent,
+                messagesReceived: this.counters.messagesReceived,
+                messageLatency: this.average(this.histograms.messageDurations),
+                conflictsDetected: this.counters.conflictsDetected,
+                conflictsResolved: this.counters.conflictsResolved,
+                workStealingEvents: this.counters.workStealingEvents,
+                circuitBreakerTrips: this.counters.circuitBreakerTrips,
+            },
+            performanceMetrics: {
+                coordinationLatency: this.average(this.histograms.coordinationLatencies),
+                schedulingLatency: this.average(this.histograms.schedulingLatencies),
+                memoryUsage: this.getMemoryUsage(),
+                cpuUsage: this.getCpuUsage(),
+                errorRate: errorCount,
+            },
+        };
+    }
+    /**
+     * Get metric history for a specific metric
+     */
+    getMetricHistory(metric, since) {
+        const cutoff = since || new Date(Date.now() - 3600000); // 1 hour ago
+        return this.samples.filter((s) => s.metric === metric && s.timestamp >= cutoff);
+    }
+    /**
+     * Get top metrics by value
+     */
+    getTopMetrics(limit = 10) {
+        const recent = this.samples.filter((s) => s.timestamp >= new Date(Date.now() - 300000));
+        const byMetric = new Map();
+        const timestamps = new Map();
+        for (const sample of recent) {
+            byMetric.set(sample.metric, (byMetric.get(sample.metric) || 0) + sample.value);
+            timestamps.set(sample.metric, sample.timestamp);
+        }
+        return Array.from(byMetric.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, limit)
+            .map(([metric, value]) => ({
+            metric,
+            value,
+            timestamp: timestamps.get(metric),
+        }));
+    }
+    /**
+     * Set up event handlers to collect metrics
+     */
+    setupEventHandlers() {
+        // Task events
+        this.eventBus.on(SystemEvents.TASK_CREATED, () => {
+            this.counters.totalTasks++;
+            this.recordMetric('task.created', 1);
+        });
+        this.eventBus.on(SystemEvents.TASK_STARTED, (data) => {
+            this.taskStartTimes.set(data.taskId, new Date());
+            this.gauges.activeTasks++;
+            this.recordMetric('task.started', 1);
+        });
+        this.eventBus.on(SystemEvents.TASK_COMPLETED, (data) => {
+            this.counters.completedTasks++;
+            this.gauges.activeTasks = Math.max(0, this.gauges.activeTasks - 1);
+            const startTime = this.taskStartTimes.get(data.taskId);
+            if (startTime) {
+                const duration = new Date().getTime() - startTime.getTime();
+                this.histograms.taskDurations.push(duration);
+                this.taskStartTimes.delete(data.taskId);
+            }
+            this.recordMetric('task.completed', 1);
+        });
+        this.eventBus.on(SystemEvents.TASK_FAILED, (data) => {
+            this.counters.failedTasks++;
+            this.gauges.activeTasks = Math.max(0, this.gauges.activeTasks - 1);
+            this.taskStartTimes.delete(data.taskId);
+            this.recordMetric('task.failed', 1);
+        });
+        this.eventBus.on(SystemEvents.TASK_CANCELLED, (data) => {
+            this.counters.cancelledTasks++;
+            this.gauges.activeTasks = Math.max(0, this.gauges.activeTasks - 1);
+            this.taskStartTimes.delete(data.taskId);
+            this.recordMetric('task.cancelled', 1);
+        });
+        // Agent events
+        this.eventBus.on(SystemEvents.AGENT_SPAWNED, () => {
+            this.gauges.activeAgents++;
+            this.recordMetric('agent.spawned', 1);
+        });
+        this.eventBus.on(SystemEvents.AGENT_TERMINATED, () => {
+            this.gauges.activeAgents = Math.max(0, this.gauges.activeAgents - 1);
+            this.recordMetric('agent.terminated', 1);
+        });
+        this.eventBus.on(SystemEvents.AGENT_IDLE, () => {
+            this.gauges.idleAgents++;
+            this.gauges.busyAgents = Math.max(0, this.gauges.busyAgents - 1);
+            this.recordMetric('agent.idle', 1);
+        });
+        this.eventBus.on(SystemEvents.AGENT_ACTIVE, () => {
+            this.gauges.busyAgents++;
+            this.gauges.idleAgents = Math.max(0, this.gauges.idleAgents - 1);
+            this.recordMetric('agent.active', 1);
+        });
+        // Resource events
+        this.eventBus.on(SystemEvents.RESOURCE_ACQUIRED, (data) => {
+            this.lockStartTimes.set(data.resourceId, new Date());
+            this.gauges.lockedResources++;
+            this.gauges.freeResources = Math.max(0, this.gauges.freeResources - 1);
+            this.recordMetric('resource.acquired', 1);
+        });
+        this.eventBus.on(SystemEvents.RESOURCE_RELEASED, (data) => {
+            this.gauges.freeResources++;
+            this.gauges.lockedResources = Math.max(0, this.gauges.lockedResources - 1);
+            const startTime = this.lockStartTimes.get(data.resourceId);
+            if (startTime) {
+                const duration = new Date().getTime() - startTime.getTime();
+                this.histograms.lockDurations.push(duration);
+                this.lockStartTimes.delete(data.resourceId);
+            }
+            this.recordMetric('resource.released', 1);
+        });
+        // Deadlock events
+        this.eventBus.on(SystemEvents.DEADLOCK_DETECTED, () => {
+            this.counters.deadlockCount++;
+            this.recordMetric('deadlock.detected', 1);
+        });
+        // Message events
+        this.eventBus.on(SystemEvents.MESSAGE_SENT, (data) => {
+            this.counters.messagesSent++;
+            this.messageStartTimes.set(data.message.id, new Date());
+            this.recordMetric('message.sent', 1);
+        });
+        this.eventBus.on(SystemEvents.MESSAGE_RECEIVED, (data) => {
+            this.counters.messagesReceived++;
+            const startTime = this.messageStartTimes.get(data.message.id);
+            if (startTime) {
+                const duration = new Date().getTime() - startTime.getTime();
+                this.histograms.messageDurations.push(duration);
+                this.messageStartTimes.delete(data.message.id);
+            }
+            this.recordMetric('message.received', 1);
+        });
+        // Conflict events
+        this.eventBus.on('conflict:resource', () => {
+            this.counters.conflictsDetected++;
+            this.recordMetric('conflict.detected', 1);
+        });
+        this.eventBus.on('conflict:resolved', () => {
+            this.counters.conflictsResolved++;
+            this.recordMetric('conflict.resolved', 1);
+        });
+        // Work stealing events
+        this.eventBus.on('workstealing:request', () => {
+            this.counters.workStealingEvents++;
+            this.recordMetric('workstealing.event', 1);
+        });
+        // Circuit breaker events
+        this.eventBus.on('circuitbreaker:state-change', (data) => {
+            if (data.to === 'open') {
+                this.counters.circuitBreakerTrips++;
+                this.recordMetric('circuitbreaker.trip', 1);
+            }
+        });
+        // Error events
+        this.eventBus.on(SystemEvents.SYSTEM_ERROR, () => {
+            this.counters.errors++;
+            this.recordMetric('error', 1);
+        });
+    }
+    /**
+     * Collect comprehensive metrics
+     */
+    collectMetrics() {
+        const metrics = this.getCurrentMetrics();
+        // Emit metrics event
+        this.eventBus.emit('metrics:coordination', metrics);
+        // Log summary
+        this.logger.debug('Coordination metrics collected', {
+            activeTasks: metrics.taskMetrics.activeTasks,
+            activeAgents: metrics.agentMetrics.activeAgents,
+            lockedResources: metrics.resourceMetrics.lockedResources,
+            taskThroughput: metrics.taskMetrics.taskThroughput,
+        });
+    }
+    /**
+     * Calculate average from array of numbers
+     */
+    average(values) {
+        if (values.length === 0)
+            return 0;
+        return values.reduce((sum, val) => sum + val, 0) / values.length;
+    }
+    /**
+     * Get tasks grouped by priority
+     */
+    getTasksByPriority() {
+        const priorities = ['low', 'medium', 'high', 'critical'];
+        const result = {};
+        for (const priority of priorities) {
+            result[priority] = this.samples.filter((s) => s.metric === 'task.created' && s.tags?.priority === priority).length;
+        }
+        return result;
+    }
+    /**
+     * Get tasks grouped by type
+     */
+    getTasksByType() {
+        const types = new Set();
+        for (const sample of this.samples) {
+            if (sample.metric === 'task.created' && sample.tags?.type) {
+                types.add(sample.tags.type);
+            }
+        }
+        const result = {};
+        for (const type of types) {
+            result[type] = this.samples.filter((s) => s.metric === 'task.created' && s.tags?.type === type).length;
+        }
+        return result;
+    }
+    /**
+     * Get agents grouped by type
+     */
+    getAgentsByType() {
+        const types = new Set();
+        for (const sample of this.samples) {
+            if (sample.metric === 'agent.spawned' && sample.tags?.type) {
+                types.add(sample.tags.type);
+            }
+        }
+        const result = {};
+        for (const type of types) {
+            result[type] = this.samples.filter((s) => s.metric === 'agent.spawned' && s.tags?.type === type).length;
+        }
+        return result;
+    }
+    /**
+     * Calculate agent utilization percentage
+     */
+    calculateAgentUtilization() {
+        const totalAgents = this.gauges.activeAgents + this.gauges.idleAgents;
+        if (totalAgents === 0)
+            return 0;
+        return (this.gauges.busyAgents / totalAgents) * 100;
+    }
+    /**
+     * Calculate average tasks per agent
+     */
+    calculateAvgTasksPerAgent() {
+        const totalAgents = this.gauges.activeAgents + this.gauges.idleAgents;
+        if (totalAgents === 0)
+            return 0;
+        return this.gauges.activeTasks / totalAgents;
+    }
+    /**
+     * Calculate resource utilization percentage
+     */
+    calculateResourceUtilization() {
+        const totalResources = this.gauges.lockedResources + this.gauges.freeResources;
+        if (totalResources === 0)
+            return 0;
+        return (this.gauges.lockedResources / totalResources) * 100;
+    }
+    /**
+     * Get current memory usage in MB
+     */
+    getMemoryUsage() {
+        if (typeof process !== 'undefined' && process.memoryUsage) {
+            return process.memoryUsage().heapUsed / 1024 / 1024;
+        }
+        return 0;
+    }
+    /**
+     * Get current CPU usage percentage
+     */
+    getCpuUsage() {
+        if (typeof process !== 'undefined' && process.cpuUsage) {
+            const usage = process.cpuUsage();
+            return (usage.user + usage.system) / 1000000; // Convert to seconds
+        }
+        return 0;
+    }
+    /**
+     * Clear all metrics data
+     */
+    clearMetrics() {
+        this.samples = [];
+        this.taskStartTimes.clear();
+        this.messageStartTimes.clear();
+        this.lockStartTimes.clear();
+        // Reset counters
+        for (const key in this.counters) {
+            this.counters[key] = 0;
+        }
+        // Reset gauges
+        for (const key in this.gauges) {
+            this.gauges[key] = 0;
+        }
+        // Clear histograms
+        for (const key in this.histograms) {
+            this.histograms[key] = [];
+        }
+        this.logger.info('Coordination metrics cleared');
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/coordination/metrics.js.map

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

package/dist/coordination/resources.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Resource manager for preventing conflicts and deadlocks
+ */
+import { CoordinationConfig } from '../utils/types.js';
+import type { IEventBus } from '../core/event-bus.js';
+import type { ILogger } from '../core/logger.js';
+/**
+ * Resource manager implementation
+ */
+export declare class ResourceManager {
+    private config;
+    private eventBus;
+    private logger;
+    private resources;
+    private locks;
+    private waitQueue;
+    private agentResources;
+    constructor(config: CoordinationConfig, eventBus: IEventBus, logger: ILogger);
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    acquire(resourceId: string, agentId: string, priority?: number): Promise<void>;
+    release(resourceId: string, agentId: string): Promise<void>;
+    releaseAllForAgent(agentId: string): Promise<void>;
+    getAllocations(): Map<string, string>;
+    getWaitingRequests(): Map<string, string[]>;
+    getHealthStatus(): Promise<{
+        healthy: boolean;
+        error?: string;
+        metrics?: Record<string, number>;
+    }>;
+    private lockResource;
+    private unlockResource;
+    performMaintenance(): Promise<void>;
+    private cleanup;
+}
+//# sourceMappingURL=resources.d.ts.map

package/dist/coordination/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/coordination/resources.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAY,kBAAkB,EAAgB,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAWjD;;GAEG;AACH,qBAAa,eAAe;IAOxB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,MAAM;IARhB,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,cAAc,CAAkC;gBAG9C,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,OAAO;IAGnB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAczB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA0FzE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B3D,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxD,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIrC,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAYrC,eAAe,IAAI,OAAO,CAAC;QAC/B,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;YAuBY,YAAY;IAqB1B,OAAO,CAAC,cAAc;IAqBhB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzC,OAAO,CAAC,OAAO;CAyChB"}