The windows-test-parity ratchet greps test source for fs.rmSync-without-
maxRetries (and six other Windows-portability anti-patterns), failing when an
integer offender COUNT exceeds a frozen baseline (rmSync: 95). A count ratchet
is a Goodhart metric: fixing one offender and adding another keeps the count
constant, so a new defect slips through green. Replace it — and every other
count ratchet in the repo — with a layered, masking-proof design.
Behavioral seam test
- tests/helpers-cleanup.test.cjs proves helpers.cleanup() carries the Windows
EBUSY retry budget. cleanup() delegates retries to Node's fs.rmSync via
maxRetries (it owns no loop), so the test asserts the option contract
(recursive/force/maxRetries>0/retryDelay>0) + real-FS removal + the cwd-guard,
rather than a loop that does not exist. The EBUSY risk is now tested ONCE at
the helper, not approximated textually at every call site.
Write-time ESLint rule (AST-accurate, replaces the grep)
- eslint-rules/no-raw-rmsync-in-tests.cjs (error in tests/**/*.test.cjs) bans
raw fs.rmSync, steering to cleanup(). Catches member, computed (fs['rmSync']),
destructured and aliased forms; escape hatch is inline
`// eslint-disable-next-line local/no-raw-rmsync-in-tests -- <reason>` only.
- Migrated 336 raw fs.rmSync teardown calls across ~116 test files to cleanup().
~18 genuinely load-bearing sites (mid-test SUT/fault-injection removals,
error-swallowing or name-colliding local teardown helpers) keep the raw call
with an inline eslint-disable + reason.
Shared anti-ratchet primitive
- scripts/lib/allowlist-ratchet.cjs:
- assertWithinAllowlist: fails on NOVEL ids (new offender introduced) AND on
STALE ids (a known offender was fixed but not pruned) — identity, not count,
and a ratchet DOWN toward zero.
- assertTightCeiling: a size/length budget whose ceiling must stay within a
grace band of the high-water mark, so budgets may only tighten, never creep.
Ratchets converted onto the primitive
- windows-test-parity-guard.test.cjs: rmSync rule deleted (now ESLint-enforced);
the remaining six patterns moved from integer baselines to named-set
allowlists with ratchet-down.
- scripts/lint-test-file-count.{cjs,allowlist.json}: per-module integer counts →
named filename sets (closes the swap-a-file-keep-the-count blind spot); a
module dropping under cap now FAILS to force pruning its allowlist entry.
- enh-2790 skill-count `<= 63` → named skill allowlist (ratchets toward ~58).
Size budgets hardened (tighten-only)
- agent-size / workflow-size / feat-3039 help-tiered: ceilings lowered to the
current high-water mark and an assertTightCeiling anti-creep check added per
tier. Fixed external-contract limits (description ≤100 chars, agent ≤100 KB)
are intentionally left as-is — they are not grandfathered creeping budgets.
No user-facing behavior change (tests + tooling only); no USER_FACING_PREFIXES
touched, so no changeset fragment is required.
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
130 lines
4.2 KiB
JavaScript
130 lines
4.2 KiB
JavaScript
/**
|
|
* Regression test for #3571: configuration.cjs used the source
|
|
* checkout sdk/shared path only, which breaks installed gsd-tools.cjs because
|
|
* runtime installs copy get-shit-done/ but not sdk/.
|
|
*/
|
|
|
|
'use strict';
|
|
|
|
process.env.GSD_TEST_MODE = '1';
|
|
|
|
const { describe, test, beforeEach, afterEach } = require('node:test');
|
|
const assert = require('node:assert/strict');
|
|
const fs = require('node:fs');
|
|
const os = require('node:os');
|
|
const path = require('node:path');
|
|
|
|
const REPO_ROOT = path.join(__dirname, '..');
|
|
const CONFIGURATION_CJS = path.join(REPO_ROOT, 'get-shit-done', 'bin', 'lib', 'configuration.cjs');
|
|
const SHARED_DIR = path.join(REPO_ROOT, 'get-shit-done', 'bin', 'shared');
|
|
|
|
const { install } = require('../bin/install.js');
|
|
|
|
const { createTempDir, cleanup } = require('./helpers.cjs');
|
|
const makeTmpDir = () => createTempDir('gsd-3571-');
|
|
|
|
function silenceConsole(fn) {
|
|
const original = {
|
|
log: console.log,
|
|
warn: console.warn,
|
|
error: console.error,
|
|
};
|
|
console.log = () => {};
|
|
console.warn = () => {};
|
|
console.error = () => {};
|
|
try {
|
|
return fn();
|
|
} finally {
|
|
console.log = original.log;
|
|
console.warn = original.warn;
|
|
console.error = original.error;
|
|
}
|
|
}
|
|
|
|
describe('bug #3571: configuration generated manifests resolve in install layout', () => {
|
|
let tmpRoot;
|
|
let savedHome;
|
|
let savedUserProfile;
|
|
let savedExplicitConfigDir;
|
|
|
|
beforeEach(() => {
|
|
tmpRoot = makeTmpDir();
|
|
savedHome = process.env.HOME;
|
|
// On Windows, os.homedir() reads USERPROFILE; install() resolves via it.
|
|
savedUserProfile = process.env.USERPROFILE;
|
|
savedExplicitConfigDir = process.env.GSD_EXPLICIT_CONFIG_DIR;
|
|
delete process.env.GSD_EXPLICIT_CONFIG_DIR;
|
|
});
|
|
|
|
afterEach(() => {
|
|
process.env.HOME = savedHome;
|
|
if (savedUserProfile === undefined) delete process.env.USERPROFILE;
|
|
else process.env.USERPROFILE = savedUserProfile;
|
|
if (savedExplicitConfigDir === undefined) {
|
|
delete process.env.GSD_EXPLICIT_CONFIG_DIR;
|
|
} else {
|
|
process.env.GSD_EXPLICIT_CONFIG_DIR = savedExplicitConfigDir;
|
|
}
|
|
cleanup(tmpRoot);
|
|
});
|
|
|
|
test('co-located bin/shared manifests let configuration.cjs load without sdk/shared', () => {
|
|
const gsdBinDir = path.join(tmpRoot, '.codex', 'get-shit-done', 'bin');
|
|
const gsdLibDir = path.join(gsdBinDir, 'lib');
|
|
const gsdSharedDir = path.join(gsdBinDir, 'shared');
|
|
fs.mkdirSync(gsdLibDir, { recursive: true });
|
|
fs.mkdirSync(gsdSharedDir, { recursive: true });
|
|
|
|
const installedCjs = path.join(gsdLibDir, 'configuration.cjs');
|
|
fs.copyFileSync(CONFIGURATION_CJS, installedCjs);
|
|
fs.copyFileSync(
|
|
path.join(SHARED_DIR, 'config-defaults.manifest.json'),
|
|
path.join(gsdSharedDir, 'config-defaults.manifest.json')
|
|
);
|
|
fs.copyFileSync(
|
|
path.join(SHARED_DIR, 'config-schema.manifest.json'),
|
|
path.join(gsdSharedDir, 'config-schema.manifest.json')
|
|
);
|
|
|
|
delete require.cache[installedCjs];
|
|
let mod;
|
|
assert.doesNotThrow(() => {
|
|
mod = require(installedCjs);
|
|
}, 'installed configuration.cjs must not require ~/.codex/sdk/shared');
|
|
|
|
assert.ok(mod.VALID_CONFIG_KEYS.has('workflow.plan_review_convergence'));
|
|
});
|
|
|
|
test('post-install: install() copies configuration manifests to co-located bin/shared', () => {
|
|
process.env.HOME = tmpRoot;
|
|
process.env.USERPROFILE = tmpRoot;
|
|
|
|
silenceConsole(() => {
|
|
install(true, 'codex');
|
|
});
|
|
|
|
const sharedDir = path.join(tmpRoot, '.codex', 'get-shit-done', 'bin', 'shared');
|
|
for (const fileName of ['config-defaults.manifest.json', 'config-schema.manifest.json']) {
|
|
const installedManifest = path.join(sharedDir, fileName);
|
|
assert.ok(fs.existsSync(installedManifest), `${fileName} must be copied to ${sharedDir}`);
|
|
assert.doesNotThrow(() => {
|
|
JSON.parse(fs.readFileSync(installedManifest, 'utf8'));
|
|
}, `${fileName} must be valid JSON`);
|
|
}
|
|
|
|
const installedCjs = path.join(
|
|
tmpRoot,
|
|
'.codex',
|
|
'get-shit-done',
|
|
'bin',
|
|
'lib',
|
|
'configuration.cjs'
|
|
);
|
|
|
|
delete require.cache[installedCjs];
|
|
assert.doesNotThrow(() => {
|
|
require(installedCjs);
|
|
}, 'post-install configuration.cjs must load from co-located manifests');
|
|
});
|
|
});
|