apex-auditor 0.2.0 → 0.2.2

package/dist/cli.js

@@ -47,6 +47,7 @@ function parseArgs(argv) {
  */
 export async function runAuditCli(argv) {
     const args = parseArgs(argv);
+    const startTimeMs = Date.now();
     const { configPath, config } = await loadConfig({ configPath: args.configPath });
     const effectiveLogLevel = args.logLevelOverride ?? config.logLevel;
     const effectiveConfig = {
@@ -66,6 +67,14 @@ export async function runAuditCli(argv) {
     console.log(consoleTable);
     printRedIssues(summary.results);
     printCiSummary(args, summary.results, effectiveConfig.budgets);
+    printLowestPerformancePages(summary.results, useColor);
+    const elapsedMs = Date.now() - startTimeMs;
+    const elapsedText = formatElapsedTime(elapsedMs);
+    const runsPerTarget = effectiveConfig.runs ?? 1;
+    const comboCount = summary.results.length;
+    const totalRuns = comboCount * runsPerTarget;
+    // eslint-disable-next-line no-console
+    console.log(`\nCompleted in ${elapsedText} (${comboCount} page/device combinations x ${runsPerTarget} runs = ${totalRuns} Lighthouse runs).`);
 }
 function buildMarkdown(results) {
     const header = [
@@ -77,11 +86,11 @@ function buildMarkdown(results) {
 }
 function buildConsoleTable(results, useColor) {
     const header = [
-        "| Label | Path | Device | P | A | BP | SEO | LCP (s) | FCP (s) | TBT (ms) | CLS | Error | Top issues |",
-        "|-------|------|--------|---|---|----|-----|---------|---------|----------|-----|-------|-----------|",
+        "| Label | Path | Device | P | A | BP | SEO | LCP (s) | FCP (s) | TBT (ms) | CLS |",
+        "|-------|------|--------|---|---|----|-----|---------|---------|----------|-----|",
     ].join("\n");
-    const lines = results.map((result) => buildConsoleRow(result, useColor));
-    return `${header}\n${lines.join("\n")}`;
+    const rows = results.map((result) => buildConsoleRow(result, useColor));
+    return `${header}\n${rows.join("\n")}`;
 }
 function buildRow(result) {
     const scores = result.scores;
@@ -95,19 +104,47 @@ function buildRow(result) {
     return `| ${result.label} | ${result.path} | ${result.device} | ${scores.performance ?? "-"} | ${scores.accessibility ?? "-"} | ${scores.bestPractices ?? "-"} | ${scores.seo ?? "-"} | ${lcpSeconds} | ${fcpSeconds} | ${tbtMs} | ${cls} | ${error} | ${issues} |`;
 }
 function buildConsoleRow(result, useColor) {
+    const line1 = buildConsoleRowLine1(result, useColor);
+    const line2 = buildConsoleRowLine2(result, useColor);
+    const line3 = buildConsoleRowLine3(result);
+    const lines = [line1];
+    if (line2.length > 0) {
+        lines.push(line2);
+    }
+    if (line3.length > 0) {
+        lines.push(line3);
+    }
+    return lines.join("\n");
+}
+function buildConsoleRowLine1(result, useColor) {
     const scores = result.scores;
     const metrics = result.metrics;
     const lcpSeconds = metrics.lcpMs !== undefined ? (metrics.lcpMs / 1000).toFixed(1) : "-";
     const fcpSeconds = metrics.fcpMs !== undefined ? (metrics.fcpMs / 1000).toFixed(1) : "-";
     const tbtMs = metrics.tbtMs !== undefined ? Math.round(metrics.tbtMs).toString() : "-";
     const cls = metrics.cls !== undefined ? metrics.cls.toFixed(3) : "-";
-    const issues = formatTopIssues(result.opportunities);
-    const error = result.runtimeErrorCode ?? (result.runtimeErrorMessage !== undefined ? result.runtimeErrorMessage : "");
     const performanceText = colourScore(scores.performance, useColor);
     const accessibilityText = colourScore(scores.accessibility, useColor);
     const bestPracticesText = colourScore(scores.bestPractices, useColor);
     const seoText = colourScore(scores.seo, useColor);
-    return `| ${result.label} | ${result.path} | ${result.device} | ${performanceText} | ${accessibilityText} | ${bestPracticesText} | ${seoText} | ${lcpSeconds} | ${fcpSeconds} | ${tbtMs} | ${cls} | ${error} | ${issues} |`;
+    return `| ${result.label} | ${result.path} | ${result.device} | ${performanceText} | ${accessibilityText} | ${bestPracticesText} | ${seoText} | ${lcpSeconds} | ${fcpSeconds} | ${tbtMs} | ${cls} |`;
+}
+function buildConsoleRowLine2(result, useColor) {
+    const errorCode = result.runtimeErrorCode;
+    const errorMessage = result.runtimeErrorMessage;
+    if (!errorCode && !errorMessage) {
+        return "";
+    }
+    const errorText = errorCode ?? errorMessage ?? "";
+    const prefix = useColor ? `${ANSI_RED}↳ Error:${ANSI_RESET}` : "↳ Error:";
+    return `  ${prefix} ${errorText}`;
+}
+function buildConsoleRowLine3(result) {
+    const issues = formatTopIssues(result.opportunities);
+    if (issues.length === 0) {
+        return "";
+    }
+    return `  ↳ Top issues: ${issues}`;
 }
 function formatTopIssues(opportunities) {
     if (opportunities.length === 0) {
@@ -250,6 +287,44 @@ function addCategoryViolation(id, actual, limit, result, allViolations) {
         limit,
     });
 }
+function formatElapsedTime(elapsedMs) {
+    const totalSeconds = Math.round(elapsedMs / 1000);
+    if (totalSeconds < 60) {
+        return `${totalSeconds}s`;
+    }
+    const minutes = Math.floor(totalSeconds / 60);
+    const remainingSeconds = totalSeconds % 60;
+    if (remainingSeconds === 0) {
+        return `${minutes}m`;
+    }
+    return `${minutes}m ${remainingSeconds}s`;
+}
+function printLowestPerformancePages(results, useColor) {
+    const entries = results.map((result) => ({
+        result,
+        performance: result.scores.performance,
+    }));
+    const definedEntries = entries
+        .filter((entry) => {
+        return typeof entry.performance === "number";
+    })
+        .sort((a, b) => a.performance - b.performance);
+    const limit = 5;
+    const worst = definedEntries.slice(0, limit);
+    if (worst.length === 0) {
+        return;
+    }
+    // eslint-disable-next-line no-console
+    console.log("\nLowest Performance pages:");
+    for (const entry of worst) {
+        const perfText = colourScore(entry.performance, useColor);
+        const label = entry.result.label;
+        const path = entry.result.path;
+        const device = entry.result.device;
+        // eslint-disable-next-line no-console
+        console.log(`- ${label} ${path} [${device}] P:${perfText}`);
+    }
+}
 function collectMetricViolations(result, metricsBudgets, allViolations) {
     const metrics = result.metrics;
     addMetricViolation("lcpMs", metrics.lcpMs, metricsBudgets.lcpMs, result, allViolations);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apex-auditor",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "private": false,
   "description": "CLI to run structured Lighthouse audits (Performance, Accessibility, Best Practices, SEO) across routes.",
   "type": "module",