pursr 0.5.0 → 0.7.0

package/assets/icon.svg

@@ -1,21 +1,21 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-label="pursr icon">
-  <defs>
-    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0" stop-color="#FF2EA6"/>
-      <stop offset="1" stop-color="#FF5CC1"/>
-    </linearGradient>
-  </defs>
-  <rect width="128" height="128" rx="24" fill="#0B0B0F"/>
-  <g transform="translate(8,8)">
-    <circle cx="56" cy="56" r="42" fill="none" stroke="url(#g)" stroke-width="7"/>
-    <g fill="none" stroke="url(#g)" stroke-width="7" stroke-linecap="round">
-      <path d="M56 22 L72 44"/>
-      <path d="M87 41 L74 59"/>
-      <path d="M87 75 L66 67"/>
-      <path d="M56 90 L46 69"/>
-      <path d="M25 75 L38 66"/>
-      <path d="M25 41 L39 51"/>
-    </g>
-    <path d="M56 28 L72 70 L60 66 L52 80 L48 70 L56 28 Z" fill="url(#g)"/>
-  </g>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-label="pursr icon">
+  <defs>
+    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#FF2EA6"/>
+      <stop offset="1" stop-color="#FF5CC1"/>
+    </linearGradient>
+  </defs>
+  <rect width="128" height="128" rx="24" fill="#0B0B0F"/>
+  <g transform="translate(8,8)">
+    <circle cx="56" cy="56" r="42" fill="none" stroke="url(#g)" stroke-width="7"/>
+    <g fill="none" stroke="url(#g)" stroke-width="7" stroke-linecap="round">
+      <path d="M56 22 L72 44"/>
+      <path d="M87 41 L74 59"/>
+      <path d="M87 75 L66 67"/>
+      <path d="M56 90 L46 69"/>
+      <path d="M25 75 L38 66"/>
+      <path d="M25 41 L39 51"/>
+    </g>
+    <path d="M56 28 L72 70 L60 66 L52 80 L48 70 L56 28 Z" fill="url(#g)"/>
+  </g>
 </svg>

package/assets/logo.svg

@@ -1,29 +1,29 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 96" role="img" aria-label="pursr">
-  <defs>
-    <linearGradient id="pursr-mark-grad" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0" stop-color="#FF2EA6"/>
-      <stop offset="1" stop-color="#FF5CC1"/>
-    </linearGradient>
-  </defs>
-  <!-- Mark: cursor arrowhead fused with camera aperture / lens iris -->
-  <g transform="translate(8,8)">
-    <!-- Outer iris ring -->
-    <circle cx="40" cy="40" r="34" fill="none" stroke="url(#pursr-mark-grad)" stroke-width="6"/>
-    <!-- Aperture blades (6) -->
-    <g fill="none" stroke="url(#pursr-mark-grad)" stroke-width="6" stroke-linecap="round">
-      <path d="M40 12 L52 30"/>
-      <path d="M64.4 25.6 L54.5 40"/>
-      <path d="M64.4 54.4 L48 48"/>
-      <path d="M40 68 L32 50"/>
-      <path d="M15.6 54.4 L26 47"/>
-      <path d="M15.6 25.6 L27 34"/>
-    </g>
-    <!-- Cursor chevron pointer on top of iris -->
-    <path d="M40 18 L52 50 L42 47 L36 58 L33 50 L40 18 Z" fill="url(#pursr-mark-grad)"/>
-  </g>
-  <!-- Wordmark: pursr -->
-  <g transform="translate(108,62)" font-family="-apple-system,BlinkMacSystemFont,Inter,Segoe UI,Roboto,sans-serif" font-weight="700" font-size="56" letter-spacing="-2">
-    <text fill="#0B0B0F" x="0" y="0">pursr</text>
-    <rect x="170" y="-12" width="10" height="10" fill="#FF2EA6"/>
-  </g>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 96" role="img" aria-label="pursr">
+  <defs>
+    <linearGradient id="pursr-mark-grad" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#FF2EA6"/>
+      <stop offset="1" stop-color="#FF5CC1"/>
+    </linearGradient>
+  </defs>
+  <!-- Mark: cursor arrowhead fused with camera aperture / lens iris -->
+  <g transform="translate(8,8)">
+    <!-- Outer iris ring -->
+    <circle cx="40" cy="40" r="34" fill="none" stroke="url(#pursr-mark-grad)" stroke-width="6"/>
+    <!-- Aperture blades (6) -->
+    <g fill="none" stroke="url(#pursr-mark-grad)" stroke-width="6" stroke-linecap="round">
+      <path d="M40 12 L52 30"/>
+      <path d="M64.4 25.6 L54.5 40"/>
+      <path d="M64.4 54.4 L48 48"/>
+      <path d="M40 68 L32 50"/>
+      <path d="M15.6 54.4 L26 47"/>
+      <path d="M15.6 25.6 L27 34"/>
+    </g>
+    <!-- Cursor chevron pointer on top of iris -->
+    <path d="M40 18 L52 50 L42 47 L36 58 L33 50 L40 18 Z" fill="url(#pursr-mark-grad)"/>
+  </g>
+  <!-- Wordmark: pursr -->
+  <g transform="translate(108,62)" font-family="-apple-system,BlinkMacSystemFont,Inter,Segoe UI,Roboto,sans-serif" font-weight="700" font-size="56" letter-spacing="-2">
+    <text fill="#0B0B0F" x="0" y="0">pursr</text>
+    <rect x="170" y="-12" width="10" height="10" fill="#FF2EA6"/>
+  </g>
 </svg>

