@skillcap/gdh 0.4.0 → 0.5.0

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "installMode": "packaged_install"
 }

package/README.md

@@ -15,9 +15,9 @@ GDH is not a planning system, release orchestrator, or generic code-editing fram
 
 ## Status
 
-GDH now ships the current `0.4.0` release line and remains ready for broader internal use within the documented support contract.
+GDH now ships the current `0.5.0` release line and remains ready for broader internal use within the documented support contract.
 
-The current release line is `0.4.0` at the `broader_internal_release` stage.
+The current release line is `0.5.0` at the `broader_internal_release` stage.
 
 That release-stage label applies only to the documented support window in [runtime-support-matrix.md](docs/development/runtime-support-matrix.md) and [runtime-release-readiness.md](docs/development/runtime-release-readiness.md). It is not a blanket claim that every Godot project shape is supported or that this implementation checkout should behave like a GDH-managed target repo.
 
@@ -43,20 +43,19 @@ The install/setup flow below is for using GDH on another target repository.
 
 If you are contributing to GDH itself in this repo, start from the contributor docs in [docs/development/install-and-update.md](docs/development/install-and-update.md), [docs/development/conventions.md](docs/development/conventions.md), and [.planning/](.planning/).
 
-GDH supports two install modes:
+GDH is published to npm as `@skillcap/gdh`. The supported install path is to invoke it via `npx` at a pinned version so `gdh setup` can record that exact version in `.gdh/project.yaml` and every managed surface (MCP launcher, agent skills, hooks) runs at the same version.
 
-1. packaged install for normal operators
-2. dev-from-source for contributors and internal dogfooding
+```sh
+npx -y @skillcap/gdh@0.4.1 setup
+```
+
+Replace `0.4.1` with the GDH version you want to pin this project to. `gdh setup` records the pinned version in `.gdh/project.yaml` as `gdh_version:`; every managed surface generated from that config invokes GDH at that exact pinned version, so future sessions stay reproducible.
 
 The full install and update contract lives in [docs/development/install-and-update.md](docs/development/install-and-update.md).
 
-For the current shipped `0.4.0` line, the one supported public package target is `@skillcap/gdh`, and the supported operator-facing executable is `gdh`.
-Maintainers prepare that package by building the generated stage at `dist/publish/gdh`; the repo root stays private, and `packages/cli` remains an internal workspace composition root rather than a direct publish target.
-Before maintainers pack or cut a public-facing release from that stage, run `corepack yarn check:public-release` so tarball-install proof and public-package safety gates pass first.
+For the current shipped `0.4.1` line, the one supported public package target is `@skillcap/gdh`, and the supported operator-facing executable is `gdh`.
 The canonical public git-versus-npm boundary for maintainers lives in [docs/development/open-source-maintainer-contract.md](docs/development/open-source-maintainer-contract.md).
 
