pursr 0.6.0 → 0.7.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 pursr
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2026 pursr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -65,7 +65,7 @@ pursr baseline save myapp shot.png home --url https://example.com
 
 # 3. Next time you run, compare against the baseline
 pursr diff https://example.com \
-  ~/.pursor/baselines/myapp/<id>/home.png \
+  ~/.pursr/baselines/myapp/<id>/home.png \
   diff.png
 
 # 4. Or: run a batched sweep + a11y audit + parallel workers
@@ -203,7 +203,7 @@ npx pursr-mcp --verbose
 | `pursr://shoot/<url|preset>` | Last screenshot PNG (image/png) |
 | `pursr://sweep/<plan-name>` | Last sweep summary JSON (application/json) |
 
-Resources are persisted to `~/.pursor/mcp/mcp-index.json` (override with `PURSOR_MCP_STATE`).
+Resources are persisted to `~/.pursr/mcp/mcp-index.json` (override with `PURSR_MCP_STATE`).
 
 ## Visual Regression Baselines
 
@@ -214,7 +214,7 @@ pursr baseline list myapp
 pursr baseline show myapp home --url https://my.app
 ```
 
-Baselines live under `~/.pursor/baselines/<project>/<id>/<step>.png` + `manifest.json`. Override with `PURSOR_BASELINES_DIR`. The `id` is a 16-char SHA1 prefix of `url|viewport|flags` so re-running a sweep maps to the same slot deterministically.
+Baselines live under `~/.pursr/baselines/<project>/<id>/<step>.png` + `manifest.json`. Override with `PURSR_BASELINES_DIR`. The `id` is a 16-char SHA1 prefix of `url|viewport|flags` so re-running a sweep maps to the same slot deterministically.
 
 ```js
 import { diffKey, saveBaseline, loadBaseline } from "pursr/baseline";
@@ -274,7 +274,7 @@ pursr auth load myapp admin --out ./round-trip.json
 pursr auth delete myapp admin
 ```
 
-States live in `~/.pursor/auth/<project>/<name>.json` (override with `PURSOR_AUTH_DIR`). The on-disk format is the standard Playwright `storageState` shape: `{ cookies, origins }`.
+States live in `~/.pursr/auth/<project>/<name>.json` (override with `PURSR_AUTH_DIR`). The on-disk format is the standard Playwright `storageState` shape: `{ cookies, origins }`.
 
 ## Parallel Sweep
 
@@ -330,7 +330,7 @@ import {
   saveBaseline, diffKey,
   startHarCapture, stopHarCapture, writeHar,
   loadAuthState,
-  PursorMCPServer, loadMcpConfig,
+  PursrMCPServer, loadMcpConfig,
   validateSweepPlan,
   listResources, readResource,
   listViewports, resolveViewport, VIEWPORTS,
@@ -355,7 +355,7 @@ import { validateSweepPlan } from "pursr/sweep-schema";
 import { startHarCapture, stopHarCapture } from "pursr/har";
 import { saveAuthState, loadAuthState } from "pursr/auth";
 import { listResources, readResource } from "pursr/mcp-resources";
-import { PursorMCPServer } from "pursr/mcp";
+import { PursrMCPServer } from "pursr/mcp";
 ```
 
 ## Plugins
@@ -416,11 +416,11 @@ npm install --save-dev playwright-core
 npm test
 ```
 
-`npm test` runs 60 unit + integration tests (Node's built-in test runner, zero test deps). Coverage includes: viewport resolution, flag parsing, selector parsing, HTML escaping, hashing, baseline storage, sweep-plan validation, MCP resources, HAR 1.2 shape, auth state, and end-to-end CLI smoke tests.
+`npm test` runs 63 unit + integration tests (Node's built-in test runner, zero test deps). Coverage includes: viewport resolution, flag parsing, selector parsing, HTML escaping, hashing, baseline storage, sweep-plan validation, MCP resources, HAR 1.2 shape, auth state, and end-to-end CLI smoke tests.
 
 ```
-src/           - 27 modules
-test/          - 60 tests, 0 failures
+src/           - 29 modules
+test/          - 63 tests, 0 failures
 plugins/       - 2 built-in plugins, auto-loaded
 ```
 

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.
+#!/usr/bin/env node
+// 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";
@@ -15,7 +15,7 @@ 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
@@ -34,7 +34,7 @@ const USAGE = `usage:
   @file prefix reads argv contents from file (UTF-8, newline trimmed).
   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: pursor automatically loads built-in plugins from plugins/.
