@skillcap/gdh 0.26.3 → 0.26.4

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "0.26.3",
+  "version": "0.26.4",
   "installMode": "packaged_install"
 }

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -3119,6 +3119,63 @@
           }
         ]
       }
+    },
+    {
+      "version": "0.26.4",
+      "releaseTag": "v0.26.4",
+      "migrationStatus": "required",
+      "summary": "v0.26.4 bumps GDH_UPDATE_HOOK_VERSION 12 -> 13 to land a three-bug fix in the managed authoring-hook.js. Bug A: spawnDetachedWarmup running `gdh lsp warmup` only booted Godot LSP and never primed diagnostics-broker/snapshot.json, so the embedded reader returned `[pending] broker_not_yet_primed` indefinitely; replaced with spawnDetachedRefresh running `gdh authoring diagnostics refresh --target ROOT --changed FILE...` (calls refreshAuthoringDiagnostics which writes snapshot.json + primed marker, per-file 10 s drain timeout). Bug B: Stop hook emitted `{\"hookSpecificOutput\":{\"hookEventName\":\"Stop\",\"additionalContext\":\"...\"}}` for Claude, which Claude Stop schema rejects (Stop accepts only decision/reason/continue/stopReason/suppressOutput/systemMessage); Claude Stop now silent-allow, Codex Stop unchanged. Bug C: same gate silently swallowed Claude PostToolUse [pending]/[stale]/[timeout] hints; gate narrowed to Stop-only on Claude, plus new reasonHint(output, targetRoot) helper appended to context messages so the agent gets per-edit actionable next-step text per broker reason class. Class-1 deterministic re-bake (D-09 / D-03 exempt — GDH_UPDATE_HOOK_VERSION is in CLASS_ONE_REBAKE_EXEMPT). Managed targets re-bake via gdh self-update or gdh migrate --apply. No surface-schema changes; no AGENTS.md contract bump; no broker schema bump.",
+      "releaseHighlights": {
+        "summary": "v0.26.4 is a patch release that fixes a three-bug stack in the managed authoring hook (`packages/adapters/src/templates/authoring-hook.js.tpl`) that was preventing the post-edit dispatch from ever reaching `[fresh]` on Claude. v0.26.3 eliminated the per-edit npx tax via the embedded broker-snapshot reader, but the detached spawn still ran `gdh lsp warmup` — which only boots Godot LSP and writes `lsp-instance.json`, never priming the broker `snapshot.json` that the embedded reader requires. The hook also emitted Claude-invalid Stop JSON and silently dropped Claude PostToolUse hints. v0.26.4 replaces the bare warmup with a scoped `gdh authoring diagnostics refresh --target ROOT --changed FILE...` spawn, makes Claude Stop silent-allow, and adds agent-actionable per-edit `reasonHint` text on `[pending]/[stale]/[timeout]` PostToolUse events.",
+        "operatorChanges": [
+          "**Hook spawns scoped diagnostics refresh, not bare warmup.** `spawnDetachedWarmup(targetRoot)` renamed to `spawnDetachedRefresh(targetRoot, files)`; the spawned argv is `npx -y @skillcap/gdh@PINNED authoring diagnostics refresh --target <root> --changed <file>...` with `detached: true`, `stdio: 'ignore'`, `windowsHide: true`, `.unref()` invariants preserved (Pitfall 1). All four call sites updated (PostToolUse, PostToolBatch, Stop cold-broker × 2). The new CLI verb runs `getManagedLspStatus({ launchPolicy: \"launch_if_needed\" })` (boots Godot if needed), opens scoped files via LSP, drains diagnostics with per-file 10 s timeout, and writes `diagnostics-broker/snapshot.json` plus the `primed` marker via `writePersistedSnapshot` (`packages/authoring/src/diagnostics-broker.ts:316`). Result: post-edit hooks now reach `[fresh]` on the second edit instead of looping forever on `[pending] broker_not_yet_primed`.",
+          "**Claude Stop hook silent-allow.** The Stop hook previously emitted `{\"hookSpecificOutput\":{\"hookEventName\":\"Stop\",\"additionalContext\":\"...\"}}`, which Claude rejects with `error: hook returned invalid stop hook JSON output` because the documented Stop schema only accepts `decision` / `reason` / `continue` / `stopReason` / `suppressOutput` / `systemMessage`. The `context()` gate now returns `allow()` (empty stdout, exit 0) for Claude Stop. Codex Stop is unchanged — Codex accepts `additionalContext` on every event.",
+          "**Per-edit `reasonHint` on Claude PostToolUse / PostToolBatch.** The same `context()` gate previously silently swallowed Claude PostToolUse `[pending]/[stale]/[timeout]` results, so the agent received no per-edit signal. The fix narrows the gate to `if (AGENT !== 'codex' && CURRENT_EVENT === 'Stop') return allow();`, so Claude PostToolUse / PostToolBatch / FileChanged now emit `hookSpecificOutput.additionalContext`. A new `reasonHint(output, targetRoot)` helper appends an agent-actionable next step keyed on the broker reason class (`lsp_instance_not_running`, `broker_not_yet_primed`, `file_not_in_snapshot`, `content_hash_mismatch`, `freshness_expired`, `lsp_instance_identity_mismatch`, generic). Each hint embeds the target path so the agent has copy-paste-ready commands like `gdh authoring diagnostics refresh --target \"<root>\"` or `gdh lsp prune --target \"<root>\"`.",
+          "**`GDH_UPDATE_HOOK_VERSION` 12 → 13.** Forces deterministic re-bake on the existing class-1 deterministic surface mechanism. No agentContract bump, no `MIGRATION_REGISTRY_ENTRIES` entry, no schema change."
+        ]
+      },
+      "updateContract": {
+        "summary": "Managed targets must re-bake the managed authoring-hook.js so the detached spawn switches from bare `lsp warmup` to scoped `authoring diagnostics refresh --target ROOT --changed FILE...`, Claude Stop becomes silent-allow (instead of emitting the Claude-invalid `hookSpecificOutput.additionalContext` JSON), and PostToolUse / PostToolBatch [pending]/[stale]/[timeout] events on Claude now deliver agent-actionable reasonHint text. Re-render is deterministic; no manual editor steps. Operators see two visible behavior deltas: post-edit dispatch now reaches `[fresh]` on the second edit instead of looping forever on `broker_not_yet_primed`, and the `Stop hook (failed): hook returned invalid stop hook JSON output` Claude error stops appearing.",
+        "steps": [
+          {
+            "id": "install_v0_26_4",
+            "kind": "mechanical",
+            "summary": "Install the v0.26.4 GDH package.",
+            "detail": "Run gdh self-update so the target uses the new managed authoring-hook.js fingerprint (hook version 13) with the scoped diagnostics-refresh spawn, Claude Stop silent-allow, and reasonHint helper.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh adapters status"
+            ]
+          },
+          {
+            "id": "rebake_authoring_hook",
+            "kind": "mechanical",
+            "summary": "Re-bake managed authoring-hook.js via gdh migrate --apply.",
+            "detail": "If gdh self-update reports pending lifecycle work, run gdh migrate --apply. The migrate path re-renders the managed Codex authoring hook and the Claude authoring hook templates with hook version 13: spawnDetachedRefresh replaces spawnDetachedWarmup (argv: authoring diagnostics refresh --target ROOT --changed FILE...), context() Stop branch returns allow() on Claude (silent), and reasonHint(output, targetRoot) is appended to PostToolUse / PostToolBatch / Stop pending-stale-timeout context messages. The new behavior is opaque to AGENTS.md contract surfaces, settings, and skill bodies; no other re-bake required for this release.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh adapters status"
+            ]
+          },
+          {
+            "id": "confirm_post_edit_reaches_fresh",
+            "kind": "agent_reasoning",
+            "summary": "Confirm post-edit dispatch now reaches `[fresh]` and Claude Stop no longer fails.",
+            "detail": "Inspect the rendered authoring-hook.js header for `gdh-hook-version: 13` and confirm `spawnDetachedRefresh` (or equivalent symbol) plus `reasonHint` appear in the script. Optionally exercise: edit a `.gd` file in the configured Godot target; the first PostToolUse hook returns `[pending] broker_not_yet_primed` plus a `reasonHint` snippet pointing at `gdh authoring diagnostics refresh --target <root>`, and the detached refresh primes `<integrationRoot>/.gdh-state/authoring/diagnostics-broker/snapshot.json` within ~10 s. Subsequent edits to the same file return silent allow ([fresh]) from the embedded reader. End-of-session Stop on Claude no longer surfaces `Stop hook (failed): hook returned invalid stop hook JSON output`.",
+            "commands": [
+              "gdh adapters status"
+            ],
+            "validationCommands": [
+              "gdh adapters status"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

package/node_modules/@gdh/adapters/dist/templates/authoring-hook.js.tpl

@@ -52,12 +52,14 @@ function handlePostEdit(input, targetRoot) {
   const changed = collectChangedFiles(input, targetRoot);
   const authoring = changed.filter(isAuthoringValidationPath);
   if (authoring.length === 0) return allow();
-  // Phase 82 / LSP-02: fire-and-forget warmup BEFORE the bounded check. The verb
-  // is idempotent (lsp.lock single-attempt; in-flight warmups return "warming"
-  // without re-spawning) so spamming on every edit is safe. Hook still returns
-  // within CHECK_TIMEOUT_MS regardless of warmup outcome (Pitfall 1: detached +
-  // stdio:'ignore' + .unref() means the parent never blocks on the child).
-  spawnDetachedWarmup(targetRoot);
+  // Phase 82 / LSP-02: fire-and-forget scoped diagnostics refresh BEFORE the
+  // bounded read. The verb calls `refreshAuthoringDiagnostics` which boots
+  // Godot LSP if needed, opens scoped files via LSP, drains diagnostics, and
+  // writes `diagnostics-broker/snapshot.json` + `primed` marker. Hook still
+  // returns within CHECK_TIMEOUT_MS regardless of refresh outcome (Pitfall 1:
+  // detached + stdio:'ignore' + .unref() means the parent never blocks on
+  // the child).
+  spawnDetachedRefresh(targetRoot, authoring);
   // Quick task 260504-ix2: embedded broker-snapshot reader. Replaces the
   // per-edit synchronous `npx -y @skillcap/gdh@PINNED authoring check ...`
   // shellout (which was eating the full `CHECK_TIMEOUT_MS` budget on the npx
@@ -84,10 +86,10 @@ function handlePostEdit(input, targetRoot) {
     return allow();
   }
   if (/^\[pending\]/m.test(output) || /^\[stale\]/m.test(output)) {
-    return context(`GDH post-edit authoring check could not prove this edit quickly; continuing without blocking. ${compactOneLine(output || 'Run final authoring validation before claiming code-validity.')}`);
+    return context(`GDH post-edit authoring check could not prove this edit quickly; continuing without blocking. ${compactOneLine(output || 'Run final authoring validation before claiming code-validity.')} ${reasonHint(output, targetRoot)}`);
   }
   if (/^\[timeout\]/m.test(output)) {
-    return context(`GDH post-edit authoring check returned a timeout status; continuing without blocking. ${compactOneLine(output || 'Run final authoring validation before claiming code-validity.')}`);
+    return context(`GDH post-edit authoring check returned a timeout status; continuing without blocking. ${compactOneLine(output || 'Run final authoring validation before claiming code-validity.')} ${reasonHint(output, targetRoot)}`);
   }
   return allow();
 }
@@ -130,10 +132,10 @@ function handlePostToolBatch(input, targetRoot) {
   const authoring = unique(files).filter(isAuthoringValidationPath);
   if (authoring.length === 0) return allow();  // Pitfall 2: no authoring files — no work
 
-  // SC2: spawnDetachedWarmup reuses Phase 82's lsp.lock-serialized helper. If a
-  // per-edit warmup is already in flight when this fires, the lock primitive
-  // returns warming without spawning a second Godot.
-  spawnDetachedWarmup(targetRoot);
+  // SC2: spawnDetachedRefresh reuses the lsp.lock-serialized helper. If a
+  // per-edit refresh is already in flight when this fires, the broker side
+  // serializes via the lock primitive — no double-spawn of Godot.
+  spawnDetachedRefresh(targetRoot, authoring);
 
   // Quick task 260504-ix2: embedded broker-snapshot reader replaces the
   // synchronous `npx ... authoring check` shellout. The reader is invoked
@@ -160,10 +162,10 @@ function handlePostToolBatch(input, targetRoot) {
     return allow();
   }
   if (/^\[pending\]/m.test(output) || /^\[stale\]/m.test(output)) {
-    return context(`GDH PostToolBatch authoring check could not prove this batch quickly; continuing without blocking. ${compactOneLine(output || 'Run final authoring validation before claiming code-validity.')}`);
+    return context(`GDH PostToolBatch authoring check could not prove this batch quickly; continuing without blocking. ${compactOneLine(output || 'Run final authoring validation before claiming code-validity.')} ${reasonHint(output, targetRoot)}`);
   }
   if (/^\[timeout\]/m.test(output)) {
-    return context(`GDH PostToolBatch authoring check returned a timeout status; continuing without blocking. ${compactOneLine(output || 'Run final authoring validation before claiming code-validity.')}`);
+    return context(`GDH PostToolBatch authoring check returned a timeout status; continuing without blocking. ${compactOneLine(output || 'Run final authoring validation before claiming code-validity.')} ${reasonHint(output, targetRoot)}`);
   }
   return allow();
 }
@@ -171,24 +173,39 @@ function handlePostToolBatch(input, targetRoot) {
 // Quick task 260504-ix2: `runGdh` deleted. The function previously wrapped
 // `spawnSync('npx', ['-y', '@skillcap/gdh@PINNED', ...args])` for the three
 // event handlers (handlePostEdit, handlePostToolBatch, handleStop). All three
-// now call `runEmbeddedDiagnosticsRead` instead. `spawnDetachedWarmup` uses
+// now call `runEmbeddedDiagnosticsRead` instead. `spawnDetachedRefresh` uses
 // `child_process.spawn` directly (always did — it was never a `runGdh`
-// caller), so removing the helper has no effect on the warmup path.
-
-// Phase 82 / LSP-02. Fire-and-forget warmup spawn from the post-edit hook. The
-// hook returns within CHECK_TIMEOUT_MS regardless of whether warmup has finished
-// — Godot startup typically takes 2-5 s, much longer than the 2500 ms cap.
+// caller), so removing the helper has no effect on the refresh path.
+// Quick task 260504-o6w renamed `spawnDetachedWarmup` → `spawnDetachedRefresh`
+// and switched the spawn argv from `lsp warmup` to `authoring diagnostics
+// refresh --changed`. Detached spawn still uses `child_process.spawn` directly
+// (always did).
+
+// Quick task 260504-o6w. Fire-and-forget scoped diagnostics refresh from the
+// post-edit hook. The CLI verb calls `refreshAuthoringDiagnostics` which boots
+// Godot LSP if needed, opens scoped files via LSP, drains diagnostics, and
+// writes `diagnostics-broker/snapshot.json` + `primed` marker — so this single
+// fire-and-forget call covers BOTH warmup and broker priming. The previous
+// `lsp warmup` argv only wrote `lsp-instance.json` and left the broker empty,
+// leaving the embedded reader stuck on `[pending] broker_not_yet_primed`
+// indefinitely (verified live on TheBeacon, 2026-05-04 dogfooding session 14).
 //
 // All three options are required (Pitfall 1):
 //   - detached: true       — child gets its own process group, survives parent exit
 //   - stdio: 'ignore'      — no fds tether the child to the parent's lifecycle
 //   - windowsHide: true    — prevents a console flash on Windows
 // .unref() is required so the Node event loop does not wait on the child.
-function spawnDetachedWarmup(targetRoot) {
+function spawnDetachedRefresh(targetRoot, files) {
   try {
+    const args = ['-y', `@skillcap/gdh@${PINNED_VERSION}`, 'authoring', 'diagnostics', 'refresh', '--target', targetRoot];
+    if (Array.isArray(files)) {
+      for (const f of files) {
+        args.push('--changed', f);
+      }
+    }
     const child = require('child_process').spawn(
       'npx',
-      ['-y', `@skillcap/gdh@${PINNED_VERSION}`, 'lsp', 'warmup', '--target', targetRoot],
+      args,
       {
         cwd: targetRoot,
         detached: true,
@@ -198,7 +215,7 @@ function spawnDetachedWarmup(targetRoot) {
     );
     child.unref();
   } catch (_error) {
-    // Silent failure — warmup is fire-and-forget. The bounded check below still runs.
+    // Silent failure — refresh is fire-and-forget. The bounded read below still runs.
   }
 }
 
@@ -262,27 +279,27 @@ function handleStop(input, targetRoot) {
     return allow();
   }
   if (/^\[failed\]/m.test(output) || /^\[partial\]/m.test(output) || /^\[stale\]/m.test(output)) {
-    return stopContext(`GDH session-end check found unresolved diagnostics: ${compactOneLine(output)}`);
+    return stopContext(`GDH session-end check found unresolved diagnostics: ${compactOneLine(output)} ${reasonHint(output, targetRoot)}`);
   }
   if (/^\[pending\]/m.test(output) || /^\[timeout\]/m.test(output)) {
-    // Cold/missing broker: spawn detached warmup so the NEXT session benefits.
+    // Cold/missing broker: spawn detached refresh so the NEXT session benefits.
     // The current Stop returns additionalContext recommending manual
     // `gdh authoring check --mode final` (the relaxed contract — see RFC 0009
-    // addendum 2026-05-04). spawnDetachedWarmup is fire-and-forget; it never
+    // addendum 2026-05-04). spawnDetachedRefresh is fire-and-forget; it never
     // blocks hook return.
-    spawnDetachedWarmup(targetRoot);
+    spawnDetachedRefresh(targetRoot, authoringFiles);
     return stopContext(
       'GDH session-end check could not prove final code-validity from the cached broker snapshot; continuing without blocking. ' +
       'Run `gdh authoring check --mode final` manually before claiming code-validity. ' +
-      compactOneLine(output),
+      compactOneLine(output) + ' ' + reasonHint(output, targetRoot),
     );
   }
   // Unknown status: degrade to additionalContext (NEVER block).
-  spawnDetachedWarmup(targetRoot);
+  spawnDetachedRefresh(targetRoot, authoringFiles);
   return stopContext(
     'GDH session-end check could not produce a final result; continuing without blocking. ' +
     'Run `gdh authoring check --mode final` manually before claiming code-validity. ' +
-    compactOneLine(output),
+    compactOneLine(output) + ' ' + reasonHint(output, targetRoot),
   );
 }
 
@@ -626,15 +643,49 @@ function compactOneLine(value) {
 }
 
 function allow() { process.exit(0); }
+// Quick task 260504-o6w: agent-actionable hint derived from the Reasons: line in
+// the embedded reader's output. The mapping covers all reason classes emitted by
+// `formatStatus` so the agent receives a copy-paste-ready command rather than a
+// generic "authoring check failed" message.
+function reasonHint(output, targetRoot) {
+  const text = String(output || '');
+  const match = text.match(/^Reasons:\s*(.+)$/m);
+  const reasons = match ? match[1].split(',').map(r => r.trim()).filter(Boolean) : [];
+  // JSON.stringify embeds the path so spaces and quotes survive shell re-use.
+  const targetArg = JSON.stringify(targetRoot);
+  // First-match-wins ordering: more specific reasons before generic.
+  if (reasons.includes('lsp_instance_identity_mismatch')) {
+    return `Cross-worktree LSP from another checkout. Run \`gdh lsp prune --target ${targetArg}\` then retry the edit.`;
+  }
+  if (reasons.includes('lsp_instance_not_running')) {
+    return `LSP launching in background; next edit will report fresh diagnostics. Force-prime: \`gdh authoring diagnostics refresh --target ${targetArg}\``;
+  }
+  if (reasons.includes('broker_not_yet_primed') || reasons.includes('file_not_in_snapshot')) {
+    return `Broker priming in background; next edit will be fresh. Force-prime: \`gdh authoring diagnostics refresh --target ${targetArg}\``;
+  }
+  if (reasons.includes('content_hash_mismatch') || reasons.includes('freshness_expired')) {
+    return `Broker snapshot stale; background refresh running. Force-prime: \`gdh authoring diagnostics refresh --target ${targetArg}\``;
+  }
+  return `Run \`gdh authoring check --mode final --target ${targetArg}\` to prime broker before claiming code-validity.`;
+}
+// Codex always receives hookSpecificOutput.additionalContext (any event — Codex's
+// hook contract accepts it on PreToolUse / PostToolUse / Stop / etc.).
+//
+// Claude receives hookSpecificOutput.additionalContext on PostToolUse / PostToolBatch
+// / FileChanged. Claude Stop is silent-allow because the Stop hook schema does NOT
+// accept additionalContext (only decision/reason/continue/stopReason/suppressOutput/
+// systemMessage). The previous gate emitted the wrong shape on every Claude Stop
+// and Claude rejected it as "invalid stop hook JSON output" (quick task 260504-o6w
+// bug B, verified live on TheBeacon 2026-05-04).
 function context(additionalContext) {
-  // Codex always receives hookSpecificOutput.additionalContext (any event).
-  // Claude receives hookSpecificOutput.additionalContext on Stop (Phase 82 / LSP-03) and
-  // on PostToolBatch (Phase 83 / LSP-09 — coalesced batch result). Without the third
-  // branch below, [pending]/[stale]/[timeout] PostToolBatch results would silently drop
-  // additionalContext on Claude — Pitfall 1.
-  if (AGENT !== 'codex') {
-    if (CURRENT_EVENT !== 'Stop' && CURRENT_EVENT !== 'PostToolBatch') return allow();
-  }
+  // Claude: Stop hook schema does NOT accept hookSpecificOutput.additionalContext
+  // (only decision/reason/continue/stopReason/suppressOutput/systemMessage). Emitting
+  // the wrong shape causes Claude to reject the hook with "invalid stop hook JSON
+  // output" — verified locally 2026-05-04 (quick task 260504-o6w bug B). Drop to
+  // silent-allow on Claude Stop. Claude PostToolUse / PostToolBatch DO accept
+  // additionalContext, so those branches still flow through. Codex accepts
+  // additionalContext on every event.
+  if (AGENT !== 'codex' && CURRENT_EVENT === 'Stop') return allow();
   const payload = { hookSpecificOutput: { hookEventName: CURRENT_EVENT, additionalContext } };
   process.stdout.write(`${JSON.stringify(payload)}\n`);
   process.exit(0);

package/node_modules/@gdh/adapters/package.json

@@ -11,13 +11,13 @@
     }
   },
   "dependencies": {
-    "@gdh/authoring": "0.26.3",
-    "@gdh/core": "0.26.3",
-    "@gdh/docs": "0.26.3",
-    "@gdh/observability": "0.26.3",
-    "@gdh/runtime": "0.26.3",
-    "@gdh/scan": "0.26.3",
-    "@gdh/verify": "0.26.3"
+    "@gdh/authoring": "0.26.4",
+    "@gdh/core": "0.26.4",
+    "@gdh/docs": "0.26.4",
+    "@gdh/observability": "0.26.4",
+    "@gdh/runtime": "0.26.4",
+    "@gdh/scan": "0.26.4",
+    "@gdh/verify": "0.26.4"
   },
-  "version": "0.26.3"
+  "version": "0.26.4"
 }

package/node_modules/@gdh/authoring/package.json

@@ -14,7 +14,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@gdh/core": "0.26.3"
+    "@gdh/core": "0.26.4"
   },
-  "version": "0.26.3"
+  "version": "0.26.4"
 }

package/node_modules/@gdh/cli/package.json

@@ -15,16 +15,16 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@gdh/adapters": "0.26.3",
-    "@gdh/authoring": "0.26.3",
-    "@gdh/core": "0.26.3",
-    "@gdh/docs": "0.26.3",
-    "@gdh/mcp": "0.26.3",
-    "@gdh/observability": "0.26.3",
-    "@gdh/runtime": "0.26.3",
-    "@gdh/scan": "0.26.3",
-    "@gdh/verify": "0.26.3",
+    "@gdh/adapters": "0.26.4",
+    "@gdh/authoring": "0.26.4",
+    "@gdh/core": "0.26.4",
+    "@gdh/docs": "0.26.4",
+    "@gdh/mcp": "0.26.4",
+    "@gdh/observability": "0.26.4",
+    "@gdh/runtime": "0.26.4",
+    "@gdh/scan": "0.26.4",
+    "@gdh/verify": "0.26.4",
     "picocolors": "^1.1.1"
   },
-  "version": "0.26.3"
+  "version": "0.26.4"
 }

