@opengsd/gsd-core 1.13.0 → 1.14.0

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

@@ -0,0 +1,210 @@
+// GENERATED FILE — do not hand-edit. Run `node scripts/gen-platform-conformance-tier.cjs --target macos --write` to regenerate.
+// macOS-specific conformance tier (#4593), separate from and narrower than the general/
+// Windows-oriented tier in platform-conformance-tier.generated.cjs — see
+// docs/adr/4593-macos-conformance-tier-architecture.md for the full rationale.
+'use strict';
+
+module.exports = {
+  MACOS_CONFORMANCE_TIER_FILES: [
+  "tests/adr-612-bracket-phase-counting.test.cjs",
+  "tests/adr-index-gate.test.cjs",
+  "tests/adr-parser.property.test.cjs",
+  "tests/adr-parser.unit.test.cjs",
+  "tests/agent-classification-parity.test.cjs",
+  "tests/agent-install-check.test.cjs",
+  "tests/agent-skills.test.cjs",
+  "tests/api-coverage-gate-e2e.test.cjs",
+  "tests/api-coverage.test.cjs",
+  "tests/ask-user-questions-fallback.test.cjs",
+  "tests/audit-command-cutover.test.cjs",
+  "tests/broken-windows.test.cjs",
+  "tests/capability-cli.test.cjs",
+  "tests/capability-command-dispatch.test.cjs",
+  "tests/capability-consent.test.cjs",
+  "tests/capability-ledger.test.cjs",
+  "tests/capability-lifecycle.test.cjs",
+  "tests/capability-loader.test.cjs",
+  "tests/capability-lock-mkdir-failure-3987.test.cjs",
+  "tests/capability-registry.test.cjs",
+  "tests/capability-source.test.cjs",
+  "tests/capability-state.test.cjs",
+  "tests/capability-trust.test.cjs",
+  "tests/changeset-parse.test.cjs",
+  "tests/check-contract-drift.test.cjs",
+  "tests/check-predicate.test.cjs",
+  "tests/check-ui-safety-gate.test.cjs",
+  "tests/check-update-config-dir.test.cjs",
+  "tests/chunked-planning-parallel.test.cjs",
+  "tests/ci-docs-guard-registry.test.cjs",
+  "tests/ci-test-scope.test.cjs",
+  "tests/cline-install.test.cjs",
+  "tests/code-review-pipeline-regression.test.cjs",
+  "tests/codex-config-agents.test.cjs",
+  "tests/codex-config-hooks.test.cjs",
+  "tests/codex-config-install.test.cjs",
+  "tests/codex-config.test.cjs",
+  "tests/commands.test.cjs",
+  "tests/commit-docs-bypass.test.cjs",
+  "tests/commit-files-deletion.test.cjs",
+  "tests/commit-files-pathspec.test.cjs",
+  "tests/commonjs-marker.test.cjs",
+  "tests/completion-ratio-scope-withholding.test.cjs",
+  "tests/config-loader.test.cjs",
+  "tests/config-schema.property.test.cjs",
+  "tests/config.test.cjs",
+  "tests/contributor-standards.test.cjs",
+  "tests/core-utils.test.cjs",
+  "tests/cursor-subagent-isolation.test.cjs",
+  "tests/debugger-semantic-recall.test.cjs",
+  "tests/default-flip-documentation-lint.test.cjs",
+  "tests/discuss-phase-power.test.cjs",
+  "tests/docs-parity-live-registry.test.cjs",
+  "tests/effort-surface-axis.test.cjs",
+  "tests/effort-sync-installed-runtime.test.cjs",
+  "tests/emitted-attribution.test.cjs",
+  "tests/ensure-runtime-build.test.cjs",
+  "tests/execute-phase-decimal-arithmetic.test.cjs",
+  "tests/executed-plan.test.cjs",
+  "tests/executor-mvp-tdd-section.test.cjs",
+  "tests/external-job.test.cjs",
+  "tests/failing-direction.test.cjs",
+  "tests/fallow-runner.test.cjs",
+  "tests/feat-2483-review-claude-mds-guard.test.cjs",
+  "tests/features-index-gate.test.cjs",
+  "tests/frontmatter.unit.test.cjs",
+  "tests/gap-checker.property.test.cjs",
+  "tests/gen-context-index.test.cjs",
+  "tests/gen-section-manifest.test.cjs",
+  "tests/git-base-branch.test.cjs",
+  "tests/graphify-query.test.cjs",
+  "tests/graphify-visualization.test.cjs",
+  "tests/gsd-secret-read-guard.test.cjs",
+  "tests/gsd-settings-advanced.test.cjs",
+  "tests/gsd-statusline.test.cjs",
+  "tests/gsd-tools-path-refs.test.cjs",
+  "tests/gsd-validate-commit-crash-policy.test.cjs",
+  "tests/gsd-write-guard.test.cjs",
+  "tests/health-diagnostic-rules/worktree-health.test.cjs",
+  "tests/health-diagnostic.test.cjs",
+  "tests/helpers-cleanup.test.cjs",
+  "tests/helpers-process-isolation.test.cjs",
+  "tests/hooks-crash-policy.test.cjs",
+  "tests/hooks-opt-in.test.cjs",
+  "tests/host-integration.test.cjs",
+  "tests/init-manager.test.cjs",
+  "tests/init.test.cjs",
+  "tests/install-minimal-hooks.test.cjs",
+  "tests/install-path-detection.test.cjs",
+  "tests/install-regressions.test.cjs",
+  "tests/install-runtime-artifacts.test.cjs",
+  "tests/install-write-confinement.test.cjs",
+  "tests/install.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",
+  "tests/installer-migration-prune-stale-pristine.test.cjs",
+  "tests/installer-migration-rename-gsd-core.test.cjs",
+  "tests/installer-migrations.test.cjs",
+  "tests/intel.test.cjs",
+  "tests/inventory-nested-families.test.cjs",
+  "tests/isolation-sentinel.test.cjs",
+  "tests/issue-version-gate.test.cjs",
+  "tests/kimi-upgrades.test.cjs",
+  "tests/lint-docs-command-form.test.cjs",
+  "tests/lint-workflow-shellcheck-fetch.test.cjs",
+  "tests/list-seeds.test.cjs",
+  "tests/markdown-sectionizer.test.cjs",
+  "tests/mcp-catalog.test.cjs",
+  "tests/milestone-archive.test.cjs",
+  "tests/milestone-window-single-owner.test.cjs",
+  "tests/model-catalog.unit.test.cjs",
+  "tests/model-resolver.test.cjs",
+  "tests/no-exact-case-env-access.rule.test.cjs",
+  "tests/no-pending-3212-markers.test.cjs",
+  "tests/no-phantom-issue-refs.test.cjs",
+  "tests/no-posix-mode-bit-assert.rule.test.cjs",
+  "tests/no-private-binary-resolution.rule.test.cjs",
+  "tests/no-unguarded-nonportable-exec.rule.test.cjs",
+  "tests/observability/event.test.cjs",
+  "tests/onboard-command.test.cjs",
+  "tests/opencode-plugin-adapter.test.cjs",
+  "tests/pause-work-context-detection.test.cjs",
+  "tests/pause-work-improvements.test.cjs",
+  "tests/perf-317-context-monitor-fs.test.cjs",
+  "tests/phase-completion-single-owner.test.cjs",
+  "tests/phase-estimation.test.cjs",
+  "tests/phase-id-drift-guard.test.cjs",
+  "tests/phase-id.test.cjs",
+  "tests/phase-locator.test.cjs",
+  "tests/phase.test.cjs",
+  "tests/plan-count-single-owner.test.cjs",
+  "tests/plan-phase-stall-detection.test.cjs",
+  "tests/plan-review-convergence.test.cjs",
+  "tests/planning-inspect.test.cjs",
+  "tests/planning-inspect.unit.test.cjs",
+  "tests/planning-lock-mkdir-failure-1884.test.cjs",
+  "tests/planning-snapshot.test.cjs",
+  "tests/planning-workspace.test.cjs",
+  "tests/platform-conformance-tier.test.cjs",
+  "tests/plugin-manifest.test.cjs",
+  "tests/policy-shell-pinning.test.cjs",
+  "tests/portability-rule-disable-ban.test.cjs",
+  "tests/precommit-alias-drift-hook.test.cjs",
+  "tests/prepush-enterprise-email-hook.test.cjs",
+  "tests/process-seam.test.cjs",
+  "tests/profile-output.test.cjs",
+  "tests/profile-pipeline.test.cjs",
+  "tests/quick-batch.test.cjs",
+  "tests/quick-branching.test.cjs",
+  "tests/quick-research.test.cjs",
+  "tests/reapply-verify-hunks.test.cjs",
+  "tests/refactor-1390-t3-characterization.test.cjs",
+  "tests/require-issue-link-policy.test.cjs",
+  "tests/response-language-coverage.test.cjs",
+  "tests/retired-artifact-cleanup.test.cjs",
+  "tests/review-build-prompt-optional-sections.test.cjs",
+  "tests/review-lane-runner.test.cjs",
+  "tests/review-lane-windows-spawn-resolution.test.cjs",
+  "tests/review-parallel-lanes.test.cjs",
+  "tests/review-plan-coverage-manifest.test.cjs",
+  "tests/review-reviewer-selection.test.cjs",
+  "tests/reviewer-manifest-body.test.cjs",
+  "tests/reviewer-step-dispatch.test.cjs",
+  "tests/roadmap-mode-field.test.cjs",
+  "tests/roadmap-parser.test.cjs",
+  "tests/roadmap-phase-fallback.test.cjs",
+  "tests/roadmap.test.cjs",
+  "tests/runtime-artifact-layout.test.cjs",
+  "tests/runtime-identity.test.cjs",
+  "tests/runtime-launcher-parity.test.cjs",
+  "tests/security.test.cjs",
+  "tests/settings-jsonc.test.cjs",
+  "tests/shared-hooks-dir-resolution.test.cjs",
+  "tests/shell-command-projection-dispatch.test.cjs",
+  "tests/spawn-liveness-banner.test.cjs",
+  "tests/state-document.test.cjs",
+  "tests/state-transition.test.cjs",
+  "tests/state.test.cjs",
+  "tests/todos-workstream-scope.test.cjs",
+  "tests/tracer-bullet.test.cjs",
+  "tests/uat.test.cjs",
+  "tests/ui-safety-gate.test.cjs",
+  "tests/ui-spec-inventory-provenance.test.cjs",
+  "tests/unreachable-guard-drift.test.cjs",
+  "tests/unreachable-shell-guard.test.cjs",
+  "tests/unusable-input.test.cjs",
+  "tests/update-custom-backup.test.cjs",
+  "tests/user-artifact-staging.test.cjs",
+  "tests/verification-overrides.test.cjs",
+  "tests/verification-status.test.cjs",
+  "tests/verify-archive-dirs-live-path.test.cjs",
+  "tests/verify-command-grounding.test.cjs",
+  "tests/verify.test.cjs",
+  "tests/workflow-fragments.test.cjs",
+  "tests/workflow-shell-pinning.test.cjs",
+  "tests/workstream-inventory.test.cjs",
+  "tests/workstream.test.cjs",
+  "tests/worktree-safety.test.cjs",
+  "tests/worktree.test.cjs",
+  ],
+};

