@rehearsal-db/core 0.1.0-rc.1 → 0.1.0-rc.3

package/CHANGELOG.md

@@ -5,6 +5,57 @@ a Changelog, and versions will follow Semantic Versioning after the package exis
 
 ## Unreleased
 
+## [0.1.0-rc.3] - 2026-10-10
+
+### Added
+
+- `status --json` now exposes bounded, target-scoped runtime state without requiring
+  editor clients to parse human-formatted process output.
+- `activity --json` reports idle, busy, stale, invalid, and unavailable project-operation
+  state without exposing lock tokens, process arguments, credentials, or private paths.
+- Supported mutating operations now have an explicit cancellation contract: owned child
+  groups receive one bounded shutdown request, rollback and lock cleanup complete before
+  exit `130`, and unrelated processes and Docker resources remain untouched.
+- Root configuration can now choose `stop-after-run` for bounded automated checks and
+  `stop-on-application-exit` for bounded hands-on sessions. Both modes stop only the
+  configured Rehearsal targets while preserving database and Storage volumes, applied
+  migrations, and sandbox edits for the next `start` or `open`.
+- Plans, JSON results, terminal receipts, generated configuration comments, and the
+  lifecycle guide now report the selected persistence mode and resulting runtime state.
+
+### Changed
+
+- Transient application and helper processes are cleaned up before an opted-in runtime
+  stop after success, proof failure, readiness timeout, or supported interruption. The
+  compatibility default remains `keep-until-stop` for both `run` and `open`.
+
+### Fixed
+
+- Read-only runtime inspection now works when a VS Code extension launches the CLI
+  through Electron's executable in Node mode. That mode is preserved only for
+  Rehearsal's nested runtime manager and is not exposed to project-owned commands.
+
+## [0.1.0-rc.2] - 2026-10-09
+
+### Changed
+
+- Container-engine startup is now explicit by default. Rehearsal starts Colima only
+  when a project deliberately enables `containerRuntime.autoStartColima`, reports that
+  action, and never silently stops the shared engine.
+- Package-managed Supabase containers use Docker's non-resuming restart policy after
+  each start, preventing stopped Rehearsal stacks from waking merely because Docker or
+  Colima restarts. Exact Supabase project labels keep the change inside the selected
+  disposable target.
+- Runtime diagnostics and a new lifecycle guide explain which commands need Docker,
+  what remains running, and how to finish a low-memory local session without pruning or
+  deleting persistent data.
+
+### Fixed
+
+- A stopped Colima VM no longer restarts from a default Rehearsal configuration.
+- Independent Test Lab acceptance now reaps exact workspace-owned interactive children
+  after success, failure, interruption, and timeout.
+
 ## [0.1.0-rc.1] - 2026-10-08
 
 ### Changed
@@ -554,7 +605,9 @@ a Changelog, and versions will follow Semantic Versioning after the package exis
   publication uses short-lived trusted OIDC, and every release tag must already exist on
   protected `main`.
 
-[Unreleased]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-rc.1...HEAD
+[Unreleased]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-rc.3...HEAD
+[0.1.0-rc.3]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-rc.2...v0.1.0-rc.3
+[0.1.0-rc.2]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-rc.1...v0.1.0-rc.2
 [0.1.0-rc.1]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-beta.18...v0.1.0-rc.1
 [0.1.0-beta.18]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-beta.17...v0.1.0-beta.18
 [0.1.0-beta.17]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-beta.16...v0.1.0-beta.17

package/README.md

@@ -1,12 +1,39 @@
-# Rehearsal
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Ddupasquier/rehearsal-db/main/docs/site/logo-mark.svg" width="104" height="104" alt="Rehearsal logo" />
+</p>
 
