@skillcap/gdh 1.0.0 → 2.0.1

package/INSTALL-BUNDLE.json

@@ -1,5 +1,5 @@
 {
   "product": "GDH",
-  "version": "1.0.0",
+  "version": "2.0.1",
   "installMode": "packaged_install"
 }

package/RELEASE-SPAN-UPDATE-CONTRACTS.json

@@ -3602,6 +3602,115 @@
           }
         ]
       }
+    },
+    {
+      "version": "2.0.0",
+      "releaseTag": "v2.0.0",
+      "migrationStatus": "required",
+      "summary": "v2.0.0 contracts the agent-facing skill surface further along the human/agent boundary. Two scope changes drive the bump: (1) gdh-scan is dropped as a managed agent skill (the `gdh scan` CLI verb stays); the agent-facing skill at .claude/skills/gdh-scan/SKILL.md and .agents/skills/gdh-scan/SKILL.md, plus the legacy command shim at .claude/commands/gdh/scan.md, are retired and swept by the cleanup planner. (2) gdh-prepare becomes agent-invoked-only (user-invocable: false on Claude; equivalent on Codex), called internally by gdh-onboard or gdh-status. GDH_AGENT_CONTRACT_VERSION moves 20 -> 21 to drive a managed-target rebake covering gdh-scan retirement, the gdh-prepare agent-only switch, and the new prepareApprovalInstruction() per-agent approval narrative. The retired-managed-surface cleanup planner enumerates content-checked deletions so user-authored content at the same paths is preserved verbatim. No new class-2 or class-3 migration registry entry is introduced.",
+      "releaseHighlights": {
+        "summary": "v2.0.0 contracts the agent-facing skill surface further along the human/agent boundary established in v1.0.0. Two breaking changes drive the major bump (per Conventional Commits + product-only SemVer; user-facing slash commands going away is breaking): - **`gdh-scan` is dropped as a managed agent skill.** The `gdh scan` CLI verb stays, but the agent-facing skill is hard-deleted. Onboard and status now invoke the CLI directly when an inventory probe is needed; existing managed targets that still carry `.claude/skills/gdh-scan/SKILL.md`, `.agents/skills/gdh-scan/SKILL.md`, or `.claude/commands/gdh/scan.md` files have them swept on the next `gdh self-update` / `gdh migrate --apply`. - **`gdh-prepare` becomes agent-invoked-only.** It is hidden from the user slash-menu (`user-invocable: false` for Claude, equivalent for Codex) and called internally by `gdh-onboard` or `gdh-status` when worktree/import readiness is needed. The skill body re-bakes with the new `prepareApprovalInstruction()` helper that narrates per-agent approval (Claude `AskUserQuestion`, Codex `request_user_input`). Together these changes continue the contraction the v1.0.0 work started: fewer human-facing surfaces, more agent-driven internal sub-skills, and explicit per-agent approval mechanics for any operation that mutates managed surfaces or triggers non-trivial side effects.",
+        "operatorChanges": [
+          "**`gdh-scan` skill removed (breaking).** The `gdh scan` CLI verb is unaffected — operators who shell out directly continue to work as before. The agent-facing managed skill at `.claude/skills/gdh-scan/SKILL.md` and `.agents/skills/gdh-scan/SKILL.md`, plus the legacy command shim at `.claude/commands/gdh/scan.md`, are retired. Agents now invoke the CLI verb directly from inside `gdh-onboard` / `gdh-status` when they need an inventory probe. Existing managed targets pick up the cleanup automatically.",
+          "**`/gdh-prepare` slash command is hidden (breaking).** The skill remains in the managed surface set (the agent calls it under the hood for cold-worktree hydration and import refresh during onboarding/status flows), but it is no longer invocable from the user slash-menu. Operators run `/gdh-onboard` or `/gdh-status`; those skills drive prepare as needed.",
+          "**Per-agent approval narrative for `/gdh-prepare`.** Like `/gdh-update` and `/gdh-migrate`, prepare now describes the provider-specific user-question tool the agent should use when asking for approval — Claude `AskUserQuestion`, Codex `request_user_input` — rather than a generic \"ask the user\" hint. The cross-provider body equality test for managed skills explicitly exempts prepare alongside update and migrate.",
+          "**Retired-managed-surface cleanup covers gdh-scan.** The cleanup planner now enumerates `.claude/skills/gdh-scan/SKILL.md`, `.agents/skills/gdh-scan/SKILL.md`, and `.claude/commands/gdh/scan.md` as content-checked deletions. User-authored content at the same paths is preserved verbatim.",
+          "**Managed adapter contract version 20 → 21.** `GDH_AGENT_CONTRACT_VERSION` bumps to drive a managed-target rebake on the next `gdh self-update` / `gdh migrate --apply`, refreshing skill bodies after gdh-scan retirement and the gdh-prepare agent-only switch."
+        ]
+      },
+      "updateContract": {
+        "summary": "Existing managed targets must re-bake managed adapter surfaces at GDH_AGENT_CONTRACT_VERSION 21. The `gdh scan` CLI verb is unchanged; only the agent-facing managed skill is dropped.",
+        "steps": [
+          {
+            "id": "install_v1_1_0",
+            "kind": "mechanical",
+            "summary": "Install the v2.0.0 GDH package.",
+            "detail": "Run gdh self-update so the target uses the v2.0.0 package with the contracted skill surface (no gdh-scan skill, agent-only gdh-prepare) and the new agent contract version.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status",
+              "gdh adapters status"
+            ]
+          },
+          {
+            "id": "rebake_managed_surfaces_and_sweep_scan",
+            "kind": "mechanical",
+            "summary": "Re-bake managed surfaces at GDH_AGENT_CONTRACT_VERSION 21 and sweep retired gdh-scan surfaces.",
+            "detail": "Run gdh migrate --apply (or invoke /gdh-update on the agent side, which calls migrate as needed). The deterministic re-bake refreshes managed skill bodies for the gdh-prepare agent-only switch and per-agent approval narrative; the retired-managed-surface cleanup planner removes any .claude/skills/gdh-scan/SKILL.md, .agents/skills/gdh-scan/SKILL.md, and .claude/commands/gdh/scan.md files that still carry GDH managed markers.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh adapters status",
+              "gdh status"
+            ]
+          },
+          {
+            "id": "switch_human_invocations_from_prepare_to_onboard_or_status",
+            "kind": "manual_review",
+            "summary": "Use /gdh-onboard or /gdh-status instead of /gdh-prepare from the human slash-menu.",
+            "detail": "/gdh-prepare is now hidden from the user slash-menu (user-invocable: false on Claude; equivalent on Codex). The agent calls prepare under the hood as part of /gdh-onboard or /gdh-status when worktree/import readiness is needed; humans interact with the parent skills only. No on-disk action is required — this is a workflow change. Validate by attempting /gdh-onboard or /gdh-status on a fresh agent session.",
+            "commands": [],
+            "validationCommands": []
+          }
+        ]
+      }
+    },
+    {
+      "version": "2.0.1",
+      "releaseTag": "v2.0.1",
+      "migrationStatus": "required",
+      "summary": "v2.0.1 pivots the highest-impact agent-facing managed-target wording away from a CLI-as-edit-loop framing for `.gd` authoring validation. Dogfood Session 18 (TheBeacon, GDH 2.0.0) showed an agent inferring a `gdh` CLI-shellout requirement from `validation_expectation: authoring-check` in `.gdh/rules.yaml` and the lead paragraph of `.gdh/guidance/authoring-and-validation.md`, even though the canonical edit-loop validator is the managed PostToolUse / PostToolBatch / Stop hook surface. The pivot rewrites the validation_expectation summary in rules.yaml and the lead paragraph plus a new scoped-feedback bullet in authoring-and-validation.md so PostToolUse / PostToolBatch / Stop hooks are named explicitly, `gdh authoring check --mode final` is positioned as handoff-only, and absence of a global `gdh` binary on PATH is framed as expected state. The change drives `GDH_RULES_SCHEMA_VERSION` 4 -> 5 and `GDH_GUIDANCE_UNIT_VERSION` 25 -> 26 so existing managed targets re-bake on the next `gdh self-update` / `gdh migrate --apply`. Both bumps are class-1 deterministic re-bake (exempt from `MIGRATION_REGISTRY_ENTRIES` per `CLASS_ONE_REBAKE_EXEMPT`). `isPriorDefaultRulesBoilerplate` recognizes both the v0.18-v0.26.7 wording (locked s2c2->s2c3 transform output) and the v0.26.8-v2.0.0 wording so chain runs from every supported corpus version land on `migration_needed` (auto-applicable) rather than `compatibility_degraded`. No project-config schema bump (`GDH_PROJECT_CONFIG_VERSION` stays at 3). No new class-2 or class-3 migration registry entry.",
+      "releaseHighlights": {
+        "summary": "v2.0.1 is a patch release that pivots the highest-impact agent-facing managed-target wording away from a CLI-as-edit-loop framing for `.gd` authoring validation. Dogfood Session 18 (TheBeacon, GDH 2.0.0) showed an agent inferring a `gdh` CLI-shellout requirement from `validation_expectation: authoring-check` in `.gdh/rules.yaml` and the lead paragraph of `.gdh/guidance/authoring-and-validation.md` — even though the canonical edit-loop validator is the managed PostToolUse / PostToolBatch / Stop hook surface, and the agent's target had hooks installed and well-formed. The agent recorded \"could not run gdh\" as a validation gap inside its ExecPlan and the operator had to redirect twice. The pivot rewrites: - the `validation_expectation: authoring-check` summary in `.gdh/rules.yaml` so PostToolUse / PostToolBatch / Stop hooks are named as the edit-loop validator, `gdh authoring check --mode final` is positioned as handoff-only, and absence of a global `gdh` binary on PATH is explicitly framed as expected state, and - the lead paragraph and scoped-feedback bullet list in `.gdh/guidance/authoring-and-validation.md` so the same three hook events are named explicitly, and a new bullet states that absence of a global `gdh` binary on PATH is not a validation gap and that the pinned `npx -y @skillcap/gdh@<pinned-version>` form is the right path when explicit handoff evidence is genuinely needed. The change drives `GDH_RULES_SCHEMA_VERSION` 4 → 5 and `GDH_GUIDANCE_UNIT_VERSION` 25 → 26 so existing managed targets re-bake on the next `gdh self-update` / `gdh migrate --apply`. Both bumps are class-1 deterministic re-bake (exempt from `MIGRATION_REGISTRY_ENTRIES` per Phase 72 D-09 / D-03 and `CLASS_ONE_REBAKE_EXEMPT` in `scripts/release-lib/registry-completeness.mjs`).",
+        "operatorChanges": [
+          "**`.gdh/rules.yaml` validation expectation summary refreshed.** The `authoring-files` path-scope's `authoring_check` validation expectation now reads \"Managed authoring validation runs through PostToolUse, PostToolBatch, and Stop hooks during normal edits; do not rerun validation commands manually. Collect explicit final-mode evidence only for handoff, unsupported file types, missing hooks, or recovery. Absence of a global `gdh` binary on PATH is expected and is not a validation gap.\" Existing managed targets that have not customized `.gdh/rules.yaml` are migrated automatically.",
+          "**`.gdh/guidance/authoring-and-validation.md` lead paragraph + new scoped-feedback bullet.** The lead paragraph now names the three hook events explicitly. A new scoped-feedback bullet covers the PATH-not-found contract and the pinned `npx -y @skillcap/gdh@<pinned-version>` form for genuine handoff.",
+          "**`isPriorDefaultRulesBoilerplate` recognizes both prior wordings.** The lifecycle inspector now recognizes both the v0.18 – v0.26.7 default body (locked s2c2→s2c3 transform output) and the v0.26.8 – v2.0.0 default body, so chain runs from any supported corpus version land on `migration_needed` (auto-applicable) rather than `compatibility_degraded`.",
+          "**Greenfield fixture refreshed.** `fixtures/greenfield-minimal/.gdh/rules.yaml` regenerates to the new rendered default so fixture-based tests don't see stale wording.",
+          "**Test refactor: `guidance-glossary.test.ts` adopts snapshot + contract pins.** Drift detection moves to `toMatchSnapshot()`; positive assertions are scoped to product-decision invariants (`.gd`-only edit-loop scope, `gdh` PATH absence, `.godot/` generated state, every-shipped-unit linked) plus the existing forbidden-content negatives. Drops ~10 wording-pin assertions that duplicated the .tpl content.",
+          "**Bundled test fix: `managed-target-surface-inventory.test.ts`.** The Codex-skill-disposition test mirrored the inventory's `RETIRED_SKILL_IDS` set incorrectly — only `skill.codex.check` was treated as retired, even though the inventory source has retired both `check` and `scan`. The test now asserts conditional retirement plus the matching staleBehavior copy."
+        ]
+      },
+      "updateContract": {
+        "summary": "Existing managed targets must re-bake managed `.gdh/rules.yaml` and `.gdh/guidance/authoring-and-validation.md` at GDH_RULES_SCHEMA_VERSION 5 and GDH_GUIDANCE_UNIT_VERSION 26. The `gdh authoring check --mode final` CLI verb is unchanged; only the in-target-guidance framing changes.",
+        "steps": [
+          {
+            "id": "install_v2_0_1",
+            "kind": "mechanical",
+            "summary": "Install the v2.0.1 GDH package.",
+            "detail": "Run gdh self-update so the target uses the v2.0.1 package with the pivoted authoring guidance and the new schema/guidance version markers.",
+            "commands": [
+              "gdh self-update --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "rebake_rules_and_guidance",
+            "kind": "mechanical",
+            "summary": "Re-bake .gdh/rules.yaml at GDH_RULES_SCHEMA_VERSION 5 and .gdh/guidance/authoring-and-validation.md at GDH_GUIDANCE_UNIT_VERSION 26.",
+            "detail": "Run gdh migrate --apply (or invoke /gdh-update on the agent side, which calls migrate as needed). The deterministic re-bake refreshes the validation_expectation summary in .gdh/rules.yaml and the lead paragraph plus the new scoped-feedback bullet in .gdh/guidance/authoring-and-validation.md. Targets whose rules.yaml carries genuine project-specific customizations stay at compatibility_degraded with manual_review so GDH does not silently overwrite operator content.",
+            "commands": [
+              "gdh migrate --apply"
+            ],
+            "validationCommands": [
+              "gdh status"
+            ]
+          },
+          {
+            "id": "drop_cli_shellout_for_normal_edit_loop",
+            "kind": "agent_reasoning",
+            "summary": "Treat absence of a global `gdh` binary on PATH as expected state during normal edit-loop work.",
+            "detail": "Managed validation runs through PostToolUse / PostToolBatch / Stop hooks; the hook surface resolves its own pinned binary internally. Do not flag `gdh not on PATH` as a validation gap and do not shell out to `gdh authoring check` during normal edits. If a project explicitly requires final-mode handoff evidence beyond hook output, run the pinned `npx -y @skillcap/gdh@<pinned-version> authoring check --mode final` form rather than assuming a global binary exists. No on-disk action is required — this is a framing change for agents reading the refreshed guidance.",
+            "commands": [],
+            "validationCommands": []
+          }
+        ]
+      }
     }
   ]
 }

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

