lensmcp 1.16.26 → 1.16.28

package/bundled/capture-runner.js

@@ -1295,9 +1295,9 @@ function makeUnixTmpDir() {
 function makeWin32TmpDir() {
   const winTmpPath = process.env.TEMP || process.env.TMP || (process.env.SystemRoot || process.env.windir) + "\\temp";
   const randomNumber = Math.floor(Math.random() * 9e7 + 1e7);
-  const tmpdir = join(winTmpPath, "lighthouse." + randomNumber);
-  mkdirSync(tmpdir, { recursive: true });
-  return tmpdir;
+  const tmpdir2 = join(winTmpPath, "lighthouse." + randomNumber);
+  mkdirSync(tmpdir2, { recursive: true });
+  return tmpdir2;
 }
 var import_is_wsl, LauncherError, ChromePathNotSetError, InvalidUserDataDirectoryError, UnsupportedPlatformError, ChromeNotInstalledError;
 var init_utils = __esm({
@@ -1958,8 +1958,8 @@ var init_chrome_launcher = __esm({
           this.fs.closeSync(this.errFile);
           delete this.errFile;
         }
-        const rmSync = this.fs.rmSync || this.fs.rmdirSync;
-        rmSync(this.userDataDir, { recursive: true, force: true, maxRetries: 10 });
+        const rmSync2 = this.fs.rmSync || this.fs.rmdirSync;
+        rmSync2(this.userDataDir, { recursive: true, force: true, maxRetries: 10 });
       }
     };
   }
@@ -33206,15 +33206,15 @@ var require_api = __commonJS({
         }
       });
     }