package/scripts/lib/npm-version-check-diagnosis.cjs

@@ -0,0 +1,59 @@
+'use strict';
+
+/**
+ * #4460: distinguishes WHY scripts/check-env.cjs's npm-version check's
+ * spawnSync(npmCmd, ['--version'], ...) produced no usable output, instead
+ * of collapsing every case into "npm binary not found on PATH" -- a
+ * message that used to fire identically for a genuinely-missing binary AND
+ * for a spawnSync TIMEOUT under CI load (exitCode stays non-zero, stdout
+ * stays empty, either way). Root-caused live: an unrelated PR's Windows CI
+ * shard failed this check twice in a row while running ~51 concurrent test
+ * files; npm.cmd's own cold-start plausibly exceeded the check's original
+ * 10s window under that contention, and the misleading message made a real
+ * timeout indistinguishable from npm actually being absent.
+ *
+ * Expects `result.timedOut` to already be computed the same way this
+ * repo's canonical OS-shell-projection seam (execNpm / isSpawnTimeout,
+ * src/shell-command-projection.cts) computes it: `error.code ===
+ * 'ETIMEDOUT'`, which Node's spawnSync guarantees when its own `timeout`
+ * option fires. NOT imported directly here -- check-env.cjs deliberately
+ * cannot depend on that seam's compiled output (gsd-core/bin/lib/*.cjs), a
+ * tsc build artifact that does not exist yet when check-env.cjs runs as its
+ * own standalone pre-`npm ci` CI step (confirmed live: an earlier version
+ * of this fix routed through execNpm directly and crashed every real CI
+ * job with MODULE_NOT_FOUND) -- so the same ETIMEDOUT check is computed
+ * inline in check-env.cjs instead. Checking `result.signal === 'SIGTERM'`
+ * directly (what an earlier version of this fix did) is platform-fragile
+ * per that seam's own documented reasoning, with a specifically-called-out
+ * risk of a false NEGATIVE on Windows -- the exact platform this failure
+ * was discovered on.
+ *
+ * Kept out of scripts/check-env.cjs itself (which runs its CLI unconditionally
+ * on require, with no `require.main === module` guard) so this pure logic
+ * can be required directly by tests without triggering a real environment
+ * check.
+ *
+ * @param {{exitCode: number, stdout: string, signal: string|null, error: (Error & {code?: string})|null, timedOut: boolean}} result
+ * @returns {string}
+ */
+function describeNpmVersionCheckFailure(result) {
+  if (result.error && result.error.code === 'ENOENT') {
+    return 'npm binary not found on PATH';
+  }
+  if (result.timedOut) {
+    return `npm --version timed out under CI load -- not a missing binary`;
+  }
+  if (result.exitCode !== 0) {
+    return `npm --version exited ${result.exitCode} with no usable output`;
+  }
+  if (result.exitCode === 0) {
+    // npm ran and exited cleanly but printed nothing -- distinct from every
+    // case above (which all involve a failed/absent spawn), so it gets its
+    // own message rather than falling through to "not found on PATH", which
+    // would misdescribe a real npm binary that simply produced no output.
+    return 'npm --version exited 0 but produced no output';
+  }
+  return 'npm binary not found on PATH';
+}
+
+module.exports = { describeNpmVersionCheckFailure };

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

