@skillcap/gdh 0.5.0 → 0.6.0

package/node_modules/@gdh/cli/dist/self-update.js

@@ -0,0 +1,235 @@
+import { bumpAndRebakePin, } from "@gdh/adapters";
+import { resolveNpmLatestVersion, } from "@gdh/core";
+import { extractPositionalArgs, findUnsupportedOptionsError, formatCliError, readSingleOptionValue, recordSessionEvent, writeJsonResult, } from "./index.js";
+/**
+ * Phase 13 Plan 13-02: CLI wrapper for `gdh self-update`.
+ *
+ * Thin composition layer over the Phase 12 `bumpAndRebakePin` orchestrator:
+ *   1. Parse argv — `[version]` positional + `--dry-run` + `--target <path>`.
+ *   2. Resolve target version — explicit passthrough (D-03) OR
+ *      `resolveNpmLatestVersion` fresh-probe-then-cache (D-04).
+ *   3. Invoke `bumpAndRebakePin` — orchestrator owns SELF-03 dev-mode gate
+ *      (Step 1 at mechanics layer; do NOT duplicate here).
+ *   4. Emit stderr one-liner BEFORE stdout JSON (Phase 11 D-11 flush order).
+ *   5. Emit structured JSON `{ command, targetPath, dryRun, result }` (D-16).
+ *   6. Record `self_update` session event — non-blocking (D-18).
+ *
+ * Divergence from `runMigrateCommand`: default action is APPLY (D-05), not
+ * dry-run. The Agent-First rationale is in CONTEXT.md D-05 — the skill
+ * (Plan 13-03) runs a `--dry-run` preview first via the same CLI, then
+ * applies. The human's intent is the approval.
+ */
+const USAGE_LINE = "Usage: gdh self-update [version] [--dry-run] [--target <path>]\n";
+export async function runSelfUpdateCommand(args, io) {
+    if (args.includes("--help")) {
+        io.stdout.write([
+            "Usage: gdh self-update [version] [--dry-run] [--target <path>]",
+            "",
+            "Bump the pinned gdh_version and re-bake every managed surface at the new pin.",
+            "Defaults to npm latest. Pass a version (e.g., 0.6.0) to pin explicitly.",
+            "",
+            "Flags:",
+            "  --dry-run           Preview the plan without mutating disk.",
+            "  --target <path>     Target directory (default: cwd).",
+            "",
+            "Note: agents typically invoke this via the /gdh-update slash command; see docs/product/CORE_PRODUCT_VALUES.md §Agent-First.",
+        ].join("\n") + "\n");
+        return 0;
+    }
+    const unsupportedOptionsError = findUnsupportedOptionsError(args, {
+        usage: USAGE_LINE,
+        booleanOptions: ["--dry-run"],
+        optionsWithValues: ["--target"],
+    });
+    if (unsupportedOptionsError !== null) {
+        io.stderr.write(unsupportedOptionsError);
+        return 1;
+    }
+    // --target is a value-bearing flag; include it in the exclusion set so its
+    // value is not mistaken for a second positional version argument.
+    const positionalArgs = extractPositionalArgs(args, new Set(["--dry-run", "--target"]));
+    if (positionalArgs.length > 1) {
+        io.stderr.write("Usage error: gdh self-update accepts at most one positional version.\n");
+        return 1;
+    }
+    const explicitVersion = positionalArgs[0] ?? null;
+    // D-05 divergence: default is APPLY. No `--apply` flag; `--dry-run` is
+    // OPT-IN (Phase 14 harness + skill preview rely on it being explicit).
+    const dryRun = args.includes("--dry-run");
+    const targetOverride = readSingleOptionValue(args, "--target");
+    const targetPath = targetOverride ?? ".";
+    const commandStartedAtMs = Date.now();
+    try {
+        // D-03: explicit version passes through verbatim. No npm pre-validate —
+        // `bumpAndRebakePin` / `writePinnedVersion` surface invalid semver as
+        // `state: "blocked"` which the caller already handles.
+        let resolvedLatest = null;
+        let targetVersion;
+        if (explicitVersion !== null) {
+            targetVersion = explicitVersion;
+        }
+        else {
+            resolvedLatest = await resolveNpmLatestVersion();
+            if (resolvedLatest === null) {
+                const reason = "No version specified and npm/cache unreachable.";
+                const blockedResult = {
+                    state: "blocked",
+                    reason,
+                };
+                // stderr banner first, then stdout JSON (flush-order convention).
+                emitSelfUpdateStderrSummary(io, blockedResult);
+                writeJsonResult(io, {
+                    command: "gdh self-update",
+                    targetPath,
+                    dryRun,
+                    result: blockedResult,
+                });
+                await safeRecordSessionEvent(targetPath, {
+                    commandStartedAtMs,
+                    state: "blocked",
+                    summary: `GDH self-update blocked — ${reason}`,
+                    errorMessage: reason,
+                });
+                return 1;
+            }
+            targetVersion = resolvedLatest.version;
+            if (resolvedLatest.source === "cache") {
+                const age = resolvedLatest.checkedAt ?? "unknown time";
+                io.stderr.write(`⚠ Using cached latest from ${age} — registry unreachable.\n`);
+            }
+        }
+        const result = await bumpAndRebakePin(targetPath, {
+            targetVersion,
+            dryRun,
+        });
+        // Phase 11 D-11 flush-order — stderr FIRST, then stdout JSON.
+        emitSelfUpdateStderrSummary(io, result);
+        writeJsonResult(io, {
+            command: "gdh self-update",
+            targetPath,
+            dryRun,
+            result,
+        });
+        await safeRecordSessionEvent(targetPath, {
+            commandStartedAtMs,
+            state: mapBumpStateToEventState(result.state),
+            summary: summarizeBumpResult(result),
+            errorMessage: errorMessageForBumpResult(result),
+            producedArtifacts: artifactsForBumpResult(result, dryRun),
+        });
+        return exitCodeForState(result.state);
+    }
+    catch (error) {
+        io.stderr.write(`Failed to self-update "${targetPath}": ${formatCliError(error)}\n`);
+        return 1;
+    }
+}
+// ---------------------------------------------------------------------------
+// helpers
+// ---------------------------------------------------------------------------
+/** D-15: updated/noop/skipped_dev_mode → 0; rolled_back/blocked → 1. */
+function exitCodeForState(state) {
+    return state === "rolled_back" || state === "blocked" ? 1 : 0;
+}
+/** D-18: BumpAndRebakePinResult.state → GdhAuthoringSessionEventState. */
+function mapBumpStateToEventState(state) {
+    if (state === "updated" || state === "noop" || state === "skipped_dev_mode") {
+        return "succeeded";
+    }
+    if (state === "rolled_back") {
+        return "failed";
+    }
+    return "blocked";
+}
+/** Human-readable state summary for the session-event record (D-18). */
+function summarizeBumpResult(result) {
+    switch (result.state) {
+        case "updated":
+            return `Updated GDH from ${result.fromVersion} to ${result.toVersion} (${result.actions.length} surfaces re-baked).`;
+        case "noop":
+            return `GDH already at ${result.currentVersion} (no changes).`;
+        case "skipped_dev_mode":
+            return `Skipped GDH self-update — dev-mode (GDH_DEV_REPO=${result.devRepoPath}).`;
+        case "rolled_back":
+            return `Re-bake failed — rolled back to ${result.fromVersion} (attempted ${result.attemptedToVersion}): ${result.failureReason}.`;
+        case "blocked":
+            return `GDH self-update blocked — ${result.reason}.`;
+    }
+}
+function errorMessageForBumpResult(result) {
+    if (result.state === "rolled_back") {
+        return result.failureReason;
+    }
+    if (result.state === "blocked") {
+        return result.reason;
+    }
+    return undefined;
+}
+function artifactsForBumpResult(result, dryRun) {
+    if (result.state !== "updated" || dryRun) {
+        return [];
+    }
+    return result.actions
+        .map((action) => action.relativePath ?? "")
+        .filter((relativePath) => relativePath.length > 0);
+}
+/**
+ * D-18 non-blocking session-event emission. Mirrors the bridge_status
+ * try/catch pattern at packages/cli/src/index.ts:2000–2017. The underlying
+ * {@link recordSessionEvent} already swallows observability failures, but we
+ * wrap with an additional try/catch so the CLI exit code is never altered by
+ * anything the observability pipeline raises — including synchronous throws
+ * between the call boundary and the inner try.
+ */
+async function safeRecordSessionEvent(targetPath, partial) {
+    try {
+        // exactOptionalPropertyTypes: only include optional keys when set — passing
+        // `errorMessage: undefined` / `producedArtifacts: undefined` is a type error.
+        const event = {
+            commandStartedAtMs: partial.commandStartedAtMs,
+            kind: "self_update",
+            command: "gdh self-update",
+            state: partial.state,
+            summary: partial.summary,
+            ...(partial.producedArtifacts !== undefined
+                ? { producedArtifacts: partial.producedArtifacts }
+                : {}),
+            ...(partial.errorMessage !== undefined
+                ? { errorMessage: partial.errorMessage }
+                : {}),
+        };
+        await recordSessionEvent(targetPath, event);
+    }
+    catch {
+        // Session event writes MUST NOT fail the primary command (D-18).
+    }
+}
+/**
+ * D-17 stderr one-liner. ANSI color only when stderr.isTTY is truthy.
+ * `noop` and `skipped_dev_mode` are always plain — per design they are
+ * normal/expected states, not warnings.
+ */
+function emitSelfUpdateStderrSummary(io, result) {
+    const tty = Boolean(io.stderr.isTTY ?? process.stderr.isTTY);
+    const color = (ansi, core) => tty ? `${ansi}${core}\x1b[0m` : core;
+    let line;
+    switch (result.state) {
+        case "updated":
+            line = color("\x1b[32m", `⬆ GDH updated ${result.fromVersion} → ${result.toVersion} (${result.actions.length} surfaces re-baked).`);
+            break;
+        case "noop":
+            line = `= GDH already at ${result.currentVersion} (no changes).`;
+            break;
+        case "skipped_dev_mode":
+            line = `⊘ GDH self-update skipped — dev mode (GDH_DEV_REPO=${result.devRepoPath}).`;
+            break;
+        case "rolled_back":
+            line = color("\x1b[31m", `↩ GDH self-update rolled back to ${result.fromVersion} — re-bake failed: ${result.failureReason}.`);
+            break;
+        case "blocked":
+            line = color("\x1b[31m", `✗ GDH self-update blocked — ${result.reason}.`);
+            break;
+    }
+    io.stderr.write(`${line}\n`);
+}
+//# sourceMappingURL=self-update.js.map

