@co0ontty/wand 4.75.1 → 4.75.2-beta.g0c40bc0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "1d477a238a1e35f04bdd754c96a3bfff5e1738a3",
-  "builtAt": "2026-09-24T07:15:43.975Z",
-  "version": "4.75.1",
-  "channel": "stable"
+  "commit": "0c40bc05212ddd1238c5e34b8e22c360948d714d",
+  "builtAt": "2026-09-24T07:47:55.588Z",
+  "version": "4.75.2-beta.g0c40bc0",
+  "channel": "beta"
 }

package/dist/render-protocol.d.ts

@@ -112,7 +112,15 @@ export interface RenderPaths {
  * `.terminald-<suffix>.token`）**刻意使用不同文件名**：升级期两套并存，
  * 但永不互相领养。
  */
-export declare function renderPaths(configPath: string): RenderPaths;
+export declare function renderPaths(configPath: string, uidOverride?: number): RenderPaths;
+/**
+ * 端点里的 uid 是**跑 daemon 那个用户**的，不是调用者的。
+ *
+ * `wand service:install` 是拿 sudo 跑的，而 daemon 在 unit/plist 里被钉成 config 的
+ * owner；调用方必须显式传 owner uid，否则 root 会算出 `/tmp/wand-render-0-<hash>.sock`
+ * 这种永远不存在的路径（2026-09-24 就这么把两个健康 daemon 误判成僵尸杀掉了）。
+ */
+export declare function resolveEndpointUid(uidOverride?: number): number;
 /** 编码一帧：`u32` 大端长度 + UTF-8 JSON。 */
 export declare function encodeRenderFrame(value: unknown): Buffer;
 /**

package/dist/render-protocol.js

@@ -39,18 +39,11 @@ function canonicalConfigPath(configPath) {
  * `.terminald-<suffix>.token`）**刻意使用不同文件名**：升级期两套并存，
  * 但永不互相领养。
  */
-export function renderPaths(configPath) {
+export function renderPaths(configPath, uidOverride) {
     const resolved = canonicalConfigPath(configPath);
     const suffix = createHash("sha256").update(resolved).digest("hex").slice(0, 12);
     const dir = path.dirname(resolved);
-    const uid = (() => {
-        try {
-            return os.userInfo().uid;
-        }
-        catch {
-            return 0;
-        }
-    })();
+    const uid = resolveEndpointUid(uidOverride);
     return {
         // macOS 的 Unix socket 路径上限约 100 字节，所以 socket 放 /tmp 保持短。
         socketPath: path.join("/tmp", `wand-render-${uid}-${suffix}.sock`),
@@ -59,6 +52,23 @@ export function renderPaths(configPath) {
         metaPath: path.join(dir, `.render-${suffix}.json`),
     };
 }
+/**
+ * 端点里的 uid 是**跑 daemon 那个用户**的，不是调用者的。
+ *
+ * `wand service:install` 是拿 sudo 跑的，而 daemon 在 unit/plist 里被钉成 config 的
+ * owner；调用方必须显式传 owner uid，否则 root 会算出 `/tmp/wand-render-0-<hash>.sock`
+ * 这种永远不存在的路径（2026-09-24 就这么把两个健康 daemon 误判成僵尸杀掉了）。
+ */
+export function resolveEndpointUid(uidOverride) {
+    if (typeof uidOverride === "number" && Number.isInteger(uidOverride) && uidOverride >= 0)
+        return uidOverride;
+    try {
+        return os.userInfo().uid;
+    }
+    catch {
+        return 0;
+    }
+}
 /** 编码一帧：`u32` 大端长度 + UTF-8 JSON。 */
 export function encodeRenderFrame(value) {
     const body = Buffer.from(JSON.stringify(value), "utf8");

package/dist/terminal-daemon-protocol.d.ts

@@ -42,4 +42,4 @@ export interface TerminalDaemonAttachPayload {
     state: TerminalSessionState;
     isNew: boolean;
 }
-export declare function terminalDaemonPaths(configPath: string): TerminalDaemonPaths;
+export declare function terminalDaemonPaths(configPath: string, uidOverride?: number): TerminalDaemonPaths;

package/dist/terminal-daemon-protocol.js

@@ -1,19 +1,14 @@
 import { createHash } from "node:crypto";
-import os from "node:os";
 import path from "node:path";
+import { resolveEndpointUid } from "./render-protocol.js";
 export const TERMINAL_DAEMON_PROTOCOL_VERSION = 2;
-export function terminalDaemonPaths(configPath) {
+export function terminalDaemonPaths(configPath, uidOverride) {
     const resolved = path.resolve(configPath);
     const suffix = createHash("sha256").update(resolved).digest("hex").slice(0, 12);
     const dir = path.dirname(resolved);
-    const uid = (() => {
-        try {
-            return os.userInfo().uid;
-        }
-        catch {
-            return 0;
-        }
-    })();
+    // uid 属于跑 daemon 的那个用户；拿 sudo 调用的命令必须显式传 config owner 的 uid，
+    // 否则 root 会算出 `-0-` 这种不存在的端点（见 render-protocol 的 resolveEndpointUid）。
+    const uid = resolveEndpointUid(uidOverride);
     return {
         socketPath: process.platform === "win32"
             ? `\\\\.\\pipe\\wand-terminald-${suffix}`

package/dist/terminal-daemon-server.d.ts

@@ -11,4 +11,4 @@ export interface StructuredRunRetentionEntry {
  */
 export declare function structuredRunEvictionOrder(entries: readonly StructuredRunRetentionEntry[], now?: number): string[];
 export declare function runTerminalDaemon(configPath: string): Promise<void>;
-export declare function readTerminalDaemonPid(configPath: string): number | null;
+export declare function readTerminalDaemonPid(configPath: string, uidOverride?: number): number | null;

package/dist/terminal-daemon-server.js

@@ -531,9 +531,9 @@ function fileHoldsValue(filePath, expected) {
         return false;
     }
 }
-export function readTerminalDaemonPid(configPath) {
+export function readTerminalDaemonPid(configPath, uidOverride) {
     try {
-        const value = Number(readFileSync(terminalDaemonPaths(configPath).pidPath, "utf8").trim());
+        const value = Number(readFileSync(terminalDaemonPaths(configPath, uidOverride).pidPath, "utf8").trim());
         return Number.isSafeInteger(value) && value > 0 ? value : null;
     }
     catch {

package/dist/tui/commands.d.ts

@@ -90,5 +90,7 @@ export declare function serviceRestart(opts?: ServiceOpts): CommandResult;
 export declare function serviceLogs(lines?: number, opts?: ServiceOpts): CommandResult;
 export declare function installService(ctx: ServiceContext): CommandResult;
 export declare function uninstallService(opts?: ServiceOpts): CommandResult;
+/** pid 的命令行是否确实是「本 config 的 render / terminald」。 */
+export declare function isDaemonProcessForConfig(pid: number, configPath: string, kind: "render" | "terminald"): boolean;
 /** 读取已安装服务 unit / plist 的入口命令；未安装或平台不支持时返回 null。 */
 export declare function readServiceEntrypoint(scope: ServiceScope): string | null;

package/dist/tui/commands.js

@@ -643,21 +643,44 @@ function terminalServicePathFor(scope) {
     }
     return "";
 }
+/**
+ * 本 config 的 config 文件 owner uid。
+ *
+ * daemon 在 unit/plist 里被钉成 config owner，端点路径里的 uid 也是它；而
+ * `wand service:install` 常常是 sudo 跑的（uid 0），所以任何涉及 daemon 文件的读取
+ * 都必须用这个 uid，不能用调用者的。
+ */
+function configOwnerUid(configPath) {
+    try {
+        return statUid(path.resolve(configPath));
+    }
+    catch {
+        return undefined;
+    }
+}
 function hasLiveTerminalDaemon(configPath) {
-    const pid = readTerminalDaemonPid(configPath);
+    const pid = readTerminalDaemonPid(configPath, configOwnerUid(configPath));
     return pid !== null && isPidAlive(pid);
 }
-/** 按 config 派生两套 daemon 的端点（socket 在 /tmp、pid 在 config 目录旁边）。 */
+/** 按 config 派生两套 daemon 的端点（socket 在 /tmp、pid 在 config 目录旁边）。
+ *
+ * uid 用 **config 文件 owner** 的，不是调用者的：`wand service:install` 常常是 sudo 跑的，
+ * 而 daemon 在 unit/plist 里被钉成 config owner。用调用者的 uid 会算出 `-0-` 这种不存在的
+ * 端点，把健康 daemon 当成僵尸（2026-09-24 真实发生过，两个 daemon 被误杀）。
+ */
 function daemonEndpointStates(configPath) {
-    const render = renderPaths(configPath);
-    const terminal = terminalDaemonPaths(configPath);
-    return [
-        { label: "Render", pidPath: render.pidPath, socketPath: render.socketPath },
-        { label: "terminald", pidPath: terminal.pidPath, socketPath: terminal.socketPath },
-    ].map(({ label, pidPath, socketPath }) => {
+    const ownerUid = configOwnerUid(configPath);
+    const render = renderPaths(configPath, ownerUid);
+    const terminal = terminalDaemonPaths(configPath, ownerUid);
+    const endpoints = [
+        { label: "Render", kind: "render", pidPath: render.pidPath, socketPath: render.socketPath },
+        { label: "terminald", kind: "terminald", pidPath: terminal.pidPath, socketPath: terminal.socketPath },
+    ];
+    return endpoints.map(({ label, kind, pidPath, socketPath }) => {
         const pid = readDaemonPidFile(pidPath);
         return {
             label,
+            kind,
             pid,
             pidAlive: pid !== null && isPidAlive(pid),
             socketPath,
@@ -695,6 +718,12 @@ function reapZombieDaemons(configPath) {
     for (const state of daemonEndpointStates(configPath)) {
         if (!state.pidAlive || state.socketExists)
             continue;
+        // 最后一道闸：确认这个 pid 的**命令行**就是本 config 的这个 daemon。
+        // 路径解析一旦与 daemon 不一致（比如 uid 算错），这条能挡住误杀。
+        if (!isDaemonProcessForConfig(state.pid, configPath, state.kind)) {
+            actions.push(`${state.label} pid ${state.pid} 端点缺失但命令行不像是本 config 的 daemon，跳过清理（保存证据）`);
+            continue;
+        }
         try {
             process.kill(state.pid, "SIGKILL");
             actions.push(`${state.label} daemon pid ${state.pid} 进程活着但端点已丢失（${state.socketPath}），已清理`);
@@ -705,6 +734,14 @@ function reapZombieDaemons(configPath) {
     }
     return actions;
 }
+/** pid 的命令行是否确实是「本 config 的 render / terminald」。 */
+export function isDaemonProcessForConfig(pid, configPath, kind) {
+    const result = spawnSync("ps", ["-o", "command=", "-p", String(pid)], { encoding: "utf8", timeout: 5_000 });
+    const command = (result.stdout ?? "").trim();
+    if (!command || !command.includes(configPath))
+        return false;
+    return kind === "render" ? command.includes("wand-render") : command.includes("terminald");
+}
 /**
  * 「正在跑的 daemon 比装好的二进制旧」的提示（没有这种情形时返回 null）。
  *
@@ -714,7 +751,7 @@ function reapZombieDaemons(configPath) {
  * 看不到 detail，所以这句拼进 message 里。
  */
 function staleDaemonNote(configPath) {
-    const render = renderPaths(configPath);
+    const render = renderPaths(configPath, configOwnerUid(configPath));
     const pid = readDaemonPidFile(render.pidPath);
     if (pid === null || !isPidAlive(pid))
         return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@co0ontty/wand",
-  "version": "4.75.1",
+  "version": "4.75.2-beta.g0c40bc0",
   "description": "A web console for Claude Code, Codex, OpenCode, and other local CLI tools.",
   "type": "module",
   "bin": {