@opengsd/gsd-core 1.10.0 → 1.11.0

package/hooks/lib/isolation-deny-reason.js

@@ -0,0 +1,39 @@
+'use strict';
+// hooks/lib/isolation-deny-reason.js — shared, frozen reason-code enum for
+// the #3045 dispatch-isolation guards' block/deny decisions
+// (hooks/gsd-agent-isolation-guard.js, hooks/gsd-cursor-subagent-start.js).
+//
+// CONTRIBUTING.md ("Prohibited: Raw Text Matching on Test Outputs") bans
+// asserting on a hook's free-form, human-readable reason/user_message prose
+// — that text is for the operator/model reading the denial and may change
+// wording without notice. Every block/deny decision therefore ALSO carries
+// one of these STABLE codes (surfaced on the hook's stdout JSON as
+// `reason_code`), so tests assert `out.reason_code === REASON_CODE.X`
+// instead of regexing the message (mirrors the REASON enum convention in
+// gsd-core/bin/verify-reapply-patches.cjs).
+//
+// Adding a new code requires updating this enum AND any test that locks the
+// documented set.
+const REASON_CODE = Object.freeze({
+  // The compiled runtime library (gsd-core/bin/lib/*.cjs) is missing and
+  // could not be self-built (ensure-runtime-build.cjs's RuntimeBuildError).
+  RUNTIME_BUILD_FAILED: 'runtime_build_failed',
+  // The project's dispatch-isolation configuration ('.planning/config.json')
+  // could not be read or resolved for a reason OTHER than a runtime-build
+  // failure (unreadable/malformed config, unexpected resolver error).
+  CONFIG_UNREADABLE: 'config_unreadable',
+  // Isolation resolves to "harness-worktree" but the Agent()/Task() dispatch
+  // is missing the harness's isolation flag/kwarg.
+  HARNESS_FLAG_MISSING: 'harness_flag_missing',
+  // Isolation resolves to "harness-worktree" but the dispatch payload carries
+  // no usable subagent_type, so the guard cannot confirm it is a GSD executor.
+  NO_SUBAGENT_TYPE: 'no_subagent_type',
+  // Isolation resolves to "harness-worktree" but whether the workspace root
+  // is an isolated worktree could not be determined (e.g. git unresponsive).
+  CANNOT_DETERMINE_ISOLATION: 'cannot_determine_isolation',
+  // Isolation resolves to "harness-worktree" and the workspace root is
+  // confirmed NOT an isolated worktree.
+  NOT_ISOLATED_WORKTREE: 'not_isolated_worktree',
+});
+
+module.exports = { REASON_CODE };

package/hooks/lib/isolation-sentinel.js

@@ -130,6 +130,15 @@ function resolveSentinelRoot(cwd) {
     if (fs.existsSync(path.join(cwd, '.planning'))) {
       return cwd;
     }
+    // #3582: worktree-safety.cjs / project-root.cjs are tsc build artifacts
+    // (ADR-457), gitignored and absent on a raw plugin-marketplace / git-clone
+    // install that never ran `npm run build:lib`. Self-heal before either
+    // require below; a RuntimeBuildError (or any other failure) falls through
+    // to the existing catch's degrade-to-raw-`cwd` — unchanged behavior, just
+    // now attempted-healed-first rather than silently degrading on the first
+    // cold-tree encounter.
+    const { ensureRuntimeBuild } = require('../../gsd-core/bin/ensure-runtime-build.cjs');
+    ensureRuntimeBuild();
     const { resolveWorktreeRoot } = require('../../gsd-core/bin/lib/worktree-safety.cjs');
     const { root } = resolveWorktreeRoot(cwd);
     const { findProjectRoot } = require('../../gsd-core/bin/lib/project-root.cjs');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengsd/gsd-core",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "GSD Core is a meta-prompting, context engineering, and spec-driven development system for AI coding agents.",
   "main": ".opencode/plugins/gsd-core.js",
   "bin": {
@@ -23,6 +23,12 @@
     "scripts",
     "!scripts/gen-emitted-baseline.cjs",
     "!scripts/qa-smell-ratchet.cjs",
+    "!scripts/live-config-guard.cjs",
+    "!scripts/run-tests.cjs",
+    "!scripts/affected-tests-lib.cjs",
+    "!scripts/run-affected-tests.cjs",
+    "!scripts/lint-no-adhoc-regex-escape.cjs",
+    "!scripts/lint-allow-test-rule-refs.cjs",
     "pi",
     "vscode"
   ],
@@ -50,7 +56,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=22.0.0",
+    "node": ">=24.0.0",
     "npm": ">=10.0.0"
   },
   "dependencies": {
@@ -65,9 +71,11 @@
     "eslint": "^9.39.4",
     "eslint-plugin-n": "^17.24.0",
     "eslint-plugin-no-only-tests": "^3.4.0",
+    "espree": "^10.4.0",
     "fast-check": "^4.8.0",
     "globals": "^16.5.0",
-    "js-yaml": "^4.2.1",
+    "js-yaml": "^4.3.1",
+    "re2js": "^2.8.6",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.60.0"
   },