@@ -1,6 +1,6 @@
 import { type GdhAgentAdaptersInstallResult, type GdhAgentAdaptersStatusResult, type GdhGsdSnapshot, type GdhProjectLifecycleCompatibilityResult, type GdhProjectLifecycleSurfaceStatus, type GdhStatusResult, type GdhSupportedAgent } from "@gdh/core";
 import { type GdhStatusBuildAdapters } from "./deferred-actions-advisory.js";
-export { GDH_MANAGED_AGENT_SKILL_MARKER, GDH_SKILL_DEFINITIONS, GDH_SKILL_IDS, renderGdhSkill, renderManagedSkillMarker, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeScanSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexScanSkill, renderCodexStatusSkill, renderCodexUpdateSkill, } from "./skill-rendering.js";
+export { GDH_MANAGED_AGENT_SKILL_MARKER, GDH_SKILL_DEFINITIONS, GDH_SKILL_IDS, renderGdhSkill, renderManagedSkillMarker, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexStatusSkill, renderCodexUpdateSkill, } from "./skill-rendering.js";
 export declare const adaptersPackage: import("@gdh/core").GdhPackageBoundary;
 export declare const SUPPORTED_AGENTS: readonly ["codex", "claude"];
 export declare const CLAUDE_SHIM_RELATIVE_PATH = "CLAUDE.md";
