@agentic-qe/v3 3.0.0-alpha.10

package/dist/mcp/metrics/metrics-collector.js

@@ -0,0 +1,377 @@
+/**
+ * Agentic QE v3 - Real Metrics Collector
+ * Collects actual system metrics instead of fake Math.random() values
+ *
+ * Tracks:
+ * - CPU usage via process.cpuUsage()
+ * - Memory usage via process.memoryUsage()
+ * - Task completion times with process.hrtime()
+ * - Success/failure counts per agent
+ * - Retry counts
+ * - Load distribution
+ */
+// Configuration
+const SLIDING_WINDOW_SIZE = 100;
+const RESOURCE_SNAPSHOT_INTERVAL_MS = 1000;
+const MAX_RESOURCE_SNAPSHOTS = 60; // Keep 1 minute of snapshots
+/**
+ * Singleton MetricsCollector for tracking real metrics across the system
+ */
+class MetricsCollectorImpl {
+    taskMetrics = [];
+    agentMetrics = new Map();
+    resourceSnapshots = [];
+    workerLoads = new Map();
+    activeTasks = new Map();
+    lastCpuUsage = null;
+    snapshotInterval = null;
+    initialized = false;
+    /**
+     * Initialize the metrics collector and start resource monitoring
+     */
+    initialize() {
+        if (this.initialized)
+            return;
+        this.initialized = true;
+        // Take initial CPU snapshot
+        this.lastCpuUsage = process.cpuUsage();
+        // Start periodic resource snapshots
+        this.snapshotInterval = setInterval(() => {
+            this.takeResourceSnapshot();
+        }, RESOURCE_SNAPSHOT_INTERVAL_MS);
+        // Don't prevent process from exiting
+        if (this.snapshotInterval.unref) {
+            this.snapshotInterval.unref();
+        }
+    }
+    /**
+     * Stop the metrics collector
+     */
+    shutdown() {
+        if (this.snapshotInterval) {
+            clearInterval(this.snapshotInterval);
+            this.snapshotInterval = null;
+        }
+        this.initialized = false;
+    }
+    /**
+     * Start tracking a task
+     */
+    startTask(taskId, agentId) {
+        this.ensureInitialized();
+        const metric = {
+            taskId,
+            agentId,
+            startTime: process.hrtime(),
+            success: false,
+            retries: 0,
+        };
+        this.activeTasks.set(taskId, metric);
+        // Update worker load
+        this.updateWorkerLoad(agentId, 1, 0);
+    }
+    /**
+     * Record a retry for a task
+     */
+    recordRetry(taskId) {
+        const task = this.activeTasks.get(taskId);
+        if (task) {
+            task.retries++;
+        }
+    }
+    /**
+     * Complete a task (success or failure)
+     */
+    completeTask(taskId, success) {
+        const task = this.activeTasks.get(taskId);
+        if (!task) {
+            return 0;
+        }
+        task.endTime = process.hrtime();
+        task.success = success;
+        // Calculate duration in milliseconds
+        const diff = process.hrtime(task.startTime);
+        task.durationMs = diff[0] * 1000 + diff[1] / 1e6;
+        // Update agent metrics
+        this.updateAgentMetrics(task);
+        // Update worker load
+        this.updateWorkerLoad(task.agentId, -1, 1);
+        // Move to completed metrics (sliding window)
+        this.taskMetrics.push(task);
+        if (this.taskMetrics.length > SLIDING_WINDOW_SIZE) {
+            this.taskMetrics.shift();
+        }
+        this.activeTasks.delete(taskId);
+        return task.durationMs;
+    }
+    /**
+     * Get current CPU usage percentage
+     */
+    getCpuUsagePercent() {
+        this.ensureInitialized();
+        if (!this.lastCpuUsage) {
+            this.lastCpuUsage = process.cpuUsage();
+            return 0;
+        }
+        const currentUsage = process.cpuUsage(this.lastCpuUsage);
+        this.lastCpuUsage = process.cpuUsage();
+        // Total CPU time in microseconds
+        const totalCpuTime = currentUsage.user + currentUsage.system;
+        // Convert to percentage (assuming 1 second sample interval)
+        // CPU usage = (cpu time / elapsed time) * 100
+        const elapsedMs = RESOURCE_SNAPSHOT_INTERVAL_MS;
+        const elapsedMicros = elapsedMs * 1000;
+        const cpuPercent = (totalCpuTime / elapsedMicros) * 100;
+        // Cap at 100% and floor at 0%
+        return Math.min(100, Math.max(0, cpuPercent));
+    }
+    /**
+     * Get current memory usage percentage
+     */
+    getMemoryUsagePercent() {
+        const memUsage = process.memoryUsage();
+        // Heap usage as percentage of heap total
+        const heapUsedPercent = (memUsage.heapUsed / memUsage.heapTotal) * 100;
+        return Math.min(100, Math.max(0, heapUsedPercent));
+    }
+    /**
+     * Get resource stats for an agent or overall
+     */
+    getResourceStats(agentId) {
+        return {
+            cpu: this.getCpuUsagePercent(),
+            memory: this.getMemoryUsagePercent(),
+        };
+    }
+    /**
+     * Get task stats for a specific agent
+     */
+    getAgentTaskStats(agentId) {
+        const metrics = this.agentMetrics.get(agentId);
+        if (!metrics || metrics.taskCount === 0) {
+            return {
+                tasksCompleted: 0,
+                averageTime: 0,
+                successRate: 1.0, // Default to 100% if no tasks
+            };
+        }
+        const totalTasks = metrics.tasksCompleted + metrics.tasksFailed;
+        const successRate = totalTasks > 0 ? metrics.tasksCompleted / totalTasks : 1.0;
+        const averageTime = metrics.taskCount > 0 ? metrics.totalDurationMs / metrics.taskCount : 0;
+        return {
+            tasksCompleted: metrics.tasksCompleted,
+            averageTime: Math.round(averageTime),
+            successRate: Math.min(1.0, Math.max(0, successRate)),
+        };
+    }
+    /**
+     * Get worker efficiency based on actual throughput
+     */
+    getWorkerEfficiency() {
+        if (this.taskMetrics.length === 0) {
+            return 0.85; // Default baseline
+        }
+        // Calculate efficiency based on:
+        // - Success rate
+        // - Average time vs expected time
+        // - Retry rate
+        const successCount = this.taskMetrics.filter((t) => t.success).length;
+        const successRate = successCount / this.taskMetrics.length;
+        const totalRetries = this.taskMetrics.reduce((sum, t) => sum + t.retries, 0);
+        const retryRate = totalRetries / this.taskMetrics.length;
+        // Efficiency = success rate * (1 - retry penalty)
+        const retryPenalty = Math.min(0.2, retryRate * 0.1); // Max 20% penalty
+        const efficiency = successRate * (1 - retryPenalty);
+        return Math.min(1.0, Math.max(0, efficiency));
+    }
+    /**
+     * Get load balance score based on actual distribution
+     */
+    getLoadBalanceScore() {
+        if (this.workerLoads.size === 0) {
+            return 0.9; // Default baseline
+        }
+        const loads = Array.from(this.workerLoads.values()).map((w) => w.completedTaskCount);
+        if (loads.length <= 1) {
+            return 1.0; // Perfect balance with 0-1 workers
+        }
+        // Calculate coefficient of variation (lower = better balance)
+        const mean = loads.reduce((a, b) => a + b, 0) / loads.length;
+        if (mean === 0) {
+            return 1.0;
+        }
+        const variance = loads.reduce((sum, val) => sum + Math.pow(val - mean, 2), 0) / loads.length;
+        const stdDev = Math.sqrt(variance);
+        const cv = stdDev / mean;
+        // Convert CV to a 0-1 score (lower CV = higher score)
+        // CV of 0 = perfect balance (score 1.0)
+        // CV of 1 = moderate imbalance (score ~0.5)
+        const balanceScore = 1 / (1 + cv);
+        return Math.min(1.0, Math.max(0, balanceScore));
+    }
+    /**
+     * Get retry statistics
+     */
+    getRetryStats() {
+        let totalRetries = 0;
+        let successfulRetries = 0;
+        let maxRetriesReached = 0;
+        for (const metrics of this.agentMetrics.values()) {
+            totalRetries += metrics.totalRetries;
+            successfulRetries += metrics.successfulRetries;
+            maxRetriesReached += metrics.maxRetriesReached;
+        }
+        return {
+            totalRetries,
+            successfulRetries,
+            maxRetriesReached,
+        };
+    }
+    /**
+     * Get average execution time from recent tasks
+     */
+    getAverageExecutionTime() {
+        if (this.taskMetrics.length === 0) {
+            return 0;
+        }
+        const totalMs = this.taskMetrics.reduce((sum, t) => sum + (t.durationMs || 0), 0);
+        return Math.round(totalMs / this.taskMetrics.length);
+    }
+    /**
+     * Get number of workers used (with active or completed tasks)
+     */
+    getWorkersUsed() {
+        return this.workerLoads.size;
+    }
+    /**
+     * Generate individual test result durations based on actual execution
+     * Uses the sliding window of real task durations
+     */
+    getTestDurations(count) {
+        const durations = [];
+        if (this.taskMetrics.length === 0) {
+            // No real data - return reasonable estimates based on typical test times
+            for (let i = 0; i < count; i++) {
+                durations.push(100 + i * 10); // Start at 100ms, increment by 10ms
+            }
+            return durations;
+        }
+        // Use real durations from the sliding window
+        const realDurations = this.taskMetrics.map((t) => t.durationMs || 200).sort((a, b) => a - b);
+        for (let i = 0; i < count; i++) {
+            // Sample from real durations with wrapping
+            const index = i % realDurations.length;
+            durations.push(Math.round(realDurations[index]));
+        }
+        return durations;
+    }
+    /**
+     * Record a successful retry for tracking
+     */
+    recordSuccessfulRetry(agentId) {
+        const metrics = this.agentMetrics.get(agentId);
+        if (metrics) {
+            metrics.successfulRetries++;
+        }
+    }
+    /**
+     * Record when max retries is reached for a task
+     */
+    recordMaxRetriesReached(agentId) {
+        const metrics = this.agentMetrics.get(agentId);
+        if (metrics) {
+            metrics.maxRetriesReached++;
+        }
+    }
+    /**
+     * Reset all metrics (useful for testing)
+     */
+    reset() {
+        this.taskMetrics = [];
+        this.agentMetrics.clear();
+        this.resourceSnapshots = [];
+        this.workerLoads.clear();
+        this.activeTasks.clear();
+        this.lastCpuUsage = null;
+    }
+    // Private helper methods
+    ensureInitialized() {
+        if (!this.initialized) {
+            this.initialize();
+        }
+    }
+    updateAgentMetrics(task) {
+        let metrics = this.agentMetrics.get(task.agentId);
+        if (!metrics) {
+            metrics = {
+                agentId: task.agentId,
+                tasksCompleted: 0,
+                tasksFailed: 0,
+                totalRetries: 0,
+                successfulRetries: 0,
+                maxRetriesReached: 0,
+                totalDurationMs: 0,
+                taskCount: 0,
+            };
+            this.agentMetrics.set(task.agentId, metrics);
+        }
+        if (task.success) {
+            metrics.tasksCompleted++;
+            if (task.retries > 0) {
+                metrics.successfulRetries++;
+            }
+        }
+        else {
+            metrics.tasksFailed++;
+        }
+        metrics.totalRetries += task.retries;
+        metrics.totalDurationMs += task.durationMs || 0;
+        metrics.taskCount++;
+    }
+    updateWorkerLoad(workerId, activeTaskDelta, completedTaskDelta) {
+        let load = this.workerLoads.get(workerId);
+        if (!load) {
+            load = {
+                workerId,
+                activeTaskCount: 0,
+                completedTaskCount: 0,
+                lastActivityTime: Date.now(),
+            };
+            this.workerLoads.set(workerId, load);
+        }
+        load.activeTaskCount = Math.max(0, load.activeTaskCount + activeTaskDelta);
+        load.completedTaskCount += completedTaskDelta;
+        load.lastActivityTime = Date.now();
+    }
+    takeResourceSnapshot() {
+        const memUsage = process.memoryUsage();
+        const cpuUsage = process.cpuUsage();
+        const snapshot = {
+            timestamp: Date.now(),
+            cpuUser: cpuUsage.user,
+            cpuSystem: cpuUsage.system,
+            memoryHeapUsed: memUsage.heapUsed,
+            memoryHeapTotal: memUsage.heapTotal,
+            memoryExternal: memUsage.external,
+            memoryRss: memUsage.rss,
+        };
+        this.resourceSnapshots.push(snapshot);
+        // Keep only the most recent snapshots
+        if (this.resourceSnapshots.length > MAX_RESOURCE_SNAPSHOTS) {
+            this.resourceSnapshots.shift();
+        }
+    }
+}
+// Export singleton instance
+export const MetricsCollector = new MetricsCollectorImpl();
+// Export class for testing
+export { MetricsCollectorImpl };
+// Helper to create a scoped task tracker for easier usage
+export function createTaskTracker(taskId, agentId) {
+    MetricsCollector.startTask(taskId, agentId);
+    return {
+        recordRetry: () => MetricsCollector.recordRetry(taskId),
+        complete: (success) => MetricsCollector.completeTask(taskId, success),
+    };
+}
+//# sourceMappingURL=metrics-collector.js.map

