@hegemonart/get-design-done 1.41.0 → 1.42.0

package/scripts/lib/manifest/prose-denylist.json

@@ -0,0 +1,126 @@
+{
+  "schema_version": 1,
+  "note": "AI-tell denylist SoT (Phase 41.5 seed). Phase 43 (lint-prose.cjs) + Phase 44 read this. Case-insensitive phrase match in the project's OWN user-facing prose only.",
+  "tells": [
+    {
+      "pattern": "load-bearing",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "highest-leverage",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "delve",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "delves",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "seamless",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "seamlessly",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "robust",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "elevate",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "empower",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "underscore",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "underscores",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "in today's",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "let's dive in",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "moreover",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "furthermore",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "tapestry",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "a testament to",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "navigating the",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "in the realm of",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "unlock the power",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "game-changer",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "leverage",
+      "kind": "phrase",
+      "note": "AI-prose tell (training-set monoculture)."
+    },
+    {
+      "pattern": "\\u2014",
+      "kind": "token",
+      "note": "Em dash — banned in the project's own user-facing prose (Phase 43)."
+    },
+    {
+      "pattern": "--",
+      "kind": "token",
+      "note": "Double hyphen (often an em-dash surrogate)."
+    }
+  ]
+}

package/scripts/lib/manifest/schemas/harnesses.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "urn:gdd:manifest:harnesses",
+  "title": "manifest/harnesses.json",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "harnesses"
+  ],
+  "additionalProperties": true,
+  "properties": {
+    "schema_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "harnesses": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": [
+          "id",
+          "name"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]+$"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/lib/manifest/schemas/prose-denylist.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "urn:gdd:manifest:prose-denylist",
+  "title": "manifest/prose-denylist.json",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "tells"
+  ],
+  "additionalProperties": true,
+  "properties": {
+    "schema_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "tells": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": [
+          "pattern",
+          "kind"
+        ],
+        "properties": {
+          "pattern": {
+            "type": "string",
+            "minLength": 1
+          },
+          "kind": {
+            "type": "string",
+            "enum": [
+              "phrase",
+              "token"
+            ]
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/lib/manifest/schemas/skills.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "urn:gdd:manifest:skills",
+  "title": "manifest/skills.json",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "skills"
+  ],
+  "additionalProperties": true,
+  "properties": {
+    "schema_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": [
+          "name"
+        ],
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/lib/manifest/skills.json

@@ -0,0 +1,255 @@
+{
+  "schema_version": 1,
+  "note": "Skill metadata SoT (Phase 41.5 seed = the live skills/ dir names). Phase 47 enriches each record (aliases, pin, description budget).",
+  "skills": [
+    {
+      "name": "add-backlog"
+    },
+    {
+      "name": "analyze-dependencies"
+    },
+    {
+      "name": "apply-reflections"
+    },
+    {
+      "name": "audit"
+    },
+    {
+      "name": "bandit-status"
+    },
+    {
+      "name": "benchmark"
+    },
+    {
+      "name": "bootstrap-ds"
+    },
+    {
+      "name": "brief"
+    },
+    {
+      "name": "budget"
+    },
+    {
+      "name": "cache-manager"
+    },
+    {
+      "name": "check-update"
+    },
+    {
+      "name": "compare"
+    },
+    {
+      "name": "complete-cycle"
+    },
+    {
+      "name": "connections"
+    },
+    {
+      "name": "continue"
+    },
+    {
+      "name": "darkmode"
+    },
+    {
+      "name": "debug"
+    },
+    {
+      "name": "design"
+    },
+    {
+      "name": "discover"
+    },
+    {
+      "name": "discuss"
+    },
+    {
+      "name": "do"
+    },
+    {
+      "name": "explore"
+    },
+    {
+      "name": "export"
+    },
+    {
+      "name": "extract-learnings"
+    },
+    {
+      "name": "fast"
+    },
+    {
+      "name": "figma-extract"
+    },
+    {
+      "name": "figma-write"
+    },
+    {
+      "name": "graphify"
+    },
+    {
+      "name": "health"
+    },
+    {
+      "name": "help"
+    },
+    {
+      "name": "list-assumptions"
+    },
+    {
+      "name": "locale"
+    },
+    {
+      "name": "map"
+    },
+    {
+      "name": "migrate"
+    },
+    {
+      "name": "new-cycle"
+    },
+    {
+      "name": "new-project"
+    },
+    {
+      "name": "next"
+    },
+    {
+      "name": "note"
+    },
+    {
+      "name": "openrouter-status"
+    },
+    {
+      "name": "optimize"
+    },
+    {
+      "name": "pause"
+    },
+    {
+      "name": "peer-cli-add"
+    },
+    {
+      "name": "peer-cli-customize"
+    },
+    {
+      "name": "peers"
+    },
+    {
+      "name": "plan"
+    },
+    {
+      "name": "plant-seed"
+    },
+    {
+      "name": "pr-branch"
+    },
+    {
+      "name": "progress"
+    },
+    {
+      "name": "quality-gate"
+    },
+    {
+      "name": "quick"
+    },
+    {
+      "name": "reapply-patches"
+    },
+    {
+      "name": "recall"
+    },
+    {
+      "name": "reflect"
+    },
+    {
+      "name": "report-issue"
+    },
+    {
+      "name": "resume"
+    },
+    {
+      "name": "review-backlog"
+    },
+    {
+      "name": "review-decisions"
+    },
+    {
+      "name": "roi"
+    },
+    {
+      "name": "rollout-status"
+    },
+    {
+      "name": "router"
+    },
+    {
+      "name": "scan"
+    },
+    {
+      "name": "settings"
+    },
+    {
+      "name": "ship"
+    },
+    {
+      "name": "sketch"
+    },
+    {
+      "name": "sketch-wrap-up"
+    },
+    {
+      "name": "skill-manifest"
+    },
+    {
+      "name": "spike"
+    },
+    {
+      "name": "spike-wrap-up"
+    },
+    {
+      "name": "start"
+    },
+    {
+      "name": "stats"
+    },
+    {
+      "name": "style"
+    },
+    {
+      "name": "synthesize"
+    },
+    {
+      "name": "timeline"
+    },
+    {
+      "name": "todo"
+    },
+    {
+      "name": "turn-closeout"
+    },
+    {
+      "name": "undo"
+    },
+    {
+      "name": "unlock-decision"
+    },
+    {
+      "name": "update"
+    },
+    {
+      "name": "using-gdd"
+    },
+    {
+      "name": "verify"
+    },
+    {
+      "name": "warm-cache"
+    },
+    {
+      "name": "watch-authorities"
+    },
+    {
+      "name": "zoom-out"
+    }
+  ]
+}

package/sdk/cli/commands/build.ts

@@ -0,0 +1,106 @@
+// sdk/cli/commands/build.ts — Phase 42 (COMPILE-06).
+//
+// `gdd-sdk build skills [--harness <id>] [--zip] [--check]` — compile the per-harness skill bundles
+// from source/skills/ via the orchestrator scripts/build-skills.cjs. The orchestrator is a separate
+// dep-free CJS process (no bundling entanglement with the SDK); we resolve it relative to the package
+// root and spawn it, forwarding stdout/stderr.
+//
+// Exit codes:
+//   * 0 — build (or --check) succeeded.
+//   * 1 — --check found drift (committed != generated).
+//   * 3 — arg / config error (missing/unknown target).
+
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+
+import {
+  coerceFlags,
+  COMMON_FLAGS,
+  type FlagSpec,
+  type ParsedArgs,
+} from '../parse-args.ts';
+
+const BUILD_FLAGS: readonly FlagSpec[] = [
+  ...COMMON_FLAGS,
+  { name: 'harness', type: 'string' },
+  { name: 'zip', type: 'boolean' },
+  { name: 'check', type: 'boolean' },
+];
+
+export const BUILD_USAGE = `gdd-sdk build skills [flags]
+
+Compile per-harness skill bundles from source/skills/ into dist/<bundle>/ (and regenerate the
+committed Claude-Code surface skills/). One source, N provider bundles.
+
+Flags:
+  --harness <id>   Build only one harness (e.g. claude, codex, gemini). Default: all 14.
+  --zip            Also package each bundle as dist/<bundle>.tgz (needs tar).
+  --check          Verify committed skills/ + dist/claude-code/ match source/ (the drift gate); no writes.
+  -h, --help       Show this help.
+
+Exit codes: 0 ok · 1 drift (--check) · 3 arg error
+`;
+
+interface CommandCtx {
+  readonly stdout: NodeJS.WritableStream;
+  readonly stderr: NodeJS.WritableStream;
+}
+
+/** Walk up from the CLI entry (argv[1]) to the package root that holds scripts/build-skills.cjs. */
+function findOrchestrator(): string | null {
+  let dir = dirname(process.argv[1] ?? process.cwd());
+  for (let i = 0; i < 8; i++) {
+    const candidate = join(dir, 'scripts', 'build-skills.cjs');
+    if (existsSync(candidate)) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  const cwdCandidate = join(process.cwd(), 'scripts', 'build-skills.cjs');
+  return existsSync(cwdCandidate) ? cwdCandidate : null;
+}
+
+export async function buildCommand(parsed: ParsedArgs, ctx: CommandCtx): Promise<number> {
+  if (parsed.flags['help'] === true || parsed.flags['h'] === true) {
+    ctx.stdout.write(BUILD_USAGE);
+    return 0;
+  }
+
+  const target = parsed.positionals[0];
+  if (target !== 'skills') {
+    ctx.stderr.write(`gdd-sdk build: expected target "skills" (got ${target ? `"${target}"` : 'nothing'})\n${BUILD_USAGE}`);
+    return 3;
+  }
+
+  let flags: Record<string, unknown>;
+  try {
+    flags = coerceFlags(parsed, BUILD_FLAGS);
+  } catch {
+    ctx.stderr.write(`gdd-sdk build: invalid flags\n${BUILD_USAGE}`);
+    return 3;
+  }
+
+  const script = findOrchestrator();
+  if (!script) {
+    ctx.stderr.write('gdd-sdk build: could not locate scripts/build-skills.cjs\n');
+    return 3;
+  }
+
+  const orchestratorArgs: string[] = [];
+  if (flags['check'] === true) orchestratorArgs.push('--check');
+  if (flags['zip'] === true) orchestratorArgs.push('--zip');
+  const harness = flags['harness'];
+  if (typeof harness === 'string' && harness.length > 0) {
+    orchestratorArgs.push('--harness', harness);
+  }
+
+  const res = spawnSync(process.execPath, [script, ...orchestratorArgs], { encoding: 'utf8' });
+  if (res.stdout) ctx.stdout.write(res.stdout);
+  if (res.stderr) ctx.stderr.write(res.stderr);
+  if (res.error) {
+    ctx.stderr.write(`gdd-sdk build: failed to run orchestrator: ${res.error.message}\n`);
+    return 3;
+  }
+  return typeof res.status === 'number' ? res.status : 3;
+}