blaze-performance-tester 3.0.40 → 3.1.0

package/dist/cli.js

@@ -147,12 +147,15 @@ function parseArguments(args) {
   let maxThreads = 300;
   let maxAllowedLatencyMs = 800;
   let outputHtml = "blaze-dashboard.html";
+  let apdexT = 50;
   const threadsIdx = args.indexOf("--threads");
   if (threadsIdx !== -1) threads = parseInt(args[threadsIdx + 1], 10);
   const durationIdx = args.indexOf("--duration");
   if (durationIdx !== -1) durationSec = parseInt(args[durationIdx + 1], 10);
   const apdexIdx = args.indexOf("--target-apdex");
   if (apdexIdx !== -1) targetApdex = parseFloat(args[apdexIdx + 1]);
+  const apdexTIdx = args.indexOf("--apdex-t");
+  if (apdexTIdx !== -1) apdexT = parseInt(args[apdexTIdx + 1], 10);
   const errorIdx = args.indexOf("--target-error");
   if (errorIdx !== -1) targetErrorRate = parseFloat(args[errorIdx + 1]);
   const maxThreadsIdx = args.indexOf("--max-threads");
@@ -189,7 +192,8 @@ function parseArguments(args) {
     maxThreads,
     stepSize: 15,
     maxAllowedLatencyMs,
-    outputHtml
+    outputHtml,
+    apdexT
   };
 }
 async function runBlazeCoreEngine(config) {
@@ -207,7 +211,11 @@ async function runBlazeCoreEngine(config) {
       }
       const warmUpCutoff = Math.floor(rawRequests.length * 0.1);
       const steadyStateRequests = rawRequests.slice(warmUpCutoff);
-      const metrics = processMetricsTelemetry(steadyStateRequests.length > 0 ? steadyStateRequests : rawRequests, config.durationSec);
+      const metrics = processMetricsTelemetry(
+        steadyStateRequests.length > 0 ? steadyStateRequests : rawRequests,
+        config.durationSec,
+        config.apdexT
+      );
       const rawErrors = rawRequests.filter((r) => r.errorMessage).map((r) => r.errorMessage);
       resolve2({ metrics, rawErrors, rawRequests: steadyStateRequests.length > 0 ? steadyStateRequests : rawRequests });
     }, 1e3);
@@ -394,7 +402,7 @@ function generateSimulationData(threads, durationSec, maxAllowedLatencyMs) {
   }
   return data.sort((a, b) => a.timestampMs - b.timestampMs);
 }
-function processMetricsTelemetry(requests, durationSec) {
+function processMetricsTelemetry(requests, durationSec, apdexT) {
   const totalRequests = requests.length;
   const durations = requests.map((r) => r.durationMs);
   const avgLatencyMs = mathUtils.mean(durations);
@@ -414,7 +422,7 @@ function processMetricsTelemetry(requests, durationSec) {
   });
   const errorCount = c4xx + c5xx;
   const errorRate = totalRequests === 0 ? 0 : errorCount / totalRequests;
-  const T = 50;
+  const T = apdexT;
   const satisfied = requests.filter((r) => r.durationMs <= T && r.statusCode < 400).length;
   const tolerating = requests.filter((r) => r.durationMs > T && r.durationMs <= T * 4 && r.statusCode < 400).length;
   const apdexScore = totalRequests === 0 ? 0 : (satisfied + tolerating / 2) / totalRequests;
@@ -477,6 +485,29 @@ 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))
   }));