package/node_modules/@gdh/core/dist/index.d.ts

@@ -55,7 +55,7 @@ export declare const GDH_AUTHORING_DOGFOOD_VERSION = 1;
 export declare const GDH_AUTHORING_SLICE_REPORT_VERSION = 1;
 export declare const GDH_MCP_MANIFEST_VERSION = 1;
 export declare const GDH_CURSOR_RULE_VERSION = 4;
-export declare const GDH_UPDATE_HOOK_VERSION = 12;
+export declare const GDH_UPDATE_HOOK_VERSION = 13;
 export declare const GDH_RUNTIME_RECIPE_RUN_VERSION = 1;
 export declare const GDH_RUNTIME_RUN_BUNDLE_VERSION = 1;
 export declare const GDH_RUNTIME_CORPUS_ARTIFACT_VERSION = 1;

package/node_modules/@gdh/core/dist/index.js

@@ -47,7 +47,7 @@ export const GDH_AUTHORING_DOGFOOD_VERSION = 1;
 export const GDH_AUTHORING_SLICE_REPORT_VERSION = 1;
 export const GDH_MCP_MANIFEST_VERSION = 1;
 export const GDH_CURSOR_RULE_VERSION = 4;
-export const GDH_UPDATE_HOOK_VERSION = 12;
+export const GDH_UPDATE_HOOK_VERSION = 13;
 export const GDH_RUNTIME_RECIPE_RUN_VERSION = 1;
 export const GDH_RUNTIME_RUN_BUNDLE_VERSION = 1;
 export const GDH_RUNTIME_CORPUS_ARTIFACT_VERSION = 1;