package/assets/social-preview.svg

@@ -1,77 +1,77 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1280 640" role="img" aria-label="pursr — visual QA, audit, and MCP for the browser">
-  <defs>
-    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0" stop-color="#0B0B0F"/>
-      <stop offset="0.6" stop-color="#15101A"/>
-      <stop offset="1" stop-color="#1F0A1A"/>
-    </linearGradient>
-    <linearGradient id="mark" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0" stop-color="#FF2EA6"/>
-      <stop offset="1" stop-color="#FF5CC1"/>
-    </linearGradient>
-    <pattern id="grid" width="48" height="48" patternUnits="userSpaceOnUse">
-      <path d="M48 0 L0 0 0 48" fill="none" stroke="#FF2EA6" stroke-opacity="0.08" stroke-width="1"/>
-    </pattern>
-    <radialGradient id="glow" cx="0.85" cy="0.15" r="0.6">
-      <stop offset="0" stop-color="#FF2EA6" stop-opacity="0.35"/>
-      <stop offset="1" stop-color="#FF2EA6" stop-opacity="0"/>
-    </radialGradient>
-  </defs>
-  <rect width="1280" height="640" fill="url(#bg)"/>
-  <rect width="1280" height="640" fill="url(#grid)"/>
-  <rect width="1280" height="640" fill="url(#glow)"/>
-
-  <!-- Decorative screenshot card on the right -->
-  <g transform="translate(720,160)">
-    <rect width="440" height="320" rx="16" fill="#101015" stroke="#2A2A30"/>
-    <rect x="0" y="0" width="440" height="40" rx="16" fill="#1B1B22"/>
-    <circle cx="20" cy="20" r="6" fill="#FF5F56"/>
-    <circle cx="40" cy="20" r="6" fill="#FFBD2E"/>
-    <circle cx="60" cy="20" r="6" fill="#27C93F"/>
-    <text x="220" y="25" fill="#666" font-family="monospace" font-size="12" text-anchor="middle">pursor.mjs shoot</text>
-    <line x1="20" y1="80" x2="200" y2="80" stroke="#FF2EA6" stroke-width="14" stroke-linecap="round"/>
-    <line x1="20" y1="120" x2="380" y2="120" stroke="#3A3A45" stroke-width="8" stroke-linecap="round"/>
-    <line x1="20" y1="160" x2="320" y2="160" stroke="#3A3A45" stroke-width="8" stroke-linecap="round"/>
-    <line x1="20" y1="200" x2="260" y2="200" stroke="#3A3A45" stroke-width="8" stroke-linecap="round"/>
-    <rect x="20" y="240" width="120" height="48" rx="6" fill="#FF2EA6"/>
-    <line x1="160" y1="264" x2="220" y2="264" stroke="#3A3A45" stroke-width="6" stroke-linecap="round"/>
-    <line x1="240" y1="252" x2="380" y2="252" stroke="#3A3A45" stroke-width="6" stroke-linecap="round"/>
-    <line x1="240" y1="276" x2="340" y2="276" stroke="#3A3A45" stroke-width="6" stroke-linecap="round"/>
-  </g>
-
-  <!-- Brand mark + wordmark on the left -->
-  <g transform="translate(80,200)">
-    <g transform="scale(1.5)">
-      <circle cx="40" cy="40" r="34" fill="none" stroke="url(#mark)" stroke-width="6"/>
-      <g fill="none" stroke="url(#mark)" stroke-width="6" stroke-linecap="round">
-        <path d="M40 12 L52 30"/>
-        <path d="M64.4 25.6 L54.5 40"/>
-        <path d="M64.4 54.4 L48 48"/>
-        <path d="M40 68 L32 50"/>
-        <path d="M15.6 54.4 L26 47"/>
-        <path d="M15.6 25.6 L27 34"/>
-      </g>
-      <path d="M40 18 L52 50 L42 47 L36 58 L33 50 L40 18 Z" fill="url(#mark)"/>
-    </g>
-    <text x="140" y="56" fill="#FFFFFF" font-family="-apple-system,BlinkMacSystemFont,Inter,sans-serif" font-weight="800" font-size="76" letter-spacing="-3">pursr</text>
-    <rect x="438" y="0" width="14" height="14" fill="#FF2EA6"/>
-  </g>
-
-  <!-- Tagline -->
-  <text x="80" y="380" fill="#FFFFFF" font-family="-apple-system,BlinkMacSystemFont,Inter,sans-serif" font-weight="600" font-size="34" letter-spacing="-1">Visual QA, audit &amp; MCP for the browser.</text>
-  <text x="80" y="430" fill="#A0A0AA" font-family="-apple-system,BlinkMacSystemFont,Inter,sans-serif" font-weight="400" font-size="22" letter-spacing="-0.5">Capture · sweep · diff · audit · repeat.</text>
-
-  <!-- Footer chip line -->
-  <g transform="translate(80,520)">
-    <rect width="180" height="36" rx="18" fill="#1A1A22" stroke="#2A2A30"/>
-    <text x="90" y="23" fill="#FF5CC1" font-family="monospace" font-size="14" text-anchor="middle">npm i pursr</text>
-  </g>
-  <g transform="translate(280,520)">
-    <rect width="200" height="36" rx="18" fill="#1A1A22" stroke="#2A2A30"/>
-    <text x="100" y="23" fill="#A0A0AA" font-family="monospace" font-size="14" text-anchor="middle">7 MCP tools · 32 tests</text>
-  </g>
-  <g transform="translate(500,520)">
-    <rect width="220" height="36" rx="18" fill="#1A1A22" stroke="#2A2A30"/>
-    <text x="110" y="23" fill="#A0A0AA" font-family="monospace" font-size="14" text-anchor="middle">HAR · baselines · parallel</text>
-  </g>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1280 640" role="img" aria-label="pursr — visual QA, audit, and MCP for the browser">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#0B0B0F"/>
+      <stop offset="0.6" stop-color="#15101A"/>
+      <stop offset="1" stop-color="#1F0A1A"/>
+    </linearGradient>
+    <linearGradient id="mark" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#FF2EA6"/>
+      <stop offset="1" stop-color="#FF5CC1"/>
+    </linearGradient>
+    <pattern id="grid" width="48" height="48" patternUnits="userSpaceOnUse">
+      <path d="M48 0 L0 0 0 48" fill="none" stroke="#FF2EA6" stroke-opacity="0.08" stroke-width="1"/>
+    </pattern>
+    <radialGradient id="glow" cx="0.85" cy="0.15" r="0.6">
+      <stop offset="0" stop-color="#FF2EA6" stop-opacity="0.35"/>
+      <stop offset="1" stop-color="#FF2EA6" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+  <rect width="1280" height="640" fill="url(#bg)"/>
+  <rect width="1280" height="640" fill="url(#grid)"/>
+  <rect width="1280" height="640" fill="url(#glow)"/>
+
+  <!-- Decorative screenshot card on the right -->
+  <g transform="translate(720,160)">
+    <rect width="440" height="320" rx="16" fill="#101015" stroke="#2A2A30"/>
+    <rect x="0" y="0" width="440" height="40" rx="16" fill="#1B1B22"/>
+    <circle cx="20" cy="20" r="6" fill="#FF5F56"/>
+    <circle cx="40" cy="20" r="6" fill="#FFBD2E"/>
+    <circle cx="60" cy="20" r="6" fill="#27C93F"/>
+    <text x="220" y="25" fill="#666" font-family="monospace" font-size="12" text-anchor="middle">pursr.mjs shoot</text>
+    <line x1="20" y1="80" x2="200" y2="80" stroke="#FF2EA6" stroke-width="14" stroke-linecap="round"/>
+    <line x1="20" y1="120" x2="380" y2="120" stroke="#3A3A45" stroke-width="8" stroke-linecap="round"/>
+    <line x1="20" y1="160" x2="320" y2="160" stroke="#3A3A45" stroke-width="8" stroke-linecap="round"/>
+    <line x1="20" y1="200" x2="260" y2="200" stroke="#3A3A45" stroke-width="8" stroke-linecap="round"/>
+    <rect x="20" y="240" width="120" height="48" rx="6" fill="#FF2EA6"/>
+    <line x1="160" y1="264" x2="220" y2="264" stroke="#3A3A45" stroke-width="6" stroke-linecap="round"/>
+    <line x1="240" y1="252" x2="380" y2="252" stroke="#3A3A45" stroke-width="6" stroke-linecap="round"/>
+    <line x1="240" y1="276" x2="340" y2="276" stroke="#3A3A45" stroke-width="6" stroke-linecap="round"/>
+  </g>
+
+  <!-- Brand mark + wordmark on the left -->
+  <g transform="translate(80,200)">
+    <g transform="scale(1.5)">
+      <circle cx="40" cy="40" r="34" fill="none" stroke="url(#mark)" stroke-width="6"/>
+      <g fill="none" stroke="url(#mark)" stroke-width="6" stroke-linecap="round">
+        <path d="M40 12 L52 30"/>
+        <path d="M64.4 25.6 L54.5 40"/>
+        <path d="M64.4 54.4 L48 48"/>
+        <path d="M40 68 L32 50"/>
+        <path d="M15.6 54.4 L26 47"/>
+        <path d="M15.6 25.6 L27 34"/>
+      </g>
+      <path d="M40 18 L52 50 L42 47 L36 58 L33 50 L40 18 Z" fill="url(#mark)"/>
+    </g>
+    <text x="140" y="56" fill="#FFFFFF" font-family="-apple-system,BlinkMacSystemFont,Inter,sans-serif" font-weight="800" font-size="76" letter-spacing="-3">pursr</text>
+    <rect x="438" y="0" width="14" height="14" fill="#FF2EA6"/>
+  </g>
+
+  <!-- Tagline -->
+  <text x="80" y="380" fill="#FFFFFF" font-family="-apple-system,BlinkMacSystemFont,Inter,sans-serif" font-weight="600" font-size="34" letter-spacing="-1">Visual QA, audit &amp; MCP for the browser.</text>
+  <text x="80" y="430" fill="#A0A0AA" font-family="-apple-system,BlinkMacSystemFont,Inter,sans-serif" font-weight="400" font-size="22" letter-spacing="-0.5">Capture · sweep · diff · audit · repeat.</text>
+
+  <!-- Footer chip line -->
+  <g transform="translate(80,520)">
+    <rect width="180" height="36" rx="18" fill="#1A1A22" stroke="#2A2A30"/>
+    <text x="90" y="23" fill="#FF5CC1" font-family="monospace" font-size="14" text-anchor="middle">npm i pursr</text>
+  </g>
+  <g transform="translate(280,520)">
+    <rect width="200" height="36" rx="18" fill="#1A1A22" stroke="#2A2A30"/>
+    <text x="100" y="23" fill="#A0A0AA" font-family="monospace" font-size="14" text-anchor="middle">7 MCP tools · 32 tests</text>
+  </g>
+  <g transform="translate(500,520)">
+    <rect width="220" height="36" rx="18" fill="#1A1A22" stroke="#2A2A30"/>
+    <text x="110" y="23" fill="#A0A0AA" font-family="monospace" font-size="14" text-anchor="middle">HAR · baselines · parallel</text>
+  </g>
 </svg>

