rampway 0.5.28 → 0.5.29

package/README.md

@@ -107,6 +107,7 @@ rampway production runtime-validate
 rampway production runtime-status
 rampway production runtime-logs
 rampway production runtime-recover --yes
+rampway production runtime-recover-generation-transition <failed-release-id> --yes
 
 # Local foreground host-restart entrypoint for the last accepted release
 rampway production runtime-boot --config /absolute/path/rampway.config.mjs
@@ -115,6 +116,12 @@ rampway production runtime-boot --config /absolute/path/rampway.config.mjs
 The older `rollbridge-validate`, `rollbridge-status`, `rollbridge-logs`, and
 `rollbridge-recover` names remain aliases for Rollbridge stages.
 
+Use [exact failed-generation recovery](docs/failed-generation-recovery.md) when
+a Rollbridge deploy timed out or failed before publication and retained its
+candidate transition fence. Recovery supports stages without an explicit
+`runtime.config`, and later successful Rollbridge deploys refresh live retained
+release pins before cleanup.
+
 ### Deploy transports
 
 Deploys run over one of three transports selected with `--transport`:
@@ -409,11 +416,18 @@ Every successful deploy, rollback, or resumed publication appends one JSON objec
 - `healthChecks: "passed"`
 - sanitized runtime status
 - `cleanupRemoved` release IDs
+- optional `warnings` for non-fatal maintenance failures after runtime acceptance
 
 Rollback events include `event: "rollback"`, target `releaseId` and `revision`,
 `rolledBackAt`, `durationMs`, `previousRelease`, `healthChecks: "passed"`, and a
 sanitized runtime result. Reports intentionally record runtime result summaries,
-not runtime configuration or secrets.
+not runtime configuration or secrets. A provisional cleanup-pin removal failure
+is reported as a warning and retained for later reconciliation; it does not turn
+an already-accepted runtime activation into a failed deploy or rollback. Rampway
+stores provisional pins outside accepted runtime state and clears only the pins
+owned by the exact runtime configuration that positively reports its live
+release references. Runtime changes preserve the previous owner's pins, and
+runtimes without reference reporting retain their unresolved pins.
 
 Resumed-publication events use `event: "resume-publication"`, `resumedAt`, the
 exact target and previous release identities, `healthChecks: "passed"`, the

package/build/src/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.js"],"names":[],"mappings":";0CAkBwC,iCAAiC;AAyCzE;;;GAGG;AACH,2BAHW,MAAM,EAAE,GACN,OAAO,CAAC,IAAI,CAAC,CAmCzB;AAED;;;;;;;GAOG;AACH,wCAHW,MAAM,EAAE,GACN;IAAC,OAAO,EAAE,MAAM,GAAC,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,GAAC,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,QAAQ,EAAE,cAAc,CAAA;CAAC,CA0C9G"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.js"],"names":[],"mappings":";0CAmBwC,iCAAiC;AA0CzE;;;GAGG;AACH,2BAHW,MAAM,EAAE,GACN,OAAO,CAAC,IAAI,CAAC,CAmCzB;AAED;;;;;;;GAOG;AACH,wCAHW,MAAM,EAAE,GACN;IAAC,OAAO,EAAE,MAAM,GAAC,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,GAAC,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,QAAQ,EAAE,cAAc,CAAA;CAAC,CA+C9G"}

package/build/src/cli.js

@@ -8,6 +8,7 @@ import { deployCommand } from "./commands/deploy.js";
 import { releasesCommand, statusCommand } from "./commands/releases.js";
 import { rollbackCommand } from "./commands/rollback.js";
 import { resumePublicationCommand } from "./commands/resume-publication.js";
+import { runtimeRecoverGenerationTransitionCommand } from "./commands/recover-generation-transition.js";
 import { rollbridgeValidateCommand, rollbridgeStatusCommand, rollbridgeLogsCommand, rollbridgeRecoverCommand, runtimeValidateCommand, runtimeStatusCommand, runtimeLogsCommand, runtimeRecoverCommand } from "./commands/rollbridge.js";
 import { tasksCommand } from "./commands/tasks.js";
 import { taskCommand } from "./commands/task.js";
@@ -38,6 +39,7 @@ const COMMANDS = {
     "runtime-status": runtimeStatusCommand,
     "runtime-logs": runtimeLogsCommand,
     "runtime-recover": runtimeRecoverCommand,
+    "runtime-recover-generation-transition": runtimeRecoverGenerationTransitionCommand,
     "runtime-boot": runtimeBootCommand,
     doctor: doctorCommand
 };
