expect(lock).toBeNull();

});

it("falls back instead of throwing when lock payload clock is outside Date range", async () => {

const env = await makeEnv();

const dateNowSpy = vi.spyOn(Date, "now").mockReturnValue(Date.parse("2026-05-30T12:00:00Z"));

const lock = expectGatewayLock(

await acquireGatewayLock({

env,

allowInTests: true,

timeoutMs: 30,

pollIntervalMs: 2,

now: () => 8_640_000_000_000_001,

sleep: async () => {},

lockDir: resolveTestLockDir(),

}),

);

try {

const payload = JSON.parse(await fs.readFile(lock.lockPath, "utf8")) as {

createdAt?: string;

};

expect(payload.createdAt).toBe("2026-05-30T12:00:00.000Z");

} finally {

dateNowSpy.mockRestore();

await lock.release();

}

});

it("wraps unexpected fs errors as GatewayLockError", async () => {

const env = await makeEnv();

const openSpy = vi.spyOn(fs, "open").mockRejectedValueOnce(

import path from "node:path";

import { z } from "zod";

import { resolveConfigPath, resolveGatewayLockDir, resolveStateDir } from "../config/paths.js";

import { resolveTimestampMsToIsoString } from "../shared/number-coercion.js";

import { isPidAlive } from "../shared/pid-alive.js";

import { safeParseJsonWithSchema } from "../utils/zod-parse.js";

import { isGatewayArgv, parseProcCmdline, parseWindowsCmdline } from "./gateway-process-argv.js";

const startTime = platform === "linux" ? readLinuxStartTime(process.pid) : null;

const payload: LockPayload = {

pid: process.pid,

createdAt: new Date(now()).toISOString(),

createdAt: resolveTimestampMsToIsoString(now()),

configPath,

};

if (typeof startTime === "number" && Number.isFinite(startTime)) {