scenri 0.19.1 → 0.20.1

package/dist/serve.js

@@ -1,14 +1,14 @@
-import { createUpdateChecker, classify, findNpm, isReleaseTriplet, stageVersion } from './chunk-YK37H6DM.js';
+import { createUpdateChecker, classify, isReleaseTriplet, findNpm, stageVersion } from './chunk-YK37H6DM.js';
 import { shouldAdoptRunning, anotherScenriLines, portBusyLines } from './chunk-CMLJGPYC.js';
-import { SchemaTooNewError, createCore, BUDGET_EXHAUSTED, SpendCapError, EDIT_REFERENCE_ROLE_DIRECTIVE, REFERENCE_ROLE_DIRECTIVE, ratioLabel, searchTerms, nameMatches, budgetSize, SCHEMA_VERSION, ASPECT_TOLERANCE } from './chunk-4PJPJGGP.js';
+import { SchemaTooNewError, defaultHome, createCore, BUDGET_EXHAUSTED, SpendCapError, EDIT_REFERENCE_ROLE_DIRECTIVE, REFERENCE_ROLE_DIRECTIVE, ratioLabel, searchTerms, nameMatches, budgetSize, SCHEMA_VERSION, ASPECT_TOLERANCE } from './chunk-YNL3WQOL.js';
 import { detectInstallKind } from './chunk-PAIAXRAC.js';
 export { detectInstallKind } from './chunk-PAIAXRAC.js';
 import { readMeta, repoSlug } from './chunk-Y3ZPBPLP.js';
 import { compareSemver, newestStaged } from './chunk-4MAFHYAD.js';
 import { powershellPath, PS_UTF8 } from './chunk-2IGINCPU.js';
-import { dirname, join, normalize, basename } from 'path';
+import { dirname, join, basename, normalize } from 'path';
 import { fileURLToPath } from 'url';
-import fs, { existsSync, readFileSync, mkdirSync, createReadStream, rmSync, readdirSync, statSync, renameSync, lstatSync, unlinkSync } from 'fs';
+import fs, { existsSync, readdirSync, readFileSync, mkdirSync, createReadStream, rmSync, statSync, renameSync, lstatSync, unlinkSync } from 'fs';
 import { homedir, tmpdir, networkInterfaces } from 'os';
 import { readFile, stat, copyFile, lstat, readdir, mkdtemp, rm, access, rmdir, rename, unlink, writeFile } from 'fs/promises';
 import { spawn, execFile } from 'child_process';
@@ -229,14 +229,24 @@ var DEFAULT_MODEL2 = "black-forest-labs/flux-schnell";
 var DEFAULT_EDIT_MODEL = "black-forest-labs/flux-kontext-pro";
 var DEFAULT_EXPAND_MODEL = "bria/expand-image";
 var DEFAULT_POLL_INTERVAL_MS = 1500;
