blaze-performance-tester 3.1.28 → 3.1.30

package/dist/cli.js

@@ -87,6 +87,52 @@ 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://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=${apiKey}`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        systemInstruction: {
+          parts: [
+            {
+              text: "You are a principal systems architect and site reliability engineer. Return clean, direct HTML list items (using <li> tags, no raw markdown blocks) summarizing diagnostics."
+            }
+          ]
+        },
+        contents: [
+          {
+            role: "user",
+            parts: [
+              {
+                text: `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}`
+              }
+            ]
+          }
+        ],
+        generationConfig: {
+          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.candidates?.[0]?.content?.parts?.[0]?.text || "<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 +194,7 @@ function parseArguments(args) {
   let maxThreads = 300;
   let maxAllowedLatencyMs = 800;
   let outputHtml = "blaze-dashboard.html";
+  let aiKey = process.env.GEMINI_API_KEY || "";
   const threadsIdx = args.indexOf("--threads");
   if (threadsIdx !== -1) threads = parseInt(args[threadsIdx + 1], 10);
   const durationIdx = args.indexOf("--duration");
@@ -160,6 +207,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 +240,8 @@ function parseArguments(args) {
     maxThreads,
     stepSize: 15,
     maxAllowedLatencyMs,
-    outputHtml
+    outputHtml,
+    aiKey
   };
 }
 async function runBlazeCoreEngine(config) {
@@ -327,12 +377,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 +413,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 +432,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 +472,7 @@ async function runStandardStressTest(config) {
     total4xx: metrics.c4xx,
     total5xx: metrics.c5xx,
     breakdownRates
-  }, finalSummaryCards, rawRequests);
+  }, finalSummaryCards, rawRequests, rcaInsights);
 }
 function getFallbackClusterLogs() {
   const logs = [];
@@ -528,7 +588,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 +605,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, or configure a <code>GEMINI_API_KEY</code> environment variable in your PowerShell runtime session to dynamically structure error logs 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 +632,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,10 +821,12 @@ 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">
-      <h1>\u{1F525} Blaze Core Performance Analysis</h1>
+      <h1>\u{1F525} Blaze Core Performance Report</h1>
       <div class="meta">Target Script: <code>${config.targetScript}</code></div>
     </div>
     
@@ -902,6 +984,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
     ${seoImpactSectionHtml}
     ${liveAdjusterHtml}
     ${rightSizingHtml}
+    ${rcaAccordionHtml}
     ${logClustersHtml}
   </div>
   
@@ -959,7 +1042,6 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
       }
     });
 
-    // --- AI FORECASTING LINE REGRESSION SETUP ---
     const baseActiveThreads = ${JSON.stringify(activeThreadsData)};
     const baseTtfTrend = ${JSON.stringify(ttfTrendData)};
     const historicalCount = baseTtfTrend.length;
@@ -988,7 +1070,6 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
       const lastThreads = baseActiveThreads[historicalCount - 1] || 10;
       const threadStep = ${config.stepSize || 15};
       
-      // Project out the next 3 hypothetical execution tiers
       for (let i = 1; i <= 3; i++) {
         extendedLabels.push(\`+\${i * 5}s (AI Forecast)\`);
         extendedThreads.push(lastThreads + (threadStep * i));
@@ -1106,6 +1187,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.28",
+  "version": "3.1.30",
   "description": "A high-performance, multi-threaded load testing engine built with Rust and QuickJS.",
   "type": "module",
   "main": "dist/index.js",