@skillcap/gdh 0.5.0 → 0.6.0

package/node_modules/@gdh/adapters/dist/claude-update-hook-render.js

@@ -0,0 +1,76 @@
+import { GDH_UPDATE_HOOK_VERSION } from "@gdh/core";
+/**
+ * Relative path of the managed Claude SessionStart parent hook script.
+ * This is the .js file Claude Code invokes when a session opens on a
+ * GDH-managed target; it spawns the worker that refreshes the update cache.
+ */
+export const CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH = ".claude/hooks/gdh-check-update.js";
+/**
+ * Relative path of the managed Claude background worker script the parent
+ * hook spawns. The worker performs the HTTPS probe and writes the cache.
+ */
+export const CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH = ".claude/hooks/gdh-check-update-worker.js";
+/**
+ * Render the Claude SessionStart parent hook source that will be baked into
+ * a managed Claude target at the given pinned GDH version.
+ *
+ * The returned string is written verbatim to
+ * `.claude/hooks/gdh-check-update.js` by the adapter install pipeline.
+ *
+ * Invariants enforced by this renderer (see 11-02-PLAN):
+ *   - shebang on line 1; a hook-version marker on line 2 for drift detection
+ *   - dev-mode short-circuit on GDH_DEV_REPO runs BEFORE spawn()
+ *   - spawn uses detached:true + child.unref() + windowsHide:true + stdio:'ignore'
+ *   - pinned version flows to the worker via GDH_PINNED_VERSION env var
+ *   - cache file path flows to the worker via GDH_CACHE_FILE env var
+ *   - cache dir (~/.cache/gdh/) is created with fs.mkdirSync recursive:true
+ *
+ * The body wraps everything after the requires in an IIFE so `return` exits
+ * cleanly (Node's CommonJS module body does not allow top-level return).
+ *
+ * The baked script is deliberately dependency-free — it imports only Node
+ * built-ins and does NOT resolve @gdh/core at runtime. Every string in the
+ * output is literal JavaScript.
+ */
+export function renderClaudeCheckUpdateHook(pinnedVersion) {
+    return [
+        "#!/usr/bin/env node",
+        `// gdh-hook-version: ${GDH_UPDATE_HOOK_VERSION}`,
+        "// Check for GDH updates in background, write result to cache.",
+        "// Called by Claude Code SessionStart hook — runs once per session.",
+        "// Baked by @gdh/adapters at the pinned gdh_version — regenerated by gdh self-update.",
+        "",
+        "const fs = require('fs');",
+        "const path = require('path');",
+        "const os = require('os');",
+        "const { spawn } = require('child_process');",
+        "",
+        "(function () {",
+        "  // Dev-mode short-circuit: contributors running from source must never see an update signal.",
+        "  // (Baked script cannot read .gdh-state/local-paths.json without @gdh/core; env var covers the contributor case.)",
+        "  if (process.env.GDH_DEV_REPO && process.env.GDH_DEV_REPO.trim()) return;",
+        "",
+        "  const homeDir = os.homedir();",
+        "  const cacheDir = path.join(homeDir, '.cache', 'gdh');",
+        "  const cacheFile = path.join(cacheDir, 'update-check.json');",
+        "",
+        "  try { fs.mkdirSync(cacheDir, { recursive: true }); } catch (e) {}",
+        "",
+        "  const workerPath = path.join(__dirname, 'gdh-check-update-worker.js');",
+        "  const child = spawn(process.execPath, [workerPath], {",
+        "    stdio: 'ignore',",
+        "    windowsHide: true,",
+        "    detached: true,",
+        "    env: {",
+        "      ...process.env,",
+        "      GDH_CACHE_FILE: cacheFile,",
+        `      GDH_PINNED_VERSION: ${JSON.stringify(pinnedVersion)},`,
+        "    },",
+        "  });",
+        "",
+        "  child.unref();",
+        "})();",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=claude-update-hook-render.js.map

package/node_modules/@gdh/adapters/dist/claude-update-hook-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-update-hook-render.js","sourceRoot":"","sources":["../src/claude-update-hook-render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sCAAsC,GACjD,mCAAmC,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,wCAAwC,GACnD,0CAA0C,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,2BAA2B,CAAC,aAAqB;IAC/D,OAAO;QACL,qBAAqB;QACrB,wBAAwB,uBAAuB,EAAE;QACjD,gEAAgE;QAChE,qEAAqE;QACrE,uFAAuF;QACvF,EAAE;QACF,2BAA2B;QAC3B,+BAA+B;QAC/B,2BAA2B;QAC3B,6CAA6C;QAC7C,EAAE;QACF,gBAAgB;QAChB,gGAAgG;QAChG,qHAAqH;QACrH,4EAA4E;QAC5E,EAAE;QACF,iCAAiC;QACjC,yDAAyD;QACzD,+DAA+D;QAC/D,EAAE;QACF,qEAAqE;QACrE,EAAE;QACF,0EAA0E;QAC1E,yDAAyD;QACzD,sBAAsB;QACtB,wBAAwB;QACxB,qBAAqB;QACrB,YAAY;QACZ,uBAAuB;QACvB,kCAAkC;QAClC,6BAA6B,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG;QAC7D,QAAQ;QACR,OAAO;QACP,EAAE;QACF,kBAAkB;QAClB,OAAO;QACP,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/node_modules/@gdh/adapters/dist/claude-update-worker-render.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Render the background worker source that is spawned (detached + unref) by
+ * the SessionStart parent hook. The worker performs the HTTPS probe against
+ * the npm registry and writes the result to the shared per-user cache.
+ *
+ * The `pinnedVersion` parameter is accepted for API uniformity with
+ * `renderClaudeCheckUpdateHook`; the worker body itself reads the pinned
+ * version from `process.env.GDH_PINNED_VERSION` so that future regenerations
+ * only need to rewrite the parent hook's env injection.
+ *
+ * The returned string is written verbatim to
+ * `.claude/hooks/gdh-check-update-worker.js` by the adapter install pipeline.
+ *
+ * Invariants enforced by this renderer (see 11-02-PLAN):
+ *   - shebang on line 1; a hook-version marker on line 2 for drift detection
+ *   - dev-mode short-circuit on GDH_DEV_REPO runs at top of IIFE
+ *   - no-pinned fallback uses the exact literal `if (!pinned) return;`
+ *   - native fetch + AbortSignal.timeout(10000) — no npm shellout, no external deps
+ *   - all I/O + parse + network wrapped in try/catch (silent-failure D-06)
+ *   - no stale_hooks scan (GSD-specific; drift detection is `gdh verify drift`)
+ *   - result object shape matches UpdateCheckCacheEntry from @gdh/core
+ *
+ * The baked script is deliberately dependency-free — it imports only Node
+ * built-ins and does NOT resolve @gdh/core at runtime. The semver compare
+ * (`isNewer`) is inlined verbatim from the GSD worker pattern.
+ */
+export declare function renderClaudeCheckUpdateWorker(_pinnedVersion?: string): string;
+//# sourceMappingURL=claude-update-worker-render.d.ts.map

package/node_modules/@gdh/adapters/dist/claude-update-worker-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-update-worker-render.d.ts","sourceRoot":"","sources":["../src/claude-update-worker-render.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAsER"}

package/node_modules/@gdh/adapters/dist/claude-update-worker-render.js

@@ -0,0 +1,99 @@
+import { GDH_UPDATE_HOOK_VERSION, GDH_UPDATE_REGISTRY_URL, } from "@gdh/core";
+/**
+ * Render the background worker source that is spawned (detached + unref) by
+ * the SessionStart parent hook. The worker performs the HTTPS probe against
+ * the npm registry and writes the result to the shared per-user cache.
+ *
+ * The `pinnedVersion` parameter is accepted for API uniformity with
+ * `renderClaudeCheckUpdateHook`; the worker body itself reads the pinned
+ * version from `process.env.GDH_PINNED_VERSION` so that future regenerations
+ * only need to rewrite the parent hook's env injection.
+ *
+ * The returned string is written verbatim to
+ * `.claude/hooks/gdh-check-update-worker.js` by the adapter install pipeline.
+ *
+ * Invariants enforced by this renderer (see 11-02-PLAN):
+ *   - shebang on line 1; a hook-version marker on line 2 for drift detection
+ *   - dev-mode short-circuit on GDH_DEV_REPO runs at top of IIFE
+ *   - no-pinned fallback uses the exact literal `if (!pinned) return;`
+ *   - native fetch + AbortSignal.timeout(10000) — no npm shellout, no external deps
+ *   - all I/O + parse + network wrapped in try/catch (silent-failure D-06)
+ *   - no stale_hooks scan (GSD-specific; drift detection is `gdh verify drift`)
+ *   - result object shape matches UpdateCheckCacheEntry from @gdh/core
+ *
+ * The baked script is deliberately dependency-free — it imports only Node
+ * built-ins and does NOT resolve @gdh/core at runtime. The semver compare
+ * (`isNewer`) is inlined verbatim from the GSD worker pattern.
+ */
+export function renderClaudeCheckUpdateWorker(_pinnedVersion) {
+    // _pinnedVersion is accepted for API uniformity with the hook renderer;
+    // the worker body itself reads process.env.GDH_PINNED_VERSION at runtime.
+    return [
+        "#!/usr/bin/env node",
+        `// gdh-hook-version: ${GDH_UPDATE_HOOK_VERSION}`,
+        "// Background worker spawned by the GDH SessionStart parent hook.",
+        "// Probes https://registry.npmjs.org/@skillcap/gdh/latest and writes the",
+        "// result to the per-user cache at ~/.cache/gdh/update-check.json.",
+        "// Exits silently on any failure — D-06 silent-failure contract.",
+        "",
+        "'use strict';",
+        "",
+        "const fs = require('fs');",
+        "",
+        "// Compare semver: true if a is strictly newer than b.",
+        "// Strips pre-release suffixes (e.g. '3-beta.1' → '3') to avoid NaN from Number().",
+        "function isNewer(a, b) {",
+        "  const pa = (a || '').split('.').map(s => Number(s.replace(/-.*/, '')) || 0);",
+        "  const pb = (b || '').split('.').map(s => Number(s.replace(/-.*/, '')) || 0);",
+        "  for (let i = 0; i < 3; i++) {",
+        "    if (pa[i] > pb[i]) return true;",
+        "    if (pa[i] < pb[i]) return false;",
+        "  }",
+        "  return false;",
+        "}",
+        "",
+        "(async () => {",
+        "  // Dev-mode short-circuit: contributors running from source must never see an update signal.",
+        "  // (Baked worker checks ONLY the env var — cannot read local-paths.json without @gdh/core.)",
+        "  if (process.env.GDH_DEV_REPO && process.env.GDH_DEV_REPO.trim()) return;",
+        "",
+        "  const pinned = process.env.GDH_PINNED_VERSION;",
+        "  if (!pinned) return;",
+        "",
+        "  const cacheFile = process.env.GDH_CACHE_FILE;",
+        "  if (!cacheFile) return;",
+        "",
+        "  let res = null;",
+        "  try {",
+        `    res = await fetch(${JSON.stringify(GDH_UPDATE_REGISTRY_URL)}, {`,
+        "      signal: AbortSignal.timeout(10000),",
+        "    });",
+        "  } catch (e) {}",
+        "",
+        "  let latest = null;",
+        "  if (res && res.ok) {",
+        "    try {",
+        "      const body = await res.json();",
+        "      if (typeof body.version === 'string') {",
+        "        latest = body.version;",
+        "      }",
+        "    } catch (e) {}",
+        "  }",
+        "",
+        "  // Offline / registry 5xx / parse error — write nothing per D-06.",
+        "  if (latest === null) return;",
+        "",
+        "  const result = {",
+        "    pinned,",
+        "    latest,",
+        "    checkedAt: new Date().toISOString(),",
+        "    source: 'npm-registry-latest',",
+        "    updateAvailable: isNewer(latest, pinned),",
+        "  };",
+        "",
+        "  try { fs.writeFileSync(cacheFile, JSON.stringify(result, null, 2)); } catch (e) {}",
+        "})();",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=claude-update-worker-render.js.map

package/node_modules/@gdh/adapters/dist/claude-update-worker-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-update-worker-render.js","sourceRoot":"","sources":["../src/claude-update-worker-render.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,6BAA6B,CAC3C,cAAuB;IAEvB,wEAAwE;IACxE,0EAA0E;IAC1E,OAAO;QACL,qBAAqB;QACrB,wBAAwB,uBAAuB,EAAE;QACjD,mEAAmE;QACnE,0EAA0E;QAC1E,oEAAoE;QACpE,kEAAkE;QAClE,EAAE;QACF,eAAe;QACf,EAAE;QACF,2BAA2B;QAC3B,EAAE;QACF,wDAAwD;QACxD,oFAAoF;QACpF,0BAA0B;QAC1B,gFAAgF;QAChF,gFAAgF;QAChF,iCAAiC;QACjC,qCAAqC;QACrC,sCAAsC;QACtC,KAAK;QACL,iBAAiB;QACjB,GAAG;QACH,EAAE;QACF,gBAAgB;QAChB,gGAAgG;QAChG,+FAA+F;QAC/F,4EAA4E;QAC5E,EAAE;QACF,kDAAkD;QAClD,wBAAwB;QACxB,EAAE;QACF,iDAAiD;QACjD,2BAA2B;QAC3B,EAAE;QACF,mBAAmB;QACnB,SAAS;QACT,yBAAyB,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,KAAK;QACrE,2CAA2C;QAC3C,SAAS;QACT,kBAAkB;QAClB,EAAE;QACF,sBAAsB;QACtB,wBAAwB;QACxB,WAAW;QACX,sCAAsC;QACtC,+CAA+C;QAC/C,gCAAgC;QAChC,SAAS;QACT,oBAAoB;QACpB,KAAK;QACL,EAAE;QACF,qEAAqE;QACrE,gCAAgC;QAChC,EAAE;QACF,oBAAoB;QACpB,aAAa;QACb,aAAa;QACb,0CAA0C;QAC1C,oCAAoC;QACpC,+CAA+C;QAC/C,MAAM;QACN,EAAE;QACF,sFAAsF;QACtF,OAAO;QACP,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

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_UPDATE_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/update.md";
+export declare const CODEX_UPDATE_SKILL_RELATIVE_PATH = ".codex/skills/gdh-update/SKILL.md";
+export declare const CURSOR_UPDATE_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-update/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";
@@ -60,6 +63,9 @@ 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 renderClaudeUpdateCommand(_pinnedVersion: string): string;
+export declare function renderCodexUpdateSkill(_pinnedVersion: string): string;
+export declare function renderCursorUpdateSkill(_pinnedVersion: string): string;
 export declare function renderClaudeCheckCommand(pinnedVersion: string): string;
 export declare function renderCodexCheckSkill(pinnedVersion: string): string;
 export declare function renderCursorCheckSkill(pinnedVersion: string): string;
@@ -70,4 +76,7 @@ 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;
+export { bumpAndRebakePin, type BumpAndRebakePinResult, } from "./self-update-mechanics.js";
+export { CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH } from "./claude-update-hook-render.js";
+export { CLAUDE_STATUSLINE_RELATIVE_PATH } from "./claude-statusline-render.js";
 //# 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":"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"}
+{"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

@@ -5,6 +5,10 @@ import os from "node:os";
 import path from "node:path";
 import { promisify } from "node:util";
 import { readProjectConfig, resolvePinnedVersion, resolvePinnedVersionOrNull, resolveProjectRoot, readWorktreeState, resolveAuthoringStatus, } from "@gdh/authoring";
+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 { CLAUDE_STATUSLINE_RELATIVE_PATH, renderClaudeUpdateStatusline, } from "./claude-statusline-render.js";
+import { CLAUDE_SETTINGS_RELATIVE_PATH, patchClaudeSettingsForGdhSessionStart, patchClaudeSettingsForGdhStatusline, } from "./claude-settings-patch.js";
 import { GDH_AGENT_CONTRACT_VERSION, GDH_CURSOR_RULE_VERSION, GDH_GUIDANCE_INDEX_VERSION, GDH_GUIDANCE_UNIT_VERSION, GDH_MCP_LAUNCHER_VERSION, GDH_PROJECT_CONFIG_VERSION, GDH_RECIPE_SCHEMA_VERSION, GDH_RULES_SCHEMA_VERSION, GDH_SCENARIO_SCHEMA_VERSION, definePackageBoundary, resolveCurrentGdhInstall, resolveGdhProductMetadata, } from "@gdh/core";
 import { createDefaultGuidanceUnits, getGuidanceStatus, resolveGuidanceQuery, } from "@gdh/docs";
 import { inspectGuidanceAudit } from "@gdh/observability";
@@ -48,6 +52,15 @@ export const CURSOR_MIGRATE_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-migrate/SK
 export const CURSOR_CHECK_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-check/SKILL.md";
 export const CURSOR_PREPARE_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-prepare/SKILL.md";
 export const CURSOR_VERIFY_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-verify/SKILL.md";
+// Phase 13 SELF-01: /gdh-update skill surface path constants. The rendered
+// bodies shell out to `npx -y @skillcap/gdh@latest self-update` (LITERAL
+// @latest, not the pinned version — D-10) so the NEW CLI performs the update,
+// not the (potentially pre-Phase-12) OLD pinned one. These constants are
+// INTENTIONALLY excluded from VERIFY_DRIFT_SCANNED_FILES (D-13) because the
+// rendered bodies are version-agnostic by design.
+export const CLAUDE_UPDATE_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/update.md";
+export const CODEX_UPDATE_SKILL_RELATIVE_PATH = ".codex/skills/gdh-update/SKILL.md";
+export const CURSOR_UPDATE_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-update/SKILL.md";
 export const CLAUDE_SCAN_COMMAND_RELATIVE_PATH = ".claude/commands/gdh/scan.md";
 export const CODEX_SCAN_SKILL_RELATIVE_PATH = ".codex/skills/gdh-scan/SKILL.md";
 export const CURSOR_SCAN_SKILL_RELATIVE_PATH = ".cursor/skills/gdh-scan/SKILL.md";
@@ -774,6 +787,133 @@ export function renderCursorMigrateSkill(pinnedVersion) {
         "",
     ].join("\n");
 }
+// --- gdh-update skill renders (Phase 13 SELF-01) ---
+//
+// D-10 invariant: every rendered body shells out to the LITERAL string
+// `@skillcap/gdh@latest` in every npx line (dry-run, apply, verify drift).
+// The `pinnedVersion` parameter is accepted for planSkillInstallAction
+// signature symmetry with every other renderer, but MUST NOT be interpolated
+// into the shellout — running the OLD pinned CLI (potentially pre-Phase-12
+// and lacking bumpAndRebakePin entirely) to perform its own update is the
+// failure mode Phase 13 exists to close. Check 44 in scripts/validate-docs.mjs
+// enforces both the @latest presence AND the @${pinnedVersion} absence.
+//
+// D-11: preview-then-apply flow WITHOUT a confirmation gate — the human's
+// original intent ("update GDH") IS the approval. No AskUserQuestion for
+// Claude; no `## User questions` H2 for Codex/Cursor. Differs from /gdh-migrate
+// which DOES gate on explicit approval.
+//
+// D-12: accept an optional positional version forwarded verbatim to the CLI.
+// `/gdh-update` = latest; `/gdh-update 0.6.0` = pin that version.
+//
+// D-13: the three rendered skill files are EXCLUDED from VERIFY_DRIFT_SCANNED_FILES
+// because @latest is not a semver literal — the baked-version scanner would
+// permanently report no_baked_version. See rationale comments adjacent to the
+// VERIFY_DRIFT_SCANNED_FILES declaration in packages/cli/src/index.ts.
+export function renderClaudeUpdateCommand(_pinnedVersion) {
+    return [
+        "---",
+        "name: gdh:update",
+        "description: Update GDH to npm latest (bump pinned version + re-bake managed surfaces)",
+        "allowed-tools:",
+        "  - Read",
+        "  - Bash",
+        "---",
+        "<objective>",
+        "Update this project's GDH pinning to npm latest and re-bake every managed surface at the new pin.",
+        "Treat any positional argument (e.g., `/gdh-update 0.6.0`) as an explicit version; otherwise default to npm latest.",
+        "</objective>",
+        "",
+        "<process>",
+        "Follow this order:",
+        "",
+        "1. Preview: run `npx -y @skillcap/gdh@latest self-update [version] --dry-run` (omit `[version]` to preview against npm latest).",
+        "2. Surface the planned version delta and re-bake action count to the human conversationally.",
+        "3. Apply: run `npx -y @skillcap/gdh@latest self-update [version]` (omit `[version]` to apply against npm latest; forward whatever positional the user passed to `/gdh-update`).",
+        "4. Verify: run `npx -y @skillcap/gdh@latest verify drift` to confirm every baked surface matches the new pin.",
+        "</process>",
+        "",
+        "<rules>",
+        "- Do NOT ask the user to confirm apply — their original intent (\"update GDH\") IS the approval.",
+        "- Bake literal `@latest` in the shellout so the new CLI performs the update, not the old one.",
+        "- If `self-update` returns `rolled_back` or `blocked`, surface the failure reason and stop (do not retry).",
+        "- If `self-update` returns `skipped_dev_mode`, explain that dev-from-source mode bypasses pinning; no action needed.",
+        "</rules>",
+        "",
+    ].join("\n");
+}
+export function renderCodexUpdateSkill(_pinnedVersion) {
+    return [
+        "---",
+        'name: "gdh-update"',
+        'description: "Update GDH to npm latest (bump pinned version + re-bake managed surfaces)"',
+        "metadata:",
+        '  short-description: "Update GDH to npm latest"',
+        "---",
+        "",
+        "<codex_skill_adapter>",
+        "## Invocation",
+        "- This skill is invoked when the user says `/gdh-update` or mentions `$gdh-update`.",
+        "- Treat any positional argument (e.g., `/gdh-update 0.6.0`) as an explicit version; otherwise default to npm latest.",
+        "</codex_skill_adapter>",
+        "",
+        "<objective>",
+        "Update this project's GDH pinning to npm latest and re-bake every managed surface at the new pin.",
+        "</objective>",
+        "",
+        "<process>",
+        "Follow this order:",
+        "",
+        "1. Preview: run `npx -y @skillcap/gdh@latest self-update [version] --dry-run` (omit `[version]` to preview against npm latest).",
+        "2. Surface the planned version delta and re-bake action count to the human conversationally.",
+        "3. Apply: run `npx -y @skillcap/gdh@latest self-update [version]` (omit `[version]` to apply against npm latest; forward whatever positional the user passed to `/gdh-update`).",
+        "4. Verify: run `npx -y @skillcap/gdh@latest verify drift` to confirm every baked surface matches the new pin.",
+        "</process>",
+        "",
+        "<rules>",
+        "- Do NOT ask the user to confirm apply — their original intent (\"update GDH\") IS the approval.",
+        "- Bake literal `@latest` in the shellout so the new CLI performs the update, not the old one.",
+        "- If `self-update` returns `rolled_back` or `blocked`, surface the failure reason and stop (do not retry).",
+        "- If `self-update` returns `skipped_dev_mode`, explain that dev-from-source mode bypasses pinning; no action needed.",
+        "</rules>",
+        "",
+    ].join("\n");
+}
+export function renderCursorUpdateSkill(_pinnedVersion) {
+    return [
+        "---",
+        "name: gdh-update",
+        'description: "Update GDH to npm latest (bump pinned version + re-bake managed surfaces)"',
+        "---",
+        "",
+        "<cursor_skill_adapter>",
+        "## Invocation",
+        "- This skill is invoked when the user says `/gdh-update` or mentions `gdh-update`.",
+        "- Treat any positional argument (e.g., `gdh-update 0.6.0`) as an explicit version; otherwise default to npm latest.",
+        "</cursor_skill_adapter>",
+        "",
+        "<objective>",
+        "Update this project's GDH pinning to npm latest and re-bake every managed surface at the new pin.",
+        "</objective>",
+        "",
+        "<process>",
+        "Follow this order:",
+        "",
+        "1. Preview: run `npx -y @skillcap/gdh@latest self-update [version] --dry-run` (omit `[version]` to preview against npm latest).",
+        "2. Surface the planned version delta and re-bake action count to the human conversationally.",
+        "3. Apply: run `npx -y @skillcap/gdh@latest self-update [version]` (omit `[version]` to apply against npm latest; forward whatever positional the user passed to `/gdh-update`).",
+        "4. Verify: run `npx -y @skillcap/gdh@latest verify drift` to confirm every baked surface matches the new pin.",
+        "</process>",
+        "",
+        "<rules>",
+        "- Do NOT ask the user to confirm apply — their original intent (\"update GDH\") IS the approval.",
+        "- Bake literal `@latest` in the shellout so the new CLI performs the update, not the old one.",
+        "- If `self-update` returns `rolled_back` or `blocked`, surface the failure reason and stop (do not retry).",
+        "- If `self-update` returns `skipped_dev_mode`, explain that dev-from-source mode bypasses pinning; no action needed.",
+        "</rules>",
+        "",
+    ].join("\n");
+}
 // --- gdh-check skill renders ---
 export function renderClaudeCheckCommand(pinnedVersion) {
     return [
@@ -1440,6 +1580,11 @@ async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersi
     const codexSkillContent = await fs.readFile(codexSkillPath, "utf8").catch(() => null);
     const codexStatusContent = await fs.readFile(path.join(targetPath, CODEX_STATUS_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
     const codexMigrateContent = await fs.readFile(path.join(targetPath, CODEX_MIGRATE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
+    // Phase 13 Plan 13-03 deliverable — /gdh-update skill for Codex. Inspection
+    // wiring is required so planSkillInstallAction can see the surface state;
+    // otherwise the planner returns `unchanged` for a missing file and install
+    // becomes a no-op (Plan 13-05 integration-test Rule 2 fix).
+    const codexUpdateContent = await fs.readFile(path.join(targetPath, CODEX_UPDATE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
     const codexCheckContent = await fs.readFile(path.join(targetPath, CODEX_CHECK_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
     const codexPrepareContent = await fs.readFile(path.join(targetPath, CODEX_PREPARE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
     const codexVerifyContent = await fs.readFile(path.join(targetPath, CODEX_VERIFY_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
@@ -1447,6 +1592,7 @@ async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersi
     const expectedCodexOnboardSkill = pinnedVersion === null ? null : renderCodexOnboardSkill(pinnedVersion);
     const expectedCodexStatusSkill = pinnedVersion === null ? null : renderCodexStatusSkill(pinnedVersion);
     const expectedCodexMigrateSkill = pinnedVersion === null ? null : renderCodexMigrateSkill(pinnedVersion);
+    const expectedCodexUpdateSkill = pinnedVersion === null ? null : renderCodexUpdateSkill(pinnedVersion);
     const expectedCodexCheckSkill = pinnedVersion === null ? null : renderCodexCheckSkill(pinnedVersion);
     const expectedCodexPrepareSkill = pinnedVersion === null ? null : renderCodexPrepareSkill(pinnedVersion);
     const expectedCodexVerifySkill = pinnedVersion === null ? null : renderCodexVerifySkill(pinnedVersion);
@@ -1494,6 +1640,7 @@ async function inspectCodexAdapter(targetPath, guidance, projectMcp, pinnedVersi
         }),
         ...inspectCodexSkillSurface(targetPath, CODEX_STATUS_SKILL_RELATIVE_PATH, codexStatusContent, expectedCodexStatusSkill, "gdh-status"),
         ...inspectCodexSkillSurface(targetPath, CODEX_MIGRATE_SKILL_RELATIVE_PATH, codexMigrateContent, expectedCodexMigrateSkill, "gdh-migrate"),
+        ...inspectCodexSkillSurface(targetPath, CODEX_UPDATE_SKILL_RELATIVE_PATH, codexUpdateContent, expectedCodexUpdateSkill, "gdh-update"),
         ...inspectCodexSkillSurface(targetPath, CODEX_CHECK_SKILL_RELATIVE_PATH, codexCheckContent, expectedCodexCheckSkill, "gdh-check"),
         ...inspectCodexSkillSurface(targetPath, CODEX_PREPARE_SKILL_RELATIVE_PATH, codexPrepareContent, expectedCodexPrepareSkill, "gdh-prepare"),
         ...inspectCodexSkillSurface(targetPath, CODEX_VERIFY_SKILL_RELATIVE_PATH, codexVerifyContent, expectedCodexVerifySkill, "gdh-verify"),
@@ -1533,17 +1680,29 @@ async function inspectClaudeAdapter(targetPath, guidance, projectMcp, pinnedVers
     const onboardCommandContent = await fs.readFile(onboardCommandPath, "utf8").catch(() => null);
     const claudeStatusContent = await fs.readFile(path.join(targetPath, CLAUDE_STATUS_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
     const claudeMigrateContent = await fs.readFile(path.join(targetPath, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
+    // Phase 13 Plan 13-03 deliverable — /gdh-update slash command for Claude.
+    // Inspection wiring is required so planSkillInstallAction can see the surface
+    // state; otherwise the planner returns `unchanged` for a missing file and
+    // install becomes a no-op (Plan 13-05 integration-test Rule 2 fix).
+    const claudeUpdateContent = await fs.readFile(path.join(targetPath, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
     const claudeCheckContent = await fs.readFile(path.join(targetPath, CLAUDE_CHECK_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
     const claudePrepareContent = await fs.readFile(path.join(targetPath, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH), "utf8").catch(() => null);
     const claudeVerifyContent = await fs.readFile(path.join(targetPath, CLAUDE_VERIFY_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);
+    const claudeCheckUpdateWorkerContent = await fs.readFile(path.join(targetPath, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH), "utf8").catch(() => null);
+    const claudeStatuslineContent = await fs.readFile(path.join(targetPath, CLAUDE_STATUSLINE_RELATIVE_PATH), "utf8").catch(() => null);
     let detectedTarget = null;
     if (lstat?.isSymbolicLink()) {
         detectedTarget = await fs.readlink(absolutePath).catch(() => null);
     }
     const expectedClaudeOnboardCommand = pinnedVersion === null ? null : renderClaudeOnboardCommand(pinnedVersion);
+    const expectedClaudeCheckUpdateHook = pinnedVersion === null ? null : renderClaudeCheckUpdateHook(pinnedVersion);
+    const expectedClaudeCheckUpdateWorker = pinnedVersion === null ? null : renderClaudeCheckUpdateWorker(pinnedVersion);
+    const expectedClaudeStatusline = pinnedVersion === null ? null : renderClaudeUpdateStatusline(pinnedVersion);
     const expectedClaudeStatusCommand = pinnedVersion === null ? null : renderClaudeStatusCommand(pinnedVersion);
     const expectedClaudeMigrateCommand = pinnedVersion === null ? null : renderClaudeMigrateCommand(pinnedVersion);
+    const expectedClaudeUpdateCommand = pinnedVersion === null ? null : renderClaudeUpdateCommand(pinnedVersion);
     const expectedClaudeCheckCommand = pinnedVersion === null ? null : renderClaudeCheckCommand(pinnedVersion);
     const expectedClaudePrepareCommand = pinnedVersion === null ? null : renderClaudePrepareCommand(pinnedVersion);
     const expectedClaudeVerifyCommand = pinnedVersion === null ? null : renderClaudeVerifyCommand(pinnedVersion);
@@ -1593,10 +1752,14 @@ async function inspectClaudeAdapter(targetPath, guidance, projectMcp, pinnedVers
         }),
         ...inspectClaudeCommandSurface(targetPath, CLAUDE_STATUS_COMMAND_RELATIVE_PATH, claudeStatusContent, expectedClaudeStatusCommand, "gdh-status"),
         ...inspectClaudeCommandSurface(targetPath, CLAUDE_MIGRATE_COMMAND_RELATIVE_PATH, claudeMigrateContent, expectedClaudeMigrateCommand, "gdh-migrate"),
+        ...inspectClaudeCommandSurface(targetPath, CLAUDE_UPDATE_COMMAND_RELATIVE_PATH, claudeUpdateContent, expectedClaudeUpdateCommand, "gdh-update"),
         ...inspectClaudeCommandSurface(targetPath, CLAUDE_CHECK_COMMAND_RELATIVE_PATH, claudeCheckContent, expectedClaudeCheckCommand, "gdh-check"),
         ...inspectClaudeCommandSurface(targetPath, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, claudePrepareContent, expectedClaudePrepareCommand, "gdh-prepare"),
         ...inspectClaudeCommandSurface(targetPath, CLAUDE_VERIFY_COMMAND_RELATIVE_PATH, claudeVerifyContent, expectedClaudeVerifyCommand, "gdh-verify"),
         ...inspectClaudeCommandSurface(targetPath, CLAUDE_SCAN_COMMAND_RELATIVE_PATH, claudeScanContent, expectedClaudeScanCommand, "gdh-scan"),
+        ...inspectClaudeCommandSurface(targetPath, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, claudeCheckUpdateHookContent, expectedClaudeCheckUpdateHook, "gdh-check-update-hook"),
+        ...inspectClaudeCommandSurface(targetPath, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH, claudeCheckUpdateWorkerContent, expectedClaudeCheckUpdateWorker, "gdh-check-update-worker"),
+        ...inspectClaudeCommandSurface(targetPath, CLAUDE_STATUSLINE_RELATIVE_PATH, claudeStatuslineContent, expectedClaudeStatusline, "gdh-statusline"),
     ];
     if (projectMcp.enabled) {
         surfaces.push(createSurfaceStatus({
@@ -1630,6 +1793,11 @@ async function inspectCursorAdapter(targetPath, guidance, projectMcp, pinnedVers
     const onboardSkillContent = await fs.readFile(onboardSkillPath, "utf8").catch(() => null);
     const cursorStatusContent = await fs.readFile(path.join(targetPath, CURSOR_STATUS_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
     const cursorMigrateContent = await fs.readFile(path.join(targetPath, CURSOR_MIGRATE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
+    // Phase 13 Plan 13-03 deliverable — /gdh-update skill for Cursor. Inspection
+    // wiring required so planSkillInstallAction sees the surface state; otherwise
+    // the planner returns `unchanged` for a missing file and install becomes a
+    // no-op (Plan 13-05 integration-test Rule 2 fix).
+    const cursorUpdateContent = await fs.readFile(path.join(targetPath, CURSOR_UPDATE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
     const cursorCheckContent = await fs.readFile(path.join(targetPath, CURSOR_CHECK_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
     const cursorPrepareContent = await fs.readFile(path.join(targetPath, CURSOR_PREPARE_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
     const cursorVerifyContent = await fs.readFile(path.join(targetPath, CURSOR_VERIFY_SKILL_RELATIVE_PATH), "utf8").catch(() => null);
@@ -1639,6 +1807,7 @@ async function inspectCursorAdapter(targetPath, guidance, projectMcp, pinnedVers
     const expectedCursorOnboardSkill = pinnedVersion === null ? null : renderCursorOnboardSkill(pinnedVersion);
     const expectedCursorStatusSkill = pinnedVersion === null ? null : renderCursorStatusSkill(pinnedVersion);
     const expectedCursorMigrateSkill = pinnedVersion === null ? null : renderCursorMigrateSkill(pinnedVersion);
+    const expectedCursorUpdateSkill = pinnedVersion === null ? null : renderCursorUpdateSkill(pinnedVersion);
     const expectedCursorCheckSkill = pinnedVersion === null ? null : renderCursorCheckSkill(pinnedVersion);
     const expectedCursorPrepareSkill = pinnedVersion === null ? null : renderCursorPrepareSkill(pinnedVersion);
     const expectedCursorVerifySkill = pinnedVersion === null ? null : renderCursorVerifySkill(pinnedVersion);
@@ -1686,6 +1855,7 @@ async function inspectCursorAdapter(targetPath, guidance, projectMcp, pinnedVers
         }),
         ...inspectCursorSkillSurface(targetPath, CURSOR_STATUS_SKILL_RELATIVE_PATH, cursorStatusContent, expectedCursorStatusSkill, "gdh-status"),
         ...inspectCursorSkillSurface(targetPath, CURSOR_MIGRATE_SKILL_RELATIVE_PATH, cursorMigrateContent, expectedCursorMigrateSkill, "gdh-migrate"),
+        ...inspectCursorSkillSurface(targetPath, CURSOR_UPDATE_SKILL_RELATIVE_PATH, cursorUpdateContent, expectedCursorUpdateSkill, "gdh-update"),
         ...inspectCursorSkillSurface(targetPath, CURSOR_CHECK_SKILL_RELATIVE_PATH, cursorCheckContent, expectedCursorCheckSkill, "gdh-check"),
         ...inspectCursorSkillSurface(targetPath, CURSOR_PREPARE_SKILL_RELATIVE_PATH, cursorPrepareContent, expectedCursorPrepareSkill, "gdh-prepare"),
         ...inspectCursorSkillSurface(targetPath, CURSOR_VERIFY_SKILL_RELATIVE_PATH, cursorVerifyContent, expectedCursorVerifySkill, "gdh-verify"),
@@ -1939,6 +2109,7 @@ function planCodexRepoInstallActions(targetPath, adapter, pinnedVersion) {
         planSkillInstallAction("codex", targetPath, adapter, CODEX_ONBOARD_SKILL_RELATIVE_PATH, renderCodexOnboardSkill, "gdh-onboard", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_STATUS_SKILL_RELATIVE_PATH, renderCodexStatusSkill, "gdh-status", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_MIGRATE_SKILL_RELATIVE_PATH, renderCodexMigrateSkill, "gdh-migrate", pinnedVersion),
+        planSkillInstallAction("codex", targetPath, adapter, CODEX_UPDATE_SKILL_RELATIVE_PATH, renderCodexUpdateSkill, "gdh-update", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_CHECK_SKILL_RELATIVE_PATH, renderCodexCheckSkill, "gdh-check", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_PREPARE_SKILL_RELATIVE_PATH, renderCodexPrepareSkill, "gdh-prepare", pinnedVersion),
         planSkillInstallAction("codex", targetPath, adapter, CODEX_VERIFY_SKILL_RELATIVE_PATH, renderCodexVerifySkill, "gdh-verify", pinnedVersion),
@@ -2024,7 +2195,55 @@ function planClaudeInstallActions(targetPath, adapter, pinnedVersion) {
             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_CHECK_COMMAND_RELATIVE_PATH, renderClaudeCheckCommand, "gdh-check", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, renderClaudePrepareCommand, "gdh-prepare", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_VERIFY_COMMAND_RELATIVE_PATH, renderClaudeVerifyCommand, "gdh-verify", 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_CHECK_COMMAND_RELATIVE_PATH, renderClaudeCheckCommand, "gdh-check", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_PREPARE_COMMAND_RELATIVE_PATH, renderClaudePrepareCommand, "gdh-prepare", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_VERIFY_COMMAND_RELATIVE_PATH, renderClaudeVerifyCommand, "gdh-verify", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_SCAN_COMMAND_RELATIVE_PATH, renderClaudeScanCommand, "gdh-scan", pinnedVersion), 
+    // UPD-01 managed hook surfaces baked at the pinned version.
+    planSkillInstallAction("claude", targetPath, adapter, CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH, renderClaudeCheckUpdateHook, "gdh-check-update-hook", pinnedVersion), planSkillInstallAction("claude", targetPath, adapter, CLAUDE_CHECK_UPDATE_WORKER_RELATIVE_PATH, renderClaudeCheckUpdateWorker, "gdh-check-update-worker", pinnedVersion), 
+    // UPD-02 managed statusline surface baked at the pinned version. The .js
+    // file is ALWAYS baked, even when settings.json statusLine is not owned
+    // by GDH (write-if-absent below) — users can manually point their config
+    // at gdh-statusline.js later; the baked file is a no-op until wired.
+    planSkillInstallAction("claude", targetPath, adapter, CLAUDE_STATUSLINE_RELATIVE_PATH, renderClaudeUpdateStatusline, "gdh-statusline", pinnedVersion));
+    // UPD-01 + UPD-02 .claude/settings.json composite patch action.
+    //   - Plan 02 (Strategy A, planner-lock #1): patch-merge the SessionStart
+    //     hook entry by exact command-literal match, preserving siblings.
+    //   - Plan 03 (write-if-absent, planner-lock #2 / D-18): add the statusLine
+    //     entry ONLY when no existing statusLine is configured (e.g. GSD-owned
+    //     or user-owned). Silent no-op for UPD-02 on targets where another
+    //     tool already owns the slot; the universal surface is MCP _meta.
+    //
+    // Synchronous read via fsSync is intentional: planClaudeInstallActions is
+    // called without `await`, and making it async would ripple to every sibling
+    // planner (Codex, Cursor). The composed patches are idempotent and
+    // commutative (proven in Task 1 Test J) so application order is irrelevant.
+    let existingSettingsContent = "";
+    try {
+        existingSettingsContent = fsSync.readFileSync(path.join(targetPath, CLAUDE_SETTINGS_RELATIVE_PATH), "utf8");
+    }
+    catch {
+        existingSettingsContent = "";
+    }
+    const patchedSettings = patchClaudeSettingsForGdhStatusline(patchClaudeSettingsForGdhSessionStart(existingSettingsContent));
+    const settingsIsUnchanged = existingSettingsContent === patchedSettings;
+    const settingsExistedOnDisk = existingSettingsContent.length > 0;
+    actions.push(createInstallAction({
+        agent: "claude",
+        kind: "write_file",
+        scope: "repo",
+        targetPath,
+        relativePath: CLAUDE_SETTINGS_RELATIVE_PATH,
+        state: settingsIsUnchanged ? "unchanged" : "planned",
+        mode: settingsIsUnchanged
+            ? "unchanged"
+            : settingsExistedOnDisk
+                ? "replace"
+                : "create",
+        summary: settingsIsUnchanged
+            ? "GDH SessionStart hook + statusline already registered in .claude/settings.json."
+            : settingsExistedOnDisk
+                ? "Register the GDH SessionStart hook and statusline (write-if-absent) in .claude/settings.json while preserving sibling content (patch-merge)."
+                : "Create .claude/settings.json with the GDH SessionStart hook + statusline registration.",
+        content: patchedSettings,
+    }));
     return actions;
 }
 function planCursorInstallActions(targetPath, adapter, pinnedVersion) {
@@ -2060,7 +2279,7 @@ function planCursorInstallActions(targetPath, adapter, pinnedVersion) {
             content: renderCursorRule(),
         }));
     }
-    actions.push(planSkillInstallAction("cursor", targetPath, adapter, CURSOR_ONBOARD_SKILL_RELATIVE_PATH, renderCursorOnboardSkill, "gdh-onboard", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_STATUS_SKILL_RELATIVE_PATH, renderCursorStatusSkill, "gdh-status", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_MIGRATE_SKILL_RELATIVE_PATH, renderCursorMigrateSkill, "gdh-migrate", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_CHECK_SKILL_RELATIVE_PATH, renderCursorCheckSkill, "gdh-check", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_PREPARE_SKILL_RELATIVE_PATH, renderCursorPrepareSkill, "gdh-prepare", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_VERIFY_SKILL_RELATIVE_PATH, renderCursorVerifySkill, "gdh-verify", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_SCAN_SKILL_RELATIVE_PATH, renderCursorScanSkill, "gdh-scan", pinnedVersion));
+    actions.push(planSkillInstallAction("cursor", targetPath, adapter, CURSOR_ONBOARD_SKILL_RELATIVE_PATH, renderCursorOnboardSkill, "gdh-onboard", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_STATUS_SKILL_RELATIVE_PATH, renderCursorStatusSkill, "gdh-status", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_MIGRATE_SKILL_RELATIVE_PATH, renderCursorMigrateSkill, "gdh-migrate", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_UPDATE_SKILL_RELATIVE_PATH, renderCursorUpdateSkill, "gdh-update", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_CHECK_SKILL_RELATIVE_PATH, renderCursorCheckSkill, "gdh-check", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_PREPARE_SKILL_RELATIVE_PATH, renderCursorPrepareSkill, "gdh-prepare", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_VERIFY_SKILL_RELATIVE_PATH, renderCursorVerifySkill, "gdh-verify", pinnedVersion), planSkillInstallAction("cursor", targetPath, adapter, CURSOR_SCAN_SKILL_RELATIVE_PATH, renderCursorScanSkill, "gdh-scan", pinnedVersion));
     return actions;
 }
 function dedupeInstallActions(actions) {
@@ -3279,4 +3498,7 @@ function deriveRepoState(context) {
 function normalizeChangedFiles(files) {
     return [...new Set(files.map((file) => file.trim()).filter((file) => file.length > 0))];
 }
+export { bumpAndRebakePin, } from "./self-update-mechanics.js";
+export { CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH } from "./claude-update-hook-render.js";
+export { CLAUDE_STATUSLINE_RELATIVE_PATH } from "./claude-statusline-render.js";
 //# sourceMappingURL=index.js.map