+  const naturalLanguageAssistantHtml = `
+  <div class="card" style="margin-top: 2rem; background: linear-gradient(135deg, #1e1b4b 0%, #111827 100%); border: 1px solid #4338ca;">
+    <h3 style="color: #818cf8; display: flex; align-items: center; gap: 0.6rem; font-size: 1.25rem; margin-bottom: 0.5rem; border-bottom: none; padding-bottom: 0;">
+      \u{1F52E} Ask the Test \u2014 Embedded Natural Language Assistant
+    </h3>
+    <div style="color: #94a3b8; font-size: 0.85rem; margin-bottom: 1.25rem;">
+      Query metrics, log topologies, and SLA compliance profiles instantly. Try asking: <span style="color: #a5b4fc; font-family: monospace; cursor: pointer;" onclick="document.getElementById('assistantInput').value=this.innerText; runAssistantQuery();">"What was our peak throughput capacity?"</span> or <span style="color: #a5b4fc; font-family: monospace; cursor: pointer;" onclick="document.getElementById('assistantInput').value=this.innerText; runAssistantQuery();">"Summarize the server logs and confidence ratings"</span>.
+    </div>
+    <div style="display: flex; gap: 0.75rem; margin-bottom: 1rem;">
+      <input type="text" id="assistantInput" placeholder="Ask a question regarding test telemetry... (e.g., 'Did we break the target Apdex limit?')" 
+        style="flex: 1; background: #030712; border: 1px solid #374151; border-radius: 6px; padding: 0.75rem 1rem; color: #f9fafb; font-size: 0.9rem; outline: none;"
+        onkeydown="if(event.key === 'Enter') runAssistantQuery();" />
+      <button onclick="runAssistantQuery()" style="background: #4f46e5; color: #ffffff; border: none; padding: 0 1.5rem; border-radius: 6px; font-weight: 600; font-size: 0.9rem; cursor: pointer; transition: background 0.2s;">
+        Query Engine
+      </button>
+    </div>
+    <div id="assistantResponseContainer" style="display: none; background: #030712; border: 1px solid #1f2937; border-radius: 6px; padding: 1.25rem;">
+      <div style="font-size: 0.7rem; font-weight: bold; color: #6366f1; text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 0.5rem; display: flex; align-items: center; gap: 0.3rem;">
+        <span>\u{1F916} AI Assistant Response</span>
+      </div>
+      <div id="assistantResponseText" style="font-size: 0.9rem; line-height: 1.5; color: #e5e7eb; white-space: pre-wrap;"></div>
+    </div>
+  </div>`;
   let logClustersHtml = "";
   if (semanticReport) {
     const totalLogCount = semanticReport.clusters.reduce((sum, c) => sum + c.count, 0);
@@ -517,7 +548,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
         fixCode = "const configId = payload?.config_id ?? defaultConfigurationId;\nif (!configId) throw new ValidationError('Missing config_id');";
         explanation = "Runtime reference error for undefined payload field under race condition spikes. Add optional chaining and input contracts.";
       }
-      const snippetId = `snippet-${idx}`;
+      const snippetId = "snippet-" + idx;
       return `
             <details style="background: #090d16; border: 1px solid #1e293b; border-radius: 6px; overflow: hidden;">
               <summary style="padding: 1rem; cursor: pointer; display: flex; align-items: center; justify-content: space-between; user-select: none;">
@@ -546,7 +577,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
             </details>`;
     }).join("")}
       </div>
