blaze-performance-tester 3.1.27 → 3.1.29

package/dist/cli.js

@@ -87,6 +87,45 @@ var mathUtils = {
     return sorted[Math.max(0, index)];
   }
 };
+async function fetchRcaInsights(semanticReport, apiKey) {
+  if (!semanticReport || !semanticReport.clusters || semanticReport.clusters.length === 0) {
+    return `<ul><li><strong>Nominal Operational Bounds:</strong> No cluster-level anomalies or processing faults were registered during this execution frame.</li></ul>`;
+  }
+  const errorSummary = semanticReport.clusters.map((c) => `[Count: ${c.count}] Category: ${c.category} -> Pattern: ${c.template}`).join("\n");
+  try {
+    const response = await fetch("https://api.openai.com/v1/chat/completions", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${apiKey}`
+      },
+      body: JSON.stringify({
+        model: "gpt-4o-mini",
+        messages: [
+          {
+            role: "system",
+            content: "You are a principal systems architect and site reliability engineer. Return clean, direct HTML list items (\u7528 <li> tags, no raw markdown blocks) summarizing diagnostics."
+          },
+          {
+            role: "user",
+            content: `Analyze these performance test errors and provide 3 bullet points detailing the likely backend bottleneck (e.g., database connection pool exhaustion) and practical configuration fixes.
+
+Error Log Patterns:
+${errorSummary}`
+          }
+        ],
+        temperature: 0.2
+      })
+    });
+    if (!response.ok) {
+      return `<span style="color: #ef4444;">AI Completion API Error: ${response.status} ${response.statusText}</span>`;
+    }
+    const data = await response.json();
+    return data.choices?.[0]?.message?.content || "<li>Failed to aggregate autonomous analysis parameters.</li>";
+  } catch (error) {
+    return `<span style="color: #ef4444;">Failed to resolve external cloud model: ${error.message}</span>`;
+  }
+}
 async function executeTestPipeline(config) {
   if (!blazeCore || typeof blazeCore.runCorrelatedTransaction !== "function") {
     console.error("\u274C Error: runCorrelatedTransaction function is missing from the compiled binary bindings.");
@@ -148,6 +187,7 @@ function parseArguments(args) {
   let maxThreads = 300;
   let maxAllowedLatencyMs = 800;
   let outputHtml = "blaze-dashboard.html";
+  let aiKey = "";
   const threadsIdx = args.indexOf("--threads");
   if (threadsIdx !== -1) threads = parseInt(args[threadsIdx + 1], 10);
   const durationIdx = args.indexOf("--duration");
@@ -160,6 +200,8 @@ function parseArguments(args) {
   if (maxThreadsIdx !== -1) maxThreads = parseInt(args[maxThreadsIdx + 1], 10);
   const outputIdx = args.indexOf("--output");
   if (outputIdx !== -1) outputHtml = args[outputIdx + 1];
+  const aiKeyIdx = args.indexOf("--ai-key");
+  if (aiKeyIdx !== -1) aiKey = args[aiKeyIdx + 1];
   const positionalNums = args.slice(1).filter((arg) => !arg.startsWith("-")).map(Number).filter((n) => !isNaN(n));
   if (positionalNums.length > 0 && threadsIdx === -1 && !isAgentic) threads = positionalNums[0];
   if (positionalNums.length > 1 && durationIdx === -1 && !isAgentic) durationSec = positionalNums[1];
@@ -191,7 +233,8 @@ function parseArguments(args) {
     maxThreads,
     stepSize: 15,
     maxAllowedLatencyMs,
-    outputHtml
+    outputHtml,
+    aiKey
   };
 }
 async function runBlazeCoreEngine(config) {
@@ -327,12 +370,17 @@ async function runIntelligentAgenticStressTest(config) {
     currentThreads += nextStep;
   }
   let semanticReport = null;
+  let rcaInsights = "";
   if (config.clusterLogs) {
     if (aggregateErrorLogs.length === 0) {
       aggregateErrorLogs = getFallbackClusterLogs();
     }
     const analyzer = new LogAnalyzer();
     semanticReport = analyzer.process(aggregateErrorLogs);
+    if (config.aiKey) {
+      console.log("\u{1F9E0} Fetching autonomous root-cause analysis from model...");
+      rcaInsights = await fetchRcaInsights(semanticReport, config.aiKey);
+    }
   }
   const finalState = history[history.length - 1] || { apdex: 0, errorRate: 0, p95Latency: 0, throughput: 0 };
   const healthScore = computeHealthScoreValue(finalState.apdex, finalState.errorRate, finalState.p95Latency, config.maxAllowedLatencyMs);
@@ -358,7 +406,7 @@ async function runIntelligentAgenticStressTest(config) {
   Object.keys(globalCodeCounts).forEach((code) => {
     breakdownRates[code] = totalRequestsAccumulator === 0 ? 0 : globalCodeCounts[code] / totalRequestsAccumulator * 100;
   });
-  exportHtmlDashboard(history, config, verdictReason, semanticReport, { total1xx, total2xx, total3xx, total4xx, total5xx, breakdownRates }, finalSummaryCards, lastRawRequests);
+  exportHtmlDashboard(history, config, verdictReason, semanticReport, { total1xx, total2xx, total3xx, total4xx, total5xx, breakdownRates }, finalSummaryCards, lastRawRequests, rcaInsights);
 }
 async function runStandardStressTest(config) {
   console.log(`\u{1F3CB}\uFE0F Running Standard Stress Test [Threads: ${config.threads} | Duration: ${config.durationSec}s]`);
@@ -377,11 +425,16 @@ async function runStandardStressTest(config) {
     failedRequests: metrics.c4xx + metrics.c5xx
   }];
   let semanticReport = null;
+  let rcaInsights = "";
   if (config.clusterLogs) {
     let errsToProcess = rawErrors;
     if (errsToProcess.length === 0) errsToProcess = getFallbackClusterLogs();
     const analyzer = new LogAnalyzer();
     semanticReport = analyzer.process(errsToProcess);
+    if (config.aiKey) {
+      console.log("\u{1F9E0} Fetching autonomous root-cause analysis from model...");
+      rcaInsights = await fetchRcaInsights(semanticReport, config.aiKey);
+    }
   }
   const finalSummaryCards = {
     apdex: metrics.apdexScore,
@@ -412,7 +465,7 @@ async function runStandardStressTest(config) {
     total4xx: metrics.c4xx,
     total5xx: metrics.c5xx,
     breakdownRates
-  }, finalSummaryCards, rawRequests);
+  }, finalSummaryCards, rawRequests, rcaInsights);
 }
 function getFallbackClusterLogs() {
   const logs = [];
@@ -467,7 +520,7 @@ function processMetricsTelemetry(requests, durationSec) {
   const avgTlsMs = mathUtils.mean(requests.map((r) => r.tlsTimeMs || 0));
   const avgTtfbMs = avgDnsMs + avgTcpMs + avgTlsMs + avgLatencyMs * 0.3;
   let c1xx = 0, c2xx = 0, c3xx = 0, c4xx = 0, c5xx = 0;
-  const codeCounts = { 400: 0, 401: 0, 403: 0, 404: 0, 429: 0, 500: 502, 502: 0, 503: 0, 504: 0 };
+  const codeCounts = { 400: 0, 401: 0, 403: 0, 404: 0, 429: 0, 500: 0, 502: 0, 503: 0, 504: 0 };
   requests.forEach((r) => {
     if (r.statusCode >= 100 && r.statusCode < 200) c1xx++;
     else if (r.statusCode >= 200 && r.statusCode < 300) c2xx++;
@@ -528,7 +581,7 @@ function generateFinalAgentReport(history, score) {
   console.log(`\u26A1 Peak Achieved Cluster Velocity   : ${peakThroughput.toFixed(0)} req/sec`);
   console.log("=======================================================\n");
 }
-function exportHtmlDashboard(history, config, verdictReason, semanticReport, responseMatrix, cards, rawRequests = []) {
+function exportHtmlDashboard(history, config, verdictReason, semanticReport, responseMatrix, cards, rawRequests = [], rcaInsights = "") {
   const labels = history.map((h, i) => `${i + 1}s`);
   const successRequestsData = history.map((h) => h.successRequests);
   const failedWorkloadsData = history.map((h) => h.failedRequests);
@@ -545,6 +598,26 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
     x: Number(((r.timestampMs - firstTimestamp) / 1e3).toFixed(2)),
     y: Number(((r.dnsTimeMs || 0) + (r.tcpTimeMs || 0) + (r.tlsTimeMs || 0) + r.durationMs * 0.3).toFixed(1))
   }));
+  let rcaAccordionHtml = "";
+  if (config.clusterLogs) {
+    const content = rcaInsights ? rcaInsights : `
+      <div style="background: #090d16; padding: 1rem; border-radius: 6px; border: 1px dashed #475569; color: #94a3b8;">
+        \u{1F4A1} <strong>Autonomous RCA Available:</strong> Pass the <code>--ai-key &lt;your-key&gt;</code> flag during pipeline execution to automatically turn structural failure logs into actionable configuration mitigations here.
+      </div>`;
+    rcaAccordionHtml = `
+    <details class="card" style="margin-top: 2rem; background: #131c2e; border: 1px solid #8b5cf6; padding: 0; overflow: hidden;" open>
+      <summary style="font-size: 1.2rem; font-weight: bold; color: #c084fc; padding: 1.25rem; display: flex; align-items: center; justify-content: space-between; cursor: pointer; outline: none; user-select: none; list-style: none;">
+        <span style="display: flex; align-items: center; gap: 0.6rem;">\u{1F9E0} Autonomous Root-Cause Analysis (RCA) Insights</span>
+        <span style="font-size: 0.8rem; color: #64748b; font-weight: normal; font-family: monospace;">[CLICK TO COLLAPSE/EXPAND]</span>
+      </summary>
+      <div style="padding: 0 1.25rem 1.25rem 1.25rem; border-top: 1px solid #1e293b; color: #cbd5e1; font-size: 0.95rem; line-height: 1.6;">
+        <div style="margin-top: 1rem; margin-bottom: 0.5rem; color: #a78bfa; font-weight: 600;">System Diagnostic Summary:</div>
+        <div style="padding-left: 0.5rem;">
+          ${content}
+        </div>
+      </div>
+    </details>`;
+  }
   let logClustersHtml = "";
   if (semanticReport) {
     const totalLogCount = semanticReport.clusters.reduce((sum, c) => sum + c.count, 0);
@@ -552,7 +625,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
     logClustersHtml = `
     <div class="card" style="margin-top: 2rem; background: #131c2e; border: 1px solid #1e293b;">
       <h3 style="border-bottom: none; padding-bottom: 0rem; margin-bottom: 0.25rem; display: flex; align-items: center; gap: 0.5rem; color: #ffffff; font-size: 1.2rem;">
-        \u{1F9E0} Semantic Log Clustering & Error Classification
+        \u{1F4CA} Semantic Log Clustering & Error Classification
       </h3>
       <div style="color: #94a3b8; font-size: 0.9rem; margin-bottom: 1.5rem;">
         Captured <strong style="color: #f8fafc;">${totalLogCount}</strong> raw failures grouped into <strong style="color: #f8fafc;">${uniquePatternsCount}</strong> unique structural patterns.
@@ -741,6 +814,8 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
     .badge { padding: 0.25rem 0.5rem; border-radius: 4px; font-size: 0.8rem; font-weight: bold; }
     .badge-success { background: #16a34a; color: #f0fdf4; }
     .badge-fail { background: #dc2626; color: #fef2f2; }
+    
+    summary::-webkit-details-marker { display: none; }
   </style></head><body>
   <div class="container">
     <div class="header">
@@ -790,7 +865,6 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
         <div class="verdict-waves">${waveListItems}</div>
       </div>
 
-      <!-- IMPLEMENTED CARD FEATURE 76: Executive Health Gauges Panel -->
       <div class="gauge-container-box">
         <div class="gauge-title">Blaze Run Health Score</div>
         <div style="position: relative; width: 140px; height: 140px; display: flex; align-items: center; justify-content: center;">
@@ -851,7 +925,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
       </div>
 
       <div class="graph-card">
-        <div class="graph-title">\u{1F504} Active Concurrency (VUs) vs. TTF Trend</div>
+        <div class="graph-title">\u{1F504} Active Concurrency (VUs) vs. TTF Trend & AI Load Forecast</div>
         <div style="height: 280px; position: relative;">
           <canvas id="concurrencyChart"></canvas>
         </div>
@@ -903,6 +977,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
     ${seoImpactSectionHtml}
     ${liveAdjusterHtml}
     ${rightSizingHtml}
+    ${rcaAccordionHtml}
     ${logClustersHtml}
   </div>
   
@@ -960,14 +1035,52 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
       }
     });
 
+    const baseActiveThreads = ${JSON.stringify(activeThreadsData)};
+    const baseTtfTrend = ${JSON.stringify(ttfTrendData)};
+    const historicalCount = baseTtfTrend.length;
+
+    let extendedLabels = [...labels];
+    let extendedThreads = [...baseActiveThreads];
+    let extendedTtf = [...baseTtfTrend];
+    let aiForecastData = [];
+
+    if (historicalCount >= 2) {
+      let sumX = 0, sumY = 0, sumXY = 0, sumXX = 0;
+      for (let i = 0; i < historicalCount; i++) {
+        sumX += i;
+        sumY += baseTtfTrend[i];
+        sumXY += i * baseTtfTrend[i];
+        sumXX += i * i;
+      }
+      const denominator = (historicalCount * sumXX - sumX * sumX);
+      const slope = denominator === 0 ? 0 : (historicalCount * sumXY - sumX * sumY) / denominator;
+      const intercept = (sumY - slope * sumX) / historicalCount;
+
+      for (let i = 0; i < historicalCount; i++) {
+        aiForecastData.push(Number((slope * i + intercept).toFixed(1)));
+      }
+
+      const lastThreads = baseActiveThreads[historicalCount - 1] || 10;
+      const threadStep = ${config.stepSize || 15};
+      
+      for (let i = 1; i <= 3; i++) {
+        extendedLabels.push(\`+\${i * 5}s (AI Forecast)\`);
+        extendedThreads.push(lastThreads + (threadStep * i));
+        extendedTtf.push(null); 
+        aiForecastData.push(Number((slope * (historicalCount + i - 1) + intercept).toFixed(1)));
+      }
+    } else {
+      aiForecastData = [...baseTtfTrend];
+    }
+
     new Chart(document.getElementById('concurrencyChart'), {
       type: 'line',
       data: {
-        labels: labels,
+        labels: extendedLabels,
         datasets: [
           {
             label: 'Active VU Threads',
-            data: ${JSON.stringify(activeThreadsData)},
+            data: extendedThreads,
             borderColor: '#38bdf8',
             backgroundColor: 'rgba(56, 189, 248, 0.1)',
             borderWidth: 2.5,
@@ -977,13 +1090,24 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
           },
           {
             label: 'Time-to-Failure (TTF) Trend',
-            data: ${JSON.stringify(ttfTrendData)},
+            data: extendedTtf,
             borderColor: '#f43f5e',
             borderWidth: 2,
             borderDash: [5, 5],
             pointRadius: 3,
             fill: false,
             yAxisID: 'yTtf'
+          },
+          {
+            label: '\u{1F52E} AI Capacity Forecast Line',
+            data: aiForecastData,
+            borderColor: '#a855f7',
+            borderWidth: 2,
+            borderDash: [3, 3],
+            pointRadius: 4,
+            pointBackgroundColor: '#a855f7',
+            fill: false,
+            yAxisID: 'yTtf'
           }
         ]
       },
@@ -1056,6 +1180,6 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
 function printUsage() {
   console.log(`Blaze Core Performance Test CLI Engine
 Options:
-  --threads <count> | --duration <seconds> | --agentic | --cluster-logs | --correlate | --seo`);
+  --threads <count> | --duration <seconds> | --agentic | --cluster-logs | --correlate | --seo | --ai-key <api-key>`);
 }
 main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blaze-performance-tester",
-  "version": "3.1.27",
+  "version": "3.1.29",
   "description": "A high-performance, multi-threaded load testing engine built with Rust and QuickJS.",
   "type": "module",
   "main": "dist/index.js",