chatccc 0.2.233 → 0.2.235

package/src/__tests__/claude-sdk-installer.test.ts

@@ -0,0 +1,285 @@
+import { afterEach, describe, expect, it } from "vitest";
+import {
+  chmodSync,
+  mkdirSync,
+  mkdtempSync,
+  readFileSync,
+  rmSync,
+  writeFileSync,
+  existsSync,
+} from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import {
+  CLAUDE_SDK_VERSION,
+  getClaudeSdkEntryPath,
+  getClaudeSdkInstalledVersion,
+  installClaudeSdk,
+  isClaudeSdkInstalled,
+  isClaudeSdkInstalling,
+  type SdkInstallProgress,
+} from "../claude-sdk-installer.ts";
+
+// ---------------------------------------------------------------------------
+// 工具：fake npm（可执行脚本，模拟安装过程并伪造产物）
+// ---------------------------------------------------------------------------
+
+const tempDirs: string[] = [];
+
+function makeTempDir(prefix = "claude-sdk-test-"): string {
+  const dir = mkdtempSync(join(tmpdir(), prefix));
+  tempDirs.push(dir);
+  return dir;
+}
+
+/** 伪造 SDK 产物：node_modules/@anthropic-ai/claude-agent-sdk/package.json */
+function fakeInstallArtifact(dir: string, version: string = CLAUDE_SDK_VERSION): void {
+  const pkgDir = join(dir, "node_modules", "@anthropic-ai", "claude-agent-sdk");
+  mkdirSync(pkgDir, { recursive: true });
+  writeFileSync(
+    join(pkgDir, "package.json"),
+    JSON.stringify({ name: "@anthropic-ai/claude-agent-sdk", version }),
+    "utf8",
+  );
+}
+
+/** 生成 fake npm 可执行脚本，行为由环境变量控制（FAKE_NPM_FAIL / FAKE_NPM_SLEEP） */
+function makeFakeNpmCommand(workDir: string): string {
+  const mjs = join(workDir, "fake-npm.mjs");
+  writeFileSync(
+    mjs,
+    [
+      'import fs from "node:fs";',
+      'const args = process.argv.slice(2);',
+      'const prefixIdx = args.indexOf("--prefix");',
+      'const dir = prefixIdx >= 0 ? args[prefixIdx + 1] : null;',
+      'const pkg = args.find((a) => a.startsWith("@anthropic-ai/claude-agent-sdk@"));',
+      'const version = pkg ? pkg.split("@").pop() : "0.0.0";',
+      'if (dir) {',
+      '  fs.mkdirSync(dir + "/node_modules/@anthropic-ai/claude-agent-sdk", { recursive: true });',
+      '  fs.writeFileSync(dir + "/node_modules/@anthropic-ai/claude-agent-sdk/package.json", JSON.stringify({ name: "@anthropic-ai/claude-agent-sdk", version }));',
+      "}",
+      'console.log("npm http fetch GET 200 https://registry.npmjs.org/fake");',
+      'console.log("npm http fetch GET 200 https://registry.npmjs.org/fake2");',
+      'if (process.env.FAKE_NPM_SLEEP) {',
+      "  await new Promise((r) => setTimeout(r, Number(process.env.FAKE_NPM_SLEEP)));",
+      "}",
+      'if (process.env.FAKE_NPM_FAIL === "1") process.exit(1);',
+      "process.exit(0);",
+      "",
+    ].join("\n"),
+    "utf8",
+  );
+
+  if (process.platform === "win32") {
+    const cmd = join(workDir, "fake-npm.cmd");
+    const winPath = mjs.replace(/\//g, "\\");
+    writeFileSync(
+      cmd,
+      ["@echo off", `node "${winPath}" %*`, ""].join("\r\n"),
+      "utf8",
+    );
+    return cmd;
+  }
+  const sh = join(workDir, "fake-npm.sh");
+  writeFileSync(sh, `#!/bin/sh\nexec node "${mjs}" "$@"\n`, "utf8");
+  // chmod +x
+  try {
+    chmodSync(sh, 0o755);
+  } catch {
+    // POSIX only
+  }
+  return sh;
+}
+
+const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
+
+afterEach(() => {
+  for (const dir of tempDirs.splice(0)) {
+    try {
+      rmSync(dir, { recursive: true, force: true });
+    } catch {
+      // 清理失败不阻塞
+    }
+  }
+});
+
+// ---------------------------------------------------------------------------
+// 状态查询
+// ---------------------------------------------------------------------------
+
+describe("claude-sdk-installer 状态查询", () => {
+  it("getClaudeSdkEntryPath 指向 sdk.mjs 入口", () => {
+    const dir = makeTempDir();
+    const entry = getClaudeSdkEntryPath(dir);
+    expect(entry).toContain(join("node_modules", "@anthropic-ai", "claude-agent-sdk"));
+    expect(entry.endsWith("sdk.mjs")).toBe(true);
+  });
+
+  it("isClaudeSdkInstalled：空目录为 false，有 package.json 为 true", () => {
+    const dir = makeTempDir();
+    expect(isClaudeSdkInstalled(dir)).toBe(false);
+    fakeInstallArtifact(dir);
+    expect(isClaudeSdkInstalled(dir)).toBe(true);
+  });
+
+  it("getClaudeSdkInstalledVersion：读取版本号", () => {
+    const dir = makeTempDir();
+    expect(getClaudeSdkInstalledVersion(dir)).toBeNull();
+    fakeInstallArtifact(dir, "9.9.9");
+    expect(getClaudeSdkInstalledVersion(dir)).toBe("9.9.9");
+  });
+
+  it("getClaudeSdkInstalledVersion：损坏 JSON 返回 null", () => {
+    const dir = makeTempDir();
+    const pkgDir = join(dir, "node_modules", "@anthropic-ai", "claude-agent-sdk");
+    mkdirSync(pkgDir, { recursive: true });
+    writeFileSync(join(pkgDir, "package.json"), "{ not json", "utf8");
+    expect(getClaudeSdkInstalledVersion(dir)).toBeNull();
+  });
+
+  it("isClaudeSdkInstalling：无锁为 false", () => {
+    const dir = makeTempDir();
+    expect(isClaudeSdkInstalling(dir)).toBe(false);
+  });
+
+  it("isClaudeSdkInstalling：活 pid 锁为 true", () => {
+    const dir = makeTempDir();
+    writeFileSync(join(dir, ".installing"), String(process.pid), "utf8");
+    expect(isClaudeSdkInstalling(dir)).toBe(true);
+  });
+
+  it("isClaudeSdkInstalling：死 pid 锁自动清除并返回 false", () => {
+    const dir = makeTempDir();
+    writeFileSync(join(dir, ".installing"), "999999999", "utf8");
+    expect(isClaudeSdkInstalling(dir)).toBe(false);
+    expect(existsSync(join(dir, ".installing"))).toBe(false);
+  });
+
+  it("isClaudeSdkInstalling：损坏锁自动清除并返回 false", () => {
+    const dir = makeTempDir();
+    writeFileSync(join(dir, ".installing"), "abc", "utf8");
+    expect(isClaudeSdkInstalling(dir)).toBe(false);
+    expect(existsSync(join(dir, ".installing"))).toBe(false);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// 安装流程
+// ---------------------------------------------------------------------------
+
+describe("installClaudeSdk", () => {
+  it("已装同版本 → 直接 done，不 spawn", async () => {
+    const dir = makeTempDir();
+    fakeInstallArtifact(dir, CLAUDE_SDK_VERSION);
+    const phases: string[] = [];
+    await installClaudeSdk({
+      dir,
+      npmCommand: "definitely-not-exists",
+      onProgress: (p) => phases.push(p.phase),
+    });
+    expect(phases).toEqual(["done"]);
+    expect(getClaudeSdkInstalledVersion(dir)).toBe(CLAUDE_SDK_VERSION);
+  });
+
+  it("未安装 → fake npm 成功 → done + 锁清除 + 进度序列", async () => {
+    const dir = makeTempDir();
+    const npmCommand = makeFakeNpmCommand(makeTempDir());
+    const phases: string[] = [];
+    const messages: string[] = [];
+    await installClaudeSdk({
+      dir,
+      npmCommand,
+      onProgress: (p) => {
+        phases.push(p.phase);
+        messages.push(p.message);
+      },
+    });
+    expect(phases[0]).toBe("detecting");
+    expect(phases).toContain("downloading");
+    expect(phases[phases.length - 1]).toBe("done");
+    expect(isClaudeSdkInstalled(dir)).toBe(true);
+    expect(getClaudeSdkInstalledVersion(dir)).toBe(CLAUDE_SDK_VERSION);
+    expect(existsSync(join(dir, ".installing"))).toBe(false);
+  });
+
+  it("已装不同版本 → 触发重装并成功", async () => {
+    const dir = makeTempDir();
+    fakeInstallArtifact(dir, "0.1.0");
+    const npmCommand = makeFakeNpmCommand(makeTempDir());
+    await installClaudeSdk({ dir, npmCommand });
+    expect(getClaudeSdkInstalledVersion(dir)).toBe(CLAUDE_SDK_VERSION);
+  });
+
+  it("安装失败（fake npm exit 1）→ error + 目录清理 + reject", async () => {
+    const dir = makeTempDir();
+    const npmCommand = makeFakeNpmCommand(makeTempDir());
+    const phases: string[] = [];
+    process.env.FAKE_NPM_FAIL = "1";
+    try {
+      await expect(
+        installClaudeSdk({
+          dir,
+          npmCommand,
+          onProgress: (p) => phases.push(p.phase),
+        }).then(() => {
+          throw new Error("should have rejected");
+        }),
+      ).rejects.toThrow(/退出码 1/);
+    } finally {
+      delete process.env.FAKE_NPM_FAIL;
+    }
+    expect(phases[phases.length - 1]).toBe("error");
+    expect(existsSync(dir)).toBe(false);
+  });
+
+  it("安装失败（spawn error）→ reject 且不残留锁", async () => {
+    const dir = makeTempDir();
+    await expect(
+      installClaudeSdk({ dir, npmCommand: join(makeTempDir(), "no-such-npm") }),
+    ).rejects.toThrow();
+    expect(existsSync(dir)).toBe(false);
+  });
+
+  it("锁存在（活 pid）→ reject 且不启动安装", async () => {
+    const dir = makeTempDir();
+    writeFileSync(join(dir, ".installing"), String(process.pid), "utf8");
+    await expect(
+      installClaudeSdk({ dir, npmCommand: "definitely-not-exists" }),
+    ).rejects.toThrow(/另一个安装任务/);
+  });
+
+  it("并发：安装进行中再次调用 → reject", async () => {
+    const dir = makeTempDir();
+    const npmCommand = makeFakeNpmCommand(makeTempDir());
+    process.env.FAKE_NPM_SLEEP = "400";
+    try {
+      const p1 = installClaudeSdk({
+        dir,
+        npmCommand,
+        expectedVersion: CLAUDE_SDK_VERSION,
+      });
+      await sleep(80); // 等 installInProgress = true
+      await expect(
+        installClaudeSdk({ dir, npmCommand }),
+      ).rejects.toThrow(/正在安装/);
+      await p1;
+    } finally {
+      delete process.env.FAKE_NPM_SLEEP;
+    }
+    expect(getClaudeSdkInstalledVersion(dir)).toBe(CLAUDE_SDK_VERSION);
+  });
+
+  it("进度 percent 单调且封顶 100", async () => {
+    const dir = makeTempDir();
+    const npmCommand = makeFakeNpmCommand(makeTempDir());
+    const progress: SdkInstallProgress[] = [];
+    await installClaudeSdk({ dir, npmCommand, onProgress: (p) => progress.push(p) });
+    expect(progress.length).toBeGreaterThan(1);
+    for (const p of progress) {
+      expect(p.percent).toBeGreaterThanOrEqual(0);
+      expect(p.percent).toBeLessThanOrEqual(100);
+    }
+    expect(progress[progress.length - 1].percent).toBe(100);
+  });
+});

package/src/__tests__/restart.test.ts

@@ -1,177 +1,177 @@
-import { EventEmitter } from "node:events";
-import { mkdtemp, readdir, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-
-import { describe, expect, it, vi, afterEach } from "vitest";
-
-import {
-  buildRestartSpawnSpec,
-  decideRestartParentExit,
-  spawnRestartChild,
-  RESTART_CHILD_READY_MS,
-} from "../orchestrator.ts";
-import { INTERNAL_RESTART_ENV_VAR } from "../startup-lifecycle.ts";
-
-describe("buildRestartSpawnSpec", () => {
-  it("spawns node directly with the local tsx CLI (never via npx/npm)", () => {
-    const spec = buildRestartSpawnSpec("F:/proj");
-    expect(spec.command).toBe(process.execPath);
-    expect(spec.args[0]).toBe(join("F:/proj", "node_modules", "tsx", "dist", "cli.mjs"));
-    expect(spec.args[1]).toBe("src/index.ts");
-    expect([spec.command, ...spec.args].join(" ")).not.toMatch(/npx|npm/i);
-  });
-
-  it("accepts the default project root", () => {
-    const spec = buildRestartSpawnSpec();
-    expect(spec.command).toBe(process.execPath);
-    expect(spec.args[0]).toContain("tsx");
-  });
-});
-
-describe("spawnRestartChild", () => {
-  class FakeChild extends EventEmitter {
-    pid = 12345;
-    exitCode: number | null = null;
-    signalCode: number | string | null = null;
-    unref = vi.fn();
-    stderr = new EventEmitter();
-  }
-
-  let tmpDirs: string[] = [];
-  afterEach(async () => {
-    for (const dir of tmpDirs) await rm(dir, { recursive: true, force: true });
-    tmpDirs = [];
-  });
-
-  async function tmpLogDir(): Promise<string> {
-    const dir = await mkdtemp(join(tmpdir(), "chatccc-restart-"));
-    tmpDirs.push(dir);
-    return dir;
-  }
-
-  it("spawns without a shell, redirects stderr to a restart log file, and marks the internal restart env", async () => {
-    const logDir = await tmpLogDir();
-    const fake = new FakeChild();
-    const spawnImpl = vi.fn(() => fake as never);
-    const trace = vi.fn();
-
-    const child = spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: logDir });
-
-    expect(child).toBe(fake);
-    expect(spawnImpl).toHaveBeenCalledWith(
-      process.execPath,
-      [join("F:/proj", "node_modules", "tsx", "dist", "cli.mjs"), "src/index.ts"],
-      expect.objectContaining({
-        detached: true,
-        env: expect.objectContaining({ [INTERNAL_RESTART_ENV_VAR]: "1" }),
-        // 不使用 shell：避免 npm/npx 的 PATH 注入问题
-        shell: false,
-      }),
-    );
-    // spawnImpl 收到的 command/args 中不得出现 npx/npm（env 里的 npm_* 变量不算）
-    const firstCall = spawnImpl.mock.calls[0] as unknown as [string, string[]];
-    const [cmd, args] = firstCall;
-    expect([cmd, ...args].join(" ")).not.toMatch(/npx|npm/i);
-
-    // stderr 指向磁盘日志文件（fd），而不是 pipe：pipe 读端随父进程退出关闭后，
-    // 子进程写 stderr 会 EPIPE 崩溃（飞书 SDK console.warn 崩溃根因）。
-    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
-    const stdio = (callArgs[2] as { stdio: unknown[] }).stdio;
-    expect(stdio[0]).toBe("ignore");
-    expect(stdio[1]).toBe("ignore");
-    expect(typeof stdio[2]).toBe("number");
-    expect(stdio[2] as number).toBeGreaterThan(2);
-
-    const files = await readdir(logDir);
-    expect(files.some((f) => f.startsWith("restart-") && f.endsWith(".log"))).toBe(true);
-  });
-
-  it("records child exit code/signal in trace without pipe capture", async () => {
-    const logDir = await tmpLogDir();
-    const fake = new FakeChild();
-    const spawnImpl = vi.fn(() => fake as never);
-    const trace = vi.fn();
-
-    spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: logDir });
-
-    fake.exitCode = 1;
-    fake.emit("exit", 1, null);
-
-    const exitCall = trace.mock.calls.find(([name]) => name === "restart: child exit");
-    expect(exitCall).toBeTruthy();
-    expect(exitCall![1]).toEqual(expect.objectContaining({
-      childPid: 12345,
-      code: 1,
-      signal: null,
-    }));
-    // 不再用 pipe 收集 stderr，trace 里不再有 stderr 字段
-    expect(exitCall![1]).not.toHaveProperty("stderr");
-  });
-
-  it("falls back to pipe capture when the stderr log file cannot be opened", async () => {
-    const dir = await tmpLogDir();
-    // 用普通文件顶替目录：mkdir/open 日志文件必然失败
-    const blocker = join(dir, "blocker");
-    await writeFile(blocker, "x");
-    const fake = new FakeChild();
-    const spawnImpl = vi.fn(() => fake as never);
-    const trace = vi.fn();
-
-    spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: blocker });
-
-    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
-    expect((callArgs[2] as { stdio: unknown[] }).stdio[2]).toBe("pipe");
-    const failCall = trace.mock.calls.find(
-      ([name]) => name === "restart: stderr log open failed, falling back to pipe",
-    );
-    expect(failCall).toBeTruthy();
-    expect(typeof (failCall![1] as { error: unknown }).error).toBe("string");
-  });
-});
-
-describe("decideRestartParentExit", () => {
-  it("returns false (parent stays alive) when the child dies during the window", async () => {
-    const child = { exitCode: 1, signalCode: null, pid: 42 } as never;
-    const trace = vi.fn();
-
-    const shouldExit = await decideRestartParentExit(child, 200, 50, trace);
-
-    expect(shouldExit).toBe(false);
-    expect(trace).toHaveBeenCalledWith(
-      "restart: child died during window, keeping parent",
-      expect.objectContaining({ childPid: 42, exitCode: 1 }),
-    );
-  });
-
-  it("returns true (parent exits) when the child stays alive through the window", async () => {
-    const child = { exitCode: null, signalCode: null, pid: 42 } as never;
-    const trace = vi.fn();
-
-    const shouldExit = await decideRestartParentExit(child, 150, 30, trace);
-
-    expect(shouldExit).toBe(true);
-    expect(trace).toHaveBeenCalledWith(
-      "restart: child alive after window, parent exiting",
-      expect.objectContaining({ childPid: 42 }),
-    );
-  });
-
-  it("surfaces a child that died with a signal", async () => {
-    const child = { exitCode: null, signalCode: "SIGKILL", pid: 42 } as never;
-    const trace = vi.fn();
-
-    const shouldExit = await decideRestartParentExit(child, 100, 25, trace);
-
-    expect(shouldExit).toBe(false);
-    expect(trace).toHaveBeenCalledWith(
-      "restart: child died during window, keeping parent",
-      expect.objectContaining({ signalCode: "SIGKILL" }),
-    );
-  });
-
-  it("exports a sane default readiness window", () => {
-    expect(RESTART_CHILD_READY_MS).toBeGreaterThan(0);
-    expect(RESTART_CHILD_READY_MS).toBeLessThan(60_000);
-  });
-});
+import { EventEmitter } from "node:events";
+import { mkdtemp, readdir, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+import { describe, expect, it, vi, afterEach } from "vitest";
+
+import {
+  buildRestartSpawnSpec,
+  decideRestartParentExit,
+  spawnRestartChild,
+  RESTART_CHILD_READY_MS,
+} from "../orchestrator.ts";
+import { INTERNAL_RESTART_ENV_VAR } from "../startup-lifecycle.ts";
+
+describe("buildRestartSpawnSpec", () => {
+  it("spawns node directly with the local tsx CLI (never via npx/npm)", () => {
+    const spec = buildRestartSpawnSpec("F:/proj");
+    expect(spec.command).toBe(process.execPath);
+    expect(spec.args[0]).toBe(join("F:/proj", "node_modules", "tsx", "dist", "cli.mjs"));
+    expect(spec.args[1]).toBe("src/index.ts");
+    expect([spec.command, ...spec.args].join(" ")).not.toMatch(/npx|npm/i);
+  });
+
+  it("accepts the default project root", () => {
+    const spec = buildRestartSpawnSpec();
+    expect(spec.command).toBe(process.execPath);
+    expect(spec.args[0]).toContain("tsx");
+  });
+});
+
+describe("spawnRestartChild", () => {
+  class FakeChild extends EventEmitter {
+    pid = 12345;
+    exitCode: number | null = null;
+    signalCode: number | string | null = null;
+    unref = vi.fn();
+    stderr = new EventEmitter();
+  }
+
+  let tmpDirs: string[] = [];
+  afterEach(async () => {
+    for (const dir of tmpDirs) await rm(dir, { recursive: true, force: true });
+    tmpDirs = [];
+  });
+
+  async function tmpLogDir(): Promise<string> {
+    const dir = await mkdtemp(join(tmpdir(), "chatccc-restart-"));
+    tmpDirs.push(dir);
+    return dir;
+  }
+
+  it("spawns without a shell, redirects stderr to a restart log file, and marks the internal restart env", async () => {
+    const logDir = await tmpLogDir();
+    const fake = new FakeChild();
+    const spawnImpl = vi.fn(() => fake as never);
+    const trace = vi.fn();
+
+    const child = spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: logDir });
+
+    expect(child).toBe(fake);
+    expect(spawnImpl).toHaveBeenCalledWith(
+      process.execPath,
+      [join("F:/proj", "node_modules", "tsx", "dist", "cli.mjs"), "src/index.ts"],
+      expect.objectContaining({
+        detached: true,
+        env: expect.objectContaining({ [INTERNAL_RESTART_ENV_VAR]: "1" }),
+        // 不使用 shell：避免 npm/npx 的 PATH 注入问题
+        shell: false,
+      }),
+    );
+    // spawnImpl 收到的 command/args 中不得出现 npx/npm（env 里的 npm_* 变量不算）
+    const firstCall = spawnImpl.mock.calls[0] as unknown as [string, string[]];
+    const [cmd, args] = firstCall;
+    expect([cmd, ...args].join(" ")).not.toMatch(/npx|npm/i);
+
+    // stderr 指向磁盘日志文件（fd），而不是 pipe：pipe 读端随父进程退出关闭后，
+    // 子进程写 stderr 会 EPIPE 崩溃（飞书 SDK console.warn 崩溃根因）。
+    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
+    const stdio = (callArgs[2] as { stdio: unknown[] }).stdio;
+    expect(stdio[0]).toBe("ignore");
+    expect(stdio[1]).toBe("ignore");
+    expect(typeof stdio[2]).toBe("number");
+    expect(stdio[2] as number).toBeGreaterThan(2);
+
+    const files = await readdir(logDir);
+    expect(files.some((f) => f.startsWith("restart-") && f.endsWith(".log"))).toBe(true);
+  });
+
+  it("records child exit code/signal in trace without pipe capture", async () => {
+    const logDir = await tmpLogDir();
+    const fake = new FakeChild();
+    const spawnImpl = vi.fn(() => fake as never);
+    const trace = vi.fn();
+
+    spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: logDir });
+
+    fake.exitCode = 1;
+    fake.emit("exit", 1, null);
+
+    const exitCall = trace.mock.calls.find(([name]) => name === "restart: child exit");
+    expect(exitCall).toBeTruthy();
+    expect(exitCall![1]).toEqual(expect.objectContaining({
+      childPid: 12345,
+      code: 1,
+      signal: null,
+    }));
+    // 不再用 pipe 收集 stderr，trace 里不再有 stderr 字段
+    expect(exitCall![1]).not.toHaveProperty("stderr");
+  });
+
+  it("falls back to pipe capture when the stderr log file cannot be opened", async () => {
+    const dir = await tmpLogDir();
+    // 用普通文件顶替目录：mkdir/open 日志文件必然失败
+    const blocker = join(dir, "blocker");
+    await writeFile(blocker, "x");
+    const fake = new FakeChild();
+    const spawnImpl = vi.fn(() => fake as never);
+    const trace = vi.fn();
+
+    spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: blocker });
+
+    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
+    expect((callArgs[2] as { stdio: unknown[] }).stdio[2]).toBe("pipe");
+    const failCall = trace.mock.calls.find(
+      ([name]) => name === "restart: stderr log open failed, falling back to pipe",
+    );
+    expect(failCall).toBeTruthy();
+    expect(typeof (failCall![1] as { error: unknown }).error).toBe("string");
+  });
+});
+
+describe("decideRestartParentExit", () => {
+  it("returns false (parent stays alive) when the child dies during the window", async () => {
+    const child = { exitCode: 1, signalCode: null, pid: 42 } as never;
+    const trace = vi.fn();
+
+    const shouldExit = await decideRestartParentExit(child, 200, 50, trace);
+
+    expect(shouldExit).toBe(false);
+    expect(trace).toHaveBeenCalledWith(
+      "restart: child died during window, keeping parent",
+      expect.objectContaining({ childPid: 42, exitCode: 1 }),
+    );
+  });
+
+  it("returns true (parent exits) when the child stays alive through the window", async () => {
+    const child = { exitCode: null, signalCode: null, pid: 42 } as never;
+    const trace = vi.fn();
+
+    const shouldExit = await decideRestartParentExit(child, 150, 30, trace);
+
+    expect(shouldExit).toBe(true);
+    expect(trace).toHaveBeenCalledWith(
+      "restart: child alive after window, parent exiting",
+      expect.objectContaining({ childPid: 42 }),
+    );
+  });
+
+  it("surfaces a child that died with a signal", async () => {
+    const child = { exitCode: null, signalCode: "SIGKILL", pid: 42 } as never;
+    const trace = vi.fn();
+
+    const shouldExit = await decideRestartParentExit(child, 100, 25, trace);
+
+    expect(shouldExit).toBe(false);
+    expect(trace).toHaveBeenCalledWith(
+      "restart: child died during window, keeping parent",
+      expect.objectContaining({ signalCode: "SIGKILL" }),
+    );
+  });
+
+  it("exports a sane default readiness window", () => {
+    expect(RESTART_CHILD_READY_MS).toBeGreaterThan(0);
+    expect(RESTART_CHILD_READY_MS).toBeLessThan(60_000);
+  });
+});