@monoes/monobrowse 1.0.12 → 1.0.13

package/dist/src/report/history.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Persistent run history for `monobrowse report` (RIG-13).
+ *
+ * Every run is appended to a per-URL directory under the monomind data dir,
+ * so the next run can say "LCP has crept up 400ms over nine runs" instead of
+ * reporting a number with no context. Deliberately not a database: one JSON
+ * file per run plus its screenshot is greppable, diffable, rsync-able, and
+ * survives this tool being uninstalled.
+ *
+ *   ~/.monomind/browser-reports/
+ *     shop.test-checkout-1f4c9a2b/
+ *       url.txt                              <- the full URL, for humans
+ *       20260921T100000Z-8f2a1c4d.json       <- HistoryRun
+ *       20260921T100000Z-8f2a1c4d.png        <- main screenshot, for the diff
+ *
+ * Set `MONOBROWSE_HISTORY_DIR` to relocate the root (the tests do).
+ */
+import type { ImageSize, Report, StructureNode, VerdictValue, VitalsData } from './types.js';
+/** Runs kept per URL before the oldest are pruned. Override with --history-max. */
+export declare const DEFAULT_HISTORY_MAX = 20;
+export interface HistoryRun {
+    /** `<compact ISO timestamp>-<8 hex>`, also the basename of its files. */
+    id: string;
+    url: string;
+    finalUrl: string;
+    title: string;
+    capturedAt: string;
+    durationMs: number;
+    verdict: VerdictValue;
+    counts: Report['counts'];
+    vitals: VitalsData;
+    failures: Array<{
+        budget: string;
+        expected: string;
+        actual: string;
+    }>;
+    /** `<rule>@<locator>` per finding, so a11y regressions are attributable. */
+    a11ySignatures: string[];
+    structure: StructureNode[];
+    /** Basename of the sibling PNG, when one was archived. */
+    screenshotFile?: string;
+    screenshotSize?: ImageSize;
+}
+export declare function historyRoot(): string;
+/**
+ * Directory name for a URL: readable prefix plus a hash of the full URL.
+ *
+ * The hash is what makes it correct — `?page=2` and `?page=3` must not share
+ * a history — and the prefix is what makes `ls` useful.
+ */
+export declare function historyKey(url: string): string;
+export declare function historyDirFor(url: string, root?: string): string;
+export declare function compactTimestamp(iso: string): string;
+export declare function newRunId(capturedAt: string): string;
+/** The record we persist — a Report minus the megabytes of inline base64. */
+export declare function toHistoryRun(report: Report, id: string): HistoryRun;
+/**
+ * Every run for a URL, oldest first.
+ *
+ * A file that will not parse is skipped rather than thrown: a half-written
+ * record from a killed process must not permanently break the next report.
+ */
+export declare function listRuns(dir: string): Promise<HistoryRun[]>;
+/** Delete all but the newest `max` runs, taking each one's PNG with it. */
+export declare function pruneHistory(dir: string, max: number): Promise<string[]>;
+export interface SaveRunOptions {
+    root?: string;
+    max?: number;
+    /** Fixed id, for deterministic tests. */
+    id?: string;
+}
+export interface SaveRunResult {
+    dir: string;
+    file: string;
+    run: HistoryRun;
+    pruned: string[];
+}
+/**
+ * Append this run to its URL's history and prune the tail. Callers treat a
+ * rejection as non-fatal — a read-only home directory should cost you the
+ * trend section, not the report.
+ */
+export declare function saveRun(report: Report, options?: SaveRunOptions): Promise<SaveRunResult>;
+export declare function loadRunScreenshot(dir: string, run: HistoryRun): Promise<Uint8Array | null>;
+//# sourceMappingURL=history.d.ts.map

