pursr 0.10.0 → 0.10.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pursr",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "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",
@@ -35,6 +35,9 @@
     "./mcp-resources": "./src/mcp-resources.js",
     "./har": "./src/har.js",
     "./auth": "./src/auth.js",
+    "./browser-discovery": "./src/browser-discovery.js",
+    "./doctor": "./src/doctor.js",
+    "./update-notifier": "./src/update-notifier.js",
     "./watch": "./src/watch.js",
     "./snap": "./src/snap.js",
     "./report": "./src/report.js",
@@ -49,6 +52,7 @@
     "plugins",
     "plans",
     "assets",
+    "SKILL.md",
     "README.md",
     "LICENSE"
   ],

package/src/browser-discovery.js

@@ -0,0 +1,196 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { posix, win32 } from "node:path";
+
+function uniq(list) {
+  return [...new Set(list.filter(Boolean).map(String))];
+}
+
+function envPath(env, key) {
+  return env && env[key] ? String(env[key]) : "";
+}
+
+function pathJoin(platform, ...parts) {
+  return platform === "win32" ? win32.join(...parts) : posix.join(...parts);
+}
+
+function joinIf(platform, base, ...parts) {
+  return base ? pathJoin(platform, base, ...parts) : "";
+}
+
+function pathExecutableCandidates(env, names, platform) {
+  const pathValue = envPath(env, "PATH");
+  if (!pathValue) return [];
+  const dirs = pathValue.split(platform === "win32" ? ";" : ":").filter(Boolean);
+  const exts = platform === "win32"
+    ? (envPath(env, "PATHEXT") || ".EXE;.CMD;.BAT").split(";").filter(Boolean)
+    : [""];
+  const out = [];
+  for (const dir of dirs) {
+    for (const name of names) {
+      if (platform === "win32" && /\.[a-z0-9]+$/i.test(name)) out.push(pathJoin(platform, dir, name));
+      else for (const ext of exts) out.push(pathJoin(platform, dir, name + ext.toLowerCase()));
+    }
+  }
+  return out;
+}
+
+export function browserCandidates(options = {}) {
+  const platform = options.platform || process.platform;
+  const env = options.env || process.env;
+  const home = options.homeDir || homedir();
+  const localAppData = envPath(env, "LOCALAPPDATA");
+  const programFiles = envPath(env, "ProgramFiles") || "C:\\Program Files";
+  const programFilesX86 = envPath(env, "ProgramFiles(x86)") || "C:\\Program Files (x86)";
+
+  const explicit = [
+    envPath(env, "PURSR_BROWSER_PATH"),
+    envPath(env, "CHROME_PATH"),
+    envPath(env, "PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH"),
+  ];
+
+  if (platform === "win32") {
+    const pathNames = [
+      "chrome.exe", "msedge.exe", "brave.exe", "chromium.exe",
+    ];
+    return uniq([
+      ...explicit,
+      pathJoin(platform, programFiles, "Google", "Chrome", "Application", "chrome.exe"),
+      pathJoin(platform, programFilesX86, "Google", "Chrome", "Application", "chrome.exe"),
+      joinIf(platform, localAppData, "Google", "Chrome", "Application", "chrome.exe"),
+      pathJoin(platform, programFiles, "Google", "Chrome Beta", "Application", "chrome.exe"),
+      pathJoin(platform, programFilesX86, "Google", "Chrome Beta", "Application", "chrome.exe"),
+      joinIf(platform, localAppData, "Google", "Chrome Beta", "Application", "chrome.exe"),
+      pathJoin(platform, programFiles, "Google", "Chrome Dev", "Application", "chrome.exe"),
+      pathJoin(platform, programFilesX86, "Google", "Chrome Dev", "Application", "chrome.exe"),
+      joinIf(platform, localAppData, "Google", "Chrome Dev", "Application", "chrome.exe"),
+      joinIf(platform, localAppData, "Google", "Chrome SxS", "Application", "chrome.exe"),
+      pathJoin(platform, programFiles, "Microsoft", "Edge", "Application", "msedge.exe"),
+      pathJoin(platform, programFilesX86, "Microsoft", "Edge", "Application", "msedge.exe"),
+      joinIf(platform, localAppData, "Microsoft", "Edge", "Application", "msedge.exe"),
+      pathJoin(platform, programFiles, "Microsoft", "Edge Beta", "Application", "msedge.exe"),
+      pathJoin(platform, programFilesX86, "Microsoft", "Edge Beta", "Application", "msedge.exe"),
+      joinIf(platform, localAppData, "Microsoft", "Edge Beta", "Application", "msedge.exe"),
+      pathJoin(platform, programFiles, "Microsoft", "Edge Dev", "Application", "msedge.exe"),
+      pathJoin(platform, programFilesX86, "Microsoft", "Edge Dev", "Application", "msedge.exe"),
+      joinIf(platform, localAppData, "Microsoft", "Edge Dev", "Application", "msedge.exe"),
+      pathJoin(platform, programFiles, "Microsoft", "Edge SxS", "Application", "msedge.exe"),
+      pathJoin(platform, programFilesX86, "Microsoft", "Edge SxS", "Application", "msedge.exe"),
+      joinIf(platform, localAppData, "Microsoft", "Edge SxS", "Application", "msedge.exe"),
+      pathJoin(platform, programFiles, "BraveSoftware", "Brave-Browser", "Application", "brave.exe"),
+      pathJoin(platform, programFilesX86, "BraveSoftware", "Brave-Browser", "Application", "brave.exe"),
+      joinIf(platform, localAppData, "BraveSoftware", "Brave-Browser", "Application", "brave.exe"),
+      pathJoin(platform, programFiles, "BraveSoftware", "Brave-Browser-Beta", "Application", "brave.exe"),
+      pathJoin(platform, programFilesX86, "BraveSoftware", "Brave-Browser-Beta", "Application", "brave.exe"),
+      joinIf(platform, localAppData, "BraveSoftware", "Brave-Browser-Beta", "Application", "brave.exe"),
+      pathJoin(platform, programFiles, "BraveSoftware", "Brave-Browser-Nightly", "Application", "brave.exe"),
+      pathJoin(platform, programFilesX86, "BraveSoftware", "Brave-Browser-Nightly", "Application", "brave.exe"),
+      joinIf(platform, localAppData, "BraveSoftware", "Brave-Browser-Nightly", "Application", "brave.exe"),
+      pathJoin(platform, programFiles, "Chromium", "Application", "chrome.exe"),
+      pathJoin(platform, programFilesX86, "Chromium", "Application", "chrome.exe"),
+      ...pathExecutableCandidates(env, pathNames, platform),
+    ]);
+  }
+
+  if (platform === "darwin") {
+    return uniq([
+      ...explicit,
+      "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+      pathJoin(platform, home, "Applications", "Google Chrome.app", "Contents", "MacOS", "Google Chrome"),
+      "/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta",
+      pathJoin(platform, home, "Applications", "Google Chrome Beta.app", "Contents", "MacOS", "Google Chrome Beta"),
+      "/Applications/Google Chrome Dev.app/Contents/MacOS/Google Chrome Dev",
+      pathJoin(platform, home, "Applications", "Google Chrome Dev.app", "Contents", "MacOS", "Google Chrome Dev"),
+      "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary",
+      pathJoin(platform, home, "Applications", "Google Chrome Canary.app", "Contents", "MacOS", "Google Chrome Canary"),
+      "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+      "/Applications/Microsoft Edge Beta.app/Contents/MacOS/Microsoft Edge Beta",
+      "/Applications/Microsoft Edge Dev.app/Contents/MacOS/Microsoft Edge Dev",
+      "/Applications/Microsoft Edge Canary.app/Contents/MacOS/Microsoft Edge Canary",
+      "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
+      "/Applications/Brave Browser Beta.app/Contents/MacOS/Brave Browser Beta",
+      "/Applications/Brave Browser Nightly.app/Contents/MacOS/Brave Browser Nightly",
+      "/Applications/Chromium.app/Contents/MacOS/Chromium",
+      ...pathExecutableCandidates(env, [
+        "google-chrome", "google-chrome-stable", "google-chrome-beta", "google-chrome-unstable",
+        "chromium", "chromium-browser", "microsoft-edge", "microsoft-edge-beta",
+        "microsoft-edge-dev", "brave-browser", "brave-browser-beta", "brave-browser-nightly",
+      ], platform),
+    ]);
+  }
+
+  return uniq([
+    ...explicit,
+    "/usr/bin/google-chrome",
+    "/usr/bin/google-chrome-stable",
+    "/usr/bin/google-chrome-beta",
+    "/usr/bin/google-chrome-unstable",
+    "/usr/bin/chromium",
+    "/usr/bin/chromium-browser",
+    "/usr/bin/microsoft-edge",
+    "/usr/bin/microsoft-edge-stable",
+    "/usr/bin/microsoft-edge-beta",
+    "/usr/bin/microsoft-edge-dev",
+    "/usr/bin/brave-browser",
+    "/usr/bin/brave-browser-beta",
+    "/usr/bin/brave-browser-nightly",
+    "/snap/bin/chromium",
+    "/snap/bin/brave",
+    ...pathExecutableCandidates(env, [
+      "google-chrome", "google-chrome-stable", "google-chrome-beta", "google-chrome-unstable",
+      "chromium", "chromium-browser", "microsoft-edge", "microsoft-edge-stable",
+      "microsoft-edge-beta", "microsoft-edge-dev", "brave-browser", "brave-browser-beta",
+      "brave-browser-nightly",
+    ], platform),
+  ]);
+}
+
+export function discoverBrowsers(options = {}) {
+  const exists = options.exists || existsSync;
+  const candidates = browserCandidates(options);
+  const found = candidates.filter((path) => {
+    try { return exists(path); } catch { return false; }
+  });
+  return {
+    found,
+    preferred: found[0] || null,
+    candidates,
+    env: {
+      PURSR_BROWSER_PATH: !!(options.env || process.env).PURSR_BROWSER_PATH,
+      CHROME_PATH: !!(options.env || process.env).CHROME_PATH,
+    },
+  };
+}
+
+export function findBrowserExecutable(options = {}) {
+  return discoverBrowsers(options).preferred;
+}
+
+export function browserSetupHints(platform = process.platform) {
+  const common = [
+    "Set PURSR_BROWSER_PATH to a Chrome-compatible executable if auto-detection misses it.",
+    "Install playwright-core in the project when using pursr as a local dependency: npm i -D playwright-core",
+  ];
+  if (platform === "win32") {
+    return [
+      "Install Google Chrome, Microsoft Edge, Brave, or Chromium.",
+      "Dev/Beta/Canary channels and PATH-installed browser executables are also detected when available.",
+      "Windows example: setx PURSR_BROWSER_PATH \"C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe\"",
+      ...common,
+    ];
+  }
+  if (platform === "darwin") {
+    return [
+      "Install Google Chrome, Microsoft Edge, Brave, or Chromium.",
+      "Dev/Beta/Canary channels, user Applications, and PATH-installed browser executables are also detected when available.",
+      "macOS example: export PURSR_BROWSER_PATH=\"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\"",
+      ...common,
+    ];
+  }
+  return [
+    "Install google-chrome-stable, chromium, microsoft-edge-stable, or brave-browser.",
+    "Dev/Beta/unstable channels and PATH-installed browser executables are also detected when available.",
+    "Linux example: export PURSR_BROWSER_PATH=/usr/bin/google-chrome",
+    ...common,
+  ];
+}

