@skillcap/gdh 0.25.4 → 0.26.0

package/node_modules/@gdh/cli/dist/index.js

@@ -5,7 +5,7 @@ import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { buildGdhStatusResult, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, CLAUDE_MIGRATE_SKILL_RELATIVE_PATH, CLAUDE_ONBOARD_SKILL_RELATIVE_PATH, CLAUDE_PREPARE_SKILL_RELATIVE_PATH, CLAUDE_SCAN_SKILL_RELATIVE_PATH, CLAUDE_STATUS_SKILL_RELATIVE_PATH, CODEX_MIGRATE_SKILL_RELATIVE_PATH, CODEX_ONBOARD_SKILL_RELATIVE_PATH, CODEX_PREPARE_SKILL_RELATIVE_PATH, CODEX_SCAN_SKILL_RELATIVE_PATH, CODEX_STATUS_SKILL_RELATIVE_PATH, CURSOR_MIGRATE_COMMAND_RELATIVE_PATH, CURSOR_ONBOARD_COMMAND_RELATIVE_PATH, CURSOR_PREPARE_COMMAND_RELATIVE_PATH, CURSOR_SCAN_COMMAND_RELATIVE_PATH, CURSOR_STATUS_COMMAND_RELATIVE_PATH, createGsdSnapshot, getSupportedAgentAdaptersStatus, installSupportedAgentAdapters, } from "@gdh/adapters";
-import { checkManagedLsp, doctorAuthoringDiagnostics, doctorManagedLsp, getAuthoringDiagnosticsStatus, getCurrentAuthoringDiagnostics, getManagedLspStatus, hasCompleteOnboardingSurface, inspectCacheState, pruneCacheState, pruneAuthoringDiagnostics, pruneManagedLsp, readProjectConfig, readWorktreeState, refreshAuthoringDiagnostics, resolveAuthoringStatus, resolveEffectiveTargetPath, resolvePinnedVersion, resolveProjectRoot, resolveTargetGodotDocsVersion, restartManagedLsp, runAuthoringCheck, runImportRefresh, runTargetPrepare, runWarmup, stopManagedLsp, } from "@gdh/authoring";
+import { checkManagedLsp, doctorAuthoringDiagnostics, doctorManagedLsp, getAuthoringDiagnosticsStatus, getCurrentAuthoringDiagnostics, getManagedLspStatus, hasCompleteOnboardingSurface, inspectCacheState, pruneCacheState, pruneAuthoringDiagnostics, pruneManagedLsp, readProjectConfig, readWorktreeState, refreshAuthoringDiagnostics, resolveAuthoringStatus, resolveEffectiveTargetPath, resolvePinnedVersion, resolveProjectRoot, resolveTargetGodotDocsVersion, restartManagedLsp, runAuthoringCheck, runImportRefresh, runTargetPrepare, runWarmup, stopManagedLsp, warmupManagedLsp, } from "@gdh/authoring";
 import { definePackageBoundary, GDH_AUTHORING_DOGFOOD_VERSION, GDH_AUTHORING_SLICE_REPORT_VERSION, GDH_PRODUCT_NAME, resolveCurrentGdhInstall, resolveGdhProductMetadata, } from "@gdh/core";
 import { fetchOfficialGodotDoc, getGuidanceStatus, resolveGuidanceQuery, searchOfficialGodotDocs, } from "@gdh/docs";
 import { createMcpManifest, invokeMcpTool, serveMcpOverStdio } from "@gdh/mcp";