-When the shipped line is published to npm, install the package with `npm install -g @skillcap/gdh` and invoke the CLI as `gdh`.
-
 After GDH is installed, the main human entrypoint is:
 
 ```sh

package/node_modules/@gdh/adapters/dist/index.d.ts

@@ -23,6 +23,9 @@ export declare const CURSOR_MIGRATE_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-mi
 export declare const CURSOR_CHECK_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-check/SKILL.md";
 export declare const CURSOR_PREPARE_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-prepare/SKILL.md";
 export declare const CURSOR_VERIFY_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-verify/SKILL.md";
+export declare const CLAUDE_SCAN_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/scan.md";
+export declare const CODEX_SCAN_SKILL_RELATIVE_PATH = ".codex/skills/gdh-scan/SKILL.md";
+export declare const CURSOR_SCAN_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-scan/SKILL.md";
 export declare const LOCAL_PATH_HINTS_RELATIVE_PATH = ".gdh-state/local-paths.json";
 export declare const MCP_LAUNCHER_RELATIVE_PATH = ".gdh/bin/gdh-mcp.mjs";
 export declare const GDH_MCP_SERVER_NAME = "gdh";
@@ -45,22 +48,26 @@ export declare function createGsdSnapshot(targetPath: string, options?: {
     readonly performed?: readonly GdhValidationKind[];
 }): Promise<GdhGsdSnapshot>;
 export declare function renderCursorRule(): string;
-export declare function renderClaudeOnboardCommand(): string;
-export declare function renderCodexOnboardSkill(): string;
-export declare function renderCursorOnboardSkill(): string;
-export declare function renderClaudeStatusCommand(): string;
-export declare function renderCodexStatusSkill(): string;
-export declare function renderCursorStatusSkill(): string;
-export declare function renderClaudeMigrateCommand(): string;
-export declare function renderCodexMigrateSkill(): string;
-export declare function renderCursorMigrateSkill(): string;
-export declare function renderClaudeCheckCommand(): string;
-export declare function renderCodexCheckSkill(): string;
-export declare function renderCursorCheckSkill(): string;
-export declare function renderClaudePrepareCommand(): string;
-export declare function renderCodexPrepareSkill(): string;
-export declare function renderCursorPrepareSkill(): string;
-export declare function renderClaudeVerifyCommand(): string;
-export declare function renderCodexVerifySkill(): string;
-export declare function renderCursorVerifySkill(): string;
+export declare function renderClaudeOnboardCommand(pinnedVersion: string): string;
+export declare function renderCodexOnboardSkill(pinnedVersion: string): string;
+export declare function renderCursorOnboardSkill(pinnedVersion: string): string;
+export declare function renderClaudeStatusCommand(pinnedVersion: string): string;
+export declare function renderCodexStatusSkill(pinnedVersion: string): string;
+export declare function renderCursorStatusSkill(pinnedVersion: string): string;
+export declare function renderClaudeScanCommand(pinnedVersion: string): string;
+export declare function renderCodexScanSkill(pinnedVersion: string): string;
+export declare function renderCursorScanSkill(pinnedVersion: string): string;
+export declare function renderClaudeMigrateCommand(pinnedVersion: string): string;
+export declare function renderCodexMigrateSkill(pinnedVersion: string): string;
+export declare function renderCursorMigrateSkill(pinnedVersion: string): string;
+export declare function renderClaudeCheckCommand(pinnedVersion: string): string;
+export declare function renderCodexCheckSkill(pinnedVersion: string): string;
+export declare function renderCursorCheckSkill(pinnedVersion: string): string;
+export declare function renderClaudePrepareCommand(pinnedVersion: string): string;
+export declare function renderCodexPrepareSkill(pinnedVersion: string): string;
+export declare function renderCursorPrepareSkill(pinnedVersion: string): string;
+export declare function renderClaudeVerifyCommand(pinnedVersion: string): string;
+export declare function renderCodexVerifySkill(pinnedVersion: string): string;
+export declare function renderCursorVerifySkill(pinnedVersion: string): string;
+export declare function renderManagedMcpLauncher(pinnedVersion: string): string;
 //# sourceMappingURL=index.d.ts.map

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":"AAaA,OAAO,EAgBL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,cAAc,EAGnB,KAAK,sCAAsC,EAK3C,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AAWnB,eAAO,MAAM,eAAe,wCAc1B,CAAC;AAEH,eAAO,MAAM,gBAAgB,wCAAgF,CAAC;AAC9G,eAAO,MAAM,yBAAyB,cAAc,CAAC;AACrD,eAAO,MAAM,oCAAoC,oCAAoC,CAAC;AACtF,eAAO,MAAM,yBAAyB,cAAc,CAAC;AACrD,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAC3D,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AACvE,eAAO,MAAM,kCAAkC,wCAAwC,CAAC;AACxF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,mCAAmC,mCAAmC,CAAC;AACpF,eAAO,MAAM,oCAAoC,oCAAoC,CAAC;AACtF,eAAO,MAAM,kCAAkC,kCAAkC,CAAC;AAClF,eAAO,MAAM,oCAAoC,oCAAoC,CAAC;AACtF,eAAO,MAAM,mCAAmC,mCAAmC,CAAC;AACpF,eAAO,MAAM,gCAAgC,sCAAsC,CAAC;AACpF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,+BAA+B,qCAAqC,CAAC;AAClF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,gCAAgC,sCAAsC,CAAC;AACpF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,kCAAkC,wCAAwC,CAAC;AACxF,eAAO,MAAM,gCAAgC,sCAAsC,CAAC;AACpF,eAAO,MAAM,kCAAkC,wCAAwC,CAAC;AACxF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,8BAA8B,gCAAgC,CAAC;AAC5E,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AACjE,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAIzC,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC,GACL,OAAO,CAAC,4BAA4B,CAAC,CAwBvC;AAED,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC9B,GACL,OAAO,CAAC,6BAA6B,CAAC,CAuExC;AAED,wBAAsB,oCAAoC,CACxD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,sCAAsC,CAAC,CAmEjD;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAS1B;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C,GACL,OAAO,CAAC,cAAc,CAAC,CAqFzB;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAczC;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAoCnD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CA8ChD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CA4CjD;AAID,wBAAgB,yBAAyB,IAAI,MAAM,CA+BlD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAuC/C;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAqChD;AAID,wBAAgB,0BAA0B,IAAI,MAAM,CAgCnD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAuChD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAqCjD;AAID,wBAAgB,wBAAwB,IAAI,MAAM,CA+BjD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAuC9C;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAqC/C;AAID,wBAAgB,0BAA0B,IAAI,MAAM,CAiCnD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAwChD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAsCjD;AAID,wBAAgB,yBAAyB,IAAI,MAAM,CAgClD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAwC/C;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAsChD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}