package/src/cli-args.js

@@ -0,0 +1,33 @@
+// Order-independent CLI argument parsing for pursr subcommands.
+
+const DEFAULT_BOOLEAN_FLAGS = new Set([
+  "ai", "full", "grid", "help", "json", "no-animation", "no-embed",
+  "no-hud", "no-visual", "update", "visible",
+]);
+
+export function parseCommandArgs(args = [], { booleanFlags = DEFAULT_BOOLEAN_FLAGS } = {}) {
+  const flags = {};
+  const positionals = [];
+  for (let i = 0; i < args.length; i++) {
+    const token = args[i];
+    if (!token?.startsWith("--")) {
+      positionals.push(token);
+      continue;
+    }
+
+    const eq = token.indexOf("=");
+    const key = token.slice(2, eq >= 0 ? eq : undefined);
+    let value;
+    if (eq >= 0) value = token.slice(eq + 1);
+    else if (booleanFlags.has(key)) value = true;
+    else if (i + 1 < args.length && !args[i + 1].startsWith("--")) value = args[++i];
+    else value = true;
+    flags[key] = value;
+  }
+  return { flags, positionals };
+}
+
+export function filePathArg(value) {
+  if (typeof value !== "string") return value;
+  return value.startsWith("@") ? value.slice(1) : value;
+}

