@opengsd/gsd-core 1.19.0 → 1.20.1

package/scripts/docs-guard-registry.cjs

@@ -163,6 +163,7 @@ const DOCS_GUARD_TESTS = {
     'docs/COMMANDS.md',
     'docs/how-to/run-phases-autonomously.md',
   ],
+  'tests/adr-612-bracket-new-project-config.test.cjs': ['docs/CONFIGURATION.md'],
   // Walks docs/adr/ as a directory (builds/reads docs/adr/README.md and
   // fixture ADRs throughout) and separately reads docs/contributor-standards.md.
   'tests/adr-index-gate.test.cjs': ['docs/adr/', 'docs/contributor-standards.md'],
@@ -319,6 +320,7 @@ const DOCS_GUARD_TESTS = {
   'tests/host-integration-descriptors.test.cjs': [
     'docs/reference/host-integration-capability-matrix.md',
   ],
+  'tests/inline-plan-threshold-default.test.cjs': ['docs/CONFIGURATION.md', 'docs/zh-CN/CONFIGURATION.md', 'docs/pt-BR/CONFIGURATION.md'],
   '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.

package/scripts/gen-features.cjs

@@ -666,6 +666,17 @@ function describeViolation(v) {
   }
 }
 
+/**
+ * Fragment bodies live in `docs/features/` and are emitted into `docs/FEATURES.md`, one
+ * directory up, so a relative markdown link target written for the fragment must lose
+ * `depth` leading `../` to resolve from the index (1 for a section; 2 for a group note from
+ * `docs/features/_groups/`). Only relative targets are touched:
+ * `http(s):`, `#anchor` and absolute `/` targets (and anything not starting `../`) pass through.
+ */
+function rewriteRelativeLinks(text, depth = 1) {
+  return text.replace(new RegExp(`\\]\\((?:\\.\\./){${depth}}`, 'g'), '](');
+}
+
 /** Render the generated region: the table of contents, then every section. */
 function renderFeatures(corpus) {
   const out = [START_MARKER, '', '## Table of Contents', ''];
@@ -677,10 +688,10 @@ function renderFeatures(corpus) {
 
   for (const g of corpus.groups) {
     out.push('', '---', '', `## ${g.title}`, '');
-    if (g.note) out.push(g.note, '');
+    if (g.note) out.push(rewriteRelativeLinks(g.note, 2), '');
     g.sections.forEach((s, i) => {
       if (i > 0) out.push('---', '');
-      out.push(`### ${s.id}. ${s.title}`, '', s.body, '');
+      out.push(`### ${s.id}. ${s.title}`, '', rewriteRelativeLinks(s.body), '');
     });
   }
 
@@ -836,6 +847,7 @@ module.exports = {
   checkInboundAnchors,
   buildCorpus,
   renderFeatures,
+  rewriteRelativeLinks,
   spliceIntoFeatures,
   describeViolation,
 };

package/scripts/lib/drift-scan.cjs

@@ -294,12 +294,39 @@ function sanitizeForReport(text) {
     .replace(/[\u200B-\u200F\u2028\u2029\u202A-\u202E\u2066-\u2069]/g, (c) => '\\u' + c.charCodeAt(0).toString(16).padStart(4, '0'));
 }
 
+/**
+ * Read the quoted or backtick-delimited string literal starting at `line[start]`
+ * (which must be `'`, `"`, or a backtick). Returns `{ text, end }` (`text`
+ * includes both delimiters, `end` is the index one past the literal) or null when
+ * no close quote is found within MAX_REGEX_LITERAL_LEN characters. Same single
+ * left-to-right, no-backtracking, escape-aware pass as `readRegexLiteralAt` (a
+ * `\x` escape consumes both characters, so an escaped quote never ends the
+ * literal early). A literal cannot span lines in a per-line scan. The older drift
+ * guards each carry their own byte-identical copy; new guards import this one.
+ */
+function readStringLiteralAt(line, start) {
+  const quote = line[start];
+  if (quote !== "'" && quote !== '"' && quote !== '`') return null;
+  const limit = Math.min(line.length, start + MAX_REGEX_LITERAL_LEN);
+  for (let i = start + 1; i < limit; i++) {
+    const ch = line[i];
+    if (ch === '\\') {
+      i++;
+      continue;
+    }
+    if (ch === '\r' || ch === '\n') return null;
+    if (ch === quote) return { text: line.slice(start, i + 1), end: i + 1 };
+  }
+  return null;
+}
+
 module.exports = {
   SKIP_DIR_NAMES,
   isInsideRoot,
   isUnderSkippedDir,
   walk,
   readRegexLiteralAt,
+  readStringLiteralAt,
   MAX_REGEX_LITERAL_LEN,
   sanitizeForReport,
   scanTree,

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

@@ -9,6 +9,8 @@ module.exports = {
   "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-612-bracket-phase-remove.test.cjs",
+  "tests/adr-612-bracket-write-path.test.cjs",
   "tests/adr-index-gate.test.cjs",
   "tests/adr-parser.property.test.cjs",
   "tests/adr-parser.unit.test.cjs",
@@ -32,6 +34,7 @@ module.exports = {
   "tests/capability-source.test.cjs",
   "tests/capability-state.test.cjs",
   "tests/capability-trust.test.cjs",
+  "tests/changeset-lint.test.cjs",
   "tests/changeset-parse.test.cjs",
   "tests/check-contract-drift.test.cjs",
   "tests/check-predicate.test.cjs",
@@ -63,6 +66,7 @@ module.exports = {
   "tests/contributor-standards.test.cjs",
   "tests/core-utils.test.cjs",
   "tests/cursor-subagent-isolation.test.cjs",
+  "tests/custom-phase-readers.test.cjs",
   "tests/debugger-semantic-recall.test.cjs",
   "tests/default-flip-documentation-lint.test.cjs",
   "tests/discuss-phase-power.test.cjs",
@@ -94,6 +98,7 @@ module.exports = {
   "tests/gen-context-index.test.cjs",
   "tests/gen-section-manifest.test.cjs",
   "tests/git-base-branch.test.cjs",
+  "tests/git-location-env-scrub.test.cjs",
   "tests/graphify-query.test.cjs",
   "tests/graphify-visualization.test.cjs",
   "tests/gsd-agent-isolation-guard.test.cjs",
@@ -101,6 +106,7 @@ module.exports = {
   "tests/gsd-secret-read-guard.test.cjs",
   "tests/gsd-settings-advanced.test.cjs",
   "tests/gsd-statusline.test.cjs",
+  "tests/gsd-tool-dir.platform.test.cjs",
   "tests/gsd-tools-path-refs.test.cjs",
   "tests/gsd-validate-commit-crash-policy.test.cjs",
   "tests/gsd-validate-commit-sigpipe.test.cjs",
@@ -138,6 +144,7 @@ module.exports = {
   "tests/markdown-sectionizer-xml-tags.property.test.cjs",
   "tests/markdown-sectionizer.test.cjs",
   "tests/mcp-catalog.test.cjs",
+  "tests/merge-commit-pr.test.cjs",
   "tests/milestone-archive.test.cjs",
   "tests/milestone-release-tags.test.cjs",
   "tests/milestone-window-single-owner.test.cjs",
@@ -197,11 +204,13 @@ module.exports = {
   "tests/quick-research.test.cjs",
   "tests/reapply-verify-hunks.test.cjs",
   "tests/refactor-1390-t3-characterization.test.cjs",
+  "tests/release-pipeline-pr.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-invocation.test.cjs",
+  "tests/review-lane-prompt-cap.test.cjs",
   "tests/review-lane-runner.test.cjs",
   "tests/review-lane-windows-spawn-resolution.test.cjs",
   "tests/review-parallel-lanes.test.cjs",
@@ -229,6 +238,7 @@ module.exports = {
   "tests/shell-command-projection-md-normalize.test.cjs",
   "tests/shipped-reference-cites.test.cjs",
   "tests/skill-manifest.test.cjs",
+  "tests/smart-entry.unit.test.cjs",
   "tests/spawn-liveness-banner.test.cjs",
   "tests/state-document.test.cjs",
   "tests/state-transition.test.cjs",

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

@@ -4,6 +4,9 @@
 module.exports = {
   CONFORMANCE_TIER_FILES: [
   "tests/5100-win32-bare-bash-sentinel.property.test.cjs",
+  "tests/adr-612-bracket-new-project-config.test.cjs",
+  "tests/adr-612-bracket-phase-remove.test.cjs",
+  "tests/adr-612-bracket-write-path.test.cjs",
   "tests/adr-index-gate.test.cjs",
   "tests/adr857-core-without-capabilities.test.cjs",
   "tests/agent-install-check.test.cjs",
@@ -52,7 +55,9 @@ module.exports = {
   "tests/claude-md.test.cjs",
   "tests/cline-install.test.cjs",
   "tests/close-phase-todos-padded-resolves.test.cjs",
+  "tests/code-review-cicd.test.cjs",
   "tests/code-review-fix-pipeline-regression.test.cjs",
+  "tests/code-review-necessity.test.cjs",
   "tests/code-review-pipeline-regression.test.cjs",
   "tests/code-review-tier3-files-override-scoping.test.cjs",
   "tests/code-review.test.cjs",
@@ -86,6 +91,7 @@ module.exports = {
   "tests/cursor-hook-workspace-roots.test.cjs",
   "tests/cursor-hooks.test.cjs",
   "tests/cursor-subagent-isolation.test.cjs",
+  "tests/custom-phase-readers.test.cjs",
   "tests/debug-session-management.test.cjs",
   "tests/defaults-json-fallback.test.cjs",
   "tests/diagnose-windows-spawn-watcher.test.cjs",
@@ -96,6 +102,7 @@ module.exports = {
   "tests/effort-local-install.test.cjs",
   "tests/effort-surface-axis.test.cjs",
   "tests/effort-sync-installed-runtime.test.cjs",
+  "tests/effort-sync-manifest.test.cjs",
   "tests/emitted-ack-trailer.test.cjs",
   "tests/emitted-attribution.test.cjs",
   "tests/emitted-provenance.test.cjs",
@@ -134,6 +141,7 @@ module.exports = {
   "tests/gen-health-docs.test.cjs",
   "tests/gen-section-manifest.test.cjs",
   "tests/git-base-branch.test.cjs",
+  "tests/git-location-env-scrub.test.cjs",
   "tests/git-optional-locks-parity.test.cjs",
   "tests/golden-install-tree.test.cjs",
   "tests/graphify-graph-path.test.cjs",
@@ -143,8 +151,10 @@ 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-mcp-server.test.cjs",
   "tests/gsd-path-export-hook.test.cjs",
   "tests/gsd-statusline.test.cjs",
+  "tests/gsd-tool-dir.platform.test.cjs",
   "tests/gsd-validate-commit-crash-policy.test.cjs",
   "tests/gsd-validate-commit-sigpipe.test.cjs",
   "tests/gsd-write-guard.test.cjs",
@@ -268,6 +278,7 @@ module.exports = {
   "tests/process-seam.test.cjs",
   "tests/profile-output.test.cjs",
   "tests/profile-pipeline.test.cjs",
+  "tests/progress-drift-guard.test.cjs",
   "tests/prohibition-enforcement.test.cjs",
   "tests/project-root.test.cjs",
   "tests/quick-batch-command-router.stdin.test.cjs",
@@ -278,6 +289,8 @@ module.exports = {
   "tests/quick-review-scope-tip-bound.test.cjs",
   "tests/read-guard.test.cjs",
   "tests/reapply-verify-hunks.test.cjs",
+  "tests/release-ancestry.test.cjs",
+  "tests/release-backmerge-invariants.test.cjs",
   "tests/repo-layout.test.cjs",
   "tests/representative-corpus.test.cjs",
   "tests/require-fs-op-fallback.rule.test.cjs",
@@ -290,6 +303,7 @@ module.exports = {
   "tests/review-lane-availability.test.cjs",
   "tests/review-lane-invocation.test.cjs",
   "tests/review-lane-no-redirect-5433.test.cjs",
+  "tests/review-lane-prompt-cap.test.cjs",
   "tests/review-lane-runner.test.cjs",
   "tests/review-lane-windows-spawn-resolution.test.cjs",
   "tests/review-model-config.test.cjs",
@@ -327,6 +341,7 @@ module.exports = {
   "tests/shipped-reference-cites.test.cjs",
   "tests/skill-manifest.test.cjs",
   "tests/slug-derivation-drift-guard.test.cjs",
+  "tests/smart-entry.unit.test.cjs",
   "tests/state-todos-render.test.cjs",
   "tests/state.platform.test.cjs",
   "tests/subject-first-line.platform.test.cjs",

package/scripts/lint-phase-enumeration-drift.cjs

@@ -191,6 +191,10 @@
  *     WHOLE ROADMAP (not milestone-scoped) for existing `2.N` ids — an id
  *     collision it must avoid can come from any milestone, so it needs the
  *     physical set, matching the CREATE-adjacent exemption category.
+ *   - `src/phase.cts` `collectPhaseDirNums` (#5528): the allocators' one on-disk scan,
+ *     run over the cwd's phases dir (cmdPhaseAdd/cmdPhaseAddBatch) and a sibling worktree's
+ *     (collectSiblingWorktreePhaseNums). It builds the set of USED phase numbers across
+ *     checkouts, not a milestone-scoped list, so listMilestonePhaseDirs cannot serve it.
  *   - `src/phase.cts` `cmdPhasePlanIndex`: resolves ONE caller-supplied
  *     `phase` id to its directory — a single-phase LOCATION lookup, not an
  *     enumeration of the current milestone's phase set.
@@ -316,10 +320,10 @@ const FUNCTION_SCOPED_EXEMPTIONS = new Map([
   [path.join('src', 'gate-phase-context.cts'), new Set(['resolvePhaseDirByToken'])],
   [path.join('src', 'init.cts'), new Set(['detectHasPriorPhases', 'detectUiPhaseActive'])],
   [path.join('src', 'milestone.cts'), new Set(['archivePhaseDirectories', 'cmdMilestoneComplete', 'cmdPhasesClear'])],
-  // #3849: collectSiblingWorktreePhaseNums reads a SIBLING worktree's phases dir —
-  // a different checkout listMilestonePhaseDirs (cwd-scoped) cannot serve; the
-  // allocators' own on-disk scans stay unexempted.
-  [path.join('src', 'phase.cts'), new Set(['cmdPhasesList', 'cmdPhaseNextDecimal', 'cmdPhasePlanIndex', 'cmdPhaseInsert', 'renameDecimalPhases', 'renameIntegerPhases', 'collectSiblingWorktreePhaseNums'])],
+  // #3849/#5528: collectPhaseDirNums is the allocators' one on-disk scan (the cwd's phases dir for
+  // cmdPhaseAdd/cmdPhaseAddBatch, a sibling worktree's for collectSiblingWorktreePhaseNums). It is a
+  // used-NUMBER roster across checkouts, not the milestone-scoped list listMilestonePhaseDirs serves.
+  [path.join('src', 'phase.cts'), new Set(['cmdPhasesList', 'cmdPhaseNextDecimal', 'cmdPhasePlanIndex', 'cmdPhaseInsert', 'renameDecimalPhases', 'renameIntegerPhases', 'collectPhaseDirNums'])],
   [path.join('src', 'audit.cts'), new Set(['listAuditPhaseTargets'])],
   [path.join('src', 'commands.cts'), new Set(['cmdHistoryDigest'])],
   [path.join('src', 'state.cts'), new Set(['cmdStateValidate', 'cmdStateSync', 'cmdStateRebuild', 'countRoadmapPhaseHeadings'])],