@@ -713,6 +713,7 @@ async function runLspCommand(args, io) {
             "",
             "Commands:",
             "  status [target]   Resolve the managed authoring.lsp lifecycle state and print it as JSON.",
+            "  warmup [target]   Warm up the managed Godot LSP behind the scenes (idempotent: returns started | warming | already_warm | blocked).",
             "  check [target]    Check the persisted managed LSP instance without launching a new one.",
             "  stop [target]     Stop the persisted GDH-managed LSP instance for this worktree.",
             "  restart [target]  Stop and relaunch the managed LSP instance for this worktree.",
@@ -724,6 +725,9 @@ async function runLspCommand(args, io) {
     if (subcommand === "status") {
         return runLspStatusCommand(rest, io);
     }
+    if (subcommand === "warmup") {
+        return runLspWarmupCommand(rest, io);
+    }
     if (subcommand === "check" ||
         subcommand === "stop" ||
         subcommand === "restart" ||
@@ -731,7 +735,7 @@ async function runLspCommand(args, io) {
         subcommand === "doctor") {
         return runLspLifecycleCommand(subcommand, rest, io);
     }
-    io.stderr.write(`Unknown lsp command: ${subcommand}\n\nUsage: gdh lsp <status|check|stop|restart|prune|doctor> [target]\n`);
+    io.stderr.write(`Unknown lsp command: ${subcommand}\n\nUsage: gdh lsp <status|warmup|check|stop|restart|prune|doctor> [target]\n`);
     return 1;
 }
 async function runDocsCommand(args, io) {
@@ -1116,17 +1120,26 @@ function formatAuthoringCheckCommand(input) {
 function formatCompactAuthoringCheckResult(result) {
     const lines = result.diagnostics.map((diagnostic) => {
         const pathPart = diagnostic.path === null ? "<unknown>" : `res://${diagnostic.path}`;
-        const line = diagnostic.line === null ? "" : `:${diagnostic.line + 1}`;
-        const column = diagnostic.column === null ? "" : `:${diagnostic.column + 1}`;
+        const line = diagnostic.line === null ? "" : `:${diagnostic.line}`;
+        const column = diagnostic.column === null ? "" : `:${diagnostic.column}`;
         return `${pathPart}${line}${column} [${diagnostic.severity}] ${diagnostic.message}`;
     });
     const summary = result.blockingSummary;
-    const outcome = summary.state === "blocked"
-        ? "Completion blocked."
+    // Phase 81 / LSP-06 / D-01, D-03: bracketed-token compact-output vocabulary.
+    // Mapping (locked from CONTEXT.md "Claude's Discretion"):
+    //   "allowed"      -> "fresh"     (no blocking errors, all files checked)
+    //   "blocked"      -> "failed"    (blocking errors present)
+    //   "unconfirmed"  -> "pending"   (could not prove this edit; warmup or scope-limited)
+    // Other status tokens ("partial", "stale", "timeout") enter the vocabulary
+    // via the hook template (timedOut branch) and via upstream broker paths
+    // that produce non-GdhAuthoringCompletionState results — not via this
+    // compact formatter, which only sees allowed | blocked | unconfirmed.
+    const statusToken = summary.state === "blocked"
+        ? "failed"
         : summary.state === "unconfirmed"
-            ? "Completion unconfirmed."
-            : "Completion allowed.";
-    lines.push(`${summary.errorCount} errors, ${summary.warningCount} warnings, ${summary.infoCount} info. ${outcome}`);
+            ? "pending"
+            : "fresh";
+    lines.push(`[${statusToken}] ${summary.errorCount} errors, ${summary.warningCount} warnings, ${summary.infoCount} info.`);
     if (summary.reasons.length > 0) {
         lines.push(`Reasons: ${summary.reasons.join(", ")}`);
     }
@@ -1159,7 +1172,17 @@ async function runLspStatusCommand(args, io) {
             projectConfig: context.projectConfig,
             owner: "gdh lsp status",
         });
+        // Phase 81 / LSP-08 / D-16: JSON pass-through includes versionFloorAdvisory
+        // as a structured field when non-null (set by Plan 04 on unavailable results
+        // with reason godot_editor_version_unsupported_for_lsp).
         io.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        // Human-readable version-floor advisory (D-16): printed after JSON when present.
+        if (result.versionFloorAdvisory != null) {
+            const advisory = result.versionFloorAdvisory;
+            const detected = advisory.detectedVersion ?? "unknown";
+            const recommended = advisory.recommendedVersions.join(" or ");
+            io.stdout.write(`Configured Godot binary ${detected} is below the managed-LSP floor (>= ${advisory.minimumVersion}); recommended: ${recommended}.\n`);
+        }
         return 0;
     }
     catch (error) {
@@ -1167,6 +1190,48 @@ async function runLspStatusCommand(args, io) {
         return 1;
     }
 }
+async function runLspWarmupCommand(args, io) {
+    if (args.includes("--help")) {
+        io.stdout.write([
+            "Usage: gdh lsp warmup [target]",
+            "Usage: gdh lsp warmup --target <path>",
+            "",
+            "Idempotently warm up the managed Godot LSP for the target so subsequent",
+            "post-edit authoring checks return fast diagnostics. Prints a JSON",
+            "GdhAuthoringLspWarmupResult with status: started | warming | already_warm",
+            "| blocked. All four statuses exit 0; --help and argument errors exit 1.",
+            "",
+            "This verb is what the post-edit hook detaches via child_process.spawn(...,",
+            "{ detached: true, stdio: 'ignore' }).unref() so the agent does not pay",
+            "Godot-startup latency on the cold-start edit (Phase 82 / LSP-02).",
+        ].join("\n") + "\n");
+        return 0;
+    }
+    const parsedTarget = parseSingleTargetPathArg(args, {
+        usage: "Usage: gdh lsp warmup [target]\nUsage: gdh lsp warmup --target <path>\n",
+        allowTargetOption: true,
+    });
+    if (parsedTarget.error !== null) {
+        io.stderr.write(parsedTarget.error);
+        return 1;
+    }
+    const targetPath = parsedTarget.targetPath;
+    try {
+        const context = await buildAuthoringContext(targetPath);
+        const result = await warmupManagedLsp({
+            targetPath: context.targetPath,
+            status: context.status,
+            projectConfig: context.projectConfig,
+            owner: "gdh lsp warmup",
+        });
+        io.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        return 0;
+    }
+    catch (error) {
+        io.stderr.write(`Failed to warm up managed LSP for "${targetPath}": ${formatCliError(error)}\n`);
+        return 1;
+    }
+}
 async function runLspLifecycleCommand(command, args, io) {
     if (args.includes("--help")) {
         io.stdout.write([
@@ -4404,7 +4469,7 @@ function renderHelp() {
         "  adapters gsd snapshot [target] [--files <path>] Export a read-only GSD projection.",
         "  authoring check [target] Run the current authoring-check entrypoint.",
         "  authoring diagnostics <status|current|refresh|doctor|prune> [target] Inspect current Godot authoring diagnostics snapshots.",
-        "  lsp <status|check|stop|restart|prune|doctor> [target] Manage authoring.lsp lifecycle state.",
+        "  lsp <status|warmup|check|stop|restart|prune|doctor> [target] Manage authoring.lsp lifecycle state.",
         "  warmup [target] [--dry-run] Inspect or apply authoring worktree warmup.",
         "  target prepare [target] [--source-target <path>] [--dry-run] Prepare target-local generated/import state.",
         "  imports refresh [target] [--dry-run] Run or plan a headless Godot import refresh.",