@skillcap/gdh 0.24.0 → 0.25.0

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

@@ -6,7 +6,7 @@ import path from "node:path";
 import { promisify } from "node:util";
 import { readProjectConfig, readWorktreeState, resolveAuthoringStatus, resolveEffectiveTargetPath, resolvePinnedVersion, resolvePinnedVersionOrNull, resolveProjectRoot, } from "@gdh/authoring";
 import { assertClassRegistered, assertProjectLifecycleCompatibilityInvariant, definePackageBoundary, GDH_AGENT_CONTRACT_VERSION, GDH_CURSOR_RULE_VERSION, GDH_GUIDANCE_INDEX_VERSION, GDH_GUIDANCE_UNIT_VERSION, GDH_PROJECT_CONFIG_VERSION, GDH_RECIPE_SCHEMA_VERSION, GDH_RULES_SCHEMA_VERSION, GDH_SCENARIO_SCHEMA_VERSION, resolveConfiguredGodotEditorBin, resolveCurrentGdhInstall, resolveGdhProductMetadata, } from "@gdh/core";
-import { createDefaultGuidanceUnits, createDefaultRulesDocument, getGuidanceStatus, readRulesDocument, renderRulesYaml, resolveGuidanceQuery, resolveRecoveryHints, } from "@gdh/docs";
+import { GDH_GUIDANCE_DIRECTORY_RELATIVE_PATH, GUIDANCE_INDEX_RELATIVE_PATH, createDefaultGuidanceUnits, createDefaultRulesDocument, getGuidanceStatus, readRulesDocument, renderRulesYaml, resolveGuidanceQuery, resolveRecoveryHints, } from "@gdh/docs";
 import { inspectGuidanceAudit } from "@gdh/observability";
 import { inspectRuntimeBridgeBroker, inspectRuntimeBridgeSurface, inspectRuntimeKnowledgeSurface, } from "@gdh/runtime";
 import { readInventoryCacheOrScan } from "@gdh/scan";
