@hegemonart/get-design-done 1.42.0 → 1.44.0

package/scripts/lib/manifest/harnesses.json

@@ -7,85 +7,351 @@
       "id": "claude",
       "name": "Claude Code",
       "config_dir": ".claude",
-      "runtime_models_ref": "reference/runtime-models.md#claude"
+      "runtime_models_ref": "reference/runtime-models.md#claude",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "argument-hint",
+          "tools",
+          "disable-model-invocation"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": true,
+        "placeholder_substitution": true,
+        "install_path": "dist/claude-code/.claude/skills/",
+        "status": "tested"
+      },
+      "last_verified": "2026-06-02",
+      "capability_notes": "Host runtime. Marketplace-registered, end-to-end documented, Phase 42 golden baseline.",
+      "fragment_links": [
+        "reference/runtime-models.md#claude---claude-code"
+      ]
     },
     {
       "id": "codex",
       "name": "OpenAI Codex CLI",
       "config_dir": ".codex",
-      "runtime_models_ref": "reference/runtime-models.md#codex"
+      "runtime_models_ref": "reference/runtime-models.md#codex",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd-<skill>",
+        "mcp_support": true,
+        "placeholder_substitution": true,
+        "install_path": "dist/codex/.codex/skills/",
+        "status": "experimental"
+      },
+      "last_verified": null,
+      "capability_notes": "Peer-CLI delegation target (ASP). Flat /gdd- command namespace. MCP auto-registered.",
+      "fragment_links": [
+        "reference/runtime-models.md#codex---openai-codex-cli",
+        "reference/codex-tools.md#tool-name-mapping",
+        "reference/peer-cli-capabilities.md#codex-asp",
+        "reference/peer-protocols.md#asp---app-server-protocol-codex"
+      ]
     },
     {
       "id": "gemini",
       "name": "Gemini CLI",
       "config_dir": ".gemini",
-      "runtime_models_ref": "reference/runtime-models.md#gemini"
+      "runtime_models_ref": "reference/runtime-models.md#gemini",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": true,
+        "placeholder_substitution": true,
+        "install_path": "dist/gemini/.gemini/skills/",
+        "status": "experimental"
+      },
+      "last_verified": null,
+      "capability_notes": "",
+      "fragment_links": [
+        "reference/runtime-models.md#gemini---gemini-cli",
+        "reference/gemini-tools.md#tool-name-mapping",
+        "reference/peer-cli-capabilities.md#gemini-acp",
+        "reference/peer-protocols.md#acp---agent-client-protocol"
+      ]
     },
     {
       "id": "qwen",
       "name": "Qwen Code",
       "config_dir": ".qwen",
-      "runtime_models_ref": "reference/runtime-models.md#qwen"
+      "runtime_models_ref": "reference/runtime-models.md#qwen",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": false,
+        "placeholder_substitution": true,
+        "install_path": "dist/qwen/.qwen/skills/",
+        "status": "experimental"
+      },
+      "last_verified": null,
+      "capability_notes": "",
+      "fragment_links": [
+        "reference/runtime-models.md#qwen---qwen-code",
+        "reference/peer-cli-capabilities.md#qwen-acp",
+        "reference/peer-protocols.md#acp---agent-client-protocol"
+      ]
     },
     {
       "id": "kilo",
       "name": "Kilo Code",
       "config_dir": ".kilo",
-      "runtime_models_ref": "reference/runtime-models.md#kilo"
+      "runtime_models_ref": "reference/runtime-models.md#kilo",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": false,
+        "placeholder_substitution": true,
+        "install_path": "dist/kilo/.kilo/skills/",
+        "status": "untested"
+      },
+      "last_verified": null,
+      "capability_notes": "",
+      "fragment_links": [
+        "reference/runtime-models.md#kilo---kilo-code"
+      ]
     },
     {
       "id": "copilot",
       "name": "GitHub Copilot CLI",
       "config_dir": ".copilot",
-      "runtime_models_ref": "reference/runtime-models.md#copilot"
+      "runtime_models_ref": "reference/runtime-models.md#copilot",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": false,
+        "placeholder_substitution": true,
+        "install_path": "dist/copilot/.copilot/skills/",
+        "status": "experimental"
+      },
+      "last_verified": null,
+      "capability_notes": "",
+      "fragment_links": [
+        "reference/runtime-models.md#copilot---github-copilot-cli",
+        "reference/peer-cli-capabilities.md#copilot-acp",
+        "reference/peer-protocols.md#acp---agent-client-protocol"
+      ]
     },
     {
       "id": "cursor",
       "name": "Cursor",
       "config_dir": ".cursor",
-      "runtime_models_ref": "reference/runtime-models.md#cursor"
+      "runtime_models_ref": "reference/runtime-models.md#cursor",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": false,
+        "placeholder_substitution": true,
+        "install_path": "dist/cursor/.cursor/skills/",
+        "status": "experimental"
+      },
+      "last_verified": null,
+      "capability_notes": "",
+      "fragment_links": [
+        "reference/runtime-models.md#cursor---cursor",
+        "reference/peer-cli-capabilities.md#cursor-acp",
+        "reference/peer-protocols.md#acp---agent-client-protocol"
+      ]
     },
     {
       "id": "windsurf",
       "name": "Windsurf (Cascade)",
       "config_dir": ".windsurf",
-      "runtime_models_ref": "reference/runtime-models.md#windsurf"
+      "runtime_models_ref": "reference/runtime-models.md#windsurf",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": false,
+        "placeholder_substitution": true,
+        "install_path": "dist/windsurf/.windsurf/skills/",
+        "status": "untested"
+      },
+      "last_verified": null,
+      "capability_notes": "",
+      "fragment_links": [
+        "reference/runtime-models.md#windsurf---windsurf"
+      ]
     },
     {
       "id": "antigravity",
       "name": "Antigravity",
       "config_dir": ".antigravity",
-      "runtime_models_ref": "reference/runtime-models.md#antigravity"
+      "runtime_models_ref": "reference/runtime-models.md#antigravity",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": false,
+        "placeholder_substitution": true,
+        "install_path": "dist/antigravity/.antigravity/skills/",
+        "status": "untested"
+      },
+      "last_verified": null,
+      "capability_notes": "",
+      "fragment_links": [
+        "reference/runtime-models.md#antigravity---antigravity"
+      ]
     },
     {
       "id": "augment",
       "name": "Augment",
       "config_dir": ".augment",
-      "runtime_models_ref": "reference/runtime-models.md#augment"
+      "runtime_models_ref": "reference/runtime-models.md#augment",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": false,
+        "placeholder_substitution": true,
+        "install_path": "dist/augment/.augment/skills/",
+        "status": "untested"
+      },
+      "last_verified": null,
+      "capability_notes": "",
+      "fragment_links": [
+        "reference/runtime-models.md#augment---augment"
+      ]
     },
     {
       "id": "trae",
       "name": "Trae",
       "config_dir": ".trae",
-      "runtime_models_ref": "reference/runtime-models.md#trae"
+      "runtime_models_ref": "reference/runtime-models.md#trae",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": false,
+        "placeholder_substitution": true,
+        "install_path": "dist/trae/.trae/skills/",
+        "status": "untested"
+      },
+      "last_verified": null,
+      "capability_notes": "",
+      "fragment_links": [
+        "reference/runtime-models.md#trae---trae"
+      ]
     },
     {
       "id": "codebuddy",
       "name": "CodeBuddy",
       "config_dir": ".codebuddy",
-      "runtime_models_ref": "reference/runtime-models.md#codebuddy"
+      "runtime_models_ref": "reference/runtime-models.md#codebuddy",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": false,
+        "placeholder_substitution": true,
+        "install_path": "dist/codebuddy/.codebuddy/skills/",
+        "status": "untested"
+      },
+      "last_verified": null,
+      "capability_notes": "",
+      "fragment_links": [
+        "reference/runtime-models.md#codebuddy---codebuddy"
+      ]
     },
     {
       "id": "cline",
       "name": "Cline",
       "config_dir": ".cline",
-      "runtime_models_ref": "reference/runtime-models.md#cline"
+      "runtime_models_ref": "reference/runtime-models.md#cline",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": false,
+        "placeholder_substitution": true,
+        "install_path": "dist/cline/.cline/skills/",
+        "status": "untested"
+      },
+      "last_verified": null,
+      "capability_notes": "Installs into .clinerules at install time (clinerules-embed special case); dist/cline/ is the compile artifact only.",
+      "fragment_links": [
+        "reference/runtime-models.md#cline---cline"
+      ]
     },
     {
       "id": "opencode",
       "name": "OpenCode",
       "config_dir": ".opencode",
-      "runtime_models_ref": "reference/runtime-models.md#opencode"
+      "runtime_models_ref": "reference/runtime-models.md#opencode",
+      "capability_matrix": {
+        "skill_discovery": true,
+        "frontmatter_fields_supported": [
+          "name",
+          "description",
+          "tools"
+        ],
+        "command_syntax": "/gdd:<skill>",
+        "mcp_support": false,
+        "placeholder_substitution": true,
+        "install_path": "dist/opencode/.opencode/skills/",
+        "status": "untested"
+      },
+      "last_verified": null,
+      "capability_notes": "",
+      "fragment_links": [
+        "reference/runtime-models.md#opencode---opencode"
+      ]
     }
   ]
 }

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

