@skillcap/gdh 0.22.0 → 0.23.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_SKILL_RELATIVE_PATH, 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_CHECK_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_CHECK_SKILL_RELATIVE_PATH, CURSOR_MIGRATE_SKILL_RELATIVE_PATH, CURSOR_ONBOARD_SKILL_RELATIVE_PATH, CURSOR_PREPARE_SKILL_RELATIVE_PATH, CURSOR_SCAN_SKILL_RELATIVE_PATH, CURSOR_STATUS_SKILL_RELATIVE_PATH, createGsdSnapshot, getSupportedAgentAdaptersStatus, installSupportedAgentAdapters, } from "@gdh/adapters";
-import { checkManagedLsp, doctorManagedLsp, getManagedLspStatus, hasCompleteOnboardingSurface, inspectCacheState, pruneCacheState, pruneManagedLsp, readProjectConfig, readWorktreeState, 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, } 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";
@@ -507,16 +507,191 @@ async function runAuthoringCommand(args, io) {
             "Usage: gdh authoring <command> [target]",
             "",
             "Commands:",
-            "  check [target]  Run the current authoring-check entrypoint and print a structured result.",
+            "  check [target]        Run the current authoring-check entrypoint and print a structured result.",
+            "  diagnostics <command> Inspect current Godot authoring diagnostics snapshots.",
         ].join("\n") + "\n");
         return 0;
     }
     if (subcommand === "check") {
         return runAuthoringCheckCommand(rest, io);
     }
-    io.stderr.write(`Unknown authoring command: ${subcommand}\n\nUsage: gdh authoring check [target]\n`);
+    if (subcommand === "diagnostics") {
+        return runAuthoringDiagnosticsCommand(rest, io);
+    }
+    io.stderr.write(`Unknown authoring command: ${subcommand}\n\nUsage: gdh authoring <check|diagnostics> [target]\n`);
     return 1;
 }