package/dist/mcp/metrics/metrics-collector.js.map

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

package/dist/mcp/protocol-server.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Agentic QE v3 - MCP Protocol Server
+ * Full MCP 2025-11-25 protocol implementation with stdio transport
+ * Based on claude-flow MCP implementation
+ */
+export interface MCPServerConfig {
+    name?: string;
+    version?: string;
+    transport?: 'stdio' | 'http' | 'websocket';
+    maxRequestSize?: number;
+}
+export interface MCPCapabilities {
+    tools?: {
+        listChanged?: boolean;
+    };
+    resources?: {
+        subscribe?: boolean;
+        listChanged?: boolean;
+    };
+    prompts?: {
+        listChanged?: boolean;
+    };
+    logging?: Record<string, unknown>;
+}
+export interface MCPServerInfo {
+    name: string;
+    version: string;
+    protocolVersion: string;
+}
+export declare class MCPProtocolServer {
+    private readonly config;
+    private readonly transport;
+    private readonly registry;
+    private readonly tools;
+    private initialized;
+    private clientInfo;
+    constructor(config?: MCPServerConfig);
+    /**
+     * Start the MCP server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the MCP server
+     */
+    stop(): Promise<void>;
+    /**
+     * Get server capabilities
+     */
+    getCapabilities(): MCPCapabilities;
+    /**
+     * Get server info
+     */
+    getServerInfo(): MCPServerInfo;
+    private handleRequest;
+    private handleNotification;
+    private handleInitialize;
+    private handleShutdown;
+    private handleToolsList;
+    private handleToolsCall;
+    private registerAllTools;
+    private registerTool;
+    private buildInputSchema;
+}
+export declare function createMCPProtocolServer(config?: MCPServerConfig): MCPProtocolServer;
+export declare function quickStart(config?: MCPServerConfig): Promise<MCPProtocolServer>;
+//# sourceMappingURL=protocol-server.d.ts.map

package/dist/mcp/protocol-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-server.d.ts","sourceRoot":"","sources":["../../src/mcp/protocol-server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+CH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAClC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB;AAWD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAkD;gBAExD,MAAM,GAAE,eAAoB;IAkBxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACH,eAAe,IAAI,eAAe;IAOlC;;OAEG;IACH,aAAa,IAAI,aAAa;YAYhB,aAAa;YA+Bb,kBAAkB;YAuBlB,gBAAgB;YAyBhB,cAAc;IAU5B,OAAO,CAAC,eAAe;YAUT,eAAe;IAyC7B,OAAO,CAAC,gBAAgB;IAoYxB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,gBAAgB;CAuCzB;AAMD,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAEnF;AAMD,wBAAsB,UAAU,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAIrF"}