@skillcap/gdh 0.23.0 → 0.24.0

package/node_modules/@gdh/adapters/dist/durable-backup.js

@@ -0,0 +1,346 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { isWorkspaceRelativePath, writeFileAtomic, } from "@gdh/core";
+/**
+ * Workspace-relative directory for the durable update backup.
+ *
+ * Single durable backup per STA-01 / D-14: this directory is overwritten
+ * (rm -rf semantics) on every successful backup write. Multi-backup retention
+ * is explicitly deferred (see 72-CONTEXT.md "Deferred Ideas").
+ */
+export const BACKUP_RELATIVE_PATH = ".gdh-state/backup";
+/**
+ * Workspace-relative staging directory used to make the backup write atomic
+ * at the directory level (Pitfall 6 / T-72-04-03). The staged tree is built
+ * here, then renamed onto BACKUP_RELATIVE_PATH so the prior backup is never
+ * absent from disk between rm-rf and write.
+ */
+export const BACKUP_STAGING_RELATIVE_PATH = ".gdh-state/backup.new";
+/** Workspace-relative path to the per-backup manifest. */
+export const BACKUP_MANIFEST_RELATIVE_PATH = ".gdh-state/backup/manifest.json";
+/**
+ * Write a single durable backup at .gdh-state/backup/ (STA-01 / D-13 / D-14).
+ *
+ * Staged-write strategy (T-72-04-03 mitigation, Pitfall 6):
+ *   1. Pre-clean .gdh-state/backup.new/ from any prior interrupted run.
+ *   2. Capture every plannedPaths entry into .gdh-state/backup.new/, mirroring
+ *      the workspace-relative directory structure. Missing files are recorded
+ *      in the manifest with existed: false but no file is written.
+ *   3. Write manifest.json into the staging directory via writeFileAtomic.
+ *   4. Remove the prior .gdh-state/backup/ (if any) and rename the staging
+ *      directory onto it.
+ *
+ * If interrupted between steps 2 and 4, the prior .gdh-state/backup/ is
+ * unchanged and the next call's pre-clean (step 1) removes the partial
+ * staging tree before it can corrupt anything.
+ *
+ * Path-traversal candidates (failing isWorkspaceRelativePath) are recorded
+ * in `skipped` with `path_traversal_blocked` and never written or captured.
+ */
+export async function writeDurableBackup(input) {
+    if (input.plannedPaths.length === 0) {
+        return { state: "skipped_no_planned_paths" };
+    }
+    const stagingPath = path.join(input.targetPath, BACKUP_STAGING_RELATIVE_PATH);
+    const finalPath = path.join(input.targetPath, BACKUP_RELATIVE_PATH);
+    // Step 1: pre-clean staging from any prior interrupted run, then re-create it
+    await fs.rm(stagingPath, { recursive: true, force: true });
+    await fs.mkdir(stagingPath, { recursive: true });
+    // Step 2: capture each planned-path file into the staging tree
+    const capturedPaths = [];
+    const skipped = [];
+    // Deduplicate planned paths and sort for deterministic manifest ordering
+    const uniquePaths = [...new Set(input.plannedPaths)].sort();
+    for (const relPath of uniquePaths) {
+        if (!isWorkspaceRelativePath(relPath)) {
+            skipped.push({ path: relPath, reason: "path_traversal_blocked" });
+            continue;
+        }
+        const sourceAbs = path.join(input.targetPath, relPath);
+        const destAbs = path.join(stagingPath, relPath);
+        let content;
+        try {
+            content = await fs.readFile(sourceAbs, "utf8");
+        }
+        catch {
+            content = null;
+        }
+        if (content !== null) {
+            await fs.mkdir(path.dirname(destAbs), { recursive: true });
+            await fs.writeFile(destAbs, content);
+            capturedPaths.push({ path: relPath, existed: true });
+        }
+        else {
+            capturedPaths.push({ path: relPath, existed: false });
+        }
+    }
+    // Step 3: write manifest into the staging directory
+    const nowIso = input.nowIso ?? (() => new Date().toISOString());
+    const manifest = {
+        backup_version: 1,
+        applied_at: nowIso(),
+        from_pair: input.fromPair,
+        to_pair: input.toPair,
+        from_pin: input.fromPin,
+        to_pin: input.toPin,
+        captured_paths: capturedPaths,
+        preservation_notes: input.preservationNotes ?? [],
+    };
+    await writeFileAtomic(path.join(stagingPath, "manifest.json"), `${JSON.stringify(manifest, null, 2)}\n`);
+    // Step 4: remove the old backup, then rename staging into place. The rename
+    // is atomic on POSIX filesystems for directories on the same device, and
+    // .gdh-state/ is always on the same device as itself by construction.
+    await fs.rm(finalPath, { recursive: true, force: true });
+    await fs.rename(stagingPath, finalPath);
+    return {
+        state: "written",
+        backupPath: finalPath,
+        manifest,
+        skipped,
+    };
+}
+// ---------------------------------------------------------------------------
+// Manifest read + restore (T-72-04-06 schema guard; D-10 step rollback)
+// ---------------------------------------------------------------------------
+function isBackupCapturedPath(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return typeof v["path"] === "string" && typeof v["existed"] === "boolean";
+}
+function isBackupPreservationNote(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (typeof v["path"] !== "string")
+        return false;
+    if (v["reason"] !== "class_1_backup_then_overwrite")
+        return false;
+    const ms = v["marker_state"];
+    return ms === "absent" || ms === "present" || ms === "not_applicable";
+}
+function isMigrationVersionPair(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return (typeof v["schema"] === "number" && typeof v["agentContract"] === "number");
+}
+function isBackupManifest(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (v["backup_version"] !== 1)
+        return false;
+    if (typeof v["applied_at"] !== "string")
+        return false;
+    if (typeof v["from_pin"] !== "string")
+        return false;
+    if (typeof v["to_pin"] !== "string")
+        return false;
+    if (!isMigrationVersionPair(v["from_pair"]))
+        return false;
+    if (!isMigrationVersionPair(v["to_pair"]))
+        return false;
+    const captured = v["captured_paths"];
+    if (!Array.isArray(captured) || !captured.every(isBackupCapturedPath)) {
+        return false;
+    }
+    const notes = v["preservation_notes"];
+    if (!Array.isArray(notes) || !notes.every(isBackupPreservationNote)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Read the backup manifest from .gdh-state/backup/manifest.json.
+ *
+ * Returns null on any failure (missing file, JSON parse error, schema
+ * mismatch). Never throws — degraded fallback so callers can branch on
+ * "no backup present" without try/catch ceremony, and so a corrupted
+ * manifest cannot trigger a partial restore (T-72-04-06).
+ */
+export async function readBackupManifest(targetPath) {
+    const manifestPath = path.join(targetPath, BACKUP_MANIFEST_RELATIVE_PATH);
+    const raw = await fs.readFile(manifestPath, "utf8").catch(() => null);
+    if (raw === null)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    return isBackupManifest(parsed) ? parsed : null;
+}
+/**
+ * Restore byte-equal content for every captured_paths entry in the backup
+ * manifest. Mirrors the legacy in-memory rollbackOriginals semantics:
+ *
+ *   - existed: true  → atomic-write the backup content over the original path
+ *   - existed: false → fs.rm the original path (file did not exist pre-update)
+ *
+ * The backup directory itself is read-only during restore (T-72-04 contract):
+ * each restore is a fresh copy from .gdh-state/backup/, so running restore
+ * twice produces the same final state.
+ *
+ * Path-traversal candidates in captured_paths are skipped with a structured
+ * warning (T-72-04-01); the rest of the restore still completes. If the
+ * backup content for an existed:true entry is missing on disk, that entry
+ * is skipped with reason "backup_content_missing" rather than aborting.
+ */
+export async function restoreFromDurableBackup(input) {
+    const manifest = await readBackupManifest(input.targetPath);
+    if (manifest === null) {
+        return { state: "no_backup_present" };
+    }
+    const backupRoot = path.join(input.targetPath, BACKUP_RELATIVE_PATH);
+    const restored = [];
+    const removed = [];
+    const skipped = [];
+    for (const entry of manifest.captured_paths) {
+        if (!isWorkspaceRelativePath(entry.path)) {
+            skipped.push({ path: entry.path, reason: "path_traversal_blocked" });
+            continue;
+        }
+        const originalAbs = path.join(input.targetPath, entry.path);
+        if (entry.existed) {
+            const backupAbs = path.join(backupRoot, entry.path);
+            const content = await fs.readFile(backupAbs, "utf8").catch(() => null);
+            if (content === null) {
+                skipped.push({ path: entry.path, reason: "backup_content_missing" });
+                continue;
+            }
+            try {
+                await writeFileAtomic(originalAbs, content);
+                restored.push(entry.path);
+            }
+            catch (error) {
+                // Best-effort restore: a destination-collision (e.g. directory at the
+                // expected file path, EACCES, EROFS) becomes a skipped entry rather
+                // than aborting the rest of the restore. Mirrors legacy
+                // rollbackOriginals semantics — partial recovery is preferable to
+                // halting mid-rollback. T-72-04-04 (single-backup contract) is
+                // unchanged; this only widens which failure modes degrade gracefully.
+                skipped.push({
+                    path: entry.path,
+                    reason: `restore_failed:${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
+        }
+        else {
+            try {
+                await fs.rm(originalAbs, { force: true });
+                removed.push(entry.path);
+            }
+            catch (error) {
+                // Same best-effort posture: fs.rm without recursive on a directory
+                // throws EISDIR; recursive removal of an unexpected directory at a
+                // file path is destructive (could surprise an operator who created
+                // the directory deliberately). Skip with a structured reason.
+                skipped.push({
+                    path: entry.path,
+                    reason: `remove_failed:${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
+        }
+    }
+    return {
+        state: "restored",
+        restored,
+        removed,
+        skipped,
+        // WR-06: surface aggregate restore failure as a typed scalar so callers
+        // can branch on actual restoration success without re-scanning `skipped`.
+        failedCount: skipped.length,
+    };
+}
+// ---------------------------------------------------------------------------
+// WFL-02 / D-24 — class-1 marker-drift detection
+// ---------------------------------------------------------------------------
+/**
+ * Known GDH ownership markers (per 72-RESEARCH.md "Established Patterns").
+ *
+ * Each class-1 file format ships at least one of these markers in its
+ * GDH-rendered output. The first match in a file proves "GDH-rendered,
+ * untouched" — no preservation needed. Absence of every marker (when the
+ * file otherwise exists at a class-1 path) proves user-edited drift and
+ * triggers WFL-02 backup-then-overwrite.
+ *
+ * Adding a new marker convention requires updating both this list AND the
+ * renderer that ships it; tests in `detectClass1MarkerDrift` cover each
+ * marker variant explicitly.
+ */
+const KNOWN_GDH_MARKERS = [
+    "<codex_skill_adapter>",
+    "<!-- gdh managed -->",
+    "# gdh:managed-hook",
+    "<!-- GDH-MANAGED -->",
+];
+/**
+ * Detect WFL-02 / D-24 class-1 marker drift.
+ *
+ * For each `plannedClass1Paths` entry that exists on disk, check whether the
+ * file contains any of its expected GDH ownership markers:
+ *   - Marker present → file is GDH-rendered; no drift; not flagged.
+ *   - Marker absent (but file exists) → user-edited drift; flagged with
+ *     marker_state: "absent".
+ *   - Per-path override supplied but no marker matches → conservative
+ *     marker_state: "not_applicable" + flagged as drifted (T-72-04-07: err on
+ *     the side of preservation when the marker convention is uncertain).
+ *   - File does not exist on disk → no drift; reported in absentPaths so
+ *     the caller knows the file will be rendered fresh (no preservation).
+ *
+ * Path-traversal candidates (failing isWorkspaceRelativePath) are skipped
+ * with structured warnings (T-72-04-01); never read.
+ *
+ * Pair the result with `driftResultToPreservationNotes` to produce the
+ * preservation-notes payload for `writeDurableBackup`.
+ */
+export async function detectClass1MarkerDrift(input) {
+    const drifted = [];
+    const absent = [];
+    const skipped = [];
+    for (const relPath of input.plannedClass1Paths) {
+        if (!isWorkspaceRelativePath(relPath)) {
+            skipped.push({ path: relPath, reason: "path_traversal_blocked" });
+            continue;
+        }
+        const absolute = path.join(input.targetPath, relPath);
+        const content = await fs.readFile(absolute, "utf8").catch(() => null);
+        if (content === null) {
+            absent.push(relPath);
+            continue;
+        }
+        const customMarkers = input.expectedMarkersByPath?.get(relPath);
+        const markersToCheck = customMarkers ?? KNOWN_GDH_MARKERS;
+        const hasMarker = markersToCheck.some((marker) => content.includes(marker));
+        if (hasMarker) {
+            // file is GDH-rendered, no drift
+            continue;
+        }
+        // marker absent — flag as drifted. When a custom marker list was supplied
+        // but none matched, the marker convention is uncertain → use the
+        // conservative "not_applicable" state per T-72-04-07.
+        const markerState = customMarkers !== undefined ? "not_applicable" : "absent";
+        drifted.push({ path: relPath, markerState });
+    }
+    return { driftedPaths: drifted, absentPaths: absent, skipped };
+}
+/**
+ * Convert a drift-detection result into preservation notes ready to attach
+ * to a `writeDurableBackup` call.
+ *
+ * Per D-24, every drifted path is preserved with reason
+ * `class_1_backup_then_overwrite`; the marker_state propagates from the
+ * drift entry so the manifest carries an audit trail of the detection
+ * outcome (absent vs not_applicable).
+ */
+export function driftResultToPreservationNotes(drift) {
+    return drift.driftedPaths.map((entry) => ({
+        path: entry.path,
+        reason: "class_1_backup_then_overwrite",
+        marker_state: entry.markerState,
+    }));
+}
+//# sourceMappingURL=durable-backup.js.map

package/node_modules/@gdh/adapters/dist/durable-backup.js.map

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

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

@@ -1,4 +1,5 @@
 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, renderClaudeCheckSkill, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeScanSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexCheckSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexScanSkill, renderCodexStatusSkill, renderCodexUpdateSkill, renderCursorCheckSkill, renderCursorMigrateSkill, renderCursorOnboardSkill, renderCursorPrepareSkill, renderCursorRunGameSkill, renderCursorScanSkill, renderCursorStatusSkill, renderCursorUpdateSkill, } from "./skill-rendering.js";
 export declare const adaptersPackage: import("@gdh/core").GdhPackageBoundary;
 export declare const SUPPORTED_AGENTS: readonly ["codex", "claude", "cursor"];
@@ -54,7 +55,7 @@ export declare function installSupportedAgentAdapters(targetPath: string, option
     readonly allowBootstrap?: boolean;
 }): Promise<GdhAgentAdaptersInstallResult>;
 export declare function inspectProjectLifecycleCompatibility(targetPath: string): Promise<GdhProjectLifecycleCompatibilityResult>;
-export declare function buildGdhStatusResult(targetPath: string): Promise<GdhStatusResult>;
+export declare function buildGdhStatusResult(targetPath: string, adapters?: GdhStatusBuildAdapters): Promise<GdhStatusResult>;
 export declare function createGsdSnapshot(targetPath: string, options?: {
     readonly files?: readonly string[];
 }): Promise<GdhGsdSnapshot>;
@@ -74,5 +75,13 @@ export { CLAUDE_STATUSLINE_RELATIVE_PATH } from "./claude-statusline-render.js";
 export { CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH } from "./claude-update-hook-render.js";
 export { CLAUDE_AUTHORING_HOOK_COMMAND, CLAUDE_AUTHORING_HOOK_RELATIVE_PATH, CODEX_AUTHORING_HOOK_COMMAND, CODEX_AUTHORING_HOOK_RELATIVE_PATH, } from "./authoring-hook-render.js";
 export { type BumpAndRebakePinResult, bumpAndRebakePin, } from "./self-update-mechanics.js";
+export { deriveExpectedRenderSet, runInventorySweep, } from "./inventory-sweep.js";
+export type { GdhInventorySweepInput, GdhInventorySweepResult, GdhInventorySweepSkipped, } from "./inventory-sweep.js";
+export { BACKUP_MANIFEST_RELATIVE_PATH, BACKUP_RELATIVE_PATH, BACKUP_STAGING_RELATIVE_PATH, detectClass1MarkerDrift, driftResultToPreservationNotes, readBackupManifest, restoreFromDurableBackup, writeDurableBackup, } from "./durable-backup.js";
+export type { GdhBackupCapturedPath, GdhBackupManifest, GdhBackupMarkerState, GdhBackupPreservationNote, GdhBackupPreservationReason, GdhClass1MarkerDriftEntry, GdhClass1MarkerDriftInput, GdhClass1MarkerDriftResult, GdhRestoreFromDurableBackupResult, GdhWriteDurableBackupInput, GdhWriteDurableBackupResult, GdhWriteDurableBackupSkipped, } from "./durable-backup.js";
+export { computeDeferredActionsAdvisory, } from "./deferred-actions-advisory.js";
+export type { GdhBackupAdvisory, GdhDeferredActionStatusEntry, GdhDeferredActionsAdvisoryResult, GdhStatusBuildAdapters, } from "./deferred-actions-advisory.js";
+export { DEFAULT_GRACEFUL_STOP_TIMEOUT_MS, STOP_AND_RESTART_ENV_SUBSET_KEYS, buildProcessRestartProbeFromSnapshot, captureProcessSnapshot, defaultProcessOrchestrationEnvironment, restartFromSnapshot, stopCapturedProcesses, } from "./process-orchestration.js";
+export type { GdhCaptureProcessSnapshotResult, GdhDiscoveredBrokerProcess, GdhDiscoveredMcpProcess, GdhProcessOrchestrationEnvironment, GdhProcessOrchestrationPlatform, GdhRestartFailedRow, GdhRestartFromSnapshotResult, GdhRestartedRow, GdhStopCapturedProcessesResult, GdhStopCapturedProcessesSkipped, } from "./process-orchestration.js";
 export { summarizeProjectLifecycleCompatibility };
 //# 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,18 +5,32 @@ import os from "node:os";
 import path from "node:path";
 import { promisify } from "node:util";
 import { readProjectConfig, readWorktreeState, resolveAuthoringStatus, resolveEffectiveTargetPath, resolvePinnedVersion, resolvePinnedVersionOrNull, resolveProjectRoot, } from "@gdh/authoring";
-import { assertProjectLifecycleCompatibilityInvariant, definePackageBoundary, GDH_AGENT_CONTRACT_VERSION, GDH_CURSOR_RULE_VERSION, GDH_GUIDANCE_INDEX_VERSION, GDH_GUIDANCE_UNIT_VERSION, GDH_PROJECT_CONFIG_VERSION, GDH_RECIPE_SCHEMA_VERSION, GDH_RULES_SCHEMA_VERSION, GDH_SCENARIO_SCHEMA_VERSION, resolveConfiguredGodotEditorBin, resolveCurrentGdhInstall, resolveGdhProductMetadata, } from "@gdh/core";
+import { assertClassRegistered, assertProjectLifecycleCompatibilityInvariant, definePackageBoundary, GDH_AGENT_CONTRACT_VERSION, GDH_CURSOR_RULE_VERSION, GDH_GUIDANCE_INDEX_VERSION, GDH_GUIDANCE_UNIT_VERSION, GDH_PROJECT_CONFIG_VERSION, GDH_RECIPE_SCHEMA_VERSION, GDH_RULES_SCHEMA_VERSION, GDH_SCENARIO_SCHEMA_VERSION, resolveConfiguredGodotEditorBin, resolveCurrentGdhInstall, resolveGdhProductMetadata, } from "@gdh/core";
 import { createDefaultGuidanceUnits, createDefaultRulesDocument, getGuidanceStatus, readRulesDocument, renderRulesYaml, resolveGuidanceQuery, resolveRecoveryHints, } from "@gdh/docs";
 import { inspectGuidanceAudit } from "@gdh/observability";
 import { inspectRuntimeBridgeBroker, inspectRuntimeBridgeSurface, inspectRuntimeKnowledgeSurface, } from "@gdh/runtime";
 import { readInventoryCacheOrScan } from "@gdh/scan";
 import { CLAUDE_SETTINGS_RELATIVE_PATH, patchClaudeSettingsForGdhAuthoringHooks, patchClaudeSettingsForGdhSessionStart, patchClaudeSettingsForGdhStatusline, } from "./claude-settings-patch.js";
+import { computeDeferredActionsAdvisory, } from "./deferred-actions-advisory.js";
 import { CLAUDE_AUTHORING_HOOK_RELATIVE_PATH, CODEX_AUTHORING_HOOK_COMMAND, CODEX_AUTHORING_HOOK_RELATIVE_PATH, renderGdhAuthoringHook, } from "./authoring-hook-render.js";
 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, renderClaudeCheckSkill, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeScanSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexCheckSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexScanSkill, renderCodexStatusSkill, renderCodexUpdateSkill, renderCursorCheckSkill, renderCursorMigrateSkill, renderCursorOnboardSkill, renderCursorPrepareSkill, renderCursorRunGameSkill, renderCursorScanSkill, renderCursorStatusSkill, renderCursorUpdateSkill, } from "./skill-rendering.js";
 export { GDH_MANAGED_AGENT_SKILL_MARKER, GDH_SKILL_DEFINITIONS, GDH_SKILL_IDS, renderGdhSkill, renderManagedSkillMarker, renderClaudeCheckSkill, renderClaudeMigrateSkill, renderClaudeOnboardSkill, renderClaudePrepareSkill, renderClaudeRunGameSkill, renderClaudeScanSkill, renderClaudeStatusSkill, renderClaudeUpdateSkill, renderCodexCheckSkill, renderCodexMigrateSkill, renderCodexOnboardSkill, renderCodexPrepareSkill, renderCodexRunGameSkill, renderCodexScanSkill, renderCodexStatusSkill, renderCodexUpdateSkill, renderCursorCheckSkill, renderCursorMigrateSkill, renderCursorOnboardSkill, renderCursorPrepareSkill, renderCursorRunGameSkill, renderCursorScanSkill, renderCursorStatusSkill, renderCursorUpdateSkill, } from "./skill-rendering.js";
+// Module-load drift guard. See packages/core/src/migrations/managed-surface-classes.ts.
+assertClassRegistered("cursor_rule", "deterministic");
+assertClassRegistered("claude_onboard_command", "deterministic");
+assertClassRegistered("claude_status_command", "deterministic");
+assertClassRegistered("claude_scan_command", "deterministic");
+assertClassRegistered("claude_migrate_command", "deterministic");
+assertClassRegistered("claude_update_command", "deterministic");
+assertClassRegistered("claude_check_command", "deterministic");
+assertClassRegistered("claude_prepare_command", "deterministic");
+assertClassRegistered("claude_run_game_command", "deterministic");
+assertClassRegistered("mcp_config_entry", "deterministic");
+assertClassRegistered("codex_project_mcp_section", "deterministic");
+assertClassRegistered("codex_authoring_hook_block", "deterministic");
 export const adaptersPackage = definePackageBoundary({
     name: "@gdh/adapters",
     layer: "integration",
@@ -258,7 +272,7 @@ export async function inspectProjectLifecycleCompatibility(targetPath) {
         inspectRuntimeBridgeLifecycleSurface(resolvedTargetPath, bridgeStatus),
     ]);
 }
-export async function buildGdhStatusResult(targetPath) {
+export async function buildGdhStatusResult(targetPath, adapters) {
     const context = await buildAuthoringContext(targetPath);
     const projectLifecycle = await inspectProjectLifecycleCompatibility(context.targetPath);
     const brokerInspection = await inspectRuntimeBridgeBroker({
@@ -271,6 +285,7 @@ export async function buildGdhStatusResult(targetPath) {
     const recoveryHints = resolveRecoveryHints(projectLifecycle.reasons);
     const capabilities = await addOperationalCapabilityStatus(context.status.capabilities, context.status.targetPath);
     const detectedProjects = summarizeDetectedProjects(context.inventory.projects, context.status.primaryProjectPath);
+    const { deferredActions, backupAdvisory, envelopeAdvisory } = await computeDeferredActionsAdvisory(context.targetPath, adapters);
     return {
         ...context.status,
         capabilities,
@@ -280,6 +295,9 @@ export async function buildGdhStatusResult(targetPath) {
         runtimeBridgeBroker: summarizeRuntimeBridgeBrokerTransition(brokerInspection.broker),
         runtimeKnowledge,
         recoveryHints,
+        deferredActions,
+        backupAdvisory,
+        envelopeAdvisory,
     };
 }
 function summarizeRuntimeBridgeBrokerTransition(broker) {
@@ -3174,6 +3192,10 @@ export { CLAUDE_STATUSLINE_RELATIVE_PATH } from "./claude-statusline-render.js";
 export { CLAUDE_CHECK_UPDATE_HOOK_RELATIVE_PATH } from "./claude-update-hook-render.js";
 export { CLAUDE_AUTHORING_HOOK_COMMAND, CLAUDE_AUTHORING_HOOK_RELATIVE_PATH, CODEX_AUTHORING_HOOK_COMMAND, CODEX_AUTHORING_HOOK_RELATIVE_PATH, } from "./authoring-hook-render.js";
 export { bumpAndRebakePin, } from "./self-update-mechanics.js";
+export { deriveExpectedRenderSet, runInventorySweep, } from "./inventory-sweep.js";
+export { BACKUP_MANIFEST_RELATIVE_PATH, BACKUP_RELATIVE_PATH, BACKUP_STAGING_RELATIVE_PATH, detectClass1MarkerDrift, driftResultToPreservationNotes, readBackupManifest, restoreFromDurableBackup, writeDurableBackup, } from "./durable-backup.js";
+export { computeDeferredActionsAdvisory, } from "./deferred-actions-advisory.js";
+export { DEFAULT_GRACEFUL_STOP_TIMEOUT_MS, STOP_AND_RESTART_ENV_SUBSET_KEYS, buildProcessRestartProbeFromSnapshot, captureProcessSnapshot, defaultProcessOrchestrationEnvironment, restartFromSnapshot, stopCapturedProcesses, } from "./process-orchestration.js";
 // Internal aggregator exposed for Wave 0 unit tests
 // (packages/adapters/src/lifecycle-compatibility.test.ts). Callers outside this
 // package should continue to use inspectProjectLifecycleCompatibility, which