@skillcap/gdh 0.26.6 → 0.26.8

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "0.26.6",
+  "version": "0.26.8",
   "installMode": "packaged_install"
 }

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -3293,6 +3293,127 @@
           }
         ]
       }
+    },
+    {
+      "version": "0.26.7",
+      "releaseTag": "v0.26.7",
+      "migrationStatus": "required",
+      "summary": "v0.26.7 re-bakes managed authoring, guidance, entrypoint, and Cursor surfaces so authoring-validation evidence is trustworthy and generated target guidance no longer carries GDH mechanics or runtime bridge procedure. GDH_AGENT_CONTRACT_VERSION moves 15 -> 17, GDH_GUIDANCE_INDEX_VERSION moves 6 -> 8, GDH_GUIDANCE_UNIT_VERSION moves 21 -> 23, GDH_CURSOR_RULE_VERSION moves 4 -> 6, and GDH_UPDATE_HOOK_VERSION moves 15 -> 16. Existing targets should self-update and migrate so hooks, target guidance, AGENTS.md, and Cursor rules reflect the corrected contract.",
+      "releaseHighlights": {
+        "summary": "v0.26.7 repairs authoring-validation trust and tightens generated target guidance. Managed hooks and diagnostics now avoid stale or lifecycle-only confidence, while generated `.gdh/guidance/` stays focused on Godot authoring and project-surface expectations instead of GDH mechanics or runtime bridge procedure.",
+        "operatorChanges": [
+          "**Authoring diagnostics are more trustworthy.** GDH now treats broker freshness, file content hashes, file type, and validator family as part of the evidence contract instead of allowing stale LSP or hook state to imply \"done.\"",
+          "**Generated target guidance is smaller and cleaner.** `.gdh/guidance/` now emits only `authoring-and-validation.md` and `project-surfaces.md`; GDH command mechanics, migration procedure, persistence semantics, and runtime bridge mechanics stay in managed skills, hooks, CLI/MCP structured output, and repo-owned maintainer docs.",
+          "**Target entrypoints point at the right guidance surface.** Managed `AGENTS.md` and Cursor rule output route agents to `.gdh/guidance/README.md`, including the greenfield fixture and nested-target onboarding checks."
+        ]
+      },
+      "updateContract": {
+        "summary": "Managed targets must re-bake generated hooks, generated guidance, managed AGENTS.md, and Cursor rules so target-side authoring evidence and guidance boundaries match v0.26.7.",
+        "steps": [
+          {
+            "id": "install_v0_26_7",
+            "kind": "mechanical",
+            "summary": "Install the v0.26.7 GDH package.",
+            "detail": "Run gdh self-update so the target uses the v0.26.7 package and can re-render managed authoring hooks, guidance, AGENTS.md, and Cursor rules with the corrected surface versions.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh adapters status",
+              "gdh guidance status"
+            ]
+          },
+          {
+            "id": "rebake_authoring_and_guidance_surfaces",
+            "kind": "mechanical",
+            "summary": "Re-bake managed authoring and guidance surfaces.",
+            "detail": "If lifecycle status reports pending managed-surface work, run gdh migrate --apply. The migration re-renders managed hooks, AGENTS.md, Cursor rules, and .gdh/guidance so generated target guidance stays scoped to Godot authoring and project surfaces.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh adapters status",
+              "gdh guidance status",
+              "gdh status"
+            ]
+          },
+          {
+            "id": "confirm_guidance_boundary_and_authoring_evidence",
+            "kind": "agent_reasoning",
+            "summary": "Confirm guidance boundary and authoring evidence behavior.",
+            "detail": "Inspect .gdh/guidance/README.md and the generated authoring guidance. It should expose only Godot authoring validation and project-surface boundaries, not GDH command mechanics or runtime bridge procedure. For handoff evidence, use the active authoring validation surface and report the validator family and file scope that actually ran.",
+            "commands": [
+              "gdh guidance status",
+              "gdh authoring check --mode final --target <target>"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.26.8",
+      "releaseTag": "v0.26.8",
+      "migrationStatus": "required",
+      "summary": "v0.26.8 re-bakes managed rules, agent contract, generated guidance, and authoring hook surfaces so target guidance no longer asks agents to rerun authoring check commands during edit loops. GDH_RULES_SCHEMA_VERSION moves 3 -> 4, GDH_AGENT_CONTRACT_VERSION moves 17 -> 18, GDH_GUIDANCE_UNIT_VERSION moves 23 -> 24, and GDH_UPDATE_HOOK_VERSION moves 16 -> 17. Existing targets should self-update and migrate so hook-owned authoring feedback and final-validation guidance are aligned. Prior v3 default rules boilerplate is recognized as GDH-owned and refreshes automatically; customized rules remain manual review. The historical v2 -> v3 registry verifier accepts rules files already re-baked to a later supported schema by the current package.",
+      "releaseHighlights": {
+        "summary": "v0.26.8 removes redundant authoring-check instructions from generated agent guidance and relies on managed hook feedback during edit loops. Agents should use hook-provided authoring results while editing, then collect explicit final validation evidence at handoff instead of rerunning the same check commands after every edit.",
+        "operatorChanges": [
+          "**Generated guidance no longer tells agents to rerun authoring checks during edits.** Managed target guidance now treats hook output as the edit-loop feedback surface.",
+          "**Hook feedback stays explicit about file type and scope.** `.gd` edits use the managed diagnostics broker/refresh path, `.tscn` edits use scoped scene validation, and `.tres` remains outside automatic scoped validation.",
+          "**Recovery wording avoids redundant command loops.** Agent-facing text points agents at hook results and final handoff evidence instead of duplicating the hook-owned checks in guidance.",
+          "**Prior default rules files refresh automatically.** Targets with the v3 default `.gdh/rules.yaml` body migrate to the v4 rules text without manual review; customized rules still require manual review."
+        ]
+      },
+      "updateContract": {
+        "summary": "Managed targets must re-bake generated rules, hooks, generated guidance, and managed AGENTS.md so agents rely on hook feedback during authoring edits and reserve explicit authoring commands for final validation or recovery.",
+        "steps": [
+          {
+            "id": "install_v0_26_8",
+            "kind": "mechanical",
+            "summary": "Install the v0.26.8 GDH package.",
+            "detail": "Run gdh self-update so the target uses the v0.26.8 package and can re-render managed rules, hooks, guidance, and agent entrypoints with the corrected authoring feedback contract.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh adapters status",
+              "gdh guidance status"
+            ]
+          },
+          {
+            "id": "rebake_authoring_feedback_surfaces",
+            "kind": "mechanical",
+            "summary": "Re-bake managed authoring feedback surfaces.",
+            "detail": "If lifecycle status reports pending managed-surface work, run gdh migrate --apply. The migration re-renders managed hooks, rules, AGENTS.md, and .gdh/guidance so hook output remains the edit-loop authoring feedback source.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh adapters status",
+              "gdh guidance status",
+              "gdh status"
+            ]
+          },
+          {
+            "id": "confirm_hook_owned_edit_loop",
+            "kind": "agent_reasoning",
+            "summary": "Confirm hook-owned edit-loop behavior.",
+            "detail": "Inspect generated authoring guidance and recovery hints. They should not ask agents to rerun authoring check commands during normal edits; agents should read hook feedback and collect final validation evidence before handoff.",
+            "commands": [
+              "gdh guidance status"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh authoring check --mode final --target <target>"
+            ]
+          }
+        ]
+      }
     }
   ]
 }

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

