@skillcap/gdh 0.15.1 → 0.17.0

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

@@ -1,11 +1,11 @@
 import { spawnSync } from "node:child_process";
-import fs from "node:fs/promises";
 import fsSync from "node:fs";
+import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { buildGdhStatusResult, CLAUDE_CHECK_COMMAND_RELATIVE_PATH, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH, CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, CLAUDE_STATUS_COMMAND_RELATIVE_PATH, CLAUDE_VERIFY_COMMAND_RELATIVE_PATH, CODEX_CHECK_SKILL_RELATIVE_PATH, CODEX_MIGRATE_SKILL_RELATIVE_PATH, CODEX_ONBOARD_SKILL_RELATIVE_PATH, CODEX_PREPARE_SKILL_RELATIVE_PATH, CODEX_STATUS_SKILL_RELATIVE_PATH, CODEX_VERIFY_SKILL_RELATIVE_PATH, createGsdSnapshot, CURSOR_CHECK_SKILL_RELATIVE_PATH, CURSOR_MIGRATE_SKILL_RELATIVE_PATH, CURSOR_ONBOARD_SKILL_RELATIVE_PATH, CURSOR_PREPARE_SKILL_RELATIVE_PATH, CURSOR_STATUS_SKILL_RELATIVE_PATH, CURSOR_VERIFY_SKILL_RELATIVE_PATH, getSupportedAgentAdaptersStatus, installSupportedAgentAdapters, } from "@gdh/adapters";
-import { getManagedLspStatus, hasCompleteOnboardingSurface, inspectCacheState, pruneCacheState, readProjectConfig, resolvePinnedVersion, resolveProjectRoot, readWorktreeState, resolveAuthoringStatus, resolveTargetGodotDocsVersion, runAuthoringCheck, runImportRefresh, runTargetPrepare, runWarmup, } from "@gdh/authoring";
+import { buildGdhStatusResult, CLAUDE_CHECK_COMMAND_RELATIVE_PATH, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH, CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, CLAUDE_STATUS_COMMAND_RELATIVE_PATH, CLAUDE_VERIFY_COMMAND_RELATIVE_PATH, CODEX_CHECK_SKILL_RELATIVE_PATH, CODEX_MIGRATE_SKILL_RELATIVE_PATH, CODEX_ONBOARD_SKILL_RELATIVE_PATH, CODEX_PREPARE_SKILL_RELATIVE_PATH, CODEX_STATUS_SKILL_RELATIVE_PATH, CODEX_VERIFY_SKILL_RELATIVE_PATH, CURSOR_CHECK_SKILL_RELATIVE_PATH, CURSOR_MIGRATE_SKILL_RELATIVE_PATH, CURSOR_ONBOARD_SKILL_RELATIVE_PATH, CURSOR_PREPARE_SKILL_RELATIVE_PATH, CURSOR_STATUS_SKILL_RELATIVE_PATH, CURSOR_VERIFY_SKILL_RELATIVE_PATH, createGsdSnapshot, getSupportedAgentAdaptersStatus, installSupportedAgentAdapters, } from "@gdh/adapters";
+import { checkManagedLsp, doctorManagedLsp, getManagedLspStatus, hasCompleteOnboardingSurface, inspectCacheState, pruneCacheState, pruneManagedLsp, readProjectConfig, readWorktreeState, resolveAuthoringStatus, resolvePinnedVersion, resolveProjectRoot, resolveTargetGodotDocsVersion, restartManagedLsp, runAuthoringCheck, runImportRefresh, runTargetPrepare, runWarmup, stopManagedLsp, } 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";
@@ -354,7 +354,12 @@ async function runOnboardCommand(args, io) {
     const dryRun = args.includes("--dry-run");
     const { targetPath, error: targetPathError } = parseOptionalPositionalTargetPath(args, {
         usage: "Usage: gdh onboard [target] [--dry-run]\n",
-        additionalOptionsWithValues: new Set(["--task-type", "--capability", "--repo-state", "--keyword"]),
+        additionalOptionsWithValues: new Set([
+            "--task-type",
+            "--capability",
+            "--repo-state",
+            "--keyword",
+        ]),
     });
     if (targetPathError !== null) {
         io.stderr.write(targetPathError);
@@ -426,7 +431,6 @@ async function runStatusCommand(args, io) {
         return 1;
     }
     const targetPath = parsedTarget.targetPath;
-    const commandStartedAtMs = Date.now();
     // UPD-04: emit the update banner to stderr BEFORE primary work so the
     // stderr prelude precedes any stdout JSON payload. D-13 scopes the banner
     // to `gdh status` and `gdh verify` only. Silent when cache is null /
@@ -434,25 +438,10 @@ async function runStatusCommand(args, io) {
     await emitUpdateBannerIfStale(targetPath, io);
     try {
         const status = await buildGdhStatusResult(targetPath);
-        await recordSessionEvent(targetPath, {
-            commandStartedAtMs,
-            kind: "status",
-            command: "gdh status",
-            state: status.readiness === "undetected" ? "blocked" : "succeeded",
-            summary: status.summary,
-        });
         io.stdout.write(`${JSON.stringify(status, null, 2)}\n`);
         return 0;
     }
     catch (error) {
-        await recordSessionEvent(targetPath, {
-            commandStartedAtMs,
-            kind: "status",
-            command: "gdh status",
-            state: "failed",
-            summary: "GDH status resolution failed before producing a result.",
-            errorMessage: formatCliError(error),
-        });
         io.stderr.write(`Failed to resolve status for "${targetPath}": ${formatCliError(error)}\n`);
         return 1;
     }
@@ -497,14 +486,26 @@ async function runLspCommand(args, io) {
             "Usage: gdh lsp <command> [target]",
             "",
             "Commands:",
-            "  status [target]  Resolve the managed authoring.lsp lifecycle state and print it as JSON.",
+            "  status [target]   Resolve the managed authoring.lsp lifecycle state and print it as JSON.",
+            "  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.",
+            "  prune [target]    Remove stale managed LSP state without killing live unrelated processes.",
+            "  doctor [target]   Report lifecycle, transport, diagnostics, and cleanup guidance.",
         ].join("\n") + "\n");
         return 0;
     }
     if (subcommand === "status") {
         return runLspStatusCommand(rest, io);
     }
-    io.stderr.write(`Unknown lsp command: ${subcommand}\n\nUsage: gdh lsp status [target]\n`);
+    if (subcommand === "check" ||
+        subcommand === "stop" ||
+        subcommand === "restart" ||
+        subcommand === "prune" ||
+        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`);
     return 1;
 }
 async function runDocsCommand(args, io) {
@@ -787,6 +788,63 @@ async function runLspStatusCommand(args, io) {
         return 1;
     }
 }
+async function runLspLifecycleCommand(command, args, io) {
+    if (args.includes("--help")) {
+        io.stdout.write([
+            `Usage: gdh lsp ${command} [target]`,
+            `Usage: gdh lsp ${command} --target <path>`,
+            "",
+            describeLspLifecycleCommand(command),
+        ].join("\n") + "\n");
+        return 0;
+    }
+    const parsedTarget = parseSingleTargetPathArg(args, {
+        usage: `Usage: gdh lsp ${command} [target]\nUsage: gdh lsp ${command} --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 input = {
+            targetPath,
+            status: context.status,
+            projectConfig: context.projectConfig,
+        };
+        const result = command === "check"
+            ? await checkManagedLsp(input)
+            : command === "stop"
+                ? await stopManagedLsp(input)
+                : command === "restart"
+                    ? await restartManagedLsp({ ...input, owner: "gdh lsp restart" })
+                    : command === "prune"
+                        ? await pruneManagedLsp(input)
+                        : await doctorManagedLsp(input);
+        io.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        return 0;
+    }
+    catch (error) {
+        io.stderr.write(`Failed to run lsp ${command} for "${targetPath}": ${formatCliError(error)}\n`);
+        return 1;
+    }
+}
+function describeLspLifecycleCommand(command) {
+    switch (command) {
+        case "check":
+            return "Check the persisted managed LSP instance without launching a new one.";
+        case "stop":
+            return "Stop the persisted GDH-managed LSP instance for this worktree.";
+        case "restart":
+            return "Stop and relaunch the managed LSP instance for this worktree.";
+        case "prune":
+            return "Remove stale managed LSP state without killing live unrelated processes.";
+        case "doctor":
+            return "Report lifecycle, transport, diagnostics, and cleanup guidance.";
+    }
+}
 async function runWarmupCommand(args, io) {
     if (args.includes("--help")) {
         io.stdout.write([
@@ -807,7 +865,12 @@ async function runWarmupCommand(args, io) {
     const dryRun = args.includes("--dry-run");
     const { targetPath, error: targetPathError } = parseOptionalPositionalTargetPath(args, {
         usage: "Usage: gdh warmup [target] [--dry-run]\n",
-        additionalOptionsWithValues: new Set(["--task-type", "--capability", "--repo-state", "--keyword"]),
+        additionalOptionsWithValues: new Set([
+            "--task-type",
+            "--capability",
+            "--repo-state",
+            "--keyword",
+        ]),
     });
     if (targetPathError !== null) {
         io.stderr.write(targetPathError);
@@ -1692,7 +1755,13 @@ async function runRecipeListCommand(args, io) {
     }
     const { targetPath, error: targetPathError } = parseOptionalPositionalTargetPath(args, {
         usage: "Usage: gdh run-config list [target]\n",
-        additionalOptionsWithValues: new Set(["--provider", "--param", "--feature", "--no-feature", "--env"]),
+        additionalOptionsWithValues: new Set([
+            "--provider",
+            "--param",
+            "--feature",
+            "--no-feature",
+            "--env",
+        ]),
     });
     if (targetPathError !== null) {
         io.stderr.write(targetPathError);
@@ -1929,7 +1998,13 @@ async function runScenarioListCommand(args, io) {
     }
     const { targetPath, error: targetPathError } = parseOptionalPositionalTargetPath(args, {
         usage: "Usage: gdh verification-scenario list [target]\n",
-        additionalOptionsWithValues: new Set(["--provider", "--param", "--feature", "--no-feature", "--env"]),
+        additionalOptionsWithValues: new Set([
+            "--provider",
+            "--param",
+            "--feature",
+            "--no-feature",
+            "--env",
+        ]),
     });
     if (targetPathError !== null) {
         io.stderr.write(targetPathError);
@@ -2506,7 +2581,8 @@ async function runVerifyRunCommand(args, io) {
             disabledFeatures: collectOptionValues(args, "--no-feature"),
             environment: collectAssignmentOptionValues(args, "--env"),
             workspaceMode: args.includes("--live-workspace") ? "live_workspace" : "isolated_copy",
-            screenshotCapture: args.includes("--rendered-screenshot") || readSingleOptionValue(args, "--provider") === "docker"
+            screenshotCapture: args.includes("--rendered-screenshot") ||
+                readSingleOptionValue(args, "--provider") === "docker"
                 ? "rendered"
                 : "never",
         });
@@ -2779,11 +2855,7 @@ async function runVerifyDriftCommand(args, io) {
         }
         const match = content.match(file.versionRegex ?? VERIFY_DRIFT_BAKED_VERSION_REGEX);
         const baked = match?.[1] ?? null;
-        const reason = baked === null
-            ? "no_baked_version"
-            : baked !== pinnedVersion
-                ? "version_mismatch"
-                : "ok";
+        const reason = baked === null ? "no_baked_version" : baked !== pinnedVersion ? "version_mismatch" : "ok";
         return {
             relativePath: file.relativePath,
             description: file.description,
@@ -3013,7 +3085,12 @@ async function runCacheInspectCommand(args, io) {
     }
     const { targetPath, error: targetPathError } = parseOptionalPositionalTargetPath(args, {
         usage: "Usage: gdh cache inspect [target]\n",
-        additionalOptionsWithValues: new Set(["--task-type", "--capability", "--repo-state", "--keyword"]),
+        additionalOptionsWithValues: new Set([
+            "--task-type",
+            "--capability",
+            "--repo-state",
+            "--keyword",
+        ]),
     });
     if (targetPathError !== null) {
         io.stderr.write(targetPathError);
@@ -3120,7 +3197,12 @@ async function runGuidanceResolveCommand(args, io) {
     }
     const { targetPath, error: targetPathError } = parseOptionalPositionalTargetPath(args, {
         usage: "Usage: gdh guidance resolve [target] [--task-type <type>] [--capability <id>] [--repo-state <state>] [--keyword <term>]\n",
-        additionalOptionsWithValues: new Set(["--task-type", "--capability", "--repo-state", "--keyword"]),
+        additionalOptionsWithValues: new Set([
+            "--task-type",
+            "--capability",
+            "--repo-state",
+            "--keyword",
+        ]),
     });
     if (targetPathError !== null) {
         io.stderr.write(targetPathError);
@@ -3872,7 +3954,7 @@ function renderHelp() {
         "  adapters install [target] [--dry-run] [--agent <name>] [--user] [--dev-repo <path>] [--integration-root <path>] Install or repair supported-agent reinforcement.",
         "  adapters gsd snapshot [target] [--files <path>] [--performed <kind>] Export a read-only GSD projection.",
         "  authoring check [target] Run the current authoring-check entrypoint.",
-        "  lsp status [target] Resolve the managed authoring.lsp lifecycle state.",
+        "  lsp <status|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.",
@@ -4063,11 +4145,15 @@ function buildGuidanceSnapshot(result) {
 }
 export async function recordSessionEvent(targetPath, input) {
     try {
+        const onboardedRoot = await resolveProjectRoot(targetPath);
+        if (onboardedRoot === null) {
+            return;
+        }
         const { commandStartedAtMs, ...eventInput } = input;
         const startedAt = typeof commandStartedAtMs === "number" && Number.isFinite(commandStartedAtMs)
             ? new Date(commandStartedAtMs).toISOString()
             : null;
-        await recordAuthoringSessionEvent(targetPath, {
+        await recordAuthoringSessionEvent(onboardedRoot, {
             sessionId: process.env["GDH_SESSION_ID"] ?? null,
             startedAt,
             ...eventInput,