@zhushanwen/pi-subagent-workflow 8.5.0 → 8.7.0

package/src/execution/__tests__/agent-registry.test.ts

@@ -1,363 +0,0 @@
-// src/execution/__tests__/agent-registry.test.ts
-//
-// AgentRegistry 测试（S2 路径统一版）。
-//
-// S2 重构：AgentRegistry 从「按名查找（discoverAll + cache Map<name>）」收敛为
-// 「按绝对路径加载（loadByPath）」——agentRef 唯一形态 = .md 绝对路径（注入段
-// <location>），内置 agent 即包内物理路径，无 builtin 合并、无名字查找。
-// 发现（注入段数据源）职责由 shared/resource-discovery + injector 承担，
-// 本文件不再测发现层（见 resource-discovery.test.ts）。
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-
-// 隔离真实用户全局目录（~/.agents/agents/ 可能有真实 agent 文件）
-vi.mock("node:os", async (importOriginal) => {
-  const actual = await importOriginal<typeof import("node:os")>();
-  return { ...actual, homedir: () => "/nonexistent-home-for-tests" };
-});
-
-import { lintAgentMeta } from "../../orchestration/script-lint.ts";
-import { parseResourceMeta } from "../../shared/meta-parser.ts";
-import { AgentRegistry, parseAgentFrontmatter, parseAgentWithMeta } from "../agent-registry.ts";
-import type { EnginePort } from "../engine/port.ts";
-import { clearEngines, registerEngine } from "../engine/registry.ts";
-
-// ============================================================
-// helpers
-// ============================================================
-
-function tmpWorkspace(): string {
-  return fs.mkdtempSync(path.join(os.tmpdir(), "agent-reg-test-"));
-}
-
-function writeAgent(dir: string, name: string, body: string): string {
-  fs.mkdirSync(dir, { recursive: true });
-  const filePath = path.join(dir, `${name}.md`);
-  fs.writeFileSync(filePath, body, "utf-8");
-  return filePath;
-}
-
-// ============================================================
-// parseAgentFrontmatter
-// ============================================================
-
-describe("parseAgentFrontmatter", () => {
-  it("parses name from filename + body as systemPrompt when no frontmatter", () => {
-    const cfg = parseAgentFrontmatter("/x/worker.md", "You are a worker.");
-    expect(cfg.name).toBe("worker");
-    expect(cfg.systemPrompt).toBe("You are a worker.");
-  });
-  it("extracts model/thinkingLevel/tools from frontmatter", () => {
-    const cfg = parseAgentFrontmatter("/x/coder.md", `---
-name: coder
-description: coding agent
-model: anthropic/claude-3.5-sonnet
-thinkingLevel: high
-tools: [read, bash]
----
-body text`);
-    expect(cfg.name).toBe("coder");
-    expect(cfg.model).toBe("anthropic/claude-3.5-sonnet");
-    expect(cfg.thinkingLevel).toBe("high");
-    expect(cfg.tools).toEqual(["read", "bash"]);
-    expect(cfg.systemPrompt).toBe("body text");
-  });
-});
-
-// ============================================================
-// parseAgentWithMeta（m5 T2：W4 lint 用 AgentMeta 二元组）
-// ============================================================
-
-describe("parseAgentWithMeta", () => {
-  it("有 frontmatter（IF1 通过）：meta 非 null 且路由字段完整，config 同步正确", () => {
-    const { config, meta } = parseAgentWithMeta("/x/coder.md", `---
-name: coder
-description: 编码 agent
-when: 需要写代码
-notFor: 纯分析
-model: anthropic/claude-3.5-sonnet
-thinkingLevel: high
-tools: [read, bash]
----
-body text`);
-    expect(meta).not.toBeNull();
-    expect(meta!.kind).toBe("agent");
-    expect(meta!.name).toBe("coder");
-    expect(meta!.description).toBe("编码 agent");
-    expect(meta!.when).toBe("需要写代码");
-    expect(meta!.notFor).toBe("纯分析");
-    expect(config.name).toBe("coder");
-    expect(config.systemPrompt).toBe("body text");
-    expect(config.model).toBe("anthropic/claude-3.5-sonnet");
-    expect(config.thinkingLevel).toBe("high");
-    expect(config.tools).toEqual(["read", "bash"]);
-  });
-
-  it("无 frontmatter：meta = null，整个内容作为 systemPrompt", () => {
-    const { config, meta } = parseAgentWithMeta("/x/plain.md", "Just a prompt body.");
-    expect(meta).toBeNull();
-    expect(config).toEqual({
-      name: "plain",
-      systemPrompt: "Just a prompt body.",
-    });
-  });
-
-  it("MF-3 fallback：缺 description（IF1 返 null）时 model/tools 经 extractYamlField 仍生效", () => {
-    const { config, meta } = parseAgentWithMeta("/x/legacy.md", `---
-name: legacy
-model: anthropic/claude-3.5-sonnet
-tools: read, bash, write
----
-body text`);
-    // 缺 description → parseResourceMeta 返 null → meta 为 null（结构化路由不可见）
-    expect(meta).toBeNull();
-    // 但 config 的 model/tools 不丢（direct-path loadByPath 与重构前行为一致）
-    expect(config.name).toBe("legacy");
-    expect(config.model).toBe("anthropic/claude-3.5-sonnet");
-    expect(config.tools).toEqual(["read", "bash", "write"]);
-    expect(config.systemPrompt).toBe("body text");
-  });
-
-  it("未闭合 frontmatter：meta = null，name 经 extractYamlField fallback，其余作为 systemPrompt", () => {
-    const { config, meta } = parseAgentWithMeta("/x/broken.md", `---
-name: broken
-model: x/y`);
-    expect(meta).toBeNull();
-    expect(config.name).toBe("broken");
-    // 未闭合分支只取 name（原行为），不解析 model
-    expect(config.systemPrompt).toBe(`---\nname: broken\nmodel: x/y`);
-  });
-});
-
-// ============================================================
-// AgentRegistry.loadByPath（S2：agentRef = .md 绝对路径）
-// ============================================================
-
-describe("AgentRegistry.loadByPath", () => {
-  let ws: string;
-  beforeEach(() => { ws = tmpWorkspace(); });
-  afterEach(() => { fs.rmSync(ws, { recursive: true, force: true }); });
-
-  it("按绝对路径加载 agent：frontmatter + body → AgentConfig", () => {
-    const file = writeAgent(path.join(ws, ".pi", "agents"), "worker", `---
-name: worker
-description: 通用执行 agent
-tools: [read, bash]
----
-You are a worker.`);
-    const reg = new AgentRegistry();
-    const cfg = reg.loadByPath(file);
-    expect(cfg?.name).toBe("worker");
-    expect(cfg?.systemPrompt).toBe("You are a worker.");
-    expect(cfg?.tools).toEqual(["read", "bash"]);
-  });
-
-  it("无 frontmatter 文件：整个内容作为 systemPrompt", () => {
-    const file = writeAgent(ws, "plain", "Just a prompt body.");
-    const cfg = new AgentRegistry().loadByPath(file);
-    expect(cfg?.name).toBe("plain");
-    expect(cfg?.systemPrompt).toBe("Just a prompt body.");
-  });
-
-  it("mtime 缓存：未变文件不重读（config 引用稳定）", () => {
-    const file = writeAgent(ws, "cached", "v1");
-    const reg = new AgentRegistry();
-    const first = reg.loadByPath(file);
-    const second = reg.loadByPath(file);
-    expect(second).toBe(first);
-    // 修改后 mtime 变化 → 新 config
-    fs.writeFileSync(file, "v2", "utf-8");
-    const third = reg.loadByPath(file);
-    expect(third?.systemPrompt).toBe("v2");
-  });
-
-  it("相对路径引用返回 undefined（引用唯一形态 = 绝对路径）", () => {
-    const reg = new AgentRegistry();
-    expect(reg.loadByPath("worker")).toBeUndefined();
-    expect(reg.loadByPath("./agents/worker.md")).toBeUndefined();
-  });
-
-  it("非 .md 引用返回 undefined", () => {
-    const reg = new AgentRegistry();
-    expect(reg.loadByPath("/tmp/worker.txt")).toBeUndefined();
-  });
-
-  it("文件不存在返回 undefined，require=true 抛错带指引", () => {
-    const reg = new AgentRegistry();
-    expect(reg.loadByPath("/nonexistent/x.md")).toBeUndefined();
-    // R5（D7）：三态错误文案统一带 <available_subagents> <location> 恢复指引
-    expect(() => reg.loadByPath("/nonexistent/x.md", true)).toThrow(/not found or unreadable/);
-    expect(() => reg.loadByPath("/nonexistent/x.md", true)).toThrow(/<available_subagents> <location>/);
-    expect(() => reg.loadByPath("relative", true)).toThrow(/Invalid agent ref/);
-    expect(() => reg.loadByPath("relative", true)).toThrow(/<available_subagents>/);
-  });
-
-  it("~/ 前缀展开", () => {
-    const reg = new AgentRegistry();
-    // homedir 被 mock 为 /nonexistent-home-for-tests → 文件必然不存在，验证展开逻辑
-    expect(reg.loadByPath("~/agent.md")).toBeUndefined();
-  });
-});
-
-// ============================================================
-// 包内 agents/*.md 数据合规（S2：内置 agent = 包内路径文件）
-// ============================================================
-
-describe("builtin agents 数据合规", () => {
-  const AGENTS_DIR = path.resolve(__dirname, "../../../agents");
-  const CORE = ["explorer", "coder", "reviewer", "debugger", "analyst", "planner", "researcher", "orchestrator", "general-purpose", "doc-reviewer"];
-
-  it("agents/*.md 全部 IF1 解析成功", () => {
-    for (const f of fs.readdirSync(AGENTS_DIR).filter((x) => x.endsWith(".md"))) {
-      const meta = parseResourceMeta(fs.readFileSync(path.join(AGENTS_DIR, f), "utf-8"), "agent");
-      expect(meta?.kind, `${f} parse 失败`).toBe("agent");
-    }
-  });
-
-  it("核心 agent 均含 when/notFor/examples 且正反各一（lintAgentMeta 无 finding）", () => {
-    for (const name of CORE) {
-      const meta = parseResourceMeta(fs.readFileSync(path.join(AGENTS_DIR, `${name}.md`), "utf-8"), "agent");
-      expect(meta, `${name} 解析失败`).not.toBeNull();
-      if (meta?.kind !== "agent") continue;
-      expect(meta.when, `${name} 缺 when`).toBeDefined();
-      expect(meta.notFor, `${name} 缺 notFor`).toBeDefined();
-      expect(meta.examples?.length, `${name} 缺 examples`).toBeGreaterThanOrEqual(2);
-      expect(meta.examples?.some((e) => e.positive), `${name} 缺正向样本`).toBe(true);
-      expect(meta.examples?.some((e) => !e.positive), `${name} 缺反向样本`).toBe(true);
-      expect(lintAgentMeta(meta), `${name} examples 不合规`).toEqual([]);
-    }
-  });
-
-  it("loadByPath 直接加载包内 agent（内置 = 路径文件，无名字查找）", () => {
-    const reg = new AgentRegistry();
-    const coder = reg.loadByPath(path.join(AGENTS_DIR, "coder.md"));
-    expect(coder?.name).toBe("coder");
-    expect(coder?.systemPrompt.length).toBeGreaterThan(0);
-    // tools 字段精确匹配：未声明的为 undefined，声明的为具体数组。
-    // 改 frontmatter 时这里会立即报错，拦住拼写错误或字段遗漏。
-    expect(reg.loadByPath(path.join(AGENTS_DIR, "explorer.md"))?.tools).toEqual(
-      ["read", "bash", "grep", "find", "structured-output"],
-    );
-    expect(reg.loadByPath(path.join(AGENTS_DIR, "researcher.md"))?.tools).toEqual(["read", "bash"]);
-    expect(reg.loadByPath(path.join(AGENTS_DIR, "orchestrator.md"))?.tools).toEqual([
-      "todo", "goal_control", "workflow", "subagent", "ask_user",
-    ]);
-    expect(reg.loadByPath(path.join(AGENTS_DIR, "reviewer.md"))?.tools).toEqual(["read", "bash", "grep", "find", "structured-output"]);
-    expect(reg.loadByPath(path.join(AGENTS_DIR, "planner.md"))?.tools).toEqual(["read", "bash", "grep", "find", "structured-output"]);
-    expect(reg.loadByPath(path.join(AGENTS_DIR, "coder.md"))?.tools).toEqual(["read", "write", "edit", "bash", "grep", "find", "structured-output"]);
-    expect(reg.loadByPath(path.join(AGENTS_DIR, "debugger.md"))?.tools).toEqual(["read", "write", "edit", "bash", "grep", "find", "structured-output"]);
-    expect(reg.loadByPath(path.join(AGENTS_DIR, "analyst.md"))?.tools).toEqual(["read", "bash", "grep", "find", "structured-output"]);
-    expect(reg.loadByPath(path.join(AGENTS_DIR, "doc-reviewer.md"))?.tools).toEqual(["read", "grep", "structured-output"]);
-  });
-});
-
-// ============================================================
-// engine 字段（P4 D9：frontmatter 主通道 + 解析期注册表校验）
-// ============================================================
-
-describe("parseAgentWithMeta engine 字段（P4 路由）", () => {
-  beforeEach(() => {
-    // 解析期校验消费注册表——测试内注册假引擎（惰性工厂无副作用）
-    clearEngines();
-    // 工厂恒 throw：解析期校验只查注册表存在性，不实例化（惰性工厂契约）
-    const neverInstantiate = (): EnginePort => {
-      throw new Error("parse-time validation must not instantiate engines");
-    };
-    registerEngine("pi", neverInstantiate);
-    registerEngine("zcode", neverInstantiate);
-  });
-  afterEach(() => {
-    clearEngines();
-  });
-
-  it("frontmatter engine 进 config.engine（结构化路径，IF1）", () => {
-    const { config, meta } = parseAgentWithMeta(
-      "/x/reviewer.md",
-      `---
-name: reviewer
-description: review agent
-engine: zcode
----
-body`,
-    );
-    expect(config.engine).toBe("zcode");
-    expect(meta?.kind === "agent" && meta.engine).toBe("zcode");
-  });
-
-  it("IF1 未通过（缺 description）时 legacy fallback 取 engine（配置不丢，与 model 同判）", () => {
-    const { config } = parseAgentWithMeta(
-      "/x/reviewer.md",
-      `---
-name: reviewer
-engine: zcode
----
-body`,
-    );
-    expect(config.engine).toBe("zcode");
-  });
-
-  it("未注册 engine id：解析期抛 EngineNotFoundError，文案含注册清单与文件路径", () => {
-    expect(() =>
-      parseAgentWithMeta(
-        "/x/reviewer.md",
-        `---
-name: reviewer
-description: review agent
-engine: nonexistent-engine
----
-body`,
-      ),
-    ).toThrowError(/engine_not_found: engine 'nonexistent-engine'/);
-    expect(() =>
-      parseAgentWithMeta(
-        "/x/reviewer.md",
-        `---
-name: reviewer
-description: review agent
-engine: nonexistent-engine
----
-body`,
-      ),
-    ).toThrowError(/Registered engines: pi, zcode/);
-    expect(() =>
-      parseAgentWithMeta(
-        "/x/my-agent.md",
-        `---
-name: my-agent
-description: d
-engine: nonexistent-engine
----
-body`,
-      ),
-    ).toThrowError(/Source: \/x\/my-agent\.md/);
-  });
-
-  it("已注册 id（pi/zcode）：解析通过，不抛", () => {
-    expect(() =>
-      parseAgentWithMeta(
-        "/x/reviewer.md",
-        `---
-name: reviewer
-description: review agent
-engine: pi
----
-body`,
-      ),
-    ).not.toThrow();
-  });
-
-  it("无 engine 字段：config.engine 缺省（走全局默认层）", () => {
-    const { config } = parseAgentWithMeta(
-      "/x/worker.md",
-      `---
-name: worker
-description: d
----
-body`,
-    );
-    expect(config.engine).toBeUndefined();
-  });
-});