@@ -134,6 +136,14 @@ function resolveInvocation(argv) {
             throw new Error(`Command 'resume-publication' does not support option --${toKebab(unsupported[0])}.`);
         options.releaseId = operands[0];
     }
+    else if (command === "runtime-recover-generation-transition") {
+        if (operands.length !== 1)
+            throw new Error("Command 'runtime-recover-generation-transition' requires exactly one failed release ID.");
+        const unsupported = Object.keys(options).filter(option => !["config", "json", "sshForwardAgent", "yes"].includes(option));
+        if (unsupported.length > 0)
+            throw new Error(`Command 'runtime-recover-generation-transition' does not support option --${toKebab(unsupported[0])}.`);
+        options.releaseId = operands[0];
+    }
     else if (command === "task") {
         if (operands.length !== 1)
             throw new Error("Command 'task' requires exactly one task name.");

package/build/src/cli.js.map

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

package/build/src/commands/recover-generation-transition.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {import('#types').CommandArgs} args
+ * @returns {Promise<void>}
+ */
+export function runtimeRecoverGenerationTransitionCommand({ stageName, options, commandContext }: import("#types").CommandArgs): Promise<void>;
+//# sourceMappingURL=recover-generation-transition.d.ts.map

package/build/src/commands/recover-generation-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover-generation-transition.d.ts","sourceRoot":"","sources":["../../../src/commands/recover-generation-transition.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,kGAHW,OAAO,QAAQ,EAAE,WAAW,GAC1B,OAAO,CAAC,IAAI,CAAC,CAWzB"}

package/build/src/commands/recover-generation-transition.js

@@ -0,0 +1,18 @@
+import { commandContext as defaultCommandContext } from "./context.js";
+import { recoverGenerationTransition } from "../core/recover-generation-transition.js";
+/**
+ * @param {import('#types').CommandArgs} args
+ * @returns {Promise<void>}
+ */
+export async function runtimeRecoverGenerationTransitionCommand({ stageName, options, commandContext = defaultCommandContext }) {
+    if (!options.yes && stageName === "production")
+        throw new Error("Refusing production failed-generation recovery without --yes in non-interactive mode.");
+    const { stage, transport } = await commandContext(options, stageName);
+    const result = await recoverGenerationTransition({
+        releaseId: /** @type {string} */ (options.releaseId),
+        stage,
+        transport
+    });
+    console.log(JSON.stringify(result, null, 2));
+}
+//# sourceMappingURL=recover-generation-transition.js.map

package/build/src/commands/recover-generation-transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover-generation-transition.js","sourceRoot":"","sources":["../../../src/commands/recover-generation-transition.js"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,IAAI,qBAAqB,EAAC,MAAM,cAAc,CAAA;AACpE,OAAO,EAAC,2BAA2B,EAAC,MAAM,0CAA0C,CAAA;AAEpF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yCAAyC,CAAC,EAAC,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,qBAAqB,EAAC;IAC1H,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,SAAS,KAAK,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAA;IACxJ,MAAM,EAAC,KAAK,EAAE,SAAS,EAAC,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACnE,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC;QAC/C,SAAS,EAAE,qBAAqB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QACpD,KAAK;QACL,SAAS;KACV,CAAC,CAAA;IACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAC9C,CAAC"}

package/build/src/core/deploy-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-runner.d.ts","sourceRoot":"","sources":["../../../src/core/deploy-runner.js"],"names":[],"mappings":"AAmCA;;;;GAIG;AACH,wCAJW,OAAO,QAAQ,EAAE,WAAW,oDAC5B;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAAC,GACtE,MAAM,EAAE,CAIpB;AAED;;;;GAIG;AACH,+CAJW,OAAO,QAAQ,EAAE,WAAW,oDAC5B;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAAC,GACtE,OAAO,QAAQ,EAAE,cAAc,EAAE,CAqB7C;AAaD;;;GAGG;AACH,uIAHW,OAAO,QAAQ,EAAE,aAAa,GAC5B,OAAO,CAAC,OAAO,QAAQ,EAAE,YAAY,GAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CA0PnE;AAED;;;GAGG;AACH,6DAHW;IAAC,SAAS,EAAE,OAAO,QAAQ,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAC,GAC5G,OAAO,CAAC,OAAO,QAAQ,EAAE,cAAc,CAAC,CAyHpD;AAED;;;;;;;GAOG;AACH,6EAHW;IAAC,SAAS,EAAE,OAAO,QAAQ,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAC,GAClH,OAAO,CAAC,OAAO,QAAQ,EAAE,uBAAuB,CAAC,CA4G7D;AA0OD;;;GAGG;AACH,6FAHW;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,GAClH,MAAM,CAqBlB;yBA3zBsB,eAAe"}
+{"version":3,"file":"deploy-runner.d.ts","sourceRoot":"","sources":["../../../src/core/deploy-runner.js"],"names":[],"mappings":"AAmCA;;;;GAIG;AACH,wCAJW,OAAO,QAAQ,EAAE,WAAW,oDAC5B;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAAC,GACtE,MAAM,EAAE,CAIpB;AAED;;;;GAIG;AACH,+CAJW,OAAO,QAAQ,EAAE,WAAW,oDAC5B;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAAC,GACtE,OAAO,QAAQ,EAAE,cAAc,EAAE,CAqB7C;AAaD;;;GAGG;AACH,uIAHW,OAAO,QAAQ,EAAE,aAAa,GAC5B,OAAO,CAAC,OAAO,QAAQ,EAAE,YAAY,GAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CA+RnE;AAED;;;GAGG;AACH,6DAHW;IAAC,SAAS,EAAE,OAAO,QAAQ,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAC,GAC5G,OAAO,CAAC,OAAO,QAAQ,EAAE,cAAc,CAAC,CAoJpD;AAED;;;;;;;GAOG;AACH,6EAHW;IAAC,SAAS,EAAE,OAAO,QAAQ,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAC,GAClH,OAAO,CAAC,OAAO,QAAQ,EAAE,uBAAuB,CAAC,CA4G7D;AA0VD;;;GAGG;AACH,6FAHW;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,GAClH,MAAM,CAqBlB;yBA3+BsB,eAAe"}