package/node_modules/@gdh/cli/dist/self-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-update.js","sourceRoot":"","sources":["../src/self-update.ts"],"names":[],"mappings":"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"}

package/node_modules/@gdh/cli/dist/update-banner.d.ts

@@ -0,0 +1,42 @@
+/**
+ * UPD-04 CLI update banner (Phase 11 D-11/D-12/D-13/D-14).
+ *
+ * Emits a yellow-when-TTY, plain-when-piped banner to stderr ONLY when the
+ * shared `~/.cache/gdh/update-check.json` cache reports that pinned lags npm
+ * latest. Silent when the cache is empty, current, offline, or the caller is
+ * in dev-mode — D-06 silent-degrade is total. `readGdhUpdateMetaOrNull`
+ * owns all of that logic; this module just renders the banner and writes it.
+ *
+ * Scope is strictly D-13: only wired into `runStatusCommand` and
+ * `runVerifyCommand`. Every other CLI command stays banner-free.
+ */
+interface StderrLike {
+    write(data: string): boolean | void;
+    isTTY?: boolean;
+}
+export interface BannerIo {
+    readonly stderr: StderrLike;
+}
+/**
+ * Pure formatter — deterministic output with no I/O. Colored form wraps the
+ * body in ANSI-yellow + reset. The hint literal comes from
+ * `GDH_UPDATE_REMEDIATION_HINT` (D-14 single source of truth, shared with
+ * the MCP `_meta.hint` field emitted by Plan 04).
+ */
+export declare function formatGdhUpdateBanner(meta: {
+    readonly pinned: string;
+    readonly latest: string;
+}, colored: boolean): string;
+/**
+ * Read the shared update-check cache through `@gdh/core` and — only when the
+ * cache signals a stale pin — write a single banner line to `io.stderr`. The
+ * helper NEVER throws (D-06): any failure reading the cache, resolving live
+ * pinned version, or writing the banner surfaces as silence. JSON stdout of
+ * the caller is never touched.
+ *
+ * Call this BEFORE the primary-work dispatch so the stderr prelude precedes
+ * any stdout JSON emitted by the command.
+ */
+export declare function emitUpdateBannerIfStale(targetPath: string, io: BannerIo): Promise<void>;
+export {};
+//# sourceMappingURL=update-banner.d.ts.map

