@skillcap/gdh 0.24.0 → 0.25.0

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 (88) hide show
  1. package/INSTALL-BUNDLE.json +1 -1
  2. package/RELEASE-SPAN-UPDATE-CONTRACTS.json +58 -0
  3. package/node_modules/@gdh/adapters/dist/authoring-hook-render.d.ts.map +1 -1
  4. package/node_modules/@gdh/adapters/dist/authoring-hook-render.js +7 -130
  5. package/node_modules/@gdh/adapters/dist/authoring-hook-render.js.map +1 -1
  6. package/node_modules/@gdh/adapters/dist/claude-statusline-render.d.ts.map +1 -1
  7. package/node_modules/@gdh/adapters/dist/claude-statusline-render.js +4 -27
  8. package/node_modules/@gdh/adapters/dist/claude-statusline-render.js.map +1 -1
  9. package/node_modules/@gdh/adapters/dist/claude-update-hook-render.d.ts.map +1 -1
  10. package/node_modules/@gdh/adapters/dist/claude-update-hook-render.js +5 -39
  11. package/node_modules/@gdh/adapters/dist/claude-update-hook-render.js.map +1 -1
  12. package/node_modules/@gdh/adapters/dist/claude-update-worker-render.d.ts.map +1 -1
  13. package/node_modules/@gdh/adapters/dist/claude-update-worker-render.js +5 -67
  14. package/node_modules/@gdh/adapters/dist/claude-update-worker-render.js.map +1 -1
  15. package/node_modules/@gdh/adapters/dist/index.d.ts +1 -2
  16. package/node_modules/@gdh/adapters/dist/index.d.ts.map +1 -1
  17. package/node_modules/@gdh/adapters/dist/index.js +55 -41
  18. package/node_modules/@gdh/adapters/dist/index.js.map +1 -1
  19. package/node_modules/@gdh/adapters/dist/skill-rendering.d.ts +2 -5
  20. package/node_modules/@gdh/adapters/dist/skill-rendering.d.ts.map +1 -1
  21. package/node_modules/@gdh/adapters/dist/skill-rendering.js +17 -59
  22. package/node_modules/@gdh/adapters/dist/skill-rendering.js.map +1 -1
  23. package/node_modules/@gdh/adapters/dist/template-assets.d.ts +2 -0
  24. package/node_modules/@gdh/adapters/dist/template-assets.d.ts.map +1 -0
  25. package/node_modules/@gdh/adapters/dist/template-assets.js +26 -0
  26. package/node_modules/@gdh/adapters/dist/template-assets.js.map +1 -0
  27. package/node_modules/@gdh/adapters/dist/templates/authoring-hook.js.tpl +128 -0
  28. package/node_modules/@gdh/adapters/dist/templates/claude-check-update-hook.js.tpl +37 -0
  29. package/node_modules/@gdh/adapters/dist/templates/claude-check-update-worker.js.tpl +65 -0
  30. package/node_modules/@gdh/adapters/dist/templates/claude-statusline.js.tpl +25 -0
  31. package/node_modules/@gdh/adapters/package.json +8 -8
  32. package/node_modules/@gdh/authoring/package.json +2 -2
  33. package/node_modules/@gdh/cli/dist/index.d.ts.map +1 -1
  34. package/node_modules/@gdh/cli/dist/index.js +5 -4
  35. package/node_modules/@gdh/cli/dist/index.js.map +1 -1
  36. package/node_modules/@gdh/cli/dist/migrate.d.ts.map +1 -1
  37. package/node_modules/@gdh/cli/dist/migrate.js +65 -2
  38. package/node_modules/@gdh/cli/dist/migrate.js.map +1 -1
  39. package/node_modules/@gdh/cli/dist/setup.d.ts +4 -0
  40. package/node_modules/@gdh/cli/dist/setup.d.ts.map +1 -1
  41. package/node_modules/@gdh/cli/dist/setup.js +8 -67
  42. package/node_modules/@gdh/cli/dist/setup.js.map +1 -1
  43. package/node_modules/@gdh/cli/package.json +10 -10
  44. package/node_modules/@gdh/core/dist/index.d.ts +6 -4
  45. package/node_modules/@gdh/core/dist/index.d.ts.map +1 -1
  46. package/node_modules/@gdh/core/dist/index.js +5 -4
  47. package/node_modules/@gdh/core/dist/index.js.map +1 -1
  48. package/node_modules/@gdh/core/dist/migrations/managed-surface-classes.d.ts +14 -14
  49. package/node_modules/@gdh/core/dist/migrations/managed-surface-classes.js +15 -15
  50. package/node_modules/@gdh/core/dist/migrations/managed-surface-classes.js.map +1 -1
  51. package/node_modules/@gdh/core/dist/migrations/managed-target-surface-inventory.d.ts +294 -0
  52. package/node_modules/@gdh/core/dist/migrations/managed-target-surface-inventory.d.ts.map +1 -0
  53. package/node_modules/@gdh/core/dist/migrations/managed-target-surface-inventory.js +365 -0
  54. package/node_modules/@gdh/core/dist/migrations/managed-target-surface-inventory.js.map +1 -0
  55. package/node_modules/@gdh/core/package.json +1 -1
  56. package/node_modules/@gdh/docs/dist/agent-contract.d.ts +2 -1
  57. package/node_modules/@gdh/docs/dist/agent-contract.d.ts.map +1 -1
  58. package/node_modules/@gdh/docs/dist/agent-contract.js +3 -2
  59. package/node_modules/@gdh/docs/dist/agent-contract.js.map +1 -1
  60. package/node_modules/@gdh/docs/dist/guidance.d.ts +2 -0
  61. package/node_modules/@gdh/docs/dist/guidance.d.ts.map +1 -1
  62. package/node_modules/@gdh/docs/dist/guidance.js +26 -254
  63. package/node_modules/@gdh/docs/dist/guidance.js.map +1 -1
  64. package/node_modules/@gdh/docs/dist/index.d.ts +1 -1
  65. package/node_modules/@gdh/docs/dist/index.d.ts.map +1 -1
  66. package/node_modules/@gdh/docs/dist/index.js +1 -1
  67. package/node_modules/@gdh/docs/dist/index.js.map +1 -1
  68. package/node_modules/@gdh/docs/dist/query.d.ts.map +1 -1
  69. package/node_modules/@gdh/docs/dist/query.js +4 -5
  70. package/node_modules/@gdh/docs/dist/query.js.map +1 -1
  71. package/node_modules/@gdh/docs/dist/recovery-hints.js +1 -1
  72. package/node_modules/@gdh/docs/dist/recovery-hints.js.map +1 -1
  73. package/node_modules/@gdh/docs/dist/template-assets.d.ts +2 -0
  74. package/node_modules/@gdh/docs/dist/template-assets.d.ts.map +1 -0
  75. package/node_modules/@gdh/docs/dist/template-assets.js +26 -0
  76. package/node_modules/@gdh/docs/dist/template-assets.js.map +1 -0
  77. package/node_modules/@gdh/docs/dist/templates/guidance/authoring-and-validation.md.tpl +111 -0
  78. package/node_modules/@gdh/docs/dist/templates/guidance/gdh-glossary.md.tpl +34 -0
  79. package/node_modules/@gdh/docs/dist/templates/guidance/persistence-semantics.md.tpl +24 -0
  80. package/node_modules/@gdh/docs/dist/templates/guidance/project-migration.md.tpl +19 -0
  81. package/node_modules/@gdh/docs/dist/templates/guidance/project-surfaces.md.tpl +14 -0
  82. package/node_modules/@gdh/docs/package.json +2 -2
  83. package/node_modules/@gdh/mcp/package.json +8 -8
  84. package/node_modules/@gdh/observability/package.json +2 -2
  85. package/node_modules/@gdh/runtime/package.json +2 -2
  86. package/node_modules/@gdh/scan/package.json +3 -3
  87. package/node_modules/@gdh/verify/package.json +7 -7
  88. package/package.json +11 -11
