scenri 0.8.3 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## [0.9.0](https://github.com/tonygorb/Scenri/compare/v0.8.3...v0.9.0) (2026-09-06)
+
+
+### Features
+
+* **cli:** a desktop icon that starts Scenri without a terminal ([35e8160](https://github.com/tonygorb/Scenri/commit/35e816086b3d2e10b32e454b4f40e93f4c95082a))
+* **cli:** desktop status, install and quit routes for Settings ([c8478e1](https://github.com/tonygorb/Scenri/commit/c8478e1b2059ba40c85779469e97251c5669152b))
+* **cli:** install, repair, remove and report the desktop launcher on macOS and Windows ([ee03601](https://github.com/tonygorb/Scenri/commit/ee036017dd5be738aff40b1adf2b04b7c45548fc))
+* **cli:** launcher support paths, rotating logs, and adopting the running install into app/versions ([abde8cc](https://github.com/tonygorb/Scenri/commit/abde8cc23a0dd7eccb1e55d4aada1603108b68da))
+* **cli:** offer the desktop icon once at a terminal, and keep an installed one current on every start ([5f56bb9](https://github.com/tonygorb/Scenri/commit/5f56bb9a45432df605c295b8893638cd75c0a2a0))
+* **cli:** scenri desktop and the hidden open command, with a console-less supervisor ([fbe3fcf](https://github.com/tonygorb/Scenri/commit/fbe3fcf7ef16573448c22cd222c0cd6a37ca909c))
+* **cli:** scenri open reuses a running Scenri or starts the supervisor detached and waits for it ([713e4f8](https://github.com/tonygorb/Scenri/commit/713e4f8f12014ceeff36bcea23718b2aac19ccec))
+* **cli:** ship the desktop launcher's icons, an icns and an ico cut from the brand mark ([ef104e2](https://github.com/tonygorb/Scenri/commit/ef104e28654c31350dd103850a22dfa34f54b26e))
+* **cli:** the frozen desktop bootstrap and the starting page ([151b2b9](https://github.com/tonygorb/Scenri/commit/151b2b92445a5f6b7602bedb4cc07c7131a85d61))
+* **studio:** after Shut down the tab closes instead of showing a card ([42bdf89](https://github.com/tonygorb/Scenri/commit/42bdf896d9e6ed7a4cfc98e21b201372097e3c8c))
+* **studio:** Desktop shortcut and Quit rows in About, and a verify hop before a build is adopted ([1587567](https://github.com/tonygorb/Scenri/commit/15875670bb5c3810437f19393440ecbffe51e68d))
+* **studio:** Reuse setup is back under the record, beside Try again ([abe6b03](https://github.com/tonygorb/Scenri/commit/abe6b034490733701b6c990eb6688f0147dd81bc))
+* **studio:** Reuse setup is back, and the shot sidebar and colour chips line up ([13345f2](https://github.com/tonygorb/Scenri/commit/13345f2a24d46cf3ae3f7c7d47ecd6c8a24a6665))
+* **studio:** Shut down Scenri lives at the bottom of the brand menu, not in a Settings pane ([d21914b](https://github.com/tonygorb/Scenri/commit/d21914b9dd1b4e712120e1d1c42208e48f8833fa))
+
+
+### Bug Fixes
+
+* **cli:** a browser that cannot be opened gets the address in a dialog instead of silence ([ef3d6a1](https://github.com/tonygorb/Scenri/commit/ef3d6a11a963611aa73ff025630bf55fc1a92fa5))
+* **cli:** a double-click answers at once, and every click stops paying for node probing ([25685e7](https://github.com/tonygorb/Scenri/commit/25685e7b8087bb1f794b1b5d30cd1252b4ea9b32))
+* **cli:** scenri open logs the sentence it shows, so support reads the log instead of the screen ([b52350c](https://github.com/tonygorb/Scenri/commit/b52350ce16cd67dc8a0f8931d3f7db71975ece07))
+* **cli:** the boot refresh heals node-path and node-major against the record ([4d09985](https://github.com/tonygorb/Scenri/commit/4d09985accf05b9eacd238249a2c61c697710b07))
+* **cli:** the rendered starting page is not a support file, so the boot refresh leaves it alone ([d3b1396](https://github.com/tonygorb/Scenri/commit/d3b13966b778c4c51a49922984f394ac9d0e146d))
+* **cli:** the starting page carries the studio URL in a meta, because open(1) drops a file URL's fragment ([4fa6c68](https://github.com/tonygorb/Scenri/commit/4fa6c682d09c34de76ef00256fb1c0bdd8f84133))
+* **cli:** when the recorded node is gone the icon prefers a node of the same major, and a native-module death says so ([aa1dba0](https://github.com/tonygorb/Scenri/commit/aa1dba06d0d48c2a6ff3c4adcc47409f31f69311))
+* **studio:** a colour chip wears its colour as the thumbnail's circle, and its menu hugs the chip ([e5970c1](https://github.com/tonygorb/Scenri/commit/e5970c14116f9721e5596167b3e821bcd45908b3))
+* **studio:** the lifecycle overlays cover a Settings dialog instead of hiding behind it ([1e89433](https://github.com/tonygorb/Scenri/commit/1e894337948f1feb4816a67584098e4658d63244))
+* **studio:** the shot record clamps by rows, its release is a verb, and its colour chip is the thumbnail's circle ([20da7a1](https://github.com/tonygorb/Scenri/commit/20da7a154272004db5cd22e0185bc08452e0a132))
+* **studio:** the shot sidebar's composer, hairlines and copy control share one inset ([d5c4a99](https://github.com/tonygorb/Scenri/commit/d5c4a99e9bcc1cc43fd8673547cfdb73923b0d8b))
+
 ## [0.8.3](https://github.com/tonygorb/Scenri/compare/v0.8.2...v0.8.3) (2026-09-06)
 
 

package/README.md

@@ -65,6 +65,8 @@ npx scenri
 
 That is the whole install. npm asks once whether to proceed, downloads the current release, and opens `http://127.0.0.1:4747`. Keep the terminal window open while you work; closing it stops Scenri. Tomorrow the same command opens it again, with everything where you left it.
 
+On macOS and Windows, Scenri then asks once whether to put a **Scenri icon on your desktop**. Say yes and from then on a double-click starts Scenri and opens it in your browser, no terminal needed; the icon works offline and keeps working across updates. Said no? Settings, then About, then **Add to desktop**, or `npx scenri desktop` in a terminal. Scenri stays what it is, a local server and your browser: the icon is a launcher, not an app.
+
 Generation runs on **Codex CLI**, an official helper from OpenAI that draws on your own ChatGPT plan. No API key to paste, and Scenri never charges you. Each image draws on your plan's Codex usage. You do not have to set it up by hand: if it is missing, Scenri offers to install it and to sign you in, both from the app. No ChatGPT plan? Add your own key from an image provider in Settings instead, see [Engines](#engines).
 
 Two dependencies (`better-sqlite3` and `sharp`) ship native binaries, so on recent npm you may be asked to approve their install scripts once. Something not starting? See [troubleshooting](https://github.com/tonygorb/scenri/blob/main/docs/INSTALL.md#troubleshooting).

package/dist/chunk-4NQKRVO2.js

@@ -0,0 +1,55 @@
+import { readFileSync, mkdirSync, writeFileSync, renameSync, existsSync } from 'fs';
+import { join } from 'path';
+
+// src/desktop/paths.ts
+var LAUNCHER_SCHEMA = 1;
+var launcherDir = (homedir) => join(homedir, ".scenri", "launcher");
+var logsDir = (home) => join(home, "logs");
+var launcherRecordPath = (homedir) => join(launcherDir(homedir), "launcher.json");
+function readLauncherRecord(homedir) {
+  try {
+    const raw = JSON.parse(readFileSync(launcherRecordPath(homedir), "utf8"));
+    if (typeof raw?.schema !== "number" || typeof raw.home !== "string" || typeof raw.nodePath !== "string" || typeof raw.artifact?.path !== "string") {
+      return null;
+    }
+    return raw;
+  } catch {
+    return null;
+  }
+}
+function writeLauncherRecord(homedir, record) {
+  const path = launcherRecordPath(homedir);
+  mkdirSync(launcherDir(homedir), { recursive: true });
+  const tmp = `${path}.tmp`;
+  writeFileSync(tmp, `${JSON.stringify(record, null, 2)}
+`);
+  renameSync(tmp, path);
+}
+var REPLAYED = ["SCENRI_PORT", "SCENRI_HOST"];
+function recordedEnv(env) {
+  const out = {};
+  for (const key of REPLAYED) if (env[key]) out[key] = env[key];
+  return out;
+}
+var KNOWN_FOLDER_DESKTOP = "[Environment]::GetFolderPath('Desktop')";
+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", [
+      "-NoProfile",
+      "-NonInteractive",
+      "-Command",
+      KNOWN_FOLDER_DESKTOP
+    ]);
+    const dir = out.trim();
+    return dir || null;
+  }
+  return null;
+}
+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

package/dist/chunk-HLMR33DT.js

@@ -0,0 +1,246 @@
+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 { join, dirname } from 'path';
+
+var MAC_BUNDLE_ID = "co.scenri.desktop-launcher";
+var MAC_MARKER = "scenri-launcher.json";
+var MAC_SCRIPT = `#!/bin/sh
+# Scenri desktop launcher. Written by Scenri; deleting it removes only this icon.
+L="$HOME/.scenri/launcher"
+say() {
+  if [ "$SCENRI_NO_DIALOG" = "1" ]; then return 0; fi
+  /usr/bin/osascript -e 'on run argv' \\
+    -e 'display dialog (item 1 of argv) with title "Scenri" buttons {"OK"} default button 1 with icon stop' \\
+    -e 'end run' -- "$1"
+}
+if [ ! -f "$L/launch.mjs" ]; then
+  say "Scenri's launcher files are missing. Open Terminal and run: npx scenri desktop"
+  exit 1
+fi
+# The node that installed the icon, while it still exists: no probing, no delay.
+NODE=""
+if [ -r "$L/node-path" ]; then IFS= read -r NODE < "$L/node-path" || NODE=""; fi
+if [ -z "$NODE" ] || [ ! -x "$NODE" ]; then
+  MAJOR=""
+  if [ -r "$L/node-major" ]; then IFS= read -r MAJOR < "$L/node-major" || MAJOR=""; fi
+  # Native modules were built for that node's major and another major refuses
+  # them: every candidate once demanding the same major, then once taking any.
+  candidates() {
+    command -v node 2>/dev/null || true
+    echo /opt/homebrew/bin/node
+    echo /usr/local/bin/node
+    echo "$HOME/.volta/bin/node"
+    echo "$HOME/.local/share/fnm/aliases/default/bin/node"
+    echo "$HOME/Library/Application Support/fnm/aliases/default/bin/node"
+    for c in "$HOME"/.nvm/versions/node/*/bin/node; do echo "$c"; done
+  }
+  pick() {
+    want="$1"
+    candidates | while IFS= read -r c; do
+      [ -n "$c" ] && [ -x "$c" ] || continue
+      if [ -n "$want" ]; then
+        v="$("$c" -p 'process.versions.node.split(".")[0]' 2>/dev/null)" || continue
+        [ "$v" = "$want" ] || continue
+      fi
+      echo "$c"
+    done | tail -n 1
+  }
+  NODE=""
+  if [ -n "$MAJOR" ]; then NODE="$(pick "$MAJOR")"; fi
+  if [ -z "$NODE" ]; then NODE="$(pick "")"; fi
+fi
+if [ -z "$NODE" ] || [ ! -x "$NODE" ]; then
+  say "Scenri needs Node.js, and none was found on this Mac. Install it from nodejs.org, then open Terminal and run: npx scenri"
+  exit 1
+fi
+exec "$NODE" "$L/launch.mjs"
+`;
+function macPlist(opts) {
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleDevelopmentRegion</key>
+  <string>en</string>
+  <key>CFBundleDisplayName</key>
+  <string>Scenri</string>
+  <key>CFBundleExecutable</key>
+  <string>Scenri</string>
+  <key>CFBundleIconFile</key>
+  <string>Scenri.icns</string>
+  <key>CFBundleIdentifier</key>
+  <string>${MAC_BUNDLE_ID}</string>
+  <key>CFBundleInfoDictionaryVersion</key>
+  <string>6.0</string>
+  <key>CFBundleName</key>
+  <string>Scenri</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  <key>CFBundleShortVersionString</key>
+  <string>${opts.version}</string>
+  <key>CFBundleVersion</key>
+  <string>${opts.schema}</string>
+  <key>LSMinimumSystemVersion</key>
+  <string>12.0</string>
+  <key>NSHighResolutionCapable</key>
+  <true/>
+</dict>
+</plist>
+`;
+}
+var isOurMacBundle = (bundle) => existsSync(join(bundle, "Contents", "Resources", MAC_MARKER));
+function writeMacBundle(opts) {
+  const tmp = `${opts.path}.tmp-${process.pid}`;
+  rmSync(tmp, { recursive: true, force: true });
+  const contents = join(tmp, "Contents");
+  mkdirSync(join(contents, "MacOS"), { recursive: true });
+  mkdirSync(join(contents, "Resources"), { recursive: true });
+  writeFileSync(join(contents, "Info.plist"), macPlist(opts));
+  writeFileSync(join(contents, "PkgInfo"), "APPL????");
+  const script = join(contents, "MacOS", "Scenri");
+  writeFileSync(script, MAC_SCRIPT);
+  chmodSync(script, 493);
+  copyFileSync(opts.icns, join(contents, "Resources", "Scenri.icns"));
+  writeFileSync(
+    join(contents, "Resources", MAC_MARKER),
+    `${JSON.stringify({ scenri: "desktop-launcher", schema: opts.schema, version: opts.version }, null, 2)}
+`
+  );
+  rmSync(opts.path, { recursive: true, force: true });
+  mkdirSync(dirname(opts.path), { recursive: true });
+  renameSync(tmp, opts.path);
+  const now = /* @__PURE__ */ new Date();
+  utimesSync(opts.path, now, now);
+}
+
+// src/desktop/windows.ts
+var POWERSHELL = "powershell.exe";
+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";
+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/);
+  return { target: target.trim(), args: args.trim() };
+}
+async function isOurLnk(runImpl, path, bootstrap) {
+  try {
+    const { args } = await readLnk(runImpl, path);
+    return args.toLowerCase().includes(bootstrap.toLowerCase());
+  } catch {
+    return false;
+  }
+}
+async function writeLnk(runImpl, opts) {
+  await runImpl(POWERSHELL, [...POWERSHELL_ARGS, CREATE_LNK_COMMAND], {
+    env: {
+      SCENRI_LNK: opts.path,
+      SCENRI_TARGET: opts.target,
+      SCENRI_ARGS: opts.args,
+      SCENRI_WORKDIR: opts.workdir,
+      SCENRI_ICON: opts.icon
+    }
+  });
+}
+
+// src/desktop/install.ts
+var UNSUPPORTED = "Desktop shortcuts are not available on this system yet.";
+var NO_DESKTOP = "Your Desktop folder could not be found.";
+var COLLISION = "Something else named Scenri is already on your desktop. Move or rename it, then try again.";
+var DENIED = "macOS did not allow writing to your Desktop. Allow it under System Settings > Privacy & Security > Files and Folders, then try again.";
+var SUPPORT_FILES = ["launch.mjs", "Scenri.icns", "scenri.ico"];
+async function installDesktop(deps) {
+  if (!isSupportedPlatform(deps.platform)) return { ok: false, reason: "unsupported", message: UNSUPPORTED };
+  const desktop = await desktopDir(deps);
+  if (!desktop) return { ok: false, reason: "no-desktop", message: NO_DESKTOP };
+  const darwin = deps.platform === "darwin";
+  const support = launcherDir(deps.homedir);
+  const bootstrap = join(support, "launch.mjs");
+  const kind = darwin ? "macos-app" : "windows-lnk";
+  const artifact = join(desktop, darwin ? "Scenri.app" : "Scenri.lnk");
+  if (existsSync(artifact)) {
+    const ours = darwin ? isOurMacBundle(artifact) : await isOurLnk(deps.runImpl, artifact, bootstrap);
+    if (!ours) return { ok: false, reason: "collision", message: COLLISION };
+  }
+  const nodeMajor = runningNodeMajor();
+  writeSupportFiles({ ...deps, nodeMajor }, support);
+  try {
+    if (darwin) {
+      writeMacBundle({
+        path: artifact,
+        icns: join(support, "Scenri.icns"),
+        version: deps.version,
+        schema: LAUNCHER_SCHEMA
+      });
+    } else {
+      await writeLnk(deps.runImpl, {
+        path: artifact,
+        target: deps.execPath,
+        args: `"${bootstrap}"`,
+        workdir: support,
+        icon: `${join(support, "scenri.ico")},0`
+      });
+    }
+  } catch (err) {
+    const code = err.code;
+    if (darwin && (code === "EPERM" || code === "EACCES"))
+      return { ok: false, reason: "desktop-denied", message: DENIED };
+    const detail = err instanceof Error ? err.message.split("\n")[0] : String(err);
+    return { ok: false, reason: "failed", message: `Scenri could not write ${artifact} (${detail}).` };
+  }
+  writeLauncherRecord(deps.homedir, {
+    schema: LAUNCHER_SCHEMA,
+    createdBy: deps.version,
+    home: deps.home,
+    nodePath: deps.execPath,
+    nodeMajor,
+    env: recordedEnv(deps.env),
+    artifact: { kind, path: artifact }
+  });
+  return { ok: true, kind, path: artifact };
+}
+var runningNodeMajor = () => Number(process.versions.node.split(".")[0]);
+function writeSupportFiles(deps, support) {
+  mkdirSync(support, { recursive: true });
+  for (const f of SUPPORT_FILES) copyFileSync(join(deps.assetsDir, f), join(support, f));
+  if (deps.platform === "darwin") {
+    writeFileSync(join(support, "node-path"), `${deps.execPath}
+`);
+    writeFileSync(join(support, "node-major"), `${deps.nodeMajor}
+`);
+  }
+}
+async function removeDesktop(deps) {
+  const record = readLauncherRecord(deps.homedir);
+  const support = launcherDir(deps.homedir);
+  let removed = false;
+  let message;
+  const path = record?.artifact.path;
+  if (path && existsSync(path)) {
+    const ours = record.artifact.kind === "macos-app" ? isOurMacBundle(path) : await isOurLnk(deps.runImpl, path, join(support, "launch.mjs"));
+    if (ours) {
+      rmSync(path, { recursive: true, force: true });
+      removed = true;
+    } else {
+      message = `${path} is not the launcher Scenri made, so it was left alone.`;
+    }
+  }
+  rmSync(support, { recursive: true, force: true });
+  return { removed, path, message };
+}
+async function desktopStatus(deps) {
+  const supported = isSupportedPlatform(deps.platform);
+  const record = readLauncherRecord(deps.homedir);
+  let installed = false;
+  let path = null;
+  if (supported && record && existsSync(record.artifact.path)) {
+    installed = record.artifact.kind === "macos-app" ? isOurMacBundle(record.artifact.path) : true;
+    path = installed ? record.artifact.path : null;
+  }
+  const current = installed && record !== null && record.schema === LAUNCHER_SCHEMA && (existsSync(record.nodePath) || record.nodePath === deps.execPath);
+  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