@opengsd/gsd-core 1.18.0 → 1.19.0

package/scripts/docs-guard-registry.cjs

@@ -55,7 +55,7 @@
  * narrow subset of guards that read it, instead of always running the
  * entire registry. Each value is a non-empty array of PATTERNS:
  *
- *   - a plain path (e.g. `'docs/AGENTS.md'`) matches that exact file only;
+ *   - a plain path (e.g. `'docs/reference/agents.md'`) matches that exact file only;
  *   - a trailing-slash path (e.g. `'docs/adr/'`) matches any changed path
  *     under that directory prefix — use this for a test that walks or
  *     `readdirSync`s a whole docs/ subdirectory;
@@ -157,6 +157,8 @@ function assertNoSuiteCollision(tests) {
  * unresolvable read is recorded as `'*'`, never a narrowed guess.
  */
 const DOCS_GUARD_TESTS = {
+  'tests/pi-unsupported-skill-docs.test.cjs': ['docs/how-to/start-a-gsd-workflow-from-pi.md'],
+  'tests/pi-parity-matrix.test.cjs': ['docs/reference/pi-parity-matrix.md'],
   'tests/adr-15-progress-converge.test.cjs': [
     'docs/COMMANDS.md',
     'docs/how-to/run-phases-autonomously.md',
@@ -168,11 +170,14 @@ const DOCS_GUARD_TESTS = {
   // Walks docs/features/ as a directory (the fragment corpus) and asserts the
   // committed docs/FEATURES.md equals the generated projection of it (#3840).
   'tests/features-index-gate.test.cjs': ['docs/features/', 'docs/FEATURES.md'],
-  'tests/agent-classification-parity.test.cjs': ['docs/AGENTS.md', 'docs/INVENTORY.md'],
+  'tests/agent-classification-parity.test.cjs': ['docs/reference/agents.md', 'docs/INVENTORY.md'],
   // #3683: pins the learnings feature section's agreement with the canonical
   // artifact registry (reads docs/FEATURES.md around the extract-learnings
   // entry).
   'tests/learnings.test.cjs': ['docs/FEATURES.md'],
+  // #5706: pins the release map statuses / tag states in docs/CONFIGURATION.md
+  // against the milestone-release-map module's exported enums.
+  'tests/milestone-release-map.test.cjs': ['docs/CONFIGURATION.md'],
   'tests/analyze-dependencies.test.cjs': ['docs/COMMANDS.md'],
   'tests/auto-select-attribute.test.cjs': ['docs/reference/plan-md.md'],
   'tests/autonomous-converge.test.cjs': [
@@ -199,6 +204,7 @@ const DOCS_GUARD_TESTS = {
   // files without re-deriving the scan's own file-discovery logic.
   'tests/commit-files-pathspec.test.cjs': ['*'],
   'tests/compact-content-4139.test.cjs': ['docs/CONFIGURATION.md'],
+  'tests/complete-milestone-release-map-routing.test.cjs': ['docs/README.md', 'docs/how-to/tag-a-multi-repo-milestone.md'],
   'tests/config-field-docs.test.cjs': ['docs/CONFIGURATION.md'],
   'tests/config.test.cjs': ['docs/CONFIGURATION.md'],
   // #4974: doc/workflow content-parity checks read docs/CONFIGURATION.md's
@@ -245,7 +251,7 @@ const DOCS_GUARD_TESTS = {
     'docs/ko-KR/reference/state-md.md',
     'docs/pt-BR/reference/state-md.md',
   ],
-  'tests/drift-detection.test.cjs': ['docs/CONFIGURATION.md', 'docs/AGENTS.md'],
+  'tests/drift-detection.test.cjs': ['docs/CONFIGURATION.md', 'docs/reference/agents.md'],
   'tests/edge-probe-docs-fixtures.test.cjs': ['docs/adr/550-spec-phase-probe-contract.md'],
   'tests/edit-phase.test.cjs': [
     'docs/INVENTORY.md',
@@ -313,7 +319,7 @@ const DOCS_GUARD_TESTS = {
   'tests/host-integration-descriptors.test.cjs': [
     'docs/reference/host-integration-capability-matrix.md',
   ],
-  'tests/install.test.cjs': ['docs/AGENTS.md', 'docs/INVENTORY.md', 'docs/INVENTORY-MANIFEST.json'],
+  'tests/install.test.cjs': ['docs/reference/agents.md', 'docs/INVENTORY.md', 'docs/INVENTORY-MANIFEST.json'],
   // SOURCE_DIRS includes 'docs' and walks it recursively for every .md file
   // (intel.test.cjs:1223-1228) — a generic tree walk.
   'tests/intel.test.cjs': ['*'],
@@ -321,6 +327,13 @@ const DOCS_GUARD_TESTS = {
   'tests/inventory-manifest-sync.test.cjs': ['docs/INVENTORY.md', 'docs/INVENTORY-MANIFEST.json'],
   'tests/kilo-upgrades.test.cjs': ['docs/how-to/connect-gsd-mcp-server.md'],
   'tests/live-config-guard.test.cjs': ['docs/TESTING-SUITES.md'],
+  // #5601: localized INVENTORY coverage notes must state no agent counts.
+  'tests/localized-inventory-agent-counts.test.cjs': [
+    'docs/ja-JP/',
+    'docs/ko-KR/',
+    'docs/pt-BR/',
+    'docs/zh-CN/',
+  ],
   // #3726: pins the `milestone complete` synopsis (English + four localized
   // mirrors), the `--confirm` flag row and the guard-override instructions —
   // `type: Fixed` exempts that PR from the docs-required lint, so this is the
@@ -346,7 +359,7 @@ const DOCS_GUARD_TESTS = {
     'docs/README.md',
   ],
   'tests/plan-authoring-verification-gaps.test.cjs': ['docs/reference/plan-md.md'],
-  'tests/plan-checker-coupling.test.cjs': ['docs/AGENTS.md'],
+  'tests/plan-checker-coupling.test.cjs': ['docs/reference/agents.md'],
   'tests/plan-phase-drift-guard.test.cjs': [
     'docs/CONFIGURATION.md',
     'docs/COMMANDS.md',
@@ -406,7 +419,7 @@ const DOCS_GUARD_TESTS = {
     'docs/COMMANDS.md',
     'docs/reference/plan-md.md',
     'docs/how-to/plan-a-phase.md',
-    'docs/AGENTS.md',
+    'docs/reference/agents.md',
   ],
   'tests/ui-interaction-capture.test.cjs': ['docs/CONFIGURATION.md'],
   'tests/ui-spec-inventory-provenance.test.cjs': [
@@ -421,7 +434,7 @@ const DOCS_GUARD_TESTS = {
     'docs/pt-BR/how-to/design-a-ui-phase.md',
   ],
   'tests/verifier-behavior-unverified.test.cjs': ['docs/reference/planning-artifacts.md'],
-  'tests/verifier-coincidental-reliance.test.cjs': ['docs/AGENTS.md'],
+  'tests/verifier-coincidental-reliance.test.cjs': ['docs/reference/agents.md'],
   'tests/verify.test.cjs': ['docs/reference/plan-md.md'],
   // #5118 V43: asserts the deleted execute-phase/steps/stale-reverification.md
   // is absent from the generated inventory manifest.

package/scripts/gen-health-docs.cjs

@@ -122,6 +122,13 @@ const REMEDY_ACTION_METADATA = new Map([
       risk: 'None — additive only; triggered by `--backfill` flag',
     },
   ],
+  [
+    'repairVerificationStatus',
+    {
+      effect: 'Rewrite a known legacy verification `status` (`pass_with_caveats`) to `passed`, keeping the original as `legacy_status`',
+      risk: 'None — only the `status` line changes; unknown statuses are never touched',
+    },
+  ],
 ]);
 
 /** Order the Effect/Risk table renders in — matches `REMEDY_ACTION`'s own declaration order. */
@@ -132,6 +139,7 @@ const REMEDY_ACTION_ORDER = [
   'addNyquistKey',
   'addAiIntegrationPhaseKey',
   'backfillMilestones',
+  'repairVerificationStatus',
 ];
 
 /**
@@ -139,7 +147,11 @@ const REMEDY_ACTION_ORDER = [
  * whose remedy is conditional on a flag the plain `Yes`/`No` can't express
  * (mirrors the hand-written table's pre-existing `W018` row: `Yes (--backfill)`).
  */
-const REPAIRABLE_DISPLAY_OVERRIDE = new Map([['W018', 'Yes (`--backfill`)']]);
+const REPAIRABLE_DISPLAY_OVERRIDE = new Map([
+  ['W018', 'Yes (`--backfill`)'],
+  // #5291: only a known legacy status (`pass_with_caveats`) is rewritten.
+  ['W030', 'Yes (known legacy statuses only)'],
+]);
 
 const STATIC_NOT_REPAIRABLE_BULLETS = [
   'PROJECT.md, ROADMAP.md content',

package/scripts/gen-pi-package-skills.cjs

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * gen-pi-package-skills.cjs — generates pi/package-skills/gsd-<stem>/SKILL.md,
+ * the Pi skill templates the Pi package (`pi install npm:@opengsd/gsd-core`)
+ * renders at session start.
+ *
+ * Usage:
+ *   node scripts/gen-pi-package-skills.cjs            # print summary
+ *   node scripts/gen-pi-package-skills.cjs --write    # write pi/package-skills/
+ *   node scripts/gen-pi-package-skills.cjs --check    # exit 1 if committed templates are stale
+ *
+ * #5558 (Phase 1b of epic #5556). Pi skill bodies embed the absolute path of the
+ * engine tree they `@`-include, and a package's install location is unknown at
+ * build time. So the templates are produced by running the real installer
+ * (`bin/install.js --pi --global --config-dir <tmp>`), then replacing the temp
+ * config dir with PI_ENGINE_ROOT_TOKEN. Rendering a template with a root R
+ * (`renderSkillTemplate`, exported for the parity test; pi/gsd.cjs carries the
+ * same two-line substitution) is therefore byte-identical to what the installer
+ * writes for config dir R.
+ *
+ * Depends on a built lib (`npm run build:lib`); must run after it in the build chain.
+ */
+
+const fs = require('node:fs');
+const os = require('node:os');
+const crypto = require('node:crypto');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const { ExitError, runMain } = require('./lib/cli-exit.cjs');
+
+const ROOT = path.resolve(__dirname, '..');
+const OUT_DIR = path.join(ROOT, 'pi', 'package-skills');
+// #5569: the converted Pi role files the package's gsd_dispatch reads (ADR-5559 amendment).
+const ROLES_DIR = path.join(ROOT, 'pi', 'package-agents');
+const ROLES_MANIFEST = 'manifest.json';
+const INSTALLER = path.join(ROOT, 'bin', 'install.js');
+const PI_ENGINE_ROOT_TOKEN = '__GSD_PI_ENGINE_ROOT__';
+const INSTALL_BOUND_MS = 30000;
+
+/** Forward-slash form of a path; the installer emits either form depending on platform. */
+function toSlash(p) {
+  return String(p).replace(/\\/g, '/');
+}
+
+/**
+ * Replace every occurrence of `root` (raw and forward-slash forms) with the token.
+ * @param {string} content
+ * @param {string} root
+ */
+function tokenizeSkill(content, root) {
+  // The installer may print either the path it was given or its symlink-resolved form (/private/var on macOS).
+  let real = root;
+  try { real = fs.realpathSync(root); } catch { /* removed already: only the given form */ }
+  const forms = [...new Set([root, toSlash(root), real, toSlash(real)])].sort((a, b) => b.length - a.length);
+  let out = content;
+  for (const form of forms) out = out.split(form).join(PI_ENGINE_ROOT_TOKEN);
+  return out;
+}
+
+/**
+ * Render a template for an engine root. The root is substituted in its
+ * forward-slash form, which is what the installer writes for the Pi skills.
+ * @param {string} template
+ * @param {string} engineRoot
+ */
+function renderSkillTemplate(template, engineRoot) {
+  return template.split(PI_ENGINE_ROOT_TOKEN).join(toSlash(engineRoot));
+}
+
+/**
+ * Run the installer for Pi into a fresh temp dir and return that dir. The run
+ * gets a separate throwaway HOME (removed straight after): the two must differ,
+ * because the installer writes a config dir that equals or sits under HOME as
+ * `~`/`$HOME`-relative paths.
+ */
+function installIntoTemp() {
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'gsd-pi-skills-'));
+  const home = fs.mkdtempSync(path.join(os.tmpdir(), 'gsd-pi-home-'));
+  const res = spawnSync(process.execPath, [INSTALLER, '--pi', '--global', '--config-dir', tmp], {
+    cwd: ROOT,
+    encoding: 'utf8',
+    timeout: INSTALL_BOUND_MS,
+    windowsHide: true,
+    // HOME is redirected too: the installer writes GSD's global defaults store under
+    // $HOME/.gsd, and a generator run must not touch the developer's real one.
+    // GSD_ARGS_NONCE_OFF keeps the templates canonical: they ship in the package, so a per-install
+    // nonce stamped here would be a build-time constant and would change on every generation.
+    env: { ...process.env, PI_CODING_AGENT_DIR: tmp, HOME: home, USERPROFILE: home, GSD_HOME: home, GSD_ARGS_NONCE_OFF: '1' },
+  });
+  fs.rmSync(home, { recursive: true, force: true });
+  if (res.status !== 0) {
+    fs.rmSync(tmp, { recursive: true, force: true });
+    throw new ExitError(
+      1,
+      `gen-pi-package-skills: installer failed (${res.error ? res.error.message : `exit ${res.status}`}).\n` +
+      `${(res.stderr || res.stdout || '').slice(-1500)}\nRun \`npm run build:lib\` first.`,
+    );
+  }
+  return tmp;
+}
+
+/**
+ * The role templates and their hash manifest, from an installed `agents/` dir. Roles `@`-reference
+ * files under the engine root, so like the skills they ship with PI_ENGINE_ROOT_TOKEN in place of the
+ * install path; gsd_dispatch verifies the template bytes against this manifest, then renders the root.
+ * @returns {{ roles: { name: string, content: string }[], manifest: string }}
+ */
+function collectRoles(tmp) {
+  const dir = path.join(tmp, 'agents');
+  const roles = fs.readdirSync(dir, { withFileTypes: true })
+    .filter((e) => e.isFile() && e.name.endsWith('.md'))
+    .map((e) => e.name)
+    .sort()
+    .map((name) => ({ name, content: tokenizeSkill(fs.readFileSync(path.join(dir, name), 'utf8'), tmp) }));
+  const files = {};
+  for (const { name, content } of roles) files[name] = crypto.createHash('sha256').update(content).digest('hex');
+  return { roles, manifest: `${JSON.stringify({ files }, null, 2)}\n` };
+}
+
+/** @returns {{ templates: { skillName: string, content: string }[], roles: { name: string, content: string }[], manifest: string }} */
+function generateAll() {
+  const tmp = installIntoTemp();
+  try {
+    const skillsDir = path.join(tmp, 'skills');
+    const names = fs.readdirSync(skillsDir, { withFileTypes: true })
+      .filter((e) => e.isDirectory() && e.name.startsWith('gsd-'))
+      .map((e) => e.name)
+      .sort();
+    const templates = names.map((skillName) => ({
+      skillName,
+      content: tokenizeSkill(fs.readFileSync(path.join(skillsDir, skillName, 'SKILL.md'), 'utf8'), tmp),
+    }));
+    return { templates, ...collectRoles(tmp) };
+  } finally {
+    fs.rmSync(tmp, { recursive: true, force: true });
+  }
+}
+
+/** @returns {{ skillName: string, content: string }[]} sorted by skill name */
+function generateTemplates() {
+  return generateAll().templates;
+}
+
+function main() {
+  const args = new Set(process.argv.slice(2));
+  const { templates: results, roles, manifest } = generateAll();
+
+  if (args.has('--write')) {
+    fs.rmSync(ROLES_DIR, { recursive: true, force: true });
+    fs.mkdirSync(ROLES_DIR, { recursive: true });
+    for (const { name, content } of roles) fs.writeFileSync(path.join(ROLES_DIR, name), content);
+    fs.writeFileSync(path.join(ROLES_DIR, ROLES_MANIFEST), manifest);
+    fs.rmSync(OUT_DIR, { recursive: true, force: true });
+    for (const { skillName, content } of results) {
+      fs.mkdirSync(path.join(OUT_DIR, skillName), { recursive: true });
+      fs.writeFileSync(path.join(OUT_DIR, skillName, 'SKILL.md'), content);
+    }
+    process.stdout.write(`gen-pi-package-skills: wrote ${results.length} templates to ${path.relative(ROOT, OUT_DIR)}/ and ${roles.length} roles to ${path.relative(ROOT, ROLES_DIR)}/\n`);
+    return 0;
+  }
+
+  if (args.has('--check')) {
+    if (!fs.existsSync(OUT_DIR)) {
+      throw new ExitError(1, 'gen-pi-package-skills: pi/package-skills/ missing. Run: npm run gen:pi-package-skills');
+    }
+    let stale = 0;
+    const expected = new Set(results.map((r) => r.skillName));
+    for (const { skillName, content } of results) {
+      const file = path.join(OUT_DIR, skillName, 'SKILL.md');
+      if (!fs.existsSync(file)) {
+        process.stderr.write(`gen-pi-package-skills: missing ${path.relative(ROOT, file)}\n`);
+        stale++;
+      } else if (fs.readFileSync(file, 'utf8') !== content) {
+        process.stderr.write(`gen-pi-package-skills: stale ${path.relative(ROOT, file)}\n`);
+        stale++;
+      }
+    }
+    for (const e of fs.readdirSync(OUT_DIR, { withFileTypes: true })) {
+      if (e.isDirectory() && !expected.has(e.name)) {
+        process.stderr.write(`gen-pi-package-skills: stale (no source) ${path.relative(ROOT, path.join(OUT_DIR, e.name))}\n`);
+        stale++;
+      }
+    }
+    const wantRoles = new Map([...roles.map((r) => [r.name, r.content]), [ROLES_MANIFEST, manifest]]);
+    const haveRoles = fs.existsSync(ROLES_DIR) ? fs.readdirSync(ROLES_DIR) : [];
+    for (const [name, content] of wantRoles) {
+      const file = path.join(ROLES_DIR, name);
+      if (!fs.existsSync(file) || fs.readFileSync(file, 'utf8') !== content) {
+        process.stderr.write(`gen-pi-package-skills: stale ${path.relative(ROOT, file)}\n`);
+        stale++;
+      }
+    }
+    for (const name of haveRoles) {
+      if (!wantRoles.has(name)) {
+        process.stderr.write(`gen-pi-package-skills: stale (no source) ${path.relative(ROOT, path.join(ROLES_DIR, name))}\n`);
+        stale++;
+      }
+    }
+    if (stale > 0) {
+      throw new ExitError(1, `gen-pi-package-skills: ${stale} stale template(s). Run: npm run gen:pi-package-skills`);
+    }
+    process.stdout.write(`gen-pi-package-skills: ${results.length} templates up to date\n`);
+    return 0;
+  }
+
+  process.stdout.write(
+    `gen-pi-package-skills: would write ${results.length} templates to ${path.relative(ROOT, OUT_DIR)}/\n` +
+    '  (use --write to generate, --check to verify staleness)\n',
+  );
+  return 0;
+}
+
+module.exports = { PI_ENGINE_ROOT_TOKEN, tokenizeSkill, renderSkillTemplate, toSlash, generateTemplates, generateAll };
+
+if (require.main === module) runMain(main);

package/scripts/lib/macos-conformance-tier.generated.cjs

@@ -6,6 +6,7 @@
 
 module.exports = {
   MACOS_CONFORMANCE_TIER_FILES: [
+  "tests/5100-win32-bare-bash-sentinel.property.test.cjs",
   "tests/active-workstream-store.unit.test.cjs",
   "tests/adr-612-bracket-phase-counting.test.cjs",
   "tests/adr-index-gate.test.cjs",
@@ -16,6 +17,7 @@ module.exports = {
   "tests/agent-skills.test.cjs",
   "tests/api-coverage-gate-e2e.test.cjs",
   "tests/api-coverage.test.cjs",
+  "tests/args-terminator-nonce.test.cjs",
   "tests/ask-user-questions-fallback.test.cjs",
   "tests/audit-command-cutover.test.cjs",
   "tests/broken-windows.test.cjs",
@@ -38,6 +40,7 @@ module.exports = {
   "tests/check-ui-safety-gate.test.cjs",
   "tests/check-update-config-dir.test.cjs",
   "tests/chunked-planning-parallel.test.cjs",
+  "tests/ci-conformance-pr-gating.test.cjs",
   "tests/ci-docs-guard-registry.test.cjs",
   "tests/ci-test-scope.test.cjs",
   "tests/cline-install.test.cjs",
@@ -82,6 +85,7 @@ module.exports = {
   "tests/gap-checker.property.test.cjs",
   "tests/gate-api-coverage-verify-pre-escape.test.cjs",
   "tests/gate-codebase-drift.unit.test.cjs",
+  "tests/gate-evaluation-scope.test.cjs",
   "tests/gate-predicate.unit.test.cjs",
   "tests/gate-tdd-red-evidence-containment.test.cjs",
   "tests/gate-ui-plan.unit.test.cjs",
@@ -93,6 +97,7 @@ module.exports = {
   "tests/graphify-query.test.cjs",
   "tests/graphify-visualization.test.cjs",
   "tests/gsd-agent-isolation-guard.test.cjs",
+  "tests/gsd-path-export-hook.test.cjs",
   "tests/gsd-secret-read-guard.test.cjs",
   "tests/gsd-settings-advanced.test.cjs",
   "tests/gsd-statusline.test.cjs",
@@ -107,7 +112,6 @@ module.exports = {
   "tests/hooks-crash-policy.test.cjs",
   "tests/hooks-opt-in.test.cjs",
   "tests/host-integration.test.cjs",
-  "tests/in-tier-commit-hook-timing.test.cjs",
   "tests/init-manager.test.cjs",
   "tests/install-minimal-hooks.test.cjs",
   "tests/install-path-detection.test.cjs",
@@ -135,6 +139,7 @@ module.exports = {
   "tests/markdown-sectionizer.test.cjs",
   "tests/mcp-catalog.test.cjs",
   "tests/milestone-archive.test.cjs",
+  "tests/milestone-release-tags.test.cjs",
   "tests/milestone-window-single-owner.test.cjs",
   "tests/model-catalog.unit.test.cjs",
   "tests/model-resolver.test.cjs",
@@ -163,6 +168,8 @@ module.exports = {
   "tests/phase-status.test.cjs",
   "tests/phase.platform.test.cjs",
   "tests/phase.test.cjs",
+  "tests/pi-dispatch.test.cjs",
+  "tests/pi-package.test.cjs",
   "tests/plan-authoring-verification-gaps.test.cjs",
   "tests/plan-count-single-owner.test.cjs",
   "tests/plan-document.test.cjs",
@@ -200,6 +207,7 @@ module.exports = {
   "tests/review-parallel-lanes.test.cjs",
   "tests/review-plan-coverage-manifest.test.cjs",
   "tests/review-reviewer-selection.test.cjs",
+  "tests/reviewed-or-maintainer-policy.test.cjs",
   "tests/reviewer-manifest-body.test.cjs",
   "tests/reviewer-step-dispatch.test.cjs",
   "tests/roadmap-mode-field.test.cjs",
@@ -214,9 +222,11 @@ module.exports = {
   "tests/runtime-launcher-parity.test.cjs",
   "tests/runtime-name-policy.test.cjs",
   "tests/security.test.cjs",
+  "tests/self-test-report-policy.test.cjs",
   "tests/settings-jsonc.test.cjs",
   "tests/shared-hooks-dir-resolution.test.cjs",
   "tests/shell-command-projection-dispatch.test.cjs",
+  "tests/shell-command-projection-md-normalize.test.cjs",
   "tests/shipped-reference-cites.test.cjs",
   "tests/skill-manifest.test.cjs",
   "tests/spawn-liveness-banner.test.cjs",

package/scripts/lib/platform-conformance-tier.generated.cjs

@@ -3,6 +3,7 @@
 
 module.exports = {
   CONFORMANCE_TIER_FILES: [
+  "tests/5100-win32-bare-bash-sentinel.property.test.cjs",
   "tests/adr-index-gate.test.cjs",
   "tests/adr857-core-without-capabilities.test.cjs",
   "tests/agent-install-check.test.cjs",
@@ -11,6 +12,7 @@ module.exports = {
   "tests/antigravity-upgrades.test.cjs",
   "tests/api-coverage-gate-e2e.test.cjs",
   "tests/api-coverage.test.cjs",
+  "tests/args-terminator-nonce.test.cjs",
   "tests/assumption-delta-checkpoint-e2e.test.cjs",
   "tests/assumption-delta.test.cjs",
   "tests/audit-command-cutover.test.cjs",
@@ -42,6 +44,7 @@ module.exports = {
   "tests/check-update-config-dir.test.cjs",
   "tests/check-update-fail-open.test.cjs",
   "tests/chunked-planning-parallel.test.cjs",
+  "tests/ci-conformance-pr-gating.test.cjs",
   "tests/ci-docs-guard-registry.test.cjs",
   "tests/ci-rebase-check.test.cjs",
   "tests/ci-test-scope.test.cjs",
@@ -67,6 +70,7 @@ module.exports = {
   "tests/commit-files-pathspec.test.cjs",
   "tests/commonjs-marker.test.cjs",
   "tests/compact-content-4139.test.cjs",
+  "tests/complete-milestone-release-map-routing.test.cjs",
   "tests/completion-ratio-scope-withholding.test.cjs",
   "tests/config-defaults-runtime-exclusion.test.cjs",
   "tests/config-get-default.test.cjs",
@@ -121,6 +125,7 @@ module.exports = {
   "tests/gate-tdd-red-evidence-containment.test.cjs",
   "tests/gate-tdd-review-checkpoint-hardening.test.cjs",
   "tests/gate-tdd-review-checkpoint.unit.test.cjs",
+  "tests/gate-tdd-review-order-5275.test.cjs",
   "tests/gate-ui-plan.unit.test.cjs",
   "tests/gate-ui-safety.unit.test.cjs",
   "tests/gate-verify-command-paths.unit.test.cjs",
@@ -129,6 +134,7 @@ module.exports = {
   "tests/gen-health-docs.test.cjs",
   "tests/gen-section-manifest.test.cjs",
   "tests/git-base-branch.test.cjs",
+  "tests/git-optional-locks-parity.test.cjs",
   "tests/golden-install-tree.test.cjs",
   "tests/graphify-graph-path.test.cjs",
   "tests/graphify-visualization.test.cjs",
@@ -137,6 +143,7 @@ module.exports = {
   "tests/gsd-check-update-worker-atomic-cache.test.cjs",
   "tests/gsd-check-update-worker-platform-gate.test.cjs",
   "tests/gsd-mcp-server-bin.test.cjs",
+  "tests/gsd-path-export-hook.test.cjs",
   "tests/gsd-statusline.test.cjs",
   "tests/gsd-validate-commit-crash-policy.test.cjs",
   "tests/gsd-validate-commit-sigpipe.test.cjs",
@@ -162,6 +169,7 @@ module.exports = {
   "tests/install-runtime-artifacts.test.cjs",
   "tests/install-write-confinement.test.cjs",
   "tests/install.test.cjs",
+  "tests/installer-first-install-user-skill-5522.test.cjs",
   "tests/installer-migration-antigravity-retire-confighome-artifacts.test.cjs",
   "tests/installer-migration-config-root-marker.test.cjs",
   "tests/installer-migration-pi-retire-hooks-dir.test.cjs",
@@ -171,6 +179,7 @@ module.exports = {
   "tests/intel.test.cjs",
   "tests/inventory-nested-families.test.cjs",
   "tests/io.test.cjs",
+  "tests/isolation-aged-none-sentinel.test.cjs",
   "tests/isolation-sentinel.test.cjs",
   "tests/kilo-upgrades.test.cjs",
   "tests/kimi-agent-converter.test.cjs",
@@ -188,6 +197,9 @@ module.exports = {
   "tests/mcp-catalog.property.test.cjs",
   "tests/mcp-catalog.test.cjs",
   "tests/milestone-archive.test.cjs",
+  "tests/milestone-lock.test.cjs",
+  "tests/milestone-release-map-archive.test.cjs",
+  "tests/milestone-release-tags.test.cjs",
   "tests/milestone-window-single-owner.test.cjs",
   "tests/milestone.test.cjs",
   "tests/model-resolver.test.cjs",
@@ -204,10 +216,12 @@ module.exports = {
   "tests/no-unbounded-spawn.test.cjs",
   "tests/no-unguarded-nonportable-exec.rule.test.cjs",
   "tests/node-compile-cache.test.cjs",
+  "tests/npm-audit-baseline-safe-directory-5659.test.cjs",
   "tests/npm-audit-baseline.test.cjs",
   "tests/npm-integrity-gate.test.cjs",
   "tests/nsegment-phase-grammar.test.cjs",
   "tests/onboard-command.test.cjs",
+  "tests/opencode-advisory-stderr.test.cjs",
   "tests/opencode-command-dir-plural.test.cjs",
   "tests/opencode-config-jsonc.test.cjs",
   "tests/opencode-generations.smoke.test.cjs",
@@ -228,6 +242,10 @@ module.exports = {
   "tests/phase.platform.test.cjs",
   "tests/phase6-capstone-conformance.test.cjs",
   "tests/pi-config-dir-env-override.test.cjs",
+  "tests/pi-dispatch-install.test.cjs",
+  "tests/pi-dispatch.test.cjs",
+  "tests/pi-hook-bridge.test.cjs",
+  "tests/pi-package.test.cjs",
   "tests/plan-count-single-owner.test.cjs",
   "tests/plan-phase-stall-detection.test.cjs",
   "tests/plan-pre-hook-e2e.test.cjs",
@@ -269,7 +287,9 @@ module.exports = {
   "tests/retired-artifact-cleanup.test.cjs",
   "tests/review-build-prompt-optional-sections.test.cjs",
   "tests/review-default-reviewers-config.test.cjs",
+  "tests/review-lane-availability.test.cjs",
   "tests/review-lane-invocation.test.cjs",
+  "tests/review-lane-no-redirect-5433.test.cjs",
   "tests/review-lane-runner.test.cjs",
   "tests/review-lane-windows-spawn-resolution.test.cjs",
   "tests/review-model-config.test.cjs",
@@ -280,6 +300,7 @@ module.exports = {
   "tests/revision-remediation-binding.test.cjs",
   "tests/roadmap-parser.test.cjs",
   "tests/roadmap-upgrade-bracket.test.cjs",
+  "tests/roadmap-upgrade.test.cjs",
   "tests/roadmap.test.cjs",
   "tests/run-tests-accounting.test.cjs",
   "tests/run-tests-harness.test.cjs",
@@ -293,11 +314,14 @@ module.exports = {
   "tests/runtime-identity.test.cjs",
   "tests/runtime-launcher-parity.test.cjs",
   "tests/schema-drift.test.cjs",
+  "tests/section-manifest-init-facts.test.cjs",
   "tests/security.test.cjs",
+  "tests/self-test-report-policy.test.cjs",
   "tests/settings-jsonc.test.cjs",
   "tests/sh-hook-paths.test.cjs",
   "tests/shared-hooks-dir-resolution.test.cjs",
   "tests/shell-command-projection-dispatch.test.cjs",
+  "tests/shell-command-projection-md-normalize.test.cjs",
   "tests/shell-command-projection-path-sep.test.cjs",
   "tests/ship-notes-wedged-pr.test.cjs",
   "tests/shipped-reference-cites.test.cjs",
@@ -321,6 +345,7 @@ module.exports = {
   "tests/unusable-input.test.cjs",
   "tests/update-custom-backup.test.cjs",
   "tests/user-artifact-staging.test.cjs",
+  "tests/user-home-isolation-5594.test.cjs",
   "tests/verification-append-audit.test.cjs",
   "tests/verification-status.test.cjs",
   "tests/verify-archive-dirs-live-path.test.cjs",
@@ -336,7 +361,7 @@ module.exports = {
   "tests/workstream.test.cjs",
   "tests/worktree-cleanup.test.cjs",
   "tests/worktree-safety.test.cjs",
+  "tests/worktree-subdir-effective-root-4885.test.cjs",
   "tests/worktree.test.cjs",
-  "tests/xtrace-phase-timing.platform.test.cjs",
   ],
 };

package/scripts/lint-docs-guard-registration.exempt-baseline.cjs

@@ -122,10 +122,10 @@ const DOCS_GUARD_EXEMPT_DOCS_PATHS = {
   // reads that (or any) docs/ file.
   'capability-validator-task-content-resolver.test.cjs': ['docs/adr/3646-per-task-content-resolution-seam.md'],
   'ci-docs-guard-registry.test.cjs': [
-    'docs/AGENTS.md', 'docs/COMMANDS.md', 'docs/INVENTORY.md', 'docs/a.md', 'docs/adr',
+    'docs/COMMANDS.md', 'docs/INVENTORY.md', 'docs/a.md', 'docs/adr',
     'docs/adr/0001-example.md', 'docs/adrenaline.md', 'docs/bar.md', 'docs/foo.md', 'docs/how-to/foo.md',
-    'docs/how-to/some-unrelated-guide.md', 'docs/how-to/x.md', 'docs/some-unrelated-file.md',
-    'docs/totally-unrelated.md',
+    'docs/how-to/some-unrelated-guide.md', 'docs/how-to/x.md', 'docs/reference/agents.md',
+    'docs/some-unrelated-file.md', 'docs/totally-unrelated.md',
   ],
   // #4641: cites docs/adr/4641-windows-selector-consolidation.md in an
   // explanatory comment describing why the retired `windows` scope must not

package/scripts/lint-retired-runtime-name.cjs

@@ -234,6 +234,11 @@ const ALLOWLIST_OCCURRENCES = new Map([
     { snippet: 'Google (Gemini)', reason: 'model-provider choice, not a GSD runtime' },
     { snippet: 'Committed to Gemini / Google Cloud / Vertex AI', reason: 'the same menu entry\'s description' },
   ]],
+  ['pi/package-agents/gsd-framework-selector.md', [
+    // Generated copy of agents/gsd-framework-selector.md for the Pi package (#5569).
+    { snippet: 'Google (Gemini)', reason: 'model-provider choice, not a GSD runtime' },
+    { snippet: 'Committed to Gemini / Google Cloud / Vertex AI', reason: 'the same menu entry\'s description' },
+  ]],
   ['agents/gsd-framework-selector.compact.md', [
     { snippet: 'Google (Gemini)', reason: 'model-provider choice, not a GSD runtime' },
   ]],