@skillcap/gdh 0.19.6 → 0.21.0

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "0.19.6",
+  "version": "0.21.0",
   "installMode": "packaged_install"
 }

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -2146,6 +2146,153 @@
           }
         ]
       }
+    },
+    {
+      "version": "0.20.0",
+      "releaseTag": "v0.20.0",
+      "migrationStatus": "required",
+      "summary": "v0.20.0 moves bridge-session ownership to host-side broker infrastructure and refreshes generated agent guidance for broker recovery. Existing managed targets need `gdh migrate --apply` because GDH_AGENT_CONTRACT_VERSION moves 5 -> 6 and GDH_GUIDANCE_UNIT_VERSION moves 13 -> 14.",
+      "releaseHighlights": {
+        "summary": "v0.20.0 moves runtime bridge-session ownership into target-local host-side broker infrastructure. CLI and MCP clients can reconnect to the same GDH-owned bridge session after the original client process exits, while stale broker state is reported through status, doctor, and prune guidance.",
+        "operatorChanges": [
+          "**Bridge sessions are broker-owned.** GDH bridge-session commands and MCP bridge tools now route through the local broker so a fresh CLI or MCP client can recover a healthy broker-owned session.",
+          "**Broker cleanup is explicit.** `gdh status`, `gdh bridge session doctor`, and `gdh bridge session prune --stale` distinguish healthy, stale, and pre-broker session state without asking agents to manually kill editor or Godot processes.",
+          "**Generated guidance explains the transition.** Agent skills and authoring guidance now describe pre-broker active session limits, stale old-version broker metadata, and when project-side bridge repair is or is not needed.",
+          "**Release gates prove broker portability.** Public-release checks run broker platform and MCP/CLI recovery tests when the release migration manifest includes `broker_transition`."
+        ]
+      },
+      "updateContract": {
+        "summary": "Managed targets need release-specific migration for v0.20.0 because generated agent skill and guidance surfaces changed for broker recovery. After self-update, run `gdh migrate --apply`, then use status and bridge-session doctor output to classify broker state.",
+        "steps": [
+          {
+            "id": "self_update_broker_package",
+            "kind": "mechanical",
+            "summary": "Install the broker-capable GDH package.",
+            "detail": "Run the normal GDH self-update or package update path. The broker starts on demand from GDH bridge-session clients; users do not start a separate MCP or broker service by hand.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "refresh_generated_guidance",
+            "kind": "mechanical",
+            "summary": "Re-bake generated agent skills and authoring guidance.",
+            "detail": "Run `gdh migrate --apply` so managed agent contract version 6 and guidance unit version 14 are written to the target. This refreshes broker recovery, stale-MCP recovery, prune, and no-unnecessary-bridge-repair wording.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh adapters status",
+              "gdh verify drift"
+            ]
+          },
+          {
+            "id": "classify_bridge_session_state",
+            "kind": "agent_reasoning",
+            "summary": "Distinguish healthy broker state from stale or pre-broker state.",
+            "detail": "Use `gdh bridge session doctor` and `gdh bridge session list` to identify healthy broker-owned sessions, stale old-version broker metadata, and pre-broker active bridge sessions. Pre-broker active bridge sessions are not recoverable through broker clients after update.",
+            "commands": [
+              "gdh bridge session doctor",
+              "gdh bridge session list"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh bridge session doctor"
+            ]
+          },
+          {
+            "id": "prune_stale_broker_metadata",
+            "kind": "mechanical",
+            "summary": "Clean only stale GDH-owned broker metadata.",
+            "detail": "Run prune only when doctor reports stale GDH broker metadata. Do not manually kill editor, Godot, or unrelated user processes. Host-side broker recovery does not require `gdh bridge repair`; repair is only for managed Godot addon drift.",
+            "commands": [
+              "gdh bridge session prune --stale"
+            ],
+            "validationCommands": [
+              "gdh bridge session doctor",
+              "gdh status"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.21.0",
+      "releaseTag": "v0.21.0",
+      "migrationStatus": "required",
+      "summary": "v0.21.0 adds global machine-local Godot editor discovery guidance and hardens nested monorepo authoring target canonicalization. Existing managed targets need `gdh migrate --apply` because GDH_AGENT_CONTRACT_VERSION moves 6 -> 7 and GDH_GUIDANCE_UNIT_VERSION moves 14 -> 15.",
+      "releaseHighlights": {
+        "summary": "v0.21.0 improves authoring readiness in real monorepos. GDH can now reuse a machine-wide Godot editor path from `~/.gdh/config.json`, check safe common editor locations before asking for manual setup, and consistently canonicalize nested Godot project inputs back to the onboarded GDH integration root before running authoring validators.",
+        "operatorChanges": [
+          "**Global Godot editor discovery.** Authoring checks, target preparation, and onboarding can resolve the editor path from `GDH_GODOT_EDITOR_BIN`, target-local hints, global `~/.gdh/config.json`, and safe common install locations.",
+          "**Better setup guidance for machine-local paths.** Generated guidance and agent skills now tell agents what GDH already checked before asking for a Godot binary path, and prefer a reusable global config when the path should apply across projects.",
+          "**Nested monorepo authoring checks use the integration root.** Passing a nested primary Godot project path such as `apps/game` no longer causes validators to append `primary_godot_project_path` twice.",
+          "**Release proof covers the nested target regression.** The regression suite now checks `gdh authoring check --target <nested-primary-project>` against a brownfield monorepo fixture."
+        ]
+      },
+      "updateContract": {
+        "summary": "Managed targets need release-specific migration for v0.21.0 because generated agent skill and guidance surfaces changed for Godot editor discovery and nested target handling. After self-update, run `gdh migrate --apply`, then validate status and drift.",
+        "steps": [
+          {
+            "id": "self_update_authoring_package",
+            "kind": "mechanical",
+            "summary": "Install the v0.21.0 GDH package.",
+            "detail": "Run the normal GDH self-update or package update path. This updates CLI behavior for global Godot editor discovery and nested target canonicalization.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "refresh_generated_authoring_guidance",
+            "kind": "mechanical",
+            "summary": "Re-bake generated agent skills and authoring guidance.",
+            "detail": "Run `gdh migrate --apply` so managed agent contract version 7 and guidance unit version 15 are written to the target. This refreshes Godot editor discovery wording and nested-target-safe authoring guidance.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh adapters status",
+              "gdh verify drift"
+            ]
+          },
+          {
+            "id": "classify_godot_editor_path_state",
+            "kind": "agent_reasoning",
+            "summary": "Classify machine-local Godot editor path state from structured GDH output.",
+            "detail": "If GDH still reports `godot_editor_not_configured`, explain that environment, target-local hints, global config, and safe common locations were checked. Ask for a local path only after those fail, and prefer global `~/.gdh/config.json` when the path should apply across projects.",
+            "commands": [
+              "gdh status",
+              "gdh target prepare --dry-run"
+            ],
+            "validationCommands": [
+              "gdh authoring check --mode final",
+              "gdh target prepare --dry-run"
+            ]
+          },
+          {
+            "id": "validate_nested_monorepo_target",
+            "kind": "agent_reasoning",
+            "summary": "Confirm nested monorepo targets are invoked from the onboarded integration root.",
+            "detail": "For monorepos whose `.gdh/project.yaml` lives at the repository root and `primary_godot_project_path` points at a nested project, use the repository root as the canonical GDH target. GDH now also canonicalizes nested inputs defensively before authoring validators run.",
+            "commands": [
+              "gdh status",
+              "gdh authoring check --mode final"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh authoring check --mode final"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

package/node_modules/@gdh/adapters/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

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

@@ -4,11 +4,11 @@ import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { promisify } from "node:util";
-import { readProjectConfig, readWorktreeState, resolveAuthoringStatus, resolvePinnedVersion, resolvePinnedVersionOrNull, resolveProjectRoot, } from "@gdh/authoring";
+import { readProjectConfig, readWorktreeState, resolveAuthoringStatus, resolveEffectiveTargetPath, resolvePinnedVersion, resolvePinnedVersionOrNull, resolveProjectRoot, } from "@gdh/authoring";
 import { assertProjectLifecycleCompatibilityInvariant, definePackageBoundary, GDH_AGENT_CONTRACT_VERSION, GDH_CURSOR_RULE_VERSION, GDH_GUIDANCE_INDEX_VERSION, GDH_GUIDANCE_UNIT_VERSION, GDH_PROJECT_CONFIG_VERSION, GDH_RECIPE_SCHEMA_VERSION, GDH_RULES_SCHEMA_VERSION, GDH_SCENARIO_SCHEMA_VERSION, resolveConfiguredGodotEditorBin, resolveCurrentGdhInstall, resolveGdhProductMetadata, } from "@gdh/core";
 import { createDefaultGuidanceUnits, createDefaultRulesDocument, getGuidanceStatus, readRulesDocument, renderRulesYaml, resolveGuidanceQuery, resolveRecoveryHints, } from "@gdh/docs";
 import { inspectGuidanceAudit } from "@gdh/observability";
-import { inspectRuntimeBridgeSurface, inspectRuntimeKnowledgeSurface } from "@gdh/runtime";
+import { inspectRuntimeBridgeBroker, inspectRuntimeBridgeSurface, inspectRuntimeKnowledgeSurface, } from "@gdh/runtime";
 import { readInventoryCacheOrScan } from "@gdh/scan";
 import { CLAUDE_SETTINGS_RELATIVE_PATH, patchClaudeSettingsForGdhAuthoringHooks, patchClaudeSettingsForGdhSessionStart, patchClaudeSettingsForGdhStatusline, } from "./claude-settings-patch.js";
 import { CLAUDE_AUTHORING_HOOK_RELATIVE_PATH, CODEX_AUTHORING_HOOK_COMMAND, CODEX_AUTHORING_HOOK_RELATIVE_PATH, renderGdhAuthoringHook, } from "./authoring-hook-render.js";
@@ -254,7 +254,10 @@ export async function inspectProjectLifecycleCompatibility(targetPath) {
 }
 export async function buildGdhStatusResult(targetPath) {
     const context = await buildAuthoringContext(targetPath);
-    const projectLifecycle = await inspectProjectLifecycleCompatibility(targetPath);
+    const projectLifecycle = await inspectProjectLifecycleCompatibility(context.targetPath);
+    const brokerInspection = await inspectRuntimeBridgeBroker({
+        targetPath: context.status.targetPath,
+    });
     const runtimeKnowledge = await inspectRuntimeKnowledgeSurface({
         targetPath: context.status.targetPath,
         runtimeKnowledgePath: context.projectConfig?.runtimeKnowledge.path ?? null,
@@ -268,18 +271,58 @@ export async function buildGdhStatusResult(targetPath) {
         detectedProjects,
         product: resolveGdhProductMetadata(),
         projectLifecycle,
+        runtimeBridgeBroker: summarizeRuntimeBridgeBrokerTransition(brokerInspection.broker),
         runtimeKnowledge,
         recoveryHints,
     };
 }
+function summarizeRuntimeBridgeBrokerTransition(broker) {
+    const state = broker.lifecycle === "ready"
+        ? "supported"
+        : broker.lifecycle === "missing"
+            ? "missing"
+            : broker.lifecycle === "stale"
+                ? "stale"
+                : broker.lifecycle === "incompatible"
+                    ? "incompatible"
+                    : "unavailable";
+    return {
+        state,
+        summary: summarizeRuntimeBridgeBrokerLifecycleForStatus(broker.lifecycle),
+        broker,
+        recoveryCommand: ["gdh", "bridge", "session", "doctor"],
+        cleanupCommand: ["gdh", "bridge", "session", "prune"],
+        notes: [
+            "Post-broker bridge sessions are broker-owned and reconnectable through CLI or MCP clients.",
+            "Pre-broker active bridge sessions lived in MCP process memory and cannot be recovered after update or MCP restart.",
+            "Host-side broker support does not require `gdh bridge repair` unless GDH reports runtime bridge surface drift separately.",
+            "Broker metadata and token files live under `.gdh-state/` and must stay untracked.",
+        ],
+    };
+}
+function summarizeRuntimeBridgeBrokerLifecycleForStatus(lifecycle) {
+    if (lifecycle === "ready") {
+        return "Runtime bridge broker is ready for reconnectable CLI/MCP bridge sessions.";
+    }
+    if (lifecycle === "missing") {
+        return "Runtime bridge broker support is available; no broker is running for this target yet.";
+    }
+    if (lifecycle === "stale") {
+        return "Runtime bridge broker metadata is stale; run `gdh bridge session prune` for safe GDH-owned cleanup.";
+    }
+    if (lifecycle === "incompatible") {
+        return "Runtime bridge broker metadata belongs to an incompatible target, protocol, or GDH version.";
+    }
+    return "Runtime bridge broker state is unavailable; inspect with `gdh bridge session doctor`.";
+}
 export async function createGsdSnapshot(targetPath, options = {}) {
     const context = await buildAuthoringContext(targetPath);
     const effectiveRepoState = deriveRepoState(context);
     const files = normalizeChangedFiles(options.files ?? []);
-    const guidance = await getGuidanceStatus(targetPath);
+    const guidance = await getGuidanceStatus(context.targetPath);
     const [audit, guidanceResolve] = await Promise.all([
-        inspectGuidanceAudit(targetPath),
-        resolveGuidanceQuery(targetPath, {
+        inspectGuidanceAudit(context.targetPath),
+        resolveGuidanceQuery(context.targetPath, {
             taskTypes: ["authoring"],
             capabilities: context.status.effectiveCapabilities,
             repoState: effectiveRepoState,
@@ -287,7 +330,7 @@ export async function createGsdSnapshot(targetPath, options = {}) {
         }),
     ]);
     const guidanceStatus = {
-        targetPath,
+        targetPath: context.targetPath,
         projectConfigPresent: context.projectConfig !== null,
         authoringReadiness: context.status.readiness,
         effectiveRepoState,
@@ -295,7 +338,7 @@ export async function createGsdSnapshot(targetPath, options = {}) {
         audit,
     };
     return {
-        targetPath,
+        targetPath: context.targetPath,
         adapter: {
             adapter: "gsd",
             enabledByDefault: false,
@@ -3036,8 +3079,7 @@ function dedupe(values) {
     return [...new Set(values)];
 }
 async function buildAuthoringContext(targetPath) {
-    const resolvedRoot = await resolveProjectRoot(targetPath);
-    const effectiveTargetPath = resolvedRoot ?? targetPath;
+    const effectiveTargetPath = await resolveEffectiveTargetPath(targetPath);
     const inventoryResult = await readInventoryCacheOrScan(effectiveTargetPath);
     const inventory = inventoryResult.inventory;
     const projectConfig = await readProjectConfig(effectiveTargetPath);
@@ -3049,6 +3091,7 @@ async function buildAuthoringContext(targetPath) {
         worktreeState,
     });
     return {
+        targetPath: effectiveTargetPath,
         inventory,
         projectConfig,
         worktreeState,