@volter/world-runtime 2.0.10 → 2.0.11

package/dist/src/branch.js

@@ -46,7 +46,38 @@ export async function branchWorld(base, name, options = {}) {
         throw new Error(`volter-world branch: ${base} has a managed database, which keeps no history to branch from at an instant or position; branch from its current state`);
     }
     refuseLiveDatabases(from, databases);
-    const instance = await upWorld(existsSync(from.configPath) ? from.configPath : from.config, { name, root, mode: from.mode, envFile });
+    // a branch that fails to boot (a twin whose mounted version breaks the config's pin) leaves no half-made branch behind:
+    // its record without a fork would check out later as an empty World
+    const existed = (() => { try {
+        statusWorld(name, root);
+        return true;
+    }
+    catch {
+        return false;
+    } })();
+    let instance;
+    try {
+        instance = await upWorld(existsSync(from.configPath) ? from.configPath : from.config, { name, root, mode: from.mode, envFile });
+    }
+    catch (error) {
+        let recorded = false;
+        if (!existed) {
+            try {
+                statusWorld(name, root);
+                recorded = true;
+            }
+            catch { /* the boot recorded nothing */ }
+        }
+        if (recorded) {
+            try {
+                await downWorld(name, root, { purge: true });
+            }
+            catch (cleanup) {
+                throw new Error(`${error instanceof Error ? error.message : String(error)} (and the half-made branch ${name} could not be removed: ${cleanup instanceof Error ? cleanup.message : String(cleanup)})`);
+            }
+        }
+        throw error;
+    }
     const forked = {};
     try {
         if (from.origin) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world-runtime",
-  "version": "2.0.10",
+  "version": "2.0.11",
   "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",

package/src/branch.ts

@@ -48,7 +48,22 @@ export async function branchWorld(base: string, name: string, options: BranchOpt
     throw new Error(`volter-world branch: ${base} has a managed database, which keeps no history to branch from at an instant or position; branch from its current state`);
   }
   refuseLiveDatabases(from, databases);
-  const instance = await upWorld(existsSync(from.configPath) ? from.configPath : from.config, { name, root, mode: from.mode, envFile });
+  // a branch that fails to boot (a twin whose mounted version breaks the config's pin) leaves no half-made branch behind:
+  // its record without a fork would check out later as an empty World
+  const existed = (() => { try { statusWorld(name, root); return true; } catch { return false; } })();
+  let instance: WorldInstance;
+  try {
+    instance = await upWorld(existsSync(from.configPath) ? from.configPath : from.config, { name, root, mode: from.mode, envFile });
+  } catch (error) {
+    let recorded = false;
+    if (!existed) { try { statusWorld(name, root); recorded = true; } catch { /* the boot recorded nothing */ } }
+    if (recorded) {
+      try { await downWorld(name, root, { purge: true }); } catch (cleanup) {
+        throw new Error(`${error instanceof Error ? error.message : String(error)} (and the half-made branch ${name} could not be removed: ${cleanup instanceof Error ? cleanup.message : String(cleanup)})`);
+      }
+    }
+    throw error;
+  }
   const forked: Record<string, string[]> = {};
   try {
     if (from.origin) { instance.origin = { ...from.origin }; saveWorldInstance(instance); }