@skillcap/gdh 0.26.3 → 0.26.5

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

@@ -5,17 +5,17 @@ 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, warmupManagedLsp, } from "@gdh/authoring";
+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 { 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";
 import { inspectAuthoringEffectiveness, inspectAuthoringSessions, inspectGuidanceAudit, recordAuthoringSessionEvent, } from "@gdh/observability";
-import { checkRuntimeRecipe, createRuntimeBridgeManager, serveRuntimeBridgeBroker, inspectRuntimeBridgeSurface, installRuntimeBridgeSurface, listRuntimeRecipes, removeRuntimeBridgeSurface, repairRuntimeBridgeSurface, runRuntimeRecipe, showRuntimeRecipe, } from "@gdh/runtime";
+import { checkRuntimeRecipe, createRuntimeBridgeManager, inspectRuntimeBridgeSurface, installRuntimeBridgeSurface, listRuntimeRecipes, removeRuntimeBridgeSurface, repairRuntimeBridgeSurface, runRuntimeRecipe, serveRuntimeBridgeBroker, showRuntimeRecipe, } from "@gdh/runtime";
 import { applyRepairableOnboardingWrites, onboardGodotProject, persistInventoryForTarget, readInventoryCacheOrScan, scanGodotProjectInventory, } from "@gdh/scan";
 import { exerciseRuntimeCorpusEntry, inspectRuntimeCorpusStatus, inspectRuntimeVerificationBundleState, inspectRuntimeVerificationReadiness, listRuntimeScenarios, materializeRuntimeCorpusEntry, recordRuntimeCorpusValidation, runRuntimeVerificationScenario, showRuntimeScenario, } from "@gdh/verify";
-import { clearEnvelope, clearMigrationBackups, migrateProjectLifecycleSurface, recordEnvelopeResult, } from "./migrate.js";
 import { runBridgeSessionCommand } from "./bridge-session.js";
 import { cleanupGdhMcpProcesses } from "./mcp-cleanup.js";
+import { clearEnvelope, clearMigrationBackups, migrateProjectLifecycleSurface, recordEnvelopeResult, } from "./migrate.js";
 import { presentPublicRuntimeTerms } from "./public-terms.js";
 import { runSelfUpdateCommand as runSelfUpdateCommandImpl } from "./self-update.js";
 /**
@@ -183,9 +183,26 @@ async function runInternalBrokerServeCommand(args, io) {
     }
 }
 export function writeJsonResult(io, value, options = {}) {
-    const output = options.presentRuntimeTerms ? presentPublicRuntimeTerms(value) : value;
+    const runtimeOutput = options.presentRuntimeTerms ? presentPublicRuntimeTerms(value) : value;
+    const output = options.omitRawPayloads ? omitRawPayloads(runtimeOutput) : runtimeOutput;
     io.stdout.write(`${JSON.stringify(output, null, 2)}\n`);
 }
+function omitRawPayloads(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => omitRawPayloads(entry));
+    }
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    const output = {};
+    for (const [key, child] of Object.entries(value)) {
+        if (key === "rawPayload") {
+            continue;
+        }
+        output[key] = omitRawPayloads(child);
+    }
+    return output;
+}
 async function runScanCommand(args, io) {
     if (args.includes("--help")) {
         io.stdout.write([
@@ -466,16 +483,17 @@ async function runOnboardCommand(args, io) {
 async function runStatusCommand(args, io) {
     if (args.includes("--help")) {
         io.stdout.write([
-            "Usage: gdh status [target]",
-            "Usage: gdh status --target <path>",
+            "Usage: gdh status [target] [--json]",
+            "Usage: gdh status --target <path> [--json]",
             "",
             "Report explicit GDH readiness and capability availability for a target as JSON.",
         ].join("\n") + "\n");
         return 0;
     }
     const parsedTarget = parseSingleTargetPathArg(args, {
-        usage: "Usage: gdh status [target]\nUsage: gdh status --target <path>\n",
+        usage: "Usage: gdh status [target] [--json]\nUsage: gdh status --target <path> [--json]\n",
         allowTargetOption: true,
+        booleanOptions: ["--json"],
     });
     if (parsedTarget.error !== null) {
         io.stderr.write(parsedTarget.error);
@@ -666,20 +684,8 @@ async function runAuthoringDiagnosticsRefreshCommand(args, io) {
         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 changedFiles = collectVariadicOptionValues(args, "--changed");
+    const filteredArgs = stripVariadicOptions(args, new Set(["--changed"]));
     const parsedTarget = parseSingleTargetPathArg(filteredArgs, {
         usage: `${usage}\n`,
         allowTargetOption: true,
@@ -926,12 +932,12 @@ async function runDocsFetchCommand(args, io) {
 }
 async function runAuthoringCheckCommand(args, io) {
     const usage = [
-        "Usage: gdh authoring check [target] [--mode final|post-edit] [--changed <path>...] [--severity-policy errors|all] [--format json|compact]",
-        "Usage: gdh authoring check --target <path> [--mode final|post-edit] [--changed <path>...] [--severity-policy errors|all] [--format json|compact]",
+        "Usage: gdh authoring check [target] [--mode final|post-edit] [--changed <path>...] [--severity-policy errors|all] [--format json|compact] [--json]",
+        "Usage: gdh authoring check --target <path> [--mode final|post-edit] [--changed <path>...] [--severity-policy errors|all] [--format json|compact] [--json]",
         "",
         "Run GDH authoring validation and print structured JSON by default.",
         "Use --mode post-edit with --changed for fast scoped feedback after edits.",
-        "Use --mode final before claiming code-validity for task completion.",
+        "Use --mode final without --changed before claiming code-validity for task completion.",
     ].join("\n");
     if (args.includes("--help")) {
         io.stdout.write(`${usage}\n`);
@@ -974,7 +980,7 @@ async function runAuthoringCheckCommand(args, io) {
             io.stdout.write(formatCompactAuthoringCheckResult(result));
         }
         else {
-            writeJsonResult(io, result, { presentRuntimeTerms: true });
+            writeJsonResult(io, result, { presentRuntimeTerms: true, omitRawPayloads: true });
         }
         return 0;
     }
@@ -993,9 +999,11 @@ async function runAuthoringCheckCommand(args, io) {
 }
 function parseAuthoringCheckArgs(args, usage) {
     const optionNames = new Set(["--target", "--mode", "--changed", "--severity-policy", "--format"]);
+    const variadicOptionNames = new Set(["--changed"]);
     const unsupportedOptionsError = findUnsupportedOptionsError(args, {
         usage,
         optionsWithValues: [...optionNames],
+        booleanOptions: ["--json"],
     });
     if (unsupportedOptionsError !== null) {
         return {
@@ -1020,7 +1028,7 @@ function parseAuthoringCheckArgs(args, usage) {
         }
     }
     const targetOptionValue = readSingleOptionValue(args, "--target");
-    const positionalArgs = extractPositionalArgs(args, optionNames);
+    const positionalArgs = extractPositionalArgs(args, optionNames, variadicOptionNames);
     if (positionalArgs.length > 1) {
         return {
             targetPath: path.resolve("."),
@@ -1053,6 +1061,20 @@ function parseAuthoringCheckArgs(args, usage) {
             error: `Usage error: --mode must be final or post-edit.\n${usage}`,
         };
     }
+    const changedFiles = collectVariadicOptionValues(args, "--changed");
+    if (mode === "final" && changedFiles.length > 0) {
+        return {
+            targetPath: path.resolve("."),
+            mode: "final",
+            changedFiles: [],
+            severityPolicy: "errors",
+            outputFormat: "json",
+            error: "Usage error: --changed is only scoped in --mode post-edit. " +
+                "Run `gdh authoring check --mode final` without --changed for full handoff evidence, " +
+                "or `gdh authoring check --mode post-edit --changed <path>...` for changed-file feedback.\n" +
+                usage,
+        };
+    }
     const severityPolicyValue = readSingleOptionValue(args, "--severity-policy") ?? "errors";
     const severityPolicy = severityPolicyValue === "errors" || severityPolicyValue === "all" ? severityPolicyValue : null;
     if (severityPolicy === null) {
@@ -1065,7 +1087,19 @@ function parseAuthoringCheckArgs(args, usage) {
             error: `Usage error: --severity-policy must be errors or all.\n${usage}`,
         };
     }
-    const outputFormatValue = readSingleOptionValue(args, "--format") ?? "json";
+    if (args.includes("--json") && readSingleOptionValue(args, "--format") === "compact") {
+        return {
+            targetPath: path.resolve("."),
+            mode: "final",
+            changedFiles: [],
+            severityPolicy: "errors",
+            outputFormat: "json",
+            error: `Usage error: choose either --json or --format compact.\n${usage}`,
+        };
+    }
+    const outputFormatValue = args.includes("--json")
+        ? "json"
+        : (readSingleOptionValue(args, "--format") ?? "json");
     const outputFormat = outputFormatValue === "json" || outputFormatValue === "compact" ? outputFormatValue : null;
     if (outputFormat === null) {
         return {
@@ -1080,7 +1114,7 @@ function parseAuthoringCheckArgs(args, usage) {
     return {
         targetPath: path.resolve(targetOptionValue ?? positionalArgs[0] ?? "."),
         mode,
-        changedFiles: collectOptionValues(args, "--changed"),
+        changedFiles,
         severityPolicy,
         outputFormat,
         error: null,
@@ -1134,11 +1168,7 @@ function formatCompactAuthoringCheckResult(result) {
     // 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"
-            ? "pending"
-            : "fresh";
+    const statusToken = summary.state === "blocked" ? "failed" : summary.state === "unconfirmed" ? "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(", ")}`);
@@ -1267,7 +1297,7 @@ async function runLspLifecycleCommand(command, args, io) {
                     : command === "prune"
                         ? await pruneManagedLsp(input)
                         : await doctorManagedLsp(input);
-        io.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        writeJsonResult(io, result, { omitRawPayloads: command === "stop" });
         return 0;
     }
     catch (error) {
@@ -2128,7 +2158,7 @@ async function runMigrationRecordEnvelopeResultCommand(args, io) {
             "Record a Phase 73 envelope output_contract block. Validates against the",
             "GdhMigrationEnvelopeOutput typed union (apply / abort / needs_clarification);",
             "appends to migration.json.envelopes[<slug>] and migration.json.envelopes[<slug>].attempts[].",
-            'Does NOT advance the chain — re-run `gdh self-update` after recording.',
+            "Does NOT advance the chain — re-run `gdh self-update` after recording.",
             "",
             'Exits 0 on { state: "recorded" }, 1 on { state: "blocked" }.',
         ].join("\n") + "\n");
@@ -4540,6 +4570,48 @@ function collectOptionValues(args, optionName) {
     }
     return values;
 }
+function collectVariadicOptionValues(args, optionName) {
+    const values = [];
+    for (let index = 0; index < args.length; index += 1) {
+        if (args[index] !== optionName) {
+            continue;
+        }
+        index += 1;
+        while (index < args.length) {
+            const value = args[index];
+            if (!value || value.startsWith("--")) {
+                index -= 1;
+                break;
+            }
+            values.push(value);
+            index += 1;
+        }
+    }
+    return values;
+}
+function stripVariadicOptions(args, variadicOptions) {
+    const filteredArgs = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!arg) {
+            continue;
+        }
+        if (!variadicOptions.has(arg)) {
+            filteredArgs.push(arg);
+            continue;
+        }
+        index += 1;
+        while (index < args.length) {
+            const value = args[index];
+            if (!value || value.startsWith("--")) {
+                index -= 1;
+                break;
+            }
+            index += 1;
+        }
+    }
+    return filteredArgs;
+}
 function collectAssignmentOptionValues(args, optionName) {
     const assignments = {};
     for (const value of collectOptionValues(args, optionName)) {
@@ -4585,6 +4657,7 @@ export function parseSingleTargetPathArg(args, options) {
     const unsupportedOptionsError = findUnsupportedOptionsError(args, {
         usage: options.usage,
         optionsWithValues: allowTargetOption ? ["--target"] : [],
+        booleanOptions: options.booleanOptions ?? [],
     });
     if (unsupportedOptionsError !== null) {
         return {
@@ -4719,7 +4792,7 @@ function deriveGuidanceRepoState(context) {
 function extractRecipePositionalArgs(args) {
     return extractPositionalArgs(args, new Set(["--provider", "--param", "--feature", "--no-feature", "--env"]));
 }
-export function extractPositionalArgs(args, optionsWithValues) {
+export function extractPositionalArgs(args, optionsWithValues, variadicOptionsWithValues = new Set()) {
     const positionalArgs = [];
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
@@ -4727,6 +4800,16 @@ export function extractPositionalArgs(args, optionsWithValues) {
             continue;
         }
         if (optionsWithValues.has(arg)) {
+            if (variadicOptionsWithValues.has(arg)) {
+                while (index + 1 < args.length) {
+                    const value = args[index + 1];
+                    if (!value || value.startsWith("--")) {
+                        break;
+                    }
+                    index += 1;
+                }
+                continue;
+            }
             index += 1;
             continue;
         }