@skillcap/gdh 3.2.0 → 3.2.2

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

@@ -6,19 +6,21 @@ 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_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 { GDH_GUIDANCE_DIRECTORY_RELATIVE_PATH, GUIDANCE_INDEX_RELATIVE_PATH, createDefaultGuidanceUnits, createDefaultRulesDocument, getGuidanceStatus, readRulesDocument, renderRulesYaml, resolveGuidanceQuery, resolveRecoveryHints, } from "@gdh/docs";
+import { createDefaultGuidanceUnits, createDefaultRulesDocument, GDH_GUIDANCE_DIRECTORY_RELATIVE_PATH, GUIDANCE_INDEX_RELATIVE_PATH, 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";
-import { CLAUDE_SETTINGS_RELATIVE_PATH, patchClaudeSettingsForGdhAuthoringHooks, patchClaudeSettingsForGdhSessionStart, patchClaudeSettingsForGdhStatusline, } from "./claude-settings-patch.js";
-import { computeDeferredActionsAdvisory, } from "./deferred-actions-advisory.js";
 import { GDH_AUTHORING_HOOK_RELATIVE_PATH, renderGdhAuthoringHook, } from "./authoring-hook-render.js";
-import { removeManagedCodexAuthoringHookBlock, renderManagedCodexAuthoringHookBlock, } from "./codex-authoring-hook-block.js";
+import { CLAUDE_SETTINGS_RELATIVE_PATH, patchClaudeSettingsForGdhAuthoringHooks, patchClaudeSettingsForGdhSessionStart, patchClaudeSettingsForGdhStatusline, } from "./claude-settings-patch.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";
+import { removeManagedCodexAuthoringHookBlock, renderManagedCodexAuthoringHookBlock, } from "./codex-authoring-hook-block.js";
+import { computeDeferredActionsAdvisory, } from "./deferred-actions-advisory.js";
+import { CLAUDE_CHECK_COMMAND_RELATIVE_PATH, CLAUDE_CHECK_SKILL_RELATIVE_PATH, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH, CLAUDE_MIGRATE_SKILL_RELATIVE_PATH, CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH, CLAUDE_ONBOARD_SKILL_RELATIVE_PATH, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, CLAUDE_PREPARE_SKILL_RELATIVE_PATH, CLAUDE_RUN_GAME_COMMAND_RELATIVE_PATH, CLAUDE_RUN_GAME_SKILL_RELATIVE_PATH, CLAUDE_SHIM_RELATIVE_PATH, CLAUDE_SKILL_RELATIVE_PATHS, CLAUDE_STATUS_COMMAND_RELATIVE_PATH, CLAUDE_STATUS_SKILL_RELATIVE_PATH, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH, CLAUDE_UPDATE_SKILL_RELATIVE_PATH, CODEX_CHECK_SKILL_RELATIVE_PATH, CODEX_MIGRATE_SKILL_RELATIVE_PATH, CODEX_ONBOARD_SKILL_RELATIVE_PATH, CODEX_PREPARE_SKILL_RELATIVE_PATH, CODEX_PROJECT_CONFIG_RELATIVE_PATH, CODEX_RUN_GAME_SKILL_RELATIVE_PATH, CODEX_SKILL_RELATIVE_PATHS, CODEX_STATUS_SKILL_RELATIVE_PATH, CODEX_UPDATE_SKILL_RELATIVE_PATH, GDH_MCP_SERVER_NAME, LEGACY_CLAUDE_SKILL_COMMAND_RELATIVE_PATHS, LEGACY_CODEX_SKILL_RELATIVE_PATHS, LOCAL_PATH_HINTS_RELATIVE_PATH, PROJECT_MCP_RELATIVE_PATH, SUPPORTED_AGENTS, } from "./managed-surfaces.js";
 import { GDH_MANAGED_AGENT_SKILL_MARKER, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexStatusSkill, renderCodexUpdateSkill, } from "./skill-rendering.js";
-export { GDH_MANAGED_AGENT_SKILL_MARKER, GDH_SKILL_DEFINITIONS, GDH_SKILL_IDS, renderGdhSkill, renderManagedSkillMarker, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexStatusSkill, renderCodexUpdateSkill, } from "./skill-rendering.js";
+export { CLAUDE_CHECK_COMMAND_RELATIVE_PATH, CLAUDE_CHECK_SKILL_RELATIVE_PATH, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH, CLAUDE_MIGRATE_SKILL_RELATIVE_PATH, CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH, CLAUDE_ONBOARD_SKILL_RELATIVE_PATH, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, CLAUDE_PREPARE_SKILL_RELATIVE_PATH, CLAUDE_RUN_GAME_COMMAND_RELATIVE_PATH, CLAUDE_RUN_GAME_SKILL_RELATIVE_PATH, CLAUDE_SHIM_RELATIVE_PATH, CLAUDE_STATUS_COMMAND_RELATIVE_PATH, CLAUDE_STATUS_SKILL_RELATIVE_PATH, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH, CLAUDE_UPDATE_SKILL_RELATIVE_PATH, CODEX_CHECK_SKILL_RELATIVE_PATH, CODEX_MIGRATE_SKILL_RELATIVE_PATH, CODEX_ONBOARD_SKILL_RELATIVE_PATH, CODEX_PREPARE_SKILL_RELATIVE_PATH, CODEX_PROJECT_CONFIG_RELATIVE_PATH, CODEX_RUN_GAME_SKILL_RELATIVE_PATH, CODEX_STATUS_SKILL_RELATIVE_PATH, CODEX_UPDATE_SKILL_RELATIVE_PATH, GDH_MCP_SERVER_NAME, LOCAL_PATH_HINTS_RELATIVE_PATH, PROJECT_MCP_RELATIVE_PATH, SUPPORTED_AGENTS, } from "./managed-surfaces.js";
+export { GDH_MANAGED_AGENT_SKILL_MARKER, GDH_SKILL_DEFINITIONS, GDH_SKILL_IDS, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexStatusSkill, renderCodexUpdateSkill, renderGdhSkill, renderManagedSkillMarker, } from "./skill-rendering.js";
 // Module-load drift guard. See packages/core/src/migrations/managed-surface-classes.ts.
 assertClassRegistered("claude_onboard_command", "deterministic");
 assertClassRegistered("claude_status_command", "deterministic");
@@ -44,79 +46,6 @@ export const adaptersPackage = definePackageBoundary({
         "@gdh/scan",
     ],
 });
