pursr 0.4.0

package/LICENSE

@@ -0,0 +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
+SOFTWARE.

package/README.md

@@ -0,0 +1,440 @@
+<!-- PROJECT_LOGO_START -->
+<p align="center">
+  <img src="assets/social-preview.svg" alt="pursr - visual QA, audit, and MCP for the browser" width="100%">
+</p>
+
+<p align="center">
+  <img src="assets/logo.svg" alt="pursr" width="320">
+</p>
+
+<h1 align="center">pursr</h1>
+
+<p align="center">
+  <strong>Visual QA, audit, and MCP for the browser.</strong><br>
+  Capture - sweep - diff - audit - repeat - from the CLI, an MCP server, or as a library.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/pursr"><img src="https://img.shields.io/npm/v/pursr.svg?style=for-the-badge&color=FF2EA6" alt="npm version"></a>
+  <a href="https://github.com/0xheycat/pursr/blob/main/LICENSE"><img src="https://img.shields.io/github/license/0xheycat/pursr.svg?style=for-the-badge" alt="license"></a>
+  <a href="https://www.npmjs.com/package/pursr"><img src="https://img.shields.io/npm/dm/pursr.svg?style=for-the-badge" alt="npm downloads"></a>
+  <a href="https://github.com/0xheycat/pursr/actions"><img src="https://img.shields.io/github/actions/workflow/status/0xheycat/pursr/ci.yml?style=for-the-badge" alt="CI"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/pursr.svg?style=for-the-badge" alt="node"></a>
+</p>
+
+<p align="center">
+  <a href="#install">Install</a> &middot; <a href="#30-seconds">30 seconds</a> &middot; <a href="#cli">CLI</a> &middot; <a href="#mcp-server">MCP</a> &middot; <a href="#library-api">Library</a> &middot; <a href="#plugins">Plugins</a> &middot; <a href="#roadmap">Roadmap</a>
+</p>
+
+---
+
+## Why pursr?
+
+Most teams need **four separate tools** to do visual QA: a screenshot CLI, a regression diff runner, an accessibility auditor, and a way to share captures with an AI assistant. **pursr is all four** - built as a single Node.js package with:
+
+- **A unified CLI** (`pursr`) for every capture, diff, sweep, and audit.
+- **An MCP stdio server** (`pursr-mcp`) so Claude Code, Cursor, and Continue can take screenshots, run sweeps, and inspect prior captures as MCP resources.
+- **A library** with 30+ named exports and 16 subpath modules, so you can embed it in your own tooling.
+- **A plugin system** for custom viewports, sweep ops, and capture hooks.
+- **Zero browser bundled** - drives your system Chrome via Playwright. No 200 MB Chromium download.
+
+## Install
+
+```bash
+npm install pursr
+npm install --save-dev playwright-core   # peer dep - bring your own Chrome
+```
+
+Then verify:
+
+```bash
+pursr viewports         # list 10+ registered viewport presets
+pursr probe https://example.com   # health check
+```
+
+## 30 seconds
+
+```bash
+# 1. Capture a screenshot with overlays
+pursr shoot https://example.com shot.png \
+  --preset desktop-1280 --grid --grid-tile 64
+
+# 2. Save it as a visual baseline
+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 \
+  diff.png
+
+# 4. Or: run a batched sweep + a11y audit + parallel workers
+pursr sweep ./plan.json   # see plans/ for an example
+```
+
+## Features
+
+| Feature | Description | CLI flag |
+| --- | --- | --- |
+| Multi-viewport capture | 10+ presets (mobile, tablet, desktop, ultrawide) | `--preset mobile-375` |
+| Layered states | entity / terrain / hud / ui isolation | `--layer entity` |
+| Animation freeze | pause CSS/JS animations for stable frames | `--no-animation` |
+| Cursor overlay | pointer / grab / grabbing / crosshair | `--cursor crosshair` |
+| Grid overlay | spacing guides, custom color + tile size | `--grid --grid-tile 64` |
+| Camera control | zoom + pan via mouse wheel/drag | `--zoom 1.5 --panX 200` |
+| Frame timeline | N captures at intervalMs for animations | `pursr frames <url> 8 200` |
+| Hover capture | text=/role=/aria=/placeholder= matchers | `pursr hover <url> "text=Login"` |
+| Pixel diff | `pixelmatch` against any reference PNG | `pursr diff <url> <ref>` |
+| Visual baselines | save / approve / diff with stable IDs | `pursr baseline save ...` |
+| Parallel sweep | opt-in worker pool across independent steps | `{ "parallel": 4 }` |
+| Accessibility audit | axe-core WCAG 2.1 AA + highlighted screenshot | `pursr audit <url>` |
+| DOM snapshot | serialized HTML + computed styles + selector map | `pursr dom <url>` |
+| Sweep plans | JSON-driven batch with per-step ops | `pursr sweep plan.json` |
+| HTML report | dark-themed grid of every capture + meta | auto-generated `index.html` |
+| CI output | JUnit XML, GitHub Actions annotations, Markdown | written on every sweep |
+| Auto-heal selectors | fallback chain + named matchers | `["text=Login", "#login"]` |
+| HAR capture | HAR 1.2 spec, written next to your shot | `--har ./req.har.json` |
+| Auth state | Playwright storageState, reuse logged-in sessions | `--auth-state admin` |
+| Plugins | custom viewports, sweep ops, before/after hooks | `pursr-plugin-*` |
+| MCP server | 7 tools + resources/list & resources/read for Claude/Cursor | `npx pursr-mcp` |
+
+## CLI
+
+```bash
+# Health check
+pursr probe https://example.com
+
+# Screenshot (simple)
+pursr shot https://example.com ./out/shot.png
+
+# Rich capture: viewport preset + cursor + grid
+pursr shoot https://example.com \
+  --preset desktop-1280 \
+  --cursor crosshair \
+  --grid --grid-tile 64
+
+# Isolate a layer
+pursr layer https://example.com entity
+
+# Animation timeline
+pursr frames https://example.com 8 200 ./frames/
+
+# Hover an element
+pursr hover https://example.com "text=Login"
+
+# Pixel diff vs reference
+pursr diff https://example.com ./ref.png ./out/diff.png
+
+# Batched plan
+pursr sweep ./plan.json
+
+# Accessibility audit
+pursr audit https://example.com --tags wcag2a,wcag2aa
+
+# DOM + selector map snapshot
+pursr dom https://example.com
+
+# HAR capture during a shoot
+pursr shoot https://example.com shot.png --har ./req.har.json
+
+# Auth state reuse
+pursr shoot https://my.app/dashboard shot.png \
+  --auth-state admin --auth-project myapp
+
+# Visual baselines
+pursr baseline save myapp shot.png home --url https://example.com
+pursr baseline list myapp
+pursr baseline approve myapp ./new.png home --url https://example.com
+
+# Plan validation
+pursr validate ./plan.json
+```
+
+### Subcommands
+
+| Subcommand | Purpose |
+| --- | --- |
+| `probe` | Health check (HTTP status, page title) |
+| `shot` / `full` | Viewport / full-page screenshot |
+| `eval` | Execute JS in the page, return result |
+| `click` / `type` / `wait` / `seq` | Interaction primitives |
+| `diff` | Pixel-level diff vs a reference PNG |
+| `viewports` | List all registered viewport presets |
+| `shoot` | Rich capture (overlays, freeze, camera, plugins) |
+| `layer` | Capture one isolated layer (entity/hud/ui/terrain) |
+| `frames` | N-frame animation timeline at interval |
+| `hover` | Hover state capture |
+| `sweep` | Batched capture plan -> HTML report + CI output |
+| `audit` | axe-core WCAG accessibility audit + highlighted screenshot |
+| `dom` / `dom-snapshot` | Serialized DOM + CSS selectors + XPath + bounding rects |
+| `every-viewport` | Capture once per preset in parallel (3-wide pool) |
+| `baseline` | save / list / approve / show visual baselines |
+| `auth` | save / load / list / delete Playwright storageState |
+| `validate` | Validate a sweep plan JSON without running it |
+
+## MCP Server
+
+`pursr-mcp` exposes every capability as MCP tools over stdio - works with Claude Code, Cursor, Continue, and any MCP host.
+
+```bash
+npx pursr-mcp
+# or with verbose logging:
+npx pursr-mcp --verbose
+```
+
+### Exposed Tools
+
+| Tool | Description |
+| --- | --- |
+| `pursr_shoot` | Rich screenshot capture (viewport, grid, layer, cursor, camera, animation freeze, HAR) |
+| `pursr_diff` | Pixel-diff a URL against a reference PNG |
+| `pursr_sweep` | Execute a batch sweep plan |
+| `pursr_frames` | Capture an N-frame animation timeline |
+| `pursr_probe` | Health-check a URL |
+| `pursr_audit` | axe-core WCAG audit + highlighted screenshot |
+| `pursr_dom_snapshot` | Full DOM + selector map snapshot |
+
+### Exposed Resources
+
+| URI | Description |
+| --- | --- |
+| `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`).
+
+## Visual Regression Baselines
+
+```bash
+pursr baseline save myapp ./out/shoot.png home --url https://my.app
+pursr baseline approve myapp ./out/shoot.png home --url https://my.app
+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.
+
+```js
+import { diffKey, saveBaseline, loadBaseline } from "pursr/baseline";
+const id = diffKey({ url: "https://my.app", viewport: { width: 1280, height: 800, dpr: 1 }, flags: { preset: "desktop-1280" } });
+saveBaseline({ project: "myapp", id, step: "home", png: "./shot.png", meta: { url: "https://my.app" } });
+```
+
+## Sweep Plan Validation
+
+```bash
+pursr validate ./plan.json
+# { "valid": false, "errors": ["steps[2].frames.count: must be a number between 1 and 120"] }
+```
+
+Catches: empty steps, unknown ops, out-of-range numbers, duplicate names, missing required fields. `pursr sweep` runs the same validator before executing - fail-fast.
+
+```json
+{
+  "name": "homepage-matrix",
+  "base": "https://example.com",
+  "parallel": 4,
+  "steps": [
+    { "name": "baseline",   "shoot":  { "preset": "desktop-1280" } },
+    { "name": "grid-64",    "shoot":  { "preset": "desktop-1280", "grid": true, "grid-tile": 64 } },
+    { "name": "tablet",     "shoot":  { "preset": "tablet-768" } },
+    { "name": "mobile",     "shoot":  { "preset": "mobile-375" } },
+    { "name": "hover-cta",  "hover":  { "selector": ["text=Get started", "a.btn-primary"] } },
+    { "name": "audit",      "audit":  { "tags": "wcag2a,wcag2aa" } },
+    { "name": "diff",       "diff":   { "ref": "baseline" } }
+  ]
+}
+```
+
+## HAR Capture
+
+```bash
+pursr shoot https://example.com shot.png --har ./out/req.har.json
+```
+
+```js
+import { startHarCapture, stopHarCapture, writeHar } from "pursr/har";
+const state = await startHarCapture(page);
+await page.goto(url);
+const har = stopHarCapture(page);
+await writeHar(har, "./out/req.har.json");
+```
+
+Output is HAR 1.2 spec - pipe to `har-cli`, perf-tools, or any visualizer.
+
+## Auth State
+
+```bash
+pursr auth save myapp admin --from ./playwright-state.json
+pursr shoot https://my.app/dashboard shot.png --auth-state admin --auth-project myapp
+pursr auth list myapp
+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 }`.
+
+## Parallel Sweep
+
+Add `parallel: N` to your plan to run steps concurrently in a worker pool:
+
+```json
+{
+  "name": "matrix",
+  "base": "https://my.app",
+  "parallel": 4,
+  "steps": [
+    { "name": "home",    "shoot": { "preset": "desktop-1280" } },
+    { "name": "pricing", "shoot": { "preset": "desktop-1280" } },
+    { "name": "docs",    "shoot": { "preset": "desktop-1280" } }
+  ]
+}
+```
+
+Steps run in a shared browser context; results are still ordered by index in the summary. Defaults to serial (`parallel: 1`) - opt in only when steps are independent.
+
+## Accessibility Audit
+
+```bash
+pursr audit https://example.com --tags wcag2a,wcag2aa
+# Writes: audit.json, audit-summary.md, audit-highlighted.png
+```
+
+Injects axe-core, runs a configurable tag set (`wcag2a`, `wcag2aa`, `wcag21a`, `wcag21aa`, `best-practice`), and overlays a red outline on every violating node with the rule id as a label. The summary Markdown includes per-rule failure snippets.
+
+## DOM Snapshot
+
+```bash
+pursr dom https://example.com
+# Writes: dom-snapshot-<ts>.dom.json
+```
+
+Captures serialized HTML, computed CSS for every visible element, and a selector map (`id`, `role`, `accessible name`, `text`, `xpath`, `css selector`, viewport-relative `rect`). Great for regression diffing without re-running a browser.
+
+## CI Output
+
+Every sweep writes three sidecar artifacts alongside `sweep.json`:
+
+- `sweep.junit.xml` - JUnit XML for Jenkins / GitLab / CircleCI
+- `sweep.github.json` - GitHub Actions annotation file
+- `sweep.md` - Human-readable Markdown summary with diffs + failures
+
+## Library API
+
+```js
+import {
+  runProbe, runShot, runShoot, runSweep, runDiff, runAudit,
+  captureDomSnapshot, resolveHealedSelector,
+  saveBaseline, diffKey,
+  startHarCapture, stopHarCapture, writeHar,
+  loadAuthState,
+  PursorMCPServer, loadMcpConfig,
+  validateSweepPlan,
+  listResources, readResource,
+  listViewports, resolveViewport, VIEWPORTS,
+  loadPlugins, registerPlugin, getSweepOp,
+  VERSION,
+} from "pursr";
+```
+
+### Subpath exports
+
+```js
+import { resolveLocator } from "pursr/selector";
+import { launch } from "pursr/runway";
+import { parseFlags, asNum } from "pursr/util";
+import { overlayGrid } from "pursr/overlays";
+import { captureDomSnapshot } from "pursr/dom-snapshot";
+import { runAudit } from "pursr/plugin-audit";
+import { resolveHealedSelector } from "pursr/selector-heal";
+import { writeCiOutput } from "pursr/ci-output";
+import { diffKey, saveBaseline, loadBaseline } from "pursr/baseline";
+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";
+```
+
+## Plugins
+
+A plugin is a plain ES module that exports a default object:
+
+```js
+// plugins/my-plugin.js
+export default {
+  name: "my-plugin",
+  viewport: { "my-laptop": { width: 1440, height: 900, dpr: 2, label: "MBP 14" } },
+  sweepOp: {
+    lighthouse: async (ctx, opts) => { /* ... */ },
+  },
+  beforeShoot: async (ctx) => { /* mutate ctx.flags / ctx.viewport */ },
+  afterShoot:  async (ctx, meta) => { /* augment sidecar */ },
+  flagHelp:    { "my-flag": "what it does" },
+};
+```
+
+Plugins are auto-loaded from `plugins/` (built-in) or via `--plugin <path>`.
+
+## Architecture
+
+```
+src/
+  index.js          - public library entry
+  mcp.js            - MCP stdio server (JSON-RPC 2.0)
+  shoot.js          - runShoot (overlays + camera + frame-stable)
+  sweep.js          - runSweep (validated, parallel pool)
+  diff.js           - pixelmatch wrapper
+  plugin-audit.js   - axe-core injection + highlighted screenshot
+  dom-snapshot.js   - full DOM + CSSOM + selector map
+  selector-heal.js  - auto-heal chain resolver
+  ci-output.js      - JUnit / GitHub / Markdown
+  baseline.js       - visual regression storage
+  har.js            - HAR 1.2 network capture
+  auth.js           - Playwright storageState
+  sweep-schema.js   - plan validator
+  mcp-resources.js  - MCP resources adapter
+  overlays.js       - page-side CSS overlays + camera
+  runway.js         - Playwright launcher + system-Chrome detector
+  viewport.js       - built-in viewport presets
+  selector.js       - text=/role=/aria=/placeholder= parser
+  plugin.js         - plugin registry + hook runner
+  util.js           - flags, args, hashing, HTML escape, renderSweepHtml
+  every-viewport.js - one shot per preset in parallel
+  frames.js, hover.js, shot.js, eval.js, probe.js, interact.js
+```
+
+## Development
+
+```bash
+git clone https://github.com/0xheycat/pursr
+cd pursr
+npm install
+npm install --save-dev playwright-core
+npm test
+```
+
+`npm test` runs 47 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/           - 25 modules
+test/          - 47 tests, 0 failures
+plugins/       - 2 built-in plugins, auto-loaded
+```
+
+## Roadmap
+
+- [x] Visual baselines (save / approve / diff)
+- [x] Sweep plan schema validation
+- [x] MCP resources (browse past captures from your AI host)
+- [x] HAR 1.2 capture
+- [x] Auth state (Playwright storageState)
+- [x] Parallel sweep workers
+- [ ] Watch mode (`pursr watch <url>`)
+- [ ] Component-level snapshot (`pursr snap <selector>`)
+- [ ] PDF report export
+- [ ] Cloud output adapters (S3 / GCS)
+- [ ] AI diff summary (vision model)
+
+## License
+
+MIT (c) 2026 - [0xheycat](https://github.com/0xheycat)

package/assets/icon.svg

@@ -0,0 +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>

package/assets/logo.svg

@@ -0,0 +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>

package/assets/social-preview.svg

@@ -0,0 +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>

package/bin/pursr-mcp.mjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+// @purr/visual — MCP server binary.
+//
+// Runs the pursor 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
+//
+//   echo '{"url":"https://example.com"}' | pursor-mcp
+
+import { PursorMCPServer, loadConfig } from "../src/mcp.js";
+
+const config = loadConfig();
+
+// Verbose mode: --verbose or debug env
+const verbose = process.argv.includes("--verbose") || !!process.env.PURSOR_DEBUG;
+config.verbose = verbose;
+
+const server = new PursorMCPServer(config);
+await server.start();