@@ -19,8 +19,6 @@ export declare const CODEX_PREPARE_SKILL_RELATIVE_PATH = ".agents/skills/gdh-pre
 export declare const CODEX_RUN_GAME_SKILL_RELATIVE_PATH = ".agents/skills/gdh-run-game/SKILL.md";
 export declare const CLAUDE_UPDATE_SKILL_RELATIVE_PATH = ".claude/skills/gdh-update/SKILL.md";
 export declare const CODEX_UPDATE_SKILL_RELATIVE_PATH = ".agents/skills/gdh-update/SKILL.md";
-export declare const CLAUDE_SCAN_SKILL_RELATIVE_PATH = ".claude/skills/gdh-scan/SKILL.md";
-export declare const CODEX_SCAN_SKILL_RELATIVE_PATH = ".agents/skills/gdh-scan/SKILL.md";
 export declare const CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH = ".claude/skills/gdh-onboard/SKILL.md";
 export declare const CLAUDE_STATUS_COMMAND_RELATIVE_PATH = ".claude/skills/gdh-status/SKILL.md";
 export declare const CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH = ".claude/skills/gdh-migrate/SKILL.md";
@@ -28,7 +26,6 @@ export declare const CLAUDE_CHECK_COMMAND_RELATIVE_PATH = ".claude/skills/gdh-ch
 export declare const CLAUDE_PREPARE_COMMAND_RELATIVE_PATH = ".claude/skills/gdh-prepare/SKILL.md";
 export declare const CLAUDE_RUN_GAME_COMMAND_RELATIVE_PATH = ".claude/skills/gdh-run-game/SKILL.md";
 export declare const CLAUDE_UPDATE_COMMAND_RELATIVE_PATH = ".claude/skills/gdh-update/SKILL.md";