-    function addCommand(chrome, domainName, command) {
+    function addCommand(chrome2, domainName, command) {
       const commandName = `${domainName}.${command.name}`;
       const handler = (params, sessionId, callback) => {
-        return chrome.send(commandName, params, sessionId, callback);
+        return chrome2.send(commandName, params, sessionId, callback);
       };
       decorate(handler, "command", command);
-      chrome[commandName] = chrome[domainName][command.name] = handler;
+      chrome2[commandName] = chrome2[domainName][command.name] = handler;
     }
-    function addEvent(chrome, domainName, event) {
+    function addEvent(chrome2, domainName, event) {
       const eventName = `${domainName}.${event.name}`;
       const handler = (sessionId, handler2) => {
         if (typeof sessionId === "function") {
@@ -33223,22 +33223,22 @@ var require_api = __commonJS({
         }
         const rawEventName = sessionId ? `${eventName}.${sessionId}` : eventName;
         if (typeof handler2 === "function") {
-          chrome.on(rawEventName, handler2);
-          return () => chrome.removeListener(rawEventName, handler2);
+          chrome2.on(rawEventName, handler2);
+          return () => chrome2.removeListener(rawEventName, handler2);
         } else {
           return new Promise((fulfill, reject) => {
-            chrome.once(rawEventName, fulfill);
+            chrome2.once(rawEventName, fulfill);
           });
         }
       };
       decorate(handler, "event", event);
-      chrome[eventName] = chrome[domainName][event.name] = handler;
+      chrome2[eventName] = chrome2[domainName][event.name] = handler;
     }
-    function addType(chrome, domainName, type) {
+    function addType(chrome2, domainName, type) {
       const typeName = `${domainName}.${type.id}`;
       const help = {};
       decorate(help, "type", type);
-      chrome[typeName] = chrome[domainName][type.id] = help;
+      chrome2[typeName] = chrome2[domainName][type.id] = help;
     }
     function prepare(object, protocol) {
       object.protocol = protocol;
@@ -33560,6 +33560,490 @@ var require_chrome_remote_interface = __commonJS({
 // libs/browser-capture/src/capture-runner.ts
 import { appendFileSync, readFileSync, renameSync, statSync } from "node:fs";
 
+// libs/core/dist/lib/ulid.js
+var ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+var RANDOM_LEN = 16;
+function encodeTime(now, len) {
+  let out = "";
+  let n = now;
+  for (let i = len - 1; i >= 0; i--) {
+    const mod = n % 32;
+    out = ALPHABET[mod] + out;
+    n = (n - mod) / 32;
+  }
+  return out;
+}
+function encodeRandom(len) {
+  const bytes = new Uint8Array(len);
+  globalThis.crypto.getRandomValues(bytes);
+  let out = "";
+  for (let i = 0; i < len; i++) {
+    out += ALPHABET[(bytes[i] ?? 0) & 31];
+  }
+  return out;
+}
+function ulid(now = Date.now()) {
+  return encodeTime(now, 10) + encodeRandom(RANDOM_LEN);
+}
+
+// libs/core/dist/lib/fingerprint.js
+var FNV_OFFSET_BASIS = 2166136261;
+var FNV_PRIME = 16777619;
+function fnv1a32(input) {
+  let h = FNV_OFFSET_BASIS;
+  for (let i = 0; i < input.length; i++) {
+    h ^= input.charCodeAt(i);
+    h = Math.imul(h, FNV_PRIME);
+  }
+  return (h >>> 0).toString(16).padStart(8, "0");
+}
+function fingerprint(input) {
+  const parts = [input.kind, input.identity, input.file ?? "", input.detail ?? ""];
+  return `${input.kind}:${fnv1a32(parts.join("|"))}`;
+}
+
+// libs/browser-sidecar/dist/lib/page-controller.js
+var PageController = class {
+  constructor(args) {
+    this.url = "";
+    this.pending = /* @__PURE__ */ new Map();
+    this.pageId = args.pageId;
+    this.cdp = args.cdp;
+    this.emit = args.emit;
+    this.sessionId = args.sessionId;
+  }
+  async attach() {
+    await Promise.all([
+      this.cdp.Runtime.enable(),
+      this.cdp.Network.enable(),
+      this.cdp.Page.enable()
+    ]);
+    this.cdp.Runtime.consoleAPICalled((params) => {
+      const text = params.args.map((a) => a.value !== void 0 ? String(a.value) : a.description ?? "?").join(" ");
+      const lvl = params.type === "error" || params.type === "warning" ? params.type : "log";
+      const severity = lvl === "error" ? "error" : lvl === "warning" ? "warning" : "info";
+      this.emit({
+        id: ulid(),
+        sessionId: this.sessionId,
+        timestamp: Math.round(params.timestamp),
+        source: "chrome",
+        category: "runtime",
+        severity,
+        context: { sessionId: this.sessionId, tabId: this.pageId, url: this.url },
+        fingerprint: fingerprint({
+          kind: "runtime",
+          identity: `console:${lvl}:${text.slice(0, 80)}`
+        }),
+        title: `console.${lvl}`,
+        message: text,
+        raw: params
+      });
+    });
+    this.cdp.Runtime.exceptionThrown((params) => {
+      const det = params.exceptionDetails;
+      const desc = det.exception?.description ?? det.text;
+      this.emit({
+        id: ulid(),
+        sessionId: this.sessionId,
+        timestamp: Math.round(params.timestamp),
+        source: "chrome",
+        category: "runtime",
+        severity: "error",
+        context: { sessionId: this.sessionId, tabId: this.pageId, url: this.url },
+        fingerprint: fingerprint({
+          kind: "runtime",
+          identity: `exception:${normaliseTopFrame(desc)}`,
+          file: det.url
+        }),
+        title: det.text,
+        message: desc,
+        location: det.url ? { file: det.url, line: det.lineNumber, column: det.columnNumber } : void 0,
+        raw: params
+      });
+    });
+    this.cdp.Network.requestWillBeSent((p) => {
+      this.pending.set(p.requestId, {
+        url: p.request.url,
+        method: p.request.method,
+        startMs: Math.round(p.timestamp * 1e3)
+      });
+    });
+    this.cdp.Network.responseReceived((p) => {
+      const pend = this.pending.get(p.requestId);
+      const durationMs = pend ? Math.round(p.timestamp * 1e3) - pend.startMs : void 0;
+      const severity = p.response.status >= 400 ? "error" : "info";
+      this.emit({
+        id: ulid(),
+        sessionId: this.sessionId,
+        timestamp: Math.round(p.timestamp * 1e3),
+        source: "chrome",
+        category: "network",
+        severity,
+        context: { sessionId: this.sessionId, tabId: this.pageId, url: this.url },
+        fingerprint: fingerprint({
+          kind: "network",
+          identity: `${pend?.method ?? "?"}:${p.response.url}:${p.response.status}`
+        }),
+        title: `${pend?.method ?? "?"} ${p.response.url} \u2192 ${p.response.status}`,
+        message: durationMs !== void 0 ? `${durationMs}ms` : void 0,
+        relatedUrls: [p.response.url],
+        raw: p
+      });
+    });
+    this.cdp.Network.loadingFailed((p) => {
+      const pend = this.pending.get(p.requestId);
+      this.pending.delete(p.requestId);
+      this.emit({
+        id: ulid(),
+        sessionId: this.sessionId,
+        timestamp: Math.round(p.timestamp * 1e3),
+        source: "chrome",
+        category: "network",
+        severity: "error",
+        context: { sessionId: this.sessionId, tabId: this.pageId, url: this.url },
+        fingerprint: fingerprint({
+          kind: "network",
+          identity: `failed:${pend?.method ?? "?"}:${pend?.url ?? p.requestId}`
+        }),
+        title: `Request failed: ${pend?.url ?? p.requestId}`,
+        message: p.errorText,
+        relatedUrls: pend ? [pend.url] : void 0,
+        raw: p
+      });
+    });
+    this.cdp.Page.frameNavigated((p) => {
+      if (!p.frame.name) {
+        this.url = p.frame.url;
+      }
+    });
+  }
+  async dispose() {
+    if (this.cdp.close) {
+      try {
+        await this.cdp.close();
+      } catch {
+      }
+    }
+  }
+};
+function normaliseTopFrame(desc) {
+  if (!desc)
+    return "unknown";
+  const m = desc.match(/at\s+([\w$.<>]+)/);
+  return m?.[1] ?? "unknown";
+}
+
+// libs/browser-sidecar/dist/lib/chrome-launch.js
+import { execFileSync as execFileSync2 } from "node:child_process";
+import { existsSync, mkdtempSync, readdirSync, rmSync } from "node:fs";
+import { homedir as homedir2, tmpdir } from "node:os";
+import { join as join2 } from "node:path";
+var CAPTURE_DIR_MARKER = "lensmcp-capture-";
+function createManagedUserDataDir() {
+  return mkdtempSync(join2(tmpdir(), `${CAPTURE_DIR_MARKER}${process.pid}-`));
+}
+function removeUserDataDir(dir) {
+  try {
+    rmSync(dir, { recursive: true, force: true });
+  } catch {
+  }
+}
+async function resolveChromePath2(log) {
+  const override = process.env["LENSMCP_CHROME_PATH"] ?? process.env["CHROME_PATH"];
+  if (override) {
+    if (existsSync(override))
+      return override;
+    log?.(`[browser-capture] LENSMCP_CHROME_PATH/CHROME_PATH points at ${override}, which does not exist \u2014 auto-detecting instead`);
+  }
+  const isolated = chromeForTestingFromPuppeteerCache() ?? firstExisting(NON_COLLIDING_INSTALLS);
+  if (isolated)
+    return isolated;
+  try {
+    const { Launcher: Launcher2 } = await Promise.resolve().then(() => (init_dist(), dist_exports));
+    const system = Launcher2.getFirstInstallation?.();
+    if (system) {
+      if (process.platform === "darwin") {
+        log?.("[browser-capture] capturing with the system Chrome \u2014 while capture runs, opening Chrome from the Dock may misbehave. Install an isolated binary (`npx @puppeteer/browsers install chrome@stable`) or set LENSMCP_CHROME_PATH to avoid this.");
+      }
+      return system;
+    }
+  } catch {
+  }
+  return void 0;
+}
+var NON_COLLIDING_INSTALLS = process.platform === "darwin" ? [
+  "/Applications/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing",
+  "/Applications/Chromium.app/Contents/MacOS/Chromium"
+] : [];
+function chromeForTestingFromPuppeteerCache() {
+  const cacheRoot = process.env["PUPPETEER_CACHE_DIR"] ?? join2(homedir2(), ".cache", "puppeteer");
+  const chromeRoot = join2(cacheRoot, "chrome");
+  let versions;
+  try {
+    versions = readdirSync(chromeRoot);
+  } catch {
+    return void 0;
+  }
+  versions.sort((a, b) => b.localeCompare(a, void 0, { numeric: true }));
+  const layouts = [
+    ["chrome-mac-arm64", "Google Chrome for Testing.app", "Contents", "MacOS", "Google Chrome for Testing"],
+    ["chrome-mac-x64", "Google Chrome for Testing.app", "Contents", "MacOS", "Google Chrome for Testing"],
+    ["chrome-linux64", "chrome"],
+    ["chrome-win64", "chrome.exe"]
+  ];
+  for (const version of versions) {
+    for (const parts of layouts) {
+      const candidate = join2(chromeRoot, version, ...parts);
+      if (existsSync(candidate))
+        return candidate;
+    }
+  }
+  return void 0;
+}
+function firstExisting(candidates) {
+  return candidates.find((c) => existsSync(c));
+}
+function planOrphanReap(psLines, isOwnerAlive, selfPid) {
+  const dirRe = new RegExp(`--user-data-dir=(\\S*${CAPTURE_DIR_MARKER}(\\d+)-\\S*)`);
+  const orphans = [];
+  for (const line of psLines) {
+    const m = /^\s*(\d+)\s+(.*)$/.exec(line);
+    if (!m)
+      continue;
+    const cmd = m[2];
+    if (cmd.includes("--type="))
+      continue;
+    const dir = dirRe.exec(cmd);
+    if (!dir)
+      continue;
+    const ownerPid = Number(dir[2]);
+    if (ownerPid === selfPid || isOwnerAlive(ownerPid))
+      continue;
+    orphans.push({ pid: Number(m[1]), ownerPid, userDataDir: dir[1] });
+  }
+  return orphans;
+}
+function reapOrphanCaptureChrome(log) {
+  if (process.platform === "win32")
+    return 0;
+  let out;
+  try {
+    out = execFileSync2("ps", ["ax", "-ww", "-o", "pid=,command="], {
+      encoding: "utf8",
+      timeout: 5e3,
+      maxBuffer: 64 * 1024 * 1024
+    });
+  } catch {
+    return 0;
+  }
+  let reaped = 0;
+  for (const orphan of planOrphanReap(out.split("\n"), isAlive, process.pid)) {
+    try {
+      process.kill(orphan.pid, "SIGKILL");
+      reaped += 1;
+      log?.(`[browser-capture] reaped orphaned capture Chrome pid=${orphan.pid} (owner ${orphan.ownerPid} is gone)`);
+    } catch {
+    }
+    removeUserDataDir(orphan.userDataDir);
+  }
+  return reaped;
+}
+function isAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    return err.code === "EPERM";
+  }
+}
+
+// libs/browser-sidecar/dist/lib/dom-snapshot.js
+var COMPUTED_STYLE_WHITELIST = [
+  // box model
+  "display",
+  "position",
+  "box-sizing",
+  "margin-top",
+  "margin-right",
+  "margin-bottom",
+  "margin-left",
+  "padding-top",
+  "padding-right",
+  "padding-bottom",
+  "padding-left",
+  // typography
+  "font-family",
+  "font-size",
+  "font-weight",
+  "line-height",
+  "letter-spacing",
+  "text-align",
+  // color + bg
+  "color",
+  "background-color",
+  "opacity",
+  "visibility",
+  // borders
+  "border-top-width",
+  "border-right-width",
+  "border-bottom-width",
+  "border-left-width",
+  "border-radius",
+  // layout
+  "flex-direction",
+  "justify-content",
+  "align-items",
+  "gap",
+  "row-gap",
+  "column-gap",
+  "grid-template-columns",
+  "grid-template-rows",
+  "overflow",
+  "overflow-x",
+  "overflow-y",
+  // stacking
+  "z-index",
+  // motion
+  "transform",
+  "transition",
+  "animation"
+];
+async function captureDomSnapshot(cdp, opts = {}) {
+  const computedStyles = (opts.computedStyles ?? COMPUTED_STYLE_WHITELIST).slice();
+  const raw = await cdp.DOMSnapshot.captureSnapshot({
+    computedStyles,
+    includePaintOrder: opts.includePaintOrder ?? true,
+    includeDOMRects: true,
+    includeBlendedBackgroundColors: opts.includeBlendedBackgroundColors ?? false,
+    includeTextColorOpacities: opts.includeTextColorOpacities ?? false
+  });
+  const ax = opts.mergeAccessibility && cdp.Accessibility ? await cdp.Accessibility.getFullAXTree().catch(() => ({ nodes: [] })) : { nodes: [] };
+  const viewport = await readViewport(cdp);
+  const snapshotId = opts.snapshotId ?? `dom-${Date.now()}`;
+  return normalise(raw, ax, computedStyles, viewport, snapshotId);
+}
+async function readViewport(cdp) {
+  const lm = cdp.Page?.getLayoutMetrics;
+  if (!lm)
+    return { x: 0, y: 0, width: 0, height: 0 };
+  try {
+    const r = await lm();
+    const v = r.cssVisualViewport ?? r.layoutViewport;
+    if (!v)
+      return { x: 0, y: 0, width: 0, height: 0 };
+    return { x: 0, y: 0, width: v.clientWidth, height: v.clientHeight };
+  } catch {
+    return { x: 0, y: 0, width: 0, height: 0 };
+  }
+}
+function normalise(raw, ax, computedStyles, viewport, snapshotId) {
+  const nodes = {};
+  const nodeOrder = [];
+  const document2 = raw.documents[0];
+  if (!document2) {
+    return {
+      capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      viewport,
+      snapshotId,
+      nodes,
+      nodeOrder
+    };
+  }
+  const strings = raw.strings;
+  const decode = (i) => i >= 0 ? strings[i] ?? "" : "";
+  const nodeCount = document2.nodes.backendNodeId.length;
+  const byIndex = new Array(nodeCount);
+  for (let i = 0; i < nodeCount; i++) {
+    const backendNodeId = document2.nodes.backendNodeId[i];
+    if (backendNodeId === void 0)
+      continue;
+    const tag = decode(document2.nodes.nodeName[i] ?? -1).toLowerCase();
+    const attributePairs = document2.nodes.attributes[i] ?? [];
+    const attributes = {};
+    for (let j = 0; j + 1 < attributePairs.length; j += 2) {
+      const name = decode(attributePairs[j]);
+      const value = decode(attributePairs[j + 1]);
+      if (name)
+        attributes[name] = value;
+    }
+    const parentIndex = document2.nodes.parentIndex?.[i] ?? -1;
+    const parentBackend = parentIndex >= 0 ? document2.nodes.backendNodeId[parentIndex] : void 0;
+    const text = decode(document2.nodes.nodeValue[i] ?? -1).trim() || void 0;
+    byIndex[i] = {
+      backendNodeId,
+      parentBackendNodeId: parentBackend,
+      tag,
+      attributes,
+      text,
+      rect: { x: 0, y: 0, width: 0, height: 0 },
+      computedStyle: {},
+      agentComponent: attributes["data-agent-component"]
+    };
+  }
+  const layout = document2.layout;
+  for (let li = 0; li < layout.nodeIndex.length; li++) {
+    const idx = layout.nodeIndex[li];
+    if (idx === void 0)
+      continue;
+    const node = byIndex[idx];
+    if (!node)
+      continue;
+    const bounds = layout.bounds[li];
+    if (bounds && bounds.length === 4) {
+      const [x, y, w, h] = bounds;
+      node.rect = {
+        x: x ?? 0,
+        y: y ?? 0,
+        width: Math.max(0, w ?? 0),
+        height: Math.max(0, h ?? 0)
+      };
+    }
+    const styleRow = layout.styles[li];
+    if (styleRow) {
+      for (let s = 0; s < styleRow.length && s < computedStyles.length; s++) {
+        const styleName = computedStyles[s];
+        if (!styleName)
+          continue;
+        const styleValue = decode(styleRow[s]);
+        if (styleValue)
+          node.computedStyle[styleName] = styleValue;
+      }
+    }
+    if (layout.paintOrders) {
+      const po = layout.paintOrders[li];
+      if (po !== void 0)
+        node.paintOrder = po;
+    }
+  }
+  const axByBackend = /* @__PURE__ */ new Map();
+  for (const axNode of ax.nodes) {
+    if (axNode.backendDOMNodeId !== void 0) {
+      axByBackend.set(axNode.backendDOMNodeId, axNode);
+    }
+  }
+  for (let i = 0; i < byIndex.length; i++) {
+    const node = byIndex[i];
+    if (!node)
+      continue;
+    const axNode = axByBackend.get(node.backendNodeId);
+    if (axNode) {
+      if (axNode.role?.value)
+        node.role = axNode.role.value;
+      if (axNode.name?.value)
+        node.ariaName = axNode.name.value;
+    }
+    nodes[node.backendNodeId] = node;
+    nodeOrder.push(node.backendNodeId);
+  }
+  return {
+    capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    viewport,
+    snapshotId,
+    nodes,
+    nodeOrder
+  };
+}
+
 // libs/visual-engine/dist/lib/diff.js
 var LAYOUT_TOLERANCE_PX = 0.5;
 function diffSnapshots(prev, curr, options) {
@@ -34186,372 +34670,12 @@ function resolveTargets(snapshot, rule) {
   return [];
 }
 
-// libs/core/dist/lib/ulid.js
-var ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-var RANDOM_LEN = 16;
-function encodeTime(now, len) {
-  let out = "";
-  let n = now;
-  for (let i = len - 1; i >= 0; i--) {
-    const mod = n % 32;
-    out = ALPHABET[mod] + out;
-    n = (n - mod) / 32;
-  }
-  return out;
-}
-function encodeRandom(len) {
-  const bytes = new Uint8Array(len);
-  globalThis.crypto.getRandomValues(bytes);
-  let out = "";
-  for (let i = 0; i < len; i++) {
-    out += ALPHABET[(bytes[i] ?? 0) & 31];
-  }
-  return out;
-}
-function ulid(now = Date.now()) {
-  return encodeTime(now, 10) + encodeRandom(RANDOM_LEN);
-}
-
-// libs/core/dist/lib/fingerprint.js
-var FNV_OFFSET_BASIS = 2166136261;
-var FNV_PRIME = 16777619;
-function fnv1a32(input) {
-  let h = FNV_OFFSET_BASIS;
-  for (let i = 0; i < input.length; i++) {
-    h ^= input.charCodeAt(i);
-    h = Math.imul(h, FNV_PRIME);
-  }
-  return (h >>> 0).toString(16).padStart(8, "0");
-}
-function fingerprint(input) {
-  const parts = [input.kind, input.identity, input.file ?? "", input.detail ?? ""];
-  return `${input.kind}:${fnv1a32(parts.join("|"))}`;
-}
-
-// libs/browser-sidecar/dist/lib/page-controller.js
-var PageController = class {
-  constructor(args) {
-    this.url = "";
-    this.pending = /* @__PURE__ */ new Map();
-    this.pageId = args.pageId;
-    this.cdp = args.cdp;
-    this.emit = args.emit;
-    this.sessionId = args.sessionId;
-  }
-  async attach() {
-    await Promise.all([
-      this.cdp.Runtime.enable(),
-      this.cdp.Network.enable(),
-      this.cdp.Page.enable()
-    ]);
-    this.cdp.Runtime.consoleAPICalled((params) => {
-      const text = params.args.map((a) => a.value !== void 0 ? String(a.value) : a.description ?? "?").join(" ");
-      const lvl = params.type === "error" || params.type === "warning" ? params.type : "log";
-      const severity = lvl === "error" ? "error" : lvl === "warning" ? "warning" : "info";
-      this.emit({
-        id: ulid(),
-        sessionId: this.sessionId,
-        timestamp: Math.round(params.timestamp),
-        source: "chrome",
-        category: "runtime",
-        severity,
-        context: { sessionId: this.sessionId, tabId: this.pageId, url: this.url },
-        fingerprint: fingerprint({
-          kind: "runtime",
-          identity: `console:${lvl}:${text.slice(0, 80)}`
-        }),
-        title: `console.${lvl}`,
-        message: text,
-        raw: params
-      });
-    });
-    this.cdp.Runtime.exceptionThrown((params) => {
-      const det = params.exceptionDetails;
-      const desc = det.exception?.description ?? det.text;
-      this.emit({
-        id: ulid(),
-        sessionId: this.sessionId,
-        timestamp: Math.round(params.timestamp),
-        source: "chrome",
-        category: "runtime",
-        severity: "error",
-        context: { sessionId: this.sessionId, tabId: this.pageId, url: this.url },
-        fingerprint: fingerprint({
-          kind: "runtime",
-          identity: `exception:${normaliseTopFrame(desc)}`,
-          file: det.url
-        }),
-        title: det.text,
-        message: desc,
-        location: det.url ? { file: det.url, line: det.lineNumber, column: det.columnNumber } : void 0,
-        raw: params
-      });
-    });
-    this.cdp.Network.requestWillBeSent((p) => {
-      this.pending.set(p.requestId, {
-        url: p.request.url,
-        method: p.request.method,
-        startMs: Math.round(p.timestamp * 1e3)
-      });
-    });
-    this.cdp.Network.responseReceived((p) => {
-      const pend = this.pending.get(p.requestId);
-      const durationMs = pend ? Math.round(p.timestamp * 1e3) - pend.startMs : void 0;
-      const severity = p.response.status >= 400 ? "error" : "info";
-      this.emit({
-        id: ulid(),
-        sessionId: this.sessionId,
-        timestamp: Math.round(p.timestamp * 1e3),
-        source: "chrome",
-        category: "network",
-        severity,
-        context: { sessionId: this.sessionId, tabId: this.pageId, url: this.url },
-        fingerprint: fingerprint({
-          kind: "network",
-          identity: `${pend?.method ?? "?"}:${p.response.url}:${p.response.status}`
-        }),
-        title: `${pend?.method ?? "?"} ${p.response.url} \u2192 ${p.response.status}`,
-        message: durationMs !== void 0 ? `${durationMs}ms` : void 0,
-        relatedUrls: [p.response.url],
-        raw: p
-      });
-    });
-    this.cdp.Network.loadingFailed((p) => {
-      const pend = this.pending.get(p.requestId);
-      this.pending.delete(p.requestId);
-      this.emit({
-        id: ulid(),
-        sessionId: this.sessionId,
-        timestamp: Math.round(p.timestamp * 1e3),
-        source: "chrome",
-        category: "network",
-        severity: "error",
-        context: { sessionId: this.sessionId, tabId: this.pageId, url: this.url },
-        fingerprint: fingerprint({
-          kind: "network",
-          identity: `failed:${pend?.method ?? "?"}:${pend?.url ?? p.requestId}`
-        }),
-        title: `Request failed: ${pend?.url ?? p.requestId}`,
-        message: p.errorText,
-        relatedUrls: pend ? [pend.url] : void 0,
-        raw: p
-      });
-    });
-    this.cdp.Page.frameNavigated((p) => {
-      if (!p.frame.name) {
-        this.url = p.frame.url;
-      }
-    });
-  }
-  async dispose() {
-    if (this.cdp.close) {
-      try {
-        await this.cdp.close();
-      } catch {
-      }
-    }
-  }
-};
-function normaliseTopFrame(desc) {
-  if (!desc)
-    return "unknown";
-  const m = desc.match(/at\s+([\w$.<>]+)/);
-  return m?.[1] ?? "unknown";
-}
-
-// libs/browser-sidecar/dist/lib/dom-snapshot.js
-var COMPUTED_STYLE_WHITELIST = [
-  // box model
-  "display",
-  "position",
-  "box-sizing",
-  "margin-top",
-  "margin-right",
-  "margin-bottom",
-  "margin-left",
-  "padding-top",
-  "padding-right",
-  "padding-bottom",
-  "padding-left",
-  // typography
-  "font-family",
-  "font-size",
-  "font-weight",
-  "line-height",
-  "letter-spacing",
-  "text-align",
-  // color + bg
-  "color",
-  "background-color",
-  "opacity",
-  "visibility",
-  // borders
-  "border-top-width",
-  "border-right-width",
-  "border-bottom-width",
-  "border-left-width",
-  "border-radius",
-  // layout
-  "flex-direction",
-  "justify-content",
-  "align-items",
-  "gap",
-  "row-gap",
-  "column-gap",
-  "grid-template-columns",
-  "grid-template-rows",
-  "overflow",
-  "overflow-x",
-  "overflow-y",
-  // stacking
-  "z-index",
-  // motion
-  "transform",
-  "transition",
-  "animation"
-];
-async function captureDomSnapshot(cdp, opts = {}) {
-  const computedStyles = (opts.computedStyles ?? COMPUTED_STYLE_WHITELIST).slice();
-  const raw = await cdp.DOMSnapshot.captureSnapshot({
-    computedStyles,
-    includePaintOrder: opts.includePaintOrder ?? true,
-    includeDOMRects: true,
-    includeBlendedBackgroundColors: opts.includeBlendedBackgroundColors ?? false,
-    includeTextColorOpacities: opts.includeTextColorOpacities ?? false
-  });
-  const ax = opts.mergeAccessibility && cdp.Accessibility ? await cdp.Accessibility.getFullAXTree().catch(() => ({ nodes: [] })) : { nodes: [] };
-  const viewport = await readViewport(cdp);
-  const snapshotId = opts.snapshotId ?? `dom-${Date.now()}`;
-  return normalise(raw, ax, computedStyles, viewport, snapshotId);
-}
-async function readViewport(cdp) {
-  const lm = cdp.Page?.getLayoutMetrics;
-  if (!lm)
-    return { x: 0, y: 0, width: 0, height: 0 };
-  try {
-    const r = await lm();
-    const v = r.cssVisualViewport ?? r.layoutViewport;
-    if (!v)
-      return { x: 0, y: 0, width: 0, height: 0 };
-    return { x: 0, y: 0, width: v.clientWidth, height: v.clientHeight };
-  } catch {
-    return { x: 0, y: 0, width: 0, height: 0 };
-  }
-}
-function normalise(raw, ax, computedStyles, viewport, snapshotId) {
-  const nodes = {};
-  const nodeOrder = [];
-  const document2 = raw.documents[0];
-  if (!document2) {
-    return {
-      capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      viewport,
-      snapshotId,
-      nodes,
-      nodeOrder
-    };
-  }
-  const strings = raw.strings;
-  const decode = (i) => i >= 0 ? strings[i] ?? "" : "";
-  const nodeCount = document2.nodes.backendNodeId.length;
-  const byIndex = new Array(nodeCount);
-  for (let i = 0; i < nodeCount; i++) {
-    const backendNodeId = document2.nodes.backendNodeId[i];
-    if (backendNodeId === void 0)
-      continue;
-    const tag = decode(document2.nodes.nodeName[i] ?? -1).toLowerCase();
-    const attributePairs = document2.nodes.attributes[i] ?? [];
-    const attributes = {};
-    for (let j = 0; j + 1 < attributePairs.length; j += 2) {
-      const name = decode(attributePairs[j]);
-      const value = decode(attributePairs[j + 1]);
-      if (name)
-        attributes[name] = value;
-    }
-    const parentIndex = document2.nodes.parentIndex?.[i] ?? -1;
-    const parentBackend = parentIndex >= 0 ? document2.nodes.backendNodeId[parentIndex] : void 0;
-    const text = decode(document2.nodes.nodeValue[i] ?? -1).trim() || void 0;
-    byIndex[i] = {
-      backendNodeId,
-      parentBackendNodeId: parentBackend,
-      tag,
-      attributes,
-      text,
-      rect: { x: 0, y: 0, width: 0, height: 0 },
-      computedStyle: {},
-      agentComponent: attributes["data-agent-component"]
-    };
-  }
-  const layout = document2.layout;
-  for (let li = 0; li < layout.nodeIndex.length; li++) {
-    const idx = layout.nodeIndex[li];
-    if (idx === void 0)
-      continue;
-    const node = byIndex[idx];
-    if (!node)
-      continue;
-    const bounds = layout.bounds[li];
-    if (bounds && bounds.length === 4) {
-      const [x, y, w, h] = bounds;
-      node.rect = {
-        x: x ?? 0,
-        y: y ?? 0,
-        width: Math.max(0, w ?? 0),
-        height: Math.max(0, h ?? 0)
-      };
-    }
-    const styleRow = layout.styles[li];
-    if (styleRow) {
-      for (let s = 0; s < styleRow.length && s < computedStyles.length; s++) {
-        const styleName = computedStyles[s];
-        if (!styleName)
-          continue;
-        const styleValue = decode(styleRow[s]);
-        if (styleValue)
-          node.computedStyle[styleName] = styleValue;
-      }
-    }
-    if (layout.paintOrders) {
-      const po = layout.paintOrders[li];
-      if (po !== void 0)
-        node.paintOrder = po;
-    }
-  }
-  const axByBackend = /* @__PURE__ */ new Map();
-  for (const axNode of ax.nodes) {
-    if (axNode.backendDOMNodeId !== void 0) {
-      axByBackend.set(axNode.backendDOMNodeId, axNode);
-    }
-  }
-  for (let i = 0; i < byIndex.length; i++) {
-    const node = byIndex[i];
-    if (!node)
-      continue;
-    const axNode = axByBackend.get(node.backendNodeId);
-    if (axNode) {
-      if (axNode.role?.value)
-        node.role = axNode.role.value;
-      if (axNode.name?.value)
-        node.ariaName = axNode.name.value;
-    }
-    nodes[node.backendNodeId] = node;
-    nodeOrder.push(node.backendNodeId);
-  }
-  return {
-    capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    viewport,
-    snapshotId,
-    nodes,
-    nodeOrder
-  };
-}
-
 // libs/browser-capture/src/lib/capture.ts
 async function startBrowserCapture(opts) {
   const log = opts.log ?? (() => void 0);
   const sessionId = opts.sessionId ?? ulid();
   const chromeLauncher = await Promise.resolve().then(() => (init_dist(), dist_exports));
-  const chromePath = safe(() => chromeLauncher.Launcher.getFirstInstallation?.());
+  const chromePath = await resolveChromePath2(log);
   if (!chromePath) {
     log("[browser-capture] no Chrome installed \u2014 skipping live browser capture");
     return void 0;
@@ -34561,8 +34685,11 @@ async function startBrowserCapture(opts) {
     log(`[browser-capture] dev URL ${opts.url} not reachable \u2014 skipping`);
     return void 0;
   }
-  const chrome = await chromeLauncher.launch({
+  const userDataDir = createManagedUserDataDir();
+  const chrome2 = await chromeLauncher.launch({
     startingUrl: "about:blank",
+    chromePath,
+    userDataDir,
     chromeFlags: [
       ...opts.headless === false ? [] : ["--headless=new"],
       "--disable-gpu",
@@ -34570,12 +34697,20 @@ async function startBrowserCapture(opts) {
       "--disable-dev-shm-usage"
     ]
   });
+  const killSync = () => {
+    try {
+      process.kill(chrome2.pid, "SIGKILL");
+    } catch {
+    }
+    removeUserDataDir(userDataDir);
+  };
+  opts.onChrome?.({ pid: chrome2.pid, killSync });
   const CDP = (await Promise.resolve().then(() => __toESM(require_chrome_remote_interface(), 1))).default;
   const attachClient = async (navigate) => {
-    const targets = await CDP.List({ port: chrome.port });
+    const targets = await CDP.List({ port: chrome2.port });
     const pageTarget = targets.find((t) => t.type === "page");
     if (!pageTarget) throw new Error("no page target");
-    const client = await CDP({ port: chrome.port, target: pageTarget });
+    const client = await CDP({ port: chrome2.port, target: pageTarget });
     const controller = new PageController({
       pageId: pageTarget.id,
       cdp: client,
@@ -34593,7 +34728,8 @@ async function startBrowserCapture(opts) {
   try {
     cdp = await attachClient(true);
   } catch {
-    await chrome.kill();
+    await chrome2.kill();
+    removeUserDataDir(userDataDir);
     log("[browser-capture] no page target after launch \u2014 skipping");
     return void 0;
   }
@@ -34660,6 +34796,7 @@ async function startBrowserCapture(opts) {
   timer.unref?.();
   return {
     frameCount: () => frames,
+    killSync,
     async stop() {
       stopped = true;
       clearInterval(timer);
@@ -34668,9 +34805,10 @@ async function startBrowserCapture(opts) {
       } catch {
       }
       try {
-        await chrome.kill();
+        await chrome2.kill();
       } catch {
       }
+      removeUserDataDir(userDataDir);
     }
   };
 }
@@ -34700,15 +34838,49 @@ async function waitForUrl(url, timeoutSec) {
   }
   return false;
 }
-function safe(fn) {
-  try {
-    return fn();
-  } catch {
-    return void 0;
-  }
-}
 
 // libs/browser-capture/src/capture-runner.ts
+var chrome;
+var capture;
+var shuttingDown = false;
+function shutdown() {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  const finish = () => process.exit(0);
+  if (!capture) {
+    chrome?.killSync();
+    finish();
+    return;
+  }
+  setTimeout(() => {
+    chrome?.killSync();
+    finish();
+  }, 5e3).unref();
+  void capture.stop().then(finish, () => {
+    chrome?.killSync();
+    finish();
+  });
+}
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+process.on("SIGHUP", shutdown);
+process.on("exit", () => chrome?.killSync());
+process.on("uncaughtException", (err) => {
+  console.error(`[browser-capture] fatal: ${err?.stack ?? String(err)}`);
+  shutdown();
+});
+process.on("unhandledRejection", (reason) => {
+  console.error(`[browser-capture] fatal: ${String(reason)}`);
+  shutdown();
+});
+setInterval(() => {
+  if (process.ppid === 1) {
+    console.error("[browser-capture] parent process gone \u2014 shutting down");
+    shutdown();
+  }
+}, 5e3).unref();
+reapOrphanCaptureChrome((m) => console.error(m));
+setInterval(() => reapOrphanCaptureChrome((m) => console.error(m)), 6e4).unref();
 var MAX_EVENT_BYTES = (() => {
   const n = Number(process.env["LENSMCP_EVENT_MAX_BYTES"]);
   return Number.isFinite(n) && n > 0 ? n : 256 * 1024 * 1024;
@@ -34747,21 +34919,20 @@ async function main() {
     process.env["LENSMCP_TOKENS_FILE"] ?? process.cwd()
   );
   const rules = loadRules(process.env["LENSMCP_RULES_FILE"]);
-  const capture = await startBrowserCapture({
+  capture = await startBrowserCapture({
     url,
     sink,
     tokens,
     rules,
     sessionId: process.env["LENSMCP_SESSION_ID"],
     headless: process.env["LENSMCP_HEADLESS"] !== "false",
+    onChrome: (c) => {
+      chrome = c;
+      if (shuttingDown) c.killSync();
+    },
     log: (m) => console.error(m)
   });
-  if (!capture) return;
-  const shutdown = () => {
-    void capture.stop().finally(() => process.exit(0));
-  };
-  process.on("SIGINT", shutdown);
-  process.on("SIGTERM", shutdown);
+  if (!capture) process.exit(0);
 }
 function loadRules(rulesFile) {
   if (!rulesFile) return [];

package/lib/cli.d.ts

@@ -13,5 +13,21 @@ interface CliContext {
     err?: (line: string) => void;
 }
 export declare function runCli(ctx: CliContext): Promise<CliResult>;
+export type AliveGatewayReality = 'serving' | 'booting' | 'zombie';
+/** Classify what a TRACKED-ALIVE gateway pid really is. ALIVE ≠ SERVING: the tracked pid is the
+ *  `nx run` WRAPPER, and the process that actually binds :443 is its run-executor child. When that
+ *  child crashes while the wrapper wedges (a lost nx-daemon connection), the pid file points at a live
+ *  process that serves NOTHING — the state that made `start` a no-op forever ("already running") while
+ *  the workspace 404'd. So:
+ *  - serving: this workspace's gateway (the wrapper or a descendant) holds :443 — genuinely up.
+ *  - booting: :443 is unbound and the spawn is fresh — the listeners just haven't bound yet.
+ *  - zombie:  past the boot window with nothing of ours on :443, or the port is already held by
+ *             someone else (a boot could never win it) — dead weight to reap. */
+export declare function classifyAliveGateway(o: {
+    oursOn443: boolean;
+    port443Held: boolean;
+    pidFileAgeMs: number | undefined;
+    bootGraceMs?: number;
+}): AliveGatewayReality;
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/lib/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gEAAgE;IAChE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAqFD,wBAAsB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CA4ChE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gEAAgE;IAChE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAqFD,wBAAsB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CA4ChE;AA0lBD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnE;;;;;;;;iFAQiF;AACjF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,mBAAmB,CAItB"}

package/lib/cli.js

@@ -1,5 +1,5 @@
 import { spawn, spawnSync } from 'node:child_process';
-import { existsSync, mkdirSync, openSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, openSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import { request as httpRequest } from 'node:http';
 import { homedir, tmpdir } from 'node:os';
 import { basename, dirname, join, relative, resolve } from 'node:path';
@@ -267,15 +267,36 @@ function runGateway(ctx, args, out, err) {
     const registeredMarker = join(cwd, '.lensmcp', 'registered.json');
     const dashUrl = `https://lensmcp.local${cfg.dashboardBasePath}/`;
     const start = () => {
-        // Reconcile with reality FIRST: an alive pid-file wins; else adopt an orphaned gateway on :443 (the
-        // desync self-heal) — so a second `start` NEVER spawns a duplicate that EADDRINUSE-crashes + orphans.
+        // Reconcile with reality FIRST: adopt an orphaned gateway on :443 (the desync self-heal) — so a
+        // second `start` NEVER spawns a duplicate that EADDRINUSE-crashes + orphans.
         const { pid: running, healed } = reconcileGateway(pidFile, cwd);
         if (running !== undefined && isAlive(running)) {
-            if (healed)
-                out(`healed: adopted a running gateway (pid ${running}) the pid file had lost — no duplicate started.`);
-            out(`gateway already running (pid ${running}).`);
-            out(`  dashboard → ${dashUrl}`);
-            return { exitCode: 0 };
+            // Bare liveness is NOT enough — classify what the alive pid really is (see classifyAliveGateway:
+            // the `nx run` wrapper can outlive its crashed run-executor child, the actual :443 binder).
+            const reality = classifyAliveGateway({
+                oursOn443: gatewayOnPort443(cwd) !== undefined,
+                port443Held: pidsOnPort443().length > 0,
+                pidFileAgeMs: pidFileAgeMs(pidFile),
+            });
+            if (reality === 'serving') {
+                if (healed)
+                    out(`healed: adopted a running gateway (pid ${running}) the pid file had lost — no duplicate started.`);
+                out(`gateway already running (pid ${running}).`);
+                out(`  dashboard → ${dashUrl}`);
+                return { exitCode: 0 };
+            }
+            if (reality === 'booting') {
+                out(`gateway starting (pid ${running}) — :443 not bound yet.`);
+                out(`  dashboard → ${dashUrl}`);
+                out(`  logs      → ${logFile}`);
+                return { exitCode: 0 };
+            }
+            // A zombie: reap the wrapper tree (it would hold the nx run-lock against a respawn), clear the
+            // stale nx daemon state, and fall through to the real paths (register into a live daemon / spawn).
+            killGatewayTree(running, 'SIGKILL');
+            rmFile(pidFile);
+            refreshNxGraph(cwd, ctx.env, () => { });
+            out(`reaped a dead gateway (pid ${running} was alive but nothing served :443 for this workspace).`);
         }
         // :443 is held by another process. If it's a lens DAEMON (its control socket answers), REGISTER this
         // workspace INTO it — the daemon then hosts this workspace's services + dashboard under the one :443
@@ -283,7 +304,20 @@ function runGateway(ctx, args, out, err) {
         // EADDRINUSE-crash + orphan).
         const foreign = pidsOnPort443()[0];
         if (foreign !== undefined) {
-            if (daemonRequest('GET', '/list') !== null) {
+            const list = daemonRequest('GET', '/list');
+            if (list !== null) {
+                // Idempotent for a GUEST too: an already-registered workspace short-circuits — re-registering
+                // would make the daemon tear down + respawn its services and dashboard for nothing.
+                const registered = list.status === 200 && list.json && typeof list.json === 'object'
+                    ? (list.json.workspaces ?? []).some((w) => w.key === cfg.key)
+                    : false;
+                if (registered) {
+                    mkdirSync(dirname(registeredMarker), { recursive: true });
+                    writeFileSync(registeredMarker, JSON.stringify({ wsKey: cfg.key }));
+                    out(`already registered into the shared gateway daemon (pid ${foreign}).`);
+                    out(`  dashboard → ${dashUrl}`);
+                    return { exitCode: 0 };
+                }
                 const res = daemonRequest('POST', '/register', { wsKey: cfg.key, root: cwd, projects: buildProjectsMap(cwd) });
                 if (res && res.status === 200) {
                     mkdirSync(dirname(registeredMarker), { recursive: true });
@@ -330,8 +364,13 @@ function runGateway(ctx, args, out, err) {
     };
     const stop = () => {
         // If THIS workspace registered into a shared daemon (P4), UNREGISTER from it instead of killing a
-        // gateway it never spawned — the daemon reaps this workspace's services + dashboard.
-        if (existsSync(registeredMarker)) {
+        // gateway it never spawned — the daemon reaps this workspace's services + dashboard. But OWNERSHIP
+        // BEATS THE MARKER: when :443 is held by THIS workspace's OWN gateway, the marker is stale litter
+        // (left over from a guest era before this workspace's daemon took over). Honoring it would
+        // self-unregister and LEAVE THE OWNED DAEMON RUNNING (observed live: tetros owned the :443 daemon,
+        // yet `stop` "unregistered 'tetros'" from itself and the daemon kept serving). Guest path only when
+        // we genuinely do NOT own the port; otherwise clear the lying marker and fall through to the kill.
+        if (existsSync(registeredMarker) && gatewayOnPort443(cwd) === undefined) {
             let wsKey = cfg.key;
             try {
                 wsKey = JSON.parse(readFileSync(registeredMarker, 'utf8')).wsKey ?? cfg.key;
@@ -342,6 +381,7 @@ function runGateway(ctx, args, out, err) {
             out(res && res.status === 200 ? `unregistered '${wsKey}' from the shared gateway daemon.` : 'unregister sent (the daemon may already be gone).');
             return { exitCode: 0 };
         }
+        rmFile(registeredMarker); // a stale marker on the daemon OWNER — clear it before the kill path
         // Reality-based: kill the tracked pid OR an orphaned gateway the pid file lost track of (so `stop`
         // works even after the desync — the case where the old CLI reported "not running" but :443 was held).
         const { pid, healed } = reconcileGateway(pidFile, cwd);
@@ -387,7 +427,16 @@ function runGateway(ctx, args, out, err) {
     };
     const status = () => {
         const { pid, healed } = reconcileGateway(pidFile, cwd);
-        const alive = pid !== undefined && isAlive(pid);
+        // ALIVE ≠ SERVING (see classifyAliveGateway) — a zombie `nx run` wrapper whose executor child died
+        // must not report "running — DAEMON on :443" while the workspace 404s.
+        const reality = pid !== undefined && isAlive(pid)
+            ? classifyAliveGateway({
+                oursOn443: gatewayOnPort443(cwd) !== undefined,
+                port443Held: pidsOnPort443().length > 0,
+                pidFileAgeMs: pidFileAgeMs(pidFile),
+            })
+            : undefined;
+        const alive = reality === 'serving' || reality === 'booting';
         // Machine-readable status for the IDE plugin / scripts: the daemon's rich /status (identity + workspaces
         // + per-service live state) plus THIS workspace's role + the dashboard URL. Degrades to a minimal object
         // when no daemon is reachable, so a consumer always gets valid JSON.
@@ -423,7 +472,9 @@ function runGateway(ctx, args, out, err) {
         };
         if (alive) {
             // This workspace's own pid owns :443 → it IS the daemon (it may be hosting other workspaces too).
-            out(`gateway: running (pid ${pid}) — DAEMON on :443${healed ? ' — recovered a stale pid file' : ''}`);
+            out(reality === 'booting'
+                ? `gateway: starting (pid ${pid}) — :443 not bound yet`
+                : `gateway: running (pid ${pid}) — DAEMON on :443${healed ? ' — recovered a stale pid file' : ''}`);
             out(`  workspace → ${cfg.key}`);
             out(`  dashboard → ${dashUrl}`);
             out(`  chooser   → https://lensmcp.local/`);
@@ -441,6 +492,14 @@ function runGateway(ctx, args, out, err) {
             printWorkspaces();
             return { exitCode: 0 };
         }
+        if (reality === 'zombie') {
+            out(`gateway: NOT serving — tracked pid ${pid} is alive but nothing holds :443 for this workspace`);
+            out('  (a crashed gateway under a wedged nx wrapper) — run `lensmcp gateway restart` to recover.');
+            out(`  workspace → ${cfg.key}`);
+            out(`  logs      → ${logFile}`);
+            printWorkspaces();
+            return { exitCode: 1 };
+        }
         out('gateway: stopped');
         out(`  workspace → ${cfg.key}`);
         out(`  dashboard → ${dashUrl}`);
@@ -596,6 +655,33 @@ function gatewayOnPort443(cwd) {
     }
     return undefined;
 }
+/** How long since `start` wrote the pid file (ms) — the spawn timestamp. undefined when unreadable. */
+function pidFileAgeMs(pidFile) {
+    try {
+        return Date.now() - statSync(pidFile).mtimeMs;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** A freshly-spawned gateway legitimately holds NO port yet — services + lens children boot before the
+ *  listeners bind. Give a spawn this long before an alive-but-portless pid is judged a zombie. */
+const BOOT_GRACE_MS = 180_000;
+/** Classify what a TRACKED-ALIVE gateway pid really is. ALIVE ≠ SERVING: the tracked pid is the
+ *  `nx run` WRAPPER, and the process that actually binds :443 is its run-executor child. When that
+ *  child crashes while the wrapper wedges (a lost nx-daemon connection), the pid file points at a live
+ *  process that serves NOTHING — the state that made `start` a no-op forever ("already running") while
+ *  the workspace 404'd. So:
+ *  - serving: this workspace's gateway (the wrapper or a descendant) holds :443 — genuinely up.
+ *  - booting: :443 is unbound and the spawn is fresh — the listeners just haven't bound yet.
+ *  - zombie:  past the boot window with nothing of ours on :443, or the port is already held by
+ *             someone else (a boot could never win it) — dead weight to reap. */
+export function classifyAliveGateway(o) {
+    if (o.oursOn443)
+        return 'serving';
+    const fresh = o.pidFileAgeMs !== undefined && o.pidFileAgeMs < (o.bootGraceMs ?? BOOT_GRACE_MS);
+    return !o.port443Held && fresh ? 'booting' : 'zombie';
+}
 /** Reconcile the tracked pid with reality: a LIVE pid-file wins; otherwise ADOPT an orphaned gateway
  *  still holding :443 (rewriting the pid file) — the self-heal for the stale-pid desync. */
 function reconcileGateway(pidFile, cwd) {
@@ -673,9 +759,10 @@ function firstClusterHost(cwd) {
     return undefined;
 }
 function rmFile(path) {
+    // DELETE, not truncate: an emptied-but-existing registered.json still `existsSync`s, so status/stop
+    // would keep treating an UNREGISTERED workspace as a guest (the lying-marker bug).
     try {
-        if (existsSync(path))
-            writeFileSync(path, '');
+        rmSync(path, { force: true });
     }
     catch {
         /* ignore */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lensmcp",
-  "version": "1.16.26",
+  "version": "1.16.28",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",

package/plugin/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "lensmcp",
   "displayName": "LensMCP",
   "description": "The observability lens for coding agents. One command brings up the dev cluster gateway (every project.json `cluster` decl → its host on :443), the per-project lens dashboard at https://lensmcp.local/<project>/, and the MCP server your agent connects to — scoped automatically to whatever project you opened Claude Code in.",
-  "version": "1.16.26",
+  "version": "1.16.28",
   "author": {
     "name": "David Antoon",
     "email": "davidmantoon@gmail.com"