@skillcap/gdh 3.0.1 → 3.1.0

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