Files
msd-core/tests/global-config-home-fragment.test.cjs
Tom Boucher 7acbdc71b8 test(#1925): register zcode across installer surfaces + fluidify count pins
Resolve the zcode test cascade exposed by gsd-test:
- model-catalog.json: add zcode runtimeTierDefaults (null tiers, matching the
  other profile-marker-only runtimes) so KNOWN_RUNTIMES stays parity with allRuntimes.
- runtime-name-policy: add zcode to GLOBAL_CONFIG_HOME_FRAGMENTS (~/.zcode) so
  getGlobalConfigHomeFragment stops falling through to the .claude default.
- installer-migration-install: add the zcode fresh-install contract (flat-skills,
  no settings, no package.json — same shape as trae).
- golden-install-parity: capture the zcode fixture via a standalone generator
  script (not node --test — the gate stays gsd-test).
- capability-matrix.md: regenerate so zcode appears as a first-party row.

Fluidify the remaining count-pinned guards so adding a runtime no longer trips a
hand-pinned snapshot: gemini-runtime-removed (flag count derives from the
registry), non-claude-runtimes-registry-derivation (golden list derived from the
registry).
2026-07-06 08:31:52 -04:00

96 lines
4.4 KiB
JavaScript

'use strict';
/**
* Drift-guard + collapse: getGlobalConfigHomeFragment must be the SINGLE source
* of truth for the runtime → global config-home path-fragment mapping used by
* `getConfigDirFromHome` in bin/install.js for hook path.join() codegen.
*
* Collapses the prior branch `if (runtime === 'x') return "'...'"` chain
* (install.js ~514-543) into one table — ADR-1239 Phase B / #1679, AC2 slice 2.
*
* Invariants pinned here:
* 1. Each of the 13 table runtimes returns its exact verbatim source fragment
* (byte-identical to the prior chain — golden install parity asserts the
* generated hook output is unchanged).
* 2. claude + unknown + empty fall back to the default "'.claude'" fragment.
* 3. antigravity is intentionally NOT in the table (handled dynamically by the
* caller via resolveAntigravityGlobalDir).
* 4. Drift guard: every registry runtime EXCEPT {claude, antigravity} has a
* table entry — so adding a runtime forces a deliberate fragment decision
* here (the add-a-host tax this collapse removes).
*
* ADR-1239 Phase B (#1679). Behavioral tests only.
*/
const { test } = require('node:test');
const assert = require('node:assert/strict');
const runtimeNamePolicy = require('../gsd-core/bin/lib/runtime-name-policy.cjs');
const registry = require('../gsd-core/bin/lib/capability-registry.cjs');
const { getGlobalConfigHomeFragment } = runtimeNamePolicy;
// Golden oracle: the exact source-string fragments the prior install.js chain
// emitted, preserved verbatim. These are path.join() arg-source snippets (the
// embedded quotes/commas are intentional — they get spliced into generated hook
// scripts). Pinned here as the test oracle.
const GOLDEN_FRAGMENT_MAP = {
copilot: "'.copilot'",
opencode: "'.config', 'opencode'",
kilo: "'.config', 'kilo'",
codex: "'.codex'",
cursor: "'.cursor'",
windsurf: "'.windsurf'",
augment: "'.augment'",
trae: "'.trae'",
qwen: "'.qwen'",
hermes: "'.hermes'",
codebuddy: "'.codebuddy'",
cline: "'.cline'",
kimi: "'.config', 'agents'",
zcode: "'.zcode'",
};
// Runtimes intentionally NOT in the table: claude is the default; antigravity is
// resolved dynamically by the caller (resolveAntigravityGlobalDir + path.relative).
const SPECIAL_CASED = new Set(['claude', 'antigravity']);
test('getGlobalConfigHomeFragment: golden map matches for all 13 table runtimes', () => {
for (const [id, expected] of Object.entries(GOLDEN_FRAGMENT_MAP)) {
const actual = getGlobalConfigHomeFragment(id);
assert.strictEqual(
actual,
expected,
`getGlobalConfigHomeFragment('${id}') diverged from golden.\n` +
` actual: ${JSON.stringify(actual)}\n` +
` expected: ${JSON.stringify(expected)}`,
);
}
});
test('getGlobalConfigHomeFragment fallback: claude/unknown/empty return the default fragment', () => {
assert.strictEqual(getGlobalConfigHomeFragment('claude'), "'.claude'",
'claude must return the default fragment (it is special-cased as the default)');
assert.strictEqual(getGlobalConfigHomeFragment('unknown'), "'.claude'",
'unknown runtime must return the default fragment');
assert.strictEqual(getGlobalConfigHomeFragment(''), "'.claude'",
'empty input must return the default fragment');
});
test('drift guard: every registry runtime except {claude, antigravity} has a table entry (add-a-host tax removed)', () => {
// A newly-added registry runtime that is NOT claude/antigravity MUST get a
// deliberate fragment entry here — otherwise it silently falls through to the
// '.claude' default. claude (default) and antigravity (caller-dynamic) are the
// only legitimate absences.
const tableIds = new Set(Object.keys(GOLDEN_FRAGMENT_MAP));
const missing = Object.keys(registry.runtimes)
.filter((id) => !SPECIAL_CASED.has(id) && !tableIds.has(id));
assert.deepEqual(missing, [],
`registry runtimes missing a fragment table entry (add one to GOLDEN_FRAGMENT_MAP + the module table, or add to SPECIAL_CASED if caller-dynamic): ${missing.join(', ')}`);
});
test('drift guard: table keys are a subset of the registry (no stale entries)', () => {
const registryIds = new Set(Object.keys(registry.runtimes));
const stale = Object.keys(GOLDEN_FRAGMENT_MAP).filter((id) => !registryIds.has(id));
assert.deepEqual(stale, [],
`fragment table references runtimes not in the registry (stale entries): ${stale.join(', ')}`);
});