@skillcap/gdh 0.19.1 → 0.19.3

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "0.19.1",
+  "version": "0.19.3",
   "installMode": "packaged_install"
 }

package/README.md

@@ -19,7 +19,7 @@ Then open your agent in that project and run:
 /gdh-onboard
 ```
 
-GDH writes the project guidance, agent skill surfaces, MCP config, and local state that supported agents use for future work. Setup records the resolved GDH version in the target project so later updates can migrate that project deliberately.
+GDH writes the project guidance, agent skill surfaces, MCP config, and local state that supported agents use for future work. In monorepos, full guidance and skills stay in the selected Godot project directory while only thin root routing/config surfaces are installed for agents launched from the repo root. Setup records the resolved GDH version in the target project so later updates can migrate that project deliberately.
 
 ## Requirements
 

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -1831,6 +1831,160 @@
           }
         ]
       }
+    },
+    {
+      "version": "0.19.2",
+      "releaseTag": "v0.19.2",
+      "migrationStatus": "required",
+      "summary": "v0.19.2 scopes GDH-managed guidance, hooks, skills, Cursor rules, and supporting docs to the configured nested Godot target while keeping monorepo-root agent launches supported through thin pointer guidance and root metadata. Existing targets need `gdh migrate --apply` because GDH_AGENT_CONTRACT_VERSION moves 3 -> 4, GDH_GUIDANCE_INDEX_VERSION moves 3 -> 4, GDH_GUIDANCE_UNIT_VERSION moves 11 -> 12, GDH_CURSOR_RULE_VERSION moves 2 -> 3, GDH_UPDATE_HOOK_VERSION moves 1 -> 2, and GDH_RUNTIME_BRIDGE_SURFACE_VERSION moves 10 -> 11.",
+      "releaseHighlights": {
+        "summary": "v0.19.2 scopes GDH-managed agent guidance, hooks, skills, Cursor rules, and supporting docs to the actual Godot project directory instead of treating a monorepo root as the target surface. This keeps non-game work in a monorepo from loading Godot-specific guidance or firing GDH hooks while still supporting agents and coding harnesses launched from the repository root. The release also fixes a Godot runtime bridge typing issue and keeps the bridge inert when the runtime environment variable is disabled.",
+        "operatorChanges": [
+          "**Target guidance is nested under the Godot project.** GDH writes the full managed `AGENTS.md` contract and generated `docs/agent/` guidance in the target Godot project directory. A monorepo-root `AGENTS.md` is only a thin pointer for Godot/GDH work.",
+          "**Agent adapter surfaces are target-scoped.** Claude hooks, Claude skills, Codex skills, Cursor rules, and related generated docs use target-relative scoping so file edits outside the Godot target do not trigger GDH checks.",
+          "**Monorepo root launch still works.** Root-level project metadata can still point GDH at the nested Godot project, so teams can start agents from the repository root without leaking game-specific instructions into unrelated work.",
+          "**Runtime bridge generation is refreshed.** The managed bridge surface moves to version 11. The bridge script now uses an explicit `Variant` for `JSON.parse_string(...)` and avoids always-on processing when runtime support is disabled."
+        ]
+      },
+      "updateContract": {
+        "summary": "Managed targets need release-specific migration for v0.19.2 because agent contracts, generated guidance, Cursor rules, Claude hooks, shipped skill guidance, and the runtime bridge surface changed to enforce nested Godot target scoping. After self-update, run `gdh migrate --apply` from the monorepo root or target directory so GDH can refresh only the configured Godot target surfaces.",
+        "steps": [
+          {
+            "id": "verify_configured_target_path",
+            "kind": "mechanical",
+            "summary": "Confirm GDH resolves the intended nested Godot target.",
+            "detail": "Run `gdh status` from the monorepo root or target directory and verify the reported target path is the actual Godot project directory, for example `apps/game`, before applying migration.",
+            "commands": [
+              "gdh status"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "apply_scoped_surface_migration",
+            "kind": "mechanical",
+            "summary": "Refresh nested target guidance, hooks, skills, Cursor rules, and runtime bridge files.",
+            "detail": "Run `gdh migrate --apply` so GDH re-bakes managed target files at the new surface versions. The migration should place full GDH instructions and extra guidance docs under the target project directory while leaving root-level files limited to required metadata and thin routing guidance.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh guidance status",
+              "gdh adapters status",
+              "gdh verify drift"
+            ]
+          },
+          {
+            "id": "check_root_instruction_scope",
+            "kind": "agent_reasoning",
+            "summary": "Keep root agent guidance narrow for non-game monorepo work.",
+            "detail": "If the repository root has AGENTS.md or equivalent instruction shims, confirm GDH-managed text only tells agents to read the nested target AGENTS.md for Godot/GDH work. Do not copy the full GDH target contract into the monorepo root.",
+            "commands": [
+              "gdh guidance status"
+            ],
+            "validationCommands": [
+              "gdh verify drift"
+            ]
+          },
+          {
+            "id": "confirm_hooks_ignore_non_target_edits",
+            "kind": "mechanical",
+            "summary": "Confirm generated hooks are gated to the target path.",
+            "detail": "For monorepos with non-game apps or packages, inspect the generated hook status after migration and confirm GDH hooks report no action for file edits outside the configured Godot target directory.",
+            "commands": [
+              "gdh adapters status"
+            ],
+            "validationCommands": [
+              "gdh adapters status",
+              "gdh verify drift"
+            ]
+          },
+          {
+            "id": "verify_runtime_bridge_surface",
+            "kind": "mechanical",
+            "summary": "Refresh the runtime bridge surface only for targets that use GDH runtime support.",
+            "detail": "The bridge surface is versioned with the other managed target files. Projects that use runtime verification should let `gdh migrate --apply` refresh the bridge and then run their normal runtime smoke. When runtime support is disabled by environment, the bridge should remain inert.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh verify drift"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.19.3",
+      "releaseTag": "v0.19.3",
+      "migrationStatus": "no_op",
+      "summary": "v0.19.3 repairs the v0.19.2 monorepo update path without changing managed surface version constants. Existing v0.19.2-managed targets do not need a new release-specific migration solely for v0.19.3; projects that were blocked by stale root guidance or `--dry-run --target` parsing should rerun the normal self-update and follow any terminal-state migration instructions.",
+      "releaseHighlights": {
+        "summary": "v0.19.3 repairs the v0.19.2 monorepo update path. It fixes `gdh self-update --dry-run --target <path>` so the target path is not mistaken for a version argument, and it makes lifecycle status inspect the target-local generated guidance directory after nested Godot target scoping. The release also aligns the greenfield runtime bridge fixture manifest with the v0.19.2 runtime bridge surface version so migration and drift tests agree with the shipped bridge contract.",
+        "operatorChanges": [
+          "**`--dry-run --target` update previews work correctly.** Agents can preview an update for a monorepo root with an explicit target path without GDH parsing that path as the requested release version.",
+          "**Nested guidance freshness checks use the configured target.** Projects that already have stale root `docs/agent/` copies from older GDH versions no longer get stuck in `migration_needed` when the current canonical guidance lives under the configured Godot target.",
+          "**Missing target-local guidance is repairable.** `gdh migrate --apply` can recreate target-local generated guidance while ignoring stale root duplicates that are no longer canonical for nested Godot targets.",
+          "**Runtime bridge fixture truth is aligned.** The greenfield fixture manifest declares runtime bridge surface v11, matching the v0.19.2 generated bridge files."
+        ]
+      },
+      "updateContract": {
+        "summary": "v0.19.3 is a no-op managed-surface release. Use the normal self-update flow; if a target still reports follow-up work from v0.19.2, run the migration command reported by GDH and verify status/drift from the monorepo root or configured Godot target.",
+        "steps": [
+          {
+            "id": "preview_update_with_target",
+            "kind": "mechanical",
+            "summary": "Preview the update from the monorepo root or configured target.",
+            "detail": "Run the normal update preview. If using an explicit target path, `--dry-run --target <path>` is now parsed correctly and the path is not treated as a version.",
+            "commands": [
+              "gdh self-update --dry-run"
+            ],
+            "validationCommands": [
+              "gdh self-update --dry-run"
+            ]
+          },
+          {
+            "id": "apply_self_update",
+            "kind": "mechanical",
+            "summary": "Apply the self-update and follow GDH terminal-state instructions.",
+            "detail": "Run `gdh self-update`. v0.19.3 itself does not introduce new managed surface versions, but a target that still needs v0.19.2 migration may report `follow_up_required`.",
+            "commands": [
+              "gdh self-update"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "run_follow_up_migration_if_reported",
+            "kind": "mechanical",
+            "summary": "Run migration only when GDH reports follow-up work.",
+            "detail": "If `gdh self-update` or `gdh status` reports migration follow-up, run `gdh migrate --apply`. Lifecycle checks now use the target-local guidance root and should not be blocked by stale root `docs/agent/` copies.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh verify drift"
+            ]
+          },
+          {
+            "id": "check_stale_root_guidance_policy",
+            "kind": "agent_reasoning",
+            "summary": "Decide what to do with old root guidance duplicates.",
+            "detail": "For nested Godot targets, old root `docs/agent/` copies are no longer canonical. GDH ignores them for lifecycle freshness, but repository owners should remove or archive stale tracked duplicates only when that matches their repo policy.",
+            "commands": [
+              "gdh guidance status"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh verify drift"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

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":"AAEA,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,CA+IT"}
+{"version":3,"file":"authoring-hook-render.d.ts","sourceRoot":"","sources":["../src/authoring-hook-render.ts"],"names":[],"mappings":"AAEA,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,CAyJT"}

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

@@ -51,7 +51,7 @@ export function renderGdhAuthoringHook(input) {
         "",
         "function handleStop(input, targetRoot) {",
         "  const state = readDirtyState(targetRoot);",
-        "  const dirtyFiles = unique(state.dirtyFiles || []);",
+        "  const dirtyFiles = sanitizeDirtyFiles(state.dirtyFiles || []);",
         "  if (dirtyFiles.length === 0) return allow();",
         "  const result = runGdh(targetRoot, ['authoring', 'check', '--target', targetRoot, '--mode', 'final', '--format', 'compact']);",
         "  if (result.ok && /Completion allowed\\./.test(result.output)) {",
@@ -76,22 +76,23 @@ export function renderGdhAuthoringHook(input) {
         "}",
         "",
         "function collectChangedFiles(input, targetRoot) {",
+        "  const baseCwd = input && typeof input.cwd === 'string' ? input.cwd : process.cwd();",
         "  const files = [];",
-        "  addFile(files, input.file_path, targetRoot);",
-        "  addFromToolPayload(files, input.tool_input, targetRoot);",
-        "  addFromToolPayload(files, input.tool_response, targetRoot);",
+        "  addFile(files, input.file_path, targetRoot, baseCwd);",
+        "  addFromToolPayload(files, input.tool_input, targetRoot, baseCwd);",
+        "  addFromToolPayload(files, input.tool_response, targetRoot, baseCwd);",
         "  const command = input && input.tool_input && typeof input.tool_input.command === 'string' ? input.tool_input.command : '';",
-        "  for (const file of parsePatchFileNames(command)) addFile(files, file, targetRoot);",
+        "  for (const file of parsePatchFileNames(command)) addFile(files, file, targetRoot, baseCwd);",
         "  return unique(files);",
         "}",
         "",
-        "function addFromToolPayload(files, payload, targetRoot) {",
+        "function addFromToolPayload(files, payload, targetRoot, baseCwd) {",
         "  if (!payload || typeof payload !== 'object') return;",
-        "  addFile(files, payload.file_path, targetRoot);",
-        "  addFile(files, payload.filePath, targetRoot);",
-        "  addFile(files, payload.path, targetRoot);",
-        "  if (Array.isArray(payload.file_paths)) for (const file of payload.file_paths) addFile(files, file, targetRoot);",
-        "  if (Array.isArray(payload.files)) for (const file of payload.files) addFile(files, file, targetRoot);",
+        "  addFile(files, payload.file_path, targetRoot, baseCwd);",
+        "  addFile(files, payload.filePath, targetRoot, baseCwd);",
+        "  addFile(files, payload.path, targetRoot, baseCwd);",
+        "  if (Array.isArray(payload.file_paths)) for (const file of payload.file_paths) addFile(files, file, targetRoot, baseCwd);",
+        "  if (Array.isArray(payload.files)) for (const file of payload.files) addFile(files, file, targetRoot, baseCwd);",
         "}",
         "",
         "function parsePatchFileNames(command) {",
@@ -102,19 +103,27 @@ export function renderGdhAuthoringHook(input) {
         "  return files;",
         "}",
         "",
-        "function addFile(files, value, targetRoot) {",
+        "function addFile(files, value, targetRoot, baseCwd) {",
         "  if (typeof value !== 'string' || value.trim() === '') return;",
-        "  const normalized = normalizeToTargetRelative(value.trim(), targetRoot);",
+        "  const normalized = normalizeToTargetRelative(value.trim(), targetRoot, baseCwd);",
         "  if (normalized) files.push(normalized);",
         "}",
         "",
-        "function normalizeToTargetRelative(value, targetRoot) {",
+        "function normalizeToTargetRelative(value, targetRoot, baseCwd) {",
         "  if (value.startsWith('res://')) return value.slice('res://'.length);",
-        "  const absolute = path.isAbsolute(value) ? path.resolve(value) : path.resolve(targetRoot, value);",
-        "  const relative = path.relative(targetRoot, absolute);",
+        "  const canonicalTargetRoot = canonicalPath(targetRoot);",
+        "  const canonicalBaseCwd = canonicalPath(baseCwd || targetRoot);",
+        "  const absolute = path.isAbsolute(value) ? canonicalPath(value) : path.resolve(canonicalBaseCwd, value);",
+        "  const relative = path.relative(canonicalTargetRoot, absolute);",
+        "  if ((relative.startsWith('..') || path.isAbsolute(relative)) && !path.isAbsolute(value) && isInside(canonicalTargetRoot, canonicalBaseCwd)) {",
+        "    const fallbackRelative = path.relative(canonicalTargetRoot, path.resolve(canonicalTargetRoot, value));",
+        "    if (!fallbackRelative.startsWith('..') && !path.isAbsolute(fallbackRelative)) return fallbackRelative.split(path.sep).join('/');",
+        "  }",
         "  if (relative.startsWith('..') || path.isAbsolute(relative)) return null;",
         "  return relative.split(path.sep).join('/');",
         "}",
+        "function isInside(root, candidate) { const rel = path.relative(root, path.resolve(candidate)); return rel === '' || (!rel.startsWith('..') && !path.isAbsolute(rel)); }",
+        "function canonicalPath(value) { try { return fs.realpathSync.native ? fs.realpathSync.native(value) : fs.realpathSync(value); } catch { return path.resolve(value); } }",
         "",
         "function isAuthoringPath(file) {",
         "  if (file === 'project.godot' || file.endsWith('/project.godot')) return true;",
@@ -133,6 +142,7 @@ export function renderGdhAuthoringHook(input) {
         "function readDirtyState(targetRoot) { try { return JSON.parse(fs.readFileSync(dirtyStatePath(targetRoot), 'utf8')); } catch { return { dirtyFiles: [], lastBlockedHash: null }; } }",
         "function writeDirtyState(targetRoot, state) { const file = dirtyStatePath(targetRoot); fs.mkdirSync(path.dirname(file), { recursive: true }); fs.writeFileSync(file, `${JSON.stringify(state, null, 2)}\\n`, 'utf8'); }",
         "function clearDirtyState(targetRoot) { try { fs.rmSync(dirtyStatePath(targetRoot), { force: true }); } catch {} }",
+        "function sanitizeDirtyFiles(values) { return unique(values).filter((file) => typeof file === 'string' && file !== '' && !file.startsWith('../') && !path.isAbsolute(file) && isAuthoringPath(file)); }",
         "function unique(values) { return [...new Set(values.filter(Boolean))].sort(); }",
         "function hash(value) { return crypto.createHash('sha256').update(value).digest('hex'); }",
         "function readHookInput() { try { return JSON.parse(fs.readFileSync(0, 'utf8') || '{}'); } catch { return {}; } }",

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":"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"}
+{"version":3,"file":"authoring-hook-render.js","sourceRoot":"","sources":["../src/authoring-hook-render.ts"],"names":[],"mappings":"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"}

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

@@ -245,8 +245,8 @@ export async function inspectProjectLifecycleCompatibility(targetPath) {
         await inspectVerificationScenarioLifecycleSurface(resolvedTargetPath),
         await inspectRulesLifecycleSurface(resolvedTargetPath, projectConfig),
         inspectAgentContractLifecycleSurface(resolvedTargetPath, guidanceStatus),
-        await inspectGuidanceIndexLifecycleSurface(resolvedTargetPath),
-        await inspectGuidanceUnitLifecycleSurface(resolvedTargetPath, projectConfig),
+        await inspectGuidanceIndexLifecycleSurface(guidanceStatus.guidanceRootPath, resolvedTargetPath),
+        await inspectGuidanceUnitLifecycleSurface(guidanceStatus.guidanceRootPath, projectConfig, resolvedTargetPath),
         inspectMcpManifestLifecycleSurface(resolvedTargetPath, projectConfig.mcp.enabled, adapterStatus),
         inspectCursorRuleLifecycleSurface(resolvedTargetPath, adapterStatus),
         inspectRuntimeBridgeLifecycleSurface(resolvedTargetPath, bridgeStatus),
@@ -317,8 +317,9 @@ export function renderCursorRule() {
         `<!-- GDH CURSOR RULE VERSION: ${GDH_CURSOR_RULE_VERSION} -->`,
         "# GDH Cursor Rule",
         "",
-        "This repository uses GDH.",
-        "Follow the canonical repo-local entrypoint in [AGENTS.md](../../AGENTS.md), then load the canonical guidance index at [docs/agent/README.md](../../docs/agent/README.md) before substantive work.",
+        "This GDH-managed Godot target uses GDH.",
+        "Apply this rule only for files inside this Godot target or when the user explicitly asks for GDH work on this target.",
+        "Follow the canonical target-local entrypoint in [AGENTS.md](../../AGENTS.md), then load the canonical guidance index at [docs/agent/README.md](../../docs/agent/README.md) before substantive Godot work.",
         "For runtime bridge usage, load [docs/agent/authoring-and-validation.md](../../docs/agent/authoring-and-validation.md) and follow its runtime bridge section.",
         "Do not duplicate or override the canonical GDH guidance chain here.",
         "",
@@ -1126,7 +1127,7 @@ async function planInstallActions(targetPath, adapters, requestedAgents, options
             continue;
         }
         if (adapter.agent === "claude") {
-            actions.push(...planClaudeInstallActions(targetPath, adapter, options.pinnedVersion));
+            actions.push(...planClaudeInstallActions(targetPath, adapter, options.pinnedVersion, options.integrationRootPath));
             continue;
         }
         if (adapter.agent === "cursor") {
@@ -1471,7 +1472,7 @@ function planCodexUserInstallActions(targetPath, projectMcp, integrationRootPath
     }));
     return actions;
 }
-function planClaudeInstallActions(targetPath, adapter, pinnedVersion) {
+function planClaudeInstallActions(targetPath, adapter, pinnedVersion, integrationRootPath) {
     const actions = [];
     const claudeSurface = adapter.surfaces.find((surface) => surface.relativePath === CLAUDE_SHIM_RELATIVE_PATH);
     if (!claudeSurface || claudeSurface.state === "ready") {
@@ -1515,6 +1516,30 @@ function planClaudeInstallActions(targetPath, adapter, pinnedVersion) {
         targetRelativePath: ".",
         agent: "claude",
     }), "authoring guard", pinnedVersion));
+    if (path.resolve(integrationRootPath) !== path.resolve(targetPath)) {
+        const rootTargetRelativePath = path.relative(integrationRootPath, targetPath) || ".";
+        actions.push(planDirectSymlinkAction({
+            agent: "claude",
+            targetPath: integrationRootPath,
+            relativePath: CLAUDE_SHIM_RELATIVE_PATH,
+            expectedTarget: "AGENTS.md",
+            readySummary: "Root CLAUDE.md already points to the thin root AGENTS.md router.",
+            createSummary: "Create root CLAUDE.md as a symlink to the thin root AGENTS.md router.",
+            replaceSummary: "Replace root CLAUDE.md with a symlink to the thin root AGENTS.md router.",
+        }), planDirectWriteFileAction({
+            agent: "claude",
+            targetPath: integrationRootPath,
+            relativePath: CLAUDE_AUTHORING_HOOK_RELATIVE_PATH,
+            content: renderGdhAuthoringHook({
+                pinnedVersion,
+                targetRelativePath: rootTargetRelativePath,
+                agent: "claude",
+            }),
+            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.",
+            replaceSummary: "Replace the root-launched Claude authoring hook with the target-scoped managed hook.",
+        }), planRootClaudeAuthoringSettingsAction(integrationRootPath));
+    }
     // .claude/settings.json composite patch action.
     //   - Plan 02 (Strategy A, planner-lock #1): patch-merge the SessionStart
     //     hook entry by exact command-literal match, preserving siblings.
@@ -1530,7 +1555,7 @@ function planClaudeInstallActions(targetPath, adapter, pinnedVersion) {
     // commutative (proven in Task 1 Test J) so application order is irrelevant.
     let existingSettingsContent = "";
     try {
-        existingSettingsContent = fsSync.readFileSync(path.join(targetPath, CLAUDE_SETTINGS_RELATIVE_PATH), "utf8");
+        existingSettingsContent = fsSync.readFileSync(path.resolve(targetPath, CLAUDE_SETTINGS_RELATIVE_PATH), "utf8");
     }
     catch {
         existingSettingsContent = "";
@@ -1556,6 +1581,83 @@ function planClaudeInstallActions(targetPath, adapter, pinnedVersion) {
     actions.push(...planLegacyClaudeCommandCleanupActions(targetPath));
     return actions;
 }
+function planDirectSymlinkAction(input) {
+    const absolutePath = path.resolve(input.targetPath, input.relativePath);
+    let present = false;
+    let ready = false;
+    try {
+        const stat = fsSync.lstatSync(absolutePath);
+        present = true;
+        ready = stat.isSymbolicLink() && fsSync.readlinkSync(absolutePath) === input.expectedTarget;
+    }
+    catch {
+        present = false;
+    }
+    return createInstallAction({
+        agent: input.agent,
+        kind: "ensure_symlink",
+        scope: "repo",
+        targetPath: input.targetPath,
+        relativePath: input.relativePath,
+        state: ready ? "unchanged" : "planned",
+        mode: ready ? "unchanged" : present ? "replace" : "create",
+        summary: ready ? input.readySummary : present ? input.replaceSummary : input.createSummary,
+        expectedTarget: input.expectedTarget,
+    });
+}
+function planDirectWriteFileAction(input) {
+    const absolutePath = path.resolve(input.targetPath, input.relativePath);
+    let existingContent = null;
+    try {
+        existingContent = fsSync.readFileSync(absolutePath, "utf8");
+    }
+    catch {
+        existingContent = null;
+    }
+    const ready = existingContent === input.content;
+    return createInstallAction({
+        agent: input.agent,
+        kind: "write_file",
+        scope: "repo",
+        targetPath: input.targetPath,
+        relativePath: input.relativePath,
+        state: ready ? "unchanged" : "planned",
+        mode: ready ? "unchanged" : existingContent === null ? "create" : "replace",
+        summary: ready
+            ? input.readySummary
+            : existingContent === null
+                ? input.createSummary
+                : input.replaceSummary,
+        content: input.content,
+    });
+}
+function planRootClaudeAuthoringSettingsAction(integrationRootPath) {
+    const absolutePath = path.join(integrationRootPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+    let existingSettingsContent = "";
+    try {
+        existingSettingsContent = fsSync.readFileSync(absolutePath, "utf8");
+    }
+    catch {
+        existingSettingsContent = "";
+    }
+    const patchedSettings = patchClaudeSettingsForGdhAuthoringHooks(existingSettingsContent);
+    const ready = existingSettingsContent === patchedSettings;
+    return createInstallAction({
+        agent: "claude",
+        kind: "write_file",
+        scope: "repo",
+        targetPath: integrationRootPath,
+        relativePath: CLAUDE_SETTINGS_RELATIVE_PATH,
+        state: ready ? "unchanged" : "planned",
+        mode: ready ? "unchanged" : existingSettingsContent.length > 0 ? "replace" : "create",
+        summary: ready
+            ? "Root-launched Claude authoring hooks are already registered with target-scoped filtering."
+            : existingSettingsContent.length > 0
+                ? "Register root-launched Claude authoring hooks while preserving sibling settings."
+                : "Create root .claude/settings.json with target-scoped authoring hooks.",
+        content: patchedSettings,
+    });
+}
 function planCursorInstallActions(targetPath, adapter, pinnedVersion) {
     const actions = [];
     const cursorRuleSurface = adapter.surfaces.find((surface) => surface.relativePath === CURSOR_RULE_RELATIVE_PATH);
@@ -2218,7 +2320,7 @@ function inspectAgentContractLifecycleSurface(targetPath, guidanceStatus) {
     const status = guidanceStatus.agentContract;
     const probes = [
         createVersionProbe({
-            targetPath,
+            targetPath: path.dirname(status.absolutePath),
             relativePath: status.relativePath,
             present: status.present,
             expectedVersion: GDH_AGENT_CONTRACT_VERSION,
@@ -2258,13 +2360,15 @@ function inspectAgentContractLifecycleSurface(targetPath, guidanceStatus) {
         },
     });
 }
-async function inspectGuidanceIndexLifecycleSurface(targetPath) {
+async function inspectGuidanceIndexLifecycleSurface(guidanceRootPath, commandTargetPath = guidanceRootPath) {
     const relativePath = "docs/agent/README.md";
-    const content = await fs.readFile(path.join(targetPath, relativePath), "utf8").catch(() => null);
+    const content = await fs
+        .readFile(path.join(guidanceRootPath, relativePath), "utf8")
+        .catch(() => null);
     const detectedVersion = readTaggedVersion(content, /<!-- GDH GUIDANCE INDEX VERSION: (\d+) -->/);
     const probes = [
         createVersionProbe({
-            targetPath,
+            targetPath: guidanceRootPath,
             relativePath,
             present: content !== null,
             expectedVersion: GDH_GUIDANCE_INDEX_VERSION,
@@ -2282,7 +2386,7 @@ async function inspectGuidanceIndexLifecycleSurface(targetPath) {
             action: {
                 kind: "apply_migration",
                 summary: "Run GDH migrate to create the default guidance index for this target.",
-                command: migrateApplyCommand(targetPath),
+                command: migrateApplyCommand(commandTargetPath),
                 autoApplicable: true,
             },
         });
@@ -2308,20 +2412,20 @@ async function inspectGuidanceIndexLifecycleSurface(targetPath) {
         action: {
             kind: "apply_migration",
             summary: "Run GDH migrate to regenerate the guidance index with updated content.",
-            command: migrateApplyCommand(targetPath),
+            command: migrateApplyCommand(commandTargetPath),
             autoApplicable: true,
         },
     });
 }
-async function inspectGuidanceUnitLifecycleSurface(targetPath, projectConfig) {
+async function inspectGuidanceUnitLifecycleSurface(guidanceRootPath, projectConfig, commandTargetPath = guidanceRootPath) {
     const expectedUnits = projectConfig === null ? [] : createDefaultGuidanceUnits(projectConfig);
     const probes = [];
     for (const unit of expectedUnits) {
         const content = await fs
-            .readFile(path.join(targetPath, unit.relativePath), "utf8")
+            .readFile(path.join(guidanceRootPath, unit.relativePath), "utf8")
             .catch(() => null);
         probes.push(createVersionProbe({
-            targetPath,
+            targetPath: guidanceRootPath,
             relativePath: unit.relativePath,
             present: content !== null,
             expectedVersion: GDH_GUIDANCE_UNIT_VERSION,
@@ -2365,7 +2469,7 @@ async function inspectGuidanceUnitLifecycleSurface(targetPath, projectConfig) {
             action: {
                 kind: "apply_migration",
                 summary: "Run GDH migrate to create the missing default guidance unit files.",
-                command: migrateApplyCommand(targetPath),
+                command: migrateApplyCommand(commandTargetPath),
                 autoApplicable: true,
             },
         });
@@ -2380,7 +2484,7 @@ async function inspectGuidanceUnitLifecycleSurface(targetPath, projectConfig) {
         action: {
             kind: "apply_migration",
             summary: "Run GDH migrate to regenerate guidance units with updated content.",
-            command: migrateApplyCommand(targetPath),
+            command: migrateApplyCommand(commandTargetPath),
             autoApplicable: true,
         },
     });