package/bin/pursr-mcp.mjs

@@ -1,21 +1,22 @@
 #!/usr/bin/env node
-// @purr/visual — MCP server binary.
+//  pursr — MCP server binary.
 //
-// Runs the pursor MCP stdio server, exposing all capture/audit/sweep
+// Runs the pursr MCP stdio server, exposing all capture/audit/sweep
 // capabilities as MCP tools for Claude Code, Cursor, Continue, etc.
 //
-// Usage: pursor-mcp
-//   Config via PURSOR_MCP_CONFIG env or ~/.pursor/mcp-config.json
+// Usage: pursr-mcp
+//   Config via PURSR_MCP_CONFIG env or ~/.pursr/mcp-config.json
 //
-//   echo '{"url":"https://example.com"}' | pursor-mcp
+//   echo '{"url":"https://example.com"}' | pursr-mcp
 
-import { PursorMCPServer, loadConfig } from "../src/mcp.js";
+import { PursrMCPServer, loadConfig } from "../src/mcp.js";
+import { __PURSR_GET } from "../src/util.js";
 
 const config = loadConfig();
 
 // Verbose mode: --verbose or debug env
-const verbose = process.argv.includes("--verbose") || !!process.env.PURSOR_DEBUG;
+const verbose = process.argv.includes("--verbose") || !!__PURSR_GET("PURSR_DEBUG");
 config.verbose = verbose;
 
