@ulpi/browse 1.4.0 → 1.4.4

package/README.md

@@ -327,6 +327,10 @@ browse perf-audit [url]                  # Full performance audit with actionabl
 browse perf-audit [url] --no-coverage    # Skip JS/CSS coverage (faster)
 browse perf-audit [url] --no-detect      # Skip stack detection
 browse perf-audit [url] --json           # Structured JSON output
+browse perf-audit save [name]            # Save audit report for later comparison
+browse perf-audit compare <base> [curr]  # Compare saved baseline vs current or saved audit
+browse perf-audit list                   # List saved audit reports
+browse perf-audit delete <name>          # Delete a saved audit
 browse detect                            # Tech stack fingerprint (frameworks, SaaS, CDN, infra)
 browse coverage start                    # Start JS/CSS code coverage collection
 browse coverage stop                     # Stop and report per-file used/unused bytes
@@ -631,7 +635,7 @@ Use browse to test the login flow. Run browse --help to see available commands.
 
 ## MCP Server Mode
 
-Run browse as an [MCP](https://modelcontextprotocol.io/) server for editors that support the Model Context Protocol.
+Run browse as an [MCP](https://modelcontextprotocol.io/) server for editors that support the Model Context Protocol. All 99 CLI commands are available as MCP tools, including `perf-audit`, `detect`, `coverage`, and `initscript`.
 
 ```bash
 browse --mcp

package/dist/browse.cjs

@@ -828,7 +828,8 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@ulpi/browse",
-      version: "1.4.0",
+      version: "1.4.3",
+      homepage: "https://browse.ulpi.io",
       repository: {
         type: "git",
         url: "https://github.com/ulpi-io/browse"
@@ -1372,9 +1373,9 @@ var init_browser_manager = __esm({
           });
         } catch (err) {
           if (err.message?.includes("Failed to launch") || err.message?.includes("Target closed")) {
-            const fs18 = await import("fs");
+            const fs19 = await import("fs");
             console.error(`[browse] Profile directory corrupted, recreating: ${profileDir}`);
-            fs18.rmSync(profileDir, { recursive: true, force: true });
+            fs19.rmSync(profileDir, { recursive: true, force: true });
             context = await import_playwright.chromium.launchPersistentContext(profileDir, {
               headless: process.env.BROWSE_HEADED !== "1",
               viewport: { width: 1920, height: 1080 }
@@ -2161,8 +2162,8 @@ var init_browser_manager = __esm({
       // ─── Video Recording ──────────────────────────────────────
       async startVideoRecording(dir) {
         if (this.videoRecording) throw new Error("Video recording already active");
-        const fs18 = await import("fs");
-        fs18.mkdirSync(dir, { recursive: true });
+        const fs19 = await import("fs");
+        fs19.mkdirSync(dir, { recursive: true });
         this.videoRecording = { dir, startedAt: Date.now() };
         const viewport = this.currentDevice?.viewport || { width: 1920, height: 1080 };
         await this.recreateContext({
@@ -4257,11 +4258,11 @@ var init_lib = __esm({
           }
         }
       },
-      addToPath: function addToPath(path15, added, removed, oldPosInc, options) {
-        var last = path15.lastComponent;
+      addToPath: function addToPath(path16, added, removed, oldPosInc, options) {
+        var last = path16.lastComponent;
         if (last && !options.oneChangePerToken && last.added === added && last.removed === removed) {
           return {
-            oldPos: path15.oldPos + oldPosInc,
+            oldPos: path16.oldPos + oldPosInc,
             lastComponent: {
               count: last.count + 1,
               added,
@@ -4271,7 +4272,7 @@ var init_lib = __esm({
           };
         } else {
           return {
-            oldPos: path15.oldPos + oldPosInc,
+            oldPos: path16.oldPos + oldPosInc,
             lastComponent: {
               count: 1,
               added,
@@ -5474,15 +5475,15 @@ async function getSuspense(bm, page) {
     if (!roots || roots.size === 0) return "No fiber roots found";
     const root = roots.values().next().value;
     const boundaries = [];
-    const walk = (fiber, path15) => {
+    const walk = (fiber, path16) => {
       if (!fiber) return;
       if (fiber.tag === 13) {
         const resolved = fiber.memoizedState === null;
-        const parent = path15.length > 0 ? path15[path15.length - 1] : "root";
+        const parent = path16.length > 0 ? path16[path16.length - 1] : "root";
         boundaries.push(`Suspense in ${parent} \u2014 ${resolved ? "resolved (children visible)" : "pending (showing fallback)"}`);
       }
       const name = fiber.type?.displayName || fiber.type?.name || null;
-      const newPath = name ? [...path15, name] : path15;
+      const newPath = name ? [...path16, name] : path16;
       let child = fiber.child;
       while (child) {
         walk(child, newPath);
@@ -12649,6 +12650,7 @@ var init_recommendations = __esm({
 // src/perf-audit/formatter.ts
 var formatter_exports = {};
 __export(formatter_exports, {
+  formatAuditDiff: () => formatAuditDiff,
   formatPerfAudit: () => formatPerfAudit
 });
 function ratingFor(metric, value) {
@@ -13062,7 +13064,84 @@ function formatTopRecommendations(report) {
   }
   return lines.join("\n");
 }
-var THRESHOLDS;
+function formatAuditDiff(diff2, json = false) {
+  if (json) return JSON.stringify(diff2, null, 2);
+  return formatTextDiff(diff2);
+}
+function formatTextDiff(diff2) {
+  const sections = [];
+  if (diff2.webVitals.length > 0) {
+    const lines = ["Web Vitals:"];
+    lines.push(
+      `  ${padRight("Metric", 10)} ${padLeft("Baseline", 10)} ${padLeft("Current", 10)} ${padLeft("Delta", 10)}  Verdict`
+    );
+    for (const d of diff2.webVitals) {
+      const baseStr = d.baseline != null ? fmtVal(d.metric, d.baseline) : "---";
+      const currStr = d.current != null ? fmtVal(d.metric, d.current) : "---";
+      const deltaStr = d.deltaMs != null ? fmtDelta(d.metric, d.deltaMs) : "---";
+      const symbol = VERDICT_SYMBOLS[d.verdict];
+      lines.push(
+        `  ${padRight(d.metric.toUpperCase(), 10)} ${padLeft(baseStr, 10)} ${padLeft(currStr, 10)} ${padLeft(deltaStr, 10)}  ${symbol} ${d.verdict}`
+      );
+    }
+    sections.push(lines.join("\n"));
+  }
+  if (diff2.resourceSize.length > 0) {
+    const lines = ["Resources:"];
+    lines.push(
+      `  ${padRight("Type", 10)} ${padLeft("Baseline", 10)} ${padLeft("Current", 10)} ${padLeft("Delta", 10)} ${padLeft("Change", 8)}  Verdict`
+    );
+    for (const d of diff2.resourceSize) {
+      const baseStr = d.baseline != null ? formatBytes2(d.baseline) : "---";
+      const currStr = d.current != null ? formatBytes2(d.current) : "---";
+      const deltaStr = d.deltaMs != null ? fmtBytesDelta(d.deltaMs) : "---";
+      const pctStr = d.deltaPct != null ? `${d.deltaPct > 0 ? "+" : ""}${d.deltaPct.toFixed(1)}%` : "---";
+      const symbol = VERDICT_SYMBOLS[d.verdict];
+      lines.push(
+        `  ${padRight(d.metric, 10)} ${padLeft(baseStr, 10)} ${padLeft(currStr, 10)} ${padLeft(deltaStr, 10)} ${padLeft(pctStr, 8)}  ${symbol} ${d.verdict}`
+      );
+    }
+    sections.push(lines.join("\n"));
+  }
+  const nonTrivialCoverage = diff2.coverage.filter(
+    (d) => d.verdict !== "unchanged" || d.baseline != null || d.current != null
+  );
+  if (nonTrivialCoverage.length > 0) {
+    const lines = ["Coverage:"];
+    lines.push(
+      `  ${padRight("Metric", 16)} ${padLeft("Baseline", 10)} ${padLeft("Current", 10)} ${padLeft("Delta", 10)}  Verdict`
+    );
+    for (const d of nonTrivialCoverage) {
+      const baseStr = d.baseline != null ? `${d.baseline.toFixed(1)}%` : "---";
+      const currStr = d.current != null ? `${d.current.toFixed(1)}%` : "---";
+      const deltaStr = d.deltaMs != null ? `${d.deltaMs > 0 ? "+" : ""}${d.deltaMs.toFixed(1)}pp` : "---";
+      const symbol = VERDICT_SYMBOLS[d.verdict];
+      lines.push(
+        `  ${padRight(d.metric, 16)} ${padLeft(baseStr, 10)} ${padLeft(currStr, 10)} ${padLeft(deltaStr, 10)}  ${symbol} ${d.verdict}`
+      );
+    }
+    sections.push(lines.join("\n"));
+  }
+  const s = diff2.summary;
+  sections.push(
+    `${s.regressions} regression${s.regressions !== 1 ? "s" : ""}, ${s.improvements} improvement${s.improvements !== 1 ? "s" : ""}, ${s.unchanged} unchanged`
+  );
+  return sections.join("\n\n");
+}
+function fmtVal(metric, value) {
+  if (metric === "cls") return value.toFixed(3);
+  return formatMs(value);
+}
+function fmtDelta(metric, delta) {
+  const sign = delta > 0 ? "+" : "";
+  if (metric === "cls") return `${sign}${delta.toFixed(3)}`;
+  return `${sign}${formatMs(delta)}`;
+}
+function fmtBytesDelta(delta) {
+  const sign = delta > 0 ? "+" : "";
+  return `${sign}${formatBytes2(Math.abs(delta))}`;
+}
+var THRESHOLDS, VERDICT_SYMBOLS;
 var init_formatter = __esm({
   "src/perf-audit/formatter.ts"() {
     "use strict";
@@ -13075,10 +13154,261 @@ var init_formatter = __esm({
       ttfb: { good: 800, needsImprovement: 1800 },
       tbt: { good: 200, needsImprovement: 600 }
     };
+    VERDICT_SYMBOLS = {
+      regression: "\u2191",
+      improvement: "\u2193",
+      unchanged: "=",
+      new: "+",
+      missing: "\u2212"
+    };
+  }
+});
+
+// src/perf-audit/persist.ts
+var persist_exports = {};
+__export(persist_exports, {
+  deleteAudit: () => deleteAudit,
+  listAudits: () => listAudits,
+  loadAudit: () => loadAudit,
+  saveAudit: () => saveAudit
+});
+function auditsDir(localDir) {
+  return path12.join(localDir, "audits");
+}
+function auditPath(localDir, name) {
+  return path12.join(auditsDir(localDir), `${sanitizeName(name)}.json`);
+}
+function saveAudit(localDir, name, report) {
+  const dir = auditsDir(localDir);
+  fs14.mkdirSync(dir, { recursive: true });
+  const filePath = auditPath(localDir, name);
+  fs14.writeFileSync(filePath, JSON.stringify(report, null, 2), { mode: 384 });
+  return filePath;
+}
+function loadAudit(localDir, name) {
+  const filePath = auditPath(localDir, name);
+  if (!fs14.existsSync(filePath)) {
+    throw new Error(
+      `Audit not found: ${filePath}. Run "browse perf-audit save ${name}" first.`
+    );
+  }
+  return JSON.parse(fs14.readFileSync(filePath, "utf-8"));
+}
+function listAudits(localDir) {
+  const dir = auditsDir(localDir);
+  if (!fs14.existsSync(dir)) return [];
+  const files = fs14.readdirSync(dir).filter((f) => f.endsWith(".json"));
+  if (files.length === 0) return [];
+  const entries = files.map((file) => {
+    const fp = path12.join(dir, file);
+    const stat = fs14.statSync(fp);
+    return {
+      name: file.replace(".json", ""),
+      sizeBytes: stat.size,
+      date: new Date(stat.mtimeMs).toISOString()
+    };
+  });
+  entries.sort((a, b) => b.date.localeCompare(a.date));
+  return entries;
+}
+function deleteAudit(localDir, name) {
+  const filePath = auditPath(localDir, name);
+  if (!fs14.existsSync(filePath)) {
+    throw new Error(
+      `Audit not found: ${filePath}. Nothing to delete.`
+    );
+  }
+  fs14.unlinkSync(filePath);
+}
+var fs14, path12;
+var init_persist = __esm({
+  "src/perf-audit/persist.ts"() {
+    "use strict";
+    fs14 = __toESM(require("fs"), 1);
+    path12 = __toESM(require("path"), 1);
+    init_sanitize();
+  }
+});
+
+// src/perf-audit/diff.ts
+var diff_exports = {};
+__export(diff_exports, {
+  diffAuditReports: () => diffAuditReports
+});
+function compareMetric(metric, baseline, current, threshold) {
+  if (baseline === null && current === null) {
+    return { metric, baseline, current, verdict: "unchanged" };
+  }
+  if (baseline === null) {
+    return { metric, baseline, current, verdict: "new" };
+  }
+  if (current === null) {
+    return { metric, baseline, current, verdict: "missing" };
+  }
+  const deltaMs = current - baseline;
+  const deltaPct = baseline !== 0 ? deltaMs / baseline * 100 : current !== 0 ? 100 : 0;
+  let verdict = "unchanged";
+  if (deltaMs > threshold) {
+    verdict = "regression";
+  } else if (deltaMs < -threshold) {
+    verdict = "improvement";
+  }
+  return {
+    metric,
+    baseline,
+    current,
+    deltaMs: round(deltaMs),
+    deltaPct: round(deltaPct),
+    verdict
+  };
+}
+function compareResourceSize(metric, baseline, current) {
+  if (baseline === null && current === null) {
+    return { metric, baseline, current, verdict: "unchanged" };
+  }
+  if (baseline === null) {
+    return { metric, baseline, current, verdict: "new" };
+  }
+  if (current === null) {
+    return { metric, baseline, current, verdict: "missing" };
+  }
+  const deltaMs = current - baseline;
+  const deltaPct = baseline !== 0 ? deltaMs / baseline * 100 : current !== 0 ? 100 : 0;
+  let verdict = "unchanged";
+  if (deltaPct > RESOURCE_SIZE_PCT_THRESHOLD) {
+    verdict = "regression";
+  } else if (deltaPct < -RESOURCE_SIZE_PCT_THRESHOLD) {
+    verdict = "improvement";
+  }
+  return {
+    metric,
+    baseline,
+    current,
+    deltaMs: round(deltaMs),
+    deltaPct: round(deltaPct),
+    verdict
+  };
+}
+function compareCoverage(metric, baseline, current) {
+  if (baseline === null && current === null) {
+    return { metric, baseline, current, verdict: "unchanged" };
+  }
+  if (baseline === null) {
+    return { metric, baseline, current, verdict: "new" };
+  }
+  if (current === null) {
+    return { metric, baseline, current, verdict: "missing" };
+  }
+  const deltaPP = current - baseline;
+  const deltaPct = baseline !== 0 ? deltaPP / baseline * 100 : current !== 0 ? 100 : 0;
+  let verdict = "unchanged";
+  if (deltaPP > COVERAGE_PP_THRESHOLD) {
+    verdict = "regression";
+  } else if (deltaPP < -COVERAGE_PP_THRESHOLD) {
+    verdict = "improvement";
+  }
+  return {
+    metric,
+    baseline,
+    current,
+    deltaMs: round(deltaPP),
+    deltaPct: round(deltaPct),
+    verdict
+  };
+}
+function avgUnusedPct(entries) {
+  if (entries.length === 0) return null;
+  let totalBytes = 0;
+  let unusedBytes = 0;
+  for (const e of entries) {
+    totalBytes += e.totalBytes;
+    unusedBytes += e.unusedBytes;
+  }
+  return totalBytes > 0 ? round(unusedBytes / totalBytes * 100) : 0;
+}
+function round(n) {
+  return Math.round(n * 100) / 100;
+}
+function diffAuditReports(baseline, current) {
+  const webVitals = [
+    compareMetric("ttfb", baseline.webVitals.ttfb, current.webVitals.ttfb, WEB_VITALS_THRESHOLDS.ttfb.absolute),
+    compareMetric("fcp", baseline.webVitals.fcp, current.webVitals.fcp, WEB_VITALS_THRESHOLDS.fcp.absolute),
+    compareMetric("lcp", baseline.webVitals.lcp, current.webVitals.lcp, WEB_VITALS_THRESHOLDS.lcp.absolute),
+    compareMetric("cls", baseline.webVitals.cls, current.webVitals.cls, WEB_VITALS_THRESHOLDS.cls.absolute),
+    compareMetric("tbt", baseline.webVitals.tbt, current.webVitals.tbt, WEB_VITALS_THRESHOLDS.tbt.absolute),
+    compareMetric("inp", baseline.webVitals.inp, current.webVitals.inp, WEB_VITALS_THRESHOLDS.inp.absolute)
+  ];
+  const allCategoryKeys = /* @__PURE__ */ new Set([
+    ...Object.keys(baseline.resources.categories),
+    ...Object.keys(current.resources.categories)
+  ]);
+  const resourceSize = [];
+  for (const key of allCategoryKeys) {
+    const baselineBytes = baseline.resources.categories[key]?.totalSizeBytes ?? null;
+    const currentBytes = current.resources.categories[key]?.totalSizeBytes ?? null;
+    resourceSize.push(compareResourceSize(key, baselineBytes, currentBytes));
+  }
+  const coverageDeltas = [];
+  const baselineJsUnused = baseline.coverage ? avgUnusedPct(baseline.coverage.js) : null;
+  const currentJsUnused = current.coverage ? avgUnusedPct(current.coverage.js) : null;
+  coverageDeltas.push(compareCoverage("js-unused-pct", baselineJsUnused, currentJsUnused));
+  const baselineCssUnused = baseline.coverage ? avgUnusedPct(baseline.coverage.css) : null;
+  const currentCssUnused = current.coverage ? avgUnusedPct(current.coverage.css) : null;
+  coverageDeltas.push(compareCoverage("css-unused-pct", baselineCssUnused, currentCssUnused));
+  const fixableCount = {
+    baseline: baseline.fixable.length,
+    current: current.fixable.length,
+    delta: current.fixable.length - baseline.fixable.length
+  };
+  const allDeltas = [...webVitals, ...resourceSize, ...coverageDeltas];
+  let regressions = 0;
+  let improvements = 0;
+  let unchanged = 0;
+  for (const d of allDeltas) {
+    switch (d.verdict) {
+      case "regression":
+        regressions++;
+        break;
+      case "improvement":
+        improvements++;
+        break;
+      case "unchanged":
+        unchanged++;
+        break;
+    }
+  }
+  return {
+    webVitals,
+    resourceSize,
+    coverage: coverageDeltas,
+    fixableCount,
+    summary: { regressions, improvements, unchanged }
+  };
+}
+var WEB_VITALS_THRESHOLDS, RESOURCE_SIZE_PCT_THRESHOLD, COVERAGE_PP_THRESHOLD;
+var init_diff = __esm({
+  "src/perf-audit/diff.ts"() {
+    "use strict";
+    WEB_VITALS_THRESHOLDS = {
+      ttfb: { absolute: 100 },
+      fcp: { absolute: 100 },
+      lcp: { absolute: 200 },
+      cls: { absolute: 0.05 },
+      tbt: { absolute: 100 },
+      inp: { absolute: 50 }
+    };
+    RESOURCE_SIZE_PCT_THRESHOLD = 10;
+    COVERAGE_PP_THRESHOLD = 5;
   }
 });
 
 // src/commands/meta.ts
+function padR(str, w) {
+  return str.length >= w ? str : str + " ".repeat(w - str.length);
+}
+function padL(str, w) {
+  return str.length >= w ? str : " ".repeat(w - str.length) + str;
+}
 async function handleMetaCommand(command, args, bm, shutdown2, sessionManager2, currentSession) {
   switch (command) {
     // ─── Tabs ──────────────────────────────────────────
@@ -13160,7 +13490,7 @@ async function handleMetaCommand(command, args, bm, shutdown2, sessionManager2,
           const lines = entries.map(
             (e) => `[${new Date(e.timestamp).toISOString()}] [${e.level}] ${e.text}`
           ).join("\n") + "\n";
-          fs14.appendFileSync(consolePath, lines);
+          fs15.appendFileSync(consolePath, lines);
           buffers.lastConsoleFlushed = buffers.consoleTotalAdded;
         }
         const newNetworkCount = buffers.networkTotalAdded - buffers.lastNetworkFlushed;
@@ -13170,7 +13500,7 @@ async function handleMetaCommand(command, args, bm, shutdown2, sessionManager2,
           const lines = entries.map(
             (e) => `[${new Date(e.timestamp).toISOString()}] ${e.method} ${e.url} \u2192 ${e.status || "pending"} (${e.duration || "?"}ms, ${e.size || "?"}B)`
           ).join("\n") + "\n";
-          fs14.appendFileSync(networkPath, lines);
+          fs15.appendFileSync(networkPath, lines);
           buffers.lastNetworkFlushed = buffers.networkTotalAdded;
         }
       }
@@ -13187,22 +13517,22 @@ async function handleMetaCommand(command, args, bm, shutdown2, sessionManager2,
       const statesDir = `${LOCAL_DIR}/states`;
       const statePath = `${statesDir}/${name}.json`;
       if (subcommand === "list") {
-        if (!fs14.existsSync(statesDir)) return "(no saved states)";
-        const files = fs14.readdirSync(statesDir).filter((f) => f.endsWith(".json"));
+        if (!fs15.existsSync(statesDir)) return "(no saved states)";
+        const files = fs15.readdirSync(statesDir).filter((f) => f.endsWith(".json"));
         if (files.length === 0) return "(no saved states)";
         const lines = [];
         for (const file of files) {
           const fp = `${statesDir}/${file}`;
-          const stat = fs14.statSync(fp);
+          const stat = fs15.statSync(fp);
           lines.push(`  ${file.replace(".json", "")}  ${stat.size}B  ${new Date(stat.mtimeMs).toISOString()}`);
         }
         return lines.join("\n");
       }
       if (subcommand === "show") {
-        if (!fs14.existsSync(statePath)) {
+        if (!fs15.existsSync(statePath)) {
           throw new Error(`State file not found: ${statePath}`);
         }
-        const data = JSON.parse(fs14.readFileSync(statePath, "utf-8"));
+        const data = JSON.parse(fs15.readFileSync(statePath, "utf-8"));
         const cookieCount = data.cookies?.length || 0;
         const originCount = data.origins?.length || 0;
         const storageItems = (data.origins || []).reduce((sum, o) => sum + (o.localStorage?.length || 0), 0);
@@ -13227,15 +13557,15 @@ async function handleMetaCommand(command, args, bm, shutdown2, sessionManager2,
         const context = bm.getContext();
         if (!context) throw new Error("No browser context");
         const state = await context.storageState();
-        fs14.mkdirSync(statesDir, { recursive: true });
-        fs14.writeFileSync(statePath, JSON.stringify(state, null, 2), { mode: 384 });
+        fs15.mkdirSync(statesDir, { recursive: true });
+        fs15.writeFileSync(statePath, JSON.stringify(state, null, 2), { mode: 384 });
         return `State saved: ${statePath}`;
       }
       if (subcommand === "load") {
-        if (!fs14.existsSync(statePath)) {
+        if (!fs15.existsSync(statePath)) {
           throw new Error(`State file not found: ${statePath}. Run "browse state save ${name}" first.`);
         }
-        const stateData = JSON.parse(fs14.readFileSync(statePath, "utf-8"));
+        const stateData = JSON.parse(fs15.readFileSync(statePath, "utf-8"));
         const context = bm.getContext();
         if (!context) throw new Error("No browser context");
         const warnings = [];
@@ -13394,9 +13724,9 @@ ${legend.join("\n")}`;
       try {
         for (const vp of viewports) {
           await page.setViewportSize({ width: vp.width, height: vp.height });
-          const path15 = `${prefix}-${vp.name}.png`;
-          await page.screenshot({ path: path15, fullPage: true });
-          results.push(`${vp.name} (${vp.width}x${vp.height}): ${path15}`);
+          const path16 = `${prefix}-${vp.name}.png`;
+          await page.screenshot({ path: path16, fullPage: true });
+          results.push(`${vp.name} (${vp.width}x${vp.height}): ${path16}`);
         }
       } finally {
         if (originalViewport) {
@@ -13540,13 +13870,13 @@ ${legend.join("\n")}`;
       const diffArgs = args.filter((a) => a !== "--full");
       const baseline = diffArgs[0];
       if (!baseline) throw new Error("Usage: browse screenshot-diff <baseline> [current] [--threshold 0.1] [--full]");
-      if (!fs14.existsSync(baseline)) throw new Error(`Baseline file not found: ${baseline}`);
+      if (!fs15.existsSync(baseline)) throw new Error(`Baseline file not found: ${baseline}`);
       let thresholdPct = 0.1;
       const threshIdx = diffArgs.indexOf("--threshold");
       if (threshIdx !== -1 && diffArgs[threshIdx + 1]) {
         thresholdPct = parseFloat(diffArgs[threshIdx + 1]);
       }
-      const baselineBuffer = fs14.readFileSync(baseline);
+      const baselineBuffer = fs15.readFileSync(baseline);
       let currentBuffer;
       let currentPath;
       for (let i = 1; i < diffArgs.length; i++) {
@@ -13560,8 +13890,8 @@ ${legend.join("\n")}`;
         }
       }
       if (currentPath) {
-        if (!fs14.existsSync(currentPath)) throw new Error(`Current screenshot not found: ${currentPath}`);
-        currentBuffer = fs14.readFileSync(currentPath);
+        if (!fs15.existsSync(currentPath)) throw new Error(`Current screenshot not found: ${currentPath}`);
+        currentBuffer = fs15.readFileSync(currentPath);
       } else {
         const page = bm.getPage();
         currentBuffer = await page.screenshot({ fullPage: isFullPageDiff });
@@ -13571,7 +13901,7 @@ ${legend.join("\n")}`;
       const extIdx = baseline.lastIndexOf(".");
       const diffPath = extIdx > 0 ? baseline.slice(0, extIdx) + "-diff" + baseline.slice(extIdx) : baseline + "-diff.png";
       if (!result.passed && result.diffImage) {
-        fs14.writeFileSync(diffPath, result.diffImage);
+        fs15.writeFileSync(diffPath, result.diffImage);
       }
       return [
         `Pixels: ${result.totalPixels}`,
@@ -13707,7 +14037,7 @@ ${legend.join("\n")}`;
         const { formatAsHar: formatAsHar2 } = await Promise.resolve().then(() => (init_har(), har_exports));
         const har = formatAsHar2(sessionBuffers.networkBuffer, recording.startTime);
         const harPath = args[1] || (currentSession ? `${currentSession.outputDir}/recording.har` : `${LOCAL_DIR}/browse-recording.har`);
-        fs14.writeFileSync(harPath, JSON.stringify(har, null, 2));
+        fs15.writeFileSync(harPath, JSON.stringify(har, null, 2));
         const entryCount = har.log.entries.length;
         return `HAR saved: ${harPath} (${entryCount} entries)`;
       }
@@ -13957,7 +14287,7 @@ ${snapshot}`;
           throw new Error(`Unknown format: ${format}. Use "browse" (chain JSON) or "replay" (Playwright/Puppeteer).`);
         }
         if (filePath) {
-          fs14.writeFileSync(filePath, output);
+          fs15.writeFileSync(filePath, output);
           return `Exported ${steps.length} steps as ${format}: ${filePath}`;
         }
         return output;
@@ -14199,29 +14529,119 @@ ${lines.join("\n")}
       return lines.join("\n");
     }
     case "perf-audit": {
-      const flags = new Set(args.filter((a) => a.startsWith("--")));
-      const positionalArgs = args.filter((a) => !a.startsWith("--"));
-      const url = positionalArgs[0];
-      const options = {
-        includeCoverage: !flags.has("--no-coverage"),
-        includeDetection: !flags.has("--no-detect")
-      };
-      const jsonOutput = flags.has("--json");
-      if (url) {
-        const { handleWriteCommand: handleWriteCommand2 } = await Promise.resolve().then(() => (init_write(), write_exports));
-        await handleWriteCommand2("goto", [url], bm, currentSession?.domainFilter);
+      const subcommand = args[0];
+      if (subcommand === "save") {
+        const subArgs = args.slice(1);
+        const flags = new Set(subArgs.filter((a) => a.startsWith("--")));
+        const positionalArgs = subArgs.filter((a) => !a.startsWith("--"));
+        const jsonOutput = flags.has("--json");
+        const options = {
+          includeCoverage: !flags.has("--no-coverage"),
+          includeDetection: !flags.has("--no-detect")
+        };
+        let name;
+        let url;
+        for (const arg of positionalArgs) {
+          if (arg.startsWith("http://") || arg.startsWith("https://")) {
+            url = arg;
+          } else {
+            name = arg;
+          }
+        }
+        if (url) {
+          const { handleWriteCommand: handleWriteCommand2 } = await Promise.resolve().then(() => (init_write(), write_exports));
+          await handleWriteCommand2("goto", [url], bm, currentSession?.domainFilter);
+        }
+        const { runPerfAudit: runPerfAudit2 } = await Promise.resolve().then(() => (init_perf_audit(), perf_audit_exports));
+        const { formatPerfAudit: formatPerfAudit2 } = await Promise.resolve().then(() => (init_formatter(), formatter_exports));
+        const { saveAudit: saveAudit2 } = await Promise.resolve().then(() => (init_persist(), persist_exports));
+        const networkEntries = currentSession?.buffers?.networkBuffer || [];
+        const report = await runPerfAudit2(bm, networkEntries, options);
+        if (!name) {
+          try {
+            const pageUrl = new URL(bm.getCurrentUrl());
+            const host = pageUrl.hostname.replace(/\./g, "-");
+            const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+            name = `${host}-${date}`;
+          } catch {
+            name = `audit-${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`;
+          }
+        }
+        const filePath = saveAudit2(LOCAL_DIR, name, report);
+        const formatted = formatPerfAudit2(report, jsonOutput);
+        return `${formatted}
+
+Audit saved: ${filePath}`;
+      }
+      if (subcommand === "compare") {
+        if (!args[1]) throw new Error("Usage: browse perf-audit compare <baseline> [current]");
+        const subArgs = args.slice(1);
+        const flags = new Set(subArgs.filter((a) => a.startsWith("--")));
+        const positionalArgs = subArgs.filter((a) => !a.startsWith("--"));
+        const jsonOutput = flags.has("--json");
+        const { loadAudit: loadAudit2 } = await Promise.resolve().then(() => (init_persist(), persist_exports));
+        const { diffAuditReports: diffAuditReports2 } = await Promise.resolve().then(() => (init_diff(), diff_exports));
+        const { formatAuditDiff: formatAuditDiff2 } = await Promise.resolve().then(() => (init_formatter(), formatter_exports));
+        const baseline = loadAudit2(LOCAL_DIR, positionalArgs[0]);
+        let current;
+        if (positionalArgs[1]) {
+          current = loadAudit2(LOCAL_DIR, positionalArgs[1]);
+        } else {
+          const options = {
+            includeCoverage: !flags.has("--no-coverage"),
+            includeDetection: !flags.has("--no-detect")
+          };
+          const { runPerfAudit: runPerfAudit2 } = await Promise.resolve().then(() => (init_perf_audit(), perf_audit_exports));
+          const networkEntries = currentSession?.buffers?.networkBuffer || [];
+          current = await runPerfAudit2(bm, networkEntries, options);
+        }
+        const diff2 = diffAuditReports2(baseline, current);
+        return formatAuditDiff2(diff2, jsonOutput);
+      }
+      if (subcommand === "list") {
+        const { listAudits: listAudits2 } = await Promise.resolve().then(() => (init_persist(), persist_exports));
+        const entries = listAudits2(LOCAL_DIR);
+        if (entries.length === 0) return "(no saved audits)";
+        const lines = [];
+        lines.push(`${padR("Name", 40)} ${padL("Size", 10)} ${"Date"}`);
+        for (const e of entries) {
+          const sizeStr = e.sizeBytes < 1024 ? `${e.sizeBytes}B` : `${Math.round(e.sizeBytes / 1024)}KB`;
+          const dateStr = e.date.slice(0, 19).replace("T", " ");
+          lines.push(`${padR(e.name, 40)} ${padL(sizeStr, 10)} ${dateStr}`);
+        }
+        return lines.join("\n");
+      }
+      if (subcommand === "delete") {
+        if (!args[1]) throw new Error("Usage: browse perf-audit delete <name>");
+        const { deleteAudit: deleteAudit2 } = await Promise.resolve().then(() => (init_persist(), persist_exports));
+        deleteAudit2(LOCAL_DIR, args[1]);
+        return `Audit deleted: ${args[1]}`;
+      }
+      {
+        const flags = new Set(args.filter((a) => a.startsWith("--")));
+        const positionalArgs = args.filter((a) => !a.startsWith("--"));
+        const url = positionalArgs[0];
+        const options = {
+          includeCoverage: !flags.has("--no-coverage"),
+          includeDetection: !flags.has("--no-detect")
+        };
+        const jsonOutput = flags.has("--json");
+        if (url) {
+          const { handleWriteCommand: handleWriteCommand2 } = await Promise.resolve().then(() => (init_write(), write_exports));
+          await handleWriteCommand2("goto", [url], bm, currentSession?.domainFilter);
+        }
+        const { runPerfAudit: runPerfAudit2 } = await Promise.resolve().then(() => (init_perf_audit(), perf_audit_exports));
+        const { formatPerfAudit: formatPerfAudit2 } = await Promise.resolve().then(() => (init_formatter(), formatter_exports));
+        const networkEntries = currentSession?.buffers?.networkBuffer || [];
+        const report = await runPerfAudit2(bm, networkEntries, options);
+        return formatPerfAudit2(report, jsonOutput);
       }
-      const { runPerfAudit: runPerfAudit2 } = await Promise.resolve().then(() => (init_perf_audit(), perf_audit_exports));
-      const { formatPerfAudit: formatPerfAudit2 } = await Promise.resolve().then(() => (init_formatter(), formatter_exports));
-      const networkEntries = currentSession?.buffers?.networkBuffer || [];
-      const report = await runPerfAudit2(bm, networkEntries, options);
-      return formatPerfAudit2(report, jsonOutput);
     }
     default:
       throw new Error(`Unknown meta command: ${command}`);
   }
 }
-var fs14, LOCAL_DIR;
+var fs15, LOCAL_DIR;
 var init_meta = __esm({
   "src/commands/meta.ts"() {
     "use strict";
@@ -14229,7 +14649,7 @@ var init_meta = __esm({
     init_constants();
     init_sanitize();
     init_lib();
-    fs14 = __toESM(require("fs"), 1);
+    fs15 = __toESM(require("fs"), 1);
     LOCAL_DIR = process.env.BROWSE_LOCAL_DIR || "/tmp";
   }
 });
@@ -14631,6 +15051,44 @@ function mapToolCallToCommand(toolName, params) {
       if (params.api_key) args.push(String(params.api_key));
       return { command: "provider", args };
     }
+    // ─── PERFORMANCE AUDIT ──────────────────────────────
+    case "perf-audit": {
+      const args = [];
+      if (params.url) args.push(String(params.url));
+      if (params.no_coverage) args.push("--no-coverage");
+      if (params.no_detect) args.push("--no-detect");
+      if (params.json) args.push("--json");
+      return { command: "perf-audit", args };
+    }
+    case "perf-audit-save": {
+      const args = ["save"];
+      if (params.name) args.push(String(params.name));
+      if (params.url) args.push(String(params.url));
+      if (params.no_coverage) args.push("--no-coverage");
+      if (params.no_detect) args.push("--no-detect");
+      return { command: "perf-audit", args };
+    }
+    case "perf-audit-compare": {
+      const args = ["compare", String(params.baseline)];
+      if (params.current) args.push(String(params.current));
+      if (params.no_coverage) args.push("--no-coverage");
+      if (params.no_detect) args.push("--no-detect");
+      if (params.json) args.push("--json");
+      return { command: "perf-audit", args };
+    }
+    case "perf-audit-list":
+      return { command: "perf-audit", args: ["list"] };
+    case "perf-audit-delete":
+      return { command: "perf-audit", args: ["delete", String(params.name)] };
+    case "detect":
+      return { command: "detect", args: [] };
+    case "coverage":
+      return { command: "coverage", args: [String(params.action)] };
+    case "initscript": {
+      const args = [String(params.action)];
+      if (params.action === "set" && params.code) args.push(String(params.code));
+      return { command: "initscript", args };
+    }
     default:
       throw new Error(`Unknown MCP tool: ${toolName}`);
   }
@@ -15605,6 +16063,103 @@ var init_mcp_tools = __esm({
           },
           required: ["action"]
         }
+      },
+      // ─── Performance Audit ────────────────────────────────────────────
+      {
+        name: "browse_perf_audit",
+        description: "Run a full performance audit on the current page (or a URL). Returns Core Web Vitals (LCP, CLS, TBT, FCP, TTFB, INP), LCP critical path reconstruction, layout shift attribution, long task script attribution, resource breakdown, render-blocking detection, image audit, font audit, DOM complexity, tech stack detection (108 frameworks, 55 SaaS platforms), third-party impact analysis, JS/CSS coverage, and prioritized recommendations. The page is reloaded as part of the audit.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            url: { type: "string", description: "URL to audit. If provided, navigates there first. If omitted, audits the current page." },
+            no_coverage: { type: "boolean", description: "Skip JS/CSS coverage collection (faster audit)." },
+            no_detect: { type: "boolean", description: "Skip framework/SaaS/infrastructure detection." },
+            json: { type: "boolean", description: "Return structured JSON instead of formatted text." }
+          }
+        }
+      },
+      {
+        name: "browse_perf_audit_save",
+        description: "Run a performance audit and save the report to .browse/audits/ for later comparison.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: { type: "string", description: "Name for the saved report. Auto-generated from URL + timestamp if omitted." },
+            url: { type: "string", description: "URL to audit. If omitted, audits the current page." },
+            no_coverage: { type: "boolean", description: "Skip JS/CSS coverage collection (faster audit)." },
+            no_detect: { type: "boolean", description: "Skip framework/SaaS/infrastructure detection." }
+          }
+        }
+      },
+      {
+        name: "browse_perf_audit_compare",
+        description: "Compare a saved audit report against the current page or another saved report. Shows regressions and improvements.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            baseline: { type: "string", description: "Name of the saved baseline audit report." },
+            current: { type: "string", description: "Name of a second saved report to compare against. If omitted, runs a live audit for comparison." },
+            no_coverage: { type: "boolean", description: "Skip JS/CSS coverage collection when running a live audit." },
+            no_detect: { type: "boolean", description: "Skip framework/SaaS/infrastructure detection when running a live audit." },
+            json: { type: "boolean", description: "Return structured JSON instead of formatted text." }
+          },
+          required: ["baseline"]
+        }
+      },
+      {
+        name: "browse_perf_audit_list",
+        description: "List all saved performance audit reports in .browse/audits/.",
+        inputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "browse_perf_audit_delete",
+        description: "Delete a saved performance audit report from .browse/audits/.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: { type: "string", description: "Name of the saved audit report to delete." }
+          },
+          required: ["name"]
+        }
+      },
+      {
+        name: "browse_detect",
+        description: "Detect the technology stack of the current page. Returns frameworks (React, Vue, Angular, Next.js, Laravel, WordPress, Magento, etc. \u2014 108 total with version, build mode, config depth), SaaS platforms (Shopify, Wix, Squarespace, etc. \u2014 55 total with app enumeration and constraints), infrastructure (CDN, protocol, compression, caching, Service Worker), DOM complexity, and third-party inventory (88 known domains classified by category).",
+        inputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "browse_coverage",
+        description: "Collect JS and CSS code coverage. Start collection, navigate/interact with the page, then stop to see per-file used/unused bytes sorted by wasted bytes descending.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            action: { type: "string", description: "Coverage operation.", enum: ["start", "stop"] }
+          },
+          required: ["action"]
+        }
+      },
+      {
+        name: "browse_initscript",
+        description: "Inject JavaScript that runs before every page load (via context.addInitScript). Useful for mocking APIs, injecting polyfills, or setting up performance observers. Scripts persist across navigations and survive device emulation.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            action: { type: "string", description: "Operation to perform.", enum: ["set", "show", "clear"] },
+            code: { type: "string", description: 'JavaScript code to inject (required for "set").' }
+          },
+          required: ["action"]
+        }
+      },
+      {
+        name: "browse_scrollintoview",
+        description: "Scroll an element into view. Alias for scrollinto.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            selector: { type: "string", description: "CSS selector or @ref of the element to scroll into view." }
+          },
+          required: ["selector"]
+        }
       }
     ];
   }
@@ -16025,7 +16580,7 @@ var init_domain_filter = __esm({
 });
 
 // src/session-manager.ts
-var fs15, path12, SessionManager;
+var fs16, path13, SessionManager;
 var init_session_manager = __esm({
   "src/session-manager.ts"() {
     "use strict";
@@ -16035,8 +16590,8 @@ var init_session_manager = __esm({
     init_sanitize();
     init_session_persist();
     init_encryption();
-    fs15 = __toESM(require("fs"), 1);
-    path12 = __toESM(require("path"), 1);
+    fs16 = __toESM(require("fs"), 1);
+    path13 = __toESM(require("path"), 1);
     SessionManager = class {
       sessions = /* @__PURE__ */ new Map();
       browser;
@@ -16091,8 +16646,8 @@ var init_session_manager = __esm({
           }
           return session;
         }
-        const outputDir = path12.join(this.localDir, "sessions", sanitizeName(sessionId));
-        fs15.mkdirSync(outputDir, { recursive: true });
+        const outputDir = path13.join(this.localDir, "sessions", sanitizeName(sessionId));
+        fs16.mkdirSync(outputDir, { recursive: true });
         const buffers = new SessionBuffers();
         const manager = new BrowserManager(buffers);
         await manager.launchWithBrowser(this.browser, this.reuseContext && this.sessions.size === 0);
@@ -16276,7 +16831,7 @@ function flushSessionBuffers(session, final) {
     const lines = newEntries.map(
       (e) => `[${new Date(e.timestamp).toISOString()}] [${e.level}] ${e.text}`
     ).join("\n") + "\n";
-    fs16.appendFileSync(consolePath, lines);
+    fs17.appendFileSync(consolePath, lines);
     buffers.lastConsoleFlushed = buffers.consoleTotalAdded;
   }
   let newNetworkCount = buffers.networkTotalAdded - buffers.lastNetworkFlushed;
@@ -16301,7 +16856,7 @@ function flushSessionBuffers(session, final) {
       const lines = prefix.map(
         (e) => `[${new Date(e.timestamp).toISOString()}] ${e.method} ${e.url} \u2192 ${e.status || "pending"} (${e.duration || "?"}ms, ${e.size || "?"}B)`
       ).join("\n") + "\n";
-      fs16.appendFileSync(networkPath, lines);
+      fs17.appendFileSync(networkPath, lines);
       buffers.lastNetworkFlushed += prefixLen;
     }
   }
@@ -16509,9 +17064,9 @@ async function shutdown() {
   await activeRuntime?.close?.().catch(() => {
   });
   try {
-    const currentState = JSON.parse(fs16.readFileSync(STATE_FILE, "utf-8"));
+    const currentState = JSON.parse(fs17.readFileSync(STATE_FILE, "utf-8"));
     if (currentState.pid === process.pid || currentState.token === AUTH_TOKEN) {
-      fs16.unlinkSync(STATE_FILE);
+      fs17.unlinkSync(STATE_FILE);
     }
   } catch {
   }
@@ -16528,15 +17083,15 @@ async function start() {
     const { BrowserManager: BrowserManager2, getProfileDir: getProfileDir2 } = await Promise.resolve().then(() => (init_browser_manager(), browser_manager_exports));
     const { SessionBuffers: SessionBuffers2 } = await Promise.resolve().then(() => (init_buffers(), buffers_exports));
     const profileDir = getProfileDir2(LOCAL_DIR2, profileName);
-    fs16.mkdirSync(profileDir, { recursive: true });
+    fs17.mkdirSync(profileDir, { recursive: true });
     const bm = new BrowserManager2();
     await bm.launchPersistent(profileDir, () => {
       if (isShuttingDown) return;
       console.error("[browse] Chromium disconnected (profile mode). Shutting down.");
       shutdown();
     });
-    const outputDir = path13.join(LOCAL_DIR2, "sessions", profileName);
-    fs16.mkdirSync(outputDir, { recursive: true });
+    const outputDir = path14.join(LOCAL_DIR2, "sessions", profileName);
+    fs17.mkdirSync(outputDir, { recursive: true });
     profileSession = {
       id: profileName,
       manager: bm,
@@ -16631,7 +17186,7 @@ async function start() {
           const context = session.manager.getContext();
           if (context) {
             try {
-              const stateData = JSON.parse(fs16.readFileSync(stateFilePath, "utf-8"));
+              const stateData = JSON.parse(fs17.readFileSync(stateFilePath, "utf-8"));
               if (stateData.cookies?.length) {
                 await context.addCookies(stateData.cookies);
               }
@@ -16658,7 +17213,7 @@ async function start() {
     port,
     token: AUTH_TOKEN,
     startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    serverPath: path13.resolve(path13.dirname((0, import_url2.fileURLToPath)(__import_meta_url)), "server.ts")
+    serverPath: path14.resolve(path14.dirname((0, import_url2.fileURLToPath)(__import_meta_url)), "server.ts")
   };
   if (profileName) {
     state.profile = profileName;
@@ -16666,12 +17221,12 @@ async function start() {
   if (DEBUG_PORT > 0) {
     state.debugPort = DEBUG_PORT;
   }
-  fs16.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2), { mode: 384 });
+  fs17.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2), { mode: 384 });
   console.log(`[browse] Server running on http://127.0.0.1:${port} (PID: ${process.pid})`);
   console.log(`[browse] State file: ${STATE_FILE}`);
   console.log(`[browse] Idle timeout: ${IDLE_TIMEOUT_MS / 1e3}s`);
 }
-var fs16, path13, crypto3, http, import_url2, net3, AUTH_TOKEN, DEBUG_PORT, BROWSE_PORT, BROWSE_INSTANCE, INSTANCE_SUFFIX, LOCAL_DIR2, STATE_FILE, IDLE_TIMEOUT_MS, sessionManager, browser, profileSession, activeRuntime, isShuttingDown, isRemoteBrowser, policyChecker, READ_COMMANDS2, WRITE_COMMANDS2, META_COMMANDS2, RECORDING_SKIP, PAGE_CONTENT_COMMANDS, BOUNDARY_NONCE, flushInterval, sessionCleanupInterval;
+var fs17, path14, crypto3, http, import_url2, net3, AUTH_TOKEN, DEBUG_PORT, BROWSE_PORT, BROWSE_INSTANCE, INSTANCE_SUFFIX, LOCAL_DIR2, STATE_FILE, IDLE_TIMEOUT_MS, sessionManager, browser, profileSession, activeRuntime, isShuttingDown, isRemoteBrowser, policyChecker, READ_COMMANDS2, WRITE_COMMANDS2, META_COMMANDS2, RECORDING_SKIP, PAGE_CONTENT_COMMANDS, BOUNDARY_NONCE, flushInterval, sessionCleanupInterval;
 var init_server = __esm({
   "src/server.ts"() {
     "use strict";
@@ -16682,8 +17237,8 @@ var init_server = __esm({
     init_meta();
     init_policy();
     init_constants();
-    fs16 = __toESM(require("fs"), 1);
-    path13 = __toESM(require("path"), 1);
+    fs17 = __toESM(require("fs"), 1);
+    path14 = __toESM(require("path"), 1);
     crypto3 = __toESM(require("crypto"), 1);
     http = __toESM(require("http"), 1);
     import_url2 = require("url");
@@ -16873,8 +17428,8 @@ __export(cli_exports, {
   resolveServerScript: () => resolveServerScript
 });
 module.exports = __toCommonJS(cli_exports);
-var fs17 = __toESM(require("fs"), 1);
-var path14 = __toESM(require("path"), 1);
+var fs18 = __toESM(require("fs"), 1);
+var path15 = __toESM(require("path"), 1);
 var import_child_process4 = require("child_process");
 var import_url3 = require("url");
 init_constants();
@@ -16930,50 +17485,50 @@ var INSTANCE_SUFFIX2 = BROWSE_PORT2 ? `-${BROWSE_PORT2}` : BROWSE_INSTANCE2 ? `-
 function resolveLocalDir() {
   if (process.env.BROWSE_LOCAL_DIR) {
     try {
-      fs17.mkdirSync(process.env.BROWSE_LOCAL_DIR, { recursive: true });
+      fs18.mkdirSync(process.env.BROWSE_LOCAL_DIR, { recursive: true });
     } catch {
     }
     return process.env.BROWSE_LOCAL_DIR;
   }
   let dir = process.cwd();
   for (let i = 0; i < 20; i++) {
-    if (fs17.existsSync(path14.join(dir, ".git")) || fs17.existsSync(path14.join(dir, ".claude"))) {
-      const browseDir = path14.join(dir, ".browse");
+    if (fs18.existsSync(path15.join(dir, ".git")) || fs18.existsSync(path15.join(dir, ".claude"))) {
+      const browseDir = path15.join(dir, ".browse");
       try {
-        fs17.mkdirSync(browseDir, { recursive: true });
-        const gi = path14.join(browseDir, ".gitignore");
-        if (!fs17.existsSync(gi)) {
-          fs17.writeFileSync(gi, "*\n");
+        fs18.mkdirSync(browseDir, { recursive: true });
+        const gi = path15.join(browseDir, ".gitignore");
+        if (!fs18.existsSync(gi)) {
+          fs18.writeFileSync(gi, "*\n");
         }
       } catch {
       }
       return browseDir;
     }
-    const parent = path14.dirname(dir);
+    const parent = path15.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
   return "/tmp";
 }
 var LOCAL_DIR3 = resolveLocalDir();
-var STATE_FILE2 = process.env.BROWSE_STATE_FILE || path14.join(LOCAL_DIR3, `browse-server${INSTANCE_SUFFIX2}.json`);
+var STATE_FILE2 = process.env.BROWSE_STATE_FILE || path15.join(LOCAL_DIR3, `browse-server${INSTANCE_SUFFIX2}.json`);
 var MAX_START_WAIT = parseInt(process.env.BROWSE_START_TIMEOUT || "0", 10) || 8e3;
 var LOCK_FILE = STATE_FILE2 + ".lock";
 var LOCK_STALE_MS = DEFAULTS.LOCK_STALE_THRESHOLD_MS;
 var __filename_cli = (0, import_url3.fileURLToPath)(__import_meta_url);
-var __dirname_cli = path14.dirname(__filename_cli);
+var __dirname_cli = path15.dirname(__filename_cli);
 function resolveServerScript(env = process.env, metaDir = __dirname_cli) {
   if (env.BROWSE_SERVER_SCRIPT) {
     return env.BROWSE_SERVER_SCRIPT;
   }
   if (metaDir.startsWith("/")) {
-    const direct = path14.resolve(metaDir, "server.ts");
-    if (fs17.existsSync(direct)) {
+    const direct = path15.resolve(metaDir, "server.ts");
+    if (fs18.existsSync(direct)) {
       return direct;
     }
   }
   const selfPath = (0, import_url3.fileURLToPath)(__import_meta_url);
-  if (fs17.existsSync(selfPath)) {
+  if (fs18.existsSync(selfPath)) {
     return "__self__";
   }
   throw new Error(
@@ -16983,7 +17538,7 @@ function resolveServerScript(env = process.env, metaDir = __dirname_cli) {
 var SERVER_SCRIPT = resolveServerScript();
 function readState() {
   try {
-    const data = fs17.readFileSync(STATE_FILE2, "utf-8");
+    const data = fs18.readFileSync(STATE_FILE2, "utf-8");
     return JSON.parse(data);
   } catch {
     return null;
@@ -16999,7 +17554,7 @@ function isProcessAlive(pid) {
 }
 async function listInstances() {
   try {
-    const files = fs17.readdirSync(LOCAL_DIR3).filter(
+    const files = fs18.readdirSync(LOCAL_DIR3).filter(
       (f) => f.startsWith("browse-server") && f.endsWith(".json") && !f.endsWith(".lock")
     );
     if (files.length === 0) {
@@ -17009,7 +17564,7 @@ async function listInstances() {
     let found = false;
     for (const file of files) {
       try {
-        const data = JSON.parse(fs17.readFileSync(path14.join(LOCAL_DIR3, file), "utf-8"));
+        const data = JSON.parse(fs18.readFileSync(path15.join(LOCAL_DIR3, file), "utf-8"));
         if (!data.pid || !data.port) continue;
         const alive = isProcessAlive(data.pid);
         let status = "dead";
@@ -17032,7 +17587,7 @@ async function listInstances() {
         found = true;
         if (!alive) {
           try {
-            fs17.unlinkSync(path14.join(LOCAL_DIR3, file));
+            fs18.unlinkSync(path15.join(LOCAL_DIR3, file));
           } catch {
           }
         }
@@ -17055,15 +17610,15 @@ function isBrowseProcess(pid) {
 }
 function acquireLock() {
   try {
-    fs17.writeFileSync(LOCK_FILE, String(process.pid), { flag: "wx" });
+    fs18.writeFileSync(LOCK_FILE, String(process.pid), { flag: "wx" });
     return true;
   } catch (err) {
     if (err.code === "EEXIST") {
       try {
-        const stat = fs17.statSync(LOCK_FILE);
+        const stat = fs18.statSync(LOCK_FILE);
         if (Date.now() - stat.mtimeMs > LOCK_STALE_MS) {
           try {
-            fs17.unlinkSync(LOCK_FILE);
+            fs18.unlinkSync(LOCK_FILE);
           } catch {
           }
           return acquireLock();
@@ -17077,7 +17632,7 @@ function acquireLock() {
 }
 function releaseLock() {
   try {
-    fs17.unlinkSync(LOCK_FILE);
+    fs18.unlinkSync(LOCK_FILE);
   } catch {
   }
 }
@@ -17094,7 +17649,7 @@ async function startServer() {
       }
       await sleep(100);
     }
-    if (!fs17.existsSync(LOCK_FILE) || fs17.readFileSync(LOCK_FILE, "utf-8").trim() !== String(process.pid)) {
+    if (!fs18.existsSync(LOCK_FILE) || fs18.readFileSync(LOCK_FILE, "utf-8").trim() !== String(process.pid)) {
       const state = readState();
       if (state && isProcessAlive(state.pid)) return state;
       throw new Error("Server failed to start (another process is starting it)");
@@ -17104,7 +17659,7 @@ async function startServer() {
     try {
       const oldState = readState();
       if (oldState && !isProcessAlive(oldState.pid)) {
-        fs17.unlinkSync(STATE_FILE2);
+        fs18.unlinkSync(STATE_FILE2);
       }
     } catch {
     }
@@ -17190,7 +17745,7 @@ async function ensureServer() {
   }
   if (state) {
     try {
-      fs17.unlinkSync(STATE_FILE2);
+      fs18.unlinkSync(STATE_FILE2);
     } catch {
     }
   }
@@ -17200,21 +17755,21 @@ async function ensureServer() {
 }
 function cleanOrphanedServers() {
   try {
-    const files = fs17.readdirSync(LOCAL_DIR3);
+    const files = fs18.readdirSync(LOCAL_DIR3);
     for (const file of files) {
       if (!file.startsWith("browse-server") || !file.endsWith(".json") || file.endsWith(".lock")) continue;
-      const filePath = path14.join(LOCAL_DIR3, file);
+      const filePath = path15.join(LOCAL_DIR3, file);
       if (filePath === STATE_FILE2) continue;
       try {
-        const data = JSON.parse(fs17.readFileSync(filePath, "utf-8"));
+        const data = JSON.parse(fs18.readFileSync(filePath, "utf-8"));
         if (!data.pid) {
-          fs17.unlinkSync(filePath);
+          fs18.unlinkSync(filePath);
           continue;
         }
         const suffixMatch = file.match(/browse-server-(\d+)\.json$/);
         if (suffixMatch && data.port === parseInt(suffixMatch[1], 10) && isProcessAlive(data.pid)) continue;
         if (!isProcessAlive(data.pid)) {
-          fs17.unlinkSync(filePath);
+          fs18.unlinkSync(filePath);
           continue;
         }
         if (isBrowseProcess(data.pid)) {
@@ -17225,7 +17780,7 @@ function cleanOrphanedServers() {
         }
       } catch {
         try {
-          fs17.unlinkSync(filePath);
+          fs18.unlinkSync(filePath);
         } catch {
         }
       }
@@ -17331,7 +17886,7 @@ async function sendCommand(state, command, args, retries = 0, sessionId) {
           await sleep(300);
         }
         try {
-          fs17.unlinkSync(STATE_FILE2);
+          fs18.unlinkSync(STATE_FILE2);
         } catch {
         }
         if (command === "restart") {
@@ -17650,6 +18205,10 @@ React:          react-devtools enable|disable|tree|props|suspense|errors
 Providers:      provider save|list|delete <name> [api-key]
 Detect:         detect (frameworks, CDN, third-party, SaaS, infra)
 Performance:    perf-audit [url] [--no-coverage] [--no-detect] [--json]
+                perf-audit save [name]             Save audit report to .browse/audits/
+                perf-audit compare <base> [curr]   Compare saved audit vs current or another
+                perf-audit list                    List saved audit reports
+                perf-audit delete <name>           Delete a saved audit report
 Debug:          inspect (requires BROWSE_DEBUG_PORT)
 Server:         status | instances | stop | restart | doctor | upgrade
 Setup:          install-skill [path]
@@ -17704,7 +18263,7 @@ if (process.argv.includes("--mcp")) {
   Promise.resolve().then(() => (init_mcp(), mcp_exports)).then((m) => m.startMcpServer(jsonMode));
 } else if (process.env.__BROWSE_SERVER_MODE === "1") {
   Promise.resolve().then(() => init_server());
-} else if (process.argv[1] && fs17.realpathSync(process.argv[1]) === fs17.realpathSync(__filename_cli)) {
+} else if (process.argv[1] && fs18.realpathSync(process.argv[1]) === fs18.realpathSync(__filename_cli)) {
   main().catch((err) => {
     console.error(`[browse] ${err.message}`);
     process.exit(1);

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@ulpi/browse",
-  "version": "1.4.0",
+  "version": "1.4.4",
+  "homepage": "https://browse.ulpi.io",
   "repository": {
     "type": "git",
     "url": "https://github.com/ulpi-io/browse"