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

Files

Tom Boucher 7032f44633 fix(#2544 ): exit 1 on missing key in config-get (#2588 )

The configGet query handler previously threw GSDError with
ErrorClassification.Validation, which maps to exit code 10. Callers
using `if ! gsd-sdk query config-get key; then fallback; fi` could
not detect missing keys through the exit code alone, because exit 10
is still truthy-failure but the intent (and documented UNIX
convention — cf. `git config --get`) is exit 1 for absent key.

Change the classification for the two 'Key not found' throw sites to
ErrorClassification.Execution so the CLI exits 1 on missing key.
Usage/schema errors (no key argument, malformed JSON, missing
config.json) remain Validation.

Closes #2544

2026-04-22 12:04:03 -04:00

docs

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

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

prompts

feat(agents): sycophancy hardening for 9 audit-class agents (#2489 )

2026-04-20 18:20:08 -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(#2544 ): exit 1 on missing key in config-get (#2588 )

2026-04-22 12:04:03 -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): bump engines.node from >=20 to >=22.0.0 (#2465 )

2026-04-19 23:02:57 -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)