@skillcap/gdh 0.22.0 → 0.23.0

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "installMode": "packaged_install"
 }

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -2427,6 +2427,71 @@
           }
         ]
       }
+    },
+    {
+      "version": "0.23.0",
+      "releaseTag": "v0.23.0",
+      "migrationStatus": "required",
+      "summary": "v0.23.0 ships the persistent diagnostics broker for agent-visible Godot LSP feedback. Existing managed targets need `gdh migrate --apply` because GDH_GUIDANCE_UNIT_VERSION moves 16 -> 17 (authoring guidance now teaches the diagnostics broker workflow) and GDH_UPDATE_HOOK_VERSION moves 4 -> 5 (managed post-edit hooks now refresh the broker before the authoring check).",
+      "releaseHighlights": {
+        "summary": "v0.23.0 ships a persistent diagnostics broker for GDH-managed Godot targets. A target/worktree-local broker keeps a live Godot LSP client connected, maintains the current normalized diagnostics snapshot under `.gdh-state`, and exposes that snapshot to CLI, MCP, post-edit hooks, and generated agent guidance. Broker state is local-only, loopback-bound, and token-protected. `gdh authoring check --mode post-edit|final` remains the explicit validation/evidence path with broker fast-path and direct LSP/static fallback.",
+        "operatorChanges": [
+          "**New `gdh authoring diagnostics` CLI surface.** `status`, `current`, `refresh`, `doctor`, and `prune` operations let agents inspect current Godot LSP problems without re-running ad hoc authoring checks. `prune` is intentionally CLI-only and not exposed via MCP.",
+          "**New MCP `authoring.diagnostics` tools.** MCP exposes `status`, `current`, `refresh`, and `doctor` parity for the same broker surface.",
+          "**Post-edit hooks refresh the broker before authoring check.** Managed Codex and Claude post-edit hooks now call `gdh authoring diagnostics refresh --target <root> --changed <path>` before the existing `gdh authoring check --mode post-edit` call. Broker refresh failure is non-fatal; the authoring check falls back to direct LSP collection.",
+          "**Generated agent guidance teaches the broker workflow.** Agent guidance distinguishes diagnostics-broker visibility (`diagnostics current/refresh/doctor`) from explicit evidence runs (`authoring check --mode final` for task handoff, commit, or broad validation).",
+          "**Honest snapshot scope and freshness.** Snapshots default to `opened_files_only` scope and `scope_limited` freshness classification. GDH does not claim whole-project diagnostics unless the Godot LSP emits evidence at that scope.",
+          "**Self-update detects legacy hooks without diagnostics refresh.** Self-update re-renders post-edit hooks that pre-date the broker workflow.",
+          "**Docs-validation tripwires.** `DIAG-BROKER-01` validate-docs checks block regression of the `authoring-dirty.json` ledger and Stop-hook validation patterns."
+        ]
+      },
+      "updateContract": {
+        "summary": "Managed targets need release-specific migration for v0.23.0 because generated authoring guidance and post-edit hook surfaces changed for the diagnostics broker workflow. After self-update, run `gdh migrate --apply`, then validate adapter status, drift, and the new diagnostics broker surfaces.",
+        "steps": [
+          {
+            "id": "self_update_runtime_workflow_package",
+            "kind": "mechanical",
+            "summary": "Install the v0.23.0 GDH package.",
+            "detail": "Run the normal GDH self-update or package update path. This makes the new authoring diagnostics CLI/MCP surfaces, refreshed managed hook renderer, and updated guidance available to the host.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "rebake_diagnostics_broker_surfaces",
+            "kind": "mechanical",
+            "summary": "Re-bake managed authoring guidance and post-edit hook surfaces.",
+            "detail": "Run `gdh migrate --apply` so guidance unit version 17 writes the new diagnostics broker guidance and hook version 5 writes the managed post-edit hooks that refresh the broker before the authoring check.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh adapters status",
+              "gdh verify drift",
+              "gdh status"
+            ]
+          },
+          {
+            "id": "verify_diagnostics_broker_visibility",
+            "kind": "agent_reasoning",
+            "summary": "Confirm the diagnostics broker is reachable for the target.",
+            "detail": "Inspect the broker with `gdh authoring diagnostics status` and, if needed, `gdh authoring diagnostics doctor`. On hosts without a configured Godot editor binary, expect honest `unavailable` results and rely on `gdh authoring check --mode final` for explicit evidence runs. Use `gdh authoring diagnostics refresh --changed <path>` after edits to warm the snapshot before reading it.",
+            "commands": [
+              "gdh authoring diagnostics status",
+              "gdh authoring diagnostics doctor",
+              "gdh authoring diagnostics refresh --changed <path>",
+              "gdh authoring diagnostics current"
+            ],
+            "validationCommands": [
+              "gdh authoring diagnostics status",
+              "gdh authoring check --mode final"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

package/node_modules/@gdh/adapters/dist/authoring-hook-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authoring-hook-render.d.ts","sourceRoot":"","sources":["../src/authoring-hook-render.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mCAAmC,yCAAyC,CAAC;AAC1F,eAAO,MAAM,kCAAkC,wCAAwC,CAAC;AACxF,eAAO,MAAM,6BAA6B,uRAC4O,CAAC;AACvR,eAAO,MAAM,4BAA4B,qRAC2O,CAAC;AAErR,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;CACpC,GAAG,MAAM,CA6HT"}
+{"version":3,"file":"authoring-hook-render.d.ts","sourceRoot":"","sources":["../src/authoring-hook-render.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mCAAmC,yCAAyC,CAAC;AAC1F,eAAO,MAAM,kCAAkC,wCAAwC,CAAC;AACxF,eAAO,MAAM,6BAA6B,uRAC4O,CAAC;AACvR,eAAO,MAAM,4BAA4B,qRAC2O,CAAC;AAErR,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;CACpC,GAAG,MAAM,CAmIT"}

package/node_modules/@gdh/adapters/dist/authoring-hook-render.js

@@ -35,7 +35,13 @@ export function renderGdhAuthoringHook(input) {
         "  const changed = collectChangedFiles(input, targetRoot);",
         "  const authoring = changed.filter(isAuthoringValidationPath);",
         "  if (authoring.length === 0) return allow();",
-        "  const result = runGdh(targetRoot, ['authoring', 'check', '--target', targetRoot, '--mode', 'post-edit', '--format', 'compact', ...authoring.flatMap((file) => ['--changed', file])]);",
+        "  const changedArgs = authoring.flatMap((file) => ['--changed', file]);",
+        "  // Attempt to refresh the diagnostics broker for changed files.",
+        "  // Broker refresh failure is non-fatal: the authoring check falls back to direct LSP.",
+        "  runGdh(targetRoot, ['authoring', 'diagnostics', 'refresh', '--target', targetRoot, ...changedArgs]);",
+        "  // Run compact authoring check. When broker was refreshed, this uses the fresh snapshot.",
+        "  // When broker is unavailable, this falls back to direct LSP post-edit collection.",
+        "  const result = runGdh(targetRoot, ['authoring', 'check', '--target', targetRoot, '--mode', 'post-edit', '--format', 'compact', ...changedArgs]);",
         "  if (!result.ok || !/Completion allowed\\./.test(result.output)) {",
         "    return block(`GDH post-edit authoring check needs attention.\\n${result.output || result.error || 'No check output.'}`);",
         "  }",

package/node_modules/@gdh/adapters/dist/authoring-hook-render.js.map

@@ -1 +1 @@
-{"version":3,"file":"authoring-hook-render.js","sourceRoot":"","sources":["../src/authoring-hook-render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,CAAC,MAAM,mCAAmC,GAAG,sCAAsC,CAAC;AAC1F,MAAM,CAAC,MAAM,kCAAkC,GAAG,qCAAqC,CAAC;AACxF,MAAM,CAAC,MAAM,6BAA6B,GACxC,oRAAoR,CAAC;AACvR,MAAM,CAAC,MAAM,4BAA4B,GACvC,kRAAkR,CAAC;AAErR,MAAM,UAAU,sBAAsB,CAAC,KAItC;IACC,OAAO;QACL,qBAAqB;QACrB,wBAAwB,uBAAuB,EAAE;QACjD,8DAA8D;QAC9D,0BAA0B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG;QAChE,gCAAgC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG;QAC3E,iBAAiB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG;QAC/C,EAAE;QACF,2BAA2B;QAC3B,+BAA+B;QAC/B,iDAAiD;QACjD,EAAE;QACF,kEAAkE;QAClE,yBAAyB;QACzB,EAAE;QACF,SAAS;QACT,EAAE;QACF,mBAAmB;QACnB,kCAAkC;QAClC,gDAAgD;QAChD,0DAA0D;QAC1D,8BAA8B;QAC9B,oCAAoC;QACpC,6GAA6G;QAC7G,mBAAmB;QACnB,GAAG;QACH,EAAE;QACF,8CAA8C;QAC9C,2DAA2D;QAC3D,gEAAgE;QAChE,+CAA+C;QAC/C,yLAAyL;QACzL,qEAAqE;QACrE,8HAA8H;QAC9H,KAAK;QACL,mBAAmB;QACnB,GAAG;QACH,EAAE;QACF,qCAAqC;QACrC,yFAAyF;QACzF,sBAAsB;QACtB,uBAAuB;QACvB,wBAAwB;QACxB,sBAAsB;QACtB,OAAO;QACP,yEAAyE;QACzE,wHAAwH;QACxH,GAAG;QACH,EAAE;QACF,mDAAmD;QACnD,uFAAuF;QACvF,qBAAqB;QACrB,yDAAyD;QACzD,qEAAqE;QACrE,wEAAwE;QACxE,8HAA8H;QAC9H,+FAA+F;QAC/F,yBAAyB;QACzB,GAAG;QACH,EAAE;QACF,oEAAoE;QACpE,wDAAwD;QACxD,2DAA2D;QAC3D,0DAA0D;QAC1D,sDAAsD;QACtD,4HAA4H;QAC5H,kHAAkH;QAClH,GAAG;QACH,EAAE;QACF,yCAAyC;QACzC,qBAAqB;QACrB,qEAAqE;QACrE,cAAc;QACd,iFAAiF;QACjF,iBAAiB;QACjB,GAAG;QACH,EAAE;QACF,uDAAuD;QACvD,iEAAiE;QACjE,oFAAoF;QACpF,2CAA2C;QAC3C,GAAG;QACH,EAAE;QACF,kEAAkE;QAClE,wEAAwE;QACxE,0DAA0D;QAC1D,kEAAkE;QAClE,2GAA2G;QAC3G,kEAAkE;QAClE,iJAAiJ;QACjJ,4GAA4G;QAC5G,sIAAsI;QACtI,KAAK;QACL,4EAA4E;QAC5E,8CAA8C;QAC9C,GAAG;QACH,yKAAyK;QACzK,yKAAyK;QACzK,EAAE;QACF,4CAA4C;QAC5C,iFAAiF;QACjF,sEAAsE;QACtE,GAAG;QACH,EAAE;QACF,qCAAqC;QACrC,qDAAqD;QACrD,uEAAuE;QACvE,qDAAqD;QACrD,iEAAiE;QACjE,yBAAyB;QACzB,GAAG;QACH,EAAE;QACF,iFAAiF;QACjF,kHAAkH;QAClH,EAAE;QACF,uCAAuC;QACvC,0BAA0B;QAC1B,kDAAkD;QAClD,oHAAoH;QACpH,0DAA0D;QAC1D,oBAAoB;QACpB,GAAG;QACH,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"authoring-hook-render.js","sourceRoot":"","sources":["../src/authoring-hook-render.ts"],"names":[],"mappings":"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"}

package/node_modules/@gdh/adapters/package.json

@@ -11,13 +11,13 @@
     }
   },
   "dependencies": {
-    "@gdh/authoring": "0.22.0",
-    "@gdh/core": "0.22.0",
-    "@gdh/docs": "0.22.0",
-    "@gdh/observability": "0.22.0",
-    "@gdh/runtime": "0.22.0",
-    "@gdh/scan": "0.22.0",
-    "@gdh/verify": "0.22.0"
+    "@gdh/authoring": "0.23.0",
+    "@gdh/core": "0.23.0",
+    "@gdh/docs": "0.23.0",
+    "@gdh/observability": "0.23.0",
+    "@gdh/runtime": "0.23.0",
+    "@gdh/scan": "0.23.0",
+    "@gdh/verify": "0.23.0"
   },
-  "version": "0.22.0"
+  "version": "0.23.0"
 }

package/node_modules/@gdh/authoring/dist/diagnostics-broker-contract.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Authoring Diagnostics Broker Contract
+ *
+ * Defines the types, constants, identity normalization helpers, and health
+ * classification logic for the persistent diagnostics broker.
+ *
+ * The broker is target/worktree scoped, local-only (loopback), and
+ * token-protected. Its state lives under `.gdh-state/authoring/diagnostics-broker/`.
+ * It builds on the existing managed LSP lifecycle rather than introducing
+ * a second Godot editor process.
+ *
+ * Raw LSP payloads are provenance only. All product-facing shapes use
+ * `GdhAuthoringDiagnostic` from `@gdh/core`.
+ *
+ * Pattern reference: packages/runtime/src/bridge-broker-contract.ts
+ * ADR: docs/adrs/0003-lsp-based-authoring-validation.md (Persistent Diagnostics Broker Addendum)
+ */
+import type { GdhDiagnosticsBrokerHealth, GdhDiagnosticsBrokerMetadata, GdhDiagnosticsBrokerTargetIdentity, GdhDiagnosticsFreshnessState, GdhDiagnosticsFileSnapshot, GdhDiagnosticsSnapshot } from "@gdh/core";
+import { GDH_DIAGNOSTICS_BROKER_DEFAULT_HEARTBEAT_STALE_AFTER_MS, GDH_DIAGNOSTICS_BROKER_LOOPBACK_HOST, GDH_DIAGNOSTICS_BROKER_PROTOCOL_VERSION, GDH_DIAGNOSTICS_BROKER_STATE_RELATIVE_PATH } from "@gdh/core";
+export { GDH_DIAGNOSTICS_BROKER_DEFAULT_HEARTBEAT_STALE_AFTER_MS, GDH_DIAGNOSTICS_BROKER_LOOPBACK_HOST, GDH_DIAGNOSTICS_BROKER_PROTOCOL_VERSION, GDH_DIAGNOSTICS_BROKER_STATE_RELATIVE_PATH, };
+export declare const DIAGNOSTICS_BROKER_DEFAULT_FRESHNESS_STALE_AFTER_MS = 60000;
+export type GdhDiagnosticsBrokerPathStyle = "posix" | "win32";
+export interface NormalizeDiagnosticsBrokerTargetIdentityInput {
+    readonly targetRootPath: string;
+    readonly godotProjectRootPath: string;
+    readonly stateRootPath: string;
+    readonly pathStyle?: GdhDiagnosticsBrokerPathStyle;
+}
+/**
+ * Normalize target/worktree identity for the diagnostics broker.
+ *
+ * Uses the same path-normalization approach as the runtime bridge broker
+ * contract to ensure consistent identity keys across OS path variants,
+ * trailing separators, and relative segments.
+ */
+export declare function normalizeDiagnosticsBrokerTargetIdentity(input: NormalizeDiagnosticsBrokerTargetIdentityInput): GdhDiagnosticsBrokerTargetIdentity;
+export interface ValidateDiagnosticsBrokerHandshakeInput {
+    readonly expectedIdentity: GdhDiagnosticsBrokerTargetIdentity;
+    readonly metadata: GdhDiagnosticsBrokerMetadata | null;
+    readonly expectedGdhVersion: string;
+    readonly tokenPresent: boolean;
+    readonly pidAlive: boolean;
+    readonly nowMs?: number;
+    readonly heartbeatStaleAfterMs?: number;
+}
+/**
+ * Validate broker metadata and classify its health state.
+ *
+ * Returns `missing` if metadata is null.
+ * Returns `incompatible` for protocol, GDH version, or identity mismatches.
+ * Returns `stale` for token, heartbeat, or process failures.
+ * Returns `ready` when all checks pass.
+ */
+export declare function validateDiagnosticsBrokerHandshake(input: ValidateDiagnosticsBrokerHandshakeInput): GdhDiagnosticsBrokerHealth;
+export interface ClassifyDiagnosticsFreshnessInput {
+    readonly fileSnapshot: GdhDiagnosticsFileSnapshot | null;
+    readonly nowMs?: number;
+    readonly staleAfterMs?: number;
+}
+/**
+ * Classify the freshness state of a file's diagnostics snapshot.
+ *
+ * - `missing`: no snapshot exists for this file
+ * - `unavailable`: snapshot exists but LSP instance identity is missing (broker degraded)
+ * - `stale`: snapshot is older than the configured staleness threshold
+ * - `fresh`: snapshot is within the staleness threshold
+ */
+export declare function classifyDiagnosticsFreshness(input: ClassifyDiagnosticsFreshnessInput): GdhDiagnosticsFreshnessState;
+export interface ClassifySnapshotFreshnessInput {
+    readonly files: readonly GdhDiagnosticsFileSnapshot[];
+    readonly requestedUris?: readonly string[];
+    readonly nowMs?: number;
+    readonly staleAfterMs?: number;
+}
+/**
+ * Roll up freshness across all files in a snapshot.
+ *
+ * - `missing`: no files in snapshot
+ * - `unavailable`: all files are unavailable
+ * - `scope_limited`: some requested URIs are not covered
+ * - `stale`: at least one file is stale and none is missing
+ * - `fresh`: all files are fresh
+ */
+export declare function classifySnapshotFreshness(input: ClassifySnapshotFreshnessInput): GdhDiagnosticsFreshnessState;
+/**
+ * Count diagnostics by severity across all file snapshots.
+ */
+export declare function countDiagnosticsInSnapshot(files: readonly GdhDiagnosticsFileSnapshot[]): {
+    errorCount: number;
+    warningCount: number;
+    infoCount: number;
+};
+/**
+ * Build a complete `GdhDiagnosticsSnapshot` from a health result and file list.
+ */
+export declare function buildDiagnosticsSnapshot(health: GdhDiagnosticsBrokerHealth, files: readonly GdhDiagnosticsFileSnapshot[], options?: {
+    readonly requestedUris?: readonly string[];
+    readonly nowMs?: number;
+    readonly staleAfterMs?: number;
+}): GdhDiagnosticsSnapshot;
+/**
+ * Resolve the standard file paths used by the diagnostics broker under
+ * `.gdh-state/authoring/diagnostics-broker/`.
+ */
+export declare function resolveDiagnosticsBrokerPaths(stateRootPath: string): {
+    readonly brokerDir: string;
+    readonly metadataPath: string;
+    readonly tokenFilePath: string;
+    readonly heartbeatPath: string;
+    readonly snapshotPath: string;
+};
+//# sourceMappingURL=diagnostics-broker-contract.d.ts.map

package/node_modules/@gdh/authoring/dist/diagnostics-broker-contract.d.ts.map

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

package/node_modules/@gdh/authoring/dist/diagnostics-broker-contract.js

@@ -0,0 +1,264 @@
+/**
+ * Authoring Diagnostics Broker Contract
+ *
+ * Defines the types, constants, identity normalization helpers, and health
+ * classification logic for the persistent diagnostics broker.
+ *
+ * The broker is target/worktree scoped, local-only (loopback), and
+ * token-protected. Its state lives under `.gdh-state/authoring/diagnostics-broker/`.
+ * It builds on the existing managed LSP lifecycle rather than introducing
+ * a second Godot editor process.
+ *
+ * Raw LSP payloads are provenance only. All product-facing shapes use
+ * `GdhAuthoringDiagnostic` from `@gdh/core`.
+ *
+ * Pattern reference: packages/runtime/src/bridge-broker-contract.ts
+ * ADR: docs/adrs/0003-lsp-based-authoring-validation.md (Persistent Diagnostics Broker Addendum)
+ */
+import path from "node:path";
+import { GDH_DIAGNOSTICS_BROKER_DEFAULT_HEARTBEAT_STALE_AFTER_MS, GDH_DIAGNOSTICS_BROKER_LOOPBACK_HOST, GDH_DIAGNOSTICS_BROKER_PROTOCOL_VERSION, GDH_DIAGNOSTICS_BROKER_STATE_RELATIVE_PATH, } from "@gdh/core";
+export { GDH_DIAGNOSTICS_BROKER_DEFAULT_HEARTBEAT_STALE_AFTER_MS, GDH_DIAGNOSTICS_BROKER_LOOPBACK_HOST, GDH_DIAGNOSTICS_BROKER_PROTOCOL_VERSION, GDH_DIAGNOSTICS_BROKER_STATE_RELATIVE_PATH, };
+export const DIAGNOSTICS_BROKER_DEFAULT_FRESHNESS_STALE_AFTER_MS = 60_000;
+/**
+ * Normalize target/worktree identity for the diagnostics broker.
+ *
+ * Uses the same path-normalization approach as the runtime bridge broker
+ * contract to ensure consistent identity keys across OS path variants,
+ * trailing separators, and relative segments.
+ */
+export function normalizeDiagnosticsBrokerTargetIdentity(input) {
+    const pathStyle = input.pathStyle ?? (process.platform === "win32" ? "win32" : "posix");
+    const normalizedTargetRootPath = normalizeBrokerPath(input.targetRootPath, pathStyle);
+    const normalizedGodotProjectRootPath = normalizeBrokerPath(input.godotProjectRootPath, pathStyle);
+    const normalizedStateRootPath = normalizeBrokerPath(input.stateRootPath, pathStyle);
+    return {
+        targetRootPath: input.targetRootPath,
+        godotProjectRootPath: input.godotProjectRootPath,
+        stateRootPath: input.stateRootPath,
+        normalizedTargetRootPath,
+        normalizedGodotProjectRootPath,
+        normalizedStateRootPath,
+        pathStyle,
+        identityKey: [
+            `target=${normalizedTargetRootPath}`,
+            `godot=${normalizedGodotProjectRootPath}`,
+            `state=${normalizedStateRootPath}`,
+            `style=${pathStyle}`,
+        ].join("|"),
+    };
+}
+/**
+ * Validate broker metadata and classify its health state.
+ *
+ * Returns `missing` if metadata is null.
+ * Returns `incompatible` for protocol, GDH version, or identity mismatches.
+ * Returns `stale` for token, heartbeat, or process failures.
+ * Returns `ready` when all checks pass.
+ */
+export function validateDiagnosticsBrokerHandshake(input) {
+    const reasons = [];
+    const metadata = input.metadata;
+    if (metadata === null) {
+        return {
+            lifecycle: "missing",
+            reasons: ["broker_metadata_missing"],
+            metadata: null,
+        };
+    }
+    if (metadata.protocolVersion !== GDH_DIAGNOSTICS_BROKER_PROTOCOL_VERSION) {
+        reasons.push("broker_protocol_mismatch");
+    }
+    if (metadata.gdhVersion !== input.expectedGdhVersion) {
+        reasons.push("broker_gdh_version_mismatch");
+    }
+    if (metadata.targetIdentity.normalizedTargetRootPath !==
+        input.expectedIdentity.normalizedTargetRootPath) {
+        reasons.push("broker_target_mismatch");
+    }
+    if (metadata.targetIdentity.normalizedGodotProjectRootPath !==
+        input.expectedIdentity.normalizedGodotProjectRootPath) {
+        reasons.push("broker_godot_project_mismatch");
+    }
+    if (metadata.targetIdentity.normalizedStateRootPath !==
+        input.expectedIdentity.normalizedStateRootPath) {
+        reasons.push("broker_state_root_mismatch");
+    }
+    if (!input.tokenPresent) {
+        reasons.push("broker_token_missing");
+    }
+    if (!input.pidAlive) {
+        reasons.push("broker_process_not_alive");
+    }
+    if (metadata.host !== GDH_DIAGNOSTICS_BROKER_LOOPBACK_HOST) {
+        // Not currently a typed reason since host is fixed by the protocol.
+        // Treat it as a protocol mismatch if host is non-loopback.
+        reasons.push("broker_protocol_mismatch");
+    }
+    const nowMs = input.nowMs ?? Date.now();
+    const heartbeatMs = Date.parse(metadata.lastHeartbeatAt);
+    const heartbeatStaleAfterMs = input.heartbeatStaleAfterMs ?? GDH_DIAGNOSTICS_BROKER_DEFAULT_HEARTBEAT_STALE_AFTER_MS;
+    if (!Number.isFinite(heartbeatMs) || nowMs - heartbeatMs > heartbeatStaleAfterMs) {
+        reasons.push("broker_heartbeat_stale");
+    }
+    const lifecycle = classifyDiagnosticsBrokerLifecycle(reasons);
+    return {
+        lifecycle,
+        reasons: reasons.length === 0 ? ["broker_ready"] : reasons,
+        metadata,
+    };
+}
+function classifyDiagnosticsBrokerLifecycle(reasons) {
+    if (reasons.length === 0)
+        return "ready";
+    if (reasons.some((r) => [
+        "broker_protocol_mismatch",
+        "broker_gdh_version_mismatch",
+        "broker_target_mismatch",
+        "broker_godot_project_mismatch",
+        "broker_state_root_mismatch",
+    ].includes(r))) {
+        return "incompatible";
+    }
+    if (reasons.some((r) => ["broker_token_missing", "broker_heartbeat_stale", "broker_process_not_alive"].includes(r))) {
+        return "stale";
+    }
+    return "unavailable";
+}
+/**
+ * Classify the freshness state of a file's diagnostics snapshot.
+ *
+ * - `missing`: no snapshot exists for this file
+ * - `unavailable`: snapshot exists but LSP instance identity is missing (broker degraded)
+ * - `stale`: snapshot is older than the configured staleness threshold
+ * - `fresh`: snapshot is within the staleness threshold
+ */
+export function classifyDiagnosticsFreshness(input) {
+    const { fileSnapshot, nowMs = Date.now(), staleAfterMs = DIAGNOSTICS_BROKER_DEFAULT_FRESHNESS_STALE_AFTER_MS } = input;
+    if (fileSnapshot === null) {
+        return "missing";
+    }
+    if (fileSnapshot.lspInstanceId === null) {
+        return "unavailable";
+    }
+    if (fileSnapshot.lastUpdatedAt === null) {
+        return "missing";
+    }
+    const updatedMs = Date.parse(fileSnapshot.lastUpdatedAt);
+    if (!Number.isFinite(updatedMs) || nowMs - updatedMs > staleAfterMs) {
+        return "stale";
+    }
+    return "fresh";
+}
+/**
+ * Roll up freshness across all files in a snapshot.
+ *
+ * - `missing`: no files in snapshot
+ * - `unavailable`: all files are unavailable
+ * - `scope_limited`: some requested URIs are not covered
+ * - `stale`: at least one file is stale and none is missing
+ * - `fresh`: all files are fresh
+ */
+export function classifySnapshotFreshness(input) {
+    const { files, requestedUris, nowMs, staleAfterMs } = input;
+    if (files.length === 0) {
+        return "missing";
+    }
+    const fileByUri = new Map(files.map((f) => [f.uri, f]));
+    // If caller specified requested URIs, check for scope gap first.
+    if (requestedUris !== undefined && requestedUris.length > 0) {
+        const covered = requestedUris.filter((uri) => fileByUri.has(uri));
+        if (covered.length < requestedUris.length) {
+            return "scope_limited";
+        }
+    }
+    const freshnesses = files.map((f) => classifyDiagnosticsFreshness({
+        fileSnapshot: f,
+        ...(nowMs !== undefined && { nowMs }),
+        ...(staleAfterMs !== undefined && { staleAfterMs }),
+    }));
+    if (freshnesses.every((s) => s === "unavailable"))
+        return "unavailable";
+    if (freshnesses.some((s) => s === "missing"))
+        return "missing";
+    if (freshnesses.some((s) => s === "stale"))
+        return "stale";
+    return "fresh";
+}
+// ─── Snapshot Summary Helpers ─────────────────────────────────────────────────
+/**
+ * Count diagnostics by severity across all file snapshots.
+ */
+export function countDiagnosticsInSnapshot(files) {
+    let errorCount = 0;
+    let warningCount = 0;
+    let infoCount = 0;
+    for (const file of files) {
+        for (const diag of file.diagnostics) {
+            if (diag.severity === "error")
+                errorCount++;
+            else if (diag.severity === "warning")
+                warningCount++;
+            else
+                infoCount++;
+        }
+    }
+    return { errorCount, warningCount, infoCount };
+}
+/**
+ * Build a complete `GdhDiagnosticsSnapshot` from a health result and file list.
+ */
+export function buildDiagnosticsSnapshot(health, files, options = {}) {
+    const { requestedUris, nowMs = Date.now(), staleAfterMs } = options;
+    const freshness = classifySnapshotFreshness({
+        files,
+        ...(requestedUris !== undefined && { requestedUris }),
+        nowMs,
+        ...(staleAfterMs !== undefined && { staleAfterMs }),
+    });
+    const scope = health.metadata?.snapshotScope ?? "unknown";
+    const { errorCount, warningCount, infoCount } = countDiagnosticsInSnapshot(files);
+    return {
+        health,
+        scope,
+        freshness,
+        files,
+        observedAt: new Date(nowMs).toISOString(),
+        errorCount,
+        warningCount,
+        infoCount,
+    };
+}
+// ─── Metadata Path Helpers ────────────────────────────────────────────────────
+/**
+ * Resolve the standard file paths used by the diagnostics broker under
+ * `.gdh-state/authoring/diagnostics-broker/`.
+ */
+export function resolveDiagnosticsBrokerPaths(stateRootPath) {
+    const brokerDir = path.join(stateRootPath, GDH_DIAGNOSTICS_BROKER_STATE_RELATIVE_PATH);
+    return {
+        brokerDir,
+        metadataPath: path.join(brokerDir, "metadata.json"),
+        tokenFilePath: path.join(brokerDir, "token"),
+        heartbeatPath: path.join(brokerDir, "heartbeat"),
+        snapshotPath: path.join(brokerDir, "snapshot.json"),
+    };
+}
+// ─── Internal Path Normalization ──────────────────────────────────────────────
+function normalizeBrokerPath(value, pathStyle) {
+    const pathModule = pathStyle === "win32" ? path.win32 : path.posix;
+    const resolved = pathModule.resolve(value);
+    const normalized = pathModule.normalize(resolved);
+    const withoutTrailingSeparator = stripTrailingSeparators(normalized, pathModule.parse(normalized).root, pathStyle);
+    return pathStyle === "win32"
+        ? withoutTrailingSeparator.replaceAll("/", "\\").toLowerCase()
+        : withoutTrailingSeparator;
+}
+function stripTrailingSeparators(value, root, pathStyle) {
+    let next = value;
+    const separators = pathStyle === "win32" ? ["\\", "/"] : ["/"];
+    while (next.length > root.length && separators.some((sep) => next.endsWith(sep))) {
+        next = next.slice(0, -1);
+    }
+    return next;
+}
+//# sourceMappingURL=diagnostics-broker-contract.js.map

package/node_modules/@gdh/authoring/dist/diagnostics-broker-contract.js.map

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

package/node_modules/@gdh/authoring/dist/diagnostics-broker.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Authoring Diagnostics Broker Service
+ *
+ * Provides broker status, current snapshot, refresh, doctor, and prune operations
+ * for the persistent diagnostics broker.
+ *
+ * The broker reuses the existing managed Godot LSP lifecycle. It does NOT launch
+ * a second Godot editor process. State is stored under:
+ *   `.gdh-state/authoring/diagnostics-broker/snapshot.json`
+ *
+ * This file implements the service layer on top of:
+ *   - packages/authoring/src/diagnostics-broker-contract.ts (pure functions/types)
+ *   - packages/authoring/src/lsp.ts (managed LSP lifecycle)
+ *   - packages/authoring/src/lsp-client.ts (TCP LSP client with diagnostics store)
+ *
+ * ADR: docs/adrs/0003-lsp-based-authoring-validation.md (Persistent Diagnostics Broker Addendum)
+ */
+import type { GdhAuthoringStatusResult, GdhDiagnosticsSnapshot, GdhManagedLspStatusResult, GdhProjectConfig } from "@gdh/core";
+export interface GetAuthoringDiagnosticsStatusInput {
+    readonly targetPath: string;
+    readonly status: GdhAuthoringStatusResult;
+    readonly projectConfig: GdhProjectConfig | null;
+}
+export interface GetCurrentAuthoringDiagnosticsInput {
+    readonly targetPath: string;
+    readonly status: GdhAuthoringStatusResult;
+    readonly projectConfig: GdhProjectConfig | null;
+    readonly requestedUris?: readonly string[];
+    readonly staleAfterMs?: number;
+}
+export interface RefreshAuthoringDiagnosticsInput {
+    readonly targetPath: string;
+    readonly status: GdhAuthoringStatusResult;
+    readonly projectConfig: GdhProjectConfig | null;
+    readonly changedFiles?: readonly string[];
+}
+export interface RefreshAuthoringDiagnosticsResult {
+    readonly snapshot: GdhDiagnosticsSnapshot;
+    readonly filesRefreshed: number;
+    readonly lspInstanceId: string | null;
+    readonly summary: string;
+}
+export interface DoctorAuthoringDiagnosticsInput {
+    readonly targetPath: string;
+    readonly status: GdhAuthoringStatusResult;
+    readonly projectConfig: GdhProjectConfig | null;
+}
+export interface DoctorAuthoringDiagnosticsResult {
+    readonly snapshot: GdhDiagnosticsSnapshot | null;
+    readonly lspStatus: GdhManagedLspStatusResult;
+    readonly recommendations: readonly string[];
+    readonly summary: string;
+}
+export interface PruneAuthoringDiagnosticsInput {
+    readonly targetPath: string;
+    readonly status: GdhAuthoringStatusResult;
+    readonly projectConfig: GdhProjectConfig | null;
+}
+export interface PruneAuthoringDiagnosticsResult {
+    readonly pruned: boolean;
+    readonly summary: string;
+}
+/**
+ * Return a lightweight status summary for the broker: whether a snapshot exists,
+ * how many files are tracked, and the snapshot's freshness.
+ */
+export declare function getAuthoringDiagnosticsStatus(input: GetAuthoringDiagnosticsStatusInput): Promise<GdhDiagnosticsSnapshot>;
+/**
+ * Return the latest stored diagnostics snapshot for this target/worktree.
+ * Classifies freshness relative to the staleness threshold.
+ * Does not trigger a new LSP refresh.
+ */
+export declare function getCurrentAuthoringDiagnostics(input: GetCurrentAuthoringDiagnosticsInput): Promise<GdhDiagnosticsSnapshot>;
+/**
+ * Open/refresh the specified (or all project) GDScript files through the managed
+ * LSP instance, collect the published diagnostics, and persist the snapshot.
+ *
+ * The broker does NOT launch a second Godot editor — it reuses the existing
+ * managed LSP lifecycle.
+ */
+export declare function refreshAuthoringDiagnostics(input: RefreshAuthoringDiagnosticsInput): Promise<RefreshAuthoringDiagnosticsResult>;
+/**
+ * Explain the broker's current state without mutating anything.
+ * Surfaces recommendations for missing, stale, or unavailable broker states.
+ */
+export declare function doctorAuthoringDiagnostics(input: DoctorAuthoringDiagnosticsInput): Promise<DoctorAuthoringDiagnosticsResult>;
+/**
+ * Remove the broker snapshot file. Does not affect the managed LSP lifecycle.
+ * Bounded to GDH-owned metadata only.
+ */
+export declare function pruneAuthoringDiagnostics(input: PruneAuthoringDiagnosticsInput): Promise<PruneAuthoringDiagnosticsResult>;
+//# sourceMappingURL=diagnostics-broker.d.ts.map

package/node_modules/@gdh/authoring/dist/diagnostics-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-broker.d.ts","sourceRoot":"","sources":["../src/diagnostics-broker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAEV,wBAAwB,EAGxB,sBAAsB,EAEtB,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AAuCnB,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAID;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,sBAAsB,CAAC,CAoBjC;AAID;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,mCAAmC,GACzC,OAAO,CAAC,sBAAsB,CAAC,CAuBjC;AAID;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,iCAAiC,CAAC,CAkH5C;AAID;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,gCAAgC,CAAC,CA2E3C;AAID;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,+BAA+B,CAAC,CA0B1C"}