-export const SUPPORTED_AGENTS = [
-    "codex",
-    "claude",
-];
-export const CLAUDE_SHIM_RELATIVE_PATH = "CLAUDE.md";
-export const CLAUDE_ONBOARD_SKILL_RELATIVE_PATH = ".claude/skills/gdh-onboard/SKILL.md";
-export const PROJECT_MCP_RELATIVE_PATH = ".mcp.json";
-export const CODEX_ONBOARD_SKILL_RELATIVE_PATH = ".agents/skills/gdh-onboard/SKILL.md";
-export const CLAUDE_STATUS_SKILL_RELATIVE_PATH = ".claude/skills/gdh-status/SKILL.md";
-export const CLAUDE_MIGRATE_SKILL_RELATIVE_PATH = ".claude/skills/gdh-migrate/SKILL.md";
-export const CLAUDE_CHECK_SKILL_RELATIVE_PATH = ".claude/skills/gdh-check/SKILL.md";
-export const CLAUDE_PREPARE_SKILL_RELATIVE_PATH = ".claude/skills/gdh-prepare/SKILL.md";
-export const CLAUDE_RUN_GAME_SKILL_RELATIVE_PATH = ".claude/skills/gdh-run-game/SKILL.md";
-export const CODEX_STATUS_SKILL_RELATIVE_PATH = ".agents/skills/gdh-status/SKILL.md";
-export const CODEX_MIGRATE_SKILL_RELATIVE_PATH = ".agents/skills/gdh-migrate/SKILL.md";
-export const CODEX_CHECK_SKILL_RELATIVE_PATH = ".agents/skills/gdh-check/SKILL.md";
-export const CODEX_PREPARE_SKILL_RELATIVE_PATH = ".agents/skills/gdh-prepare/SKILL.md";
-export const CODEX_RUN_GAME_SKILL_RELATIVE_PATH = ".agents/skills/gdh-run-game/SKILL.md";
-// Phase 13 SELF-01: /gdh-update skill surface path constants. The rendered
-// bodies shell out to `npx -y @skillcap/gdh@latest self-update` (LITERAL
-// @latest, not the pinned version — D-10) so the NEW CLI performs the update,
-// not the (potentially pre-Phase-12) OLD pinned one. These constants are
-// INTENTIONALLY excluded from VERIFY_DRIFT_SCANNED_FILES (D-13) because the
-// rendered bodies are version-agnostic by design.
-export const CLAUDE_UPDATE_SKILL_RELATIVE_PATH = ".claude/skills/gdh-update/SKILL.md";
-export const CODEX_UPDATE_SKILL_RELATIVE_PATH = ".agents/skills/gdh-update/SKILL.md";
-export const CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH = CLAUDE_ONBOARD_SKILL_RELATIVE_PATH;
-export const CLAUDE_STATUS_COMMAND_RELATIVE_PATH = CLAUDE_STATUS_SKILL_RELATIVE_PATH;
-export const CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH = CLAUDE_MIGRATE_SKILL_RELATIVE_PATH;
-export const CLAUDE_CHECK_COMMAND_RELATIVE_PATH = CLAUDE_CHECK_SKILL_RELATIVE_PATH;
-export const CLAUDE_PREPARE_COMMAND_RELATIVE_PATH = CLAUDE_PREPARE_SKILL_RELATIVE_PATH;
-export const CLAUDE_RUN_GAME_COMMAND_RELATIVE_PATH = CLAUDE_RUN_GAME_SKILL_RELATIVE_PATH;
-export const CLAUDE_UPDATE_COMMAND_RELATIVE_PATH = CLAUDE_UPDATE_SKILL_RELATIVE_PATH;
-const LEGACY_CLAUDE_SKILL_COMMAND_RELATIVE_PATHS = [
-    [".claude/commands/gdh/onboard.md", "gdh-onboard"],
-    [".claude/commands/gdh/status.md", "gdh-status"],
-    [".claude/commands/gdh/migrate.md", "gdh-migrate"],
-    [".claude/commands/gdh/update.md", "gdh-update"],
-    [".claude/commands/gdh/check.md", "gdh-check"],
-    [".claude/commands/gdh/prepare.md", "gdh-prepare"],
-    [".claude/commands/gdh/run-game.md", "gdh-run-game"],
-    [".claude/commands/gdh/scan.md", "gdh-scan"],
-];
-const LEGACY_CODEX_SKILL_RELATIVE_PATHS = [
-    [".codex/skills/gdh-onboard/SKILL.md", "gdh-onboard"],
-    [".codex/skills/gdh-status/SKILL.md", "gdh-status"],
-    [".codex/skills/gdh-migrate/SKILL.md", "gdh-migrate"],
-    [".codex/skills/gdh-update/SKILL.md", "gdh-update"],
-    [".codex/skills/gdh-check/SKILL.md", "gdh-check"],
-    [".codex/skills/gdh-prepare/SKILL.md", "gdh-prepare"],
-    [".codex/skills/gdh-run-game/SKILL.md", "gdh-run-game"],
-    [".codex/skills/gdh-verify/SKILL.md", "gdh-verify"],
-    [".codex/skills/gdh-scan/SKILL.md", "gdh-scan"],
-];
-const CODEX_SKILL_RELATIVE_PATHS = [
-    path.dirname(CODEX_ONBOARD_SKILL_RELATIVE_PATH),
-    path.dirname(CODEX_STATUS_SKILL_RELATIVE_PATH),
-    path.dirname(CODEX_MIGRATE_SKILL_RELATIVE_PATH),
-    path.dirname(CODEX_UPDATE_SKILL_RELATIVE_PATH),
-    path.dirname(CODEX_PREPARE_SKILL_RELATIVE_PATH),
-    path.dirname(CODEX_RUN_GAME_SKILL_RELATIVE_PATH),
-];
-const CLAUDE_SKILL_RELATIVE_PATHS = [
-    path.dirname(CLAUDE_ONBOARD_SKILL_RELATIVE_PATH),
-    path.dirname(CLAUDE_STATUS_SKILL_RELATIVE_PATH),
-    path.dirname(CLAUDE_MIGRATE_SKILL_RELATIVE_PATH),
-    path.dirname(CLAUDE_UPDATE_SKILL_RELATIVE_PATH),
-    path.dirname(CLAUDE_PREPARE_SKILL_RELATIVE_PATH),
-    path.dirname(CLAUDE_RUN_GAME_SKILL_RELATIVE_PATH),
-];
-export const LOCAL_PATH_HINTS_RELATIVE_PATH = ".gdh-state/local-paths.json";
-export const CODEX_PROJECT_CONFIG_RELATIVE_PATH = ".codex/config.toml";
-export const GDH_MCP_SERVER_NAME = "gdh";
 // Phase 17 UX-01: single source of truth for the `/gdh-status` preview-header
 // literal. The character between "dry-run)" and "not" is em-dash U+2014 (NOT
 // two hyphens). Centralizing here prevents silent drift across shipped skills.