@@ -0,0 +1,365 @@
1
+ import { GDH_MANAGED_SURFACE_CLASSES } from "./managed-surface-classes.js";
2
+ const GDH_SKILL_IDS = [
3
+ "onboard",
4
+ "status",
5
+ "scan",
6
+ "migrate",
7
+ "update",
8
+ "check",
9
+ "prepare",
10
+ "run-game",
11
+ ];
12
+ const GDH_SKILL_PURPOSES = {
13
+ onboard: "first-use readiness handoff",
14
+ status: "readiness and lifecycle status interpretation",
15
+ scan: "Godot target discovery",
16
+ migrate: "managed surface migration and repair",
17
+ update: "pinned GDH self-update",
18
+ check: "authoring validation evidence",
19
+ prepare: "cold worktree and import-state preparation",
20
+ "run-game": "runtime run configuration execution",
21
+ };
22
+ const AGENT_SKILL_LOCATIONS = {
23
+ claude: ".claude/skills",
24
+ codex: ".agents/skills",
25
+ cursor: ".cursor/skills",
26
+ };
27
+ const AGENT_SKILL_DISCOVERY_NOTES = {
28
+ claude: "Claude Code loads project skills from the provider-native .claude/skills surface.",
29
+ codex: "Codex consumes shared project skills from .agents/skills; legacy .codex/skills files are cleanup-only.",
30
+ cursor: "Cursor consumes project skills from the provider-native .cursor/skills surface.",
31
+ };
32
+ const skillEntries = Object.entries(AGENT_SKILL_LOCATIONS).flatMap(([agent, basePath]) => GDH_SKILL_IDS.map((skillId) => ({
33
+ surfaceId: `skill.${agent}.${skillId}`,
34
+ purpose: `${agent} ${GDH_SKILL_PURPOSES[skillId]} skill wrapper around GDH CLI/MCP behavior.`,
35
+ owner: "gdh",
36
+ targetLocations: [`${basePath}/gdh-${skillId}/SKILL.md`],
37
+ discoveryRequirement: "provider_skill",
38
+ migrationBehavior: "Deterministically re-render from the current GDH version during setup, migrate, repair, and self-update.",
39
+ staleBehavior: "Treat version or marker drift as stale; replace the managed skill and remove known legacy duplicates where the adapter installer owns them.",
40
+ finalDisposition: skillId === "check" ? "replace_with_hook_mcp_or_cli_behavior" : "move_into_skill",
41
+ dispositionRationale: skillId === "check"
42
+ ? `${AGENT_SKILL_DISCOVERY_NOTES[agent]} Retire this validation skill; validation evidence belongs to GDH hooks, MCP/CLI status, and explicit authoring-check commands.`
43
+ : `${AGENT_SKILL_DISCOVERY_NOTES[agent]} Keep workflow instructions inside the skill instead of leaking command guidance into target docs.`,
44
+ followUpPhase: skillId === "check" ? null : "78",
45
+ })));
46
+ const staticEntries = [
47
+ {
48
+ surfaceId: "cursor_rule",
49
+ purpose: "Minimal Cursor rule that routes GDH work to the installed GDH skills and target-local surfaces.",
50
+ owner: "gdh",
51
+ targetLocations: [".cursor/rules/gdh-agent.mdc"],
52
+ discoveryRequirement: "provider_rule",
53
+ migrationBehavior: "Deterministically re-render when adapter surfaces are installed or repaired.",
54
+ staleBehavior: "Replace marker-owned drift; keep user-authored Cursor rules outside the managed file untouched.",
55
+ finalDisposition: "keep_discoverability_shim",
56
+ dispositionRationale: "Cursor rules are a provider-native discovery hook. They should stay thin and point to skills instead of duplicating guidance.",
57
+ followUpPhase: "78",
58
+ },
59
+ {
60
+ surfaceId: "claude_onboard_command",
61
+ purpose: "Legacy Claude command compatibility for the onboard workflow.",
62
+ owner: "gdh",
63
+ targetLocations: [".claude/skills/gdh-onboard/SKILL.md"],
64
+ discoveryRequirement: "provider_skill",
65
+ migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/onboard.md files are removed when GDH owns them.",
66
+ staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.",
67
+ finalDisposition: "move_into_skill",
68
+ dispositionRationale: "The onboard workflow belongs in the gdh-onboard skill; command shims should not carry separate instructions.",
69
+ followUpPhase: "78",
70
+ },
71
+ {
72
+ surfaceId: "claude_status_command",
73
+ purpose: "Legacy Claude command compatibility for status interpretation.",
74
+ owner: "gdh",
75
+ targetLocations: [".claude/skills/gdh-status/SKILL.md"],
76
+ discoveryRequirement: "provider_skill",
77
+ migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/status.md files are removed when GDH owns them.",
78
+ staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.",
79
+ finalDisposition: "move_into_skill",
80
+ dispositionRationale: "Status interpretation belongs in the gdh-status skill, backed by structured GDH CLI output.",
81
+ followUpPhase: "78",
82
+ },
83
+ {
84
+ surfaceId: "claude_scan_command",
85
+ purpose: "Legacy Claude command compatibility for Godot target discovery.",
86
+ owner: "gdh",
87
+ targetLocations: [".claude/skills/gdh-scan/SKILL.md"],
88
+ discoveryRequirement: "provider_skill",
89
+ migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/scan.md files are removed when GDH owns them.",
90
+ staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.",
91
+ finalDisposition: "move_into_skill",
92
+ dispositionRationale: "Scan workflow instructions belong in the gdh-scan skill, not in a second command document.",
93
+ followUpPhase: "78",
94
+ },
95
+ {
96
+ surfaceId: "claude_migrate_command",
97
+ purpose: "Legacy Claude command compatibility for managed surface migration.",
98
+ owner: "gdh",
99
+ targetLocations: [".claude/skills/gdh-migrate/SKILL.md"],
100
+ discoveryRequirement: "provider_skill",
101
+ migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/migrate.md files are removed when GDH owns them.",
102
+ staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.",
103
+ finalDisposition: "move_into_skill",
104
+ dispositionRationale: "Migration approval and terminal-state guidance belongs in the gdh-migrate skill.",
105
+ followUpPhase: "78",
106
+ },
107
+ {
108
+ surfaceId: "claude_update_command",
109
+ purpose: "Legacy Claude command compatibility for GDH self-update.",
110
+ owner: "gdh",
111
+ targetLocations: [".claude/skills/gdh-update/SKILL.md"],
112
+ discoveryRequirement: "provider_skill",
113
+ migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/update.md files are removed when GDH owns them.",
114
+ staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.",
115
+ finalDisposition: "move_into_skill",
116
+ dispositionRationale: "Update workflow guidance belongs in the gdh-update skill and should not be duplicated as a command doc.",
117
+ followUpPhase: "78",
118
+ },
119
+ {
120
+ surfaceId: "claude_check_command",
121
+ purpose: "Legacy Claude command compatibility for authoring validation checks.",
122
+ owner: "gdh",
123
+ targetLocations: [".claude/skills/gdh-check/SKILL.md"],
124
+ discoveryRequirement: "provider_skill",
125
+ migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/check.md files are removed when GDH owns them.",
126
+ staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.",
127
+ finalDisposition: "replace_with_hook_mcp_or_cli_behavior",
128
+ dispositionRationale: "Validation should be driven by hook, MCP, and CLI behavior. The legacy command and generated check skill are retired.",
129
+ followUpPhase: null,
130
+ },
131
+ {
132
+ surfaceId: "claude_prepare_command",
133
+ purpose: "Legacy Claude command compatibility for target preparation.",
134
+ owner: "gdh",
135
+ targetLocations: [".claude/skills/gdh-prepare/SKILL.md"],
136
+ discoveryRequirement: "provider_skill",
137
+ migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/prepare.md files are removed when GDH owns them.",
138
+ staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.",
139
+ finalDisposition: "move_into_skill",
140
+ dispositionRationale: "Preparation workflow guidance belongs in the gdh-prepare skill, backed by GDH commands.",
141
+ followUpPhase: "78",
142
+ },
143
+ {
144
+ surfaceId: "claude_run_game_command",
145
+ purpose: "Legacy Claude command compatibility for run configuration execution.",
146
+ owner: "gdh",
147
+ targetLocations: [".claude/skills/gdh-run-game/SKILL.md"],
148
+ discoveryRequirement: "provider_skill",
149
+ migrationBehavior: "Current installs use Claude skills; legacy .claude/commands/gdh/run-game.md files are removed when GDH owns them.",
150
+ staleBehavior: "Treat legacy command files as stale owned duplicates after the skill exists.",
151
+ finalDisposition: "move_into_skill",
152
+ dispositionRationale: "Runtime workflow guidance belongs in the gdh-run-game skill and should reference .gdh run configurations.",
153
+ followUpPhase: "78",
154
+ },
155
+ {
156
+ surfaceId: "mcp_config_entry",
157
+ purpose: "Managed GDH MCP server entry inside Claude and Cursor project MCP files.",
158
+ owner: "mixed",
159
+ targetLocations: [".mcp.json#mcpServers.gdh", ".cursor/mcp.json#mcpServers.gdh"],
160
+ discoveryRequirement: "provider_mcp_config",
161
+ migrationBehavior: "Patch only the GDH-owned MCP entry; leave surrounding project/user MCP config as project-native data.",
162
+ staleBehavior: "Replace only the managed server entry when pin or invocation drifts.",
163
+ finalDisposition: "keep_discoverability_shim",
164
+ dispositionRationale: "Claude and Cursor require provider-visible MCP config. GDH should own the smallest possible entry, not the whole file.",
165
+ followUpPhase: "79",
166
+ },
167
+ {
168
+ surfaceId: "codex_project_mcp_section",
169
+ purpose: "Managed GDH MCP server section inside repo-local Codex config.",
170
+ owner: "mixed",
171
+ targetLocations: [".codex/config.toml#[mcp_servers.gdh]"],
172
+ discoveryRequirement: "provider_mcp_config",
173
+ migrationBehavior: "Patch the GDH-owned TOML section in repo-local config; do not register user-local Codex MCP as part of normal setup.",
174
+ staleBehavior: "Replace the managed section when the pin or invocation drifts.",
175
+ finalDisposition: "keep_discoverability_shim",
176
+ dispositionRationale: "Codex needs a provider-readable MCP declaration. GDH should keep it repo-local and marker-bounded where possible.",
177
+ followUpPhase: "79",
178
+ },
179
+ {
180
+ surfaceId: "codex_authoring_hook_block",
181
+ purpose: "Codex authoring hook registration for post-edit GDH validation behavior.",
182
+ owner: "gdh",
183
+ targetLocations: [".codex/config.toml#GDH managed authoring hooks"],
184
+ discoveryRequirement: "provider_hook_config",
185
+ migrationBehavior: "Patch the managed hook block and feature flag in repo-local Codex config.",
186
+ staleBehavior: "Replace the managed hook block when version, command, or path drifts.",
187
+ finalDisposition: "replace_with_hook_mcp_or_cli_behavior",
188
+ dispositionRationale: "Validation enforcement should be behavior, not guidance. The config block exists only to wire the behavior.",
189
+ followUpPhase: "79",
190
+ },
191
+ {
192
+ surfaceId: "authoring_hook",
193
+ purpose: "Provider hook script that turns authoring edits into GDH diagnostics/check feedback.",
194
+ owner: "gdh",
195
+ targetLocations: [
196
+ ".claude/hooks/gdh-authoring-guard.js",
197
+ ".codex/hooks/gdh-authoring-guard.js",
198
+ ],
199
+ discoveryRequirement: "provider_hook_config",
200
+ migrationBehavior: "Deterministically re-render hook scripts for providers that support GDH hooks.",
201
+ staleBehavior: "Replace marker-owned script drift; never depend on agents remembering validation instructions.",
202
+ finalDisposition: "replace_with_hook_mcp_or_cli_behavior",
203
+ dispositionRationale: "Authoring validation should run through hooks and GDH CLI evidence rather than prose instructions.",
204
+ followUpPhase: "79",
205
+ },
206
+ {
207
+ surfaceId: "claude_update_hook",
208
+ purpose: "Claude SessionStart hook that checks whether the pinned GDH install is stale.",
209
+ owner: "gdh",
210
+ targetLocations: [".claude/hooks/gdh-check-update.js"],
211
+ discoveryRequirement: "provider_hook_config",
212
+ migrationBehavior: "Deterministically re-render the managed hook script.",
213
+ staleBehavior: "Replace marker-owned script drift; stale update awareness should not live in docs.",
214
+ finalDisposition: "replace_with_hook_mcp_or_cli_behavior",
215
+ dispositionRationale: "Update awareness is event-driven behavior. Guidance should only explain outcomes when surfaced.",
216
+ followUpPhase: "79",
217
+ },
218
+ {
219
+ surfaceId: "claude_update_worker",
220
+ purpose: "Background worker used by the Claude update-check hook.",
221
+ owner: "gdh",
222
+ targetLocations: [".claude/hooks/gdh-check-update-worker.js"],
223
+ discoveryRequirement: "provider_hook_config",
224
+ migrationBehavior: "Deterministically re-render the managed worker script.",
225
+ staleBehavior: "Replace marker-owned worker drift with the current version.",
226
+ finalDisposition: "replace_with_hook_mcp_or_cli_behavior",
227
+ dispositionRationale: "This is implementation machinery for a hook, not a target-project documentation surface.",
228
+ followUpPhase: "79",
229
+ },
230
+ {
231
+ surfaceId: "claude_statusline",
232
+ purpose: "Optional Claude statusline script for surfacing GDH target status.",
233
+ owner: "gdh",
234
+ targetLocations: [".claude/hooks/gdh-statusline.js"],
235
+ discoveryRequirement: "provider_hook_config",
236
+ migrationBehavior: "Deterministically re-render the optional script; statusline registration remains opt-in.",
237
+ staleBehavior: "Replace marker-owned script drift; do not overwrite unrelated statusline settings.",
238
+ finalDisposition: "replace_with_hook_mcp_or_cli_behavior",
239
+ dispositionRationale: "Statusline behavior belongs in an executable script with opt-in registration, not in general guidance.",
240
+ followUpPhase: "79",
241
+ },
242
+ {
243
+ surfaceId: "agents_md_managed_block",
244
+ purpose: "Root agent-instruction pointer that tells agents this target is GDH-managed.",
245
+ owner: "mixed",
246
+ targetLocations: ["AGENTS.md#GDH managed block"],
247
+ discoveryRequirement: "root_agent_instruction",
248
+ migrationBehavior: "Patch only the GDH-owned marker block; preserve user-authored AGENTS.md content around it.",
249
+ staleBehavior: "Replace the managed block when its version or target pointers drift.",
250
+ finalDisposition: "keep_discoverability_shim",
251
+ dispositionRationale: "A tiny root pointer is useful for discoverability, but full GDH docs must not live in root instructions.",
252
+ followUpPhase: "77",
253
+ },
254
+ {
255
+ surfaceId: "guidance_unit_set",
256
+ purpose: "Generated GDH guidance units currently emitted as target-local docs.",
257
+ owner: "gdh",
258
+ targetLocations: [".gdh/guidance/*.md"],
259
+ discoveryRequirement: "durable_gdh_truth",
260
+ migrationBehavior: "Current versions deterministically re-render units from package templates.",
261
+ staleBehavior: "Version drift replaces generated units in the GDH-owned guidance directory.",
262
+ finalDisposition: "move_under_gdh",
263
+ dispositionRationale: "Durable GDH target guidance belongs under .gdh. Command-specific/onboarding guidance should be folded into skills during the skill repack.",
264
+ followUpPhase: null,
265
+ },
266
+ {
267
+ surfaceId: "guidance_index",
268
+ purpose: "Generated index for GDH guidance units.",
269
+ owner: "gdh",
270
+ targetLocations: [".gdh/guidance/README.md"],
271
+ discoveryRequirement: "durable_gdh_truth",
272
+ migrationBehavior: "Current versions deterministically re-render the index from generated units.",
273
+ staleBehavior: "Version drift replaces the generated index in the GDH-owned guidance directory.",
274
+ finalDisposition: "move_under_gdh",
275
+ dispositionRationale: "The index should move with the guidance corpus under .gdh, leaving only minimal root/provider pointers.",
276
+ followUpPhase: null,
277
+ },
278
+ {
279
+ surfaceId: "gdh_project_yaml",
280
+ purpose: "Durable GDH project configuration and pinned GDH version.",
281
+ owner: "mixed",
282
+ targetLocations: [".gdh/project.yaml"],
283
+ discoveryRequirement: "durable_gdh_truth",
284
+ migrationBehavior: "Schema migrations preserve user-selected values while updating GDH-owned shape.",
285
+ staleBehavior: "Schema/pin drift is handled by migration planning and explicit apply.",
286
+ finalDisposition: "move_under_gdh",
287
+ dispositionRationale: "This already lives in the correct durable GDH namespace.",
288
+ followUpPhase: null,
289
+ },
290
+ {
291
+ surfaceId: "gdh_rules_yaml",
292
+ purpose: "Durable GDH project rules and policy defaults.",
293
+ owner: "mixed",
294
+ targetLocations: [".gdh/rules.yaml"],
295
+ discoveryRequirement: "durable_gdh_truth",
296
+ migrationBehavior: "Byte-equal defaults can be upgraded automatically; user-customized rules require conflict-aware migration.",
297
+ staleBehavior: "Default drift is auto-replaceable only when prior content is still known GDH default content.",
298
+ finalDisposition: "move_under_gdh",
299
+ dispositionRationale: "Rules are durable GDH target truth and already live under .gdh.",
300
+ followUpPhase: null,
301
+ },
302
+ {
303
+ surfaceId: "run_configuration_set",
304
+ purpose: "User-authored run configurations managed by GDH schema.",
305
+ owner: "mixed",
306
+ targetLocations: [".gdh/run-configurations/*.yaml"],
307
+ discoveryRequirement: "durable_gdh_truth",
308
+ migrationBehavior: "Schema migrations preserve user-authored run intent and route semantic changes through review.",
309
+ staleBehavior: "Schema drift requires migration; user values are not overwritten as deterministic render output.",
310
+ finalDisposition: "move_under_gdh",
311
+ dispositionRationale: "Run configurations are durable GDH target truth and already live under .gdh.",
312
+ followUpPhase: null,
313
+ },
314
+ {
315
+ surfaceId: "verification_scenario_set",
316
+ purpose: "User-authored verification scenarios managed by GDH schema.",
317
+ owner: "mixed",
318
+ targetLocations: [".gdh/verification-scenarios/*.yaml"],
319
+ discoveryRequirement: "durable_gdh_truth",
320
+ migrationBehavior: "Schema migrations preserve user-authored verification intent and route semantic changes through review.",
321
+ staleBehavior: "Schema drift requires migration; user values are not overwritten as deterministic render output.",
322
+ finalDisposition: "move_under_gdh",
323
+ dispositionRationale: "Verification scenarios are durable GDH target truth and already live under .gdh.",
324
+ followUpPhase: null,
325
+ },
326
+ {
327
+ surfaceId: "project_godot",
328
+ purpose: "Godot project manifest touched only through explicit allowlisted project-native operations.",
329
+ owner: "project",
330
+ targetLocations: ["project.godot"],
331
+ discoveryRequirement: "project_native",
332
+ migrationBehavior: "GDH may only apply registered allowlisted operations such as autoload/plugin updates.",
333
+ staleBehavior: "Unallowlisted drift is project-owned and must not be treated as GDH stale content.",
334
+ finalDisposition: "keep_project_native",
335
+ dispositionRationale: "This is not GDH-owned target guidance. It remains Godot project truth with explicit operation allowlists.",
336
+ followUpPhase: null,
337
+ },
338
+ ];
339
+ export const GDH_MANAGED_TARGET_SURFACE_INVENTORY = [
340
+ ...skillEntries,
341
+ ...staticEntries,
342
+ ];
343
+ export function assertManagedTargetSurfaceInventoryComplete() {
344
+ const classIds = GDH_MANAGED_SURFACE_CLASSES.map((entry) => entry.surfaceId);
345
+ const inventoryIds = GDH_MANAGED_TARGET_SURFACE_INVENTORY.map((entry) => entry.surfaceId);
346
+ const duplicateIds = inventoryIds.filter((id, index) => inventoryIds.indexOf(id) !== index);
347
+ if (duplicateIds.length > 0) {
348
+ throw new Error(`Duplicate managed target surface inventory entries: ${[...new Set(duplicateIds)].join(", ")}`);
349
+ }
350
+ const classIdSet = new Set(classIds);
351
+ const inventoryIdSet = new Set(inventoryIds);
352
+ const missing = classIds.filter((id) => !inventoryIdSet.has(id));
353
+ const extra = inventoryIds.filter((id) => !classIdSet.has(id));
354
+ if (missing.length > 0 || extra.length > 0) {
355
+ throw new Error([
356
+ "GDH managed target surface inventory does not match GDH_MANAGED_SURFACE_CLASSES.",
357
+ missing.length > 0 ? `Missing: ${missing.join(", ")}` : null,
358
+ extra.length > 0 ? `Extra: ${extra.join(", ")}` : null,
359
+ ]
360
+ .filter((line) => line !== null)
361
+ .join(" "));
362
+ }
363
+ }
364
+ assertManagedTargetSurfaceInventoryComplete();
365
+ //# sourceMappingURL=managed-target-surface-inventory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"managed-target-surface-inventory.js","sourceRoot":"","sources":["../../src/migrations/managed-target-surface-inventory.ts"],"names":[],"mappings":"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"}
@@ -10,5 +10,5 @@
10
10
  "import": "./dist/index.js"
