@skillcap/gdh 3.2.3 → 4.1.0

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "3.2.3",
+  "version": "4.1.0",
   "installMode": "packaged_install"
 }

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/@skillcap/gdh.svg)](https://www.npmjs.com/package/@skillcap/gdh)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
-GDH helps AI coding agents work inside Godot projects without guessing the project shape, commands, runtime setup, or validation evidence.
+GDH helps AI coding agents work inside Godot projects without guessing the project shape, authoring checks, runtime guidance, or validation evidence.
 
 ## Quick Start
 
@@ -26,14 +26,15 @@ GDH writes the project guidance, agent skill surfaces, MCP config, and local sta
 - Node.js 24 or newer.
 - A local Godot project, currently focused on Godot 4.4 through 4.6.
 - A supported AI coding agent: Codex or Claude.
-- Optional: `GDH_GODOT_EDITOR_BIN` for Godot import refresh or direct local runtime checks.
-- Optional: Docker for the Docker-backed rendered runtime path.
+- Optional: `GDH_GODOT_EDITOR_BIN` for Godot import refresh and local editor-backed checks.
+- Optional: Docker when a project-owned run workflow uses containers.
 
 ## What It Does
 
-- Finds Godot project roots and writes `.gdh/project.yaml` plus `.gdh-state/` derived state.
+- Finds Godot project roots and writes `.gdh/project.yaml`, `.gdh/runtime-knowledge/run-game.md`, plus `.gdh-state/` derived state.
 - Installs agent commands and skills such as `/gdh-status`, `/gdh-prepare`, `/gdh-run-game`, `/gdh-migrate`, and `/gdh-update`.
-- Exposes MCP tools for project status, authoring checks, docs lookup, runtime bridge operations, and verification.
+- Exposes MCP tools for project status, authoring checks, docs lookup, and bounded bridge/editor inspection.
+- Teaches agents to run the game through project-owned commands and keep run knowledge fresh instead of forcing launch behavior into a GDH wrapper.
 - Keeps generated target-project files inside the managed project, not in GDH's own implementation repo.
 
 ## Common Commands

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -4265,6 +4265,131 @@
           }
         ]
       }
+    },
+    {
+      "version": "4.0.0",
+      "releaseTag": "v4.0.0",
+      "migrationStatus": "required",
+      "summary": "v4.0.0 retires GDH-owned run configurations as the agent-facing launch workflow and re-bakes managed skills plus generated runtime guidance. Existing targets need migration so agents receive the new run-game guidance and a project-owned .gdh/runtime-knowledge/run-game.md scaffold when missing.",
+      "releaseHighlights": {
+        "summary": "v4.0.0 retires GDH-owned run configurations as the agent-facing way to launch Godot projects. Agents now use project-owned run-game knowledge, generated runtime guidance, and the project's real launch commands.",
+        "operatorChanges": [
+          "**Run configs are no longer the launch workflow.** Agents should use the",
+          "**Runtime guidance is generated.** Onboarded targets receive",
+          "**Existing targets get a run-game runbook.** Migration creates",
+          "**Runtime bridge usage stays flexible.** Agents activate the bridge through"
+        ]
+      },
+      "updateContract": {
+        "summary": "Existing managed targets can update to v4.0.0 through the normal GDH update flow. Migration refreshes managed agent/guidance surfaces and creates run-game knowledge when absent.",
+        "steps": [
+          {
+            "id": "install_v4_0_0",
+            "kind": "mechanical",
+            "summary": "Install the v4.0.0 GDH package.",
+            "detail": "Run the normal GDH update flow so the target uses the package with retired run-config guidance.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "rebake_runtime_guidance",
+            "kind": "mechanical",
+            "summary": "Re-bake managed skills and generated guidance.",
+            "detail": "Migration refreshes the managed gdh-run-game skill, .gdh/guidance/README.md, and .gdh/guidance/runtime.md.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "seed_run_game_knowledge",
+            "kind": "agent_reasoning",
+            "summary": "Confirm run-game knowledge exists and is source-backed.",
+            "detail": "If .gdh/runtime-knowledge/run-game.md was newly scaffolded, treat it as draft until an agent proves the real project launch command.",
+            "commands": [
+              "gdh status"
+            ],
+            "validationCommands": [
+              "test -f .gdh/runtime-knowledge/run-game.md"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "version": "4.1.0",
+      "releaseTag": "v4.1.0",
+      "migrationStatus": "required",
+      "summary": "v4.1.0 adds focused Editor Bridge animation operations and hardens GDH-owned process lifecycle behavior. Existing targets need migration so managed MCP manifests, generated guidance, and runtime bridge files re-bake to the current contract.",
+      "releaseHighlights": {
+        "summary": "v4.1.0 expands the Editor Bridge with focused Godot animation operations and tightens GDH-owned process lifecycle control. Agents get semantic AnimationPlayer and AnimationTree state-machine tools through MCP, while managed headless Godot launches and runtime bridge brokers have stricter ownership and cleanup behavior.",
+        "operatorChanges": [
+          "**Animation editing is a first-class editor surface.** MCP exposes focused",
+          "**Advanced editor operations cover the same animation catalog.**",
+          "**GDH-owned headless Godot launches no longer register as adopted editors.**",
+          "**Process cleanup is more deterministic.** `gdh lsp prune` removes"
+        ]
+      },
+      "updateContract": {
+        "summary": "Existing managed targets can update to v4.1.0 through the normal GDH update flow. Migration refreshes MCP manifests, generated guidance, and runtime bridge files so agents receive the animation tools and the headless-launch adoption opt-out.",
+        "steps": [
+          {
+            "id": "install_v4_1_0",
+            "kind": "mechanical",
+            "summary": "Install the v4.1.0 GDH package.",
+            "detail": "Run the normal GDH update flow so the target uses the package with focused editor animation tools and lifecycle hardening.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "rebake_editor_guidance_and_mcp",
+            "kind": "mechanical",
+            "summary": "Re-bake generated guidance and MCP metadata.",
+            "detail": "Migration refreshes generated guidance and the managed MCP manifest so editor.animation.* tools are visible to agents.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "refresh_runtime_bridge_surface",
+            "kind": "mechanical",
+            "summary": "Refresh the runtime bridge surface.",
+            "detail": "Migration re-installs the runtime bridge surface so GDH-owned headless launches opt out of adopted-editor registration.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "review_editor_sessions",
+            "kind": "manual_review",
+            "summary": "Review editor and LSP lifecycle state when stale processes are suspected.",
+            "detail": "Use GDH lifecycle commands to inspect and prune stale exact-project managed LSP processes instead of hand-killing unrelated Godot editor sessions.",
+            "commands": [
+              "gdh lsp status",
+              "gdh lsp prune"
+            ],
+            "validationCommands": [
+              "gdh lsp status"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

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

@@ -191,8 +191,6 @@ export async function inspectProjectLifecycleCompatibility(targetPath) {
     });
     return summarizeProjectLifecycleCompatibility(resolvedTargetPath, [
         await inspectProjectConfigLifecycleSurface(resolvedTargetPath),
-        await inspectRunConfigurationLifecycleSurface(resolvedTargetPath),
-        await inspectVerificationScenarioLifecycleSurface(resolvedTargetPath),
         await inspectRulesLifecycleSurface(resolvedTargetPath, projectConfig),
         inspectAgentContractLifecycleSurface(resolvedTargetPath, guidanceStatus),
         await inspectGuidanceIndexLifecycleSurface(guidanceStatus.guidanceRootPath, resolvedTargetPath),