agentic-qe 3.3.4 → 3.4.0

package/v3/dist/testing/load/metrics-collector.js

@@ -0,0 +1,475 @@
+/**
+ * Agentic QE v3 - Load Test Metrics Collector
+ * Performance metrics collection for 100+ agent coordination testing
+ *
+ * Issue #177 Targets:
+ * - 100+ agents
+ * - <4GB memory
+ * - <100ms coordination latency
+ */
+import { CircularBuffer } from '../../shared/utils/index.js';
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    maxEvents: 100000,
+    memorySampleInterval: 1000,
+    enableTimeline: true,
+    timelineSampleInterval: 1000,
+};
+// ============================================================================
+// Metrics Collector Implementation
+// ============================================================================
+/**
+ * MetricsCollector - Collects and analyzes performance metrics for load testing
+ *
+ * Efficiently tracks:
+ * - Agent spawn/terminate events
+ * - Task start/complete with duration
+ * - Coordination latency measurements
+ * - Memory usage snapshots
+ *
+ * Provides:
+ * - P50/P95/P99 latency calculations
+ * - Peak/average memory tracking
+ * - Throughput calculations
+ * - Timeline data for visualization
+ */
+export class MetricsCollector {
+    config;
+    // Active agent tracking
+    activeAgents = new Map(); // agentId -> spawnTimestamp
+    peakAgentCount = 0;
+    totalAgentsSpawned = 0;
+    // Task tracking
+    activeTasks = new Map();
+    totalTasksStarted = 0;
+    totalTasksCompleted = 0;
+    // Latency buffers (using CircularBuffer for memory efficiency)
+    coordinationLatencies;
+    taskDurations;
+    // Memory tracking
+    memorySnapshots;
+    peakMemoryUsed = 0;
+    memorySum = 0;
+    memorySamples = 0;
+    // Timeline tracking
+    agentTimeline = [];
+    latencyTimeline = [];
+    memoryTimeline = [];
+    // Timing
+    startTime = 0;
+    endTime = 0;
+    running = false;
+    memorySamplerTimer = null;
+    timelineSamplerTimer = null;
+    // Issue tracking
+    issues = [];
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        // Initialize circular buffers
+        this.coordinationLatencies = new CircularBuffer(this.config.maxEvents);
+        this.taskDurations = new CircularBuffer(this.config.maxEvents);
+        this.memorySnapshots = new CircularBuffer(10000);
+    }
+    // ============================================================================
+    // Lifecycle
+    // ============================================================================
+    /**
+     * Start collecting metrics
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.startTime = Date.now();
+        // Start memory sampler
+        this.memorySamplerTimer = setInterval(() => {
+            this.sampleMemory();
+        }, this.config.memorySampleInterval);
+        // Start timeline sampler if enabled
+        if (this.config.enableTimeline) {
+            this.timelineSamplerTimer = setInterval(() => {
+                this.sampleTimeline();
+            }, this.config.timelineSampleInterval);
+        }
+    }
+    /**
+     * Stop collecting metrics
+     */
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        this.endTime = Date.now();
+        if (this.memorySamplerTimer) {
+            clearInterval(this.memorySamplerTimer);
+            this.memorySamplerTimer = null;
+        }
+        if (this.timelineSamplerTimer) {
+            clearInterval(this.timelineSamplerTimer);
+            this.timelineSamplerTimer = null;
+        }
+    }
+    /**
+     * Reset all metrics
+     */
+    reset() {
+        this.stop();
+        this.activeAgents.clear();
+        this.peakAgentCount = 0;
+        this.totalAgentsSpawned = 0;
+        this.activeTasks.clear();
+        this.totalTasksStarted = 0;
+        this.totalTasksCompleted = 0;
+        this.coordinationLatencies.clear();
+        this.taskDurations.clear();
+        this.memorySnapshots.clear();
+        this.peakMemoryUsed = 0;
+        this.memorySum = 0;
+        this.memorySamples = 0;
+        this.agentTimeline.length = 0;
+        this.latencyTimeline.length = 0;
+        this.memoryTimeline.length = 0;
+        this.startTime = 0;
+        this.endTime = 0;
+        this.issues.length = 0;
+    }
+    // ============================================================================
+    // Recording Methods
+    // ============================================================================
+    /**
+     * Record agent spawn
+     */
+    recordAgentSpawn(agentId, timestamp = Date.now()) {
+        this.activeAgents.set(agentId, timestamp);
+        this.totalAgentsSpawned++;
+        const currentCount = this.activeAgents.size;
+        if (currentCount > this.peakAgentCount) {
+            this.peakAgentCount = currentCount;
+        }
+    }
+    /**
+     * Record agent termination
+     */
+    recordAgentTerminate(agentId, _timestamp = Date.now()) {
+        this.activeAgents.delete(agentId);
+    }
+    /**
+     * Record task start
+     */
+    recordTaskStart(agentId, taskId, timestamp = Date.now()) {
+        this.activeTasks.set(taskId, { agentId, startTime: timestamp });
+        this.totalTasksStarted++;
+    }
+    /**
+     * Record task completion with duration
+     */
+    recordTaskComplete(agentId, taskId, duration, _timestamp = Date.now()) {
+        const taskInfo = this.activeTasks.get(taskId);
+        if (taskInfo && taskInfo.agentId === agentId) {
+            this.activeTasks.delete(taskId);
+            this.taskDurations.push(duration);
+            this.totalTasksCompleted++;
+        }
+    }
+    /**
+     * Record coordination latency
+     */
+    recordCoordination(agentId, latency, _timestamp = Date.now()) {
+        this.coordinationLatencies.push(latency);
+        // Check for latency issues
+        if (latency > 100) {
+            this.issues.push(`High coordination latency for agent ${agentId}: ${latency}ms`);
+        }
+    }
+    /**
+     * Record memory usage
+     */
+    recordMemoryUsage(heapUsed, heapTotal) {
+        const snapshot = {
+            timestamp: Date.now(),
+            heapUsed,
+            heapTotal,
+            external: 0,
+            rss: 0,
+        };
+        this.memorySnapshots.push(snapshot);
+        this.memorySum += heapUsed;
+        this.memorySamples++;
+        if (heapUsed > this.peakMemoryUsed) {
+            this.peakMemoryUsed = heapUsed;
+        }
+        // Check for memory issues (4GB limit from Issue #177)
+        const MEMORY_LIMIT = 4 * 1024 * 1024 * 1024;
+        if (heapUsed > MEMORY_LIMIT) {
+            this.issues.push(`Memory exceeded 4GB limit: ${(heapUsed / 1024 / 1024 / 1024).toFixed(2)}GB`);
+        }
+    }
+    /**
+     * Record an issue
+     */
+    recordIssue(message) {
+        this.issues.push(message);
+    }
+    // ============================================================================
+    // Query Methods
+    // ============================================================================
+    /**
+     * Get current active agent count
+     */
+    getAgentCount() {
+        return this.activeAgents.size;
+    }
+    /**
+     * Get peak agent count
+     */
+    getPeakAgentCount() {
+        return this.peakAgentCount;
+    }
+    /**
+     * Get total agents spawned
+     */
+    getTotalAgentsSpawned() {
+        return this.totalAgentsSpawned;
+    }
+    /**
+     * Get coordination latency at P95
+     */
+    getP95CoordinationLatency() {
+        return this.calculatePercentile(this.coordinationLatencies.toArray(), 0.95);
+    }
+    /**
+     * Get coordination latency at P99
+     */
+    getP99CoordinationLatency() {
+        return this.calculatePercentile(this.coordinationLatencies.toArray(), 0.99);
+    }
+    /**
+     * Get coordination latency percentiles
+     */
+    getCoordinationLatencyPercentiles() {
+        return this.calculatePercentiles(this.coordinationLatencies.toArray());
+    }
+    /**
+     * Get task latency percentiles
+     */
+    getTaskLatencyPercentiles() {
+        return this.calculatePercentiles(this.taskDurations.toArray());
+    }
+    /**
+     * Get maximum memory usage
+     */
+    getMaxMemoryUsage() {
+        return this.peakMemoryUsed;
+    }
+    /**
+     * Get average memory usage
+     */
+    getAverageMemoryUsage() {
+        return this.memorySamples > 0 ? this.memorySum / this.memorySamples : 0;
+    }
+    /**
+     * Get throughput metrics
+     */
+    getThroughput() {
+        const duration = this.getDuration();
+        const durationSeconds = duration / 1000;
+        return {
+            tasks: this.totalTasksCompleted,
+            tasksPerSecond: durationSeconds > 0 ? this.totalTasksCompleted / durationSeconds : 0,
+            agents: this.totalAgentsSpawned,
+            agentsPerSecond: durationSeconds > 0 ? this.totalAgentsSpawned / durationSeconds : 0,
+        };
+    }
+    /**
+     * Get test duration in milliseconds
+     */
+    getDuration() {
+        if (this.startTime === 0)
+            return 0;
+        const end = this.endTime > 0 ? this.endTime : Date.now();
+        return end - this.startTime;
+    }
+    /**
+     * Check if any agents are starving (no tasks for extended period)
+     */
+    hasAgentStarvation() {
+        // Check if active agents have no active tasks
+        const activeAgentCount = this.activeAgents.size;
+        const activeTaskCount = this.activeTasks.size;
+        // If we have agents but no tasks running for them, potential starvation
+        return activeAgentCount > 0 && activeTaskCount === 0 && this.totalTasksCompleted > 0;
+    }
+    /**
+     * Check for potential deadlocks (tasks started but not completing)
+     */
+    hasDeadlocks() {
+        // Simple heuristic: if tasks have been running for > 60 seconds, potential deadlock
+        const now = Date.now();
+        const DEADLOCK_THRESHOLD = 60000;
+        const tasks = Array.from(this.activeTasks.values());
+        for (const taskInfo of tasks) {
+            if (now - taskInfo.startTime > DEADLOCK_THRESHOLD) {
+                return true;
+            }
+        }
+        return false;
+    }
+    // ============================================================================
+    // Report Generation
+    // ============================================================================
+    /**
+     * Export complete load test report
+     */
+    exportReport() {
+        const duration = this.getDuration();
+        const coordinationLatency = this.getCoordinationLatencyPercentiles();
+        const taskLatency = this.getTaskLatencyPercentiles();
+        const throughput = this.getThroughput();
+        // Success criteria from Issue #177
+        const AGENT_TARGET = 100;
+        const MEMORY_LIMIT = 4 * 1024 * 1024 * 1024;
+        const LATENCY_TARGET = 100;
+        const successCriteria = {
+            agentCount: this.peakAgentCount >= AGENT_TARGET,
+            memoryLimit: this.peakMemoryUsed < MEMORY_LIMIT,
+            coordinationLatency: coordinationLatency.p95 <= LATENCY_TARGET,
+            noDeadlocks: !this.hasDeadlocks(),
+            noStarvation: !this.hasAgentStarvation(),
+        };
+        const allCriteriaMet = Object.values(successCriteria).every(Boolean);
+        // Generate recommendations based on metrics
+        const recommendations = this.generateRecommendations(coordinationLatency, this.peakMemoryUsed, throughput);
+        return {
+            summary: {
+                totalAgents: this.totalAgentsSpawned,
+                peakAgents: this.peakAgentCount,
+                totalTasks: this.totalTasksCompleted,
+                duration,
+                success: allCriteriaMet,
+                successCriteria,
+            },
+            performance: {
+                coordinationLatency,
+                taskLatency,
+                throughput,
+            },
+            resources: {
+                memoryPeak: this.peakMemoryUsed,
+                memoryAverage: this.getAverageMemoryUsage(),
+                cpuPeak: 0, // Not tracked yet
+                cpuAverage: 0,
+            },
+            timeline: {
+                agentCounts: [...this.agentTimeline],
+                latencies: [...this.latencyTimeline],
+                memoryUsage: [...this.memoryTimeline],
+            },
+            issues: [...this.issues],
+            recommendations,
+        };
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    sampleMemory() {
+        const memUsage = process.memoryUsage();
+        this.recordMemoryUsage(memUsage.heapUsed, memUsage.heapTotal);
+    }
+    sampleTimeline() {
+        const now = Date.now();
+        // Sample agent count
+        this.agentTimeline.push({
+            timestamp: now,
+            count: this.activeAgents.size,
+        });
+        // Sample latency P95
+        const latencies = this.coordinationLatencies.toArray();
+        if (latencies.length > 0) {
+            this.latencyTimeline.push({
+                timestamp: now,
+                p95: this.calculatePercentile(latencies, 0.95),
+            });
+        }
+        // Sample memory
+        const memUsage = process.memoryUsage();
+        this.memoryTimeline.push({
+            timestamp: now,
+            heapUsed: memUsage.heapUsed,
+        });
+        // Limit timeline size
+        const MAX_TIMELINE_POINTS = 1000;
+        if (this.agentTimeline.length > MAX_TIMELINE_POINTS) {
+            this.agentTimeline.shift();
+        }
+        if (this.latencyTimeline.length > MAX_TIMELINE_POINTS) {
+            this.latencyTimeline.shift();
+        }
+        if (this.memoryTimeline.length > MAX_TIMELINE_POINTS) {
+            this.memoryTimeline.shift();
+        }
+    }
+    calculatePercentile(values, percentile) {
+        if (values.length === 0)
+            return 0;
+        const sorted = [...values].sort((a, b) => a - b);
+        const index = Math.ceil(sorted.length * percentile) - 1;
+        return sorted[Math.max(0, index)];
+    }
+    calculatePercentiles(values) {
+        if (values.length === 0) {
+            return { p50: 0, p95: 0, p99: 0, max: 0, min: 0, avg: 0, count: 0 };
+        }
+        const sorted = [...values].sort((a, b) => a - b);
+        const sum = sorted.reduce((a, b) => a + b, 0);
+        return {
+            p50: this.calculatePercentile(sorted, 0.5),
+            p95: this.calculatePercentile(sorted, 0.95),
+            p99: this.calculatePercentile(sorted, 0.99),
+            max: sorted[sorted.length - 1],
+            min: sorted[0],
+            avg: sum / sorted.length,
+            count: sorted.length,
+        };
+    }
+    generateRecommendations(latency, memoryPeak, throughput) {
+        const recommendations = [];
+        // Latency recommendations
+        if (latency.p95 > 100) {
+            recommendations.push(`P95 coordination latency (${latency.p95.toFixed(1)}ms) exceeds 100ms target. ` +
+                'Consider optimizing gossip protocol or reducing agent count.');
+        }
+        if (latency.p99 > latency.p95 * 2) {
+            recommendations.push('High P99/P95 ratio indicates latency outliers. ' +
+                'Investigate specific agents or network conditions.');
+        }
+        // Memory recommendations
+        const memoryGB = memoryPeak / 1024 / 1024 / 1024;
+        if (memoryGB > 3) {
+            recommendations.push(`Memory usage (${memoryGB.toFixed(2)}GB) approaching 4GB limit. ` +
+                'Consider implementing agent pooling or reducing per-agent memory.');
+        }
+        // Throughput recommendations
+        if (throughput.tasksPerSecond < 10) {
+            recommendations.push(`Task throughput (${throughput.tasksPerSecond.toFixed(1)}/s) is low. ` +
+                'Consider parallelizing task execution or reducing task complexity.');
+        }
+        // General recommendations
+        if (this.issues.length > 10) {
+            recommendations.push(`${this.issues.length} issues recorded. ` +
+                'Review issue log for patterns and prioritize fixes.');
+        }
+        return recommendations;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a new MetricsCollector instance
+ */
+export function createMetricsCollector(config) {
+    return new MetricsCollector(config);
+}
+//# sourceMappingURL=metrics-collector.js.map

package/v3/dist/testing/load/metrics-collector.js.map

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

package/v3/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-qe/v3",
-  "version": "3.3.4",
+  "version": "3.4.0",
   "description": "Agentic QE v3 - Domain-Driven Design Architecture with 12 Bounded Contexts, O(log n) coverage analysis, ReasoningBank learning, 51 specialized QE agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -71,6 +71,7 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "test:perf": "vitest bench tests/performance/",
+    "performance:gate": "npx tsx src/performance/run-gates.ts",
     "test:integration:browser": "VIBIUM_REAL_TESTS=true vitest run tests/integrations/vibium/vibium-real.test.ts",
     "benchmark:token-reduction": "vitest bench tests/benchmarks/code-intelligence-token-reduction.bench.ts",
     "lint": "eslint src tests --ext .ts",
@@ -100,6 +101,7 @@
     "@types/node": "^20.10.0",
     "@types/pg": "^8.16.0",
     "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.18.1",
     "@vitest/coverage-v8": "^4.0.16",
     "esbuild": "^0.27.2",
     "glob": "^13.0.0",
@@ -120,7 +122,9 @@
     "cli-progress": "^3.12.0",
     "commander": "^12.1.0",
     "fast-glob": "^3.3.3",
+    "fast-json-patch": "^3.1.1",
     "hnswlib-node": "^3.0.0",
+    "jose": "^6.1.3",
     "ora": "^9.0.0",
     "pg": "^8.17.2",
     "prime-radiant-advanced-wasm": "^0.1.3",