@skillcap/gdh 0.19.0 → 0.19.2

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

@@ -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") {
@@ -1505,22 +1506,48 @@ function planClaudeInstallActions(targetPath, adapter, pinnedVersion) {
     actions.push(planSkillInstallAction("claude", targetPath, adapter, CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH, renderClaudeOnboardCommand, "gdh-onboard", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_STATUS_COMMAND_RELATIVE_PATH, renderClaudeStatusCommand, "gdh-status", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH, renderClaudeMigrateCommand, "gdh-migrate", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH, renderClaudeUpdateCommand, "gdh-update", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_CHECK_COMMAND_RELATIVE_PATH, renderClaudeCheckCommand, "gdh-check", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, renderClaudePrepareCommand, "gdh-prepare", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_SCAN_COMMAND_RELATIVE_PATH, renderClaudeScanCommand, "gdh-scan", pinnedVersion), 
     // UPD-01 managed hook surfaces baked at the pinned version.
     planHookInstallAction("claude", targetPath, adapter, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, renderClaudeCheckUpdateHook, "gdh-check-update-hook", pinnedVersion), planHookInstallAction("claude", targetPath, adapter, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH, renderClaudeCheckUpdateWorker, "gdh-check-update-worker", pinnedVersion), 
-    // UPD-02 managed statusline surface baked at the pinned version. The .js
-    // file is ALWAYS baked, even when settings.json statusLine is not owned
-    // by GDH (write-if-absent below) — users can manually point their config
-    // at gdh-statusline.js later; the baked file is a no-op until wired.
+    // Optional statusline script baked at the pinned version. The .js file is
+    // ALWAYS baked, but GDH no longer registers Claude's single project
+    // statusLine slot automatically because that would shadow user/global
+    // statusline content. Users can manually point their config at
+    // gdh-statusline.js later; the baked file is a no-op until wired.
     planHookInstallAction("claude", targetPath, adapter, CLAUDE_STATUSLINE_RELATIVE_PATH, renderClaudeUpdateStatusline, "gdh-statusline", pinnedVersion), planHookInstallAction("claude", targetPath, adapter, CLAUDE_AUTHORING_HOOK_RELATIVE_PATH, (version) => renderGdhAuthoringHook({
         pinnedVersion: version,
         targetRelativePath: ".",
         agent: "claude",
     }), "authoring guard", pinnedVersion));
-    // UPD-01 + UPD-02 .claude/settings.json composite patch action.
+    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.
-    //   - Plan 03 (write-if-absent, planner-lock #2 / D-18): add the statusLine
-    //     entry ONLY when no existing statusLine is configured (e.g. GSD-owned
-    //     or user-owned). Silent no-op for UPD-02 on targets where another
-    //     tool already owns the slot; the universal surface is MCP _meta.
+    //   - Claude statusline migration: remove only the exact old GDH-managed
+    //     statusLine entry and never create a new one. Claude supports one
+    //     statusLine command; project-level GDH ownership can shadow a user's
+    //     global statusline. SessionStart, MCP _meta, and CLI banner remain the
+    //     non-destructive update surfaces.
     //
     // Synchronous read via fsSync is intentional: planClaudeInstallActions is
     // called without `await`, and making it async would ripple to every sibling
@@ -1528,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 = "";
@@ -1545,15 +1572,92 @@ function planClaudeInstallActions(targetPath, adapter, pinnedVersion) {
         state: settingsIsUnchanged ? "unchanged" : "planned",
         mode: settingsIsUnchanged ? "unchanged" : settingsExistedOnDisk ? "replace" : "create",
         summary: settingsIsUnchanged
-            ? "GDH SessionStart hook, authoring guard hooks, and statusline already registered in .claude/settings.json."
+            ? "GDH SessionStart hook and authoring guard hooks already registered in .claude/settings.json; statusline ownership preserved."
             : settingsExistedOnDisk
-                ? "Register the GDH SessionStart hook, authoring guard hooks, and statusline (write-if-absent) in .claude/settings.json while preserving sibling content (patch-merge)."
-                : "Create .claude/settings.json with the GDH SessionStart hook, authoring guard hooks, and statusline registration.",
+                ? "Register the GDH SessionStart hook and authoring guard hooks in .claude/settings.json while preserving sibling content and removing any exact old GDH-managed statusline."
+                : "Create .claude/settings.json with the GDH SessionStart hook and authoring guard hooks.",
         content: patchedSettings,
     }));
     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);
@@ -2216,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,