-export declare const CLAUDE_SCAN_COMMAND_RELATIVE_PATH = ".claude/skills/gdh-scan/SKILL.md";
 export declare const LOCAL_PATH_HINTS_RELATIVE_PATH = ".gdh-state/local-paths.json";
 export declare const CODEX_PROJECT_CONFIG_RELATIVE_PATH = ".codex/config.toml";
 export declare const GDH_MCP_SERVER_NAME = "gdh";
@@ -51,7 +48,6 @@ export declare function createGsdSnapshot(targetPath: string, options?: {
 }): Promise<GdhGsdSnapshot>;
 export declare function renderClaudeOnboardCommand(pinnedVersion: string): string;
 export declare function renderClaudeStatusCommand(pinnedVersion: string): string;
-export declare function renderClaudeScanCommand(pinnedVersion: string): string;
 export declare function renderClaudeMigrateCommand(pinnedVersion: string): string;
 export declare function renderClaudeUpdateCommand(pinnedVersion: string): string;
 export declare function renderClaudePrepareCommand(pinnedVersion: string): string;

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":"AAgBA,OAAO,EAcL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,cAAc,EAInB,KAAK,sCAAsC,EAE3C,KAAK,gCAAgC,EAKrC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAIvB,MAAM,WAAW,CAAC;AAyBnB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,gCAAgC,CAAC;AAsCxC,OAAO,EACL,8BAA8B,EAC9B,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAe9B,eAAO,MAAM,eAAe,wCAa1B,CAAC;AAEH,eAAO,MAAM,gBAAgB,8BAGoB,CAAC;AAClD,eAAO,MAAM,yBAAyB,cAAc,CAAC;AACrD,eAAO,MAAM,kCAAkC,wCAAwC,CAAC;AACxF,eAAO,MAAM,yBAAyB,cAAc,CAAC;AACrD,eAAO,MAAM,iCAAiC,wCAAwC,CAAC;AACvF,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,mCAAmC,yCAAyC,CAAC;AAC1F,eAAO,MAAM,gCAAgC,uCAAuC,CAAC;AACrF,eAAO,MAAM,iCAAiC,wCAAwC,CAAC;AACvF,eAAO,MAAM,+BAA+B,sCAAsC,CAAC;AACnF,eAAO,MAAM,iCAAiC,wCAAwC,CAAC;AACvF,eAAO,MAAM,kCAAkC,yCAAyC,CAAC;AAOzF,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,gCAAgC,uCAAuC,CAAC;AACrF,eAAO,MAAM,+BAA+B,qCAAqC,CAAC;AAClF,eAAO,MAAM,8BAA8B,qCAAqC,CAAC;AACjF,eAAO,MAAM,oCAAoC,wCAAqC,CAAC;AACvF,eAAO,MAAM,mCAAmC,uCAAoC,CAAC;AACrF,eAAO,MAAM,oCAAoC,wCAAqC,CAAC;AACvF,eAAO,MAAM,kCAAkC,sCAAmC,CAAC;AACnF,eAAO,MAAM,oCAAoC,wCAAqC,CAAC;AACvF,eAAO,MAAM,qCAAqC,yCAAsC,CAAC;AACzF,eAAO,MAAM,mCAAmC,uCAAoC,CAAC;AACrF,eAAO,MAAM,iCAAiC,qCAAkC,CAAC;AAwCjF,eAAO,MAAM,8BAA8B,gCAAgC,CAAC;AAC5E,eAAO,MAAM,kCAAkC,uBAAuB,CAAC;AACvE,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AASzC,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,CAsBvC;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,CA8ExC;AAED,wBAAsB,oCAAoC,CACxD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,sCAAsC,CAAC,CAiEjD;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,sBAAsB,GAChC,OAAO,CAAC,eAAe,CAAC,CAmC1B;AAgDD,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,GACL,OAAO,CAAC,cAAc,CAAC,CAsCzB;AAOD,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAExE;AA84ED,wBAAgB,gCAAgC,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAQ9E;AAED,wBAAgB,+BAA+B,CAC7C,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,aAAa,EAAE,MAAM,GACpB,MAAM,CAOR;AAsvCD,iBAAS,sCAAsC,CAC7C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,gCAAgC,EAAE,GACpD,sCAAsC,CAmCxC;AAiPD,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,sCAAsC,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,EACnC,4BAA4B,EAC5B,kCAAkC,GACnC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,KAAK,sBAAsB,EAC3B,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,iCAAiC,EACjC,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,8BAA8B,GAC/B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,iBAAiB,EACjB,4BAA4B,EAC5B,gCAAgC,EAChC,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,gCAAgC,EAChC,gCAAgC,EAChC,oCAAoC,EACpC,sBAAsB,EACtB,sCAAsC,EACtC,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,+BAA+B,EAC/B,0BAA0B,EAC1B,uBAAuB,EACvB,kCAAkC,EAClC,+BAA+B,EAC/B,mBAAmB,EACnB,4BAA4B,EAC5B,eAAe,EACf,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EAAE,sCAAsC,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/node_modules/@gdh/adapters/dist/index.js