11
11
  }
12
12
  },
13
- "version": "0.24.0"
13
+ "version": "0.25.0"
14
14
  }
@@ -2,7 +2,8 @@ import { type GdhAgentContractStatus, type GdhOnboardingArtifactWrite } from "@g
2
2
  export declare const AGENT_CONTRACT_RELATIVE_PATH = "AGENTS.md";
3
3
  export declare const AGENT_CONTRACT_BEGIN_MARKER = "<!-- BEGIN GDH AGENT CONTRACT -->";
4
4
  export declare const AGENT_CONTRACT_END_MARKER = "<!-- END GDH AGENT CONTRACT -->";
5
- export declare const AGENT_CONTRACT_INDEX_RELATIVE_PATH = "docs/agent/README.md";
5
+ export declare const AGENT_CONTRACT_INDEX_RELATIVE_PATH = ".gdh/guidance/README.md";
6
+ export declare const AGENT_CONTRACT_AUTHORING_RELATIVE_PATH = ".gdh/guidance/authoring-and-validation.md";
6
7
  export type GdhAgentContractMode = "root_router" | "target_contract";
7
8
  export interface GdhAgentContractRenderOptions {
8
9
  readonly mode?: GdhAgentContractMode;
@@ -1 +1 @@
1
- {"version":3,"file":"agent-contract.d.ts","sourceRoot":"","sources":["../src/agent-contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAChC,MAAM,WAAW,CAAC;AAMnB,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,2BAA2B,sCAAsC,CAAC;AAC/E,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAC3E,eAAO,MAAM,kCAAkC,yBAAyB,CAAC;AAEzE,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAErE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAOR;AAqCD,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAeR;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,0BAA0B,CAAC,CAWrC;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,sBAAsB,CAAC,CAmBjC"}
1
+ {"version":3,"file":"agent-contract.d.ts","sourceRoot":"","sources":["../src/agent-contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAChC,MAAM,WAAW,CAAC;AAMnB,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,2BAA2B,sCAAsC,CAAC;AAC/E,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAC3E,eAAO,MAAM,kCAAkC,4BAA4B,CAAC;AAC5E,eAAO,MAAM,sCAAsC,8CACN,CAAC;AAE9C,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAErE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAOR;AAqCD,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAeR;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,0BAA0B,CAAC,CAWrC;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,sBAAsB,CAAC,CAmBjC"}
@@ -6,7 +6,8 @@ assertClassRegistered("agents_md_managed_block", "deterministic");
6
6
  export const AGENT_CONTRACT_RELATIVE_PATH = "AGENTS.md";
7
7
  export const AGENT_CONTRACT_BEGIN_MARKER = "<!-- BEGIN GDH AGENT CONTRACT -->";
8
8
  export const AGENT_CONTRACT_END_MARKER = "<!-- END GDH AGENT CONTRACT -->";
9
- export const AGENT_CONTRACT_INDEX_RELATIVE_PATH = "docs/agent/README.md";
9
+ export const AGENT_CONTRACT_INDEX_RELATIVE_PATH = ".gdh/guidance/README.md";
10
+ export const AGENT_CONTRACT_AUTHORING_RELATIVE_PATH = ".gdh/guidance/authoring-and-validation.md";
10
11
  export function renderManagedAgentContractBlock(options = {}) {
11
12
  const mode = options.mode ?? "target_contract";
12
13
  if (mode === "root_router") {
@@ -23,7 +24,7 @@ function renderManagedTargetContractBlock() {
23
24
  "",
24
25
  "GDH is active for this Godot project.",
25
26
  `Before substantive work, load the canonical guidance index at [${AGENT_CONTRACT_INDEX_RELATIVE_PATH}](${AGENT_CONTRACT_INDEX_RELATIVE_PATH}).`,
26
- "For runtime bridge usage, load [docs/agent/authoring-and-validation.md](docs/agent/authoring-and-validation.md) and follow its runtime bridge section.",
27
+ `For runtime bridge usage, load [${AGENT_CONTRACT_AUTHORING_RELATIVE_PATH}](${AGENT_CONTRACT_AUTHORING_RELATIVE_PATH}) and follow its runtime bridge section.`,
27
28
  "If the canonical guidance chain cannot be fully read, stop and report that GDH visibility is broken.",
28
29
  "Use GDH's structured surfaces (`gdh status`, `gdh guidance`, and `gdh authoring check`) instead of ad hoc repo guesses for project truth and code-validity evidence.",
29
30
  AGENT_CONTRACT_END_MARKER,
@@ -1 +1 @@
1
- {"version":3,"file":"agent-contract.js","sourceRoot":"","sources":["../src/agent-contract.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agent-contract.js","sourceRoot":"","sources":["../src/agent-contract.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,6 @@
1
1
  import { type GdhGuidanceIndexDocument, type GdhGuidanceSurface, type GdhGuidanceUnitDocument, type GdhGuidanceUnitMetadata, type GdhOnboardingArtifactWrite, type GdhProjectConfig } from "@gdh/core";
2
+ export declare const GDH_GUIDANCE_DIRECTORY_RELATIVE_PATH = ".gdh/guidance";
3
+ export declare const GUIDANCE_INDEX_RELATIVE_PATH = ".gdh/guidance/README.md";
2
4
  interface DefaultGuidanceUnitDefinition {
3
5
  readonly relativePath: string;
4
6
  readonly metadata: GdhGuidanceUnitMetadata;
@@ -1 +1 @@
1
- {"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../src/guidance.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AAWnB,UAAU,6BAA6B;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,gBAAgB,GAC9B,SAAS,6BAA6B,EAAE,CA6W1C;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,gBAAgB,EAC/B,KAAK,EAAE,SAAS,6BAA6B,EAAE,GAC9C,MAAM,CAsBR;AAED,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,gBAAgB,GAC9B,OAAO,CAAC,SAAS,0BAA0B,EAAE,CAAC,CAuBhD;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAqB1C;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CA4B7C;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAYzF"}
1
+ {"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../src/guidance.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AAUnB,eAAO,MAAM,oCAAoC,kBAAkB,CAAC;AACpE,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE,UAAU,6BAA6B;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,gBAAgB,GAC9B,SAAS,6BAA6B,EAAE,CAuI1C;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,gBAAgB,EAC/B,KAAK,EAAE,SAAS,6BAA6B,EAAE,GAC9C,MAAM,CAsBR;AAED,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,gBAAgB,GAC9B,OAAO,CAAC,SAAS,0BAA0B,EAAE,CAAC,CAuBhD;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAqB1C;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CA4B7C;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAYzF"}