laxy-verify 1.2.3 → 1.3.0

package/README.md

@@ -188,6 +188,16 @@ Passed:
 Artifacts:
 - .laxy-result.json
 - laxy-verify-report.md
+
+  Badge (auto-updates with each run):
+    [![Laxy Verify](https://laxy.app/api/badge/your-repo-id)](https://laxy.app)
+```
+
+For Free accounts, the CLI prints a tip instead:
+
+```text
+  Tip: Pro tracks your last 30 runs so you can see if Performance or Grade is improving.
+       https://laxy.app/pricing
 ```
 
 ## The decision it helps you make
@@ -318,9 +328,13 @@ Pro and Team accounts unlock additional capabilities on top of the same verifica
 - **Result saving and sharing** — `--share` saves the run to your dashboard and returns a shareable URL
 - **Environment comparison** — `--compare <url>` runs Lighthouse against a reference URL (e.g. staging or production) and shows score deltas between your local build and the reference
 - **AI failure analysis** — when a run ends in `hold`, Claude analyzes the failure context and returns a root cause summary with top fix suggestions
+- **History trend tracking** — the last 30 runs are stored so you can see whether your grade and performance scores are improving or regressing over time
+- **Dynamic README badge** — after each run, the CLI prints a Markdown badge snippet that links to your live verification status. The badge auto-updates with every run so your README always reflects current grade
 - **Team Slack / Discord alerts** — grade drops and `hold` verdicts fire webhook notifications with score deltas and blocker details
 - **Weekly team report** — automated weekly summary of verification activity across your team's repos
 
+Free accounts see a hint after each run pointing to the history trend feature.
+
 ## Secret scan patterns
 
 When `--secret-scan` is enabled, the following patterns are detected:
@@ -418,6 +432,15 @@ It is a pre-merge and pre-release verification layer, not your entire quality sy
 
 ## Changelog
 
+### v1.3.0 — Pro history trend, dynamic badge, CLI nudge
+
+- **History trend tracking** — Pro accounts now store the last 30 verification runs. Grade and performance scores accumulate so you can see whether your app is improving or regressing over time
+- **Dynamic README badge** — after each run, Pro accounts see a Markdown badge snippet in the CLI output. The badge auto-updates with every run via the `/api/badge/:id` endpoint
+- **CLI nudge** — Free accounts see a one-line tip after each run pointing to the history trend feature
+- Added `generateDynamicBadgeMarkdown(repoId, apiUrl)` export to the `badge` module
+- Added `share_result` and `history_trend` flags to `EntitlementFeatures` interface
+- 17 test files, 88 unit tests
+
 ### v1.2.3 — Bug fix
 
 - Fix E2E and visual diff connection failure on Windows with Node.js 17+: `verifyUrl` now uses `localhost` instead of `127.0.0.1`. On Windows, Vite binds to `::1` (IPv6) which does not accept IPv4 connections.

package/dist/audit/broken-links.d.ts

@@ -1,25 +1,25 @@
-/**
- * Broken-links audit.
- * Uses the crawl result to find all internal links, then validates each
- * with an HTTP HEAD/GET request. Links that return 4xx/5xx or timeout are
- * reported as blockers.
- */
-import { type CrawlResult } from "../crawler.js";
-export interface BrokenLink {
-    url: string;
-    path: string;
-    status: number;
-    statusText: string;
-    severity: "critical" | "high";
-}
-export interface BrokenLinksResult {
-    brokenLinks: BrokenLink[];
-    checkedCount: number;
-    hasBrokenLinks: boolean;
-    summary: string;
-}
-export interface BrokenLinksAuditOptions {
-    extraRoutes?: string[];
-    abortSignal?: AbortSignal;
-}
-export declare function auditBrokenLinks(crawlResult: CrawlResult | undefined, baseUrl: string, options?: BrokenLinksAuditOptions): Promise<BrokenLinksResult>;
+/**
+ * Broken-links audit.
+ * Uses the crawl result to find all internal links, then validates each
+ * with an HTTP HEAD/GET request. Links that return 4xx/5xx or timeout are
+ * reported as blockers.
+ */
+import { type CrawlResult } from "../crawler.js";
+export interface BrokenLink {
+    url: string;
+    path: string;
+    status: number;
+    statusText: string;
+    severity: "critical" | "high";
+}
+export interface BrokenLinksResult {
+    brokenLinks: BrokenLink[];
+    checkedCount: number;
+    hasBrokenLinks: boolean;
+    summary: string;
+}
+export interface BrokenLinksAuditOptions {
+    extraRoutes?: string[];
+    abortSignal?: AbortSignal;
+}
+export declare function auditBrokenLinks(crawlResult: CrawlResult | undefined, baseUrl: string, options?: BrokenLinksAuditOptions): Promise<BrokenLinksResult>;

package/dist/audit/broken-links.js

@@ -1,97 +1,97 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.auditBrokenLinks = auditBrokenLinks;
-const TIMEOUT_MS = 5000;
-const VALID_OK_STATUS = [200, 201, 202, 203, 204, 301, 302, 303, 307, 308];
-function isSuccessStatus(n) {
-    return VALID_OK_STATUS.includes(n);
-}
-async function auditBrokenLinks(crawlResult, baseUrl, options = {}) {
-    const allUrls = [];
-    if (crawlResult) {
-        for (const page of crawlResult.pages) {
-            for (const href of page.internalLinks) {
-                try {
-                    const url = new URL(href, baseUrl).href;
-                    if (!allUrls.includes(url))
-                        allUrls.push(url);
-                }
-                catch {
-                    // skip malformed URLs
-                }
-            }
-        }
-    }
-    for (const route of options.extraRoutes ?? []) {
-        try {
-            const url = new URL(route, baseUrl).href;
-            if (!allUrls.includes(url))
-                allUrls.push(url);
-        }
-        catch {
-            // skip malformed routes
-        }
-    }
-    const uniqueUrls = allUrls;
-    const brokenLinks = [];
-    await Promise.all(uniqueUrls.map(async (url) => {
-        if (options.abortSignal?.aborted)
-            return;
-        try {
-            const controller = new AbortController();
-            const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
-            let status = 0;
-            let statusText = "";
-            try {
-                const res = await fetch(url, {
-                    method: "HEAD",
-                    redirect: "follow",
-                    signal: controller.signal,
-                });
-                status = res.status;
-                statusText = res.statusText;
-            }
-            catch {
-                // Fall back to GET if HEAD is not allowed
-                const controller2 = new AbortController();
-                const timer2 = setTimeout(() => controller2.abort(), TIMEOUT_MS);
-                try {
-                    const res = await fetch(url, {
-                        method: "GET",
-                        redirect: "follow",
-                        signal: controller2.signal,
-                    });
-                    status = res.status;
-                    statusText = res.statusText;
-                }
-                catch {
-                    status = 0;
-                    statusText = "timeout or network error";
-                }
-                clearTimeout(timer2);
-            }
-            clearTimeout(timer);
-            if (!isSuccessStatus(status)) {
-                const severity = status >= 500 ? "critical" : "high";
-                let path = url;
-                try {
-                    path = new URL(url).pathname;
-                }
-                catch { }
-                brokenLinks.push({ url, path, status, statusText, severity });
-            }
-        }
-        catch {
-            // skip
-        }
-    }));
-    const summary = brokenLinks.length === 0
-        ? `All ${uniqueUrls.length} links OK`
-        : `${brokenLinks.length} broken link(s) found`;
-    return {
-        brokenLinks,
-        checkedCount: uniqueUrls.length,
-        hasBrokenLinks: brokenLinks.length > 0,
-        summary,
-    };
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auditBrokenLinks = auditBrokenLinks;
+const TIMEOUT_MS = 5000;
+const VALID_OK_STATUS = [200, 201, 202, 203, 204, 301, 302, 303, 307, 308];
+function isSuccessStatus(n) {
+    return VALID_OK_STATUS.includes(n);
+}
+async function auditBrokenLinks(crawlResult, baseUrl, options = {}) {
+    const allUrls = [];
+    if (crawlResult) {
+        for (const page of crawlResult.pages) {
+            for (const href of page.internalLinks) {
+                try {
+                    const url = new URL(href, baseUrl).href;
+                    if (!allUrls.includes(url))
+                        allUrls.push(url);
+                }
+                catch {
+                    // skip malformed URLs
+                }
+            }
+        }
+    }
+    for (const route of options.extraRoutes ?? []) {
+        try {
+            const url = new URL(route, baseUrl).href;
+            if (!allUrls.includes(url))
+                allUrls.push(url);
+        }
+        catch {
+            // skip malformed routes
+        }
+    }
+    const uniqueUrls = allUrls;
+    const brokenLinks = [];
+    await Promise.all(uniqueUrls.map(async (url) => {
+        if (options.abortSignal?.aborted)
+            return;
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+            let status = 0;
+            let statusText = "";
+            try {
+                const res = await fetch(url, {
+                    method: "HEAD",
+                    redirect: "follow",
+                    signal: controller.signal,
+                });
+                status = res.status;
+                statusText = res.statusText;
+            }
+            catch {
+                // Fall back to GET if HEAD is not allowed
+                const controller2 = new AbortController();
+                const timer2 = setTimeout(() => controller2.abort(), TIMEOUT_MS);
+                try {
+                    const res = await fetch(url, {
+                        method: "GET",
+                        redirect: "follow",
+                        signal: controller2.signal,
+                    });
+                    status = res.status;
+                    statusText = res.statusText;
+                }
+                catch {
+                    status = 0;
+                    statusText = "timeout or network error";
+                }
+                clearTimeout(timer2);
+            }
+            clearTimeout(timer);
+            if (!isSuccessStatus(status)) {
+                const severity = status >= 500 ? "critical" : "high";
+                let path = url;
+                try {
+                    path = new URL(url).pathname;
+                }
+                catch { }
+                brokenLinks.push({ url, path, status, statusText, severity });
+            }
+        }
+        catch {
+            // skip
+        }
+    }));
+    const summary = brokenLinks.length === 0
+        ? `All ${uniqueUrls.length} links OK`
+        : `${brokenLinks.length} broken link(s) found`;
+    return {
+        brokenLinks,
+        checkedCount: uniqueUrls.length,
+        hasBrokenLinks: brokenLinks.length > 0,
+        summary,
+    };
+}

package/dist/badge.d.ts

@@ -1 +1,2 @@
-export declare function generateBadge(grade: string): string;
+export declare function generateBadge(grade: string): string;
+export declare function generateDynamicBadgeMarkdown(repoId: string, apiUrl: string): string;

package/dist/badge.js

@@ -1,14 +1,18 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateBadge = generateBadge;
-function generateBadge(grade) {
-    const gradeLower = grade.toLowerCase();
-    const colors = {
-        gold: "yellow",
-        silver: "brightgreen",
-        bronze: "blue",
-        unverified: "lightgrey",
-    };
-    const color = colors[gradeLower] ?? "lightgrey";
-    return `![Laxy Verify: ${grade}](https://img.shields.io/badge/laxy_verify-${gradeLower}-${color})`;
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateBadge = generateBadge;
+exports.generateDynamicBadgeMarkdown = generateDynamicBadgeMarkdown;
+function generateBadge(grade) {
+    const gradeLower = grade.toLowerCase();
+    const colors = {
+        gold: "yellow",
+        silver: "brightgreen",
+        bronze: "blue",
+        unverified: "lightgrey",
+    };
+    const color = colors[gradeLower] ?? "lightgrey";
+    return `![Laxy Verify: ${grade}](https://img.shields.io/badge/laxy_verify-${gradeLower}-${color})`;
+}
+function generateDynamicBadgeMarkdown(repoId, apiUrl) {
+    return `[![Laxy Verify](${apiUrl}/api/badge/${repoId})](${apiUrl})`;
+}