@skillcap/gdh 0.26.2 → 0.26.3

package/INSTALL-BUNDLE.json

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

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -3061,6 +3061,64 @@
           }
         ]
       }
+    },
+    {
+      "version": "0.26.3",
+      "releaseTag": "v0.26.3",
+      "migrationStatus": "required",
+      "summary": "v0.26.3 bumps GDH_UPDATE_HOOK_VERSION 11 -> 12 to land the embedded broker-snapshot reader in the managed authoring-hook.js. handlePostEdit, handlePostToolBatch, and handleStop now read .gdh-state/authoring/lsp-instance.json + diagnostics-broker/snapshot.json directly instead of shelling out to `npx -y @skillcap/gdh@PINNED authoring check` synchronously, eliminating the ~9.32 s npx bootstrap tax that was making every hook event time out at the 2500 ms default budget. Detached warmup spawn still uses npx (fire-and-forget). 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.3 is a patch release that eliminates the per-edit `npx` tax in the managed authoring hook. Dogfooding on monorepo targets measured `npx -y @skillcap/gdh@0.25.5 --version` alone at ~9.32 s on cold cache; the hook's default check budget is 2500 ms (env-cap 10 000 ms), so every PostToolUse, PostToolBatch, and Stop event timed out before GDH could produce diagnostics. The hook now embeds the broker-snapshot fast-path read directly — `<integrationRoot>/.gdh-state/authoring/lsp-instance.json` + `diagnostics-broker/snapshot.json` are read in the hook process (sub-100 ms warm), validated against `lspInstanceId` and utf8 SHA-256 `contentHash`, and rendered into the same bracketed-token vocabulary the existing dispatch consumes.",
+        "operatorChanges": [
+          "**Embedded broker-snapshot reader on the hot path.** `handlePostEdit`, `handlePostToolBatch`, and `handleStop` now route through a shared `runEmbeddedDiagnosticsRead(stateRoot, changedFiles)` helper rendered into the hook template. The synchronous `runGdh(['authoring','check',...])` call site (and its `npx -y @skillcap/gdh@PINNED` shellout) is deleted.",
+          "**Detached warmup spawn unchanged.** `spawnDetachedWarmup` still uses `child_process.spawn('npx', ['-y', '@skillcap/gdh@PINNED', 'lsp', 'warmup', ...])` because it is fire-and-forget (`detached: true`, `stdio: 'ignore'`, `.unref()`); the npx tax there does not block hook return. Eliminating it is future work.",
+          "**New render-time input `stateRelativePathFromHook`.** Computed at install-plan time per call site so monorepo nesting works: a hook installed at `<root>/.codex/hooks/gdh-authoring-guard.js` and a hook installed at `<root>/apps/game/.claude/hooks/gdh-authoring-guard.js` both resolve to the same `<integrationRoot>/.gdh-state/` at runtime via `path.resolve(__dirname, STATE_RELATIVE_PATH_FROM_HOOK)`.",
+          "**Stop hook contract relaxation.** Stop no longer synchronously launches Godot via `gdh authoring check --mode final`. When the broker is cold (no `lsp-instance.json` / no `snapshot.json`), Stop returns `additionalContext` recommending `gdh authoring check --mode final` manually and spawns detached warmup so the next session benefits. The never-block invariant from Phase 82 / LSP-03 is preserved; the existing `hasAuthoringWorkInTarget` (GF3) git-gate noop is preserved. RFC 0009 carries an addendum recording the relaxation.",
+          "**`GDH_UPDATE_HOOK_VERSION` 11 → 12.** 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 embedded broker-snapshot reader replaces the synchronous npx shellout in PostEdit / PostToolBatch / Stop. Re-render is deterministic; no manual editor steps. Operators see the largest behavior delta as wallclock — every authoring-file edit's hook event returns sub-100 ms warm instead of timing out after 2500 ms. Stop hook contract relaxes intentionally: cold-broker Stop now reports a recommendation and spawns warmup rather than synchronously launching Godot.",
+        "steps": [
+          {
+            "id": "install_v0_26_3",
+            "kind": "mechanical",
+            "summary": "Install the v0.26.3 GDH package.",
+            "detail": "Run gdh self-update so the target uses the new managed authoring-hook.js fingerprint (hook version 12) with the embedded broker-snapshot reader.",
+            "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 12 and the new STATE_RELATIVE_PATH_FROM_HOOK constant baked per install location. 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_embedded_reader",
+            "kind": "agent_reasoning",
+            "summary": "Confirm the embedded broker-snapshot reader is active and the npx tax is gone.",
+            "detail": "Inspect the rendered authoring-hook.js header for `gdh-hook-version: 12` and confirm `STATE_RELATIVE_PATH_FROM_HOOK` and `runEmbeddedDiagnosticsRead` (or equivalent symbol) appear in the script. Optionally exercise: edit a `.gd` file in the configured Godot target; the PostToolUse hook should return within ~100 ms once warmup has primed the broker (first edit is bound by warmup latency, subsequent edits read directly). Cold-broker Stop should report `broker not yet primed; run gdh authoring check --mode final manually` rather than synchronously launching Godot.",
+            "commands": [
+              "gdh adapters status"
+            ],
+            "validationCommands": [
+              "gdh adapters status"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

package/node_modules/@gdh/adapters/dist/authoring-hook-render.d.ts

@@ -6,5 +6,18 @@ export declare function renderGdhAuthoringHook(input: {
     readonly pinnedVersion: string;
     readonly targetRelativePath: string;
     readonly agent: "codex" | "claude";
+    /**
+     * POSIX-normalised relative path from the directory containing the rendered
+     * hook (`__dirname` at runtime) to the integration root's `.gdh-state/`
+     * directory. The hook's embedded broker-snapshot reader resolves
+     * `path.resolve(__dirname, STATE_RELATIVE_PATH_FROM_HOOK)` to find the
+     * authoring state files (`lsp-instance.json`,
+     * `diagnostics-broker/snapshot.json`).
+     *
+     * Computed at install-plan time as
+     * `path.relative(hookDirAbsolute, path.join(integrationRootAbsolute, ".gdh-state"))`
+     * with separators converted to `/`.
+     */
+    readonly stateRelativePathFromHook: string;
 }): string;
 //# sourceMappingURL=authoring-hook-render.d.ts.map

package/node_modules/@gdh/adapters/dist/authoring-hook-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authoring-hook-render.d.ts","sourceRoot":"","sources":["../src/authoring-hook-render.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mCAAmC,yCAAyC,CAAC;AAC1F,eAAO,MAAM,kCAAkC,wCAAwC,CAAC;AACxF,eAAO,MAAM,6BAA6B,uRAC4O,CAAC;AACvR,eAAO,MAAM,4BAA4B,qRAC2O,CAAC;AAErR,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;CACpC,GAAG,MAAM,CAOT"}
+{"version":3,"file":"authoring-hook-render.d.ts","sourceRoot":"","sources":["../src/authoring-hook-render.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mCAAmC,yCAAyC,CAAC;AAC1F,eAAO,MAAM,kCAAkC,wCAAwC,CAAC;AACxF,eAAO,MAAM,6BAA6B,uRAC4O,CAAC;AACvR,eAAO,MAAM,4BAA4B,qRAC2O,CAAC;AAErR,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IACnC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;CAC5C,GAAG,MAAM,CAQT"}

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

@@ -11,6 +11,7 @@ export function renderGdhAuthoringHook(input) {
         pinnedVersionJson: JSON.stringify(input.pinnedVersion),
         targetRelativePathJson: JSON.stringify(input.targetRelativePath),
         agentJson: JSON.stringify(input.agent),
+        stateRelativePathFromHookJson: JSON.stringify(input.stateRelativePathFromHook),
     });
 }
 //# sourceMappingURL=authoring-hook-render.js.map

package/node_modules/@gdh/adapters/dist/authoring-hook-render.js.map

@@ -1 +1 @@
-{"version":3,"file":"authoring-hook-render.js","sourceRoot":"","sources":["../src/authoring-hook-render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAE3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,qBAAqB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,mCAAmC,GAAG,sCAAsC,CAAC;AAC1F,MAAM,CAAC,MAAM,kCAAkC,GAAG,qCAAqC,CAAC;AACxF,MAAM,CAAC,MAAM,6BAA6B,GACxC,oRAAoR,CAAC;AACvR,MAAM,CAAC,MAAM,4BAA4B,GACvC,kRAAkR,CAAC;AAErR,MAAM,UAAU,sBAAsB,CAAC,KAItC;IACC,OAAO,qBAAqB,CAAC,uBAAuB,EAAE;QACpD,WAAW,EAAE,MAAM,CAAC,uBAAuB,CAAC;QAC5C,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC;QACtD,sBAAsB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,kBAAkB,CAAC;QAChE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;KACvC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"authoring-hook-render.js","sourceRoot":"","sources":["../src/authoring-hook-render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAE3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,qBAAqB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,mCAAmC,GAAG,sCAAsC,CAAC;AAC1F,MAAM,CAAC,MAAM,kCAAkC,GAAG,qCAAqC,CAAC;AACxF,MAAM,CAAC,MAAM,6BAA6B,GACxC,oRAAoR,CAAC;AACvR,MAAM,CAAC,MAAM,4BAA4B,GACvC,kRAAkR,CAAC;AAErR,MAAM,UAAU,sBAAsB,CAAC,KAiBtC;IACC,OAAO,qBAAqB,CAAC,uBAAuB,EAAE;QACpD,WAAW,EAAE,MAAM,CAAC,uBAAuB,CAAC;QAC5C,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC;QACtD,sBAAsB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,kBAAkB,CAAC;QAChE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;QACtC,6BAA6B,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,yBAAyB,CAAC;KAC/E,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@gdh/adapters/dist/authoring-hook-state-path.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Compute the POSIX-normalised relative path from the directory of an installed
+ * authoring hook to the integration root's `.gdh-state/` directory. Used to
+ * bake `STATE_RELATIVE_PATH_FROM_HOOK` into the rendered hook so its embedded
+ * broker-snapshot reader can resolve `path.resolve(__dirname, …)` to the state
+ * files at runtime regardless of `process.cwd()`.
+ *
+ * @param installRoot Absolute directory at which the hook file's relative path
+ *   is anchored (Codex install: `integrationRootPath`; Claude same-repo target
+ *   install: `targetPath`).
+ * @param hookRelativePath Hook path relative to `installRoot` (e.g.
+ *   `.codex/hooks/gdh-authoring-guard.js`).
+ * @param integrationRootAbsolute Absolute integration-root path containing the
+ *   shared `.gdh-state/` directory.
+ */
+export declare function computeStateRelativePathFromHook(installRoot: string, hookRelativePath: string, integrationRootAbsolute: string): string;
+//# sourceMappingURL=authoring-hook-state-path.d.ts.map

package/node_modules/@gdh/adapters/dist/authoring-hook-state-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-hook-state-path.d.ts","sourceRoot":"","sources":["../src/authoring-hook-state-path.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,uBAAuB,EAAE,MAAM,GAC9B,MAAM,CAKR"}

package/node_modules/@gdh/adapters/dist/authoring-hook-state-path.js

@@ -0,0 +1,23 @@
+import path from "node:path";
+/**
+ * Compute the POSIX-normalised relative path from the directory of an installed
+ * authoring hook to the integration root's `.gdh-state/` directory. Used to
+ * bake `STATE_RELATIVE_PATH_FROM_HOOK` into the rendered hook so its embedded
+ * broker-snapshot reader can resolve `path.resolve(__dirname, …)` to the state
+ * files at runtime regardless of `process.cwd()`.
+ *
+ * @param installRoot Absolute directory at which the hook file's relative path
+ *   is anchored (Codex install: `integrationRootPath`; Claude same-repo target
+ *   install: `targetPath`).
+ * @param hookRelativePath Hook path relative to `installRoot` (e.g.
+ *   `.codex/hooks/gdh-authoring-guard.js`).
+ * @param integrationRootAbsolute Absolute integration-root path containing the
+ *   shared `.gdh-state/` directory.
+ */
+export function computeStateRelativePathFromHook(installRoot, hookRelativePath, integrationRootAbsolute) {
+    const stateAbsolute = path.join(integrationRootAbsolute, ".gdh-state");
+    const hookDirAbsolute = path.dirname(path.join(installRoot, hookRelativePath));
+    const relative = path.relative(hookDirAbsolute, stateAbsolute) || ".";
+    return relative.split(path.sep).join("/");
+}
+//# sourceMappingURL=authoring-hook-state-path.js.map

package/node_modules/@gdh/adapters/dist/authoring-hook-state-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-hook-state-path.js","sourceRoot":"","sources":["../src/authoring-hook-state-path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gCAAgC,CAC9C,WAAmB,EACnB,gBAAwB,EACxB,uBAA+B;IAE/B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,YAAY,CAAC,CAAC;IACvE,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC;IACtE,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/node_modules/@gdh/adapters/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

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

@@ -13,6 +13,7 @@ import { readInventoryCacheOrScan } from "@gdh/scan";
 import { CLAUDE_SETTINGS_RELATIVE_PATH, patchClaudeSettingsForGdhAuthoringHooks, patchClaudeSettingsForGdhSessionStart, patchClaudeSettingsForGdhStatusline, } from "./claude-settings-patch.js";
 import { computeDeferredActionsAdvisory, } from "./deferred-actions-advisory.js";
 import { CLAUDE_AUTHORING_HOOK_RELATIVE_PATH, CODEX_AUTHORING_HOOK_COMMAND, CODEX_AUTHORING_HOOK_RELATIVE_PATH, renderGdhAuthoringHook, } from "./authoring-hook-render.js";
+import { computeStateRelativePathFromHook } from "./authoring-hook-state-path.js";
 import { CLAUDE_STATUSLINE_RELATIVE_PATH, renderClaudeUpdateStatusline, } from "./claude-statusline-render.js";
 import { CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH, renderClaudeCheckUpdateHook, } from "./claude-update-hook-render.js";
 import { renderClaudeCheckUpdateWorker } from "./claude-update-worker-render.js";
@@ -852,6 +853,7 @@ async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersi
             pinnedVersion,
             targetRelativePath: path.relative(projectMcp.integrationRootPath, targetPath) || ".",
             agent: "codex",
+            stateRelativePathFromHook: computeStateRelativePathFromHook(projectMcp.integrationRootPath, CODEX_AUTHORING_HOOK_RELATIVE_PATH, projectMcp.integrationRootPath),
         });
     const surfaces = [
         createSurfaceStatus({
@@ -983,6 +985,10 @@ async function inspectClaudeAdapter(targetPath, guidance, projectMcp, pinnedVers
             pinnedVersion,
             targetRelativePath: ".",
             agent: "claude",
+            // inspectClaudeAdapter previews the same-repo install: hook lives at
+            // `<targetPath>/.claude/hooks/gdh-authoring-guard.js`; state lives at
+            // `<targetPath>/.gdh-state/`. Compute the relative from the hook dir.
+            stateRelativePathFromHook: computeStateRelativePathFromHook(targetPath, CLAUDE_AUTHORING_HOOK_RELATIVE_PATH, targetPath),
         });
     const expectedClaudeStatusCommand = pinnedVersion === null ? null : renderClaudeStatusCommand(pinnedVersion);
     const expectedClaudeMigrateCommand = pinnedVersion === null ? null : renderClaudeMigrateCommand(pinnedVersion);
@@ -1398,6 +1404,21 @@ function planSharedRepoInstallActions(targetPath, projectMcp, agent, effectiveDe
     }
     return actions;
 }
+/**
+ * Compute the POSIX-normalised relative path from the directory of an installed
+ * authoring hook to the integration root's `.gdh-state/` directory. Used to
+ * bake `STATE_RELATIVE_PATH_FROM_HOOK` into the rendered hook so its embedded
+ * broker-snapshot reader can resolve `path.resolve(__dirname, …)` to the state
+ * files at runtime regardless of `process.cwd()`.
+ *
+ * @param installRoot Absolute directory at which the hook file's relative path
+ *   is anchored (Codex install: `integrationRootPath`; Claude same-repo target
+ *   install: `targetPath`).
+ * @param hookRelativePath Hook path relative to `installRoot` (e.g.
+ *   `.codex/hooks/gdh-authoring-guard.js`).
+ * @param integrationRootAbsolute Absolute integration-root path containing the
+ *   shared `.gdh-state/` directory.
+ */
 function planSkillInstallAction(agent, targetPath, adapter, relativePath, renderFn, skillName, pinnedVersion) {
     const surface = adapter.surfaces.find((s) => s.relativePath === relativePath);
     if (!surface || surface.state === "ready") {
@@ -1508,6 +1529,9 @@ function planCodexRepoInstallActions(targetPath, adapter, pinnedVersion, project
             pinnedVersion: version,
             targetRelativePath: path.relative(integrationRootPath, targetPath) || ".",
             agent: "codex",
+            // Codex install-action: hook installed at integrationRootPath; state
+            // root lives at integrationRootPath/.gdh-state.
+            stateRelativePathFromHook: computeStateRelativePathFromHook(integrationRootPath, CODEX_AUTHORING_HOOK_RELATIVE_PATH, integrationRootPath),
         }), "authoring guard", pinnedVersion),
     ];
     if (projectMcp.enabled && projectMcp.codexProjectFile.state !== "ready") {
@@ -1812,6 +1836,14 @@ function planClaudeInstallActions(targetPath, adapter, pinnedVersion, integratio
         pinnedVersion: version,
         targetRelativePath: ".",
         agent: "claude",
+        // Claude install-action target install: hook lives at
+        // `<targetPath>/.claude/hooks/...`; state root lives at
+        // `<integrationRootPath>/.gdh-state/`. In the same-repo case,
+        // integrationRootPath equals targetPath; in the monorepo nested-target
+        // case (where this same hook is also installed at the target alongside
+        // a separate root-launched hook from site #5), the state remains at
+        // integrationRootPath/.gdh-state, so use integrationRootPath here.
+        stateRelativePathFromHook: computeStateRelativePathFromHook(targetPath, CLAUDE_AUTHORING_HOOK_RELATIVE_PATH, integrationRootPath),
     }), "authoring guard", pinnedVersion));
     if (path.resolve(integrationRootPath) !== path.resolve(targetPath)) {
         const rootTargetRelativePath = path.relative(integrationRootPath, targetPath) || ".";
@@ -1831,6 +1863,10 @@ function planClaudeInstallActions(targetPath, adapter, pinnedVersion, integratio
                 pinnedVersion,
                 targetRelativePath: rootTargetRelativePath,
                 agent: "claude",
+                // Root-launched Claude install in monorepo nested-target case: hook
+                // lives at `<integrationRootPath>/.claude/hooks/...`; state lives at
+                // `<integrationRootPath>/.gdh-state/`.
+                stateRelativePathFromHook: computeStateRelativePathFromHook(integrationRootPath, CLAUDE_AUTHORING_HOOK_RELATIVE_PATH, integrationRootPath),
             }),
             readySummary: "Root-launched Claude authoring hook already matches the managed target-scoped hook.",
             createSummary: "Create the root-launched Claude authoring hook with target-scoped filtering.",