@skillcap/gdh 0.19.5 → 0.20.0

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "0.19.5",
+  "version": "0.20.0",
   "installMode": "packaged_install"
 }

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -2088,6 +2088,137 @@
           }
         ]
       }
+    },
+    {
+      "version": "0.19.6",
+      "releaseTag": "v0.19.6",
+      "migrationStatus": "required",
+      "summary": "v0.19.6 standardizes shipped GDH agent skill output and adds release-preview guardrails for migration-sensitive generated surfaces. Existing targets need `gdh migrate --apply` because GDH_AGENT_CONTRACT_VERSION moves 4 -> 5.",
+      "releaseHighlights": {
+        "summary": "v0.19.6 makes shipped GDH agent skills more consistent and migration-aware. Status, scan, migrate, and update skills now tell agents to use stable section names, and update previews include an explicit changelog section. Release preview also now flags migration-sensitive managed output changes before release artifacts can pass.",
+        "operatorChanges": [
+          "**Agent responses are more consistent.** GDH-managed status, scan, migrate, and update skills now ask agents to use stable headings and compact sections across Claude, Codex, and Cursor.",
+          "**Update previews surface changelog context.** The update skill now distinguishes preview, changelog, migration work, approval, and result sections so agents present release notes consistently before apply.",
+          "**Migration-sensitive source changes are guarded.** Release preview now tracks generated `gdh-*` skill renderer changes and managed hook/statusline renderer changes as migration-review signals.",
+          "**Release and migration-verifier handoffs inspect migration signals.** Maintainer workflows now require agents to review `migrationSignals.surfaceVersionChanges` and `migrationSignals.generatorVersionIssues` before claiming migration proof is passable."
+        ]
+      },
+      "updateContract": {
+        "summary": "Managed targets need release-specific migration for v0.19.6 because the generated agent skill output changed and the managed agent contract surface moved to version 5. After self-update, run `gdh migrate --apply` so GDH refreshes managed skills and instruction surfaces.",
+        "steps": [
+          {
+            "id": "preview_agent_contract_migration",
+            "kind": "mechanical",
+            "summary": "Preview managed agent contract and skill refresh work.",
+            "detail": "Run `gdh migrate` to inspect the target's managed surface state before applying changes. The preview should show the agent contract or generated skill surfaces as needing refresh when they are still on the previous output.",
+            "commands": [
+              "gdh migrate"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "apply_agent_skill_refresh",
+            "kind": "mechanical",
+            "summary": "Refresh generated agent skills and instruction surfaces.",
+            "detail": "Run `gdh migrate --apply` so GDH re-bakes Claude, Codex, and Cursor managed skills with the current structured response guidance and refreshes the managed agent contract marker to version 5.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh adapters status",
+              "gdh verify drift"
+            ]
+          },
+          {
+            "id": "confirm_agent_response_sections",
+            "kind": "agent_reasoning",
+            "summary": "Confirm the refreshed skill output is the expected v0.19.6 behavior.",
+            "detail": "After migration, inspect status or adapter output when useful and confirm generated skills describe the stable report sections for status, scan, migrate, and update. Do not treat unrelated target drift as a v0.19.6 migration failure unless GDH structured status reports it.",
+            "commands": [
+              "gdh adapters status"
+            ],
+            "validationCommands": [
+              "gdh verify drift"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "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"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

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

@@ -8,7 +8,7 @@ import { readProjectConfig, readWorktreeState, resolveAuthoringStatus, resolvePi
 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";
@@ -255,6 +255,9 @@ export async function inspectProjectLifecycleCompatibility(targetPath) {
 export async function buildGdhStatusResult(targetPath) {
     const context = await buildAuthoringContext(targetPath);
     const projectLifecycle = await inspectProjectLifecycleCompatibility(targetPath);
+    const brokerInspection = await inspectRuntimeBridgeBroker({
+        targetPath: context.status.targetPath,
+    });
     const runtimeKnowledge = await inspectRuntimeKnowledgeSurface({
         targetPath: context.status.targetPath,
         runtimeKnowledgePath: context.projectConfig?.runtimeKnowledge.path ?? null,
@@ -268,10 +271,50 @@ 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);