blaze-performance-tester 3.1.6 → 3.1.7

package/dist/cli.js

@@ -147,6 +147,7 @@ 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");
@@ -159,6 +160,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 apdexTIdx = args.indexOf("--apdex-t");
+  if (apdexTIdx !== -1) apdexT = parseFloat(args[apdexTIdx + 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];
@@ -189,7 +192,8 @@ function parseArguments(args) {
     maxThreads,
     stepSize: 15,
     maxAllowedLatencyMs,
-    outputHtml
+    outputHtml,
+    apdexT
   };
 }
 async function runBlazeCoreEngine(config) {
@@ -207,7 +211,7 @@ 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);
@@ -219,7 +223,7 @@ async function runIntelligentAgenticStressTest(config) {
   let aggregateErrorLogs = [];
   let lastRawRequests = [];
   let total1xx = 0, total2xx = 0, total3xx = 0, total4xx = 0, total5xx = 0;
-  let globalMetricsAccumulator = { dns: [], tcp: [], tls: [], ttfb: [], latencies: [], bandwidths: [] };
+  let globalMetricsAccumulator = { dns: [], tcp: [], tls: [], ttfb: [], latencies: [], bandwidths: [], lcp: [], fid: [], cls: [] };
   let currentThreads = Math.min(config.maxThreads, Math.max(5, Math.floor(config.maxThreads * 0.2)));
   let baseStep = config.stepSize;
   let isStable = true;
@@ -243,6 +247,9 @@ async function runIntelligentAgenticStressTest(config) {
     globalMetricsAccumulator.ttfb.push(metrics.avgTtfbMs);
     globalMetricsAccumulator.latencies.push(metrics.avgLatencyMs);
     globalMetricsAccumulator.bandwidths.push(metrics.bandwidthMb);
+    globalMetricsAccumulator.lcp.push(metrics.lcpMs);
+    globalMetricsAccumulator.fid.push(metrics.fidMs);
+    globalMetricsAccumulator.cls.push(metrics.clsScore);
     const currentState = {
       threads: currentThreads,
       avgLatency: metrics.avgLatencyMs,
@@ -251,7 +258,10 @@ async function runIntelligentAgenticStressTest(config) {
       apdex: metrics.apdexScore,
       throughput: metrics.requestsPerSecond,
       successRequests: metrics.c2xx + metrics.c3xx,
-      failedRequests: metrics.c4xx + metrics.c5xx
+      failedRequests: metrics.c4xx + metrics.c5xx,
+      lcp: metrics.lcpMs,
+      fid: metrics.fidMs,
+      cls: metrics.clsScore
     };
     printMatrixDashboard(metrics, currentThreads);
     history.push(currentState);
@@ -305,7 +315,10 @@ async function runIntelligentAgenticStressTest(config) {
     tls: mathUtils.mean(globalMetricsAccumulator.tls),
     stdDev: mathUtils.stdDev(globalMetricsAccumulator.latencies, mathUtils.mean(globalMetricsAccumulator.latencies)),
     saturationKneePoint: saturationKneePoint || history[history.length - 1]?.threads || 50,
-    vuRampUpVelocity
+    vuRampUpVelocity,
+    lcp: mathUtils.mean(globalMetricsAccumulator.lcp),
+    fid: mathUtils.mean(globalMetricsAccumulator.fid),
+    cls: mathUtils.mean(globalMetricsAccumulator.cls)
   };
   generateFinalAgentReport(history);
   exportHtmlDashboard(history, config, verdictReason, semanticReport, { total1xx, total2xx, total3xx, total4xx, total5xx }, finalSummaryCards, lastRawRequests);
@@ -322,7 +335,10 @@ async function runStandardStressTest(config) {
     apdex: metrics.apdexScore,
     throughput: metrics.requestsPerSecond,
     successRequests: metrics.c2xx + metrics.c3xx,
-    failedRequests: metrics.c4xx + metrics.c5xx
+    failedRequests: metrics.c4xx + metrics.c5xx,
+    lcp: metrics.lcpMs,
+    fid: metrics.fidMs,
+    cls: metrics.clsScore
   }];
   let semanticReport = null;
   if (config.clusterLogs) {
@@ -341,7 +357,10 @@ async function runStandardStressTest(config) {
     tls: metrics.avgTlsMs,
     stdDev: metrics.stdDevMs,
     saturationKneePoint: config.threads,
-    vuRampUpVelocity: config.threads / config.durationSec
+    vuRampUpVelocity: config.threads / config.durationSec,
+    lcp: metrics.lcpMs,
+    fid: metrics.fidMs,
+    cls: metrics.clsScore
   };
   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.";
@@ -394,7 +413,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,11 +433,13 @@ function processMetricsTelemetry(requests, durationSec) {
   });
   const errorCount = c4xx + c5xx;
   const errorRate = totalRequests === 0 ? 0 : errorCount / totalRequests;
-  const T = 50;
-  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 satisfied = requests.filter((r) => r.durationMs <= apdexT && r.statusCode < 400).length;
+  const tolerating = requests.filter((r) => r.durationMs > apdexT && r.durationMs <= apdexT * 4 && r.statusCode < 400).length;
   const apdexScore = totalRequests === 0 ? 0 : (satisfied + tolerating / 2) / totalRequests;
   const bandwidthMb = totalRequests * 1.2 / durationSec / 10;
+  const lcpMs = avgTtfbMs * 1.6 + (p95LatencyMs - avgLatencyMs) * 0.4;
+  const fidMs = Math.max(1.5, stdDevMs * 0.18 + errorRate * 60);
+  const clsScore = Math.min(0.5, errorRate * 0.25 + (avgLatencyMs > 400 ? 0.08 : 0.01));
   return {
     totalRequests,
     requestsPerSecond: totalRequests / durationSec,
@@ -436,7 +457,10 @@ function processMetricsTelemetry(requests, durationSec) {
     avgTcpMs,
     avgTlsMs,
     avgTtfbMs,
-    bandwidthMb
+    bandwidthMb,
+    lcpMs,
+    fidMs,
+    clsScore
   };
 }
 function printMatrixDashboard(m, threads) {
@@ -446,6 +470,8 @@ function printMatrixDashboard(m, threads) {
   console.log(`-----------------------------------------------------------------------------------------`);
   console.log(`| ${pad(threads, 7)} | ${pad(m.totalRequests, 9)} | ${pad(m.avgLatencyMs.toFixed(1) + "ms", 11)} | ${pad(m.p95LatencyMs.toFixed(1) + "ms", 11)} | ${pad(m.requestsPerSecond.toFixed(0) + "/s", 10)} | ${pad((m.errorRate * 100).toFixed(2) + "%", 10)} | ${pad(m.apdexScore.toFixed(2), 9)} |`);
   console.log(`-----------------------------------------------------------------------------------------`);
+  console.log(`| Simulated Web Vitals Equivalent -> LCP: ${m.lcpMs.toFixed(0)}ms | FID: ${m.fidMs.toFixed(1)}ms | CLS: ${m.clsScore.toFixed(3)} |`);
+  console.log(`-----------------------------------------------------------------------------------------`);
 }
 function generateFinalAgentReport(history) {
   if (history.length === 0) return;
@@ -467,7 +493,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
   const activeThreadsData = history.map((h) => h.threads);
   const ttfTrendData = history.map((h) => h.avgLatency * 1.1);
   const waveListItems = history.map((h) => {
-    return `<div class="wave-item">Wave (${h.threads} VUs): P95 ${h.p95Latency.toFixed(1)}ms, Errors ${(h.errorRate * 100).toFixed(1)}%</div>`;
+    return `<div class="wave-item">Wave (${h.threads} VUs): P95 ${h.p95Latency.toFixed(1)}ms, Errors ${(h.errorRate * 100).toFixed(1)}%, LCP ${h.lcp.toFixed(0)}ms</div>`;
   }).join("");
   const estimatedMonthlyCost = (cards.throughput * 0.045 * 24 * 30).toFixed(2);
   const recommendedCpuCores = Math.max(2, Math.ceil(cards.saturationKneePoint / 75));
@@ -477,6 +503,12 @@ 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 getLcpStatus = (val) => val <= 2500 ? { label: "Good", cls: "green" } : val <= 4e3 ? { label: "Needs Imp.", cls: "orange" } : { label: "Poor", cls: "badge-fail" };
+  const getFidStatus = (val) => val <= 100 ? { label: "Good", cls: "green" } : val <= 300 ? { label: "Needs Imp.", cls: "orange" } : { label: "Poor", cls: "badge-fail" };
+  const getClsStatus = (val) => val <= 0.1 ? { label: "Good", cls: "green" } : val <= 0.25 ? { label: "Needs Imp.", cls: "orange" } : { label: "Poor", cls: "badge-fail" };
+  const lcpStat = getLcpStatus(cards.lcp);
+  const fidStat = getFidStatus(cards.fid);
+  const clsStat = getClsStatus(cards.cls);
   let logClustersHtml = "";
   if (semanticReport) {
     const totalLogCount = semanticReport.clusters.reduce((sum, c) => sum + c.count, 0);
@@ -603,6 +635,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
     h1 { color: #38bdf8; margin: 0; font-size: 2rem; }
     .meta { color: #94a3b8; font-size: 0.9rem; margin-top: 0.5rem; }
     
+    .section-title { font-size: 1.2rem; color: #cbd5e1; font-weight: bold; margin: 2rem 0 1rem 0; padding-bottom: 0.4rem; border-bottom: 1px solid #1e293b; }
     .cards-wrapper { display: grid; grid-template-columns: repeat(3, 1fr); gap: 1rem; margin-bottom: 1.5rem; }
     .metric-card { background: #131c2e; border: 1px solid #1e293b; border-radius: 6px; padding: 1.25rem; position: relative; }
     .card-title { font-size: 0.75rem; font-weight: 700; color: #64748b; text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 0.5rem; }
@@ -612,7 +645,9 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
     .card-value.orange { color: #f97316; }
     .card-value.purple { color: #a855f7; }
     .card-value.cyan { color: #38bdf8; }
-    .card-subtext { font-size: 0.8rem; color: #10b981; font-weight: 500; margin-left: 0.4rem; display: inline-block; }
+    .card-subtext { font-size: 0.8rem; font-weight: 500; margin-left: 0.4rem; display: inline-block; }
+    .card-subtext.green { color: #10b981; }
+    .card-subtext.orange { color: #f97316; }
 
     .top-layout-grid { display: grid; grid-template-columns: 1fr 400px; gap: 1.5rem; margin-bottom: 2rem; }
     .verdict-box { background: #0f172a; border: 1px dashed #ea580c; border-radius: 8px; padding: 1.25rem; }
@@ -653,10 +688,11 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
       <div class="meta">Target Script: <code>${config.targetScript}</code></div>
     </div>
     
+    <div class="section-title">\u{1F4CA} Core Server Metrics & Apdex Verification</div>
     <div class="cards-wrapper">
       <div class="metric-card">
-        <div class="card-title">Apdex Score (T: 50ms)</div>
-        <div class="card-value green">${cards.apdex.toFixed(2)}<span class="card-subtext">(Good)</span></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 green">(Target Verified)</span></div>
       </div>
       <div class="metric-card">
         <div class="card-title">Throughput</div>
@@ -675,23 +711,28 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
         <div class="card-value cyan">${cards.vuRampUpVelocity.toFixed(1)}<span class="unit">VUs/s</span></div>
       </div>
       <div class="metric-card">
-        <div class="card-title">DNS Lookup</div>
-        <div class="card-value">${cards.dns.toFixed(2)}<span class="unit">ms</span></div>
+        <div class="card-title">Stability (Std Dev)</div>
+        <div class="card-value">&plusmn;${cards.stdDev.toFixed(1)}<span class="unit">ms</span></div>
       </div>
+    </div>
+
+    <div class="section-title">\u{1F310} Simulated Browser Core Web Vitals Equivalent</div>
+    <div class="cards-wrapper">
       <div class="metric-card">
-        <div class="card-title">TCP Connect</div>
-        <div class="card-value">${cards.tcp.toFixed(2)}<span class="unit">ms</span></div>
+        <div class="card-title">Largest Contentful Paint (LCP)</div>
+        <div class="card-value">${cards.lcp.toFixed(0)}<span class="unit">ms</span><span class="card-subtext ${lcpStat.cls}">(${lcpStat.label})</span></div>
       </div>
       <div class="metric-card">
-        <div class="card-title">TLS Handshake</div>
-        <div class="card-value">${cards.tls.toFixed(2)}<span class="unit">ms</span></div>
+        <div class="card-title">First Input Delay (FID)</div>
+        <div class="card-value">${cards.fid.toFixed(1)}<span class="unit">ms</span><span class="card-subtext ${fidStat.cls}">(${fidStat.label})</span></div>
       </div>
       <div class="metric-card">
-        <div class="card-title">Stability (Std Dev)</div>
-        <div class="card-value">&plusmn;${cards.stdDev.toFixed(1)}<span class="unit">ms</span></div>
+        <div class="card-title">Cumulative Layout Shift (CLS)</div>
+        <div class="card-value">${cards.cls.toFixed(3)}<span class="card-subtext ${clsStat.cls}">(${clsStat.label})</span></div>
       </div>
     </div>
 
+    <div class="section-title">\u26A1 Diagnostic Breakdowns</div>
     <div class="top-layout-grid">
       <div class="verdict-box">
         <div class="verdict-title">\u{1F916} AI Stress-Testing Agent Verdict</div>
@@ -763,6 +804,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
             <th>Throughput</th>
             <th>Avg Latency</th>
             <th>P95 Latency</th>
+            <th>Simulated LCP</th>
             <th>Error Rate</th>
             <th>Status</th>
           </tr>
@@ -775,6 +817,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
                 <td>${h.throughput.toFixed(0)} req/sec</td>
                 <td>${h.avgLatency.toFixed(1)} ms</td>
                 <td>${h.p95Latency.toFixed(1)} ms</td>
+                <td>${h.lcp.toFixed(0)} ms</td>
                 <td>${(h.errorRate * 100).toFixed(2)}%</td>
                 <td><span class="badge ${isPassed ? "badge-success" : "badge-fail"}">${isPassed ? "SLO PASS" : "SLO BREACH"}</span></td>
               </tr>`;
@@ -947,6 +990,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`);
+  --threads <count> | --duration <seconds> | --agentic | --cluster-logs | --correlate | --apdex-t <ms>`);
 }
 main().catch(console.error);

package/package.json

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