@@ -0,0 +1,276 @@
+// GENERATED FILE — do not hand-edit. Run `node scripts/gen-platform-conformance-tier.cjs --write` to regenerate.
+'use strict';
+
+module.exports = {
+  CONFORMANCE_TIER_FILES: [
+  "tests/adr-index-gate.test.cjs",
+  "tests/adr857-core-without-capabilities.test.cjs",
+  "tests/agent-install-check.test.cjs",
+  "tests/agent-install-validation.test.cjs",
+  "tests/agent-skills.test.cjs",
+  "tests/antigravity-upgrades.test.cjs",
+  "tests/api-coverage-gate-e2e.test.cjs",
+  "tests/api-coverage.test.cjs",
+  "tests/assumption-delta-checkpoint-e2e.test.cjs",
+  "tests/assumption-delta.test.cjs",
+  "tests/audit-command-cutover.test.cjs",
+  "tests/augment-upgrades.test.cjs",
+  "tests/broken-windows.test.cjs",
+  "tests/capability-cli.test.cjs",
+  "tests/capability-command-dispatch.test.cjs",
+  "tests/capability-consent.test.cjs",
+  "tests/capability-ledger.test.cjs",
+  "tests/capability-lifecycle.test.cjs",
+  "tests/capability-loader.test.cjs",
+  "tests/capability-lock-mkdir-failure-3987.test.cjs",
+  "tests/capability-probe-fallback.test.cjs",
+  "tests/capability-source.test.cjs",
+  "tests/capability-state.test.cjs",
+  "tests/changeset-new.test.cjs",
+  "tests/check-env.test.cjs",
+  "tests/check-gap-analysis-plan-post-e2e.test.cjs",
+  "tests/check-glossary-refs.test.cjs",
+  "tests/check-predicate.test.cjs",
+  "tests/check-tdd-review-checkpoint-e2e.test.cjs",
+  "tests/check-ui-safety-gate.test.cjs",
+  "tests/check-update-config-dir.test.cjs",
+  "tests/chunked-planning-parallel.test.cjs",
+  "tests/ci-docs-guard-registry.test.cjs",
+  "tests/ci-rebase-check.test.cjs",
+  "tests/ci-test-scope.test.cjs",
+  "tests/cjs-command-router-adapter.test.cjs",
+  "tests/claude-md.test.cjs",
+  "tests/cline-install.test.cjs",
+  "tests/close-phase-todos-padded-resolves.test.cjs",
+  "tests/code-review-pipeline-regression.test.cjs",
+  "tests/code-review-tier3-files-override-scoping.test.cjs",
+  "tests/code-review.test.cjs",
+  "tests/codex-config-agents.test.cjs",
+  "tests/codex-config-hooks.test.cjs",
+  "tests/codex-config-install.test.cjs",
+  "tests/codex-config.test.cjs",
+  "tests/codex-inherit-smoke.test.cjs",
+  "tests/command-routing-hub.test.cjs",
+  "tests/commands.test.cjs",
+  "tests/commit-files-deletion.test.cjs",
+  "tests/commit-files-pathspec.test.cjs",
+  "tests/commonjs-marker.test.cjs",
+  "tests/compact-content-4139.test.cjs",
+  "tests/completion-ratio-scope-withholding.test.cjs",
+  "tests/config-defaults-runtime-exclusion.test.cjs",
+  "tests/config-get-default.test.cjs",
+  "tests/config-loader.test.cjs",
+  "tests/config-schema.property.test.cjs",
+  "tests/config.test.cjs",
+  "tests/copilot-install.test.cjs",
+  "tests/copilot-upgrades.test.cjs",
+  "tests/core-utils.test.cjs",
+  "tests/cursor-hook-workspace-roots.test.cjs",
+  "tests/cursor-hooks.test.cjs",
+  "tests/cursor-subagent-isolation.test.cjs",
+  "tests/dispatch-identity.test.cjs",
+  "tests/dispatcher.test.cjs",
+  "tests/drift-detection.test.cjs",
+  "tests/effort-surface-axis.test.cjs",
+  "tests/effort-sync-installed-runtime.test.cjs",
+  "tests/emitted-ack-trailer.test.cjs",
+  "tests/emitted-attribution.test.cjs",
+  "tests/emitted-provenance.test.cjs",
+  "tests/ensure-runtime-build.test.cjs",
+  "tests/eslint-rules.test.cjs",
+  "tests/execute-phase-decimal-arithmetic.test.cjs",
+  "tests/execute-phase-worktree-guard.test.cjs",
+  "tests/execute-plan-update-codebase-map-diff-base.test.cjs",
+  "tests/execute-wave-post-gate-pipeline-e2e.test.cjs",
+  "tests/executed-plan.test.cjs",
+  "tests/executor-mvp-tdd-section.test.cjs",
+  "tests/external-descriptor-confinement.test.cjs",
+  "tests/failing-direction.test.cjs",
+  "tests/fallow-runner.test.cjs",
+  "tests/faulty-deps.test.cjs",
+  "tests/feat-2483-review-claude-mds-guard.test.cjs",
+  "tests/features-index-gate.test.cjs",
+  "tests/frontmatter.test.cjs",
+  "tests/gap-checker.property.test.cjs",
+  "tests/gemini-runtime-removed.test.cjs",
+  "tests/gen-context-index.test.cjs",
+  "tests/gen-health-docs.test.cjs",
+  "tests/gen-section-manifest.test.cjs",
+  "tests/git-base-branch.test.cjs",
+  "tests/golden-install-tree.test.cjs",
+  "tests/graphify-graph-path.test.cjs",
+  "tests/graphify-visualization.test.cjs",
+  "tests/graphify.test.cjs",
+  "tests/gsd-agent-isolation-guard.test.cjs",
+  "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-statusline.test.cjs",
+  "tests/gsd-validate-commit-crash-policy.test.cjs",
+  "tests/gsd-write-guard.test.cjs",
+  "tests/health-diagnostic-rules/config-validation.test.cjs",
+  "tests/health-diagnostic-rules/worktree-health.test.cjs",
+  "tests/health-diagnostic.test.cjs",
+  "tests/helpers-cleanup.test.cjs",
+  "tests/helpers-process-isolation.test.cjs",
+  "tests/hermes-skills-migration.test.cjs",
+  "tests/hooks-commonjs-marker.test.cjs",
+  "tests/hooks-crash-policy.test.cjs",
+  "tests/hooks-opt-in.test.cjs",
+  "tests/host-integration.test.cjs",
+  "tests/init-manager.test.cjs",
+  "tests/init.test.cjs",
+  "tests/install-minimal-hooks.test.cjs",
+  "tests/install-nested-layout.test.cjs",
+  "tests/install-path-detection.test.cjs",
+  "tests/install-regressions.test.cjs",
+  "tests/install-runtime-artifacts.test.cjs",
+  "tests/install-write-confinement.test.cjs",
+  "tests/install.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",
+  "tests/installer-migration-prune-stale-pristine.test.cjs",
+  "tests/installer-migration-rename-gsd-core.test.cjs",
+  "tests/installer-migrations.test.cjs",
+  "tests/intel.test.cjs",
+  "tests/inventory-nested-families.test.cjs",
+  "tests/io.test.cjs",
+  "tests/isolation-sentinel.test.cjs",
+  "tests/kilo-upgrades.test.cjs",
+  "tests/kimi-agent-converter.test.cjs",
+  "tests/kimi-upgrades.test.cjs",
+  "tests/kimi-variant-disambiguation.test.cjs",
+  "tests/lint-workflow-shellcheck-fetch.test.cjs",
+  "tests/live-config-guard.test.cjs",
+  "tests/lockfile-cve-audit.test.cjs",
+  "tests/locking-bugs-1909-1916-1925-1927.test.cjs",
+  "tests/loop-hooks-empty-points-e2e.test.cjs",
+  "tests/loop-hooks-ship-pre-e2e.test.cjs",
+  "tests/loop-hooks-verify-post-e2e.test.cjs",
+  "tests/mcp-catalog.property.test.cjs",
+  "tests/mcp-catalog.test.cjs",
+  "tests/milestone-archive.test.cjs",
+  "tests/milestone-window-single-owner.test.cjs",
+  "tests/model-resolver.test.cjs",
+  "tests/mutation-workflow-base-ref.test.cjs",
+  "tests/new-milestone-clear-phases.test.cjs",
+  "tests/no-bare-npm-exec.rule.test.cjs",
+  "tests/no-exact-case-env-access.rule.test.cjs",
+  "tests/no-path-literal-in-assert.rule.test.cjs",
+  "tests/no-pending-3212-markers.test.cjs",
+  "tests/no-phantom-issue-refs.test.cjs",
+  "tests/no-posix-mode-bit-assert.rule.test.cjs",
+  "tests/no-private-binary-resolution.rule.test.cjs",
+  "tests/no-unbounded-dirname-walk.rule.test.cjs",
+  "tests/no-unbounded-spawn.test.cjs",
+  "tests/no-unguarded-nonportable-exec.rule.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-command-dir-plural.test.cjs",
+  "tests/opencode-plugin-adapter.test.cjs",
+  "tests/overlay-repo-helpers.test.cjs",
+  "tests/packaging-shipped-scripts-require-only-shipped.test.cjs",
+  "tests/path-replacement.test.cjs",
+  "tests/pause-work-context-detection.test.cjs",
+  "tests/pause-work-improvements.test.cjs",
+  "tests/perf-317-context-monitor-fs.test.cjs",
+  "tests/phase-completion-single-owner.test.cjs",
+  "tests/phase-estimation.test.cjs",
+  "tests/phase-locator.test.cjs",
+  "tests/phase.test.cjs",
+  "tests/phase6-capstone-conformance.test.cjs",
+  "tests/pi-config-dir-env-override.test.cjs",
+  "tests/plan-count-single-owner.test.cjs",
+  "tests/plan-phase-stall-detection.test.cjs",
+  "tests/plan-pre-hook-e2e.test.cjs",
+  "tests/plan-review-convergence.test.cjs",
+  "tests/planning-inspect.test.cjs",
+  "tests/planning-inspect.unit.test.cjs",
+  "tests/planning-lock-mkdir-failure-1884.test.cjs",
+  "tests/planning-prompt-drift.test.cjs",
+  "tests/planning-snapshot.test.cjs",
+  "tests/planning-workspace.test.cjs",
+  "tests/platform-conformance-tier.test.cjs",
+  "tests/platform-guard.unit.test.cjs",
+  "tests/plugin-manifest.test.cjs",
+  "tests/policy-160-route0-resume.test.cjs",
+  "tests/policy-shell-pinning.test.cjs",
+  "tests/portability-rule-disable-ban.test.cjs",
+  "tests/pr-branch-planning-filter.test.cjs",
+  "tests/precommit-alias-drift-hook.test.cjs",
+  "tests/prepush-enterprise-email-hook.test.cjs",
+  "tests/process-seam.test.cjs",
+  "tests/profile-output.test.cjs",
+  "tests/profile-pipeline.test.cjs",
+  "tests/prohibition-enforcement.test.cjs",
+  "tests/project-root.test.cjs",
+  "tests/quick-batch.test.cjs",
+  "tests/quick-branching.test.cjs",
+  "tests/quick-research.test.cjs",
+  "tests/quick-review-scope-tip-bound.test.cjs",
+  "tests/read-guard.test.cjs",
+  "tests/reapply-verify-hunks.test.cjs",
+  "tests/repo-layout.test.cjs",
+  "tests/representative-corpus.test.cjs",
+  "tests/require-fs-op-fallback.rule.test.cjs",
+  "tests/require-full-tmpdir-triad.rule.test.cjs",
+  "tests/require-userprofile-with-home.rule.test.cjs",
+  "tests/response-language-coverage.test.cjs",
+  "tests/retired-artifact-cleanup.test.cjs",
+  "tests/review-build-prompt-optional-sections.test.cjs",
+  "tests/review-default-reviewers-config.test.cjs",
+  "tests/review-lane-runner.test.cjs",
+  "tests/review-lane-windows-spawn-resolution.test.cjs",
+  "tests/review-model-config.test.cjs",
+  "tests/review-parallel-lanes.test.cjs",
+  "tests/review-plan-coverage-manifest.test.cjs",
+  "tests/reviewer-manifest-body.test.cjs",
+  "tests/reviewer-step-dispatch.test.cjs",
+  "tests/revision-remediation-binding.test.cjs",
+  "tests/roadmap-parser.test.cjs",
+  "tests/roadmap.test.cjs",
+  "tests/run-tests-harness.test.cjs",
+  "tests/run-tests-temp-root.test.cjs",
+  "tests/run-with-timeout.test.cjs",
+  "tests/runtime-artifact-layout-surface.test.cjs",
+  "tests/runtime-artifact-layout.test.cjs",
+  "tests/runtime-converters.test.cjs",
+  "tests/runtime-homes-descriptor-drive.test.cjs",
+  "tests/runtime-identity.test.cjs",
+  "tests/runtime-launcher-parity.test.cjs",
+  "tests/security.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-path-sep.test.cjs",
+  "tests/ship-notes-wedged-pr.test.cjs",
+  "tests/skill-manifest.test.cjs",
+  "tests/slug-derivation-drift-guard.test.cjs",
+  "tests/state-todos-render.test.cjs",
+  "tests/state.test.cjs",
+  "tests/teams-status.test.cjs",
+  "tests/todos-workstream-scope.test.cjs",
+  "tests/unreachable-guard-drift.test.cjs",
+  "tests/unreachable-shell-guard.test.cjs",
+  "tests/unusable-input.test.cjs",
+  "tests/update-custom-backup.test.cjs",
+  "tests/user-artifact-staging.test.cjs",
+  "tests/verification-status.test.cjs",
+  "tests/verify-archive-dirs-live-path.test.cjs",
+  "tests/verify-command-grounding.test.cjs",
+  "tests/verify.test.cjs",
+  "tests/windsurf-hooks-bridge.test.cjs",
+  "tests/workflow-guard.test.cjs",
+  "tests/workflow-shell-pinning.test.cjs",
+  "tests/workstream-inventory.test.cjs",
+  "tests/workstream-scoped-paths.test.cjs",
+  "tests/workstream.test.cjs",
+  "tests/worktree-cleanup.test.cjs",
+  "tests/worktree-safety.test.cjs",
+  "tests/worktree.test.cjs",
+  ],
+};

