browsertrack 0.2.1 → 0.2.2

package/AGENTS.md

@@ -99,10 +99,9 @@ When an error or unexpected behavior occurs in the frontend:
 
 If BrowserTrack is not yet active in your project:
 
-### 1. Ensure Daemon is Running
-```bash
-browsertrack start
-```
+### 1. Zero-Config Daemon Auto-Boot (Singleton Daemon)
+You do **not** need to manually run `browsertrack start`! When your IDE connects to BrowserTrack via MCP (`browsertrack mcp`), the background HTTP/WebSocket server is launched **automatically** on `http://127.0.0.1:7331` as a **singleton daemon**. Multiple windows, workspaces, or sub-agent sessions seamlessly share this single daemon without spawning duplicates or conflicting on ports.
+*(You can still manually run `browsertrack start` or `browsertrack stop` if you want a standalone terminal process).*
 
 ### 2. Connect the Browser Client
 - **Via HTML script tag:**
@@ -116,17 +115,21 @@ browsertrack start
 
 ### 3. MCP Configuration
 Ensure BrowserTrack MCP is configured in your editor:
+
 ```json
 {
   "mcpServers": {
     "browsertrack": {
-      "command": "browsertrack",
-      "args": ["mcp"]
+      "command": "npx",
+      "args": ["-y", "browsertrack@latest", "mcp"]
     }
   }
 }
 ```
 
+> **Note on PATH errors (`executable file not found in $PATH`):**
+> If your IDE cannot find `npx` or `browsertrack` in `$PATH` (common in GUI apps on macOS using NVM or Homebrew), provide the absolute path to `npx` (e.g. `~/.nvm/versions/node/v20.x.x/bin/npx`) along with `PATH` in the `env` object.
+
 ---
 
 ## 💡 Best Practices for AI Agents

package/README.md

@@ -17,6 +17,8 @@ browsertrack start
 
 This starts the local diagnostics server at `http://127.0.0.1:7331` (WebSocket at `ws://127.0.0.1:7331`).
 
+> **⚡ Zero-Config Auto-Start**: If you configure BrowserTrack via MCP in your AI editor (Cursor, Antigravity, Claude Code), you do **not** need to manually run `browsertrack start`! The MCP server automatically launches and manages a **single background daemon (singleton)** on port `7331`. Multiple windows or sessions share this single daemon without duplicate processes or port conflicts.
+
 ### 2. Connect Your Web Project
 
 #### Option A: Zero-install script tag (Plain HTML / Vite / Next.js)

package/dist/{chunk-INXDWPJW.js → chunk-4HRLW6YF.js}

@@ -1,8 +1,9 @@
 import {
   getSemanticSelector,
   redactUrl,
+  safeJsonStringify,
   truncate
-} from "./chunk-6VA7GBAO.js";
+} from "./chunk-QRZ57ME3.js";
 
 // packages/client/src/breadcrumbs.ts
 var BreadcrumbBuffer = class {
@@ -78,7 +79,9 @@ function resolveReactComponent(el) {
       }
     }
     let curr = hostFiber;
