@volter/world-runtime 2.0.4 → 2.0.5

package/dist/src/cli.js

@@ -70,7 +70,7 @@ function printHelp() {
                                                   # emission. Exit 0 = ready to \`up\`; exit 1 = the honest worklist.
                                                   # Deterministic: same repo + same pack catalog => identical bytes.
                                                   # init DIAGNOSES; it never boots — it prints the exact next commands
-  volter-world up <config> --env-file=<path> [--owner <label>] [--name <name>] [--mode local|share|sealed] [--isolation process|colocated|worker] [--root <repo>]
+  volter-world up <config> --env-file=<path> [--owner <label>] [--name <name>] [--mode local|share|sealed] [--isolation process|colocated|worker] [--keep-state] [--root <repo>]
   volter-world outdated <world> [--json]            — each mounted twin: pinned / mounted / catalog-current version and protocol standing (R17)
   volter-world audit <world> [--json]               — the catalog's upkeep verdicts for the mounted twins: matrix debt, census (R17)
   volter-world down <name> [--grace-ms <ms>] [--purge] [--root <repo>]   # SIGTERM, then SIGKILL survivors after the grace (default 5000ms)
@@ -329,7 +329,10 @@ async function main() {
         }
         const isolation = (isolationArg || undefined);
         // The boot runs in its own owner process (./up-task.ts): a closed terminal does not leave it half-done.
-        const instance = await superviseWorldUp(subject, { name, root, mode, envFile, owner: ownerOption(rest), ...(isolation ? { isolation } : {}) });
+        // --keep-state: boot over the state the World's directory already holds (a World carried somewhere else, e.g. a
+        // browser tab's image, comes up over its data instead of starting empty, as a fresh `up` does)
+        const keepState = rest.includes('--keep-state');
+        const instance = await superviseWorldUp(subject, { name, root, mode, envFile, owner: ownerOption(rest), ...(isolation ? { isolation } : {}), ...(keepState ? { keepState: true } : {}) });
         printReady(instance);
         return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world-runtime",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "description": "World configs for twins: boot named local runtimes, allocate ports, generate world.env/instance.json, and run apps against fake-key twin worlds.",
   "keywords": [
     "twin",
@@ -67,14 +67,14 @@
     "node": ">=22.3"
   },
   "peerDependencies": {
-    "@volter/world-core": "2.0.3",
-    "@volter/world-console": "2.0.4"
+    "@volter/world-core": "2.0.4",
+    "@volter/world-console": "2.0.5"
   },
   "dependencies": {
     "@electric-sql/pglite": "0.5.8",
     "@electric-sql/pglite-pgvector": "0.0.9",
     "@volter/world-access": "2.0.1",
-    "@volter/world-core": "2.0.3",
+    "@volter/world-core": "2.0.4",
     "pg-gateway": "0.3.0-beta.4",
     "smol-toml": "^1.8.0"
   },
@@ -84,6 +84,6 @@
     }
   },
   "optionalDependencies": {
-    "@volter/twin-mongodb": "0.1.3"
+    "@volter/twin-mongodb": "0.1.4"
   }
 }

package/src/cli.ts

@@ -71,7 +71,7 @@ function printHelp(): void {
                                                   # emission. Exit 0 = ready to \`up\`; exit 1 = the honest worklist.
                                                   # Deterministic: same repo + same pack catalog => identical bytes.
                                                   # init DIAGNOSES; it never boots — it prints the exact next commands
-  volter-world up <config> --env-file=<path> [--owner <label>] [--name <name>] [--mode local|share|sealed] [--isolation process|colocated|worker] [--root <repo>]
+  volter-world up <config> --env-file=<path> [--owner <label>] [--name <name>] [--mode local|share|sealed] [--isolation process|colocated|worker] [--keep-state] [--root <repo>]
   volter-world outdated <world> [--json]            — each mounted twin: pinned / mounted / catalog-current version and protocol standing (R17)
   volter-world audit <world> [--json]               — the catalog's upkeep verdicts for the mounted twins: matrix debt, census (R17)
   volter-world down <name> [--grace-ms <ms>] [--purge] [--root <repo>]   # SIGTERM, then SIGKILL survivors after the grace (default 5000ms)
@@ -309,7 +309,10 @@ async function main(): Promise<void> {
     }
     const isolation = (isolationArg || undefined) as 'process' | 'colocated' | 'worker' | undefined;
     // The boot runs in its own owner process (./up-task.ts): a closed terminal does not leave it half-done.
-    const instance = await superviseWorldUp(subject, { name, root, mode, envFile, owner: ownerOption(rest), ...(isolation ? { isolation } : {}) });
+    // --keep-state: boot over the state the World's directory already holds (a World carried somewhere else, e.g. a
+    // browser tab's image, comes up over its data instead of starting empty, as a fresh `up` does)
+    const keepState = rest.includes('--keep-state');
+    const instance = await superviseWorldUp(subject, { name, root, mode, envFile, owner: ownerOption(rest), ...(isolation ? { isolation } : {}), ...(keepState ? { keepState: true } : {}) });
     printReady(instance);
     return;
   }