@zhushanwen/pi-subagent-workflow 8.5.0 → 8.7.0

package/src/execution/__tests__/list-component.test.ts

@@ -1,401 +0,0 @@
-// src/__tests__/list-component.test.ts
-//
-// SubagentsListComponent 单元测试（循环依赖消除后的新结构）。
-//
-// 被测组件 list-component.ts 不再 import list-view——按键处理经第 7 个构造函数参数
-// keyHandler 注入（list-view factory 的 processKey），状态经第 4 参数 ViewState 注入。
-// 本测试覆盖 render 三分支调度 / hasRunning / 左列视口窗口 / 右列预览兜底链 /
-// handleInput exit|changed|none 分支 / render 缓存 / detailMode 切换。
-//
-// Mock 策略：theme 透传为纯文本（断言业务文本而非 ANSI 码），service 只 stub collectRecords，
-// keyHandler 由各用例注入返回 KeyResult。spinner 帧 Date.now() 驱动 → fake timers 锁定。
-
-import { afterEach,beforeEach, describe, expect, it, vi } from "vitest";
-
-import type { ThemeLike } from "../../interface/format.ts";
-import { SubagentsListComponent } from "../../interface/list-component.ts";
-import type { KeyHandler, KeyResult, TuiLike, ViewState } from "../../interface/list-shared.ts";
-import type { SubagentService } from "../subagent-service.ts";
-import type { SubagentRecord } from "../types.ts";
-
-// ── KeyResult 常量（语义清晰，避到处写字面量对象） ──
-
-const KEY_NONE: KeyResult = { changed: false, exit: false };
-const KEY_CHANGED: KeyResult = { changed: true, exit: false };
-const KEY_EXIT: KeyResult = { changed: false, exit: true };
-
-// ── stub 工厂 ──
-
-/** 透传 theme（list-component 经 format.ts 调用 fg/bold，ThemeLike 要求 4 方法齐全）。 */
-function makeTheme(): ThemeLike {
-  return {
-    fg: (_tag: string, text: string) => text,
-    bg: (_color: string, text: string) => text,
-    bold: (text: string) => text,
-    underline: (text: string) => text,
-  } as ThemeLike;
-}
-
-/** service stub：list-component 只调 collectRecords(limit) 单参数 + getFullRecord（[perf]
- *  选中项详情懒加载，mock 回 undefined → fullRecordOf 回退 light record，与旧行为一致）。
- *  与 tool-action.test.ts 同模式：部分对象直接断言为 SubagentService（duck-type）。 */
-function makeService(records: SubagentRecord[] = []): SubagentService {
-  return {
-    collectRecords: vi.fn(() => records),
-    getFullRecord: vi.fn(() => undefined as SubagentRecord | undefined),
-  } as SubagentService;
-}
-
-/** record fixture（参考 tool-action.test.ts，字段见 types.ts SubagentRecord）。 */
-function makeRecord(over: Partial<SubagentRecord> = {}): SubagentRecord {
-  return {
-    id: "run-1",
-    agent: "worker",
-    task: "do the thing",
-    status: "closed",
-    mode: "sync",
-    startedAt: 1000,
-    endedAt: 2000,
-    rootSessionId: undefined,
-    parentRecordId: undefined,
-    depth: 0,
-    turns: 1,
-    totalTokens: 10,
-    model: "test/model",
-    thinkingLevel: undefined,
-    eventLog: [],
-    displayItems: [],
-    result: "ok",
-    error: undefined,
-    sessionFile: undefined,
-    ...over,
-  };
-}
-
-/** 构造 N 条 records（agent/task 含索引便于断言可见性）。 */
-function makeRecords(n: number): SubagentRecord[] {
-  return Array.from({ length: n }, (_, i) =>
-    makeRecord({ id: `run-${i}`, agent: `agent-${i}`, task: `task-${i}` }),
-  );
-}
-
-interface MakeOpts {
-  records?: SubagentRecord[];
-  rows?: number;
-  selectedIdx?: number;
-  detailMode?: boolean;
-  keyHandler?: KeyHandler;
-}
-
-/** 构造组件 + 暴露 service/tui/state 供断言。 */
-function makeComponent(opts: MakeOpts = {}) {
-  const records = opts.records ?? [];
-  const service = makeService(records);
-  const theme = makeTheme();
-  const tui = {
-    requestRender: vi.fn(),
-    terminal: { rows: opts.rows ?? 24 },
-  };
-  const state: ViewState = {
-    selectedIdx: opts.selectedIdx ?? 0,
-    scrollOffset: 0,
-    filterText: "",
-    detailMode: opts.detailMode ?? false,
-    disposed: false,
-    syncCancelHint: false,
-  };
-  const keyHandler: KeyHandler = opts.keyHandler ?? (() => KEY_NONE);
-  const comp = new SubagentsListComponent(
-    service,
-    theme,
-    tui as TuiLike,
-    state,
-    () => {},
-    () => {},
-    keyHandler,
-  );
-  return { comp, service, theme, tui, state };
-}
-
-// ============================================================
-// SubagentsListComponent
-// ============================================================
-describe("SubagentsListComponent", () => {
-  beforeEach(() => {
-    // spinner 帧由 Math.floor(Date.now()/250) 选取，锁定时间避免 flaky。
-    vi.useFakeTimers();
-    vi.setSystemTime(new Date("2025-01-01T00:00:00Z"));
-  });
-  afterEach(() => {
-    vi.useRealTimers();
-  });
-
-  // ── render 三分支调度 ──────────────────────────────────
-  describe("render 分支调度", () => {
-    it("rows < MIN_TERM_ROWS(8) → too small 提示", () => {
-      const { comp } = makeComponent({ records: [], rows: 5 });
-      const joined = comp.render(80).join("\n");
-      expect(joined).toContain("too small");
-      expect(joined).toContain("need >=");
-    });
-
-    it("空 records → emptyBox（含 (no subagent records) 文案）", () => {
-      const { comp } = makeComponent({ records: [], rows: 24 });
-      const joined = comp.render(80).join("\n");
-      expect(joined).toContain("(no subagent records)");
-      // 紧凑小框不渲染分屏分区线
-      expect(joined).not.toContain("Records");
-    });
-
-    it("有 records → splitBox（含 record 的 task + agent 文本）", () => {
-      const rec = makeRecord({ agent: "researcher", task: "investigate bug" });
-      const { comp } = makeComponent({ records: [rec], rows: 24 });
-      const joined = comp.render(80).join("\n");
-      expect(joined).toContain("researcher"); // 左列 agent
-      expect(joined).toContain("investigate bug"); // 右列 task 首行
-      expect(joined).toContain("Records"); // 分区线标题
-      expect(joined).toContain("Detail");
-    });
-  });
-
-  // ── hasRunning ────────────────────────────────────────
-  describe("hasRunning", () => {
-    it("records 全是 closed（终态）→ false", () => {
-      const { comp } = makeComponent({
-        // v4 B-1：done/failed 等旧终态已收敛为 closed（fixture 同步迁移）
-        records: [makeRecord({ status: "closed" }), makeRecord({ status: "closed" })],
-      });
-      expect(comp.hasRunning()).toBe(false);
-    });
-
-    it("records 含一个 running → true", () => {
-      const { comp } = makeComponent({
-        records: [
-          makeRecord({ id: "a", status: "closed" }),
-          makeRecord({ id: "b", status: "running" }),
-        ],
-      });
-      expect(comp.hasRunning()).toBe(true);
-    });
-  });
-
-  // ── 左列视口窗口 ──────────────────────────────────────
-  describe("左列视口窗口", () => {
-    it("records 数 > bodyH → render 行数 ≤ rows（不溢出终端）", () => {
-      // rows=24 → 内框高 innerRows = 24 - PAD_ROWS(2) = 22；bodyH = 22 - SPLIT_FIXED_LINES(6) = 16。
-      // 30 条 records 远超 bodyH，选中行在中间。断言输出总行数 == rows（overlay 填满全屏），
-      // 且左列只渲染 bodyH 条（不溢出导致底框被推出终端）。
-      const records = makeRecords(30);
-      const { comp } = makeComponent({ records, rows: 24, selectedIdx: 15 });
-      const lines = comp.render(80);
-      expect(lines.length).toBe(24); // 填满全屏，不溢出
-      // 中间 record 的 agent 不在视口窗口外应仍可见（窗口居中显示 selectedIdx 附近）。
-      const joined = lines.join("\n");
-      expect(joined).toContain("agent-15"); // 选中行在视口内
-    });
-
-    it("selectedIdx 在尾部 → 视口贴底（最后一条可见）", () => {
-      const records = makeRecords(30);
-      const { comp } = makeComponent({ records, rows: 24, selectedIdx: 29 });
-      const joined = comp.render(80).join("\n");
-      expect(joined).toContain("agent-29"); // 尾部 record 仍可见（视口贴底）
-    });
-  });
-
-  // ── 右列预览兜底链 ────────────────────────────────────
-  describe("右列预览兜底链 (renderRightPreview)", () => {
-    it("record 有 displayItems → 输出含 displayItems 内容", () => {
-      const rec = makeRecord({
-        displayItems: [{ type: "text", text: "partial analysis output" }],
-      });
-      const { comp } = makeComponent({ records: [rec], rows: 24 });
-      const joined = comp.render(80).join("\n");
-      expect(joined).toContain("partial analysis output");
-    });
-
-    it("record 无 displayItems 但有 eventLog → 回退 eventLog（输出含 event 标签）", () => {
-      const rec = makeRecord({
-        displayItems: [],
-        eventLog: [{ type: "tool_start", label: "Read file.ts", ts: 1500 }],
-      });
-      const { comp } = makeComponent({ records: [rec], rows: 24 });
-      const joined = comp.render(80).join("\n");
-      // formatEventLine 的 tool_start 输出 "tool: <label>"
-      expect(joined).toContain("tool:");
-      expect(joined).toContain("Read file.ts");
-    });
-
-    it("record 两者都无 → 输出 (no output) 兜底文案", () => {
-      const rec = makeRecord({ displayItems: [], eventLog: [] });
-      const { comp } = makeComponent({ records: [rec], rows: 24 });
-      const joined = comp.render(80).join("\n");
-      expect(joined).toContain("(no output)");
-    });
-  });
-
-  // ── handleInput ───────────────────────────────────────
-  describe("handleInput", () => {
-    it("disposed → 直接返回，不调用 keyHandler", () => {
-      const keyHandler = vi.fn(() => KEY_NONE);
-      const { comp, state } = makeComponent({ keyHandler });
-      state.disposed = true;
-      comp.handleInput("x");
-      expect(keyHandler).not.toHaveBeenCalled();
-    });
-
-    it("keyHandler 返回 exit → 调用 closeFn 关闭 overlay", () => {
-      const keyHandler = vi.fn(() => KEY_EXIT);
-      const { comp } = makeComponent({ keyHandler });
-      const closeFn = vi.fn();
-      comp.setCloseFn(closeFn);
-      comp.handleInput("\x1b"); // Esc
-      expect(closeFn).toHaveBeenCalledTimes(1);
-    });
-
-    it("keyHandler 返回 changed → invalidate + requestRender", () => {
-      const keyHandler = vi.fn(() => KEY_CHANGED);
-      const { comp, tui } = makeComponent({ keyHandler });
-      comp.handleInput("\x1b[B"); // Down
-      expect(tui.requestRender).toHaveBeenCalledTimes(1);
-    });
-
-    it("keyHandler 返回 none → 不 invalidate / 不 close / 不 requestRender", () => {
-      const keyHandler = vi.fn(() => KEY_NONE);
-      const closeFn = vi.fn();
-      const { comp, tui } = makeComponent({ keyHandler });
-      comp.setCloseFn(closeFn);
-      comp.handleInput("x");
-      expect(closeFn).not.toHaveBeenCalled();
-      expect(tui.requestRender).not.toHaveBeenCalled();
-    });
-
-    it("exit 优先于 changed（exit=true 时只 close，不 requestRender）", () => {
-      const keyHandler = vi.fn(() => ({ changed: true, exit: true }));
-      const closeFn = vi.fn();
-      const { comp, tui } = makeComponent({ keyHandler });
-      comp.setCloseFn(closeFn);
-      comp.handleInput("\x1b");
-      expect(closeFn).toHaveBeenCalledTimes(1);
-      expect(tui.requestRender).not.toHaveBeenCalled();
-    });
-  });
-
-  // ── render 缓存 ───────────────────────────────────────
-  describe("render 缓存", () => {
-    it("相同 width 连续两次 render → 返回相同结果（缓存命中）", () => {
-      const records = [makeRecord({ agent: "cached-agent" })];
-      const { comp } = makeComponent({ records, rows: 24 });
-      const first = comp.render(80);
-      const second = comp.render(80);
-      // 缓存命中：返回同一引用（buildLines 未重新执行）。
-      expect(second).toBe(first);
-    });
-
-    it("invalidate 后再 render → 重建（结果内容相同但引用不同）", () => {
-      const records = [makeRecord()];
-      const { comp } = makeComponent({ records, rows: 24 });
-      const first = comp.render(80);
-      comp.invalidate();
-      const second = comp.render(80);
-      expect(second).not.toBe(first); // 引用不同 → 重建
-      expect(second).toEqual(first); // 内容相同
-    });
-
-    it("不同 width → 不命中缓存（重新构建）", () => {
-      const records = [makeRecord()];
-      const { comp } = makeComponent({ records, rows: 24 });
-      const w80 = comp.render(80);
-      const w100 = comp.render(100);
-      // 宽度不同 → 不同 key → 重建。行数应随宽度变化内容（至少引用不同）。
-      expect(w100).not.toBe(w80);
-    });
-  });
-
-  // ── detailMode 切换 ───────────────────────────────────
-  describe("detailMode 切换", () => {
-    it("detailMode=true → footer 含 Esc back + 右侧锚定提示 Pinned", () => {
-      const rec = makeRecord({ agent: "pinned-agent" });
-      const { comp } = makeComponent({ records: [rec], rows: 24, detailMode: true });
-      const joined = comp.render(80).join("\n");
-      expect(joined).toContain("Esc back to list");
-      expect(joined).toContain("Pinned:");
-      expect(joined).toContain("pinned-agent");
-    });
-
-    it("detailMode=false → footer 含 navigate / Enter detail（非锚定文案）", () => {
-      const rec = makeRecord();
-      const { comp } = makeComponent({ records: [rec], rows: 24, detailMode: false });
-      const joined = comp.render(80).join("\n");
-      expect(joined).toContain("Enter detail");
-      expect(joined).not.toContain("Pinned:");
-    });
-
-    it("detailMode 下完整详情含 result + sessionFile（预览阶段不显示 sessionFile）", () => {
-      const rec = makeRecord({
-        result: "final report content",
-        sessionFile: "/tmp/session-abc.jsonl",
-      });
-      // 预览阶段
-      const previewComp = makeComponent({ records: [rec], rows: 24, detailMode: false });
-      const previewJoined = previewComp.comp.render(80).join("\n");
-      expect(previewJoined).toContain("Enter for full detail"); // 预览阶段提示
-      // 详情阶段
-      const detailComp = makeComponent({ records: [rec], rows: 24, detailMode: true });
-      const detailJoined = detailComp.comp.render(80).join("\n");
-      expect(detailJoined).toContain("final report content"); // Result 段
-      expect(detailJoined).toContain("Result:");
-      expect(detailJoined).toContain("session-abc.jsonl"); // sessionFile
-    });
-  });
-
-  // ── 帧缓存 collectRecordsFrame（TC3/IF3/DM5）──────────
-  describe("帧缓存 collectRecordsFrame", () => {
-    it("同一帧（TTL 50ms 内）hasRunning + render 只触发 1 次 service.collectRecords", () => {
-      // fake timers 已锁 Date.now()（beforeEach）→ 帧内多次消费共享同一份 records
-      const rec = makeRecord({ id: "a", status: "running" });
-      const { comp, service } = makeComponent({ records: [rec], rows: 24 });
-      expect(comp.hasRunning()).toBe(true); // 第 1 次扫描
-      comp.render(80); // buildLines 消费（帧命中，不重扫）
-      comp.handleInput("x"); // handleInput 消费（帧命中）
-      expect(vi.mocked(service.collectRecords)).toHaveBeenCalledTimes(1);
-    });
-
-    it("advance 100ms 后 TTL 过期 → 重扫（collectRecords 递增）", () => {
-      const rec = makeRecord({ id: "a", status: "running" });
-      const { comp, service } = makeComponent({ records: [rec], rows: 24 });
-      comp.render(80);
-      expect(vi.mocked(service.collectRecords)).toHaveBeenCalledTimes(1);
-      vi.advanceTimersByTime(100); // > FRAME_TTL_MS(50)
-      // 镜像 animTimer 真实序列：hasRunning（帧消费点）→ invalidate → render。
-      // hasRunning 直接走帧缓存（不经 render 行缓存），TTL 过期 → 重扫
-      expect(comp.hasRunning()).toBe(true);
-      expect(vi.mocked(service.collectRecords)).toHaveBeenCalledTimes(2);
-      comp.invalidate();
-      comp.render(80); // 重建行，但帧刚刷新（100ms 后的同一时刻）→ 不再重扫
-      expect(vi.mocked(service.collectRecords)).toHaveBeenCalledTimes(2);
-    });
-
-    it("invalidate 不清帧缓存：invalidate 后同帧 render 仍命中（不重扫）", () => {
-      // timer 序列 hasRunning → invalidate → requestRender 的共享前提：
-      // invalidate 只清渲染行缓存（cachedKey/cachedLines），帧缓存由 TTL 独立保证
-      const rec = makeRecord({ id: "a", status: "running" });
-      const { comp, service } = makeComponent({ records: [rec], rows: 24 });
-      const first = comp.render(80);
-      expect(vi.mocked(service.collectRecords)).toHaveBeenCalledTimes(1);
-      comp.invalidate();
-      const second = comp.render(80);
-      expect(second).not.toBe(first); // 渲染行缓存已清 → 重建
-      expect(vi.mocked(service.collectRecords)).toHaveBeenCalledTimes(1); // 帧缓存未清 → 不重扫
-    });
-
-    it("detailMode 渲染路径（buildDetailContent children）同帧共享：render 仍只 1 次扫描", () => {
-      // 选中项有子 record → buildDetailContent 内 children 计算消费 collectRecordsFrame
-      const parent = makeRecord({ id: "p", status: "closed" });
-      const child = makeRecord({ id: "c", parentRecordId: "p" });
-      const { comp, service } = makeComponent({ records: [parent, child], rows: 24, detailMode: true });
-      const joined = comp.render(80).join("\n");
-      expect(joined).toContain("children:");
-      expect(vi.mocked(service.collectRecords)).toHaveBeenCalledTimes(1); // buildLines + children 同帧合一
-    });
-  });
-});

