Files

Tom Boucher dacc23137a feat(3347): opt-in auto-update of knowledge graph after main HEAD advances

Closes #3347

Config:
- Add graphify.auto_update (default false) to manifests:
  sdk/shared/config-defaults.manifest.json, config-schema.manifest.json

Hook:
- hooks/gsd-graphify-update.sh — PostToolUse Bash matcher
  - Gates: tool_name=Bash, HEAD-advancing git op, CI=unset, in git repo,
    current branch == default branch (git.base_branch override or main/
    master/trunk fallback), graphify.enabled && graphify.auto_update both
    true, graphify on PATH, no live PID lock
  - Writes .planning/graphs/.last-build-status.json with status=running
    synchronously, then detaches hooks/lib/gsd-graphify-rebuild.sh
- hooks/lib/gsd-graphify-rebuild.sh — detached rebuild runner
  - PID-lock acquire + trap-on-exit cleanup
  - graphify update . then cp graphify-out/* → .planning/graphs/
  - Status file rewritten to status=ok|failed with exit_code, duration_ms,
    head_at_build
- Portable detach (subshell + disown, no setsid dependency)

Installer:
- bin/install.js: register hook as PostToolUse Bash matcher (5s timeout)
- Add to gsdHooks uninstall list and expectedShHooks warning list

Planner / researcher status surface (issue #3347 reviewer must-have AC):
- agents/gsd-planner.md and agents/gsd-phase-researcher.md
  load_graph_context steps now read .last-build-status.json and surface:
  running → "rebuild in flight"; failed → "auto-rebuild FAILED at {ts},
  context is from prior build"; ok with stale head_at_build → "HEAD has
  advanced since last build"

Settings:
- get-shit-done/workflows/settings.md adds "Graph auto-update" question
  with No-Recommended default; bullets and update_config block updated

Inventory:
- docs/INVENTORY.md hook count 12 → 13 with new row
- docs/INVENTORY-MANIFEST.json regenerated

Tests:
- tests/feat-3347-graphify-auto-update-config.test.cjs (8 tests):
  isValidConfigKey accepts graphify.auto_update, CANONICAL_CONFIG_DEFAULTS
  default false, config-set round-trip, sibling key preservation
- tests/feat-3347-graphify-auto-update-hook.test.cjs (18 tests):
  all bail paths (non-Bash, non-HEAD-advancing, enabled=false,
  auto_update=false, CI=true, non-default-branch, missing graphify bin,
  live-PID lock), dispatch path with mock graphify bin (sync running
  status + detached transition to ok/failed), stale-PID lock, all five
  HEAD-advancing command matchers, git.base_branch override

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-15 11:59:43 -04:00

2937-statusline-context-position.md

chore: pin changeset pr field to #3515

2026-05-14 15:46:35 -04:00

3033-sdk-flag-wired.md

fix(install): wire --sdk flag into installSdkIfNeeded (#3033 )

2026-05-06 21:55:45 -04:00

3095-quota-failure-classification.md

feat(execute-phase): classify quota/rate-limit failures across runtimes (#3095 ) (#3490 )

2026-05-14 07:46:56 -04:00

3156-plan-phase-opencode-dispatch.md

fix(plan-phase): remove agent: directive that caused OpenCode subagent dispatch (#3156 ) (#3206 )

2026-05-06 21:51:38 -04:00

3166-graphify-inline-build.md

fix(graphify): run /gsd-graphify build inline (with regression fence) (#3169 )

2026-05-06 11:56:27 -04:00

3170-graphify-commit-staleness.md

feat(graphify): commit-based staleness from built_at_commit (#3170 ) (#3171 )

2026-05-06 11:59:53 -04:00

3195-quick-resurrection-guard.md

fix(quick): port history-based resurrection guard from execute-phase.md (#3195 ) (#3201 )

2026-05-06 21:51:32 -04:00

3198-retrospective-canonical.md

fix(artifacts): register RETROSPECTIVE.md as canonical planning artifact (#3200 )

2026-05-06 21:51:29 -04:00

3210-fallow-structural-review.md

feat(code-review): integrate fallow structural pre-pass for /gsd-code-review (#3424 )

2026-05-13 21:19:47 -04:00

3251-non-family-aliases.md

feat(sdk): add NON_FAMILY_COMMAND_ALIASES to manifest — 14 missing commands (#3305 )

2026-05-09 11:46:40 -04:00

3262-extract-scan-phase-plans.md

feat(phase-plans): extract shared scanPhasePlans helper (k014) (#3308 )

2026-05-09 11:39:31 -04:00

3271-sdk-adr-structure.md

docs(adr): add docs/adr/README.md index and structural ADR test (#3302 )

2026-05-09 11:46:28 -04:00

3298-phase-dir-prefix-drift-workflows.md

fix(phase-dir): apply project_code prefix in plan-milestone-gaps, import, and add-backlog workflows (PRED.k015) (#3306 )

2026-05-09 11:47:15 -04:00

3312-sdk-first-architecture-seams.md

Refactor SDK-first architecture seams (#3316 )

2026-05-09 14:21:42 -04:00

3346-codex-aot-toml-key.md

fix(install): emit event-name leaf key for Codex AoT hooks migration (#3346 )

2026-05-14 10:43:09 -04:00

3347-graphify-auto-update-hook.md

feat(3347): opt-in auto-update of knowledge graph after main HEAD advances

2026-05-15 11:59:43 -04:00

3409-phase-remove-force-position.md

fix: accept flag-first syntax for phase remove (#3416 )

2026-05-11 21:13:07 -04:00

3450-shell-projection-merge-repair.md

feat(shell-projection): centralize managed hook command policy (#3450 )

2026-05-12 20:15:43 -04:00

3488-decimal-phase-depends-on.md

fix(sdk): expand short-form depends_on for decimal-phase plans (#3488 )

2026-05-14 08:28:11 -04:00

3489-complete-phase-idempotent.md

fix(sdk): make state.complete-phase idempotent (#3489 )

2026-05-14 07:47:18 -04:00

3491-nested-git-detection.md

fix(init): preserve inside=true on root lookup failures

2026-05-14 09:56:36 -04:00

3493-extract-milestone-generic-heading.md

fix(sdk): extractCurrentMilestone preserves generic Phase Details heading (#3493 )

2026-05-14 07:52:51 -04:00

3517-phase-complete-state-staleness.md

chore: pin changeset pr field to #3520

2026-05-14 17:22:34 -04:00

3537-phase-regex-fanout.md

fix(3537): route every phase-number ROADMAP regex through phaseMarkdownRegexSource (#3538 )

2026-05-14 23:17:38 -04:00

3541-installer-migration-prompt-user-resolution.md

fix: honor installer migration resolution env override

2026-05-15 09:16:41 -04:00

3542-executor-git-stash-prohibition.md

chore(3542): backfill PR number in changeset

2026-05-15 08:31:19 -04:00

3544-workstream-inventory-builder.md

chore: add changeset for workstream inventory builder

2026-05-15 09:36:47 -04:00

adr-0002-command-contract-validation.md

chore(changeset): add changeset for ADR-0002 enhancement (#3151 )

2026-05-05 15:36:45 -04:00

agile-birds-cheer.md

chore: add changeset fragment for #3046 (missing from contributor PR)

2026-05-06 15:41:37 -04:00

blue-stones-topology.md

Deepen query dispatch seam with Command Topology Module (#3078 )

2026-05-03 18:11:38 -04:00

bold-elks-zip.md

docs: replace retired /gsd-intel with /gsd-map-codebase --query (#3258 ) (#3260 )

2026-05-08 09:06:37 -04:00

bold-finches-rally.md

refactor(sdk): extract GSDTools transport seam + policy (#3058 )

2026-05-03 08:20:05 -04:00

brave-mice-build.md

refactor(query): deepen command/dispatch seams and resolve coderabbit findings

2026-05-03 15:29:34 -04:00

brave-wolves-rally.md

fix(config): allow model_overrides.<agent-id> in config-set (#3227 ) (#3253 )

2026-05-08 08:40:53 -04:00

bright-pumas-fold.md

refactor(query): deepen runtime context/native adapter/output seams (#3076 )

2026-05-03 16:31:48 -04:00

bug-3446-resume-continue-here-discovery.md

fix(resume-work): detect non-phase continue-here checkpoints (#3451 )

2026-05-12 21:20:54 -04:00

build-hooks-atomic-write.md

chore(changeset): add pr: 3216 to build-hooks-atomic-write changeset

2026-05-06 23:35:16 -04:00

calm-birds-greet.md

fix(#2990 ): gsd-code-fixer worktree attaches to a new branch, not the user-checked-out one (#3001 )

2026-05-02 00:29:43 -04:00

calm-herons-wake.md

fix(3259): non-mutating --help guard for native query handlers (#3272 )

2026-05-08 23:53:27 -04:00

calm-ibex-jump.md

test(#2986 ): mutation-killer suite for config-schema.cjs (95 typed assertions) (#3005 )

2026-05-01 21:13:25 -04:00

calm-koalas-hop.md

feat(plan-phase): add ADR ingest express path for approved enhancement #3209 (#3421 )

2026-05-11 23:01:34 -04:00

calm-tigers-frolic.md

fix(#3008 ): kill cross-process race in install-minimal:307 mid-copy test (#3009 )

2026-05-01 22:37:48 -04:00

careful-model-transport.md

fix(sdk): gate reasoning effort by runtime allowlist

2026-05-13 22:27:15 -04:00

clever-wasps-parade.md

correct changeset pr number

2026-05-10 14:44:23 -05:00

codex-bare-node-fix.md

fix(#3017 ): codex SessionStart hook uses absolute node, not bare 'node' (#3022 )

2026-05-02 11:45:30 -04:00

codex-discuss-fallback.md

fix(#3018 ): codex adapter must stop and ask, not silently default decisions (#3027 )

2026-05-02 11:45:36 -04:00

codex-windows-bash-runner.md

Fix(hooks): resolve Windows Bash hook runner (#3397 )

2026-05-11 15:32:21 -04:00

codex-windows-hook-script-paths.md

Fix(hooks): normalize Windows managed hook script paths (#3396 )

2026-05-11 15:27:44 -04:00

cool-monkeys-smell.md

refactor(cli): extract Query CLI Adapter Module seam (#3074 )

2026-05-03 15:57:01 -04:00

crisp-seams-align.md

feat(sdk): deepen package seam for legacy query compatibility (#3419 )

2026-05-11 21:12:29 -04:00

curious-bears-march.md

fix(#3010 ): post-install message and docs use /gsd-update --reapply (#3012 )

2026-05-02 09:38:34 -04:00

curious-bears-zip.md

fix: address coderabbit doc and ordering feedback

2026-05-15 10:14:37 -04:00

daring-badgers-munch.md

feat: add review.default_reviewers config for /gsd-review defaults (#3464 )

2026-05-13 14:10:15 -04:00

disable-milestone-tags.md

chore: pin changeset pr field to #3508

2026-05-14 12:09:55 -04:00

docs-1-40-0-audit.md

docs: audit and update docs/ for v1.40.0 release (#3048 )

2026-05-03 07:33:27 -04:00

dynamic-routing.md

feat(#3024 ): dynamic routing with failure-tier escalation (#3031 )

2026-05-02 14:26:35 -04:00

eager-badgers-purr.md

chore(changeset): add changelog fragment for sdk runtime bridge seam

2026-05-05 19:40:33 -04:00

eager-elks-purr.md

fix: reconcile planner action contract (#3326 )

2026-05-09 19:27:36 -04:00

eager-hawks-rally.md

feat(#2975 ): adopt changeset-fragment workflow to eliminate CHANGELOG conflicts (#2978 )

2026-05-01 18:12:20 -04:00

eager-lynx-munch.md

fix: gsd-debug-session-manager uses stale Task() dispatcher (#3462 )

2026-05-13 14:11:02 -04:00

fair-hawks-play.md

feat: route Codex hook commands through projection seam (#3444 )

2026-05-12 18:16:36 -04:00

feat-3408-skill-profiles.md

feat(skill-surface): install-time profiles + runtime /gsd:surface (#3408 ) (#3456 )

2026-05-13 12:45:16 -04:00

feat-3408-skill-surface.md

feat(skill-surface): install-time profiles + runtime /gsd:surface (#3408 ) (#3456 )

2026-05-13 12:45:16 -04:00

fierce-birds-wake.md

fix(install): accept Codex TOML floats; idempotent rollback (#3245 ) (#3254 )

2026-05-08 10:25:59 -04:00

fierce-geese-march.md

feat(3309): workflow.human_verify_mode = end-of-phase (new default; mid-flight opt-back-in) (#3325 )

2026-05-09 23:29:11 -04:00

fix-3054-doc-anchor-and-token-check.md

fix(3054): align docs anchors and structured stale-command checks

2026-05-04 23:30:35 -04:00

fix-3056-worktree-path-assertion.md

test(3056): canonicalize worktree paths in prune assertions

2026-05-04 23:28:20 -04:00

fix-3072-findings-probe-assertions.md

test(3072): parse bash blocks for findings probe guard checks

2026-05-04 23:28:52 -04:00

fix-3087-planner-directive-language.md

fix(#3087 ): restore 10 demoted directive phrases in gsd-planner.md (#3138 )

2026-05-05 15:02:03 -04:00

fix-3088-milestone-state-fallback-sections.md

fix(3088): append missing STATE narrative sections on milestone close

2026-05-04 23:29:45 -04:00

fix-3094-progress-stale-assumptions.md

test(3094): switch stale-progress assertion to structured token check

2026-05-04 23:27:38 -04:00

fix-3096-ai-integration-parallel-race.md

fix(#3096 ): enforce sequential Steps 7+8 + Edit-only tool discipline in ai-integration-phase (#3143 )

2026-05-05 15:02:23 -04:00

fix-3097-3099-executor-worktree-path.md

fix(#3097 , #3099 ): add cwd-drift sentinel + absolute-path guard to executor worktree protocol (#3144 )

2026-05-05 15:02:26 -04:00

fix-3120-secure-phase-empty-register.md

fix(#3120 ): add register_authored_at_plan_time guard — prevent rubber-stamping legacy phases (#3142 )

2026-05-05 15:02:19 -04:00

fix-3121-gsd-tools-commands-verb.md

fix(#3121 ): implement commands verb in SDK native registry (#3146 )

2026-05-05 15:02:34 -04:00

fix-3126-global-skills-base-runtime.md

fix(#3126 ): replace hardcoded globalSkillsBase with first-class runtime-aware mapping (#3140 )

2026-05-05 15:02:11 -04:00

fix-3127-state-begin-phase-idempotent.md

fix(#3127 ): make state.begin-phase idempotent on mid-flight phases (#3145 )

2026-05-05 15:02:30 -04:00

fix-3128-roadmap-plan-count-slug.md

fix(#3128 ): extend roadmap.cjs plan-count to detect {N}-PLAN-{NN}-{slug}.md layout (#3139 )

2026-05-05 15:02:07 -04:00

fix-3129-validate-commit-bypass.md

fix(#3129 ): replace bypassed bash regex with token-walk git-cmd.js classifier (#3141 )

2026-05-05 15:02:15 -04:00

fix-3130-update-npx-robust.md

fix(#3130 ): harden update.md npx invocations against cache-stale and token-routing failures (#3136 )

2026-05-05 15:01:59 -04:00

fix-3135-capture-backlog-workflow.md

fix(#3135 ): restore workflows/add-backlog.md — capture --backlog had no workflow to load (#3147 )

2026-05-05 15:02:38 -04:00

fix-3150-stats-json-decimal-gap-regression.md

chore(3155): address CodeRabbit changeset ref and test diagnostics

2026-05-05 18:53:35 -04:00

fix-3153-statusline-percent-next-phases.md

fix(3153): handle numeric 100 percent and block-list next_phases

2026-05-05 18:34:42 -04:00

fix-3163-codex-agents-md.md

fix(plan-phase): remove agent: directive that caused OpenCode subagent dispatch (#3156 ) (#3206 )

2026-05-06 21:51:38 -04:00

fix-3196-workstream-milestone-op.md

fix(query): workstream resolution in init.milestone-op and roadmap.analyze (#3196 )

2026-05-06 22:01:45 -04:00

fix-3197-gsd-tools-config-whitelist.md

fix(config): regression test and changeset for #3197 gsd-tools config-whitelist (#3208 )

2026-05-06 21:51:42 -04:00

fix-3229-model-catalog-source-of-truth.md

fix(#3229 ): shared model catalog source of truth for agent profiles + runtime tier defaults (#3230 )

2026-05-08 21:25:37 -04:00

fix-3321-verifier-probes.md

fix(verifier): require direct probe execution

2026-05-10 17:37:55 -04:00

fix-3339-human-needed-verification-pending.md

fix(3323): keep human-needed verification pending (#3339 )

2026-05-09 23:28:25 -04:00

fix-3344-gemini-agent-tool.md

fix(gemini): drop Agent dispatcher tool (#3349 )

2026-05-10 11:20:06 -04:00

fix-3355-phase-remove-roadmap-renumber.md

fix(phase): prevent roadmap renumber collapse

2026-05-10 17:38:40 -04:00

fix-3357-codex-legacy-hooks-json.md

fix(codex): remove legacy hooks json update hook

2026-05-10 17:38:03 -04:00

fix-3358-sdk-init-progress-models.md

fix(sdk): honor Codex model overrides in init progress

2026-05-10 17:40:11 -04:00

fix-3359-stale-sdk-path-version.md

fix(installer): warn on stale gsd-sdk path

2026-05-10 17:40:39 -04:00

fix-3360-codex-execute-worktrees.md

fix(codex): block unsupported execute worktrees

2026-05-10 17:38:36 -04:00

fix-3362-windows-powershell-gemini.md

fix(gemini): make Windows hooks and agent tools valid

2026-05-10 17:39:06 -04:00

fix-3381-init-verify-work-ws.md

fix: honor workstream in verify-work init (#3386 )

2026-05-10 20:25:42 -04:00

fix-3384-worktree-merge-safety.md

fix: make worktree cleanup fail closed (#3385 )

2026-05-10 19:48:28 -04:00

fix-3509-path-spaces-test-suite.md

chore: pin changeset pr field to #3510

2026-05-14 12:44:25 -04:00

fix-canary-2-release-gates.md

fix(plan-phase): remove agent: directive that caused OpenCode subagent dispatch (#3156 ) (#3206 )

2026-05-06 21:51:38 -04:00

gallant-badgers-bark.md

fix(install): prefer stable Homebrew symlinks over versioned Cellar paths in node runner

2026-05-06 22:06:56 -04:00

gallant-ravens-travel.md

Deepen SDK package seam and converge runtime skills policy (#3238 )

2026-05-08 09:06:43 -04:00

gemini-skip-local-when-global.md

fix(install): skip Gemini local commands/gsd when global GSD present (#3037 ) (#3041 )

2026-05-02 17:44:52 -04:00

gentle-bears-wave.md

fix(state): preserve curated progress on body-only updates; correct percent formula (#3242 ) (#3252 )

2026-05-08 08:40:47 -04:00

gentle-birds-caper.md

fix(commit): scope every commit call to its staged pathspec

2026-05-05 15:30:05 -03:00

gentle-goats-fly.md

fix(sdk): anchor extractFrontmatter at file start (#3240 ) (#3247 )

2026-05-08 08:40:30 -04:00

gentle-jays-zip.md

docs: add changeset for installer migration phase two

2026-05-10 23:10:10 -04:00

gentle-tigers-roar.md

feat(3255): add --json-errors structured error mode to gsd-tools (#3304 )

2026-05-09 11:46:34 -04:00

graceful-geese-tumble.md

fix(sdk): reduce validate.health false positives (#3479 )

2026-05-13 19:25:14 -04:00

graceful-moles-wave.md

chore: pin changeset pr field to #3526

2026-05-14 19:02:53 -04:00

graceful-otters-wave.md

feat(security): package legitimacy gate against slopsquatting (#3215 )

2026-05-08 09:08:06 -04:00

graceful-sloths-wake.md

fix: stabilize /gsd-progress flag routing parse contract (#3420 )

2026-05-11 22:09:59 -04:00

happy-jays-greet.md

fix(#2994 ): move verify-reapply-patches.cjs to get-shit-done/bin/ so it ships to user installs (#3000 )

2026-05-02 00:29:34 -04:00

happy-jays-wake.md

fix(worktree): bound git subprocesses with timeout + surface degraded health (#3281 ) (#3283 )

2026-05-09 01:53:50 -04:00

happy-tigers-travel.md

refactor(query): extract command catalog seam for registry wiring (#3060 )

2026-05-03 13:57:32 -04:00

help-passthrough.md

fix(#3019 ): query --help reaches handler instead of short-circuiting (#3026 )

2026-05-02 11:45:33 -04:00

humble-goats-swim.md

refactor(query): extract command catalog seam for registry wiring (#3060 )

2026-05-03 13:57:32 -04:00

humble-tunas-leap.md

fix(3263): harden code-review SUMMARY parser; accept BL-/blocker as Critical-tier across pipeline (#3274 )

2026-05-08 23:53:32 -04:00

install-shell-path-probe.md

fix(#3020 ): probe user shell PATH at install-time, not just process.env.PATH (#3028 )

2026-05-02 11:45:39 -04:00

issue-driven-orchestration.md

docs: add issue-driven orchestration guide (#2840 ) (#3036 )

2026-05-02 16:57:42 -04:00

jolly-newts-roam.md

fix(#2994 ): move verify-reapply-patches.cjs to get-shit-done/bin/ so it ships to user installs (#3000 )

2026-05-02 00:29:34 -04:00

jolly-pumas-dance.md

fix(#2979 ): emit absolute node path in managed hooks for GUI/minimal-PATH runtimes (#3002 )

2026-05-02 00:40:09 -04:00

kind-foxes-click.md

feat(sdk): add --respect-staged opt-in to gsd-sdk query commit --files (#3522 )

2026-05-14 19:08:08 -04:00

lively-goats-run.md

feat(#2995 ): post-install path audit for workflow-invoked scripts (#2996 )

2026-05-01 21:13:45 -04:00

lively-lemurs-glide.md

fix(state): record-metric/add-decision: auto-create sections + workstream routing (#3286 ) (#3291 )

2026-05-09 07:40:56 -04:00

lively-moles-caper.md

fix: scope milestone complete stats to explicit version

2026-05-04 22:06:22 -04:00

lively-otters-gather.md

fix(#3011 ): actionable SDK-not-on-PATH diagnostic with shim location and shell-specific commands (#3014 )

2026-05-02 09:30:58 -04:00

mcp-token-budget-docs.md

docs(#3025 ): MCP tool schema as a context-budget concern (#3032 )

2026-05-02 15:24:26 -04:00

mellow-lynx-forage.md

fix(install): allow codex hooks.state.<key> as regular table (#3285 ) (#3289 )

2026-05-09 07:42:22 -04:00

merry-foxes-climb.md

fix(#2997 ): mask SECRET_CONFIG_KEYS in SDK config-set/get and init responses (#2999 )

2026-05-02 00:17:45 -04:00

merry-lynx-sing.md

fix(#2992 ): deterministic latest-version check — package name is a constant, not LLM choice (#2993 )

2026-05-02 00:29:31 -04:00

merry-lynx-wander.md

fix(#3006 ): retarget PR-template CHANGELOG checkboxes at the changeset workflow (#3007 )

2026-05-01 20:01:04 -04:00

merry-moles-chatter.md

refactor(query): extract command catalog seam for registry wiring (#3060 )

2026-05-03 13:57:32 -04:00

merry-quails-roam.md

docs: add changeset for installer migrations

2026-05-10 22:24:47 -04:00

mvp-concept-cleanup-canary-prep.md

fix(plan-phase): remove agent: directive that caused OpenCode subagent dispatch (#3156 ) (#3206 )

2026-05-06 21:51:38 -04:00

mvp-resolution-verbs-and-fix-sdk-mode.md

fix(plan-phase): remove agent: directive that caused OpenCode subagent dispatch (#3156 ) (#3206 )

2026-05-06 21:51:38 -04:00

new-project-agent-diagnostics.md

Fix(workflow): expose new-project agent diagnostics (#3390 )

2026-05-11 15:27:35 -04:00

nimble-deer-chatter.md

fix(sdk): phase.add honors --dry-run; rejects unknown flags (#3226 ) (#3246 )

2026-05-08 08:40:24 -04:00

nimble-lynx-tumble.md

fix(workstream): normalize migration workstream names (#3269 )

2026-05-09 00:15:04 -04:00

nimble-sloths-zip.md

fix: state mutations recurse when Current Position has dollar amounts (#3463 )

2026-05-13 13:54:30 -04:00

noble-badgers-roar.md

refactor(query): extract command catalog seam for registry wiring (#3060 )

2026-05-03 13:57:32 -04:00

noble-jaguars-squeak.md

fix: extend fix-slash-commands SEARCH_DIRS to agents/, sdk/src/, .clinerules

2026-05-05 13:19:10 -04:00

noble-mice-squeak.md

fix(sdk): skip terminal-labeled phases in init.progress next_phase (#3478 )

2026-05-13 19:34:53 -04:00

noble-otters-hop.md

fix(3266): preserve wave 0 and bucket plans by depends_on DAG in phase-plan-index (#3276 )

2026-05-09 00:25:05 -04:00

patient-lemurs-sing.md

chore(3536): add changeset fragment for user-facing surfaces

2026-05-15 08:25:06 -04:00

per-phase-type-models.md

feat(#3023 ): per-phase-type model map in .planning/config.json (#3030 )

2026-05-02 13:19:15 -04:00

phase-five-installer-migration-guardrails.md

Docs(changeset): set phase 5 PR number

2026-05-11 10:46:22 -04:00

plucky-eagles-roar.md

fix: pin cleanup to primary worktree (#3437 )

2026-05-12 18:50:50 -04:00

plucky-ibex-gather.md

fix(#2998 ): populate gsd-pristine/ from install transform pipeline so verifier has a real baseline (#3004 )

2026-05-01 21:14:14 -04:00

plucky-lemurs-dance.md

feat(shell-projection): route PATH guidance through typed action projection (#3447 )

2026-05-12 19:19:04 -04:00

plucky-moles-roam.md

fix(#2997 ): mask SECRET_CONFIG_KEYS in SDK config-set/get and init responses (#2999 )

2026-05-02 00:17:45 -04:00

plucky-otters-roam.md

feat(#2995 ): post-install path audit for workflow-invoked scripts (#2996 )

2026-05-01 21:13:45 -04:00

plucky-pandas-sprint.md

chore: update changeset pr reference

2026-05-04 21:49:40 -04:00

portable-bash-shebang-hooks.md

chore(changeset): correct PR number for portable bash hooks

2026-05-06 20:32:12 -04:00

pr-3112-release-note.md

chore(changeset): add release fragment for PR #3112

2026-05-04 23:32:15 -04:00

pr-3113-release-note.md

chore(changeset): add release fragment for PR #3113

2026-05-04 23:32:14 -04:00

pr-3115-release-note.md

chore(changeset): add release fragment for PR #3115

2026-05-04 23:32:12 -04:00

pr-3116-release-note.md

chore(changeset): add release fragment for PR #3116

2026-05-04 23:32:11 -04:00

pr-3118-release-note.md

chore(changeset): add release fragment for PR #3118

2026-05-04 23:32:09 -04:00

pr-3123-release-note.md

chore(changeset): add release fragment for PR #3123

2026-05-04 23:32:07 -04:00

pr-3124-release-note.md

chore(changeset): add release fragment for PR #3124

2026-05-04 23:32:06 -04:00

pr-3125-release-note.md

chore(changeset): correct issue reference for PR #3125 fragment

2026-05-04 23:49:00 -04:00

quick-deer-squeak.md

feat(shell-projection): add shim wrapper drift guard (#3448 )

2026-05-12 20:49:43 -04:00

quick-geese-hum.md

refactor(query): extract command catalog seam for registry wiring (#3060 )

2026-05-03 13:57:32 -04:00

quick-voles-sprint.md

fix(install): require persistent SDK reachability before reporting ready (#3231 ) (#3249 )

2026-05-08 09:39:33 -04:00

quiet-geckos-switch.md

fix(claude): restore namespaced /gsd:<command> references (#3452 )

2026-05-12 21:53:24 -04:00

rapid-goats-munch.md

refactor(query): extract command catalog seam for registry wiring (#3060 )

2026-05-03 13:57:32 -04:00

README.md

feat(#2975 ): adopt changeset-fragment workflow to eliminate CHANGELOG conflicts (#2978 )

2026-05-01 18:12:20 -04:00

research-flag-and-stale-refs.md

feat(plan-phase): --research-phase flag + scrub stale slash-command refs (#3042 , #3044 ) (#3045 )

2026-05-02 23:12:50 -04:00

rewire-orphaned-workflows-3131.md

fix: short-circuit --assumptions and --from-gsd2 dispatch; add changeset

2026-05-05 11:05:17 -04:00

scrub-stale-command-routes.md

fix(workflows,docs): scrub stale /gsd-code-review-fix and /gsd-plan-milestone-gaps refs (#3029 , #3034 ) (#3038 )

2026-05-02 17:23:44 -04:00

sdk-init-phase-flags.md

Fix(workflow): normalize SDK init phase flags (#3389 )

2026-05-11 15:27:32 -04:00

serene-pandas-zip.md

docs: clarify gsd-update reapply changeset

2026-05-14 19:43:59 -04:00

sharp-badgers-squeak.md

fix(3265): prefer YAML frontmatter for state-snapshot canonical fields (#3275 )

2026-05-08 23:53:21 -04:00

shell-projection-cleanup.md

refactor(shell-projection): remove deprecated wrappers + finalize ADRs (Phase 4, #3468 ) (#3484 )

2026-05-13 20:46:02 -04:00

shell-projection-fs-migration.md

refactor(shell-projection): migrate all fs call sites to platform* seam (Phase 3, #3467 ) (#3481 )

2026-05-13 19:34:23 -04:00

shell-projection-io-seam.md

feat(shell-projection): add exec* dispatch and platform* file I/O seam (#3465 ) (#3470 )

2026-05-13 17:12:53 -04:00

shell-projection-subprocess-migration.md

refactor(shell-projection): migrate all subprocess call sites to exec*/probeTty seam (Phase 2, #3466 ) (#3476 )

2026-05-13 18:33:32 -04:00

silly-badgers-frolic.md

fix(cjs): accept dotted canonical command form (#3243 ) (#3248 )

2026-05-08 08:40:36 -04:00

silly-foxes-sing.md

fix(install): Windows persistent SDK shim; replace legacy gsd-tools.cjs shim (#3211 ) (#3282 )

2026-05-09 02:03:57 -04:00

silly-foxes-wander.md

fix(#2990 ): gsd-code-fixer worktree attaches to a new branch, not the user-checked-out one (#3001 )

2026-05-02 00:29:43 -04:00

silly-jaguars-sing.md

fix: align planner plan contract with phase index (#3436 )

2026-05-12 18:50:35 -04:00

silly-newts-swim.md

feat(#2982 ): extend no-source-grep lint to catch var-binding readFileSync.includes() (#2985 )

2026-05-01 19:50:10 -04:00

steady-bears-purr.md

fix(sdk): state.prune current phase fallback handling (#3477 )

2026-05-13 19:24:07 -04:00

steady-jays-click.md

fix(install): copy sdk/shared/model-catalog.json + resolve chain in CJS (#3288 ) (#3293 )

2026-05-09 07:40:17 -04:00

steady-ravens-shape.md

refactor(query): deepen dispatch policy seam with structured result contract (#3066 )

2026-05-03 14:30:27 -04:00

steady-shell-projection.md

feat: deepen shell command projection seam (#3445 )

2026-05-12 19:02:18 -04:00

steady-yaks-caper.md

Add changeset for baseline migration

2026-05-10 23:26:45 -04:00

sturdy-finches-fly.md

fix(state): count nested plans/ files in buildStateFrontmatter (#3257 ) (#3261 )

2026-05-08 09:26:35 -04:00

sturdy-jays-glide.md

refactor(query): extract command catalog seam for registry wiring (#3060 )

2026-05-03 13:57:32 -04:00

sturdy-rams-caper.md

docs(3232): codify contributor standards (CONTEXT.md, ADRs, AI-agent work) (#3301 )

2026-05-09 11:39:24 -04:00

sturdy-rams-forage.md

fix: add executor stall recovery contract (#3329 )

2026-05-09 23:28:52 -04:00

sturdy-sloths-hum.md

fix(capture): restore one-shot --seed contract (#3236 ) (#3250 )

2026-05-08 08:40:41 -04:00

sturdy-wolves-frolic.md

Feat(ship): add configurable PR body sections (#3391 )

2026-05-11 15:27:40 -04:00

sunny-dogs-frolic.md

feat(3310): wire remaining ERROR_REASON typed codes into gsd-tools (#3311 )

2026-05-09 13:54:06 -04:00

sunny-ibex-wave.md

fix(intel): gate layout-detection block on framework-repo check (#3290 ) (#3299 )

2026-05-09 11:39:15 -04:00

sunny-pandas-dance.md

fix: address branching strategy review findings

2026-05-14 19:44:01 -04:00

swift-coyotes-document.md

docs: add Prerelease editions install guidance (Next/Nightly/Insiders/Preview) (#3173 )

2026-05-06 12:44:48 -04:00

tidy-finches-caper.md

fix(3264): document cross-wave-deviation cleanup tail in execute-phase step 5.5 (#3273 )

2026-05-09 00:14:54 -04:00

tidy-herons-dance.md

fix(sdk): preserve same-milestone archived phase handling (#3480 )

2026-05-13 19:25:33 -04:00

tidy-tigers-dance.md

chore: revert redundant CHANGELOG.md row from #3308 (use .changeset/ fragment) (#3313 )

2026-05-09 13:35:57 -04:00

tidy-tunas-zip.md

docs: fix changeset summary text

2026-05-04 21:49:38 -04:00

typed-rivers-flow.md

test(#2974 ): migrate 8 test files to typed-IR assertions (#3016 )

2026-05-02 09:27:23 -04:00

update-banner-opt-in.md

feat(hooks): opt-in SessionStart update banner for non-statusline users (#2795 ) (#3035 )

2026-05-02 16:33:16 -04:00

verifier-debt-gate.md

fix: block verifier pass on unresolved debt markers (#3343 )

2026-05-10 11:19:50 -04:00

vivid-foxes-romp.md

Feat(installer): harden phase 4 migration integration

2026-05-11 10:02:02 -04:00

windows-npm-shell-fix.md

fix(changeset): add missing pr: 3102 field to windows-npm-shell-fix

2026-05-06 20:53:57 -04:00

wise-foxes-romp.md

chore: add changeset fragment for #3189

2026-05-06 15:21:29 -04:00

wise-koalas-climb.md

fix: quote debug command argument-hint (#3435 )

2026-05-12 18:50:19 -04:00

wise-mice-cheer.md

chore: add changeset fragment for #3188

2026-05-06 15:21:24 -04:00

wise-rams-gather.md

fix(3317): SDK detect-custom-files now scans skills/ (parity with CJS port) (#3318 )

2026-05-09 23:28:10 -04:00

witty-geese-purr.md

fix(phase): unify phase-dir naming via shared helper across creation paths (#3287 ) (#3292 )

2026-05-09 07:32:31 -04:00

witty-hawks-jump.md

fix(#2973 ): /gsd-profile-user writes dev-preferences.md to skills/, not legacy commands/gsd/ (#3003 )

2026-05-02 00:29:45 -04:00

witty-newts-greet.md

fix(#2992 ): deterministic latest-version check — package name is a constant, not LLM choice (#2993 )

2026-05-02 00:29:31 -04:00

witty-wasps-hum.md

chore: add changeset fragment for #3191

2026-05-06 15:21:30 -04:00

zesty-goats-dart.md

docs: adopt issue#-prefix naming for ADRs/PRDs to eliminate parallel-developer collisions (#3487 )

2026-05-13 21:20:08 -04:00

zesty-jays-wake.md

fix(#2979 ): emit absolute node path in managed hooks for GUI/minimal-PATH runtimes (#3002 )

2026-05-02 00:40:09 -04:00

zesty-moles-forage.md

feat(#2982 ): extend no-source-grep lint to catch var-binding readFileSync.includes() (#2985 )

2026-05-01 19:50:10 -04:00

zesty-ravens-rest.md

fix: scope Windows hook syntax to Gemini runtime (#3438 )

2026-05-12 17:32:50 -04:00

README.md

Changeset Fragments

This directory holds per-PR CHANGELOG fragments. Every PR with user-facing changes drops one (or more) <random-name>.md files here describing its CHANGELOG entry. Fragments are consolidated into the top-level CHANGELOG.md at release time.

Why

Two PRs that both edit the ### Fixed block of CHANGELOG.md always conflict on merge — git can't pick a serialization order without human input. Two PRs that each add a fresh .changeset/<unique-name>.md never conflict because they don't share lines.

See #2975 for the full rationale.

Adding a fragment

node scripts/changeset/new.cjs \
  --type Fixed \
  --pr 1234 \
  --body "fix the thing — explain the user-visible change in one sentence"

This writes .changeset/<adjective>-<noun>-<noun>.md with frontmatter and a body. Three random words → concurrent PRs don't collide.

Format

---
type: Fixed
pr: 1234
---
**`/gsd-foo` no longer drops trailing slashes** — explain the user-visible change.

Allowed type: values follow Keep a Changelog: Added, Changed, Deprecated, Removed, Fixed, Security.

Opting out

PRs that legitimately have no user-facing impact can add the no-changelog label. CI honors it. When unsure, add the fragment.

At release time

node scripts/changeset/cli.cjs render --version vX.Y.Z --date YYYY-MM-DD

Reads every fragment, groups bullets by type:, replaces ## [Unreleased] with a new ## [vX.Y.Z] - YYYY-MM-DD block, opens a fresh ## [Unreleased] above, deletes consumed fragments. Idempotent.