package/src/diff.js

@@ -1,6 +1,6 @@
 // Pixelmatch diff against a reference PNG.
 
-import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { launch, newPage } from "./runway.js";
 import { resolveViewport } from "./viewport.js";
@@ -24,7 +24,8 @@ export async function runDiff(url, refPath, out, threshold, flags = {}, browser)
   requireArg("url", url, "string");
   requireArg("refPath", refPath, "string");
   const t = threshold !== undefined ? Number(threshold) : DIFF_DEFAULT_THRESHOLD;
-  if (!existsSync(refPath)) return { url, refPath, error: "reference file not found" };
+  if (!existsSync(refPath)) return { url, refPath, error: "reference file not found" };
+  if (out) mkdirSync(dirname(out), { recursive: true });
   const PNG = await loadPngjs();
   const pixelmatch = await loadPixelmatch();
   const ownBrowser = !browser;

package/src/doctor.js

@@ -0,0 +1,88 @@
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { browserSetupHints, discoverBrowsers } from "./browser-discovery.js";
+import { resolvePlaywrightCore } from "./runway.js";
+
+function nodeMajor(version = process.version) {
+  const m = String(version).match(/^v?(\d+)/);
+  return m ? Number(m[1]) : 0;
+}
+
+function okCheck(name, ok, details = {}) {
+  return { name, ok: !!ok, ...details };
+}
+
+export async function runDoctor(options = {}) {
+  const version = options.version || process.version;
+  const browsers = discoverBrowsers(options);
+  let playwright = null;
+  try {
+    const resolved = await resolvePlaywrightCore();
+    playwright = okCheck("playwright-core", true, { source: resolved.source });
+  } catch (e) {
+    playwright = okCheck("playwright-core", false, { error: e.message });
+  }
+
+  const packageRoot = options.packageRoot || dirname(dirname(fileURLToPath(import.meta.url)));
+  const skillPath = join(packageRoot, "SKILL.md");
+  const checks = [
+    okCheck("node", nodeMajor(version) >= 18, { version, required: ">=18" }),
+    playwright,
+    okCheck("browser", !!browsers.preferred, { preferred: browsers.preferred, found: browsers.found }),
+    okCheck("skill", existsSync(skillPath), { path: skillPath }),
+  ];
+
+  const ok = checks.every((check) => check.ok);
+  return {
+    ok,
+    checks,
+    browsers,
+    hints: ok ? [] : browserSetupHints(options.platform || process.platform),
+  };
+}
+
+export function renderDoctorText(result) {
+  const lines = [];
+  lines.push(result.ok ? "pursr doctor: OK" : "pursr doctor: attention needed");
+  for (const check of result.checks) {
+    const mark = check.ok ? "ok" : "missing";
+    let detail = "";
+    if (check.name === "browser") detail = check.preferred ? ` (${check.preferred})` : "";
+    if (check.name === "playwright-core") detail = check.source ? ` (${check.source})` : check.error ? ` (${check.error})` : "";
+    if (check.name === "node") detail = ` (${check.version}, required ${check.required})`;
+    lines.push(`- ${mark}: ${check.name}${detail}`);
+  }
+  if (result.hints.length) {
+    lines.push("");
+    lines.push("Next steps:");
+    for (const hint of result.hints) lines.push(`- ${hint}`);
+  }
+  return lines.join("\n");
+}
+
+export async function runSetup(options = {}) {
+  const doctor = await runDoctor(options);
+  return {
+    ok: doctor.ok,
+    doctor,
+    recommended: doctor.ok ? [
+      "Run: pursr probe https://example.com",
+      "For agents, point them at node_modules/pursr/SKILL.md or enable the pursr MCP server.",
+    ] : [
+      ...doctor.hints,
+      "After fixing dependencies, run: pursr doctor",
+    ],
+  };
+}
+
+export function renderSetupText(result) {
+  const lines = [];
+  lines.push(result.ok ? "pursr setup: ready" : "pursr setup: manual steps required");
+  lines.push("");
+  lines.push(renderDoctorText(result.doctor));
+  lines.push("");
+  lines.push("Recommended:");
+  for (const item of result.recommended) lines.push(`- ${item}`);
+  return lines.join("\n");
+}