@@ -115,7 +115,7 @@
     {
       "pattern": "\\u2014",
       "kind": "token",
-      "note": "Em dash — banned in the project's own user-facing prose (Phase 43)."
+      "note": "Em dash - banned in the project's own user-facing prose (Phase 43)."
     },
     {
       "pattern": "--",

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

@@ -30,6 +30,38 @@
           "name": {
             "type": "string",
             "minLength": 1
+          },
+          "last_verified": {
+            "type": ["string", "null"],
+            "description": "YYYY-MM-DD of the last verify-harness run; null if never verified (Phase 44)."
+          },
+          "capability_notes": {
+            "type": "string"
+          },
+          "fragment_links": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "capability_matrix": {
+            "type": "object",
+            "description": "Phase 44 harness capability matrix (a view of this SoT; HARNESSES.md is generated from it).",
+            "additionalProperties": true,
+            "required": ["status", "command_syntax", "install_path"],
+            "properties": {
+              "skill_discovery": { "type": "boolean" },
+              "frontmatter_fields_supported": {
+                "type": "array",
+                "items": { "type": "string" }
+              },
+              "command_syntax": { "type": "string", "minLength": 1 },
+              "mcp_support": { "type": "boolean" },
+              "placeholder_substitution": { "type": "boolean" },
+              "install_path": { "type": "string", "minLength": 1 },
+              "status": {
+                "type": "string",
+                "enum": ["tested", "experimental", "untested", "known-broken"]
+              }
+            }
           }
         }
       }

