@aryanduntley/pwa-debug 0.1.3 → 0.1.5

package/README.md

@@ -194,18 +194,18 @@ claude mcp add chrome-devtools --scope user -- npx -y chrome-devtools-mcp@latest
 
 ### Or install `pwa-debug` as a Claude Code plugin
 
-The repo ships a `.claude-plugin/` manifest, so instead of the manual `claude mcp add pwa-debug` above you can install the host as a plugin and pick up updates with **`/reload-plugins`** — no full restart:
+The repo ships a `.claude-plugin/` manifest whose MCP server runs the **published npm package** (`npx -y @aryanduntley/pwa-debug@latest`), so the plugin installs with **no clone and no build** — and picks up updates with **`/reload-plugins`**, no full restart:
 
 ```sh
-# Add this repo as a plugin marketplace (use the local checkout path, or the GitHub URL)
-/plugin marketplace add /absolute/path/to/pwa-debug-layer
-# Install + enable the pwa-debug plugin from it
+# Add the marketplace straight from GitHub (no checkout needed)
+/plugin marketplace add aryanduntley/pwa-debug-layer
+# Install + enable the pwa-debug plugin
 /plugin install pwa-debug@pwa-debug
-# After enabling (or after a `git pull` + rebuild), bring the MCP server up with no restart:
+# Bring the MCP server up with no restart:
 /reload-plugins
 ```
 
-> **Build the host first.** The plugin's MCP entry runs `node ${CLAUDE_PLUGIN_ROOT}/packages/host/dist/main.js`, so `dist/` must exist — run `pnpm --filter @aryanduntley/pwa-debug build` in the checkout before enabling.
+> **No build needed.** The plugin's MCP entry is `npx -y @aryanduntley/pwa-debug@latest`, which fetches the prebuilt host (and its bundled extension) from npm. *Working on a local clone instead?* Skip the plugin and register your own build directly: `claude mcp add pwa-debug --scope user -- node /absolute/path/to/pwa-debug-layer/packages/host/dist/main.js`.
 >
 > **`chrome-devtools-mcp` is still separate.** The plugin declares **only** the `pwa-debug` host — `chrome-devtools-mcp` stays the optional `claude mcp add chrome-devtools …` above (no version coupling, no owning its launch). The bundled **`chrome-devtools-coexistence`** skill walks you through registering it; with a plugin install, its "make the tools appear" step is `/reload-plugins`.
 

package/dist/main.js

@@ -15027,6 +15027,21 @@ const snapshotConn = (c) => Object.freeze({
     connectedAt: c.connectedAt,
     lastSeenAt: c.lastSeenAt,
 });
+// Probe whether a unix socket path has a live listener. Resolves 'live' if a
+// connection is accepted, 'stale' if the path refuses connection (ECONNREFUSED)
+// or is gone (ENOENT) — i.e. an orphaned socket file left behind by a host that
+// was hard-killed (SIGKILL / terminal close / crash) before close() could
+// unlink it. Used to decide whether an EADDRINUSE bind failure is a genuine
+// conflict (another host is up) or a reclaimable stale file.
+const probeSocketLiveness = (path) => new Promise((resolve) => {
+    const probe = createConnection(path);
+    const settle = (result) => {
+        probe.destroy();
+        resolve(result);
+    };
+    probe.once('connect', () => settle('live'));
+    probe.once('error', () => settle('stale'));
+});
 const createIpcServer = async (opts) => {
     const connections = new Map();
     const pending = new Map();
@@ -15117,12 +15132,39 @@ const createIpcServer = async (opts) => {
     const socketPaths = [opts.socketPath, ...(opts.extraSocketPaths ?? [])];
     const servers = socketPaths.map(() => createServer(handleSocket));
     const listenOne = (server, path) => new Promise((resolve, reject) => {
-        const onError = (err) => reject(err);
-        server.once('error', onError);
-        server.listen(path, () => {
-            server.off('error', onError);
-            resolve();
-        });
+        const attempt = (recovered) => {
+            const onError = (err) => {
+                const recoverable = err.code === 'EADDRINUSE' &&
+                    !recovered &&
+                    process.platform !== 'win32';
+                if (!recoverable) {
+                    reject(err);
+                    return;
+                }
+                // A prior host may have been hard-killed without unlinking its socket.
+                // Probe before clobbering: only reclaim a path nothing is listening on
+                // — never unlink out from under a host that is genuinely up.
+                void probeSocketLiveness(path).then(async (liveness) => {
+                    if (liveness === 'live') {
+                        reject(new Error(`ipc server: another pwa-debug host is already listening on ${path}`));
+                        return;
+                    }
+                    try {
+                        await unlink(path);
+                    }
+                    catch {
+                        // already gone — fine, just retry the bind
+                    }
+                    attempt(true);
+                });
+            };
+            server.once('error', onError);
+            server.listen(path, () => {
+                server.off('error', onError);
+                resolve();
+            });
+        };
+        attempt(false);
     });
     await Promise.all(servers.map((s, i) => listenOne(s, socketPaths[i])));
     const sendTo = (extensionId, env) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aryanduntley/pwa-debug",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -41,6 +41,7 @@
   },
   "author": "aryanduntley",
   "bin": {
+    "pwa-debug": "./dist/main.js",
     "pwa-debug-host": "./dist/main.js"
   },
   "main": "./dist/main.js",
@@ -62,8 +63,8 @@
     "@types/winreg": "^1.2.36",
     "rollup": "^4.27.4",
     "tslib": "^2.8.1",
-    "@pwa-debug/extension": "0.1.3",
-    "@pwa-debug/shared": "0.1.3"
+    "@pwa-debug/extension": "0.1.5",
+    "@pwa-debug/shared": "0.1.5"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",