scenri 0.2.3 → 0.3.1

package/ASSETS-LICENSE.md

@@ -1,12 +1,12 @@
-# scenri assets license
+# Scenri assets license
 
-scenri's code is AGPL-3.0-only (see LICENSE). The imagery and curated content are
+Scenri's code is AGPL-3.0-only (see LICENSE). The imagery and curated content are
 licensed under these terms instead.
 
 This covers the starter content pack, everything under `templates/`, the library
-content scenri downloads at runtime, and the project's marketing imagery.
+content Scenri downloads at runtime, and the project's marketing imagery.
 
-You may use this content freely within scenri, including for commercial work.
+You may use this content freely within Scenri, including for commercial work.
 Everything you generate with it is yours.
 
 You may not redistribute, rebundle, resell, or republish the content itself, and

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.3.1](https://github.com/tonygorb/scenri/compare/v0.3.0...v0.3.1) (2026-08-20)
+
+
+### Bug Fixes
+
+* calm boot failures and stop the silent hang on a busy port ([d04946f](https://github.com/tonygorb/scenri/commit/d04946f011b204c230473f5338f0a32f8870a1d0))
+* friendly first-run errors and the install guide ([b1782ad](https://github.com/tonygorb/scenri/commit/b1782adb4fc48807e384a208ee8894022d62d615))
+
+## [0.3.0](https://github.com/tonygorb/scenri/compare/v0.2.3...v0.3.0) (2026-08-20)
+
+
+### Features
+
+* give every browser tab an intentional title ([e518396](https://github.com/tonygorb/scenri/commit/e5183961dae9f52ecd5801ae4c8cfce5fb397f3a))
+* name the product Scenri across the interface, docs and CLI ([cce242b](https://github.com/tonygorb/scenri/commit/cce242be955520569fdffb170f14f91f752d1801))
+
 ## [0.2.3](https://github.com/tonygorb/scenri/compare/v0.2.2...v0.2.3) (2026-08-20)
 
 

package/LICENSE

@@ -629,7 +629,7 @@ to attach them to the start of each source file to most effectively
 state the exclusion of warranty; and each file should have at least
 the "copyright" line and a pointer to where the full notice is found.
 
-    scenri - the open studio for brand-consistent AI visuals
+    Scenri - the open studio for brand-consistent AI visuals
     Copyright (C) 2026  Tony Gorb
 
     This program is free software: you can redistribute it and/or modify

package/NOTICE

@@ -1,4 +1,4 @@
-scenri
+Scenri
 Copyright 2026 Tony Gorb
 
 This product includes software and assets developed by third parties.
@@ -46,11 +46,11 @@ Phosphor Icons (`@phosphor-icons/react`), MIT, Copyright (c) 2023 Phosphor Icons
 
 ## Third-party marks
 
-scenri shows each generation provider's own mark beside its name, so that the
+Scenri shows each generation provider's own mark beside its name, so that the
 row asking for your key names the service you recognise rather than a generic
 glyph. Every mark is reproduced unmodified, in a variant its owner publishes,
 and is used referentially to identify which service a key or a sign-in belongs
-to. scenri is not built, supported, certified, endorsed by, or affiliated with
+to. Scenri is not built, supported, certified, endorsed by, or affiliated with
 any of them, and makes no such claim.
 
 | Mark | File | Artwork source | Artwork licence |
@@ -63,7 +63,7 @@ Each mark sits on the plate its owner puts it on, in the colours its owner
 publishes, sampled from that owner's own icon: OpenAI's 180px favicon (white
 plate, black mark), OpenRouter's app icon (white plate, violet mark) and
 Replicate's favicon (red plate, white mark). The pairs are recorded in `BRAND` in
-`apps/studio/src/engines/providers.tsx` and are identical in both of scenri's
+`apps/studio/src/engines/providers.tsx` and are identical in both of Scenri's
 themes, because none of these owners publishes a dark variant and inventing one
 would be redrawing their logo. No geometry is redrawn, distorted, recomposed,
 recoloured or tinted, and no mark is ever separated from its own plate.

package/README.md

@@ -2,7 +2,7 @@
 
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/logo-on-dark.svg">
-  <img src="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/logo-on-light.svg" alt="scenri" width="200">
+  <img src="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/logo-on-light.svg" alt="Scenri" width="200">
 </picture>
 <br><br>
 
@@ -19,7 +19,9 @@ Define a client's brand once. Then generate, branch, and art-direct on-brand ima
 npx scenri
 ```
 
-<img src="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/demo.gif" alt="The scenri composer: a dollar sign opens a product picker and Selvedge Trucker is chosen, an at sign picks the presenter Maren, a slash picks the Editorial Walk scene, a line of written direction is typed after the three chips, the shot renders as a card in the wall, and it opens to show the picture beside the brief that made it" width="820">
+<sub>Needs [Node.js](https://nodejs.org) 22 or newer. New to any of this? The [install guide](docs/INSTALL.md) walks through every step.</sub>
+
+<img src="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/demo.gif" alt="The Scenri composer: a dollar sign opens a product picker and Selvedge Trucker is chosen, an at sign picks the presenter Maren, a slash picks the Editorial Walk scene, a line of written direction is typed after the three chips, the shot renders as a card in the wall, and it opens to show the picture beside the brief that made it" width="820">
 
 <sub>Pick a product, pick a presenter, pick a scene, then write the direction. That is the brief.</sub>
 
@@ -29,7 +31,7 @@ npx scenri
 
 ## What it is
 
-Most AI image tools give you a prompt box and a slot machine. scenri gives you the part that actually takes the time: **art direction**.
+Most AI image tools give you a prompt box and a slot machine. Scenri gives you the part that actually takes the time: **art direction**.
 
 Every shot keeps its lineage. Branch an edit from any shot, put the two side by side, and the drift heatmap shows you exactly where the model changed your product when it should not have.
 
@@ -47,7 +49,7 @@ All 97 examples on the home wall work the same way. Open one and it loads back i
 
 ## What you get out of the box
 
-<img src="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/library.gif" alt="A slow scroll down the scenri home wall: rows of finished example shots across product categories, with the composer docked at the bottom of the screen" width="820">
+<img src="https://raw.githubusercontent.com/tonygorb/scenri/main/docs/media/library.gif" alt="A slow scroll down the Scenri home wall: rows of finished example shots across product categories, with the composer docked at the bottom of the screen" width="820">
 
 A library of scenes, presenters and demo products, so the app is useful before you have uploaded anything of your own. Filter by category, bookmark what fits the brand, or build your own from a few reference photos.
 
@@ -55,15 +57,17 @@ The brand kit sits one gesture away in Settings and is the part that keeps outpu
 
 ## Run it
 
+Scenri runs on [Node.js](https://nodejs.org), version 22 or newer. If you are not sure you have it, or terminals are not part of your day, the **[install guide](docs/INSTALL.md)** covers every step for macOS, Windows and Linux. With Node in place:
+
 ```bash
 npx scenri
 ```
 
-That is the whole install. It opens `http://127.0.0.1:4747`.
+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.
 
-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).
+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).
 
-Requires **Node 22 or newer**. Two dependencies (`better-sqlite3` and `sharp`) ship native binaries, so on recent npm you may be asked to approve their install scripts once.
+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](docs/INSTALL.md#troubleshooting).
 
 <details>
 <summary>Run from source</summary>
@@ -80,7 +84,7 @@ pnpm dev          # starts the server on 127.0.0.1:4747
 
 ## First five minutes
 
-1. **Paste a website URL.** scenri reads the public page and drafts the kit: name, palette, logo, tone.
+1. **Paste a website URL.** Scenri reads the public page and drafts the kit: name, palette, logo, tone.
 2. **Describe a shot.** In the composer, `$` reaches for a product, `@` for a presenter, `/` for a scene, and `#` for a colour. Everything between them is your own words. The composer compiles a brief you can inspect before it runs.
 3. **Generate on Codex CLI.** Runs on your own ChatGPT plan, so there is no key and no per-image charge from us.
 4. **Branch an edit** from any shot, then hit compare. The heatmap shows what moved.
@@ -91,7 +95,7 @@ pnpm dev          # starts the server on 127.0.0.1:4747
 - **Iteration is the product.** A version tree, not a prompt box. Branch, compare, keep the winners.
 - **Your brands are files, not hostages.** `.brand` is an open, documented format under a permissive license. Email one to a client. Any tool can adopt it.
 - **Your AI, your cost.** Bring your own Codex CLI session or an API key. Experiments cost raw API price, or nothing at all on a local session. No credits that burn on a miss.
-- **Local first, and it means it.** No account, no telemetry, no upload. The server binds to your machine only. scenri makes exactly two requests on its own behalf: a daily version-number check against npm so updates can announce themselves, and a one-time download of the library imagery archive, cached locally forever after. Nothing about you or your work is ever sent, and both turn off: in Settings or `SCENRI_NO_UPDATE_CHECK=1` for the first, `SCENRI_NO_CONTENT_FETCH=1` for the second ([how updates work](docs/updates.md)).
+- **Local first, and it means it.** No account, no telemetry, no upload. The server binds to your machine only. Scenri makes exactly two requests on its own behalf: a daily version-number check against npm so updates can announce themselves, and a one-time download of the library imagery archive, cached locally forever after. Nothing about you or your work is ever sent, and both turn off: in Settings or `SCENRI_NO_UPDATE_CHECK=1` for the first, `SCENRI_NO_CONTENT_FETCH=1` for the second ([how updates work](docs/updates.md)).
 
 ## Engines
 
@@ -104,13 +108,13 @@ pnpm dev          # starts the server on 127.0.0.1:4747
 
 Codex CLI is the default because it needs no key and because it carries the most reference images: a shot that has to keep both a product and a person accurate needs the room.
 
-It is not free. Every ChatGPT plan comes with some Codex usage and each image spends a little of it. OpenAI meters that, not scenri, so spend caps do not apply to this engine.
+It is not free. Every ChatGPT plan comes with some Codex usage and each image spends a little of it. OpenAI meters that, not Scenri, so spend caps do not apply to this engine.
 
-**Without a ChatGPT plan**, use your own provider key. OpenRouter is the one to pick if your shots name a Product or a Presenter. Replicate and fal take no reference images, so scenri refuses those briefs on them rather than generating something that only looks right.
+**Without a ChatGPT plan**, use your own provider key. OpenRouter is the one to pick if your shots name a Product or a Presenter. Replicate and fal take no reference images, so Scenri refuses those briefs on them rather than generating something that only looks right.
 
 Keys are stored in your local library folder, sent only to that provider, and never returned by the API. Set a monthly spend cap per engine in Settings.
 
-Your Codex session is yours: scenri runs the official `codex` commands on your machine and never reads, copies or stores the credential. That is also why scenri never pools user plans: a plan is licensed to the person who pays for it, not to a service reselling it to other people. Any hosted version of scenri, if one ever exists, would run API-priced engines only.
+Your Codex session is yours: Scenri runs the official `codex` commands on your machine and never reads, copies or stores the credential. That is also why Scenri never pools user plans: a plan is licensed to the person who pays for it, not to a service reselling it to other people. Any hosted version of Scenri, if one ever exists, would run API-priced engines only.
 
 ## Configuration
 
@@ -127,7 +131,7 @@ Your Codex session is yours: scenri runs the official `codex` commands on your m
 
 `OPENROUTER_API_KEY`, `REPLICATE_API_TOKEN` and `FAL_KEY` are read from the environment as an alternative to entering them in Settings.
 
-**Before you change `SCENRI_HOST`:** scenri has no accounts, so anyone who can reach the port can spend your API keys and delete your library. Setting `SCENRI_HOST=0.0.0.0` opens it to your local network so you can use it from a phone. That path prints a URL carrying a one-time access token, refuses every request without it, and rejects unfamiliar `Host` headers. Treat it as convenience on a network you trust, not as a security boundary.
+**Before you change `SCENRI_HOST`:** Scenri has no accounts, so anyone who can reach the port can spend your API keys and delete your library. Setting `SCENRI_HOST=0.0.0.0` opens it to your local network so you can use it from a phone. That path prints a URL carrying a one-time access token, refuses every request without it, and rejects unfamiliar `Host` headers. Treat it as convenience on a network you trust, not as a security boundary.
 
 ## Layout
 
@@ -158,7 +162,7 @@ Early. The version is `0.x` and interfaces can still move. Everything documented
 
 The application is [AGPL-3.0-only](LICENSE). The `.brand` format, its schema, and its validator live in [packages/brand-spec](https://github.com/tonygorb/scenri/tree/main/packages/brand-spec) under Apache-2.0, so any tool may implement or reuse them without taking on copyleft; the npm package carries that license text as `LICENSE-APACHE-2.0-brand-spec`. Contributions require a [CLA](CLA.md).
 
-The bundled imagery and curated content are licensed separately under [ASSETS-LICENSE.md](docs/ASSETS-LICENSE.md): free to use within scenri, commercial work included; no redistribution or rebundling. The npm package's `license` field describes the code; the starter imagery inside it stays under those asset terms.
+The bundled imagery and curated content are licensed separately under [ASSETS-LICENSE.md](docs/ASSETS-LICENSE.md): free to use within Scenri, commercial work included; no redistribution or rebundling. The npm package's `license` field describes the code; the starter imagery inside it stays under those asset terms.
 
 The name and the mark are not part of the code license: [TRADEMARKS.md](TRADEMARKS.md) says what a fork may and may not call itself. What the app does and does not send anywhere is written down in [PRIVACY.md](PRIVACY.md).
 

package/dist/{chunk-VE675PSG.js → chunk-GA7P7K2M.js}

@@ -202,5 +202,5 @@ async function stageVersion(deps) {
 }
 
 export { classify, createUpdateChecker, fetchDistTagLatest, findNpm, stageVersion };
-//# sourceMappingURL=chunk-VE675PSG.js.map
-//# sourceMappingURL=chunk-VE675PSG.js.map
+//# sourceMappingURL=chunk-GA7P7K2M.js.map
+//# sourceMappingURL=chunk-GA7P7K2M.js.map

package/dist/chunk-WGIZJXNE.js

@@ -0,0 +1,36 @@
+// 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"];
+function portBusyLines(port) {
+  const next = port + 1;
+  return [
+    `Port ${port} is in use by another app.`,
+    "Start Scenri on a different port:",
+    `  macOS or Linux:      SCENRI_PORT=${next} npx scenri`,
+    `  Windows PowerShell:  $env:SCENRI_PORT=${next}; npx scenri`
+  ];
+}
+function bootErrorLines(err) {
+  const raw = err instanceof Error ? err.message : String(err);
+  const first = raw.split("\n")[0];
+  const code = err?.code;
+  const haystack = `${typeof code === "string" ? code : ""} ${raw}`;
+  if (NATIVE_MARKERS.some((marker) => haystack.includes(marker))) {
+    return [
+      "Scenri could not start: a native component failed to load.",
+      `(${first})`,
+      "This usually means Node changed since this copy of Scenri was installed.",
+      "Fix: install the current Node LTS from https://nodejs.org, then run npx scenri@latest."
+    ];
+  }
+  return [
+    `Scenri could not start: ${first}`,
+    "If this keeps happening, run npx scenri@latest, or see the install guide:",
+    INSTALL_GUIDE,
+    "Set SCENRI_DEBUG=1 to see the full error."
+  ];
+}
+
+export { bootErrorLines, portBusyLines };
+//# sourceMappingURL=chunk-WGIZJXNE.js.map
+//# sourceMappingURL=chunk-WGIZJXNE.js.map

package/dist/{cli-JVN6MY72.js → cli-GQLRYYGU.js}

@@ -1,4 +1,4 @@
-import { stageVersion, fetchDistTagLatest, findNpm } from './chunk-VE675PSG.js';
+import { stageVersion, fetchDistTagLatest, findNpm } from './chunk-GA7P7K2M.js';
 import { readMeta } from './chunk-Y3ZPBPLP.js';
 import { defaultHome, newestStaged, compareSemver } from './chunk-4MAFHYAD.js';
 
@@ -34,7 +34,7 @@ async function runUpdateCommand(opts) {
   const effective = staged && compareSemver(staged, meta.version) > 0 ? staged : meta.version;
   console.log(`  running ${meta.version}${staged ? ` \xB7 staged ${staged}` : ""} \xB7 latest ${latest}`);
   if (compareSemver(latest, effective) <= 0) {
-    console.log(staged ? "  the newest version is already staged. Just start scenri." : "  already the newest.");
+    console.log(staged ? "  the newest version is already staged. Just start Scenri." : "  already the newest.");
     return 0;
   }
   if (opts.check) {
@@ -62,5 +62,5 @@ async function runUpdateCommand(opts) {
 }
 
 export { runUpdateCommand };
-//# sourceMappingURL=cli-JVN6MY72.js.map
-//# sourceMappingURL=cli-JVN6MY72.js.map
+//# sourceMappingURL=cli-GQLRYYGU.js.map
+//# sourceMappingURL=cli-GQLRYYGU.js.map

package/dist/index.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { bootErrorLines } from './chunk-WGIZJXNE.js';
+
 // src/args.ts
 function parseArgs(argv) {
   const [first, ...rest] = argv;
@@ -23,10 +25,10 @@ function parseArgs(argv) {
   return { cmd: "error", message: `unknown command '${first}' (try --help)` };
 }
 function helpText() {
-  return `scenri: local brand studio
+  return `Scenri: local brand studio
 
 Usage
-  scenri                start scenri (auto-restarts after updates)
+  scenri                start Scenri (auto-restarts after updates)
   scenri serve          start this exact build, no supervision
   scenri update         download and stage the newest version
     --check             only check, do not download
@@ -41,43 +43,51 @@ SCENRI_CONTENT_URL.
 
 // src/index.ts
 var command = parseArgs(process.argv.slice(2));
-switch (command.cmd) {
-  case "version": {
-    const { readMeta } = await import('./meta-MPQPBPBK.js');
-    console.log(readMeta().version);
-    break;
-  }
-  case "help":
-    console.log(helpText());
-    break;
-  case "error":
-    console.error(command.message);
-    process.exit(2);
-    break;
-  case "verify":
-    await (await import('./serve.js')).verify();
-    break;
-  case "serve":
-    await (await import('./serve.js')).serve();
-    break;
-  case "update": {
-    const { runUpdateCommand } = await import('./cli-JVN6MY72.js');
-    process.exit(await runUpdateCommand(command));
-    break;
-  }
-  case "launch": {
-    const ownEntry = process.argv[1] ?? "";
-    if (!/[\\/]dist[\\/]/.test(ownEntry)) {
+try {
+  switch (command.cmd) {
+    case "version": {
+      const { readMeta } = await import('./meta-MPQPBPBK.js');
+      console.log(readMeta().version);
+      break;
+    }
+    case "help":
+      console.log(helpText());
+      break;
+    case "error":
+      console.error(command.message);
+      process.exit(2);
+      break;
+    case "verify":
+      await (await import('./serve.js')).verify();
+      break;
+    case "serve":
       await (await import('./serve.js')).serve();
       break;
+    case "update": {
+      const { runUpdateCommand } = await import('./cli-GQLRYYGU.js');
+      process.exit(await runUpdateCommand(command));
+      break;
+    }
+    case "launch": {
+      const ownEntry = process.argv[1] ?? "";
+      if (!/[\\/]dist[\\/]/.test(ownEntry)) {
+        await (await import('./serve.js')).serve();
+        break;
+      }
+      const { runLauncher } = await import('./launcher-RETYUGSR.js');
+      const { readMeta } = await import('./meta-MPQPBPBK.js');
+      const { defaultHome } = await import('./versionsDir-ILQ4CI7B.js');
+      const meta = readMeta();
+      process.exit(await runLauncher({ home: defaultHome(), pkg: meta.name, ownVersion: meta.version, ownEntry }));
+      break;
     }
-    const { runLauncher } = await import('./launcher-YT5KSSTN.js');
-    const { readMeta } = await import('./meta-MPQPBPBK.js');
-    const { defaultHome } = await import('./versionsDir-ILQ4CI7B.js');
-    const meta = readMeta();
-    process.exit(await runLauncher({ home: defaultHome(), pkg: meta.name, ownVersion: meta.version, ownEntry }));
-    break;
   }
+} catch (err) {
+  if (process.env.SCENRI_DEBUG === "1") throw err;
+  console.error("");
+  for (const line of bootErrorLines(err)) console.error(`  ${line}`);
+  console.error("");
+  process.exit(1);
 }
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{launcher-YT5KSSTN.js → launcher-RETYUGSR.js}

@@ -31,7 +31,7 @@ async function runLauncher(deps) {
     starts.push(startedAt);
     while (starts.length > 0 && startedAt - starts[0] > LOOP_WINDOW_MS) starts.shift();
     if (starts.length > LOOP_MAX_STARTS) {
-      log("  scenri is restarting in a loop and has stopped trying.");
+      log("  Scenri is restarting in a loop and has stopped trying.");
       log("  Recover with:  rm -rf ~/.scenri/app   (app versions only, your library is untouched)");
       log("  then start fresh:  npx scenri@latest");
       return 1;
@@ -51,7 +51,7 @@ async function runLauncher(deps) {
     if (signalled) return code ?? 0;
     if (code === RESTART_EXIT_CODE) continue;
     if (code !== 0 && useStaged && now() - startedAt < QUICK_DEATH_MS) {
-      log(`  scenri ${staged} failed to start. Falling back to ${deps.ownVersion}.`);
+      log(`  Scenri ${staged} failed to start. Falling back to ${deps.ownVersion}.`);
       log("  If this keeps happening:  rm -rf ~/.scenri/app");
       distrustStaged = true;
       continue;
@@ -61,5 +61,5 @@ async function runLauncher(deps) {
 }
 
 export { LAUNCHER_PROTOCOL, RESTART_EXIT_CODE, runLauncher };
-//# sourceMappingURL=launcher-YT5KSSTN.js.map
-//# sourceMappingURL=launcher-YT5KSSTN.js.map
+//# sourceMappingURL=launcher-RETYUGSR.js.map
+//# sourceMappingURL=launcher-RETYUGSR.js.map

package/dist/serve.js

@@ -1,4 +1,5 @@
-import { createUpdateChecker, classify, stageVersion, findNpm } from './chunk-VE675PSG.js';
+import { portBusyLines } from './chunk-WGIZJXNE.js';
+import { createUpdateChecker, classify, stageVersion, findNpm } from './chunk-GA7P7K2M.js';
 import { readMeta, repoSlug } from './chunk-Y3ZPBPLP.js';
 import { newestStaged, compareSemver } from './chunk-4MAFHYAD.js';
 import { networkInterfaces, homedir, tmpdir } from 'os';
@@ -297,7 +298,7 @@ var SCHEMA_VERSION = 1;
 var SchemaTooNewError = class extends Error {
   constructor(found, supported) {
     super(
-      `This library was written by a newer scenri (schema ${found}; this build understands ${supported}). Update and retry: npx scenri@latest`
+      `This library was written by a newer Scenri (schema ${found}; this build understands ${supported}). Update and retry: npx scenri@latest`
     );
     this.name = "SchemaTooNewError";
   }
@@ -2149,7 +2150,7 @@ function createCodexSetup(opts = {}) {
             ok: false,
             fallbackCommand: INSTALL_COMMAND,
             docsUrl: INSTALL_DOCS_URL,
-            detail: "Codex installed but is not on this app\u2019s PATH yet. Restart scenri, or install it yourself."
+            detail: "Codex installed but is not on this app\u2019s PATH yet. Restart Scenri, or install it yourself."
           };
         }
         return { ok: true };
@@ -2308,7 +2309,7 @@ function createDemoEngine(saveImage) {
       <rect width="100%" height="100%" fill="url(#g)"/>
       <circle cx="${w * (0.25 + 0.5 * (seed * 37 % 100) / 100)}" cy="${h * 0.38}" r="${Math.min(w, h) * 0.18}" fill="#ffffff" opacity="0.25"/>
       <text x="24" y="${h - 48}" font-family="Helvetica, Arial" font-size="${Math.max(14, Math.round(w / 42))}" fill="#ffffff" opacity="0.92">${esc(label)}</text>
-      <text x="24" y="${h - 22}" font-family="Helvetica, Arial" font-size="12" fill="#ffffff" opacity="0.6">scenri demo engine</text>
+      <text x="24" y="${h - 22}" font-family="Helvetica, Arial" font-size="12" fill="#ffffff" opacity="0.6">Scenri demo engine</text>
     </svg>`;
     return sharp5(Buffer.from(svg)).png().toBuffer();
   }
@@ -2946,7 +2947,7 @@ function createContentFetcher(deps) {
     const root = contentCacheRoot(env);
     const staging = `${root}.staging`;
     if (!deps.store.getSetting("content.disclosed")) {
-      log("  fetching the scenri library (~95 MB, once, cached; set SCENRI_NO_CONTENT_FETCH=1 to disable)");
+      log("  fetching the Scenri library (~95 MB, once, cached; set SCENRI_NO_CONTENT_FETCH=1 to disable)");
       deps.store.setSetting("content.disclosed", "1");
     }
     try {
@@ -2982,7 +2983,7 @@ function createContentFetcher(deps) {
         deps.store.setSetting("content.version", String(meta.version ?? ""));
       } catch {
       }
-      log("  scenri library ready");
+      log("  Scenri library ready");
       return { ok: true, updated: true, error: null };
     } catch (err) {
       rmSync(staging, { recursive: true, force: true });
@@ -5900,11 +5901,11 @@ function registerAssetBuildRoutes(app, deps) {
       engineId: engine?.capabilities().id ?? null,
       engineName: engine?.capabilities().displayName ?? null,
       /**
-       * True when scenri cannot price this per image, because it is not billed
+       * True when Scenri cannot price this per image, because it is not billed
        * through a key we hold. NOT the same as costing the user nothing: the
        * local Codex engine spends the Codex allowance on their ChatGPT plan,
        * which only OpenAI can meter. Copy built on this flag must say "nothing
-       * billed through scenri", never "free".
+       * billed through Scenri", never "free".
        */
       free: engine ? await engine.costEstimate(COST_PROBE).catch(() => 0) <= 0 : true
     };
@@ -6514,6 +6515,31 @@ function registerImageRoutes(app, deps) {
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.3.1",
+    date: "2026-08-20",
+    sections: [
+      {
+        heading: "Fixes",
+        body: "Starting Scenri is calmer when something is wrong. A busy port or a failed start now explains itself in plain words instead of a stack trace, and the terminal says to keep its window open while Scenri runs."
+      }
+    ]
+  },
+  {
+    version: "0.3.0",
+    date: "2026-08-20",
+    title: "The name is Scenri.",
+    sections: [
+      {
+        heading: "The name",
+        body: "Written out, the product is Scenri. Every screen, every page of the documentation and every line the terminal prints now spells it that way. Lowercase stays where a machine reads it: the command you type, the folder your library lives in, and the settings that configure it are all unchanged."
+      },
+      {
+        heading: "Browser tabs",
+        body: "A tab now names what is open in it rather than the section it came from, so eight products in eight tabs read as eight product names. Settings and What's new say so, an open shot says Shot, and a tab whose page is still loading names its section instead of going blank."
+      }
+    ]
+  },
   {
     version: "0.2.3",
     date: "2026-08-20",
@@ -6700,7 +6726,7 @@ function registerUpdateRoutes(app, deps) {
     const apply = effectiveApply();
     if (apply.phase !== "ready") return reply.status(409).send({ error: "no staged update to restart into" });
     if (!runtime.supervised) {
-      return reply.status(409).send({ error: "not supervised; restart scenri yourself", blockReason: "unsupervised" });
+      return reply.status(409).send({ error: "not supervised; restart Scenri yourself", blockReason: "unsupervised" });
     }
     reply.send({ ok: true });
     const exit = deps.exitImpl ?? ((code) => process.exit(code));
@@ -7500,12 +7526,14 @@ async function run() {
           continue;
         }
         try {
-          const res = await fetch(`http://127.0.0.1:${PORT}/api/version`);
+          const res = await fetch(`http://127.0.0.1:${PORT}/api/version`, {
+            signal: AbortSignal.timeout(2e3)
+          });
           const info = await res.json();
           if (info.name === readMeta().name) {
             const url = `http://127.0.0.1:${PORT}`;
             console.log(`
-  scenri is already running \u2192 ${url}
+  Scenri is already running \u2192 ${url}
 `);
             if (process.env.SCENRI_NO_OPEN !== "1") {
               try {
@@ -7518,6 +7546,10 @@ async function run() {
           }
         } catch {
         }
+        console.error("");
+        for (const line of portBusyLines(PORT)) console.error(`  ${line}`);
+        console.error("");
+        process.exit(1);
       }
       throw err;
     }
@@ -7527,7 +7559,7 @@ async function run() {
     if (closing) return;
     closing = true;
     console.log(`
-  ${signal}: closing scenri\u2026`);
+  ${signal}: closing Scenri\u2026`);
     setTimeout(() => process.exit(1), 5e3).unref();
     app.drain().then(() => process.exit(0)).catch(() => process.exit(1));
   };
@@ -7538,10 +7570,10 @@ async function run() {
   const query = token ? `/?t=${token}` : "";
   const localUrl = `http://127.0.0.1:${PORT}${query}`;
   console.log(`
-  scenri studio \u2192 ${localUrl}`);
+  Scenri Studio \u2192 ${localUrl}`);
   for (const ip of reachableAt) console.log(`  on your network \u2192 http://${ip}:${PORT}${query}`);
-  console.log(`  data dir        \u2192 ${core.home}
-`);
+  console.log(`  data dir        \u2192 ${core.home}`);
+  console.log("  Keep this window open while Scenri is running.\n");
   if (!studioDist) console.log("  (studio UI not built, API only. Run: pnpm build)\n");
   if (token) {
     console.log("  Warning: the studio is reachable from your network.");
@@ -7551,10 +7583,22 @@ async function run() {
     console.log("  For this machine only, unset SCENRI_HOST.\n");
   }
   if (process.env.SCENRI_NO_OPEN !== "1") {
+    let told = false;
+    const tellUrl = () => {
+      if (told) return;
+      told = true;
+      console.log(`  Open ${localUrl} in your browser.
+`);
+    };
     try {
       const { default: open } = await import('open');
-      await open(localUrl);
+      const child = await open(localUrl);
+      child.once("error", tellUrl);
+      child.once("exit", (openExit) => {
+        if (openExit !== null && openExit !== 0) tellUrl();
+      });
     } catch {
+      tellUrl();
     }
   }
 }

package/package.json

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