@@ -81,6 +89,7 @@
   },
   "scripts": {
     "sync:launcher": "node scripts/sync-runtime-launcher.cjs",
+    "check:contract-drift": "node scripts/check-contract-drift.cjs",
     "check:env": "node scripts/check-env.cjs",
     "check:alias-drift": "node scripts/check-alias-drift.cjs",
     "check:identity-drift": "node scripts/lint-package-identity-drift.cjs",
@@ -105,10 +114,12 @@
     "prepublishOnly": "npm run build:lib && npm run build:hooks",
     "pretest": "npm run build:lib && npm run lint:skill-deps",
     "pretest:coverage": "npm run build:lib && npm run lint:skill-deps",
-    "lint": "eslint . --cache --cache-location node_modules/.cache/eslint/",
+    "lint": "eslint . --cache --cache-location node_modules/.cache/eslint/ --max-warnings 0",
     "lint:fix": "eslint . --fix",
     "lint:table-schema-drift": "node scripts/lint-table-schema-drift.cjs",
-    "lint:ci": "npm run lint && npm run lint:skill-deps && npm run lint:generated-sync && node scripts/lint-test-file-count.cjs && node scripts/lint-command-contract.cjs && node scripts/lint-pr-check-project-dir.cjs && npm run lint:legacy-name && node scripts/lint-regression-test-names.cjs && node scripts/lint-allow-test-rule-refs.cjs && node scripts/lint-resolution-provenance.cjs && node scripts/lint-emitted-drift-ack.cjs && node scripts/lint-portable-timeout.cjs && node scripts/validate-registry.cjs && node scripts/lint-table-schema-drift.cjs && node scripts/lint-fix-has-regression-test.cjs && node scripts/lint-example-parser-parity.cjs && node scripts/lint-docs-command-form.cjs",
+    "lint:frontmatter-scalar-broad-grep": "node scripts/lint-frontmatter-scalar-broad-grep.cjs",
+    "lint:removed-but-needed": "node scripts/lint-removed-but-needed.cjs",
+    "lint:ci": "npm run lint && npm run lint:skill-deps && npm run lint:generated-sync && node scripts/lint-test-file-count.cjs && node scripts/lint-command-contract.cjs && node scripts/lint-pr-check-project-dir.cjs && npm run lint:legacy-name && node scripts/lint-regression-test-names.cjs && node scripts/lint-allow-test-rule-refs.cjs && node scripts/lint-resolution-provenance.cjs && node scripts/lint-emitted-drift-ack.cjs && node scripts/lint-portable-timeout.cjs && node scripts/validate-registry.cjs && node scripts/lint-table-schema-drift.cjs && node scripts/lint-fix-has-regression-test.cjs && node scripts/lint-example-parser-parity.cjs && node scripts/lint-docs-command-form.cjs && node scripts/lint-plan-count-drift.cjs && node scripts/lint-milestone-window-drift.cjs && node scripts/lint-phase-enumeration-drift.cjs && node scripts/lint-planning-prompt-drift.cjs && node scripts/lint-unreachable-guard-drift.cjs && node scripts/lint-completion-ratio-drift.cjs && node scripts/lint-state-field-drift.cjs && node scripts/lint-state-write-path-drift.cjs && node scripts/lint-completion-predicate-drift.cjs && node scripts/lint-planning-snapshot-bypass-drift.cjs && node scripts/lint-health-diagnostic-rule-table.cjs && node scripts/lint-planning-artifact-writer-drift.cjs && node scripts/lint-frontmatter-scalar-broad-grep.cjs && node scripts/lint-removed-but-needed.cjs && node scripts/lint-no-adhoc-regex-escape.cjs && node scripts/lint-vendored-deps.cjs && npm run lint:hooks-runtime-build-seam && node scripts/check-contract-drift.cjs",
     "lint:allow-test-rule-refs": "node scripts/lint-allow-test-rule-refs.cjs",
     "lint:regression-names": "node scripts/lint-regression-test-names.cjs",
     "lint:descriptions": "node scripts/lint-descriptions.cjs",
@@ -116,11 +127,12 @@
     "lint:test-file-count": "node scripts/lint-test-file-count.cjs",
     "lint:pr-checks": "node scripts/lint-pr-check-project-dir.cjs",
     "lint:changeset": "node scripts/changeset/lint.cjs",
-    "lint:generated-sync": "node scripts/gen-capability-registry.cjs --check && node scripts/gen-loop-host-contract.cjs --check && node scripts/gen-capability-matrix.cjs --check && node scripts/sync-manifest-versions.cjs --check && node scripts/gen-inventory-manifest.cjs --check && node scripts/generate-package-identity.cjs --check && node scripts/gen-plugin-skills.cjs --check && node scripts/gen-registry.cjs --check && node scripts/gen-adr-index.cjs --check && node scripts/check-glossary-refs.cjs --check && node scripts/lint-compiled-artifact-sync.cjs --check && node scripts/gen-context-index.cjs --check && node scripts/gen-section-manifest.cjs --check",
+    "lint:generated-sync": "node scripts/gen-capability-registry.cjs --check && node scripts/gen-loop-host-contract.cjs --check && node scripts/gen-capability-matrix.cjs --check && node scripts/sync-manifest-versions.cjs --check && node scripts/gen-inventory-manifest.cjs --check && node scripts/generate-package-identity.cjs --check && node scripts/gen-plugin-skills.cjs --check && node scripts/gen-registry.cjs --check && node scripts/gen-adr-index.cjs --check && node scripts/check-glossary-refs.cjs --check && node scripts/lint-compiled-artifact-sync.cjs --check && node scripts/gen-context-index.cjs --check && node scripts/gen-section-manifest.cjs --check && node scripts/gen-health-docs.cjs --check",
     "lint:docs": "node scripts/lint-docs-required.cjs",
     "lint:qa-smells": "node scripts/qa-smell-ratchet.cjs",
     "lint:legacy-name": "node scripts/lint-legacy-dir-name.cjs",
     "lint:docs-command-form": "node scripts/lint-docs-command-form.cjs",
+    "lint:hooks-runtime-build-seam": "node scripts/lint-hooks-runtime-build-seam.cjs",
     "ci:test-scope": "node scripts/ci-test-scope.cjs",
     "changeset": "node scripts/changeset/new.cjs",
     "changelog:render": "node scripts/changeset/cli.cjs render",
@@ -132,11 +144,11 @@
     "test:slow": "node scripts/run-tests.cjs --suite slow",
     "test:qa": "node scripts/run-tests.cjs --suite qa",
     "test:affected": "node scripts/run-affected-tests.cjs",
-    "test:coverage": "c8 --check-coverage --lines 70 --branches 60 --reporter text --include 'gsd-core/bin/lib/*.cjs' --exclude 'tests/**' --all node scripts/run-tests.cjs",
+    "test:coverage": "c8 --check-coverage --lines 70 --branches 60 --reporter text --include 'gsd-core/bin/lib/**/*.cjs' --exclude 'tests/**' --all node scripts/run-tests.cjs",
     "test:coverage:scripts-floor": "c8 check-coverage --lines 55 --include 'scripts/**/*.cjs' --exclude 'tests/**' --all",
-    "test:coverage:unit": "c8 --reporter text --reporter json-summary --include 'gsd-core/bin/lib/*.cjs' --exclude 'tests/**' --all node scripts/run-tests.cjs --suite unit && node scripts/check-coverage-gate.cjs",
+    "test:coverage:unit": "c8 --reporter text --reporter json-summary --include 'gsd-core/bin/lib/**/*.cjs' --exclude 'tests/**' --all node scripts/run-tests.cjs --suite unit && node scripts/check-coverage-gate.cjs",
     "test:coverage:unit:raw": "c8 --reporter none node scripts/run-tests.cjs --suite unit",
-    "test:coverage:report": "c8 report --reporter text --reporter json-summary --include 'gsd-core/bin/lib/*.cjs' --exclude 'tests/**' --all && node scripts/check-coverage-gate.cjs",
+    "test:coverage:report": "c8 report --reporter text --reporter json-summary --include 'gsd-core/bin/lib/**/*.cjs' --exclude 'tests/**' --all && node scripts/check-coverage-gate.cjs",
     "test:coverage:all": "npm run test:coverage",
     "test:mutation": "stryker run",
     "test:mutation:since": "stryker run --incremental --since origin/next"

package/pi/gsd.cjs

@@ -320,21 +320,35 @@ module.exports = function gsdPiExtension(pi) {
     getArgumentCompletions,
     handler: async (args, ctx) => {
       const cwd = (ctx && ctx.cwd) || process.cwd();
+      // #3456: Pi's command dispatcher awaits the handler and DISCARDS its
+      // return value (agent-session.ts: `await command.handler(args, ctx);
+      // return true;`) — #3097's `{ content: [...] }` return was silently
+      // dropped exactly like the pre-#3097 bare string. The ONLY command-
+      // output mechanism Pi consumes is `ctx.ui.notify(message, type)`
+      // (pi docs: extensions.md#piregistercommandname-options), so the output
+      // is pushed as a side effect on both the success and error paths.
+      // Guarded so a host ctx without `ui` degrades silently instead of
+      // crashing the command.
+      const notify = (ctx && ctx.ui && typeof ctx.ui.notify === 'function')
+        ? (message, type) => ctx.ui.notify(message, type)
+        : null;
       const { family, subcommand, args: rest } = parseGsdCommandArgs(args);
       let dispatchGsdCommand;
       try {
         ({ dispatchGsdCommand } = require(path.join(GSD_CORE, 'bin', 'lib', 'shell-command-projection.cjs')));
       } catch (e) {
-        // #2991: return the structured { content } shape Pi's ExtensionAPI
-        // displays, not a bare string (which Pi silently drops).
-        return { content: [{ type: 'text', text: `GSD engine unavailable: ${e && e.message ? e.message : String(e)}` }] };
+        if (notify) {
+          notify(`GSD engine unavailable: ${e && e.message ? e.message : String(e)}`, 'error');
+        }
+        return;
       }
       const result = dispatchGsdCommand({ family, subcommand, args: rest, cwd });
-      // #2991: match gsd_invoke's proven output shape so Pi actually displays it.
       const text = result.ok
         ? result.stdout
         : `GSD error: ${result.stderr || result.stdout || `dispatch failed (exit ${result.code})`}`;
-      return { content: [{ type: 'text', text }] };
+      if (notify) {
+        notify(text, result.ok ? 'info' : 'error');
+      }
     },
   });
 

