@skillcap/gdh 0.17.1 → 0.18.0

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "0.17.1",
+  "version": "0.18.0",
   "installMode": "packaged_install"
 }

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -1414,6 +1414,176 @@
           }
         ]
       }
+    },
+    {
+      "version": "0.17.2",
+      "releaseTag": "v0.17.2",
+      "migrationStatus": "no_op",
+      "summary": "v0.17.2 hardens Codex supported-agent skills and MCP recovery without changing managed project schema or lifecycle surface versions. Existing targets do not need release-scoped schema migration, but Codex targets should run ordinary self-update or adapter repair so skills move to .agents/skills and exact managed legacy .codex/skills copies are removed.",
+      "releaseHighlights": {
+        "summary": "v0.17.2 hardens supported-agent setup after dogfooding exposed Codex skill-location drift and stale MCP registration confusion. Codex target skills now use the documented `.agents/skills` location, exact managed legacy `.codex/skills` files are cleaned up during repair, and MCP recovery guidance now explains what GDH can repair versus what the host agent must reconnect.",
+        "operatorChanges": [
+          "**Codex target skills use the documented project-local location.** Generated GDH target skills now install under `.agents/skills/gdh-*/SKILL.md`.",
+          "**Managed legacy Codex skill copies are cleaned safely.** `gdh adapters install` and migration translation remove exact managed `.codex/skills/gdh-*` files after the new `.agents/skills` copy exists; customized files are preserved.",
+          "**Codex project MCP config is part of readiness.** GDH lifecycle checks now include `.codex/config.toml` alongside Claude `.mcp.json` and Cursor `.cursor/mcp.json`.",
+          "**Codex MCP startup is less ambiguous.** Generated `.codex/config.toml` includes explicit startup and tool timeouts for the GDH MCP server.",
+          "**MCP recovery docs are clearer.** Install/update docs now distinguish project-local repair, Codex user-local registration cleanup, and the host-owned restart needed after a stdio MCP transport closes."
+        ]
+      },
+      "updateContract": {
+        "summary": "No release-scoped managed schema migration is required for v0.17.2. After self-update, Codex users should verify adapter surfaces so generated GDH skills live under `.agents/skills`, exact managed legacy `.codex/skills` copies are gone, and MCP config points at the current pinned GDH command. Closed host MCP transports still require the host agent to reconnect or restart.",
+        "steps": [
+          {
+            "id": "rebake_agent_adapters",
+            "kind": "mechanical",
+            "summary": "Re-bake supported-agent surfaces at the new GDH pin.",
+            "detail": "`gdh self-update` re-runs the adapter install path. If an agent needs to repair surfaces manually, run `gdh adapters install <target>` for repo-local agent surfaces.",
+            "commands": [
+              "gdh adapters install <target>"
+            ],
+            "validationCommands": [
+              "gdh adapters status <target>",
+              "gdh verify drift <target>"
+            ]
+          },
+          {
+            "id": "repair_codex_user_mcp",
+            "kind": "mechanical",
+            "summary": "Repair or remove stale Codex user-local MCP registrations when present.",
+            "detail": "For user-local Codex registrations that point at an old package version or missing legacy launcher, run the GDH Codex user install flow for the expected project key or remove stale unrelated entries with `codex mcp remove <name>`.",
+            "commands": [
+              "gdh adapters install <target> --user --agent codex"
+            ],
+            "validationCommands": [
+              "codex mcp list --json",
+              "gdh adapters status <target>"
+            ]
+          },
+          {
+            "id": "restart_closed_mcp_transport",
+            "kind": "manual_review",
+            "summary": "Restart the host agent session if the live MCP transport is closed.",
+            "detail": "GDH can repair configuration and prove command shape, but Codex, Claude, and Cursor own their live stdio MCP process. If the transport is already closed, refresh or restart the host agent session before trusting MCP tool availability.",
+            "commands": [],
+            "validationCommands": [
+              "gdh adapters status <target>"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.18.0",
+      "releaseTag": "v0.18.0",
+      "migrationStatus": "required",
+      "summary": "v0.18.0 adds current-scene, whole-tree, and arbitrary-subtree runtime bridge discovery, refreshes managed bridge guidance and agent entrypoints, and refactors generated bridge internals to native Godot APIs. The release changes GDH_AGENT_CONTRACT_VERSION (1 -> 2), GDH_GUIDANCE_UNIT_VERSION (7 -> 8), GDH_CURSOR_RULE_VERSION (1 -> 2), and GDH_RUNTIME_BRIDGE_SURFACE_VERSION (7 -> 10), so managed targets need adapter/guidance migration and bridge repair before they are treated as current.",
+      "releaseHighlights": {
+        "summary": "v0.18.0 improves runtime bridge discoverability for agents and tightens managed agent entrypoints. Agents can now ask the bridge for the current scene, search from the whole SceneTree, or search from an arbitrary node path when the target is outside the active scene. Managed guidance and Cursor/AGENTS entrypoints now point agents directly at the bridge usage guidance, and the generated bridge uses native Godot APIs for node search, inheritance-aware type checks, and indexed property reads.",
+        "operatorChanges": [
+          "**Runtime bridge node discovery is broader and clearer.** `scene.current.get` returns the current scene snapshot, `scene.tree.nodes.find` searches from `SceneTree.root`, and `scene.node.nodes.find` searches below one `rootNodePath`.",
+          "**Existing active-scene search stays stable.** `scene.nodes.find` remains the active-scene scoped query for ordinary scene-local discovery.",
+          "**Bridge guidance is easier to find.** Managed `AGENTS.md` and Cursor rule surfaces now direct agents to `docs/agent/authoring-and-validation.md` for runtime bridge usage.",
+          "**Generated runtime guidance names the discovery boundary.** Agents are told when to use active-scene search, whole-tree search, or bounded arbitrary-subtree search.",
+          "**Bridge internals now lean on native Godot APIs.** Generated bridge code uses `Node.find_children`, `Object.is_class`, GDScript property membership, and `Object.get_indexed` instead of manual tree walking, exact class-string matching, property-list scans, and flat property reads.",
+          "**Maintainer release/publish skills are namespaced.** GDH repo maintainer-only adapters use the `gdh-dev-*` / `/gdh-dev:*` namespace to reduce confusion with target-project GDH skills."
+        ]
+      },
+      "updateContract": {
+        "summary": "Managed targets need release-specific migration for v0.18.0 because agent contract, Cursor rule, guidance, and runtime bridge surfaces changed. Agents should inspect status, rebake adapter surfaces when drift is reported, migrate guidance, repair the runtime bridge when drift is active, complete plugin/autoload follow-through when required, and validate the target lifecycle.",
+        "steps": [
+          {
+            "id": "verify_post_update_status",
+            "kind": "mechanical",
+            "summary": "Run the standard post-update lifecycle check.",
+            "detail": "Start with `gdh status` so GDH can report whether the target needs guidance migration, adapter repair, runtime bridge repair, or plugin/autoload follow-through for v0.18.0.",
+            "commands": [
+              "gdh status"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "rebake_agent_adapters",
+            "kind": "mechanical",
+            "summary": "Re-bake supported-agent entrypoint surfaces when drift is active.",
+            "detail": "When GDH reports adapter drift, run `gdh adapters install <target>` so managed AGENTS.md and Cursor rule surfaces carry the runtime bridge guidance pointer at the current surface versions.",
+            "commands": [
+              "gdh adapters install <target>"
+            ],
+            "validationCommands": [
+              "gdh adapters status <target>",
+              "gdh verify drift <target>"
+            ]
+          },
+          {
+            "id": "apply_guidance_migration",
+            "kind": "mechanical",
+            "summary": "Apply managed guidance migration.",
+            "detail": "When `gdh status` or `gdh migrate` reports guidance migration work, run `gdh migrate --apply` to refresh guidance units with current-scene, whole-tree, and arbitrary-subtree bridge discovery instructions.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh guidance status",
+              "gdh status"
+            ]
+          },
+          {
+            "id": "inspect_bridge_repair_branch",
+            "kind": "agent_reasoning",
+            "summary": "Decide whether runtime bridge repair is active for this target.",
+            "detail": "If lifecycle output surfaces runtime-bridge reasons, inspect `gdh bridge status` and treat the surfaced terminal commands as release-specific follow-up. If no runtime-bridge reasons appear, no release-specific bridge repair is needed.",
+            "commands": [
+              "gdh bridge status"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "repair_runtime_bridge_surface",
+            "kind": "mechanical",
+            "summary": "Repair managed runtime bridge files when drift is active.",
+            "detail": "Bridge-enabled targets on older runtime bridge surfaces drift until they are repaired to runtime bridge surface version 10. Run `gdh bridge repair` to rewrite the managed bridge addon with `scene.current.get`, whole-tree node search, arbitrary-subtree node search, and native Godot API internals.",
+            "commands": [
+              "gdh bridge repair"
+            ],
+            "validationCommands": [
+              "gdh bridge status"
+            ]
+          },
+          {
+            "id": "enable_plugin_and_finish_gdhbridge_registration",
+            "kind": "manual_review",
+            "summary": "Enable the GDH Runtime Bridge plugin so GDHBridge registers when required.",
+            "detail": "GDH does not hand-edit `project.godot` for operators. After bridge repair, if bridge status still reports plugin/autoload follow-through, open the project in the Godot editor and enable the `GDH Runtime Bridge` plugin so it can register `GDHBridge`.",
+            "commands": [],
+            "validationCommands": [
+              "gdh bridge status",
+              "gdh status"
+            ]
+          },
+          {
+            "id": "validate_repaired_lifecycle",
+            "kind": "mechanical",
+            "summary": "Validate guidance, adapter, bridge, and project lifecycle after migration.",
+            "detail": "After migration, adapter rebake, bridge repair, and any plugin follow-through, rerun `gdh guidance status`, `gdh adapters status`, `gdh bridge status`, and `gdh status`. The target should return to the current lifecycle state for the refreshed surfaces.",
+            "commands": [
+              "gdh guidance status",
+              "gdh adapters status <target>",
+              "gdh bridge status",
+              "gdh status"
+            ],
+            "validationCommands": [
+              "gdh guidance status",
+              "gdh adapters status <target>",
+              "gdh bridge status",
+              "gdh status"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

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

@@ -7,27 +7,27 @@ export declare const PROJECT_MCP_RELATIVE_PATH = ".mcp.json";
 export declare const CURSOR_MCP_RELATIVE_PATH = ".cursor/mcp.json";
 export declare const CURSOR_RULE_RELATIVE_PATH = ".cursor/rules/gdh-agent.mdc";
 export declare const CURSOR_ONBOARD_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-onboard/SKILL.md";
-export declare const CODEX_ONBOARD_SKILL_RELATIVE_PATH = ".codex/skills/gdh-onboard/SKILL.md";
+export declare const CODEX_ONBOARD_SKILL_RELATIVE_PATH = ".agents/skills/gdh-onboard/SKILL.md";
 export declare const CLAUDE_STATUS_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/status.md";
 export declare const CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/migrate.md";
 export declare const CLAUDE_CHECK_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/check.md";
 export declare const CLAUDE_PREPARE_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/prepare.md";
 export declare const CLAUDE_VERIFY_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/verify.md";
-export declare const CODEX_STATUS_SKILL_RELATIVE_PATH = ".codex/skills/gdh-status/SKILL.md";
-export declare const CODEX_MIGRATE_SKILL_RELATIVE_PATH = ".codex/skills/gdh-migrate/SKILL.md";
-export declare const CODEX_CHECK_SKILL_RELATIVE_PATH = ".codex/skills/gdh-check/SKILL.md";
-export declare const CODEX_PREPARE_SKILL_RELATIVE_PATH = ".codex/skills/gdh-prepare/SKILL.md";
-export declare const CODEX_VERIFY_SKILL_RELATIVE_PATH = ".codex/skills/gdh-verify/SKILL.md";
+export declare const CODEX_STATUS_SKILL_RELATIVE_PATH = ".agents/skills/gdh-status/SKILL.md";
+export declare const CODEX_MIGRATE_SKILL_RELATIVE_PATH = ".agents/skills/gdh-migrate/SKILL.md";
+export declare const CODEX_CHECK_SKILL_RELATIVE_PATH = ".agents/skills/gdh-check/SKILL.md";
+export declare const CODEX_PREPARE_SKILL_RELATIVE_PATH = ".agents/skills/gdh-prepare/SKILL.md";
+export declare const CODEX_VERIFY_SKILL_RELATIVE_PATH = ".agents/skills/gdh-verify/SKILL.md";
 export declare const CURSOR_STATUS_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-status/SKILL.md";
 export declare const CURSOR_MIGRATE_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-migrate/SKILL.md";
 export declare const CURSOR_CHECK_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-check/SKILL.md";
 export declare const CURSOR_PREPARE_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-prepare/SKILL.md";
 export declare const CURSOR_VERIFY_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-verify/SKILL.md";
 export declare const CLAUDE_UPDATE_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/update.md";
-export declare const CODEX_UPDATE_SKILL_RELATIVE_PATH = ".codex/skills/gdh-update/SKILL.md";
+export declare const CODEX_UPDATE_SKILL_RELATIVE_PATH = ".agents/skills/gdh-update/SKILL.md";
 export declare const CURSOR_UPDATE_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-update/SKILL.md";
 export declare const CLAUDE_SCAN_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/scan.md";
-export declare const CODEX_SCAN_SKILL_RELATIVE_PATH = ".codex/skills/gdh-scan/SKILL.md";
+export declare const CODEX_SCAN_SKILL_RELATIVE_PATH = ".agents/skills/gdh-scan/SKILL.md";
 export declare const CURSOR_SCAN_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-scan/SKILL.md";
 export declare const LOCAL_PATH_HINTS_RELATIVE_PATH = ".gdh-state/local-paths.json";
 export declare const CODEX_PROJECT_CONFIG_RELATIVE_PATH = ".codex/config.toml";

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":"AAeA,OAAO,EAcL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,cAAc,EAGnB,KAAK,sCAAsC,EAE3C,KAAK,gCAAgC,EAIrC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAIvB,MAAM,WAAW,CAAC;AA2BnB,eAAO,MAAM,eAAe,wCAc1B,CAAC;AAEH,eAAO,MAAM,gBAAgB,wCAIoB,CAAC;AAClD,eAAO,MAAM,yBAAyB,cAAc,CAAC;AACrD,eAAO,MAAM,oCAAoC,oCAAoC,CAAC;AACtF,eAAO,MAAM,yBAAyB,cAAc,CAAC;AACrD,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAC3D,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AACvE,eAAO,MAAM,kCAAkC,wCAAwC,CAAC;AACxF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,mCAAmC,mCAAmC,CAAC;AACpF,eAAO,MAAM,oCAAoC,oCAAoC,CAAC;AACtF,eAAO,MAAM,kCAAkC,kCAAkC,CAAC;AAClF,eAAO,MAAM,oCAAoC,oCAAoC,CAAC;AACtF,eAAO,MAAM,mCAAmC,mCAAmC,CAAC;AACpF,eAAO,MAAM,gCAAgC,sCAAsC,CAAC;AACpF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,+BAA+B,qCAAqC,CAAC;AAClF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,gCAAgC,sCAAsC,CAAC;AACpF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,kCAAkC,wCAAwC,CAAC;AACxF,eAAO,MAAM,gCAAgC,sCAAsC,CAAC;AACpF,eAAO,MAAM,kCAAkC,wCAAwC,CAAC;AACxF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AAOtF,eAAO,MAAM,mCAAmC,mCAAmC,CAAC;AACpF,eAAO,MAAM,gCAAgC,sCAAsC,CAAC;AACpF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAChF,eAAO,MAAM,8BAA8B,oCAAoC,CAAC;AAChF,eAAO,MAAM,+BAA+B,qCAAqC,CAAC;AAClF,eAAO,MAAM,8BAA8B,gCAAgC,CAAC;AAC5E,eAAO,MAAM,kCAAkC,uBAAuB,CAAC;AACvE,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAUzC,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC,GACL,OAAO,CAAC,4BAA4B,CAAC,CAuBvC;AAED,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC9B,GACL,OAAO,CAAC,6BAA6B,CAAC,CA4ExC;AAED,wBAAsB,oCAAoC,CACxD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,sCAAsC,CAAC,CA2DjD;AAED,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA0BvF;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C,GACL,OAAO,CAAC,cAAc,CAAC,CAoFzB;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAczC;AAED,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAqCxE;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA+CrE;AAED,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA6CtE;AAID,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAmCvE;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA2CpE;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAyCrE;AAID,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA8BrE;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAuClE;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAqCnE;AAID,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAqCxE;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA4CrE;AAED,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA0CtE;AA4BD,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CA0CxE;AAED,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CA+CrE;AAED,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CA6CtE;AAID,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAoCtE;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA4CnE;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA0CpE;AAID,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAiCxE;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAwCrE;AAED,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAsCtE;AAID,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAiCvE;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAyCpE;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAuCrE;AAg8DD,wBAAgB,gCAAgC,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAM9E;AAED,wBAAgB,+BAA+B,CAC7C,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,aAAa,EAAE,MAAM,GACpB,MAAM,CA+BR;AAulCD,iBAAS,sCAAsC,CAC7C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,gCAAgC,EAAE,GACpD,sCAAsC,CAmCxC;AAiPD,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,sCAAsC,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,EACL,KAAK,sBAAsB,EAC3B,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EAAE,sCAAsC,EAAE,CAAC"}
+{"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

@@ -40,17 +40,17 @@ export const PROJECT_MCP_RELATIVE_PATH = ".mcp.json";
 export const CURSOR_MCP_RELATIVE_PATH = ".cursor/mcp.json";
 export const CURSOR_RULE_RELATIVE_PATH = ".cursor/rules/gdh-agent.mdc";
 export const CURSOR_ONBOARD_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-onboard/SKILL.md";
-export const CODEX_ONBOARD_SKILL_RELATIVE_PATH = ".codex/skills/gdh-onboard/SKILL.md";
+export const CODEX_ONBOARD_SKILL_RELATIVE_PATH = ".agents/skills/gdh-onboard/SKILL.md";
 export const CLAUDE_STATUS_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/status.md";
 export const CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/migrate.md";
 export const CLAUDE_CHECK_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/check.md";
 export const CLAUDE_PREPARE_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/prepare.md";
 export const CLAUDE_VERIFY_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/verify.md";
-export const CODEX_STATUS_SKILL_RELATIVE_PATH = ".codex/skills/gdh-status/SKILL.md";
-export const CODEX_MIGRATE_SKILL_RELATIVE_PATH = ".codex/skills/gdh-migrate/SKILL.md";
-export const CODEX_CHECK_SKILL_RELATIVE_PATH = ".codex/skills/gdh-check/SKILL.md";
-export const CODEX_PREPARE_SKILL_RELATIVE_PATH = ".codex/skills/gdh-prepare/SKILL.md";
-export const CODEX_VERIFY_SKILL_RELATIVE_PATH = ".codex/skills/gdh-verify/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_VERIFY_SKILL_RELATIVE_PATH = ".agents/skills/gdh-verify/SKILL.md";
 export const CURSOR_STATUS_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-status/SKILL.md";
 export const CURSOR_MIGRATE_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-migrate/SKILL.md";
 export const CURSOR_CHECK_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-check/SKILL.md";
@@ -63,10 +63,20 @@ export const CURSOR_VERIFY_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-verify/SKIL
 // INTENTIONALLY excluded from VERIFY_DRIFT_SCANNED_FILES (D-13) because the
 // rendered bodies are version-agnostic by design.
 export const CLAUDE_UPDATE_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/update.md";
-export const CODEX_UPDATE_SKILL_RELATIVE_PATH = ".codex/skills/gdh-update/SKILL.md";
+export const CODEX_UPDATE_SKILL_RELATIVE_PATH = ".agents/skills/gdh-update/SKILL.md";
 export const CURSOR_UPDATE_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-update/SKILL.md";
 export const CLAUDE_SCAN_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/scan.md";
-export const CODEX_SCAN_SKILL_RELATIVE_PATH = ".codex/skills/gdh-scan/SKILL.md";
+export const CODEX_SCAN_SKILL_RELATIVE_PATH = ".agents/skills/gdh-scan/SKILL.md";
+const LEGACY_CODEX_SKILL_RELATIVE_PATHS = [
+    [".codex/skills/gdh-onboard/SKILL.md", renderCodexOnboardSkill, "gdh-onboard"],
+    [".codex/skills/gdh-status/SKILL.md", renderCodexStatusSkill, "gdh-status"],
+    [".codex/skills/gdh-migrate/SKILL.md", renderCodexMigrateSkill, "gdh-migrate"],
+    [".codex/skills/gdh-update/SKILL.md", renderCodexUpdateSkill, "gdh-update"],
+    [".codex/skills/gdh-check/SKILL.md", renderCodexCheckSkill, "gdh-check"],
+    [".codex/skills/gdh-prepare/SKILL.md", renderCodexPrepareSkill, "gdh-prepare"],
+    [".codex/skills/gdh-verify/SKILL.md", renderCodexVerifySkill, "gdh-verify"],
+    [".codex/skills/gdh-scan/SKILL.md", renderCodexScanSkill, "gdh-scan"],
+];
 export const CURSOR_SCAN_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-scan/SKILL.md";
 export const LOCAL_PATH_HINTS_RELATIVE_PATH = ".gdh-state/local-paths.json";
 export const CODEX_PROJECT_CONFIG_RELATIVE_PATH = ".codex/config.toml";
@@ -138,6 +148,9 @@ export async function installSupportedAgentAdapters(targetPath, options = {}) {
                 if (action.kind === "ensure_symlink") {
                     await applySymlinkAction(action);
                 }
+                else if (action.kind === "remove_file") {
+                    await applyRemoveFileAction(action);
+                }
                 else if (action.kind === "run_command") {
                     await applyRunCommandAction(action);
                 }
@@ -332,6 +345,7 @@ export function renderCursorRule() {
         "",
         "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.",
+        "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.",
         "",
     ].join("\n");
@@ -1566,7 +1580,7 @@ function inspectCodexSkillSurface(targetPath, relativePath, content, expectedCon
             present: content !== null,
             state: content === null ? "missing" : content === expectedContent ? "ready" : "misconfigured",
             summary: content === null
-                ? `Codex \`/${skillName}\` skill is missing and should install under .codex/skills/.`
+                ? `Codex \`/${skillName}\` skill is missing and should install under .agents/skills/.`
                 : content === expectedContent
                     ? `Codex can discover the managed \`/${skillName}\` skill.`
                     : `Codex \`/${skillName}\` skill exists but no longer matches the expected managed GDH skill.`,
@@ -1707,7 +1721,7 @@ async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersi
                         ? "ready"
                         : "misconfigured",
             summary: codexSkillContent === null
-                ? "Codex onboarding handoff is missing and should install `/gdh-onboard` under .codex/skills/."
+                ? "Codex onboarding handoff is missing and should install `/gdh-onboard` under .agents/skills/."
                 : expectedCodexOnboardSkill === null
                     ? "Codex onboarding handoff cannot be validated yet: no `gdh_version` is pinned (run `gdh setup` or `gdh migrate --apply`)."
                     : codexSkillContent === expectedCodexOnboardSkill
@@ -2199,6 +2213,30 @@ function planCodexRepoInstallActions(targetPath, adapter, pinnedVersion, project
             content: renderManagedCodexProjectConfig(existingContent, pinnedVersion),
         }));
     }
+    actions.push(...planLegacyCodexSkillCleanupActions(targetPath, pinnedVersion));
+    return actions;
+}
+function planLegacyCodexSkillCleanupActions(targetPath, pinnedVersion) {
+    const actions = [];
+    for (const [relativePath, renderFn, skillName] of LEGACY_CODEX_SKILL_RELATIVE_PATHS) {
+        const absolutePath = path.join(targetPath, relativePath);
+        const content = fsSync.existsSync(absolutePath)
+            ? fsSync.readFileSync(absolutePath, "utf8")
+            : null;
+        if (content === null || content !== renderFn(pinnedVersion)) {
+            continue;
+        }
+        actions.push(createInstallAction({
+            agent: "codex",
+            kind: "remove_file",
+            scope: "repo",
+            targetPath,
+            relativePath,
+            state: "planned",
+            mode: "delete",
+            summary: `Remove legacy managed Codex \`/${skillName}\` skill from .codex/skills after installing the documented .agents/skills location.`,
+        }));
+    }
     return actions;
 }
 function planCodexUserInstallActions(targetPath, projectMcp, integrationRootPath, pinnedVersion) {
@@ -2415,6 +2453,12 @@ async function applyWriteFileAction(action) {
     await fs.mkdir(path.dirname(action.absolutePath), { recursive: true });
     await fs.writeFile(action.absolutePath, action.content ?? renderCursorRule(), "utf8");
 }
+async function applyRemoveFileAction(action) {
+    if (action.absolutePath === null) {
+        throw new Error("Remove-file install action is missing an absolute path.");
+    }
+    await fs.rm(action.absolutePath, { force: true });
+}
 async function applyRunCommandAction(action) {
     const [command, ...args] = action.command ?? [];
     if (!command) {
@@ -2512,6 +2556,8 @@ export function renderManagedCodexProjectSection(pinnedVersion) {
         "[mcp_servers.gdh]",
         'command = "npx"',
         `args = ["-y", "@skillcap/gdh@${pinnedVersion}", "mcp", "serve"]`,
+        "startup_timeout_sec = 30",
+        "tool_timeout_sec = 300",
     ].join("\n");
 }
 export function renderManagedCodexProjectConfig(existingContent, pinnedVersion) {
@@ -3048,7 +3094,8 @@ function inspectMcpManifestLifecycleSurface(targetPath, mcpEnabled, adapterStatu
     }
     const claudeMcp = findAdapterSurface(adapterStatus, "claude", "mcp_file");
     const cursorMcp = findAdapterSurface(adapterStatus, "cursor", "mcp_file");
-    const probes = [claudeMcp, cursorMcp]
+    const codexMcp = findAdapterSurface(adapterStatus, "codex", "mcp_file");
+    const probes = [claudeMcp, cursorMcp, codexMcp]
         .filter((surface) => surface !== null)
         .map((surface) => createVersionProbe({
         targetPath,
@@ -3057,13 +3104,13 @@ function inspectMcpManifestLifecycleSurface(targetPath, mcpEnabled, adapterStatu
         expectedVersion: null,
         detectedVersion: surface.present ? surface.version : null,
     }));
-    const states = [claudeMcp?.state, cursorMcp?.state].filter((state) => state !== undefined);
+    const states = [claudeMcp?.state, cursorMcp?.state, codexMcp?.state].filter((state) => state !== undefined);
     if (states.length > 0 && states.every((state) => state === "ready")) {
         return createLifecycleSurfaceStatus({
             surface: "mcp_manifest",
             management: "managed",
             state: "compatible",
-            summary: "Project MCP config files are aligned for Claude and Cursor.",
+            summary: "Project MCP config files are aligned for Codex, Claude, and Cursor.",
             reasons: [],
             probes,
             action: null,