@skillcap/gdh 0.26.7 → 0.26.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/INSTALL-BUNDLE.json +1 -1
  2. package/RELEASE-SPAN-UPDATE-CONTRACTS.json +61 -0
  3. package/node_modules/@gdh/adapters/dist/index.d.ts.map +1 -1
  4. package/node_modules/@gdh/adapters/dist/index.js +71 -1
  5. package/node_modules/@gdh/adapters/dist/index.js.map +1 -1
  6. package/node_modules/@gdh/adapters/dist/self-update-mechanics.d.ts +4 -2
  7. package/node_modules/@gdh/adapters/dist/self-update-mechanics.d.ts.map +1 -1
  8. package/node_modules/@gdh/adapters/dist/self-update-mechanics.js +4 -2
  9. package/node_modules/@gdh/adapters/dist/self-update-mechanics.js.map +1 -1
  10. package/node_modules/@gdh/adapters/dist/skill-rendering.js +3 -3
  11. package/node_modules/@gdh/adapters/dist/skill-rendering.js.map +1 -1
  12. package/node_modules/@gdh/adapters/dist/templates/authoring-hook.js.tpl +22 -26
  13. package/node_modules/@gdh/adapters/package.json +8 -8
  14. package/node_modules/@gdh/authoring/package.json +2 -2
  15. package/node_modules/@gdh/cli/dist/migrate.js +1 -1
  16. package/node_modules/@gdh/cli/dist/migrate.js.map +1 -1
  17. package/node_modules/@gdh/cli/package.json +10 -10
  18. package/node_modules/@gdh/core/dist/index.d.ts +6 -4
  19. package/node_modules/@gdh/core/dist/index.d.ts.map +1 -1
  20. package/node_modules/@gdh/core/dist/index.js +6 -4
  21. package/node_modules/@gdh/core/dist/index.js.map +1 -1
  22. package/node_modules/@gdh/core/dist/migrations/entries/s2c2_to_s2c3_rules_schema_v2_to_v3.d.ts.map +1 -1
  23. package/node_modules/@gdh/core/dist/migrations/entries/s2c2_to_s2c3_rules_schema_v2_to_v3.js +8 -4
  24. package/node_modules/@gdh/core/dist/migrations/entries/s2c2_to_s2c3_rules_schema_v2_to_v3.js.map +1 -1
  25. package/node_modules/@gdh/core/package.json +1 -1
  26. package/node_modules/@gdh/docs/dist/agent-contract.js +1 -1
  27. package/node_modules/@gdh/docs/dist/agent-contract.js.map +1 -1
  28. package/node_modules/@gdh/docs/dist/rules.js +3 -3
  29. package/node_modules/@gdh/docs/dist/rules.js.map +1 -1
  30. package/node_modules/@gdh/docs/dist/templates/guidance/authoring-and-validation.md.tpl +4 -3
  31. package/node_modules/@gdh/docs/package.json +2 -2
  32. package/node_modules/@gdh/mcp/package.json +8 -8
  33. package/node_modules/@gdh/observability/package.json +2 -2
  34. package/node_modules/@gdh/runtime/package.json +2 -2
  35. package/node_modules/@gdh/scan/package.json +3 -3
  36. package/node_modules/@gdh/verify/package.json +7 -7
  37. package/package.json +11 -11
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "product": "GDH",
3
- "version": "0.26.7",
3
+ "version": "0.26.8",
4
4
  "installMode": "packaged_install"
5
5
  }
@@ -3353,6 +3353,67 @@
3353
3353
  }
3354
3354
  ]
3355
3355
  }
3356
+ },
3357
+ {
3358
+ "version": "0.26.8",
3359
+ "releaseTag": "v0.26.8",
3360
+ "migrationStatus": "required",
3361
+ "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.",
3362
+ "releaseHighlights": {
3363
+ "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.",
3364
+ "operatorChanges": [
3365
+ "**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.",
3366
+ "**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.",
3367
+ "**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.",
3368
+ "**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."
3369
+ ]
3370
+ },
3371
+ "updateContract": {
3372
+ "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.",
3373
+ "steps": [
3374
+ {
3375
+ "id": "install_v0_26_8",
3376
+ "kind": "mechanical",
3377
+ "summary": "Install the v0.26.8 GDH package.",
3378
+ "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.",
3379
+ "commands": [
3380
+ "gdh self-update --apply"
3381
+ ],
3382
+ "validationCommands": [
3383
+ "gdh status",
3384
+ "gdh adapters status",
3385
+ "gdh guidance status"
3386
+ ]
3387
+ },
3388
+ {
3389
+ "id": "rebake_authoring_feedback_surfaces",
3390
+ "kind": "mechanical",
3391
+ "summary": "Re-bake managed authoring feedback surfaces.",
3392
+ "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.",
3393
+ "commands": [
3394
+ "gdh migrate --apply"
3395
+ ],
3396
+ "validationCommands": [
3397
+ "gdh adapters status",
3398
+ "gdh guidance status",
3399
+ "gdh status"
3400
+ ]
3401
+ },
3402
+ {
3403
+ "id": "confirm_hook_owned_edit_loop",
3404
+ "kind": "agent_reasoning",
3405
+ "summary": "Confirm hook-owned edit-loop behavior.",
3406
+ "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.",
3407
+ "commands": [
3408
+ "gdh guidance status"
3409
+ ],
3410
+ "validationCommands": [
3411
+ "gdh status",
3412
+ "gdh authoring check --mode final --target <target>"
3413
+ ]
3414
+ }
3415
+ ]
3416
+ }
3356
3417
  }
