Skip to content

v2.42.0 - Bundled SDK: no more gsd-sdk prerequisite (#4)

Choose a tag to compare

View all tags
@jnuyens jnuyens released this 07 May 20:18
v2.42.0
39bd98e

No more gsd-sdk prerequisite. The plugin now bundles its own copy of the GSD SDK, so /plugin install gsd@gsd-plugin is genuinely the only install step for new users. Closes the architectural side of #4 (v2.41.1's README fix corrected the documentation; this release removes the prereq the documentation was trying to describe).

Highlights

  • 🎁 Bundled SDK — plugin ships sdk/dist/cli.js plus a bin/gsd-sdk wrapper that Claude Code automatically resolves on PATH for plugin Bash calls.
  • 🔁 Zero callsite rewrite — Claude Code already adds each plugin's bin/ to PATH, so the existing 500+ gsd-sdk invocations across workflows/ and skills/ resolve to the bundled wrapper unchanged.
  • 🔄 Backwards-compatible — users with an external gsd-sdk already on PATH (e.g. /opt/homebrew/bin from a prior npx get-shit-done-cc install) keep using their external one. Plugin bin/ is appended, not prepended.
  • 📦 Migration §2 of the README is now correct again: npm uninstall -g get-shit-done-cc is genuinely safe on v2.42.0+.

Added

  • sdk/ — full SDK source synced from upstream gsd-build/get-shit-done@v1.41.0 (src/, prompts/, scripts/, package.json, tsconfig.json).
  • sdk/dist/ — pre-built TypeScript output committed (override of upstream's dist/ gitignore — plugin users won't run npm install).
  • bin/gsd-sdk — POSIX shell wrapper.
  • bin/gsd-sdk.cmd — Windows batch wrapper with the same logic.

Plugin patches

Two SDK source patches for the plugin's flat directory layout (tagged [PLUGIN PATCH] inline):

  • sdk/src/query/state-project-load.ts — adds ${CLAUDE_PLUGIN_ROOT}/bin/lib/core.cjs as the first probe candidate.
  • sdk/src/query-gsd-tools-path.ts — same for gsd-tools.cjs.

Verified

  • gsd-sdk --version → v1.50.0-canary.0 (bundled, was the npm-published 0.1.0 previously)
  • gsd-sdk query state.load returns valid project config block
  • gsd-sdk query roadmap.analyze returns project milestones
  • gsd-sdk query commands returns full command list
  • MCP regression test from v2.40.2 still passes (tests/mcp-stdio-framing.test.cjs)

Versioning note

Bumping minor (2.41.x → 2.42.0) for a plugin-only feature even though upstream is still at 1.41.0. Standard rule (plugin_minor = upstream_minor) resumes when the next upstream sync lands; if upstream then ships 1.42.0, that sync goes out as 2.43.0 to avoid collision.

Credits

Reported by @ThomasHezard (#4, 2026-04-28) with line-precise investigation. Confirmed by @herman925 (2026-05-06).

Upgrade

/plugin marketplace update gsd-plugin
/plugin install gsd@gsd-plugin
/reload-plugins

After upgrade, if you'd previously kept get-shit-done-cc installed for the plugin's sake, you can now safely:

npm uninstall -g get-shit-done-cc

…and the bundled gsd-sdk will take over. Verify with which gsd-sdk (should resolve to the plugin cache bin/) and gsd-sdk --version (should print 1.50.0-canary.0 or later).

Full changelog: https://github.com/jnuyens/gsd-plugin/blob/master/CHANGELOG.md#2420---2026-05-07
Issue: #4

Assets 2
Loading