+  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) {
@@ -44,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 = {};
@@ -66,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; }
@@ -79,14 +79,15 @@ await loadPlugins(pluginPaths);
       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 flags = parseFlags(argv.slice(5));
         // --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);
+          ? await runDiffWithAi(url, ref, out, threshold, flags, { model: aiModel, baseUrl: aiBaseUrl, apiKey: aiApiKey })
+          : await runDiff(url, ref, out, threshold, flags);
         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; }
@@ -139,7 +140,7 @@ await loadPlugins(pluginPaths);
         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(/pursor-[^-]+-shot.png$/, "report.pdf"));
+        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;
@@ -186,7 +187,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>]
@@ -227,7 +228,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]
@@ -300,7 +301,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,8 +1,8 @@
 {
   "name": "pursr",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "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.",
+  "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": {
@@ -50,9 +50,9 @@
     "LICENSE"
   ],
   "scripts": {
-    "start": "node bin/pursor.mjs",
+    "start": "node bin/pursr.mjs",
     "test": "node --test \"test/*.test.js\"",
-    "smoke": "node bin/pursor.mjs viewports"
+    "smoke": "node bin/pursr.mjs viewports"
   },
   "engines": {
     "node": ">=18"

package/plans/m5.4-polish.json

@@ -1,22 +1,22 @@
-{
-  "name": "m5.4-polish",
-  "base": "http://localhost:3010",
-  "outDir": "./out/m54-sweep",
-  "steps": [
-    { "name": "baseline",         "shoot":  { "preset": "desktop-1280" } },
-    { "name": "cursor-pointer",   "shoot":  { "preset": "desktop-1280", "cursor": "pointer" } },
-    { "name": "grid-64",          "shoot":  { "preset": "desktop-1280", "grid": true, "grid-tile": 64 } },
-    { "name": "grid-128",         "shoot":  { "preset": "desktop-1280", "grid": true, "grid-tile": 128 } },
-    { "name": "layer-entity",     "shoot":  { "preset": "desktop-1280", "layer": "entity" } },
-    { "name": "layer-terrain",    "shoot":  { "preset": "desktop-1280", "layer": "terrain" } },
-    { "name": "no-hud",           "shoot":  { "preset": "desktop-1280", "no-hud": true } },
-    { "name": "frozen",           "shoot":  { "preset": "desktop-1280", "no-animation": true } },
-    { "name": "tablet-768",       "shoot":  { "preset": "tablet-768" } },
-    { "name": "mobile-375",       "shoot":  { "preset": "mobile-375" } },
-    { "name": "ultrawide-3440",   "shoot":  { "preset": "ultrawide-3440" } },
-    { "name": "hover-build",      "hover":  { "selector": "text=Build" } },
-    { "name": "hover-decor",      "hover":  { "selector": "text=Decor" } },
-    { "name": "frames-8",         "frames": { "count": 8, "intervalMs": 200 } },
-    { "name": "diff-vs-baseline", "diff":   { "ref": "baseline.png" } }
-  ]
+{
+  "name": "m5.4-polish",
+  "base": "http://localhost:3010",
+  "outDir": "./out/m54-sweep",
+  "steps": [
+    { "name": "baseline",         "shoot":  { "preset": "desktop-1280" } },
+    { "name": "cursor-pointer",   "shoot":  { "preset": "desktop-1280", "cursor": "pointer" } },
+    { "name": "grid-64",          "shoot":  { "preset": "desktop-1280", "grid": true, "grid-tile": 64 } },
+    { "name": "grid-128",         "shoot":  { "preset": "desktop-1280", "grid": true, "grid-tile": 128 } },
+    { "name": "layer-entity",     "shoot":  { "preset": "desktop-1280", "layer": "entity" } },
+    { "name": "layer-terrain",    "shoot":  { "preset": "desktop-1280", "layer": "terrain" } },
+    { "name": "no-hud",           "shoot":  { "preset": "desktop-1280", "no-hud": true } },
+    { "name": "frozen",           "shoot":  { "preset": "desktop-1280", "no-animation": true } },
+    { "name": "tablet-768",       "shoot":  { "preset": "tablet-768" } },
+    { "name": "mobile-375",       "shoot":  { "preset": "mobile-375" } },
+    { "name": "ultrawide-3440",   "shoot":  { "preset": "ultrawide-3440" } },
+    { "name": "hover-build",      "hover":  { "selector": "text=Build" } },
+    { "name": "hover-decor",      "hover":  { "selector": "text=Decor" } },
+    { "name": "frames-8",         "frames": { "count": 8, "intervalMs": 200 } },
+    { "name": "diff-vs-baseline", "diff":   { "ref": "baseline.png" } }
+  ]
 }