@skillcap/gdh 0.17.0 → 0.17.1

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "installMode": "packaged_install"
 }

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -1356,6 +1356,64 @@
           }
         ]
       }
+    },
+    {
+      "version": "0.17.1",
+      "releaseTag": "v0.17.1",
+      "migrationStatus": "no_op",
+      "summary": "v0.17.1 fixes update and migration follow-through classification plus managed Godot LSP startup timing without changing managed project surface versions. Existing targets do not need release-scoped migration for this patch line; agents should follow the ordinary self-update terminal contract, and managed LSP state remains compatible.",
+      "releaseHighlights": {
+        "summary": "v0.17.1 fixes two dogfooding regressions from the v0.17.0 authoring release. Update and migration follow-up now separates safe GDH-managed repair from project-owned manual review, and managed Godot LSP startup now waits long enough for slower real projects to become protocol-ready.",
+        "operatorChanges": [
+          "**Self-update no longer hides safe repair behind manual review.** `gdh self-update` and `gdh migrate --apply` can repair auto-applicable managed bridge drift even when project-owned rules still need review.",
+          "**Terminal commands are safer to trust.** `terminal.commands` now contains only GDH-classified auto-applicable follow-up commands; project-owned review remains in `terminal.manualSteps`.",
+          "**Generated update guidance is clearer.** `/gdh-update` and `/gdh-migrate` tell agents to run surfaced safe commands before stopping for manual review.",
+          "**Migration action hints point at apply when work is auto-applicable.** Lifecycle surfaces that GDH can safely migrate now surface `gdh migrate --apply` instead of preview-only `gdh migrate`.",
+          "**Managed LSP startup is less brittle.** GDH now gives the Godot editor a longer startup window, retries startup `initialize` timeouts, and records command, pid, port, timeout budget, attempts, elapsed time, and protocol failure details when authoring LSP still cannot become ready.",
+          "**Real-project LSP proof is restored.** The Beacon dogfood target now reaches `authoring.lsp` `ready` with initialized protocol health using the local v0.17.1 build."
+        ]
+      },
+      "updateContract": {
+        "summary": "No release-scoped managed migration is required for v0.17.1. After self-update, agents should trust the terminal contract: run any surfaced auto-applicable `terminal.commands`, validate with `terminal.validationCommands`, and stop for the remaining `terminal.manualSteps`. Managed LSP startup behavior improves automatically with the new GDH package and does not require target migration.",
+        "steps": [
+          {
+            "id": "verify_post_update_terminal",
+            "kind": "mechanical",
+            "summary": "Read the post-update terminal result.",
+            "detail": "After `gdh self-update`, inspect `terminal.state`, `terminal.commands`, `terminal.validationCommands`, and `terminal.manualSteps`. Treat `terminal.commands` as GDH-classified auto-applicable follow-up only.",
+            "commands": [
+              "gdh status"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "run_safe_terminal_commands",
+            "kind": "mechanical",
+            "summary": "Run surfaced safe commands before manual review.",
+            "detail": "If `terminal.commands` is non-empty, run those commands because GDH classified them as auto-applicable. This may include managed bridge repair or migration apply work that is independent from project-owned review.",
+            "commands": [
+              "gdh migrate --apply",
+              "gdh bridge repair"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh bridge status"
+            ]
+          },
+          {
+            "id": "review_remaining_manual_steps",
+            "kind": "manual_review",
+            "summary": "Stop for remaining project-owned or editor-side manual review.",
+            "detail": "If `terminal.manualSteps` remains after safe commands and validation, explain those steps and stop. Do not overwrite project-owned rules or pretend editor-side plugin enable happened automatically.",
+            "commands": [],
+            "validationCommands": [
+              "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

@@ -728,7 +728,7 @@ export function renderClaudeMigrateCommand(pinnedVersion) {
         "5. After apply, read `terminal.state` in the stdout JSON.",
         "6. If `terminal.state` is `healthy`, confirm no further migration action is required and stop.",
         "7. If `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping.",
-        "8. If `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of improvising a repair.",
+        "8. If `terminal.state` is `manual_review_required`, run any surfaced `terminal.commands` first because they are auto-applicable, then run the surfaced `terminal.validationCommands`, explain the remaining `terminal.manualSteps`, and stop for review instead of improvising a repair.",
         "9. If `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop.",
         "</process>",
         "",
@@ -773,7 +773,7 @@ export function renderCodexMigrateSkill(pinnedVersion) {
         "- after apply, read `terminal.state` in the stdout JSON",
         "- if `terminal.state` is `healthy`, confirm no further migration action is required and stop",
         "- if `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping",
-        "- if `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of improvising a repair",
+        "- if `terminal.state` is `manual_review_required`, run any surfaced `terminal.commands` first because they are auto-applicable, then run the surfaced `terminal.validationCommands`, explain the remaining `terminal.manualSteps`, and stop for review instead of improvising a repair",
         "- if `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop",
         "</process>",
         "",
@@ -816,7 +816,7 @@ export function renderCursorMigrateSkill(pinnedVersion) {
         "- after apply, read `terminal.state` in the stdout JSON",
         "- if `terminal.state` is `healthy`, confirm no further migration action is required and stop",
         "- if `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping",
-        "- if `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of improvising a repair",
+        "- if `terminal.state` is `manual_review_required`, run any surfaced `terminal.commands` first because they are auto-applicable, then run the surfaced `terminal.validationCommands`, explain the remaining `terminal.manualSteps`, and stop for review instead of improvising a repair",
         "- if `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop",
         "</process>",
         "",
@@ -880,7 +880,7 @@ export function renderClaudeUpdateCommand(_pinnedVersion) {
         "8. Read `terminal.state` in the apply stdout JSON and treat it as the lifecycle/runtime truth.",
         "9. If `terminal.state` is `healthy`, confirm the update completed and stop.",
         "10. If `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping.",
-        "11. If `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of inventing a repair.",
+        "11. If `terminal.state` is `manual_review_required`, run any surfaced `terminal.commands` first because they are auto-applicable, then run the surfaced `terminal.validationCommands`, explain the remaining `terminal.manualSteps`, and stop for review instead of inventing a repair.",
         "12. If `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop.",
         "</process>",
         "",
@@ -888,6 +888,7 @@ export function renderClaudeUpdateCommand(_pinnedVersion) {
         "- Do ask for explicit approval after the structured preview and before apply.",
         "- Do not invent migration steps from prose docs; use the machine-readable `preview` payload.",
         "- Do treat `terminal.state` as the primary apply truth; the additive compatibility fields are not the main follow-through contract.",
+        "- `terminal.commands` contains only GDH-classified auto-applicable follow-up; project-owned review stays in `terminal.manualSteps`.",
         "- Bake literal `@latest` in the shellout so the new CLI performs the update, not the old one.",
         "- If `self-update` returns `rolled_back` or `blocked`, surface the failure reason and stop (do not retry).",
         "- If `self-update` returns `skipped_dev_mode`, explain that dev-from-source mode bypasses pinning; no action needed.",
@@ -927,7 +928,7 @@ export function renderCodexUpdateSkill(_pinnedVersion) {
         "8. Read `terminal.state` in the apply stdout JSON and treat it as the lifecycle/runtime truth.",
         "9. If `terminal.state` is `healthy`, confirm the update completed and stop.",
         "10. If `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping.",
-        "11. If `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of inventing a repair.",
+        "11. If `terminal.state` is `manual_review_required`, run any surfaced `terminal.commands` first because they are auto-applicable, then run the surfaced `terminal.validationCommands`, explain the remaining `terminal.manualSteps`, and stop for review instead of inventing a repair.",
         "12. If `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop.",
         "</process>",
         "",
@@ -935,6 +936,7 @@ export function renderCodexUpdateSkill(_pinnedVersion) {
         "- Do ask for explicit approval after the structured preview and before apply.",
         "- Do not invent migration steps from prose docs; use the machine-readable `preview` payload.",
         "- Do treat `terminal.state` as the primary apply truth; the additive compatibility fields are not the main follow-through contract.",
+        "- `terminal.commands` contains only GDH-classified auto-applicable follow-up; project-owned review stays in `terminal.manualSteps`.",
         "- Bake literal `@latest` in the shellout so the new CLI performs the update, not the old one.",
         "- If `self-update` returns `rolled_back` or `blocked`, surface the failure reason and stop (do not retry).",
         "- If `self-update` returns `skipped_dev_mode`, explain that dev-from-source mode bypasses pinning; no action needed.",
@@ -972,7 +974,7 @@ export function renderCursorUpdateSkill(_pinnedVersion) {
         "8. Read `terminal.state` in the apply stdout JSON and treat it as the lifecycle/runtime truth.",
         "9. If `terminal.state` is `healthy`, confirm the update completed and stop.",
         "10. If `terminal.state` is `follow_up_required`, run the surfaced `terminal.commands`, then run the surfaced `terminal.validationCommands`, and confirm the follow-up results before stopping.",
-        "11. If `terminal.state` is `manual_review_required`, explain the surfaced `terminal.manualSteps`, name the surfaced `terminal.validationCommands`, and stop for review instead of inventing a repair.",
+        "11. If `terminal.state` is `manual_review_required`, run any surfaced `terminal.commands` first because they are auto-applicable, then run the surfaced `terminal.validationCommands`, explain the remaining `terminal.manualSteps`, and stop for review instead of inventing a repair.",
         "12. If `terminal.state` is `blocked`, surface `terminal.summary` plus the reasons and stop.",
         "</process>",
         "",
@@ -980,6 +982,7 @@ export function renderCursorUpdateSkill(_pinnedVersion) {
         "- Do ask for explicit approval after the structured preview and before apply.",
         "- Do not invent migration steps from prose docs; use the machine-readable `preview` payload.",
         "- Do treat `terminal.state` as the primary apply truth; the additive compatibility fields are not the main follow-through contract.",
+        "- `terminal.commands` contains only GDH-classified auto-applicable follow-up; project-owned review stays in `terminal.manualSteps`.",
         "- Bake literal `@latest` in the shellout so the new CLI performs the update, not the old one.",
         "- If `self-update` returns `rolled_back` or `blocked`, surface the failure reason and stop (do not retry).",
         "- If `self-update` returns `skipped_dev_mode`, explain that dev-from-source mode bypasses pinning; no action needed.",
@@ -2753,7 +2756,7 @@ async function inspectProjectConfigLifecycleSurface(targetPath) {
             action: {
                 kind: "apply_migration",
                 summary: "Run GDH migrate to rewrite the project config to the current schema.",
-                command: ["gdh", "migrate", targetPath],
+                command: migrateApplyCommand(targetPath),
                 autoApplicable: true,
             },
         });
@@ -2829,7 +2832,7 @@ async function inspectRulesLifecycleSurface(targetPath) {
             action: {
                 kind: "apply_migration",
                 summary: "Run GDH migrate to create the default rules file for this target.",
-                command: ["gdh", "migrate", targetPath],
+                command: migrateApplyCommand(targetPath),
                 autoApplicable: true,
             },
         });
@@ -2899,7 +2902,7 @@ function inspectAgentContractLifecycleSurface(targetPath, guidanceStatus) {
         action: {
             kind: "apply_migration",
             summary: "Run GDH migrate to merge or refresh the managed agent contract block.",
-            command: ["gdh", "migrate", targetPath],
+            command: migrateApplyCommand(targetPath),
             autoApplicable: true,
         },
     });
@@ -2928,7 +2931,7 @@ async function inspectGuidanceIndexLifecycleSurface(targetPath) {
             action: {
                 kind: "apply_migration",
                 summary: "Run GDH migrate to create the default guidance index for this target.",
-                command: ["gdh", "migrate", targetPath],
+                command: migrateApplyCommand(targetPath),
                 autoApplicable: true,
             },
         });
@@ -2954,7 +2957,7 @@ async function inspectGuidanceIndexLifecycleSurface(targetPath) {
         action: {
             kind: "apply_migration",
             summary: "Run GDH migrate to regenerate the guidance index with updated content.",
-            command: ["gdh", "migrate", targetPath],
+            command: migrateApplyCommand(targetPath),
             autoApplicable: true,
         },
     });
@@ -3011,7 +3014,7 @@ async function inspectGuidanceUnitLifecycleSurface(targetPath, projectConfig) {
             action: {
                 kind: "apply_migration",
                 summary: "Run GDH migrate to create the missing default guidance unit files.",
-                command: ["gdh", "migrate", targetPath],
+                command: migrateApplyCommand(targetPath),
                 autoApplicable: true,
             },
         });
@@ -3026,7 +3029,7 @@ async function inspectGuidanceUnitLifecycleSurface(targetPath, projectConfig) {
         action: {
             kind: "apply_migration",
             summary: "Run GDH migrate to regenerate guidance units with updated content.",
-            command: ["gdh", "migrate", targetPath],
+            command: migrateApplyCommand(targetPath),
             autoApplicable: true,
         },
     });
@@ -3393,7 +3396,7 @@ async function inspectYamlSurfaceDirectory(input) {
             action: {
                 kind: "apply_migration",
                 summary: "Run GDH migrate to normalize legacy runtime surface directories.",
-                command: ["gdh", "migrate", input.targetPath],
+                command: migrateApplyCommand(input.targetPath),
                 autoApplicable: true,
             },
         });
@@ -3433,7 +3436,7 @@ async function inspectYamlSurfaceDirectory(input) {
             action: {
                 kind: "apply_migration",
                 summary: "Run GDH migrate to normalize the affected runtime surfaces.",
-                command: ["gdh", "migrate", input.targetPath],
+                command: migrateApplyCommand(input.targetPath),
                 autoApplicable: true,
             },
         });
@@ -3519,6 +3522,9 @@ function summarizeProjectLifecycleState(state, surfaces) {
 function createLifecycleSurfaceStatus(input) {
     return input;
 }
+function migrateApplyCommand(targetPath) {
+    return ["gdh", "migrate", "--apply", targetPath];
+}
 function createVersionProbe(input) {
     return {
         relativePath: input.relativePath,