apex-auditor 0.1.5 → 0.1.6

package/dist/cli.js

@@ -2,6 +2,10 @@ import { mkdir, writeFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import { loadConfig } from "./config.js";
 import { runAuditsForConfig } from "./lighthouse-runner.js";
+const ANSI_RESET = "\u001B[0m";
+const ANSI_RED = "\u001B[31m";
+const ANSI_YELLOW = "\u001B[33m";
+const ANSI_GREEN = "\u001B[32m";
 function parseArgs(argv) {
     let configPath;
     for (let i = 2; i < argv.length; i += 1) {
@@ -28,9 +32,11 @@ export async function runAuditCli(argv) {
     await writeFile(resolve(outputDir, "summary.json"), JSON.stringify(summary, null, 2), "utf8");
     const markdown = buildMarkdown(summary.results);
     await writeFile(resolve(outputDir, "summary.md"), markdown, "utf8");
-    // Also echo a compact table to stdout for quick viewing.
+    // Also echo a compact, colourised table to stdout for quick viewing.
+    const consoleTable = buildConsoleTable(summary.results);
     // eslint-disable-next-line no-console
-    console.log(markdown);
+    console.log(consoleTable);
+    printRedIssues(summary.results);
 }
 function buildMarkdown(results) {
     const header = [
@@ -40,6 +46,14 @@ function buildMarkdown(results) {
     const lines = results.map((result) => buildRow(result));
     return `${header}\n${lines.join("\n")}`;
 }
+function buildConsoleTable(results) {
+    const header = [
+        "| Label | Path | Device | P | A | BP | SEO | LCP (s) | FCP (s) | TBT (ms) | CLS | Error | Top issues |",
+        "|-------|------|--------|---|---|----|-----|---------|---------|----------|-----|-------|-----------|",
+    ].join("\n");
+    const lines = results.map((result) => buildConsoleRow(result));
+    return `${header}\n${lines.join("\n")}`;
+}
 function buildRow(result) {
     const scores = result.scores;
     const metrics = result.metrics;
@@ -51,6 +65,21 @@ function buildRow(result) {
     const error = result.runtimeErrorCode ?? (result.runtimeErrorMessage !== undefined ? result.runtimeErrorMessage : "");
     return `| ${result.label} | ${result.path} | ${result.device} | ${scores.performance ?? "-"} | ${scores.accessibility ?? "-"} | ${scores.bestPractices ?? "-"} | ${scores.seo ?? "-"} | ${lcpSeconds} | ${fcpSeconds} | ${tbtMs} | ${cls} | ${error} | ${issues} |`;
 }
+function buildConsoleRow(result) {
+    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);
+    const accessibilityText = colourScore(scores.accessibility);
+    const bestPracticesText = colourScore(scores.bestPractices);
+    const seoText = colourScore(scores.seo);
+    return `| ${result.label} | ${result.path} | ${result.device} | ${performanceText} | ${accessibilityText} | ${bestPracticesText} | ${seoText} | ${lcpSeconds} | ${fcpSeconds} | ${tbtMs} | ${cls} | ${error} | ${issues} |`;
+}
 function formatTopIssues(opportunities) {
     if (opportunities.length === 0) {
         return "";
@@ -64,3 +93,57 @@ function formatTopIssues(opportunities) {
     });
     return items.join("; ");
 }
+function colourScore(score) {
+    if (score === undefined) {
+        return "-";
+    }
+    const value = score;
+    const text = value.toString();
+    let colour;
+    if (value < 50) {
+        colour = ANSI_RED;
+    }
+    else if (value < 90) {
+        colour = ANSI_YELLOW;
+    }
+    else {
+        colour = ANSI_GREEN;
+    }
+    return `${colour}${text}${ANSI_RESET}`;
+}
+function isRedScore(score) {
+    return typeof score === "number" && score < 50;
+}
+function printRedIssues(results) {
+    const redResults = results.filter((result) => {
+        const scores = result.scores;
+        return (isRedScore(scores.performance) ||
+            isRedScore(scores.accessibility) ||
+            isRedScore(scores.bestPractices) ||
+            isRedScore(scores.seo));
+    });
+    if (redResults.length === 0) {
+        return;
+    }
+    // eslint-disable-next-line no-console
+    console.log("\nRed issues (scores below 50):");
+    for (const result of redResults) {
+        const scores = result.scores;
+        const badParts = [];
+        if (isRedScore(scores.performance)) {
+            badParts.push(`P:${scores.performance}`);
+        }
+        if (isRedScore(scores.accessibility)) {
+            badParts.push(`A:${scores.accessibility}`);
+        }
+        if (isRedScore(scores.bestPractices)) {
+            badParts.push(`BP:${scores.bestPractices}`);
+        }
+        if (isRedScore(scores.seo)) {
+            badParts.push(`SEO:${scores.seo}`);
+        }
+        const issues = formatTopIssues(result.opportunities);
+        // eslint-disable-next-line no-console
+        console.log(`- ${result.label} ${result.path} [${result.device}] – ${badParts.join(", ")} – ${issues}`);
+    }
+}

package/dist/lighthouse-runner.js

@@ -68,6 +68,8 @@ export async function runAuditsForConfig({ config, configPath, }) {
     const firstPage = config.pages[0];
     const healthCheckUrl = buildUrl({ baseUrl: config.baseUrl, path: firstPage.path, query: config.query });
     await ensureUrlReachable(healthCheckUrl);
+    const totalSteps = config.pages.reduce((sum, page) => sum + page.devices.length * runs, 0);
+    let completedSteps = 0;
     const session = await createChromeSession(config.chromePort);
     try {
         for (const page of config.pages) {
@@ -84,6 +86,13 @@ export async function runAuditsForConfig({ config, configPath, }) {
                         logLevel: config.logLevel ?? "error",
                     });
                     summaries.push(summary);
+                    completedSteps += 1;
+                    logProgress({
+                        completed: completedSteps,
+                        total: totalSteps,
+                        path: page.path,
+                        device,
+                    });
                 }
                 results.push(aggregateSummaries(summaries));
             }
@@ -102,6 +111,20 @@ function buildUrl({ baseUrl, path, query }) {
     const queryPart = query && query.length > 0 ? query : "";
     return `${cleanBase}${cleanPath}${queryPart}`;
 }
+function logProgress({ completed, total, path, device, }) {
+    const percentage = total > 0 ? Math.round((completed / total) * 100) : 0;
+    const message = `Running audits ${completed}/${total} (${percentage}%) – ${path} [${device}]`;
+    if (typeof process !== "undefined" && process.stdout && typeof process.stdout.write === "function" && process.stdout.isTTY) {
+        const padded = message.padEnd(80, " ");
+        process.stdout.write(`\r${padded}`);
+        if (completed === total) {
+            process.stdout.write("\n");
+        }
+        return;
+    }
+    // eslint-disable-next-line no-console
+    console.log(message);
+}
 async function runSingleAudit(params) {
     const options = {
         port: params.port,

package/package.json

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