+async function runAuthoringDiagnosticsCommand(args, io) {
+    const [subcommand, ...rest] = args;
+    if (!subcommand || subcommand === "--help" || subcommand === "help") {
+        io.stdout.write([
+            "Usage: gdh authoring diagnostics <command> [target]",
+            "",
+            "Inspect current Godot authoring diagnostics snapshots from the GDH diagnostics broker.",
+            "These commands report CURRENT diagnostics snapshots, not final validation evidence.",
+            "Use `gdh authoring check` for bounded validation evidence at task boundaries.",
+            "Use `gdh lsp status|doctor|restart|prune|stop` for LSP lifecycle management.",
+            "",
+            "Commands:",
+            "  status [target]                    Print broker health and snapshot freshness.",
+            "  current [target]                   Print current normalized diagnostics snapshot.",
+            "  refresh [target] [--changed <p>…]  Refresh diagnostics for changed files.",
+            "  doctor [target]                    Explain stale, missing, or unavailable states.",
+            "  prune [target]                     Remove stale broker metadata.",
+        ].join("\n") + "\n");
+        return 0;
+    }
+    if (subcommand === "status") {
+        return runAuthoringDiagnosticsSubcommand("status", rest, io);
+    }
+    if (subcommand === "current") {
+        return runAuthoringDiagnosticsSubcommand("current", rest, io);
+    }
+    if (subcommand === "refresh") {
+        return runAuthoringDiagnosticsRefreshCommand(rest, io);
+    }
+    if (subcommand === "doctor") {
+        return runAuthoringDiagnosticsSubcommand("doctor", rest, io);
+    }
+    if (subcommand === "prune") {
+        return runAuthoringDiagnosticsSubcommand("prune", rest, io);
+    }
+    io.stderr.write([
+        `Unknown authoring diagnostics command: ${subcommand}`,
+        "",
+        "Usage: gdh authoring diagnostics <status|current|refresh|doctor|prune> [target]",
+    ].join("\n") + "\n");
+    return 1;
+}
+async function runAuthoringDiagnosticsSubcommand(command, args, io) {
+    const helpText = {
+        status: [
+            "Usage: gdh authoring diagnostics status [target]",
+            "Usage: gdh authoring diagnostics status --target <path>",
+            "",
+            "Print diagnostics broker health, snapshot freshness, and scope summary as JSON.",
+            "Reports CURRENT broker state — not final validation evidence.",
+            "Use `gdh authoring check` for bounded validation evidence.",
+        ].join("\n"),
+        current: [
+            "Usage: gdh authoring diagnostics current [target]",
+            "Usage: gdh authoring diagnostics current --target <path>",
+            "",
+            "Print the current normalized diagnostics snapshot without triggering a refresh.",
+            "Reports CURRENT broker snapshot — not final validation evidence.",
+            "Use `gdh authoring diagnostics refresh` to update the snapshot after edits.",
+        ].join("\n"),
+        doctor: [
+            "Usage: gdh authoring diagnostics doctor [target]",
+            "Usage: gdh authoring diagnostics doctor --target <path>",
+            "",
+            "Explain stale, missing, incompatible, or unavailable diagnostics broker states.",
+            "Provides actionable recovery steps — does not recommend raw process killing.",
+        ].join("\n"),
+        prune: [
+            "Usage: gdh authoring diagnostics prune [target]",
+            "Usage: gdh authoring diagnostics prune --target <path>",
+            "",
+            "Remove stale diagnostics broker metadata under .gdh-state.",
+            "Only removes GDH-owned metadata — does not affect the managed LSP lifecycle.",
+        ].join("\n"),
+    };
+    if (args.includes("--help")) {
+        io.stdout.write(`${helpText[command]}\n`);
+        return 0;
+    }
+    const parsedTarget = parseSingleTargetPathArg(args, {
+        usage: `${helpText[command]}\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: context.targetPath,
+            status: context.status,
+            projectConfig: context.projectConfig,
+        };
+        if (command === "status") {
+            const result = await getAuthoringDiagnosticsStatus(input);
+            writeJsonResult(io, result);
+        }
+        else if (command === "current") {
+            const result = await getCurrentAuthoringDiagnostics(input);
+            writeJsonResult(io, result);
+        }
+        else if (command === "doctor") {
+            const result = await doctorAuthoringDiagnostics(input);
+            writeJsonResult(io, result);
+        }
+        else {
+            const result = await pruneAuthoringDiagnostics(input);
+            writeJsonResult(io, result);
+        }
+        return 0;
+    }
+    catch (error) {
+        io.stderr.write(`Failed to run authoring diagnostics ${command} for "${targetPath}": ${formatCliError(error)}\n`);
+        return 1;
+    }
+}
+async function runAuthoringDiagnosticsRefreshCommand(args, io) {
+    const usage = [
+        "Usage: gdh authoring diagnostics refresh [target] [--changed <path>...]",
+        "Usage: gdh authoring diagnostics refresh --target <path> [--changed <path>...]",
+        "",
+        "Open or refresh specified files through the managed LSP and persist the diagnostics snapshot.",
+        "Omitting --changed refreshes all project GDScript files.",
+        "Reports CURRENT broker snapshot after refresh — not final validation evidence.",
+        "Use `gdh authoring check --mode final` for bounded handoff evidence.",
+    ].join("\n");
+    if (args.includes("--help")) {
+        io.stdout.write(`${usage}\n`);
+        return 0;
+    }
+    // Collect --changed values (may be repeated)
+    const changedFiles = [];
+    const filteredArgs = [];
+    let i = 0;
+    while (i < args.length) {
+        if (args[i] === "--changed" && i + 1 < args.length) {
+            changedFiles.push(args[i + 1]);
+            i += 2;
+        }
+        else {
+            filteredArgs.push(args[i]);
+            i += 1;
+        }
+    }
+    const parsedTarget = parseSingleTargetPathArg(filteredArgs, {
+        usage: `${usage}\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 refreshAuthoringDiagnostics({
+            targetPath: context.targetPath,
+            status: context.status,
+            projectConfig: context.projectConfig,
+            ...(changedFiles.length > 0 && { changedFiles }),
+        });
+        writeJsonResult(io, result);
+        return 0;
+    }
+    catch (error) {
+        io.stderr.write(`Failed to refresh authoring diagnostics for "${targetPath}": ${formatCliError(error)}\n`);
+        return 1;
+    }
+}
 async function runLspCommand(args, io) {
     const [subcommand, ...rest] = args;
     if (!subcommand || subcommand === "--help" || subcommand === "help") {
@@ -3985,6 +4160,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>] 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.",
         "  warmup [target] [--dry-run] Inspect or apply authoring worktree warmup.",
         "  target prepare [target] [--source-target <path>] [--dry-run] Prepare target-local generated/import state.",