package/node_modules/@gdh/cli/dist/update-banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-banner.d.ts","sourceRoot":"","sources":["../src/update-banner.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AAEH,UAAU,UAAU;IAClB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAYD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC1D,OAAO,EAAE,OAAO,GACf,MAAM,CAGR;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,QAAQ,GACX,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/node_modules/@gdh/cli/dist/update-banner.js

@@ -0,0 +1,49 @@
+import { GDH_UPDATE_REMEDIATION_HINT, readGdhUpdateMetaOrNull, } from "@gdh/core";
+const ANSI_YELLOW = "\x1b[33m";
+const ANSI_RESET = "\x1b[0m";
+function isStderrTty(stream) {
+    if (typeof stream.isTTY === "boolean") {
+        return stream.isTTY;
+    }
+    return Boolean(process.stderr.isTTY);
+}
+/**
+ * Pure formatter — deterministic output with no I/O. Colored form wraps the
+ * body in ANSI-yellow + reset. The hint literal comes from
+ * `GDH_UPDATE_REMEDIATION_HINT` (D-14 single source of truth, shared with
+ * the MCP `_meta.hint` field emitted by Plan 04).
+ */
+export function formatGdhUpdateBanner(meta, colored) {
+    const core = `⬆ GDH ${meta.latest} available (pinned ${meta.pinned}). ${GDH_UPDATE_REMEDIATION_HINT}`;
+    return colored ? `${ANSI_YELLOW}${core}${ANSI_RESET}\n` : `${core}\n`;
+}
+/**
+ * Read the shared update-check cache through `@gdh/core` and — only when the
+ * cache signals a stale pin — write a single banner line to `io.stderr`. The
+ * helper NEVER throws (D-06): any failure reading the cache, resolving live
+ * pinned version, or writing the banner surfaces as silence. JSON stdout of
+ * the caller is never touched.
+ *
+ * Call this BEFORE the primary-work dispatch so the stderr prelude precedes
+ * any stdout JSON emitted by the command.
+ */
+export async function emitUpdateBannerIfStale(targetPath, io) {
+    let meta;
+    try {
+        meta = await readGdhUpdateMetaOrNull(targetPath);
+    }
+    catch {
+        meta = null;
+    }
+    if (meta === null) {
+        return;
+    }
+    const colored = isStderrTty(io.stderr);
+    try {
+        io.stderr.write(formatGdhUpdateBanner(meta, colored));
+    }
+    catch {
+        // D-06: banner writes never surface failures to the user.
+    }
+}
+//# sourceMappingURL=update-banner.js.map