-[![Monthly npm downloads](https://img.shields.io/npm/dm/%40rehearsal-db%2Fcore?style=flat-square&logo=npm&logoColor=white&label=npm%20downloads&labelColor=1c2a34&color=287b5c)](https://www.npmjs.com/package/@rehearsal-db/core)
+<h1 align="center">Rehearsal</h1>
 
-[Read the documentation](https://ddupasquier.github.io/rehearsal-db/) · [View on npm](https://www.npmjs.com/package/@rehearsal-db/core) · [Report a problem](https://github.com/Ddupasquier/rehearsal-db/issues)
+<p align="center"><strong>Your migration passed on an empty database. Production will not be empty.</strong></p>
 
-Rehearsal tests PostgreSQL and Supabase migrations on your computer before you run them
-anywhere important. It restores safe test data into a disposable local database, applies
-only the migrations you approve, and runs your project's own test command.
+<p align="center">
+  <a href="https://www.npmjs.com/package/@rehearsal-db/core"><img alt="npm version" src="https://img.shields.io/npm/v/%40rehearsal-db%2Fcore?style=flat-square&logo=npm&logoColor=white&labelColor=1c2a34&color=287b5c" /></a>
+  <a href="https://www.npmjs.com/package/@rehearsal-db/core"><img alt="Monthly npm downloads" src="https://img.shields.io/npm/dm/%40rehearsal-db%2Fcore?style=flat-square&logo=npm&logoColor=white&label=downloads&labelColor=1c2a34&color=287b5c" /></a>
+  <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/npm/l/%40rehearsal-db%2Fcore?style=flat-square&labelColor=1c2a34&color=287b5c" /></a>
+  <a href="https://ddupasquier.github.io/rehearsal-db/"><img alt="Read the documentation" src="https://img.shields.io/badge/docs-read_the_guide-269fab?style=flat-square&labelColor=1c2a34" /></a>
+</p>
+
+<p align="center">
+  <a href="https://ddupasquier.github.io/rehearsal-db/">Read the documentation</a> ·
+  <a href="https://www.npmjs.com/package/@rehearsal-db/core">View on npm</a> ·
+  <a href="https://github.com/Ddupasquier/rehearsal-db/issues">Report a problem</a>
+</p>
+
+Most migration tests start with an empty database. Production does not.
+
+Existing rows, relationships, authentication identities, stored files, and migration
+history are where risky changes break. A migration can build successfully and still fail
+against the data and application behavior you actually have.
+
+**Rehearsal catches those problems before deployment.** It restores a reviewed,
+sanitized baseline into a disposable local PostgreSQL or Supabase environment, applies
+only the exact migrations you approve, and runs your application's own proof.
+
+| An empty database cannot prove…                      | Rehearsal lets you verify…                                   |
+| ---------------------------------------------------- | ------------------------------------------------------------ |
+| old rows still satisfy new constraints               | the migration against a reviewed, production-shaped copy     |
+| relationships, identities, and stored files survive  | database, Auth, and Storage behavior in one local sandbox    |
+| the application still works after the schema changes | your own tests and hands-on flows before anything is shipped |
 
 Projects with a separate publication or read-model database can declare it as a
 dependent target. Rehearsal then manages the complete isolated runtime stack.
@@ -17,7 +44,7 @@ it through a reviewed privacy policy, and retire the access again. It is never p
 `run`, `reset`, `migrate`, or application launch. Rehearsal is not a backup system or a
 production deployment tool.
 
-> Rehearsal is in public beta. Use it on a branch and keep a working backup of your
+> **Pre-1.0 safety note:** use Rehearsal on a branch and keep a working backup of your
 > project.
 
 ## What you need
@@ -37,7 +64,7 @@ your migration is intended to change.
 From your project directory:
 
 ```bash
-npm install --save-dev @rehearsal-db/core@beta
+npm install --save-dev @rehearsal-db/core
 npx rehearsal
 ```
 
@@ -89,7 +116,9 @@ source-owner approval; see [Standalone workflow](docs/standalone-workflow.md).
 
 `npx rehearsal open` starts and verifies the existing local runtime, keeps the configured
 app available until you press `Ctrl+C`, and preserves database and Storage changes for
-the next session.
+the next session. Set `lifecycle.open` to `stop-on-application-exit` when you also want
+its database targets stopped afterward; `lifecycle.run: "stop-after-run"` gives automated
+checks the same bounded, non-destructive behavior.
 
 For an approved production-shaped copy, the optional sequence is `source plan`, `source
 apply`, `refresh`, and `source retire`. `refresh` verifies the replacement before it
@@ -145,6 +174,7 @@ Reference:
 
 - [CLI commands](docs/commands.md)
 - [Configuration](docs/configuration.md)
+- [Container runtime lifecycle](docs/runtime-lifecycle.md) — keep Docker and Supabase use on demand
 - [TypeScript types](docs/typescript.md)
 - [Baselines](docs/baselines.md)
 - [Sanitization](docs/sanitization.md)

package/dist/package.json

@@ -1,8 +1,8 @@
 {
     "name": "@rehearsal-db/core",
-    "version": "0.1.0-rc.1",
+    "version": "0.1.0-rc.3",
     "private": false,
-    "description": "Safely rehearse PostgreSQL and Supabase migrations against sanitized, production-shaped data.",
+    "description": "Catch PostgreSQL and Supabase migrations that pass on empty databases but fail on real data—before deploy.",
     "repository": {
         "type": "git",
         "url": "git+https://github.com/Ddupasquier/rehearsal-db.git"

package/dist/scripts/runtime/manage_database.mjs

@@ -6,11 +6,20 @@
 import { loadRehearsalConfig } from "../../src/project/configuration.mjs";
 import { parseRuntimeInvocation } from "../../src/targets/target.mjs";
 import { runRuntimeTarget } from "../../src/targets/driver.mjs";
-const invocation = parseRuntimeInvocation();
-const { config } = await loadRehearsalConfig({
-    projectRoot: process.cwd(),
-    ...(invocation.configPath === undefined
-        ? {}
-        : { configPath: invocation.configPath }),
-});
-await runRuntimeTarget(config.runtime.target);
+import { runWithOperationCancellation } from "../../src/shared/cancellation.mjs";
+const run = async () => {
+    const invocation = parseRuntimeInvocation();
+    const { config } = await loadRehearsalConfig({
+        projectRoot: process.cwd(),
+        ...(invocation.configPath === undefined
+            ? {}
+            : { configPath: invocation.configPath }),
+    });
+    await runRuntimeTarget(config.runtime.target);
+};
+if (process.env.REHEARSAL_CANCELLABLE_OPERATION === "1") {
+    await runWithOperationCancellation({ task: run });
+}
+else {
+    await run();
+}

package/dist/src/cli/application_command_handlers.mjs

@@ -14,10 +14,10 @@ export const createApplicationCommandHandlers = ({ openRuntimeApplication, }) =>
             onReady: (ready) => {
                 const lines = [
                     `Application: ${ready.url}`,
-                    "The verified database runtime stays running and keeps your local changes.",
+                    "The configured lifecycle policy will preserve your local database and Storage changes.",
                     guided
                         ? "Press Ctrl+C to close the app and return here, or Ctrl+Z to exit Rehearsal."
-                        : "Press Ctrl+C or Ctrl+Z to close the app. Rehearsal will leave the database runtime running.",
+                        : "Press Ctrl+C or Ctrl+Z to close the app. Rehearsal will then apply the configured lifecycle policy.",
                 ];
                 if (useStyledPrompts(flags)) {
                     prompts.note(lines.join("\n"), "SANDBOX READY");
@@ -35,6 +35,7 @@ export const createApplicationCommandHandlers = ({ openRuntimeApplication, }) =>
                 data.started.output,
                 data.verified.output,
                 ...data.preparations.map((preparation) => preparation.output),
+                data.lifecycle.stop?.output,
             ]
                 .filter(Boolean)
                 .join("\n");
@@ -44,8 +45,12 @@ export const createApplicationCommandHandlers = ({ openRuntimeApplication, }) =>
             render: (result) => [
                 "SANDBOX APP CLOSED",
                 `Application stopped after ${result.application.stoppedBy}.`,
-                "The database runtime and its local database and Storage changes were preserved.",
-                "Run rehearsal open to return, rehearsal verify to check it, or rehearsal stop to stop the databases.",
+                result.lifecycle.runtimeState === "stopped"
+                    ? `Lifecycle ${result.lifecycle.mode} stopped the database runtime; its local database and Storage changes were preserved.`
+                    : `Lifecycle ${result.lifecycle.mode} left the database runtime running; its local database and Storage changes were preserved.`,
+                result.lifecycle.runtimeState === "stopped"
+                    ? "Run rehearsal start or rehearsal open to resume."
+                    : "Run rehearsal open to return, rehearsal verify to check it, or rehearsal stop to stop the databases.",
             ].join("\n"),
         });
     }),

package/dist/src/cli/basic_command_handlers.mjs

@@ -21,6 +21,7 @@ Commands:
   identity connect [--identity=] Keep the app open, detect sign-in, and connect once
   doctor                     Check whether Rehearsal is safe and ready
   support                    Print a safe, copy-ready support report
+  activity                   Report idle, busy, stale, or invalid operation state
   explain                    Show the immutable execution plan
   run --dry-run              Alias the exact explain plan without mutations
   run --confirm-candidates=  Execute reset, migration, and verification locally

package/dist/src/cli/inspection_command_handlers.mjs

@@ -4,7 +4,34 @@ import { inspectRehearsalBaseline, inspectRehearsalMigrations, } from "../runtim
 import { buildRuntimeStackPlan, runRuntimeStackDoctor, topologyCandidateSummary, } from "./runtime_commands.mjs";
 import { renderBaseline, renderCandidates, renderDoctor, renderMigrations, renderPlan, renderSupportReport, } from "./renderers.mjs";
 import { exactCommands, renderedCommand } from "./command_contract.mjs";
+import { inspectProjectOperationState } from "../shared/operation_guard.mjs";
 export const createInspectionCommandHandlers = () => [
+    exactCommands("activity", ["activity"], async ({ planOptions }) => {
+        const data = await inspectProjectOperationState({
+            projectRoot: planOptions.projectRoot ?? process.cwd(),
+        });
+        return renderedCommand({
+            data,
+            render: (result) => {
+                if (result.state === "idle")
+                    return "Rehearsal activity: idle.";
+                if (result.state === "invalid") {
+                    return "Rehearsal activity: invalid lock state. No lock was changed; finish or diagnose the owning operation before retrying a mutation.";
+                }
+                const label = result.state === "busy" ? "busy" : "stale";
+                return [
+                    `Rehearsal activity: ${label}.`,
+                    `Operation: ${result.operation.kind}`,
+                    `Started: ${result.operation.startedAt}`,
+                    result.operation.rehearsalVersion
+                        ? `Rehearsal: ${result.operation.rehearsalVersion}`
+                        : null,
+                ]
+                    .filter(Boolean)
+                    .join("\n");
+            },
+        });
+    }),
     exactCommands("doctor", ["doctor"], async ({ guided, flags, planOptions }) => {
         const data = await runRuntimeStackDoctor(planOptions);
         return renderedCommand({

package/dist/src/cli/project_commands.d.mts

@@ -17,7 +17,7 @@ type RunManager = (input: {
     flags: RehearsalCliFlags;
     configPath?: string;
     targetName?: string;
-}) => unknown;
+}) => Promise<unknown>;
 interface ProjectCommandInput {
     readonly flags: RehearsalCliFlags;
     readonly planOptions: RehearsalConfigPathOptions;
@@ -67,6 +67,10 @@ export declare const createProjectCommands: ({ projectRoot, runManager, }: {
                 containerRuntime: Readonly<{
                     autoStartColima: boolean;
                 }>;
+                lifecycle: Readonly<{
+                    run: "keep-until-stop" | "stop-after-run";
+                    open: "keep-until-stop" | "stop-on-application-exit";
+                }>;
                 cleanup: Readonly<{
                     retainBaselineGenerations: number;
                 }>;
@@ -191,6 +195,10 @@ export declare const createProjectCommands: ({ projectRoot, runManager, }: {
                 containerRuntime: Readonly<{
                     autoStartColima: boolean;
                 }>;
+                lifecycle: Readonly<{
+                    run: "keep-until-stop" | "stop-after-run";
+                    open: "keep-until-stop" | "stop-on-application-exit";
+                }>;
                 cleanup: Readonly<{
                     retainBaselineGenerations: number;
                 }>;

package/dist/src/cli/project_commands.mjs

@@ -128,7 +128,7 @@ export const createProjectCommands = ({ projectRoot, runManager, }) => {
                         projectRoot,
                         configPath: target.configPath,
                         removeRuntime: async () => {
-                            runManager({
+                            await runManager({
                                 action: "discard",
                                 flags,
                                 configPath: target.configPath,
@@ -151,7 +151,7 @@ export const createProjectCommands = ({ projectRoot, runManager, }) => {
                 : { confirmation: flags.cleanupConfirmation }),
             ...planOptions,
             removeRuntime: async () => {
-                runManager({ action: "discard", flags });
+                await runManager({ action: "discard", flags });
             },
         });
         return { mode: "written", plan, applied };

package/dist/src/cli/rehearsal.mjs

@@ -20,6 +20,7 @@ import { createProjectCommands } from "./project_commands.mjs";
 import { buildRuntimeStackPlan, createRuntimeCommands, runRuntimeStackDoctor, topologyCandidateSummary, topologyCommandEnvironment, } from "./runtime_commands.mjs";
 import { buildRefreshWorkflowPlan, createRefreshWorkflow, } from "./source_commands.mjs";
 import { installGuidedExitShortcut, useStyledPrompts } from "./terminal.mjs";
+import { runWithOperationCancellation, supportsOperationCancellation, } from "../shared/cancellation.mjs";
 const packageRoot = fileURLToPath(new URL("../../..", import.meta.url));
 const projectRoot = process.cwd();
 const managerPath = join(packageRoot, "dist/scripts/runtime/manage_database.mjs");
@@ -89,83 +90,94 @@ const main = async () => {
     const guided = command === "guide" || wantsAutomaticGuide;
     const mutating = commandMutatesProject({ command, flags, guided });
     const operation = mutating
-        ? await acquireProjectOperation({ projectRoot, command })
+        ? await acquireProjectOperation({
+            projectRoot,
+            command: guided ? "guide" : command,
+        })
         : null;
-    if (operation) {
-        activePackageFingerprint = createInstalledPackageFingerprint({
-            packageRoot,
-        });
-    }
-    try {
-        if (!guided) {
-            await executeCommand({ command, flags, planOptions, guided: false });
-            return;
-        }
-        if (!process.stdin.isTTY || !process.stdout.isTTY) {
-            throw new Error("The guided home screen requires an interactive terminal. Run rehearsal --help to list scriptable commands.");
-        }
-        flags.guided = true;
-        const installExitShortcut = () => installGuidedExitShortcut(flags, {
-            beforeExit: () => operation?.releaseSync(),
-        });
-        let removeGuidedExitShortcut = installExitShortcut();
-        if (useStyledPrompts(flags)) {
-            prompts.intro("REHEARSAL · Safe local migration testing");
+    const run = async () => {
+        if (operation) {
+            activePackageFingerprint = createInstalledPackageFingerprint({
+                packageRoot,
+            });
         }
         try {
-            while (true) {
-                resetGuidedFlags(flags);
-                resetCommandSessionState(state);
-                const selected = await runGuidedHome({ flags, planOptions });
-                if (!selected)
-                    break;
-                if (selected === "home")
-                    continue;
-                const opensApplication = selected === "open";
-                if (opensApplication) {
-                    removeGuidedExitShortcut?.();
-                    removeGuidedExitShortcut = null;
+            if (!guided) {
+                await executeCommand({ command, flags, planOptions, guided: false });
+                return;
+            }
+            if (!process.stdin.isTTY || !process.stdout.isTTY) {
+                throw new Error("The guided home screen requires an interactive terminal. Run rehearsal --help to list scriptable commands.");
+            }
+            flags.guided = true;
+            const installExitShortcut = () => installGuidedExitShortcut(flags, {
+                beforeExit: () => operation?.releaseSync(),
+            });
+            let removeGuidedExitShortcut = installExitShortcut();
+            if (useStyledPrompts(flags)) {
+                prompts.intro("REHEARSAL · Safe local migration testing");
+            }
+            try {
+                while (true) {
+                    resetGuidedFlags(flags);
+                    resetCommandSessionState(state);
+                    const selected = await runGuidedHome({ flags, planOptions });
+                    if (!selected)
+                        break;
+                    if (selected === "home")
+                        continue;
+                    const opensApplication = selected === "open";
+                    if (opensApplication) {
+                        removeGuidedExitShortcut?.();
+                        removeGuidedExitShortcut = null;
+                    }
+                    try {
+                        await executeCommand({
+                            command: selected,
+                            flags,
+                            planOptions,
+                            guided: true,
+                        });
+                    }
+                    finally {
+                        if (opensApplication) {
+                            removeGuidedExitShortcut = installExitShortcut();
+                        }
+                    }
+                    if (flags.exitGuidedSession)
+                        break;
                 }
+            }
+            finally {
+                removeGuidedExitShortcut?.();
+            }
+            if (useStyledPrompts(flags)) {
+                prompts.outro("See you at the next rehearsal.");
+            }
+            else {
+                console.log("See you at the next rehearsal.");
+            }
+        }
+        finally {
+            if (operation) {
                 try {
-                    await executeCommand({
-                        command: selected,
-                        flags,
-                        planOptions,
-                        guided: true,
+                    assertInstalledPackageFingerprint({
+                        packageRoot,
+                        expected: activePackageFingerprint,
                     });
                 }
                 finally {
-                    if (opensApplication) {
-                        removeGuidedExitShortcut = installExitShortcut();
-                    }
+                    activePackageFingerprint = null;
+                    await operation.release();
                 }
-                if (flags.exitGuidedSession)
-                    break;
             }
         }
-        finally {
-            removeGuidedExitShortcut?.();
-        }
-        if (useStyledPrompts(flags)) {
-            prompts.outro("See you at the next rehearsal.");
-        }
-        else {
-            console.log("See you at the next rehearsal.");
-        }
+    };
+    if (operation && !guided && supportsOperationCancellation(command)) {
+        await runWithOperationCancellation({ task: run });
     }
-    finally {
-        if (operation) {
-            try {
-                assertInstalledPackageFingerprint({
-                    packageRoot,
-                    expected: activePackageFingerprint,
-                });
-            }
-            finally {
-                activePackageFingerprint = null;
-                await operation.release();
-            }
-        }
+    else {
+        await run();
     }
 };
 try {

package/dist/src/cli/runtime_action_handlers.mjs

@@ -1,6 +1,7 @@
 /** Database runtime action handlers shared by guided and scripted CLI flows. */
 import * as prompts from "@clack/prompts";
 import { buildApplicationEnvironment, runHttpProofs, startApplicationSession, } from "../application/session.mjs";
+import { applyRuntimePersistence } from "../runtime/persistence.mjs";
 import { exactCommands, renderedCommand, silentCommand, } from "./command_contract.mjs";
 import { topologyCommandEnvironment, topologyEnvironmentFiles, } from "./runtime_commands.mjs";
 import { formatDuration, isHumanTerminal, terminalStyle, useStyledPrompts, } from "./terminal.mjs";
@@ -42,17 +43,20 @@ export const createRuntimeActionHandlers = ({ prepareCandidateConfirmation, prep
             });
             const { runtime, topology } = stack;
             const stackEnvironment = topologyCommandEnvironment(topology);
-            const preparations = ["run", "reset", "migrate"].includes(command)
-                ? prepareDependentTargets({
-                    topology,
-                    environment: stackEnvironment,
-                })
-                : [];
+            let preparations = [];
             let applicationProof;
             let dependentProofs = [];
             let httpProofResults = [];
             let applicationReadiness;
-            if (command === "run") {
+            const completeFollowups = async () => {
+                preparations = ["run", "reset", "migrate"].includes(command)
+                    ? await prepareDependentTargets({
+                        topology,
+                        environment: stackEnvironment,
+                    })
+                    : [];
+                if (command !== "run")
+                    return;
                 const applicationConfig = topology.primary.config.application;
                 const mappedApplicationEnvironment = Object.keys(applicationConfig.environmentVariables).length
                     ? await buildApplicationEnvironment({
@@ -111,7 +115,19 @@ export const createRuntimeActionHandlers = ({ prepareCandidateConfirmation, prep
                 else if (isHumanTerminal(flags)) {
                     console.log(`${terminalStyle(flags, "32", "✓")} Project proofs passed.`);
                 }
-            }
+            };
+            const persistence = command === "run"
+                ? await applyRuntimePersistence({
+                    mode: topology.primary.config.lifecycle.run,
+                    operation: completeFollowups,
+                    stop: async () => (await runRuntimeStack({
+                        command: "stop",
+                        flags,
+                        planOptions,
+                        session: state,
+                    })).runtime,
+                })
+                : (await completeFollowups(), null);
             const data = command === "run"
                 ? {
                     runtime,
@@ -120,6 +136,7 @@ export const createRuntimeActionHandlers = ({ prepareCandidateConfirmation, prep
                     applicationProof,
                     applicationReadiness,
                     httpProofResults,
+                    lifecycle: persistence.lifecycle,
                 }
                 : preparations.length
                     ? { ...runtime, preparations }
@@ -130,6 +147,7 @@ export const createRuntimeActionHandlers = ({ prepareCandidateConfirmation, prep
                     ...preparations.map((preparation) => preparation.output),
                     ...dependentProofs.map((proof) => proof.output),
                     applicationProof?.output,
+                    persistence?.lifecycle.stop?.output,
                 ]
                     .filter(Boolean)
                     .join("\n");
@@ -145,8 +163,11 @@ export const createRuntimeActionHandlers = ({ prepareCandidateConfirmation, prep
                         ? value.applicationReadiness
                         : undefined;
                     const renderedHttpProofResults = "httpProofResults" in value ? value.httpProofResults : [];
+                    const renderedLifecycle = "lifecycle" in value ? value.lifecycle : undefined;
                     const nextAction = {
-                        run: "Next: run rehearsal open for hands-on testing, then rehearsal verify.",
+                        run: renderedLifecycle?.runtimeState === "stopped"
+                            ? "The runtime was stopped with its database and Storage changes preserved. Run rehearsal start or rehearsal open to resume."
+                            : "Next: run rehearsal open for hands-on testing, then rehearsal verify.",
                         start: "Next: run rehearsal open for hands-on testing or rehearsal status.",
                         migrate: "Next: run rehearsal verify to prove the current runtime.",
                         reset: "Next: run rehearsal open or rehearsal verify.",
@@ -171,6 +192,9 @@ export const createRuntimeActionHandlers = ({ prepareCandidateConfirmation, prep
                                 ? `✓ Application became ready at ${renderedApplicationReadiness.url}`
                                 : null,
                             ...renderedHttpProofResults.map((proof) => `✓ ${proof.kind} HTTP proof passed: ${proof.name}`),
+                            renderedLifecycle
+                                ? `✓ Lifecycle ${renderedLifecycle.mode}: runtime ${renderedLifecycle.runtimeState}; data preserved`
+                                : null,
                             "",
                             "Technical output is available from Show details in the guide.",
                         ]
@@ -189,6 +213,9 @@ export const createRuntimeActionHandlers = ({ prepareCandidateConfirmation, prep
                             ? `Application readiness passed: ${renderedApplicationReadiness.url}`
                             : null,
                         ...renderedHttpProofResults.map((proof) => `${proof.kind} HTTP proof passed: ${proof.name}`),
+                        renderedLifecycle
+                            ? `Lifecycle ${renderedLifecycle.mode}: runtime ${renderedLifecycle.runtimeState}; data preserved.`
+                            : null,
                         nextAction ? "" : null,
                         nextAction,
                     ]