@skillcap/gdh 3.2.2 → 4.0.0

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "3.2.2",
+  "version": "4.0.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

@@ -4201,6 +4201,126 @@
           }
         ]
       }
+    },
+    {
+      "version": "3.2.3",
+      "releaseTag": "v3.2.3",
+      "migrationStatus": "no_op",
+      "summary": "v3.2.3 hardens host-side GDH-owned process cleanup across managed LSP, MCP cleanup, runtime broker/session paths, runtime recipe timeouts, and managed headless editor operations. It introduces no managed target schema, generated surface, agent contract, hook/statusline, or bridge surface version changes.",
+      "releaseHighlights": {
+        "summary": "v3.2.3 is a patch release that hardens GDH-owned process cleanup across MCP, managed Godot LSP, runtime bridge broker, runtime recipe execution, bridge sessions, and managed headless editor operations. GDH now uses a shared termination helper that verifies process liveness, requests graceful shutdown, escalates to `SIGKILL` when needed, and reports when a process may still be alive. This reduces stale Godot or GDH-owned helper processes after failed startup, timeout, prune, stop, or cleanup paths.",
+        "operatorChanges": [
+          "**Managed Godot LSP cleanup is stricter.** GDH-owned LSP processes now go",
+          "**MCP cleanup escalates when ownership is proven.** `gdh mcp cleanup --apply`",
+          "**Runtime broker prune shuts down compatible live brokers.** `gdh bridge",
+          "**Runtime and editor timeouts avoid SIGTERM-only cleanup.** Runtime recipe",
+          "**Lifecycle review findings are documented.** The release includes a detailed"
+        ]
+      },
+      "updateContract": {
+        "summary": "Existing managed targets can update to v3.2.3 through the normal GDH update flow. The release changes host-side process cleanup behavior only and does not require managed project migration when the target is otherwise healthy.",
+        "steps": [
+          {
+            "id": "install_v3_2_3",
+            "kind": "mechanical",
+            "summary": "Install the v3.2.3 GDH package.",
+            "detail": "Run the normal GDH update flow so the target uses the package with hardened host-side process cleanup.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "confirm_no_managed_migration",
+            "kind": "agent_reasoning",
+            "summary": "Confirm the target has no release-specific migration work.",
+            "detail": "This release has no managed surface or project schema version change. If gdh status reports migration work, treat it as pre-existing target drift rather than v3.2.3-specific migration.",
+            "commands": [
+              "gdh status"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh verify drift <target>"
+            ]
+          },
+          {
+            "id": "use_bounded_cleanup_commands",
+            "kind": "manual_review",
+            "summary": "Use GDH cleanup commands before manually killing processes.",
+            "detail": "When stale GDH-owned processes are suspected, prefer gdh lsp doctor/prune/stop, gdh mcp cleanup --target <target> --apply, and gdh bridge session doctor/prune <target>. GDH still avoids killing unrelated editor, Godot, or user processes.",
+            "commands": [
+              "gdh lsp doctor",
+              "gdh lsp prune",
+              "gdh mcp cleanup --target <target> --apply",
+              "gdh bridge session doctor <target>",
+              "gdh bridge session prune <target>"
+            ],
+            "validationCommands": [
+              "gdh lsp status",
+              "gdh bridge session doctor <target>",
+              "gdh status"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "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"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

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),