lensmcp 1.18.0 → 1.18.1

package/bundled/dashboard.js

@@ -17435,9 +17435,14 @@ var MAX_ERRORS = 50;
 var STATE_BY_KIND = {
   "service-starting": "starting",
   "service-respawn": "starting",
+  // A lens frontend's vite has been SPAWNED — started, not yet proven to serve.
+  // The gateway's liveness probe emits `service-up` once its port accepts, so
+  // this must claim `starting` and never `up`.
+  "lens-app-up": "starting",
   "service-up": "up",
   "cold-start": "up",
   "service-down": "down",
+  "idle-kill": "idle",
   "service-recycle": "wedged",
   "pod-recycle": "wedged",
   "service-crash-loop": "crash-looping"
@@ -17494,6 +17499,7 @@ var ClusterHealth = class {
       down: byState("down"),
       wedged: byState("wedged"),
       crashLooping: byState("crash-looping"),
+      idle: byState("idle"),
       buildFailed: services.filter((s) => s.buildFailed).map((s) => s.project),
       restarts: services.reduce((n, s) => n + s.restarts, 0),
       errors: this.errors.slice()

package/bundled/main.js

@@ -17437,9 +17437,14 @@ var MAX_ERRORS = 50;
 var STATE_BY_KIND = {
   "service-starting": "starting",
   "service-respawn": "starting",
+  // A lens frontend's vite has been SPAWNED — started, not yet proven to serve.
+  // The gateway's liveness probe emits `service-up` once its port accepts, so
+  // this must claim `starting` and never `up`.
+  "lens-app-up": "starting",
   "service-up": "up",
   "cold-start": "up",
   "service-down": "down",
+  "idle-kill": "idle",
   "service-recycle": "wedged",
   "pod-recycle": "wedged",
   "service-crash-loop": "crash-looping"
@@ -17496,6 +17501,7 @@ var ClusterHealth = class {
       down: byState("down"),
       wedged: byState("wedged"),
       crashLooping: byState("crash-looping"),
+      idle: byState("idle"),
       buildFailed: services.filter((s) => s.buildFailed).map((s) => s.project),
       restarts: services.reduce((n, s) => n + s.restarts, 0),
       errors: this.errors.slice()

package/bundled/shim.js

@@ -8493,6 +8493,9 @@ async function ensureSharedServer(deps) {
   };
   if (await deps.probe())
     return live("already-running");
+  const taken = await deps.foreignPortOwner?.();
+  if (taken)
+    return { outcome: "unavailable", reason: taken, waitedMs: elapsed() };
   let holdsLock = deps.tryCreateLock(JSON.stringify({ pid: process.pid, at: deps.now() }));
   if (!holdsLock) {
     const existing = parseSpawnLock(deps.readLock());
@@ -8624,6 +8627,9 @@ function startSharedServerWatched(opts) {
   }
 }
 
+// servers/lensmcp-mcp/dist/shim/probe.js
+import { connect } from "node:net";
+
 // servers/lensmcp-mcp/dist/shim/workspace.js
 import { existsSync as existsSync2, readFileSync as readFileSync2, realpathSync } from "node:fs";
 import { basename, dirname, join as join2 } from "node:path";
@@ -8779,7 +8785,7 @@ async function probeShared(port, timeoutMs = 2e3) {
     if (res.ok) {
       const identity = parseServerIdentity(await res.json().catch(() => void 0));
       if (identity)
-        return { alive: true, identity };
+        return { alive: true, identity, owner: "lensmcp" };
     } else {
       await res.text().catch(() => void 0);
     }
@@ -8788,8 +8794,22 @@ async function probeShared(port, timeoutMs = 2e3) {
     clearTimeout(timer);
   }
   if (!answered)
-    return { alive: false };
-  return { alive: await probeMcp(sharedMcpUrl(port), timeoutMs) };
+    return { alive: false, owner: "none" };
+  const legacy = await probeMcp(sharedMcpUrl(port), timeoutMs);
+  return { alive: legacy, owner: legacy ? "lensmcp" : "foreign" };
+}
+function tcpAccepts(port, timeoutMs = 750) {
+  return new Promise((resolve2) => {
+    const socket = connect({ port, host: "127.0.0.1" });
+    const settle = (accepted) => {
+      socket.destroy();
+      resolve2(accepted);
+    };
+    socket.setTimeout(timeoutMs);
+    socket.once("connect", () => settle(true));
+    socket.once("timeout", () => settle(false));
+    socket.once("error", () => settle(false));
+  });
 }
 
 // servers/lensmcp-mcp/dist/shim/proxy.js
@@ -8976,9 +8996,9 @@ async function main() {
   const scope = resolveWorkspaceScope(cwd);
   const url2 = sharedMcpUrl(scope.mcpHttpPort);
   log(`[lensmcp] shim \u2192 workspace "${scope.key}" (${scope.root}) \u2192 ${url2}`);
-  let seen = { alive: false };
+  let seen = { alive: false, owner: "none" };
   let warnedUnknown = false;
-  let refused = false;
+  let explained = false;
   const verifyIdentity = () => {
     const mismatch = describeIdentityMismatch(scope, seen.identity);
     if (!mismatch) {
@@ -8989,7 +9009,7 @@ async function main() {
       return void 0;
     }
     const theirs = seen.identity;
-    refused = true;
+    explained = true;
     log("");
     log(`[lensmcp] REFUSING the shared MCP server on 127.0.0.1:${scope.mcpHttpPort} \u2014 ${mismatch}.`);
     log(`[lensmcp]   this session's workspace : "${scope.key}"  ${scope.root}`);
@@ -9002,6 +9022,27 @@ async function main() {
     log("");
     return `the shared MCP port is served by workspace "${theirs?.key}", not "${scope.key}"`;
   };
+  const foreignPortOwner = async () => {
+    const port = scope.mcpHttpPort;
+    const nonHttp = seen.owner === "foreign" ? false : await tcpAccepts(port);
+    if (seen.owner !== "foreign" && !nonHttp)
+      return void 0;
+    explained = true;
+    log("");
+    log(`[lensmcp] the shared MCP port 127.0.0.1:${port} is TAKEN by another process.`);
+    log(`[lensmcp]   It ${nonHttp ? "accepts connections but does not speak HTTP" : "answers HTTP but is not a lensmcp MCP server"}, so this session cannot attach to it.`);
+    log("[lensmcp]   Not starting a server on it: on macOS a second bind SUCCEEDS on the");
+    log("[lensmcp]   wildcard address while the kernel keeps routing 127.0.0.1 to the");
+    log("[lensmcp]   process already there \u2014 the new server would be unreachable, and");
+    log("[lensmcp]   would keep running after this session ends.");
+    log("[lensmcp]   Fix EITHER by freeing the port:");
+    log(`[lensmcp]     lsof -nP -iTCP:${port} -sTCP:LISTEN`);
+    log(`[lensmcp]   OR by pinning a different one in ${join3(scope.root, ".lensmcp", "config.json")}:`);
+    log(`[lensmcp]     { "ports": { "mcpHttp": ${port + 1} } }`);
+    log("[lensmcp]   then restart this session. Any free 4500-4699 port works.");
+    log("");
+    return `the shared MCP port ${port} is held by another process that is not a lensmcp server`;
+  };
   const ensure = () => {
     let watch;
     return ensureSharedServer({
@@ -9010,6 +9051,7 @@ async function main() {
         return seen.alive;
       },
       verifyIdentity,
+      foreignPortOwner,
       startServer: () => {
         const started = startSharedServerWatched({
           serverEntry: serverEntry(),
@@ -9032,7 +9074,7 @@ async function main() {
   };
   const ensured = await ensure();
   if (ensured.outcome === "unavailable") {
-    runEmbedded(cwd, ensured.reason ?? "unknown", !refused);
+    runEmbedded(cwd, ensured.reason ?? "unknown", !explained);
     return;
   }
   log(`[lensmcp] shim: shared server ${ensured.outcome} (${ensured.waitedMs}ms)`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lensmcp",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "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.18.0",
+  "version": "1.18.1",
   "author": {
     "name": "David Antoon",
     "email": "davidmantoon@gmail.com"