-    while (curr) {
+    let depth = 0;
+    while (curr && depth < 50) {
+      depth++;
       const type = curr.type;
       const name = getReactComponentName(type);
       if (name && !name.startsWith("html:") && name !== "Fragment") {
@@ -133,7 +136,9 @@ function resolveVueComponent(el) {
       const sourceFile = type.__file;
       const hierarchy = [];
       let curr = vueParent;
-      while (curr) {
+      let depth = 0;
+      while (curr && depth < 50) {
+        depth++;
         const cType = curr.type || {};
         const cName = cType.name || cType.__name || cType.displayName;
         if (cName && !hierarchy.includes(cName)) {
@@ -170,7 +175,9 @@ function resolveVueComponent(el) {
 function resolveSvelteComponent(el) {
   try {
     let curr = el;
-    while (curr) {
+    let depth = 0;
+    while (curr && depth < 50) {
+      depth++;
       const meta = curr.__svelte_meta;
       if (meta && meta.loc) {
         return {
@@ -709,12 +716,16 @@ function setupConsoleInterceptors(onConsole) {
 function setupNavigationInterceptors(onNavigation) {
   if (typeof window === "undefined" || typeof history === "undefined") return () => {
   };
-  let currentUrl = redactUrl(window.location.href);
-  onNavigation({
-    to: currentUrl,
-    type: "initial",
-    timestamp: Date.now()
-  });
+  let currentUrl = "";
+  try {
+    currentUrl = redactUrl(window.location.href);
+    onNavigation({
+      to: currentUrl,
+      type: "initial",
+      timestamp: Date.now()
+    });
+  } catch {
+  }
   const originalPushState = history.pushState;
   const originalReplaceState = history.replaceState;
   history.pushState = function(data, unused, url) {
@@ -750,26 +761,32 @@ function setupNavigationInterceptors(onNavigation) {
     return result;
   };
   const onPopState = () => {
-    const from = currentUrl;
-    const to = redactUrl(window.location.href);
-    currentUrl = to;
-    onNavigation({
-      from,
-      to,
-      type: "popstate",
-      timestamp: Date.now()
-    });
+    try {
+      const from = currentUrl;
+      const to = redactUrl(window.location.href);
+      currentUrl = to;
+      onNavigation({
+        from,
+        to,
+        type: "popstate",
+        timestamp: Date.now()
+      });
+    } catch {
+    }
   };
   const onHashChange = () => {
-    const from = currentUrl;
-    const to = redactUrl(window.location.href);
-    currentUrl = to;
-    onNavigation({
-      from,
-      to,
-      type: "hashchange",
-      timestamp: Date.now()
-    });
+    try {
+      const from = currentUrl;
+      const to = redactUrl(window.location.href);
+      currentUrl = to;
+      onNavigation({
+        from,
+        to,
+        type: "hashchange",
+        timestamp: Date.now()
+      });
+    } catch {
+    }
   };
   window.addEventListener("popstate", onPopState);
   window.addEventListener("hashchange", onHashChange);
@@ -806,31 +823,38 @@ function setupNetworkInterceptors(onNetwork) {
         urlStr = "unknown_url";
       }
       const safeUrl = redactUrl(urlStr);
+      let response;
       try {
-        const response = await originalFetch.apply(window, [input, init2]);
-        const durationMs = Date.now() - startTime;
-        onNetwork({
-          url: safeUrl,
-          method,
-          status: response.status,
-          statusText: response.statusText,
-          durationMs,
-          timestamp: startTime
-        });
-        return response;
+        response = await originalFetch.apply(window, [input, init2]);
       } catch (err) {
-        const durationMs = Date.now() - startTime;
+        const durationMs2 = Date.now() - startTime;
         const isAbort = err?.name === "AbortError";
+        try {
+          onNetwork({
+            url: safeUrl,
+            method,
+            durationMs: durationMs2,
+            error: err?.message || "Network request failed",
+            aborted: isAbort,
+            timestamp: startTime
+          });
+        } catch {
+        }
+        throw err;
+      }
+      const durationMs = Date.now() - startTime;
+      try {
         onNetwork({
           url: safeUrl,
           method,
+          status: response.status,
+          statusText: response.statusText,
           durationMs,
-          error: err?.message || "Network request failed",
-          aborted: isAbort,
           timestamp: startTime
         });
-        throw err;
+      } catch {
       }
+      return response;
     };
     cleanups.push(() => {
       window.fetch = originalFetch;
@@ -1216,15 +1240,18 @@ var WebSocketTransport = class {
     }
   }
   send(payload) {
-    const raw = JSON.stringify(payload);
-    if (this.isConnected()) {
-      try {
-        this.ws.send(raw);
-      } catch {
+    try {
+      const raw = safeJsonStringify(payload);
+      if (this.isConnected()) {
+        try {
+          this.ws.send(raw);
+        } catch {
+          this.enqueue(raw);
+        }
+      } else {
         this.enqueue(raw);
       }
-    } else {
-      this.enqueue(raw);
+    } catch {
     }
   }
   enqueue(raw) {
@@ -1249,17 +1276,17 @@ var WebSocketTransport = class {
   }
   sendHello() {
     if (typeof window === "undefined") return;
-    const hello = {
-      type: "hello",
-      origin: window.location.origin,
-      url: window.location.href,
-      title: document.title,
-      userAgent: navigator.userAgent,
-      timestamp: Date.now(),
-      projectId: this.projectId
-    };
     try {
-      this.ws.send(JSON.stringify(hello));
+      const hello = {
+        type: "hello",
+        origin: window.location.origin,
+        url: window.location.href,
+        title: document.title,
+        userAgent: navigator.userAgent,
+        timestamp: Date.now(),
+        projectId: this.projectId
+      };
+      this.ws.send(safeJsonStringify(hello));
     } catch {
     }
   }
@@ -2247,9 +2274,15 @@ var NoteInspector = class {
     this.markersContainer.innerHTML = "";
     if (!this.showMarkers || this.isHidden) return;
     const currentPath = window.location.pathname;
-    const activeNotes = this.savedNotes.filter(
-      (n) => n.status === "OPEN" && (n.route === currentPath || !n.route || n.route === "/" || window.location.href.includes(n.route))
-    );
+    const activeNotes = this.savedNotes.filter((n) => {
+      if (n.status !== "OPEN") return false;
+      if (!n.route) return true;
+      if (n.route === currentPath) return true;
+      if (n.route.includes("#") || n.route.includes("?")) {
+        return window.location.href.includes(n.route);
+      }
+      return false;
+    });
     const pageNotes = [];
     activeNotes.forEach((note, index) => {
       if (note.type === "page") {
@@ -2474,65 +2507,83 @@ var NoteInspector = class {
   }
   setupListeners() {
     const onMouseMove = (e) => {
-      if (this.isHidden || this.modalOverlay || this.cardOverlay || this.isDraggingRegion || this.activeMode === "region") return;
-      const path = e.composedPath ? e.composedPath() : [];
-      if (this.container && path.includes(this.container)) {
-        this.hideHighlight();
-        return;
-      }
-      if (e.altKey || this.activeMode === "element") {
-        const target = document.elementFromPoint(e.clientX, e.clientY);
-        if (target && target !== this.container && !this.container?.contains(target)) {
-          this.hoveredElement = target;
-          this.updateHighlight(target);
+      try {
+        if (this.isHidden || this.modalOverlay || this.cardOverlay || this.isDraggingRegion || this.activeMode === "region") return;
+        const path = e.composedPath ? e.composedPath() : [];
+        if (this.container && path.includes(this.container)) {
+          this.hideHighlight();
           return;
         }
-      }
-      if (!e.altKey && this.activeMode !== "element") {
-        this.hideHighlight();
+        if (e.altKey || this.activeMode === "element") {
+          const target = document.elementFromPoint(e.clientX, e.clientY);
+          if (target && target !== this.container && !this.container?.contains(target)) {
+            this.hoveredElement = target;
+            this.updateHighlight(target);
+            return;
+          }
+        }
+        if (!e.altKey && this.activeMode !== "element") {
+          this.hideHighlight();
+        }
+      } catch {
       }
     };
     const onClick = (e) => {
-      if (this.isHidden || this.modalOverlay || this.cardOverlay) return;
-      const path = e.composedPath ? e.composedPath() : [];
-      if (this.container && path.includes(this.container)) {
-        return;
-      }
-      if (this.activeMode === "region") return;
-      if (e.altKey || this.activeMode === "element") {
-        e.preventDefault();
-        e.stopPropagation();
-        const target = this.hoveredElement || document.elementFromPoint(e.clientX, e.clientY);
-        if (target && target !== this.container && !this.container?.contains(target)) {
-          this.selectedElement = target;
-          this.openNoteEditor(target, "element");
-          if (this.activeMode === "element" && !this.activeScenario) {
-            this.setMode("idle");
+      try {
+        if (this.isHidden || this.modalOverlay || this.cardOverlay) return;
+        const path = e.composedPath ? e.composedPath() : [];
+        if (this.container && path.includes(this.container)) {
+          return;
+        }
+        if (this.activeMode === "region") return;
+        if (e.altKey || this.activeMode === "element") {
+          e.preventDefault();
+          e.stopPropagation();
+          const target = this.hoveredElement || document.elementFromPoint(e.clientX, e.clientY);
+          if (target && target !== this.container && !this.container?.contains(target)) {
+            this.selectedElement = target;
+            this.openNoteEditor(target, "element");
+            if (this.activeMode === "element" && !this.activeScenario) {
+              this.setMode("idle");
+            }
           }
         }
+      } catch {
       }
     };
     const onKeyDown = (e) => {
-      if (e.key === "Escape") {
-        if (this.cardOverlay && this.cardOverlay.parentElement && this.shadowRoot) {
-          this.shadowRoot.removeChild(this.cardOverlay);
-          this.cardOverlay = null;
-        } else if (this.activeMode === "region" || this.activeMode === "element") {
-          if (!this.activeScenario) {
-            this.setMode("idle");
+      try {
+        if (e.key === "Escape") {
+          if (this.cardOverlay && this.cardOverlay.parentElement && this.shadowRoot) {
+            this.shadowRoot.removeChild(this.cardOverlay);
+            this.cardOverlay = null;
+          } else if (this.activeMode === "region" || this.activeMode === "element") {
+            if (!this.activeScenario) {
+              this.setMode("idle");
+            }
           }
         }
+      } catch {
       }
     };
     const onKeyUp = (e) => {
-      if (e.key === "Alt" && !this.modalOverlay && !this.cardOverlay && this.activeMode !== "element") {
-        this.hideHighlight();
+      try {
+        if (e.key === "Alt" && !this.modalOverlay && !this.cardOverlay && this.activeMode !== "element") {
+          this.hideHighlight();
+        }
+      } catch {
       }
     };
     const onScrollOrResize = () => {
-      requestAnimationFrame(() => {
-        this.updateMarkerPositions();
-      });
+      try {
+        requestAnimationFrame(() => {
+          try {
+            this.updateMarkerPositions();
+          } catch {
+          }
+        });
+      } catch {
+      }
     };
     window.addEventListener("mousemove", onMouseMove, { capture: true, passive: true });
     window.addEventListener("click", onClick, { capture: true });
@@ -2994,7 +3045,11 @@ var NoteInspector = class {
           region.width,
           region.height
         );
-        resolve(canvas.toDataURL("image/png"));
+        try {
+          resolve(canvas.toDataURL("image/png"));
+        } catch {
+          resolve(dataUrl);
+        }
       };
       img.onerror = () => resolve(dataUrl);
       img.src = dataUrl;
@@ -3284,4 +3339,4 @@ export {
   init,
   getClient
 };
-//# sourceMappingURL=chunk-INXDWPJW.js.map
+//# sourceMappingURL=chunk-4HRLW6YF.js.map