package/src/execution/__tests__/agent-result-mapper.test.ts

@@ -1,150 +0,0 @@
-// src/execution/__tests__/agent-result-mapper.test.ts
-//
-// T3.14 (NFR-兼容性): AgentResult 映射字段对齐 —— D-A10 纯函数单测
-// T3.1  (正常): executeAndAwait 返回 content → 间接覆盖（subagent-service.test.ts 集成验证）
-//
-// 测试范围: mapToWorkflowAgentResult 所有字段映射分支（success/error/usage/toolCalls）
-
-import { describe, expect, it } from "vitest";
-
-import { mapToWorkflowAgentResult } from "../agent-result-mapper.ts";
-import type { AgentResult as SubagentsAgentResult, AgentUsageTotal, ToolCall } from "../types.ts";
-
-describe("mapToWorkflowAgentResult (D-A10)", () => {
-  const minimalResult: SubagentsAgentResult = {
-    text: "Hello",
-    turns: 3,
-    durationMs: 1200,
-    success: true,
-    sessionId: "session-123",
-    toolCalls: [],
-  };
-
-  // ── T3.14: 正常成功路径 ──
-
-  it("映射成功结果: text→content, durationMs/sessionId 透传", () => {
-    const result = mapToWorkflowAgentResult(minimalResult);
-    expect(result.content).toBe("Hello");
-    expect(result.durationMs).toBe(1200);
-    expect(result.sessionId).toBe("session-123");
-    expect(result.error).toBeUndefined();
-    expect(result.parsedOutput).toBeUndefined();
-    expect(result.usage).toBeUndefined();
-    expect(result.toolCalls).toEqual([]);
-  });
-
-  // ── sessionFile 透传（方案 A：让 workflow 继承 subagent 的 session jsonl 路径）──
-
-  it("映射 sessionFile: subagents AgentResult.sessionFile → workflow AgentResult.sessionFile 透传", () => {
-    const r: SubagentsAgentResult = {
-      ...minimalResult,
-      sessionFile: "/abs/path/.pi/agent/subagents/enc/sessions/2026-07-15T10-00-00-000Z_session-123.jsonl",
-    };
-    const result = mapToWorkflowAgentResult(r);
-    expect(result.sessionFile).toBe("/abs/path/.pi/agent/subagents/enc/sessions/2026-07-15T10-00-00-000Z_session-123.jsonl");
-  });
-
-  it("映射 sessionFile: 无 sessionFile → workflow AgentResult.sessionFile undefined（窗口期/未回填）", () => {
-    const r: SubagentsAgentResult = { ...minimalResult, sessionFile: undefined };
-    const result = mapToWorkflowAgentResult(r);
-    expect(result.sessionFile).toBeUndefined();
-  });
-
-  it("映射 parsedOutput 透传（structured-output 契约 BC-8）", () => {
-    const parsedData = { score: 0.95, label: "positive" };
-    const r: SubagentsAgentResult = { ...minimalResult, parsedOutput: parsedData };
-    const result = mapToWorkflowAgentResult(r);
-    expect(result.parsedOutput).toEqual(parsedData);
-  });
-
-  // ── T3.14: 失败路径 ──
-
-  it("映射失败: success=false 且 error → 填入 error 字段", () => {
-    const r: SubagentsAgentResult = { ...minimalResult, success: false, error: "timeout" };
-    const result = mapToWorkflowAgentResult(r);
-    expect(result.error).toBe("timeout");
-    expect(result.content).toBe("Hello"); // content 仍保留（可能有部分输出）
-  });
-
-  it("映射失败: success=false 但无 error（abort 路径）→ error 填入 fallback 而非 undefined", () => {
-    // H4: session-runner.ts abort 时 success=false, error=undefined。
-    // 旧代码 error=undefined → executeAgentCall 误判 completed。
-    // 修复后应 synthesize fallback error。
-    const r: SubagentsAgentResult = { ...minimalResult, success: false };
-    const result = mapToWorkflowAgentResult(r);
-    expect(result.error).toBeDefined();
-    expect(typeof result.error).toBe("string");
-    expect(result.error.length).toBeGreaterThan(0);
-  });
-
-  it("映射成功: success=true 且 error 存在 → error=undefined（不误填）", () => {
-    const r: SubagentsAgentResult = { ...minimalResult, success: true, error: "stale" };
-    const result = mapToWorkflowAgentResult(r);
-    expect(result.error).toBeUndefined();
-  });
-
-  // ── T3.14: usage 映射 ──
-
-  it("映射 usage: AgentUsageTotal → AgentUsage（字段形状转换）", () => {
-    const usage: AgentUsageTotal = {
-      input: 1000,
-      output: 500,
-      cacheRead: 200,
-      cacheWrite: 100,
-      total: 1800,
-      cost: 0.005,
-    };
-    const r: SubagentsAgentResult = { ...minimalResult, usage };
-    const result = mapToWorkflowAgentResult(r);
-    expect(result.usage).toEqual({
-      input: 1000,
-      output: 500,
-      cacheRead: 200,
-      cacheWrite: 100,
-      cost: 0.005,
-      contextTokens: 1800, // total → contextTokens
-      turns: 3, // 来自 AgentResult.turns
-    });
-  });
-
-  it("映射 usage: 无 usage → usage undefined", () => {
-    const result = mapToWorkflowAgentResult(minimalResult);
-    expect(result.usage).toBeUndefined();
-  });
-
-  // ── T3.14: toolCalls 映射 ──
-
-  it("映射 toolCalls: ToolCall → ToolCallEntry（name/input 形状转换）", () => {
-    const calls: ToolCall[] = [
-      { toolName: "read", args: { path: "/a.txt" } },
-      { toolName: "bash", args: { command: "ls" }, result: { content: ["ok"] }, isError: false },
-    ];
-    const r: SubagentsAgentResult = { ...minimalResult, toolCalls: calls };
-    const result = mapToWorkflowAgentResult(r);
-    expect(result.toolCalls).toBeDefined();
-    expect(result.toolCalls!).toHaveLength(2);
-    expect(result.toolCalls![0]).toEqual({ name: "read", input: '{"path":"/a.txt"}' });
-    expect(result.toolCalls![1].name).toBe("bash");
-  });
-
-  it("映射 toolCalls: args=undefined → input=''", () => {
-    const calls: ToolCall[] = [{ toolName: "list" }];
-    const r: SubagentsAgentResult = { ...minimalResult, toolCalls: calls };
-    const result = mapToWorkflowAgentResult(r);
-    expect(result.toolCalls![0].input).toBe("");
-  });
-
-  it("映射 toolCalls: 长 args 截断（>500 chars）", () => {
-    const longStr = "x".repeat(600);
-    const calls: ToolCall[] = [{ toolName: "write", args: { content: longStr } }];
-    const r: SubagentsAgentResult = { ...minimalResult, toolCalls: calls };
-    const result = mapToWorkflowAgentResult(r);
-    expect(result.toolCalls![0].input.length).toBeLessThanOrEqual(503); // 500 + "..."
-  });
-
-  it("映射 toolCalls: 无 toolCalls → undefined", () => {
-    const r: SubagentsAgentResult = { ...minimalResult, toolCalls: undefined };
-    const result = mapToWorkflowAgentResult(r);
-    expect(result.toolCalls).toBeUndefined();
-  });
-});