package/src/execution/__tests__/list-fields.test.ts

@@ -1,109 +0,0 @@
-// src/execution/__tests__/list-fields.test.ts
-//
-// [v4 A-6] recordToListItem 字段派生单测。
-//
-// 验证 list 输出的新增字段派生正确：
-//   - parent：从 record.parentRecordId 派生（顶层 record → undefined）
-//   - resumable：从 isResumable 派生（running && 无活进程句柄）
-//   - closedReason：透传 record.closedReason（SP-4 级联关闭告知替代）
-//
-// Mock 策略：vi.mock lifecycle-predicates 的 isResumable，控制其返回值模拟「有/无
-// 活进程句柄」两种 running 子态。isResumable 真实逻辑（running && !hasLiveProcessHandle）
-// 由 lifecycle-predicates.test.ts 覆盖；本测试聚焦 recordToListItem 的字段派生与透传。
-
-import { describe, expect, it, vi } from "vitest";
-
-// mock lifecycle-predicates：控制 isResumable 返回值。
-// recordToListItem 内部 import 的 isResumable 经 vitest 自动接线拿到此 mock 版本。
-vi.mock("../../execution/lifecycle-predicates.ts", () => ({
-	isResumable: vi.fn(),
-}));
-
-import { recordToListItem } from "../../interface/subagent-actions.ts";
-import { isResumable } from "../../execution/lifecycle-predicates.ts";
-import type { ClosedReason, SubagentRecord } from "../types.ts";
-
-// ── SubagentRecord stub 工厂（最小合法 record） ──
-
-function makeRecord(over: Partial<SubagentRecord> = {}): SubagentRecord {
-	return {
-		id: "sa-test",
-		agent: "general-purpose",
-		task: "test task",
-		slug: "test-slug",
-		status: "running",
-		mode: "background",
-		startedAt: Date.now(),
-		rootSessionId: "session-main",
-		parentRecordId: undefined,
-		depth: 0,
-		endedAt: undefined,
-		turns: 0,
-		totalTokens: 0,
-		model: "test/model",
-		thinkingLevel: undefined,
-		eventLog: [],
-		displayItems: [],
-		result: undefined,
-		error: undefined,
-		sessionFile: undefined,
-		...over,
-	};
-}
-
-describe("recordToListItem — parent/resumable/closedReason (v4 A-6)", () => {
-	// ═══ parent：从 record.parentRecordId 派生 ═══
-
-	it("parent：嵌套 record（parentRecordId='sa-A'）→ parent='sa-A'", () => {
-		const rec = makeRecord({ parentRecordId: "sa-A" });
-		expect(recordToListItem(rec).parent).toBe("sa-A");
-	});
-
-	it("parent：根层 record（parentRecordId=undefined）→ parent=undefined", () => {
-		const rec = makeRecord({ parentRecordId: undefined });
-		expect(recordToListItem(rec).parent).toBeUndefined();
-	});
-
-	// ═══ resumable：isResumable 透传（mock 模拟有/无活进程句柄） ═══
-
-	it("resumable：running + 无活进程句柄（isResumable=true）→ true（B-1 续聊态）", () => {
-		vi.mocked(isResumable).mockReturnValue(true);
-		const rec = makeRecord({ status: "running" });
-		expect(recordToListItem(rec).resumable).toBe(true);
-	});
-
-	it("resumable：running + 有活进程句柄（isResumable=false）→ false（正在执行）", () => {
-		vi.mocked(isResumable).mockReturnValue(false);
-		const rec = makeRecord({ status: "running" });
-		expect(recordToListItem(rec).resumable).toBe(false);
-	});
-
-	it("resumable：closed（isResumable=false）→ false（终态不可续聊）", () => {
-		vi.mocked(isResumable).mockReturnValue(false);
-		const rec = makeRecord({ status: "closed" });
-		expect(recordToListItem(rec).resumable).toBe(false);
-	});
-
-	// ═══ closedReason：透传 record.closedReason ═══
-
-	it("closedReason：closed + closedReason='parent-fork' → 透传", () => {
-		const rec = makeRecord({
-			status: "closed",
-			closedReason: "parent-fork" as ClosedReason,
-		});
-		expect(recordToListItem(rec).closedReason).toBe("parent-fork");
-	});
-
-	it("closedReason：closed + closedReason='parent-new' → 透传（SP-4 级联关闭场景）", () => {
-		const rec = makeRecord({
-			status: "closed",
-			closedReason: "parent-new" as ClosedReason,
-		});
-		expect(recordToListItem(rec).closedReason).toBe("parent-new");
-	});
-
-	it("closedReason：running record（无 closedReason）→ undefined", () => {
-		const rec = makeRecord({ status: "running" });
-		expect(recordToListItem(rec).closedReason).toBeUndefined();
-	});
-});