3357
3418
  ]
3358
3419
  }
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -2684,7 +2684,77 @@ async function isDefaultRulesBoilerplate(targetPath, projectConfig) {
2684
2684
  // signal needed to decide whether overwriting the file is safe.
2685
2685
  const expected = renderRulesYaml(createDefaultRulesDocument(projectConfig));
2686
2686
  const actual = renderRulesYaml(onDisk);
2687
- return actual === expected;
2687
+ return actual === expected || isPriorDefaultRulesBoilerplate(actual);
2688
+ }
2689
+ function isPriorDefaultRulesBoilerplate(content) {
2690
+ // v0.26.8 changed only the default authoring-validation wording to stop
2691
+ // telling agents to rerun hook-owned checks during edit loops. Prior v3
2692
+ // boilerplate is still GDH-owned default content, so it is safe to refresh.
2693
+ const priorV3Default = `version: ${GDH_RULES_SCHEMA_VERSION}
2694
+ hard_rules:
2695
+ - id: "authoring-validation-evidence"
2696
+ summary: "Use GDH authoring check evidence when judging Godot code validity."
2697
+ rationale: "Authoring validity should come from GDH diagnostics, not readiness guesses."
2698
+ validation_expectations:
2699
+ []
2700
+ soft_guidance:
2701
+ - id: "prefer-gdh-surfaces"
2702
+ summary: "Prefer GDH status, target-prepare, authoring, import-refresh, and guidance surfaces over ad hoc Godot-state guesses."
2703
+ rationale: "GDH exists to make Godot authoring and validation constraints inspectable instead of folklore-driven."
2704
+ validation_expectations:
2705
+ []
2706
+ prohibited_patterns:
2707
+ - id: "generated-godot-state-is-not-truth"
2708
+ summary: "Do not treat \`.godot/\` generated state as durable project truth or hand-edit it unless a project-specific rule says otherwise."
2709
+ rationale: "Generated import/editor state is environment-sensitive and should not become the source of truth for agents."
2710
+ validation_expectations:
2711
+ []
2712
+ - id: "dont-copy-project-local-env-files-by-default"
2713
+ 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."
2714
+ rationale: "Default GDH preparation should stay deterministic and should not silently inherit machine-local env behavior from another checkout."
2715
+ validation_expectations:
2716
+ []
2717
+ path_scopes:
2718
+ - id: "authoring-files"
2719
+ summary: "Authoring-facing Godot source and project files require an authoring check for code-validity evidence."
2720
+ path_globs:
2721
+ - "**/*.gd"
2722
+ - "**/*.tscn"
2723
+ - "**/*.tres"
2724
+ - "project.godot"
2725
+ hard_rules:
2726
+ []
2727
+ soft_guidance:
2728
+ []
2729
+ prohibited_patterns:
2730
+ []
2731
+ validation_expectations:
2732
+ - id: "authoring-check"
2733
+ kind: "authoring_check"
2734
+ required: true
2735
+ summary: "Run \`gdh authoring check\` after changing Godot source or project configuration files."
2736
+ - id: "editor-plugin-files"
2737
+ summary: "EditorPlugin and plugin configuration work requires editor-side validation, not only runtime confidence."
2738
+ path_globs:
2739
+ - "addons/**/plugin.gd"
2740
+ - "addons/**/plugin.cfg"
2741
+ hard_rules:
2742
+ []
2743
+ soft_guidance:
2744
+ - id: "surface-editor-validation"
2745
+ summary: "Surface editor-side caveats explicitly when plugin or \`@tool\` work is involved."
2746
+ rationale: "Phase 3 already detects editor-side caveats at the point of use and Phase 4 should preserve that distinction."
2747
+ validation_expectations:
2748
+ []
2749
+ prohibited_patterns:
2750
+ []
2751
+ validation_expectations:
2752
+ - id: "editor-validation"
2753
+ kind: "editor_validation"
2754
+ required: true
2755
+ summary: "Arrange editor-side validation for \`EditorPlugin\` and plugin configuration changes before claiming code validity."
2756
+ `;
2757
+ return content === priorV3Default;
2688
2758
  }
2689
2759
  function inspectAgentContractLifecycleSurface(targetPath, guidanceStatus) {
2690
2760
  const status = guidanceStatus.agentContract;