@@ -368,7 +297,7 @@ async function inspectProjectMcpSupport(targetPath, options) {
         pinnedVersion: options.pinnedVersion ?? "latest",
     });
     const nestedTarget = path.resolve(targetPath) !== path.resolve(options.integrationRootPath);
-    const [projectFile, targetProjectFile, codexProjectContent, localPathHints,] = await Promise.all([
+    const [projectFile, targetProjectFile, codexProjectContent, localPathHints] = await Promise.all([
         inspectJsonFile(path.join(options.integrationRootPath, PROJECT_MCP_RELATIVE_PATH)),
         nestedTarget
             ? inspectJsonFile(path.join(targetPath, PROJECT_MCP_RELATIVE_PATH))
@@ -1284,8 +1213,7 @@ function planCodexRepoInstallActions(targetPath, adapter, pinnedVersion, project
         surface.scope === "repo" &&
         surface.relativePath === CODEX_PROJECT_CONFIG_RELATIVE_PATH);
     const shouldRepairCodexProjectConfig = projectMcp.enabled &&
-        (projectMcp.codexProjectFile.state !== "ready" ||
-            codexHookConfigSurface?.state !== "ready");
+        (projectMcp.codexProjectFile.state !== "ready" || codexHookConfigSurface?.state !== "ready");
     if (shouldRepairCodexProjectConfig) {
         const absolutePath = path.join(integrationRootPath, CODEX_PROJECT_CONFIG_RELATIVE_PATH);
         const existingContent = fsSync.existsSync(absolutePath)
@@ -1420,7 +1348,7 @@ const RETIRED_MANAGED_SURFACE_RELATIVE_PATHS = [
     // nuke user content. (The stale `gdh` entry inside it is harmless — the
     // command it points at is dead — and a JSON-aware partial delete is a
     // separate concern.)
-    ...([
+    ...[
         "gdh-onboard",
         "gdh-status",
         "gdh-migrate",
@@ -1434,8 +1362,8 @@ const RETIRED_MANAGED_SURFACE_RELATIVE_PATHS = [
         skillName,
         isManaged: isManagedAgentSkillContent,
         replacementSummary: "Cursor is no longer a supported GDH adapter target; this file was rendered by a pre-removal GDH version.",
-    }))),
-    ...([
+    })),
+    ...[
         "gdh-onboard",
         "gdh-status",
         "gdh-migrate",
@@ -1451,7 +1379,7 @@ const RETIRED_MANAGED_SURFACE_RELATIVE_PATHS = [
         skillName,
         isManaged: isManagedAgentSkillContent,
         replacementSummary: "Cursor is no longer a supported GDH adapter target; this file was rendered by a pre-removal GDH version.",
-    }))),
+    })),
     {
         agent: "claude",
         relativePath: ".cursor/rules/gdh-agent.mdc",
@@ -3290,14 +3218,14 @@ function deriveRepoState(context) {
 function normalizeChangedFiles(files) {
     return [...new Set(files.map((file) => file.trim()).filter((file) => file.length > 0))];
 }
+export { CLAUDE_AUTHORING_HOOK_COMMAND, CODEX_AUTHORING_HOOK_COMMAND, GDH_AUTHORING_HOOK_RELATIVE_PATH, } from "./authoring-hook-render.js";
 export { CLAUDE_STATUSLINE_RELATIVE_PATH } from "./claude-statusline-render.js";
 export { CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH } from "./claude-update-hook-render.js";
-export { CLAUDE_AUTHORING_HOOK_COMMAND, CODEX_AUTHORING_HOOK_COMMAND, GDH_AUTHORING_HOOK_RELATIVE_PATH, } from "./authoring-hook-render.js";
-export { bumpAndRebakePin, } from "./self-update-mechanics.js";
-export { deriveExpectedRenderSet, runInventorySweep, } from "./inventory-sweep.js";
+export { computeDeferredActionsAdvisory } from "./deferred-actions-advisory.js";
 export { BACKUP_MANIFEST_RELATIVE_PATH, BACKUP_RELATIVE_PATH, BACKUP_STAGING_RELATIVE_PATH, detectClass1MarkerDrift, driftResultToPreservationNotes, readBackupManifest, restoreFromDurableBackup, writeDurableBackup, } from "./durable-backup.js";
-export { computeDeferredActionsAdvisory, } from "./deferred-actions-advisory.js";
-export { DEFAULT_GRACEFUL_STOP_TIMEOUT_MS, STOP_AND_RESTART_ENV_SUBSET_KEYS, buildProcessRestartProbeFromSnapshot, captureProcessSnapshot, defaultProcessOrchestrationEnvironment, restartFromSnapshot, stopCapturedProcesses, } from "./process-orchestration.js";
+export { deriveExpectedRenderSet, runInventorySweep, } from "./inventory-sweep.js";
+export { buildProcessRestartProbeFromSnapshot, captureProcessSnapshot, DEFAULT_GRACEFUL_STOP_TIMEOUT_MS, defaultProcessOrchestrationEnvironment, restartFromSnapshot, STOP_AND_RESTART_ENV_SUBSET_KEYS, stopCapturedProcesses, } from "./process-orchestration.js";
+export { bumpAndRebakePin, } from "./self-update-mechanics.js";
 // Internal aggregator exposed for Wave 0 unit tests
 // (packages/adapters/src/lifecycle-compatibility.test.ts). Callers outside this
 // package should continue to use inspectProjectLifecycleCompatibility, which