package/sdk/mcp/gdd-mcp/server.js

@@ -136,6 +136,107 @@ var require_kill_switch = __commonJS({
   }
 });
 
+// scripts/lib/manifest/loader.cjs
+var require_loader = __commonJS({
+  "scripts/lib/manifest/loader.cjs"(exports2, module2) {
+    "use strict";
+    var fs = require("node:fs");
+    var path = require("node:path");
+    var MANIFEST_DIR = __dirname;
+    var _cache = /* @__PURE__ */ new Map();
+    function reset() {
+      _cache.clear();
+    }
+    function load(name13, opts) {
+      const o = opts || {};
+      const dir = o.dir || MANIFEST_DIR;
+      const fallback = Object.prototype.hasOwnProperty.call(o, "fallback") ? o.fallback : {};
+      const abs = path.join(dir, `${name13}.json`);
+      let stat;
+      try {
+        stat = fs.statSync(abs);
+      } catch {
+        if (!o.quiet) process.stderr.write(`manifest: ${name13}.json not found \u2014 using empty fallback (a consumer phase may not have shipped its data yet)
+`);
+        return fallback;
+      }
+      const cached = _cache.get(abs);
+      if (cached && cached.mtimeMs === stat.mtimeMs) return cached.data;
+      try {
+        const data = JSON.parse(fs.readFileSync(abs, "utf8"));
+        _cache.set(abs, { mtimeMs: stat.mtimeMs, data });
+        return data;
+      } catch (e) {
+        if (!o.quiet) process.stderr.write(`manifest: ${name13}.json parse error (${e.message}) \u2014 using empty fallback
+`);
+        return fallback;
+      }
+    }
+    module2.exports = { load, reset, MANIFEST_DIR };
+  }
+});
+
+// scripts/lib/manifest/index.cjs
+var require_manifest = __commonJS({
+  "scripts/lib/manifest/index.cjs"(exports2, module2) {
+    "use strict";
+    var loader = require_loader();
+    function readHarnesses(opts) {
+      return loader.load("harnesses", { ...opts, fallback: { schema_version: 1, generated_at: null, harnesses: [] } });
+    }
+    function readSkills(opts) {
+      return loader.load("skills", { ...opts, fallback: { schema_version: 1, skills: [] } });
+    }
+    function readProseDenylist(opts) {
+      return loader.load("prose-denylist", { ...opts, fallback: { schema_version: 1, tells: [] } });
+    }
+    module2.exports = {
+      readHarnesses,
+      readSkills,
+      readProseDenylist,
+      reset: loader.reset,
+      MANIFEST_DIR: loader.MANIFEST_DIR
+    };
+  }
+});
+
+// scripts/lib/harness-freshness.cjs
+var require_harness_freshness = __commonJS({
+  "scripts/lib/harness-freshness.cjs"(exports2, module2) {
+    "use strict";
+    var { readHarnesses } = require_manifest();
+    var WARN_DAYS = 60;
+    var FAIL_DAYS = 180;
+    var MS_PER_DAY = 864e5;
+    function ageInDays(last_verified, nowMs) {
+      if (!last_verified) return Infinity;
+      const t = Date.parse(last_verified);
+      if (!Number.isFinite(t)) return Infinity;
+      return (nowMs - t) / MS_PER_DAY;
+    }
+    function checkFreshness({ nowMs, harnesses } = {}) {
+      const list = harnesses || readHarnesses().harnesses || [];
+      const now = typeof nowMs === "number" ? nowMs : Date.now();
+      return list.map((h) => {
+        const status = h.capability_matrix && h.capability_matrix.status || "untested";
+        const age = ageInDays(h.last_verified, now);
+        let freshness = "n/a";
+        if (status === "tested") {
+          freshness = age >= FAIL_DAYS ? "fail" : age >= WARN_DAYS ? "warn" : "ok";
+        }
+        return {
+          id: h.id,
+          status,
+          last_verified: h.last_verified || null,
+          age_days: Number.isFinite(age) ? Math.floor(age) : null,
+          freshness
+        };
+      });
+    }
+    module2.exports = { checkFreshness, ageInDays, WARN_DAYS, FAIL_DAYS };
+  }
+});
+
 // scripts/lib/health-mirror/index.cjs
 var require_health_mirror = __commonJS({
   "scripts/lib/health-mirror/index.cjs"(exports2, module2) {
@@ -143,6 +244,7 @@ var require_health_mirror = __commonJS({
     var fs = require("node:fs");
     var path = require("node:path");
     var { getDisableReason } = require_kill_switch();
+    var { checkFreshness, WARN_DAYS, FAIL_DAYS } = require_harness_freshness();
     function fileExists(p) {
       try {
         return fs.statSync(p).isFile();
@@ -270,6 +372,29 @@ var require_health_mirror = __commonJS({
         }
         checks.push({ name: "skill_discipline", status, detail });
       }
+      {
+        let status = "ok";
+        let detail;
+        try {
+          const results = checkFreshness();
+          const failing = results.filter((r) => r.freshness === "fail");
+          const warning = results.filter((r) => r.freshness === "warn");
+          const tested = results.filter((r) => r.status === "tested");
+          if (failing.length) {
+            status = "fail";
+            detail = `harness freshness: ${failing.length} stale (>${FAIL_DAYS}d): ${failing.map((r) => r.id).join(", ")}`;
+          } else if (warning.length) {
+            status = "warn";
+            detail = `harness freshness: ${warning.length} aging (>${WARN_DAYS}d): ${warning.map((r) => r.id).join(", ")}`;
+          } else {
+            detail = `harness freshness: ${tested.length} tested harness(es) current`;
+          }
+        } catch {
+          status = "warn";
+          detail = "harness freshness: unavailable";
+        }
+        checks.push({ name: "harness_freshness", status, detail });
+      }
       return { checks };
     }
     function sessionStartWiresInject(rootDir) {

package/skills/add-backlog/SKILL.md

@@ -10,11 +10,11 @@ disable-model-invocation: true
 
 **Role:** Long-term parking lot for design ideas. Backing store: `.design/backlog/BACKLOG.md`.
 
-## Step 1 — Get text
+## Step 1 - Get text
 
 If `$ARGUMENTS` is empty, ask the user: "What should be added to the backlog?"
 
-## Step 2 — Append
+## Step 2 - Append
 
 Create `.design/backlog/` directory and `BACKLOG.md` with `# Design Backlog` header if missing.
 
@@ -43,6 +43,6 @@ Promote later via: /gdd:review-backlog
 ## Constraints
 
 - Do not modify files outside `.design/backlog/`.
-- Do not set status to anything other than `parked` here — `/gdd:review-backlog` owns status transitions.
+- Do not set status to anything other than `parked` here - `/gdd:review-backlog` owns status transitions.
 
 ## ADD-BACKLOG COMPLETE

package/skills/analyze-dependencies/SKILL.md

@@ -6,7 +6,7 @@ tools: Bash, Read, Glob, Grep
 
 # /gdd:analyze-dependencies
 
-**Role:** Surface dependency relationships, token usage spread, component graphs, and decision traceability using `.design/intel/`. All queries are O(1) reads against pre-built JSON slices — no file greps. See `./reference/heuristics.md` for the underlying dependency-analysis heuristics (fan-out thresholds, orphan-token criteria, cycle-detection bias).
+**Role:** Surface dependency relationships, token usage spread, component graphs, and decision traceability using `.design/intel/`. All queries are O(1) reads against pre-built JSON slices - no file greps. See `./reference/heuristics.md` for the underlying dependency-analysis heuristics (fan-out thresholds, orphan-token criteria, cycle-detection bias).
 
 ## Pre-flight
 
@@ -26,13 +26,13 @@ Then re-run /gdd:analyze-dependencies.
 
 ## Usage modes
 
-- `/gdd:analyze-dependencies` — run all four analyses and print a combined report
-- `/gdd:analyze-dependencies tokens` — token fan-out only
-- `/gdd:analyze-dependencies components` — component call-graph only
-- `/gdd:analyze-dependencies decisions` — decision traceability only
-- `/gdd:analyze-dependencies circular` — circular dependency detection only
+- `/gdd:analyze-dependencies` - run all four analyses and print a combined report
+- `/gdd:analyze-dependencies tokens` - token fan-out only
+- `/gdd:analyze-dependencies components` - component call-graph only
+- `/gdd:analyze-dependencies decisions` - decision traceability only
+- `/gdd:analyze-dependencies circular` - circular dependency detection only
 
-## Analysis 1 — Token fan-out
+## Analysis 1 - Token fan-out
 
 Surfaces tokens referenced in many files + orphans (referenced exactly once).
 
@@ -42,7 +42,7 @@ Surfaces tokens referenced in many files + orphans (referenced exactly once).
 
 Header: `━━━ Token fan-out ━━━` … `(top 20 shown)` … `Orphaned tokens (referenced in exactly 1 file):` … footer rule.
 
-## Analysis 2 — Component call-graph
+## Analysis 2 - Component call-graph
 
 Surfaces widely-referenced components and the files referencing each.
 
@@ -52,7 +52,7 @@ Surfaces widely-referenced components and the files referencing each.
 
 Header: `━━━ Component call-graph ━━━` … footer rule.
 
-## Analysis 3 — Decision traceability
+## Analysis 3 - Decision traceability
 
 Maps decisions to skill/agent files that cite them.
 
@@ -64,7 +64,7 @@ Maps decisions to skill/agent files that cite them.
 
 Empty-state: `No decisions indexed. Run node scripts/build-intel.cjs after creating .design/DESIGN-CONTEXT.md.`
 
-## Analysis 4 — Circular dependency detection
+## Analysis 4 - Circular dependency detection
 
 Detects cycles in the `@`-reference graph (File A → File B → File A). DFS with path-tracking detects back-edges; algorithm + adjacency-map shape detailed in `./reference/heuristics.md` §"Dependency-cycle detection".