f27b10736e
* test(#3751): add RED test for resolveAgentsDir missing repo-local .claude/agents Drive resolveAgentsDir() with a repo-local .claude/agents present and ~/.claude/agents absent. Structural contracts assert the function body must reference projectDir when constructing the fallback path, and that init-complex.ts must pass projectDir to the call site. Both fail deterministically before the fix. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix(#3751): resolveAgentsDir() falls back to repo-local .claude/agents for --local installs resolveAgentsDir() was probing only GSD_AGENTS_DIR or the runtime-global config dir (~/.claude/agents for Claude). For Claude Code --local installs where agents land in ./.claude/agents, the SDK reported agents_installed: false even when the agent files were present. Precedence (post-fix): 1. GSD_AGENTS_DIR (explicit override, unchanged) 2. <getRuntimeConfigDir(runtime)>/agents (when the dir exists) 3. <projectDir>/.claude/agents (repo-local fallback for claude runtime) Both init.ts:checkAgentsInstalled and init-complex.ts:initNewProject now receive projectDir and thread it to resolveAgentsDir(). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore(3751): update changeset to reference PR #3762 * fix(3751): add allow-test-rule annotation to satisfy lint-no-source-grep The structural-contract test reads TypeScript SDK source files to verify resolveAgentsDir() signature shape, fallback ordering, and call-site wiring. These are legitimate SDK-seam contracts (the TS source IS the product artifact). The allow-test-rule annotation bypasses the lint-no-source-grep check that flags readFileSync-bound variable usage. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix(3751): repair Windows config-set concurrent-write race withPlanningLock threw on EPERM instead of retrying, causing the losing process to crash silently and its config write to never land. On Windows, when two processes race to create the same lock file via O_EXCL (writeFileSync with flag:'wx'), the OS can return EPERM instead of EEXIST while NTFS holds an internal exclusive handle on the newly-created file during the write. The previous catch block only recognized EEXIST as a contention signal — any other code (including EPERM) fell through to `throw err`. The calling test used .catch(()=>{}) to suppress process errors, so the losing process silently exited without writing its value; the winning process then wrote from the stale pre-race config, producing the observed 'balanced' instead of 'quality'. Fix: port the PLANNING_LOCK_RETRY_ERRNOS Set from main (landed in #3777) into this branch. The set treats EPERM, EBUSY, and six other transient filesystem codes as retry signals rather than fatal errors. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
@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.mdat 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) |