@skillcap/gdh 0.26.10 → 2.0.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.
- package/INSTALL-BUNDLE.json +1 -1
- package/README.md +1 -1
- package/RELEASE-SPAN-UPDATE-CONTRACTS.json +125 -0
- package/node_modules/@gdh/adapters/dist/codex-authoring-hook-block.d.ts +16 -0
- package/node_modules/@gdh/adapters/dist/codex-authoring-hook-block.d.ts.map +1 -0
- package/node_modules/@gdh/adapters/dist/codex-authoring-hook-block.js +40 -0
- package/node_modules/@gdh/adapters/dist/codex-authoring-hook-block.js.map +1 -0
- package/node_modules/@gdh/adapters/dist/index.d.ts +2 -30
- package/node_modules/@gdh/adapters/dist/index.d.ts.map +1 -1
- package/node_modules/@gdh/adapters/dist/index.js +99 -455
- package/node_modules/@gdh/adapters/dist/index.js.map +1 -1
- package/node_modules/@gdh/adapters/dist/self-update-mechanics.js +1 -1
- package/node_modules/@gdh/adapters/dist/self-update-mechanics.js.map +1 -1
- package/node_modules/@gdh/adapters/dist/skill-rendering.d.ts +4 -13
- package/node_modules/@gdh/adapters/dist/skill-rendering.d.ts.map +1 -1
- package/node_modules/@gdh/adapters/dist/skill-rendering.js +36 -98
- package/node_modules/@gdh/adapters/dist/skill-rendering.js.map +1 -1
- package/node_modules/@gdh/adapters/package.json +8 -8
- package/node_modules/@gdh/authoring/package.json +2 -2
- package/node_modules/@gdh/cli/dist/index.d.ts.map +1 -1
- package/node_modules/@gdh/cli/dist/index.js +16 -23
- package/node_modules/@gdh/cli/dist/index.js.map +1 -1
- package/node_modules/@gdh/cli/dist/migrate.d.ts.map +1 -1
- package/node_modules/@gdh/cli/dist/migrate.js +1 -4
- package/node_modules/@gdh/cli/dist/migrate.js.map +1 -1
- package/node_modules/@gdh/cli/dist/setup.d.ts.map +1 -1
- package/node_modules/@gdh/cli/dist/setup.js +6 -12
- package/node_modules/@gdh/cli/dist/setup.js.map +1 -1
- package/node_modules/@gdh/cli/package.json +10 -10
- package/node_modules/@gdh/core/dist/index.d.ts +18 -5
- package/node_modules/@gdh/core/dist/index.d.ts.map +1 -1
- package/node_modules/@gdh/core/dist/index.js +15 -6
- package/node_modules/@gdh/core/dist/index.js.map +1 -1
- package/node_modules/@gdh/core/dist/migrations/managed-surface-classes.d.ts +18 -54
- package/node_modules/@gdh/core/dist/migrations/managed-surface-classes.d.ts.map +1 -1
- package/node_modules/@gdh/core/dist/migrations/managed-surface-classes.js +12 -67
- package/node_modules/@gdh/core/dist/migrations/managed-surface-classes.js.map +1 -1
- package/node_modules/@gdh/core/dist/migrations/managed-target-surface-inventory.d.ts +11 -22
- package/node_modules/@gdh/core/dist/migrations/managed-target-surface-inventory.d.ts.map +1 -1
- package/node_modules/@gdh/core/dist/migrations/managed-target-surface-inventory.js +36 -38
- package/node_modules/@gdh/core/dist/migrations/managed-target-surface-inventory.js.map +1 -1
- package/node_modules/@gdh/core/package.json +1 -1
- package/node_modules/@gdh/docs/dist/recovery-hints.d.ts +18 -4
- package/node_modules/@gdh/docs/dist/recovery-hints.d.ts.map +1 -1
- package/node_modules/@gdh/docs/dist/recovery-hints.js +32 -34
- package/node_modules/@gdh/docs/dist/recovery-hints.js.map +1 -1
- package/node_modules/@gdh/docs/package.json +2 -2
- package/node_modules/@gdh/mcp/package.json +8 -8
- package/node_modules/@gdh/observability/package.json +2 -2
- package/node_modules/@gdh/runtime/package.json +2 -2
- package/node_modules/@gdh/scan/dist/onboard.js +2 -2
- package/node_modules/@gdh/scan/dist/onboard.js.map +1 -1
- package/node_modules/@gdh/scan/package.json +3 -3
- package/node_modules/@gdh/verify/package.json +7 -7
- package/package.json +11 -11
|
@@ -56,7 +56,7 @@ export const GDH_MANAGED_SURFACE_CLASSES = [
|
|
|
56
56
|
surfaceId: "skill.claude.scan",
|
|
57
57
|
relativePath: null,
|
|
58
58
|
class: "deterministic",
|
|
59
|
-
notes: "
|
|
59
|
+
notes: "Retired generated discovery skill. Legacy managed path .claude/skills/gdh-scan/SKILL.md is cleanup-only; the `gdh scan` CLI verb stays, but agents now invoke it directly from gdh-onboard or gdh-status when an inventory probe is needed.",
|
|
60
60
|
},
|
|
61
61
|
{
|
|
62
62
|
surfaceId: "skill.claude.migrate",
|
|
@@ -110,7 +110,7 @@ export const GDH_MANAGED_SURFACE_CLASSES = [
|
|
|
110
110
|
surfaceId: "skill.codex.scan",
|
|
111
111
|
relativePath: null,
|
|
112
112
|
class: "deterministic",
|
|
113
|
-
notes: "
|
|
113
|
+
notes: "Retired generated discovery skill. Legacy managed path .agents/skills/gdh-scan/SKILL.md is cleanup-only; the `gdh scan` CLI verb stays, but agents now invoke it directly from gdh-onboard or gdh-status when an inventory probe is needed.",
|
|
114
114
|
},
|
|
115
115
|
{
|
|
116
116
|
surfaceId: "skill.codex.migrate",
|
|
@@ -148,72 +148,11 @@ export const GDH_MANAGED_SURFACE_CLASSES = [
|
|
|
148
148
|
class: "deterministic",
|
|
149
149
|
notes: "Generated agent skill rendered by renderGdhSkill('codex', 'warmup', version). Per-target path: .agents/skills/gdh-warmup/SKILL.md (Phase 82 / LSP-07).",
|
|
150
150
|
},
|
|
151
|
-
{
|
|
152
|
-
surfaceId: "skill.cursor.onboard",
|
|
153
|
-
relativePath: null,
|
|
154
|
-
class: "deterministic",
|
|
155
|
-
notes: "Generated Cursor command rendered by renderGdhSkill('cursor', 'onboard', version). Per-target path: .cursor/commands/gdh-onboard.md; legacy .cursor/skills path is cleanup-only.",
|
|
156
|
-
},
|
|
157
|
-
{
|
|
158
|
-
surfaceId: "skill.cursor.status",
|
|
159
|
-
relativePath: null,
|
|
160
|
-
class: "deterministic",
|
|
161
|
-
notes: "Generated Cursor command rendered by renderGdhSkill('cursor', 'status', version). Per-target path: .cursor/commands/gdh-status.md; legacy .cursor/skills path is cleanup-only.",
|
|
162
|
-
},
|
|
163
|
-
{
|
|
164
|
-
surfaceId: "skill.cursor.scan",
|
|
165
|
-
relativePath: null,
|
|
166
|
-
class: "deterministic",
|
|
167
|
-
notes: "Generated Cursor command rendered by renderGdhSkill('cursor', 'scan', version). Per-target path: .cursor/commands/gdh-scan.md; legacy .cursor/skills path is cleanup-only.",
|
|
168
|
-
},
|
|
169
|
-
{
|
|
170
|
-
surfaceId: "skill.cursor.migrate",
|
|
171
|
-
relativePath: null,
|
|
172
|
-
class: "deterministic",
|
|
173
|
-
notes: "Generated Cursor command rendered by renderGdhSkill('cursor', 'migrate', version). Per-target path: .cursor/commands/gdh-migrate.md; legacy .cursor/skills path is cleanup-only.",
|
|
174
|
-
},
|
|
175
|
-
{
|
|
176
|
-
surfaceId: "skill.cursor.update",
|
|
177
|
-
relativePath: null,
|
|
178
|
-
class: "deterministic",
|
|
179
|
-
notes: "Generated Cursor command rendered by renderGdhSkill('cursor', 'update', version). Per-target path: .cursor/commands/gdh-update.md; legacy .cursor/skills path is cleanup-only.",
|
|
180
|
-
},
|
|
181
|
-
{
|
|
182
|
-
surfaceId: "skill.cursor.check",
|
|
183
|
-
relativePath: null,
|
|
184
|
-
class: "deterministic",
|
|
185
|
-
notes: "Retired generated validation skill. Legacy managed path .cursor/skills/gdh-check/SKILL.md is cleanup-only; validation now uses MCP/CLI status and explicit gdh authoring check commands.",
|
|
186
|
-
},
|
|
187
|
-
{
|
|
188
|
-
surfaceId: "skill.cursor.prepare",
|
|
189
|
-
relativePath: null,
|
|
190
|
-
class: "deterministic",
|
|
191
|
-
notes: "Generated Cursor command rendered by renderGdhSkill('cursor', 'prepare', version). Per-target path: .cursor/commands/gdh-prepare.md; legacy .cursor/skills path is cleanup-only.",
|
|
192
|
-
},
|
|
193
|
-
{
|
|
194
|
-
surfaceId: "skill.cursor.run-game",
|
|
195
|
-
relativePath: null,
|
|
196
|
-
class: "deterministic",
|
|
197
|
-
notes: "Generated Cursor command rendered by renderGdhSkill('cursor', 'run-game', version). Per-target path: .cursor/commands/gdh-run-game.md; legacy .cursor/skills path is cleanup-only.",
|
|
198
|
-
},
|
|
199
|
-
{
|
|
200
|
-
surfaceId: "skill.cursor.warmup",
|
|
201
|
-
relativePath: null,
|
|
202
|
-
class: "deterministic",
|
|
203
|
-
notes: "Generated Cursor command rendered by renderGdhSkill('cursor', 'warmup', version). Per-target path: .cursor/commands/gdh-warmup.md; legacy .cursor/skills path is cleanup-only (Phase 82 / LSP-07).",
|
|
204
|
-
},
|
|
205
151
|
// ---------------------------------------------------------------
|
|
206
|
-
// Non-skill renderers in packages/adapters/src/index.ts
|
|
207
|
-
//
|
|
208
|
-
//
|
|
209
|
-
// EXCLUDED per D-23.
|
|
152
|
+
// Non-skill renderers in packages/adapters/src/index.ts. All
|
|
153
|
+
// deterministic per D-20/D-21/D-22. NOTE: renderLocalPathHints writes to
|
|
154
|
+
// .gdh-state/local-paths.json and is intentionally EXCLUDED per D-23.
|
|
210
155
|
// ---------------------------------------------------------------
|
|
211
|
-
{
|
|
212
|
-
surfaceId: "cursor_rule",
|
|
213
|
-
relativePath: ".cursor/rules/gdh-agent.mdc",
|
|
214
|
-
class: "deterministic",
|
|
215
|
-
notes: "Cursor rule file rendered by renderCursorRule() in packages/adapters/src/index.ts (line 555). Path constant CURSOR_RULE_RELATIVE_PATH (line 171) defines the workspace-relative location.",
|
|
216
|
-
},
|
|
217
156
|
{
|
|
218
157
|
surfaceId: "claude_onboard_command",
|
|
219
158
|
relativePath: null,
|
|
@@ -230,7 +169,7 @@ export const GDH_MANAGED_SURFACE_CLASSES = [
|
|
|
230
169
|
surfaceId: "claude_scan_command",
|
|
231
170
|
relativePath: null,
|
|
232
171
|
class: "deterministic",
|
|
233
|
-
notes: "
|
|
172
|
+
notes: "Retired legacy Claude scan command shim. Per-target path under .claude/commands/gdh/ is cleanup-only; the `gdh scan` CLI verb stays, but agents invoke it directly from gdh-onboard or gdh-status rather than through a managed skill or command shim.",
|
|
234
173
|
},
|
|
235
174
|
{
|
|
236
175
|
surfaceId: "claude_migrate_command",
|
|
@@ -387,6 +326,12 @@ export const GDH_MANAGED_SURFACE_CLASSES = [
|
|
|
387
326
|
* surface is registered in the manifest under the expected class. Throws
|
|
388
327
|
* loudly on drift — module init aborts before any write can happen.
|
|
389
328
|
*
|
|
329
|
+
* The `surfaceId` parameter is typed against the manifest-derived
|
|
330
|
+
* `GdhManagedSurfaceId` union so a renderer asserting a surface that no
|
|
331
|
+
* longer exists in the manifest fails at typecheck. The runtime check
|
|
332
|
+
* still catches the class mismatch case, where the ID exists but the
|
|
333
|
+
* renderer claims the wrong class.
|
|
334
|
+
*
|
|
390
335
|
* Mirrors the throw-on-violation discipline of
|
|
391
336
|
* packages/core/src/release-span-update-contract.ts (lines 60-83).
|
|
392
337
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"managed-surface-classes.js","sourceRoot":"","sources":["../../src/migrations/managed-surface-classes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAuCH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,kEAAkE;IAClE,wFAAwF;IACxF,2DAA2D;IAC3D,uEAAuE;IACvE,qDAAqD;IACrD,qEAAqE;IACrE,8CAA8C;IAC9C,kEAAkE;IAClE;QACE,SAAS,EAAE,sBAAsB;QACjC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,uIAAuI;KAC1I;IACD;QACE,SAAS,EAAE,qBAAqB;QAChC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,qIAAqI;KACxI;IACD;QACE,SAAS,EAAE,mBAAmB;QAC9B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,
|
|
1
|
+
{"version":3,"file":"managed-surface-classes.js","sourceRoot":"","sources":["../../src/migrations/managed-surface-classes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAuCH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,kEAAkE;IAClE,wFAAwF;IACxF,2DAA2D;IAC3D,uEAAuE;IACvE,qDAAqD;IACrD,qEAAqE;IACrE,8CAA8C;IAC9C,kEAAkE;IAClE;QACE,SAAS,EAAE,sBAAsB;QACjC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,uIAAuI;KAC1I;IACD;QACE,SAAS,EAAE,qBAAqB;QAChC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,qIAAqI;KACxI;IACD;QACE,SAAS,EAAE,mBAAmB;QAC9B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,6OAA6O;KAChP;IACD;QACE,SAAS,EAAE,sBAAsB;QACjC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,uIAAuI;KAC1I;IACD;QACE,SAAS,EAAE,qBAAqB;QAChC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,qIAAqI;KACxI;IACD;QACE,SAAS,EAAE,oBAAoB;QAC/B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,kMAAkM;KACrM;IACD;QACE,SAAS,EAAE,sBAAsB;QACjC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,uIAAuI;KAC1I;IACD;QACE,SAAS,EAAE,uBAAuB;QAClC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,yIAAyI;KAC5I;IACD;QACE,SAAS,EAAE,qBAAqB;QAChC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,yJAAyJ;KAC5J;IACD;QACE,SAAS,EAAE,qBAAqB;QAChC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,sIAAsI;KACzI;IACD;QACE,SAAS,EAAE,oBAAoB;QAC/B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,oIAAoI;KACvI;IACD;QACE,SAAS,EAAE,kBAAkB;QAC7B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,6OAA6O;KAChP;IACD;QACE,SAAS,EAAE,qBAAqB;QAChC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,sIAAsI;KACzI;IACD;QACE,SAAS,EAAE,oBAAoB;QAC/B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,oIAAoI;KACvI;IACD;QACE,SAAS,EAAE,mBAAmB;QAC9B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,kMAAkM;KACrM;IACD;QACE,SAAS,EAAE,qBAAqB;QAChC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,sIAAsI;KACzI;IACD;QACE,SAAS,EAAE,sBAAsB;QACjC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,wIAAwI;KAC3I;IACD;QACE,SAAS,EAAE,oBAAoB;QAC/B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,wJAAwJ;KAC3J;IAED,kEAAkE;IAClE,6DAA6D;IAC7D,yEAAyE;IACzE,sEAAsE;IACtE,kEAAkE;IAClE;QACE,SAAS,EAAE,wBAAwB;QACnC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,yQAAyQ;KAC5Q;IACD;QACE,SAAS,EAAE,uBAAuB;QAClC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,kMAAkM;KACrM;IACD;QACE,SAAS,EAAE,qBAAqB;QAChC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,wPAAwP;KAC3P;IACD;QACE,SAAS,EAAE,wBAAwB;QACnC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,oMAAoM;KACvM;IACD;QACE,SAAS,EAAE,uBAAuB;QAClC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,kMAAkM;KACrM;IACD;QACE,SAAS,EAAE,sBAAsB;QACjC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,mMAAmM;KACtM;IACD;QACE,SAAS,EAAE,wBAAwB;QACnC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,oMAAoM;KACvM;IACD;QACE,SAAS,EAAE,yBAAyB;QACpC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,oMAAoM;KACvM;IACD;QACE,SAAS,EAAE,kBAAkB;QAC7B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,wTAAwT;KAC3T;IACD;QACE,SAAS,EAAE,2BAA2B;QACtC,YAAY,EAAE,oBAAoB;QAClC,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,gSAAgS;KACnS;IACD;QACE,SAAS,EAAE,4BAA4B;QACvC,YAAY,EAAE,oBAAoB;QAClC,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,kNAAkN;KACrN;IAED,kEAAkE;IAClE,qEAAqE;IACrE,8BAA8B;IAC9B,kEAAkE;IAClE;QACE,SAAS,EAAE,gBAAgB;QAC3B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,uSAAuS;KAC1S;IACD;QACE,SAAS,EAAE,oBAAoB;QAC/B,YAAY,EAAE,mCAAmC;QACjD,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,wLAAwL;KAC3L;IACD;QACE,SAAS,EAAE,sBAAsB;QACjC,YAAY,EAAE,0CAA0C;QACxD,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,iLAAiL;KACpL;IACD;QACE,SAAS,EAAE,mBAAmB;QAC9B,YAAY,EAAE,iCAAiC;QAC/C,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,2RAA2R;KAC9R;IAED,kEAAkE;IAClE,+CAA+C;IAC/C,qCAAqC;IACrC,kEAAkE;IAClE;QACE,SAAS,EAAE,yBAAyB;QACpC,YAAY,EAAE,WAAW;QACzB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,ibAAib;KACpb;IACD;QACE,SAAS,EAAE,mBAAmB;QAC9B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,qRAAqR;KACxR;IACD;QACE,SAAS,EAAE,gBAAgB;QAC3B,YAAY,EAAE,yBAAyB;QACvC,KAAK,EAAE,eAAe;QACtB,KAAK,EACH,kLAAkL;KACrL;IAED,kEAAkE;IAClE,0DAA0D;IAC1D,iEAAiE;IACjE,uEAAuE;IACvE,qEAAqE;IACrE,mEAAmE;IACnE,+CAA+C;IAC/C,kEAAkE;IAClE;QACE,SAAS,EAAE,kBAAkB;QAC7B,YAAY,EAAE,mBAAmB;QACjC,KAAK,EAAE,WAAW;QAClB,KAAK,EACH,2OAA2O;KAC9O;IACD;QACE,SAAS,EAAE,gBAAgB;QAC3B,YAAY,EAAE,iBAAiB;QAC/B,KAAK,EAAE,WAAW;QAClB,KAAK,EACH,wOAAwO;KAC3O;IACD;QACE,SAAS,EAAE,uBAAuB;QAClC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,WAAW;QAClB,KAAK,EACH,mLAAmL;KACtL;IACD;QACE,SAAS,EAAE,2BAA2B;QACtC,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,WAAW;QAClB,KAAK,EACH,kMAAkM;KACrM;IAED,kEAAkE;IAClE,+CAA+C;IAC/C,kEAAkE;IAClE;QACE,SAAS,EAAE,eAAe;QAC1B,YAAY,EAAE,eAAe;QAC7B,KAAK,EAAE,gBAAgB;QACvB,KAAK,EACH,8KAA8K;QAChL,sBAAsB,EAAE;YACtB;gBACE,EAAE,EAAE,2BAA2B;gBAC/B,OAAO,EAAE,wDAAwD;aAClE;YACD;gBACE,EAAE,EAAE,mBAAmB;gBACvB,OAAO,EAAE,2CAA2C;aACrD;SACF;KACF;CACwD,CAAC;AAY5D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAA8B,EAC9B,aAAqC;IAErC,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAC5C,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,KAAK,SAAS,CACjD,CAAC;IACF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,oBAAoB,SAAS,qDAAqD,CACnF,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,oBAAoB,SAAS,uBAAuB,KAAK,CAAC,KAAK,iCAAiC,aAAa,IAAI,CAClH,CAAC;IACJ,CAAC;AACH,CAAC"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export type GdhManagedTargetSurfaceOwner = "gdh" | "project" | "agent_vendor" | "mixed";
|
|
2
|
-
export type GdhManagedTargetSurfaceDiscoveryRequirement = "root_agent_instruction" | "provider_skill" | "provider_command" | "provider_command_legacy" | "provider_mcp_config" | "provider_hook_config" | "
|
|
2
|
+
export type GdhManagedTargetSurfaceDiscoveryRequirement = "root_agent_instruction" | "provider_skill" | "provider_command" | "provider_command_legacy" | "provider_mcp_config" | "provider_hook_config" | "durable_gdh_truth" | "project_native";
|
|
3
3
|
export type GdhManagedTargetSurfaceFinalDisposition = "keep_discoverability_shim" | "move_under_gdh" | "move_into_skill" | "replace_with_hook_mcp_or_cli_behavior" | "delete" | "keep_project_native";
|
|
4
4
|
export type GdhManagedTargetSurfaceFollowUpPhase = "77" | "78" | "79" | null;
|
|
5
5
|
export interface GdhManagedTargetSurfaceInventoryEntry {
|
|
@@ -19,24 +19,13 @@ export declare const GDH_MANAGED_TARGET_SURFACE_INVENTORY: readonly [...{
|
|
|
19
19
|
purpose: string;
|
|
20
20
|
owner: "gdh";
|
|
21
21
|
targetLocations: string[];
|
|
22
|
-
discoveryRequirement: "
|
|
22
|
+
discoveryRequirement: "provider_skill";
|
|
23
23
|
migrationBehavior: string;
|
|
24
24
|
staleBehavior: string;
|
|
25
|
-
finalDisposition: "
|
|
25
|
+
finalDisposition: "move_into_skill" | "replace_with_hook_mcp_or_cli_behavior";
|
|
26
26
|
dispositionRationale: string;
|
|
27
27
|
followUpPhase: "78" | null;
|
|
28
28
|
}[], {
|
|
29
|
-
readonly surfaceId: "cursor_rule";
|
|
30
|
-
readonly purpose: "Minimal Cursor rule that routes GDH work to installed GDH commands and target-local surfaces.";
|
|
31
|
-
readonly owner: "gdh";
|
|
32
|
-
readonly targetLocations: readonly [".cursor/rules/gdh-agent.mdc"];
|
|
33
|
-
readonly discoveryRequirement: "provider_rule";
|
|
34
|
-
readonly migrationBehavior: "Deterministically re-render when adapter surfaces are installed or repaired.";
|
|
35
|
-
readonly staleBehavior: "Replace marker-owned drift; keep user-authored Cursor rules outside the managed file untouched.";
|
|
36
|
-
readonly finalDisposition: "keep_discoverability_shim";
|
|
37
|
-
readonly dispositionRationale: "Cursor rules are a provider-native discovery hook. They should stay thin and point to commands instead of duplicating guidance.";
|
|
38
|
-
readonly followUpPhase: "78";
|
|
39
|
-
}, {
|
|
40
29
|
readonly surfaceId: "claude_onboard_command";
|
|
41
30
|
readonly purpose: "Legacy Claude command compatibility for the onboard workflow.";
|
|
42
31
|
readonly owner: "gdh";
|
|
@@ -64,11 +53,11 @@ export declare const GDH_MANAGED_TARGET_SURFACE_INVENTORY: readonly [...{
|
|
|
64
53
|
readonly owner: "gdh";
|
|
65
54
|
readonly targetLocations: readonly [".claude/skills/gdh-scan/SKILL.md"];
|
|
66
55
|
readonly discoveryRequirement: "provider_skill";
|
|
67
|
-
readonly migrationBehavior: "Current installs
|
|
68
|
-
readonly staleBehavior: "Treat
|
|
69
|
-
readonly finalDisposition: "
|
|
70
|
-
readonly dispositionRationale: "
|
|
71
|
-
readonly followUpPhase:
|
|
56
|
+
readonly migrationBehavior: "Current installs do not render this surface; legacy .claude/commands/gdh/scan.md and the retired gdh-scan skill are removed when GDH owns them.";
|
|
57
|
+
readonly staleBehavior: "Treat any on-disk managed render as stale; cleanup is content-checked.";
|
|
58
|
+
readonly finalDisposition: "replace_with_hook_mcp_or_cli_behavior";
|
|
59
|
+
readonly dispositionRationale: "The `gdh scan` CLI verb stays; the managed gdh-scan skill and command shim are retired. Agents invoke the scan verb directly from gdh-onboard or gdh-status when an inventory probe is needed.";
|
|
60
|
+
readonly followUpPhase: null;
|
|
72
61
|
}, {
|
|
73
62
|
readonly surfaceId: "claude_migrate_command";
|
|
74
63
|
readonly purpose: "Legacy Claude command compatibility for managed surface migration.";
|
|
@@ -126,14 +115,14 @@ export declare const GDH_MANAGED_TARGET_SURFACE_INVENTORY: readonly [...{
|
|
|
126
115
|
readonly followUpPhase: "78";
|
|
127
116
|
}, {
|
|
128
117
|
readonly surfaceId: "mcp_config_entry";
|
|
129
|
-
readonly purpose: "Managed GDH MCP server entry inside Claude
|
|
118
|
+
readonly purpose: "Managed GDH MCP server entry inside Claude project MCP files.";
|
|
130
119
|
readonly owner: "mixed";
|
|
131
|
-
readonly targetLocations: readonly [".mcp.json#mcpServers.gdh"
|
|
120
|
+
readonly targetLocations: readonly [".mcp.json#mcpServers.gdh"];
|
|
132
121
|
readonly discoveryRequirement: "provider_mcp_config";
|
|
133
122
|
readonly migrationBehavior: "Patch only the GDH-owned MCP entry; leave surrounding project/user MCP config as project-native data.";
|
|
134
123
|
readonly staleBehavior: "Replace only the managed server entry when pin or invocation drifts.";
|
|
135
124
|
readonly finalDisposition: "keep_discoverability_shim";
|
|
136
|
-
readonly dispositionRationale: "Claude
|
|
125
|
+
readonly dispositionRationale: "Claude requires provider-visible MCP config. GDH should own the smallest possible entry, not the whole file.";
|
|
137
126
|
readonly followUpPhase: "79";
|
|
138
127
|
}, {
|
|
139
128
|
readonly surfaceId: "codex_project_mcp_section";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"managed-target-surface-inventory.d.ts","sourceRoot":"","sources":["../../src/migrations/managed-target-surface-inventory.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,4BAA4B,GAAG,KAAK,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC;AAExF,MAAM,MAAM,2CAA2C,GACnD,wBAAwB,GACxB,gBAAgB,GAChB,kBAAkB,GAClB,yBAAyB,GACzB,qBAAqB,GACrB,sBAAsB,GACtB,
|
|
1
|
+
{"version":3,"file":"managed-target-surface-inventory.d.ts","sourceRoot":"","sources":["../../src/migrations/managed-target-surface-inventory.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,4BAA4B,GAAG,KAAK,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC;AAExF,MAAM,MAAM,2CAA2C,GACnD,wBAAwB,GACxB,gBAAgB,GAChB,kBAAkB,GAClB,yBAAyB,GACzB,qBAAqB,GACrB,sBAAsB,GACtB,mBAAmB,GACnB,gBAAgB,CAAC;AAErB,MAAM,MAAM,uCAAuC,GAC/C,2BAA2B,GAC3B,gBAAgB,GAChB,iBAAiB,GACjB,uCAAuC,GACvC,QAAQ,GACR,qBAAqB,CAAC;AAE1B,MAAM,MAAM,oCAAoC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7E,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,4BAA4B,CAAC;IAC7C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,2CAA2C,CAAC;IAC3E,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,uCAAuC,CAAC;IACnE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,oCAAoC,CAAC;CAC9D;AAiZD,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGoB,CAAC;AAEtE,wBAAgB,2CAA2C,IAAI,IAAI,CA0BlE"}
|
|
@@ -24,42 +24,40 @@ const GDH_SKILL_PURPOSES = {
|
|
|
24
24
|
const AGENT_SKILL_LOCATIONS = {
|
|
25
25
|
claude: ".claude/skills",
|
|
26
26
|
codex: ".agents/skills",
|
|
27
|
-
cursor: ".cursor/commands",
|
|
28
27
|
};
|
|
29
28
|
const AGENT_SKILL_DISCOVERY_NOTES = {
|
|
30
29
|
claude: "Claude Code loads project skills from the provider-native .claude/skills surface.",
|
|
31
30
|
codex: "Codex consumes shared project skills from .agents/skills; legacy .codex/skills files are cleanup-only.",
|
|
32
|
-
cursor: "Cursor consumes reusable project slash workflows from the provider-native .cursor/commands surface; legacy .cursor/skills files are cleanup-only.",
|
|
33
31
|
};
|
|
34
|
-
const
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
: [`${basePath}/gdh-${skillId}/SKILL.md`],
|
|
41
|
-
discoveryRequirement: agent === "cursor" ? "provider_command" : "provider_skill",
|
|
42
|
-
migrationBehavior: "Deterministically re-render from the current GDH version during setup, migrate, repair, and self-update.",
|
|
43
|
-
staleBehavior: "Treat version or marker drift as stale; replace the managed skill and remove known legacy duplicates where the adapter installer owns them.",
|
|
44
|
-
finalDisposition: skillId === "check" ? "replace_with_hook_mcp_or_cli_behavior" : "move_into_skill",
|
|
45
|
-
dispositionRationale: skillId === "check"
|
|
46
|
-
? `${AGENT_SKILL_DISCOVERY_NOTES[agent]} Retire this validation skill; validation evidence belongs to GDH hooks, MCP/CLI status, and explicit authoring-check commands.`
|
|
47
|
-
: `${AGENT_SKILL_DISCOVERY_NOTES[agent]} Keep workflow instructions inside the skill instead of leaking command guidance into target docs.`,
|
|
48
|
-
followUpPhase: skillId === "check" ? null : "78",
|
|
49
|
-
})));
|
|
50
|
-
const staticEntries = [
|
|
51
|
-
{
|
|
52
|
-
surfaceId: "cursor_rule",
|
|
53
|
-
purpose: "Minimal Cursor rule that routes GDH work to installed GDH commands and target-local surfaces.",
|
|
32
|
+
const RETIRED_SKILL_IDS = new Set(["check", "scan"]);
|
|
33
|
+
const skillEntries = Object.entries(AGENT_SKILL_LOCATIONS).flatMap(([agent, basePath]) => GDH_SKILL_IDS.map((skillId) => {
|
|
34
|
+
const retired = RETIRED_SKILL_IDS.has(skillId);
|
|
35
|
+
return {
|
|
36
|
+
surfaceId: `skill.${agent}.${skillId}`,
|
|
37
|
+
purpose: `${agent} ${GDH_SKILL_PURPOSES[skillId]} skill wrapper around GDH CLI/MCP behavior.`,
|
|
54
38
|
owner: "gdh",
|
|
55
|
-
targetLocations: [
|
|
56
|
-
discoveryRequirement: "
|
|
57
|
-
migrationBehavior:
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
39
|
+
targetLocations: [`${basePath}/gdh-${skillId}/SKILL.md`],
|
|
40
|
+
discoveryRequirement: "provider_skill",
|
|
41
|
+
migrationBehavior: retired
|
|
42
|
+
? "Retired generated skill; the adapter installer no longer renders this surface, but the retired-managed-surface cleanup planner removes any legacy file at the managed path that still carries GDH managed markers."
|
|
43
|
+
: "Deterministically re-render from the current GDH version during setup, migrate, repair, and self-update.",
|
|
44
|
+
staleBehavior: retired
|
|
45
|
+
? "Treat any on-disk managed render as stale; cleanup is content-checked so user-authored files at the same path are preserved."
|
|
46
|
+
: "Treat version or marker drift as stale; replace the managed skill and remove known legacy duplicates where the adapter installer owns them.",
|
|
47
|
+
finalDisposition: retired ? "replace_with_hook_mcp_or_cli_behavior" : "move_into_skill",
|
|
48
|
+
dispositionRationale: (() => {
|
|
49
|
+
if (skillId === "check") {
|
|
50
|
+
return `${AGENT_SKILL_DISCOVERY_NOTES[agent]} Retire this validation skill; validation evidence belongs to GDH hooks, MCP/CLI status, and explicit authoring-check commands.`;
|
|
51
|
+
}
|
|
52
|
+
if (skillId === "scan") {
|
|
53
|
+
return `${AGENT_SKILL_DISCOVERY_NOTES[agent]} Retire this discovery skill; the \`gdh scan\` CLI verb stays, but agents invoke it directly from gdh-onboard or gdh-status when an inventory probe is needed.`;
|
|
54
|
+
}
|
|
55
|
+
return `${AGENT_SKILL_DISCOVERY_NOTES[agent]} Keep workflow instructions inside the skill instead of leaking command guidance into target docs.`;
|
|
56
|
+
})(),
|
|
57
|
+
followUpPhase: retired ? null : "78",
|
|
58
|
+
};
|
|
59
|
+
}));
|
|
60
|
+
const staticEntries = [
|
|
63
61
|
{
|
|
64
62
|
surfaceId: "claude_onboard_command",
|
|
65
63
|
purpose: "Legacy Claude command compatibility for the onboard workflow.",
|
|
@@ -90,11 +88,11 @@ const staticEntries = [
|
|
|
90
88
|
owner: "gdh",
|
|
91
89
|
targetLocations: [".claude/skills/gdh-scan/SKILL.md"],
|
|
92
90
|
discoveryRequirement: "provider_skill",
|
|
93
|
-
migrationBehavior: "Current installs
|
|
94
|
-
staleBehavior: "Treat
|
|
95
|
-
finalDisposition: "
|
|
96
|
-
dispositionRationale: "
|
|
97
|
-
followUpPhase:
|
|
91
|
+
migrationBehavior: "Current installs do not render this surface; legacy .claude/commands/gdh/scan.md and the retired gdh-scan skill are removed when GDH owns them.",
|
|
92
|
+
staleBehavior: "Treat any on-disk managed render as stale; cleanup is content-checked.",
|
|
93
|
+
finalDisposition: "replace_with_hook_mcp_or_cli_behavior",
|
|
94
|
+
dispositionRationale: "The `gdh scan` CLI verb stays; the managed gdh-scan skill and command shim are retired. Agents invoke the scan verb directly from gdh-onboard or gdh-status when an inventory probe is needed.",
|
|
95
|
+
followUpPhase: null,
|
|
98
96
|
},
|
|
99
97
|
{
|
|
100
98
|
surfaceId: "claude_migrate_command",
|
|
@@ -158,14 +156,14 @@ const staticEntries = [
|
|
|
158
156
|
},
|
|
159
157
|
{
|
|
160
158
|
surfaceId: "mcp_config_entry",
|
|
161
|
-
purpose: "Managed GDH MCP server entry inside Claude
|
|
159
|
+
purpose: "Managed GDH MCP server entry inside Claude project MCP files.",
|
|
162
160
|
owner: "mixed",
|
|
163
|
-
targetLocations: [".mcp.json#mcpServers.gdh"
|
|
161
|
+
targetLocations: [".mcp.json#mcpServers.gdh"],
|
|
164
162
|
discoveryRequirement: "provider_mcp_config",
|
|
165
163
|
migrationBehavior: "Patch only the GDH-owned MCP entry; leave surrounding project/user MCP config as project-native data.",
|
|
166
164
|
staleBehavior: "Replace only the managed server entry when pin or invocation drifts.",
|
|
167
165
|
finalDisposition: "keep_discoverability_shim",
|
|
168
|
-
dispositionRationale: "Claude
|
|
166
|
+
dispositionRationale: "Claude requires provider-visible MCP config. GDH should own the smallest possible entry, not the whole file.",
|
|
169
167
|
followUpPhase: "79",
|
|
170
168
|
},
|
|
171
169
|
{
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"managed-target-surface-inventory.js","sourceRoot":"","sources":["../../src/migrations/managed-target-surface-inventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;
|
|
1
|
+
{"version":3,"file":"managed-target-surface-inventory.js","sourceRoot":"","sources":["../../src/migrations/managed-target-surface-inventory.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,11 +5,19 @@
|
|
|
5
5
|
* This module is the UX-05 foundation for Phase 17. It is consumed by:
|
|
6
6
|
* - `buildGdhStatusResult` in `@gdh/adapters` (emits `recoveryHints[]`
|
|
7
7
|
* in the `gdh status` JSON payload via `resolveRecoveryHints(...)`).
|
|
8
|
-
* - The `/gdh-status` and `/gdh-
|
|
8
|
+
* - The `/gdh-status` and `/gdh-update` skill renderers (narrate the
|
|
9
9
|
* `recoveryHints[]` JSON field symbolically — they do NOT bake the
|
|
10
10
|
* `command` strings as shell literals; the renderer uses pinned
|
|
11
11
|
* `npx -y @skillcap/gdh@${pinnedVersion} <verb>` instead).
|
|
12
12
|
*
|
|
13
|
+
* Routing model: the agent reads `recoveryHints[]` and acts on the entry
|
|
14
|
+
* itself — there is no human-facing slash command for migration-class
|
|
15
|
+
* recoveries. When `skillName` is set, the agent invokes that skill
|
|
16
|
+
* (which owns any required user approval gates). When `skillName` is
|
|
17
|
+
* null, either the recovery is a deterministic CLI action the agent can
|
|
18
|
+
* execute directly via `command`, or it is a manual editor step the
|
|
19
|
+
* agent cannot perform on the user's behalf (the `summary` disambiguates).
|
|
20
|
+
*
|
|
13
21
|
* Package boundary: this module is pure presentation/lookup. It must NOT
|
|
14
22
|
* import from `@gdh/core`, `@gdh/adapters`, or any other internal package
|
|
15
23
|
* (see `packages/docs/src/index.ts` `docsPackage` boundary declaration).
|
|
@@ -17,11 +25,17 @@
|
|
|
17
25
|
export interface RecoveryHint {
|
|
18
26
|
/** The reason literal that matched (either a known static literal or a dynamic prefixed one). */
|
|
19
27
|
readonly reason: string;
|
|
20
|
-
/**
|
|
28
|
+
/** Agent-facing command to run. Renderer surfaces this symbolically (never as a raw shell literal). */
|
|
21
29
|
readonly command: string;
|
|
22
|
-
/**
|
|
30
|
+
/**
|
|
31
|
+
* Skill the agent should invoke to handle this recovery. Null means either:
|
|
32
|
+
* - the agent can run `command` directly without invoking a skill, or
|
|
33
|
+
* - the recovery is a manual editor step the agent cannot perform (see `summary`).
|
|
34
|
+
* Migration-class recoveries route to `/gdh-update` (the human-facing entry that
|
|
35
|
+
* calls the agent-only `gdh-migrate` sub-skill internally with its own approval gate).
|
|
36
|
+
*/
|
|
23
37
|
readonly skillName: string | null;
|
|
24
|
-
/** One-line explanation for the human
|
|
38
|
+
/** One-line explanation for the agent (and any surfaced human-readable output). */
|
|
25
39
|
readonly summary: string;
|
|
26
40
|
}
|
|
27
41
|
declare const REASON_RECOVERY_HINTS: Readonly<Record<string, Omit<RecoveryHint, "reason">>>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"recovery-hints.d.ts","sourceRoot":"","sources":["../src/recovery-hints.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"recovery-hints.d.ts","sourceRoot":"","sources":["../src/recovery-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,YAAY;IAC3B,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uGAAuG;IACvG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,QAAA,MAAM,qBAAqB,EAAE,QAAQ,CACnC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CA4I7C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,SAAS,YAAY,EAAE,CAyCzB;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}
|
|
@@ -5,11 +5,19 @@
|
|
|
5
5
|
* This module is the UX-05 foundation for Phase 17. It is consumed by:
|
|
6
6
|
* - `buildGdhStatusResult` in `@gdh/adapters` (emits `recoveryHints[]`
|
|
7
7
|
* in the `gdh status` JSON payload via `resolveRecoveryHints(...)`).
|
|
8
|
-
* - The `/gdh-status` and `/gdh-
|
|
8
|
+
* - The `/gdh-status` and `/gdh-update` skill renderers (narrate the
|
|
9
9
|
* `recoveryHints[]` JSON field symbolically — they do NOT bake the
|
|
10
10
|
* `command` strings as shell literals; the renderer uses pinned
|
|
11
11
|
* `npx -y @skillcap/gdh@${pinnedVersion} <verb>` instead).
|
|
12
12
|
*
|
|
13
|
+
* Routing model: the agent reads `recoveryHints[]` and acts on the entry
|
|
14
|
+
* itself — there is no human-facing slash command for migration-class
|
|
15
|
+
* recoveries. When `skillName` is set, the agent invokes that skill
|
|
16
|
+
* (which owns any required user approval gates). When `skillName` is
|
|
17
|
+
* null, either the recovery is a deterministic CLI action the agent can
|
|
18
|
+
* execute directly via `command`, or it is a manual editor step the
|
|
19
|
+
* agent cannot perform on the user's behalf (the `summary` disambiguates).
|
|
20
|
+
*
|
|
13
21
|
* Package boundary: this module is pure presentation/lookup. It must NOT
|
|
14
22
|
* import from `@gdh/core`, `@gdh/adapters`, or any other internal package
|
|
15
23
|
* (see `packages/docs/src/index.ts` `docsPackage` boundary declaration).
|
|
@@ -38,12 +46,12 @@ const REASON_RECOVERY_HINTS = {
|
|
|
38
46
|
},
|
|
39
47
|
run_configuration_directory_conflict: {
|
|
40
48
|
command: "gdh migrate",
|
|
41
|
-
skillName: "/gdh-
|
|
49
|
+
skillName: "/gdh-update",
|
|
42
50
|
summary: "Both legacy and current run-configuration directories exist — manual review required before migrate.",
|
|
43
51
|
},
|
|
44
52
|
verification_scenario_directory_conflict: {
|
|
45
53
|
command: "gdh migrate",
|
|
46
|
-
skillName: "/gdh-
|
|
54
|
+
skillName: "/gdh-update",
|
|
47
55
|
summary: "Both legacy and current verification-scenario directories exist — manual review required before migrate.",
|
|
48
56
|
},
|
|
49
57
|
run_configuration_version_unrecognized: {
|
|
@@ -64,88 +72,78 @@ const REASON_RECOVERY_HINTS = {
|
|
|
64
72
|
// --- Coupled (auto-fixable via gdh migrate --apply or gdh adapters install) ---
|
|
65
73
|
project_config_version_behind: {
|
|
66
74
|
command: "gdh migrate --apply",
|
|
67
|
-
skillName: "/gdh-
|
|
75
|
+
skillName: "/gdh-update",
|
|
68
76
|
summary: "Project config can be migrated forward to the current schema.",
|
|
69
77
|
},
|
|
70
78
|
rules_missing: {
|
|
71
79
|
command: "gdh migrate --apply",
|
|
72
|
-
skillName: "/gdh-
|
|
80
|
+
skillName: "/gdh-update",
|
|
73
81
|
summary: "Rules file is missing — regenerate via migrate.",
|
|
74
82
|
},
|
|
75
83
|
agent_contract_missing: {
|
|
76
84
|
command: "gdh migrate --apply",
|
|
77
|
-
skillName: "/gdh-
|
|
85
|
+
skillName: "/gdh-update",
|
|
78
86
|
summary: "Managed agent contract block is missing from AGENTS.md — regenerate via migrate.",
|
|
79
87
|
},
|
|
80
88
|
guidance_index_missing: {
|
|
81
89
|
command: "gdh migrate --apply",
|
|
82
|
-
skillName: "/gdh-
|
|
90
|
+
skillName: "/gdh-update",
|
|
83
91
|
summary: "Guidance index (.gdh/guidance/README.md) is missing — regenerate via migrate.",
|
|
84
92
|
},
|
|
85
93
|
guidance_unit_missing: {
|
|
86
94
|
command: "gdh migrate --apply",
|
|
87
|
-
skillName: "/gdh-
|
|
95
|
+
skillName: "/gdh-update",
|
|
88
96
|
summary: "One or more guidance units are missing — regenerate via migrate.",
|
|
89
97
|
},
|
|
90
98
|
guidance_index_version_outdated: {
|
|
91
99
|
command: "gdh migrate --apply",
|
|
92
|
-
skillName: "/gdh-
|
|
100
|
+
skillName: "/gdh-update",
|
|
93
101
|
summary: "Guidance index has an outdated version marker — refresh via migrate.",
|
|
94
102
|
},
|
|
95
103
|
guidance_unit_version_outdated: {
|
|
96
104
|
command: "gdh migrate --apply",
|
|
97
|
-
skillName: "/gdh-
|
|
105
|
+
skillName: "/gdh-update",
|
|
98
106
|
summary: "One or more guidance units have outdated version markers — refresh via migrate.",
|
|
99
107
|
},
|
|
100
108
|
mcp_manifest_missing: {
|
|
101
109
|
command: "gdh adapters install",
|
|
102
|
-
skillName: "/gdh-
|
|
110
|
+
skillName: "/gdh-update",
|
|
103
111
|
summary: "Project MCP config files need to be created.",
|
|
104
112
|
},
|
|
105
113
|
mcp_manifest_misconfigured: {
|
|
106
114
|
command: "gdh adapters install",
|
|
107
|
-
skillName: "/gdh-
|
|
115
|
+
skillName: "/gdh-update",
|
|
108
116
|
summary: "Project MCP config files need to be refreshed.",
|
|
109
117
|
},
|
|
110
|
-
cursor_rule_missing: {
|
|
111
|
-
command: "gdh adapters install",
|
|
112
|
-
skillName: "/gdh-migrate",
|
|
113
|
-
summary: "Cursor rule file needs to be created.",
|
|
114
|
-
},
|
|
115
|
-
cursor_rule_misconfigured: {
|
|
116
|
-
command: "gdh adapters install",
|
|
117
|
-
skillName: "/gdh-migrate",
|
|
118
|
-
summary: "Cursor rule file needs to be refreshed.",
|
|
119
|
-
},
|
|
120
118
|
mcp_launcher_missing: {
|
|
121
119
|
command: "gdh adapters install",
|
|
122
|
-
skillName: "/gdh-
|
|
120
|
+
skillName: "/gdh-update",
|
|
123
121
|
summary: "Managed MCP launcher needs to be created.",
|
|
124
122
|
},
|
|
125
123
|
mcp_launcher_misconfigured: {
|
|
126
124
|
command: "gdh adapters install",
|
|
127
|
-
skillName: "/gdh-
|
|
125
|
+
skillName: "/gdh-update",
|
|
128
126
|
summary: "Managed MCP launcher needs to be refreshed.",
|
|
129
127
|
},
|
|
130
128
|
run_configuration_version_behind: {
|
|
131
129
|
command: "gdh migrate --apply",
|
|
132
|
-
skillName: "/gdh-
|
|
130
|
+
skillName: "/gdh-update",
|
|
133
131
|
summary: "Run-configuration schema can be migrated forward.",
|
|
134
132
|
},
|
|
135
133
|
verification_scenario_version_behind: {
|
|
136
134
|
command: "gdh migrate --apply",
|
|
137
|
-
skillName: "/gdh-
|
|
135
|
+
skillName: "/gdh-update",
|
|
138
136
|
summary: "Verification-scenario schema can be migrated forward.",
|
|
139
137
|
},
|
|
140
138
|
runtime_bridge_surface_migration_available: {
|
|
141
139
|
command: "gdh bridge repair",
|
|
142
|
-
skillName:
|
|
143
|
-
summary: "Runtime bridge configuration can be normalized.",
|
|
140
|
+
skillName: null,
|
|
141
|
+
summary: "Runtime bridge configuration can be normalized. Agent can run `gdh bridge repair` directly.",
|
|
144
142
|
},
|
|
145
143
|
runtime_bridge_autoload_missing_or_drifted: {
|
|
146
144
|
command: "gdh bridge repair",
|
|
147
|
-
skillName:
|
|
148
|
-
summary: "Runtime bridge autoload registration is missing or drifted.",
|
|
145
|
+
skillName: null,
|
|
146
|
+
summary: "Runtime bridge autoload registration is missing or drifted. Agent can run `gdh bridge repair` directly.",
|
|
149
147
|
},
|
|
150
148
|
};
|
|
151
149
|
/**
|
|
@@ -180,8 +178,8 @@ export function resolveRecoveryHints(reasons) {
|
|
|
180
178
|
hints.push({
|
|
181
179
|
reason,
|
|
182
180
|
command: "gdh bridge repair",
|
|
183
|
-
skillName:
|
|
184
|
-
summary: `Runtime bridge artifact missing (${artifactId}).`,
|
|
181
|
+
skillName: null,
|
|
182
|
+
summary: `Runtime bridge artifact missing (${artifactId}). Agent can run \`gdh bridge repair\` directly.`,
|
|
185
183
|
});
|
|
186
184
|
continue;
|
|
187
185
|
}
|
|
@@ -190,8 +188,8 @@ export function resolveRecoveryHints(reasons) {
|
|
|
190
188
|
hints.push({
|
|
191
189
|
reason,
|
|
192
190
|
command: "gdh bridge repair",
|
|
193
|
-
skillName:
|
|
194
|
-
summary: `Runtime bridge artifact drifted (${artifactId}).`,
|
|
191
|
+
skillName: null,
|
|
192
|
+
summary: `Runtime bridge artifact drifted (${artifactId}). Agent can run \`gdh bridge repair\` directly.`,
|
|
195
193
|
});
|
|
196
194
|
continue;
|
|
197
195
|
}
|