-    </div>`;
+    `;
   }
   const liveAdjusterHtml = `
   <div class="card" style="margin-top: 2rem; background: #131c2e; border: 1px solid #1e293b;">
@@ -655,7 +686,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
     
     <div class="cards-wrapper">
       <div class="metric-card">
-        <div class="card-title">Apdex Score (T: 50ms)</div>
+        <div class="card-title">Apdex Score (T: ${config.apdexT}ms)</div>
         <div class="card-value green">${cards.apdex.toFixed(2)}<span class="card-subtext">(Good)</span></div>
       </div>
       <div class="metric-card">
@@ -724,6 +755,8 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
       </div>
     </div>
 
+    ${naturalLanguageAssistantHtml}
+
     <div class="charts-grid">
       <div class="graph-card">
         <div class="graph-title">\u{1F4CA} Throughput Velocity & Workload Volume</div>
@@ -800,8 +833,111 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
     const labels = ${JSON.stringify(labels)};
     const baseThroughput = ${cards.throughput};
     const baseLatency = ${cards.ttfb};
+    const telemetryHistory = ${JSON.stringify(history)};
+    const responseMatrixData = ${JSON.stringify(responseMatrix)};
+    const globalSummaryCards = ${JSON.stringify(cards)};
+    const semanticReportData = ${JSON.stringify(semanticReport)};
+    const agentVerdictText = ${JSON.stringify(verdictReason)};
+
+    function runAssistantQuery() {
+      const inputEl = document.getElementById('assistantInput');
+      const containerEl = document.getElementById('assistantResponseContainer');
+      const textEl = document.getElementById('assistantResponseText');
+      const query = inputEl.value.toLowerCase().trim();
+
+      if (!query) return;
+
+      let answer = "";
+      const match = (keywords) => keywords.some(k => query.includes(k));
+
+      if (match(['throughput', 'rps', 'requests per second', 'capacity', 'volume'])) {
+        const peakT = Math.max(...telemetryHistory.map(h => h.throughput)).toFixed(0);
+        const finalT = globalSummaryCards.throughput.toFixed(1);
+        answer = "\u{1F4C8} **Throughput Assessment:**
+" +
+                 "- The peak throughput velocity achieved during this test run was **" + peakT + " req/sec**.
+" +
+                 "- The normalized/final execution throughput tracking shows **" + finalT + " req/sec**.
+" +
+                 "If your infrastructure limits drop below these values, upstream buffers will choke, precipitating service level drops.";
+      } 
+      else if (match(['latency', 'p95', 'average latency', 'slow', 'speed', 'ttfb', 'delay'])) {
+        const maxP95 = Math.max(...telemetryHistory.map(h => h.p95Latency)).toFixed(1);
+        answer = "\u23F1\uFE0F **Latency Profiling Telemetry:**
+" +
+                 "- Average Time-to-First-Byte (TTFB) registered across workloads: **" + globalSummaryCards.ttfb.toFixed(1) + " ms**.
+" +
+                 "- Peak Worst-Case P95 Latency boundary reached: **" + maxP95 + " ms**.
+" +
+                 "- Handshake Breakdown: DNS Lookup [" + globalSummaryCards.dns.toFixed(2) + "ms] | TCP Connect [" + globalSummaryCards.tcp.toFixed(2) + "ms] | TLS Handshake [" + globalSummaryCards.tls.toFixed(2) + "ms].
+" +
+                 "Spikes are heavily correlated to network layer pooling exhaustion rather than payload compute constraints.";
+      }
+      else if (match(['error', 'fail', 'crash', 'broken', '5xx', '4xx', 'econnrefused', 'timeout'])) {
+        const totalErrs = responseMatrixData.total4xx + responseMatrixData.total5xx;
+        answer = "\u{1F6A8} **Failure Breakdown & Topology Mapping:**
+" +
+                 "- A total of **" + totalErrs + " operations failed** during execution loops (" + responseMatrixData.total4xx + " Client 4xx Errors, " + responseMatrixData.total5xx + " Server 5xx Errors).
+";
+        
+        if (semanticReportData && semanticReportData.clusters && semanticReportData.clusters.length > 0) {
+          answer += "- **Primary Log Clusters Captured:**
+";
+          semanticReportData.clusters.forEach((c) => {
+            const rawTemplate = c.template || '';
+            const idxClose = rawTemplate.indexOf(']');
+            const cleaned = idxClose !== -1 ? rawTemplate.substring(idxClose + 1).trim().substring(0, 80) + "..." : rawTemplate.substring(0, 80) + "...";
+            const freqScore = Math.min(25, c.count * 0.5);
+            const clarityBonus = c.severity === 'CRITICAL' ? 15 : 8;
+            const confidenceScore = Math.min(99, Math.round(65 + freqScore + clarityBonus));
+            answer += "  * [" + c.count + "x] **" + c.category + "** (" + c.severity + ") -> Confidence Rating: *" + confidenceScore + "%* 
+    \`" + cleaned + "\`
+";
+          });
+        } else {
+          answer += "- No structural failure entries were recorded in stdout/stderr diagnostic streams.";
+        }
+      }
+      else if (match(['apdex', 'satisfaction', 'slo', 'breach', 'limit', 'pass', 'target'])) {
+        const passStatus = globalSummaryCards.apdex >= ${config.targetApdex};
+        answer = "\u{1F3AF} **SLO Verification Profile:**
+" +
+                 "- Target Configured Apdex Floor: **" + (${config.targetApdex}).toFixed(2) + "**
+" +
+                 "- Actual Achieved Runtime Apdex: **" + globalSummaryCards.apdex.toFixed(2) + "**
+" +
+                 "- **Status Status:** " + (passStatus ? "\u2705 **SLO PASS**" : "\u274C **SLO BREACHED**") + "
+" +
+                 "Verdict Context: " + agentVerdictText;
+      }
+      else if (match(['summary', 'verdict', 'recommendation', 'cost', 'cloud', 'sizing', 'what happened'])) {
+        answer = "\u{1F9E0} **AI Executive Summary Directive:**
+" +
+                 "- **System Verdict:** " + agentVerdictText + "
+" +
+                 "- **Recommended Max Safe Scaled Capacity:** " + globalSummaryCards.saturationKneePoint + " Virtual User Threads Allocation.
+" +
+                 "- **Infrastructure Target Allocation Strategy:** Right-size infrastructure to **" + Math.max(2, Math.ceil(globalSummaryCards.saturationKneePoint / 75)) + " vCores** and **" + (Math.max(2, Math.ceil(globalSummaryCards.saturationKneePoint / 75)) * 2) + " GB RAM** to minimize the projected cloud operating budget (~$" + (globalSummaryCards.throughput * 0.045 * 24 * 30).toFixed(2) + "/mo).";
+      }
+      else {
+        answer = "\u2753 **Intent Routing Fallback:**
+" +
+                 "I didn't quite catch that context parameter. Try asking specifically about:
+" +
+                 "\u2022 *'What was our peak throughput capacity?'*
+" +
+                 "\u2022 *'Show me the latency performance limits and handshake timings'*
+" +
+                 "\u2022 *'Summarize the server logs and confidence ratings'*
+" +
+                 "\u2022 *'Did we pass or breach our target SLO settings?'*";
+      }
+
+      textEl.innerHTML = answer.replace(/
+/g, '<br>').replace(/**(.*?)**/g, '<strong>$1</strong>');
+      containerEl.style.display = 'block';
+    }
 
-    // Live Concurrency Adjuster interactive client logic
     const slider = document.getElementById('concurrencySlider');
     const sliderVal = document.getElementById('sliderValue');
     const simThroughput = document.getElementById('simThroughput');
@@ -864,7 +1000,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
             borderWidth: 2.5,
             pointRadius: 4,
             fill: true,
-            yAxisID: 'yThreads'
+            yAxisID: 'y_threads'
           },
           {
             label: 'Time-to-Failure (TTF) Trend',
@@ -874,7 +1010,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
             borderDash: [5, 5],
             pointRadius: 3,
             fill: false,
-            yAxisID: 'yTtf'
+            yAxisID: 'y_ttf'
           }
         ]
       },
@@ -947,6 +1083,7 @@ 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`);
+  --threads <count> | --duration <seconds> | --agentic | --cluster-logs | --correlate
+  --apdex-t <ms>        Set customizable T-Threshold window (Default: 50ms)`);
 }
 main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blaze-performance-tester",
-  "version": "3.0.40",
+  "version": "3.1.0",
   "description": "A high-performance, multi-threaded load testing engine built with Rust and QuickJS.",
   "type": "module",
   "main": "dist/index.js",
@@ -18,10 +18,10 @@
     "blaze.win32-x64-msvc.node"
   ],
   "scripts": {
-"prebuild": "node -e \"if (!fs.existsSync('dist')) fs.mkdirSync('dist')\"",
-  "build:rust": "napi build --platform --release --output-dir dist --js index.js --dts index.d.ts",
-  "build:cli": "esbuild cli.ts --bundle --platform=node --format=esm --packages=external --outfile=dist/cli.js",
-  "build": "npm run prebuild && npm run build:rust && npm run build:cli"
+    "prebuild": "node -e \"if (!fs.existsSync('dist')) fs.mkdirSync('dist')\"",
+    "build:rust": "napi build --platform --release --output-dir dist --js index.js --dts index.d.ts",
+    "build:cli": "esbuild cli.ts --bundle --platform=node --format=esm --packages=external --outfile=dist/cli.js",
+    "build": "npm run prebuild && npm run build:rust && npm run build:cli"
   },
   "dependencies": {
     "esbuild": "^0.20.0"