scenri 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [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

package/dist/{refresh-7HXPUHLQ.js → refresh-FKQABJOC.js}

@@ -1,37 +1,48 @@
-import { adoptRunningInstall } from './chunk-QDODTMSN.js';
+import { adoptRunningInstall } from './chunk-ECS5LRHB.js';
 import { newestStaged, compareSemver } from './chunk-4MAFHYAD.js';
-import { isOurMacBundle, runningNodeMajor, MAC_SCRIPT, macPlist, writeSupportFiles, writeMacBundle, writeLnk } from './chunk-HLMR33DT.js';
-import { readLauncherRecord, launcherDir, LAUNCHER_SCHEMA, writeLauncherRecord } from './chunk-4NQKRVO2.js';
+import { runningNodeMajor, stableExecPath, isOurMacBundle, MAC_SCRIPT, macPlist, writeSupportFiles, writeMacBundle, writeLnk } from './chunk-SDVL5OJF.js';
+import { readLauncherRecord, launcherDir, LAUNCHER_SCHEMA, writeLauncherRecord } from './chunk-2IGINCPU.js';
 import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 
 var ASSETS = ["launch.mjs", "Scenri.icns", "scenri.ico"];
 async function refreshLauncher(deps) {
   if (deps.env.SCENRI_NO_DESKTOP === "1") return {};
+  if (deps.installKind === "dev") return {};
   const record = readLauncherRecord(deps.homedir);
   if (!record) return {};
   const out = {};
+  const running = runningNodeMajor();
+  const ownNode = stableExecPath(deps.execPath, deps.platform);
+  const nodeGone = !existsSync(record.nodePath);
+  const majorChanged = (nodeGone || samePath(record.nodePath, ownNode, deps.platform) || samePath(record.nodePath, deps.execPath, deps.platform)) && record.nodeMajor !== void 0 && record.nodeMajor !== running;
+  let rebuilt = false;
   if (deps.installKind === "npx" || deps.installKind === "global") {
     const newest = newestStaged(deps.home, deps.pkg);
-    if (!newest || compareSemver(deps.version, newest) > 0) {
+    const newer = !newest || compareSemver(deps.version, newest) > 0;
+    const rebuild = majorChanged && newest !== null && compareSemver(deps.version, newest) >= 0;
+    if (newer || rebuild) {
       const r = await adoptRunningInstall({
         home: deps.home,
         pkg: deps.pkg,
         version: deps.version,
         ownEntry: deps.ownEntry,
         installKind: deps.installKind,
-        verifyImpl: deps.verifyImpl
+        verifyImpl: deps.verifyImpl,
+        force: rebuild
       });
-      if (r.adopted) out.adopted = true;
+      if (r.adopted) {
+        out.adopted = true;
+        rebuilt = rebuild;
+      }
     }
   }
   const support = launcherDir(deps.homedir);
   const artifact = record.artifact.path;
   const ours = existsSync(artifact) && (record.artifact.kind === "macos-app" ? isOurMacBundle(artifact) : true);
   const schemaStale = record.schema !== LAUNCHER_SCHEMA;
-  const nodeGone = !existsSync(record.nodePath);
-  const nodePath = nodeGone ? deps.execPath : record.nodePath;
-  const nodeMajor = nodeGone ? runningNodeMajor() : record.nodeMajor ?? runningNodeMajor();
+  const nodePath = nodeGone ? ownNode : record.nodePath;
+  const nodeMajor = nodeGone || rebuilt ? running : record.nodeMajor ?? running;
   const nodeFilesStale = deps.platform === "darwin" && (readText(join(support, "node-path")) !== `${nodePath}
 ` || readText(join(support, "node-major")) !== `${nodeMajor}
 `);
@@ -59,7 +70,7 @@ async function refreshLauncher(deps) {
       icon: `${join(support, "scenri.ico")},0`
     });
   }
-  if (schemaStale || supportStale || nodeGone || iconStale || bundleStale) {
+  if (schemaStale || supportStale || nodeGone || iconStale || bundleStale || rebuilt) {
     writeLauncherRecord(deps.homedir, {
       ...record,
       schema: LAUNCHER_SCHEMA,
@@ -71,6 +82,9 @@ async function refreshLauncher(deps) {
   }
   return out;
 }
+function samePath(a, b, platform) {
+  return platform === "win32" ? a.toLowerCase() === b.toLowerCase() : a === b;
+}
 function readText(path) {
   try {
     return readFileSync(path, "utf8");
@@ -87,5 +101,5 @@ function sameFile(a, b) {
 }
 
 export { refreshLauncher };
-//# sourceMappingURL=refresh-7HXPUHLQ.js.map
-//# sourceMappingURL=refresh-7HXPUHLQ.js.map
+//# sourceMappingURL=refresh-FKQABJOC.js.map
+//# sourceMappingURL=refresh-FKQABJOC.js.map

package/dist/serve.js

@@ -1,5 +1,5 @@
 import { createUpdateChecker, classify, isReleaseTriplet, findNpm, stageVersion } from './chunk-FYQ5BAFA.js';
-import { portBusyLines } from './chunk-WGIZJXNE.js';
+import { shouldAdoptRunning, anotherScenriLines, portBusyLines } from './chunk-CMLJGPYC.js';
 import { SchemaTooNewError, createCore, BUDGET_EXHAUSTED, SpendCapError, budgetSize, EDIT_REFERENCE_ROLE_DIRECTIVE, REFERENCE_ROLE_DIRECTIVE, ratioLabel, searchTerms, termMatches, SCHEMA_VERSION, ASPECT_TOLERANCE } from './chunk-OJAG3FRX.js';
 import { detectInstallKind } from './chunk-PAIAXRAC.js';
 export { detectInstallKind } from './chunk-PAIAXRAC.js';
@@ -7789,6 +7789,16 @@ function registerImageRoutes(app, deps) {
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.9.1",
+    date: "2026-09-07",
+    sections: [
+      {
+        heading: "Desktop",
+        body: "The desktop icon on Windows now ends in the studio or in one plain sentence, never in silence. On both systems the Starting page and the studio open in your default browser, a start that fails says why, and after a Node.js upgrade the next terminal start rebuilds the copy the icon runs."
+      }
+    ]
+  },
   {
     version: "0.9.0",
     date: "2026-09-06",
@@ -8739,15 +8749,15 @@ function registerDesktopRoutes(app, deps) {
         record: null
       };
     }
-    const { installDeps } = await import('./cli-BVPVS4V5.js');
-    const { desktopStatus } = await import('./install-V6DAA7TT.js');
+    const { installDeps } = await import('./cli-FYWM4HBN.js');
+    const { desktopStatus } = await import('./install-4W6AARK6.js');
     return desktopStatus(installDeps(runtime.entry));
   });
   const install = deps.installImpl ?? (async () => {
     if (!runtime.entry) {
       return { ok: false, reason: "unsupported", message: "Desktop shortcuts are not available on this system yet." };
     }
-    const { addToDesktop } = await import('./cli-BVPVS4V5.js');
+    const { addToDesktop } = await import('./cli-FYWM4HBN.js');
     return addToDesktop(runtime.entry);
   });
   app.get("/api/desktop", async () => {
@@ -10260,6 +10270,14 @@ async function run() {
           });
           const info = await res.json();
           if (info.name === readMeta().name) {
+            if (!shouldAdoptRunning({ installKind, ourHome: core.home, theirHome: info.home })) {
+              console.error("");
+              for (const line of anotherScenriLines(PORT, info.home ?? "another library", core.home)) {
+                console.error(`  ${line}`);
+              }
+              console.error("");
+              process.exit(1);
+            }
             const url = `http://127.0.0.1:${PORT}`;
             console.log(`
   Scenri is already running \u2192 ${url}
@@ -10332,10 +10350,10 @@ async function run() {
     }
   }
   const ownEntry = fileURLToPath(import.meta.url);
-  const { addToDesktop, installDeps } = await import('./cli-BVPVS4V5.js');
-  const { refreshLauncher } = await import('./refresh-7HXPUHLQ.js');
+  const { addToDesktop, installDeps } = await import('./cli-FYWM4HBN.js');
+  const { refreshLauncher } = await import('./refresh-FKQABJOC.js');
   const { askOnTerminal, offerDesktop, shouldOfferDesktop } = await import('./offer-IVTNHIDJ.js');
-  const { launcherInstalled } = await import('./paths-36Y73GGY.js');
+  const { launcherInstalled } = await import('./paths-6ZXRZUHY.js');
   const meta = readMeta();
   void refreshLauncher({ ...installDeps(ownEntry), ownEntry, installKind, pkg: meta.name }).then((r) => {
     if (r.adopted)

package/launcher/launch.mjs

@@ -22,7 +22,9 @@ const record = readJson(join(here, 'launcher.json'));
 const home = typeof record?.home === 'string' && record.home ? record.home : join(homedir(), '.scenri');
 const logPath = join(home, 'logs', 'launcher.log');
 
-log(`bootstrap v${SCHEMA}: invoked from ${here}`);
+log(
+  `bootstrap v${SCHEMA}: invoked from ${here} by ${process.execPath} (node ${process.version}, ${process.platform}), home ${home}`,
+);
 const version = newestVersion(home);
 if (!version) {
   log(`bootstrap v${SCHEMA}: no valid version under ${join(home, 'app', 'versions')}`);
@@ -49,6 +51,13 @@ const child = spawn(process.execPath, [entry, 'open'], {
   env,
 });
 if (fd !== null) closeSync(fd);
+// A node that cannot be executed arrives as an event, not an exit, and unhandled
+// it would end this process with nothing on screen.
+child.on('error', (err) => {
+  log(`bootstrap v${SCHEMA}: could not start ${entry} (${err.message})`);
+  dialog(`Scenri could not start (${err.message}). Open a terminal and run: npx scenri`);
+  process.exit(1);
+});
 log(`bootstrap v${SCHEMA}: handing off to ${entry} (pid ${child.pid ?? 'unknown'})`);
 if (wait) {
   child.on('exit', (code) => process.exit(code ?? 1));
@@ -127,8 +136,10 @@ function dialog(message) {
         { stdio: 'ignore' },
       );
     } else if (process.platform === 'win32') {
+      // windowsHide keeps the console off screen and the box still shows;
+      // probed on a real Windows desktop, where a detached PowerShell shows nothing.
       spawnSync(
-        'powershell.exe',
+        powershell(),
         [
           '-NoProfile',
           '-NonInteractive',
@@ -142,3 +153,10 @@ function dialog(message) {
     /* the log line above is the record */
   }
 }
+
+/** Windows PowerShell 5.1 by its absolute path: a Desktop click has Explorer's PATH, not the terminal's. */
+function powershell() {
+  const root = process.env.SystemRoot || process.env.windir || 'C:\\Windows';
+  const absolute = join(root, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+  return existsSync(absolute) ? absolute : 'powershell.exe';
+}

package/launcher/starting.html

@@ -49,9 +49,12 @@
   var bar = document.getElementById('bar');
   var deadline = Date.now() + 90000;
   var done = false;
+  var failed = false;
   function go() { if (done) return; done = true; location.replace(target); }
+  // The fail text is a verdict on the wait, not on the server: a start that
+  // finishes late (a first Defender scan of a fresh install) still hands over.
   function fail(message) {
-    if (done) return; done = true;
+    if (done || failed) return; failed = true;
     title.textContent = 'Scenri did not start';
     text.innerHTML = message;
     bar.hidden = true;
@@ -59,7 +62,7 @@
   if (!ok) { fail('This page needs to be opened by Scenri itself. Open a terminal and run: <code>npx scenri</code>'); return; }
   function probe() {
     if (done) return;
-    if (Date.now() > deadline) { fail('Open a terminal and run <code>npx scenri</code> to see why.'); return; }
+    if (Date.now() > deadline) fail('Open a terminal and run <code>npx scenri</code> to see why.');
     // An image load needs no CORS and works from a file: URL in every browser;
     // the opaque fetch is the second opinion for browsers that block images
     // from a local page.
@@ -69,7 +72,7 @@
     if (window.fetch) {
       fetch(target + 'api/version', { mode: 'no-cors', cache: 'no-store' }).then(go, () => {});
     }
-    setTimeout(probe, 500);
+    setTimeout(probe, failed ? 2000 : 500);
   }
   probe();
 })();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scenri",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "author": "Tony Gorb <hello@scenri.co>",
   "license": "AGPL-3.0-only",
   "type": "module",

package/dist/install-V6DAA7TT.js

@@ -1,4 +0,0 @@
-export { UNSUPPORTED, desktopStatus, installDesktop, removeDesktop, runningNodeMajor, writeSupportFiles } from './chunk-HLMR33DT.js';
-import './chunk-4NQKRVO2.js';
-//# sourceMappingURL=install-V6DAA7TT.js.map
-//# sourceMappingURL=install-V6DAA7TT.js.map

package/dist/paths-36Y73GGY.js

@@ -1,3 +0,0 @@
-export { LAUNCHER_SCHEMA, desktopDir, isSupportedPlatform, launcherDir, launcherInstalled, launcherRecordPath, logsDir, readLauncherRecord, recordedEnv, writeLauncherRecord } from './chunk-4NQKRVO2.js';
-//# sourceMappingURL=paths-36Y73GGY.js.map
-//# sourceMappingURL=paths-36Y73GGY.js.map