-const server = new PursorMCPServer(config);
-await server.start();
+const server = new PursrMCPServer(config);
+await server.start();

package/bin/pursr.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// pursor CLI. Thin wrapper around src/* that mirrors the npm bin.
+// pursr CLI. Thin wrapper around src/* that mirrors the npm bin.
 
 import { VERSION } from "../src/index.js";
 import { runClick, runType, runWait, runSeq } from "../src/interact.js";
@@ -9,13 +9,13 @@ import { runShot } from "../src/shot.js";
 import { runShootWithSidecar } from "../src/shoot.js";
 import { runHover } from "../src/hover.js";
 import { runFrames } from "../src/frames.js";
-import { runDiff } from "../src/diff.js";
+import { runDiff, runDiffWithAi } from "../src/diff.js";
 import { runSweep } from "../src/sweep.js";
 import { runEveryViewport } from "../src/every-viewport.js";
 import { runAudit } from "../src/plugin-audit.js";
 import { captureDomSnapshot } from "../src/dom-snapshot.js";
 import { listViewports } from "../src/viewport.js";
-import { parseFlags, asNum, readArg, makeOut, pickOutPath } from "../src/util.js";
+import { parseFlags, asNum, readArg, makeOut, pickOutPath, __PURSR_GET } from "../src/util.js";
 import { writeFileSync, existsSync, mkdirSync } from "node:fs";
 import { dirname } from "node:path";
 import { readFileSync as _readFileSync } from "node:fs";