package/dist/src/report/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/report/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7F,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAStC,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,4EAA4E;IAC5E,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,wBAAgB,WAAW,IAAI,MAAM,CAIpC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAY9C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAgB,GAAG,MAAM,CAEvE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAmBnE;AAID;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAiBjE;AAED,2EAA2E;AAC3E,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAc9E;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAOhG"}

package/dist/src/report/history.js

@@ -0,0 +1,176 @@
+/**
+ * Persistent run history for `monobrowse report` (RIG-13).
+ *
+ * Every run is appended to a per-URL directory under the monomind data dir,
+ * so the next run can say "LCP has crept up 400ms over nine runs" instead of
+ * reporting a number with no context. Deliberately not a database: one JSON
+ * file per run plus its screenshot is greppable, diffable, rsync-able, and
+ * survives this tool being uninstalled.
+ *
+ *   ~/.monomind/browser-reports/
+ *     shop.test-checkout-1f4c9a2b/
+ *       url.txt                              <- the full URL, for humans
+ *       20260921T100000Z-8f2a1c4d.json       <- HistoryRun
+ *       20260921T100000Z-8f2a1c4d.png        <- main screenshot, for the diff
+ *
+ * Set `MONOBROWSE_HISTORY_DIR` to relocate the root (the tests do).
+ */
+import { createHash, randomBytes } from 'node:crypto';
+import { mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { pngFromDataUrl } from './png.js';
+/** Runs kept per URL before the oldest are pruned. Override with --history-max. */
+export const DEFAULT_HISTORY_MAX = 20;
+/**
+ * Screenshots above this are not archived for the diff. A 30MB full-page PNG
+ * per run would turn a 20-run history into 600MB on someone's laptop, and the
+ * pixel diff is the only consumer.
+ */
+const MAX_ARCHIVED_SCREENSHOT_BYTES = 8 * 1024 * 1024;
+export function historyRoot() {
+    const override = process.env.MONOBROWSE_HISTORY_DIR;
+    if (override?.trim())
+        return override.trim();
+    return join(homedir(), '.monomind', 'browser-reports');
+}
+/**
+ * Directory name for a URL: readable prefix plus a hash of the full URL.
+ *
+ * The hash is what makes it correct — `?page=2` and `?page=3` must not share
+ * a history — and the prefix is what makes `ls` useful.
+ */
+export function historyKey(url) {
+    const hash = createHash('sha256').update(url).digest('hex').slice(0, 8);
+    let readable;
+    try {
+        const parsed = new URL(url);
+        const path = parsed.pathname.replace(/\/+$/, '').replace(/[^a-z0-9]+/gi, '-');
+        readable = `${parsed.hostname}${path}`;
+    }
+    catch {
+        readable = url.replace(/[^a-z0-9]+/gi, '-');
+    }
+    readable = readable.replace(/-+/g, '-').replace(/^-|-$/g, '').toLowerCase().slice(0, 60);
+    return `${readable || 'page'}-${hash}`;
+}
+export function historyDirFor(url, root = historyRoot()) {
+    return join(root, historyKey(url));
+}
+export function compactTimestamp(iso) {
+    return iso.replace(/[-:]/g, '').replace(/\.\d+Z$/, 'Z');
+}
+export function newRunId(capturedAt) {
+    return `${compactTimestamp(capturedAt)}-${randomBytes(4).toString('hex')}`;
+}
+/** The record we persist — a Report minus the megabytes of inline base64. */
+export function toHistoryRun(report, id) {
+    return {
+        id,
+        url: report.url,
+        finalUrl: report.finalUrl,
+        title: report.title,
+        capturedAt: report.capturedAt,
+        durationMs: report.durationMs,
+        verdict: report.verdict,
+        counts: report.counts,
+        vitals: report.vitals,
+        failures: report.failures.map((f) => ({
+            budget: String(f.budget),
+            expected: f.expected,
+            actual: f.actual,
+        })),
+        a11ySignatures: report.a11y.map((f) => `${f.rule}@${f.locator}`),
+        structure: report.structure ?? [],
+    };
+}
+const RUN_FILE = /^(\d{8}T\d{6}Z)-([0-9a-f]{8})\.json$/;
+/**
+ * Every run for a URL, oldest first.
+ *
+ * A file that will not parse is skipped rather than thrown: a half-written
+ * record from a killed process must not permanently break the next report.
+ */
+export async function listRuns(dir) {
+    let names;
+    try {
+        names = await readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    const runs = [];
+    for (const name of names.filter((n) => RUN_FILE.test(n)).sort()) {
+        try {
+            const parsed = JSON.parse(await readFile(join(dir, name), 'utf8'));
+            if (parsed && typeof parsed.capturedAt === 'string')
+                runs.push(parsed);
+        }
+        catch {
+            // Unreadable record — ignore it and carry on.
+        }
+    }
+    return runs.sort((a, b) => a.capturedAt.localeCompare(b.capturedAt));
+}
+/** Delete all but the newest `max` runs, taking each one's PNG with it. */
+export async function pruneHistory(dir, max) {
+    if (!Number.isFinite(max) || max <= 0)
+        return [];
+    const runs = await listRuns(dir);
+    if (runs.length <= max)
+        return [];
+    const doomed = runs.slice(0, runs.length - max);
+    const removed = [];
+    for (const run of doomed) {
+        for (const file of [`${run.id}.json`, run.screenshotFile]) {
+            if (!file)
+                continue;
+            await rm(join(dir, file), { force: true }).catch(() => { });
+            removed.push(file);
+        }
+    }
+    return removed;
+}
+/**
+ * Append this run to its URL's history and prune the tail. Callers treat a
+ * rejection as non-fatal — a read-only home directory should cost you the
+ * trend section, not the report.
+ */
+export async function saveRun(report, options = {}) {
+    const root = options.root ?? historyRoot();
+    const dir = join(root, historyKey(report.url));
+    await mkdir(dir, { recursive: true });
+    await writeFile(join(dir, 'url.txt'), `${report.url}\n`, 'utf8').catch(() => { });
+    const id = options.id ?? newRunId(report.capturedAt);
+    const run = toHistoryRun(report, id);
+    const main = report.screenshots.find((s) => s.label === 'page') ?? report.screenshots[0];
+    if (main?.dataUrl) {
+        try {
+            const bytes = pngFromDataUrl(main.dataUrl);
+            if (bytes.length <= MAX_ARCHIVED_SCREENSHOT_BYTES) {
+                const file = `${id}.png`;
+                await writeFile(join(dir, file), bytes);
+                run.screenshotFile = file;
+                run.screenshotSize = { width: main.width, height: main.height };
+            }
+        }
+        catch {
+            // No archived screenshot means no pixel diff next run. Not fatal.
+        }
+    }
+    const file = join(dir, `${id}.json`);
+    await writeFile(file, `${JSON.stringify(run, null, 2)}\n`, 'utf8');
+    const pruned = await pruneHistory(dir, options.max ?? DEFAULT_HISTORY_MAX);
+    return { dir, file, run, pruned };
+}
+export async function loadRunScreenshot(dir, run) {
+    if (!run.screenshotFile)
+        return null;
+    try {
+        return new Uint8Array(await readFile(join(dir, run.screenshotFile)));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/src/report/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/report/history.ts"],"names":[],"mappings":"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"}

package/dist/src/report/index.d.ts

@@ -0,0 +1,102 @@
+/**
+ * `monobrowse report <url>` — open a page, measure it, judge it against a
+ * budget, and leave behind one self-contained HTML file plus a sibling JSON.
+ *
+ * collect.ts (drive the browser) -> analyze.ts (a11y + budgets -> verdict)
+ * -> history/trend/diff (what changed since last time) -> render.ts (HTML).
+ * This module is the seam that wires them together and writes the two files.
+ */
+import type { CdpClient } from '../browser/cdp.js';
+import type { CollectOptions } from './collect.js';
+import { type FlakeReport } from './flake.js';
+import { type HistoryRun } from './history.js';
+import type { Budget, Report } from './types.js';
+export * from './a11y.js';
+export * from './analyze.js';
+export * from './budget.js';
+export * from './collect.js';
+export * from './collect-a11y.js';
+export * from './evidence.js';
+export * from './flake.js';
+export * from './history.js';
+export * from './pixel-diff.js';
+export * from './png.js';
+export * from './render.js';
+export * from './run-diff.js';
+export * from './structure.js';
+export * from './trend.js';
+export * from './types.js';
+/** Prior runs a trend is charted over. Older runs stay on disk, off the chart. */
+export declare const DEFAULT_TREND_WINDOW = 10;
+export interface RunReportOptions extends CollectOptions {
+    /** Output path: a `.html` file, or a directory to drop the default name in. */
+    out?: string;
+    /** Budget file path or inline JSON. Omitted means DEFAULT_BUDGET. */
+    budget?: string | Budget;
+    cwd?: string;
+    /** Persist this run and compare against previous ones. Default true. */
+    history?: boolean;
+    /** Runs kept per URL. Default DEFAULT_HISTORY_MAX. */
+    historyMax?: number;
+    /** Root of the history store. Default `~/.monomind/browser-reports`. */
+    historyDir?: string;
+    /** Prior runs charted. Default DEFAULT_TREND_WINDOW. */
+    trendWindow?: number;
+}
+export interface ReportResult {
+    report: Report;
+    htmlPath: string;
+    jsonPath: string;
+    summary: string;
+    /** Present when the run was saved to the history store. */
+    historyDir?: string;
+    /** Present only for a `--repeat` run (RIG-14); see RepeatResult. */
+    flake?: FlakeReport;
+}
+/**
+ * Resolve `--out` into an absolute .html path. A path that is an existing
+ * directory, or that ends in a separator, gets the generated filename
+ * appended — `--out ./reports` should not silently produce a file called
+ * `reports`.
+ */
+export declare function resolveOutPath(out: string | undefined, url: string, capturedAt: string, cwd: string): Promise<string>;
+/**
+ * The JSON sibling drops the base64 image payloads — they are megabytes of
+ * noise for anything reading this programmatically, and the HTML already
+ * carries them inline. `path` still points at the PNG on disk. The pixel
+ * diff's highlight image and the evidence frames go the same way: every
+ * measurement survives, only the pixels are dropped.
+ */
+export declare function toJsonReport(report: Report): Record<string, unknown>;
+export declare function writeReportFiles(report: Report, htmlPath: string, extras?: {
+    flake?: FlakeReport;
+}): Promise<{
+    htmlPath: string;
+    jsonPath: string;
+}>;
+/** One run: collect, judge, compare against history, write the two files. */
+export declare function runReport(client: CdpClient, sessionId: string, options: RunReportOptions): Promise<ReportResult>;
+export interface RepeatResult extends ReportResult {
+    flake: FlakeReport;
+    /** Every run, in order. `report` is the last of them. */
+    reports: Report[];
+}
+/**
+ * `--repeat N`: run the same URL N times and judge the set (RIG-14).
+ *
+ * Only the last run is written out in full — N runs' worth of inlined
+ * screenshots is not something anyone wants on disk — but the flake analysis
+ * covers all of them, and it is the flake verdict that decides the exit code.
+ * A check that passed three times and failed twice must not exit 0.
+ */
+export declare function runReportRepeated(client: CdpClient, sessionId: string, options: RunReportOptions & {
+    repeat: number;
+}): Promise<RepeatResult>;
+/** `--history <url>`: the stored runs for a URL, oldest first. */
+export declare function readHistory(url: string, options?: {
+    historyDir?: string;
+}): Promise<{
+    dir: string;
+    runs: HistoryRun[];
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/report/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/report/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAgB,KAAK,WAAW,EAAkB,MAAM,YAAY,CAAC;AAC5E,OAAO,EAEL,KAAK,UAAU,EAKhB,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,EAAE,MAAM,YAAY,CAAC;AAE9D,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAE3B,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAqBD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAajB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BpE;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE;IAAE,KAAK,CAAC,EAAE,WAAW,CAAA;CAAO,GACnC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CASjD;AAuDD,6EAA6E;AAC7E,wBAAsB,SAAS,CAC7B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,YAAY,CAAC,CAkBvB;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,KAAK,EAAE,WAAW,CAAC;IACnB,yDAAyD;IACzD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,YAAY,CAAC,CA2BvB;AAED,kEAAkE;AAClE,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CAG9C"}

package/dist/src/report/index.js

@@ -0,0 +1,216 @@
+/**
+ * `monobrowse report <url>` — open a page, measure it, judge it against a
+ * budget, and leave behind one self-contained HTML file plus a sibling JSON.
+ *
+ * collect.ts (drive the browser) -> analyze.ts (a11y + budgets -> verdict)
+ * -> history/trend/diff (what changed since last time) -> render.ts (HTML).
+ * This module is the seam that wires them together and writes the two files.
+ */
+import { mkdir, stat, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { buildReport, summarizeVerdict } from './analyze.js';
+import { loadBudget } from './budget.js';
+import { collect } from './collect.js';
+import { buildEvidence } from './evidence.js';
+import { analyzeFlake, summarizeFlake } from './flake.js';
+import { DEFAULT_HISTORY_MAX, historyDirFor, historyRoot, listRuns, saveRun, } from './history.js';
+import { renderHtml } from './render.js';
+import { buildRunDiff } from './run-diff.js';
+import { buildTrend } from './trend.js';
+export * from './a11y.js';
+export * from './analyze.js';
+export * from './budget.js';
+export * from './collect.js';
+export * from './collect-a11y.js';
+export * from './evidence.js';
+export * from './flake.js';
+export * from './history.js';
+export * from './pixel-diff.js';
+export * from './png.js';
+export * from './render.js';
+export * from './run-diff.js';
+export * from './structure.js';
+export * from './trend.js';
+export * from './types.js';
+/** Prior runs a trend is charted over. Older runs stay on disk, off the chart. */
+export const DEFAULT_TREND_WINDOW = 10;
+function slugFor(url) {
+    try {
+        const parsed = new URL(url);
+        const path = parsed.pathname.replace(/\/+$/, '').replace(/[^a-z0-9]+/gi, '-');
+        return `${parsed.hostname}${path}`.replace(/-+/g, '-').replace(/^-|-$/g, '').toLowerCase();
+    }
+    catch {
+        return (url
+            .replace(/[^a-z0-9]+/gi, '-')
+            .replace(/^-|-$/g, '')
+            .toLowerCase() || 'page');
+    }
+}
+function timestamp(iso) {
+    return iso.replace(/[-:]/g, '').replace(/\.\d+Z$/, 'Z');
+}
+/**
+ * Resolve `--out` into an absolute .html path. A path that is an existing
+ * directory, or that ends in a separator, gets the generated filename
+ * appended — `--out ./reports` should not silently produce a file called
+ * `reports`.
+ */
+export async function resolveOutPath(out, url, capturedAt, cwd) {
+    const defaultName = `monobrowse-report-${slugFor(url)}-${timestamp(capturedAt)}.html`;
+    if (!out)
+        return join(cwd, defaultName);
+    const abs = isAbsolute(out) ? out : resolve(cwd, out);
+    if (/[\\/]$/.test(out))
+        return join(abs, defaultName);
+    const isDir = await stat(abs)
+        .then((s) => s.isDirectory())
+        .catch(() => false);
+    if (isDir)
+        return join(abs, defaultName);
+    return abs.toLowerCase().endsWith('.html') || abs.toLowerCase().endsWith('.htm')
+        ? abs
+        : `${abs}.html`;
+}
+/**
+ * The JSON sibling drops the base64 image payloads — they are megabytes of
+ * noise for anything reading this programmatically, and the HTML already
+ * carries them inline. `path` still points at the PNG on disk. The pixel
+ * diff's highlight image and the evidence frames go the same way: every
+ * measurement survives, only the pixels are dropped.
+ */
+export function toJsonReport(report) {
+    const { screenshots, recording, diff, evidence, ...rest } = report;
+    void recording;
+    return {
+        ...rest,
+        screenshots: screenshots.map(({ label, width, height, path }) => ({
+            label,
+            width,
+            height,
+            path,
+        })),
+        ...(diff
+            ? {
+                diff: {
+                    ...diff,
+                    pixels: diff.pixels ? { ...diff.pixels, diffDataUrl: undefined } : undefined,
+                },
+            }
+            : {}),
+        ...(evidence
+            ? {
+                evidence: {
+                    ...evidence,
+                    frames: evidence.frames.map(({ offsetMs, bytes }) => ({ offsetMs, bytes })),
+                },
+            }
+            : {}),
+    };
+}
+export async function writeReportFiles(report, htmlPath, extras = {}) {
+    const jsonPath = `${htmlPath.replace(/\.html?$/i, '')}.json`;
+    await mkdir(dirname(htmlPath), { recursive: true });
+    await writeFile(htmlPath, renderHtml(report, extras), 'utf8');
+    const json = extras.flake
+        ? { ...toJsonReport(report), flake: extras.flake }
+        : toJsonReport(report);
+    await writeFile(jsonPath, `${JSON.stringify(json, null, 2)}\n`, 'utf8');
+    return { htmlPath, jsonPath };
+}
+/**
+ * Attach the trend and the diff, then persist the run.
+ *
+ * Order matters: history is read BEFORE the run is saved, so a run never
+ * trends or diffs against itself. A failure anywhere in here becomes a note
+ * on the report rather than an error — an unwritable home directory should
+ * cost you the trend section, not the report.
+ */
+async function applyHistory(report, options) {
+    if (options.history === false)
+        return undefined;
+    const root = options.historyDir ?? historyRoot();
+    const dir = historyDirFor(report.url, root);
+    try {
+        const previous = await listRuns(dir);
+        const window = options.trendWindow ?? DEFAULT_TREND_WINDOW;
+        report.trend = buildTrend(report, previous.slice(-window));
+        report.diff = await buildRunDiff(dir, previous.at(-1), report);
+        await saveRun(report, { root, max: options.historyMax ?? DEFAULT_HISTORY_MAX });
+        return dir;
+    }
+    catch (err) {
+        report.notes.push(`Run history unavailable (${err.message}) — no trend or diff for this run.`);
+        return undefined;
+    }
+}
+/** Turn the recorder's raw frames into the evidence block, when warranted. */
+function applyEvidence(report, data) {
+    const recording = data.recording;
+    if (!recording)
+        return;
+    if (report.verdict !== 'fail' && !recording.requested)
+        return;
+    report.evidence = buildEvidence({
+        reason: report.verdict === 'fail' ? 'budget-failure' : 'requested',
+        startedAtMs: recording.startedAtMs,
+        frames: recording.frames,
+        bufferDropped: recording.droppedFrames,
+        console: report.console,
+        pageErrors: report.pageErrors,
+        requests: report.requests,
+        failures: report.failures,
+    });
+}
+async function resolveBudget(options) {
+    return options.budget && typeof options.budget === 'object'
+        ? options.budget
+        : await loadBudget(options.budget);
+}
+/** One run: collect, judge, compare against history, write the two files. */
+export async function runReport(client, sessionId, options) {
+    const budget = await resolveBudget(options);
+    const data = await collect(client, sessionId, options);
+    const report = buildReport(data, budget);
+    applyEvidence(report, data);
+    const historyDir = await applyHistory(report, options);
+    // Working material, not report content — and megabytes of it.
+    report.recording = undefined;
+    const htmlPath = await resolveOutPath(options.out, options.url, data.capturedAt, options.cwd ?? process.cwd());
+    const paths = await writeReportFiles(report, htmlPath);
+    return { report, ...paths, summary: summarizeVerdict(report), historyDir };
+}
+/**
+ * `--repeat N`: run the same URL N times and judge the set (RIG-14).
+ *
+ * Only the last run is written out in full — N runs' worth of inlined
+ * screenshots is not something anyone wants on disk — but the flake analysis
+ * covers all of them, and it is the flake verdict that decides the exit code.
+ * A check that passed three times and failed twice must not exit 0.
+ */
+export async function runReportRepeated(client, sessionId, options) {
+    const times = Math.max(1, Math.floor(options.repeat));
+    const budget = await resolveBudget(options);
+    const reports = [];
+    for (let i = 0; i < times; i++) {
+        const data = await collect(client, sessionId, options);
+        const report = buildReport(data, budget);
+        applyEvidence(report, data);
+        report.recording = undefined;
+        reports.push(report);
+    }
+    const flake = analyzeFlake(reports);
+    const report = reports[reports.length - 1];
+    // Only the run we keep is persisted: writing N history entries for one
+    // command would let a single `--repeat 20` evict the whole trend window.
+    const historyDir = await applyHistory(report, options);
+    const htmlPath = await resolveOutPath(options.out, options.url, report.capturedAt, options.cwd ?? process.cwd());
+    const paths = await writeReportFiles(report, htmlPath, { flake });
+    return { report, reports, flake, ...paths, summary: summarizeFlake(flake), historyDir };
+}
+/** `--history <url>`: the stored runs for a URL, oldest first. */
+export async function readHistory(url, options = {}) {
+    const dir = historyDirFor(url, options.historyDir ?? historyRoot());
+    return { dir, runs: await listRuns(dir) };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/report/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/report/index.ts"],"names":[],"mappings":"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"}

package/dist/src/report/pixel-diff.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Pixel diff between two screenshots (RIG-10), with no image dependency —
+ * png.ts decodes and re-encodes using node's own zlib.
+ *
+ * Two design choices worth stating:
+ *
+ *  - A per-channel tolerance, not exact equality. Chrome's rasteriser is not
+ *    bit-deterministic across runs (font hinting, GPU vs. software paths), so
+ *    an exact compare reports 4% of every screenshot as "changed" and the
+ *    number becomes noise nobody reads.
+ *  - Differing dimensions are a result, not an error. A page that grew 200px
+ *    taller is exactly the regression this is for, so we compare the
+ *    overlapping region, count the rest as changed, and say so.
+ */
+import type { PixelDiff } from './types.js';
+export interface PixelDiffOptions {
+    threshold?: number;
+    maxPixels?: number;
+    /** Set false to skip building the highlight image (counts only). */
+    renderImage?: boolean;
+}
+/**
+ * Compare two PNGs. Never throws for image-shaped reasons — an undecodable
+ * screenshot produces a result carrying `note` and no counts, because a
+ * report that renders minus one section beats a report that fails to build.
+ */
+export declare function pixelDiff(previousPng: Uint8Array, currentPng: Uint8Array, options?: PixelDiffOptions): PixelDiff;
+/** One line for a CI log. */
+export declare function summarizePixelDiff(diff: PixelDiff): string;
+//# sourceMappingURL=pixel-diff.d.ts.map

package/dist/src/report/pixel-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-diff.d.ts","sourceRoot":"","sources":["../../../src/report/pixel-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAW5C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAwED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,UAAU,EACvB,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAwEX;AAED,6BAA6B;AAC7B,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAQ1D"}