@skillcap/gdh 0.25.5 → 0.26.1

package/node_modules/@gdh/cli/package.json

@@ -15,16 +15,16 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@gdh/adapters": "0.25.5",
-    "@gdh/authoring": "0.25.5",
-    "@gdh/core": "0.25.5",
-    "@gdh/docs": "0.25.5",
-    "@gdh/mcp": "0.25.5",
-    "@gdh/observability": "0.25.5",
-    "@gdh/runtime": "0.25.5",
-    "@gdh/scan": "0.25.5",
-    "@gdh/verify": "0.25.5",
+    "@gdh/adapters": "0.26.1",
+    "@gdh/authoring": "0.26.1",
+    "@gdh/core": "0.26.1",
+    "@gdh/docs": "0.26.1",
+    "@gdh/mcp": "0.26.1",
+    "@gdh/observability": "0.26.1",
+    "@gdh/runtime": "0.26.1",
+    "@gdh/scan": "0.26.1",
+    "@gdh/verify": "0.26.1",
     "picocolors": "^1.1.1"
   },
-  "version": "0.25.5"
+  "version": "0.26.1"
 }

package/node_modules/@gdh/core/dist/index.d.ts

@@ -29,7 +29,16 @@ export declare const GDH_PROJECT_CONFIG_VERSION = 3;
 export declare const GDH_RECIPE_SCHEMA_VERSION = 2;
 export declare const GDH_SCENARIO_SCHEMA_VERSION = 2;
 export declare const GDH_RULES_SCHEMA_VERSION = 3;
