scenri 0.9.0 → 0.9.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [0.9.2](https://github.com/tonygorb/Scenri/compare/v0.9.1...v0.9.2) (2026-09-07)
+
+
+### Bug Fixes
+
+* **codex:** name the model the installed cli is too old for ([91868da](https://github.com/tonygorb/Scenri/commit/91868daf6ec2d8f3d2c6e636923683d7650aafbf))
+* **codex:** name the model the installed cli is too old for ([66b6b81](https://github.com/tonygorb/Scenri/commit/66b6b819303c4ed99fc40e6137bf00725b4d9673))
+
+## [0.9.1](https://github.com/tonygorb/Scenri/compare/v0.9.0...v0.9.1) (2026-09-07)
+
+
+### Bug Fixes
+
+* **cli:** the desktop icon on Windows ends in the studio or a sentence, never in silence ([4a5dacb](https://github.com/tonygorb/Scenri/commit/4a5dacbdc1522fa04e506c92354182d0c3f08309))
+* **cli:** the desktop icon on Windows ends in the studio or a sentence, never in silence ([86bdc1e](https://github.com/tonygorb/Scenri/commit/86bdc1e24728d3a706e690c13c08b0adb27714ec))
+* **cli:** the dialog PowerShell keeps windowsHide, because a detached one shows nothing on Windows ([f140c04](https://github.com/tonygorb/Scenri/commit/f140c04b47008359ea4f2e194a08435b9321842a))
+
 ## [0.9.0](https://github.com/tonygorb/Scenri/compare/v0.8.3...v0.9.0) (2026-09-06)
 
 

package/dist/{chunk-4NQKRVO2.js → chunk-2IGINCPU.js}

@@ -1,5 +1,5 @@
-import { readFileSync, mkdirSync, writeFileSync, renameSync, existsSync } from 'fs';
-import { join } from 'path';
+import { existsSync, readFileSync, mkdirSync, writeFileSync, renameSync } from 'fs';
+import { join, win32 } from 'path';
 
 // src/desktop/paths.ts
 var LAUNCHER_SCHEMA = 1;
@@ -32,15 +32,21 @@ function recordedEnv(env) {
   return out;
 }
 var KNOWN_FOLDER_DESKTOP = "[Environment]::GetFolderPath('Desktop')";
+var PS_UTF8 = "[Console]::OutputEncoding=[System.Text.Encoding]::UTF8; ";
+function powershellPath(env, exists = existsSync) {
+  const root = env.SystemRoot || env.SYSTEMROOT || env.windir || "C:\\Windows";
+  const absolute = win32.join(root, "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
+  return exists(absolute) ? absolute : "powershell.exe";
+}
 async function desktopDir(deps) {
   if (deps.env.SCENRI_DESKTOP_DIR) return deps.env.SCENRI_DESKTOP_DIR;
   if (deps.platform === "darwin") return join(deps.homedir, "Desktop");
   if (deps.platform === "win32") {
-    const out = await deps.runImpl("powershell.exe", [
+    const out = await deps.runImpl(powershellPath(deps.env), [
       "-NoProfile",
       "-NonInteractive",
       "-Command",
-      KNOWN_FOLDER_DESKTOP
+      PS_UTF8 + KNOWN_FOLDER_DESKTOP
     ]);
     const dir = out.trim();
     return dir || null;
@@ -50,6 +56,6 @@ async function desktopDir(deps) {
 var isSupportedPlatform = (platform) => platform === "darwin" || platform === "win32";
 var launcherInstalled = (homedir) => existsSync(launcherRecordPath(homedir));
 
-export { LAUNCHER_SCHEMA, desktopDir, isSupportedPlatform, launcherDir, launcherInstalled, launcherRecordPath, logsDir, readLauncherRecord, recordedEnv, writeLauncherRecord };
-//# sourceMappingURL=chunk-4NQKRVO2.js.map
-//# sourceMappingURL=chunk-4NQKRVO2.js.map
+export { LAUNCHER_SCHEMA, PS_UTF8, desktopDir, isSupportedPlatform, launcherDir, launcherInstalled, launcherRecordPath, logsDir, powershellPath, readLauncherRecord, recordedEnv, writeLauncherRecord };
+//# sourceMappingURL=chunk-2IGINCPU.js.map
+//# sourceMappingURL=chunk-2IGINCPU.js.map

package/dist/{chunk-WGIZJXNE.js → chunk-CMLJGPYC.js}

@@ -1,3 +1,6 @@
+import { realpathSync } from 'fs';
+import { resolve } from 'path';
+
 // src/bootError.ts
 var INSTALL_GUIDE = "https://github.com/tonygorb/scenri/blob/main/docs/INSTALL.md";
 var NATIVE_MARKERS = ["NODE_MODULE_VERSION", "Could not locate the bindings file", "ERR_DLOPEN_FAILED"];
@@ -30,7 +33,26 @@ function bootErrorLines(err) {
     "Set SCENRI_DEBUG=1 to see the full error."
   ];
 }
+function shouldAdoptRunning(input) {
+  if (input.installKind !== "dev" || !input.theirHome) return true;
+  return realDir(input.theirHome) === realDir(input.ourHome);
+}
+function realDir(p) {
+  try {
+    return realpathSync(p);
+  } catch {
+    return resolve(p);
+  }
+}
+function anotherScenriLines(port, theirs, ours) {
+  return [
+    `Port ${port} is held by another Scenri, serving ${theirs}.`,
+    `This checkout would serve ${ours}, so it did not start.`,
+    "Stop that server, or start this checkout on a different port:",
+    `  SCENRI_PORT=${port + 1} pnpm dev`
+  ];
+}
 
-export { bootErrorLines, portBusyLines };
-//# sourceMappingURL=chunk-WGIZJXNE.js.map
-//# sourceMappingURL=chunk-WGIZJXNE.js.map
+export { anotherScenriLines, bootErrorLines, portBusyLines, shouldAdoptRunning };
+//# sourceMappingURL=chunk-CMLJGPYC.js.map
+//# sourceMappingURL=chunk-CMLJGPYC.js.map

package/dist/{chunk-QDODTMSN.js → chunk-ECS5LRHB.js}

@@ -6,7 +6,7 @@ import { dirname, join } from 'path';
 async function adoptRunningInstall(deps) {
   if (deps.installKind === "dev") return { adopted: false, reason: "dev" };
   if (deps.installKind === "managed") return { adopted: false, reason: "managed" };
-  if (isValidVersionDir(deps.home, deps.pkg, deps.version)) return { adopted: false, reason: "present" };
+  if (!deps.force && isValidVersionDir(deps.home, deps.pkg, deps.version)) return { adopted: false, reason: "present" };
   const pkgRoot = dirname(dirname(deps.ownEntry));
   if (!existsSync(deps.ownEntry) || manifestVersion(pkgRoot) !== deps.version) {
     return { adopted: false, reason: "no-source" };
@@ -23,8 +23,15 @@ async function adoptRunningInstall(deps) {
     if (!await (deps.verifyImpl ?? verifyEntry)(copied)) return { adopted: false, reason: "no-source" };
     const target = join(versionsDir(deps.home), deps.version);
     mkdirSync(dirname(target), { recursive: true });
-    rmSync(target, { recursive: true, force: true });
-    renameSync(work, target);
+    const aside = join(stagingDir(deps.home), `replaced-${deps.version}`);
+    rmSync(aside, { recursive: true, force: true });
+    try {
+      if (existsSync(target)) renameSync(target, aside);
+      renameSync(work, target);
+    } catch {
+      return { adopted: false, reason: "busy" };
+    }
+    rmSync(aside, { recursive: true, force: true });
   } finally {
     rmSync(work, { recursive: true, force: true });
   }
@@ -58,5 +65,5 @@ function manifestVersion(pkgRoot) {
 }
 
 export { adoptRunningInstall };
-//# sourceMappingURL=chunk-QDODTMSN.js.map
-//# sourceMappingURL=chunk-QDODTMSN.js.map
+//# sourceMappingURL=chunk-ECS5LRHB.js.map
+//# sourceMappingURL=chunk-ECS5LRHB.js.map

package/dist/{chunk-HLMR33DT.js → chunk-SDVL5OJF.js}

@@ -1,5 +1,5 @@
-import { isSupportedPlatform, desktopDir, launcherDir, LAUNCHER_SCHEMA, writeLauncherRecord, recordedEnv, readLauncherRecord } from './chunk-4NQKRVO2.js';
-import { existsSync, rmSync, mkdirSync, writeFileSync, chmodSync, copyFileSync, renameSync, utimesSync } from 'fs';
+import { powershellPath, isSupportedPlatform, desktopDir, launcherDir, LAUNCHER_SCHEMA, writeLauncherRecord, recordedEnv, readLauncherRecord, PS_UTF8 } from './chunk-2IGINCPU.js';
+import { realpathSync, existsSync, rmSync, mkdirSync, writeFileSync, chmodSync, copyFileSync, renameSync, utimesSync } from 'fs';
 import { join, dirname } from 'path';
 
 var MAC_BUNDLE_ID = "co.scenri.desktop-launcher";
@@ -114,10 +114,10 @@ function writeMacBundle(opts) {
 }
 
 // src/desktop/windows.ts
-var POWERSHELL = "powershell.exe";
+var POWERSHELL = powershellPath(process.env);
 var POWERSHELL_ARGS = ["-NoProfile", "-NonInteractive", "-Command"];
 var CREATE_LNK_COMMAND = "$s = New-Object -ComObject WScript.Shell; $l = $s.CreateShortcut($env:SCENRI_LNK); $l.TargetPath = $env:SCENRI_TARGET; $l.Arguments = $env:SCENRI_ARGS; $l.WorkingDirectory = $env:SCENRI_WORKDIR; $l.IconLocation = $env:SCENRI_ICON; $l.Description = 'Open Scenri'; $l.WindowStyle = 7; $l.Save()";
-var READ_LNK_COMMAND = "$s = New-Object -ComObject WScript.Shell; $l = $s.CreateShortcut($env:SCENRI_LNK); Write-Output $l.TargetPath; Write-Output $l.Arguments";
+var READ_LNK_COMMAND = `${PS_UTF8}$s = New-Object -ComObject WScript.Shell; $l = $s.CreateShortcut($env:SCENRI_LNK); Write-Output $l.TargetPath; Write-Output $l.Arguments`;
 async function readLnk(runImpl, path) {
   const out = await runImpl(POWERSHELL, [...POWERSHELL_ARGS, READ_LNK_COMMAND], { env: { SCENRI_LNK: path } });
   const [target = "", args = ""] = out.split(/\r?\n/);
@@ -163,7 +163,8 @@ async function installDesktop(deps) {
     if (!ours) return { ok: false, reason: "collision", message: COLLISION };
   }
   const nodeMajor = runningNodeMajor();
-  writeSupportFiles({ ...deps, nodeMajor }, support);
+  const nodePath = stableExecPath(deps.execPath, deps.platform);
+  writeSupportFiles({ ...deps, execPath: nodePath, nodeMajor }, support);
   try {
     if (darwin) {
       writeMacBundle({
@@ -175,7 +176,7 @@ async function installDesktop(deps) {
     } else {
       await writeLnk(deps.runImpl, {
         path: artifact,
-        target: deps.execPath,
+        target: nodePath,
         args: `"${bootstrap}"`,
         workdir: support,
         icon: `${join(support, "scenri.ico")},0`
@@ -192,7 +193,7 @@ async function installDesktop(deps) {
     schema: LAUNCHER_SCHEMA,
     createdBy: deps.version,
     home: deps.home,
-    nodePath: deps.execPath,
+    nodePath,
     nodeMajor,
     env: recordedEnv(deps.env),
     artifact: { kind, path: artifact }
@@ -200,6 +201,14 @@ async function installDesktop(deps) {
   return { ok: true, kind, path: artifact };
 }
 var runningNodeMajor = () => Number(process.versions.node.split(".")[0]);
+function stableExecPath(execPath, platform, realpath = realpathSync) {
+  if (platform !== "win32") return execPath;
+  try {
+    return realpath(execPath);
+  } catch {
+    return execPath;
+  }
+}
 function writeSupportFiles(deps, support) {
   mkdirSync(support, { recursive: true });
   for (const f of SUPPORT_FILES) copyFileSync(join(deps.assetsDir, f), join(support, f));
@@ -241,6 +250,6 @@ async function desktopStatus(deps) {
   return { supported, platform: deps.platform, installed, path, current, record };
 }
 
-export { MAC_SCRIPT, POWERSHELL, POWERSHELL_ARGS, UNSUPPORTED, desktopStatus, installDesktop, isOurMacBundle, macPlist, removeDesktop, runningNodeMajor, writeLnk, writeMacBundle, writeSupportFiles };
-//# sourceMappingURL=chunk-HLMR33DT.js.map
-//# sourceMappingURL=chunk-HLMR33DT.js.map
+export { MAC_SCRIPT, POWERSHELL_ARGS, UNSUPPORTED, desktopStatus, installDesktop, isOurMacBundle, macPlist, removeDesktop, runningNodeMajor, stableExecPath, writeLnk, writeMacBundle, writeSupportFiles };
+//# sourceMappingURL=chunk-SDVL5OJF.js.map
+//# sourceMappingURL=chunk-SDVL5OJF.js.map

package/dist/{cli-BVPVS4V5.js → cli-FYWM4HBN.js}

@@ -1,39 +1,107 @@
-import { adoptRunningInstall } from './chunk-QDODTMSN.js';
+import { adoptRunningInstall } from './chunk-ECS5LRHB.js';
 import { detectInstallKind } from './chunk-PAIAXRAC.js';
 import { readMeta } from './chunk-Y3ZPBPLP.js';
 import { defaultHome, newestStaged, listStaged, compareSemver, entryOf } from './chunk-4MAFHYAD.js';
-import { removeDesktop, installDesktop, POWERSHELL_ARGS, POWERSHELL } from './chunk-HLMR33DT.js';
-import { launcherDir, logsDir } from './chunk-4NQKRVO2.js';
+import { removeDesktop, installDesktop, POWERSHELL_ARGS } from './chunk-SDVL5OJF.js';
+import { launcherDir, logsDir, powershellPath } from './chunk-2IGINCPU.js';
 import { execFile, spawn } from 'child_process';
-import { existsSync, closeSync, mkdirSync, writeFileSync, readFileSync, openSync, rmSync, statSync, renameSync, appendFileSync } from 'fs';
+import { existsSync, closeSync, readFileSync, writeFileSync, mkdirSync, openSync, rmSync, statSync, renameSync, appendFileSync } from 'fs';
 import { homedir } from 'os';
-import { join, dirname, delimiter } from 'path';
-import { pathToFileURL } from 'url';
+import { join, dirname, delimiter, win32 } from 'path';
+import { createServer } from 'http';
 
-async function openInBrowser(url, platform, env) {
+var HELPER_TIMEOUT_MS = 1e4;
+async function openInBrowser(url, platform, env, impl = {}) {
+  const timeoutMs = impl.timeoutMs ?? HELPER_TIMEOUT_MS;
   if (platform === "win32") {
-    await new Promise((resolve) => {
-      const child = spawn(POWERSHELL, [...POWERSHELL_ARGS, "Start-Process $env:SCENRI_URL"], {
-        stdio: "ignore",
+    const spawnImpl = impl.spawn ?? spawn;
+    const root = env.SystemRoot || env.SYSTEMROOT || env.windir || "C:\\Windows";
+    const helpers = [
+      {
+        cmd: powershellPath(env),
+        args: [...POWERSHELL_ARGS, "Start-Process $env:SCENRI_URL"],
+        env: { ...env, SCENRI_URL: url },
+        ok: (code) => code === 0
+      },
+      {
+        cmd: win32.join(root, "System32", "rundll32.exe"),
+        args: ["url.dll,FileProtocolHandler", url],
+        ok: (c) => c === 0
+      },
+      // explorer.exe answers 1 even when it did the job; only a failure to start counts.
+      { cmd: win32.join(root, "explorer.exe"), args: [url], ok: (code) => code !== null }
+    ];
+    const reasons = [];
+    for (const helper of helpers) {
+      const result = await runHelper(spawnImpl, helper, env, timeoutMs);
+      if (result.ok) return;
+      reasons.push(`${win32.basename(helper.cmd)}: ${result.reason}`);
+    }
+    throw new Error(`no helper could open the browser (${reasons.join("; ")})`);
+  }
+  const openImpl = impl.open ?? (async (u) => await (await import('open')).default(u));
+  const child = await openImpl(url);
+  child.ref?.();
+  await new Promise((resolve, reject) => {
+    let done = false;
+    const finish = (err) => {
+      if (done) return;
+      done = true;
+      clearTimeout(timer);
+      err ? reject(err) : resolve();
+    };
+    const timer = setTimeout(() => finish(), timeoutMs);
+    child.once("error", (err) => finish(err));
+    child.once(
+      "close",
+      (code) => finish(code === 0 || code === null ? void 0 : new Error(`the opener exited with ${code}`))
+    );
+  });
+}
+function runHelper(spawnImpl, helper, env, timeoutMs) {
+  return new Promise((resolve) => {
+    let done = false;
+    let stderr = "";
+    const finish = (result) => {
+      if (done) return;
+      done = true;
+      clearTimeout(timer);
+      resolve(result);
+    };
+    let child;
+    try {
+      child = spawnImpl(helper.cmd, helper.args, {
+        stdio: ["ignore", "ignore", "pipe"],
         windowsHide: true,
-        detached: true,
-        env: { ...env, SCENRI_URL: url }
+        env: helper.env ?? env
       });
-      child.once("error", () => resolve());
-      child.once("spawn", () => resolve());
-      child.unref();
+    } catch (err) {
+      return finish({ ok: false, reason: err instanceof Error ? err.message : String(err) });
+    }
+    const timer = setTimeout(() => {
+      try {
+        child.kill();
+      } catch {
+      }
+      finish({ ok: false, reason: `no answer within ${Math.round(timeoutMs / 1e3)} s` });
+    }, timeoutMs);
+    child.stderr?.on("data", (d) => {
+      stderr += String(d);
     });
-    return;
-  }
-  const { default: open } = await import('open');
-  await open(url);
+    child.once("error", (err) => finish({ ok: false, reason: err.message }));
+    child.once("close", (code) => {
+      if (helper.ok(code)) return finish({ ok: true });
+      const detail = stderr.trim().split(/\r?\n/)[0];
+      finish({ ok: false, reason: `exit ${code}${detail ? `: ${detail}` : ""}` });
+    });
+  });
 }
 var MESSAGE_BOX = "Add-Type -AssemblyName System.Windows.Forms | Out-Null; [System.Windows.Forms.MessageBox]::Show($env:SCENRI_MESSAGE, 'Scenri') | Out-Null";
-function showDialog(platform, message, env) {
+function showDialog(platform, message, env, spawnImpl = spawn) {
   if (env.SCENRI_NO_DIALOG === "1") return Promise.resolve();
   let cmd;
   let args;
-  let childEnv;
+  let opts;
   if (platform === "darwin") {
     cmd = "/usr/bin/osascript";
     args = [
@@ -46,10 +114,11 @@ function showDialog(platform, message, env) {
       "--",
       message
     ];
+    opts = { stdio: "ignore" };
   } else if (platform === "win32") {
-    cmd = POWERSHELL;
+    cmd = powershellPath(env);
     args = [...POWERSHELL_ARGS, MESSAGE_BOX];
-    childEnv = { ...env, SCENRI_MESSAGE: message };
+    opts = { stdio: "ignore", windowsHide: true, env: { ...env, SCENRI_MESSAGE: message } };
   } else {
     console.error(`
   ${message}
@@ -58,7 +127,7 @@ function showDialog(platform, message, env) {
   }
   return new Promise((resolve) => {
     try {
-      const child = spawn(cmd, args, { stdio: "ignore", windowsHide: true, env: childEnv });
+      const child = spawnImpl(cmd, args, opts);
       child.once("error", () => resolve());
       child.once("exit", () => resolve());
     } catch {
@@ -88,6 +157,8 @@ function openLogFd(path, opts = {}) {
   return openSync(path, "a");
 }
 var LOCK_FRESH_MS = 6e4;
+var READY_TIMEOUT_MS = 18e4;
+var PAGE_FETCH_GRACE_MS = 15e3;
 var QUICK_DEATH_MS = 1e4;
 var NATIVE_MARKERS = ["NODE_MODULE_VERSION", "Could not locate the bindings file", "ERR_DLOPEN_FAILED"];
 async function showBrowser(deps, url) {
@@ -104,8 +175,17 @@ async function openScenri(deps) {
   const port = Number(deps.env.SCENRI_PORT || 4747);
   const url = `http://127.0.0.1:${port}/`;
   const noOpen = deps.env.SCENRI_NO_OPEN === "1";
-  deps.log(`open: invoked by ${deps.version} for port ${port}`);
+  deps.log(
+    `open: invoked by ${deps.version} (${deps.execPath}, node ${process.version}, ${process.platform}, cwd ${process.cwd()}) for port ${port}`
+  );
+  let page = null;
   if (!takeLock(deps)) {
+    const running = await deps.probe(`${url}api/version`, 2e3);
+    if (running?.name === deps.pkg) {
+      deps.log("open: another launch is in progress and Scenri already answers, opening the browser");
+      if (!noOpen) await showBrowser(deps, url);
+      return 0;
+    }
     deps.log("open: another launch is in progress, stepping aside");
     return 0;
   }
@@ -117,46 +197,57 @@ async function openScenri(deps) {
       return 0;
     }
     const fd = openLogFd(deps.serverLogPath);
-    const child = deps.spawnImpl(deps.execPath, [deps.ownEntry], {
-      detached: true,
-      stdio: ["ignore", fd, fd],
-      windowsHide: true,
-      env: {
-        ...deps.env,
-        SCENRI_NO_OPEN: "1",
-        SCENRI_HEADLESS: "1",
-        // npm sits beside node for nvm, fnm, Volta, Homebrew and the installer,
-        // and a Finder or Explorer PATH has none of them: without this the
-        // server boots but one-click updates report no npm.
-        PATH: [dirname(deps.execPath), deps.env.PATH].filter(Boolean).join(delimiter)
-      }
-    });
-    child.unref();
-    closeSync(fd);
     const started = deps.now();
     let exit = null;
+    let spawnError = null;
+    let child;
+    try {
+      child = deps.spawnImpl(deps.execPath, [deps.ownEntry], {
+        detached: true,
+        stdio: ["ignore", fd, fd],
+        windowsHide: true,
+        env: {
+          ...deps.env,
+          SCENRI_NO_OPEN: "1",
+          SCENRI_HEADLESS: "1",
+          // npm sits beside node for nvm, fnm, Volta, Homebrew and the installer,
+          // and a Finder or Explorer PATH has none of them: without this the
+          // server boots but one-click updates report no npm.
+          PATH: [dirname(deps.execPath), deps.env.PATH].filter(Boolean).join(delimiter)
+        }
+      });
+    } catch (err) {
+      closeSync(fd);
+      return await couldNotStart(deps, err);
+    }
+    child.unref();
+    closeSync(fd);
+    child.on("error", (err) => {
+      spawnError = err;
+      exit = { code: null };
+    });
     child.on("exit", (code) => {
       exit = { code };
     });
     deps.log(`open: started the supervisor, pid ${child.pid ?? "unknown"}, log ${deps.serverLogPath}`);
     let shown = false;
-    if (!noOpen && deps.startingTemplate && existsSync(deps.startingTemplate)) {
+    if (!noOpen && deps.startingTemplate && existsSync(deps.startingTemplate) && deps.startingServer) {
       try {
-        mkdirSync(dirname(deps.startingPage), { recursive: true });
-        writeFileSync(deps.startingPage, renderStartingPage(readFileSync(deps.startingTemplate, "utf8"), url));
-        await deps.openBrowser(pathToFileURL(deps.startingPage).href);
+        page = await deps.startingServer(renderStartingPage(readFileSync(deps.startingTemplate, "utf8"), url));
+        deps.log(`open: serving the starting page at ${page.url}`);
+        await deps.openBrowser(page.url);
         shown = true;
         deps.log("open: showing the starting page");
       } catch (err) {
         deps.log(`open: could not show the starting page (${err instanceof Error ? err.message : String(err)})`);
       }
     }
-    const deadline = started + (deps.readyTimeoutMs ?? 9e4);
+    const deadline = started + (deps.readyTimeoutMs ?? READY_TIMEOUT_MS);
     for (; ; ) {
       const info = await deps.probe(`${url}api/version`, 1e3);
       if (info?.name === deps.pkg) {
         deps.log(`open: ready in ${deps.now() - started}ms`);
-        if (!noOpen && !shown) await showBrowser(deps, url);
+        if (!noOpen) await handOver(deps, url, shown ? page : null);
         return 0;
       }
       if (exit) break;
@@ -168,6 +259,7 @@ async function openScenri(deps) {
       }
       await deps.sleep(deps.pollMs ?? 250);
     }
+    if (spawnError) return await couldNotStart(deps, spawnError);
     const lived = deps.now() - started;
     deps.log(`open: the server exited with ${exit.code} after ${lived}ms`);
     const previous = deps.previousEntries[0];
@@ -176,6 +268,9 @@ async function openScenri(deps) {
       releaseLock(deps.lockPath);
       const fallback = deps.spawnImpl(deps.execPath, [previous, "open"], {
         stdio: "inherit",
+        // This process has no console; without the hint Windows would give
+        // the fallback a visible one.
+        windowsHide: true,
         env: {
           ...deps.env,
           SCENRI_DESKTOP_FALLBACK: deps.version,
@@ -183,16 +278,34 @@ async function openScenri(deps) {
           ...shown ? { SCENRI_NO_OPEN: "1" } : {}
         }
       });
-      return await new Promise((resolve) => fallback.on("exit", (code) => resolve(code ?? 1)));
+      return await new Promise((resolve) => {
+        fallback.on("error", (err) => {
+          deps.log(`open: could not start the fallback (${err.message})`);
+          resolve(1);
+        });
+        fallback.on("exit", (code) => resolve(code ?? 1));
+      });
     }
     const message = explain(deps.readLogTail(), port);
     deps.log(`open: dialog: ${message}`);
     await deps.showDialog(message);
     return 1;
   } finally {
+    page?.close();
     releaseLock(deps.lockPath);
   }
 }
+async function handOver(deps, url, page) {
+  if (!page) return showBrowser(deps, url);
+  const until = deps.now() + PAGE_FETCH_GRACE_MS;
+  while (!page.wasFetched() && deps.now() < until) await deps.sleep(deps.pollMs ?? 250);
+  if (page.wasFetched()) {
+    deps.log(`open: the browser fetched the starting page (${page.userAgent() ?? "unknown browser"})`);
+    return;
+  }
+  deps.log("open: the browser never fetched the starting page, opening the studio directly");
+  await showBrowser(deps, url);
+}
 var STUDIO_URL = /^http:\/\/127\.0\.0\.1:\d{2,5}\/$/;
 var STUDIO_META = '<meta name="scenri-studio" content="">';
 function renderStartingPage(template, url) {
@@ -209,11 +322,16 @@ function explain(tail2, port) {
   if (tail2.includes("a native component failed to load") || NATIVE_MARKERS.some((m) => tail2.includes(m))) {
     return "Node.js changed since Scenri was installed. Open Terminal and run: npx scenri@latest";
   }
-  if (NATIVE_MARKERS.some((m) => tail2.includes(m))) {
-    return "Scenri\u2019s files do not match this Node.js. Open Terminal and run: npx scenri";
-  }
   return "Scenri could not start. Open Terminal and run npx scenri to see why.";
 }
+async function couldNotStart(deps, err) {
+  const reason = err instanceof Error ? err.message : String(err);
+  deps.log(`open: could not start the supervisor (${reason})`);
+  const message = `Scenri could not start (${reason}). Open Terminal and run npx scenri to see why.`;
+  deps.log(`open: dialog: ${message}`);
+  await deps.showDialog(message);
+  return 1;
+}
 function takeLock(deps) {
   try {
     const held = JSON.parse(readFileSync(deps.lockPath, "utf8"));
@@ -234,6 +352,38 @@ function releaseLock(path) {
   } catch {
   }
 }
+function serveStartingPage(html) {
+  let fetched = false;
+  let agent = null;
+  const server = createServer((req, res) => {
+    if (req.method !== "GET" && req.method !== "HEAD" || req.url !== "/") {
+      res.statusCode = 404;
+      res.end();
+      return;
+    }
+    fetched = true;
+    const ua = req.headers["user-agent"];
+    agent = typeof ua === "string" ? ua : null;
+    res.setHeader("content-type", "text/html; charset=utf-8");
+    res.setHeader("cache-control", "no-store");
+    res.end(html);
+  });
+  return new Promise((resolve, reject) => {
+    server.once("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const { port } = server.address();
+      resolve({
+        url: `http://127.0.0.1:${port}/`,
+        wasFetched: () => fetched,
+        userAgent: () => agent,
+        close: () => {
+          server.close();
+          server.closeAllConnections();
+        }
+      });
+    });
+  });
+}
 
 // src/desktop/cli.ts
 var assetsDirFor = (ownEntry) => join(dirname(ownEntry), "..", "launcher");
@@ -348,7 +498,7 @@ async function runOpenCommand(ownEntry) {
     serverLogPath,
     readLogTail: () => tail(serverLogPath),
     startingTemplate: join(assetsDirFor(ownEntry), "starting.html"),
-    startingPage: join(support, "starting.html"),
+    startingServer: serveStartingPage,
     previousEntries: previous
   });
 }
@@ -372,5 +522,5 @@ function tail(path, bytes = 4096) {
 var supportInstalled = () => existsSync(join(launcherDir(homedir()), "launcher.json"));
 
 export { addToDesktop, assetsDirFor, installDeps, runDesktopCommand, runExecFile, runOpenCommand, supportInstalled };
-//# sourceMappingURL=cli-BVPVS4V5.js.map
-//# sourceMappingURL=cli-BVPVS4V5.js.map
+//# sourceMappingURL=cli-FYWM4HBN.js.map
+//# sourceMappingURL=cli-FYWM4HBN.js.map

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { bootErrorLines } from './chunk-WGIZJXNE.js';
+import { bootErrorLines } from './chunk-CMLJGPYC.js';
 import { fileURLToPath } from 'url';
 
 // src/args.ts
@@ -86,12 +86,12 @@ try {
       break;
     }
     case "desktop": {
-      const { runDesktopCommand } = await import('./cli-BVPVS4V5.js');
+      const { runDesktopCommand } = await import('./cli-FYWM4HBN.js');
       process.exit(await runDesktopCommand(command, fileURLToPath(import.meta.url)));
       break;
     }
     case "open": {
-      const { runOpenCommand } = await import('./cli-BVPVS4V5.js');
+      const { runOpenCommand } = await import('./cli-FYWM4HBN.js');
       process.exit(await runOpenCommand(fileURLToPath(import.meta.url)));
       break;
     }

package/dist/install-4W6AARK6.js

@@ -0,0 +1,4 @@
+export { UNSUPPORTED, desktopStatus, installDesktop, removeDesktop, runningNodeMajor, stableExecPath, writeSupportFiles } from './chunk-SDVL5OJF.js';
+import './chunk-2IGINCPU.js';
+//# sourceMappingURL=install-4W6AARK6.js.map
+//# sourceMappingURL=install-4W6AARK6.js.map

package/dist/paths-6ZXRZUHY.js

@@ -0,0 +1,3 @@
+export { LAUNCHER_SCHEMA, PS_UTF8, desktopDir, isSupportedPlatform, launcherDir, launcherInstalled, launcherRecordPath, logsDir, powershellPath, readLauncherRecord, recordedEnv, writeLauncherRecord } from './chunk-2IGINCPU.js';
+//# sourceMappingURL=paths-6ZXRZUHY.js.map
+//# sourceMappingURL=paths-6ZXRZUHY.js.map