gsd-build/get-shit-done v1.42.0-rc4

on GitHub

v1.42.0-rc4 completes the four-phase shell command projection seam refactor (#3465–#3468), ships the install-time skill-surface profiles work, adds the optional fallow structural pre-pass to /gsd-code-review, and fixes a string of SDK state-handling bugs.

Added

Skill surface

• Install-time skill profiles + runtime /gsd:surface command - users select a skill profile at install time and switch profiles at runtime without reinstalling. (#3456)

Code review & review tooling

• Optional fallow structural pre-pass for /gsd-code-review - cross-module structural findings from fallow are injected as a distinct <structural_findings> block in the reviewer prompt and rendered in a separate ## Structural Findings (fallow) section of REVIEW.md. Off by default; opt in via code_quality.fallow.enabled. (#3424)
• review.default_reviewers config for /gsd-review - the default reviewer roster can be configured project-wide instead of being passed per invocation. (#3464)

Changed

Architecture & SDK seams

• Shell command projection seam: exec* dispatch + platform* file I/O - new typed seam covers subprocess and filesystem call sites uniformly. (#3470)
• All subprocess call sites migrated to the exec* / probeTty seam (Phase 2) - direct child_process.spawn / execFile usage replaced with the typed projection. (#3476)
• All filesystem call sites migrated to the platform* seam (Phase 3) - direct fs.* usage replaced with the typed projection where the seam applies. (#3481)
• Deprecated wrappers removed; shell-projection ADRs finalized (Phase 4) - transitional re-exports cleaned up after migration; ADRs marked accepted. (#3484)
• Shim wrapper drift guard - install-time check verifies shim wrappers have not drifted from the canonical projection. (#3448)

Docs & conventions

• ADRs and PRDs adopt issue#-prefix naming - parallel developers no longer collide on ADR-NNNN / PRD-NNNN numbering. (#3487)

Fixed

State & SDK

• state mutations no longer recurse when Current Position contains dollar amounts - $NNN patterns in state body content no longer trigger expansion loops. (#3463)
• state.prune honors the documented current-phase fallback - pruning a state with no current phase no longer throws. (#3477)
• validate.health false-positive rate reduced - non-actionable warnings on healthy projects are suppressed. (#3479)
• Same-milestone archived phases preserved - the SDK no longer drops archived phases from the active milestone. (#3480)
• Terminal-labeled phases skipped in init.progress next-phase computation - completed / abandoned phases no longer reappear as the next candidate. (#3478)

Resume & dispatcher

• /gsd-resume-work detects non-phase continue-here checkpoints - resume now handles checkpoints created outside a phase context. (#3451)
• Namespaced /gsd:<command> references restored for the Claude runtime - bare /gsd-* references in agent prompts are rewritten to the namespaced form where required. (#3452)
• gsd-debug-session-manager uses a current Task() dispatcher - the agent no longer references the deprecated dispatcher signature. (#3462)

This is a release candidate. Install for testing:

npx get-shit-done-cc@next

Full Changelog: v1.42.0-rc3...v1.42.0-rc4