package/node_modules/@gdh/cli/dist/update-banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-banner.js","sourceRoot":"","sources":["../src/update-banner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,WAAW,CAAC;AAwBnB,MAAM,WAAW,GAAG,UAAU,CAAC;AAC/B,MAAM,UAAU,GAAG,SAAS,CAAC;AAE7B,SAAS,WAAW,CAAC,MAAkB;IACrC,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAA0D,EAC1D,OAAgB;IAEhB,MAAM,IAAI,GAAG,SAAS,IAAI,CAAC,MAAM,sBAAsB,IAAI,CAAC,MAAM,MAAM,2BAA2B,EAAE,CAAC;IACtG,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,IAAI,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;AACxE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAkB,EAClB,EAAY;IAEZ,IAAI,IAAyD,CAAC;IAC9D,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;AACH,CAAC"}

package/node_modules/@gdh/cli/package.json

@@ -15,16 +15,16 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@gdh/adapters": "0.5.0",
-    "@gdh/authoring": "0.5.0",
-    "@gdh/core": "0.5.0",
-    "@gdh/docs": "0.5.0",
-    "@gdh/mcp": "0.5.0",
-    "@gdh/observability": "0.5.0",
-    "@gdh/runtime": "0.5.0",
-    "@gdh/scan": "0.5.0",
-    "@gdh/verify": "0.5.0",
+    "@gdh/adapters": "0.6.0",
+    "@gdh/authoring": "0.6.0",
+    "@gdh/core": "0.6.0",
+    "@gdh/docs": "0.6.0",
+    "@gdh/mcp": "0.6.0",
+    "@gdh/observability": "0.6.0",
+    "@gdh/runtime": "0.6.0",
+    "@gdh/scan": "0.6.0",
+    "@gdh/verify": "0.6.0",
     "picocolors": "^1.1.1"
   },
