@hegemonart/get-design-done 1.31.0 → 1.31.5

package/{README.zh-CN.md → docs/i18n/README.zh-CN.md}

@@ -2,7 +2,7 @@
 
 # GET DESIGN DONE
 
-[English](README.md) · **简体中文** · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Italiano](README.it.md) · [Deutsch](README.de.md)
+[English](../../README.md) · **简体中文** · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Italiano](README.it.md) · [Deutsch](README.de.md)
 
 **面向 AI 编码智能体的设计质量流水线:简报 → 探索 → 规划 → 实现 → 验证。**
 

package/hooks/_hook-emit.js

@@ -45,7 +45,7 @@ function getAppendEvent() {
     // require()'ing — if Node refuses to parse `.ts`, we silently fall
     // back to no-op.
     // eslint-disable-next-line node/no-missing-require, global-require
-    cachedAppendEvent = require('../scripts/lib/event-stream/index.ts').appendEvent;
+    cachedAppendEvent = require('../sdk/event-stream/index.ts').appendEvent;
     return cachedAppendEvent;
   } catch {
     cachedAppendEvent = null;

package/hooks/budget-enforcer.ts

@@ -44,8 +44,8 @@ import { spawn } from 'node:child_process';
 import { createInterface } from 'node:readline';
 import { createRequire } from 'node:module';
 
-import { appendEvent } from '../scripts/lib/event-stream/index.ts';
-import type { HookFiredEvent } from '../scripts/lib/event-stream/index.ts';
+import { appendEvent } from '../sdk/event-stream/index.ts';
+import type { HookFiredEvent } from '../sdk/event-stream/index.ts';
 // Consume the generated BudgetSchema so this hook participates in the
 // Plan 20-00 codegen graph. We treat parsed JSON as BudgetSchema after
 // the structural merge with defaults — the schema permits every field
@@ -71,7 +71,7 @@ function resolveHookPath(): string {
 }
 const nodeRequire = createRequire(resolveHookPath());
 const rateGuard = nodeRequire('../scripts/lib/rate-guard.cjs') as typeof import('../scripts/lib/rate-guard.cjs');
-const iterationBudget = nodeRequire('../scripts/lib/iteration-budget.cjs') as typeof import('../scripts/lib/iteration-budget.cjs');
+const iterationBudget = nodeRequire('../sdk/primitives/iteration-budget.cjs') as typeof import('../sdk/primitives/iteration-budget.cjs');
 // Plan 26-05: shared cost-computation backend for the resolved_models
 // consumer path. Pure module — takes (model_id, runtime, token_counts) →
 // cost_usd by reading per-runtime price tables under reference/prices/.
@@ -612,9 +612,9 @@ export function writeTelemetry(partial: TelemetryRowPartial): void {
 
 /**
  * Emit one hook.fired event per hook decision. Uses the pre-registered
- * HookFiredEvent subtype from scripts/lib/event-stream/types.ts and
+ * HookFiredEvent subtype from sdk/event-stream/types.ts and
  * stamps sessionId from the process PID + boot time — same scheme as
- * scripts/mcp-servers/gdd-state/tools/shared.ts but inlined here so the
+ * sdk/mcp/gdd-state/tools/shared.ts but inlined here so the
  * hook stays dependency-light.
  */
 let CACHED_SESSION_ID: string | null = null;

package/hooks/context-exhaustion.ts

@@ -28,8 +28,8 @@ import {
 import { dirname, join } from 'node:path';
 import { createInterface } from 'node:readline';
 
-import { appendEvent } from '../scripts/lib/event-stream/index.ts';
-import type { HookFiredEvent } from '../scripts/lib/event-stream/index.ts';
+import { appendEvent } from '../sdk/event-stream/index.ts';
+import type { HookFiredEvent } from '../sdk/event-stream/index.ts';
 
 // ── Types ───────────────────────────────────────────────────────────────────
 

package/hooks/gdd-precompact-snapshot.js

@@ -6,7 +6,7 @@
  * writes an atomic snapshot of STATE.md sections + last-N event-chain
  * entries + last-N decisions to `.design/snapshots/<ts>.json`.
  *
- * Phase 27.6 D-08: atomic .tmp + rename via scripts/lib/lockfile.cjs.
+ * Phase 27.6 D-08: atomic .tmp + rename via sdk/primitives/lockfile.cjs.
  *   - Lockfile serializes concurrent PreCompact writers.
  *   - .tmp + rename guarantees no partial file ever appears at target path
  *     (a SIGKILL between writeFileSync and renameSync leaves an orphan
@@ -52,7 +52,7 @@ function detectHarness() {
 
 function getAppendEvent() {
   try {
-    const m = require('../scripts/lib/event-stream');
+    const m = require('../sdk/event-stream');
     if (m && typeof m.appendEvent === 'function') return m.appendEvent;
   } catch {
     /* swallow — event-stream is optional infrastructure */
@@ -224,7 +224,7 @@ async function main() {
   // PreCompact writers; the second writer either waits or fails-silent.
   let release = null;
   try {
-    const lockfile = require('../scripts/lib/lockfile.cjs');
+    const lockfile = require('../sdk/primitives/lockfile.cjs');
     release = await lockfile.acquire(snapshotPath, {
       staleMs: 60_000,
       maxWaitMs: 10_000,

package/hooks/gdd-read-injection-scanner.ts

@@ -29,8 +29,8 @@ import { createRequire } from 'node:module';
 import { createInterface } from 'node:readline';
 import { dirname, isAbsolute, join, resolve } from 'node:path';
 
-import { appendEvent } from '../scripts/lib/event-stream/index.ts';
-import type { HookFiredEvent } from '../scripts/lib/event-stream/index.ts';
+import { appendEvent } from '../sdk/event-stream/index.ts';
+import type { HookFiredEvent } from '../sdk/event-stream/index.ts';
 
 // ── require-bridge to the shared .cjs pattern file ──────────────────────────
 

package/hooks/gdd-sessionstart-recap.js

@@ -45,7 +45,7 @@ function detectHarness() {
 
 function getAppendEvent() {
   try {
-    const m = require('../scripts/lib/event-stream');
+    const m = require('../sdk/event-stream');
     if (m && typeof m.appendEvent === 'function') return m.appendEvent;
   } catch {
     /* swallow — event-stream is optional infrastructure */

package/hooks/gdd-turn-closeout.js

@@ -49,7 +49,7 @@ const TAIL_BYTES = 8_192; // last 8 KiB is plenty for one event line (<<64KiB ca
  * Lightweight parse of the `<position>` block in STATE.md. Returns the fields
  * we care about, or null if the block isn't present / well-formed.
  *
- * We intentionally avoid the full parser at scripts/lib/gdd-state/parser.ts
+ * We intentionally avoid the full parser at sdk/state/parser.ts
  * because (a) it requires TS execution and (b) its overhead would blow the
  * 10ms budget. The position block is k=v lines so a regex pass is fine.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hegemonart/get-design-done",
-  "version": "1.31.0",
+  "version": "1.31.5",
   "description": "A design-quality pipeline for AI coding agents: brief, plan, implement, and verify UI work against your design system.",
   "author": "Hegemon",
   "homepage": "https://github.com/hegemonart/get-design-done",
@@ -17,21 +17,28 @@
     "agents/",
     "skills/",
     "hooks/",
-    "scripts/",
     "connections/",
     "reference/",
     "bin/",
+    "sdk/",
+    "recipes/",
+    "docs/i18n/",
+    "scripts/lib/",
+    "scripts/mcp-servers/",
+    "scripts/cli/",
+    "scripts/install.cjs",
     "SKILL.md",
     "README.md",
     "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "NOTICE"
   ],
   "bin": {
     "gdd-events": "./scripts/cli/gdd-events.mjs",
     "gdd-graph": "./bin/gdd-graph",
-    "gdd-mcp": "./scripts/mcp-servers/gdd-mcp/server.ts",
+    "gdd-mcp": "./bin/gdd-mcp",
     "gdd-sdk": "./bin/gdd-sdk",
-    "gdd-state-mcp": "./scripts/mcp-servers/gdd-state/server.ts",
+    "gdd-state-mcp": "./bin/gdd-state-mcp",
     "get-design-done": "./scripts/install.cjs"
   },
   "publishConfig": {
@@ -40,26 +47,30 @@
   },
   "scripts": {
     "build:bundles": "node scripts/build-distribution-bundles.cjs",
-    "test": "node --test --experimental-strip-types \"tests/**/*.test.cjs\" \"tests/**/*.test.ts\"",
+    "build:sdk": "node scripts/build-sdk-bins.cjs",
+    "prepack": "npm run build:sdk",
+    "postpack": "node scripts/build-sdk-bins.cjs --clean",
+    "test": "node --test --experimental-strip-types \"test/suite/**/*.test.cjs\" \"test/suite/**/*.test.ts\"",
     "typecheck": "tsc --noEmit",
     "codegen:schemas": "node --experimental-strip-types scripts/codegen-schema-types.ts",
-    "lint:md": "npx --yes markdownlint-cli2 \"**/*.md\" \"#node_modules\" \"#.planning\" \"#.claude\" \"#test-fixture/baselines\"",
+    "lint:md": "npx --yes markdownlint-cli2 \"**/*.md\" \"#node_modules\" \"#.planning\" \"#.claude\" \"#test/fixtures/baselines\"",
     "lint:links": "npx --yes lychee --no-progress --accept 200,206,403,429 \"**/*.md\" || true",
     "lint:agentskills": "node scripts/lint-agentskills-spec.cjs",
     "validate:schemas": "node --experimental-strip-types scripts/validate-schemas.ts",
     "validate:frontmatter": "node --experimental-strip-types scripts/validate-frontmatter.ts agents/",
     "detect:stale-refs": "node scripts/detect-stale-refs.cjs",
     "scan:injection": "node scripts/run-injection-scanner-ci.cjs",
-    "test:size-budget": "node --test tests/agent-size-budget.test.cjs",
+    "test:size-budget": "node --test test/suite/agent-size-budget.test.cjs",
     "release:extract-changelog": "node scripts/extract-changelog-section.cjs",
     "verify:version-sync": "node scripts/verify-version-sync.cjs",
     "typecheck:session-runner": "tsc --noEmit",
-    "gdd-sdk": "node --experimental-strip-types scripts/lib/cli/index.ts"
+    "gdd-sdk": "node --experimental-strip-types sdk/cli/index.ts"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
     "ajv-cli": "^5.0.0",
     "ajv-formats": "^3.0.1",
+    "esbuild": "^0.25.12",
     "json-schema-to-typescript": "^15.0.0",
     "typescript": "^6.0.3"
   },

package/reference/schemas/recipe.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/hegemonart/get-design-done/main/reference/schemas/recipe.schema.json",
+  "title": "Recipe",
+  "description": "Shape of a declarative recipe loaded from recipes/<name>.json by scripts/lib/recipe-loader.cjs (Plan 31-5-03, RECIPE-01 / SC#14). The recipes/ directory ships EMPTY of recipes and is populated downstream by Phase 32 (skill-trigger recipes), Phase 33.6 (per-provider), Phase 26 (per-runtime/per-model), and Phase 23.5 (bandit-arm shape). This is a minimal, forward-compatible envelope: a recipe MUST carry name/version/steps; additionalProperties:true lets the populating phases extend the envelope without breaking the loader contract. Modelled on Storybloq's src/autonomous/recipes/ loader.ts pattern.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["name", "version", "steps"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The recipe identifier. Matches the filename stem (recipes/<name>.json)."
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Recipe/schema version string for forward-compatibility. Lets the loader and downstream phases reason about envelope evolution."
+    },
+    "steps": {
+      "type": "array",
+      "description": "The ordered recipe body. Item shape is kept permissive for now — each step is an object carrying at least a `kind` OR an `id` string. Downstream phases (32/33.6/26/23.5) tighten the step contract per their domain.",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "anyOf": [
+          { "required": ["kind"], "properties": { "kind": { "type": "string", "minLength": 1 } } },
+          { "required": ["id"], "properties": { "id": { "type": "string", "minLength": 1 } } }
+        ]
+      }
+    }
+  }
+}

package/scripts/cli/gdd-events.mjs

@@ -138,7 +138,7 @@ export function compileFilter(terms) {
 
 async function cmdTail(parsed) {
   const path = resolvePath(parsed.flags.path);
-  const { readEvents } = await import('../lib/event-stream/reader.ts');
+  const { readEvents } = await import('../../sdk/event-stream/reader.ts');
   if (!parsed.flags.follow) {
     for await (const ev of readEvents({ path })) {
       stdout.write(JSON.stringify(ev) + '\n');
@@ -188,7 +188,7 @@ async function cmdGrep(parsed) {
     return 2;
   }
   const predicate = compileFilter(terms);
-  const { readEvents } = await import('../lib/event-stream/reader.ts');
+  const { readEvents } = await import('../../sdk/event-stream/reader.ts');
   for await (const ev of readEvents({ path, predicate })) {
     stdout.write(JSON.stringify(ev) + '\n');
   }
@@ -197,7 +197,7 @@ async function cmdGrep(parsed) {
 
 async function cmdCat(parsed) {
   const path = resolvePath(parsed.flags.path);
-  const { readEvents } = await import('../lib/event-stream/reader.ts');
+  const { readEvents } = await import('../../sdk/event-stream/reader.ts');
   for await (const ev of readEvents({ path })) {
     const ts = ev.timestamp ?? '?';
     const tp = ev.type ?? '?';
@@ -207,7 +207,7 @@ async function cmdCat(parsed) {
 }
 
 async function cmdListTypes() {
-  const { KNOWN_EVENT_TYPES } = await import('../lib/event-stream/types.ts');
+  const { KNOWN_EVENT_TYPES } = await import('../../sdk/event-stream/types.ts');
   for (const t of KNOWN_EVENT_TYPES) stdout.write(t + '\n');
   return 0;
 }
@@ -236,7 +236,7 @@ async function cmdServe(parsed) {
   // Bridge live bus → ws transport. The transport is CommonJS and cannot
   // require .ts directly, so we import the bus here and pass subscribeAll
   // as a callback factory.
-  const { subscribeAll } = await import('../lib/event-stream/index.ts');
+  const { subscribeAll } = await import('../../sdk/event-stream/index.ts');
   const subscribe = (handler) => subscribeAll(handler);
   const handle = await mod.startServer({ port, token, tailFrom, subscribe });
   stderr.write(`gdd-events: WebSocket listening on :${port} (auth required)\n`);

package/scripts/lib/cache/gdd-cache-manager.cjs

@@ -83,7 +83,7 @@ function clamp01(n) {
 function getAppendEvent() {
   try {
     // Resolved relative to this file: `scripts/lib/cache/` → `../event-stream`.
-    const m = require('../event-stream');
+    const m = require('../../../sdk/event-stream');
     if (m && typeof m.appendEvent === 'function') return m.appendEvent;
   } catch {
     // Swallow — fall through to the no-op below. The event is

package/scripts/lib/cli/index.ts

@@ -1,167 +1,29 @@
-// scripts/lib/cli/index.ts — Plan 21-09 Task 7 (SDK-21).
+// scripts/lib/cli/index.ts — GDD-DEPRECATION-SHIM (Plan 31-5-06, SDK-05, D-02).
 //
-// Main dispatcher for the `gdd-sdk` CLI. Invoked by `bin/gdd-sdk` (the
-// CJS trampoline) with `--experimental-strip-types` so TS runs without
-// a build step.
+// Thin deprecation shim. The real implementation moved to sdk/cli/index.ts
+// in Plan 31-5-04 (SDK consolidation). This file is re-created at the OLD
+// path so undocumented EXTERNAL importers (anyone who reached into
+// node_modules/@hegemonart/get-design-done/scripts/lib/cli/index.ts directly)
+// keep working for one minor grace window.
 //
-// Responsibilities:
-//   * Parse argv via parseArgs().
-//   * Route by first positional to the matching subcommand module.
-//   * Print top-level USAGE on bare `gdd-sdk` / `-h` / `--help`.
-//   * Exit with the subcommand's return code. Unknown subcommands
-//     exit 3 and print USAGE to stderr.
+// REMOVED IN v1.33.0 (D-02). Grace window: 1.31.5 ships with shims →
+// 1.32.0 still has them → 1.33.0 removes them. Internal callers already use
+// the sdk/ path (Plan 31-5-04/05) — this shim is external-only; 31-5-10's
+// no-stale-internal-refs guard excludes files carrying the
+// GDD-DEPRECATION-SHIM marker above.
 //
-// The bottom of this file has the `main()` bootstrap that the trampoline
-// invokes. It catches any accidental throw (subcommands are contracted
-// not to throw) and translates to exit code 3.
+// Runs under --experimental-strip-types (the runtime `bin/gdd-sdk` and the
+// test suite both use it), so `export *` re-export is strip-types-clean.
 
-import { parseArgs, type ParsedArgs } from './parse-args.ts';
-import { runCommand } from './commands/run.ts';
-import { stageCommand } from './commands/stage.ts';
-import { queryCommand } from './commands/query.ts';
-import { auditCommand } from './commands/audit.ts';
-import { initCommand } from './commands/init.ts';
+import { emitWarning } from 'node:process';
 
-// ---------------------------------------------------------------------------
-// Top-level USAGE.
-// ---------------------------------------------------------------------------
-
-export const USAGE = `gdd-sdk <command> [flags]
-
-Commands:
-  run              Run the full design pipeline headlessly.
-  stage <name>     Run a single stage (brief|explore|plan|design|verify|discuss).
-  query <op>       Typed STATE.md read operations.
-  audit            Probe connections + dry-run verify.
-  init             Bootstrap a new project.
-
-Use 'gdd-sdk <command> -h' for command-specific flags.
-
-Exit codes (general):
-  0  success
-  1  halted / regression / already-initialized
-  2  awaiting-gate / partial (init)
-  3  argument / config error
-`;
-
-// ---------------------------------------------------------------------------
-// Deps.
-// ---------------------------------------------------------------------------
-
-export interface DispatcherDeps {
-  readonly stdout?: NodeJS.WritableStream;
-  readonly stderr?: NodeJS.WritableStream;
-  readonly commands?: {
-    readonly run?: typeof runCommand;
-    readonly stage?: typeof stageCommand;
-    readonly query?: typeof queryCommand;
-    readonly audit?: typeof auditCommand;
-    readonly init?: typeof initCommand;
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Dispatcher.
-// ---------------------------------------------------------------------------
-
-/**
- * Dispatch a parsed ParsedArgs to the appropriate subcommand. Exported
- * for tests (they can construct a ParsedArgs manually and assert the
- * exit code + captured stdout/stderr).
- */
-export async function dispatch(
-  parsed: ParsedArgs,
-  deps: DispatcherDeps = {},
-): Promise<number> {
-  const stdout = deps.stdout ?? process.stdout;
-  const stderr = deps.stderr ?? process.stderr;
-  const commands = {
-    run: deps.commands?.run ?? runCommand,
-    stage: deps.commands?.stage ?? stageCommand,
-    query: deps.commands?.query ?? queryCommand,
-    audit: deps.commands?.audit ?? auditCommand,
-    init: deps.commands?.init ?? initCommand,
-  };
-
-  // Bare invocation or top-level help → USAGE.
-  if (parsed.subcommand === null) {
-    stdout.write(USAGE);
-    return 0;
-  }
-  if (
-    (parsed.flags['help'] === true || parsed.flags['h'] === true) &&
-    // Top-level --help (no subcommand recognized yet; --help before the
-    // first positional lands here). Subcommands also honor --help
-    // themselves, so this branch only fires for `gdd-sdk --help`.
-    parsed.positionals.length === 0 &&
-    !KNOWN_SUBCOMMANDS.has(parsed.subcommand)
-  ) {
-    stdout.write(USAGE);
-    return 0;
-  }
-
-  switch (parsed.subcommand) {
-    case 'run':
-      return await commands.run(parsed, { stdout, stderr });
-    case 'stage':
-      return await commands.stage(parsed, { stdout, stderr });
-    case 'query':
-      return await commands.query(parsed, { stdout, stderr });
-    case 'audit':
-      return await commands.audit(parsed, { stdout, stderr });
-    case 'init':
-      return await commands.init(parsed, { stdout, stderr });
-    default:
-      stderr.write(
-        `gdd-sdk: unknown subcommand "${parsed.subcommand}"\n${USAGE}`,
-      );
-      return 3;
-  }
-}
-
-const KNOWN_SUBCOMMANDS: ReadonlySet<string> = new Set([
-  'run',
-  'stage',
-  'query',
-  'audit',
-  'init',
-]);
-
-// ---------------------------------------------------------------------------
-// Bootstrap entry point — called by bin/gdd-sdk trampoline.
-// ---------------------------------------------------------------------------
-
-/**
- * Top-level main. Parses process.argv.slice(2), dispatches, prints
- * USAGE + exit 3 on any uncaught error. Exported so tests can invoke
- * it directly (bypassing the trampoline).
- */
-export async function main(
-  argv: readonly string[] = process.argv.slice(2),
-  deps: DispatcherDeps = {},
-): Promise<number> {
-  const parsed = parseArgs(argv);
-  return await dispatch(parsed, deps);
-}
-
-// ---------------------------------------------------------------------------
-// When executed directly by the trampoline, invoke main() + exit.
-// ---------------------------------------------------------------------------
-
-// Only self-invoke when this module IS the entry point. We detect that
-// by checking process.argv[1] (trampoline passes this file's path).
-//
-// `import.meta.url` is the POSIX idiom but this TS runs under --experimental-strip-types
-// as Node16 modules — we use process.argv to stay ESM/CJS-agnostic.
-
-const entryPath: string = (process.argv[1] ?? '').replace(/\\/g, '/');
-if (entryPath.endsWith('/scripts/lib/cli/index.ts')) {
-  main().then(
-    (code) => process.exit(code),
-    (err) => {
-      // eslint-disable-next-line no-console
-      console.error('gdd-sdk: unexpected error:', err);
-      process.exit(3);
-    },
+let warned = false;
+if (!warned) {
+  warned = true;
+  emitWarning(
+    'scripts/lib/cli/index.ts is deprecated; import sdk/cli instead. Removed in v1.33.0.',
+    'DeprecationWarning',
   );
 }
+
+export * from '../../../sdk/cli/index.ts';

package/scripts/lib/connection-probe/index.cjs

@@ -42,7 +42,7 @@
 const { writeFileSync, readFileSync, existsSync, mkdirSync, renameSync } = require('node:fs');
 const { dirname, isAbsolute, resolve, join } = require('node:path');
 
-const { delayMs } = require('../jittered-backoff.cjs');
+const { delayMs } = require('../../../sdk/primitives/jittered-backoff.cjs');
 
 const DEFAULT_STATE_PATH = '.design/telemetry/connection-state.json';
 

package/scripts/lib/discuss-parallel-runner/aggregator.ts

@@ -27,7 +27,7 @@ import type {
   SessionResult,
   SessionRunnerOptions,
 } from '../session-runner/types.ts';
-import { ValidationError } from '../gdd-errors/index.ts';
+import { ValidationError } from '../../../sdk/errors/index.ts';
 import { getLogger } from '../logger/index.ts';
 
 import type {

package/scripts/lib/discuss-parallel-runner/index.ts

@@ -27,7 +27,7 @@
 // Consumers: `discuss` skill (Plan 21-08 / future) + `gdd-sdk discuss`
 // CLI subcommand (Plan 21-09).
 
-import { OperationFailedError } from '../gdd-errors/index.ts';
+import { OperationFailedError } from '../../../sdk/errors/index.ts';
 import { getLogger } from '../logger/index.ts';
 import { resolveConcurrency } from '../parallelism-engine/concurrency-tuner.cjs';