* refactor(#455): implement typed surfaces to retire grep tests Production surfaces added: - hooks/managed-hooks-registry.cjs: new CJS module exporting MANAGED_HOOKS as a typed array; gsd-check-update-worker.js now requires it instead of declaring an inline array - bin/install.js: elevate inline gsdHooks to module-level GSD_UNINSTALL_HOOKS, export it alongside runtimeMap/allRuntimes (already exported) - scripts/build-hooks.js: export HOOKS_TO_COPY; guard build() behind require.main===module so tests can require the file without triggering a build - get-shit-done/bin/lib/init.cjs: add --json mode to agent-skills command, emitting typed IR { agent_type, block, skills_count } for test assertions - get-shit-done/bin/gsd-tools.cjs: wire --json flag for agent-skills dispatch Category-B source-grep migrations: - tests/managed-hooks.test.cjs: require MANAGED_HOOKS from registry, drop fs.readFileSync+regex - tests/orphaned-hooks.test.cjs: require MANAGED_HOOKS+HOOKS_TO_COPY as typed exports - tests/hooks-opt-in.test.cjs: replace gsdHooks regex-parse with GSD_UNINSTALL_HOOKS import - tests/install-minimal-hooks.test.cjs: replace gsdHooks regex-parse with GSD_UNINSTALL_HOOKS - tests/copilot-install.test.cjs: replace src.includes() checks with typed assertions on runtimeMap, allRuntimes, parseRuntimeInput, buildRuntimePromptText - tests/agent-skills.test.cjs: migrate to --json typed IR assertions pending-migration-to-typed-ir token cleared (87 of 87 files): - 78 files already had source-text-is-the-product; removed duplicate token - 5 files already used typed assertions; reclassified or annotated - 4 files required individual reclassification to source-text-is-the-product or architectural-invariant Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(#455): update workflow-guard test to typed GSD_UNINSTALL_HOOKS import; isolate HOME in runtime-launcher (D) test Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(#455): guard install.js main() behind require.main===module so the typed export is require-safe Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * docs(#455): document --json typed surfaces for agent-skills, progress, validate context Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * docs(#455): add changeset fragment for new --json surfaces Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(#455): complete grep migration for files flagged by lint-tests The branch commit 4e630d99 stripped `allow-test-rule: pending-migration-to-typed-ir` from ~80 test files without replacing their assertions or adding the correct exemption annotation. The files were NOT source-grep tests — they read .md workflow/agent/command/reference files (source-text-is-the-product) or hook source files for structural invariants (structural-regression-guard). No assertion logic was changed; only the correct allow-test-rule annotation was added to each file per CONTRIBUTING.md exception matrix. 73 files: `source-text-is-the-product` — workflow/agent/command/reference .md 7 files: `structural-regression-guard` — hook .js / bin/install.js structural checks Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: CI Rebase Check <ci@gsd-redux> Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
120 lines
5.3 KiB
JavaScript
120 lines
5.3 KiB
JavaScript
// allow-test-rule: source-text-is-the-product
|
|
// Workflow .md / agent .md / command .md / reference .md files — their text
|
|
// IS what the runtime loads. Testing text content tests the deployed contract.
|
|
// Per CONTRIBUTING.md exception matrix.
|
|
|
|
/**
|
|
* Regression test for bug #2516
|
|
*
|
|
* When `.planning/config.json` has `model_profile: "inherit"`, the
|
|
* `init.execute-phase` query returns `executor_model: "inherit"`. The
|
|
* execute-phase workflow was passing this literal string directly to the
|
|
* Task tool via `model="{executor_model}"`, causing Task to fall back to
|
|
* its default model instead of inheriting the orchestrator model.
|
|
*
|
|
* Fix: the workflow must document that when `executor_model` is `"inherit"`,
|
|
* the `model=` parameter must be OMITTED from Task() calls entirely.
|
|
* Omitting `model=` causes Claude Code to inherit the current orchestrator
|
|
* model automatically.
|
|
*/
|
|
|
|
'use strict';
|
|
|
|
const { test, describe } = require('node:test');
|
|
const assert = require('node:assert/strict');
|
|
const fs = require('fs');
|
|
const path = require('path');
|
|
|
|
const WORKFLOW_PATH = path.join(
|
|
__dirname,
|
|
'..',
|
|
'get-shit-done',
|
|
'workflows',
|
|
'execute-phase.md'
|
|
);
|
|
|
|
describe('bug #2516: executor_model "inherit" must not be passed literally to Task()', () => {
|
|
test('workflow file exists', () => {
|
|
assert.ok(fs.existsSync(WORKFLOW_PATH), 'get-shit-done/workflows/execute-phase.md should exist');
|
|
});
|
|
|
|
test('workflow contains instructions for handling the "inherit" case', () => {
|
|
assert.ok(fs.existsSync(WORKFLOW_PATH), 'get-shit-done/workflows/execute-phase.md should exist');
|
|
const content = fs.readFileSync(WORKFLOW_PATH, 'utf-8');
|
|
const hasInheritInstruction =
|
|
content.includes('"inherit"') &&
|
|
(content.includes('omit') || content.includes('Omit') || content.includes('omitting') || content.includes('Omitting'));
|
|
assert.ok(
|
|
hasInheritInstruction,
|
|
'execute-phase.md must document that when executor_model is "inherit", ' +
|
|
'the model= parameter must be omitted from Task() calls. ' +
|
|
'Found "inherit" mention: ' + content.includes('"inherit"') + '. ' +
|
|
'Found omit mention: ' + (content.includes('omit') || content.includes('Omit'))
|
|
);
|
|
});
|
|
|
|
test('workflow does not instruct passing model="inherit" literally to Task', () => {
|
|
assert.ok(fs.existsSync(WORKFLOW_PATH), 'get-shit-done/workflows/execute-phase.md should exist');
|
|
const content = fs.readFileSync(WORKFLOW_PATH, 'utf-8');
|
|
// The workflow must not have an unconditional model="{executor_model}" template
|
|
// that would pass "inherit" through. It should document conditional logic.
|
|
const hasConditionalModelParam =
|
|
content.includes('inherit') &&
|
|
(
|
|
content.includes('Only set `model=`') ||
|
|
content.includes('only set `model=`') ||
|
|
content.includes('Only set model=') ||
|
|
content.includes('omit the `model=`') ||
|
|
content.includes('omit the model=') ||
|
|
content.includes('omit `model=`') ||
|
|
content.includes('omit model=')
|
|
);
|
|
const lines = content.split('\n');
|
|
const hasLiteralInheritInTask = lines.some(line => {
|
|
if (!/model\s*=\s*["']inherit["']/.test(line)) return false;
|
|
// Exclude instructional/explanatory lines that document what NOT to do
|
|
return !/\b(not|NOT|don'?t|do not|DO NOT|never|NEVER)\b/.test(line);
|
|
});
|
|
assert.ok(
|
|
!hasLiteralInheritInTask,
|
|
'execute-phase workflow must not pass literal "inherit" string to Task() model parameter'
|
|
);
|
|
assert.ok(
|
|
hasConditionalModelParam && !hasLiteralInheritInTask,
|
|
'execute-phase.md must conditionally omit model= when executor_model is "inherit", never pass it literally. ' +
|
|
'The unconditional model="{executor_model}" template would pass the literal ' +
|
|
'string "inherit" to Task(), which falls back to the default model instead ' +
|
|
'of the orchestrator model (root cause of #2516).'
|
|
);
|
|
// Guard against a future contributor adding an unconditional model="{executor_model}"
|
|
// template alongside the conditional docs — that would pass "inherit" literally to Task().
|
|
const hasUnsafeTemplate = lines.some(line => {
|
|
if (!/model\s*=\s*['"]\{executor_model\}['"]/.test(line)) return false;
|
|
return !/\b(not|NOT|do not|DO NOT|don'?t|never|NEVER|omit)\b/i.test(line);
|
|
});
|
|
assert.ok(!hasUnsafeTemplate,
|
|
'execute-phase.md must not contain an unconditional model="{executor_model}" template — ' +
|
|
'it would pass "inherit" literally to Task() when executor_model is "inherit"'
|
|
);
|
|
});
|
|
|
|
test('workflow documents that omitting model= causes inheritance from orchestrator', () => {
|
|
assert.ok(fs.existsSync(WORKFLOW_PATH), 'get-shit-done/workflows/execute-phase.md should exist');
|
|
const content = fs.readFileSync(WORKFLOW_PATH, 'utf-8');
|
|
const hasInheritanceExplanation =
|
|
content.includes('inherit') &&
|
|
(
|
|
content.includes('orchestrator model') ||
|
|
content.includes('orchestrator\'s model') ||
|
|
content.includes('inherits the') ||
|
|
content.includes('inherit the current')
|
|
);
|
|
assert.ok(
|
|
hasInheritanceExplanation,
|
|
'execute-phase.md must explain that omitting model= causes Claude Code to ' +
|
|
'inherit the current orchestrator model — this is the mechanism that makes ' +
|
|
'"inherit" work correctly.'
|
|
);
|
|
});
|
|
});
|