@skillcap/gdh 3.1.0 → 3.2.0

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "installMode": "packaged_install"
 }

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -3979,6 +3979,89 @@
           }
         ]
       }
+    },
+    {
+      "version": "3.2.0",
+      "releaseTag": "v3.2.0",
+      "migrationStatus": "required",
+      "summary": "v3.2.0 refreshes editor bridge ergonomics for agents. Managed guidance gains an editor bridge unit, the MCP manifest exposes focused editor read tools, and the managed Godot editor bridge catalog adds current editor context, node inspection, resource property discovery, recoverable operation usage, and bounded recursive resource encoding. Existing managed targets need a guidance/MCP refresh and bridge-enabled targets may need runtime bridge surface 15 repair.",
+      "releaseHighlights": {
+        "summary": "v3.2.0 makes the editor bridge easier for agents to use correctly. Common editor reads now have focused MCP tools, malformed generic editor-operation payloads return concrete usage help, and adopted editor state reports current scene and selection context when Godot exposes it. The release also expands resource and inspector-style reads. Agents can inspect scene nodes, discover resource properties, and read nested arrays/dictionaries without losing resource handles to stringification.",
+        "operatorChanges": [
+          "**Focused editor MCP tools.** Agents can use `editor.state`,",
+          "**Self-correcting operation errors.** Invalid editor operations now explain",
+          "**Better adopted-editor context.** `editor.state` reports current/open scene",
+          "**Inspector-style reads.** `node.inspect` and `resource.properties` expose",
+          "**Navigable nested resources.** `resource.read` recursively encodes arrays and",
+          "**Generated guidance refresh.** Managed target guidance now includes an"
+        ]
+      },
+      "updateContract": {
+        "summary": "Existing managed targets should self-update to v3.2.0, run GDH migration when guidance or MCP manifest surfaces are outdated, and repair the bridge addon when runtime bridge surface drift is reported. After migration, agents should use focused editor tools first and reserve editor.operation.run for advanced payloads with operation.kind.",
+        "steps": [
+          {
+            "id": "install_v3_2_0",
+            "kind": "mechanical",
+            "summary": "Install the v3.2.0 GDH package.",
+            "detail": "Run the normal GDH update flow so the target uses the package with focused editor MCP tools, guidance unit version 27, MCP manifest version 2, and runtime bridge surface version 15.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "apply_guidance_and_manifest_migration",
+            "kind": "mechanical",
+            "summary": "Apply managed guidance and MCP manifest refresh work.",
+            "detail": "Run migrate when lifecycle status reports guidance index, guidance unit, or MCP manifest drift. This writes the editor bridge guidance unit and refreshes generated target surfaces.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh guidance status",
+              "gdh verify drift <target>"
+            ]
+          },
+          {
+            "id": "repair_bridge_addon_when_drifted",
+            "kind": "mechanical",
+            "summary": "Repair the managed bridge addon when bridge status reports runtime bridge drift.",
+            "detail": "Run bridge repair only when GDH reports project-side runtime bridge surface drift. The repair path refreshes addons/gdh_bridge/editor/gdh_editor_bridge_plugin.gd to the surface 15 catalog.",
+            "commands": [
+              "gdh bridge repair <target>"
+            ],
+            "validationCommands": [
+              "gdh bridge status <target>",
+              "gdh status"
+            ]
+          },
+          {
+            "id": "verify_editor_tool_usage",
+            "kind": "agent_reasoning",
+            "summary": "Use focused editor tools before the generic operation runner.",
+            "detail": "For editor context questions, agents should call editor.state first, then focused tools such as editor.scene.tree, editor.node.inspect, editor.resource.properties, or editor.resource.read. The generic editor.operation.run remains valid for advanced payloads that include operation.kind.",
+            "commands": [
+              "gdh editor session status [target]"
+            ],
+            "validationCommands": [
+              "gdh editor session status [target]"
+            ]
+          },
+          {
+            "id": "review_editor_context_boundary",
+            "kind": "manual_review",
+            "summary": "Confirm adopted editor context is available when the task depends on human editor state.",
+            "detail": "When an agent needs the currently open editor scene, selected nodes, or other human editor context, verify editor.state reports editorContextAvailable before treating currentScenePath or selectedNodePaths as live editor truth. Headless sessions can still load saved scenes/resources but do not expose human selection.",
+            "commands": [],
+            "validationCommands": [
+              "gdh editor session status [target]"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

package/node_modules/@gdh/adapters/package.json

@@ -11,13 +11,13 @@
     }
   },
   "dependencies": {
-    "@gdh/authoring": "3.1.0",
-    "@gdh/core": "3.1.0",
-    "@gdh/docs": "3.1.0",
-    "@gdh/observability": "3.1.0",
-    "@gdh/runtime": "3.1.0",
-    "@gdh/scan": "3.1.0",
-    "@gdh/verify": "3.1.0"
+    "@gdh/authoring": "3.2.0",
+    "@gdh/core": "3.2.0",
+    "@gdh/docs": "3.2.0",
+    "@gdh/observability": "3.2.0",
+    "@gdh/runtime": "3.2.0",
+    "@gdh/scan": "3.2.0",
+    "@gdh/verify": "3.2.0"
   },
-  "version": "3.1.0"
+  "version": "3.2.0"
 }

package/node_modules/@gdh/authoring/package.json

@@ -14,7 +14,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@gdh/core": "3.1.0"
+    "@gdh/core": "3.2.0"
   },
-  "version": "3.1.0"
+  "version": "3.2.0"
 }