@@ -18,8 +18,8 @@ import { removeManagedCodexAuthoringHookBlock, renderManagedCodexAuthoringHookBl
 import { CLAUDE_STATUSLINE_RELATIVE_PATH, renderClaudeUpdateStatusline, } from "./claude-statusline-render.js";
 import { CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH, renderClaudeCheckUpdateHook, } from "./claude-update-hook-render.js";
 import { renderClaudeCheckUpdateWorker } from "./claude-update-worker-render.js";
-import { GDH_MANAGED_AGENT_SKILL_MARKER, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeScanSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexScanSkill, renderCodexStatusSkill, renderCodexUpdateSkill, } from "./skill-rendering.js";
-export { GDH_MANAGED_AGENT_SKILL_MARKER, GDH_SKILL_DEFINITIONS, GDH_SKILL_IDS, renderGdhSkill, renderManagedSkillMarker, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeScanSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexScanSkill, renderCodexStatusSkill, renderCodexUpdateSkill, } from "./skill-rendering.js";
+import { GDH_MANAGED_AGENT_SKILL_MARKER, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexStatusSkill, renderCodexUpdateSkill, } from "./skill-rendering.js";
+export { GDH_MANAGED_AGENT_SKILL_MARKER, GDH_SKILL_DEFINITIONS, GDH_SKILL_IDS, renderGdhSkill, renderManagedSkillMarker, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexStatusSkill, renderCodexUpdateSkill, } from "./skill-rendering.js";
 // Module-load drift guard. See packages/core/src/migrations/managed-surface-classes.ts.
 assertClassRegistered("claude_onboard_command", "deterministic");
 assertClassRegistered("claude_status_command", "deterministic");
@@ -71,8 +71,6 @@ export const CODEX_RUN_GAME_SKILL_RELATIVE_PATH = ".agents/skills/gdh-run-game/S
 // rendered bodies are version-agnostic by design.
 export const CLAUDE_UPDATE_SKILL_RELATIVE_PATH = ".claude/skills/gdh-update/SKILL.md";
 export const CODEX_UPDATE_SKILL_RELATIVE_PATH = ".agents/skills/gdh-update/SKILL.md";
-export const CLAUDE_SCAN_SKILL_RELATIVE_PATH = ".claude/skills/gdh-scan/SKILL.md";
-export const CODEX_SCAN_SKILL_RELATIVE_PATH = ".agents/skills/gdh-scan/SKILL.md";
 export const CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH = CLAUDE_ONBOARD_SKILL_RELATIVE_PATH;
 export const CLAUDE_STATUS_COMMAND_RELATIVE_PATH = CLAUDE_STATUS_SKILL_RELATIVE_PATH;
 export const CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH = CLAUDE_MIGRATE_SKILL_RELATIVE_PATH;
@@ -80,7 +78,6 @@ export const CLAUDE_CHECK_COMMAND_RELATIVE_PATH = CLAUDE_CHECK_SKILL_RELATIVE_PA
 export const CLAUDE_PREPARE_COMMAND_RELATIVE_PATH = CLAUDE_PREPARE_SKILL_RELATIVE_PATH;
 export const CLAUDE_RUN_GAME_COMMAND_RELATIVE_PATH = CLAUDE_RUN_GAME_SKILL_RELATIVE_PATH;
 export const CLAUDE_UPDATE_COMMAND_RELATIVE_PATH = CLAUDE_UPDATE_SKILL_RELATIVE_PATH;
-export const CLAUDE_SCAN_COMMAND_RELATIVE_PATH = CLAUDE_SCAN_SKILL_RELATIVE_PATH;
 const LEGACY_CLAUDE_SKILL_COMMAND_RELATIVE_PATHS = [
     [".claude/commands/gdh/onboard.md", "gdh-onboard"],
     [".claude/commands/gdh/status.md", "gdh-status"],
@@ -109,7 +106,6 @@ const CODEX_SKILL_RELATIVE_PATHS = [
     path.dirname(CODEX_UPDATE_SKILL_RELATIVE_PATH),
     path.dirname(CODEX_PREPARE_SKILL_RELATIVE_PATH),
     path.dirname(CODEX_RUN_GAME_SKILL_RELATIVE_PATH),
-    path.dirname(CODEX_SCAN_SKILL_RELATIVE_PATH),
 ];
 const CLAUDE_SKILL_RELATIVE_PATHS = [
     path.dirname(CLAUDE_ONBOARD_SKILL_RELATIVE_PATH),
@@ -118,7 +114,6 @@ const CLAUDE_SKILL_RELATIVE_PATHS = [
     path.dirname(CLAUDE_UPDATE_SKILL_RELATIVE_PATH),
     path.dirname(CLAUDE_PREPARE_SKILL_RELATIVE_PATH),
     path.dirname(CLAUDE_RUN_GAME_SKILL_RELATIVE_PATH),
-    path.dirname(CLAUDE_SCAN_SKILL_RELATIVE_PATH),
 ];
 export const LOCAL_PATH_HINTS_RELATIVE_PATH = ".gdh-state/local-paths.json";
 export const CODEX_PROJECT_CONFIG_RELATIVE_PATH = ".codex/config.toml";
@@ -391,9 +386,6 @@ export function renderClaudeOnboardCommand(pinnedVersion) {
 export function renderClaudeStatusCommand(pinnedVersion) {
     return renderClaudeStatusSkill(pinnedVersion);
 }
-export function renderClaudeScanCommand(pinnedVersion) {
-    return renderClaudeScanSkill(pinnedVersion);
-}
 export function renderClaudeMigrateCommand(pinnedVersion) {
     return renderClaudeMigrateSkill(pinnedVersion);
 }
@@ -749,9 +741,6 @@ async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersi
     const codexRunGameContent = await fs
         .readFile(path.resolve(targetPath, CODEX_RUN_GAME_SKILL_RELATIVE_PATH), "utf8")
         .catch(() => null);
-    const codexScanContent = await fs
-        .readFile(path.join(targetPath, CODEX_SCAN_SKILL_RELATIVE_PATH), "utf8")
-        .catch(() => null);
     const codexAuthoringHookContent = await fs
         .readFile(path.join(projectMcp.integrationRootPath, CODEX_AUTHORING_HOOK_RELATIVE_PATH), "utf8")
         .catch(() => null);
@@ -764,7 +753,6 @@ async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersi
     const expectedCodexUpdateSkill = pinnedVersion === null ? null : renderCodexUpdateSkill(pinnedVersion);
     const expectedCodexPrepareSkill = pinnedVersion === null ? null : renderCodexPrepareSkill(pinnedVersion);
     const expectedCodexRunGameSkill = pinnedVersion === null ? null : renderCodexRunGameSkill(pinnedVersion);
-    const expectedCodexScanSkill = pinnedVersion === null ? null : renderCodexScanSkill(pinnedVersion);
     const expectedCodexAuthoringHook = pinnedVersion === null
         ? null
         : renderGdhAuthoringHook({
@@ -819,7 +807,6 @@ async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersi
         ...inspectCodexSkillSurface(targetPath, CODEX_UPDATE_SKILL_RELATIVE_PATH, codexUpdateContent, expectedCodexUpdateSkill, "gdh-update"),
         ...inspectCodexSkillSurface(targetPath, CODEX_PREPARE_SKILL_RELATIVE_PATH, codexPrepareContent, expectedCodexPrepareSkill, "gdh-prepare"),
         ...inspectCodexSkillSurface(targetPath, CODEX_RUN_GAME_SKILL_RELATIVE_PATH, codexRunGameContent, expectedCodexRunGameSkill, "gdh-run-game"),
-        ...inspectCodexSkillSurface(targetPath, CODEX_SCAN_SKILL_RELATIVE_PATH, codexScanContent, expectedCodexScanSkill, "gdh-scan"),
         inspectManagedHookSurface("codex", projectMcp.integrationRootPath, CODEX_AUTHORING_HOOK_RELATIVE_PATH, codexAuthoringHookContent, expectedCodexAuthoringHook, "authoring guard"),
         inspectCodexAuthoringHookConfig(projectMcp.integrationRootPath, codexProjectConfigContent, projectMcp.enabled),
     ];
@@ -874,9 +861,6 @@ async function inspectClaudeAdapter(targetPath, guidance, projectMcp, pinnedVers
     const claudeRunGameContent = await fs
         .readFile(path.resolve(targetPath, CLAUDE_RUN_GAME_COMMAND_RELATIVE_PATH), "utf8")
         .catch(() => null);
-    const claudeScanContent = await fs
-        .readFile(path.join(targetPath, CLAUDE_SCAN_COMMAND_RELATIVE_PATH), "utf8")
-        .catch(() => null);
     const claudeCheckUpdateHookContent = await fs
         .readFile(path.join(targetPath, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH), "utf8")
         .catch(() => null);
@@ -913,7 +897,6 @@ async function inspectClaudeAdapter(targetPath, guidance, projectMcp, pinnedVers
     const expectedClaudeUpdateCommand = pinnedVersion === null ? null : renderClaudeUpdateCommand(pinnedVersion);
     const expectedClaudePrepareCommand = pinnedVersion === null ? null : renderClaudePrepareCommand(pinnedVersion);
     const expectedClaudeRunGameCommand = pinnedVersion === null ? null : renderClaudeRunGameCommand(pinnedVersion);
-    const expectedClaudeScanCommand = pinnedVersion === null ? null : renderClaudeScanCommand(pinnedVersion);
     const surfaces = [
         createSurfaceStatus({
             kind: "symlink",
@@ -962,7 +945,6 @@ async function inspectClaudeAdapter(targetPath, guidance, projectMcp, pinnedVers
         ...inspectClaudeSkillSurface(targetPath, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH, claudeUpdateContent, expectedClaudeUpdateCommand, "gdh-update"),
         ...inspectClaudeSkillSurface(targetPath, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, claudePrepareContent, expectedClaudePrepareCommand, "gdh-prepare"),
         ...inspectClaudeSkillSurface(targetPath, CLAUDE_RUN_GAME_COMMAND_RELATIVE_PATH, claudeRunGameContent, expectedClaudeRunGameCommand, "gdh-run-game"),
-        ...inspectClaudeSkillSurface(targetPath, CLAUDE_SCAN_COMMAND_RELATIVE_PATH, claudeScanContent, expectedClaudeScanCommand, "gdh-scan"),
         inspectManagedHookSurface("claude", targetPath, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, claudeCheckUpdateHookContent, expectedClaudeCheckUpdateHook, "gdh-check-update-hook"),
         inspectManagedHookSurface("claude", targetPath, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH, claudeCheckUpdateWorkerContent, expectedClaudeCheckUpdateWorker, "gdh-check-update-worker"),
         inspectManagedHookSurface("claude", targetPath, CLAUDE_STATUSLINE_RELATIVE_PATH, claudeStatuslineContent, expectedClaudeStatusline, "gdh-statusline"),
@@ -1337,7 +1319,6 @@ function planCodexRepoInstallActions(targetPath, adapter, pinnedVersion, project
         planSkillInstallAction("codex", targetPath, adapter, CODEX_UPDATE_SKILL_RELATIVE_PATH, renderCodexUpdateSkill, "gdh-update", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_PREPARE_SKILL_RELATIVE_PATH, renderCodexPrepareSkill, "gdh-prepare", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_RUN_GAME_SKILL_RELATIVE_PATH, renderCodexRunGameSkill, "gdh-run-game", pinnedVersion),
-        planSkillInstallAction("codex", targetPath, adapter, CODEX_SCAN_SKILL_RELATIVE_PATH, renderCodexScanSkill, "gdh-scan", pinnedVersion),
         planSkillInstallAction("codex", integrationRootPath, adapter, CODEX_AUTHORING_HOOK_RELATIVE_PATH, (version) => renderGdhAuthoringHook({
             pinnedVersion: version,
             targetRelativePath: path.relative(integrationRootPath, targetPath) || ".",
@@ -1439,6 +1420,34 @@ const RETIRED_MANAGED_SURFACE_RELATIVE_PATHS = [
             (content.includes("@skillcap/gdh@") || content.includes("gdh verify recommend")),
         replacementSummary: "Agents should use `gdh authoring check --mode final` for code-validity evidence.",
     },
+    // Retired generated discovery skill (v1.1.0). The `gdh scan` CLI verb
+    // stays — only the agent-facing skill is dropped. Targets that ran a
+    // pre-v1.1 GDH still carry GDH-rendered SKILL.md and command files at the
+    // managed paths; the cleanup planner removes them content-checked so
+    // user-authored content at the same paths is preserved verbatim. Agents
+    // now invoke `gdh scan` directly from gdh-onboard or gdh-status when an
+    // inventory probe is needed.
+    {
+        agent: "codex",
+        relativePath: ".agents/skills/gdh-scan/SKILL.md",
+        skillName: "gdh-scan",
+        isManaged: isManagedAgentSkillContent,
+        replacementSummary: "The gdh-scan skill is retired; the `gdh scan` CLI verb stays and agents invoke it directly from gdh-onboard or gdh-status when an inventory probe is needed.",
+    },
+    {
+        agent: "claude",
+        relativePath: ".claude/skills/gdh-scan/SKILL.md",
+        skillName: "gdh-scan",
+        isManaged: isManagedAgentSkillContent,
+        replacementSummary: "The gdh-scan skill is retired; the `gdh scan` CLI verb stays and agents invoke it directly from gdh-onboard or gdh-status when an inventory probe is needed.",
+    },
+    {
+        agent: "claude",
+        relativePath: ".claude/commands/gdh/scan.md",
+        skillName: "gdh-scan",
+        isManaged: isManagedAgentSkillContent,
+        replacementSummary: "The gdh-scan command shim is retired; the `gdh scan` CLI verb stays and agents invoke it directly from gdh-onboard or gdh-status when an inventory probe is needed.",
+    },
     // Retired cursor agent (commit 7f65b098, "feat(adapters)!: drop cursor
     // agent from source"). Cursor was a hard delete — no deprecation shim — so
     // legacy targets that ran a pre-removal GDH still carry GDH-rendered files
@@ -1646,7 +1655,7 @@ function planClaudeInstallActions(targetPath, adapter, pinnedVersion, integratio
             expectedTarget: "AGENTS.md",
         }));
     }
-    actions.push(planSkillInstallAction("claude", targetPath, adapter, CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH, renderClaudeOnboardCommand, "gdh-onboard", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_STATUS_COMMAND_RELATIVE_PATH, renderClaudeStatusCommand, "gdh-status", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH, renderClaudeMigrateCommand, "gdh-migrate", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH, renderClaudeUpdateCommand, "gdh-update", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, renderClaudePrepareCommand, "gdh-prepare", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_RUN_GAME_COMMAND_RELATIVE_PATH, renderClaudeRunGameCommand, "gdh-run-game", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_SCAN_COMMAND_RELATIVE_PATH, renderClaudeScanCommand, "gdh-scan", pinnedVersion), 
+    actions.push(planSkillInstallAction("claude", targetPath, adapter, CLAUDE_ONBOARD_COMMAND_RELATIVE_PATH, renderClaudeOnboardCommand, "gdh-onboard", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_STATUS_COMMAND_RELATIVE_PATH, renderClaudeStatusCommand, "gdh-status", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH, renderClaudeMigrateCommand, "gdh-migrate", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH, renderClaudeUpdateCommand, "gdh-update", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, renderClaudePrepareCommand, "gdh-prepare", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_RUN_GAME_COMMAND_RELATIVE_PATH, renderClaudeRunGameCommand, "gdh-run-game", pinnedVersion), 
     // UPD-01 managed hook surfaces baked at the pinned version.
     planHookInstallAction("claude", targetPath, adapter, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, renderClaudeCheckUpdateHook, "gdh-check-update-hook", pinnedVersion), planHookInstallAction("claude", targetPath, adapter, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH, renderClaudeCheckUpdateWorker, "gdh-check-update-worker", pinnedVersion), 
     // Optional statusline script baked at the pinned version. The .js file is
@@ -2425,10 +2434,21 @@ async function isDefaultRulesBoilerplate(targetPath, projectConfig) {
     return actual === expected || isPriorDefaultRulesBoilerplate(actual);
 }
 function isPriorDefaultRulesBoilerplate(content) {
-    // v0.26.8 changed only the default authoring-validation wording to stop
-    // telling agents to rerun hook-owned checks during edit loops. Prior v3
-    // boilerplate is still GDH-owned default content, so it is safe to refresh.
-    const priorV3Default = `version: ${GDH_RULES_SCHEMA_VERSION}
+    // Each entry below is a prior-version GDH-owned default rules body that is
+    // safe to refresh to the current default during `gdh migrate --apply`. The
+    // `version:` line is interpolated to the CURRENT schema version because
+    // `coerceRulesDocument` normalizes the on-disk header before this comparison.
+    // Append a new entry here when the live default body changes; removing an
+    // older entry drops chain support for targets last touched at that wording.
+    //
+    // - v0.18-v0.26.7 wording: "Run `gdh authoring check` after changing Godot
+    //   source or project configuration files." Also the locked s2c2→s2c3
+    //   transform output, so chain matrix runs from v0.18.0 land here.
+    // - v0.26.8-v2.0.0 wording: "Do not rerun authoring checks during normal
+    //   hooked edits..." Stopped telling agents to rerun hook-owned checks but
+    //   still positioned `authoring-check` as a CLI-shaped verb.
+    const priorRulesBoilerplateBodies = [
+        `version: ${GDH_RULES_SCHEMA_VERSION}
 hard_rules:
   - id: "authoring-validation-evidence"
     summary: "Use GDH authoring check evidence when judging Godot code validity."
@@ -2491,8 +2511,73 @@ path_scopes:
         kind: "editor_validation"
         required: true
         summary: "Arrange editor-side validation for \`EditorPlugin\` and plugin configuration changes before claiming code validity."
-`;
-    return content === priorV3Default;
+`,
+        `version: ${GDH_RULES_SCHEMA_VERSION}
+hard_rules:
+  - id: "authoring-validation-evidence"
+    summary: "Use managed authoring validation evidence when judging Godot code validity."
+    rationale: "Authoring validity should come from GDH diagnostics or final validation evidence, not readiness guesses."
+    validation_expectations:
+      []
+soft_guidance:
+  - id: "prefer-gdh-surfaces"
+    summary: "Prefer GDH status, target-prepare, authoring, import-refresh, and guidance surfaces over ad hoc Godot-state guesses."
+    rationale: "GDH exists to make Godot authoring and validation constraints inspectable instead of folklore-driven."
+    validation_expectations:
+      []
+prohibited_patterns:
+  - id: "generated-godot-state-is-not-truth"
+    summary: "Do not treat \`.godot/\` generated state as durable project truth or hand-edit it unless a project-specific rule says otherwise."
+    rationale: "Generated import/editor state is environment-sensitive and should not become the source of truth for agents."
+    validation_expectations:
+      []
+  - id: "dont-copy-project-local-env-files-by-default"
+    summary: "Do not copy project-local env files such as \`.env.local\` as part of default GDH target preparation unless project-specific guidance explicitly says to do so."
+    rationale: "Default GDH preparation should stay deterministic and should not silently inherit machine-local env behavior from another checkout."
+    validation_expectations:
+      []
+path_scopes:
+  - id: "authoring-files"
+    summary: "Authoring-facing Godot source and project files rely on managed hook feedback during edits and explicit validation evidence at handoff."
+    path_globs:
+      - "**/*.gd"
+      - "**/*.tscn"
+      - "**/*.tres"
+      - "project.godot"
+    hard_rules:
+      []
+    soft_guidance:
+      []
+    prohibited_patterns:
+      []
+    validation_expectations:
+      - id: "authoring-check"
+        kind: "authoring_check"
+        required: true
+        summary: "Do not rerun authoring checks during normal hooked edits; collect explicit authoring-check evidence only for handoff, unsupported file types, missing hooks, or recovery."
+  - id: "editor-plugin-files"
+    summary: "EditorPlugin and plugin configuration work requires editor-side validation, not only runtime confidence."
+    path_globs:
+      - "addons/**/plugin.gd"
+      - "addons/**/plugin.cfg"
+    hard_rules:
+      []
+    soft_guidance:
+      - id: "surface-editor-validation"
+        summary: "Surface editor-side caveats explicitly when plugin or \`@tool\` work is involved."
+        rationale: "Phase 3 already detects editor-side caveats at the point of use and Phase 4 should preserve that distinction."
+        validation_expectations:
+          []
+    prohibited_patterns:
+      []
+    validation_expectations:
+      - id: "editor-validation"
+        kind: "editor_validation"
+        required: true
+        summary: "Arrange editor-side validation for \`EditorPlugin\` and plugin configuration changes before claiming code validity."
+`,
+    ];
+    return priorRulesBoilerplateBodies.includes(content);
 }
 function inspectAgentContractLifecycleSurface(targetPath, guidanceStatus) {
     const status = guidanceStatus.agentContract;