@skillcap/gdh 0.13.1 → 0.13.3

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "0.13.1",
+  "version": "0.13.3",
   "installMode": "packaged_install"
 }

package/README.md

@@ -12,10 +12,10 @@ GDH detects your Godot project, configures your AI agents, and gives them the co
 ## Install
 
 ```sh
-npx -y @skillcap/gdh@0.13.1 setup
+npx -y @skillcap/gdh@0.13.3 setup
 ```
 
-Replace `0.13.1` with the GDH version you want to pin this project to. `gdh setup` records the pinned version in `.gdh/project.yaml`; every managed surface generated from that config invokes GDH at that exact pinned version, so future sessions stay reproducible.
+Replace `0.13.3` with the GDH version you want to pin this project to. `gdh setup` records the pinned version in `.gdh/project.yaml`; every managed surface generated from that config invokes GDH at that exact pinned version, so future sessions stay reproducible.
 
 From `0.9.0` onward, the shipped package also carries bounded release-span update metadata in `RELEASE-SPAN-UPDATE-CONTRACTS.json` so update flows can explain release-specific migration steps without reading repo-only `docs/releases/` files at target runtime.
 
@@ -36,7 +36,7 @@ The full install and update contract lives in [install-and-update.md](docs/devel
 
 ```sh
 # 1. Run setup in your Godot project
-npx -y @skillcap/gdh@0.13.1 setup
+npx -y @skillcap/gdh@0.13.3 setup
 
 # 2. Open your AI agent (Claude, Cursor, Codex) in the repo
 
@@ -101,7 +101,7 @@ The CLI exists for advanced operators, debugging, and automation. Update preview
 
 ## Status
 
-GDH now ships the current `0.13.1` release line and remains ready for broader internal use within the documented support contract. The current release line is `0.13.1` at the `broader_internal_release` stage.
+GDH now ships the current `0.13.3` release line and remains ready for broader internal use within the documented support contract. The current release line is `0.13.3` at the `broader_internal_release` stage.
 That line includes one first-class Docker-backed rendered runtime provider and bounded screenshot evidence on rendered-capable paths.
 
 The release-stage label applies only to the documented support window in [runtime-support-matrix.md](docs/development/runtime-support-matrix.md) and [runtime-release-readiness.md](docs/development/runtime-release-readiness.md). It is not a blanket claim that every Godot project shape is supported or that this implementation checkout should behave like a GDH-managed target repo.

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -839,6 +839,100 @@
           }
         ]
       }
+    },
+    {
+      "version": "0.13.2",
+      "releaseTag": "v0.13.2",
+      "migrationStatus": "no_op",
+      "summary": "v0.13.2 keeps managed surface versions unchanged while tightening ordinary update and runtime-verification follow-through. `gdh self-update` and `gdh migrate --apply` now auto-repair the known v0.13.0 runtime-bridge `plugin.cfg` drift before terminal classification, update guidance now makes long-lived MCP reconnect explicit before trusting post-update MCP output, verification scenarios now reject `artifact_policy.screenshots: \"fallback\"`, and interrupted `gdh verify run` executions now keep an inspectable provisional run record. Existing targets do not require a new release-scoped managed-project migrate step for this release line.",
+      "releaseHighlights": {
+        "summary": "v0.13.2 is a patch release for GDH's update and runtime-verification follow-through. The ordinary update path now auto-repairs the known v0.13.0 runtime-bridge `plugin.cfg` drift before terminal classification, long-lived MCP sessions are now explicitly told to reconnect after `gdh self-update`, verification scenarios no longer support `artifact_policy.screenshots: \"fallback\"`, and interrupted `gdh verify run` executions now keep an inspectable run record instead of dropping into `run_record_metadata_missing`.",
+        "operatorChanges": [
+          "**Known v0.13.0 bridge drift now repairs inline during update and migrate.** When a target still carries the malformed managed `addons/gdh_bridge/plugin.cfg` from v0.13.0, GDH rewrites that file as part of the ordinary self-update or migrate path instead of sending bridge-enabled targets with existing `GDHBridge` registration to manual review.",
+          "**Post-update MCP follow-through is now explicit.** Generated `/gdh-update` instructions now tell operators and agents to reconnect or restart any long-lived GDH MCP session after `gdh self-update` before trusting MCP follow-up output, because the old server process can keep a stale pin or stale machine-local env snapshot.",
+          "**Verification scenarios no longer treat fallback screenshots as scenario truth.** `artifact_policy.screenshots: \"fallback\"` is now rejected with `verification_scenario_screenshot_policy_unsupported`; scenario truth must come from project-owned signals, while manual or external screenshots stay human-only supporting evidence.",
+          "**Interrupted verify runs remain inspectable.** If `gdh verify run` is interrupted before GDH finishes the final write, GDH now leaves a provisional top-level run record so `gdh verify inspect` can still show honest `run_record_incomplete` state instead of `run_record_metadata_missing`."
+        ]
+      },
+      "updateContract": {
+        "summary": "No release-specific managed migration is required after self-update. v0.13.2 narrows the ordinary update path for the known v0.13.0 bridge `plugin.cfg` drift, makes long-lived MCP reconnect explicit before trusting MCP follow-up output, and blocks `artifact_policy.screenshots: \"fallback\"` in project-owned verification scenarios.",
+        "steps": [
+          {
+            "id": "reconnect_long_lived_mcp_if_present",
+            "kind": "agent_reasoning",
+            "summary": "If follow-up happens through a long-lived GDH MCP session, reconnect it before trusting MCP output.",
+            "detail": "Self-update rebakes files on disk, but an already-running MCP server can still be the old process or an old machine-local env snapshot until it reconnects. Only do this step when the chat or editor actually keeps a long-lived GDH MCP session alive.",
+            "commands": [],
+            "validationCommands": [
+              "gdh verify drift",
+              "gdh status"
+            ]
+          },
+          {
+            "id": "run_standard_post_update_checks",
+            "kind": "mechanical",
+            "summary": "Use the ordinary post-update checks and trust terminal truth for this release line.",
+            "detail": "v0.13.2 does not bump a managed surface version or add a new release-scoped migrate action. If the target still carries the known v0.13.0 runtime-bridge `plugin.cfg` drift, the normal self-update or migrate path auto-repairs that managed file before deciding whether editor-side plugin-enable follow-through is still needed. `gdh verify drift` only audits baked `@skillcap/gdh@<version>` literals in managed skill and command surfaces, so treat the self-update `terminal` plus `gdh status` / `gdh bridge status` as the lifecycle and runtime truth.",
+            "commands": [
+              "gdh verify drift"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh bridge status"
+            ]
+          },
+          {
+            "id": "inspect_project_owned_verification_scenarios",
+            "kind": "agent_reasoning",
+            "summary": "If this target owns runtime verification scenarios, remove any `artifact_policy.screenshots: \"fallback\"` declarations.",
+            "detail": "v0.13.2 intentionally blocks fallback screenshot capture inside verification scenarios. Keep scenario truth in project-owned signals instead, and treat manual or external screenshots as human-only supporting evidence. This is a project-owned compatibility follow-through, not a managed-surface migrate step.",
+            "commands": [],
+            "validationCommands": []
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.13.3",
+      "releaseTag": "v0.13.3",
+      "migrationStatus": "no_op",
+      "summary": "v0.13.3 restores GDH-owned rendered screenshot verification after the v0.13.2 regression. Verification scenarios can again request one supporting screenshot artifact through the canonical `artifact_policy.screenshots: \"rendered\"` policy, legacy `\"fallback\"` remains a compatibility alias, the shipped Docker rendered-runtime image is rebuilt around current Node and Godot truth, and runtime-bridge screenshot capture now waits for real scene readiness before declaring success or failure. Existing targets do not require a new release-scoped managed-project migrate step for this release line.",
+      "releaseHighlights": {
+        "summary": "v0.13.3 is a patch release that restores GDH-owned rendered screenshot verification after the v0.13.2 regression. Verification scenarios can again request one supporting rendered screenshot artifact through the canonical `artifact_policy.screenshots: \"rendered\"` policy, legacy `\"fallback\"` remains accepted as a compatibility alias, and the shipped Docker plus runtime-bridge path is hardened enough to pass the real Beacon title-screen proof again.",
+        "operatorChanges": [
+          "**Rendered screenshot requests are reachable again through GDH's normal verification surfaces.** `gdh verify run` and `gdh run-config run` now share an explicit rendered-screenshot request contract, verification scenarios can declare `artifact_policy.screenshots: \"rendered\"`, and legacy `\"fallback\"` now normalizes to the same supporting-artifact behavior instead of blocking the run outright.",
+          "**The shipped Docker rendered-runtime image is rebuilt around the current toolchain truth.** The default image now targets `gdh-runtime-rendered:4.6-stable-r3`, uses Ubuntu 24.04 plus Node 22 and Godot 4.6, and exposes both `godot-linux` and `godot` inside the container for consistent GDH and manual debugging behavior.",
+          "**Rendered Docker launches are more resilient against real-target drift.** GDH now overlays sanitized `project.godot` and `.godot/extension_list.cfg` inputs for Docker Godot launches, rewrites stale UID-backed main-scene references when a resolvable `res://` path exists, forces dummy audio, and allows a longer Docker bridge handshake for slow real targets.",
+          "**Managed bridge screenshot capture is now honest about scene readiness.** The runtime bridge waits for a real current scene before attempting capture, keeps retrying until the viewport image is actually ready, and writes structured unavailability metadata when the session exits before capture completes."
+        ]
+      },
+      "updateContract": {
+        "summary": "No release-specific managed migration is required after self-update. v0.13.3 restores rendered screenshot verification and hardens the Docker plus bridge path; if a target still behaves like the older bridge template, use the ordinary `gdh bridge status` and `gdh bridge repair` flow before retrying rendered verification.",
+        "steps": [
+          {
+            "id": "repair_managed_bridge_if_rendered_verify_still_looks_stale",
+            "kind": "mechanical",
+            "summary": "If rendered verification still behaves like the older managed bridge files, run the ordinary bridge repair flow before retrying.",
+            "detail": "v0.13.3 does not bump a managed surface version, but it does ship a stricter runtime-bridge screenshot path. When a target still carries older managed bridge files or rendered verification exits before a scene becomes ready, use `gdh bridge status` and `gdh bridge repair` to rebake the managed bridge baseline. This is bounded ordinary repair, not a new release-scoped migrate step.",
+            "commands": [
+              "gdh bridge status",
+              "gdh bridge repair"
+            ],
+            "validationCommands": [
+              "gdh bridge status",
+              "gdh verify run <target> <run-config-id> --verification-scenario <scenario-id> --provider docker"
+            ]
+          },
+          {
+            "id": "prefer_canonical_rendered_policy_for_project_owned_scenarios",
+            "kind": "agent_reasoning",
+            "summary": "Project-owned screenshot scenarios should prefer `artifact_policy.screenshots: \"rendered\"` going forward.",
+            "detail": "Legacy `\"fallback\"` remains accepted as a compatibility alias in v0.13.3, but `\"rendered\"` is the canonical screenshot policy now and keeps docs, tests, and future migrations aligned. Scenario truth should still come from project-owned signals rather than image interpretation.",
+            "commands": [],
+            "validationCommands": []
+          }
+        ]
+      }
     }
   ]
 }

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

@@ -868,12 +868,13 @@ export function renderClaudeUpdateCommand(_pinnedVersion) {
         "3. When `preview.state` is `ready`, summarize the current version, target version, intervening releases, bounded release highlights, ordered steps, and which work is `mechanical`, `agent_reasoning`, or `manual_review`.",
         "4. Ask for explicit approval before apply.",
         "5. Apply: run `npx -y @skillcap/gdh@latest self-update [version]` (omit `[version]` to apply against npm latest; forward whatever positional the user passed to `/gdh-update`).",
-        "6. Verify: run `npx -y @skillcap/gdh@latest verify drift` to confirm every baked surface matches the new pin.",
-        "7. Read `terminal.state` in the apply stdout JSON.",
-        "8. If `terminal.state` is `healthy`, confirm the update completed and stop.",
-        "9. If `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping.",
-        "10. If `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of inventing a repair.",
-        "11. If `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop.",
+        "6. If this chat or editor keeps a long-lived GDH MCP session alive, restart or reconnect that MCP session before trusting MCP follow-up output. Self-update rebakes files on disk; an already-running MCP server can still be the old process or old env snapshot until it reconnects.",
+        "7. Verify baked pinning: run `npx -y @skillcap/gdh@latest verify drift` to confirm every managed skill/command surface matches the new pin. This does not validate runtime bridge or other lifecycle surfaces.",
+        "8. Read `terminal.state` in the apply stdout JSON and treat it as the lifecycle/runtime truth.",
+        "9. If `terminal.state` is `healthy`, confirm the update completed and stop.",
+        "10. If `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping.",
+        "11. If `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of inventing a repair.",
+        "12. If `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop.",
         "</process>",
         "",
         "<rules>",
@@ -914,12 +915,13 @@ export function renderCodexUpdateSkill(_pinnedVersion) {
         "3. When `preview.state` is `ready`, summarize the current version, target version, intervening releases, bounded release highlights, ordered steps, and which work is `mechanical`, `agent_reasoning`, or `manual_review`.",
         "4. Ask for explicit approval before apply.",
         "5. Apply: run `npx -y @skillcap/gdh@latest self-update [version]` (omit `[version]` to apply against npm latest; forward whatever positional the user passed to `/gdh-update`).",
-        "6. Verify: run `npx -y @skillcap/gdh@latest verify drift` to confirm every baked surface matches the new pin.",
-        "7. Read `terminal.state` in the apply stdout JSON.",
-        "8. If `terminal.state` is `healthy`, confirm the update completed and stop.",
-        "9. If `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping.",
-        "10. If `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of inventing a repair.",
-        "11. If `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop.",
+        "6. If this chat or editor keeps a long-lived GDH MCP session alive, restart or reconnect that MCP session before trusting MCP follow-up output. Self-update rebakes files on disk; an already-running MCP server can still be the old process or old env snapshot until it reconnects.",
+        "7. Verify baked pinning: run `npx -y @skillcap/gdh@latest verify drift` to confirm every managed skill/command surface matches the new pin. This does not validate runtime bridge or other lifecycle surfaces.",
+        "8. Read `terminal.state` in the apply stdout JSON and treat it as the lifecycle/runtime truth.",
+        "9. If `terminal.state` is `healthy`, confirm the update completed and stop.",
+        "10. If `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping.",
+        "11. If `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of inventing a repair.",
+        "12. If `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop.",
         "</process>",
         "",
         "<rules>",
@@ -958,12 +960,13 @@ export function renderCursorUpdateSkill(_pinnedVersion) {
         "3. When `preview.state` is `ready`, summarize the current version, target version, intervening releases, bounded release highlights, ordered steps, and which work is `mechanical`, `agent_reasoning`, or `manual_review`.",
         "4. Ask for explicit approval before apply.",
         "5. Apply: run `npx -y @skillcap/gdh@latest self-update [version]` (omit `[version]` to apply against npm latest; forward whatever positional the user passed to `/gdh-update`).",
-        "6. Verify: run `npx -y @skillcap/gdh@latest verify drift` to confirm every baked surface matches the new pin.",
-        "7. Read `terminal.state` in the apply stdout JSON.",
-        "8. If `terminal.state` is `healthy`, confirm the update completed and stop.",
-        "9. If `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping.",
-        "10. If `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of inventing a repair.",
-        "11. If `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop.",
+        "6. If this chat or editor keeps a long-lived GDH MCP session alive, restart or reconnect that MCP session before trusting MCP follow-up output. Self-update rebakes files on disk; an already-running MCP server can still be the old process or old env snapshot until it reconnects.",
+        "7. Verify baked pinning: run `npx -y @skillcap/gdh@latest verify drift` to confirm every managed skill/command surface matches the new pin. This does not validate runtime bridge or other lifecycle surfaces.",
+        "8. Read `terminal.state` in the apply stdout JSON and treat it as the lifecycle/runtime truth.",
+        "9. If `terminal.state` is `healthy`, confirm the update completed and stop.",
+        "10. If `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping.",
+        "11. If `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of inventing a repair.",
+        "12. If `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop.",
         "</process>",
         "",
         "<rules>",
@@ -3162,6 +3165,30 @@ function inspectRuntimeBridgeLifecycleSurface(targetPath, bridgeStatus) {
         });
     }
     if (bridgeStatus.state === "drifted") {
+        if (isKnownBrokenRuntimeBridgePluginCfgDrift(bridgeStatus)) {
+            return createLifecycleSurfaceStatus({
+                surface: "runtime_bridge_surface",
+                management: "managed",
+                state: "migration_available",
+                summary: bridgeStatus.autoloadRegistered
+                    ? "Runtime bridge managed plugin.cfg matches the known v0.13.0 bug and can be repaired automatically."
+                    : "Runtime bridge managed plugin.cfg matches the known v0.13.0 bug and can be repaired automatically. If GDHBridge is still not registered after repair, enable the GDH Runtime Bridge plugin in Godot.",
+                reasons: bridgeStatus.reasons,
+                probes,
+                action: {
+                    kind: "run_repair",
+                    summary: bridgeStatus.autoloadRegistered
+                        ? "Run GDH bridge repair to rewrite the managed runtime-bridge plugin.cfg."
+                        : "Run GDH bridge repair to rewrite the managed runtime-bridge plugin.cfg. If GDHBridge is still missing after repair, enable the GDH Runtime Bridge plugin in Godot.",
+                    command: ["gdh", "bridge", "repair", targetPath],
+                    validationCommands: [
+                        ["gdh", "bridge", "status", targetPath],
+                        ["gdh", "status", targetPath],
+                    ],
+                    autoApplicable: true,
+                },
+            });
+        }
         if (isRuntimeBridgePluginEnablePending(bridgeStatus)) {
             return createLifecycleSurfaceStatus({
                 surface: "runtime_bridge_surface",
@@ -3234,6 +3261,26 @@ function isRuntimeBridgePluginEnablePending(bridgeStatus) {
         bridgeStatus.managedArtifacts.every((artifact) => artifact.state === "present") &&
         bridgeStatus.reasons.includes("runtime_bridge_plugin_enable_required"));
 }
+function isKnownBrokenRuntimeBridgePluginCfgDrift(bridgeStatus) {
+    if (bridgeStatus.state !== "drifted") {
+        return false;
+    }
+    const driftedArtifacts = bridgeStatus.managedArtifacts
+        .filter((artifact) => artifact.state === "drifted")
+        .map((artifact) => artifact.id);
+    if (driftedArtifacts.length !== 1 || driftedArtifacts[0] !== "plugin-cfg") {
+        return false;
+    }
+    if (bridgeStatus.managedArtifacts.some((artifact) => artifact.state === "missing")) {
+        return false;
+    }
+    const allowedReasons = new Set([
+        "runtime_bridge_drifted:plugin-cfg",
+        "runtime_bridge_plugin_enable_required",
+        "runtime_bridge_autoload_missing_or_drifted",
+    ]);
+    return bridgeStatus.reasons.every((reason) => allowedReasons.has(reason));
+}
 async function inspectYamlSurfaceDirectory(input) {
     const currentAbsoluteDirectory = path.join(input.targetPath, input.currentRelativeDirectory);
     const legacyAbsoluteDirectory = path.join(input.targetPath, input.legacyRelativeDirectory);