package/node_modules/@gdh/core/package.json

@@ -10,5 +10,5 @@
       "import": "./dist/index.js"
     }
   },
-  "version": "0.26.3"
+  "version": "0.26.4"
 }

package/node_modules/@gdh/docs/package.json

@@ -11,8 +11,8 @@
     }
   },
   "dependencies": {
-    "@gdh/core": "0.26.3",
+    "@gdh/core": "0.26.4",
     "yaml": "^2.8.3"
   },
-  "version": "0.26.3"
+  "version": "0.26.4"
 }

package/node_modules/@gdh/mcp/package.json

@@ -11,14 +11,14 @@
     }
   },
   "dependencies": {
-    "@gdh/adapters": "0.26.3",
-    "@gdh/authoring": "0.26.3",
-    "@gdh/core": "0.26.3",
-    "@gdh/docs": "0.26.3",
-    "@gdh/observability": "0.26.3",
-    "@gdh/scan": "0.26.3",
-    "@gdh/verify": "0.26.3",
+    "@gdh/adapters": "0.26.4",
+    "@gdh/authoring": "0.26.4",
+    "@gdh/core": "0.26.4",
+    "@gdh/docs": "0.26.4",
+    "@gdh/observability": "0.26.4",
+    "@gdh/scan": "0.26.4",
+    "@gdh/verify": "0.26.4",
     "@modelcontextprotocol/sdk": "1.29.0"
   },