@@ -16,8 +16,8 @@ import { CLAUDE_AUTHORING_HOOK_RELATIVE_PATH, CODEX_AUTHORING_HOOK_COMMAND, CODE
 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";
-import { GDH_MANAGED_AGENT_SKILL_MARKER, renderClaudeCheckSkill, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeScanSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexCheckSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexScanSkill, renderCodexStatusSkill, renderCodexUpdateSkill, renderCursorCheckSkill, renderCursorMigrateSkill, renderCursorOnboardSkill, renderCursorPrepareSkill, renderCursorRunGameSkill, renderCursorScanSkill, renderCursorStatusSkill, renderCursorUpdateSkill, } from "./skill-rendering.js";
-export { GDH_MANAGED_AGENT_SKILL_MARKER, GDH_SKILL_DEFINITIONS, GDH_SKILL_IDS, renderGdhSkill, renderManagedSkillMarker, renderClaudeCheckSkill, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeScanSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexCheckSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexScanSkill, renderCodexStatusSkill, renderCodexUpdateSkill, renderCursorCheckSkill, renderCursorMigrateSkill, renderCursorOnboardSkill, renderCursorPrepareSkill, renderCursorRunGameSkill, renderCursorScanSkill, renderCursorStatusSkill, renderCursorUpdateSkill, } from "./skill-rendering.js";
+import { GDH_MANAGED_AGENT_SKILL_MARKER, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeScanSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexScanSkill, renderCodexStatusSkill, renderCodexUpdateSkill, renderCursorMigrateSkill, renderCursorOnboardSkill, renderCursorPrepareSkill, renderCursorRunGameSkill, renderCursorScanSkill, renderCursorStatusSkill, renderCursorUpdateSkill, } from "./skill-rendering.js";
+export { GDH_MANAGED_AGENT_SKILL_MARKER, GDH_SKILL_DEFINITIONS, GDH_SKILL_IDS, renderGdhSkill, renderManagedSkillMarker, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeScanSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexScanSkill, renderCodexStatusSkill, renderCodexUpdateSkill, renderCursorMigrateSkill, renderCursorOnboardSkill, renderCursorPrepareSkill, renderCursorRunGameSkill, renderCursorScanSkill, renderCursorStatusSkill, renderCursorUpdateSkill, } from "./skill-rendering.js";
 // Module-load drift guard. See packages/core/src/migrations/managed-surface-classes.ts.
 assertClassRegistered("cursor_rule", "deterministic");
 assertClassRegistered("claude_onboard_command", "deterministic");
@@ -386,8 +386,8 @@ export function renderCursorRule() {
         "",
         "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.",
+        "Follow the canonical target-local entrypoint in [AGENTS.md](../../AGENTS.md), then load the canonical guidance index at [.gdh/guidance/README.md](../../.gdh/guidance/README.md) before substantive Godot work.",
+        "For runtime bridge usage, load [.gdh/guidance/authoring-and-validation.md](../../.gdh/guidance/authoring-and-validation.md) and follow its runtime bridge section.",
         "Do not duplicate or override the canonical GDH guidance chain here.",
         "",
     ].join("\n");
@@ -407,9 +407,6 @@ export function renderClaudeMigrateCommand(pinnedVersion) {
 export function renderClaudeUpdateCommand(pinnedVersion) {
     return renderClaudeUpdateSkill(pinnedVersion);
 }
-export function renderClaudeCheckCommand(pinnedVersion) {
-    return renderClaudeCheckSkill(pinnedVersion);
-}
 export function renderClaudePrepareCommand(pinnedVersion) {
     return renderClaudePrepareSkill(pinnedVersion);
 }
@@ -782,9 +779,6 @@ async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersi
     const codexUpdateContent = await fs
         .readFile(path.join(targetPath, CODEX_UPDATE_SKILL_RELATIVE_PATH), "utf8")
         .catch(() => null);
-    const codexCheckContent = await fs
-        .readFile(path.join(targetPath, CODEX_CHECK_SKILL_RELATIVE_PATH), "utf8")
-        .catch(() => null);
     const codexPrepareContent = await fs
         .readFile(path.join(targetPath, CODEX_PREPARE_SKILL_RELATIVE_PATH), "utf8")
         .catch(() => null);
@@ -804,7 +798,6 @@ async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersi
     const expectedCodexStatusSkill = pinnedVersion === null ? null : renderCodexStatusSkill(pinnedVersion);
     const expectedCodexMigrateSkill = pinnedVersion === null ? null : renderCodexMigrateSkill(pinnedVersion);
     const expectedCodexUpdateSkill = pinnedVersion === null ? null : renderCodexUpdateSkill(pinnedVersion);
-    const expectedCodexCheckSkill = pinnedVersion === null ? null : renderCodexCheckSkill(pinnedVersion);
     const expectedCodexPrepareSkill = pinnedVersion === null ? null : renderCodexPrepareSkill(pinnedVersion);
     const expectedCodexRunGameSkill = pinnedVersion === null ? null : renderCodexRunGameSkill(pinnedVersion);
     const expectedCodexScanSkill = pinnedVersion === null ? null : renderCodexScanSkill(pinnedVersion);
@@ -859,7 +852,6 @@ async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersi
         ...inspectCodexSkillSurface(targetPath, CODEX_STATUS_SKILL_RELATIVE_PATH, codexStatusContent, expectedCodexStatusSkill, "gdh-status"),
         ...inspectCodexSkillSurface(targetPath, CODEX_MIGRATE_SKILL_RELATIVE_PATH, codexMigrateContent, expectedCodexMigrateSkill, "gdh-migrate"),
         ...inspectCodexSkillSurface(targetPath, CODEX_UPDATE_SKILL_RELATIVE_PATH, codexUpdateContent, expectedCodexUpdateSkill, "gdh-update"),
-        ...inspectCodexSkillSurface(targetPath, CODEX_CHECK_SKILL_RELATIVE_PATH, codexCheckContent, expectedCodexCheckSkill, "gdh-check"),
         ...inspectCodexSkillSurface(targetPath, CODEX_PREPARE_SKILL_RELATIVE_PATH, codexPrepareContent, expectedCodexPrepareSkill, "gdh-prepare"),
         ...inspectCodexSkillSurface(targetPath, CODEX_RUN_GAME_SKILL_RELATIVE_PATH, codexRunGameContent, expectedCodexRunGameSkill, "gdh-run-game"),
         ...inspectCodexSkillSurface(targetPath, CODEX_SCAN_SKILL_RELATIVE_PATH, codexScanContent, expectedCodexScanSkill, "gdh-scan"),
@@ -911,9 +903,6 @@ async function inspectClaudeAdapter(targetPath, guidance, projectMcp, pinnedVers
     const claudeUpdateContent = await fs
         .readFile(path.join(targetPath, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH), "utf8")
         .catch(() => null);
-    const claudeCheckContent = await fs
-        .readFile(path.join(targetPath, CLAUDE_CHECK_COMMAND_RELATIVE_PATH), "utf8")
-        .catch(() => null);
     const claudePrepareContent = await fs
         .readFile(path.join(targetPath, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH), "utf8")
         .catch(() => null);
@@ -953,7 +942,6 @@ async function inspectClaudeAdapter(targetPath, guidance, projectMcp, pinnedVers
     const expectedClaudeStatusCommand = pinnedVersion === null ? null : renderClaudeStatusCommand(pinnedVersion);
     const expectedClaudeMigrateCommand = pinnedVersion === null ? null : renderClaudeMigrateCommand(pinnedVersion);
     const expectedClaudeUpdateCommand = pinnedVersion === null ? null : renderClaudeUpdateCommand(pinnedVersion);
-    const expectedClaudeCheckCommand = pinnedVersion === null ? null : renderClaudeCheckCommand(pinnedVersion);
     const expectedClaudePrepareCommand = pinnedVersion === null ? null : renderClaudePrepareCommand(pinnedVersion);
     const expectedClaudeRunGameCommand = pinnedVersion === null ? null : renderClaudeRunGameCommand(pinnedVersion);
     const expectedClaudeScanCommand = pinnedVersion === null ? null : renderClaudeScanCommand(pinnedVersion);
@@ -1003,7 +991,6 @@ async function inspectClaudeAdapter(targetPath, guidance, projectMcp, pinnedVers
         ...inspectClaudeSkillSurface(targetPath, CLAUDE_STATUS_COMMAND_RELATIVE_PATH, claudeStatusContent, expectedClaudeStatusCommand, "gdh-status"),
         ...inspectClaudeSkillSurface(targetPath, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH, claudeMigrateContent, expectedClaudeMigrateCommand, "gdh-migrate"),
         ...inspectClaudeSkillSurface(targetPath, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH, claudeUpdateContent, expectedClaudeUpdateCommand, "gdh-update"),
-        ...inspectClaudeSkillSurface(targetPath, CLAUDE_CHECK_COMMAND_RELATIVE_PATH, claudeCheckContent, expectedClaudeCheckCommand, "gdh-check"),
         ...inspectClaudeSkillSurface(targetPath, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, claudePrepareContent, expectedClaudePrepareCommand, "gdh-prepare"),
         ...inspectClaudeSkillSurface(targetPath, CLAUDE_RUN_GAME_COMMAND_RELATIVE_PATH, claudeRunGameContent, expectedClaudeRunGameCommand, "gdh-run-game"),
         ...inspectClaudeSkillSurface(targetPath, CLAUDE_SCAN_COMMAND_RELATIVE_PATH, claudeScanContent, expectedClaudeScanCommand, "gdh-scan"),
@@ -1046,9 +1033,6 @@ async function inspectCursorAdapter(targetPath, guidance, projectMcp, pinnedVers
     const cursorUpdateContent = await fs
         .readFile(path.join(targetPath, CURSOR_UPDATE_SKILL_RELATIVE_PATH), "utf8")
         .catch(() => null);
-    const cursorCheckContent = await fs
-        .readFile(path.join(targetPath, CURSOR_CHECK_SKILL_RELATIVE_PATH), "utf8")
-        .catch(() => null);
     const cursorPrepareContent = await fs
         .readFile(path.join(targetPath, CURSOR_PREPARE_SKILL_RELATIVE_PATH), "utf8")
         .catch(() => null);
@@ -1064,7 +1048,6 @@ async function inspectCursorAdapter(targetPath, guidance, projectMcp, pinnedVers
     const expectedCursorStatusSkill = pinnedVersion === null ? null : renderCursorStatusSkill(pinnedVersion);
     const expectedCursorMigrateSkill = pinnedVersion === null ? null : renderCursorMigrateSkill(pinnedVersion);
     const expectedCursorUpdateSkill = pinnedVersion === null ? null : renderCursorUpdateSkill(pinnedVersion);
-    const expectedCursorCheckSkill = pinnedVersion === null ? null : renderCursorCheckSkill(pinnedVersion);
     const expectedCursorPrepareSkill = pinnedVersion === null ? null : renderCursorPrepareSkill(pinnedVersion);
     const expectedCursorRunGameSkill = pinnedVersion === null ? null : renderCursorRunGameSkill(pinnedVersion);
     const expectedCursorScanSkill = pinnedVersion === null ? null : renderCursorScanSkill(pinnedVersion);
@@ -1108,7 +1091,6 @@ async function inspectCursorAdapter(targetPath, guidance, projectMcp, pinnedVers
         ...inspectCursorSkillSurface(targetPath, CURSOR_STATUS_SKILL_RELATIVE_PATH, cursorStatusContent, expectedCursorStatusSkill, "gdh-status"),
         ...inspectCursorSkillSurface(targetPath, CURSOR_MIGRATE_SKILL_RELATIVE_PATH, cursorMigrateContent, expectedCursorMigrateSkill, "gdh-migrate"),
         ...inspectCursorSkillSurface(targetPath, CURSOR_UPDATE_SKILL_RELATIVE_PATH, cursorUpdateContent, expectedCursorUpdateSkill, "gdh-update"),
-        ...inspectCursorSkillSurface(targetPath, CURSOR_CHECK_SKILL_RELATIVE_PATH, cursorCheckContent, expectedCursorCheckSkill, "gdh-check"),
         ...inspectCursorSkillSurface(targetPath, CURSOR_PREPARE_SKILL_RELATIVE_PATH, cursorPrepareContent, expectedCursorPrepareSkill, "gdh-prepare"),
         ...inspectCursorSkillSurface(targetPath, CURSOR_RUN_GAME_SKILL_RELATIVE_PATH, cursorRunGameContent, expectedCursorRunGameSkill, "gdh-run-game"),
         ...inspectCursorSkillSurface(targetPath, CURSOR_SCAN_SKILL_RELATIVE_PATH, cursorScanContent, expectedCursorScanSkill, "gdh-scan"),
@@ -1219,7 +1201,7 @@ async function planInstallActions(targetPath, adapters, requestedAgents, options
             actions.push(...planCursorInstallActions(targetPath, adapter, options.pinnedVersion));
         }
     }
-    actions.push(...planRetiredVerifySurfaceCleanupActions(targetPath));
+    actions.push(...planRetiredManagedSurfaceCleanupActions(targetPath));
     return dedupeInstallActions(actions);
 }
 function planSharedRepoInstallActions(targetPath, projectMcp, agent, effectiveDevRepoPath, integrationRootPath, pinnedVersion) {
@@ -1359,7 +1341,6 @@ function planCodexRepoInstallActions(targetPath, adapter, pinnedVersion, project
         planSkillInstallAction("codex", targetPath, adapter, CODEX_STATUS_SKILL_RELATIVE_PATH, renderCodexStatusSkill, "gdh-status", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_MIGRATE_SKILL_RELATIVE_PATH, renderCodexMigrateSkill, "gdh-migrate", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_UPDATE_SKILL_RELATIVE_PATH, renderCodexUpdateSkill, "gdh-update", pinnedVersion),
-        planSkillInstallAction("codex", targetPath, adapter, CODEX_CHECK_SKILL_RELATIVE_PATH, renderCodexCheckSkill, "gdh-check", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_PREPARE_SKILL_RELATIVE_PATH, renderCodexPrepareSkill, "gdh-prepare", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_RUN_GAME_SKILL_RELATIVE_PATH, renderCodexRunGameSkill, "gdh-run-game", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_SCAN_SKILL_RELATIVE_PATH, renderCodexScanSkill, "gdh-scan", pinnedVersion),
@@ -1415,18 +1396,50 @@ function isManagedLegacyClaudeCommandContent(content, skillName) {
             content.includes("<process>") ||
             content.includes("<rules>")));
 }
-const RETIRED_VERIFY_SURFACE_RELATIVE_PATHS = [
+const RETIRED_MANAGED_SURFACE_RELATIVE_PATHS = [
+    {
+        agent: "codex",
+        relativePath: ".gdh/guidance/00-gdh-onboarding.md",
+        skillName: "gdh-onboarding-guidance",
+        isManaged: (content) => content.includes('id: "gdh_onboarding"') &&
+            content.includes("GDH Onboarding") &&
+            /^version:\s+\d+$/m.test(content),
+        replacementSummary: "Onboarding procedure now lives in the generated `gdh-onboard` skill and the `.gdh/guidance/README.md` index.",
+    },
+    {
+        agent: "codex",
+        relativePath: ".agents/skills/gdh-check/SKILL.md",
+        skillName: "gdh-check",
+        isManaged: isManagedAgentSkillContent,
+        replacementSummary: "Agents should rely on GDH post-edit hooks, MCP/CLI status, and explicit `gdh authoring check --mode final` evidence instead.",
+    },
+    {
+        agent: "cursor",
+        relativePath: ".cursor/skills/gdh-check/SKILL.md",
+        skillName: "gdh-check",
+        isManaged: isManagedAgentSkillContent,
+        replacementSummary: "Agents should rely on MCP/CLI status and explicit `gdh authoring check --mode final` evidence instead.",
+    },
+    {
+        agent: "claude",
+        relativePath: ".claude/skills/gdh-check/SKILL.md",
+        skillName: "gdh-check",
+        isManaged: isManagedAgentSkillContent,
+        replacementSummary: "Agents should rely on GDH post-edit hooks, MCP/CLI status, and explicit `gdh authoring check --mode final` evidence instead.",
+    },
     {
         agent: "codex",
         relativePath: ".agents/skills/gdh-verify/SKILL.md",
         skillName: "gdh-verify",
         isManaged: isManagedAgentSkillContent,
+        replacementSummary: "Agents should use `gdh authoring check --mode final` for code-validity evidence.",
     },
     {
         agent: "cursor",
         relativePath: ".cursor/skills/gdh-verify/SKILL.md",
         skillName: "gdh-verify",
         isManaged: isManagedAgentSkillContent,
+        replacementSummary: "Agents should use `gdh authoring check --mode final` for code-validity evidence.",
     },
     {
         agent: "claude",
@@ -1434,11 +1447,12 @@ const RETIRED_VERIFY_SURFACE_RELATIVE_PATHS = [
         skillName: "gdh-verify",
         isManaged: (content) => content.includes("name: gdh:verify") &&
             (content.includes("@skillcap/gdh@") || content.includes("gdh verify recommend")),
+        replacementSummary: "Agents should use `gdh authoring check --mode final` for code-validity evidence.",
     },
 ];
-function planRetiredVerifySurfaceCleanupActions(targetPath) {
+function planRetiredManagedSurfaceCleanupActions(targetPath) {
     const actions = [];
-    for (const entry of RETIRED_VERIFY_SURFACE_RELATIVE_PATHS) {
+    for (const entry of RETIRED_MANAGED_SURFACE_RELATIVE_PATHS) {
         const absolutePath = path.join(targetPath, entry.relativePath);
         const content = fsSync.existsSync(absolutePath)
             ? fsSync.readFileSync(absolutePath, "utf8")
@@ -1454,7 +1468,7 @@ function planRetiredVerifySurfaceCleanupActions(targetPath) {
             relativePath: entry.relativePath,
             state: "planned",
             mode: "delete",
-            summary: `Remove retired managed \`/${entry.skillName}\` surface. Agents should use \`/gdh-check\` for code-validity evidence.`,
+            summary: `Remove retired managed \`${entry.skillName}\` surface. ${entry.replacementSummary}`,
         }));
     }
     return actions;
@@ -1589,7 +1603,7 @@ function planClaudeInstallActions(targetPath, adapter, pinnedVersion, integratio
             expectedTarget: "AGENTS.md",
         }));
     }
-    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_RUN_GAME_COMMAND_RELATIVE_PATH, renderClaudeRunGameCommand, "gdh-run-game", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_SCAN_COMMAND_RELATIVE_PATH, renderClaudeScanCommand, "gdh-scan", 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_PREPARE_COMMAND_RELATIVE_PATH, renderClaudePrepareCommand, "gdh-prepare", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_RUN_GAME_COMMAND_RELATIVE_PATH, renderClaudeRunGameCommand, "gdh-run-game", 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), 
     // Optional statusline script baked at the pinned version. The .js file is
@@ -1777,7 +1791,7 @@ function planCursorInstallActions(targetPath, adapter, pinnedVersion) {
             content: renderCursorRule(),
         }));
     }
-    actions.push(planSkillInstallAction("cursor", targetPath, adapter, CURSOR_ONBOARD_SKILL_RELATIVE_PATH, renderCursorOnboardSkill, "gdh-onboard", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_STATUS_SKILL_RELATIVE_PATH, renderCursorStatusSkill, "gdh-status", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_MIGRATE_SKILL_RELATIVE_PATH, renderCursorMigrateSkill, "gdh-migrate", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_UPDATE_SKILL_RELATIVE_PATH, renderCursorUpdateSkill, "gdh-update", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_CHECK_SKILL_RELATIVE_PATH, renderCursorCheckSkill, "gdh-check", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_PREPARE_SKILL_RELATIVE_PATH, renderCursorPrepareSkill, "gdh-prepare", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_RUN_GAME_SKILL_RELATIVE_PATH, renderCursorRunGameSkill, "gdh-run-game", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_SCAN_SKILL_RELATIVE_PATH, renderCursorScanSkill, "gdh-scan", pinnedVersion));
+    actions.push(planSkillInstallAction("cursor", targetPath, adapter, CURSOR_ONBOARD_SKILL_RELATIVE_PATH, renderCursorOnboardSkill, "gdh-onboard", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_STATUS_SKILL_RELATIVE_PATH, renderCursorStatusSkill, "gdh-status", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_MIGRATE_SKILL_RELATIVE_PATH, renderCursorMigrateSkill, "gdh-migrate", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_UPDATE_SKILL_RELATIVE_PATH, renderCursorUpdateSkill, "gdh-update", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_PREPARE_SKILL_RELATIVE_PATH, renderCursorPrepareSkill, "gdh-prepare", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_RUN_GAME_SKILL_RELATIVE_PATH, renderCursorRunGameSkill, "gdh-run-game", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_SCAN_SKILL_RELATIVE_PATH, renderCursorScanSkill, "gdh-scan", pinnedVersion));
     return actions;
 }
 function dedupeInstallActions(actions) {
@@ -2439,7 +2453,7 @@ function inspectAgentContractLifecycleSurface(targetPath, guidanceStatus) {
     });
 }
 async function inspectGuidanceIndexLifecycleSurface(guidanceRootPath, commandTargetPath = guidanceRootPath) {
-    const relativePath = "docs/agent/README.md";
+    const relativePath = GUIDANCE_INDEX_RELATIVE_PATH;
     const content = await fs
         .readFile(path.join(guidanceRootPath, relativePath), "utf8")
         .catch(() => null);
@@ -2456,9 +2470,9 @@ async function inspectGuidanceIndexLifecycleSurface(guidanceRootPath, commandTar
     if (content === null) {
         return createLifecycleSurfaceStatus({
             surface: "guidance_index",
-            management: "project_owned",
+            management: "managed",
             state: "migration_needed",
-            summary: "The canonical guidance index is missing from docs/agent/README.md.",
+            summary: "The canonical guidance index is missing from .gdh/guidance/README.md.",
             reasons: ["guidance_index_missing"],
             probes,
             action: {
@@ -2472,7 +2486,7 @@ async function inspectGuidanceIndexLifecycleSurface(guidanceRootPath, commandTar
     if (detectedVersion === GDH_GUIDANCE_INDEX_VERSION) {
         return createLifecycleSurfaceStatus({
             surface: "guidance_index",
-            management: "project_owned",
+            management: "managed",
             state: "compatible",
             summary: "The canonical guidance index matches the current GDH version marker.",
             reasons: [],
@@ -2482,7 +2496,7 @@ async function inspectGuidanceIndexLifecycleSurface(guidanceRootPath, commandTar
     }
     return createLifecycleSurfaceStatus({
         surface: "guidance_index",
-        management: "project_owned",
+        management: "managed",
         state: "migration_needed",
         summary: "The canonical guidance index has an outdated version marker and will be regenerated during migration.",
         reasons: ["guidance_index_version_outdated"],
@@ -2513,7 +2527,7 @@ async function inspectGuidanceUnitLifecycleSurface(guidanceRootPath, projectConf
     if (probes.length === 0) {
         return createLifecycleSurfaceStatus({
             surface: "guidance_unit",
-            management: "project_owned",
+            management: "managed",
             state: "compatible",
             summary: "No default guidance units are expected until the target is onboarded.",
             reasons: [],
@@ -2524,7 +2538,7 @@ async function inspectGuidanceUnitLifecycleSurface(guidanceRootPath, projectConf
     if (probes.every((probe) => probe.present && probe.detectedVersion === probe.expectedVersion)) {
         return createLifecycleSurfaceStatus({
             surface: "guidance_unit",
-            management: "project_owned",
+            management: "managed",
             state: "compatible",
             summary: "The default GDH guidance units match the current version markers.",
             reasons: [],
@@ -2539,9 +2553,9 @@ async function inspectGuidanceUnitLifecycleSurface(guidanceRootPath, projectConf
     if (hasMissing && !hasUnexpectedVersion) {
         return createLifecycleSurfaceStatus({
             surface: "guidance_unit",
-            management: "project_owned",
+            management: "managed",
             state: "migration_needed",
-            summary: "One or more default GDH guidance units are missing from docs/agent/.",
+            summary: `One or more default GDH guidance units are missing from ${GDH_GUIDANCE_DIRECTORY_RELATIVE_PATH}/.`,
             reasons: ["guidance_unit_missing"],
             probes,
             action: {
@@ -2554,7 +2568,7 @@ async function inspectGuidanceUnitLifecycleSurface(guidanceRootPath, projectConf
     }
     return createLifecycleSurfaceStatus({
         surface: "guidance_unit",
-        management: "project_owned",
+        management: "managed",
         state: "migration_needed",
         summary: "One or more guidance units have outdated version markers and will be regenerated during migration.",
         reasons: ["guidance_unit_version_outdated"],