package/src/eval.js

@@ -1,18 +1,24 @@
 // Evaluate a JS string in the page, optionally screenshot after.
 
 import { launch, newPage } from "./runway.js";
-import { DEFAULT_VIEWPORT } from "./viewport.js";
+import { resolveViewport } from "./viewport.js";
 import { gotoOrThrow } from "./overlays.js";
-import { requireArg } from "./util.js";
+import { requireArg } from "./util.js";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
 
-export async function runEval(url, js, out) {
-  requireArg("url", url, "string");
-  const browser = await launch();
-  try {
-    const page = await newPage(browser, DEFAULT_VIEWPORT);
+export async function runEval(url, js, out, flags = {}) {
+  requireArg("url", url, "string");
+  const viewport = resolveViewport(flags);
+  const browser = await launch();
+  try {
+    const page = await newPage(browser, viewport);
     const r = await gotoOrThrow(page, url);
     const result = await page.evaluate(js);
-    if (out) await page.screenshot({ path: out, fullPage: false });
-    return { ...r, url, out, result };
+    if (out) {
+      mkdirSync(dirname(out), { recursive: true });
+      await page.screenshot({ path: out, fullPage: false });
+    }
+    return { ...r, url, out, viewport, result };
   } finally { try { await browser.close(); } catch {} }
-}
+}

package/src/hover.js

@@ -4,7 +4,9 @@ import { launch, newPage } from "./runway.js";
 import { resolveViewport } from "./viewport.js";
 import { gotoOrThrow, settle, CLICK_TIMEOUT_MS } from "./overlays.js";
 import { resolveLocator } from "./selector.js";
-import { asNum, asBool, nowIso, writeSidecar, requireArg } from "./util.js";
+import { asNum, asBool, nowIso, writeSidecar, requireArg } from "./util.js";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
 
 export async function runHover({ url, selector, out, flags = {} }) {
   requireArg("url", url, "string");
@@ -18,9 +20,12 @@ export async function runHover({ url, selector, out, flags = {} }) {
     await loc.first().waitFor({ state: "visible", timeout: CLICK_TIMEOUT_MS });
     await loc.first().hover({ timeout: CLICK_TIMEOUT_MS });
     await page.waitForTimeout(asNum(flags["hover-ms"], 250));
-    if (out) await page.screenshot({ path: out, fullPage: asBool(flags.full, false) });
+    if (out) {
+      mkdirSync(dirname(out), { recursive: true });
+      await page.screenshot({ path: out, fullPage: asBool(flags.full, false) });
+    }
     const meta = { ...r, url, out, selector, viewport, ts: nowIso() };
     if (out) await writeSidecar(meta);
     return meta;
   } finally { try { await browser.close(); } catch {} }
-}
+}