package/build/src/core/deploy-runner.js

@@ -6,7 +6,7 @@ import { Reporter } from "./reporter.js";
 import { releaseIdFromDate } from "./release-id.js";
 import { deployPaths } from "./paths.js";
 import { acquireLock, releaseLock } from "./locks.js";
-import { ensureBaseDirs, prepareSharedLinks, publishCurrent, cleanupReleases, currentReleaseId, previousRelease, readReleaseRevision, requireCurrentRelease, resolveRetainedRelease } from "./release-manager.js";
+import { ensureBaseDirs, prepareSharedLinks, publishCurrent, cleanupReleases, currentReleaseId, previousRelease, readReleaseRevision, requireCurrentRelease, requireReleaseMetadata, resolveRetainedRelease, pinRuntimeReleaseForCleanup, clearRuntimeReleasePinsForCleanup } from "./release-manager.js";
 import { runTasks } from "./task-runner.js";
 import { runHealthChecks } from "./health-checks.js";
 import { runHooks } from "./hooks.js";
@@ -111,6 +111,8 @@ export async function deploy({ transport, stage, sourcePath = process.cwd(), rev
     /** @type {object|undefined} */
     let runtimeResult;
     let deployedRevision = releaseRevision;
+    /** @type {string[]} */
+    const warnings = [];
     const runtime = runtimeFor(stage);
     reporter.line(`Deploying ${stage.application}/${stage.stageName} revision ${releaseRevision} as release ${releaseId}`);
     await runHooks(transport, stage, null, "before_deploy");
@@ -132,6 +134,7 @@ export async function deploy({ transport, stage, sourcePath = process.cwd(), rev
                 const current = await requireCurrentRelease(transport, stage);
                 const currentRevision = await readReleaseRevision(transport, current.releasePath);
                 if (currentRevision.toLowerCase() === deployedRevision.toLowerCase()) {
+                    warnings.push(...await reconcileRuntimeReleasePinsForIdempotentDeploy(runtime, transport, stage, current, currentRevision, reporter));
                     reporter.line(`  * Revision ${currentRevision} is already active as release ${current.releaseId}; skipping release and runtime lifecycle`);
                     const report = {
                         application: stage.application,
@@ -144,7 +147,8 @@ export async function deploy({ transport, stage, sourcePath = process.cwd(), rev
                         durationMs: Date.now() - startedAt.getTime(),
                         healthChecks: "unchanged",
                         cleanupRemoved: [],
-                        idempotent: true
+                        idempotent: true,
+                        ...(warnings.length > 0 ? { warnings } : {})
                     };
                     await appendReport(transport, stage, report);
                     return report;
@@ -203,6 +207,10 @@ export async function deploy({ transport, stage, sourcePath = process.cwd(), rev
                 previousRuntimeRelease = { releaseId: activeReleaseId, revision: previousRevision, runtime: previousSnapshot };
             }
         }
+        await preserveSupersededRuntimeReferences(transport, stage, currentRuntimeState, activeReleaseId);
+        // Keep accepted state immutable while the candidate may become live before
+        // Rampway can read the runtime owner's references.
+        await pinRuntimeReleaseForCleanup(transport, stage, runtimeSnapshot, releaseId);
         runtimeAttempted = true;
         runtimeResult = await runtime.deploy(transport, {
             releasePath,
@@ -229,11 +237,15 @@ export async function deploy({ transport, stage, sourcePath = process.cwd(), rev
         await runHooks(transport, stage, releasePath, "after_health", { previousReleasePath });
         const previous = await currentReleaseId(transport, stage);
         await runHooks(transport, stage, releasePath, "before_publish", { previousReleasePath });
+        const referencedReleaseIds = await readRuntimeReferencesBeforePublication(runtime, transport, stage, { releaseId, revision: deployedRevision, runtime: runtimeSnapshot }, runtimeResult);
         let publicationAttempted = false;
         /** @type {import('#types').RuntimeBootState|undefined} */
         let acceptedBoot;
         try {
-            await writeRuntimeState(transport, stage, { releaseId, revision: deployedRevision, runtime: runtimeSnapshot }, { retain: previousRuntimeRelease ? [previousRuntimeRelease] : [] });
+            await writeRuntimeState(transport, stage, { releaseId, revision: deployedRevision, runtime: runtimeSnapshot }, {
+                retain: previousRuntimeRelease ? [previousRuntimeRelease] : [],
+                referencedReleaseIds
+            });
             if (runtime.commit)
                 await runtime.commit(transport, { snapshot: runtimeSnapshot });
             reporter.line("  * Publishing current symlink");
@@ -273,23 +285,31 @@ export async function deploy({ transport, stage, sourcePath = process.cwd(), rev
                 await runHealthChecks(transport, stage.healthChecks, previousReleasePath);
                 if (publicationAttempted)
                     await publishCurrent(transport, stage, previousReleasePath);
-                await writeRuntimeState(transport, stage, { releaseId: activeReleaseId, revision: previousRevision, runtime: restorationSnapshot });
+                await writeRuntimeStateWithLiveReferences(runtime, transport, stage, { releaseId: activeReleaseId, revision: previousRevision, runtime: restorationSnapshot });
                 if (runtime.commit)
                     await runtime.commit(transport, { snapshot: restorationSnapshot });
                 runtimeRestored = true;
             }
             catch (error) {
-                throw new Error(`${transitionError.message}\nRestoration of previous release '${activeReleaseId}' also failed: ${ /** @type {Error} */(error).message}`, { cause: transitionError });
+                const restorationError = /** @type {Error} */ (error);
+                if (isRuntimeIncumbentPreservedError(restorationError) && restorationError.recovery) {
+                    await persistRuntimeRecoveryPins(transport, stage, previousRuntimeRelease?.runtime ?? currentRuntimeSnapshot ?? runtimeSnapshot, restorationError.recovery);
+                }
+                throw new Error(`${transitionError.message}\nRestoration of previous release '${activeReleaseId}' also failed: ${restorationError.message}`, { cause: transitionError });
             }
             throw new Error(`${transitionError.message}\nPrevious release '${activeReleaseId}' was reactivated and health-checked; current ${publicationAttempted ? "was republished" : "was not changed"}.`, { cause: transitionError });
         }
-        await completeRuntimeOwnerHandoff(runtime, transport, stage, lock, acceptedBoot, { releaseId, revision: deployedRevision, runtime: runtimeSnapshot }, runtimeResult);
+        const handoffReferencesPersisted = await completeRuntimeOwnerHandoff(runtime, transport, stage, lock, acceptedBoot, { releaseId, revision: deployedRevision, runtime: runtimeSnapshot }, runtimeResult);
+        warnings.push(...await reconcileRuntimeReleasePinsAfterAcceptance(transport, stage, reporter, {
+            referencesAuthoritative: referencedReleaseIds !== undefined || handoffReferencesPersisted,
+            runtimeSnapshot
+        }));
         await runHooks(transport, stage, releasePath, "after_publish", { previousReleasePath });
         await runHooks(transport, stage, releasePath, "before_cleanup", { previousReleasePath });
         reporter.line(`  * Cleaning up old releases keeping ${stage.keepReleases}`);
         const removed = await cleanupReleases(transport, stage);
         await runHooks(transport, stage, releasePath, "after_cleanup", { previousReleasePath });
-        const report = { application: stage.application, stage: stage.stageName, releaseId, revision: deployedRevision, branch, deployedAt: new Date().toISOString(), event: "deploy", durationMs: Date.now() - startedAt.getTime(), previousRelease: previous ?? undefined, healthChecks: "passed", runtime: sanitizeRuntimeResult(runtimeResult, stage), cleanupRemoved: removed };
+        const report = { application: stage.application, stage: stage.stageName, releaseId, revision: deployedRevision, branch, deployedAt: new Date().toISOString(), event: "deploy", durationMs: Date.now() - startedAt.getTime(), previousRelease: previous ?? undefined, healthChecks: "passed", runtime: sanitizeRuntimeResult(runtimeResult, stage), cleanupRemoved: removed, ...(warnings.length > 0 ? { warnings } : {}) };
         await appendReport(transport, stage, report);
         return report;
     }
@@ -306,6 +326,9 @@ export async function deploy({ transport, stage, sourcePath = process.cwd(), rev
                 failureHookError = /** @type {Error} */ (hookError);
             }
             if (isRuntimeIncumbentPreservedError(err)) {
+                if (err.recovery) {
+                    await persistRuntimeRecoveryPins(transport, stage, runtimeSnapshot, err.recovery);
+                }
                 restorationMessage = "The incumbent runtime remains authoritative; automatic runtime restoration was not attempted.";
             }
             else if (isRuntimeRecoveryFailedError(err)) {
@@ -328,7 +351,7 @@ export async function deploy({ transport, stage, sourcePath = process.cwd(), rev
                         deferCommit: true
                     });
                     await runHealthChecks(transport, stage.healthChecks, previousReleasePath);
-                    await writeRuntimeState(transport, stage, previousRuntimeRelease);
+                    await writeRuntimeStateWithLiveReferences(runtime, transport, stage, previousRuntimeRelease);
                     if (runtime.commit)
                         await runtime.commit(transport, { snapshot: previousRuntimeRelease.runtime });
                     runtimeRestored = true;
@@ -336,6 +359,9 @@ export async function deploy({ transport, stage, sourcePath = process.cwd(), rev
                 }
                 catch (restoreError) {
                     restorationError = /** @type {Error} */ (restoreError);
+                    if (isRuntimeIncumbentPreservedError(restorationError) && restorationError.recovery) {
+                        await persistRuntimeRecoveryPins(transport, stage, previousRuntimeRelease.runtime, restorationError.recovery);
+                    }
                 }
             }
         }
@@ -361,6 +387,8 @@ export async function rollback({ transport, stage, to, reporter = new Reporter({
     const lock = await acquireLock(transport, stage);
     try {
         const startedAt = new Date();
+        /** @type {string[]} */
+        const warnings = [];
         const current = await requireCurrentRelease(transport, stage);
         const targetId = to ?? await previousRelease(transport, stage, current.releaseId);
         if (!targetId)
@@ -369,6 +397,7 @@ export async function rollback({ transport, stage, to, reporter = new Reporter({
             throw new Error(`Rollback target '${targetId}' is already current.`);
         const target = await resolveRetainedRelease(transport, stage, targetId);
         const revision = await readReleaseRevision(transport, target.releasePath);
+        const currentRevision = await readReleaseRevision(transport, current.releasePath);
         const runtime = runtimeFor(stage);
         const state = await readRuntimeState(transport, stage);
         const currentSnapshot = runtimeSnapshotForRollback(runtime, stage, state, current.releaseId);
@@ -386,9 +415,14 @@ export async function rollback({ transport, stage, to, reporter = new Reporter({
         let publicationAttempted = false;
         /** @type {import('#types').RuntimeBootState|undefined} */
         let acceptedBoot;
+        /** @type {string[]|undefined} */
+        let referencedReleaseIds;
         try {
             reporter.line(`Rolling back ${stage.application}/${stage.stageName} from ${current.releaseId} to ${target.releaseId}`);
             reporter.line(`  * Handing off to ${runtime.type ?? stage.runtime.type} runtime`);
+            await preserveSupersededRuntimeReferences(transport, stage, state, current.releaseId);
+            // A rollback target needs the same pre-activation cleanup pin as a newly deployed candidate.
+            await pinRuntimeReleaseForCleanup(transport, stage, targetSnapshot, target.releaseId);
             runtimeResult = await runtime.deploy(transport, {
                 releasePath: target.releasePath,
                 currentPath: current.releasePath,
@@ -409,10 +443,11 @@ export async function rollback({ transport, stage, to, reporter = new Reporter({
             if (stage.healthChecks.length > 0)
                 reporter.line("  * Running health checks");
             await runHealthChecks(transport, stage.healthChecks, target.releasePath);
+            referencedReleaseIds = await readRuntimeReferencesBeforePublication(runtime, transport, stage, { releaseId: target.releaseId, revision, runtime: acceptedTargetSnapshot }, runtimeResult);
             reporter.line("  * Publishing current symlink");
             publicationAttempted = true;
             await publishCurrent(transport, stage, target.releasePath);
-            await writeRuntimeState(transport, stage, { releaseId: target.releaseId, revision, runtime: acceptedTargetSnapshot });
+            await writeRuntimeState(transport, stage, { releaseId: target.releaseId, revision, runtime: acceptedTargetSnapshot }, { referencedReleaseIds });
             if (runtime.commit)
                 await runtime.commit(transport, { snapshot: acceptedTargetSnapshot });
             acceptedBoot = await persistRuntimeBootState(runtime, transport, stage, acceptedTargetSnapshot, { releasePath: target.releasePath, releaseId: target.releaseId, revision });
@@ -420,6 +455,9 @@ export async function rollback({ transport, stage, to, reporter = new Reporter({
         catch (error) {
             const targetError = /** @type {Error} */ (error);
             if (isRuntimeIncumbentPreservedError(targetError)) {
+                if (targetError.recovery) {
+                    await persistRuntimeRecoveryPins(transport, stage, targetSnapshot, targetError.recovery);
+                }
                 targetError.message = `Rollback to '${target.releaseId}' failed: ${targetError.message}\nThe incumbent release '${current.releaseId}' remains authoritative; automatic runtime restoration was not attempted. Current was not changed.`;
                 throw targetError;
             }
@@ -437,7 +475,7 @@ export async function rollback({ transport, stage, to, reporter = new Reporter({
                     currentPath: target.releasePath,
                     releaseId: current.releaseId,
                     previousReleaseId: target.releaseId,
-                    revision: await readReleaseRevision(transport, current.releasePath),
+                    revision: currentRevision,
                     targetSnapshot: currentSnapshot,
                     currentSnapshot: targetSnapshot,
                     deferCommit: true
@@ -445,25 +483,27 @@ export async function rollback({ transport, stage, to, reporter = new Reporter({
                 await runHealthChecks(transport, stage.healthChecks, current.releasePath);
                 if (publicationAttempted) {
                     await publishCurrent(transport, stage, current.releasePath);
-                    if (state) {
-                        await writeRuntimeState(transport, stage, state.active);
-                    }
-                    else if (await transport.exists(deployPaths(stage).statePath)) {
-                        await transport.rm(deployPaths(stage).statePath);
-                    }
                 }
+                await writeRuntimeStateWithLiveReferences(runtime, transport, stage, { releaseId: current.releaseId, revision: currentRevision, runtime: currentSnapshot });
                 if (runtime.commit)
                     await runtime.commit(transport, { snapshot: currentSnapshot });
             }
             catch (error) {
                 const restorationError = /** @type {Error} */ (error);
+                if (isRuntimeIncumbentPreservedError(restorationError) && restorationError.recovery) {
+                    await persistRuntimeRecoveryPins(transport, stage, currentSnapshot, restorationError.recovery);
+                }
                 const combined = /** @type {Error & {restorationError?: Error}} */ (new Error(`Rollback to '${target.releaseId}' failed: ${targetError.message}\nRestoration of previous release '${current.releaseId}' also failed: ${restorationError.message}`, { cause: targetError }));
                 combined.restorationError = restorationError;
                 throw combined;
             }
             throw new Error(`Rollback to '${target.releaseId}' failed: ${targetError.message}\nPrevious release '${current.releaseId}' was reactivated and passed health checks. Current was ${publicationAttempted ? "restored" : "not changed"}.`, { cause: targetError });
         }
-        await completeRuntimeOwnerHandoff(runtime, transport, stage, lock, acceptedBoot, { releaseId: target.releaseId, revision, runtime: acceptedTargetSnapshot }, runtimeResult);
+        const handoffReferencesPersisted = await completeRuntimeOwnerHandoff(runtime, transport, stage, lock, acceptedBoot, { releaseId: target.releaseId, revision, runtime: acceptedTargetSnapshot }, runtimeResult);
+        warnings.push(...await reconcileRuntimeReleasePinsAfterAcceptance(transport, stage, reporter, {
+            referencesAuthoritative: referencedReleaseIds !== undefined || handoffReferencesPersisted,
+            runtimeSnapshot: acceptedTargetSnapshot
+        }));
         const report = {
             application: stage.application,
             stage: stage.stageName,
@@ -474,7 +514,8 @@ export async function rollback({ transport, stage, to, reporter = new Reporter({
             previousRelease: current.releaseId,
             healthChecks: "passed",
             runtime: sanitizeRuntimeResult(runtimeResult, stage),
-            event: "rollback"
+            event: "rollback",
+            ...(warnings.length > 0 ? { warnings } : {})
         };
         await appendReport(transport, stage, report);
         return report;
@@ -716,25 +757,37 @@ function validateRecoveredPublication(stage, recovered, releaseId) {
 /**
  * @param {import('#types').Transport} transport
  * @param {import('#types').StageConfig} stage
- * @param {{releaseId: string, releasePath: string}} release
- * @param {string} revision
- * @returns {Promise<Record<string, unknown>>}
+ * @param {import('#types').RuntimeSnapshot|undefined} runtimeSnapshot
+ * @param {import('#types').GenerationTransitionRecovery} recovery
+ * @returns {Promise<void>}
  */
-async function requireReleaseMetadata(transport, stage, release, revision) {
-    const metadataPath = path.join(release.releasePath, "TRESTLE_RELEASE.json");
-    if (!await transport.exists(metadataPath) || await transport.isDirectory(metadataPath))
-        throw new Error(`Retained release is missing Rampway metadata: ${metadataPath}`);
-    let metadata;
-    try {
-        metadata = JSON.parse(await transport.readFile(metadataPath));
-    }
-    catch (error) {
-        throw new Error(`Retained release metadata is malformed at ${metadataPath}: ${ /** @type {Error} */(error).message}`);
+async function persistRuntimeRecoveryPins(transport, stage, runtimeSnapshot, recovery) {
+    if (!runtimeSnapshot)
+        throw new Error("Cannot persist runtime recovery pins without the attempted runtime snapshot.");
+    for (const releaseId of recovery.referencedReleaseIds) {
+        if (releaseId === recovery.activeReleaseId)
+            continue;
+        await pinRuntimeReleaseForCleanup(transport, stage, runtimeSnapshot, releaseId);
     }
-    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata) || metadata.application !== stage.application || metadata.stage !== stage.stageName || metadata.releaseId !== release.releaseId || metadata.revision !== revision || typeof metadata.rampwayVersion !== "string") {
-        throw new Error(`Retained release metadata does not match application, stage, release, and revision identity at ${metadataPath}.`);
+}
+/**
+ * Move accepted references to owner-scoped pins before a runtime can replace
+ * stable state. An unchanged owner clears them after its authoritative report;
+ * a changed owner cannot clear another owner's pins.
+ *
+ * @param {import('#types').Transport} transport
+ * @param {import('#types').StageConfig} stage
+ * @param {import('#types').RuntimeState|null} state
+ * @param {string|null} activeReleaseId
+ * @returns {Promise<void>}
+ */
+async function preserveSupersededRuntimeReferences(transport, stage, state, activeReleaseId) {
+    if (!state)
+        return;
+    const releaseIds = new Set([...state.referencedReleaseIds, ...(activeReleaseId ? [activeReleaseId] : [])]);
+    for (const releaseId of releaseIds) {
+        await pinRuntimeReleaseForCleanup(transport, stage, state.active.runtime, releaseId);
     }
-    return metadata;
 }
 /**
  * @param {import('#types').RuntimeAdapter} runtime
@@ -766,6 +819,43 @@ async function persistRuntimeBootState(runtime, transport, stage, snapshot, targ
         return undefined;
     return await writeRuntimeBootState(transport, stage, identity);
 }
+/**
+ * @param {import('#types').RuntimeAdapter} runtime
+ * @param {import('#types').Transport} transport
+ * @param {import('#types').StageConfig} stage
+ * @param {import('#types').RuntimeRelease} active
+ * @param {any} runtimeResult
+ * @returns {Promise<string[]|undefined>}
+ */
+async function readRuntimeReferencesBeforePublication(runtime, transport, stage, active, runtimeResult) {
+    if (runtime.handoffExternalOwner && runtimeResult?.externalOwnerVerificationRequired)
+        return undefined;
+    return await readRuntimeReferences(runtime, transport, stage, active);
+}
+/**
+ * @param {import('#types').RuntimeAdapter} runtime
+ * @param {import('#types').Transport} transport
+ * @param {import('#types').StageConfig} stage
+ * @param {import('#types').RuntimeRelease} active
+ * @returns {Promise<string[]|undefined>}
+ */
+async function readRuntimeReferences(runtime, transport, stage, active) {
+    if (!runtime.readReferencedReleaseIds)
+        return undefined;
+    const releasePath = path.join(deployPaths(stage).releasesPath, active.releaseId);
+    return await runtime.readReferencedReleaseIds(transport, { releasePath, snapshot: active.runtime });
+}
+/**
+ * @param {import('#types').RuntimeAdapter} runtime
+ * @param {import('#types').Transport} transport
+ * @param {import('#types').StageConfig} stage
+ * @param {import('#types').RuntimeRelease} active
+ * @returns {Promise<void>}
+ */
+async function writeRuntimeStateWithLiveReferences(runtime, transport, stage, active) {
+    const referencedReleaseIds = await readRuntimeReferences(runtime, transport, stage, active);
+    await writeRuntimeState(transport, stage, active, { referencedReleaseIds });
+}
 /**
  * @param {import('#types').RuntimeAdapter} runtime
  * @param {import('#types').Transport} transport
@@ -774,13 +864,11 @@ async function persistRuntimeBootState(runtime, transport, stage, snapshot, targ
  * @param {import('#types').RuntimeBootState|undefined} boot
  * @param {import('#types').RuntimeRelease} active
  * @param {any} runtimeResult
- * @returns {Promise<void>}
+ * @returns {Promise<boolean>} Whether an external owner persisted an authoritative release-reference set.
  */
 async function completeRuntimeOwnerHandoff(runtime, transport, stage, lock, boot, active, runtimeResult) {
-    if (!runtime.handoffExternalOwner || !runtimeResult?.externalOwnerVerificationRequired) {
-        await writeRuntimeState(transport, stage, active, { referencedReleaseIds: [] });
-        return;
-    }
+    if (!runtime.handoffExternalOwner || !runtimeResult?.externalOwnerVerificationRequired)
+        return false;
     if (!boot)
         throw new Error("External runtime ownership handoff requires accepted runtime boot state.");
     const request = await writeRuntimeOwnerHandoff(transport, stage, boot, lock);
@@ -793,6 +881,69 @@ async function completeRuntimeOwnerHandoff(runtime, transport, stage, lock, boot
     if (!referencesPersisted)
         throw new Error("External runtime owner did not report its referenced releases; cleanup pins and handoff request were preserved.");
     await removeRuntimeOwnerHandoff(transport, stage, request);
+    return true;
+}
+/**
+ * Provisional cleanup pins are conservative recovery metadata rather than part
+ * of runtime acceptance. Once activation is accepted, a pin-removal failure is
+ * reported but cannot turn the healthy activation into a failed deployment.
+ * Pins are cleared only when the runtime owner supplied an authoritative live
+ * reference set.
+ *
+ * @param {import('#types').Transport} transport
+ * @param {import('#types').StageConfig} stage
+ * @param {Reporter} reporter
+ * @param {{referencesAuthoritative: boolean, runtimeSnapshot: import('#types').RuntimeSnapshot}} opts
+ * @returns {Promise<string[]>}
+ */
+async function reconcileRuntimeReleasePinsAfterAcceptance(transport, stage, reporter, { referencesAuthoritative, runtimeSnapshot }) {
+    if (!referencesAuthoritative)
+        return [];
+    try {
+        await clearRuntimeReleasePinsForCleanup(transport, stage, runtimeSnapshot);
+        return [];
+    }
+    catch (error) {
+        return runtimeReleasePinReconciliationWarning(reporter, /** @type {Error} */ (error));
+    }
+}
+/**
+ * An idempotent deploy may repair a stale standalone pin only after the runtime
+ * positively refreshes the accepted release's live reference set.
+ *
+ * @param {import('#types').RuntimeAdapter} runtime
+ * @param {import('#types').Transport} transport
+ * @param {import('#types').StageConfig} stage
+ * @param {{releaseId: string, releasePath: string}} current
+ * @param {string} currentRevision
+ * @param {Reporter} reporter
+ * @returns {Promise<string[]>}
+ */
+async function reconcileRuntimeReleasePinsForIdempotentDeploy(runtime, transport, stage, current, currentRevision, reporter) {
+    if (!runtime.readReferencedReleaseIds)
+        return [];
+    try {
+        const state = await readRuntimeState(transport, stage);
+        if (state?.active.releaseId !== current.releaseId || state.active.revision.toLowerCase() !== currentRevision.toLowerCase() || state.active.runtime.type !== stage.runtime.type)
+            return [];
+        const referencedReleaseIds = await runtime.readReferencedReleaseIds(transport, { releasePath: current.releasePath, snapshot: state.active.runtime });
+        await writeRuntimeState(transport, stage, state.active, { referencedReleaseIds });
+        await clearRuntimeReleasePinsForCleanup(transport, stage, state.active.runtime);
+        return [];
+    }
+    catch (error) {
+        return runtimeReleasePinReconciliationWarning(reporter, /** @type {Error} */ (error));
+    }
+}
+/**
+ * @param {Reporter} reporter
+ * @param {Error} error
+ * @returns {string[]}
+ */
+function runtimeReleasePinReconciliationWarning(reporter, error) {
+    const warning = `Runtime activation was accepted, but provisional cleanup pins could not be cleared: ${error.message}`;
+    reporter.line(`  ! Warning: ${warning}`);
+    return [warning];
 }
 /**
  * @param {import('#types').RuntimeAdapter} runtime