package/scripts/baselines/planning-prompt-drift-baseline.json

@@ -0,0 +1,4 @@
+{
+  "$comment": "ADR-3180 Decision 4(e) ratchet, owned by Phase 8 (#3218). See scripts/lint-planning-prompt-drift.cjs. SHRINK-ONLY: entries are removed as sites migrate to the gsd-core CLI; new or changed entries fail lint:ci. `count` is the number of byte-identical (file, text) occurrences acknowledged at this site — a run producing fewer fails as a partial migration, more fails as an unacknowledged new copy. Emptied by #3218: all 6 recorded sites (7 occurrences) migrated to `gsd_run query find-phase` — see gsd-core/workflows/{execute-plan,plan-phase,plan-review-convergence,progress}.md.",
+  "entries": []
+}

package/scripts/baselines/planning-snapshot-bypass-baseline.json

@@ -0,0 +1,12 @@
+{
+  "$comment": "ADR-3180 §8.1 rule 2 ratchet, owned by Phase 11 (#3309). See scripts/lint-planning-snapshot-bypass-drift.cjs. SHRINK-ONLY: entries are removed as cmdValidateHealth migrates onto src/planning-snapshot.cts; new or changed entries fail lint:ci. `count` is the number of byte-identical (file, text) occurrences acknowledged at this site — a run producing fewer fails as a partial migration, more fails as an unacknowledged new copy.",
+  "entries": [
+    {
+      "file": "src/verify.cts",
+      "text": "const stateContent = fs.readFileSync(statePath, 'utf-8');",
+      "derivation": "planning-snapshot-bypass",
+      "owner_issue": "#3309",
+      "count": 1
+    }
+  ]
+}