-export declare const GDH_AGENT_CONTRACT_VERSION = 11;
+/**
+ * Bumped to 13 in Phase 82 to drive a managed-target rebake on the next
+ * `gdh setup` / migration. The rebake is required to land the Stop hook
+ * surface and the post-edit hook's `warming_up` additionalContext token
+ * (LSP-02 / LSP-03 / LSP-07).
+ * Bumped to 14 in Phase 83 (LSP-09) to drive a managed-target rebake so that
+ * existing managed targets receive the new PostToolBatch hook install on the
+ * next `gdh setup` / `gdh migrate apply` run.
+ */
+export declare const GDH_AGENT_CONTRACT_VERSION = 14;
 /**
  * Minimum self-update source pin (WFL-03 / D-21).
  *
@@ -46,7 +55,7 @@ export declare const GDH_AUTHORING_DOGFOOD_VERSION = 1;
 export declare const GDH_AUTHORING_SLICE_REPORT_VERSION = 1;
 export declare const GDH_MCP_MANIFEST_VERSION = 1;
 export declare const GDH_CURSOR_RULE_VERSION = 4;
-export declare const GDH_UPDATE_HOOK_VERSION = 9;
+export declare const GDH_UPDATE_HOOK_VERSION = 10;
 export declare const GDH_RUNTIME_RECIPE_RUN_VERSION = 1;
 export declare const GDH_RUNTIME_RUN_BUNDLE_VERSION = 1;
 export declare const GDH_RUNTIME_CORPUS_ARTIFACT_VERSION = 1;
@@ -556,7 +565,7 @@ export interface GdhAuthoringSliceReport {
     readonly dogfood: GdhAuthoringDogfoodTargetResult;
     readonly authoringCheck: GdhAuthoringCheckResult | null;
 }
-export type GdhMcpToolName = "docs.search" | "docs.fetch" | "target.prepare" | "authoring.check" | "authoring.diagnostics.status" | "authoring.diagnostics.current" | "authoring.diagnostics.refresh" | "authoring.diagnostics.doctor" | "run-config.check" | "run-config.run" | "bridge.session.start" | "bridge.entry.list" | "bridge.entry.invoke" | "bridge.session.stop" | "verify.run";
+export type GdhMcpToolName = "docs.search" | "docs.fetch" | "target.prepare" | "authoring.check" | "authoring.diagnostics.status" | "authoring.diagnostics.current" | "authoring.diagnostics.refresh" | "authoring.diagnostics.doctor" | "run-config.check" | "run-config.run" | "bridge.session.start" | "bridge.entry.list" | "bridge.entry.invoke" | "bridge.session.stop" | "verify.run" | "authoring.warmup";
 export interface GdhMcpResourceManifestEntry {
     readonly name: string;
     readonly summary: string;
@@ -697,7 +706,18 @@ export type GdhLspLifecycleStatus = "ready" | "degraded" | "unavailable";
 export type GdhLspTrustState = "trusted" | "degraded" | "stale";
 export type GdhLspLauncherKind = "godot_editor" | "test_fake";
 export type GdhLspValidationMode = "unimplemented" | "passed" | "diagnostics" | "degraded";
-export declare const GDH_MANAGED_LSP_SURFACE_VERSION = 1;
+export declare const GDH_MANAGED_LSP_SURFACE_VERSION = 2;
+/**
+ * Minimum Godot editor version supported by the managed LSP (Phase 81 / LSP-08 / D-14).
+ *
+ * Godot 4.5.0 and 4.5.1 ship with broken external-editor surfaces (PR #104401
+ * regression — restored in 4.5.2 by PR #111478 backport). The managed LSP
+ * refuses-to-launch on those versions and routes agents to 4.5.2+ or 4.6.x.
+ *
+ * Documented in docs/development/runtime-support-matrix.md.
+ * Centralized here so future floor bumps are a one-line change.
+ */
+export declare const GDH_MANAGED_LSP_MIN_GODOT_VERSION = "4.5.2";
 export interface GdhWorktreeIdentity {
     readonly rootPath: string;
     readonly worktreeKey: string;
@@ -748,6 +768,23 @@ export interface GdhManagedLspStatusProvenance {
     readonly stateRootPath: string;
     readonly rawPayload: Readonly<Record<string, unknown>> | null;
 }
+/**
+ * Structured advisory carried on the unavailable result when the configured
+ * Godot binary fails the managed-LSP version floor (Phase 81 / LSP-08 / D-16).
+ * Non-null only when `availability === "unavailable"` AND reason includes
+ * `"godot_editor_version_unsupported_for_lsp"`.
+ *
+ * - detectedVersion       — what Godot reported (or null if unprobed)
+ * - minimumVersion        — equals GDH_MANAGED_LSP_MIN_GODOT_VERSION
+ * - recommendedVersions   — sequence of recommended labels (e.g. ["4.5.2", "4.6.x"])
+ * - recommendedCommand    — optional next-step command suggestion
+ */
+export interface GdhVersionFloorAdvisory {
+    readonly detectedVersion: string | null;
+    readonly minimumVersion: string;
+    readonly recommendedVersions: readonly string[];
+    readonly recommendedCommand?: GdhRecommendedCommand;
+}
 export interface GdhManagedLspStatusResult {
     readonly targetPath: string;
     readonly capability: "authoring.lsp";
@@ -761,6 +798,13 @@ export interface GdhManagedLspStatusResult {
     readonly session: GdhManagedLspSessionSnapshot;
     readonly instance: GdhManagedLspInstanceSnapshot | null;
     readonly provenance: GdhManagedLspStatusProvenance;
+    /**
+     * Set when availability is "unavailable" AND reasons include
+     * "godot_editor_version_unsupported_for_lsp". CLI compact and MCP renderers
+     * surface this as the actionable advisory pointing agents at 4.5.2+ or 4.6.x
+     * (Phase 81 / LSP-08 / D-16).
+     */
+    readonly versionFloorAdvisory?: GdhVersionFloorAdvisory | null;
 }
 export interface GdhAuthoringCheckLspSnapshot {
     readonly status: GdhLspLifecycleStatus;
@@ -801,6 +845,33 @@ export interface GdhAuthoringCheckResult {
     readonly reasons: readonly string[];
     readonly provenance: GdhAuthoringCheckProvenance;
 }
+/**
+ * Result of a call to the managed LSP warmup verb.
+ *
+ * - `already_warm`: A cheap probe found the managed LSP healthy; no lock taken,
+ *   no Godot launched.
+ * - `warming`: `lsp.lock` is currently held by another warmup; this caller
+ *   returns without launching a second Godot editor.
+ * - `started`: This caller acquired `lsp.lock` and launched the managed Godot
+ *   editor (or completed the launch if already in flight under our lock).
+ * - `blocked`: The configured Godot binary fails the version floor (see
+ *   GdhVersionFloorAdvisory). The warmup did not launch Godot. Phase 81's
+ *   refuse-to-launch contract is propagated here verbatim.
+ */
+export type GdhAuthoringLspWarmupResult = {
+    readonly status: "already_warm";
+    readonly targetPath: string;
+} | {
+    readonly status: "warming";
+    readonly targetPath: string;
+} | {
+    readonly status: "started";
+    readonly targetPath: string;
+} | {
+    readonly status: "blocked";
+    readonly targetPath: string;
+    readonly versionFloorAdvisory: GdhVersionFloorAdvisory;
+};
 export type GdhAuthoringValidatorFamily = "gdscript_lsp" | "godot_scene_resource" | "unsupported";
 export type GdhProjectPlacement = "root" | "nested" | "submodule" | "vendored";
 export interface GdhScanProvenance {
@@ -2053,10 +2124,60 @@ export type GdhDiagnosticsSnapshotScope = "opened_files_only" | "refreshed_files
  * - scope_limited: diagnostics exist but cover only a subset of requested files
  */
 export type GdhDiagnosticsFreshnessState = "fresh" | "stale" | "missing" | "unavailable" | "scope_limited";
+/**
+ * Status discriminant for compact authoring-check output and hook
+ * `additionalContext` strings (Phase 81 / LSP-06 / D-02). This is the
+ * user-visible token used by `formatCompactAuthoringCheckResult` and the
+ * authoring-hook regex dispatch.
+ *
+ * Distinct from `GdhDiagnosticsFreshnessState` (which describes per-snapshot
+ * file freshness). Result-status merges per-file freshness AND LSP lifecycle
+ * into one user-visible vocabulary; do not conflate the two.
+ *
+ * - "fresh"    — all requested files checked, no blocking errors
+ * - "partial"  — some files checked, some still pending
+ * - "pending"  — no files captured because warmup is in flight
+ * - "timeout"  — hook bound exceeded before drain completed
+ * - "stale"    — LSP up but snapshot's lspInstanceId no longer matches current LSP
+ * - "failed"   — LSP unavailable, connection error, or refusal
+ */
+export type GdhDiagnosticsResultStatus = "fresh" | "partial" | "pending" | "timeout" | "stale" | "failed";
+/**
+ * Value-level array form of `GdhDiagnosticsResultStatus` for runtime iteration
+ * and exhaustiveness assertions (Phase 81 / D-02). Element type IS
+ * `GdhDiagnosticsResultStatus`; consumers can `forEach` to render help text or
+ * `includes(value)` to runtime-validate untrusted JSON inputs.
+ */
+export declare const GDH_DIAGNOSTICS_RESULT_STATUSES: readonly GdhDiagnosticsResultStatus[];
+/**
+ * Token surfaced as `additionalContext` (Codex) or context body (Claude) by
+ * the post-edit authoring hook when the managed LSP is cold-starting and a
+ * detached warmup has been kicked off. Phase 82 / LSP-02.
+ */
+export declare const GDH_AUTHORING_WARMING_UP_TOKEN: "warming_up";
 /**
  * Reasons reported in broker health and diagnostics freshness results.
+ *
+ * Phase 81 additions (D-08, D-15):
+ * - "broker_not_yet_primed" — broker has never been refreshed; .primed marker absent.
+ *   Distinct from "broker_metadata_missing" (which now means snapshot was pruned).
+ * - "godot_editor_version_unsupported_for_lsp" — configured Godot binary is below
+ *   GDH_MANAGED_LSP_MIN_GODOT_VERSION (= "4.5.2"); managed LSP refuses-to-launch.
  */
-export type GdhDiagnosticsBrokerReason = "broker_metadata_missing" | "broker_protocol_mismatch" | "broker_gdh_version_mismatch" | "broker_target_mismatch" | "broker_godot_project_mismatch" | "broker_state_root_mismatch" | "broker_token_missing" | "broker_heartbeat_stale" | "broker_process_not_alive" | "broker_lsp_unavailable" | "broker_ready" | "diagnostics_stale" | "diagnostics_missing" | "diagnostics_scope_limited" | "lsp_instance_identity_mismatch";
+export type GdhDiagnosticsBrokerReason = "broker_metadata_missing" | "broker_protocol_mismatch" | "broker_gdh_version_mismatch" | "broker_target_mismatch" | "broker_godot_project_mismatch" | "broker_state_root_mismatch" | "broker_token_missing" | "broker_heartbeat_stale" | "broker_process_not_alive" | "broker_lsp_unavailable" | "broker_ready" | "diagnostics_stale" | "diagnostics_missing" | "diagnostics_scope_limited" | "lsp_instance_identity_mismatch" | "broker_not_yet_primed" | "godot_editor_version_unsupported_for_lsp";
+/**
+ * Structured actionable suggestion attached to broker-absence reasons,
+ * version-floor advisories, and any future surface that wants to point
+ * agents at a concrete next-step command (Phase 81 / LSP-05, LSP-08 / D-07).
+ *
+ * CLI renderers compose `command + " " + args.join(" ")` for prose;
+ * MCP renderers can surface as a structured suggestion field. Keep the verb
+ * minimal; downstream renderers append target context as needed.
+ */
+export interface GdhRecommendedCommand {
+    readonly command: string;
+    readonly args?: readonly string[];
+}
 /**
  * Target/worktree identity for the diagnostics broker, normalized for
  * cross-platform and symlink-safe comparison. Mirrors the runtime bridge
@@ -2118,6 +2239,13 @@ export interface GdhDiagnosticsBrokerHealth {
     readonly lifecycle: GdhDiagnosticsBrokerLifecycleState;
     readonly reasons: readonly GdhDiagnosticsBrokerReason[];
     readonly metadata: GdhDiagnosticsBrokerMetadata | null;
+    /**
+     * Optional actionable next-step suggestion. Set when the reason set carries
+     * an absent-broker reason (broker_not_yet_primed, broker_metadata_missing)
+     * or any other reason where a single command would help (Phase 81 / LSP-05 / D-07).
+     * Renderers compose `command + args.join(" ")` for prose.
+     */
+    readonly recommendedCommand?: GdhRecommendedCommand;
 }
 /**
  * Full diagnostics snapshot returned by broker operations.
@@ -2134,4 +2262,48 @@ export interface GdhDiagnosticsSnapshot {
     readonly warningCount: number;
     readonly infoCount: number;
 }
+/**
+ * Top-level diagnostics result envelope with a discriminated `status` field
+ * (Phase 81 / LSP-06 / D-05). The two branches make `status: fresh` with
+ * `files: []` (legitimately empty — D-13 project-empty / scope-empty) STRUCTURALLY
+ * DISTINCT from `status: pending` (warmup in flight, no files captured yet).
+ *
+ * Branches:
+ * - `"fresh" | "partial"` carry `readonly files`. The array MAY be empty (D-13
+ *   legitimate empty-set case); the array's emptiness is a domain truth, not a
+ *   wire-format ambiguity. Renderers SHOULD branch on `status` first, then on
+ *   `files.length` only after narrowing into this branch.
+ * - `"pending" | "timeout" | "stale" | "failed"` OMIT `files` entirely.
+ *   TypeScript exhaustiveness blocks `result.files` access in this branch at
+ *   compile time, eliminating the "is `[]` clean or not-yet-resolved?" class
+ *   of bugs called out by ROADMAP success criterion #4.
+ *
+ * Phase 81 introduces this type for use by:
+ * - Plan 05 hook-render dispatch (consumes the `status` token via wire format)
+ * - Plan 05 CLI compact formatter (TypeScript-narrows on `status` to decide
+ *   whether to emit a "files" line)
+ * - Phase 82 warmup machinery (will produce `pending` envelopes during cold-start)
+ *
+ * The envelope is additive — `GdhDiagnosticsSnapshot` (which keeps its `files`
+ * field on every shape via its independent `freshness` discriminant) continues
+ * to exist for consumers that prefer the snapshot view.
+ */
+export type GdhAuthoringDiagnosticsResultEnvelope = {
+    readonly status: "fresh" | "partial";
+    readonly health: GdhDiagnosticsBrokerHealth;
+    readonly files: readonly GdhDiagnosticsFileSnapshot[];
+    readonly observedAt: string;
+    readonly errorCount: number;
+    readonly warningCount: number;
+    readonly infoCount: number;
+    readonly summary: string;
+} | {
+    readonly status: "pending" | "timeout" | "stale" | "failed";
+    readonly health: GdhDiagnosticsBrokerHealth;
+    readonly observedAt: string;
+    readonly errorCount: number;
+    readonly warningCount: number;
+    readonly infoCount: number;
+    readonly summary: string;
+};
 //# sourceMappingURL=index.d.ts.map