-  "version": "0.5.0"
+  "version": "0.6.0"
 }

package/node_modules/@gdh/core/dist/dev-mode.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Phase 11: canonical dev-mode signal resolution. Mirrors the merge-order
+ * established at `packages/adapters/src/index.ts:1517` and the baked launcher
+ * at `packages/adapters/src/index.ts:2795-2796`: env var `GDH_DEV_REPO` wins
+ * over the persisted `gdhDevRepoPath` hint in `.gdh-state/local-paths.json`.
+ *
+ * When this helper returns a truthy string, callers MUST treat the target as
+ * a contributor / dev-from-source setup and skip every probe / cache write /
+ * banner / `_meta` injection. Contributors are never spammed with update
+ * signals about the repo they're actively editing (SELF-03).
+ */
+export declare function resolveEffectiveDevRepoPath(targetPath: string): Promise<string | null>;
+//# sourceMappingURL=dev-mode.d.ts.map

package/node_modules/@gdh/core/dist/dev-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-mode.d.ts","sourceRoot":"","sources":["../src/dev-mode.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB"}

package/node_modules/@gdh/core/dist/dev-mode.js

@@ -0,0 +1,21 @@
+import { readGdhLocalPathHints } from "./local-path-hints.js";
+/**
+ * Phase 11: canonical dev-mode signal resolution. Mirrors the merge-order
+ * established at `packages/adapters/src/index.ts:1517` and the baked launcher
+ * at `packages/adapters/src/index.ts:2795-2796`: env var `GDH_DEV_REPO` wins
+ * over the persisted `gdhDevRepoPath` hint in `.gdh-state/local-paths.json`.
+ *
+ * When this helper returns a truthy string, callers MUST treat the target as
+ * a contributor / dev-from-source setup and skip every probe / cache write /
+ * banner / `_meta` injection. Contributors are never spammed with update
+ * signals about the repo they're actively editing (SELF-03).
+ */
+export async function resolveEffectiveDevRepoPath(targetPath) {
+    const envDevRepoPath = process.env["GDH_DEV_REPO"]?.trim() || null;
+    if (envDevRepoPath) {
+        return envDevRepoPath;
+    }
+    const hints = await readGdhLocalPathHints(targetPath);
+    return hints.gdhDevRepoPath;
+}
+//# sourceMappingURL=dev-mode.js.map

package/node_modules/@gdh/core/dist/dev-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-mode.js","sourceRoot":"","sources":["../src/dev-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,UAAkB;IAElB,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;IACnE,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC,cAAc,CAAC;AAC9B,CAAC"}

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

@@ -15,6 +15,7 @@ export declare const GDH_AUTHORING_SLICE_REPORT_VERSION = 1;
 export declare const GDH_MCP_MANIFEST_VERSION = 1;
 export declare const GDH_CURSOR_RULE_VERSION = 1;
 export declare const GDH_MCP_LAUNCHER_VERSION = 2;
+export declare const GDH_UPDATE_HOOK_VERSION = 1;
 export declare const GDH_RUNTIME_RECIPE_RUN_VERSION = 1;
 export declare const GDH_RUNTIME_RUN_BUNDLE_VERSION = 1;
 export declare const GDH_RUNTIME_CORPUS_ARTIFACT_VERSION = 1;
