{"_id":"@ai-is-gonna/gtd-sdk","_rev":"7-69c5a9b9ac29d7fdb6ac267ce29b3284","name":"@ai-is-gonna/gtd-sdk","dist-tags":{"latest":"0.2.4"},"versions":{"0.2.2":{"name":"@ai-is-gonna/gtd-sdk","version":"0.2.2","author":{"name":"Davide Troiani"},"license":"MIT","_id":"@ai-is-gonna/gtd-sdk@0.2.2","maintainers":[{"name":"davide-troiani","email":"me@davidetroiani.it"}],"homepage":"https://github.com/ai-is-gonna/get-tasks-done","bugs":{"url":"https://github.com/ai-is-gonna/get-tasks-done/issues"},"bin":{"gtd-sdk":"dist/cli.js"},"dist":{"shasum":"4abbe7badb785553f88045cedbf01bc32d8ca710","tarball":"https://registry.npmjs.org/@ai-is-gonna/gtd-sdk/-/gtd-sdk-0.2.2.tgz","fileCount":742,"integrity":"sha512-DWjVIVYBw5IDqnTv3mT1vt5iZafMwDtGYXsIZUAGoq0HyZFIe+3UqY0JoakC/0tNqeb5LCSCj3ywib2W3r7Atw==","signatures":[{"sig":"MEUCIQCyaVmlZL5Vx1AWydUbD2wkDMsIPJXUJv6bS9QNjaw2EgIgYXstUIxu8KDS17a6H1jPxoz44I/1LXeLfpVoGd5RHiY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ai-is-gonna%2fgtd-sdk@0.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3354138},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=22.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b961c1c7f7874254d15a0249d1acdbd249ba6d4e","scripts":{"test":"vitest run","build":"tsc","test:unit":"vitest run --project unit","prepublishOnly":"rm -rf dist && tsc && chmod +x dist/cli.js","gen:project-root":"npm run build && node scripts/gen-project-root.mjs","test:integration":"vitest run --project integration","check:alias-drift":"npm run build && node scripts/check-command-aliases-fresh.mjs","gen:configuration":"npm run build && node scripts/gen-configuration.mjs","gen:state-document":"npm run build && npx tsx scripts/gen-state-document.ts","check:project-root-fresh":"npm run build && node scripts/check-project-root-fresh.mjs","check:configuration-fresh":"npm run build && node scripts/check-configuration-fresh.mjs","check:state-document-fresh":"npm run build && node scripts/check-state-document-fresh.mjs","gen:workstream-inventory-builder":"npm run build && node scripts/gen-workstream-inventory-builder.mjs","check:workstream-inventory-builder-fresh":"npm run build && node scripts/check-workstream-inventory-builder-fresh.mjs"},"_npmUser":{"name":"davide-troiani","email":"me@davidetroiani.it"},"repository":{"url":"git+https://github.com/ai-is-gonna/get-tasks-done.git","type":"git","directory":"sdk"},"_npmVersion":"10.9.8","description":"GTD SDK — programmatic interface for running GTD plans via the Agent SDK","directories":{},"_nodeVersion":"22.22.3","dependencies":{"ws":"^8.20.0","synckit":"^0.11.12","@anthropic-ai/claude-agent-sdk":"^0.2.84"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.0","vitest":"^3.1.1","@types/ws":"^8.18.1","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/gtd-sdk_0.2.2_1780148077291_0.16937031770930422","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@ai-is-gonna/gtd-sdk","version":"0.2.3","author":{"name":"Davide Troiani"},"license":"MIT","_id":"@ai-is-gonna/gtd-sdk@0.2.3","maintainers":[{"name":"davide-troiani","email":"me@davidetroiani.it"}],"homepage":"https://github.com/ai-is-gonna/get-tasks-done","bugs":{"url":"https://github.com/ai-is-gonna/get-tasks-done/issues"},"bin":{"gtd-sdk":"dist/cli.js"},"dist":{"shasum":"8c52610980250e2a50719f138cc2aaa261099a90","tarball":"https://registry.npmjs.org/@ai-is-gonna/gtd-sdk/-/gtd-sdk-0.2.3.tgz","fileCount":742,"integrity":"sha512-Ik1LUgth/mEdwL8TunDZ9ddlgSLMHoGrRMy/nCcIIvWvo3r1p1o75yKwzK3Y0MJvGVT4HbgJhD8eQUoLjEObPg==","signatures":[{"sig":"MEUCIQDzSUjcQZk/W27/+EaM3S//fdntTq9J/C06teN9hHwU8wIgAhunpM9ZHp8kKHDy0z0R0r/xmmPzOiIksGHozfUFXUs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ai-is-gonna%2fgtd-sdk@0.2.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3354138},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=22.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"ad3e0094239c3dbe757e6e4fce18ba154a746518","scripts":{"test":"vitest run","build":"tsc","test:unit":"vitest run --project unit","prepublishOnly":"rm -rf dist && tsc && chmod +x dist/cli.js","gen:project-root":"npm run build && node scripts/gen-project-root.mjs","test:integration":"vitest run --project integration","check:alias-drift":"npm run build && node scripts/check-command-aliases-fresh.mjs","gen:configuration":"npm run build && node scripts/gen-configuration.mjs","gen:state-document":"npm run build && npx tsx scripts/gen-state-document.ts","check:project-root-fresh":"npm run build && node scripts/check-project-root-fresh.mjs","check:configuration-fresh":"npm run build && node scripts/check-configuration-fresh.mjs","check:state-document-fresh":"npm run build && node scripts/check-state-document-fresh.mjs","gen:workstream-inventory-builder":"npm run build && node scripts/gen-workstream-inventory-builder.mjs","check:workstream-inventory-builder-fresh":"npm run build && node scripts/check-workstream-inventory-builder-fresh.mjs"},"_npmUser":{"name":"davide-troiani","email":"me@davidetroiani.it"},"repository":{"url":"git+https://github.com/ai-is-gonna/get-tasks-done.git","type":"git","directory":"sdk"},"_npmVersion":"10.9.8","description":"GTD SDK — programmatic interface for running GTD plans via the Agent SDK","directories":{},"_nodeVersion":"22.22.3","dependencies":{"ws":"^8.20.0","synckit":"^0.11.12","@anthropic-ai/claude-agent-sdk":"^0.2.84"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.0","vitest":"^3.1.1","@types/ws":"^8.18.1","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/gtd-sdk_0.2.3_1780151642342_0.2766488131609992","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"@ai-is-gonna/gtd-sdk","version":"0.2.4","description":"GTD SDK — programmatic interface for running GTD plans via the Agent SDK","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"bin":{"gtd-sdk":"dist/cli.js"},"repository":{"type":"git","url":"git+https://github.com/ai-is-gonna/get-tasks-done.git","directory":"sdk"},"homepage":"https://github.com/ai-is-gonna/get-tasks-done","bugs":{"url":"https://github.com/ai-is-gonna/get-tasks-done/issues"},"publishConfig":{"access":"public"},"author":{"name":"Davide Troiani"},"license":"MIT","engines":{"node":">=22.0.0"},"scripts":{"build":"tsc","check:alias-drift":"npm run build && node scripts/check-command-aliases-fresh.mjs","gen:state-document":"npm run build && npx tsx scripts/gen-state-document.ts","check:state-document-fresh":"npm run build && node scripts/check-state-document-fresh.mjs","gen:configuration":"npm run build && node scripts/gen-configuration.mjs","check:configuration-fresh":"npm run build && node scripts/check-configuration-fresh.mjs","gen:workstream-inventory-builder":"npm run build && node scripts/gen-workstream-inventory-builder.mjs","check:workstream-inventory-builder-fresh":"npm run build && node scripts/check-workstream-inventory-builder-fresh.mjs","gen:project-root":"npm run build && node scripts/gen-project-root.mjs","check:project-root-fresh":"npm run build && node scripts/check-project-root-fresh.mjs","prepublishOnly":"rm -rf dist && tsc && chmod +x dist/cli.js","test":"vitest run","test:unit":"vitest run --project unit","test:integration":"vitest run --project integration"},"dependencies":{"@anthropic-ai/claude-agent-sdk":"^0.2.84","synckit":"^0.11.12","ws":"^8.20.0"},"devDependencies":{"@types/node":"^22.0.0","@types/ws":"^8.18.1","tsx":"^4.22.0","typescript":"^5.7.0","vitest":"^3.1.1"},"_id":"@ai-is-gonna/gtd-sdk@0.2.4","gitHead":"7539fc67a0bfbf1f5b2c2fb113da472280ca1267","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-2jyr2U4VKP03l/KBp3+mbMcgHbmMSJHr4jk7ZiyFbEyv4GYtUOXbhLaxvr3o+IE7l8kJrQhPdSrDn0lWpuZlcg==","shasum":"4e24acc4d5caa37358ea42da97a654018d79f79d","tarball":"https://registry.npmjs.org/@ai-is-gonna/gtd-sdk/-/gtd-sdk-0.2.4.tgz","fileCount":746,"unpackedSize":3366349,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ai-is-gonna%2fgtd-sdk@0.2.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDa2hYcN9uzJmul/P4/dCld2osSj5LmYDBIsC0H65y2awIgJgzcgPuGZbf/S7xAiw+DfMZVdFJDQ2r34hB0/JW/2aU="}]},"_npmUser":{"name":"davide-troiani","email":"me@davidetroiani.it"},"directories":{},"maintainers":[{"name":"davide-troiani","email":"me@davidetroiani.it"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gtd-sdk_0.2.4_1780518094103_0.9544925592873794"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-30T13:34:37.104Z","modified":"2026-06-03T20:21:34.722Z","0.1.4":"2026-05-30T09:49:35.776Z","0.1.5":"2026-05-30T12:27:46.258Z","0.2.2":"2026-05-30T13:34:37.464Z","0.2.3":"2026-05-30T14:34:02.553Z","0.2.4":"2026-06-03T20:21:34.316Z"},"bugs":{"url":"https://github.com/ai-is-gonna/get-tasks-done/issues"},"author":{"name":"Davide Troiani"},"license":"MIT","homepage":"https://github.com/ai-is-gonna/get-tasks-done","repository":{"type":"git","url":"git+https://github.com/ai-is-gonna/get-tasks-done.git","directory":"sdk"},"description":"GTD SDK — programmatic interface for running GTD plans via the Agent SDK","maintainers":[{"name":"davide-troiani","email":"me@davidetroiani.it"}],"readme":"# @ai-is-gonna/gtd-sdk\n\nTypeScript SDK for **Get Tasks Done**: deterministic query/mutation handlers, plan execution, and event-stream telemetry so agents focus on judgment, not shell plumbing.\n\n## Install\n\n```bash\nnpm install @ai-is-gonna/gtd-sdk\n```\n\n## Quickstart — programmatic\n\n```typescript\nimport { GTD, createRegistry } from '@ai-is-gonna/gtd-sdk';\n\nconst gtd = new GTD({ projectDir: process.cwd(), sessionId: 'my-run' });\nconst tools = gtd.createTools();\n\nconst registry = createRegistry(gtd.eventStream, 'my-run');\nconst { data } = await registry.dispatch('state.json', [], process.cwd());\n```\n\n## Quickstart — CLI\n\nFrom a project that depends on this package, **invoke the CLI with Node** (recommended in CI and local dev):\n\n```bash\nnode ./node_modules/@ai-is-gonna/gtd-sdk/dist/cli.js query state.json\nnode ./node_modules/@ai-is-gonna/gtd-sdk/dist/cli.js query roadmap.analyze\n```\n\nIf no native handler is registered for a command, the CLI can transparently shell out to `get-tasks-done/bin/gtd-tools.cjs` (see stderr warning), unless `GTD_QUERY_FALLBACK=off`.\n\n## Task Workflow Commands\n\nThe SDK exposes the GitHub-backed task workflow as query commands so CI jobs and dashboards can inspect or advance the same workflow used by the slash commands:\n\n```bash\nnode ./node_modules/@ai-is-gonna/gtd-sdk/dist/cli.js query export-phase-issues 1 --dry-run\nnode ./node_modules/@ai-is-gonna/gtd-sdk/dist/cli.js query export-phase-issues 1\nnode ./node_modules/@ai-is-gonna/gtd-sdk/dist/cli.js query work-task-issue --read-only --phase 1\nnode ./node_modules/@ai-is-gonna/gtd-sdk/dist/cli.js query work-task-issue --phase 1\nnode ./node_modules/@ai-is-gonna/gtd-sdk/dist/cli.js query orchestrate-tasks 123 124 --dry-run\nnode ./node_modules/@ai-is-gonna/gtd-sdk/dist/cli.js query work-task-issue --complete-phase 1 --execute\n```\n\nUseful gates around that workflow:\n\n```bash\nnode ./node_modules/@ai-is-gonna/gtd-sdk/dist/cli.js query check.completion phase 1\nnode ./node_modules/@ai-is-gonna/gtd-sdk/dist/cli.js query check.verification-status 1\nnode ./node_modules/@ai-is-gonna/gtd-sdk/dist/cli.js query progress.json\n```\n\n## What ships\n\n| Area | Entry |\n|------|--------|\n| Query registry | `createRegistry()` in `src/query/index.ts` — same handlers as `gtd-sdk query` |\n| Tools bridge | `GTDTools` — native dispatch with optional CJS subprocess fallback |\n| Orchestrators | `PhaseRunner`, `InitRunner`, `GTD` |\n| CLI | `gtd-sdk` — `query`, `run`, `init`, `auto` |\n\n## Guides\n\n- **Handler registry & contracts:** [`src/query/QUERY-HANDLERS.md`](src/query/QUERY-HANDLERS.md)\n- **Repository docs** (when present): `docs/ARCHITECTURE.md`, `docs/CLI-TOOLS.md` at repo root\n\n## Environment\n\n| Variable | Purpose |\n|----------|---------|\n| `GTD_QUERY_FALLBACK` | `off` / `never` disables CLI fallback to `gtd-tools.cjs` for unknown commands |\n| `GTD_AGENTS_DIR` | Override directory scanned for installed GTD agents (`~/.claude/agents` by default) |\n","readmeFilename":"README.md"}