@skillcap/gdh 0.19.6 → 0.21.0

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

@@ -5,15 +5,16 @@ 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, resolvePinnedVersion, resolveProjectRoot, resolveTargetGodotDocsVersion, restartManagedLsp, runAuthoringCheck, runImportRefresh, runTargetPrepare, runWarmup, stopManagedLsp, } from "@gdh/authoring";
+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 { 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, inspectRuntimeBridgeSurface, installRuntimeBridgeSurface, listRuntimeRecipes, removeRuntimeBridgeSurface, repairRuntimeBridgeSurface, runRuntimeRecipe, showRuntimeRecipe, } from "@gdh/runtime";
+import { checkRuntimeRecipe, createRuntimeBridgeManager, serveRuntimeBridgeBroker, inspectRuntimeBridgeSurface, installRuntimeBridgeSurface, listRuntimeRecipes, removeRuntimeBridgeSurface, repairRuntimeBridgeSurface, runRuntimeRecipe, 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 { migrateProjectLifecycleSurface } from "./migrate.js";
+import { runBridgeSessionCommand } from "./bridge-session.js";
 import { cleanupGdhMcpProcesses } from "./mcp-cleanup.js";
 import { presentPublicRuntimeTerms } from "./public-terms.js";
 import { runSelfUpdateCommand } from "./self-update.js";
@@ -57,6 +58,9 @@ export async function runCli(args, io = { stdout: process.stdout, stderr: proces
         io.stdout.write(`${JSON.stringify({ targetPath })}\n`);
         return 0;
     }
+    if (command === "__gdh-broker-serve") {
+        return runInternalBrokerServeCommand(rest, io);
+    }
     if (command === "version") {
         return runVersionCommand(rest, io);
     }
@@ -132,6 +136,39 @@ export async function runCli(args, io = { stdout: process.stdout, stderr: proces
     io.stderr.write(`Unknown command: ${command}\n\n${renderHelp()}`);
     return 1;
 }
+async function runInternalBrokerServeCommand(args, io) {
+    const targetPath = readSingleOptionValue(args, "--target");
+    const godotProjectRootPath = readSingleOptionValue(args, "--godot-project-root");
+    const stateRootPath = readSingleOptionValue(args, "--state-root");
+    const tokenFilePath = readSingleOptionValue(args, "--token-file");
+    const metadataPath = readSingleOptionValue(args, "--metadata-file");
+    const heartbeatPath = readSingleOptionValue(args, "--heartbeat-file");
+    if (targetPath === null ||
+        godotProjectRootPath === null ||
+        stateRootPath === null ||
+        tokenFilePath === null ||
+        metadataPath === null ||
+        heartbeatPath === null) {
+        io.stderr.write("Usage error: internal broker serve requires target, state, token, metadata, and heartbeat paths.\n");
+        return 1;
+    }
+    try {
+        await serveRuntimeBridgeBroker({
+            targetPath,
+            godotProjectRootPath,
+            stateRootPath,
+            tokenFilePath,
+            metadataPath,
+            heartbeatPath,
+            bridgeManager: createRuntimeBridgeManager(),
+        });
+        return 0;
+    }
+    catch (error) {
+        io.stderr.write(`Failed to serve the GDH runtime bridge broker: ${formatCliError(error)}\n`);
+        return 1;
+    }
+}
 export function writeJsonResult(io, value, options = {}) {
     const output = options.presentRuntimeTerms ? presentPublicRuntimeTerms(value) : value;
     io.stdout.write(`${JSON.stringify(output, null, 2)}\n`);
@@ -573,7 +610,7 @@ async function runDocsVersionCommand(args, io) {
     try {
         const context = await buildAuthoringContext(targetPath);
         const result = resolveTargetGodotDocsVersion({
-            targetPath,
+            targetPath: context.targetPath,
             inventory: context.inventory,
             projectConfig: context.projectConfig,
             requestedProjectPath,
@@ -628,7 +665,7 @@ async function runDocsSearchCommand(args, io) {
     try {
         const context = await buildAuthoringContext(targetPath);
         const docsVersion = resolveTargetGodotDocsVersion({
-            targetPath,
+            targetPath: context.targetPath,
             inventory: context.inventory,
             projectConfig: context.projectConfig,
             requestedProjectPath,
@@ -678,7 +715,7 @@ async function runDocsFetchCommand(args, io) {
     try {
         const context = await buildAuthoringContext(targetPath);
         const docsVersion = resolveTargetGodotDocsVersion({
-            targetPath,
+            targetPath: context.targetPath,
             inventory: context.inventory,
             projectConfig: context.projectConfig,
             requestedProjectPath,
@@ -718,14 +755,14 @@ async function runAuthoringCheckCommand(args, io) {
     try {
         const context = await buildAuthoringContext(targetPath);
         const result = await runAuthoringCheck({
-            targetPath,
+            targetPath: context.targetPath,
             status: context.status,
             projectConfig: context.projectConfig,
             mode,
             changedFiles,
             severityPolicy,
         });
-        await recordSessionEvent(targetPath, {
+        await recordSessionEvent(context.targetPath, {
             commandStartedAtMs,
             kind: "authoring_check",
             command: formatAuthoringCheckCommand({ mode, changedFiles, severityPolicy, outputFormat }),
@@ -929,7 +966,7 @@ async function runLspStatusCommand(args, io) {
     try {
         const context = await buildAuthoringContext(targetPath);
         const result = await getManagedLspStatus({
-            targetPath,
+            targetPath: context.targetPath,
             status: context.status,
             projectConfig: context.projectConfig,
             owner: "gdh lsp status",
@@ -964,7 +1001,7 @@ async function runLspLifecycleCommand(command, args, io) {
     try {
         const context = await buildAuthoringContext(targetPath);
         const input = {
-            targetPath,
+            targetPath: context.targetPath,
             status: context.status,
             projectConfig: context.projectConfig,
         };
@@ -1033,7 +1070,7 @@ async function runWarmupCommand(args, io) {
     try {
         const context = await buildAuthoringContext(targetPath);
         const result = await runWarmup({
-            targetPath,
+            targetPath: context.targetPath,
             status: context.status,
             projectConfig: context.projectConfig,
             dryRun,
@@ -1101,7 +1138,7 @@ async function runTargetPrepareCommand(args, io) {
     try {
         const context = await buildAuthoringContext(targetPath);
         const result = await runTargetPrepare({
-            targetPath,
+            targetPath: context.targetPath,
             status: context.status,
             projectConfig: context.projectConfig,
             sourceTargetPath,
@@ -1188,7 +1225,7 @@ async function runImportsRefreshCommand(args, io) {
     try {
         const context = await buildAuthoringContext(targetPath);
         const result = await runImportRefresh({
-            targetPath,
+            targetPath: context.targetPath,
             status: context.status,
             projectConfig: context.projectConfig,
             dryRun,
@@ -1653,6 +1690,7 @@ async function runBridgeCommand(args, io) {
             "",
             "Commands:",
             "  status [target]                           Inspect the managed runtime bridge lifecycle state for one target.",
+            "  session <command> [target]                Operate broker-owned runtime bridge sessions.",
             "  doctor [target]                           Alias for status with the same structured bridge-health report.",
             "  install [target] [--dry-run]              Install the managed runtime bridge addon and autoload surfaces.",
             "  repair [target] [--dry-run]               Rewrite drifted GDH-managed bridge files and autoload state.",
@@ -1663,6 +1701,9 @@ async function runBridgeCommand(args, io) {
     if (subcommand === "status") {
         return runBridgeStatusCommand(rest, io);
     }
+    if (subcommand === "session") {
+        return runBridgeSessionCommand(rest, io);
+    }
     if (subcommand === "doctor") {
         return runBridgeStatusCommand(rest, io);
     }
@@ -1679,6 +1720,7 @@ async function runBridgeCommand(args, io) {
         `Unknown bridge command: ${subcommand}`,
         "",
         "Usage: gdh bridge status [target]",
+        "Usage: gdh bridge session <command> [target]",
         "Usage: gdh bridge doctor [target]",
         "Usage: gdh bridge install [target] [--dry-run]",
         "Usage: gdh bridge repair [target] [--dry-run]",
@@ -2535,10 +2577,6 @@ async function runMcpInvokeCommand(args, io) {
         return 1;
     }
 }
-async function resolveEffectiveTargetPath(targetPath) {
-    const resolvedRoot = await resolveProjectRoot(targetPath);
-    return resolvedRoot ?? targetPath;
-}
 async function buildAuthoringContext(targetPath, io) {
     const effectiveTargetPath = await resolveEffectiveTargetPath(targetPath);
     const inventoryResult = await readInventoryCacheOrScan(effectiveTargetPath);
@@ -2555,6 +2593,7 @@ async function buildAuthoringContext(targetPath, io) {
         worktreeState,
     });
     return {
+        targetPath: effectiveTargetPath,
         inventory,
         projectConfig,
         worktreeState,
@@ -3141,7 +3180,7 @@ async function runCacheInspectCommand(args, io) {
     try {
         const context = await buildAuthoringContext(targetPath);
         const result = await inspectCacheState({
-            targetPath,
+            targetPath: context.targetPath,
             status: context.status,
             projectConfig: context.projectConfig,
         });
@@ -3181,11 +3220,11 @@ async function runGuidanceStatusCommand(args, io) {
         const context = await buildAuthoringContext(targetPath);
         const effectiveRepoState = deriveGuidanceRepoState(context);
         const [guidance, audit] = await Promise.all([
-            getGuidanceStatus(targetPath),
-            inspectGuidanceAudit(targetPath),
+            getGuidanceStatus(context.targetPath),
+            inspectGuidanceAudit(context.targetPath),
         ]);
         const result = {
-            targetPath,
+            targetPath: context.targetPath,
             projectConfigPresent: context.projectConfig !== null,
             authoringReadiness: context.status.readiness,
             effectiveRepoState,
@@ -3255,7 +3294,7 @@ async function runGuidanceResolveCommand(args, io) {
         const context = await buildAuthoringContext(targetPath);
         const derivedRepoState = deriveGuidanceRepoState(context);
         const repoStateArgs = collectOptionValues(args, "--repo-state");
-        const result = await resolveGuidanceQuery(targetPath, {
+        const result = await resolveGuidanceQuery(context.targetPath, {
             taskTypes: collectOptionValues(args, "--task-type"),
             capabilities: collectOptionValues(args, "--capability"),
             repoState: repoStateArgs.length > 0 ? repoStateArgs : derivedRepoState,
@@ -3449,7 +3488,7 @@ async function runCachePruneCommand(args, io) {
     try {
         const context = await buildAuthoringContext(targetPath);
         const result = await pruneCacheState({
-            targetPath,
+            targetPath: context.targetPath,
             status: context.status,
             projectConfig: context.projectConfig,
             scope,
@@ -3620,15 +3659,15 @@ async function executeAuthoringDogfoodTarget(input) {
             };
         }
         const context = await buildAuthoringContext(workingCopy.targetPath);
-        await recordAuthoringSessionEvent(workingCopy.targetPath, {
+        await recordAuthoringSessionEvent(context.targetPath, {
             sessionId,
             kind: "status",
             command: "gdh status",
             state: context.status.readiness === "undetected" ? "blocked" : "succeeded",
             summary: context.status.summary,
         });
-        const guidanceStatus = await getGuidanceStatus(workingCopy.targetPath);
-        await recordAuthoringSessionEvent(workingCopy.targetPath, {
+        const guidanceStatus = await getGuidanceStatus(context.targetPath);
+        await recordAuthoringSessionEvent(context.targetPath, {
             sessionId,
             kind: "guidance_status",
             command: "gdh guidance status",
@@ -3637,7 +3676,7 @@ async function executeAuthoringDogfoodTarget(input) {
         });
         const changedFiles = deriveDogfoodChangedFiles(onboarding.selectedProject);
         if (changedFiles.length === 0) {
-            const sessionInspection = await inspectAuthoringSessions(workingCopy.targetPath, {
+            const sessionInspection = await inspectAuthoringSessions(context.targetPath, {
                 sessionId,
             });
             return {
@@ -3655,13 +3694,13 @@ async function executeAuthoringDogfoodTarget(input) {
                 errorMessage: null,
             };
         }
-        const guidanceResolve = await resolveGuidanceQuery(workingCopy.targetPath, {
+        const guidanceResolve = await resolveGuidanceQuery(context.targetPath, {
             taskTypes: ["authoring"],
             capabilities: context.status.effectiveCapabilities,
             repoState: deriveGuidanceRepoState(context),
             keywords: [],
         });
-        await recordAuthoringSessionEvent(workingCopy.targetPath, {
+        await recordAuthoringSessionEvent(context.targetPath, {
             sessionId,
             kind: "guidance_resolve",
             command: "gdh guidance resolve",
@@ -3672,7 +3711,7 @@ async function executeAuthoringDogfoodTarget(input) {
             guidance: buildGuidanceSnapshot(guidanceResolve),
             changedFiles,
         });
-        const sessionInspection = await inspectAuthoringSessions(workingCopy.targetPath, {
+        const sessionInspection = await inspectAuthoringSessions(context.targetPath, {
             sessionId,
         });
         const state = isHealthyDogfoodTarget({
@@ -3773,7 +3812,7 @@ async function evaluateAuthoringSliceValidation(targetPath) {
             includeUserLocal: false,
         });
         const authoringCheck = await runAuthoringCheck({
-            targetPath: workingCopy.targetPath,
+            targetPath: context.targetPath,
             status: context.status,
             projectConfig: context.projectConfig,
         });
@@ -3951,6 +3990,7 @@ function renderHelp() {
         "  run-config check [target] <run-config-id> Evaluate run-configuration readiness.",
         "  run-config run [target] <run-config-id> Execute one run configuration.",
         "  bridge status [target] Inspect the managed runtime bridge lifecycle state.",
+        "  bridge session <command> [target] Operate broker-owned runtime bridge sessions.",
         "  bridge doctor [target] Alias for bridge status.",
         "  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.",