test: Phase 2-4 — 添加 12 个测试文件 (+321 tests, 968 total)

Phase 2 (轻 Mock): envUtils, sleep/sequential, memoize, groupToolUses, dangerousPatterns, outputLimits
Phase 3 (补全): zodToJsonSchema, PermissionMode, envValidation
Phase 4 (工具模块): mcpStringUtils, destructiveCommandWarning, commandSemantics

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

src/utils/__tests__/envValidation.test.ts

@@ -0,0 +1,74 @@
+import { mock, describe, expect, test } from "bun:test";
+
+// Mock debug.ts to cut bootstrap/state dependency chain
+mock.module("src/utils/debug.ts", () => ({
+  logForDebugging: () => {},
+  isDebugMode: () => false,
+  isDebugToStdErr: () => false,
+  getDebugFilePath: () => null,
+  getDebugFilter: () => null,
+  getMinDebugLogLevel: () => "debug",
+  getDebugLogPath: () => "/tmp/mock-debug.log",
+  flushDebugLogs: async () => {},
+  enableDebugLogging: () => false,
+  setHasFormattedOutput: () => {},
+  getHasFormattedOutput: () => false,
+  logAntError: () => {},
+}));
+
+const { validateBoundedIntEnvVar } = await import("../envValidation");
+
+describe("validateBoundedIntEnvVar", () => {
+  test("returns default when value is undefined", () => {
+    const result = validateBoundedIntEnvVar("TEST_VAR", undefined, 100, 1000);
+    expect(result).toEqual({ effective: 100, status: "valid" });
+  });
+
+  test("returns default when value is empty string", () => {
+    const result = validateBoundedIntEnvVar("TEST_VAR", "", 100, 1000);
+    expect(result).toEqual({ effective: 100, status: "valid" });
+  });
+
+  test("returns parsed value when valid and within limit", () => {
+    const result = validateBoundedIntEnvVar("TEST_VAR", "500", 100, 1000);
+    expect(result).toEqual({ effective: 500, status: "valid" });
+  });
+
+  test("caps value at upper limit", () => {
+    const result = validateBoundedIntEnvVar("TEST_VAR", "2000", 100, 1000);
+    expect(result.effective).toBe(1000);
+    expect(result.status).toBe("capped");
+    expect(result.message).toContain("Capped from 2000 to 1000");
+  });
+
+  test("returns default for non-numeric value", () => {
+    const result = validateBoundedIntEnvVar("TEST_VAR", "abc", 100, 1000);
+    expect(result.effective).toBe(100);
+    expect(result.status).toBe("invalid");
+    expect(result.message).toContain("Invalid value");
+  });
+
+  test("returns default for zero", () => {
+    const result = validateBoundedIntEnvVar("TEST_VAR", "0", 100, 1000);
+    expect(result.effective).toBe(100);
+    expect(result.status).toBe("invalid");
+  });
+
+  test("returns default for negative value", () => {
+    const result = validateBoundedIntEnvVar("TEST_VAR", "-5", 100, 1000);
+    expect(result.effective).toBe(100);
+    expect(result.status).toBe("invalid");
+  });
+
+  test("handles value at exact upper limit", () => {
+    const result = validateBoundedIntEnvVar("TEST_VAR", "1000", 100, 1000);
+    expect(result.effective).toBe(1000);
+    expect(result.status).toBe("valid");
+  });
+
+  test("handles value of 1 (minimum valid)", () => {
+    const result = validateBoundedIntEnvVar("TEST_VAR", "1", 100, 1000);
+    expect(result.effective).toBe(1);
+    expect(result.status).toBe("valid");
+  });
+});