@@ -23,8 +23,8 @@ const readFile = _readFileSync;
 import { loadPlugins, listPlugins, getFlagHelp } from "../src/plugin.js";
 
 const USAGE = `usage:
-  v1: pursor {probe|shot|full|eval|click|type|wait|diff|seq} <url> [...]
-  v2: pursor {viewports|shoot|layer|frames|hover|sweep} <...>
+  v1: pursr {probe|shot|full|eval|click|type|wait|diff|seq} <url> [...]
+  v2: pursr {viewports|shoot|layer|frames|hover|sweep} <...>
   flags: --preset <name> --width N --height N --dpr N
          --zoom 1.5 --panX 200 --panY -100
          --cursor pointer|grab|grabbing|crosshair|none
@@ -32,7 +32,9 @@ const USAGE = `usage:
          --grid --grid-tile 64 --grid-color rgba(255,0,255,0.35)
          --no-animation --wait-frame 600 --full
   @file prefix reads argv contents from file (UTF-8, newline trimmed).
-  plugins: pursor automatically loads built-in plugins from plugins/.
+  report: pursr report --sweep <sweep.json> [--out <report.pdf>] [--title "..."] [--no-embed]
+         diff extras: --ai [--ai-model M] [--ai-base-url U] [--ai-api-key K]
+  plugins: pursr automatically loads built-in plugins from plugins/.
   You can also pass --plugin <path> to load custom plugins (repeatable).`;
 
 function die(msg, code = 2) {
@@ -42,7 +44,7 @@ function die(msg, code = 2) {
 
 const argv = process.argv;
 const [, , cmd, a, b, c, d] = argv;
-const url = process.env.PURSOR_URL || a;
+const url = __PURSR_GET("PURSR_URL") || a;
 // Top-level --plan / --out parsing for subcommands that need it before dispatch
 function _topOpts() {
   const o = {};
@@ -64,7 +66,7 @@ await loadPlugins(pluginPaths);
     switch (cmd) {
       case undefined: case "help": case "--help": case "-h": { console.log(JSON.stringify({ usage: USAGE }, null, 2)); break; }
       case "version": case "--version": case "-v": {
-        console.log(JSON.stringify({ name: "pursor", version: VERSION, plugins: listPlugins() }, null, 2));
+        console.log(JSON.stringify({ name: "pursr", version: VERSION, plugins: listPlugins() }, null, 2));
         break;
       }
       case "probe": { if (!url) die("missing url"); const r = await runProbe(url); console.log(JSON.stringify(r, null, 2)); break; }
@@ -74,7 +76,19 @@ await loadPlugins(pluginPaths);
       case "click": { if (!url) die("missing url"); const sel = b; if (!sel) die("click: missing <selector>"); const out = c || makeOut(`click-${(sel||"").replace(/[^a-z0-9]+/gi, "_").slice(0, 32)}.png`); const r = await runClick(url, sel, out); console.log(JSON.stringify(r, null, 2)); break; }
       case "type": { if (!url) die("missing url"); const sel = b; const text = readArg(c); if (!sel || text === undefined) die("type: missing <selector> or <text> (text can be @file)"); const out = d || makeOut(`type-${(sel||"").replace(/[^a-z0-9]+/gi, "_").slice(0, 32)}.png`); const r = await runType(url, sel, text, out); console.log(JSON.stringify(r, null, 2)); break; }
       case "wait": { if (!url) die("missing url"); const sel = b; if (!sel) die("wait: missing <selector>"); const t = c !== undefined ? asNum(c, 30000) : 30000; const r = await runWait(url, sel, t); console.log(JSON.stringify(r, null, 2)); break; }
-      case "diff": { if (!url) die("missing url"); const ref = b; if (!ref) die("diff: missing <ref.png>"); const out = c || makeOut("diff.png"); const threshold = d !== undefined ? Number(d) : 0.1; const r = await runDiff(url, ref, out, threshold); console.log(JSON.stringify(r, null, 2)); break; }
+      case "diff": {
+        if (!url) die("missing url"); const ref = b; if (!ref) die("diff: missing <ref.png>");
+        const out = c || makeOut("diff.png"); const threshold = d !== undefined ? Number(d) : 0.1;
+        // --ai / --ai-model / --ai-base-url / --ai-api-key
+        const useAi = argv.includes("--ai");
+        const aiModel = (() => { const i = argv.indexOf("--ai-model"); return i >= 0 && i + 1 < argv.length ? argv[i + 1] : undefined; })();
+        const aiBaseUrl = (() => { const i = argv.indexOf("--ai-base-url"); return i >= 0 && i + 1 < argv.length ? argv[i + 1] : undefined; })();
+        const aiApiKey = (() => { const i = argv.indexOf("--ai-api-key"); return i >= 0 && i + 1 < argv.length ? argv[i + 1] : undefined; })();
+        const r = useAi
+          ? await runDiffWithAi(url, ref, out, threshold, { model: aiModel, baseUrl: aiBaseUrl, apiKey: aiApiKey })
+          : await runDiff(url, ref, out, threshold);
+        console.log(JSON.stringify(r, null, 2)); break;
+      }
       case "seq": { if (!url) die("missing url"); const actions = readArg(b); if (!actions) die("seq: missing <actions.json> (or @file)"); const out = c || makeOut("seq.png"); const r = await runSeq(url, actions, out); console.log(JSON.stringify(r, null, 2)); break; }
       case "viewports": { console.log(JSON.stringify(listViewports(), null, 2)); break; }
       case "shoot": {
@@ -118,6 +132,24 @@ await loadPlugins(pluginPaths);
         console.log(JSON.stringify(r, null, 2));
         break;
       }
+      case "report": {
+        // pursr report --sweep <sweep.json> [--out report.pdf] [--title "..."]
+        const sweepIdx = argv.indexOf("--sweep");
+        const sweepPath = sweepIdx >= 0 && sweepIdx + 1 < argv.length ? argv[sweepIdx + 1] : a;
+        if (!sweepPath) die("report: missing --sweep <sweep.json>");
+        if (!existsSync(sweepPath)) die("report: sweep not found: " + sweepPath);
+        const outIdx = argv.indexOf("--out");
+        const outPath = outIdx >= 0 && outIdx + 1 < argv.length ? argv[outIdx + 1] : (opts.out || makeOut("report.pdf").replace(/pursr-[^-]+-shot.png$/, "report.pdf"));
+        if (outPath && outPath !== "-") mkdirSync(dirname(outPath), { recursive: true });
+        const titleIdx = argv.indexOf("--title");
+        const title = titleIdx >= 0 && titleIdx + 1 < argv.length ? argv[titleIdx + 1] : undefined;
+        const noEmbed = argv.includes("--no-embed");
+        const summary = JSON.parse(readFile(sweepPath, "utf8"));
+        const { renderSweepPdf } = await import("../src/report.js");
+        const buf = await renderSweepPdf(summary, { out: outPath === "-" ? undefined : outPath, title, embedImages: !noEmbed });
+        console.log(JSON.stringify({ ok: true, sweep: sweepPath, out: outPath, bytes: buf.length }, null, 2));
+        break;
+      }
       case "every-viewport": {
         if (!url) die("missing url");
         const outDir = (b && !b.startsWith("--")) ? b : undefined;
@@ -154,7 +186,7 @@ await loadPlugins(pluginPaths);
         break;
       }
       case "baseline": {
-        // pursor baseline <sub> [...args]
+        //  baseline <sub> [...args]
         //   sub=list                    -> list baselines
         //   sub=save <project> <png> <step>  [--id <id>] [--url <u>] [--meta-json <file>]
         //   sub=approve <project> <png> <step>  [--id <id>] [--url <u>]
@@ -195,7 +227,7 @@ await loadPlugins(pluginPaths);
         break;
       }
       case "auth": {
-              // pursor auth <sub> [...args]
+              //  auth <sub> [...args]
               //   save <project> <name> --from <state.json>
               //   load <project> <name> --out <state.json>
               //   list [project]
@@ -268,7 +300,7 @@ await loadPlugins(pluginPaths);
               const sel = b; if (!sel) die("snap: missing <selector>");
               const flags = parseFlags(argv.slice(4));
               const { runSnap, approveSnapsAsBaselines } = await import("../src/snap.js");
-              const outDir = flags.out || makeOut("snaps").replace(/pursor-[^-]+-snap\.png$/, "snaps");
+              const outDir = flags.out || makeOut("snaps").replace(/pursr-[^-]+-snap\.png$/, "snaps");
               const snap = await runSnap({ url, selector: sel, outDir, name: flags.name, max: flags.max, flags });
               console.log(JSON.stringify({
                 url: snap.url,

package/package.json

@@ -1,92 +1,95 @@
-{
-  "name": "pursr",
-  "version": "0.5.0",
-  "private": false,
-  "description": "Visual QA, audit, and MCP for the browser. One CLI + one MCP server for screenshots, sweeps, baselines, diffs, axe-core a11y audits, HAR capture, and auth state — with parallel sweep workers, auto-healing selectors, and a plugin system. Zero browser bundled: drives your system Chrome via Playwright.",
-  "homepage": "https://github.com/0xheycat/pursr",
-  "bugs": "https://github.com/0xheycat/pursr/issues",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/0xheycat/pursr.git"
-  },
-  "funding": "https://github.com/sponsors/0xheycat",
-  "type": "module",
-  "bin": {
-    "pursr": "./bin/pursr.mjs",
-    "pursr-mcp": "./bin/pursr-mcp.mjs"
-  },
-  "main": "./src/index.js",
-  "exports": {
-    ".": "./src/index.js",
-    "./plugin": "./src/plugin.js",
-    "./plugins/*": "./plugins/*.js",
-    "./util": "./src/util.js",
-    "./runway": "./src/runway.js",
-    "./selector": "./src/selector.js",
-    "./overlays": "./src/overlays.js",
-    "./viewport": "./src/viewport.js",
-    "./dom-snapshot": "./src/dom-snapshot.js",
-    "./plugin-audit": "./src/plugin-audit.js",
-    "./selector-heal": "./src/selector-heal.js",
-    "./ci-output": "./src/ci-output.js",
-    "./mcp": "./src/mcp.js",
-    "./baseline": "./src/baseline.js",
-    "./sweep-schema": "./src/sweep-schema.js",
-    "./mcp-resources": "./src/mcp-resources.js",
-    "./har": "./src/har.js",
-    "./auth": "./src/auth.js",
-    "./watch": "./src/watch.js",
-    "./snap": "./src/snap.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "plugins",
-    "plans",
-    "assets",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "start": "node bin/pursor.mjs",
-    "test": "node --test \"test/*.test.js\"",
-    "smoke": "node bin/pursor.mjs viewports"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "visual-qa",
-    "visual-regression",
-    "screenshot",
-    "audit",
-    "accessibility",
-    "axe-core",
-    "playwright",
-    "mcp",
-    "model-context-protocol",
-    "baseline",
-    "diff",
-    "har",
-    "testing",
-    "devtools",
-    "pursr"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "axe-core": "^4.12.1",
-    "pixelmatch": "^5.3.0",
-    "pngjs": "^7.0.0"
-  },
-  "peerDependencies": {
-    "playwright-core": "*"
-  },
-  "peerDependenciesMeta": {
-    "playwright-core": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "playwright-core": "^1.61.0"
-  }
-}
+{
+  "name": "pursr",
+  "version": "0.7.0",
+  "private": false,
+  "description": "pursr — Visual QA, audit, and MCP for the browser. One CLI + one MCP server for screenshots, sweeps, baselines, diffs, axe-core a11y audits, HAR capture, and auth state — with parallel sweep workers, auto-healing selectors, and a plugin system. Zero browser bundled: drives your system Chrome via Playwright.",
+  "homepage": "https://github.com/0xheycat/pursr",
+  "bugs": "https://github.com/0xheycat/pursr/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/0xheycat/pursr.git"
+  },
+  "funding": "https://github.com/sponsors/0xheycat",
+  "type": "module",
+  "bin": {
+    "pursr": "./bin/pursr.mjs",
+    "pursr-mcp": "./bin/pursr-mcp.mjs"
+  },
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./plugin": "./src/plugin.js",
+    "./plugins/*": "./plugins/*.js",
+    "./util": "./src/util.js",
+    "./runway": "./src/runway.js",
+    "./selector": "./src/selector.js",
+    "./overlays": "./src/overlays.js",
+    "./viewport": "./src/viewport.js",
+    "./dom-snapshot": "./src/dom-snapshot.js",
+    "./plugin-audit": "./src/plugin-audit.js",
+    "./selector-heal": "./src/selector-heal.js",
+    "./ci-output": "./src/ci-output.js",
+    "./mcp": "./src/mcp.js",
+    "./baseline": "./src/baseline.js",
+    "./sweep-schema": "./src/sweep-schema.js",
+    "./mcp-resources": "./src/mcp-resources.js",
+    "./har": "./src/har.js",
+    "./auth": "./src/auth.js",
+    "./watch": "./src/watch.js",
+    "./snap": "./src/snap.js",
+    "./report": "./src/report.js",
+    "./ai-diff": "./src/ai-diff.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "plugins",
+    "plans",
+    "assets",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node bin/pursr.mjs",
+    "test": "node --test \"test/*.test.js\"",
+    "smoke": "node bin/pursr.mjs viewports"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "visual-qa",
+    "visual-regression",
+    "screenshot",
+    "audit",
+    "accessibility",
+    "axe-core",
+    "playwright",
+    "mcp",
+    "model-context-protocol",
+    "baseline",
+    "diff",
+    "har",
+    "testing",
+    "devtools",
+    "pursr"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "axe-core": "^4.12.1",
+    "pdfkit": "^0.19.1",
+    "pixelmatch": "^5.3.0",
+    "pngjs": "^7.0.0"
+  },
+  "peerDependencies": {
+    "playwright-core": "*"
+  },
+  "peerDependenciesMeta": {
+    "playwright-core": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "playwright-core": "^1.61.0"
+  }
+}