mirror of
https://github.com/garrytan/gstack.git
synced 2026-09-09 14:38:59 +02:00
Garry TanandClaude Fable 5
3e674e4c01
spawnSync/execSync/Bun.spawnSync BLOCK the main thread, so bun's in-process per-test timeout can never fire while one waits — a hung child (stdin read, network probe, dead daemon) wedges the whole shard until the runner's external wall-clock SIGKILL. This exact class reached main: free-tests run 33262077256, test/gstack-memory-ingest.test.ts (normally 2.3s) held shard 2 at the 360s wall while its five siblings finished in ~65s. Mechanical sweep in two waves (12 + 4 fan-out agents, every edit verified against its call site): default timeout: 30_000 (matches the free runner's per-test budget), 120_000 for genuinely slow ops (installs, builds, playwright, provider CLIs), helper wrappers fixed ONCE where call sites route through them. Sites that only LOOK like calls (string fixtures, grep needles, comments) were skipped with reasons — the enforcement commit that follows marks them exempt. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
54 lines
2.2 KiB
TypeScript
54 lines
2.2 KiB
TypeScript
/**
|
|
* No module-scope GSTACK_HOME assignment in any test file.
|
|
*
|
|
* Shard processes evaluate many test-file modules in one bun process, and a
|
|
* module can be loaded before its tests run — so a module-scope
|
|
* `process.env.GSTACK_HOME = ...` leaks into every sibling file in the
|
|
* shard. The damage was real before the 2026-08 sweep: relink.test.ts:28
|
|
* documents a "fresh install" test seeing a neighbor's skill_prefix, and
|
|
* cdp-e2e once baked a sibling's temp dir into artifacts that outlived it
|
|
* (dangling symlinks into a deleted render dir).
|
|
*
|
|
* The pattern is: save the original, assign in beforeAll, restore in
|
|
* afterAll — confining the value to the file's execution window. See
|
|
* browse/test/cdp-e2e.test.ts for the reference shape.
|
|
*
|
|
* Heuristic: repo test files write module-scope statements unindented, so a
|
|
* column-0 assignment is module scope; indented assignments (inside hooks,
|
|
* tests, or helpers) are fine.
|
|
*/
|
|
import { describe, expect, test } from 'bun:test';
|
|
import { spawnSync } from 'node:child_process';
|
|
import * as fs from 'node:fs';
|
|
import * as path from 'node:path';
|
|
|
|
const ROOT = path.resolve(__dirname, '..');
|
|
|
|
function trackedTestFiles(): string[] {
|
|
const out = spawnSync('git', ['ls-files', '*.test.ts'], {
|
|
cwd: ROOT, encoding: 'utf-8', timeout: 30_000,
|
|
});
|
|
if (out.status !== 0) throw new Error(`git ls-files failed: ${out.stderr}`);
|
|
return out.stdout.split('\n').filter(Boolean);
|
|
}
|
|
|
|
describe('GSTACK_HOME module-scope tripwire', () => {
|
|
test('no test file assigns process.env.GSTACK_HOME at module scope', () => {
|
|
const files = trackedTestFiles();
|
|
expect(files.length).toBeGreaterThan(100); // scan-rot guard
|
|
|
|
const offenders: string[] = [];
|
|
for (const rel of files) {
|
|
const lines = fs.readFileSync(path.join(ROOT, rel), 'utf-8').split('\n');
|
|
lines.forEach((line, i) => {
|
|
if (/^(?:process\.env\.GSTACK_HOME|process\.env\.GSTACK_STATE_ROOT)\s*=[^=]/.test(line)) {
|
|
offenders.push(`${rel}:${i + 1} — ${line.trim()}`);
|
|
}
|
|
});
|
|
}
|
|
expect(offenders,
|
|
`module-scope env assignment leaks across shard siblings — move into beforeAll + restore in afterAll:\n${offenders.join('\n')}`,
|
|
).toEqual([]);
|
|
});
|
|
});
|