test(setup): 자식 프로세스를 띄우는 시험이 잰 시간으로 timeout을 정한다

자식 프로세스를 띄우는 Vitest 시험 91개(24파일)가 기본 timeout 10초에
기대고 있었다. 셋은 FE-GATE-013에서만 도는 tests/system 시험이다.
기본값은 프로세스 안에서 도는 시험에 맞춘 값이다. 부하가 높은
desktop에서는 자식 프로세스 시험이 평소보다 크게 느려진다.
FE-GATE-020 drill 사본에서 평소 0.4~1.2초인 문서 시험이 10.6초 걸려
실패했다(2026-11-12). 가장 위험한 것은 tests/architecture/app-build-input
.test.ts로, desktop에서 이미 5.7초까지 걸렸다.

무엇을 고칠지는 desktop 계측으로 정했다.
- test:coverage 묶음(maxWorkers=4)과 test:unit을 세 번씩 돌렸다. 시험마다
  띄운 자식 프로세스는 child_process 함수를 감싸 기록했고, 소요 시간은
  JSON reporter로 받았다.
- 시험마다 실제 timeout은 task.timeout으로 기록했다.
- 자식 프로세스를 띄우는 시험 140개 중 88개가 기본값이었다. tests/system은
  그 묶음에 없어서, 아래 검사가 잡은 셋을 따로 세 번 쟀다.

고친 것:
- tests/helpers/child-process-timeout.ts의 childProcessTimeout(<잰 최대
  ms>)는 그 15배를 30초 단위로 올린 값이다. 15배는 위 0.7초 → 10.6초에서
  왔다. 시험마다 자기가 잰 최대값을 인자로 적어 근거가 호출 자리에 남는다.
- describe 안의 기본값 시험이 모두 자식 프로세스를 띄우면 describe에,
  일부만 띄우면 그 시험에 준다. 프로세스 안에서 도는 시험의 hang을 늦게
  잡지 않으려는 것이다.
- tests/setup.ts가 child_process 함수를 감싼다. 기본 timeout인 시험이
  자식 프로세스를 띄우면 그 호출에서 실패시키고, helper 이름을 알린다.
  helper나 시험이 import한 스크립트가 띄워도 잡는다. util.promisify가
  읽는 속성은 원래 함수에서 옮긴다.
- docs/work/reference/testing.md 2절에 값 정하는 법과 이 검사를 적었다.

버린 것:
- 전역 testTimeout 올리기: 프로세스 안 시험의 hang을 늦게 잡는다.
- 시험마다 손으로 정한 숫자: 근거가 남지 않고, 이미 있는 값도
  60_000·120_000처럼 근거가 없었다.
- 자식 프로세스를 띄우지 않게 바꾸기: 검사 스크립트를 CLI 그대로 시험하는
  것이 이 시험들의 목적이라 범위가 커진다.
- 파일에 timeout 선언이 있는지만 보는 정적 검사: helper가 띄우는 경우와
  같은 파일의 다른 시험을 놓친다.

위험:
- hook(beforeAll 등)에서 띄우는 프로세스는 검사하지 않는다. 계측에서
  hook이 띄운 곳은 둘이고, 둘 다 180초를 선언했다.
- 같은 파일 안에서 it.concurrent로 도는 시험이 섞이면 어느 시험의
  timeout인지 틀릴 수 있다. 지금은 그런 시험이 없다.
- 다운스트림 시험이 기본값으로 자식 프로세스를 띄우면 test:unit 등이
  실패한다. 메시지가 helper를 알린다.

검증(desktop):
- 다섯 검사(test:unit·check:types·check:ci·lint·verify:documentation)
  rc=0.
- 자식 프로세스를 띄우는 시험 파일 40개와 tests/scale: rc=0, 검사 위반 0.
- tests/system: 115개 중 18개 실패. 모두 bwrap 호스트 제약이고 검사
  위반은 0이다.
- 변이: 검사를 끄면 tests/unit/child-process-timeout.test.ts가 실패한다.
  tracked-artifacts describe의 timeout을 지우면 그 시험이 검사 메시지로
  실패한다.
- 재현: CPU 10% 제한에서 app-build-input·registry-governance·hosting-probe
  ·design-system-rules를 돌렸다. main 650d22fa는 11개가 10초 timeout으로
  실패했다. 이 커밋은 71개 모두 통과했고, 가장 긴 시험은 17.7초였다.
