@monoes/monobrowse 1.0.12 → 1.0.13

package/dist/src/__tests__/report-run.test.js

@@ -0,0 +1,234 @@
+/**
+ * The orchestration seam in report/index.ts: history is read before the run
+ * is saved, evidence is only built when it is warranted, and `--repeat`
+ * judges the set rather than the last run.
+ *
+ * `collect` is mocked, so nothing here launches Chrome. Output and history
+ * both go to a scratch directory under the monomind data dir — never the
+ * shared /tmp.
+ */
+import { mkdir, mkdtemp, readdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { historyKey, listRuns } from '../report/history.js';
+import { encodePng, pngToDataUrl } from '../report/png.js';
+const collect = vi.hoisted(() => vi.fn());
+vi.mock('../report/collect.js', () => ({ collect }));
+const { runReport, runReportRepeated, readHistory } = await import('../report/index.js');
+const URL_UNDER_TEST = 'https://shop.test/checkout';
+const client = {};
+function shot(shade, width = 8, height = 8) {
+    const data = new Uint8Array(width * height * 4);
+    for (let i = 0; i < width * height; i++)
+        data.set([shade, shade, shade, 255], i * 4);
+    return {
+        label: 'page',
+        width,
+        height,
+        dataUrl: pngToDataUrl(encodePng({ width, height, data })),
+    };
+}
+function capture(partial = {}) {
+    return {
+        url: URL_UNDER_TEST,
+        finalUrl: URL_UNDER_TEST,
+        title: 'Checkout',
+        capturedAt: '2026-09-21T10:00:00.000Z',
+        durationMs: 1000,
+        console: [],
+        pageErrors: [],
+        requests: [],
+        vitals: { lcp: 2000, cls: 0.01, inp: 50 },
+        a11y: [],
+        structure: [{ path: '/main[1]/button[1]', role: 'button', name: 'Pay now', depth: 1 }],
+        screenshots: [shot(200)],
+        notes: [],
+        ...partial,
+    };
+}
+let root;
+let outDir;
+beforeEach(async () => {
+    await mkdir(join(homedir(), '.monomind'), { recursive: true });
+    root = await mkdtemp(join(homedir(), '.monomind', 'monobrowse-run-test-'));
+    outDir = join(root, 'out');
+    await mkdir(outDir, { recursive: true });
+    collect.mockReset();
+});
+afterEach(async () => {
+    await rm(root, { recursive: true, force: true });
+});
+const run = (data, extra = {}) => {
+    collect.mockResolvedValueOnce(data);
+    return runReport(client, 'S1', {
+        url: URL_UNDER_TEST,
+        out: join(outDir, `${Math.random().toString(36).slice(2)}.html`),
+        historyDir: root,
+        cwd: outDir,
+        ...extra,
+    });
+};
+describe('runReport and history', () => {
+    it('does not let the first run trend or diff against itself', async () => {
+        const result = await run(capture());
+        expect(result.report.trend?.runs).toBe(0);
+        expect(result.report.diff).toBeUndefined();
+        // ...but it is on disk for the next run to compare against.
+        expect((await listRuns(join(root, historyKey(URL_UNDER_TEST)))).length).toBe(1);
+    });
+    it('trends and diffs the second run against the first', async () => {
+        await run(capture());
+        const second = await run(capture({
+            capturedAt: '2026-09-21T11:00:00.000Z',
+            vitals: { lcp: 2600, cls: 0.01, inp: 50 },
+            structure: [{ path: '/main[1]/button[1]', role: 'button', name: 'Place order', depth: 1 }],
+            screenshots: [shot(40)],
+        }));
+        expect(second.report.trend?.runs).toBe(1);
+        const lcp = second.report.trend?.series.find((s) => s.key === 'lcp');
+        expect(lcp).toMatchObject({ previous: 2000, current: 2600, direction: 'regressed' });
+        expect(second.report.diff?.previousCapturedAt).toBe('2026-09-21T10:00:00.000Z');
+        expect(second.report.diff?.structure?.renamed).toEqual([
+            { path: '/main[1]/button[1]', role: 'button', from: 'Pay now', to: 'Place order' },
+        ]);
+        // Every pixel went from light grey to dark — a whole-screenshot change.
+        expect(second.report.diff?.pixels?.changedPercent).toBe(100);
+    });
+    it('reports the history directory it wrote to', async () => {
+        const result = await run(capture());
+        expect(result.historyDir).toBe(join(root, historyKey(URL_UNDER_TEST)));
+    });
+    it('prunes to the configured maximum across runs', async () => {
+        for (let i = 0; i < 4; i++) {
+            await run(capture({ capturedAt: `2026-09-2${i + 1}T10:00:00.000Z` }), { historyMax: 2 });
+        }
+        const runs = await listRuns(join(root, historyKey(URL_UNDER_TEST)));
+        expect(runs.map((r) => r.capturedAt)).toEqual([
+            '2026-09-23T10:00:00.000Z',
+            '2026-09-24T10:00:00.000Z',
+        ]);
+    });
+    it('writes nothing to the store when history is off, and says nothing about trends', async () => {
+        const result = await run(capture(), { history: false });
+        expect(result.report.trend).toBeUndefined();
+        expect(result.historyDir).toBeUndefined();
+        await expect(readdir(join(root, historyKey(URL_UNDER_TEST)))).rejects.toThrow();
+    });
+    it('keeps the report when the history store cannot be written', async () => {
+        // A regular file where the store's directory needs to be: mkdir fails
+        // with ENOTDIR, and the report still has to come out.
+        const blocked = join(root, 'blocked-store');
+        await writeFile(blocked, 'not a directory', 'utf8');
+        const result = await run(capture(), { historyDir: blocked });
+        expect(result.report.verdict).toBe('pass');
+        expect(result.report.notes.join(' ')).toMatch(/Run history unavailable/);
+        expect(result.historyDir).toBeUndefined();
+    });
+    it('exposes the stored runs through readHistory', async () => {
+        await run(capture());
+        const { runs } = await readHistory(URL_UNDER_TEST, { historyDir: root });
+        expect(runs.length).toBe(1);
+        expect(runs[0]).toMatchObject({ url: URL_UNDER_TEST, verdict: 'pass' });
+    });
+});
+describe('runReport and evidence', () => {
+    const recording = {
+        startedAtMs: 1_000_000,
+        frames: [
+            { offsetMs: 0, data: 'AAAA', bytes: 4 },
+            { offsetMs: 900, data: 'BBBB', bytes: 4 },
+        ],
+        droppedFrames: 0,
+        requested: false,
+    };
+    it('attaches evidence when the run breaches its budget', async () => {
+        const result = await run(capture({
+            recording,
+            console: [{ type: 'error', text: 'boom', timestamp: 1_000_800 }],
+        }));
+        expect(result.report.verdict).toBe('fail');
+        expect(result.report.evidence?.reason).toBe('budget-failure');
+        expect(result.report.evidence?.focusOffsetMs).toBe(800);
+        expect(result.report.evidence?.frames.length).toBe(2);
+    });
+    it('does not attach evidence to a passing run that did not ask for it', async () => {
+        const result = await run(capture({ recording }));
+        expect(result.report.verdict).toBe('pass');
+        expect(result.report.evidence).toBeUndefined();
+    });
+    it('attaches evidence to a passing run when --record asked for it', async () => {
+        const result = await run(capture({ recording: { ...recording, requested: true } }));
+        expect(result.report.evidence?.reason).toBe('requested');
+    });
+    it('never leaves the raw recording on the report it returns', async () => {
+        const result = await run(capture({ recording: { ...recording, requested: true } }));
+        expect(result.report.recording).toBeUndefined();
+    });
+    it('keeps the frame images out of the JSON sibling', async () => {
+        const result = await run(capture({ recording: { ...recording, requested: true } }));
+        const json = JSON.parse(await readFile(result.jsonPath, 'utf8'));
+        expect(json.evidence.frames).toEqual([
+            { offsetMs: 0, bytes: 4 },
+            { offsetMs: 900, bytes: 4 },
+        ]);
+    });
+});
+describe('runReportRepeated', () => {
+    const failing = capture({ console: [{ type: 'error', text: 'boom', timestamp: 0 }] });
+    it('runs the URL N times and judges the set', async () => {
+        for (const data of [capture(), failing, capture()])
+            collect.mockResolvedValueOnce(data);
+        const result = await runReportRepeated(client, 'S1', {
+            url: URL_UNDER_TEST,
+            out: join(outDir, 'repeat.html'),
+            historyDir: root,
+            cwd: outDir,
+            repeat: 3,
+        });
+        expect(collect).toHaveBeenCalledTimes(3);
+        expect(result.reports.length).toBe(3);
+        expect(result.flake.verdict).toBe('flaky');
+        expect(result.summary).toMatch(/^FLAKY/);
+    });
+    it('refuses to call a sometimes-failing URL a pass, even when the last run is green', async () => {
+        for (const data of [failing, capture()])
+            collect.mockResolvedValueOnce(data);
+        const result = await runReportRepeated(client, 'S1', {
+            url: URL_UNDER_TEST,
+            out: join(outDir, 'repeat2.html'),
+            historyDir: root,
+            cwd: outDir,
+            repeat: 2,
+        });
+        expect(result.report.verdict).toBe('pass'); // the last run alone
+        expect(result.flake.verdict).toBe('flaky'); // what the command reports
+    });
+    it('writes one history entry for the whole command, not one per run', async () => {
+        for (const data of [capture(), capture(), capture()])
+            collect.mockResolvedValueOnce(data);
+        await runReportRepeated(client, 'S1', {
+            url: URL_UNDER_TEST,
+            out: join(outDir, 'repeat3.html'),
+            historyDir: root,
+            cwd: outDir,
+            repeat: 3,
+        });
+        expect((await listRuns(join(root, historyKey(URL_UNDER_TEST)))).length).toBe(1);
+    });
+    it('puts the flake analysis in the JSON sibling', async () => {
+        for (const data of [capture(), failing])
+            collect.mockResolvedValueOnce(data);
+        const result = await runReportRepeated(client, 'S1', {
+            url: URL_UNDER_TEST,
+            out: join(outDir, 'repeat4.html'),
+            historyDir: root,
+            cwd: outDir,
+            repeat: 2,
+        });
+        const json = JSON.parse(await readFile(result.jsonPath, 'utf8'));
+        expect(json.flake.verdict).toBe('flaky');
+        expect(json.flake.runs).toBe(2);
+    });
+});
+//# sourceMappingURL=report-run.test.js.map

package/dist/src/__tests__/report-run.test.js.map

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

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

@@ -1,3 +1,4 @@
+export * from '../report/index.js';
 export * from './actions.js';
 export * from './batch.js';
 export * from './browser.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/src/browser/index.js

@@ -1,3 +1,4 @@
+export * from '../report/index.js';
 export * from './actions.js';
 export * from './batch.js';
 export * from './browser.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/src/browser/profiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../../../src/browser/profiler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAKD,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CA4CjB"}
+{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../../../src/browser/profiler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAgDjB"}

package/dist/src/browser/profiler.js

@@ -1,6 +1,8 @@
 import { writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
+/** Heap snapshots on a large page take far longer than the 30s CDP default. */
+const HEAP_SNAPSHOT_TIMEOUT_MS = 120_000;
 const _sessions = new Set();
 const _heapSessions = new Set();
 export async function startCpuProfile(client, sessionId, options = {}) {
@@ -47,34 +49,29 @@ export async function startHeapSnapshot(client, sessionId, outputPath) {
         chunks.push(params.chunk);
     });
     try {
-        await new Promise((resolve, reject) => {
-            const timeoutHandle = setTimeout(() => {
-                off2();
-                reject(new Error('Timeout waiting for heap snapshot (120s)'));
-            }, 120_000);
-            const off2 = client.on('HeapProfiler.reportHeapSnapshotProgress', (params, sid) => {
-                if (sid !== sessionId)
-                    return;
-                if (params.finished) {
-                    clearTimeout(timeoutHandle);
-                    off2();
-                    resolve();
-                }
-            });
-            client
-                .send('HeapProfiler.takeHeapSnapshot', { reportProgress: true }, sessionId)
-                .catch((err) => {
-                clearTimeout(timeoutHandle);
-                off2();
-                reject(err);
-            });
-        });
+        // Resolve on takeHeapSnapshot's own RESPONSE, not on
+        // `HeapProfiler.reportHeapSnapshotProgress` with finished:true. Chrome
+        // emits that progress event once it has finished WALKING the heap, which
+        // is before it has streamed a single addHeapSnapshotChunk (verified
+        // against Chrome 153) — so resolving there detached the chunk listener in
+        // the `finally` below and wrote a 0-byte snapshot every single time. The
+        // command response is the only signal that every chunk has been sent.
+        //
+        // reportProgress is off for the same reason: nothing consumes those
+        // events any more, and they are pure noise on the wire.
+        await client.send('HeapProfiler.takeHeapSnapshot', { reportProgress: false }, sessionId, HEAP_SNAPSHOT_TIMEOUT_MS);
     }
     finally {
         off();
         _heapSessions.delete(sessionId);
         await client.send('HeapProfiler.disable', {}, sessionId).catch(() => { });
     }
+    // A zero-chunk snapshot is not a snapshot. Writing the empty file anyway is
+    // how this bug stayed invisible — the caller got a path, and only noticed
+    // when DevTools refused to load it.
+    if (chunks.length === 0) {
+        throw new Error('Heap snapshot produced no data — Chrome accepted HeapProfiler.takeHeapSnapshot but sent no chunks');
+    }
     const path = outputPath ?? join(tmpdir(), `monomind-heap-${Date.now()}.heapsnapshot`);
     await writeFile(path, chunks.join(''));
     return path;

package/dist/src/browser/profiler.js.map

@@ -1 +1 @@
-{"version":3,"file":"profiler.js","sourceRoot":"","sources":["../../../src/browser/profiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;AACpC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAiB,EACjB,SAAiB,EACjB,OAAO,GAAoB,EAAE;IAE7B,IAAI,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;IACpD,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,MAAM,CAAC,IAAI,CACf,8BAA8B,EAC9B,EAAE,QAAQ,EAAE,OAAO,CAAC,gBAAgB,EAAE,EACtC,SAAS,CACV,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;IACnD,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAiB,EACjB,SAAiB,EACjB,UAAmB;IAEnB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,MAA4B,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAuB,eAAe,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;IACnF,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,sFAAsF;IACtF,MAAM,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAErE,MAAM,IAAI,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACvF,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAiB,EACjB,SAAiB,EACjB,UAAmB;IAEnB,IAAI,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;IAExD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,mCAAmC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QACzE,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO;QAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBACpC,IAAI,EAAE,CAAC;gBACP,MAAM,CAAC,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC,CAAC;YAChE,CAAC,EAAE,OAAO,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,yCAAyC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;gBAChF,IAAI,GAAG,KAAK,SAAS;oBAAE,OAAO;gBAC9B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACpB,YAAY,CAAC,aAAa,CAAC,CAAC;oBAC5B,IAAI,EAAE,CAAC;oBACP,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;YACH,MAAM;iBACH,IAAI,CAAC,+BAA+B,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,SAAS,CAAC;iBAC1E,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACb,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,IAAI,EAAE,CAAC;gBACP,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,GAAG,EAAE,CAAC;QACN,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACtF,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"profiler.js","sourceRoot":"","sources":["../../../src/browser/profiler.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,YAAY,CAAC;AAqoGzE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GACrE;IACD,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAUP;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CA4BA;AA4fD,QAAA,MAAM,aAAa,EAAE,OAyJpB,CAAC;eAEa,aAAa"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,YAAY,CAAC;AA+4GzE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GACrE;IACD,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAUP;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CA4BA;AA4fD,QAAA,MAAM,aAAa,EAAE,OA+JpB,CAAC;eAEa,aAAa"}

package/dist/src/cli/commands.js

@@ -1537,6 +1537,254 @@ const evalCommand = {
         return { success: true, data: { result } };
     },
 };
+const reportCommand = {
+    name: 'report',
+    description: 'Test a page and write one self-contained HTML report + sibling JSON. Usage: monomind browse report <url>',
+    options: [
+        { name: 'out', short: 'o', type: 'string', description: 'Output .html path, or a directory' },
+        {
+            name: 'budget',
+            short: 'b',
+            type: 'string',
+            description: 'Budget JSON file path, or inline JSON',
+        },
+        {
+            name: 'devices',
+            short: 'd',
+            type: 'string',
+            description: 'Comma-separated device names for the screenshot matrix',
+        },
+        {
+            name: 'wait',
+            short: 'w',
+            type: 'string',
+            description: 'Extra settle step: a CSS selector to wait for, or milliseconds',
+        },
+        { name: 'json', type: 'boolean', description: 'Output as JSON', default: false },
+        {
+            name: 'full-page',
+            type: 'boolean',
+            description: 'Full-page screenshot (--no-full-page for viewport only)',
+            default: true,
+        },
+        {
+            name: 'vitals-wait',
+            type: 'number',
+            description: 'Milliseconds to let the web-vitals observers run',
+            default: 2500,
+        },
+        {
+            name: 'timeout',
+            type: 'number',
+            description: 'Milliseconds to wait for the page to go network-idle',
+            default: 20000,
+        },
+        {
+            name: 'keep-open',
+            type: 'boolean',
+            description: 'Leave the browser running after the report',
+            default: false,
+        },
+        {
+            name: 'repeat',
+            type: 'number',
+            description: 'Run the URL N times and report per-check flake rates (RIG-14)',
+        },
+        {
+            name: 'record',
+            type: 'boolean',
+            description: 'Record frames for the evidence timeline even when the run passes',
+            default: false,
+        },
+        {
+            name: 'history',
+            type: 'boolean',
+            description: 'Print the stored run history for this URL instead of running it',
+            default: false,
+        },
+        {
+            name: 'save',
+            type: 'boolean',
+            description: 'Save this run to the history store (--no-save to skip)',
+            default: true,
+        },
+        {
+            name: 'history-max',
+            type: 'number',
+            description: 'Runs kept per URL before the oldest are pruned (default 20)',
+        },
+        {
+            name: 'trend-window',
+            type: 'number',
+            description: 'Prior runs charted in the trend section (default 10)',
+        },
+    ],
+    examples: [
+        { command: 'monomind browse report https://example.com', description: 'Report with defaults' },
+        {
+            command: 'monomind browse report https://example.com --repeat 5',
+            description: 'Run five times and report flake rates',
+        },
+        {
+            command: 'monomind browse report https://example.com --history',
+            description: 'Show the stored run history for a URL',
+        },
+        {
+            command: 'monomind browse report https://example.com --record',
+            description: 'Attach a frame-by-frame evidence timeline',
+        },
+        {
+            command: 'monomind browse report https://example.com --out ./reports/home.html',
+            description: 'Choose the output path',
+        },
+        {
+            command: 'monomind browse report https://example.com --budget \'{"lcp":4000}\'',
+            description: 'Relax a budget inline',
+        },
+        {
+            command: 'monomind browse report https://example.com --devices "iPhone 14,iPad"',
+            description: 'Add a device screenshot matrix',
+        },
+    ],
+    action: async (ctx) => {
+        const url = ctx.args[0];
+        if (!url)
+            throw new Error('URL required. Usage: monomind browse report <url>');
+        // Imported lazily for the same reason getBrowser() is: this module loads
+        // on every CLI invocation, and nothing but `report` needs the renderer.
+        const { runReport, runReportRepeated, readHistory } = await import('../report/index.js');
+        // --history is a read of the store, so it deliberately never launches a
+        // browser — `report --history` must work offline and on a dead site.
+        if (ctx.flags.history) {
+            const { dir, runs } = await readHistory(url);
+            if (ctx.flags.json) {
+                print(JSON.stringify({ data: { dir, runs } }, null, 2));
+            }
+            else if (!runs.length) {
+                output.printWarning(`No stored runs for ${url}`);
+                print(`Looked in: ${dir}`);
+            }
+            else {
+                print(`${runs.length} run(s) for ${url}`);
+                print(`Stored in: ${dir}`);
+                for (const run of runs) {
+                    const lcp = run.vitals.lcp === undefined ? '—' : `${Math.round(run.vitals.lcp)}ms`;
+                    print(`  ${run.capturedAt}  ${run.verdict.toUpperCase().padEnd(4)}  ` +
+                        `LCP ${lcp.padStart(7)}  ${run.counts.consoleErrors} console errors  ` +
+                        `${run.counts.failedRequests} failed requests  ${run.counts.a11yErrors} a11y errors`);
+                }
+            }
+            return { success: true, data: { dir, runs } };
+        }
+        const repeatRaw = ctx.flags.repeat;
+        const repeat = typeof repeatRaw === 'number' && Number.isFinite(repeatRaw) && repeatRaw > 1
+            ? Math.floor(repeatRaw)
+            : undefined;
+        const { client, sessionId } = await ensureConnected(_port);
+        const browser = await getBrowser();
+        const rawDevices = ctx.flags.devices;
+        const devices = typeof rawDevices === 'string'
+            ? rawDevices
+                .split(',')
+                .map((d) => d.trim())
+                .filter(Boolean)
+            : undefined;
+        const runOptions = {
+            url,
+            out: ctx.flags.out,
+            budget: ctx.flags.budget,
+            devices,
+            wait: ctx.flags.wait,
+            vitalsWaitMs: ctx.flags['vitals-wait'],
+            loadTimeoutMs: ctx.flags.timeout,
+            fullPage: ctx.flags['full-page'] !== false,
+            cwd: ctx.cwd,
+            // A failing run records its own evidence without being asked; --record
+            // is for when you want the timeline from a run that passes.
+            record: ctx.flags.record === true,
+            history: ctx.flags.save !== false,
+            historyMax: ctx.flags['history-max'],
+            trendWindow: ctx.flags['trend-window'],
+        };
+        let result;
+        try {
+            result = repeat
+                ? await runReportRepeated(client, sessionId, { ...runOptions, repeat })
+                : await runReport(client, sessionId, runOptions);
+        }
+        finally {
+            // A report is a one-shot command — CI should not be left with an
+            // orphan Chrome. Only close a browser THIS process launched: an
+            // attached one belongs to the user's own `open`/`connect` session.
+            if (!ctx.flags['keep-open'] && browser.getLaunchedPid(_port) !== undefined) {
+                browser.stopRequestCapture(sessionId);
+                browser.teardownConsoleCapture(sessionId);
+                try {
+                    await browser.closeBrowser(client, _port);
+                }
+                catch {
+                    /* best-effort */
+                }
+                _client = null;
+                _sessionId = '';
+                _targetId = '';
+                _refs = new Map();
+                await browser.clearActivePort();
+                await browser.clearRefCache();
+            }
+        }
+        const { report, htmlPath, jsonPath, summary, historyDir } = result;
+        const { flake } = result;
+        // With --repeat the flake verdict governs: a check that failed 2 of 5
+        // runs must not exit 0 just because the last run happened to be green.
+        const passed = flake ? flake.verdict === 'pass' : report.verdict === 'pass';
+        if (ctx.flags.json) {
+            const { toJsonReport } = await import('../report/index.js');
+            print(JSON.stringify({ data: { ...toJsonReport(report), flake, htmlPath, jsonPath, historyDir } }, null, 2));
+        }
+        else {
+            if (passed)
+                output.printSuccess(summary);
+            else
+                output.printError(summary);
+            if (flake) {
+                print(`    ${flake.confidenceNote}`);
+                for (const check of flake.checks.filter((c) => !c.stable)) {
+                    print(`    ${check.label}: failed ${check.failed} of ${check.runs} runs`);
+                }
+                for (const signal of flake.signals.slice(0, 5)) {
+                    print(`    ${signal.kind} "${signal.signature}" in ${signal.runs} of ${signal.total} runs`);
+                }
+            }
+            for (const failure of report.failures) {
+                print(`    ${failure.budget}: expected ${failure.expected}, got ${failure.actual}`);
+                if (failure.detail)
+                    print(`      ${failure.detail}`);
+            }
+            for (const headline of report.trend?.headlines ?? [])
+                output.printWarning(headline);
+            if (report.diff?.structure) {
+                const d = report.diff.structure;
+                print(`    vs previous run: ${d.gained.length} gained, ${d.lost.length} lost, ${d.renamed.length} renamed`);
+            }
+            if (report.diff?.pixels?.comparable) {
+                print(`    vs previous run: ${report.diff.pixels.changedPercent.toFixed(2)}% of pixels changed`);
+            }
+            for (const note of report.notes)
+                output.printWarning(note);
+            print(`Report: ${htmlPath}`);
+            print(`JSON:   ${jsonPath}`);
+            if (historyDir)
+                print(`History: ${historyDir}`);
+        }
+        // Non-zero exit is the point of RIG-06 — CI and agents gate on it.
+        return {
+            success: passed,
+            exitCode: passed ? 0 : 1,
+            data: { htmlPath, jsonPath, report, flake },
+        };
+    },
+};
 const closeCommand = {
     name: 'close',
     description: 'Close the active browser session',
@@ -3579,6 +3827,7 @@ const browseCommand = {
         traceCommand,
         profilerCommand,
         vitalsCommand,
+        reportCommand,
         harCommand,
         resizeCommand,
         closeCommand,
@@ -3612,6 +3861,10 @@ const browseCommand = {
             command: 'monomind browse network route --pattern "https://api.*" --abort',
             description: 'Abort API calls',
         },
+        {
+            command: 'monomind browse report https://example.com',
+            description: 'One-command page report with a pass/fail verdict',
+        },
         { command: 'monomind browse close', description: 'Close browser session' },
     ],
     action: async (_ctx) => {
@@ -3668,6 +3921,7 @@ const browseCommand = {
         output.printInfo('  batch          Execute multiple commands');
         output.printInfo('  addinitscript  Add script to run before page navigation');
         output.printInfo('  removeinitscript Remove a previously added init script');
+        output.printInfo('  report         Test a page and write an HTML report');
         output.printInfo('  close          Close the browser session');
         return { success: true };
     },