-  "version": "0.26.3"
+  "version": "0.26.4"
 }

package/node_modules/@gdh/observability/package.json

@@ -11,7 +11,7 @@
     }
   },
   "dependencies": {
-    "@gdh/core": "0.26.3"
+    "@gdh/core": "0.26.4"
   },
-  "version": "0.26.3"
+  "version": "0.26.4"
 }

package/node_modules/@gdh/runtime/package.json

@@ -11,9 +11,9 @@
     }
   },
   "dependencies": {
-    "@gdh/core": "0.26.3",
+    "@gdh/core": "0.26.4",
     "ws": "^8.18.3",
     "yaml": "^2.8.3"
   },
-  "version": "0.26.3"
+  "version": "0.26.4"
 }

package/node_modules/@gdh/scan/package.json

@@ -11,8 +11,8 @@
     }
   },
   "dependencies": {
-    "@gdh/core": "0.26.3",
-    "@gdh/docs": "0.26.3"
+    "@gdh/core": "0.26.4",
+    "@gdh/docs": "0.26.4"
   },
-  "version": "0.26.3"
+  "version": "0.26.4"
 }

package/node_modules/@gdh/verify/package.json

@@ -11,13 +11,13 @@
     }
   },
   "dependencies": {
-    "@gdh/authoring": "0.26.3",
-    "@gdh/core": "0.26.3",
-    "@gdh/docs": "0.26.3",
-    "@gdh/observability": "0.26.3",
-    "@gdh/runtime": "0.26.3",
-    "@gdh/scan": "0.26.3",
+    "@gdh/authoring": "0.26.4",
+    "@gdh/core": "0.26.4",
+    "@gdh/docs": "0.26.4",
+    "@gdh/observability": "0.26.4",
+    "@gdh/runtime": "0.26.4",
+    "@gdh/scan": "0.26.4",
     "yaml": "^2.8.3"
   },
