@skillcap/gdh 3.0.2 → 3.1.0

package/INSTALL-BUNDLE.json

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

package/README.md

@@ -51,6 +51,7 @@ gdh self-update --dry-run --target .
 
 - [Install and update](./docs/development/install-and-update.md)
 - [Advanced CLI usage](./docs/development/advanced-cli-usage.md)
+- [Editor Bridge](./docs/development/editor-bridge.md)
 - [Runtime support matrix](./docs/development/runtime-support-matrix.md)
 - [Runtime release readiness](./docs/development/runtime-release-readiness.md)
 - [All docs](./docs/README.md)

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -3896,6 +3896,89 @@
           }
         ]
       }
+    },
+    {
+      "version": "3.1.0",
+      "releaseTag": "v3.1.0",
+      "migrationStatus": "required",
+      "summary": "v3.1.0 adds the GDH editor bridge and exact-worktree editor session adoption. The managed Godot addon remains one addon under addons/gdh_bridge/, now with separate runtime and editor components composed by plugin.gd. GDH_RUNTIME_BRIDGE_SURFACE_VERSION moves 12 -> 14 so existing managed bridge targets re-bake or repair the bridge addon, generated bridge manifest, plugin.cfg/plugin.gd, autoload registration, and [editor_plugins] registration before editor operations are treated as healthy.",
+      "releaseHighlights": {
+        "summary": "v3.1.0 adds the editor bridge: a Godot-editor-backed authoring surface that lets agents inspect editor state and perform bounded scene/resource operations through Godot APIs instead of editing `.tscn` and `.tres` text directly. The release ships editor session adoption for already-open Godot editors that belong to the exact target/worktree, plus managed headless editor launch when no compatible editor is open. Editor-specific MCP tools lazily ensure this session; generic status and documentation tools do not launch the editor as a side effect. The managed Godot addon remains one addon under `addons/gdh_bridge/`. Runtime and editor bridge pieces are separated inside that addon, and the Godot-required `plugin.gd` composition root owns both pieces.",
+        "operatorChanges": [
+          "**Editor bridge MCP tools.** Agents can use `editor.session.status` and",
+          "**CLI smoke-test commands.** Maintainers can run `gdh editor session status`",
+          "**Exact-worktree editor adoption.** GDH adopts an already-open editor only",
+          "**Managed headless fallback.** If no compatible editor is registered, GDH can",
+          "**One managed addon.** Editor support ships inside the existing",
+          "**Bounded v1 operation catalog.** The first catalog includes scene creation,"
+        ]
+      },
+      "updateContract": {
+        "summary": "Existing managed targets should self-update to v3.1.0, then let GDH migrate or repair the managed bridge addon when lifecycle or bridge status reports runtime bridge surface drift. Editor operations require the current single GDH addon, autoload registration, [editor_plugins] registration, and an exact-worktree adopted or managed headless editor session.",
+        "steps": [
+          {
+            "id": "install_v3_1_0",
+            "kind": "mechanical",
+            "summary": "Install the v3.1.0 GDH package.",
+            "detail": "Run the normal GDH update flow so the target uses the package that knows the editor bridge operation catalog and runtime bridge surface version 14.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "apply_managed_surface_migration",
+            "kind": "mechanical",
+            "summary": "Apply pending managed-surface migration work.",
+            "detail": "Run migrate when lifecycle status reports pending managed-surface work. This refreshes generated agent surfaces as needed and lets GDH plan or apply current managed bridge output for the configured target.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh 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 rewrites the single addons/gdh_bridge/ addon to the current runtime/editor composition, bridge manifest version 14, plugin.cfg/plugin.gd shape, GDHBridge autoload registration, and [editor_plugins] registration.",
+            "commands": [
+              "gdh bridge repair <target>"
+            ],
+            "validationCommands": [
+              "gdh bridge status <target>",
+              "gdh status"
+            ]
+          },
+          {
+            "id": "verify_editor_session_surface",
+            "kind": "agent_reasoning",
+            "summary": "Verify editor operations use the exact target/worktree editor session.",
+            "detail": "For editor-specific work, inspect editor session status after opening the target in Godot or let the editor operation ensure a managed headless session. Adopted sessions are valid only when metadata points to the exact target/worktree; otherwise GDH should launch or report the managed session path for editor operations.",
+            "commands": [
+              "gdh editor session status [target]"
+            ],
+            "validationCommands": [
+              "gdh editor session status [target]"
+            ]
+          },
+          {
+            "id": "manual_editor_plugin_enable_if_needed",
+            "kind": "manual_review",
+            "summary": "Enable the GDH bridge plugin in Godot if Godot has not loaded it yet.",
+            "detail": "GDH writes the managed plugin registration, but Godot may still require the editor to reload or the operator to enable the GDH bridge plugin before adopted editor metadata and GDHBridge runtime registration are visible. Do this only when GDH status or bridge/editor session status reports the plugin is not active after repair.",
+            "commands": [],
+            "validationCommands": [
+              "gdh bridge status <target>",
+              "gdh editor session status [target]"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

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

@@ -11,13 +11,13 @@
     }
   },
   "dependencies": {
-    "@gdh/authoring": "3.0.2",
-    "@gdh/core": "3.0.2",
-    "@gdh/docs": "3.0.2",
-    "@gdh/observability": "3.0.2",
-    "@gdh/runtime": "3.0.2",
-    "@gdh/scan": "3.0.2",
-    "@gdh/verify": "3.0.2"
+    "@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"
   },
-  "version": "3.0.2"
+  "version": "3.1.0"
 }

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

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

package/node_modules/@gdh/cli/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/cli/dist/index.js

@@ -8,6 +8,7 @@ import { buildGdhStatusResult, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, CLAUDE_MI
 import { checkManagedLsp, doctorAuthoringDiagnostics, doctorManagedLsp, getAuthoringDiagnosticsStatus, getCurrentAuthoringDiagnostics, getManagedLspStatus, hasCompleteOnboardingSurface, inspectCacheState, pruneAuthoringDiagnostics, pruneCacheState, pruneManagedLsp, readProjectConfig, readWorktreeState, refreshAuthoringDiagnostics, resolveAuthoringStatus, resolveEffectiveTargetPath, resolvePinnedVersion, resolveProjectRoot, resolveTargetGodotDocsVersion, restartManagedLsp, runAuthoringCheck, runImportRefresh, runTargetPrepare, runWarmup, stopManagedLsp, warmupManagedLsp, } from "@gdh/authoring";
 import { CODEX_RETRUST_REMINDER_TEXT, clearCodexRetrustReminder, definePackageBoundary, GDH_AUTHORING_DOGFOOD_VERSION, GDH_AUTHORING_SLICE_REPORT_VERSION, GDH_PRODUCT_NAME, readCodexRetrustReminder, resolveCurrentGdhInstall, resolveGdhProductMetadata, } from "@gdh/core";
 import { fetchOfficialGodotDoc, getGuidanceStatus, resolveGuidanceQuery, searchOfficialGodotDocs, } from "@gdh/docs";
+import { inspectEditorBridgeSession, runEditorOperation, } from "@gdh/editor";
 import { createMcpManifest, invokeMcpTool, serveMcpOverStdio } from "@gdh/mcp";
 import { inspectAuthoringEffectiveness, inspectAuthoringSessions, inspectGuidanceAudit, recordAuthoringSessionEvent, } from "@gdh/observability";
 import { checkRuntimeRecipe, createRuntimeBridgeManager, inspectRuntimeBridgeSurface, installRuntimeBridgeSurface, listRuntimeRecipes, removeRuntimeBridgeSurface, repairRuntimeBridgeSurface, runRuntimeRecipe, serveRuntimeBridgeBroker, showRuntimeRecipe, } from "@gdh/runtime";
@@ -39,6 +40,7 @@ export const cliPackage = definePackageBoundary({
         "@gdh/core",
         "@gdh/authoring",
         "@gdh/docs",
+        "@gdh/editor",
         "@gdh/mcp",
         "@gdh/observability",
         "@gdh/runtime",
@@ -107,6 +109,9 @@ export async function runCli(args, io = { stdout: process.stdout, stderr: proces
     if (command === "bridge") {
         return runBridgeCommand(rest, io);
     }
+    if (command === "editor") {
+        return runEditorCommand(rest, io);
+    }
     if (command === "verification-scenario" || command === "scenario") {
         return runScenarioCommand(rest, io);
     }
@@ -1765,6 +1770,163 @@ async function runMcpCommand(args, io) {
     ].join("\n") + "\n");
     return 1;
 }
+async function runEditorCommand(args, io) {
+    const [subcommand, ...rest] = args;
+    if (!subcommand || subcommand === "--help" || subcommand === "help") {
+        io.stdout.write([
+            "Usage: gdh editor <command>",
+            "",
+            "Commands:",
+            "  session status [target] [--mode <mode>] [--godot-editor-bin <path>]                 Inspect Editor Bridge availability.",
+            "  operation run [target] --input-json <json> [--mode <mode>] [--godot-editor-bin <path>] Run one Godot-native editor operation.",
+        ].join("\n") + "\n");
+        return 0;
+    }
+    if (subcommand === "session") {
+        return runEditorSessionCommand(rest, io);
+    }
+    if (subcommand === "operation") {
+        return runEditorOperationCommand(rest, io);
+    }
+    io.stderr.write([
+        `Unknown editor command: ${subcommand}`,
+        "",
+        "Usage: gdh editor session status [target] [--mode <mode>] [--godot-editor-bin <path>]",
+        "Usage: gdh editor operation run [target] --input-json <json> [--mode <mode>] [--godot-editor-bin <path>]",
+    ].join("\n") + "\n");
+    return 1;
+}
+async function runEditorSessionCommand(args, io) {
+    const [subcommand, ...rest] = args;
+    if (!subcommand || subcommand === "--help" || subcommand === "help") {
+        io.stdout.write([
+            "Usage: gdh editor session status [target] [--mode <mode>] [--godot-editor-bin <path>]",
+            "",
+            "Inspect whether GDH can run editor operations for the exact target/worktree.",
+        ].join("\n") + "\n");
+        return 0;
+    }
+    if (subcommand !== "status") {
+        io.stderr.write(`Unknown editor session command: ${subcommand}\nUsage: gdh editor session status [target] [--mode <mode>] [--godot-editor-bin <path>]\n`);
+        return 1;
+    }
+    const unsupportedOptionsError = findUnsupportedOptionsError(rest, {
+        usage: "Usage: gdh editor session status [target] [--mode <mode>] [--godot-editor-bin <path>]\n",
+        optionsWithValues: ["--mode", "--godot-editor-bin"],
+    });
+    if (unsupportedOptionsError !== null) {
+        io.stderr.write(unsupportedOptionsError);
+        return 1;
+    }
+    const { targetPath, error } = parseOptionalPositionalTargetPath(rest, {
+        usage: "Usage: gdh editor session status [target] [--mode <mode>] [--godot-editor-bin <path>]\n",
+        additionalOptionsWithValues: new Set(["--mode", "--godot-editor-bin"]),
+    });
+    if (error !== null) {
+        io.stderr.write(error);
+        return 1;
+    }
+    const mode = parseEditorSessionMode(readSingleOptionValue(rest, "--mode"));
+    if (mode === null) {
+        io.stderr.write("Usage error: --mode must be one of auto, headless_only, headless-only, adopt_only, adopt-only, or disabled.\n");
+        return 1;
+    }
+    try {
+        const projectConfig = await readProjectConfig(targetPath);
+        const result = await inspectEditorBridgeSession({
+            targetPath,
+            projectConfig,
+            mode,
+            godotEditorBin: readSingleOptionValue(rest, "--godot-editor-bin"),
+        });
+        writeJsonResult(io, result);
+        return result.state === "blocked" ? 1 : 0;
+    }
+    catch (error) {
+        io.stderr.write(`Failed to inspect Editor Bridge session: ${formatCliError(error)}\n`);
+        return 1;
+    }
+}
+async function runEditorOperationCommand(args, io) {
+    const [subcommand, ...rest] = args;
+    if (!subcommand || subcommand === "--help" || subcommand === "help") {
+        io.stdout.write([
+            "Usage: gdh editor operation run [target] --input-json <json> [--mode <mode>] [--godot-editor-bin <path>] [--timeout-ms <ms>] [--retain-artifacts <count>]",
+            "",
+            "Run one targeted Editor Bridge operation and print the action-oriented result as JSON.",
+        ].join("\n") + "\n");
+        return 0;
+    }
+    if (subcommand !== "run") {
+        io.stderr.write(`Unknown editor operation command: ${subcommand}\nUsage: gdh editor operation run [target] --input-json <json> [--mode <mode>] [--godot-editor-bin <path>] [--timeout-ms <ms>] [--retain-artifacts <count>]\n`);
+        return 1;
+    }
+    const unsupportedOptionsError = findUnsupportedOptionsError(rest, {
+        usage: "Usage: gdh editor operation run [target] --input-json <json> [--mode <mode>] [--godot-editor-bin <path>] [--timeout-ms <ms>] [--retain-artifacts <count>]\n",
+        optionsWithValues: [
+            "--input-json",
+            "--mode",
+            "--godot-editor-bin",
+            "--timeout-ms",
+            "--retain-artifacts",
+        ],
+    });
+    if (unsupportedOptionsError !== null) {
+        io.stderr.write(unsupportedOptionsError);
+        return 1;
+    }
+    if (readSingleOptionValue(rest, "--input-json") === null) {
+        io.stderr.write("Usage error: gdh editor operation run requires --input-json <json>.\n");
+        return 1;
+    }
+    const { targetPath, error } = parseOptionalPositionalTargetPath(rest, {
+        usage: "Usage: gdh editor operation run [target] --input-json <json> [--mode <mode>] [--godot-editor-bin <path>] [--timeout-ms <ms>] [--retain-artifacts <count>]\n",
+        additionalOptionsWithValues: new Set([
+            "--input-json",
+            "--mode",
+            "--godot-editor-bin",
+            "--timeout-ms",
+            "--retain-artifacts",
+        ]),
+    });
+    if (error !== null) {
+        io.stderr.write(error);
+        return 1;
+    }
+    const mode = parseEditorSessionMode(readSingleOptionValue(rest, "--mode"));
+    if (mode === null) {
+        io.stderr.write("Usage error: --mode must be one of auto, headless_only, headless-only, adopt_only, adopt-only, or disabled.\n");
+        return 1;
+    }
+    const timeoutMs = parseOptionalPositiveIntegerOption(rest, "--timeout-ms");
+    if (timeoutMs === null && rest.includes("--timeout-ms")) {
+        io.stderr.write("Usage error: --timeout-ms must be a positive integer.\n");
+        return 1;
+    }
+    const retainOperationArtifacts = parseOptionalPositiveIntegerOption(rest, "--retain-artifacts");
+    if (retainOperationArtifacts === null && rest.includes("--retain-artifacts")) {
+        io.stderr.write("Usage error: --retain-artifacts must be a positive integer.\n");
+        return 1;
+    }
+    try {
+        const projectConfig = await readProjectConfig(targetPath);
+        const result = await runEditorOperation({
+            targetPath,
+            projectConfig,
+            operation: parseEditorOperationJson(rest),
+            mode,
+            ...(typeof timeoutMs === "number" && { timeoutMs }),
+            ...(typeof retainOperationArtifacts === "number" && { retainOperationArtifacts }),
+            godotEditorBin: readSingleOptionValue(rest, "--godot-editor-bin"),
+        });
+        writeJsonResult(io, result);
+        return result.state === "ok" ? 0 : 1;
+    }
+    catch (error) {
+        io.stderr.write(`Failed to run Editor Bridge operation: ${formatCliError(error)}\n`);
+        return 1;
+    }
+}
 async function runAuthoringDogfoodCommand(args, io) {
     if (args.includes("--help")) {
         io.stdout.write([
@@ -3407,8 +3569,8 @@ async function runVerifyDriftCommand(args, io) {
             "the pinned value. Covers ROADMAP Success Criterion #3 (one source of truth).",
             "Also recognises the pre-v3.0.0 hook layout (RFC 0010 / CPATH-10): when",
             "`.claude/hooks/gdh-*.js` or `.codex/hooks/gdh-authoring-guard.js` is still on",
-            "disk, the result emits `legacyLayout.state: \"migration_pending\"` (legacy only)",
-            "or `\"partially_migrated\"` (legacy + canonical present) and points the",
+            'disk, the result emits `legacyLayout.state: "migration_pending"` (legacy only)',
+            'or `"partially_migrated"` (legacy + canonical present) and points the',
             "remediation action at `gdh self-update` rather than `gdh adapters install`.",
             "This command does NOT validate runtime bridge, project lifecycle, or authoring health.",
             "",
@@ -3484,8 +3646,7 @@ async function runVerifyDriftCommand(args, io) {
     // `gdh self-update` instead of `gdh adapters install`; the migration entry
     // owns the legacy-file cleanup that re-bake cannot perform.
     const legacyLayout = await inspectVerifyDriftLegacyLayout(targetPath);
-    const action = legacyLayout.state === "migration_pending" ||
-        legacyLayout.state === "partially_migrated"
+    const action = legacyLayout.state === "migration_pending" || legacyLayout.state === "partially_migrated"
         ? {
             kind: "run_migration",
             summary: legacyLayout.state === "migration_pending"
@@ -4547,6 +4708,8 @@ function renderHelp() {
         "  bridge install [target] [--dry-run] Install the GDH-managed runtime bridge surface.",
         "  bridge repair [target] [--dry-run] Repair drifted GDH-managed bridge files and autoload state.",
         "  bridge remove [target] [--dry-run] Remove the GDH-managed runtime bridge surface.",
+        "  editor session status [target] Inspect Editor Bridge availability for the exact target/worktree.",
+        "  editor operation run [target] --input-json <json> Run one Godot-native editor operation.",
         "  verification-scenario list [target] List verification scenarios.",
         "  verification-scenario show [target] <verification-scenario-id> Show one verification scenario.",
         "  guidance status [target] Inspect durable guidance and audit availability.",
@@ -4796,6 +4959,34 @@ function parseMcpInputJson(args) {
     }
     return parsed;
 }
+function parseEditorOperationJson(args) {
+    const parsed = parseMcpInputJson(args);
+    const operation = parsed["operation"];
+    if (operation !== null &&
+        operation !== undefined &&
+        !Array.isArray(operation) &&
+        typeof operation === "object") {
+        return operation;
+    }
+    return parsed;
+}
+function parseEditorSessionMode(value) {
+    if (value === null || value === "auto")
+        return "auto";
+    if (value === "headless_only" || value === "headless-only")
+        return "headless_only";
+    if (value === "adopt_only" || value === "adopt-only")
+        return "adopt_only";
+    if (value === "disabled")
+        return "disabled";
+    return null;
+}
+function parseOptionalPositiveIntegerOption(args, optionName) {
+    const value = readSingleOptionValue(args, optionName);
+    if (value === null)
+        return undefined;
+    return parsePositiveIntegerOptionValue(value);
+}
 function collectAdapterNames(args) {
     const values = collectOptionValues(args, "--agent");
     if (values.length === 0) {