This commit is contained in:
DongHyeonka
2026-11-12 11:22:59 +09:00
parent 6b4f703c59
commit 91962e24e3
28 changed files with 202 additions and 59 deletions
+4 -3
View File
@@ -8,6 +8,7 @@ import { afterAll, describe, expect, it } from "vitest";
import { inspectAppBuildInput } from "../../scripts/check-app-build-input.ts";
import { renderContextIndex, renderFeatureIndex } from "../../scripts/generate-product-feature-index.ts";
import { APP_A, writeFilesystemTopology } from "../scale/filesystem-topology.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
/**
* Deployable-app isolation regression gate: the build input of one app must
@@ -51,7 +52,7 @@ describe("app build input isolation gate", () => {
expect(report.appId).toBe(APP_A.id);
expect(report.generatedFeatureImports).toHaveLength(APP_A.contexts * APP_A.featuresPerContext);
expect(report.bundle.checked).toBe(true);
});
}, childProcessTimeout(5_739));
it("rejects a generator regression that imports every discovered feature", async () => {
const root = await multiAppRepo();
@@ -70,7 +71,7 @@ describe("app build input isolation gate", () => {
expect(report.violations.length).toBeGreaterThan(0);
expect(report.violations.join("\n")).toMatch(/imports feature "other-0-ctx0-f0" not owned by app app-a/);
expect(report.violations.join("\n")).toMatch(/declares context "other-0-ctx0" not owned/);
});
}, childProcessTimeout(4_734));
it("rejects a production bundle that contains another app's feature", async () => {
const root = await multiAppRepo();
@@ -82,7 +83,7 @@ describe("app build input isolation gate", () => {
expect(report.violations).toEqual([
'production bundle contains feature "other-0-ctx3-f7" not owned by app app-a',
]);
});
}, childProcessTimeout(4_217));
it("holds for this repository's generated indexes", async () => {
// The bundle side is gated after a fresh build (check:app-build-input:bundle).
+27
View File
@@ -0,0 +1,27 @@
/**
* Timeouts for Vitest tests that start a child process
* (docs/work/reference/testing.md 2절: such a test declares its own timeout).
* tests/setup.ts fails a test on the default timeout that starts one.
*/
/** `testTimeout` in vitest.config.ts, sized for tests that run in process. */
export const DEFAULT_TEST_TIMEOUT_MS = 10_000;
/**
* A child process slowed down far more than in-process code on a loaded
* desktop: a documentation test that runs its checker as a child took 0.4 to
* 1.2 s, and 10.6 s once inside an FE-GATE-020 drill (2026-11-12), so it
* failed on the 10 s default.
*/
const LOADED_HOST_SLOWDOWN = 15;
const STEP_MS = 30_000;
/**
* The timeout for a test, or for a describe, whose longest measured run took
* `longestMeasuredMs`: fifteen times that, rounded up to a 30 s step. Measure
* on desktop with the JSON reporter, with test:coverage and test:unit, and pass
* the longest test of the describe.
*/
export function childProcessTimeout(longestMeasuredMs: number): number {
return Math.max(1, Math.ceil((longestMeasuredMs * LOADED_HOST_SLOWDOWN) / STEP_MS)) * STEP_MS;
}
@@ -17,6 +17,7 @@ import path from "node:path";
import { pathToFileURL } from "node:url";
import { afterEach, describe, expect, it } from "vitest";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
/**
* This suite's budget, not the file's. The 10s default is sized for pure-JS
@@ -242,7 +243,7 @@ describe("provider guardian transaction protocol", () => {
await expect(lstat(rawPath)).rejects.toMatchObject({ code: "ENOENT" });
await expect(lstat(sealedTempPath)).rejects.toMatchObject({ code: "ENOENT" });
await expect(readdir(path.join(workspace, "provider-evidence/untrusted"))).resolves.toEqual([]);
});
}, childProcessTimeout(253));
it("creates no evidence for empty or truncated guard input", async () => {
const { startProviderGuardian } = await import(
@@ -279,7 +280,7 @@ describe("provider guardian transaction protocol", () => {
await expect(readdir(path.join(workspace, "provider-evidence")))
.resolves.toEqual(["untrusted"]);
}
});
}, childProcessTimeout(1_226));
it.each(["raw", "sealed"] as const)(
"cleans the independently bound %s private alias when peer bootstrap validation fails",
@@ -308,6 +309,7 @@ describe("provider guardian transaction protocol", () => {
await expect(readdir(path.join(workspace, "provider-evidence")))
.resolves.toEqual(["untrusted"]);
},
childProcessTimeout(250),
);
it("cleans guardian-created objects when the parent closes immediately after guard", async () => {
@@ -321,7 +323,7 @@ describe("provider guardian transaction protocol", () => {
.resolves.toEqual({ code: 125, signal: null });
await expect(readdir(path.join(workspace, "provider-evidence/untrusted"))).resolves.toEqual([]);
await expect(readdir(path.join(workspace, "provider-evidence"))).resolves.toEqual(["untrusted"]);
});
}, childProcessTimeout(314));
// G-1: a guardian that rejects its guard must exit then, not when the parent
// finally closes stdin. The client waits for READY with stdin open, so a
@@ -340,7 +342,7 @@ describe("provider guardian transaction protocol", () => {
}
await expect(readdir(path.join(workspace, "provider-evidence/untrusted"))).resolves.toEqual([]);
await expect(readdir(path.join(workspace, "provider-evidence"))).resolves.toEqual(["untrusted"]);
});
}, childProcessTimeout(430));
it("publishes the pinned sealed inode and preserves it only after commit EOF", async () => {
const {
@@ -410,7 +412,7 @@ describe("provider guardian transaction protocol", () => {
});
await expect(lstat(rawPath)).rejects.toMatchObject({ code: "ENOENT" });
await expect(readFile(sealedPath)).resolves.toEqual(bytes);
});
}, childProcessTimeout(448));
it("owns raw and sealed publication through the authenticated client lease", async () => {
const client = await import("../../scripts/lib/provider-guardian-client.ts") as
@@ -460,7 +462,7 @@ describe("provider guardian transaction protocol", () => {
await lease.commit();
await expect(lstat(lease.rawPath)).rejects.toMatchObject({ code: "ENOENT" });
await expect(readFile(lease.sealedPath)).resolves.toEqual(bytes);
});
}, childProcessTimeout(383));
it("cleans published evidence on EOF before commit and permits a same-workspace retry", async () => {
const workspace = await createWorkspace("provider-guardian-published-eof-");
@@ -483,7 +485,7 @@ describe("provider guardian transaction protocol", () => {
await retry.abort();
await expect(readdir(path.join(workspace, "provider-evidence/untrusted"))).resolves.toEqual([]);
await expect(readdir(path.join(workspace, "provider-evidence"))).resolves.toEqual(["untrusted"]);
});
}, childProcessTimeout(429));
it("fails closed when a separate trailing frame arrives after commit", async () => {
const { encodeProviderGuardianCommit } = await import(
@@ -501,7 +503,7 @@ describe("provider guardian transaction protocol", () => {
await expect(within(transaction.completion, PROCESS_HANDSHAKE_WATCHDOG_MS, "guardian trailing frame"))
.resolves.toEqual({ code: 126, signal: null });
await assertTransactionAbsent(transaction);
});
}, childProcessTimeout(301));
it("uses pinned fallback identities after a guardian hard death", async () => {
const { startProviderGuardian } = await import(
@@ -522,7 +524,7 @@ describe("provider guardian transaction protocol", () => {
await expect(lstat(lease.rawPath)).rejects.toMatchObject({ code: "ENOENT" });
await expect(lstat(lease.sealedTempPath)).rejects.toMatchObject({ code: "ENOENT" });
await expect(lstat(lease.sealedPath)).rejects.toMatchObject({ code: "ENOENT" });
});
}, childProcessTimeout(380));
it("cleans a linked raw inode when killed before READY and retries immediately", async () => {
const { startProviderGuardian } = await import(
@@ -568,7 +570,7 @@ describe("provider guardian transaction protocol", () => {
await retry.abort();
await expect(readdir(rawDirectory)).resolves.toEqual([]);
await expect(readdir(evidenceRoot)).resolves.toEqual(["untrusted"]);
});
}, childProcessTimeout(524));
it("preserves an external raw canary created after startup checks", async () => {
const { startProviderGuardian } = await import(
@@ -618,7 +620,7 @@ describe("provider guardian transaction protocol", () => {
.resolves.toEqual([]);
await expect(readdir(path.join(workspace, "provider-evidence")))
.resolves.toEqual(["untrusted"]);
});
}, childProcessTimeout(425));
it("allows exactly one same-kind guardian without deleting the winner", async () => {
const { startProviderGuardian } = await import(
@@ -655,7 +657,7 @@ describe("provider guardian transaction protocol", () => {
.resolves.toEqual([]);
await expect(readdir(path.join(workspace, "provider-evidence")))
.resolves.toEqual(["untrusted"]);
});
}, childProcessTimeout(945));
it("exits nonzero after cleanup when the diagnostic stderr pipe is closed", async () => {
const { decodeProviderGuardianReady } = await import(
@@ -683,7 +685,7 @@ describe("provider guardian transaction protocol", () => {
.rejects.toMatchObject({ code: "ENOENT" });
await expect(lstat(path.join(evidenceRoot, ready.sealedTempLeaf)))
.rejects.toMatchObject({ code: "ENOENT" });
});
}, childProcessTimeout(469));
it("expires an uncommitted lease only after cleaning every owned object", async () => {
const { decodeProviderGuardianReady } = await import(
@@ -733,7 +735,7 @@ describe("provider guardian transaction protocol", () => {
await lease.commit();
await expect(lstat(lease.rawPath)).rejects.toMatchObject({ code: "ENOENT" });
await expect(readFile(lease.sealedPath)).resolves.toEqual(bytes);
});
}, childProcessTimeout(1_126));
it("signals guardian exit only while the provider scope latch is active", async () => {
const lifecycle = await import("../../scripts/lib/provider-guardian-client.ts") as
@@ -9,6 +9,7 @@ import {
selectAppIndexes,
type TopologyDeclarationSource,
} from "../../scripts/generate-product-feature-index.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
describe("feature index generator", () => {
it("is deterministic by normalized id", () => {
@@ -275,5 +276,5 @@ describe("build-time product selection (09-02)", () => {
);
expect(run.status).not.toBe(0);
expect(run.stderr).toMatch(/does not contain: reference-featrue/u);
});
}, childProcessTimeout(157));
});
+50 -1
View File
@@ -1,6 +1,10 @@
import "@testing-library/jest-dom/vitest";
import { createRequire, syncBuiltinESMExports } from "node:module";
import { cleanup, configure } from "@testing-library/react";
import { afterEach, vi } from "vitest";
import { afterEach, beforeEach, vi } from "vitest";
import { DEFAULT_TEST_TIMEOUT_MS } from "./helpers/child-process-timeout.ts";
// findBy*/waitFor settle on the DOM change itself; their deadline only reports
// a hang. Routes render through React.lazy, and React 19 holds every Suspense
@@ -18,3 +22,48 @@ afterEach(() => {
// timers to the next test in the file.
vi.useRealTimers();
});
/**
* A test that starts a child process declares its own timeout
* (docs/work/reference/testing.md 2절). On a loaded desktop a 0.7 s
* documentation test took 10.6 s and failed FE-GATE-020 on the default, which
* is sized for tests that run in process. A test still on the default fails
* here, at the call, also when a helper or a script it imports starts the
* process. Hooks are not checked: they have no test of their own.
*/
type ChildProcessCall = (this: unknown, ...args: unknown[]) => unknown;
const guard = globalThis as typeof globalThis & {
__childProcessTimeoutGuard?: { timeout: number | undefined };
};
if (!guard.__childProcessTimeoutGuard) {
const state: { timeout: number | undefined } = { timeout: undefined };
guard.__childProcessTimeoutGuard = state;
const childProcess = createRequire(import.meta.url)("node:child_process") as Record<string, ChildProcessCall>;
for (const name of ["spawn", "spawnSync", "exec", "execSync", "execFile", "execFileSync", "fork"]) {
const original = childProcess[name]!;
const checked: ChildProcessCall = function (this: unknown, ...args: unknown[]) {
if (state.timeout === DEFAULT_TEST_TIMEOUT_MS) {
throw new Error(
`${name}(${String(args[0])}) ran in a test on the default ${DEFAULT_TEST_TIMEOUT_MS} ms timeout. ` +
"Give the test, or its describe, childProcessTimeout(<longest measured ms>) from tests/helpers/child-process-timeout.ts.",
);
}
return original.apply(this, args);
};
// util.promisify(execFile) and the like read properties of the function.
for (const key of Reflect.ownKeys(original)) {
if (key !== "length" && key !== "name" && key !== "prototype") {
Object.defineProperty(checked, key, Reflect.getOwnPropertyDescriptor(original, key)!);
}
}
childProcess[name] = checked;
}
syncBuiltinESMExports();
}
const childProcessGuard = guard.__childProcessTimeoutGuard;
beforeEach((context) => {
childProcessGuard.timeout = context.task.timeout;
});
afterEach(() => {
childProcessGuard.timeout = undefined;
});
@@ -8,6 +8,7 @@ import { afterEach, describe, expect, it } from "vitest";
import { loadCiGateContract } from "../../../scripts/contracts/ci-gates.ts";
import { DEPENDENCY_ADVISORIES_RECORD_PATH } from "../../../scripts/lib/dependency-advisories.ts";
import { FIXTURE_PNPM_ENVIRONMENT } from "../../../scripts/lib/fixture-node-modules.ts";
import { childProcessTimeout } from "../../helpers/child-process-timeout.ts";
// F-12. The temp roots have a package.json but no node_modules or lockfile.
// Run directly (not under pnpm), pnpm's pre-script install check started an
@@ -24,7 +25,7 @@ afterEach(async () => {
);
});
describe("CI-runner command-generated evidence freshness", () => {
describe("CI-runner command-generated evidence freshness", { timeout: childProcessTimeout(871) }, () => {
it("rejects stale command-generated evidence from a successful no-op producer", async () => {
const root = await mkdtemp(path.join(tmpdir(), "ci-gate-stale-evidence-"));
temporaryRoots.push(root);
@@ -5,8 +5,9 @@ import path from "node:path";
import { describe, expect, it } from "vitest";
import { runProviderProcess } from "../../../scripts/lib/provider-process-runner.ts";
import { childProcessTimeout } from "../../helpers/child-process-timeout.ts";
describe("CI-runner provider process-group lifecycle", () => {
describe("CI-runner provider process-group lifecycle", { timeout: childProcessTimeout(263) }, () => {
it("kills and reaps a stubborn provider process group including its descendant", async () => {
const root = await mkdtemp(path.join(tmpdir(), "provider-process-group-"));
const descendantPidPath = path.join(root, "descendant.pid");
+3 -2
View File
@@ -4,6 +4,7 @@ import { tmpdir } from "node:os";
import path from "node:path";
import { afterEach, describe, expect, it } from "vitest";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
/**
* 1105/07-01. `check:backend-contract-drift` on a fake paired backend: a git
@@ -224,7 +225,7 @@ async function drift(
};
}
describe("check:backend-contract-drift (1105/07-01)", () => {
describe("check:backend-contract-drift (1105/07-01)", { timeout: childProcessTimeout(450) }, () => {
it("passes when the excerpt and the answer table match the pinned document", async () => {
const result = await drift();
@@ -311,7 +312,7 @@ describe("check:backend-contract-drift (1105/07-01)", () => {
* `docs/web/http-contract.md`, so a backend that changed its scaffold left
* the frontend generator writing another path, limit or code with no signal.
*/
describe("check:backend-contract-drift scaffold sources (1105/16-02)", () => {
describe("check:backend-contract-drift scaffold sources (1105/16-02)", { timeout: childProcessTimeout(502) }, () => {
it("reports a scaffold source the generator copies from, with where the copy is", async () => {
const result = await drift({ scaffoldHead: "public static final int NAME_MAX_LENGTH = 120;\n" });
+3 -2
View File
@@ -4,6 +4,7 @@ import { tmpdir } from "node:os";
import path from "node:path";
import { afterEach, describe, expect, it } from "vitest";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
/**
* 1103/15-03. An over-budget build printed only
@@ -77,7 +78,7 @@ const OUTPUTS = [
];
const BUDGETS = { initialJsGzipBytes: 1_000, initialJsFiles: 2, lazyChunkGzipBytes: 400 };
describe("check:bundle failure output (1103/15-03)", () => {
describe("check:bundle failure output (1103/15-03)", { timeout: childProcessTimeout(730) }, () => {
it("passes and prints the total within budget", async () => {
const result = await checkBundle({ outputs: OUTPUTS, manifest: MANIFEST, budgets: BUDGETS });
expect(result.stderr).toBe("");
@@ -142,7 +143,7 @@ describe("check:bundle failure output (1103/15-03)", () => {
* build over budget under .tmp/ passed on the checkout's earlier build
* (review run 12-R2). Both stop and name the variable instead.
*/
describe("check:bundle with RUN_OUTPUT_ROOT (1106/12-02)", () => {
describe("check:bundle with RUN_OUTPUT_ROOT (1106/12-02)", { timeout: childProcessTimeout(1_041) }, () => {
it("does not pass the checkout's earlier build while the build writes elsewhere", async () => {
const result = await checkBundle({
outputs: OUTPUTS,
+40
View File
@@ -0,0 +1,40 @@
import { execFile, spawnSync } from "node:child_process";
import { promisify } from "node:util";
import { describe, expect, it } from "vitest";
import config from "../../vitest.config.ts";
import { childProcessTimeout, DEFAULT_TEST_TIMEOUT_MS } from "../helpers/child-process-timeout.ts";
const NODE_ARGS = ["-e", "process.stdout.write('ran')"];
// tests/setup.ts fails a test on the default timeout that starts a child process.
describe("a child process in a test on the default timeout", () => {
it("fails at the call, naming the call and the helper", () => {
expect(() => spawnSync(process.execPath, NODE_ARGS)).toThrow(
/spawnSync\(.+\) ran in a test on the default 10000 ms timeout\. .*childProcessTimeout/u,
);
expect(() => execFile(process.execPath, NODE_ARGS)).toThrow(/execFile\(.+\) ran in a test on the default/u);
});
it("is the default vitest.config.ts sets", () => {
expect(config.test?.testTimeout).toBe(DEFAULT_TEST_TIMEOUT_MS);
});
});
describe("a child process in a test with its own timeout", { timeout: childProcessTimeout(100) }, () => {
it("runs", async () => {
expect(spawnSync(process.execPath, NODE_ARGS, { encoding: "utf8" }).stdout).toBe("ran");
// The guard keeps what util.promisify reads from the original function.
await expect(promisify(execFile)(process.execPath, NODE_ARGS)).resolves.toEqual({ stdout: "ran", stderr: "" });
});
});
describe("childProcessTimeout", () => {
it("is fifteen times the longest measured run, rounded up to 30 s steps", () => {
expect(childProcessTimeout(0)).toBe(30_000);
expect(childProcessTimeout(1_999)).toBe(30_000);
expect(childProcessTimeout(2_001)).toBe(60_000);
expect(childProcessTimeout(5_739)).toBe(90_000);
});
});
+3 -2
View File
@@ -29,6 +29,7 @@ import {
validatePackageScriptGraph,
} from "../../scripts/lib/package-script-graph.ts";
import { VISUAL_TEST_FONT_PACKAGES } from "../../scripts/lib/visual-test-fonts.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
const temporaryRoots: string[] = [];
const npmPostScriptForeignScopeCommands = [
@@ -1537,7 +1538,7 @@ describe("CI gate contract", () => {
const result = spawnSync(process.execPath, [path.resolve("scripts/run-ci-gate.ts"), "FE-GATE-010"], { cwd: root, encoding: "utf8" });
expect(result.status).not.toBe(0);
await expect(readFile(marker)).rejects.toMatchObject({ code: "ENOENT" });
});
}, childProcessTimeout(1_298));
it("records checked-in workflow drift as a failing typed report", async () => {
const root = await mkdtemp(path.join(tmpdir(), "ci-contract-workflow-drift-"));
@@ -1564,7 +1565,7 @@ describe("CI gate contract", () => {
expect(report.workflowSha256).toBe(
await import("node:crypto").then(({ createHash }) => createHash("sha256").update(drift).digest("hex")),
);
});
}, childProcessTimeout(1_376));
});
+3 -2
View File
@@ -16,6 +16,7 @@ import { ENV_REGISTRY, getBuildConfig } from "../../src/contracts/env.ts";
import { EXPECTED_CONTRACT_SET_PACKAGES } from "../../src/features/installed-contract-contributions.ts";
import { runtimeConfigV2ArtifactSchema } from "../../src/contracts/release-artifacts.ts";
import { generateRuntimeConfig } from "../../scripts/generate-runtime-config.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
const PRODUCTION_ARTIFACT: AdmissionInput = Object.freeze({
APP_ENV: "production",
@@ -357,13 +358,13 @@ describe("runtime config profiles", () => {
} finally {
await rm(root, { recursive: true, force: true });
}
});
}, childProcessTimeout(513));
});
// 1101/13-05. The emergency switches (CAPABILITY_OVERRIDES, FEATURE_OVERRIDES)
// are changed in the deployed config.json without a rebuild. A typo there stops
// every boot, so the edited copy is checked against the deployed one first.
describe("checking an edited copy of the deployed runtime config", () => {
describe("checking an edited copy of the deployed runtime config", { timeout: childProcessTimeout(795) }, () => {
async function check(
edit: (deployed: Record<string, unknown>) => Record<string, unknown>,
args: readonly string[] = ["--config", "edited.json", "--original", "deployed.json"],
+2 -1
View File
@@ -12,10 +12,11 @@ import {
hueMixFailures,
unreadTokenFailures,
} from "../../scripts/lib/design-system-rules.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
const css = (source: string) => ({ file: "probe.css", source });
describe("design system rules", () => {
describe("design system rules", { timeout: childProcessTimeout(3_540) }, () => {
describe("UI-01 focus ring contrast", () => {
const tokens = (focus: string) =>
new Map([
+3 -2
View File
@@ -13,6 +13,7 @@ import {
} from "../../scripts/lib/removable-template-features.ts";
import { PLATFORM_ROUTE_REGISTRY } from "../../src/contracts/routes.ts";
import { ROUTE_FEATURE_OWNER, ROUTE_REGISTRY } from "../../src/features/installed-feature-contracts.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
/**
* R4 and R5 of docs/manual/03-outside-feature-folder.md. A sample feature
@@ -257,7 +258,7 @@ describe("gate targets (R5)", () => {
expect(targets.artifacts.some((artifact) => artifact.startsWith("docs/accessibility/route-reviews/"))).toBe(true);
expect(targets.gateScripts.length).toBeGreaterThan(20);
expect(sampleGateTargets(samplesOf(REMOVABLE_TEMPLATE_FEATURES), repositoryRoutes(), targets)).toEqual([]);
});
}, childProcessTimeout(176));
it("finds this repository's targets once a sample owns what they point at", async () => {
// As if the platform overview screen, the design system and the message catalog were a sample's.
@@ -278,7 +279,7 @@ describe("gate targets (R5)", () => {
"FE-GATE-008 runs test:visual, a script of sample overview-sample",
]),
);
});
}, childProcessTimeout(85));
it("follows routes, imports, route reviews, scripts and the scale record of a synthetic sample", () => {
const sample: Sample = {
@@ -9,6 +9,7 @@ import { createRuntimeAdapters } from "../../src/bootstrap/runtime-adapters.ts";
import { COMPILED_PRODUCT_FEATURE_IDS } from "../../src/features/installed-product-manifest.ts";
import { generateRuntimeConfig } from "../../scripts/generate-runtime-config.ts";
import { testRuntimeConfig } from "../helpers/runtime-config.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
type Runtime = Parameters<typeof createRuntimeAdapters>[0]["runtime"];
@@ -120,5 +121,5 @@ describe("unknown feature override keys (09-09)", () => {
} finally {
await rm(root, { recursive: true, force: true });
}
});
}, childProcessTimeout(464));
});
+2 -1
View File
@@ -6,11 +6,12 @@ import path from "node:path";
import { describe, expect, it } from "vitest";
import { REMOVABLE_TEMPLATE_FEATURES } from "../../scripts/lib/removable-template-features.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
// 09-07 (D-10). The removal gate takes the feature to remove as an argument
// instead of hard-coding the sample; an id no feature declares stops it before
// any fixture is built.
describe("feature removal argument", () => {
describe("feature removal argument", { timeout: childProcessTimeout(1_348) }, () => {
it("refuses a feature id that no installed feature declares", () => {
const run = spawnSync(
process.execPath,
+2 -1
View File
@@ -20,6 +20,7 @@ import {
linkFixtureNodeModules,
} from "../../scripts/lib/fixture-node-modules.ts";
import { selectRepositoryPaths } from "../../scripts/lib/repository-layout.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
/**
* A removal or provider fixture runs `pnpm` inside a throwaway copy of the
@@ -171,7 +172,7 @@ describe("fixture node_modules linking", () => {
* from pnpm and was safe; the same fixture started directly
* (`node scripts/run-vitest.ts run <file>`) was not.
*/
describe("pnpm inside a linked fixture (F-4)", () => {
describe("pnpm inside a linked fixture (F-4)", { timeout: childProcessTimeout(94) }, () => {
const scratch: string[] = [];
afterEach(async () => {
await Promise.all(
+4 -3
View File
@@ -16,6 +16,7 @@ import {
servedEntryScript,
} from "../../scripts/lib/hosting-probe.ts";
import { SERVICE_WORKER_SCRIPT_PATH } from "../../src/contracts/service-worker.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
describe("public service worker in dist", () => {
const app = ["index.html", "config.json", "assets/index-abc.js"];
@@ -563,7 +564,7 @@ describe("verify-hosting-headers on a promoted release root (1101/13-01)", () =>
const result = await verify({ ...DIST, "assets/index-A1.js.map": "{}" });
expect(result.failed, result.stderr).toEqual(["sourceMap public"]);
expect(result.status).toBe(1);
});
}, childProcessTimeout(1_931));
it("ends UNVERIFIED without probing the host when the deployment slot is empty", async () => {
const result = await verify(DIST, {
@@ -574,7 +575,7 @@ describe("verify-hosting-headers on a promoted release root (1101/13-01)", () =>
expect(result.mode).toBe("fixture");
expect(result.status).toBe(3);
expect(result.stderr).toContain("deployment slot");
});
}, childProcessTimeout(984));
// 1103/13-02. The bundle budget counts gzip bytes; an uncompressed entry
// script means about three times as many bytes on the wire.
@@ -595,5 +596,5 @@ describe("verify-hosting-headers on a promoted release root (1101/13-01)", () =>
});
expect(result.failed, result.stderr).toEqual(["hashedAsset content-encoding"]);
expect(result.status).toBe(1);
});
}, childProcessTimeout(763));
});
+2 -1
View File
@@ -22,6 +22,7 @@ import {
type HttpScenarioAssertionGroups,
type HttpScenarioExpectation,
} from "../../scripts/lib/http-scenario-evidence.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
type MutableReceipt = {
schemaVersion: number;
@@ -356,5 +357,5 @@ describe("HTTP scenario evidence receipt schema", () => {
expect(result.error).toBeUndefined();
expect(result.status).toBe(1);
expect(`${result.stdout}\n${result.stderr}`).toContain(fixture.diagnostic);
});
}, childProcessTimeout(962));
});
@@ -4,6 +4,7 @@ import { tmpdir } from "node:os";
import path from "node:path";
import { afterEach, describe, expect, it } from "vitest";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
/**
* 1105/12-04. Every build, dev server, type check and test run renders
@@ -53,7 +54,7 @@ async function identity(file: string): Promise<string> {
return `${metadata.ino}:${metadata.mtimeNs}`;
}
describe("product feature index writes (1105/12-04)", () => {
describe("product feature index writes (1105/12-04)", { timeout: childProcessTimeout(566) }, () => {
it("leaves an index that has not changed untouched", async () => {
const root = await declarationCopy();
const files = OUTPUTS.map((name) => path.join(root, "src/.generated", name));
+9 -8
View File
@@ -11,6 +11,7 @@ import {
validateBreakingEvidence,
verifyRegistryBaselineApproval,
} from "../../scripts/lib/registry-compatibility.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
type RegistryDefinition = Readonly<{
registryId: string;
@@ -172,7 +173,7 @@ describe("registry governance manifest", () => {
} finally {
await rm(directory, { recursive: true, force: true });
}
});
}, childProcessTimeout(907));
it("requires explicit evidence for post-baseline graph and version drift", async () => {
const directory = await mkdtemp(
@@ -302,7 +303,7 @@ describe("registry governance manifest", () => {
} finally {
await rm(directory, { recursive: true, force: true });
}
});
}, childProcessTimeout(1_150));
it("pins the full invalidation graph and versions in the approved repository baseline", async () => {
const baseline = JSON.parse(
@@ -421,7 +422,7 @@ describe("registry governance manifest", () => {
} finally {
await rm(directory, { recursive: true, force: true });
}
});
}, childProcessTimeout(288));
it("rejects duplicate composite invalidation edges after projection", async () => {
const directory = await mkdtemp(
@@ -454,7 +455,7 @@ describe("registry governance manifest", () => {
} finally {
await rm(directory, { recursive: true, force: true });
}
});
}, childProcessTimeout(1_113));
// 0929/07-03. loadingSurface is a name, checked for its form, not a list.
it("rejects a route loading surface that is not a kebab-case name", async () => {
@@ -485,7 +486,7 @@ describe("registry governance manifest", () => {
} finally {
await rm(directory, { recursive: true, force: true });
}
});
}, childProcessTimeout(1_424));
it("names the load error of a registry source that exists but fails to import", async () => {
const directory = await mkdtemp(path.join(tmpdir(), "registry-source-error-"));
@@ -537,7 +538,7 @@ describe("registry governance manifest", () => {
} finally {
await rm(directory, { recursive: true, force: true });
}
});
}, childProcessTimeout(871));
// 1103/14-06. A contract contribution that fails to compose throws while
// the registry source loads. The gate names the cause the error carries in
@@ -648,7 +649,7 @@ describe("registry governance manifest", () => {
} finally {
await rm(directory, { recursive: true, force: true });
}
});
}, childProcessTimeout(2_222));
// 1105/09-03. The real composition error already ends its message with the
// reason (1103/09-07). The gate prints that cause once, not again in
@@ -709,5 +710,5 @@ describe("registry governance manifest", () => {
} finally {
await rm(directory, { recursive: true, force: true });
}
});
}, childProcessTimeout(1_065));
});
+7 -6
View File
@@ -13,6 +13,7 @@ import {
selectRepositoryPaths,
} from "../../scripts/lib/repository-layout.ts";
import { REMOVAL_FIXTURE_DOCUMENT_TESTS } from "../../scripts/lib/removal-fixture.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
/**
* The repository layout rules of docs/manual/03-outside-feature-folder.md
@@ -46,14 +47,14 @@ describe("repository layout registry (R1)", () => {
[...roots].filter((root) => !rootItemNames.has(root)).sort(),
`add an entry with its role to ${REPOSITORY_LAYOUT_FILE}`,
).toEqual([]);
});
}, childProcessTimeout(31));
it("lists untracked items that have no tracked file", () => {
const tracked = new Set(trackedFiles().map((file) => file.split("/")[0]!));
const untracked = REPOSITORY_LAYOUT.filter(({ kind }) => kind === "untracked");
expect(untracked.length).toBeGreaterThan(0);
expect(untracked.filter(({ path: item }) => tracked.has(item)).map(({ path: item }) => item)).toEqual([]);
});
}, childProcessTimeout(20));
it("rejects an entry that is not a root item, a duplicate and a path outside its item", () => {
const entry = { path: "src", kind: "source", role: "app", readBy: "build" };
@@ -164,7 +165,7 @@ describe("root path lists (R2)", () => {
),
"MADE_UP_REPOSITORY_LISTS entries that match no list any more",
).toEqual([]);
});
}, childProcessTimeout(177));
it("finds a literal root list, also after -- in an argument vector, and nothing else", () => {
const tracked = new Set(["alpha", "beta"]);
@@ -203,7 +204,7 @@ describe("root path lists (R2)", () => {
unreadBy(readers.filter(({ file }) => !documentTests.has(file))),
"sets only REMOVAL_FIXTURE_DOCUMENT_TESTS select (DOCUMENT_TEST_SETS)",
).toEqual(DOCUMENT_TEST_SETS);
});
}, childProcessTimeout(310));
// A removal fixture deletes some of these inputs on purpose — removing the
// browser file/storage capability takes the whole browser-capability harness
@@ -231,7 +232,7 @@ describe("infrastructure configuration (R7)", () => {
.filter((file) => /\.ya?ml$/u.test(file) && existsSync(file))
.filter((file) => KUBERNETES_MANIFEST.test(readFileSync(file, "utf8")));
expect([...files.filter((file) => INFRASTRUCTURE_FILE.test(file)), ...manifests]).toEqual([]);
});
}, childProcessTimeout(11));
it("recognises the file kinds the rule names", () => {
expect(["deploy/nginx.conf", "infra/main.tf", "chart/Chart.yaml", "kustomization.yml"].filter((file) =>
@@ -273,7 +274,7 @@ function sameOptionTsconfigs(files: readonly string[]): string[] {
);
}
describe("tsconfig files (R9)", () => {
describe("tsconfig files (R9)", { timeout: childProcessTimeout(29) }, () => {
// tests/fixtures/typecheck had 23 one-file tsconfigs with one set of
// options until 2026-11-08; scripts/check-type-fixtures.ts runs them now.
it("differ in lib, types or module resolution, not only in their files", () => {
+2 -1
View File
@@ -23,6 +23,7 @@ import {
parseRiskCoveragePolicy,
type ProductionModuleInventory,
} from "../../scripts/lib/risk-coverage.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
/**
* This suite's budget, not the file's. The 10s default is sized for pure-JS
@@ -263,7 +264,7 @@ describe("repository-aware risk coverage", () => {
expect(artifact).not.toHaveProperty("instrumentedExecutableTotal");
expect(artifact).not.toHaveProperty("nonExecutableTotal");
expect(artifact).not.toHaveProperty("nonExecutableModules");
});
}, childProcessTimeout(2_637));
it("rejects arbitrary coverage paths instead of silently allowing inflation", () => {
const parsedPolicy = parseRiskCoveragePolicy(
@@ -24,6 +24,7 @@ import {
privatePromotionFiles,
syntheticSignedPromotionBundle,
} from "./security-followup-fixture.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
describe("security private promotion staging contracts", () => {
it("forces exact private staging modes in an isolated child with umask 077", async () => {
@@ -69,7 +70,7 @@ describe("security private promotion staging contracts", () => {
} finally {
await rm(root, { recursive: true, force: true });
}
});
}, childProcessTimeout(2_361));
it("rejects a staged file unlinked and recreated after its original write", async () => {
const root = await mkdtemp(path.join(tmpdir(), "promotion-seal-recreate-"));
@@ -23,6 +23,7 @@ import {
ACTIVE_VALUE,
turnOnServiceWorker,
} from "../e2e/support/service-worker-builds.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
/**
* 0929/06-01. Step 6 of `scripts/build-frontend.ts`, the Service Worker Vite
@@ -107,7 +108,7 @@ describe("Service Worker build output (0929/06-01, 0929/06-02)", () => {
// recover a client without a page. Served from an edge that caches root `.js`
// for long, they stay out of reach for that TTL, so a build that ships a
// worker has its script's Cache-Control checked like the page's.
describe("worker script hosting headers (0929/06-05)", () => {
describe("worker script hosting headers (0929/06-05)", { timeout: childProcessTimeout(934) }, () => {
async function verifyHosting(workerCacheControl: string) {
const root = builds!.root;
await rm(path.join(root, "dist"), { recursive: true, force: true });
+2 -1
View File
@@ -1,6 +1,7 @@
import { spawnSync } from "node:child_process";
import { describe, expect, it } from "vitest";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
/**
* 0929/14-01. `artifacts/` is run output, but screenshots and a coverage
@@ -26,7 +27,7 @@ function trackedArtifacts(): string[] {
return listed.stdout.split("\0").filter((file) => file !== "");
}
describe("tracked artifacts", () => {
describe("tracked artifacts", { timeout: childProcessTimeout(20) }, () => {
it("are only the folder markers", () => {
expect(
trackedArtifacts().filter((file) => !ALLOWED.some((pattern) => pattern.test(file))),
@@ -15,6 +15,7 @@ import {
assertV8CoverageCounterSemantics,
checkV8CoverageCounterSemantics,
} from "../../scripts/lib/v8-coverage-counter-semantics.ts";
import { childProcessTimeout } from "../helpers/child-process-timeout.ts";
const roots: string[] = [];
const execFileAsync = promisify(execFile);
@@ -210,5 +211,5 @@ describe("V8 coverage counter semantics", () => {
);
expect(JSON.parse(await readFile(outputPath, "utf8"))).toEqual([]);
});
}, childProcessTimeout(1_104));
});