blaze-performance-tester 3.2.18 → 3.2.20

package/dist/cli.js

@@ -5613,6 +5613,33 @@ function loadBaselineData(filePath) {
   }
   return null;
 }
+async function generateElifExplanation(metrics) {
+  const apiKey = process.env.GEMINI_API_KEY;
+  if (!apiKey) {
+    console.warn("\u26A0\uFE0F Warning: GEMINI_API_KEY missing. Skipping ELIF plain-language breakdown.");
+    return null;
+  }
+  console.log("\u{1F9E0} Querying Gemini 2.5 Flash for ELIF Performance Breakdown...");
+  const prompt = `
+You are a friendly, witty performance coach. 
+Analyze the following JSON performance metrics and explain them as if the user is 5 years old. 
+Use fun, relatable analogies (like a crowded amusement park ride or a highway toll booth) instead of technical jargon like p99 or thread contention. Keep it concise, encouraging, and clear.
+
+Metrics:
+${JSON.stringify(metrics, null, 2)}
+  `;
+  try {
+    const ai = new GoogleGenAI({});
+    const response = await ai.models.generateContent({
+      model: "gemini-2.5-flash",
+      contents: prompt
+    });
+    return response.text || "Could not generate ELIF explanation.";
+  } catch (error) {
+    console.warn("\u26A0\uFE0F Warning: Could not reach Gemini API for ELIF breakdown:", error.message || error);
+    return null;
+  }
+}
 async function generateGeminiRCA(history, finalSummary, errorLogs) {
   const apiKey = process.env.GEMINI_API_KEY;
   if (!apiKey) {
@@ -5804,6 +5831,7 @@ function parseArguments(args) {
   let maxAllowedLatencyMs = 800;
   let outputHtml = "blaze-dashboard.html";
   let baselinePath = null;
+  let optionValue = null;
   const threadsIdx = args.indexOf("--threads");
   if (threadsIdx !== -1)
     threads = parseInt(args[threadsIdx + 1], 10);
@@ -5818,7 +5846,7 @@ function parseArguments(args) {
     rampDownSec = parseInt(args[rampDownIdx + 1], 10);
   const apdexIdx = args.indexOf("--target-apdex");
   if (apdexIdx !== -1)
-    targetApdex = parseFloat(args[apdexIdx + 1]);
+    targetApdex = parseFloat(apdexIdx + 1);
   const errorIdx = args.indexOf("--target-error");
   if (errorIdx !== -1)
     targetErrorRate = parseFloat(args[errorIdx + 1]);
@@ -5831,6 +5859,10 @@ function parseArguments(args) {
   const baselineIdx = args.indexOf("--baseline");
   if (baselineIdx !== -1)
     baselinePath = args[baselineIdx + 1];
+  const optionIdx = args.indexOf("--option");
+  if (optionIdx !== -1 && args[optionIdx + 1]) {
+    optionValue = args[optionIdx + 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];
@@ -5870,7 +5902,9 @@ function parseArguments(args) {
     stepSize: 15,
     maxAllowedLatencyMs,
     outputHtml,
-    baselinePath
+    baselinePath,
+    optionValue
+    // Return optionValue in configuration object
   };
 }
 async function runBlazeCoreEngine(config) {
@@ -6032,6 +6066,14 @@ async function runIntelligentAgenticStressTest(config) {
   };
   generateFinalAgentReport(history, healthScore);
   const geminiAnalysisHtml = await generateGeminiRCA(history, finalSummaryCards, aggregateErrorLogs);
+  if (config.optionValue === "elif") {
+    const plainEnglishSummary = await generateElifExplanation(finalSummaryCards);
+    if (plainEnglishSummary) {
+      console.log("\n--- \u{1F9F8} ELIF Performance Breakdown ---");
+      console.log(plainEnglishSummary);
+      console.log("-------------------------------------\n");
+    }
+  }
   if (config.isSeo) {
     const finalLat = finalState.avgLatency || finalSummaryCards.ttfb;
     const seo = calculateSeoImpactMetrics(finalLat);
@@ -6086,6 +6128,14 @@ async function runStandardStressTest(config) {
   const isPassed = metrics.apdexScore >= config.targetApdex && metrics.errorRate <= config.targetErrorRate;
   const verdictReason = isPassed ? "Static single-wave baseline checks concluded successfully without triggering health boundaries." : "Static verification loop completed with values exceeding defined quality thresholds.";
   const geminiAnalysisHtml = await generateGeminiRCA(history, finalSummaryCards, rawErrors.length > 0 ? rawErrors : getFallbackClusterLogs());
+  if (config.optionValue === "elif") {
+    const plainEnglishSummary = await generateElifExplanation(finalSummaryCards);
+    if (plainEnglishSummary) {
+      console.log("\n--- \u{1F9F8} ELIF Performance Breakdown ---");
+      console.log(plainEnglishSummary);
+      console.log("-------------------------------------\n");
+    }
+  }
   if (config.isSeo) {
     const seo = calculateSeoImpactMetrics(metrics.avgLatencyMs);
     console.log(`\u{1F50E} [SEO Impact Report]: Target latency (${metrics.avgLatencyMs.toFixed(1)}ms) triggers a predicted Search Visibility Loss of -${seo.trafficLoss}% [Status: ${seo.status}].`);
@@ -6965,7 +7015,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
 function printUsage() {
   console.log(`Blaze Core Performance Test CLI Engine
 Options:
-  --threads <count> | --duration <seconds> | --baseline <json_file> | --output <html_file>`);
+  --threads <count> | --duration <seconds> | --baseline <json_file> | --output <html_file> | --option elif`);
 }
 runCli().catch(console.error);
 export {

package/package.json

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