@@ -424,7 +424,6 @@ export function renderCursorRule(input) {
         "This GDH-managed Godot target uses GDH.",
         "Apply this rule only for files inside this Godot target or when the user explicitly asks for GDH work on this target.",
         `Follow the canonical target-local entrypoint in [AGENTS.md](../../${prefixed("AGENTS.md")}), then load the canonical guidance index at [.gdh/guidance/README.md](../../${prefixed(".gdh/guidance/README.md")}) before substantive Godot work.`,
-        `For runtime bridge usage, load [.gdh/guidance/authoring-and-validation.md](../../${prefixed(".gdh/guidance/authoring-and-validation.md")}) and follow its runtime bridge section.`,
         "Do not duplicate or override the canonical GDH guidance chain here.",
         "",
     ].join("\n");
@@ -2685,7 +2684,77 @@ async function isDefaultRulesBoilerplate(targetPath, projectConfig) {
     // signal needed to decide whether overwriting the file is safe.
     const expected = renderRulesYaml(createDefaultRulesDocument(projectConfig));
     const actual = renderRulesYaml(onDisk);
-    return actual === expected;
+    return actual === expected || isPriorDefaultRulesBoilerplate(actual);
+}
+function isPriorDefaultRulesBoilerplate(content) {
+    // v0.26.8 changed only the default authoring-validation wording to stop
+    // telling agents to rerun hook-owned checks during edit loops. Prior v3
+    // boilerplate is still GDH-owned default content, so it is safe to refresh.
+    const priorV3Default = `version: ${GDH_RULES_SCHEMA_VERSION}
+hard_rules:
+  - id: "authoring-validation-evidence"
+    summary: "Use GDH authoring check evidence when judging Godot code validity."
+    rationale: "Authoring validity should come from GDH diagnostics, not readiness guesses."
+    validation_expectations:
+      []
+soft_guidance:
+  - id: "prefer-gdh-surfaces"
+    summary: "Prefer GDH status, target-prepare, authoring, import-refresh, and guidance surfaces over ad hoc Godot-state guesses."
+    rationale: "GDH exists to make Godot authoring and validation constraints inspectable instead of folklore-driven."
+    validation_expectations:
+      []
+prohibited_patterns:
+  - id: "generated-godot-state-is-not-truth"
+    summary: "Do not treat \`.godot/\` generated state as durable project truth or hand-edit it unless a project-specific rule says otherwise."
+    rationale: "Generated import/editor state is environment-sensitive and should not become the source of truth for agents."
+    validation_expectations:
+      []
+  - id: "dont-copy-project-local-env-files-by-default"
+    summary: "Do not copy project-local env files such as \`.env.local\` as part of default GDH target preparation unless project-specific guidance explicitly says to do so."
+    rationale: "Default GDH preparation should stay deterministic and should not silently inherit machine-local env behavior from another checkout."
+    validation_expectations:
+      []
+path_scopes:
+  - id: "authoring-files"
+    summary: "Authoring-facing Godot source and project files require an authoring check for code-validity evidence."
+    path_globs:
+      - "**/*.gd"
+      - "**/*.tscn"
+      - "**/*.tres"
+      - "project.godot"
+    hard_rules:
+      []
+    soft_guidance:
+      []
+    prohibited_patterns:
+      []
+    validation_expectations:
+      - id: "authoring-check"
+        kind: "authoring_check"
+        required: true
+        summary: "Run \`gdh authoring check\` after changing Godot source or project configuration files."
+  - id: "editor-plugin-files"
+    summary: "EditorPlugin and plugin configuration work requires editor-side validation, not only runtime confidence."
+    path_globs:
+      - "addons/**/plugin.gd"
+      - "addons/**/plugin.cfg"
+    hard_rules:
+      []
+    soft_guidance:
+      - id: "surface-editor-validation"
+        summary: "Surface editor-side caveats explicitly when plugin or \`@tool\` work is involved."
+        rationale: "Phase 3 already detects editor-side caveats at the point of use and Phase 4 should preserve that distinction."
+        validation_expectations:
+          []
+    prohibited_patterns:
+      []
+    validation_expectations:
+      - id: "editor-validation"
+        kind: "editor_validation"
+        required: true
+        summary: "Arrange editor-side validation for \`EditorPlugin\` and plugin configuration changes before claiming code validity."
+`;
+    return content === priorV3Default;
 }
 function inspectAgentContractLifecycleSurface(targetPath, guidanceStatus) {
     const status = guidanceStatus.agentContract;
@@ -2736,7 +2805,7 @@ async function inspectGuidanceIndexLifecycleSurface(guidanceRootPath, commandTar
     const content = await fs
         .readFile(path.join(guidanceRootPath, relativePath), "utf8")
         .catch(() => null);
-    const detectedVersion = readTaggedVersion(content, /<!-- GDH GUIDANCE INDEX VERSION: (\d+) -->/);
+    const detectedVersion = readTaggedVersion(content, /<!-- (?:GDH )?GUIDANCE INDEX VERSION: (\d+) -->/);
     const probes = [
         createVersionProbe({
             targetPath: guidanceRootPath,