scenri 0.3.2 → 0.3.4

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.3.4](https://github.com/tonygorb/Scenri/compare/v0.3.3...v0.3.4) (2026-08-20)
+
+
+### Bug Fixes
+
+* presenter references are identity, not wardrobe ([dc372fd](https://github.com/tonygorb/Scenri/commit/dc372fd40d7e15d7d8dc72b5ec8f41993e078ae9))
+* presenter references are identity, not wardrobe ([c8bca43](https://github.com/tonygorb/Scenri/commit/c8bca431730a2d4c41d2783fb6eba2c564af5141))
+* stop custom presenter and scene pages freezing the whole app ([fcf88dd](https://github.com/tonygorb/Scenri/commit/fcf88ddbcd57d01354c833cf9f8456fa1b0b0434))
+* stop custom presenter and scene pages freezing the whole app ([8595078](https://github.com/tonygorb/Scenri/commit/859507893892cb23a7ff2f132f273db4dbd0a0f9))
+
+## [0.3.3](https://github.com/tonygorb/Scenri/compare/v0.3.2...v0.3.3) (2026-08-20)
+
+
+### Bug Fixes
+
+* absolute README links so they survive the npm package page ([c8b2cd0](https://github.com/tonygorb/Scenri/commit/c8b2cd04e6f4a2e6be9e7470b970c2d5033d60d4))
+* absolute README links so they survive the npm package page ([16219cf](https://github.com/tonygorb/Scenri/commit/16219cf848279f58ab2d1e0db46e5f3efffeb388))
+
 ## [0.3.2](https://github.com/tonygorb/scenri/compare/v0.3.1...v0.3.2) (2026-08-20)
 
 

package/README.md

@@ -11,7 +11,7 @@ Define a client's brand once. Then generate, branch, and art-direct on-brand ima
 
 [![CI](https://github.com/tonygorb/scenri/actions/workflows/ci.yml/badge.svg)](https://github.com/tonygorb/scenri/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/scenri)](https://www.npmjs.com/package/scenri)
-[![License: AGPL v3](https://img.shields.io/badge/license-AGPL--3.0-blue)](LICENSE)
+[![License: AGPL v3](https://img.shields.io/badge/license-AGPL--3.0-blue)](https://github.com/tonygorb/scenri/blob/main/LICENSE)
 
 **Get started:** one command, no account.
 
@@ -19,7 +19,7 @@ Define a client's brand once. Then generate, branch, and art-direct on-brand ima
 npx scenri
 ```
 
-<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>
+<sub>Needs [Node.js](https://nodejs.org) 22 or newer. New to any of this? The [install guide](https://github.com/tonygorb/scenri/blob/main/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">
 
@@ -57,7 +57,7 @@ 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:
+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](https://github.com/tonygorb/scenri/blob/main/docs/INSTALL.md)** covers every step for macOS, Windows and Linux. With Node in place:
 
 ```bash
 npx scenri
@@ -67,7 +67,7 @@ That is the whole install. npm asks once whether to proceed, downloads the curre
 
 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](docs/INSTALL.md#troubleshooting).
+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).
 
 <details>
 <summary>Run from source</summary>
@@ -95,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](https://github.com/tonygorb/scenri/blob/main/docs/updates.md)).
 
 ## Engines
 
@@ -148,23 +148,23 @@ One package publishes to npm: **`scenri`**, the CLI, which bundles everything el
 
 ## Contributing
 
-Start with [CONTRIBUTING.md](CONTRIBUTING.md). Engine adapters are the friendliest surface: one file, one interface, well covered by tests.
+Start with [CONTRIBUTING.md](https://github.com/tonygorb/scenri/blob/main/CONTRIBUTING.md). Engine adapters are the friendliest surface: one file, one interface, well covered by tests.
 
-Accessibility is tracked in [docs/A11Y-BACKLOG.md](docs/A11Y-BACKLOG.md). Every Biome a11y rule runs at `error`, so the backlog is currently empty and a new defect fails CI rather than joining a list.
+Accessibility is tracked in [docs/A11Y-BACKLOG.md](https://github.com/tonygorb/scenri/blob/main/docs/A11Y-BACKLOG.md). Every Biome a11y rule runs at `error`, so the backlog is currently empty and a new defect fails CI rather than joining a list.
 
-Found a security problem? Please report it privately. See [SECURITY.md](SECURITY.md).
+Found a security problem? Please report it privately. See [SECURITY.md](https://github.com/tonygorb/scenri/blob/main/SECURITY.md).
 
 ## Status
 
-Early. The version is `0.x` and interfaces can still move. Everything documented above works today. [ROADMAP.md](ROADMAP.md) says what is next.
+Early. The version is `0.x` and interfaces can still move. Everything documented above works today. [ROADMAP.md](https://github.com/tonygorb/scenri/blob/main/ROADMAP.md) says what is next.
 
 ## License
 
-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 application is [AGPL-3.0-only](https://github.com/tonygorb/scenri/blob/main/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](https://github.com/tonygorb/scenri/blob/main/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](https://github.com/tonygorb/scenri/blob/main/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).
+The name and the mark are not part of the code license: [TRADEMARKS.md](https://github.com/tonygorb/scenri/blob/main/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](https://github.com/tonygorb/scenri/blob/main/PRIVACY.md).
 
 ---
 

package/dist/serve.js

@@ -1271,7 +1271,7 @@ function createCatalogStore(db) {
 // ../core/src/engine.ts
 var REFERENCE_ROLE_DIRECTIVE = {
   product: "the exact product \u2014 preserve its label, shape, colors and design faithfully; do not redesign it",
-  character: "the exact person \u2014 preserve their face, hair and build faithfully; do not restyle them",
+  character: "the exact person \u2014 match their face, facial structure, skin, hair and build exactly; their clothing, pose and background are capture context, not styling to reproduce",
   brand: "the brand's own mark \u2014 if the direction calls for the mark to appear, reproduce it exactly as drawn, same colours, letterforms and proportions; otherwise take only its colour and treatment, and never its subject, geometry or composition",
   scene: "a reference for the environment and light only \u2014 take no subject, product or person from it",
   composition: "a reference for framing, camera angle and pose only \u2014 take no subject, color, material or branding from it",
@@ -1280,7 +1280,7 @@ var REFERENCE_ROLE_DIRECTIVE = {
 };
 var EDIT_REFERENCE_ROLE_DIRECTIVE = {
   product: "the exact product: keep or restore its label, shape and design faithfully",
-  character: "the exact person: keep their face, hair and build faithfully",
+  character: "the exact person: keep their face, facial structure, skin, hair and build faithfully; take no clothing, pose or background from this reference, and keep the source image's existing outfit unless the instruction changes it",
   brand: "the brand's own mark: reproduce it exactly as drawn wherever it appears, never redrawn or re-lettered",
   scene: "a reference for environment and light only",
   composition: "a reference for framing and pose only",
@@ -1944,6 +1944,9 @@ function createRunner(opts = {}) {
     });
   }
   async function probe() {
+    if (process.env.SCENRI_NO_CODEX === "1") {
+      return { ok: false, reason: NOT_INSTALLED_REASON, code: "not-installed" };
+    }
     if (!await exitedZero(["--version"])) {
       return { ok: false, reason: NOT_INSTALLED_REASON, code: "not-installed" };
     }
@@ -2487,7 +2490,14 @@ async function resolvePresenterImages(core, templatesRoot, presenter) {
     const hash = core.images.save(png);
     shots.push({ file: `asset:${hash}`, angle, locked: true });
   }
-  return shots.length ? { id: presenter.id, name: presenter.name, shots } : null;
+  if (!shots.length) return null;
+  return {
+    id: presenter.id,
+    name: presenter.name,
+    ...presenter.identityNotes ? { identityNotes: presenter.identityNotes } : {},
+    ...presenter.negativeConstraints?.length ? { negativeConstraints: presenter.negativeConstraints } : {},
+    shots
+  };
 }
 async function brandJsonWithResolvedPresenters(core, templatesRoot, presenters, brandJson, tokens) {
   const existing = brandJson?.characters ?? [];
@@ -2793,7 +2803,7 @@ function compileBrief(brief, ctx) {
             attachments.push({ role: "character", id: c.id, label: c.name, hash: chash, essential: i === 0 });
           });
           personDirectives.push(
-            "The attached person reference is the same person every time: hold their face, hair and build, and do not restyle them."
+            "The attached person reference is the same person every time: match their face, facial structure, skin, hair and build exactly. Their outfit, pose, background and lighting are neutral studio capture conditions, not styling direction: dress and style them for this shot, to a commercial standard, following any wardrobe the direction itself specifies."
           );
           if (c.identityNotes) personDirectives.push(String(c.identityNotes));
           if (c.negativeConstraints?.length)
@@ -2891,10 +2901,14 @@ function compileBrief(brief, ctx) {
   const sceneCamera = inlineTemplates[0]?.camera?.trim() || ctx.template?.camera?.trim() || "";
   const cameraDirectives = sceneCamera && !shotSpecifiesCamera(sentence) ? [`Camera for this shot: ${sceneCamera}`] : [];
   const guard = scene ? sceneGuardDirectives({ hasProduct: !!productId, hasPerson }) : [];
+  const pairDirectives = productId && hasPerson ? [
+    "If the attached product is something a person wears, the presenter wears that exact product, with the rest of the outfit styled around it; otherwise the presenter presents or uses the product naturally."
+  ] : [];
   const brandLines = brandRuleDirectives(ctx.brand);
   const allDirectives = [
     ...productDirectives,
     ...personDirectives,
+    ...pairDirectives,
     ...otherDirectives,
     ...cameraDirectives,
     ...brandLines,
@@ -6524,6 +6538,27 @@ function registerImageRoutes(app, deps) {
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.3.4",
+    date: "2026-08-21",
+    sections: [
+      {
+        heading: "Presenters",
+        body: "A presenter's reference photos now define who they are, not what they wear. The neutral studio outfit from their reference set no longer follows them into finished shots; wardrobe comes from the shot, the product and the scene instead, and refining an image keeps the outfit it already has."
+      },
+      {
+        heading: "Fixes",
+        body: "Opening a presenter or scene you built yourself no longer freezes the app."
+      }
+    ]
+  },
+  {
+    version: "0.3.3",
+    date: "2026-08-20",
+    // Documentation only: the links on the npm package page were resolving
+    // against the package folder and 404ing. Nothing inside the app changed.
+    sections: []
+  },
   {
     version: "0.3.2",
     date: "2026-08-20",

package/package.json

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