package/src/execution/__tests__/manifest-parentid.test.ts

@@ -1,117 +0,0 @@
-// ManifestStore — parentRecordId 落盘测试（M3a）。
-//
-// 验证 M3a 三条契约：
-// 1. 新 record 落盘含 parentRecordId（depth>=1 subagent 读回直接父 record id）
-// 2. 旧 manifest JSON（无 parentRecordId 字段）readManifest 仍有效（向后兼容）
-// 3. isValidManifest 校验不改（5 必填不变，parentRecordId optional）
-//
-// isValidManifest 私有未 export——通过 readManifest 等价验证：readManifest 内部
-// `isValidManifest(parsed) ? parsed : null`，非 null ⟺ 校验通过。不 export 私有函数
-// 避免扩大公共 API 表面（M3a C1 约束：不改 isValidManifest，仅 2 行代码改动）。
-
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-
-import { ManifestStore, type ManifestRecord } from "../manifest-store.ts";
-
-/** 构造最小合法 ManifestRecord（5 必填），optional 字段按 overrides 传入。 */
-function makeBaseManifest(overrides: Partial<ManifestRecord> = {}): ManifestRecord {
-  return {
-    id: "rec-test",
-    rootSessionId: "session-main",
-    agentName: "worker",
-    status: "completed",
-    createdAt: 1000,
-    ...overrides,
-  };
-}
-
-describe("ManifestStore — parentRecordId 落盘 (M3a)", () => {
-  let tmpDir: string;
-  let store: ManifestStore;
-
-  beforeEach(() => {
-    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "manifest-parentid-"));
-    store = new ManifestStore(tmpDir);
-  });
-
-  afterEach(() => {
-    fs.rmSync(tmpDir, { recursive: true, force: true });
-  });
-
-  // ── TC-m3a-new-record-parentid ──
-  it("新 record 落盘含 parentRecordId（depth>=1 读回直接父 record id）", async () => {
-    const record = makeBaseManifest({
-      id: "rec-child",
-      parentRecordId: "sa-parent-1",
-    });
-    await store.writeManifest(record);
-
-    const readBack = await store.readManifest("rec-child");
-    expect(readBack).not.toBeNull();
-    expect(readBack?.parentRecordId).toBe("sa-parent-1");
-  });
-
-  it("顶层 record（parentRecordId 缺失）落盘读回仍 undefined", async () => {
-    // 顶层 subagent parentRecordId=undefined（父是 main，main 无 record）
-    const record = makeBaseManifest({ id: "rec-top" });
-    await store.writeManifest(record);
-
-    const readBack = await store.readManifest("rec-top");
-    expect(readBack).not.toBeNull();
-    expect(readBack?.parentRecordId).toBeUndefined();
-  });
-
-  // ── TC-m3a-old-manifest-compat ──
-  it("旧 manifest JSON（无 parentRecordId）readManifest 返有效（isValidManifest 通过）", async () => {
-    // 手写旧版本格式 manifest（无 parentRecordId 字段），模拟旧 subagent-workflow 写的磁盘文件
-    const oldManifest = {
-      id: "rec-old",
-      rootSessionId: "session-main",
-      agentName: "worker",
-      status: "completed",
-      createdAt: 2000,
-      // 无 parentRecordId —— 旧版本写的
-    };
-    fs.writeFileSync(
-      path.join(tmpDir, "rec-old.json"),
-      JSON.stringify(oldManifest),
-      "utf-8",
-    );
-
-    const readBack = await store.readManifest("rec-old");
-    // readManifest 内 isValidManifest(parsed) ? parsed : null —— 非 null 即 5 必填校验通过
-    expect(readBack).not.toBeNull();
-    expect(readBack?.id).toBe("rec-old");
-    expect(readBack?.parentRecordId).toBeUndefined();
-  });
-
-  // ── TC-m3a-isvalidmanifest-unchanged ──
-  it("isValidManifest 不改：含/不含 parentRecordId 均通过（5 必填不变）", async () => {
-    // isValidManifest 私有，通过 readManifest 等价验证（非 null ⟺ 校验通过）。
-    // 含 parentRecordId —— 新格式
-    const withParent = makeBaseManifest({
-      id: "rec-with-parent",
-      parentRecordId: "sa-x",
-    });
-    await store.writeManifest(withParent);
-    expect(await store.readManifest("rec-with-parent")).not.toBeNull();
-
-    // 不含 parentRecordId —— 仅 5 必填（旧格式 / 顶层 record）
-    const minimal = {
-      id: "rec-minimal",
-      rootSessionId: "session-main",
-      agentName: "worker",
-      status: "completed",
-      createdAt: 3000,
-    };
-    fs.writeFileSync(
-      path.join(tmpDir, "rec-minimal.json"),
-      JSON.stringify(minimal),
-      "utf-8",
-    );
-    expect(await store.readManifest("rec-minimal")).not.toBeNull();
-  });
-});