-  "version": "0.26.3"
+  "version": "0.26.4"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillcap/gdh",
-  "version": "0.26.3",
+  "version": "0.26.4",
   "description": "Godot-specific authoring and validation harness for agentic development.",
   "license": "MIT",
   "type": "module",
@@ -31,17 +31,17 @@
     "releaseStage": "broader_internal_release"
   },
   "dependencies": {
-    "@gdh/cli": "0.26.3",
+    "@gdh/cli": "0.26.4",
     "@clack/prompts": "^1.2.0",
-    "@gdh/adapters": "0.26.3",
-    "@gdh/authoring": "0.26.3",
-    "@gdh/core": "0.26.3",
-    "@gdh/docs": "0.26.3",
-    "@gdh/mcp": "0.26.3",
-    "@gdh/observability": "0.26.3",
-    "@gdh/runtime": "0.26.3",
-    "@gdh/scan": "0.26.3",
-    "@gdh/verify": "0.26.3",
+    "@gdh/adapters": "0.26.4",
+    "@gdh/authoring": "0.26.4",
+    "@gdh/core": "0.26.4",
+    "@gdh/docs": "0.26.4",
+    "@gdh/mcp": "0.26.4",
+    "@gdh/observability": "0.26.4",
+    "@gdh/runtime": "0.26.4",
+    "@gdh/scan": "0.26.4",
+    "@gdh/verify": "0.26.4",
     "picocolors": "^1.1.1"
   },
   "bundledDependencies": [