@mentiko/pty-mgr 1.4.3 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 1.5.0 - 2026-07-18
+
+### Added
+
+- `p daemons` lists every running daemon on the machine — one line per daemon
+  with pid, uptime, session counts, and cwd, in the same style as `p list`. The
+  currently-selected daemon (`@name` / `$PTY_DAEMON`) is marked with a leading
+  `*`; a socket that no longer answers is shown as `(stale)` and one with an
+  empty name as `(unnamed)`. It is read-only — unlike `p stop all` it never
+  removes stale sockets. Both commands now share one socket-enumeration helper.
+
+### Fixed
+
+- The installer no longer reports success while an older `pty-mgr` shadows the
+  freshly installed one. `install.sh` used to print `PATH is set.` once
+  `~/.pty-mgr/bin` was on `PATH`, which said nothing about *which* copy answers:
+  a stale binary earlier in `PATH` (e.g. a hand-placed `/usr/local/bin/pty-mgr`,
+  which sits on line 1 of macOS `/etc/paths`) would win silently. The installer
+  now scans every `PATH` entry after installing and prints any other `pty-mgr`
+  or `p` it finds, with an exact `rm` line to remove them.
+
 ## 1.4.3 - 2026-07-07
 
 ### Fixed

package/lib/pty-manager.mjs

@@ -42,7 +42,7 @@ import { fileURLToPath } from "node:url";
 import { spawn as spawnChild } from "node:child_process";
 
 // kept in sync by scripts/version-sync.cjs (rewrites this literal on release)
-export const VERSION = "1.4.3";
+export const VERSION = "1.5.0";
 import xterm from "@xterm/headless";
 import { SerializeAddon } from "@xterm/addon-serialize";
 
@@ -1479,6 +1479,32 @@ function sendCommandTo(sock, req) {
   return requestSocket(sock, req, "daemon not running");
 }
 
+// enumerate every daemon socket: ~/.pty-manager/*.sock plus legacy
+// /tmp/pty-manager-*.sock. returns [{ name, sockFile }]. shared by `stop all`
+// and `daemons` so both see the same set. presence of a .sock file does not
+// prove the daemon is alive -- the caller probes it.
+function listDaemonSockets() {
+  const found = [];
+  const dir = join(homedir(), ".pty-manager");
+  try {
+    for (const f of readdirSync(dir)) {
+      if (f.endsWith(".sock")) {
+        found.push({ name: f.replace(/\.sock$/, ""), sockFile: join(dir, f) });
+      }
+    }
+  } catch { /* dir doesn't exist yet */ }
+  try {
+    const tmp = tmpdir();
+    for (const f of readdirSync(tmp)) {
+      if (f.startsWith("pty-manager-") && f.endsWith(".sock")) {
+        const name = f.replace(/^pty-manager-/, "").replace(/\.sock$/, "");
+        found.push({ name, sockFile: join(tmp, f) });
+      }
+    }
+  } catch { /* tmp unreadable */ }
+  return found;
+}
+
 // send to the daemon selected by @name / --daemon / $PTY_DAEMON.
 function sendCommand(req) {
   return requestSocket(SOCKET_PATH, req, "daemon not running. start with: pty-mgr daemon");
@@ -1642,6 +1668,7 @@ const USAGE = `pty-mgr - PTY session manager
 usage:
   p daemon                           start daemon (background: &)
   p daemon @myproject                named daemon (isolated sessions)
+  p daemons                          list all running daemons (* = current)
   p status                           daemon info + config
   p config                           show current config
   p config screen 100x50             set default terminal size
@@ -3059,32 +3086,13 @@ async function cli() {
     const target = args[0]; // "all" or undefined (= current daemon)
     if (target === "all") {
       // find all pty-manager sockets and shut them down
-      const dir = join(homedir(), ".pty-manager");
-      let socks = [];
-      try {
-        socks = readdirSync(dir).filter((f) => f.endsWith(".sock"));
-      } catch { /* dir doesn't exist */ }
-      // also check legacy /tmp/ location for old sockets
-      try {
-        const tmp = tmpdir();
-        const legacy = readdirSync(tmp).filter((f) => f.startsWith("pty-manager-") && f.endsWith(".sock"));
-        for (const s of legacy) socks.push("__legacy__/" + s);
-      } catch {}
-      if (socks.length === 0) {
+      const daemons = listDaemonSockets();
+      if (daemons.length === 0) {
         console.log("no daemons running");
         return;
       }
       const stopped = [];
-      for (const sock of socks) {
-        let sockFile, name;
-        if (sock.startsWith("__legacy__/")) {
-          const legacyName = sock.replace("__legacy__/", "");
-          sockFile = join(tmpdir(), legacyName);
-          name = legacyName.replace("pty-manager-", "").replace(".sock", "");
-        } else {
-          sockFile = join(dir, sock);
-          name = sock.replace(".sock", "");
-        }
+      for (const { name, sockFile } of daemons) {
         try {
           const res = await sendCommandTo(sockFile, { cmd: "shutdown" });
           if (res.ok) stopped.push(name);
@@ -3107,6 +3115,36 @@ async function cli() {
     return;
   }
 
+  if (command === "daemons") {
+    // read-only listing of every daemon socket. probes each for live status;
+    // unlike `stop all` it never removes stale sockets. one line per daemon,
+    // matching the `list` house style. current daemon (@name/$PTY_DAEMON) is
+    // marked with a leading '*'.
+    const daemons = listDaemonSockets();
+    if (daemons.length === 0) {
+      console.log("no daemons running");
+      return;
+    }
+    for (const { name, sockFile } of daemons) {
+      const marker = sockFile === SOCKET_PATH ? "*" : " ";
+      let st = null;
+      try {
+        const res = await sendCommandTo(sockFile, { cmd: "status" });
+        if (res.ok) st = res.status;
+      } catch { /* stale: file exists but nothing is listening */ }
+      const label = name || "(unnamed)";
+      if (st) {
+        const s = st.sessions;
+        let line = `${marker} ${label}  pid=${st.pid}  up=${st.uptime}  ${s.alive}/${s.total} sessions`;
+        if (st.cwd) line += `  ${st.cwd}`; // older daemons may not report cwd
+        console.log(line);
+      } else {
+        console.log(`${marker} ${label}  (stale)`);
+      }
+    }
+    return;
+  }
+
   if (command === "attach") {
     const name = args[0];
     if (!name) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentiko/pty-mgr",
-  "version": "1.4.3",
+  "version": "1.5.0",
   "description": "PTY session manager with terminal emulation for programmatic session control.",
   "type": "module",
   "main": "lib/pty-manager.mjs",
@@ -26,10 +26,10 @@
     "@xterm/headless": "^6.0.0"
   },
   "optionalDependencies": {
-    "@mentiko/pty-mgr-linux-x64": "1.4.3",
-    "@mentiko/pty-mgr-linux-arm64": "1.4.3",
-    "@mentiko/pty-mgr-darwin-x64": "1.4.3",
-    "@mentiko/pty-mgr-darwin-arm64": "1.4.3"
+    "@mentiko/pty-mgr-linux-x64": "1.5.0",
+    "@mentiko/pty-mgr-linux-arm64": "1.5.0",
+    "@mentiko/pty-mgr-darwin-x64": "1.5.0",
+    "@mentiko/pty-mgr-darwin-arm64": "1.5.0"
   },
   "engines": {
     "bun": ">=1.0"