package/scripts/lib/suite-detection.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+/**
+ * Suite classification by filename suffix (#4591 packaging fix — extracted
+ * from scripts/run-tests.cjs so a SHIPPED script, e.g.
+ * scripts/gen-platform-conformance-tier.cjs, can depend on it: run-tests.cjs
+ * itself does not ship (it is a repo-development-only tool), so a shipped
+ * file requiring it directly is MODULE_NOT_FOUND in a published install
+ * (tests/packaging-shipped-scripts-require-only-shipped.test.cjs, #2858).
+ * run-tests.cjs re-exports suiteOf from here unchanged for full backward
+ * compatibility — this is a pure relocation, not a behavior change.
+ *
+ * A file with no suite suffix (plain `foo.test.cjs`) belongs to the `unit`
+ * suite and returns `null` here; a suite-tagged file (`foo.install.test.cjs`)
+ * returns its marker string.
+ */
+
+const { basename } = require('node:path');
+
+const MARKED_SUITES = ['integration', 'install', 'security', 'slow', 'qa'];
+
+function suiteOf(filename) {
+  const name = basename(filename);
+  if (!name.endsWith('.test.cjs')) return null;
+  const base = name.slice(0, -'.test.cjs'.length);
+  const lastDot = base.lastIndexOf('.');
+  if (lastDot === -1) return null;
+  const marker = base.slice(lastDot + 1);
+  return MARKED_SUITES.includes(marker) ? marker : null;
+}
+
+module.exports = { MARKED_SUITES, suiteOf };