-var DEFAULT_TIMEOUT_MS = 12e4;
+var DEFAULT_TIMEOUT_MS = 6e5;
+var MIN_CANCEL_AFTER_S = 5;
+var CANCEL_TIMEOUT_MS = 5e3;
 var GENERATE_COST_PER_IMAGE_USD = 3e-3;
 var EDIT_COST_USD = 0.04;
 function nearestAspectRatio(width, height) {
   const candidates = [
     ["1:1", 1],
     ["16:9", 16 / 9],
-    ["9:16", 9 / 16]
+    ["21:9", 21 / 9],
+    ["3:2", 3 / 2],
+    ["2:3", 2 / 3],
+    ["4:5", 4 / 5],
+    ["5:4", 5 / 4],
+    ["3:4", 3 / 4],
+    ["4:3", 4 / 3],
+    ["9:16", 9 / 16],
+    ["9:21", 9 / 21]
   ];
   const ratio = width / height;
   let best = candidates[0];
@@ -307,7 +317,12 @@ function createReplicateEngine(opts) {
       headers: {
         Authorization: `Bearer ${key}`,
         "Content-Type": "application/json",
-        Prefer: "wait"
+        Prefer: "wait",
+        // Replicate's own copy of the ceiling, measured from creation, so a
+        // prediction nobody here can cancel any more (the app quit, or a Stop
+        // landed while this request was still open and no id had come back)
+        // still stops running, and billing, on its own.
+        "Cancel-After": `${Math.max(MIN_CANCEL_AFTER_S, Math.ceil(timeoutMs / 1e3))}s`
       },
       body: JSON.stringify({ input }),
       signal
@@ -315,6 +330,18 @@ function createReplicateEngine(opts) {
     if (!res.ok) throw await httpError(res, "prediction create");
     return asPrediction(await res.json(), "prediction create");
   }
+  async function cancelPrediction(key, prediction) {
+    const url = typeof prediction.urls?.cancel === "string" ? prediction.urls.cancel : typeof prediction.id === "string" ? `${API_BASE}/predictions/${prediction.id}/cancel` : null;
+    if (!url) return;
+    try {
+      await fetchImpl(url, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${key}` },
+        signal: AbortSignal.timeout(CANCEL_TIMEOUT_MS)
+      });
+    } catch {
+    }
+  }
   async function waitForCompletion(key, initial, signal) {
     let prediction = initial;
     if (prediction.status === "succeeded") return prediction;
@@ -327,26 +354,34 @@ function createReplicateEngine(opts) {
     }
     const getUrl = prediction.urls?.get;
     if (typeof getUrl !== "string" || getUrl.length === 0) {
+      await cancelPrediction(key, prediction);
       throw new Error(
         `Replicate prediction did not succeed (status: ${prediction.status ?? "unknown"}) and no polling URL was provided`
       );
     }
     const deadline = Date.now() + timeoutMs;
-    for (; ; ) {
-      if (Date.now() >= deadline) {
-        throw new Error(`Replicate prediction timed out after ${timeoutMs}ms`);
+    try {
+      for (; ; ) {
+        if (Date.now() >= deadline) {
+          throw new Error(`Replicate prediction timed out after ${timeoutMs}ms`);
+        }
+        await sleep(pollIntervalMs, signal);
+        const res = await fetchImpl(getUrl, {
+          headers: { Authorization: `Bearer ${key}` },
+          signal
+        });
+        if (!res.ok) throw await httpError(res, "prediction poll");
+        prediction = asPrediction(await res.json(), "prediction poll");
+        if (prediction.status === "succeeded") return prediction;
+        if (prediction.status === "failed" || prediction.status === "canceled") {
+          throw failureError(prediction);
+        }
       }
-      await sleep(pollIntervalMs, signal);
-      const res = await fetchImpl(getUrl, {
-        headers: { Authorization: `Bearer ${key}` },
-        signal
-      });
-      if (!res.ok) throw await httpError(res, "prediction poll");
-      prediction = asPrediction(await res.json(), "prediction poll");
-      if (prediction.status === "succeeded") return prediction;
-      if (prediction.status === "failed" || prediction.status === "canceled") {
-        throw failureError(prediction);
+    } catch (err) {
+      if (prediction.status !== "failed" && prediction.status !== "canceled") {
+        await cancelPrediction(key, initial);
       }
+      throw err;
     }
   }
   async function downloadOutputs(prediction, signal) {
@@ -387,8 +422,8 @@ function createReplicateEngine(opts) {
         // bria/expand-image: the picture plus the canvas it belongs in.
         supportsOutpaint: true,
         // 0, deliberately — see the same note in the fal adapter. generate()
-        // sends only prompt/num_outputs/aspect_ratio, so a declared capacity
-        // of 1 was a promise this adapter never kept.
+        // sends no reference image, only its prompt and settings, so a
+        // declared capacity of 1 was a promise this adapter never kept.
         maxReferenceImages: 0
       };
     },
@@ -409,7 +444,13 @@ function createReplicateEngine(opts) {
         {
           prompt: req.prompt,
           num_outputs: req.count,
-          aspect_ratio: nearestAspectRatio(req.width, req.height)
+          aspect_ratio: nearestAspectRatio(req.width, req.height),
+          // Left alone, flux-schnell answers in webp at quality 80: a lossy
+          // frame the server then re-encodes to png anyway. A png arrives as
+          // delivered. The edit models need no such line: kontext-pro already
+          // answers in png, and bria's expander has no format field. The
+          // generate input assumes the flux-schnell schema, as aspect_ratio does.
+          output_format: "png"
         },
         signal
       );
@@ -490,24 +531,41 @@ async function sourceImageToDataUri(source) {
   const buf = await readFile(source);
   return `data:${mimeForPath(source)};base64,${buf.toString("base64")}`;
 }
-function extractImageUrls(json) {
+function readReply(json) {
   if (typeof json !== "object" || json === null) {
     throw new Error("fal.ai response was not a JSON object");
   }
-  const images = json.images;
+  const reply = json;
+  if (!Array.isArray(reply.images) && typeof reply.image === "object" && reply.image !== null) {
+    const url = reply.image.url;
+    if (typeof url !== "string" || url.length === 0) {
+      throw new Error('fal.ai response image missing "url"');
+    }
+    return { urls: [url], slots: [0] };
+  }
+  const images = reply.images;
   if (!Array.isArray(images)) {
-    throw new Error('fal.ai response missing "images" array');
+    throw new Error('fal.ai response missing "images" array or "image" object');
   }
   if (images.length === 0) {
     throw new Error("fal.ai response contained no images");
   }
-  return images.map((img, i) => {
+  const urls = images.map((img, i) => {
     const url = img?.url;
     if (typeof url !== "string" || url.length === 0) {
       throw new Error(`fal.ai response images[${i}] missing "url"`);
     }
     return url;
   });
+  const flagged = Array.isArray(reply.has_nsfw_concepts) ? reply.has_nsfw_concepts : [];
+  const slots = urls.map((_, i) => i).filter((i) => flagged[i] !== true);
+  if (slots.length === 0) {
+    throw new Error("fal.ai flagged every image as unsafe and returned only black frames, so none were kept");
+  }
+  return { urls: slots.map((i) => urls[i]), slots };
+}
+function extractImageUrls(json) {
+  return readReply(json).urls;
 }
 function createFalEngine(opts) {
   const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
@@ -600,13 +658,31 @@ function createFalEngine(opts) {
         {
           prompt: req.prompt,
           image_size: { width: req.width, height: req.height },
-          num_images: req.count
+          num_images: req.count,
+          // fal defaults to jpeg. png costs nothing extra, and a shot that
+          // may be refined or extended later should not start out lossy.
+          output_format: "png"
         },
         signal
       );
-      const urls = extractImageUrls(json);
+      const { urls, slots } = readReply(json);
       const images = await saveAll(urls, signal);
-      return { images, costUsd: req.count * GENERATE_COST_PER_IMAGE_USD2, raw: json };
+      const costUsd = req.count * GENERATE_COST_PER_IMAGE_USD2;
+      if (slots.length === req.count) return { images, costUsd, raw: json };
+      const dropped = req.count - slots.length;
+      return {
+        images,
+        costUsd,
+        raw: {
+          ...json,
+          requested: req.count,
+          variantIndexes: slots,
+          partialFailures: Array.from(
+            { length: dropped },
+            () => "fal.ai flagged this image as unsafe and returned a black frame, so it was not kept"
+          )
+        }
+      };
     },
     async edit(req, signal) {
       const key = requireKey();
@@ -631,7 +707,12 @@ function createFalEngine(opts) {
         const images2 = await saveAll(urls2, signal);
         return { images: images2, costUsd: EDIT_COST_USD2, raw: json2 };
       }
-      const json = await postJson(editModel, key, { prompt: req.instruction, image_url: imageUrl }, signal);
+      const json = await postJson(
+        editModel,
+        key,
+        { prompt: req.instruction, image_url: imageUrl, output_format: "png" },
+        signal
+      );
       const urls = extractImageUrls(json);
       const images = await saveAll(urls, signal);
       return { images, costUsd: EDIT_COST_USD2, raw: json };
@@ -948,6 +1029,7 @@ function createRunner(opts = {}) {
   async function run4(args, signal, io) {
     const exe = await resolution();
     const timeoutMs = io?.timeoutMs ?? defaultTimeoutMs;
+    const launchedAs = args[0] === "exec" ? fingerprintFor(exe, knownVersion) : null;
     return new Promise((resolve, reject) => {
       let child;
       try {
@@ -1031,7 +1113,11 @@ function createRunner(opts = {}) {
       });
       child.on("exit", (code) => {
         if (code === 0) {
-          finish("ok", resolve);
+          finish("ok", () => {
+            if (launchedAs && resolved && launchedAs === fingerprintFor(resolved, knownVersion))
+              noteConnection("proven");
+            resolve();
+          });
           return;
         }
         const limit = /You've hit your usage limit\.(?:[^\n]*?\btry again at ([^.\n]+)\.)?/.exec(stderr);
@@ -1266,8 +1352,9 @@ function createRunner(opts = {}) {
     if (outcome === "unproven") return;
     const exe = resolved;
     if (!exe) return;
+    const wasRefused = connCache?.outcome === "refused";
     connCache = { outcome, failure, at: Date.now(), fingerprint: fingerprintFor(exe, knownVersion) };
-    cached = null;
+    if (outcome === "refused" || wasRefused) cached = null;
   }
   function invalidateProbe() {
     cached = null;
@@ -1357,7 +1444,7 @@ function createCodexAnalyzer(opts = {}) {
           if (parsed.ok) return parsed.size;
           problems = parsed.problems;
         }
-        throw new Error(`Codex could not size this product: ${problems.join(" ")}`);
+        return null;
       });
     }
   };
@@ -2040,6 +2127,7 @@ function demoOptionsFromEnv(env) {
   if (env.SCENRI_DEMO_FAIL_EDIT === "1") out.failEdit = true;
   const refs = Number(env.SCENRI_DEMO_REFS);
   if (env.SCENRI_DEMO_REFS && Number.isInteger(refs) && refs > 0) out.maxReferenceImages = refs;
+  if (env.SCENRI_DEMO_PHOTOS) out.photosDir = env.SCENRI_DEMO_PHOTOS;
   return out;
 }
 function sleep2(ms, signal) {
@@ -2065,7 +2153,21 @@ function createDemoEngine(saveImage, opts = {}) {
     return hexes.length ? hexes : ["#4B5563", "#9CA3AF"];
   };
   const esc2 = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").slice(0, 90);
+  let calls = 0;
+  const photos = (() => {
+    if (!opts.photosDir) return [];
+    try {
+      return readdirSync(opts.photosDir).filter((f) => /\.(jpe?g|png|webp)$/i.test(f)).map((f) => join(opts.photosDir, f));
+    } catch {
+      return [];
+    }
+  })();
   async function render(colors, label, w, h, seed) {
+    if (photos.length) {
+      calls += 1;
+      const file = photos[(seed * 7919 + calls * 104729) % photos.length];
+      return sharp22(file).resize(w, h, { fit: "cover" }).png().toBuffer();
+    }
     const c0 = colors[seed % colors.length];
     const c1 = colors[(seed + 1) % colors.length] ?? "#111111";
     const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}">
@@ -4479,8 +4581,10 @@ function mergeScrape(existing, scraped) {
 }
 
 // src/assetRecords.ts
+var TYPED_TEXT_MAX = 4e3;
+var COMPOSED_TEXT_MAX = 8e3;
 var IDENTITY_EDITS_MAX = 8;
-var IDENTITY_EDIT_CHARS = 120;
+var IDENTITY_EDIT_CHARS = TYPED_TEXT_MAX;
 var PRESENTER_SOURCES = ["synthetic", "photos"];
 var LIKENESS_VERSION = "v1";
 var PRESENTER_ID_PREFIX = "up";
@@ -4550,7 +4654,7 @@ function identityEditsOf(v) {
   return out;
 }
 var SUBJECTS2 = /* @__PURE__ */ new Set(["product", "person", "either"]);
-var SCENE_INSTRUCTION_MAX = 800;
+var SCENE_INSTRUCTION_MAX = COMPOSED_TEXT_MAX;
 function sceneRecordFrom(input, base) {
   const has = (k) => input[k] !== void 0;
   const prompt = has("prompt") ? phrase(input.prompt, 2e3) : base?.prompt ?? "";
@@ -5003,21 +5107,31 @@ var toMarkPng = async (buf) => {
   }
   return out;
 };
+var SENDABLE_FORMATS = /* @__PURE__ */ new Set(["png", "jpeg", "webp", "gif"]);
 var cappedRefs = /* @__PURE__ */ new Map();
 async function capReferenceEdge(core, path, maxEdge) {
   const key = `${path}#${maxEdge}`;
   const hit = cappedRefs.get(key);
   if (hit && existsSync(hit)) return hit;
-  let out = path;
+  let format;
+  let buf = null;
   try {
     const meta = await sharp22(path).metadata();
-    if ((meta.width ?? 0) > maxEdge || (meta.height ?? 0) > maxEdge) {
-      const buf = await sharp22(path).resize({ width: maxEdge, height: maxEdge, fit: "inside", withoutEnlargement: true }).png().toBuffer();
-      out = core.images.pathFor(core.images.save(buf));
+    format = meta.format;
+    const oversized = (meta.width ?? 0) > maxEdge || (meta.height ?? 0) > maxEdge;
+    if (oversized || !SENDABLE_FORMATS.has(String(format))) {
+      buf = await sharp22(path).resize({ width: maxEdge, height: maxEdge, fit: "inside", withoutEnlargement: true }).png().toBuffer();
     }
   } catch {
-    return path;
+    if (!existsSync(path) || SENDABLE_FORMATS.has(String(format))) return path;
+    throw Object.assign(
+      new Error(
+        "One of the reference pictures is in a format that cannot be read. Save it as a JPEG or PNG and add it again."
+      ),
+      { statusCode: 400 }
+    );
   }
+  const out = buf ? core.images.pathFor(core.images.save(buf)) : path;
   cappedRefs.set(key, out);
   return out;
 }
@@ -5290,8 +5404,11 @@ function productEditFidelityDirective(name) {
 function characterEditIdentityDirective(name) {
   return `${name} is the person in this photograph: keep them present and clearly visible. Match their face, facial structure, skin, hair and build to the attached person reference exactly. The reference's plain outfit and studio backdrop are capture conditions, not direction: keep the styling this photograph already has unless the instruction itself changes it, and never return them to the capture uniform of their reference photographs (${CAPTURE_UNIFORM}) or to all-white or all-cream plain basics like it.`;
 }
-function referenceIdentityGuard() {
-  return "A reference shot lends its composition, lighting and treatment, never its cast: the attached presenter is the only source of person identity in this shot, and any person visible in a reference shot is a stand-in whose place the presenter takes. The stand-in's clothes are not part of the pose: unless this shot's own words dress the presenter, dress them for this place in clothes of their own that show their own build, never in the stand-in's outfit. This holds even where the direction asks to use someone from a reference \u2014 the attached presenter is that someone.";
+function referenceIdentityGuard(people = 1) {
+  return "A reference shot lends its composition, lighting and treatment, never its cast: the attached presenter is the only source of person identity in this shot, and any person visible in a reference shot is a stand-in whose place the presenter takes. The stand-in's clothes are not part of the pose: unless this shot's own words dress the presenter, dress them for this place in clothes of their own that show their own build, never in the stand-in's outfit. Not a recoloured copy of it either: each garment and the shoes are a different kind from the stand-in's, in none of the stand-in's colours. This holds even where the direction asks to use someone from a reference \u2014 the attached presenter is that someone. " + // Nothing said who else may be in the frame, and read word for word a café
+  // doorway filled with customers, a barista and people on the street in 3
+  // of 4 (2026-09-27). People come from presenters, never from a place.
+  (people > 1 ? "The attached presenters are the only people" : "The presenter is the only person") + " in this image unless this shot's own words ask for others: no customers, staff or passers-by, and nobody glimpsed through glass or in the distance.";
 }
 function referenceProductGuard() {
   return "A reference shot lends its composition, lighting and treatment, never its product: the attached product photo is the only source of product identity in this shot. Any product, package or object a reference shot features in that place only marks where the attached product goes, and the attached product takes it at its own real size, with its own shape, label and colours.";
@@ -5869,6 +5986,22 @@ function compileBrief(input, ctx) {
       );
     }
   }
+  const sent = new Set(ctx.sourceHash ? [ctx.sourceHash] : []);
+  const identitySent = /* @__PURE__ */ new Set();
+  const copies = /* @__PURE__ */ new Set();
+  for (const a of attachments) {
+    if (a.role !== "product" && a.role !== "character") continue;
+    const own = `${a.role}:${a.id}:${a.hash}`;
+    if (identitySent.has(own)) copies.add(a);
+    identitySent.add(own);
+    sent.add(a.hash);
+  }
+  for (const a of attachments) {
+    if (a.role === "product" || a.role === "character") continue;
+    if (sent.has(a.hash)) copies.add(a);
+    sent.add(a.hash);
+  }
+  for (let i = attachments.length - 1; i >= 0; i--) if (copies.has(attachments[i])) attachments.splice(i, 1);
   const max = ctx.engineCaps.maxReferenceImages;
   const {
     kept,
@@ -5961,7 +6094,7 @@ function compileBrief(input, ctx) {
     const rec = (ctx.brand?.products ?? []).find((x) => x?.id === a.id);
     return String(rec?.category ?? "").toLowerCase() === "apparel";
   }) ? [garmentDisplayDirective()] : [];
-  const refGuard = ctx.mode !== "edit" && hasPerson && kept.some((a) => a.role === "reference") ? [referenceIdentityGuard()] : [];
+  const refGuard = ctx.mode !== "edit" && hasPerson && kept.some((a) => a.role === "reference") ? [referenceIdentityGuard(people)] : [];
   const framed = ctx.mode !== "edit" && kept.some((a) => a.role === "reference" && frameRefs.has(a.hash));
   const refProductGuard = ctx.mode !== "edit" && productId && kept.some((a) => a.role === "reference") ? [referenceProductGuard()] : [];
   const allDirectives = [
@@ -6129,6 +6262,9 @@ function createContentFetcher(deps) {
   const expected = deps.sha256 !== void 0 ? deps.sha256 : custom ? null : CONTENT_SHA256;
   const enabled = () => env.SCENRI_NO_CONTENT_FETCH !== "1" && deps.store.getSetting("content.enabled") !== "false";
   let inflight = null;
+  let gaveUp = false;
+  let installs = 0;
+  let stale = null;
   async function download() {
     const root = contentCacheRoot(env);
     if (!deps.store.getSetting("content.disclosed")) {
@@ -6170,15 +6306,25 @@ function createContentFetcher(deps) {
   async function ensure() {
     if (!enabled()) return { ok: false, updated: false, error: null };
     if (!contentCacheStale(env, custom)) return { ok: true, updated: false, error: null };
-    inflight ??= download().finally(() => {
+    inflight ??= download().then((result) => {
+      if (result.updated) installs += 1;
+      else if (!result.ok) gaveUp = true;
+      return result;
+    }).finally(() => {
       inflight = null;
+      stale = null;
     });
     return inflight;
   }
+  function state() {
+    if (!enabled() || gaveUp) return { arriving: false, installs };
+    stale ??= contentCacheStale(env, custom);
+    return { arriving: stale, installs };
+  }
   function schedule() {
     setTimeout(() => void ensure(), 3e3).unref();
   }
-  return { enabled, ensure, schedule };
+  return { enabled, ensure, schedule, state };
 }
 async function inspectMark(buf, toPng2) {
   const png = await toPng2(buf);
@@ -7670,7 +7816,8 @@ async function discoverCatalog(opts) {
   const estimatedTotal = discovered.estimatedTotal ?? discovered.productUrls.length;
   let empty = null;
   if (!estimatedTotal) {
-    empty = {
+    const unreachable = await neverAnswered(baseUrl, fetchImpl, opts.signal);
+    empty = unreachable ? { code: "unreachable", message: unreachable, retryable: true } : {
       code: "empty_catalog",
       message: detection.platform === "generic" ? "No public product catalog found. This store may be JavaScript-rendered or require authentication." : `No products discovered on this ${detection.platform} store.`
     };
@@ -7702,6 +7849,17 @@ async function discoverCatalog(opts) {
     }
   };
 }
+async function neverAnswered(baseUrl, fetchImpl, signal) {
+  try {
+    const res = await httpGet(baseUrl, { fetchImpl, signal, retries: 1, timeoutMs: 15e3 });
+    await res.body?.cancel().catch(() => {
+    });
+    return null;
+  } catch {
+    if (signal?.aborted) return null;
+    return `Could not reach ${new URL(baseUrl).hostname}.`;
+  }
+}
 
 // ../catalog/src/robots.ts
 var ALLOW_ALL = { rules: [], crawlDelayMs: 0 };
@@ -8000,6 +8158,16 @@ async function runJob(deps, jobId, brandId, url, signal, only) {
       platform = found.detection.platform;
       discovered = found.estimatedTotal;
       warnings = found.progress.warnings;
+      if (found.empty?.code === "unreachable") {
+        patch3({
+          stage: "failed",
+          errors: [found.empty],
+          warnings: found.progress.warnings,
+          message: found.empty.message,
+          finished: true
+        });
+        return;
+      }
       if (found.empty || !found.estimatedTotal) {
         const source = core.catalog.upsertSource(brandId, found.baseUrl, platform);
         patch3({ sourceId: source.id, platform });
@@ -9830,13 +9998,17 @@ function resolveSize(dimensions, stored2) {
 }
 async function drawAtScale(o) {
   const span = spanCm(o.size.largestCm);
+  const edge = o.engine.capabilities().maxReferenceEdge;
+  const [scenePath, productPath] = await Promise.all(
+    [o.plan.sceneHash, o.plan.productHash].map((h) => o.images.pathFor(h)).map((p) => edge ? capReferenceEdge({ images: o.images }, p, edge) : p)
+  );
   const plates = {
     prompt: platePrompt({ span, light: o.plan.light, shot: o.plan.shot }),
     brand: o.brand,
     width: o.width,
     height: o.height,
     count: o.count,
-    referenceImages: [o.images.pathFor(o.plan.sceneHash)],
+    referenceImages: [scenePath],
     referenceRoles: ["scene"]
   };
   const instruction = placeInstruction({
@@ -9876,7 +10048,7 @@ async function drawAtScale(o) {
             instruction,
             sourceImage: o.images.pathFor(plate),
             brand: o.brand,
-            referenceImages: [o.images.pathFor(o.plan.productHash)],
+            referenceImages: [productPath],
             referenceRoles: ["product"],
             width: o.width,
             height: o.height
@@ -9918,17 +10090,28 @@ async function drawAtScale(o) {
     raw: { requested: o.count, variantIndexes: slots, partialFailures: reasons }
   };
 }
-
-// src/productSizes.ts
-function createProductSizes(core, reader) {
+var MISS_MS = 24 * 60 * 60 * 1e3;
+var missKey = (brandId, productId) => `product-size-miss:${brandId}:${productId}`;
+function createProductSizes(core, reader, clock = Date.now) {
   const reading = /* @__PURE__ */ new Map();
   const stored2 = (brandId, id) => readSize(core.store.getSetting(sizeKey(brandId, id)));
   const known = (brandId, p) => resolveSize(p.dimensions, stored2(brandId, p.id));
+  const missed = (brandId, id, photo) => {
+    try {
+      const miss = JSON.parse(core.store.getSetting(missKey(brandId, id)) || "null");
+      const age = clock() - Number(miss?.at);
+      return miss?.photo === photo && age >= 0 && age < MISS_MS;
+    } catch {
+      return false;
+    }
+  };
   return {
     known,
     async ensure(brandId, p, signal) {
       const now2 = known(brandId, p);
       if (now2 || !p.photo) return now2;
+      const name = basename(p.photo);
+      if (missed(brandId, p.id, name)) return null;
       const key = sizeKey(brandId, p.id);
       let read2 = reading.get(key);
       if (!read2) {
@@ -9936,13 +10119,21 @@ function createProductSizes(core, reader) {
         read2 = (async () => {
           const analyzer = await reader();
           if (!analyzer?.measure) return null;
-          const got = await analyzer.measure(
-            { imagePath: photo, name: p.name, ...p.description ? { description: p.description } : {} },
-            signal
-          );
+          let got = null;
+          try {
+            got = await analyzer.measure(
+              { imagePath: photo, name: p.name, ...p.description ? { description: p.description } : {} },
+              signal
+            );
+          } catch {
+            return null;
+          }
           const n = Number(got?.largestCm);
           const text = String(got?.text ?? "").trim();
-          if (!text || !Number.isFinite(n) || n <= 0) return null;
+          if (!text || !Number.isFinite(n) || n <= 0) {
+            core.store.setSetting(missKey(brandId, p.id), JSON.stringify({ photo: name, at: clock() }));
+            return null;
+          }
           const size = { text, largestCm: n, by: "estimate" };
           core.store.setSetting(key, JSON.stringify(size));
           return size;
@@ -10935,12 +11126,13 @@ function registerLogoRoutes(app, deps) {
     return allowed.includes(v) ? v : null;
   };
   app.post("/api/brands/:id/logos", async (req, reply) => {
+    if (!core.store.getBrand(req.params.id)) return reply.status(404).send({ error: "brand not found" });
+    const part = await readImagePart(core, req, toMarkPng);
+    if ("error" in part) return reply.status(400).send({ error: part.error });
     const brand = core.store.getBrand(req.params.id);
     if (!brand) return reply.status(404).send({ error: "brand not found" });
     const json = { ...brand.json };
     const logos = [...readLogos(json)];
-    const part = await readImagePart(core, req, toMarkPng);
-    if ("error" in part) return reply.status(400).send({ error: part.error });
     const existing = logos.findIndex((l) => assetHash(l?.file) === part.hash);
     const role = enumField(
       part.fields?.role?.value,
@@ -11643,8 +11835,8 @@ function sweepPresenterDrafts(core) {
   }
   return swept;
 }
-var KEEP_ITEM_CHARS = 200;
-var SETUP_CHARS = 4e4;
+var KEEP_ITEM_CHARS = TYPED_TEXT_MAX;
+var SETUP_CHARS = 64 * TYPED_TEXT_MAX;
 var KEEP_ITEMS_MAX = 12;
 var SOURCES_MAX = 8;
 function keepItemsOf(raw, has) {
@@ -11686,18 +11878,18 @@ async function createPresenterDraft(deps, input) {
   const brand = core.store.getBrand(input.brandId);
   if (!brand) throw fail("brand not found", 404);
   const source = input.source === "synthetic" ? "synthetic" : "photos";
-  const direction = str4(input.direction, 400);
+  const direction = str4(input.direction, COMPOSED_TEXT_MAX);
   const keep = str4(input.keep, 240);
   const keepItems = keepItemsOf(input.keepItems, (h) => core.images.has(h));
   const sources = [
     ...new Set((input.imageHashes ?? []).map(String).filter((h) => HASH.test(h) && core.images.has(h)))
   ].slice(0, SOURCES_MAX);
   if (source === "synthetic" && !direction) throw fail("describe who they are in a sentence", 400);
-  if (source === "synthetic" && !deps.engine) throw fail("no engine here can draw a person", 400);
   if (source === "photos" && !sources.length) throw fail("add at least one photo of this person", 400);
   if (source === "photos" && !input.attestation) {
     throw fail("confirm you have permission to use this person's likeness", 400);
   }
+  if (!deps.engine) throw fail("no engine here can draw a person", 400);
   if (source === "photos" && closing) throw restarting();
   const clientKey = str4(input.clientKey, 80);
   const made = clientKey ? listPresenterDrafts(core, brand.id).find(
@@ -11965,7 +12157,7 @@ async function generateView(deps, id, view, opts = {}) {
   if (closing) throw restarting();
   if (isExtra(view) && !rec.extras) throw fail("extra views are built on request", 400);
   if (rec.source === "synthetic" && !rec.direction?.trim()) {
-    const said = str4(opts.adjustment, 400);
+    const said = str4(opts.adjustment, TYPED_TEXT_MAX);
     if (!said) throw fail("describe who they are in a sentence", 400);
     rec = mutate(core, id, (r) => {
       r.direction = said;
@@ -11977,7 +12169,7 @@ async function generateView(deps, id, view, opts = {}) {
     if (rec.views[dep].status !== "approved") throw fail(`approve the ${VIEW_LABEL[dep]} first`, 400);
   }
   if (!engine || !engine.capabilities().maxReferenceImages) throw fail("no engine here can draw a person", 400);
-  const adjustment = str4(opts.adjustment, 240) || void 0;
+  const adjustment = str4(opts.adjustment, TYPED_TEXT_MAX) || void 0;
   const decide = opts.decide === "auto" ? "auto" : void 0;
   const before = rec.views[view].status;
   const saved = mutate(core, id, (r) => {
@@ -12315,35 +12507,17 @@ async function redoView(deps, id, view) {
     r.decisions = [...r.decisions, { view, what: "again", at: (/* @__PURE__ */ new Date()).toISOString() }].slice(-RESULTS_MAX);
   });
 }
-async function usePhotoForView(deps, id, view, hash) {
-  if (!isView(view)) throw fail("no such view", 400);
-  if (running3.has(id)) throw fail("a view is still being drawn", 409);
-  const rec = getPresenterDraft(deps.core, id);
-  if (!rec) throw fail("draft not found", 404);
-  if (rec.source !== "photos" || !rec.sources.includes(hash)) throw fail("that is not one of their photos", 400);
-  return mutate(deps.core, id, (r) => {
-    const slot = r.views[view];
-    if (slot.hash === hash && slot.origin === "photo") return;
-    const gone = [slot.hash, slot.prior].filter((h) => !!h && !r.sources.includes(h));
-    r.views[view] = {
-      ...emptySlot(),
-      attempts: slot.attempts,
-      rejected: [...slot.rejected, ...gone],
-      status: "approved",
-      hash,
-      origin: "photo"
-    };
-    staleDependents(r, view);
-  });
-}
 async function updatePresenterDraft(core, id, patch3) {
   return mutate(core, id, (r) => {
     if (patch3.extras !== void 0) r.extras = patch3.extras === true;
     if (patch3.name !== void 0) r.name = str4(patch3.name, 60);
     if (Array.isArray(patch3.facets))
       r.facets = patch3.facets.map((f) => str4(f, 40)).filter(Boolean).slice(0, 8);
-    if (patch3.direction !== void 0) r.direction = str4(patch3.direction, 400) || void 0;
-    if (patch3.setup !== void 0) r.setup = str4(patch3.setup, SETUP_CHARS) || void 0;
+    if (patch3.direction !== void 0) r.direction = str4(patch3.direction, COMPOSED_TEXT_MAX) || void 0;
+    if (patch3.setup !== void 0) {
+      const setup = str4(patch3.setup, Number.POSITIVE_INFINITY);
+      if (setup.length <= SETUP_CHARS) r.setup = setup || void 0;
+    }
     const items = keepItemsOf(patch3.keepItems, (h) => core.images.has(h));
     if (items) writeItems(r, items);
     else {
@@ -12376,19 +12550,15 @@ async function saveNew(deps, rec, hooks) {
   const { core } = deps;
   const id = rec.id;
   if (!rec.name.trim()) throw fail("give them a name", 400);
-  const drawnSet = CORE_VIEWS.some(
-    (v) => v !== "portrait" && rec.views[v].origin === "generated" && !!rec.views[v].hash
-  );
-  const blind = !deps.engine && !drawnSet;
-  const required = blind ? ["portrait"] : [...CORE_VIEWS, ...EXTRA_VIEWS.filter((v) => rec.views[v].status !== "empty")];
+  const required = [...CORE_VIEWS, ...EXTRA_VIEWS.filter((v) => rec.views[v].status !== "empty")];
   for (const v of required) {
     const s = rec.views[v];
     if (s.status === "stale") throw fail(`redo the ${VIEW_LABEL[v]}: it was built on a view you changed`, 400);
     if (s.status !== "approved" || !s.hash) throw fail(`approve the ${VIEW_LABEL[v]} first`, 400);
+    if (rec.sources.includes(s.hash)) throw fail(`draw the ${VIEW_LABEL[v]} first`, 400);
   }
-  const approved = required.map((v) => rec.views[v].hash);
-  const shots = blind ? [...approved, ...rec.sources.filter((h) => !approved.includes(h))] : approved;
-  const angles = blind ? ["portrait"] : [...required];
+  const shots = required.map((v) => rec.views[v].hash);
+  const angles = [...required];
   const portraitFile = `asset:${shots[0]}`;
   const sourceFiles = rec.sources.map((h) => `asset:${h}`);
   const mode = presenterCropMode(portraitFile, sourceFiles, "portrait");
@@ -12777,12 +12947,16 @@ function createSceneExamples(deps) {
     const engineId = engine.capabilities().id;
     const brand = deps.brandContext(brandId);
     const path = (h) => deps.core.images.pathFor(h);
+    const edge = engine.capabilities().maxReferenceEdge;
     return async (source, instruction, refs, role) => {
+      const referenceImages = await Promise.all(
+        refs.map(path).map((p) => edge ? capReferenceEdge(deps.core, p, edge) : p)
+      );
       const req = {
         instruction,
         sourceImage: path(source),
         brand,
-        referenceImages: refs.map(path),
+        referenceImages,
         referenceRoles: refs.map((_, i) => Array.isArray(role) ? role[i] : role),
         width: scene.width,
         height: scene.height
@@ -13161,7 +13335,7 @@ function createSceneExamples(deps) {
 // src/sceneStudio.ts
 var SHOT_READ = `This is one of their own product shots. Read only the place in it: the surface, the architecture, the materials, the light, the atmosphere and the layout. The product and any person in it are that shot's cast, not the place: leave both out and leave "figure" empty, and never transcribe its text or logos. If the shot shows too little of its place to build a world from, say so in "coverage" and describe only what is visible`;
 var STUDIO_PICTURES_MAX = 4;
-var ASK_MAX = 400;
+var ASK_MAX = TYPED_TEXT_MAX;
 var KEEP_PER_BRAND2 = 24;
 var KEEP_MS2 = 24 * 60 * 60 * 1e3;
 var jobs = /* @__PURE__ */ new Map();
@@ -13169,6 +13343,17 @@ var running4 = /* @__PURE__ */ new Map();
 var tasks2 = /* @__PURE__ */ new Map();
 var readHolds = /* @__PURE__ */ new Map();
 var READ_HOLDS_KEPT = 500;
+var holdsKey = (hash) => `scene-holds:${hash}`;
+function heldIn(deps, hash) {
+  const known = readHolds.get(hash);
+  if (known) return known;
+  try {
+    const kept = deps.core.store.getSetting(holdsKey(hash));
+    return kept ? holdsFrom(JSON.parse(kept)) : void 0;
+  } catch {
+    return void 0;
+  }
+}
 var fail2 = (message, statusCode = 400) => Object.assign(new Error(message), { statusCode });
 var oneLine2 = (v, max) => String(v ?? "").replace(/\s+/g, " ").trim().slice(0, max);
 function nameFromWords(words) {
@@ -13355,7 +13540,9 @@ function startSceneStudioJob(deps, input) {
     const checked = readingFrom(input.reading);
     if (!checked.ok) throw fail2(checked.error);
     reading = checked.reading;
-    if (reading.holds?.length === 0 && !hashes.every((h) => readHolds.get(h)?.length === 0)) delete reading.holds;
+    if (reading.holds?.length === 0 && !hashes.every((h) => heldIn(deps, h)?.length === 0)) delete reading.holds;
+    else if (reading.holds === void 0 && hashes.length && hashes.every((h) => heldIn(deps, h)?.length === 0))
+      reading.holds = [];
   }
   const ask = oneLine2(input.ask, ASK_MAX);
   if (kind === "make") {
@@ -13431,7 +13618,13 @@ async function read(deps, job, input, signal) {
     const read2 = readingOfDraft(draft, fallback);
     const holds = imagePaths.length ? holdsFrom(draft.holds) : prior?.holds;
     if (imagePaths.length && holds) {
-      for (const h of hashes) readHolds.set(h, holds);
+      for (const h of hashes) {
+        readHolds.set(h, holds);
+        try {
+          deps.core.store.setSetting(holdsKey(h), JSON.stringify(holds));
+        } catch {
+        }
+      }
       while (readHolds.size > READ_HOLDS_KEPT) readHolds.delete(readHolds.keys().next().value);
     }
     const hero = read2.hero ?? prior?.hero;
@@ -14100,15 +14293,6 @@ function registerPresenterDraftRoutes(app, deps) {
     const hash = String(req.body?.hash ?? "");
     return answer(reply, async () => restoreView(await buildDeps(), draft.id, viewOf(req), hash));
   });
-  app.post("/api/brands/:id/presenter-drafts/:draftId/views/:view/use-photo", async (req, reply) => {
-    const draft = draftOr404(req, reply);
-    if (!draft) return;
-    const body = req.body ?? {};
-    return answer(
-      reply,
-      async () => usePhotoForView(await buildDeps(), draft.id, viewOf(req), String(body.hash ?? ""))
-    );
-  });
   app.post("/api/brands/:id/presenter-drafts/:draftId/save", async (req, reply) => {
     const draft = draftOr404(req, reply);
     if (!draft) return;
@@ -14487,7 +14671,11 @@ function registerProjectRoutes(app, deps) {
       nodes: core.store.recentActivity(brand.id, limit),
       jobs: core.catalog.listRecentJobs(brand.id),
       studio: listStudioWork(core, brand.id, deps.sceneExampleJobs?.(brand.id) ?? []),
-      boot: BOOT
+      boot: BOOT,
+      // Machine-scoped like `boot`, and read on the same tick: whether library
+      // pictures are still arriving, so the studio shows them as on their way
+      // rather than missing, and reads its catalogs again once they land.
+      content: app.content?.state()
     };
   });
   app.get("/api/brands/:id/workspace", async (req, reply) => {
@@ -14891,18 +15079,60 @@ function registerImageRoutes(app, deps) {
 }
 
 // src/release/notes.data.ts
+var HEADLINES_KEPT = 5;
+var FIRST_PUBLIC = "0.2.0";
 var RELEASES = [
+  {
+    version: "0.20.1",
+    date: "2026-09-27",
+    title: "Use in a shot starts a new prompt with just that pick",
+    sections: [
+      {
+        heading: "Create",
+        body: "From Products, Presenters or Scenes, Use in a shot opens a new prompt holding only what you picked. If you were writing one, a note offers Undo to bring it back."
+      },
+      {
+        heading: "Fixes",
+        body: "An example you leave and come back to keeps its shape and quality, even if its scene view was still loading. A pick sent to Create while it is open joins your prompt instead of replacing it."
+      }
+    ]
+  },
+  {
+    version: "0.20.0",
+    date: "2026-09-27",
+    title: "Pictures develop in place, and What's new has its own page",
+    announce: true,
+    sections: [
+      {
+        heading: "Create",
+        body: "While a picture is being made, a quiet swirl holds its place, and the picture develops out of it when it is ready. Refine a shot and the new refinement opens at once, swirling until it lands.",
+        image: {
+          file: "0.20.0-made-in-place.webp",
+          alt: "Two shots from one prompt in Create: the first has landed, and the second is still being made, a swirl with its clock."
+        }
+      },
+      {
+        heading: "What's new",
+        body: "Every update is on one page now, newest first: open What's new from Help, or from Settings > Updates. After a big update, a short window introduces it once."
+      },
+      {
+        heading: "Fixes",
+        body: "Try again starts one new picture, never two, and presenter and scene chats take long descriptions. Beside a reference picture, your presenter keeps their own clothes and no strangers join the shot."
+      }
+    ]
+  },
   {
     version: "0.19.1",
     date: "2026-09-26",
+    title: "Codex keeps no copy of your pictures",
     sections: [
       {
-        heading: "Codex",
+        heading: "Privacy",
         body: "Codex keeps no copy of a picture once Scenri has it, neither a saved conversation nor a second file, and its plugins stay off while Scenri runs it."
       },
       {
         heading: "Library",
-        body: "The library download is checked against the exact archive this version was released with, and nothing is installed unless it matches."
+        body: "The library download is checked before anything is installed, and one that does not match what this version expects is never used."
       },
       {
         heading: "Fixes",
@@ -14913,29 +15143,31 @@ var RELEASES = [
   {
     version: "0.19.0",
     date: "2026-09-26",
-    title: "A new Scenri library.",
+    title: "A new library of products, presenters and scenes",
+    announce: true,
     sections: [
       {
         heading: "Library",
-        body: "Scenri's library is new: 30 products, 19 presenters and 42 scenes, with 110 examples on Home. Every view and example is 1536 by 1920, and cards read sharp at every size they are shown."
+        body: "The library now holds 30 products, 19 presenters and 42 scenes, with 110 examples on Home. Cards stay sharp at every size they are shown.",
+        image: {
+          file: "0.19.0-home-examples.webp",
+          alt: "Home in a full-size window: the row of example kinds under the top bar, and the wall of examples made with the new library."
+        }
       },
       {
         heading: "Scenes",
-        body: "A scene leads with its hero. Any of its pictures can be the frame a shot follows, from the scene's page or from its chip, whose picker now opens on the scene's own pictures. Five of the Home examples follow one this way."
+        body: "Scene cards show each place in use, not empty. Any picture of a scene can be the frame a shot follows: press Use this view on the scene's page, or pick it from the scene's chip in your prompt."
       },
       {
         heading: "Create",
-        body: "A presenter is dressed for the place and holds a pose real physics allows, a product carries its written size into the brief, and a close-up follows the product wherever a set has one."
-      },
-      {
-        heading: "Fixes",
-        body: "Presenter and scene conversations recover from a failed press, a retry or a restart without losing their place. A brand kit rename made in a second window stays, Tab leaves a brief that holds a chip, a shot sent right after switching brands is filed in the brand on screen, and a deleted presenter's revisions stay out of a brand export."
+        body: "Presenters are dressed for the place, and lean or sit only on things that could hold them. A scene's close-up moves in on the product, keeping the person only where they wear it."
       }
     ]
   },
   {
     version: "0.18.2",
     date: "2026-09-26",
+    title: "The first library download finishes on a slow connection",
     sections: [
       {
         heading: "Fixes",
@@ -14946,119 +15178,142 @@ var RELEASES = [
   {
     version: "0.18.1",
     date: "2026-09-26",
+    title: "Pictures made with Codex use far less of your ChatGPT plan",
+    announce: true,
     sections: [
       {
         heading: "Codex",
-        body: "Pictures made with Codex use far less of your ChatGPT plan. Every run uses gpt-6-sol, draws each picture once and no longer pastes the finished picture into its own conversation. It needs Codex CLI 0.157.1 or newer, and Scenri says when to update."
+        body: "Each picture is drawn once, and the finished picture is no longer pasted back into Codex's own conversation. It needs Codex CLI 0.157.1 or newer, and Scenri says when yours is too old."
       },
       {
-        heading: "Phone access",
-        body: "A phone with the access code can no longer delete the library, change provider keys or spend caps, install an update or shut Scenri down. Those stay on the computer running Scenri, and the phone no longer offers them."
+        heading: "Local access",
+        body: "A phone or tablet signed in with the code can no longer delete the library, change provider keys or spend caps, install an update or shut Scenri down. Only the computer running Scenri can."
       },
       {
         heading: "Fixes",
-        body: "A library download that stalls now gives up instead of waiting for the rest of the session, and store and brand scans no longer reach private network addresses."
+        body: "A library download that stalls now stops, and the library you already have keeps working."
       }
     ]
   },
   {
     version: "0.18.0",
     date: "2026-09-25",
+    title: "New shots start in portrait at Standard quality",
     sections: [
       {
         heading: "Create",
-        body: "A new shot opens at portrait, one picture, standard quality. A choice already saved still wins."
+        body: "A new shot starts in portrait, with one picture at Standard quality. A setting you already saved still wins.",
+        image: {
+          file: "0.18.0-portrait-standard.webp",
+          alt: "The settings a new shot starts with, Portrait, one picture and Standard, with the shape list open on Portrait."
+        }
       },
       {
         heading: "Library",
-        body: "A presenter, a product and a scene are kept from their own page. Filing and size show as chips, an empty Keepers tab offers the whole wall, and catalog cards stay a readable size as the window narrows."
+        body: "Keep a product, presenter or scene with the star on its own page, yours or Scenri's. A product's size shows as a chip and changes in Details."
       },
       {
         heading: "Shots",
-        body: "Download comes before archive or delete, and Keep stays last. The remove stays the same glass as the rest of the row until the pointer is on it."
-      },
-      {
-        heading: "Activity",
-        body: "An empty Activity panel is the heading and one sentence."
+        body: "On a shot, Download comes first, then Archive or Delete, then the Keepers star."
       }
     ]
   },
   {
     version: "0.17.2",
     date: "2026-09-24",
+    title: "A waiting prompt uses your presenters as they are now",
     sections: [
       {
         heading: "Presenters",
-        body: "A brief left waiting in Create brings its presenters back as they are now, so a shot started after you edit someone uses their new pictures."
+        body: "A prompt left waiting in Create uses each presenter as they are now, so a shot started after you edit someone gets their new pictures.",
+        image: {
+          file: "0.17.2-presenter-prompt.webp",
+          alt: "A waiting prompt, Amara and Kwame by a window, naming two of your presenters as chips with their faces."
+        }
       }
     ]
   },
   {
     version: "0.17.1",
     date: "2026-09-24",
+    title: "Presenters keep their own face, hair and build",
     sections: [
       {
         heading: "Presenters",
-        body: "A presenter keeps their own face, hair, build, glasses and tattoos when a scene or a reference picture shows someone else, with every mark on its own side. A picture used for a pose no longer dresses them in that person's clothes, and their descriptions are no longer cut off mid-word."
+        body: "A presenter keeps their own face, hair, build, glasses and tattoos when a scene or reference picture shows someone else. A picture used for a pose no longer dresses them in that person's clothes.",
+        image: {
+          file: "0.17.1-presenter-identity.webp",
+          alt: "Kwame, one of your presenters, as his page opens: his face, what he is filed under, and his hair and build."
+        }
       }
     ]
   },
   {
     version: "0.17.0",
     date: "2026-09-24",
+    title: "Select several of your own products, presenters or scenes",
+    announce: true,
     sections: [
       {
         heading: "Library",
-        body: "Products, presenters and scenes of your own can be selected and then kept or deleted together from a bar at the bottom of the page, and renamed from their menu. Bookmarks are now Keepers, on every page and in every menu."
+        body: "Select your own products, presenters or scenes from their cards, then keep or delete them together from the bar at the bottom of the page. Rename one from its menu. Bookmarks are now called Keepers.",
+        image: {
+          file: "0.17.0-select-several.webp",
+          alt: "Five of your scenes in a row, three of them picked, and the bar that keeps or deletes them together."
+        }
       },
       {
-        heading: "Create",
-        body: "Home, Create and the libraries share one tab row, with search and size at its end. On a phone, Create keeps its tabs readable and puts the set and the sort in one button beside search. Choosing a tab while scrolled down starts the list from the top."
+        heading: "Tabs",
+        body: "Home, Create, Products, Presenters and Scenes share one tab row, with search and size at its end. On a phone, Create keeps its tabs readable and puts the set and the sort in one button beside search."
       },
       {
         heading: "Fixes",
-        body: "Tab counts on Create no longer jump while the page loads. Closing and opening the assets panel keeps the shot you were looking at in place, and alerts no longer cover the composer's buttons."
+        body: "Tab counts on Create no longer jump while it loads, a tab chosen while scrolled down starts at the top, and closing and opening the Assets panel keeps the shot you were on in place."
       }
     ]
   },
   {
     version: "0.16.0",
     date: "2026-09-24",
-    title: "Open Scenri on your phone or tablet, and Settings with one page for each thing.",
+    title: "Open Scenri on your phone or tablet",
+    announce: true,
     sections: [
       {
         heading: "Local access",
-        body: "Scenri now opens on a phone, tablet or another computer on the same Wi-Fi. Scan the QR code in Settings > Local access, or type the address and enter the six-digit code. The first start may ask whether Node can accept incoming connections; allow it, and if the firewall still stands in the way, Local access says so and, where it can, Allow Scenri fixes it through your computer's own prompt."
+        body: "Open Scenri on a phone, tablet or another computer on the same Wi-Fi: scan the QR code in Settings > Local access. If your computer's firewall stops it, Local access says so and offers Allow Scenri.",
+        image: {
+          file: "0.16.0-local-access.webp",
+          alt: "The Local access card: a QR code to scan, the address and six-digit code to type, and an iPhone just connected."
+        }
       },
       {
         heading: "Security",
-        body: "Only devices with the code get in, and wrong guesses are slowed to a crawl. New code, on the computer running Scenri, signs every device out."
+        body: "Only devices with the six-digit code get in, and wrong guesses have to wait. Press New code to sign every device out."
       },
       {
         heading: "Settings",
-        body: "Providers, Appearance, Library, Local access, Updates and About each have their own page, and every delete sits under Danger zone. On a phone, a link to a Settings page opens that page."
+        body: "One page for each thing: Providers, Appearance, Library, Local access, Updates and About, with every delete under Danger zone."
       }
-    ]
+    ],
+    newFeatures: ["local-access"]
   },
   {
     version: "0.15.1",
     date: "2026-09-23",
+    title: "Make a scene by describing it, or by choosing from pictures",
+    announce: true,
     sections: [
       {
         heading: "Scenes",
-        body: "Scenes are now made in a conversation. Describe a place, start from your own pictures or from a shot you already made, or let Guide Me offer worlds, surfaces and light as pictures to choose from. The pictures you give a scene set its mood and are never copied into it. Each scene has its own page, and setups let one world be shot several ways."
-      },
-      {
-        heading: "Shots",
-        body: "A small product alone in a scene is drawn at its real size. Glossy products such as phones and laptops are lit and staged like a campaign shoot, with the screen dark unless you ask for something on it. An attached picture now means what the words beside it say, so a screenshot can go on a device's screen, redesigned for that screen when it was made for another shape, and a refine can swap it for a different one."
+        body: "Describe a place, start from your own pictures or a shot you already made, or press Guide me and choose a world, its surface and its light from pictures. Your pictures set the mood and are never copied."
       },
       {
         heading: "Activity",
-        body: "Scene and presenter work carries on after you leave the page and shows in the bell and in Activity. A scene still being made stays on the Scenes wall."
+        body: "Scene and presenter work keeps going when you leave the page, and shows in the bell and in Activity. A scene still being made stays on the Scenes wall."
       },
       {
-        heading: "Create",
-        body: "Searching your shots narrows from the first letter, in any alphabet, and matches the words you wrote."
+        heading: "Shots",
+        body: "A small product alone in a scene is drawn at its real size. Phones, laptops and other glossy products are lit like a campaign shoot, and an attached picture can go on a device's screen when your words say so."
       }
     ]
   },
@@ -15073,10 +15328,11 @@ var RELEASES = [
   {
     version: "0.14.0",
     date: "2026-09-22",
+    title: "Settings is redesigned with six pages",
     sections: [
       {
         heading: "Settings",
-        body: "Settings is redesigned with six pages instead of eight: Brand kit and Usage sit under the brand, Providers now includes the monthly caps, and General holds the theme and the library. On a phone it opens as a sheet, with the list of pages first and Back from each one."
+        body: "Six pages instead of eight: Brand kit and Usage sit under the brand, Providers now includes the monthly caps, and General holds the theme and the library. On a phone it opens as a sheet, with the list of pages first and Back from each one."
       },
       {
         heading: "Providers",
@@ -15091,16 +15347,18 @@ var RELEASES = [
   {
     version: "0.13.2",
     date: "2026-09-22",
+    title: "Presenters show an expression that fits the shot",
     sections: [
       {
         heading: "Presenters",
-        body: "Presenters in shots now show an expression that fits the moment and look where the shot directs, instead of a blank stare into the camera. When a presenter has a detail on one side, such as a tattoo or a prosthetic, approving their face and full body now says which side to check."
+        body: "In a shot, a presenter now shows an expression that fits the moment and looks where the shot directs, instead of a blank stare into the camera. When a presenter has a detail on one side, such as a tattoo or a prosthetic, approving their face and full body now says which side to check."
       }
     ]
   },
   {
     version: "0.13.1",
     date: "2026-09-22",
+    title: "Alerts work without closing the dialog beneath them",
     sections: [
       {
         heading: "Alerts",
@@ -15119,15 +15377,16 @@ var RELEASES = [
   {
     version: "0.13.0",
     date: "2026-09-21",
-    title: "Learn teaches Scenri one lesson at a time, alerts are quieter, and the Create feed holds still.",
+    title: "Learn teaches Scenri one lesson at a time, alerts are quieter, and the Create feed holds still",
+    announce: true,
     sections: [
       {
         heading: "Learn",
-        body: "Learn sits in the top bar, or under Help on a smaller screen, and teaches Scenri in six short lessons: your first shot, adding a product, a presenter, a scene, using a product again, and refining a shot. Each lesson keeps its own place, so you can set one down, take up another and come back to it. A new install is offered a guided first shot, and the guide can step back when you change your mind."
+        body: "Six short lessons, in the top bar or under Help on a smaller screen, teach Scenri: your first shot, adding a product, a presenter, a scene, using a product again, and refining a shot. Each lesson keeps its own place, so you can set one down, take up another and come back to it. A new install is offered a guided first shot, and the guide can step back when you change your mind."
       },
       {
         heading: "Alerts",
-        body: "Alerts are smaller and stack at the bottom of the screen, above the composer rather than over it. The same event twice shares one card, an error stays until you close it, and an alert holds still while you point at it or tab into it."
+        body: "Each alert is smaller, and they stack at the bottom of the screen, above the composer rather than over it. The same event twice shares one card, an error stays until you close it, and an alert holds still while you point at it or tab into it."
       },
       {
         heading: "Create",
@@ -15138,7 +15397,8 @@ var RELEASES = [
   {
     version: "0.12.0",
     date: "2026-09-20",
-    title: "Saved work shows up everywhere at once, and a selection has its own toolbar.",
+    title: "Saved work shows up everywhere at once, and a selection has its own toolbar",
+    announce: true,
     sections: [
       {
         heading: "Create",
@@ -15157,6 +15417,7 @@ var RELEASES = [
   {
     version: "0.11.1",
     date: "2026-09-18",
+    title: "Learn and the guided first shot are paused",
     sections: [
       {
         heading: "Learn",
@@ -15171,7 +15432,8 @@ var RELEASES = [
   {
     version: "0.11.0",
     date: "2026-09-18",
-    title: "A new top bar, and a tutor that makes your first shot with you.",
+    title: "A new top bar, and a tutor that makes your first shot with you",
+    announce: true,
     sections: [
       {
         heading: "Top bar",
@@ -15194,6 +15456,7 @@ var RELEASES = [
   {
     version: "0.10.3",
     date: "2026-09-18",
+    title: "Scenri no longer pauses right after the studio opens",
     sections: [
       {
         heading: "Fixes",
@@ -15204,6 +15467,7 @@ var RELEASES = [
   {
     version: "0.10.2",
     date: "2026-09-17",
+    title: "A presenter draft opens where the conversation left off",
     sections: [
       {
         heading: "Presenters",
@@ -15214,7 +15478,8 @@ var RELEASES = [
   {
     version: "0.10.1",
     date: "2026-09-16",
-    title: "A saved presenter can be duplicated or deleted straight from its card.",
+    title: "A saved presenter can be duplicated or deleted straight from its card",
+    announce: true,
     sections: [
       {
         heading: "Presenters",
@@ -15237,7 +15502,8 @@ var RELEASES = [
   {
     version: "0.10.0",
     date: "2026-09-16",
-    title: "Presenters are cast by talking to Scenri, one question at a time.",
+    title: "Presenters are cast by talking to Scenri, one question at a time",
+    announce: true,
     sections: [
       {
         heading: "Presenters",
@@ -15252,7 +15518,8 @@ var RELEASES = [
   {
     version: "0.9.4",
     date: "2026-09-14",
-    title: "A store that asks Scenri to slow down no longer looks like an empty one.",
+    title: "A store that asks Scenri to slow down no longer looks like an empty one",
+    announce: true,
     sections: [
       {
         heading: "Products",
@@ -15267,7 +15534,8 @@ var RELEASES = [
   {
     version: "0.9.3",
     date: "2026-09-14",
-    title: "Paste a website, get the brand and its products.",
+    title: "Paste a website, get the brand and its products",
+    announce: true,
     sections: [
       {
         heading: "Brand",
@@ -15290,6 +15558,7 @@ var RELEASES = [
   {
     version: "0.9.2",
     date: "2026-09-07",
+    title: "A Codex CLI too old for its model now says so",
     sections: [
       {
         heading: "Fixes",
@@ -15300,6 +15569,7 @@ var RELEASES = [
   {
     version: "0.9.1",
     date: "2026-09-07",
+    title: "The Windows desktop icon never fails in silence",
     sections: [
       {
         heading: "Desktop",
@@ -15311,6 +15581,7 @@ var RELEASES = [
     version: "0.9.0",
     date: "2026-09-06",
     title: "Scenri on your desktop",
+    announce: true,
     sections: [
       {
         heading: "Desktop",
@@ -15329,6 +15600,7 @@ var RELEASES = [
   {
     version: "0.8.3",
     date: "2026-09-06",
+    title: "One picker for everything you add to a shot",
     sections: [
       {
         heading: "Create",
@@ -15351,6 +15623,7 @@ var RELEASES = [
   {
     version: "0.8.2",
     date: "2026-09-03",
+    title: "Security updates to the server and its URL parser",
     sections: [
       {
         heading: "Security",
@@ -15361,7 +15634,8 @@ var RELEASES = [
   {
     version: "0.8.1",
     date: "2026-09-03",
-    title: "The same speed at any size.",
+    title: "The same speed at any size",
+    announce: true,
     sections: [
       {
         heading: "Create",
@@ -15380,7 +15654,8 @@ var RELEASES = [
   {
     version: "0.8.0",
     date: "2026-09-02",
-    title: "The composer, rebuilt around what a shot is made of.",
+    title: "The composer, rebuilt around what a shot is made of",
+    announce: true,
     sections: [
       {
         heading: "Create",
@@ -15403,7 +15678,8 @@ var RELEASES = [
   {
     version: "0.7.5",
     date: "2026-09-01",
-    title: "Every shot is one card.",
+    title: "Every shot is one card",
+    announce: true,
     sections: [
       {
         heading: "Create",
@@ -15422,6 +15698,7 @@ var RELEASES = [
   {
     version: "0.7.4",
     date: "2026-08-31",
+    title: "A failed Codex shot says why it failed",
     sections: [
       {
         heading: "Fixes",
@@ -15432,6 +15709,7 @@ var RELEASES = [
   {
     version: "0.7.3",
     date: "2026-08-31",
+    title: "A finished tile no longer guesses its shape",
     sections: [
       {
         heading: "Fixes",
@@ -15442,7 +15720,8 @@ var RELEASES = [
   {
     version: "0.7.2",
     date: "2026-08-30",
-    title: "Changing a shot to a new shape keeps the photograph.",
+    title: "Changing a shot to a new shape keeps the photograph",
+    announce: true,
     sections: [
       {
         heading: "Create",
@@ -15457,7 +15736,8 @@ var RELEASES = [
   {
     version: "0.7.1",
     date: "2026-08-30",
-    title: "Four images from one brief are one set.",
+    title: "Four images from one prompt are one set",
+    announce: true,
     sections: [
       {
         heading: "Create",
@@ -15476,7 +15756,8 @@ var RELEASES = [
   {
     version: "0.7.0",
     date: "2026-08-30",
-    title: "Your presenter stays your presenter.",
+    title: "Your presenter stays your presenter",
+    announce: true,
     sections: [
       {
         heading: "Scenes",
@@ -15495,6 +15776,7 @@ var RELEASES = [
   {
     version: "0.6.13",
     date: "2026-08-30",
+    title: "Products keep their colour, and your logo joins the shot",
     sections: [
       {
         heading: "Products",
@@ -15513,6 +15795,7 @@ var RELEASES = [
   {
     version: "0.6.12",
     date: "2026-08-29",
+    title: "Reference images show what they are",
     sections: [
       {
         heading: "Create",
@@ -15523,6 +15806,7 @@ var RELEASES = [
   {
     version: "0.6.11",
     date: "2026-08-29",
+    title: "Hitting your Codex usage limit says when it comes back",
     sections: [
       {
         heading: "Create",
@@ -15533,7 +15817,8 @@ var RELEASES = [
   {
     version: "0.6.10",
     date: "2026-08-29",
-    title: "Pictures keep their shape.",
+    title: "Pictures keep their shape",
+    announce: true,
     sections: [
       {
         heading: "Create",
@@ -15548,7 +15833,8 @@ var RELEASES = [
   {
     version: "0.6.9",
     date: "2026-08-29",
-    title: "Refinements keep the shot.",
+    title: "Refinements keep the shot",
+    announce: true,
     sections: [
       {
         heading: "Refine",
@@ -15567,6 +15853,7 @@ var RELEASES = [
   {
     version: "0.6.8",
     date: "2026-08-29",
+    title: "Closing a new form ends it, with Undo if you did not mean it",
     sections: [
       {
         heading: "Create dialogs",
@@ -15581,6 +15868,7 @@ var RELEASES = [
   {
     version: "0.6.7",
     date: "2026-08-29",
+    title: "The prompt starts empty, with no scene you did not pick",
     sections: [
       {
         heading: "Create",
@@ -15591,6 +15879,7 @@ var RELEASES = [
   {
     version: "0.6.6",
     date: "2026-08-29",
+    title: "Removing a chip works on the first click",
     sections: [
       {
         heading: "Create",
@@ -15605,6 +15894,7 @@ var RELEASES = [
   {
     version: "0.6.5",
     date: "2026-08-29",
+    title: "A scene no longer brings its own demo object",
     sections: [
       {
         heading: "Scenes",
@@ -15615,6 +15905,7 @@ var RELEASES = [
   {
     version: "0.6.4",
     date: "2026-08-29",
+    title: "New forms no longer carry photos from something else",
     sections: [
       {
         heading: "Create",
@@ -15625,7 +15916,8 @@ var RELEASES = [
   {
     version: "0.6.3",
     date: "2026-08-28",
-    title: "Your logo stays your logo, and every page opens like a page.",
+    title: "Your logo stays your logo, and every page opens like a page",
+    announce: true,
     sections: [
       {
         heading: "Brand",
@@ -15640,7 +15932,8 @@ var RELEASES = [
   {
     version: "0.6.2",
     date: "2026-08-28",
-    title: "Scenes keep what makes them distinctive.",
+    title: "Scenes keep what makes them distinctive",
+    announce: true,
     sections: [
       {
         heading: "Scenes",
@@ -15663,6 +15956,7 @@ var RELEASES = [
   {
     version: "0.6.1",
     date: "2026-08-26",
+    title: "Refining a shot opens at its own shape",
     sections: [
       {
         heading: "Shots",
@@ -15673,6 +15967,7 @@ var RELEASES = [
   {
     version: "0.6.0",
     date: "2026-08-26",
+    title: "A wider or taller shot keeps the original photograph",
     sections: [
       {
         heading: "Shots",
@@ -15687,6 +15982,7 @@ var RELEASES = [
   {
     version: "0.5.1",
     date: "2026-08-26",
+    title: "An extended shot keeps its subject where it was",
     sections: [
       {
         heading: "Shots",
@@ -15697,7 +15993,8 @@ var RELEASES = [
   {
     version: "0.5.0",
     date: "2026-08-26",
-    title: "A finished shot can change shape, and a presenter you attach is a requirement rather than a suggestion.",
+    title: "A finished shot can change shape, and a presenter you attach is a requirement rather than a suggestion",
+    announce: true,
     sections: [
       {
         heading: "Create",
@@ -15720,7 +16017,8 @@ var RELEASES = [
   {
     version: "0.4.7",
     date: "2026-08-24",
-    title: "The feed shows the work, and the controls wait until you point at it.",
+    title: "The feed shows the work, and the controls wait until you point at it",
+    announce: true,
     sections: [
       {
         heading: "Create",
@@ -15739,6 +16037,7 @@ var RELEASES = [
   {
     version: "0.4.6",
     date: "2026-08-24",
+    title: "Removing something from a shot leaves no outline",
     sections: [
       {
         heading: "Refining",
@@ -15753,7 +16052,8 @@ var RELEASES = [
   {
     version: "0.4.5",
     date: "2026-08-23",
-    title: "New versions find you while Scenri runs.",
+    title: "New versions find you while Scenri runs",
+    announce: true,
     sections: [
       {
         heading: "Updates",
@@ -15768,7 +16068,8 @@ var RELEASES = [
   {
     version: "0.4.4",
     date: "2026-08-23",
-    title: "Codex setup tells the truth, and a stuck generation fails instead of running forever.",
+    title: "Codex setup tells the truth, and a stuck generation fails instead of running forever",
+    announce: true,
     sections: [
       {
         heading: "Codex",
@@ -15783,7 +16084,8 @@ var RELEASES = [
   {
     version: "0.4.3",
     date: "2026-08-23",
-    title: "Controls hold still when you press them.",
+    title: "Controls hold still when you press them",
+    announce: true,
     sections: [
       {
         heading: "Fixes",
@@ -15794,6 +16096,7 @@ var RELEASES = [
   {
     version: "0.4.2",
     date: "2026-08-23",
+    title: "Settings tells the update story in one row",
     sections: [
       {
         heading: "Updates",
@@ -15804,7 +16107,8 @@ var RELEASES = [
   {
     version: "0.4.1",
     date: "2026-08-23",
-    title: "Updates now arrive by themselves.",
+    title: "Updates now arrive by themselves",
+    announce: true,
     sections: [
       {
         heading: "Updates",
@@ -15819,7 +16123,8 @@ var RELEASES = [
   {
     version: "0.4.0",
     date: "2026-08-23",
-    title: "Refining a shot keeps the shot.",
+    title: "Refining a shot keeps the shot",
+    announce: true,
     sections: [
       {
         heading: "Refining",
@@ -15842,6 +16147,7 @@ var RELEASES = [
   {
     version: "0.3.5",
     date: "2026-08-21",
+    title: "Codex setup on Windows sees a successful install",
     sections: [
       {
         heading: "Fixes",
@@ -15852,6 +16158,7 @@ var RELEASES = [
   {
     version: "0.3.4",
     date: "2026-08-21",
+    title: "A presenter's photos define who they are, not what they wear",
     sections: [
       {
         heading: "Presenters",
@@ -15873,6 +16180,7 @@ var RELEASES = [
   {
     version: "0.3.2",
     date: "2026-08-20",
+    title: "Codex CLI setup offers the command that gets past a refusal",
     sections: [
       {
         heading: "Fixes",
@@ -15883,6 +16191,7 @@ var RELEASES = [
   {
     version: "0.3.1",
     date: "2026-08-20",
+    title: "Starting Scenri explains what went wrong in plain words",
     sections: [
       {
         heading: "Fixes",
@@ -15893,7 +16202,8 @@ var RELEASES = [
   {
     version: "0.3.0",
     date: "2026-08-20",
-    title: "The name is Scenri.",
+    title: "The name is Scenri",
+    announce: true,
     sections: [
       {
         heading: "The name",
@@ -15908,26 +16218,29 @@ var RELEASES = [
   {
     version: "0.2.3",
     date: "2026-08-20",
+    title: "The last advisory against a build dependency is closed",
     sections: [
       {
         heading: "Security",
-        body: "The last advisory against a build dependency is closed. Nothing about how scenri runs changes, and nothing in the published package moves."
+        body: "The last advisory against a build dependency is closed. Nothing about how Scenri runs changes, and nothing in the published package moves."
       }
     ]
   },
   {
     version: "0.2.2",
     date: "2026-08-20",
+    title: "Two dependencies are on their patched releases",
     sections: [
       {
         heading: "Security",
-        body: "Two dependencies are on their patched releases. The file server that serves the studio is updated for a path traversal advisory, and the image library scenri re-encodes every upload through is updated for the libvips advisories. Nothing about how scenri works changes."
+        body: "Two dependencies are on their patched releases. The file server that serves the studio is updated for a path traversal advisory, and the image library Scenri re-encodes every upload through is updated for the libvips advisories. Nothing about how Scenri works changes."
       }
     ]
   },
   {
     version: "0.2.1",
     date: "2026-08-20",
+    title: "The top bar and app icons carry the real mark",
     sections: [
       {
         heading: "Fixes",
@@ -15938,7 +16251,8 @@ var RELEASES = [
   {
     version: "0.2.0",
     date: "2026-08-20",
-    title: "scenri goes public.",
+    title: "Scenri goes public",
+    announce: true,
     sections: [
       {
         heading: "Compose",
@@ -15954,7 +16268,7 @@ var RELEASES = [
       },
       {
         heading: "The studio",
-        body: "The scenri mark sits in the top bar, the browser tab names the screen you are on, and About says who builds this and under which license."
+        body: "The Scenri mark sits in the top bar, the browser tab names the screen you are on, and About says who builds this and under which license."
       }
     ]
   },
@@ -15972,6 +16286,7 @@ var RELEASES = [
     version: "0.1.0",
     date: "2026-08-16",
     title: "The first complete scenri, released internally.",
+    announce: true,
     sections: [
       {
         heading: "Create",
@@ -15998,6 +16313,35 @@ function releaseFor(version) {
 function isNewsworthy(entry) {
   return (entry?.sections.length ?? 0) > 0;
 }
+function whatsNewWindow(releases, running5, seen = null) {
+  const released = running5 !== "0.0.0";
+  const recent = [];
+  let headlines = 0;
+  for (const r of releases) {
+    if (headlines === HEADLINES_KEPT) break;
+    if (!isNewsworthy(r)) continue;
+    if (released && compareSemver(r.version, running5) > 0) continue;
+    recent.push(r);
+    if (r.announce) headlines++;
+  }
+  const unseen = seen === null || !released ? [] : recent.filter((r) => compareSemver(seen, r.version) < 0 && compareSemver(r.version, running5) <= 0).map((r) => r.version);
+  const lead = recent.find((r) => r.announce && unseen.includes(r.version))?.version ?? null;
+  const history = releases.filter(
+    (r) => isNewsworthy(r) && compareSemver(r.version, FIRST_PUBLIC) >= 0 && (!released || compareSemver(r.version, running5) <= 0)
+  );
+  return { recent, history, unseen, lead };
+}
+var NEW_FOR_DAYS = 30;
+var DAY_MS = 864e5;
+var dayOf = (entry) => Date.parse(`${entry.date}T00:00:00Z`);
+function newUntil(entry) {
+  return dayOf(entry) + NEW_FOR_DAYS * DAY_MS;
+}
+function newFeaturesFor(releases, install) {
+  const { firstVersion, used, now: now2 } = install;
+  if (!firstVersion) return [];
+  return releases.filter((r) => compareSemver(r.version, firstVersion) > 0 && now2 < newUntil(r)).flatMap((r) => r.newFeatures ?? []).filter((f) => !used.includes(f));
+}
 
 // src/routes/updates.ts
 function registerUpdateRoutes(app, deps) {
@@ -16156,38 +16500,68 @@ function registerUpdateRoutes(app, deps) {
       });
     }, 50);
   });
+  const raiseSeen = (v) => {
+    const was = core.store.getSetting("whatsnew.seen");
+    if (!was || compareSemver(v, was) > 0) core.store.setSetting("whatsnew.seen", v);
+  };
   app.get("/api/release/notes", async () => {
-    if (!core.store.getSetting("install.firstVersion")) {
-      core.store.setSetting("install.firstVersion", meta.version);
-      core.store.setSetting("whatsnew.seen", meta.version);
-    }
+    const unmarked = !core.store.getSetting("install.firstVersion");
+    if (unmarked) core.store.setSetting("install.firstVersion", meta.version);
+    if (unmarked || !core.store.getSetting("whatsnew.seen")) raiseSeen(meta.version);
+    const seen = core.store.getSetting("whatsnew.seen") || null;
     return {
       version: meta.version,
       entry: releaseFor(meta.version),
-      seen: core.store.getSetting("whatsnew.seen") || null,
+      seen,
+      // The in-app history (`recent`), what in it is new here (`unseen`), and
+      // the one headline update allowed to open by itself (`lead`). All of it
+      // is in the build: nothing here reaches the network.
+      ...whatsNewWindow(RELEASES, meta.version, seen),
       // 0.0.0 is the placeholder release-please has not bumped yet. No tag has
       // ever existed for it, and the releases index of a project that has not
       // released is an empty page, so there is nowhere honest to point: null.
-      // Its absence is also what tells the dialog it is looking at a
-      // development build rather than a release nobody wrote notes for.
       // Every other version a user can be running was published, and
       // publishing is what creates the tag. The exceptions are the internal
       // 0.1.x builds: published, unpublished, never tagged. Their numbers are
       // burned on npm and a tag link would 404.
       changelogUrl: ghSlug && meta.version !== UNRELEASED && !UNTAGGED.has(meta.version) ? `https://github.com/${ghSlug}/releases/tag/v${meta.version}` : null,
-      // Where everything before the three in the dialog lives. The index, not
-      // a tag: this one is the archive, and it outlives the version running.
-      // Gated on there being an archive at all, so a project that has never
-      // published does not offer a link to an empty page. Never use it to
-      // decide whether *this build* was released — `changelogUrl` answers that.
-      releasesUrl: ghSlug && RELEASES.some(isNewsworthy) ? `https://github.com/${ghSlug}/releases` : null
+      // Full release notes: everything older than the in-app window, and every
+      // fix a record left out. The index, not a tag: this one is the archive,
+      // and it outlives the version running. Gated on there being an archive
+      // at all, so a project that has never published does not offer a link
+      // to an empty page.
+      releasesUrl: ghSlug && RELEASES.some(isNewsworthy) ? `https://github.com/${ghSlug}/releases` : null,
+      // The few features saying New on this install, from the same record
+      // (DESIGN.md, "New"). Read after the stamping above, so a new home's
+      // first read has none: everything is new to it.
+      newFeatures: newFeaturesFor(RELEASES, {
+        firstVersion: core.store.getSetting("install.firstVersion"),
+        used: usedFeatures(),
+        now: Date.now()
+      })
     };
   });
   app.post("/api/release/seen", async (req) => {
     const v = req.body?.version;
-    core.store.setSetting("whatsnew.seen", typeof v === "string" && v ? v : meta.version);
+    raiseSeen(typeof v === "string" && isReleaseTriplet(v) ? v : meta.version);
+    return { ok: true };
+  });
+  app.post("/api/release/used", async (req, reply) => {
+    const f = req.body?.feature;
+    if (typeof f !== "string" || !RELEASES.some((r) => r.newFeatures?.includes(f)))
+      return reply.status(400).send({ error: "not a feature any release marked New" });
+    const used = usedFeatures();
+    if (!used.includes(f)) core.store.setSetting("features.used", JSON.stringify([...used, f]));
     return { ok: true };
   });
+  function usedFeatures() {
+    try {
+      const v = JSON.parse(core.store.getSetting("features.used") ?? "[]");
+      return Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
+    } catch {
+      return [];
+    }
+  }
 }
 function registerSystemRoutes(app, deps) {
   const { core, thumbs } = deps;
@@ -16210,10 +16584,19 @@ function registerSystemRoutes(app, deps) {
   app.post("/api/system/reveal", async (req, reply) => {
     if (!fromThisComputer(req)) return reply.status(403).send({ error: "Only on the computer running Scenri." });
     const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "explorer" : "xdg-open";
-    try {
-      spawn(cmd, [core.home], { detached: true, stdio: "ignore" }).unref();
-    } catch {
-    }
+    const opened = await new Promise((resolve) => {
+      try {
+        const child = spawn(cmd, [core.home], { detached: true, stdio: "ignore" });
+        child.on("error", () => resolve(false));
+        child.once("spawn", () => {
+          child.unref();
+          resolve(true);
+        });
+      } catch {
+        resolve(false);
+      }
+    });
+    if (!opened) return reply.status(501).send({ error: "No file manager could be opened on this computer." });
     return reply.send({ ok: true });
   });
   app.get("/api/export/all", async (_req, reply) => {
@@ -16243,6 +16626,7 @@ function registerSystemRoutes(app, deps) {
     const scope = String(req.query?.scope ?? "");
     if (scope !== "shots" && scope !== "all") return reply.status(400).send({ error: "scope must be shots or all" });
     if (scope === "shots") {
+      deps.stopAllRuns();
       let removed = 0;
       for (const brand of core.store.listBrands()) {
         for (const set of core.store.listSets(brand.id)) core.store.deleteSet(set.id);
@@ -16513,7 +16897,7 @@ function registerDesktopRoutes(app, deps) {
         record: null
       };
     }
-    const { installDeps } = await import('./cli-6LLQ5INA.js');
+    const { installDeps } = await import('./cli-WRNWT6P7.js');
     const { desktopStatus } = await import('./install-VXJPLYWM.js');
     return desktopStatus(installDeps(runtime.entry));
   });
@@ -16521,7 +16905,7 @@ function registerDesktopRoutes(app, deps) {
     if (!runtime.entry) {
       return { ok: false, reason: "unsupported", message: "Desktop shortcuts are not available on this system yet." };
     }
-    const { addToDesktop } = await import('./cli-6LLQ5INA.js');
+    const { addToDesktop } = await import('./cli-WRNWT6P7.js');
     return addToDesktop(runtime.entry);
   });
   app.get("/api/desktop", async (req) => {
@@ -16632,6 +17016,16 @@ function buildServer(opts) {
   });
   const reserved = /* @__PURE__ */ new Map();
   const runningGenerations = /* @__PURE__ */ new Map();
+  const stopRuns = (belongs) => {
+    const stopped = /* @__PURE__ */ new Set();
+    for (const [id, ctrl] of runningGenerations) {
+      if (stopped.has(ctrl)) continue;
+      const node = core.store.getNode(id);
+      if (!node || !belongs(node)) continue;
+      ctrl.abort();
+      stopped.add(ctrl);
+    }
+  };
   core.catalog.reconcileInterruptedJobs();
   const thumbs = createThumbStore(core);
   const { scenes } = loadScenes(opts.templatesDir);
@@ -16698,6 +17092,8 @@ function buildServer(opts) {
       const quiet = {
         core};
       for (const d of listPresenterDrafts(core, id)) await discardPresenterDraft(quiet, d.id, hooks);
+      stopRuns((node) => core.store.getProject(node.projectId)?.brandId === id);
+      for (const job of core.catalog.listJobs(id)) cancelCatalogImport(job.id);
     }
     core.store.deleteBrand(id);
     if (brand) {
@@ -16742,7 +17138,9 @@ function buildServer(opts) {
       ).slice(0, 80).join("").trim() || spec.fallback;
     }
     const id = `${spec.prefix}-${randomUUID().slice(0, 8)}`;
-    const json = { ...brand.json };
+    const current = core.store.getBrand(brand.id);
+    if (!current) return reply.status(404).send({ error: "brand not found" });
+    const json = { ...current.json };
     json[spec.key] = [
       ...json[spec.key] ?? [],
       {
@@ -16780,7 +17178,9 @@ function buildServer(opts) {
       inspectMark: (buf) => inspectMark(buf, toMarkPng),
       createdWith: `${meta.name}/${meta.version}`
     });
-    const { brand: merged, suggestions } = mergeScrape(brand.json, scraped);
+    const current = core.store.getBrand(brand.id);
+    if (!current) return reply.status(404).send({ error: "brand not found" });
+    const { brand: merged, suggestions } = mergeScrape(current.json, scraped);
     const v = validateBrand(merged);
     if (!v.valid) return reply.status(400).send({ error: "brand became invalid", details: v.errors });
     const row = core.store.updateBrand(brand.id, merged);
@@ -16809,11 +17209,9 @@ function buildServer(opts) {
     if (!brand) return reply.status(404).send({ error: "brand not found" });
     const productId = String(req.params.productId);
     const catalogId2 = productId.startsWith("cat-") ? productId.slice(4) : null;
-    const json = { ...brand.json };
-    const products = json.products ?? [];
-    const idx = catalogId2 ? -1 : products.findIndex((p) => p.id === productId);
+    const owned = (json2) => (json2.products ?? []).findIndex((p) => p.id === productId);
     const catalogRow = catalogId2 ? core.catalog.getProduct(catalogId2) : null;
-    if (idx === -1 && (!catalogRow || catalogRow.brandId !== brand.id)) {
+    if ((catalogId2 ? -1 : owned(brand.json)) === -1 && (!catalogRow || catalogRow.brandId !== brand.id)) {
       return reply.status(404).send({ error: "product not found" });
     }
     const part = await readImagePart(core, req, toPng);
@@ -16824,6 +17222,11 @@ function buildServer(opts) {
       core.catalog.addLocalImage(catalogId2, `asset:${hash}`, angle ?? null);
       return core.store.getBrand(brand.id);
     }
+    const current = core.store.getBrand(brand.id);
+    const json = { ...current?.json };
+    const products = json.products ?? [];
+    const idx = current ? owned(json) : -1;
+    if (idx === -1) return reply.status(404).send({ error: "product not found" });
     const shot = { file: `asset:${hash}`, locked: true };
     if (angle) shot.angle = angle;
     json.products = products.map((p, i) => i === idx ? { ...p, shots: [...p.shots ?? [], shot] } : p);
@@ -17075,6 +17478,8 @@ function buildServer(opts) {
       }
     }
     if (inheritedPerson) inheritedDirectives.push(personSkinDirective());
+    const parentImages = core.store.getNode(parentId)?.images ?? [];
+    const source = opts2?.source ?? (parentImages.length === 1 ? parentImages[0] : void 0);
     const compileCtx = {
       brand: brandJson,
       images: core.images,
@@ -17083,6 +17488,9 @@ function buildServer(opts) {
       template: brief.templateId ? sceneById(String(brief.templateId)) : void 0,
       templateById: sceneById,
       mode: "edit",
+      // The frame rides on its own, so a picture this refine attaches that is
+      // the same bytes is never sent a second time beside it.
+      ...source ? { sourceHash: String(source) } : {},
       editScope: verdict.scope,
       editRemoval: verdict.removal ?? false,
       // Kinds, not a count: the identity claim speaks only about the kinds
@@ -17146,7 +17554,8 @@ function buildServer(opts) {
     if (parentId && core.store.getNode(String(parentId))) {
       const previewReshape = req.body.reshape;
       const edit = await compileEditBrief(brand.id, String(parentId), brief, engine.capabilities(), {
-        reshape: previewReshape === "extend" ? "extend" : previewReshape === "crop" ? "crop" : void 0
+        reshape: previewReshape === "extend" ? "extend" : previewReshape === "crop" ? "crop" : void 0,
+        source: req.body.sourceImage
       });
       const { referenceImages: referenceImages2, ...rest2 } = edit.compiled;
       return {
@@ -17446,6 +17855,8 @@ function buildServer(opts) {
     let { width = 1024, height = 1024 } = req.body;
     const project = core.store.getProject(String(projectId));
     if (!project) return reply.status(404).send({ error: "project not found" });
+    if (parentId && core.store.getNode(String(parentId))?.projectId !== project.id)
+      return reply.status(404).send({ error: "That shot is no longer there." });
     const rawReshape = req.body.reshape ?? req.body.brief?.reshape;
     const reshape = rawReshape === "crop" ? "crop" : rawReshape === "extend" ? "extend" : void 0;
     const runCropNode = async (args) => {
@@ -17476,7 +17887,8 @@ function buildServer(opts) {
       void runNode([node2.id], null, 0, work2, { width: plan2.width, height: plan2.height }).catch(
         (err) => app.log.error({ err }, "crop run failed")
       );
-      return reply.status(202).send(args.note ? { ...node2, warnings: [args.note] } : node2);
+      const sent2 = core.store.getNode(node2.id) ?? node2;
+      return reply.status(202).send(args.note ? { ...sent2, warnings: [args.note] } : sent2);
     };
     if (kind === "edit" && reshape === "crop") {
       const rootForCrop = core.store.rootFor(project.id);
@@ -17533,7 +17945,8 @@ function buildServer(opts) {
       if (briefErrors.length) return reply.status(400).send({ error: `invalid brief: ${briefErrors.join("; ")}` });
       if (kind === "edit") {
         const edit = await compileEditBrief(project.brandId, resolvedParentId, brief, engine.capabilities(), {
-          reshape
+          reshape,
+          source: req.body.sourceImage
         });
         compiled2 = edit.compiled;
         inheritedTokens = edit.inheritedTokens;
@@ -17659,13 +18072,13 @@ function buildServer(opts) {
       const sentRefs = keptRefs && maxEdge ? await Promise.all(keptRefs.map((p) => capReferenceEdge(core, p, maxEdge))) : keptRefs;
       const sentRoles = referenceRoles && cap2 > 0 ? referenceRoles.slice(0, cap2) : referenceRoles ?? [];
       if (process.env.SCENRI_DEBUG) {
-        const sent = {};
-        for (const r of sentRoles) sent[r] = (sent[r] ?? 0) + 1;
+        const sent2 = {};
+        for (const r of sentRoles) sent2[r] = (sent2[r] ?? 0) + 1;
         app.log.info(
           {
             engine: engine.capabilities().id,
             cap: cap2,
-            sent,
+            sent: sent2,
             dropped: (compiled2?.dropped ?? []).map((d) => `${d.role}:${d.label} (${d.reason ?? "budget"})`)
           },
           "reference transport"
@@ -17738,14 +18151,14 @@ function buildServer(opts) {
       const editEdge = engine.capabilities().maxReferenceEdge;
       if (editEdge) for (const r of editRefs) r.path = await capReferenceEdge(core, r.path, editEdge);
       if (process.env.SCENRI_DEBUG) {
-        const sent = {};
-        for (const r of editRefs) sent[String(r.role ?? "reference")] = (sent[String(r.role ?? "reference")] ?? 0) + 1;
+        const sent2 = {};
+        for (const r of editRefs) sent2[String(r.role ?? "reference")] = (sent2[String(r.role ?? "reference")] ?? 0) + 1;
         app.log.info(
           {
             engine: engine.capabilities().id,
             cap: Math.max(0, engine.capabilities().maxReferenceImages - 1),
             sourceFrame: true,
-            sent,
+            sent: sent2,
             dropped: (mergedEdit?.dropped ?? []).map((d) => `${d.role}:${d.label} (${d.reason ?? "budget"})`)
           },
           "reference transport"
@@ -18054,10 +18467,10 @@ function buildServer(opts) {
     } : kind === "edit" && original ? async (images) => {
       let staged = images;
       if (gradeOnlyAsk && !expandPlan) {
-        const sent = budgetSourceHash ? core.images.read(budgetSourceHash) : original;
+        const sent2 = budgetSourceHash ? core.images.read(budgetSourceHash) : original;
         const out = [];
         for (const h of staged) {
-          const g = await gradeComposite(original, sent, core.images.read(h));
+          const g = await gradeComposite(original, sent2, core.images.read(h));
           if (g) {
             app.log.info(
               { nodeId: node.id, residual: Number(g.residual.toFixed(2)) },
@@ -18102,14 +18515,16 @@ function buildServer(opts) {
       nodeBudgetMs
     ).catch((err) => app.log.error({ err }, "node run failed"));
     const allWarnings = [...compiled2?.warnings ?? [], ...extraWarnings];
-    return reply.status(202).send({ ...node, siblings: nodes, ...allWarnings.length ? { warnings: allWarnings } : {} });
+    const sent = nodes.map((n) => core.store.getNode(n.id) ?? n);
+    return reply.status(202).send({ ...sent[0], siblings: sent, ...allWarnings.length ? { warnings: allWarnings } : {} });
   };
   app.post("/api/nodes", async (req, reply) => startNodeRun(req, reply));
   app.post("/api/nodes/:id/retry", async (req, reply) => {
     const id = req.params.id;
     const n = core.store.getNode(id);
     if (!n) return reply.status(404).send({ error: "node not found" });
-    if (n.status === "running") return reply.status(409).send({ error: "already running" });
+    if (n.status === "running" || runningGenerations.has(id))
+      return reply.status(409).send({ error: "already running" });
     if (n.status === "done") return reply.status(400).send({ error: "finished shots start a new take" });
     if (n.status !== "error" && n.status !== "cancelled") {
       return reply.status(400).send({ error: "cannot retry this shot" });
@@ -18231,7 +18646,7 @@ function buildServer(opts) {
     })();
     return drained;
   });
-  registerSystemRoutes(app, { core, thumbs });
+  registerSystemRoutes(app, { core, thumbs, stopAllRuns: () => stopRuns(() => true) });
   registerPhoneRoutes(app, { phone });
   registerGuideRoutes(app, { core, version: meta.version });
   registerDesktopRoutes(app, {
@@ -18331,6 +18746,12 @@ async function serve() {
   }
 }
 async function run3() {
+  const supervised = process.env.SCENRI_SUPERVISED === "1";
+  const installKind = detectInstallKind(fileURLToPath(import.meta.url), defaultHome());
+  const theirs = await runningScenri();
+  if (theirs && shouldAdoptRunning({ installKind, ourHome: defaultHome(), theirHome: theirs.home })) {
+    await adoptRunning();
+  }
   const core = createCore();
   const stubs = process.env.SCENRI_DEMO_ENGINE === "1" ? [createDemoEngine((b) => core.images.save(b), demoOptionsFromEnv(process.env))] : [];
   const engines = createEngineRegistry(core, stubs);
@@ -18343,8 +18764,6 @@ async function run3() {
   const here = dirname(fileURLToPath(import.meta.url));
   const candidates = [join(here, "..", "..", "..", "apps", "studio", "dist"), join(here, "..", "studio-dist")];
   const studioDist = candidates.find((p) => existsSync(p));
-  const supervised = process.env.SCENRI_SUPERVISED === "1";
-  const installKind = detectInstallKind(fileURLToPath(import.meta.url), core.home);
   const named = isLoopbackName(HOST) || isWildcardHost(HOST) || isIPv4Literal(HOST) ? [] : [HOST];
   const app = buildServer({
     core,
@@ -18371,34 +18790,17 @@ async function run3() {
           await new Promise((r) => setTimeout(r, 300));
           continue;
         }
-        try {
-          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) {
-            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 theirs2 = await runningScenri();
+        if (theirs2) {
+          if (!shouldAdoptRunning({ installKind, ourHome: core.home, theirHome: theirs2.home })) {
+            console.error("");
+            for (const line of anotherScenriLines(PORT, theirs2.home ?? "another library", core.home)) {
+              console.error(`  ${line}`);
             }
-            const url = `http://127.0.0.1:${PORT}`;
-            console.log(`
-  Scenri is already running \u2192 ${url}
-`);
-            if (process.env.SCENRI_NO_OPEN !== "1") {
-              try {
-                const { default: open } = await import('open');
-                await open(url);
-              } catch {
-              }
-            }
-            process.exit(0);
+            console.error("");
+            process.exit(1);
           }
-        } catch {
+          await adoptRunning();
         }
         console.error("");
         for (const line of portBusyLines(PORT)) console.error(`  ${line}`);
@@ -18412,13 +18814,14 @@ async function run3() {
   const shutdown = (signal) => {
     if (closing2) return;
     closing2 = true;
-    console.log(`
+    if (signal !== "SIGHUP") console.log(`
   ${signal}: closing Scenri\u2026`);
     setTimeout(() => process.exit(1), 5e3).unref();
     app.drain().then(() => process.exit(0)).catch(() => process.exit(1));
   };
   process.on("SIGINT", shutdown);
   process.on("SIGTERM", shutdown);
+  process.on("SIGHUP", shutdown);
   void repairPresenterCrops(core, (line) => console.log(line)).catch(() => void 0);
   app.updates.schedule();
   app.content.schedule();
@@ -18452,7 +18855,7 @@ async function run3() {
     }
   }
   const ownEntry = fileURLToPath(import.meta.url);
-  const { addToDesktop, installDeps } = await import('./cli-6LLQ5INA.js');
+  const { addToDesktop, installDeps } = await import('./cli-WRNWT6P7.js');
   const { refreshLauncher } = await import('./refresh-5HBDLLLB.js');
   const { askOnTerminal, offerDesktop, shouldOfferDesktop } = await import('./offer-W6NJXMWT.js');
   const { launcherInstalled } = await import('./paths-6ZXRZUHY.js');
@@ -18494,6 +18897,29 @@ async function verify() {
     process.exit(1);
   }
 }
+async function runningScenri() {
+  try {
+    const res = await fetch(`http://127.0.0.1:${PORT}/api/version`, { signal: AbortSignal.timeout(2e3) });
+    const info = await res.json();
+    return info.name === readMeta().name ? info : null;
+  } catch {
+    return null;
+  }
+}
+async function adoptRunning() {
+  const url = `http://127.0.0.1:${PORT}`;
+  console.log(`
+  Scenri is already running \u2192 ${url}
+`);
+  if (process.env.SCENRI_NO_OPEN !== "1") {
+    try {
+      const { default: open } = await import('open');
+      await open(url);
+    } catch {
+    }
+  }
+  process.exit(0);
+}
 
 export { serve, verify };
 //# sourceMappingURL=serve.js.map