@opengsd/gsd-core 1.3.1 → 1.4.0-rc.1

package/scripts/lint-legacy-dir-name.cjs

@@ -33,6 +33,7 @@
 const { execFileSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const { ExitError, runMain } = require('./lib/cli-exit.cjs');
 
 // Constructed with split to avoid self-match when this script is scanned.
 const FORBIDDEN = 'get-shit' + '-done';
@@ -90,67 +91,70 @@ function isBinary(fullPath) {
   }
 }
 
-// Enumerate tracked files via git ls-files so only committed/staged source is checked.
-let trackedFiles;
-try {
-  trackedFiles = execFileSync('git', ['ls-files'], { cwd: REPO_ROOT, encoding: 'utf8' })
-    .split('\n')
-    .map((f) => f.trim())
-    .filter(Boolean);
-} catch (err) {
-  process.stderr.write('ERROR lint-legacy-dir-name: git ls-files failed: ' + err.message + '\n');
-  process.exit(1);
-}
+function main() {
+  // Enumerate tracked files via git ls-files so only committed/staged source is checked.
+  let trackedFiles;
+  try {
+    trackedFiles = execFileSync('git', ['ls-files'], { cwd: REPO_ROOT, encoding: 'utf8' })
+      .split('\n')
+      .map((f) => f.trim())
+      .filter(Boolean);
+  } catch (err) {
+    throw new ExitError(1, 'ERROR lint-legacy-dir-name: git ls-files failed: ' + err.message);
+  }
 
-const violations = [];
+  const violations = [];
 
-for (const relPath of trackedFiles) {
-  if (isAllowlisted(relPath)) continue;
+  for (const relPath of trackedFiles) {
+    if (isAllowlisted(relPath)) continue;
 
-  const fullPath = path.join(REPO_ROOT, relPath);
+    const fullPath = path.join(REPO_ROOT, relPath);
 
-  // Skip this guard script itself.
-  if (path.resolve(fullPath) === SELF_PATH) continue;
+    // Skip this guard script itself.
+    if (path.resolve(fullPath) === SELF_PATH) continue;
 
-  if (isBinary(fullPath)) continue;
+    if (isBinary(fullPath)) continue;
 
-  let content;
-  try {
-    content = fs.readFileSync(fullPath, 'utf8');
-  } catch {
-    // Unreadable files (permissions, etc.) — skip silently.
-    continue;
-  }
+    let content;
+    try {
+      content = fs.readFileSync(fullPath, 'utf8');
+    } catch {
+      // Unreadable files (permissions, etc.) — skip silently.
+      continue;
+    }
 
-  const lines = content.split('\n');
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    // Skip lines that carry the explicit allow marker.
-    if (line.includes(ALLOW_MARKER)) continue;
-
-    FORBIDDEN_RE.lastIndex = 0;
-    let match;
-    while ((match = FORBIDDEN_RE.exec(line)) !== null) {
-      violations.push({
-        file: relPath,
-        line: i + 1,
-        col: match.index + 1,
-        text: match[0],
-      });
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      // Skip lines that carry the explicit allow marker.
+      if (line.includes(ALLOW_MARKER)) continue;
+
+      FORBIDDEN_RE.lastIndex = 0;
+      let match;
+      while ((match = FORBIDDEN_RE.exec(line)) !== null) {
+        violations.push({
+          file: relPath,
+          line: i + 1,
+          col: match.index + 1,
+          text: match[0],
+        });
+      }
     }
   }
-}
 
-if (violations.length === 0) {
-  process.stdout.write('ok lint-legacy-dir-name: ' + trackedFiles.length + ' tracked file(s) checked, 0 violations\n');
-  process.exit(0);
-}
+  if (violations.length === 0) {
+    process.stdout.write('ok lint-legacy-dir-name: ' + trackedFiles.length + ' tracked file(s) checked, 0 violations\n');
+    return 0;
+  }
 
-process.stderr.write('\nERROR lint-legacy-dir-name: ' + violations.length + ' violation(s) found\n\n');
-for (const v of violations) {
-  process.stderr.write('  ' + v.file + ':' + v.line + ':' + v.col + ' — ' + JSON.stringify(v.text) + '\n');
+  process.stderr.write('\nERROR lint-legacy-dir-name: ' + violations.length + ' violation(s) found\n\n');
+  for (const v of violations) {
+    process.stderr.write('  ' + v.file + ':' + v.line + ':' + v.col + ' — ' + JSON.stringify(v.text) + '\n');
+  }
+  process.stderr.write('\n');
+  process.stderr.write('Fix: rename to gsd-core, or add `gsd-allow-legacy-name` marker on the line if the\n');
+  process.stderr.write('      use is intentional (migration modules, tests, guard, changeset).\n\n');
+  return 1;
 }
-process.stderr.write('\n');
-process.stderr.write('Fix: rename to gsd-core, or add `gsd-allow-legacy-name` marker on the line if the\n');
-process.stderr.write('      use is intentional (migration modules, tests, guard, changeset).\n\n');
-process.exit(1);
+
+runMain(main);

package/scripts/lint-pr-check-project-dir.cjs

@@ -4,6 +4,8 @@
 const fs = require('fs');
 const path = require('path');
 
+const { runMain } = require('./lib/cli-exit.cjs');
+
 const ROOT = path.join(__dirname, '..');
 
 const DEFAULT_RELATIVE_FILES = [
@@ -84,7 +86,7 @@ function main(argv = process.argv.slice(2)) {
 }
 
 if (require.main === module) {
-  process.exit(main());
+  runMain(main);
 }
 
 module.exports = {

package/scripts/lint-shell-command-projection-drift.cjs

@@ -13,19 +13,9 @@
 
 const fs = require('fs');
 const path = require('path');
+const { ExitError, runMain } = require('./lib/cli-exit.cjs');
 
 const ROOT = path.resolve(__dirname, '..');
-const targetArg = process.argv[2] || path.join(ROOT, 'bin', 'install.js');
-const target = path.resolve(targetArg);
-const rel = path.relative(ROOT, target);
-
-let content;
-try {
-  content = fs.readFileSync(target, 'utf8');
-} catch (error) {
-  process.stderr.write(`lint-shell-command-projection-drift: failed to read ${target}: ${error.message}\n`);
-  process.exit(1);
-}
 
 const forbidden = [
   {
@@ -42,16 +32,31 @@ const forbidden = [
   },
 ];
 
-const matches = forbidden.filter((rule) => rule.pattern.test(content));
-if (matches.length === 0) {
-  process.stdout.write(`ok shell-projection-drift: ${rel}\n`);
-  process.exit(0);
-}
+function main() {
+  const targetArg = process.argv[2] || path.join(ROOT, 'bin', 'install.js');
+  const target = path.resolve(targetArg);
+  const rel = path.relative(ROOT, target);
+
+  let content;
+  try {
+    content = fs.readFileSync(target, 'utf8');
+  } catch (error) {
+    throw new ExitError(1, `lint-shell-command-projection-drift: failed to read ${target}: ${error.message}`);
+  }
 
-process.stderr.write(`ERROR shell-projection-drift: inline serialized shim builders found in ${rel}\n`);
-for (const match of matches) {
-  process.stderr.write(`  - ${match.label}\n`);
+  const matches = forbidden.filter((rule) => rule.pattern.test(content));
+  if (matches.length === 0) {
+    process.stdout.write(`ok shell-projection-drift: ${rel}\n`);
+    return 0;
+  }
+
+  process.stderr.write(`ERROR shell-projection-drift: inline serialized shim builders found in ${rel}\n`);
+  for (const match of matches) {
+    process.stderr.write(`  - ${match.label}\n`);
+  }
+  process.stderr.write('Route shim/wrapper rendering through gsd-core/bin/lib/shell-command-projection.cjs\n');
+  process.stderr.write('Safe subprocess execution via spawnSync/execFileSync is intentionally allowed.\n');
+  return 1;
 }
-process.stderr.write('Route shim/wrapper rendering through gsd-core/bin/lib/shell-command-projection.cjs\n');
-process.stderr.write('Safe subprocess execution via spawnSync/execFileSync is intentionally allowed.\n');
-process.exit(1);
+
+runMain(main);

package/scripts/lint-skill-deps.cjs

@@ -25,6 +25,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const { runMain } = require('./lib/cli-exit.cjs');
 
 const PROFILES_MODULE = path.join(__dirname, '..', 'gsd-core', 'bin', 'lib', 'install-profiles.cjs');
 const { PROFILES, loadSkillsManifest, resolveProfile } = require(PROFILES_MODULE);
@@ -142,39 +143,43 @@ function checkProfileClosure(manifest) {
 // Main
 // ---------------------------------------------------------------------------
 
-const manifest = loadSkillsManifest(commandsDir);
-const allStems = new Set(
-  [...manifest.keys()].filter((k) => !k.startsWith('_calls_agents_'))
-);
+function main() {
+  const manifest = loadSkillsManifest(commandsDir);
+  const allStems = new Set(
+    [...manifest.keys()].filter((k) => !k.startsWith('_calls_agents_'))
+  );
 
-const consistencyViolations = checkFrontmatterBodyConsistency(manifest, allStems);
-const closureViolations = checkProfileClosure(manifest);
+  const consistencyViolations = checkFrontmatterBodyConsistency(manifest, allStems);
+  const closureViolations = checkProfileClosure(manifest);
 
-const totalViolations = consistencyViolations.length + closureViolations.length;
+  const totalViolations = consistencyViolations.length + closureViolations.length;
 
-if (totalViolations === 0) {
-  const checked = manifest.size;
-  process.stdout.write('ok lint-skill-deps: ' + checked + ' skill(s) checked, 0 violations\n');
-  process.exit(0);
-}
+  if (totalViolations === 0) {
+    const checked = manifest.size;
+    process.stdout.write('ok lint-skill-deps: ' + checked + ' skill(s) checked, 0 violations\n');
+    return 0;
+  }
 
-process.stderr.write('\nERROR lint-skill-deps: ' + totalViolations + ' violation(s) found\n\n');
+  process.stderr.write('\nERROR lint-skill-deps: ' + totalViolations + ' violation(s) found\n\n');
 
-if (consistencyViolations.length > 0) {
-  process.stderr.write('Frontmatter to body consistency violations (' + consistencyViolations.length + '):\n\n');
-  for (const v of consistencyViolations) {
-    process.stderr.write('  ' + v.filePath + '\n');
-    process.stderr.write('    ' + v.message + '\n\n');
+  if (consistencyViolations.length > 0) {
+    process.stderr.write('Frontmatter to body consistency violations (' + consistencyViolations.length + '):\n\n');
+    for (const v of consistencyViolations) {
+      process.stderr.write('  ' + v.filePath + '\n');
+      process.stderr.write('    ' + v.message + '\n\n');
+    }
+    process.stderr.write('Fix: add missing deps to requires: in the skill frontmatter.\n\n');
   }
-  process.stderr.write('Fix: add missing deps to requires: in the skill frontmatter.\n\n');
-}
 
-if (closureViolations.length > 0) {
-  process.stderr.write('Profile closure violations (' + closureViolations.length + '):\n\n');
-  for (const v of closureViolations) {
-    process.stderr.write('  ' + v.message + '\n');
+  if (closureViolations.length > 0) {
+    process.stderr.write('Profile closure violations (' + closureViolations.length + '):\n\n');
+    for (const v of closureViolations) {
+      process.stderr.write('  ' + v.message + '\n');
+    }
+    process.stderr.write('\nFix: add the missing skills to the profile base set in install-profiles.cjs.\n\n');
   }
-  process.stderr.write('\nFix: add the missing skills to the profile base set in install-profiles.cjs.\n\n');
+
+  return 1;
 }
 
-process.exit(1);
+runMain(main);

package/scripts/lint-test-file-count.allowlist.json

@@ -43,6 +43,7 @@
     },
     "milestone": {
       "files": [
+        "bug-730-milestone-phase-details-scope.test.cjs",
         "milestone-archive.test.cjs",
         "milestone-helper.test.cjs",
         "milestone-prefixed-convention.test.cjs",

package/scripts/lint-test-file-count.cjs

@@ -17,6 +17,7 @@
 const fs   = require('fs');
 const path = require('path');
 const { assertWithinAllowlist } = require('./lib/allowlist-ratchet.cjs');
+const { runMain } = require('./lib/cli-exit.cjs');
 
 const ROOT = path.join(__dirname, '..');
 const PROD_DIRS = [
@@ -201,14 +202,14 @@ function run() {
 
   if (jsonMode) {
     console.log(JSON.stringify({ ok: failures.length === 0, results, failures, hints: [] }, null, 2));
-    process.exit(failures.length > 0 ? 1 : 0);
+    return failures.length > 0 ? 1 : 0;
   }
 
   if (failures.length === 0) {
     const inAllowlist = results.filter(r => r.verdict === Verdict.OK_IN_ALLOWLIST).length;
     console.log(`ok lint-test-file-count: ${results.length} module(s) checked, 0 failures` +
       (inAllowlist > 0 ? `, ${inAllowlist} allowlisted` : ''));
-    process.exit(0);
+    return 0;
   }
 
   process.stderr.write(`\nERROR lint-test-file-count: ${failures.length} module(s) exceed the test-file limit\n\n`);
@@ -231,7 +232,7 @@ function run() {
   }
   process.stderr.write('\nFix: consolidate test files per module (one primary + one integration).\n');
   process.stderr.write('Or update scripts/lint-test-file-count.allowlist.json with PR justification.\n\n');
-  process.exit(1);
+  return 1;
 }
 
 module.exports = {
@@ -242,4 +243,4 @@ module.exports = {
   _loadAllowlist: loadAllowlist,
 };
 
-if (require.main === module) run();
+if (require.main === module) runMain(run);

package/scripts/mutation-matrix.cjs

@@ -32,6 +32,8 @@
 const { execFileSync } = require('child_process');
 const { readFileSync } = require('fs');
 
+const { ExitError, runMain } = require('./lib/cli-exit.cjs');
+
 // ── Single source of truth: covered modules ───────────────────────────────────
 // Each entry: { cjs: '<built artifact>', tests: ['tests/...', ...] }
 // A module is "covered" iff its tests are wired into the Stryker command runner
@@ -121,7 +123,7 @@ function parseArgs(argv) {
         '  --base <ref>   Git ref to diff against (default: origin/${GITHUB_BASE_REF:-next})',
         '  --print        Human-readable output instead of JSON',
       ].join('\n'));
-      process.exit(0);
+      throw new ExitError(0);
     } else {
       throw new Error(`unknown argument: ${arg}`);
     }
@@ -211,9 +213,10 @@ function main() {
       console.log(JSON.stringify(result, null, 2));
     }
   } catch (err) {
+    if (err instanceof ExitError) throw err;
     console.error(`mutation-matrix: ${err.message}`);
-    process.exit(2);
+    throw new ExitError(2);
   }
 }
 
-main();
+runMain(main);

package/scripts/prompt-injection-scan.sh

@@ -83,7 +83,7 @@ ALLOWLIST=(
   # These files contain intentional injection examples / security-model prose
   # and are not attack vectors — they explain/demonstrate injection patterns.
   'TEST-EXAMPLES.md'
-  'docs/explanation/security-model.md'
+  'explanation/security-model.md'
 )
 
 is_allowlisted() {

package/scripts/release-notes/format-github-release-notes.cjs

@@ -4,6 +4,7 @@ const path = require('path');
 const os = require('os');
 const fs = require('fs');
 const { execFileSync } = require('child_process');
+const { runMain, ExitError } = require('../lib/cli-exit.cjs');
 
 /**
  * Classify a What's-Changed bullet line into 'Feature', 'Fix', or 'Enhancement'.
@@ -155,7 +156,7 @@ function formatReleaseNotes({ generatedBody, version, prerelease, packageName })
 }
 
 // CLI entry point
-if (require.main === module) {
+function main() {
   try {
     const argv = process.argv.slice(2);
 
@@ -248,9 +249,13 @@ if (require.main === module) {
       process.stdout.write(formatted + '\n');
     }
   } catch (err) {
-    process.stderr.write((err.message || String(err)) + '\n');
-    process.exit(1);
+    if (err instanceof ExitError) throw err;
+    throw new ExitError(1, err && err.message ? err.message : String(err));
   }
 }
 
+if (require.main === module) {
+  runMain(main);
+}
+
 module.exports = { formatReleaseNotes, classifyTitle };

package/scripts/release-tarball-smoke.cjs

@@ -46,6 +46,7 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 const { PACKAGE_NAME } = require('../gsd-core/bin/lib/package-identity.cjs');
+const { ExitError, runMain } = require('./lib/cli-exit.cjs');
 // 120 s proved too tight on Windows GitHub-hosted runners: cold-cache
 // `npm install -g` with a 1499-file tarball took ~120 s exactly, causing
 // spawnSync to fire SIGTERM and return { status: null, stdout: '', stderr: '' }
@@ -587,23 +588,24 @@ function cliMain() {
         };
         if (isJson) process.stdout.write(JSON.stringify(result) + '\n');
         cleanup(packDir, installPrefix, fixtureDir);
-        process.exit(1);
+        throw new ExitError(1);
       }
     }
   } catch (err) {
+    if (err instanceof ExitError) throw err;
     const result = {
       code: SMOKE.PACK_FAILED,
       details: { error: err.message, stderr: err.stderr },
     };
     if (isJson) process.stdout.write(JSON.stringify(result) + '\n');
     cleanup(packDir, installPrefix, fixtureDir);
-    process.exit(1);
+    throw new ExitError(1);
   }
 
   const result = runSmoke({ tarballPath, installPrefix, expectedVersion, fixtureDir });
   if (isJson) process.stdout.write(JSON.stringify(result) + '\n');
   cleanup(packDir, installPrefix, fixtureDir);
-  process.exit(result.code === SMOKE.OK ? 0 : 1);
+  return result.code === SMOKE.OK ? 0 : 1;
 }
 
 function cleanup(...dirs) {
@@ -623,5 +625,5 @@ function cleanup(...dirs) {
 module.exports = { SMOKE, runSmoke, binInvocation };
 
 if (require.main === module) {
-  cliMain();
+  runMain(cliMain);
 }

package/scripts/research-profiles.cjs

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * research-profiles.cjs — hand-authored profile table for the 7 researcher agents.
+ *
+ * Each profile field is derived verbatim from the agent's current committed state so
+ * that the initial --check in gen-research-agents.cjs is green by construction.
+ *
+ * Fields:
+ *   name             — verbatim frontmatter `name:` value
+ *   description      — verbatim frontmatter `description:` value
+ *   color            — verbatim frontmatter `color:` value
+ *   tools            — verbatim frontmatter `tools:` value (single string, comma-separated)
+ *   requiredIncludes — @~/.claude/gsd-core/references/<file>.md strings the body MUST contain
+ *   requiredSeamCalls — `gsd-tools query <cmd>` strings the body MUST contain
+ *   outputContract   — strings the body MUST contain (output path, return marker, etc.)
+ */
+
+const PROFILES = [
+  {
+    name: 'gsd-project-researcher',
+    description:
+      'Researches domain ecosystem before roadmap creation. Produces files in .planning/research/ consumed during roadmap creation. Spawned by /gsd:new-project or /gsd:new-milestone orchestrators.',
+    color: 'cyan',
+    tools:
+      'Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*, mcp__firecrawl__*, mcp__exa__*, mcp__tavily__*, mcp__ref__*, mcp__jina__*',
+    requiredIncludes: [
+      '@~/.claude/gsd-core/references/research-documentation-lookup.md',
+      '@~/.claude/gsd-core/references/research-philosophy.md',
+      '@~/.claude/gsd-core/references/research-verification-protocol.md',
+    ],
+    requiredSeamCalls: [
+      'gsd-tools query research-plan',
+      'gsd-tools query research-store put',
+      'gsd-tools query classify-confidence',
+    ],
+    outputContract: [
+      '.planning/research/',
+      '## RESEARCH COMPLETE',
+    ],
+  },
+  {
+    name: 'gsd-phase-researcher',
+    description:
+      'Researches how to implement a phase before planning. Produces RESEARCH.md consumed by gsd-planner. Spawned by /gsd:plan-phase orchestrator.',
+    color: 'cyan',
+    tools:
+      'Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*, mcp__firecrawl__*, mcp__exa__*, mcp__tavily__*, mcp__ref__*, mcp__jina__*',
+    requiredIncludes: [
+      '@~/.claude/gsd-core/references/research-documentation-lookup.md',
+      '@~/.claude/gsd-core/references/research-philosophy.md',
+      '@~/.claude/gsd-core/references/research-verification-protocol.md',
+    ],
+    requiredSeamCalls: [
+      'gsd-tools query research-plan',
+      'gsd-tools query research-store put',
+      'gsd-tools query classify-confidence',
+      'gsd-tools query package-legitimacy check',
+    ],
+    outputContract: [
+      '.planning/phases/XX-name/{phase_num}-RESEARCH.md',
+      '## RESEARCH COMPLETE',
+    ],
+  },
+  {
+    name: 'gsd-advisor-researcher',
+    description:
+      'Researches a single gray area decision and returns a structured comparison table with rationale. Spawned by discuss-phase advisor mode.',
+    color: 'cyan',
+    tools: 'Read, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*',
+    requiredIncludes: [
+      '@~/.claude/gsd-core/references/research-documentation-lookup.md',
+    ],
+    requiredSeamCalls: [],
+    outputContract: [
+      '| Option | Pros | Cons | Complexity | Recommendation |',
+      '**Rationale:**',
+    ],
+  },
+  {
+    name: 'gsd-ai-researcher',
+    description:
+      'Researches a chosen AI framework\'s official docs to produce implementation-ready guidance — best practices, syntax, core patterns, and pitfalls distilled for the specific use case. Writes the Framework Quick Reference and Implementation Guidance sections of AI-SPEC.md. Spawned by /gsd:ai-integration-phase orchestrator.',
+    color: '"#34D399"',
+    tools:
+      'Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch, mcp__context7__*',
+    requiredIncludes: [
+      '@~/.claude/gsd-core/references/research-documentation-lookup.md',
+    ],
+    requiredSeamCalls: [],
+    outputContract: [
+      'AI-SPEC.md',
+      'Section 3',
+      'Section 4',
+    ],
+  },
+  {
+    name: 'gsd-domain-researcher',
+    description:
+      'Researches the business domain and real-world application context of the AI system being built. Surfaces domain expert evaluation criteria, industry-specific failure modes, regulatory context, and what "good" looks like for practitioners in this field — before the eval-planner turns it into measurable rubrics. Spawned by /gsd:ai-integration-phase orchestrator.',
+    color: '"#A78BFA"',
+    tools:
+      'Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*',
+    requiredIncludes: [
+      '@~/.claude/gsd-core/references/research-documentation-lookup.md',
+    ],
+    requiredSeamCalls: [],
+    outputContract: [
+      'AI-SPEC.md',
+      'Section 1b',
+    ],
+  },
+  {
+    name: 'gsd-ui-researcher',
+    description:
+      'Produces UI-SPEC.md design contract for frontend phases. Reads upstream artifacts, detects design system state, asks only unanswered questions. Spawned by /gsd:ui-phase orchestrator.',
+    color: '"#E879F9"',
+    tools:
+      'Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*, mcp__firecrawl__*, mcp__exa__*, mcp__tavily__*, mcp__ref__*, mcp__jina__*',
+    requiredIncludes: [
+      '@~/.claude/gsd-core/references/research-documentation-lookup.md',
+    ],
+    requiredSeamCalls: [
+      'gsd-tools query commit',
+    ],
+    outputContract: [
+      'UI-SPEC.md',
+      '## UI-SPEC COMPLETE',
+    ],
+  },
+  {
+    name: 'gsd-research-synthesizer',
+    description:
+      'Synthesizes research outputs from parallel researcher agents into SUMMARY.md. Spawned by /gsd:new-project after 4 researcher agents complete.',
+    color: 'purple',
+    tools: 'Read, Write, Bash',
+    requiredIncludes: [],
+    requiredSeamCalls: [
+      'gsd-tools query commit',
+    ],
+    outputContract: [
+      '.planning/research/SUMMARY.md',
+      '## SYNTHESIS COMPLETE',
+    ],
+  },
+];
+
+module.exports = { PROFILES };

package/scripts/run-affected-tests.cjs

@@ -2,5 +2,6 @@
 'use strict';
 
 const { runAffectedTests } = require('./affected-tests-lib.cjs');
+const { runMain } = require('./lib/cli-exit.cjs');
 
-runAffectedTests();
+runMain(runAffectedTests);

package/scripts/run-cross-platform-tests.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 const { spawnSync } = require('child_process');
+const { ExitError, runMain } = require('./lib/cli-exit.cjs');
 
 const CROSS_PLATFORM_TEST_REASON = Object.freeze({
   PASS: 'pass',
@@ -50,14 +51,17 @@ function runCrossPlatformTests(options = {}, deps = {}) {
 }
 
 if (require.main === module) {
-  const result = runCrossPlatformTests();
-  const line = `[cross-platform-tests] reason=${result.reason} exit=${result.exitCode}`;
-  if (result.ok) {
-    process.stdout.write(`${line}\n`);
-    process.exit(0);
+  function main() {
+    const result = runCrossPlatformTests();
+    const line = `[cross-platform-tests] reason=${result.reason} exit=${result.exitCode}`;
+    if (result.ok) {
+      process.stdout.write(`${line}\n`);
+      return 0;
+    }
+    process.stderr.write(`${line}\n`);
+    throw new ExitError(result.exitCode);
   }
-  process.stderr.write(`${line}\n`);
-  process.exit(result.exitCode);
+  runMain(main);
 }
 
 module.exports = { CROSS_PLATFORM_TEST_REASON, runCrossPlatformTests };