7acbdc71b8
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).
81 lines
3.6 KiB
JavaScript
81 lines
3.6 KiB
JavaScript
'use strict';
|
||
/**
|
||
* Drift-guard: NON_CLAUDE_RUNTIMES must always be derived from the capability
|
||
* registry. Verifies:
|
||
* 1. The exported constant equals a hardcoded golden expected list — a pinned
|
||
* oracle that catches BOTH formula bugs (derived value diverges from golden)
|
||
* AND unintended registry drift (adding/removing a runtime forces a
|
||
* deliberate golden-list update).
|
||
* 2. Every registry entry with role === 'runtime' and id !== 'claude' appears
|
||
* in NON_CLAUDE_RUNTIMES — a cross-check from a different angle than the
|
||
* production derivation formula.
|
||
* 3. Every member of NON_CLAUDE_RUNTIMES has an explicit getDirName branch that
|
||
* does not return '.claude' — guards against adding a runtime to the registry
|
||
* without teaching getDirName about it (ADR-1239 Phase B, #1679).
|
||
*
|
||
* Behavioral tests only: assert on returned values, no source-grep.
|
||
*/
|
||
|
||
const { test } = require('node:test');
|
||
const assert = require('node:assert/strict');
|
||
const conversion = require('../gsd-core/bin/lib/runtime-artifact-conversion.cjs');
|
||
const registry = require('../gsd-core/bin/lib/capability-registry.cjs');
|
||
const runtimeNamePolicy = require('../gsd-core/bin/lib/runtime-name-policy.cjs');
|
||
|
||
const { NON_CLAUDE_RUNTIMES } = conversion;
|
||
const { getDirName } = runtimeNamePolicy;
|
||
|
||
// Golden oracle: hardcoded sorted known-good list of all non-Claude runtimes.
|
||
// A pinned expected value in a TEST is correct — the test IS the oracle.
|
||
// EXPECTED is DERIVED from the capability registry (the single source of truth)
|
||
// so this guard stays fluid when a runtime is added or removed. The contract
|
||
// being pinned is the DERIVATION (NON_CLAUDE_RUNTIMES === registry runtimes −
|
||
// claude), not a frozen per-runtime snapshot.
|
||
const EXPECTED = Object.keys(registry.runtimes)
|
||
.filter((id) => id !== 'claude')
|
||
.sort();
|
||
|
||
test('NON_CLAUDE_RUNTIMES matches the golden expected set (sorted)', () => {
|
||
assert.deepEqual(
|
||
[...NON_CLAUDE_RUNTIMES],
|
||
EXPECTED,
|
||
`NON_CLAUDE_RUNTIMES diverged from golden list.\n` +
|
||
` actual: [${[...NON_CLAUDE_RUNTIMES].join(', ')}]\n` +
|
||
` expected: [${EXPECTED.join(', ')}]`,
|
||
);
|
||
// Explicit readability assertion: 'claude' must never appear.
|
||
assert.ok(
|
||
!NON_CLAUDE_RUNTIMES.includes('claude'),
|
||
'NON_CLAUDE_RUNTIMES must not contain "claude"',
|
||
);
|
||
});
|
||
|
||
test('every registry-declared runtime except claude is present in NON_CLAUDE_RUNTIMES', () => {
|
||
// Cross-check from a DIFFERENT angle than the production derivation formula:
|
||
// iterate registry entries by their role field rather than by Object.keys().filter().
|
||
// This catches a case where a runtime is added to the registry with role==='runtime'
|
||
// but is somehow excluded from NON_CLAUDE_RUNTIMES by a formula bug.
|
||
for (const [id, entry] of Object.entries(registry.runtimes)) {
|
||
if (entry.role === 'runtime' && id !== 'claude') {
|
||
assert.ok(
|
||
NON_CLAUDE_RUNTIMES.includes(id),
|
||
`Registry declares runtime '${id}' (role==='runtime') but it is missing from NON_CLAUDE_RUNTIMES`,
|
||
);
|
||
}
|
||
}
|
||
});
|
||
|
||
// Forward direction (registry → getDirName coverage) is the load-bearing guard:
|
||
// the registry is the authoritative runtime source, so every member of
|
||
// NON_CLAUDE_RUNTIMES must have an explicit getDirName branch.
|
||
test('DRIFT GUARD: every registry-declared non-Claude runtime has an explicit getDirName branch (not .claude)', () => {
|
||
for (const rt of NON_CLAUDE_RUNTIMES) {
|
||
const dir = getDirName(rt);
|
||
assert.notEqual(
|
||
dir,
|
||
'.claude',
|
||
`getDirName('${rt}') returned '.claude' — runtime '${rt}' is in the registry but missing an explicit getDirName branch`,
|
||
);
|
||
}
|
||
});
|