fix(fs): S-10 hang test hook requires UMT_FS_TEST_HOOKS=1; preflight warns when set

Co-Authored-By: Claude Opus 5.5 <[email protected]>

packages/adapters/src/fs/fsproxy.test.ts

@@ -9,6 +9,7 @@ import {
   type FsProgress,
   FsProxy,
   fsErrorClass,
+  fsTestHookFromEnv,
   sweepStalePartials,
   toFsError,
 } from "./index.ts";
@@ -147,10 +148,22 @@ describe("FsProxy 启动方式", () => {
     expect(px.stats()).toMatchObject({ mode: "inprocess", fallbackReason: expect.stringMatching(/^spawn_failed/) });
   });
 
+  it("验收开关只在 UMT_FS_TEST_HOOKS=1 时生效(单独误设 HANG_AFTER_BYTES 无效)", () => {
+    const env = (m: Record<string, string>) => (k: string) => m[k];
+    expect(fsTestHookFromEnv(env({ UMT_FS_TEST_HANG_AFTER_BYTES: "1024" }))).toBeUndefined();
+    expect(fsTestHookFromEnv(env({ UMT_FS_TEST_HANG_AFTER_BYTES: "1024", UMT_FS_TEST_HOOKS: "0" }))).toBeUndefined();
+    expect(fsTestHookFromEnv(env({ UMT_FS_TEST_HANG_AFTER_BYTES: "x", UMT_FS_TEST_HOOKS: "1" }))).toBeUndefined();
+    expect(fsTestHookFromEnv(env({ UMT_FS_TEST_HANG_AFTER_BYTES: "1024", UMT_FS_TEST_HOOKS: "1" }))).toEqual({
+      hangAfterBytes: 1024,
+      ignoreTerm: true,
+    });
+  });
+
   it("UMT_FS_TEST_HANG_AFTER_BYTES(容器验收开关)→ 数据类操作卡死 → SIGKILL → TIMEOUT;快操作不受影响", async () => {
     const t = await tree({ "src/a.mkv": 3 * MiB, "dst/": null });
     const px = new FsProxy({ mode: "subprocess", ...fast });
     Deno.env.set("UMT_FS_TEST_HANG_AFTER_BYTES", String(MiB));
+    Deno.env.set("UMT_FS_TEST_HOOKS", "1");
     try {
       expect(await px.statSafe(t.path("src/a.mkv"))).toMatchObject({ kind: "ok" });
       const e = await px.copy(t.path("src/a.mkv"), t.path("dst/a.mkv")).catch((x) => x);
@@ -158,6 +171,7 @@ describe("FsProxy 启动方式", () => {
       expect(px.stats()).toMatchObject({ timeouts: 1, killed: 1 });
     } finally {
       Deno.env.delete("UMT_FS_TEST_HANG_AFTER_BYTES");
+      Deno.env.delete("UMT_FS_TEST_HOOKS");
     }
   }, 30_000);
 });