package/scripts/baselines/unreachable-guard-drift-baseline.json

@@ -0,0 +1,4 @@
+{
+  "$comment": "#3409 unreachable-shell-guard ratchet. See scripts/lint-unreachable-guard-drift.cjs. SHRINK-ONLY: entries are removed as sites migrate off the unreachable-arm shape; new or changed entries fail lint:ci. `count` is the number of byte-identical (file, text) occurrences acknowledged at this site — a run producing fewer fails as a partial migration, more fails as an unacknowledged new copy.",
+  "entries": []
+}

package/scripts/changeset/lint.cjs

@@ -22,6 +22,7 @@ const LINT_REASON = Object.freeze({
   OK_NO_USER_FACING_CHANGES: 'ok_no_user_facing_changes',
   FAIL_MISSING_FRAGMENT: 'fail_missing_fragment',
   FAIL_INVALID_FRAGMENT: 'fail_invalid_fragment',
+  FAIL_PR_FIELD_DRIFT: 'fail_pr_field_drift',
 });
 
 const OPT_OUT_LABEL = 'no-changelog';
@@ -35,8 +36,6 @@ const USER_FACING_PREFIXES = [
   'agents/',
   'commands/',
   'hooks/',
-  'sdk/src/',
-  'sdk/prompts/',
 ];
 
 // Exact-match user-facing files. Any direct edit to one of these without a