package/src/interact.js

@@ -1,50 +1,56 @@
 // click, type, wait, seq — interaction primitives.
 
 import { launch, newPage } from "./runway.js";
-import { DEFAULT_VIEWPORT } from "./viewport.js";
+import { resolveViewport } from "./viewport.js";
 import { gotoOrThrow, settle, CLICK_TIMEOUT_MS, WAIT_DEFAULT_TIMEOUT_MS } from "./overlays.js";
 import { resolveLocator } from "./selector.js";
-import { requireArg } from "./util.js";
+import { requireArg } from "./util.js";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+
+function ensureScreenshotDir(out) {
+  if (out) mkdirSync(dirname(out), { recursive: true });
+}
 
-export async function runClick(url, selector, out) {
+export async function runClick(url, selector, out, flags = {}) {
   requireArg("url", url, "string");
   requireArg("selector", selector, "string");
   const browser = await launch();
   try {
-    const page = await newPage(browser, DEFAULT_VIEWPORT);
+    const page = await newPage(browser, resolveViewport(flags));
     const r = await gotoOrThrow(page, url); await settle(page);
     const loc = await resolveLocator(page, selector);
     await loc.first().waitFor({ state: "visible", timeout: CLICK_TIMEOUT_MS });
     await loc.first().click({ timeout: CLICK_TIMEOUT_MS });
     await settle(page);
-    if (out) await page.screenshot({ path: out, fullPage: false });
+    if (out) { ensureScreenshotDir(out); await page.screenshot({ path: out, fullPage: false }); }
     return { ...r, url, out, selector, clicked: true };
   } finally { try { await browser.close(); } catch {} }
 }
 
-export async function runType(url, selector, text, out) {
+export async function runType(url, selector, text, out, flags = {}) {
   requireArg("url", url, "string");
   requireArg("selector", selector, "string");
   const browser = await launch();
   try {
-    const page = await newPage(browser, DEFAULT_VIEWPORT);
+    const page = await newPage(browser, resolveViewport(flags));
     const r = await gotoOrThrow(page, url); await settle(page);
     const loc = await resolveLocator(page, selector);
     await loc.first().waitFor({ state: "visible", timeout: CLICK_TIMEOUT_MS });
     await loc.first().click({ timeout: CLICK_TIMEOUT_MS });
     await page.keyboard.type(String(text ?? ""), { delay: 10 });
     await settle(page);
-    if (out) await page.screenshot({ path: out, fullPage: false });
+    if (out) { ensureScreenshotDir(out); await page.screenshot({ path: out, fullPage: false }); }
     return { ...r, url, out, selector, text, typed: true };
   } finally { try { await browser.close(); } catch {} }
 }
 
-export async function runWait(url, selector, timeoutMs) {
+export async function runWait(url, selector, timeoutMs, flags = {}) {
   requireArg("url", url, "string");
   requireArg("selector", selector, "string");
   const browser = await launch();
   try {
-    const page = await newPage(browser, DEFAULT_VIEWPORT);
+    const page = await newPage(browser, resolveViewport(flags));
     const r = await gotoOrThrow(page, url);
     const loc = await resolveLocator(page, selector);
     const t = timeoutMs || WAIT_DEFAULT_TIMEOUT_MS;
@@ -57,7 +63,7 @@ export async function runWait(url, selector, timeoutMs) {
   } finally { try { await browser.close(); } catch {} }
 }
 
-export async function runSeq(url, actionsJson, out) {
+export async function runSeq(url, actionsJson, out, flags = {}) {
   requireArg("url", url, "string");
   let actions;
   try { actions = JSON.parse(actionsJson); }
@@ -66,7 +72,7 @@ export async function runSeq(url, actionsJson, out) {
   if (!actions.length) throw new Error("actions array is empty");
   const browser = await launch();
   try {
-    const page = await newPage(browser, DEFAULT_VIEWPORT);
+    const page = await newPage(browser, resolveViewport(flags));
     const r = await gotoOrThrow(page, url); await settle(page);
     const trace = [];
     let failed = false;
@@ -132,7 +138,7 @@ export async function runSeq(url, actionsJson, out) {
       trace.push(step);
       if (failed) break;
     }
-    if (out) await page.screenshot({ path: out, fullPage: false });
+    if (out) { ensureScreenshotDir(out); await page.screenshot({ path: out, fullPage: false }); }
     return { ...r, url, out, steps: trace, failed };
   } finally { try { await browser.close(); } catch {} }
-}
+}

package/src/runway.js

@@ -1,55 +1,53 @@
-// Browser launcher: auto-detect Playwright + system Chrome.
-
-import { existsSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-
-let _chromium = null;
-async function getChromium() {
-  if (_chromium) return _chromium;
-  // Try local node_modules first
-  try { return _chromium = (await import("playwright-core")).chromium; } catch {}
-  // Try Codex cua_node runtime (current Codex Desktop bundles it).
-  // The cua_node folder has a hash subdir (e.g. 789504f803e82e2b), so we
-  // walk it to find the playwright-core entry.
+// Browser launcher: auto-detect Playwright + system Chrome.
+
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { findBrowserExecutable } from "./browser-discovery.js";
+
+let _chromium = null;
+export async function resolvePlaywrightCore() {
+  if (_chromium) return { chromium: _chromium, source: "cached" };
+  // Try local node_modules first
+  try {
+    _chromium = (await import("playwright-core")).chromium;
+    return { chromium: _chromium, source: "playwright-core" };
+  } catch {}
+  // Try Codex cua_node runtime (current Codex Desktop bundles it).
+  // The cua_node folder has a hash subdir (e.g. 789504f803e82e2b), so we
+  // walk it to find the playwright-core entry.
   const cuaRoot = join(homedir(), "AppData", "Local", "OpenAI", "Codex", "runtimes", "cua_node");
   if (existsSync(cuaRoot)) {
     const { readdirSync } = await import("node:fs");
     const subdirs = (() => { try { return readdirSync(cuaRoot); } catch { return []; } })();
     for (const sub of subdirs) {
       const cand = join(cuaRoot, sub, "bin", "node_modules", "playwright-core", "index.mjs");
-      if (existsSync(cand)) {
-        try {
-          const url = "file:///" + cand.replace(/\\/g, "/");
-          return _chromium = (await import(url)).chromium;
-        } catch {}
-      }
-    }
-  }
-  throw new Error("playwright-core not found. Install it: npm i -D playwright-core");
-}
-
-const CHROME_PATHS = [
-  "C:/Program Files/Google/Chrome/Application/chrome.exe",
-  "C:/Program Files (x86)/Google/Chrome/Application/chrome.exe",
-  "/usr/bin/google-chrome",
-  "/usr/bin/chromium-browser",
-  "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
-];
-function findChrome() {
-  for (const p of CHROME_PATHS) if (existsSync(p)) return p;
-  return null;
-}
-
-const BROWSER_ARGS = Object.freeze(["--no-sandbox", "--disable-gpu", "--disable-dev-shm-usage"]);
-
+      if (existsSync(cand)) {
+        try {
+          const url = "file:///" + cand.replace(/\\/g, "/");
+          _chromium = (await import(url)).chromium;
+          return { chromium: _chromium, source: "codex-cua-node" };
+        } catch {}
+      }
+    }
+  }
+  throw new Error("playwright-core not found. Install it: npm i -D playwright-core");
+}
+
+async function getChromium() {
+  const resolved = await resolvePlaywrightCore();
+  return resolved.chromium;
+}
+
+const BROWSER_ARGS = Object.freeze(["--no-sandbox", "--disable-gpu", "--disable-dev-shm-usage"]);
+
 export async function launch(options = {}) {
   const chromium = await getChromium();
-  const exec = findChrome();
-  if (!exec) throw new Error("system Chrome not found in standard paths");
+  const exec = options.executablePath || findBrowserExecutable();
+  if (!exec) throw new Error("Chrome-compatible browser not found. Run: pursr doctor");
   return await chromium.launch({
     headless: options.headless !== false,
-    executablePath: options.executablePath || exec,
+    executablePath: exec,
     slowMo: Math.max(0, Number(options.slowMo) || 0),
     args: [...BROWSER_ARGS, ...(Array.isArray(options.args) ? options.args : [])],
   });

package/src/shoot.js

@@ -10,10 +10,13 @@ import {
 import { asNum, asBool, nowIso, writeSidecar, requireArg } from "./util.js";
 import { runBeforeShoot, runAfterShoot } from "./plugin.js";
 import { startHarCapture, stopHarCapture, writeHar } from "./har.js";
-import { loadAuthState } from "./auth.js";
+import { loadAuthState } from "./auth.js";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
 
-export async function runShoot({ url, out, flags = {}, prepare, browser: extBrowser }) {
-  requireArg("url", url, "string");
+export async function runShoot({ url, out, flags = {}, prepare, browser: extBrowser }) {
+  requireArg("url", url, "string");
+  if (out) mkdirSync(dirname(out), { recursive: true });
   const viewport = resolveViewport(flags);
   const ownBrowser = !extBrowser;
   const browser = extBrowser || await launch();
@@ -71,4 +74,4 @@ export async function runShootWithSidecar(args) {
   const meta = await runShoot(args);
   await writeSidecar(meta);
   return meta;
-}
+}