@@ -23,7 +24,7 @@ export type GdhProductReleaseStage = "targeted_internal_use" | "broader_internal
 export type GdhCurrentInstallMode = "development_checkout" | "packaged_install";
 export type GdhProductCompatibilityState = "compatible" | "migration_available" | "migration_needed" | "migration_blocked" | "compatibility_degraded";
 export type GdhProductVersionSource = "root_package_json";
-export type GdhManagedProjectSurfaceId = "project_config" | "run_configuration_schema" | "verification_scenario_schema" | "rules_schema" | "agent_contract" | "guidance_index" | "guidance_unit" | "mcp_manifest" | "cursor_rule" | "mcp_launcher" | "runtime_bridge_surface";
+export type GdhManagedProjectSurfaceId = "project_config" | "run_configuration_schema" | "verification_scenario_schema" | "rules_schema" | "agent_contract" | "guidance_index" | "guidance_unit" | "mcp_manifest" | "cursor_rule" | "mcp_launcher" | "runtime_bridge_surface" | "update_hook";
 export type GdhProjectLifecycleSurfaceManagement = "project_owned" | "managed" | "merge_managed";
 export type GdhProjectLifecycleActionKind = "apply_migration" | "run_repair" | "manual_review";
 export interface GdhProjectLifecycleActionHint {
@@ -317,7 +318,7 @@ export interface GdhGuidanceStatusView {
     readonly guidance: GdhGuidanceStatusResult;
     readonly audit: GdhGuidanceAuditInspectionResult;
 }
-export type GdhAuthoringSessionEventKind = "onboard" | "status" | "scan" | "bridge_status" | "bridge_install" | "bridge_repair" | "bridge_remove" | "authoring_check" | "target_prepare" | "imports_refresh" | "recipe_list" | "recipe_show" | "recipe_check" | "recipe_run" | "scenario_list" | "scenario_show" | "verify_run" | "verify_inspect" | "verify_readiness" | "verify_drift" | "guidance_status" | "guidance_resolve" | "guidance_audit" | "verify_recommend" | "verify_done";
+export type GdhAuthoringSessionEventKind = "onboard" | "status" | "scan" | "bridge_status" | "bridge_install" | "bridge_repair" | "bridge_remove" | "authoring_check" | "target_prepare" | "imports_refresh" | "recipe_list" | "recipe_show" | "recipe_check" | "recipe_run" | "scenario_list" | "scenario_show" | "verify_run" | "verify_inspect" | "verify_readiness" | "verify_drift" | "guidance_status" | "guidance_resolve" | "guidance_audit" | "verify_recommend" | "verify_done" | "self_update";
 export type GdhAuthoringSessionEventState = "succeeded" | "blocked" | "failed";
 export interface GdhAuthoringSessionGuidanceSnapshot {
     readonly effectiveRepoState: readonly string[];
@@ -1637,4 +1638,9 @@ export declare const corePackage: GdhPackageBoundary;
 export * from "./godot-docs-version.js";
 export * from "./local-path-hints.js";
 export * from "./official-docs.js";
+export { GDH_UPDATE_CACHE_RELATIVE_PATH, readGdhUpdateCache, resolveGdhUpdateCacheDir, resolveGdhUpdateCachePath, writeGdhUpdateCache, } from "./update-cache.js";
+export type { UpdateCheckCacheEntry } from "./update-cache.js";
+export { resolveEffectiveDevRepoPath } from "./dev-mode.js";
+export { GDH_UPDATE_REGISTRY_URL, GDH_UPDATE_REMEDIATION_HINT, fetchNpmLatestForGdh, isNewerGdhVersion, readGdhUpdateMetaOrNull, resolveNpmLatestVersion, runGdhUpdateProbe, } from "./update-probe.js";
+export type { GdhUpdateMeta, ReadGdhUpdateMetaOptions, ResolveNpmLatestVersionResult, RunGdhUpdateProbeOptions, } from "./update-probe.js";
 //# sourceMappingURL=index.d.ts.map