@@ -53,10 +52,47 @@ function isFragment(file) {
   return /^\.changeset\/[^/]+\.md$/.test(file) && !file.endsWith('/README.md');
 }
 
-function evaluateLint({ changedFiles, labels, fragmentFailures = [] }) {
+/**
+ * DEFECT.CHANGESET-PR-FIELD-DRIFT (#3316, #3325): a fragment's `pr:` field is
+ * a guess (issue number, stacked-PR leftover) that never got backfilled to
+ * the real PR number after `gh api POST /pulls` returned it.
+ *
+ * Pure: given `prEntries` (`[{ file, pr }]`, one entry per successfully
+ * parsed changed fragment — `pr` is always a positive integer, since
+ * `parseFragment` already rejects `pr: 0` / non-numeric values as
+ * `invalid_pr` before a fragment ever reaches this function) and
+ * `realPrNumber` (the PR this run belongs to, or `null` when unknown —
+ * push/non-PR runs), returns every fragment whose `pr` disagrees with
+ * `realPrNumber`. `realPrNumber == null` always yields `[]`: with no PR
+ * event payload to compare against, there is nothing to drift-check.
+ *
+ * `pr === 0` is always silent regardless of `realPrNumber` — CONTRIBUTING.md
+ * documents `pr: 0` as the deliberate placeholder used "during initial
+ * commit" before `gh api POST /pulls` returns the real number, so it is not
+ * yet a drifted value, just an unbackfilled one. (In practice `parseFragment`
+ * already rejects `pr: 0` as `invalid_pr` before a fragment reaches this
+ * function via `main()`'s wiring — this guard documents and locks in the
+ * pure function's own contract independent of that upstream check.)
+ */
+function findPrFieldDrift(prEntries, realPrNumber) {
+  if (realPrNumber == null) return [];
+  const drift = [];
+  for (const { file, pr } of prEntries) {
+    if (pr === 0) continue;
+    if (pr !== realPrNumber) {
+      drift.push({ file, found: pr, expected: realPrNumber });
+    }
+  }
+  return drift;
+}
+
+function evaluateLint({ changedFiles, labels, fragmentFailures = [], prFieldDrift = [] }) {
   if (fragmentFailures.length > 0) {
     return { ok: false, reason: LINT_REASON.FAIL_INVALID_FRAGMENT, failures: fragmentFailures };
   }
+  if (prFieldDrift.length > 0) {
+    return { ok: false, reason: LINT_REASON.FAIL_PR_FIELD_DRIFT, drift: prFieldDrift };
+  }
   if (changedFiles.some(isFragment)) {
     return { ok: true, reason: LINT_REASON.OK_FRAGMENT_PRESENT };
   }
@@ -78,10 +114,18 @@ function main() {
   // GitHub Actions event payload path
   const eventPath = process.env.GITHUB_EVENT_PATH;
   let labels = [];
+  // DEFECT.CHANGESET-PR-FIELD-DRIFT: the real PR number this run belongs to,
+  // read from the same event payload. `null` on a push / non-PR run (no
+  // `pull_request` in the payload, or no payload at all) — the drift check
+  // below is a no-op in that case, it never fails a push run.
+  let realPrNumber = null;
   if (eventPath && fs.existsSync(eventPath)) {
     try {
       const event = JSON.parse(fs.readFileSync(eventPath, 'utf8'));
       labels = (event.pull_request?.labels || []).map((l) => l.name);
+      if (event.pull_request && Number.isInteger(event.pull_request.number)) {
+        realPrNumber = event.pull_request.number;
+      }
     } catch { /* fall through */ }
   }
   // #2988: local fallback must match the repo's integration branch (`next`),
@@ -107,6 +151,7 @@ function main() {
 
   // Validate the content of every changed fragment file.
   const fragmentFailures = [];
+  const prEntries = [];
   for (const file of changedFiles) {
     if (!isFragment(file)) continue;
     // A fragment path in the diff that no longer exists on disk was deleted in
@@ -125,10 +170,13 @@ function main() {
     const result = parseFragment(src);
     if (!result.ok) {
       fragmentFailures.push({ file, reason: result.reason, detail: result.detail });
+      continue;
     }
+    prEntries.push({ file, pr: result.fragment.pr });
   }
 
-  const verdict = evaluateLint({ changedFiles, labels, fragmentFailures });
+  const prFieldDrift = findPrFieldDrift(prEntries, realPrNumber);
+  const verdict = evaluateLint({ changedFiles, labels, fragmentFailures, prFieldDrift });
   if (process.argv.includes('--json')) {
     process.stdout.write(JSON.stringify({ ...verdict, changedFiles, labels }, null, 2) + '\n');
   } else if (verdict.ok) {
@@ -141,6 +189,13 @@ function main() {
       process.stderr.write(`  ${f.file}: ${f.reason}${detail}\n`);
     }
     process.stderr.write(`Fix the fragment(s) above before merging.\n`);
+  } else if (verdict.reason === LINT_REASON.FAIL_PR_FIELD_DRIFT) {
+    process.stderr.write(`\nERROR changeset-lint: ${verdict.reason}\n`);
+    process.stderr.write(`The following .changeset fragment(s) have a stale \`pr:\` field (DEFECT.CHANGESET-PR-FIELD-DRIFT):\n`);
+    for (const d of verdict.drift) {
+      process.stderr.write(`  ${d.file}: pr: ${d.found}, expected pr: ${d.expected}\n`);
+    }
+    process.stderr.write(`Backfill \`pr:\` with this PR's real number (see .changeset/README.md), then push again.\n`);
   } else {
     process.stderr.write(`\nERROR changeset-lint: ${verdict.reason}\n`);
     process.stderr.write(`PR touches user-facing files but does not include a .changeset/*.md fragment.\n`);
@@ -152,4 +207,4 @@ function main() {
 
 if (require.main === module) runMain(main);
 
-module.exports = { evaluateLint, LINT_REASON, OPT_OUT_LABEL, isUserFacing, isFragment, DEFAULT_BASE };
+module.exports = { evaluateLint, LINT_REASON, OPT_OUT_LABEL, isUserFacing, isFragment, DEFAULT_BASE, findPrFieldDrift };

package/scripts/check-alias-drift.cjs

@@ -4,9 +4,10 @@ const fs = require('node:fs');
 const path = require('node:path');
 
 const { ExitError, runMain } = require('./lib/cli-exit.cjs');
+const { FAMILIES, ALIAS_TABLE } = require('./lib/alias-drift-families.cjs');
 
 const ROOT = path.resolve(__dirname, '..');
-const aliasesPath = path.join(ROOT, 'gsd-core', 'bin', 'lib', 'command-aliases.cjs');
+const aliasesPath = path.join(ROOT, 'gsd-core', 'bin', 'lib', `${ALIAS_TABLE}.cjs`);
 
 function fail(message) {
   process.stderr.write(`${message}\n`);
@@ -36,48 +37,11 @@ function main() {
 
   const aliases = require(aliasesPath);
 
-  const families = [
-    {
-      commandAliases: 'STATE_COMMAND_ALIASES',
-      subcommands: 'STATE_SUBCOMMANDS',
-      routerPath: path.join(ROOT, 'gsd-core', 'bin', 'lib', 'state-command-router.cjs'),
-    },
-    {
-      commandAliases: 'VERIFY_COMMAND_ALIASES',
-      subcommands: 'VERIFY_SUBCOMMANDS',
-      routerPath: path.join(ROOT, 'gsd-core', 'bin', 'lib', 'verify-command-router.cjs'),
-    },
-    {
-      commandAliases: 'INIT_COMMAND_ALIASES',
-      subcommands: 'INIT_SUBCOMMANDS',
-      routerPath: path.join(ROOT, 'gsd-core', 'bin', 'lib', 'init-command-router.cjs'),
-    },
-    {
-      commandAliases: 'PHASE_COMMAND_ALIASES',
-      subcommands: 'PHASE_SUBCOMMANDS',
-      routerPath: path.join(ROOT, 'gsd-core', 'bin', 'lib', 'phase-command-router.cjs'),
-    },
-    {
-      commandAliases: 'PHASES_COMMAND_ALIASES',
-      subcommands: 'PHASES_SUBCOMMANDS',
-      routerPath: path.join(ROOT, 'gsd-core', 'bin', 'lib', 'phases-command-router.cjs'),
-    },
-    {
-      commandAliases: 'VALIDATE_COMMAND_ALIASES',
-      subcommands: 'VALIDATE_SUBCOMMANDS',
-      routerPath: path.join(ROOT, 'gsd-core', 'bin', 'lib', 'validate-command-router.cjs'),
-    },
-    {
-      commandAliases: 'ROADMAP_COMMAND_ALIASES',
-      subcommands: 'ROADMAP_SUBCOMMANDS',
-      routerPath: path.join(ROOT, 'gsd-core', 'bin', 'lib', 'roadmap-command-router.cjs'),
-    },
-    {
-      commandAliases: 'EVAL_COMMAND_ALIASES',
-      subcommands: 'EVAL_SUBCOMMANDS',
-      routerPath: path.join(ROOT, 'gsd-core', 'bin', 'lib', 'eval-command-router.cjs'),
-    },
-  ];
+  const families = FAMILIES.map((family) => ({
+    commandAliases: family.commandAliases,
+    subcommands: family.subcommands,
+    routerPath: path.join(ROOT, 'gsd-core', 'bin', 'lib', `${family.router}.cjs`),
+  }));
 
   for (const family of families) {
     const commandAliases = aliases[family.commandAliases];