package/src/execution/__tests__/alive-store.test.ts

@@ -1,147 +0,0 @@
-// src/__tests__/alive-store.test.ts
-
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-
-import { afterEach,describe, expect, it } from "vitest";
-
-import {
-  isProcessAlive,
-  readAliveMarker,
-  removeAliveMarker,
-  writeAliveMarker,
-} from "../alive-store.ts";
-import type { AliveMarker } from "../types.ts";
-
-function makeTmpDir(): string {
-  return fs.mkdtempSync(path.join(os.tmpdir(), "alive-store-test-"));
-}
-
-describe("alive-store", () => {
-  let tmpDir: string;
-
-  afterEach(() => {
-    if (tmpDir) {
-      fs.rmSync(tmpDir, { recursive: true, force: true });
-    }
-  });
-
-  // ── writeAliveMarker + readAliveMarker 往返 ──
-
-  it("write → read round-trip", () => {
-    tmpDir = makeTmpDir();
-    const sessionFile = path.join(tmpDir, "session.jsonl");
-    const marker: AliveMarker = { pid: 12345, id: "bg-1-abc", startedAt: Date.now() };
-
-    writeAliveMarker(sessionFile, marker);
-    const result = readAliveMarker(sessionFile);
-
-    expect(result).toEqual(marker);
-    // 验证 sidecar 文件是单行 JSON
-    const raw = fs.readFileSync(`${sessionFile}.alive`, "utf-8");
-    expect(raw.endsWith("\n")).toBe(true);
-    expect(JSON.parse(raw.trim())).toEqual(marker);
-  });
-
-  // ── readAliveMarker 损坏文件 ──
-
-  it("readAliveMarker returns undefined for corrupted file", () => {
-    tmpDir = makeTmpDir();
-    const sessionFile = path.join(tmpDir, "session.jsonl");
-    fs.writeFileSync(`${sessionFile}.alive`, "not-json", "utf-8");
-
-    expect(readAliveMarker(sessionFile)).toBeUndefined();
-  });
-
-  it("readAliveMarker returns undefined for structurally invalid JSON", () => {
-    tmpDir = makeTmpDir();
-    const sessionFile = path.join(tmpDir, "session.jsonl");
-    // pid 字段缺失
-    fs.writeFileSync(`${sessionFile}.alive`, '{"id":"x","startedAt":1}\n', "utf-8");
-
-    expect(readAliveMarker(sessionFile)).toBeUndefined();
-  });
-
-  it("readAliveMarker returns undefined when file does not exist", () => {
-    tmpDir = makeTmpDir();
-    const sessionFile = path.join(tmpDir, "session.jsonl");
-
-    expect(readAliveMarker(sessionFile)).toBeUndefined();
-  });
-
-  // ── removeAliveMarker ──
-
-  it("removeAliveMarker removes existing sidecar", () => {
-    tmpDir = makeTmpDir();
-    const sessionFile = path.join(tmpDir, "session.jsonl");
-    const marker: AliveMarker = { pid: 1, id: "x", startedAt: 0 };
-
-    writeAliveMarker(sessionFile, marker);
-    expect(fs.existsSync(`${sessionFile}.alive`)).toBe(true);
-
-    removeAliveMarker(sessionFile);
-    expect(fs.existsSync(`${sessionFile}.alive`)).toBe(false);
-  });
-
-  it("removeAliveMarker does not throw when file does not exist", () => {
-    tmpDir = makeTmpDir();
-    const sessionFile = path.join(tmpDir, "session.jsonl");
-
-    expect(() => removeAliveMarker(sessionFile)).not.toThrow();
-  });
-
-  // ── isProcessAlive ──
-
-  it("isProcessAlive returns true for current process", () => {
-    expect(isProcessAlive(process.pid)).toBe(true);
-  });
-
-  it("isProcessAlive returns false for non-existent pid", () => {
-    // pid 0 不存在于用户空间（kill(0,0) 在某些 OS 有特殊语义，用大数更安全）
-    expect(isProcessAlive(9999999)).toBe(false);
-  });
-
-  it("isProcessAlive returns true for EPERM (process exists but no permission)", () => {
-    // 模拟 EPERM：进程存在但无权限发信号
-    const err = new Error("EPERM") as NodeJS.ErrnoException;
-    err.code = "EPERM";
-    const originalKill = process.kill;
-    process.kill = (_pid: number, _signal?: string | number) => {
-      throw err;
-    };
-    try {
-      expect(isProcessAlive(12345)).toBe(true);
-    } finally {
-      process.kill = originalKill;
-    }
-  });
-
-  it("isProcessAlive returns false for ESRCH (no such process)", () => {
-    // 模拟 ESRCH：进程不存在
-    const err = new Error("ESRCH") as NodeJS.ErrnoException;
-    err.code = "ESRCH";
-    const originalKill = process.kill;
-    process.kill = (_pid: number, _signal?: string | number) => {
-      throw err;
-    };
-    try {
-      expect(isProcessAlive(12345)).toBe(false);
-    } finally {
-      process.kill = originalKill;
-    }
-  });
-
-  it("isProcessAlive returns false for unknown errors", () => {
-    // 模拟未知错误：保守判死
-    const originalKill = process.kill;
-    process.kill = (_pid: number, _signal?: string | number) => {
-      throw new Error("unknown error");
-    };
-    try {
-      expect(isProcessAlive(12345)).toBe(false);
-    } finally {
-      process.kill = originalKill;
-    }
-  });
-});