mirror of https://github.com/glittercowboy/get-shit-done synced 2026-04-25 17:25:23 +02:00

Files

Tom Boucher 0f8f7537da fix(#2652 ): layer ~/.gsd/defaults.json over built-ins in SDK loadConfig (#2663 )

* fix(#2652): layer ~/.gsd/defaults.json over built-ins in SDK loadConfig

SDK loadConfig only merged built-in CONFIG_DEFAULTS, so pre-project init
queries (e.g. resolveModel in Codex installs) ignored user-level knobs like
resolve_model_ids: "omit" and emitted Claude model aliases from MODEL_PROFILES.

Port the user-defaults layer from get-shit-done/bin/lib/config.cjs:65 to the
TS loader. CJS parity: user defaults only apply when no .planning/config.json
exists (buildNewProjectConfig already bakes them in at /gsd:new-project time).

Fixes #2652

* fix(#2652): isolate GSD_HOME in test, refresh loadConfig JSDoc (CodeRabbit)

2026-04-24 18:08:07 -04:00

docs

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

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

prompts

feat: add unified post-planning gap checker (closes #2493 ) (#2610 )

2026-04-22 23:03:59 -04:00

scripts

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

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

src

fix(#2652 ): layer ~/.gsd/defaults.json over built-ins in SDK loadConfig (#2663 )

2026-04-24 18:08:07 -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

fix(install): build gsd-sdk from in-repo sdk/ source, not stale npm package

2026-04-17 19:53:16 -05:00

package.json

fix(sdk): decouple from build-from-source install, close #2441 #2453 (#2457 )

2026-04-23 08:36:03 -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)