Files

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

Closes #3522. When --respect-staged is passed the git add loop is skipped
entirely so per-hunk staging from git add -p is preserved. Default behavior
(full re-stage) is unchanged. The #3061 pathspec invariant holds under both
modes. Nothing-staged within scope returns { committed: false, reason:
'nothing staged' } without error.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

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

docs

docs(sdk): recommend 1-hour cache TTL for system prompts (#2055 )

2026-04-12 08:09:44 -04:00

prompts/templates

fix(sdk): use installed agent/workflow prompts instead of stripped-down bundled copies

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

scripts

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

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

shared

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

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

src

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

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

test-fixtures

feat: GSD SDK — headless CLI with init + auto commands (#1407 )

2026-03-26 20:27:51 -06:00

HANDOVER-GOLDEN-PARITY.md

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341 )

2026-04-20 18:09:02 -04:00

HANDOVER-PARITY-DOCS.md

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341 )

2026-04-20 18:09:02 -04:00

HANDOVER-QUERY-LAYER.md

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341 )

2026-04-20 18:09:02 -04:00

package-lock.json

feat(sdk): add durable planning runtime (#2898 )

2026-04-30 09:03:06 -06:00

package.json

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

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

README.md

feat(sdk): golden parity harness and query handler CJS alignment (#2302 Track A) (#2341 )

2026-04-20 18:09:02 -04:00

tsconfig.json

feat: GSD SDK — headless CLI with init + auto commands (#1407 )

2026-03-26 20:27:51 -06:00

vitest.config.ts

feat: GSD SDK — headless CLI with init + auto commands (#1407 )

2026-03-26 20:27:51 -06:00

README.md

@gsd-build/sdk

TypeScript SDK for Get Shit Done: deterministic query/mutation handlers, plan execution, and event-stream telemetry so agents focus on judgment, not shell plumbing.

Install

npm install @gsd-build/sdk

Quickstart — programmatic

import { GSD, createRegistry } from '@gsd-build/sdk';

const gsd = new GSD({ projectDir: process.cwd(), sessionId: 'my-run' });
const tools = gsd.createTools();

const registry = createRegistry(gsd.eventStream, 'my-run');
const { data } = await registry.dispatch('state.json', [], process.cwd());

Quickstart — CLI

From a project that depends on this package, invoke the CLI with Node (recommended in CI and local dev):

node ./node_modules/@gsd-build/sdk/dist/cli.js query state.json
node ./node_modules/@gsd-build/sdk/dist/cli.js query roadmap.analyze

If no native handler is registered for a command, the CLI can transparently shell out to get-shit-done/bin/gsd-tools.cjs (see stderr warning), unless GSD_QUERY_FALLBACK=off.

What ships

Area	Entry
Query registry	`createRegistry()` in `src/query/index.ts` — same handlers as `gsd-sdk query`
Tools bridge	`GSDTools` — native dispatch with optional CJS subprocess fallback
Orchestrators	`PhaseRunner`, `InitRunner`, `GSD`
CLI	`gsd-sdk` — `query`, `run`, `init`, `auto`

Guides

Handler registry & contracts: src/query/QUERY-HANDLERS.md
Repository docs (when present): docs/ARCHITECTURE.md, docs/CLI-TOOLS.md at repo root

Environment

Variable	Purpose
`GSD_QUERY_FALLBACK`	`off` / `never` disables CLI fallback to `gsd-tools.cjs` for unknown commands
`GSD_AGENTS_DIR`	Override directory scanned for installed GSD agents (`~/.claude/agents` by default)