From 8a44d0dafc0ac053bdc76319342bd6550abb0c09 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Tue, 20 Oct 2026 13:31:13 +0000
Subject: [PATCH] docs(website): sync dev docs from
 d97709fb5b3756413edd924137562e3339787014

---
 fern/.docs-snapshots.yml                           | 6 +++---
 fern/pages-dev/how-it-works/sandboxes/runtimes.mdx | 6 ++++++
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/fern/.docs-snapshots.yml b/fern/.docs-snapshots.yml
index 60e4b22d6..33f045fd3 100644
--- a/fern/.docs-snapshots.yml
+++ b/fern/.docs-snapshots.yml
@@ -1,8 +1,8 @@
 snapshots:
   dev:
-    source-ref: 7417f75384a02a12b30b736cc185bb08b814bd40
-    source-sha: 7417f75384a02a12b30b736cc185bb08b814bd40
-    version: 0.1.5.dev77
+    source-ref: d97709fb5b3756413edd924137562e3339787014
+    source-sha: d97709fb5b3756413edd924137562e3339787014
+    version: 0.1.5.dev81
   latest:
     source-ref: 5a7728c304b5528e954e9ae900cf21f84e1a12b1
     source-sha: 5a7728c304b5528e954e9ae900cf21f84e1a12b1
diff --git a/fern/pages-dev/how-it-works/sandboxes/runtimes.mdx b/fern/pages-dev/how-it-works/sandboxes/runtimes.mdx
index 89ec2c8d4..f56d194d6 100644
--- a/fern/pages-dev/how-it-works/sandboxes/runtimes.mdx
+++ b/fern/pages-dev/how-it-works/sandboxes/runtimes.mdx
@@ -238,6 +238,12 @@ VM sandboxes have no network interface. All traffic flows through the OpenShell
 
 If the gateway is briefly unavailable while a VM starts, its supervisor retries the session connection. The sandbox stays in provisioning until the gateway accepts the session.
 
+### MicroVM Stop Durability
+
+When you run `openshell sandbox stop` while the main process is running, OpenShell terminates the workload and flushes the guest root filesystem before acknowledging termination. The guest waits up to three seconds for the flush. The host allows up to 22 seconds for supervisor shutdown, then up to five seconds to stop the VM.
+
+Flush errors and timeouts produce warnings while shutdown continues. If a signal kills the supervisor, the driver warns that the guest flush was not confirmed and recent writes may be lost. A completed stop does not guarantee persistence after a failed or timed-out flush. This flush does not cover stops after the main process has already exited.
+
 ### MicroVM Mounts
 
 The VM driver shares gateway-host directories into the guest with virtiofs. Each entry in `mounts` takes `source` (absolute host directory), `target`, optional `read_only` (default `true`), and optional `type`, which must be `bind` so Docker and Podman bind entries work unchanged: