scenri 0.7.5 → 0.8.1

package/dist/serve.js

@@ -6,11 +6,11 @@ import { networkInterfaces, homedir, tmpdir } from 'os';
 import { sep, join, dirname, normalize } from 'path';
 import Database from 'better-sqlite3';
 import { randomBytes, createHash, randomUUID, timingSafeEqual } from 'crypto';
-import fs, { realpathSync, existsSync, readFileSync, mkdirSync, chmodSync, writeFileSync, readdirSync, statSync, rmSync, renameSync } from 'fs';
+import fs, { realpathSync, existsSync, readFileSync, mkdirSync, chmodSync, writeFileSync, createReadStream, rmSync, readdirSync, statSync, renameSync } from 'fs';
 import { fileURLToPath } from 'url';
-import { readFile, copyFile, stat, mkdtemp, rm, readdir, writeFile } from 'fs/promises';
+import { readFile, copyFile, stat, access, readdir, mkdtemp, rm, rename, unlink, writeFile } from 'fs/promises';
 import { spawn } from 'child_process';
-import sharp20 from 'sharp';
+import sharp21 from 'sharp';
 import Fastify from 'fastify';
 import fastifyStatic from '@fastify/static';
 import fastifyMultipart from '@fastify/multipart';
@@ -297,8 +297,14 @@ function collapseProjects(db) {
     })();
   }
 }
+var IMAGES_SPLIT_MARK = "v1";
 function splitMultiImageNodes(db) {
-  const rows = db.prepare("SELECT * FROM nodes").all();
+  const done = db.prepare("SELECT value FROM settings WHERE key='images_split'").get()?.value;
+  if (done === IMAGES_SPLIT_MARK) return;
+  const mark = () => db.prepare(
+    "INSERT INTO settings (key, value) VALUES ('images_split', ?) ON CONFLICT(key) DO UPDATE SET value=excluded.value"
+  ).run(IMAGES_SPLIT_MARK);
+  const rows = db.prepare("SELECT * FROM nodes WHERE images LIKE '%,%'").all();
   const multi = rows.filter((r) => {
     try {
       return JSON.parse(r.images).length > 1;
@@ -306,7 +312,10 @@ function splitMultiImageNodes(db) {
       return false;
     }
   });
-  if (!multi.length) return;
+  if (!multi.length) {
+    mark();
+    return;
+  }
   const parse2 = (s) => {
     if (!s) return null;
     try {
@@ -389,6 +398,89 @@ function splitMultiImageNodes(db) {
       }
     }
   })();
+  mark();
+}
+function ensureIndexes(db) {
+  db.exec(`
+    CREATE INDEX IF NOT EXISTS idx_nodes_project_created ON nodes(project_id, created_at, id);
+    CREATE INDEX IF NOT EXISTS idx_nodes_project_kept ON nodes(project_id, kept, created_at, id);
+    CREATE INDEX IF NOT EXISTS idx_nodes_project_cost ON nodes(project_id, cost_usd, created_at, id);
+    CREATE INDEX IF NOT EXISTS idx_nodes_project_state ON nodes(project_id, kind, archived, kept);
+    DROP INDEX IF EXISTS idx_nodes_parent;
+    CREATE INDEX IF NOT EXISTS idx_nodes_parent_created ON nodes(parent_id, created_at, id);
+    CREATE INDEX IF NOT EXISTS idx_nodes_status ON nodes(status);
+    CREATE INDEX IF NOT EXISTS idx_catalog_variants_product ON catalog_variants(product_id);
+    CREATE INDEX IF NOT EXISTS idx_cost_events_engine_ts ON cost_events(engine_id, ts);
+  `);
+}
+function searchTextSql(alias) {
+  const brief = `CASE WHEN json_valid(${alias}.brief) THEN ${alias}.brief ELSE '{}' END`;
+  return `trim(coalesce(${alias}.prompt, '') || ' ' ||
+    coalesce((SELECT group_concat(je.value, ' ') FROM json_each(${brief}, '$.templateFields') AS je), '') || ' ' ||
+    coalesce((SELECT group_concat(coalesce(json_extract(je.value, '$.name'), '') || ' ' || coalesce(json_extract(je.value, '$.hex'), ''), ' ')
+                FROM json_each(${brief}, '$.tokens') AS je WHERE json_extract(je.value, '$.t') = 'color'), ''))`;
+}
+function tokenRowsSql(alias) {
+  const brief = `CASE WHEN json_valid(${alias}.brief) THEN ${alias}.brief ELSE '{}' END`;
+  return `SELECT ${alias}.id, json_extract(je.value, '$.t'), json_extract(je.value, '$.id')
+            FROM json_each(${brief}, '$.tokens') AS je
+           WHERE json_extract(je.value, '$.t') IN ('product', 'character', 'template')
+             AND json_extract(je.value, '$.id') IS NOT NULL
+          UNION ALL
+          SELECT ${alias}.id, 'template', json_extract(${brief}, '$.templateId')
+           WHERE json_extract(${brief}, '$.templateId') IS NOT NULL`;
+}
+function tokenRowsFromNodesSql() {
+  const brief = "CASE WHEN json_valid(n.brief) THEN n.brief ELSE '{}' END";
+  return `SELECT n.id, json_extract(je.value, '$.t'), json_extract(je.value, '$.id')
+            FROM nodes n, json_each(${brief}, '$.tokens') AS je
+           WHERE json_extract(je.value, '$.t') IN ('product', 'character', 'template')
+             AND json_extract(je.value, '$.id') IS NOT NULL
+          UNION ALL
+          SELECT n.id, 'template', json_extract(${brief}, '$.templateId')
+            FROM nodes n
+           WHERE json_extract(${brief}, '$.templateId') IS NOT NULL`;
+}
+var SEARCH_INDEX_VERSION = "v1";
+function ensureSearch(db) {
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS nodes_fts USING fts5(text, tokenize='trigram case_sensitive 0 remove_diacritics 1');
+    CREATE TABLE IF NOT EXISTS node_tokens (
+      node_id TEXT NOT NULL,
+      kind TEXT NOT NULL,
+      token_id TEXT NOT NULL,
+      PRIMARY KEY (node_id, kind, token_id)
+    ) WITHOUT ROWID;
+    CREATE INDEX IF NOT EXISTS idx_node_tokens_token ON node_tokens(token_id, node_id);
+    CREATE TRIGGER IF NOT EXISTS nodes_search_ai AFTER INSERT ON nodes BEGIN
+      INSERT INTO nodes_fts(rowid, text) VALUES (new.rowid, ${searchTextSql("new")});
+      INSERT OR IGNORE INTO node_tokens(node_id, kind, token_id) ${tokenRowsSql("new")};
+    END;
+    CREATE TRIGGER IF NOT EXISTS nodes_search_au AFTER UPDATE OF prompt, brief ON nodes BEGIN
+      DELETE FROM nodes_fts WHERE rowid = old.rowid;
+      DELETE FROM node_tokens WHERE node_id = old.id;
+      INSERT INTO nodes_fts(rowid, text) VALUES (new.rowid, ${searchTextSql("new")});
+      INSERT OR IGNORE INTO node_tokens(node_id, kind, token_id) ${tokenRowsSql("new")};
+    END;
+    CREATE TRIGGER IF NOT EXISTS nodes_search_ad AFTER DELETE ON nodes BEGIN
+      DELETE FROM nodes_fts WHERE rowid = old.rowid;
+      DELETE FROM node_tokens WHERE node_id = old.id;
+    END;
+  `);
+  const marker = db.prepare("SELECT value FROM settings WHERE key='search_index'").get()?.value;
+  const bounds = db.prepare("SELECT min(rowid) AS lo, max(rowid) AS hi, count(*) AS c FROM nodes").get();
+  const indexed = (rowid) => rowid !== null && !!db.prepare("SELECT 1 FROM nodes_fts WHERE rowid = ?").get(rowid);
+  const whole = bounds.c === 0 || indexed(bounds.lo) && indexed(bounds.hi);
+  if (marker === SEARCH_INDEX_VERSION && whole) return;
+  db.transaction(() => {
+    db.exec("DELETE FROM nodes_fts");
+    db.exec("DELETE FROM node_tokens");
+    db.exec(`INSERT INTO nodes_fts(rowid, text) SELECT n.rowid, ${searchTextSql("n")} FROM nodes n`);
+    db.exec(`INSERT OR IGNORE INTO node_tokens(node_id, kind, token_id) ${tokenRowsFromNodesSql()}`);
+    db.prepare(
+      "INSERT INTO settings (key, value) VALUES ('search_index', ?) ON CONFLICT(key) DO UPDATE SET value=excluded.value"
+    ).run(SEARCH_INDEX_VERSION);
+  })();
 }
 var SCHEMA_VERSION = 2;
 var SchemaTooNewError = class extends Error {
@@ -461,9 +553,11 @@ function openDb(homeDir) {
     db.exec("ALTER TABLE catalog_images ADD COLUMN excluded INTEGER NOT NULL DEFAULT 0");
   }
   widenNodeStatusCheck(db);
+  ensureIndexes(db);
   backfillSlugs(db);
   collapseProjects(db);
   splitMultiImageNodes(db);
+  ensureSearch(db);
   db.prepare(
     "UPDATE nodes SET status='error', error='interrupted: server restarted mid-generation' WHERE status='running'"
   ).run();
@@ -544,6 +638,31 @@ function createLedger(db) {
     }
   };
 }
+
+// ../core/src/searchRules.ts
+function fold(s) {
+  return s.normalize("NFD").replace(new RegExp("\\p{Diacritic}", "gu"), "").replace(/[\u200e\u200f\u061c\u202a-\u202e\u2066-\u2069]/g, "").toLowerCase();
+}
+var STEM_MIN = 4;
+var TRIGRAM_MIN = 3;
+function searchTerms(q) {
+  return fold(q).trim().split(/\s+/).filter(Boolean).map((text) => ({
+    text,
+    stem: text.length >= STEM_MIN && text.endsWith("s") ? text.slice(0, -1) : null
+  }));
+}
+function termMatches(haystack, term) {
+  const h = fold(haystack);
+  return h.includes(term.text) || term.stem !== null && h.includes(term.stem);
+}
+var quote = (s) => `"${s.replace(/"/g, '""')}"`;
+function ftsMatch(term) {
+  if (term.text.length < TRIGRAM_MIN) return null;
+  return term.stem ? `(${quote(term.text)} OR ${quote(term.stem)})` : quote(term.text);
+}
+
+// ../core/src/store.ts
+var PROMPT_HEAD_CHARS = 240;
 function uniqueSlug(db, name, id) {
   const stmt = db.prepare("SELECT 1 FROM brands WHERE slug=? AND id IS NOT ?");
   return firstFree(slugifyWithId(name, id), (c) => RESERVED_SLUGS.has(c) || !!stmt.get(c, id));
@@ -567,13 +686,20 @@ function rowToSet(r) {
     updatedAt: r.updated_at
   };
 }
-function rowToNode(r) {
+var headOf = (prompt) => Array.from(String(prompt ?? "")).slice(0, PROMPT_HEAD_CHARS).join("");
+var CHILD_COUNT_SQL = "(CASE WHEN n.kind = 'root' THEN 0 ELSE (SELECT count(*) FROM nodes c WHERE c.parent_id = n.id AND c.archived = 0) END)";
+var LINEAGE_SIBLINGS_RADIUS = 25;
+var LINEAGE_CHILDREN_MAX = 60;
+var FEED_COLS = `n.id, n.project_id, n.parent_id, n.kind, substr(n.prompt, 1, ${PROMPT_HEAD_CHARS}) AS prompt_head,
+  n.engine_id, n.status, n.images, n.cost_usd, n.duration_ms, n.kept, n.error, n.created_at, n.brief, n.archived,
+  n.batch_id, n.batch_index, ${CHILD_COUNT_SQL} AS child_count`;
+function rowToFeedNode(r) {
   return {
     id: r.id,
     projectId: r.project_id,
     parentId: r.parent_id,
     kind: r.kind,
-    prompt: r.prompt,
+    promptHead: r.prompt_head ?? headOf(r.prompt),
     engineId: r.engine_id,
     status: r.status,
     images: JSON.parse(r.images),
@@ -582,11 +708,18 @@ function rowToNode(r) {
     kept: !!r.kept,
     error: r.error,
     createdAt: r.created_at,
-    overlays: JSON.parse(r.overlays ?? "{}"),
     brief: r.brief ? JSON.parse(r.brief) : null,
     archived: !!r.archived,
     batchId: r.batch_id ?? null,
-    batchIndex: r.batch_index ?? 0
+    batchIndex: r.batch_index ?? 0,
+    childCount: r.child_count ?? 0
+  };
+}
+function rowToNode(r) {
+  return {
+    ...rowToFeedNode(r),
+    prompt: r.prompt,
+    overlays: JSON.parse(r.overlays ?? "{}")
   };
 }
 var lastBatchStamp = 0;
@@ -599,6 +732,92 @@ function batchStamps(count) {
     return `${d.getUTCFullYear()}-${p(d.getUTCMonth() + 1)}-${p(d.getUTCDate())} ${p(d.getUTCHours())}:${p(d.getUTCMinutes())}:${p(d.getUTCSeconds())}.${p(d.getUTCMilliseconds(), 3)}`;
   });
 }
+var encodeCursor = (k) => Buffer.from(JSON.stringify(k)).toString("base64url");
+function decodeCursor(cursor) {
+  try {
+    const k = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+    if (typeof k?.c === "string" && typeof k?.i === "string") return k;
+  } catch {
+  }
+  throw new Error("invalid cursor");
+}
+function filterSql(f, params, withLens) {
+  const where = ["n.kind != 'root'"];
+  if (withLens) {
+    if (f.lens === "archived") where.push("n.archived = 1");
+    else if (f.lens === "keepers") where.push("n.archived = 0 AND n.kept = 1");
+    else where.push("n.archived = 0");
+  }
+  if (f.lineage) {
+    params.lineage = f.lineage;
+    where.push(
+      "n.id IN (WITH RECURSIVE d(id) AS (SELECT @lineage UNION ALL SELECT c.id FROM nodes c JOIN d ON c.parent_id = d.id) SELECT id FROM d)"
+    );
+  } else if (f.set) {
+    params.set = f.set;
+    where.push("n.id IN (SELECT node_id FROM set_nodes WHERE set_id = @set)");
+  } else if (f.ungrouped) {
+    where.push("NOT EXISTS (SELECT 1 FROM set_nodes sn WHERE sn.node_id = n.id)");
+  }
+  if (f.tokens?.length) {
+    const names = f.tokens.map((t, i) => {
+      params[`tok${i}`] = t;
+      return `@tok${i}`;
+    });
+    where.push(`n.id IN (SELECT node_id FROM node_tokens WHERE token_id IN (${names.join(", ")}))`);
+  }
+  (f.terms ?? []).forEach((term, i) => {
+    const any = [];
+    const match = ftsMatch(term);
+    if (match) {
+      params[`m${i}`] = match;
+      any.push(`n.rowid IN (SELECT rowid FROM nodes_fts WHERE nodes_fts MATCH @m${i})`);
+    }
+    if (term.tokenIds.length) {
+      const names = term.tokenIds.map((t, j) => {
+        params[`t${i}_${j}`] = t;
+        return `@t${i}_${j}`;
+      });
+      any.push(`n.id IN (SELECT node_id FROM node_tokens WHERE token_id IN (${names.join(", ")}))`);
+    }
+    if (term.engineIds.length) {
+      const names = term.engineIds.map((e, j) => {
+        params[`e${i}_${j}`] = e;
+        return `@e${i}_${j}`;
+      });
+      any.push(`n.engine_id IN (${names.join(", ")})`);
+    }
+    if (any.length) where.push(`(${any.join(" OR ")})`);
+  });
+  return where;
+}
+function sortSql(sort, cursor, params) {
+  if (cursor) {
+    params.c = cursor.c;
+    params.i = cursor.i;
+    params.v = cursor.v ?? 0;
+  }
+  const newest = "(n.created_at < @c OR (n.created_at = @c AND n.id < @i))";
+  const oldest = "(n.created_at > @c OR (n.created_at = @c AND n.id > @i))";
+  switch (sort) {
+    case "oldest":
+      return { order: "n.created_at ASC, n.id ASC", after: cursor ? oldest : null };
+    case "cost":
+      return {
+        order: "n.cost_usd DESC, n.created_at DESC, n.id DESC",
+        after: cursor ? `(n.cost_usd < @v OR (n.cost_usd = @v AND ${newest}))` : null
+      };
+    case "keepers":
+      return {
+        order: "n.kept DESC, n.created_at DESC, n.id DESC",
+        after: cursor ? `(n.kept < @v OR (n.kept = @v AND ${newest}))` : null
+      };
+    default:
+      return { order: "n.created_at DESC, n.id DESC", after: cursor ? newest : null };
+  }
+}
+var keysetOf = (n, sort) => sort === "cost" ? { c: n.createdAt, i: n.id, v: n.costUsd } : sort === "keepers" ? { c: n.createdAt, i: n.id, v: n.kept ? 1 : 0 } : { c: n.createdAt, i: n.id };
+var FEED_PAGE_MAX = 200;
 function createStore(db) {
   return {
     // brands
@@ -750,6 +969,10 @@ function createStore(db) {
       }
       return out;
     },
+    /** One set's members, in the order they were filed. */
+    membersOf(setId) {
+      return db.prepare("SELECT node_id FROM set_nodes WHERE set_id=? ORDER BY added_at, node_id").all(setId).map((r) => r.node_id);
+    },
     // nodes / version tree
     addNode(input) {
       if (input.parentId) {
@@ -806,6 +1029,16 @@ function createStore(db) {
         id
       );
     },
+    /**
+     * The run's money, written once it is known. A batch's first sibling used
+     * to be charged inside completeNode, at the end of the whole call; a
+     * sibling now completes the moment its own image lands, and the cost is
+     * only known when the call resolves, so it is written afterwards, onto a
+     * node that finished. A failed or running node keeps 0, as before.
+     */
+    chargeNode(id, costUsd) {
+      db.prepare("UPDATE nodes SET cost_usd=? WHERE id=? AND status='done'").run(costUsd, id);
+    },
     failNode(id, error) {
       db.prepare("UPDATE nodes SET status='error', error=? WHERE id=?").run(error, id);
     },
@@ -813,13 +1046,143 @@ function createStore(db) {
       db.prepare("UPDATE nodes SET status='cancelled' WHERE id=?").run(id);
     },
     getNode(id) {
-      const r = db.prepare("SELECT * FROM nodes WHERE id=?").get(id);
+      const r = db.prepare(`SELECT n.*, ${CHILD_COUNT_SQL} AS child_count FROM nodes n WHERE n.id=?`).get(id);
       return r ? rowToNode(r) : null;
     },
-    treeFor(projectId) {
-      return db.prepare("SELECT * FROM nodes WHERE project_id=? ORDER BY created_at, id").all(projectId).map(
-        rowToNode
+    /** The list shape of one shot: what a keep or an archive answers with. */
+    getFeedNode(id) {
+      const r = db.prepare(`SELECT ${FEED_COLS} FROM nodes n WHERE n.id=?`).get(id);
+      return r ? rowToFeedNode(r) : null;
+    },
+    /** The project's root, by index, rather than the whole tree read to find it. */
+    rootFor(projectId) {
+      const rows = db.prepare(`SELECT n.*, ${CHILD_COUNT_SQL} AS child_count FROM nodes n WHERE n.project_id=? AND n.kind='root'`).all(projectId);
+      rows.sort(
+        (a, b) => String(a.created_at).localeCompare(String(b.created_at)) || String(a.id).localeCompare(String(b.id))
       );
+      return rows.length ? rowToNode(rows[0]) : null;
+    },
+    treeFor(projectId) {
+      return db.prepare(
+        `SELECT n.*, ${CHILD_COUNT_SQL} AS child_count FROM nodes n WHERE n.project_id=? ORDER BY n.created_at, n.id`
+      ).all(projectId).map(rowToNode);
+    },
+    /**
+     * One page of a project's shots for a place, lens, search and sort.
+     *
+     * Keyset paging on the sort's own columns, never OFFSET: the cost of page
+     * forty is the cost of page one, and a shot landing between two pages
+     * shifts nothing already read. Every clause is served by an index or by
+     * the search index; the whole workspace is never read.
+     */
+    feedPage(projectId, q) {
+      const limit = Math.max(1, Math.min(FEED_PAGE_MAX, Math.floor(q.limit ?? 60)));
+      const sort = q.sort ?? "newest";
+      const params = { project: projectId, limit: limit + 1 };
+      const where = ["n.project_id = @project", ...filterSql(q, params, true)];
+      const { order, after } = sortSql(sort, q.cursor ? decodeCursor(q.cursor) : null, params);
+      if (after) where.push(after);
+      const rows = db.prepare(`SELECT ${FEED_COLS} FROM nodes n WHERE ${where.join(" AND ")} ORDER BY ${order} LIMIT @limit`).all(params);
+      const items = rows.slice(0, limit).map(rowToFeedNode);
+      const more = rows.length > limit;
+      return { items, next: more && items.length ? encodeCursor(keysetOf(items[items.length - 1], sort)) : null };
+    },
+    /**
+     * What each lens would show from a place and search, plus the two
+     * unscoped totals. The scoped sums and the total read the state index
+     * alone (project, kind, archived, kept: nothing that needs the row), and
+     * the grouped count walks the brand's memberships rather than asking
+     * every shot whether it is in a set.
+     */
+    feedCounts(projectId, f) {
+      const params = { project: projectId };
+      const where = ["n.project_id = @project", ...filterSql({ ...f, lens: void 0 }, params, false)];
+      const scoped = db.prepare(
+        `SELECT coalesce(sum(n.archived = 0), 0) AS live, coalesce(sum(n.archived = 0 AND n.kept = 1), 0) AS kept,
+                  coalesce(sum(n.archived = 1), 0) AS archived
+             FROM nodes n WHERE ${where.join(" AND ")}`
+      ).get(params);
+      const totals = db.prepare(
+        `SELECT count(*) AS total, coalesce(sum(n.archived = 0), 0) AS live
+             FROM nodes n WHERE n.project_id = ? AND n.kind != 'root'`
+      ).get(projectId);
+      const grouped = db.prepare(
+        `SELECT count(DISTINCT sn.node_id) AS c
+               FROM sets s
+               CROSS JOIN set_nodes sn ON sn.set_id = s.id
+               CROSS JOIN nodes n ON n.id = sn.node_id
+              WHERE s.brand_id = (SELECT brand_id FROM projects WHERE id = ?)
+                AND n.project_id = ? AND n.archived = 0`
+      ).get(projectId, projectId).c;
+      return {
+        total: totals.total,
+        all: scoped.live,
+        keepers: scoped.kept,
+        archived: scoped.archived,
+        ungrouped: totals.live - grouped
+      };
+    },
+    /**
+     * Where one shot sits in its tree, from the parent index: its ancestors
+     * up to (never including) the root, the siblings around it, and what
+     * hangs off it. Archived versions stay in the strip, as they did when the
+     * overlay walked the whole workspace.
+     *
+     * The siblings are a window: this shot, and up to twenty-five on either
+     * side in filing order. A top-level shot's siblings are every top-level
+     * shot in the brand, and the whole list was eighteen megabytes on a
+     * brand of twenty thousand; the overlay only ever steps to a neighbour,
+     * and each step asks again, so the window re-centres as it goes.
+     */
+    lineageOf(id) {
+      const node = this.getFeedNode(id);
+      if (!node) return null;
+      if (node.kind === "root") return { ancestors: [], siblings: [], children: [] };
+      const ancestors = [];
+      let cur = node.parentId ? this.getFeedNode(node.parentId) : null;
+      for (let hops = 0; cur && cur.kind !== "root" && hops < 64; hops++) {
+        ancestors.unshift(cur);
+        cur = cur.parentId ? this.getFeedNode(cur.parentId) : null;
+      }
+      const before = db.prepare(
+        `SELECT count(*) AS c FROM nodes n
+              WHERE n.parent_id IS ? AND (n.created_at < ? OR (n.created_at = ? AND n.id < ?))`
+      ).get(node.parentId, node.createdAt, node.createdAt, node.id).c;
+      const skip = Math.max(0, before - LINEAGE_SIBLINGS_RADIUS);
+      const take = before - skip + 1 + LINEAGE_SIBLINGS_RADIUS;
+      const siblings = db.prepare(
+        `SELECT ${FEED_COLS} FROM nodes n WHERE n.parent_id IS ?
+              ORDER BY n.created_at, n.id LIMIT ? OFFSET ?`
+      ).all(node.parentId, take, skip).map(rowToFeedNode);
+      const children = db.prepare(`SELECT ${FEED_COLS} FROM nodes n WHERE n.parent_id = ? ORDER BY n.created_at, n.id LIMIT ?`).all(node.id, LINEAGE_CHILDREN_MAX).map(rowToFeedNode);
+      return { ancestors, siblings, children };
+    },
+    /** The newest finished shots, newest first, for the rail and the attach panel. */
+    recentShots(projectId, limit = 48) {
+      return db.prepare(
+        `SELECT ${FEED_COLS} FROM nodes n
+              WHERE n.project_id = ? AND n.kind != 'root' AND n.status = 'done' AND n.images != '[]'
+              ORDER BY n.created_at DESC, n.id DESC LIMIT ?`
+      ).all(projectId, Math.max(1, Math.min(FEED_PAGE_MAX, limit))).map(rowToFeedNode);
+    },
+    /** A year of runs by day, counted where the rows are. */
+    usageByDay(brandId) {
+      return db.prepare(
+        `SELECT substr(n.created_at, 1, 10) AS day,
+                    coalesce(sum(n.kind = 'generation'), 0) AS generations,
+                    coalesce(sum(n.kind = 'edit'), 0) AS edits
+               FROM nodes n JOIN projects p ON p.id = n.project_id
+              WHERE p.brand_id = ? AND n.kind != 'root' AND n.created_at >= date('now', '-400 days')
+              GROUP BY day ORDER BY day`
+      ).all(brandId).map((r) => ({ day: String(r.day), generations: Number(r.generations), edits: Number(r.edits) }));
+    },
+    /** The compiled prompt of the shot that produced an image, for a reference described in words. */
+    promptForImage(brandId, hash) {
+      const r = db.prepare(
+        `SELECT n.prompt FROM nodes n JOIN projects p ON p.id = n.project_id
+            WHERE p.brand_id = ? AND n.images LIKE ? ORDER BY n.created_at, n.id LIMIT 1`
+      ).get(brandId, `%"${hash}"%`);
+      return r?.prompt ?? null;
     },
     /**
      * Every piece of work a brand has in flight, plus whatever finished lately,
@@ -832,21 +1195,26 @@ function createStore(db) {
      * ISO string is a silent, timezone-shaped mis-filter.
      */
     recentActivity(brandId, limit = 60) {
-      const rows = db.prepare(
-        `SELECT n.*, (
+      const cols = `${FEED_COLS}, (
                     SELECT group_concat(s.name, char(31))
                       FROM set_nodes sn JOIN sets s ON s.id = sn.set_id
                      WHERE sn.node_id = n.id
-                  ) AS set_names
-             FROM nodes n JOIN projects p ON p.id = n.project_id
-            WHERE p.brand_id = ?
-              AND n.kind != 'root'
-              AND (n.status = 'running' OR n.created_at >= datetime('now', '-2 days'))
-            ORDER BY n.created_at DESC, n.id DESC
-            LIMIT ?`
-      ).all(brandId, limit);
+                  ) AS set_names`;
+      const inBrand = "n.project_id IN (SELECT id FROM projects WHERE brand_id = @brand)";
+      const rows = db.prepare(
+        `SELECT * FROM (
+             SELECT ${cols} FROM nodes n
+              WHERE ${inBrand} AND n.kind != 'root' AND n.status = 'running'
+             UNION ALL
+             SELECT ${cols} FROM nodes n
+              WHERE ${inBrand} AND n.kind != 'root' AND n.status != 'running'
+                AND n.created_at >= datetime('now', '-2 days')
+           )
+           ORDER BY created_at DESC, id DESC
+           LIMIT @limit`
+      ).all({ brand: brandId, limit });
       return rows.map((r) => ({
-        ...rowToNode(r),
+        ...rowToFeedNode(r),
         setNames: r.set_names ? String(r.set_names).split(SET_NAME_SEP) : []
       }));
     },
@@ -969,6 +1337,56 @@ var productById = (db, id) => {
 var productsFor = (db, brandId) => db.prepare(
   "SELECT * FROM catalog_products WHERE brand_id=? AND status!='unavailable' ORDER BY title COLLATE NOCASE"
 ).all(brandId).map(rowProduct);
+var rowVariant = (r) => ({
+  id: r.id,
+  productId: r.product_id,
+  externalKey: r.external_key,
+  title: r.title,
+  sku: r.sku,
+  price: r.price,
+  compareAtPrice: r.compare_at_price,
+  currency: r.currency,
+  available: r.available == null ? null : !!r.available,
+  options: JSON.parse(r.options || "{}")
+});
+var rowImage = (r) => ({
+  id: r.id,
+  productId: r.product_id,
+  sourceUrl: r.source_url,
+  assetRef: r.asset_ref,
+  width: r.width,
+  height: r.height,
+  position: r.position,
+  alt: r.alt,
+  angle: r.angle ?? null,
+  excluded: !!r.excluded
+});
+var variantsForBrand = (db, brandId) => {
+  const out = /* @__PURE__ */ new Map();
+  const rows = db.prepare(
+    `SELECT v.* FROM catalog_variants v JOIN catalog_products p ON p.id = v.product_id
+        WHERE p.brand_id=? AND p.status!='unavailable' ORDER BY v.product_id, v.rowid`
+  ).all(brandId);
+  for (const r of rows) {
+    const list2 = out.get(r.product_id) ?? [];
+    list2.push(rowVariant(r));
+    out.set(r.product_id, list2);
+  }
+  return out;
+};
+var imagesForBrand = (db, brandId) => {
+  const out = /* @__PURE__ */ new Map();
+  const rows = db.prepare(
+    `SELECT i.* FROM catalog_images i JOIN catalog_products p ON p.id = i.product_id
+        WHERE p.brand_id=? AND p.status!='unavailable' ORDER BY i.product_id, i.position`
+  ).all(brandId);
+  for (const r of rows) {
+    const list2 = out.get(r.product_id) ?? [];
+    list2.push(rowImage(r));
+    out.set(r.product_id, list2);
+  }
+  return out;
+};
 var variantsFor = (db, productId) => db.prepare("SELECT * FROM catalog_variants WHERE product_id=?").all(productId).map((r) => ({
   id: r.id,
   productId: r.product_id,
@@ -1378,8 +1796,10 @@ function libraryMethods(db) {
           alt: s.alt ?? s.angle ?? null
         }))
       }));
+      const imagesBy = imagesForBrand(db, brandId);
+      const variantsBy = variantsForBrand(db, brandId);
       const catalog = productsFor(db, brandId).map((p) => {
-        const images = imagesFor(db, p.id);
+        const images = imagesBy.get(p.id) ?? [];
         const shot = (i) => ({
           file: i.assetRef,
           locked: true,
@@ -1411,7 +1831,7 @@ function libraryMethods(db) {
           status: p.status,
           shots,
           hiddenShots,
-          variants: variantsFor(db, p.id)
+          variants: variantsBy.get(p.id) ?? []
         };
       });
       return [...manual, ...catalog];
@@ -1630,7 +2050,7 @@ function createOpenRouterEngine(opts) {
       const count = "count" in req ? req.count : 1;
       return count * perImageUsd;
     },
-    async generate(req, signal) {
+    async generate(req, signal, onImage) {
       const key = requireKey();
       const roles = req.referenceRoles ?? [];
       const refs = req.referenceImages ?? [];
@@ -1666,7 +2086,9 @@ function createOpenRouterEngine(opts) {
           signal
         );
         raws.push(json);
-        for (const buf of extractImages(json)) hashes.push(opts.saveImage(buf));
+        const own = extractImages(json).map((buf) => opts.saveImage(buf));
+        hashes.push(...own);
+        if (own[0]) onImage?.(i, own[0]);
         if (typeof json?.usage?.cost === "number") {
           reportedCost += json.usage.cost;
           sawReportedCost = true;
@@ -2863,7 +3285,7 @@ function createCodexEngine(opts) {
     async costEstimate() {
       return 0;
     },
-    async generate(req, signal) {
+    async generate(req, signal, onImage) {
       const count = Math.max(1, req.count);
       const refs = req.referenceImages ?? [];
       const roles = req.referenceRoles ?? refs.map(() => "reference");
@@ -2902,6 +3324,7 @@ function createCodexEngine(opts) {
             const i = next++;
             try {
               results[i] = await jobs[i]();
+              if (results[i][0]) onImage?.(i, results[i][0]);
             } catch (err) {
               if (signal?.aborted && signal.reason !== BUDGET_EXHAUSTED) throw err;
               results[i] = [];
@@ -3041,7 +3464,30 @@ function createEngineRegistry(core, extra = []) {
     codexRunner
   };
 }
-function createDemoEngine(saveImage) {
+function demoOptionsFromEnv(env) {
+  const out = {};
+  const stagger = Number(env.SCENRI_DEMO_STAGGER_MS);
+  if (env.SCENRI_DEMO_STAGGER_MS && Number.isFinite(stagger) && stagger > 0) out.staggerMs = stagger;
+  if (env.SCENRI_DEMO_ORDER === "reverse") out.order = "reverse";
+  const fail = Number(env.SCENRI_DEMO_FAIL_SLOT);
+  if (env.SCENRI_DEMO_FAIL_SLOT && Number.isInteger(fail) && fail >= 0) out.failSlot = fail;
+  return out;
+}
+function sleep2(ms, signal) {
+  return new Promise((resolve) => {
+    if (signal?.aborted) return resolve();
+    const onAbort = () => {
+      clearTimeout(timer);
+      resolve();
+    };
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+function createDemoEngine(saveImage, opts = {}) {
   const paletteOf = (req) => {
     const p = req.brand?.brand?.palette;
     const hexes = [p?.primary?.hex, p?.secondary?.hex, ...(p?.accent ?? []).map((a) => a?.hex)].filter(
@@ -3062,7 +3508,7 @@ function createDemoEngine(saveImage) {
       <text x="24" y="${h - 48}" font-family="Helvetica, Arial" font-size="${Math.max(14, Math.round(w / 42))}" fill="#ffffff" opacity="0.92">${esc(label)}</text>
       <text x="24" y="${h - 22}" font-family="Helvetica, Arial" font-size="12" fill="#ffffff" opacity="0.6">Scenri demo engine</text>
     </svg>`;
-    return sharp20(Buffer.from(svg)).png().toBuffer();
+    return sharp21(Buffer.from(svg)).png().toBuffer();
   }
   return {
     capabilities() {
@@ -3087,13 +3533,31 @@ function createDemoEngine(saveImage) {
     async costEstimate() {
       return 0;
     },
-    async generate(req) {
+    async generate(req, signal, onImage) {
       const colors = paletteOf(req);
-      const images = [];
-      for (let i = 0; i < Math.max(1, req.count); i++) {
-        images.push(saveImage(await render(colors, req.prompt, req.width, req.height, i + req.prompt.length)));
-      }
-      return { images, costUsd: 0 };
+      const count = Math.max(1, req.count);
+      const slots = Array.from({ length: count }, (_, i) => i);
+      if (opts.order === "reverse") slots.reverse();
+      const landed = /* @__PURE__ */ new Map();
+      const failures = [];
+      for (const [position, slot] of slots.entries()) {
+        if (position > 0 && opts.staggerMs) await sleep2(opts.staggerMs, signal);
+        if (signal?.aborted) {
+          if (signal.reason === BUDGET_EXHAUSTED) break;
+          throw Object.assign(new Error("generation cancelled"), { name: "AbortError" });
+        }
+        if (slot === opts.failSlot) {
+          failures.push(`demo: slot ${slot + 1} refused`);
+          continue;
+        }
+        const hash = saveImage(await render(colors, req.prompt, req.width, req.height, slot + req.prompt.length));
+        landed.set(slot, hash);
+        onImage?.(slot, hash);
+      }
+      const done = [...landed.keys()].sort((a, b) => a - b);
+      const images = done.map((slot) => landed.get(slot));
+      if (done.length === count) return { images, costUsd: 0 };
+      return { images, costUsd: 0, raw: { requested: count, variantIndexes: done, partialFailures: failures } };
     },
     async edit(req) {
       const colors = paletteOf(req);
@@ -3235,7 +3699,7 @@ var resolvedRefs = /* @__PURE__ */ new Map();
 async function refHash(core, path) {
   const hit = resolvedRefs.get(path);
   if (hit && core.images.has(hit)) return hit;
-  const hash = core.images.save(await sharp20(readFileSync(path)).png().toBuffer());
+  const hash = core.images.save(await sharp21(readFileSync(path)).png().toBuffer());
   resolvedRefs.set(path, hash);
   return hash;
 }
@@ -3335,14 +3799,21 @@ function demoProductFacetsOf(demoProducts) {
 function demoProductRefPath(templatesRoot, id, angle) {
   return contentFile(templatesRoot, "previews", "demo-products", id, `${angle}.jpg`);
 }
+var resolvedRefs2 = /* @__PURE__ */ new Map();
+async function refHash2(core, path) {
+  const hit = resolvedRefs2.get(path);
+  if (hit && core.images.has(hit)) return hit;
+  const hash = core.images.save(await sharp21(readFileSync(path)).png().toBuffer());
+  resolvedRefs2.set(path, hash);
+  return hash;
+}
 async function resolveDemoProductImages(core, templatesRoot, product) {
   const angles = PRODUCT_ANGLES_BY_CATEGORY[product.category] ?? PRODUCT_ANGLES_BY_CATEGORY.other;
   const shots = [];
   for (const angle of angles) {
     const path = demoProductRefPath(templatesRoot, product.id, angle);
     if (!existsSync(path)) continue;
-    const png = await sharp20(readFileSync(path)).png().toBuffer();
-    const hash = core.images.save(png);
+    const hash = await refHash2(core, path);
     shots.push({ file: `asset:${hash}`, angle, locked: true });
   }
   if (!shots.length) return null;
@@ -3398,6 +3869,15 @@ function defaultDemoProductsDir() {
 }
 
 // src/attachmentBudget.ts
+var SEAT_TIER = {
+  brand: 0,
+  reference: 0,
+  product: 0,
+  character: 0,
+  scene: 0,
+  composition: 1,
+  style: 2
+};
 var ROLE_PRIORITY = {
   product: 0,
   character: 1,
@@ -3420,11 +3900,8 @@ function allocateAttachments(attachments, cap2) {
     kept.add(x.i);
     keptGroups.add(groupOf(x.a));
   };
-  for (const x of legacyOrder) {
-    if (kept.size >= max) break;
-    if (x.a.essential) admit(x);
-  }
-  for (const x of legacyOrder) {
+  const seatOrder = [...indexed].sort((x, y) => SEAT_TIER[x.a.role] - SEAT_TIER[y.a.role] || x.i - y.i);
+  for (const x of seatOrder) {
     if (kept.size >= max) break;
     if (!kept.has(x.i) && !keptGroups.has(groupOf(x.a))) admit(x);
   }
@@ -3449,7 +3926,13 @@ function allocateAttachments(attachments, cap2) {
   }
   return {
     kept: legacyOrder.filter((x) => kept.has(x.i)).map((x) => x.a),
-    dropped: legacyOrder.filter((x) => !kept.has(x.i)).map((x) => x.a)
+    dropped: legacyOrder.filter((x) => !kept.has(x.i)).map((x) => x.a),
+    // The same images in the order the brief placed them, for a caller that
+    // will allocate again: `kept` is re-sorted by role for the consumers
+    // below, and feeding that back into a second, tighter allocation put
+    // every product ahead of every face on a refinement whatever the line
+    // said.
+    seated: seatOrder.filter((x) => kept.has(x.i)).map((x) => x.a)
   };
 }
 function mergeEditAttachments(own, inherited, cap2) {
@@ -3480,7 +3963,7 @@ var assetHash = (ref) => {
 };
 var LOGO_ROLES = ["primary", "mark", "wordmark", "monochrome", "alternate"];
 var LOGO_BACKGROUNDS = ["light", "dark", "any"];
-var toPng = (buf) => sharp20(buf).rotate().png().toBuffer();
+var toPng = (buf) => sharp21(buf).rotate().png().toBuffer();
 var COST_PROBE = {
   prompt: "",
   brand: { brand: {}, assetPaths: {} },
@@ -3493,11 +3976,11 @@ var MARK_MIN_EDGE = 1024;
 var MARK_TINY_EDGE = 256;
 var MARK_WARN_EDGE = 512;
 var toMarkPng = async (buf) => {
-  const out = await sharp20(buf, { density: 384 }).rotate().resize({ width: MARK_MAX_EDGE, height: MARK_MAX_EDGE, fit: "inside", withoutEnlargement: true }).png().toBuffer();
-  const meta = await sharp20(out).metadata();
+  const out = await sharp21(buf, { density: 384 }).rotate().resize({ width: MARK_MAX_EDGE, height: MARK_MAX_EDGE, fit: "inside", withoutEnlargement: true }).png().toBuffer();
+  const meta = await sharp21(out).metadata();
   const edge = Math.max(meta.width ?? 0, meta.height ?? 0);
   if (edge >= MARK_TINY_EDGE && edge < MARK_MIN_EDGE) {
-    return sharp20(out).resize({ width: MARK_MIN_EDGE, height: MARK_MIN_EDGE, fit: "inside", kernel: "lanczos3" }).png().toBuffer();
+    return sharp21(out).resize({ width: MARK_MIN_EDGE, height: MARK_MIN_EDGE, fit: "inside", kernel: "lanczos3" }).png().toBuffer();
   }
   return out;
 };
@@ -3508,9 +3991,9 @@ async function capReferenceEdge(core, path, maxEdge) {
   if (hit) return hit;
   let out = path;
   try {
-    const meta = await sharp20(path).metadata();
+    const meta = await sharp21(path).metadata();
     if ((meta.width ?? 0) > maxEdge || (meta.height ?? 0) > maxEdge) {
-      const buf = await sharp20(path).resize({ width: maxEdge, height: maxEdge, fit: "inside", withoutEnlargement: true }).png().toBuffer();
+      const buf = await sharp21(path).resize({ width: maxEdge, height: maxEdge, fit: "inside", withoutEnlargement: true }).png().toBuffer();
       out = core.images.pathFor(core.images.save(buf));
     }
   } catch {
@@ -3614,12 +4097,19 @@ function shotSpecifiesCamera(text) {
     text
   );
 }
+function namesAreNotLetteringDirective() {
+  return "The names in this brief identify what to show and are never text to render: no caption, label, signage, engraving or lettering spells a product name or a person's name, in any language or script, anywhere in the picture. Printing that is part of a product's own packaging stays exactly as photographed, and nothing else spells a name unless the direction above explicitly asks for it to be written.";
+}
 function sceneFigureDirectives(opts) {
   const figure = opts.figure.trim().replace(/[.\s]+$/, "");
   if (!figure) return [];
   const treatment = (opts.treatment ?? "").trim().replace(/[.\s]+$/, "");
   const out = [];
-  if (opts.hasPerson) {
+  if (opts.hasPerson && (opts.people ?? 1) > 1) {
+    out.push(
+      `This world is built around one figure: ${figure}. The attached presenters share that role: the first named presenter takes the figure position and the others stand with them in the same frame, every one of them clearly visible. Any person the scene direction describes IS one of the attached presenters and never an extra person, and each identity comes from their own attached photograph alone, never from anything the scene direction says about a body.`
+    );
+  } else if (opts.hasPerson) {
     out.push(
       `This world is built around one figure: ${figure}. The attached presenter is that figure. Any person the scene direction describes IS the presenter and never a second person, and their identity comes from their own attached photograph alone, never from anything the scene direction says about a body.`
     );
@@ -3740,6 +4230,8 @@ function validateBrief(brief) {
       case "ref":
       case "mark":
         if (!str4(t.imageHash)) errors.push(`${at}.imageHash must be a non-empty string`);
+        if (t.t === "ref" && t.label !== void 0 && typeof t.label !== "string")
+          errors.push(`${at}.label must be a string when present`);
         break;
       case "format":
         if (!Number.isFinite(t.w) || !Number.isFinite(t.h) || Number(t.w) <= 0 || Number(t.h) <= 0)
@@ -3766,6 +4258,7 @@ function compileBrief(brief, ctx) {
   const characters = ctx.brand?.characters ?? [];
   const inlineTemplates = [];
   let hasPerson = false;
+  let people = 0;
   let sentence = "";
   const append = (s) => {
     sentence += (sentence && !sentence.endsWith(" ") ? " " : "") + s;
@@ -3825,6 +4318,7 @@ function compileBrief(brief, ctx) {
           break;
         }
         hasPerson = true;
+        people += 1;
         append(c.promptName ?? c.name);
         const cshots = (c.shots ?? []).slice(0, CHARACTER_REF_MAX).map((s) => ({ h: assetHash2(s?.file), angle: s?.angle ? String(s.angle) : void 0 })).filter((x) => !!x.h && ctx.images.has(x.h));
         if (cshots.length) {
@@ -3869,8 +4363,10 @@ function compileBrief(brief, ctx) {
       }
       case "color": {
         const hex = tok.hex.toUpperCase();
-        append(tok.name ? `${tok.name} (${hex})` : hex);
-        otherDirectives.push(`Use ${hex} as a defining color in the composition.`);
+        append(tok.name ? `(brand color ${tok.name} ${hex})` : `(brand color ${hex})`);
+        otherDirectives.push(
+          `Use ${hex} as a defining color in the composition, in surfaces, materials and light, never as lettering.`
+        );
         break;
       }
       case "ref": {
@@ -4007,7 +4503,7 @@ function compileBrief(brief, ctx) {
     }
   }
   const max = ctx.engineCaps.maxReferenceImages;
-  const { kept, dropped: budgetDropped } = allocateAttachments(attachments, max);
+  const { kept, dropped: budgetDropped, seated } = allocateAttachments(attachments, max);
   const presentKeys = new Set((ctx.presentAttachments ?? kept).map((a) => `${a.role}:${a.hash}`));
   const resolveDirective = (d) => {
     if (typeof d === "string") return d;
@@ -4019,6 +4515,24 @@ function compileBrief(brief, ctx) {
     }
     return presentKeys.has(`${d.role}:${d.hash}`) ? d.text : null;
   };
+  const absentDirectives = [];
+  const absentSeen = /* @__PURE__ */ new Set();
+  for (const a of attachments) {
+    const key = `${a.role}:${a.hash}`;
+    if (presentKeys.has(key) || absentSeen.has(key)) continue;
+    if (a.role === "reference") {
+      absentSeen.add(key);
+      const words = ctx.wordsFor?.(a.hash) ?? null;
+      absentDirectives.push(
+        words ? `A reference shot was not attached this time; it showed ${words}. Match that composition, lighting and treatment.` : "A reference image was attached but not sent this time."
+      );
+    } else if (a.role === "brand") {
+      absentSeen.add(key);
+      absentDirectives.push(
+        `The brand mark "${a.label}" was not attached this time; keep every branded surface plain and do not invent a logo.`
+      );
+    }
+  }
   const guard = scene ? sceneGuardDirectives({
     hasProduct: !!productId,
     hasPerson,
@@ -4035,10 +4549,12 @@ function compileBrief(brief, ctx) {
     "Any earlier instruction that bans props, hands, people, or a presenter from the frame is a solo-packshot rule for this product and does not apply to this shot: the attached presenter is deliberate and must appear as directed.",
     productHandlingDirective()
   ] : [];
+  const nameDirectives = productId || hasPerson ? [namesAreNotLetteringDirective()] : [];
   const figureDirectives = scene?.figure ? sceneFigureDirectives({
     figure: scene.figure,
     treatment: scene.figureTreatment,
     hasPerson,
+    people,
     // The treatment's fictional-brands rule needs to know a real mark is
     // deliberately in play - and only one that actually rides counts,
     // same honesty rule as the photo guard above.
@@ -4067,12 +4583,16 @@ function compileBrief(brief, ctx) {
   }) ? [garmentDisplayDirective()] : [];
   const refGuard = ctx.mode !== "edit" && hasPerson && kept.some((a) => a.role === "reference") ? [referenceIdentityGuard()] : [];
   const allDirectives = [
+    // First, beside the sentence that names things: the model reads the names
+    // and this line in one breath, before any spec repeats them.
+    ...nameDirectives,
     ...productDirectives,
     ...personDirectives,
     ...pairDirectives,
     ...figureDirectives,
     ...closeUpDirectives,
     ...otherDirectives,
+    ...absentDirectives,
     ...cameraDirectives,
     ...apparelUnworn,
     ...brandLines,
@@ -4082,15 +4602,14 @@ function compileBrief(brief, ctx) {
   ];
   const spoken = dedupe(allDirectives.map(resolveDirective).filter((s) => s !== null));
   if (spoken.length) prompt = `${prompt}${prompt.endsWith(".") ? "" : "."} ${spoken.join(" ")}`;
-  if (budgetDropped.some((d) => d.role !== "scene")) {
+  if (max === 0 && budgetDropped.some((d) => d.role !== "scene")) {
     const keptLabels = new Set(kept.map((a) => a.label));
     const names = [...new Set(budgetDropped.filter((d) => d.role !== "scene").map((d) => d.label))].filter(
       (l) => !keptLabels.has(l)
     );
     if (names.length) {
-      const reads = max === 0 ? "reads no reference images" : `reads ${max} reference image${max === 1 ? "" : "s"}`;
       warnings.push(
-        `${names.join(" and ")} ${names.length === 1 ? "was" : "were"} left out \u2014 ${ctx.engineCaps.displayName} ${reads}.`
+        `${names.join(" and ")} ${names.length === 1 ? "was" : "were"} left out \u2014 ${ctx.engineCaps.displayName} reads no reference images.`
       );
     }
   }
@@ -4103,11 +4622,28 @@ function compileBrief(brief, ctx) {
     width,
     height,
     attachments: kept,
+    seated,
     warnings,
     productId
   };
 }
 var dedupe = (xs) => [...new Set(xs)];
+
+// src/shotWords.ts
+function shotWords(prompt, max = 160) {
+  if (!prompt) return null;
+  const head = prompt.split(/\. (?=[A-Z])/)[0]?.trim() ?? "";
+  if (!head) return null;
+  const clipped = head.length > max ? `${head.slice(0, max).replace(/\s+\S*$/, "")}\u2026` : head;
+  return clipped.replace(/[.\s]+$/, "");
+}
+function shotWordsFor(core, brandId) {
+  const byHash = /* @__PURE__ */ new Map();
+  return (hash) => {
+    if (!byHash.has(hash)) byHash.set(hash, shotWords(core.store.promptForImage(brandId, hash)));
+    return byHash.get(hash) ?? null;
+  };
+}
 var DEFAULT_CONTENT_URL = "https://github.com/tonygorb/scenri/releases/download/content-latest/scenri-content.zip";
 var TIMEOUT_MS = 10 * 60 * 1e3;
 function resolveContentUrl(env = process.env, override) {
@@ -5034,7 +5570,7 @@ function dedupeProducts(products) {
 
 // ../catalog/src/http/fetch.ts
 var USER_AGENT = "scenri-catalog/0.1 (+https://scenri.co)";
-function sleep2(ms) {
+function sleep3(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
 async function httpGet(url, opts = {}) {
@@ -5058,7 +5594,7 @@ async function httpGet(url, opts = {}) {
         }
       });
       if ((res.status === 429 || res.status >= 500) && attempt < retries) {
-        await sleep2(400 * 2 ** attempt);
+        await sleep3(400 * 2 ** attempt);
         continue;
       }
       return res;
@@ -5066,7 +5602,7 @@ async function httpGet(url, opts = {}) {
       lastErr = err;
       if (opts.signal?.aborted) throw err;
       if (attempt < retries) {
-        await sleep2(400 * 2 ** attempt);
+        await sleep3(400 * 2 ** attempt);
         continue;
       }
       throw err;
@@ -6103,8 +6639,8 @@ async function runJob(deps, jobId, brandId, url, signal) {
             errors.push({ code: "image_empty", message: "Empty image", url: img.sourceUrl });
             return;
           }
-          const png = await sharp20(buf).rotate().png().toBuffer();
-          const meta = await sharp20(png).metadata();
+          const png = await sharp21(buf).rotate().png().toBuffer();
+          const meta = await sharp21(png).metadata();
           const hash = core.images.save(png);
           core.catalog.setImageAsset(img.productId, img.sourceUrl, `asset:${hash}`, {
             width: meta.width,
@@ -6581,7 +7117,7 @@ async function generateStudioSet(deps, job, who, sourcePaths, signal) {
   return { hashes: kept.map((f) => byAngle.get(f.angle)), angles: kept.map((f) => f.angle) };
 }
 async function edgeBarGeometry(buf) {
-  const { data, info } = await sharp20(buf).greyscale().raw().toBuffer({ resolveWithObject: true });
+  const { data, info } = await sharp21(buf).greyscale().raw().toBuffer({ resolveWithObject: true });
   const W = info.width;
   const H = info.height;
   const scan = (len, cross, at) => {
@@ -6635,7 +7171,7 @@ async function trimEdgeBars(core, hash) {
     const width = g.right - g.left + 1;
     const height = g.bottom - g.top + 1;
     if (width < g.W * 0.6 || height < g.H * 0.6) return hash;
-    const png = await sharp20(buf).extract({ left: g.left, top: g.top, width, height }).png().toBuffer();
+    const png = await sharp21(buf).extract({ left: g.left, top: g.top, width, height }).png().toBuffer();
     return core.images.save(png);
   } catch {
     return hash;
@@ -6706,7 +7242,7 @@ async function identityCrop(core, hash) {
   if (!out) return void 0;
   try {
     const height = Math.min(IDENTITY_TARGET_HEIGHT, Math.round(nativeHeight * IDENTITY_MAX_UPSCALE)) || IDENTITY_TARGET_HEIGHT;
-    const png = await sharp20(core.images.read(out)).resize({ height, fit: "inside", kernel: "lanczos3", withoutEnlargement: false }).png().toBuffer();
+    const png = await sharp21(core.images.read(out)).resize({ height, fit: "inside", kernel: "lanczos3", withoutEnlargement: false }).png().toBuffer();
     const scaled = core.images.save(png);
     identityCrops.set(hash, scaled);
     return scaled;
@@ -6735,12 +7271,12 @@ async function brandJsonWithIdentityCrops(core, json, characterIds) {
   return changed ? { ...json, characters } : json;
 }
 async function figureBox(buf) {
-  const meta = await sharp20(buf).metadata();
+  const meta = await sharp21(buf).metadata();
   const W = meta.width ?? 0;
   const H = meta.height ?? 0;
   if (!W || !H) return null;
   for (const threshold of FIGURE_TRIM_THRESHOLDS) {
-    const { info } = await sharp20(buf).trim({ threshold }).toBuffer({ resolveWithObject: true });
+    const { info } = await sharp21(buf).trim({ threshold }).toBuffer({ resolveWithObject: true });
     const left = Math.abs(info.trimOffsetLeft ?? 0);
     const top = Math.abs(info.trimOffsetTop ?? 0);
     const width = info.width ?? 0;
@@ -6773,13 +7309,13 @@ async function smartCover(core, hash, box) {
   if (!hash || !core.images.has(hash)) return void 0;
   try {
     const buf = core.images.read(hash);
-    const meta = await sharp20(buf).metadata();
+    const meta = await sharp21(buf).metadata();
     const w = meta.width ?? 0;
     const h = meta.height ?? 0;
     if (!w || !h) return void 0;
     const raw = box(w, h);
     const target = { width: Math.max(1, raw.width), height: Math.max(1, raw.height) };
-    const png = await sharp20(buf).resize(target.width, target.height, { fit: "cover", position: "attention" }).png().toBuffer();
+    const png = await sharp21(buf).resize(target.width, target.height, { fit: "cover", position: "attention" }).png().toBuffer();
     return core.images.save(png);
   } catch {
     return void 0;
@@ -6788,11 +7324,11 @@ async function smartCover(core, hash, box) {
 async function crop(core, hash, region, cap2) {
   if (!hash || !core.images.has(hash)) return void 0;
   try {
-    const meta = await sharp20(core.images.read(hash)).metadata();
+    const meta = await sharp21(core.images.read(hash)).metadata();
     const w = meta.width ?? 0;
     const h = meta.height ?? 0;
     if (!w || !h) return void 0;
-    let pipeline = sharp20(core.images.read(hash)).extract(region(w, h));
+    let pipeline = sharp21(core.images.read(hash)).extract(region(w, h));
     if (cap2) pipeline = pipeline.resize(cap2, cap2, { fit: "inside", withoutEnlargement: true });
     const png = await pipeline.png().toBuffer();
     return core.images.save(png);
@@ -7139,7 +7675,7 @@ var fromLab = (l, a, bb) => {
   return [clamp(R), clamp(G), clamp(B)];
 };
 var rawAt = async (png, edge) => {
-  let img = sharp20(png);
+  let img = sharp21(png);
   if (edge) img = img.resize(edge, edge, { fit: "fill" });
   const { data, info } = await img.removeAlpha().raw().toBuffer({ resolveWithObject: true });
   return { data, width: info.width, height: info.height };
@@ -7202,7 +7738,7 @@ async function gradeComposite(originalPng, modelInputPng, modelOutputPng) {
     if (residual > GRADE_GATE_MEAN_DELTA) return null;
     const full = await rawAt(originalPng);
     applyAffine(full, T);
-    const image = await sharp20(full.data, {
+    const image = await sharp21(full.data, {
       raw: { width: full.width, height: full.height, channels: 3 }
     }).png().toBuffer();
     return { image, residual };
@@ -7376,7 +7912,7 @@ function fitExpandToBudget(plan, source, pixelBudget) {
 }
 async function attentionCropOrigin(srcBuf, source, plan) {
   try {
-    const { info } = await sharp20(srcBuf).resize(plan.width, plan.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
+    const { info } = await sharp21(srcBuf).resize(plan.width, plan.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
     const attnLeft = typeof info.cropOffsetLeft === "number" ? Math.abs(info.cropOffsetLeft) : plan.left;
     const attnTop = typeof info.cropOffsetTop === "number" ? Math.abs(info.cropOffsetTop) : plan.top;
     const left = Math.round((attnLeft + plan.left) / 2);
@@ -7529,23 +8065,23 @@ function relax(grid, seam, fixedSweeps) {
 
 // src/expand.ts
 async function expandCanvas(source, plan) {
-  const bed = await sharp20(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
-  return sharp20(bed).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
+  const bed = await sharp21(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
+  return sharp21(bed).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
 }
 async function compositeExpand(engineImage, source, plan) {
-  const meta = await sharp20(engineImage).metadata();
+  const meta = await sharp21(engineImage).metadata();
   const want = plan.width / plan.height;
   const got = meta.width && meta.height ? meta.width / meta.height : 0;
   const sameOrientation = got > 0 && got >= 1 === want >= 1;
   const aligned = sameOrientation;
   const exact = meta.width === plan.width && meta.height === plan.height;
-  const surround = aligned ? exact ? engineImage : await sharp20(engineImage).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).toBuffer() : await expandCanvasBedOnly(source, plan);
+  const surround = aligned ? exact ? engineImage : await sharp21(engineImage).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).toBuffer() : await expandCanvasBedOnly(source, plan);
   const matched = aligned ? await matchMarginsToSeam(surround, source, plan) : surround;
-  const image = await sharp20(matched).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
+  const image = await sharp21(matched).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
   return { image, aligned };
 }
 async function matchMarginsToSeam(surround, source, plan) {
-  const src = await sharp20(source).metadata();
+  const src = await sharp21(source).metadata();
   if (!src.width || !src.height) return surround;
   const SW = src.width;
   const SH = src.height;
@@ -7592,8 +8128,8 @@ var MAX_CORRECTION = 60;
 async function reconcile(surround, source, side, axis) {
   const { margin } = side;
   if (margin.width < 1 || margin.height < 1) return surround;
-  const marginRaw = await sharp20(surround).extract(margin).removeAlpha().raw().toBuffer();
-  const edgeRaw = await sharp20(source).extract(side.srcEdge).removeAlpha().raw().toBuffer();
+  const marginRaw = await sharp21(surround).extract(margin).removeAlpha().raw().toBuffer();
+  const edgeRaw = await sharp21(source).extract(side.srcEdge).removeAlpha().raw().toBuffer();
   const W = margin.width;
   const H = margin.height;
   const along = axis === "width" ? H : W;
@@ -7647,11 +8183,11 @@ async function reconcile(surround, source, side, axis) {
       }
     }
   }
-  const patch2 = await sharp20(corrected, { raw: { width: W, height: H, channels: 3 } }).png().toBuffer();
-  return sharp20(surround).composite([{ input: patch2, left: margin.left, top: margin.top }]).toBuffer();
+  const patch2 = await sharp21(corrected, { raw: { width: W, height: H, channels: 3 } }).png().toBuffer();
+  return sharp21(surround).composite([{ input: patch2, left: margin.left, top: margin.top }]).toBuffer();
 }
 async function expandCanvasBedOnly(source, plan) {
-  return sharp20(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
+  return sharp21(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
 }
 function medianOf(rgb, channel, from, to) {
   const n = to - from;
@@ -7662,17 +8198,17 @@ function medianOf(rgb, channel, from, to) {
   return n % 2 ? values[(n - 1) / 2] : (values[n / 2 - 1] + values[n / 2]) / 2;
 }
 async function reframeExpand(engineImage, plan) {
-  const meta = await sharp20(engineImage).metadata();
+  const meta = await sharp21(engineImage).metadata();
   if (!(meta.width && meta.height)) return null;
   const want = plan.width / plan.height;
   const got = meta.width / meta.height;
   if (got >= 1 !== want >= 1) return null;
   if (meta.width === plan.width && meta.height === plan.height) return engineImage;
   const straight = Math.abs(got - want) / want <= 0.02;
-  return sharp20(engineImage).resize(plan.width, plan.height, { fit: straight ? "fill" : "cover", position: "centre" }).png().toBuffer();
+  return sharp21(engineImage).resize(plan.width, plan.height, { fit: straight ? "fill" : "cover", position: "centre" }).png().toBuffer();
 }
 async function seamScore(image, plan, source) {
-  const { data, info } = await sharp20(image).removeAlpha().greyscale().raw().toBuffer({ resolveWithObject: true });
+  const { data, info } = await sharp21(image).removeAlpha().greyscale().raw().toBuffer({ resolveWithObject: true });
   const W = info.width;
   const H = info.height;
   const horizontal = plan.axis === "width";
@@ -7705,7 +8241,7 @@ var SEAM_VISIBLE = 2.2;
 var OFFSET = 4;
 var RESIDUAL_VISIBLE = 15;
 async function seamResidual(image, plan, source) {
-  const { data, info } = await sharp20(image).removeAlpha().raw().toBuffer({ resolveWithObject: true });
+  const { data, info } = await sharp21(image).removeAlpha().raw().toBuffer({ resolveWithObject: true });
   const W = info.width;
   const H = info.height;
   const ch = info.channels;
@@ -7740,7 +8276,7 @@ var MAX_SHARE = 0.8;
 async function subjectFraction(src, source, axis) {
   try {
     const window = axis === "width" ? { width: Math.max(8, Math.round(source.width * 0.5)), height: source.height } : { width: source.width, height: Math.max(8, Math.round(source.height * 0.5)) };
-    const { info } = await sharp20(src).resize(window.width, window.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
+    const { info } = await sharp21(src).resize(window.width, window.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
     const offset = axis === "width" ? Math.abs(typeof info.cropOffsetLeft === "number" ? info.cropOffsetLeft : 0) : Math.abs(typeof info.cropOffsetTop === "number" ? info.cropOffsetTop : 0);
     const span = axis === "width" ? source.width : source.height;
     const extent = axis === "width" ? window.width : window.height;
@@ -7763,14 +8299,14 @@ function placeExpand(plan, source, fraction) {
 }
 var NEUTRAL = { r: 128, g: 128, b: 128 };
 async function conditioningCanvas(source, plan, fill = "edge") {
-  const meta = await sharp20(source).metadata();
+  const meta = await sharp21(source).metadata();
   const sw = meta.width ?? 0;
   const sh = meta.height ?? 0;
   if (!(sw > 0 && sh > 0)) throw new Error("conditioningCanvas: source has no dimensions");
   const layers = [];
   if (fill === "edge") layers.push(...await edgeMargins(source, plan, { width: sw, height: sh }));
   layers.push({ input: source, left: plan.left, top: plan.top });
-  const canvas = sharp20({
+  const canvas = sharp21({
     create: {
       width: plan.width,
       height: plan.height,
@@ -7782,7 +8318,7 @@ async function conditioningCanvas(source, plan, fill = "edge") {
 }
 async function edgeMargins(source, plan, size) {
   const out = [];
-  const strip = async (extract, width, height) => sharp20(source).extract(extract).resize(width, height, { fit: "fill" }).png().toBuffer();
+  const strip = async (extract, width, height) => sharp21(source).extract(extract).resize(width, height, { fit: "fill" }).png().toBuffer();
   if (plan.axis === "width") {
     const before = plan.left;
     const after = plan.width - plan.left - size.width;
@@ -7873,12 +8409,12 @@ async function resolveOutpaintRoute(all, shot) {
   return { engine: shot, method: "reframe", crossed: false };
 }
 async function driftDiff(a, b) {
-  const metaA = await sharp20(a).metadata();
-  const metaB = await sharp20(b).metadata();
+  const metaA = await sharp21(a).metadata();
+  const metaB = await sharp21(b).metadata();
   const width = Math.min(metaA.width ?? 1, metaB.width ?? 1, 1024);
   const height = Math.min(metaA.height ?? 1, metaB.height ?? 1, 1024);
   const [rawA, rawB] = await Promise.all(
-    [a, b].map((buf) => sharp20(buf).resize(width, height, { fit: "cover" }).ensureAlpha().raw().toBuffer())
+    [a, b].map((buf) => sharp21(buf).resize(width, height, { fit: "cover" }).ensureAlpha().raw().toBuffer())
   );
   const out = new PNG({ width, height });
   const changed = pixelmatch(rawA, rawB, out.data, width, height, { threshold: 0.1, diffColor: [255, 64, 64] });
@@ -7890,11 +8426,11 @@ async function driftDiff(a, b) {
   };
 }
 async function changeMask(a, b, cap2 = 1024) {
-  const metaA = await sharp20(a).metadata();
+  const metaA = await sharp21(a).metadata();
   const width = Math.min(metaA.width ?? 1, cap2);
   const height = Math.min(metaA.height ?? 1, cap2);
   const [rawA, rawB] = await Promise.all(
-    [a, b].map((buf) => sharp20(buf).resize(width, height, { fit: "fill" }).ensureAlpha().raw().toBuffer())
+    [a, b].map((buf) => sharp21(buf).resize(width, height, { fit: "fill" }).ensureAlpha().raw().toBuffer())
   );
   const out = new PNG({ width, height });
   pixelmatch(rawA, rawB, out.data, width, height, { threshold: 0.1, includeAA: true, diffMask: true });
@@ -7943,8 +8479,8 @@ function dilationFor(longEdge) {
 // src/localEdit.ts
 async function preserveOutsideChange(source, edited) {
   try {
-    const srcMeta = await sharp20(source).metadata();
-    const outMeta = await sharp20(edited).metadata();
+    const srcMeta = await sharp21(source).metadata();
+    const outMeta = await sharp21(edited).metadata();
     if (!srcMeta.width || !srcMeta.height || !outMeta.width || !outMeta.height)
       return { image: edited, outcome: "error", changed: 0 };
     const sameShape = Math.abs(outMeta.width / outMeta.height - srcMeta.width / srcMeta.height) / (srcMeta.width / srcMeta.height) <= 0.01;
@@ -7954,15 +8490,15 @@ async function preserveOutsideChange(source, edited) {
     if (outcome !== "composited") return { image: edited, outcome, changed: shape.changed };
     const r = dilationFor(Math.max(shape.width, shape.height));
     const rawShape = { raw: { width: shape.width, height: shape.height, channels: 1 } };
-    const spread = await sharp20(shape.mask, rawShape).blur(r).toColourspace("b-w").raw().toBuffer();
-    const dilated = await sharp20(spread, rawShape).threshold(8).toColourspace("b-w").raw().toBuffer();
-    const feathered = await sharp20(dilated, rawShape).blur(Math.max(2, r / 3)).toColourspace("b-w").raw().toBuffer();
-    const grown = await sharp20(feathered, rawShape).resize(srcMeta.width, srcMeta.height, { fit: "fill", kernel: "cubic" }).toColourspace("b-w").raw().toBuffer();
-    const editedRgb = await sharp20(edited).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).removeAlpha().raw().toBuffer();
-    const masked = await sharp20(editedRgb, {
+    const spread = await sharp21(shape.mask, rawShape).blur(r).toColourspace("b-w").raw().toBuffer();
+    const dilated = await sharp21(spread, rawShape).threshold(8).toColourspace("b-w").raw().toBuffer();
+    const feathered = await sharp21(dilated, rawShape).blur(Math.max(2, r / 3)).toColourspace("b-w").raw().toBuffer();
+    const grown = await sharp21(feathered, rawShape).resize(srcMeta.width, srcMeta.height, { fit: "fill", kernel: "cubic" }).toColourspace("b-w").raw().toBuffer();
+    const editedRgb = await sharp21(edited).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).removeAlpha().raw().toBuffer();
+    const masked = await sharp21(editedRgb, {
       raw: { width: srcMeta.width, height: srcMeta.height, channels: 3 }
     }).joinChannel(grown, { raw: { width: srcMeta.width, height: srcMeta.height, channels: 1 } }).png().toBuffer();
-    const image = await sharp20(source).removeAlpha().composite([{ input: masked }]).png().toBuffer();
+    const image = await sharp21(source).removeAlpha().composite([{ input: masked }]).png().toBuffer();
     return { image, outcome: "composited", changed: shape.changed };
   } catch {
     return { image: edited, outcome: "error", changed: 0 };
@@ -8000,7 +8536,7 @@ function registerLogoRoutes(app, deps) {
     const v = validateBrand(json);
     if (!v.valid) return reply.status(400).send({ error: "brand became invalid", details: v.errors });
     const row = core.store.updateBrand(brand.id, json);
-    const meta = await sharp20(core.images.read(part.hash)).metadata().catch(() => null);
+    const meta = await sharp21(core.images.read(part.hash)).metadata().catch(() => null);
     const logoEdge = meta ? Math.max(meta.width ?? 0, meta.height ?? 0) || null : null;
     return { ...row, logoHash: part.hash, logoEdge };
   });
@@ -8036,11 +8572,6 @@ function registerLogoRoutes(app, deps) {
     if (!v.valid) return reply.status(400).send({ error: "brand became invalid", details: v.errors });
     return core.store.updateBrand(brand.id, json);
   });
-  app.get("/api/brands/:id/directives", async (req, reply) => {
-    const brand = core.store.getBrand(req.params.id);
-    if (!brand) return reply.status(404).send({ error: "brand not found" });
-    return { directives: brandRuleDirectives(brand.json) };
-  });
   app.delete("/api/brands/:id/logos/:hash", async (req, reply) => {
     const brand = core.store.getBrand(req.params.id);
     if (!brand) return reply.status(404).send({ error: "brand not found" });
@@ -8127,7 +8658,7 @@ async function vibrantColor(input) {
   let data;
   let channels;
   try {
-    const out = await sharp20(input).resize(48, 48, { fit: "inside" }).raw().toBuffer({ resolveWithObject: true });
+    const out = await sharp21(input).resize(48, 48, { fit: "inside" }).raw().toBuffer({ resolveWithObject: true });
     data = out.data;
     channels = out.info.channels;
   } catch {
@@ -8150,7 +8681,7 @@ async function vibrantColor(input) {
   const best = buckets.reduce((a, b) => b.score > a.score ? b : a, buckets[0]);
   if (best.score <= 0) {
     try {
-      const { dominant } = await sharp20(input).stats();
+      const { dominant } = await sharp21(input).stats();
       return toHex(dominant.r, dominant.g, dominant.b);
     } catch {
       return null;
@@ -8659,8 +9190,22 @@ function registerShowcaseRoutes(app, deps) {
 }
 
 // src/routes/projects.ts
+var SORTS = ["newest", "oldest", "cost", "keepers"];
+var NAMES_TTL_MS = 2e3;
+var NAMES_MAX = 50;
 function registerProjectRoutes(app, deps) {
   const { core } = deps;
+  const names = /* @__PURE__ */ new Map();
+  const tokenNames = (brand) => {
+    const key = `${brand.id}:${brand.updatedAt}`;
+    const now = Date.now();
+    const hit = names.get(key);
+    if (hit && now - hit.at < NAMES_TTL_MS) return hit.list;
+    const list2 = deps.tokenNames(brand);
+    if (names.size >= NAMES_MAX) names.delete(names.keys().next().value);
+    names.set(key, { at: now, list: list2 });
+    return list2;
+  };
   app.post("/api/projects", async (req, reply) => {
     const { brandId, name } = req.body;
     if (!core.store.getBrand(String(brandId))) return reply.status(404).send({ error: "brand not found" });
@@ -8684,10 +9229,61 @@ function registerProjectRoutes(app, deps) {
     const project = core.store.workspaceFor(brand.id);
     return {
       project,
-      nodes: core.store.treeFor(project.id),
+      root: core.store.rootFor(project.id)?.id ?? null,
       sets: core.store.listSets(brand.id),
-      membership: core.store.membershipFor(brand.id)
+      membership: core.store.membershipFor(brand.id),
+      recent: core.store.recentShots(project.id, 48)
+    };
+  });
+  app.get("/api/brands/:id/feed", async (req, reply) => {
+    const brand = core.store.getBrand(req.params.id);
+    if (!brand) return reply.status(404).send({ error: "brand not found" });
+    const project = core.store.workspaceFor(brand.id);
+    const qs = req.query ?? {};
+    const lens = qs.lens === "keepers" || qs.lens === "archived" ? qs.lens : "all";
+    const sort = SORTS.includes(qs.sort) ? qs.sort : "newest";
+    const tokens = qs.token ? qs.token.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+    const q = qs.q ?? "";
+    let terms;
+    if (q.trim()) {
+      const known = tokenNames(brand);
+      const engines = deps.engineNames();
+      terms = searchTerms(q).map((t) => ({
+        ...t,
+        tokenIds: known.filter((n) => termMatches(n.name, t)).map((n) => n.id),
+        engineIds: engines.filter((e) => termMatches(e.name, t)).map((e) => e.id)
+      }));
+    }
+    const filter = {
+      lens,
+      set: qs.set || void 0,
+      ungrouped: qs.ungrouped === "1" || qs.ungrouped === "true",
+      lineage: qs.lineage || void 0,
+      tokens: tokens?.length ? tokens : void 0,
+      terms
     };
+    let page;
+    try {
+      page = core.store.feedPage(project.id, {
+        ...filter,
+        sort,
+        limit: Number(qs.limit) || 60,
+        cursor: qs.cursor || null
+      });
+    } catch (err) {
+      if (/cursor/.test(String(err.message))) return reply.status(400).send({ error: "invalid cursor" });
+      throw err;
+    }
+    return qs.cursor ? page : { ...page, counts: core.store.feedCounts(project.id, filter) };
+  });
+  app.get("/api/nodes/:id/lineage", async (req, reply) => {
+    const lineage = core.store.lineageOf(req.params.id);
+    return lineage ?? reply.status(404).send({ error: "node not found" });
+  });
+  app.get("/api/brands/:id/usage", async (req, reply) => {
+    const brand = core.store.getBrand(req.params.id);
+    if (!brand) return reply.status(404).send({ error: "brand not found" });
+    return { days: core.store.usageByDay(brand.id) };
   });
   app.get("/api/brands/:id/sets", async (req, reply) => {
     const brand = core.store.getBrand(req.params.id);
@@ -8720,13 +9316,13 @@ function registerProjectRoutes(app, deps) {
     const nodeIds = (Array.isArray(raw) ? raw : []).map(String).filter((id) => core.store.getNode(id));
     if (nodeIds.length === 0) return reply.status(400).send({ error: "nodeIds must name at least one shot" });
     core.store.addToSet(set.id, nodeIds);
-    return { ok: true, added: nodeIds.length };
+    return { ok: true, added: nodeIds.length, nodeIds: core.store.membersOf(set.id) };
   });
   app.delete("/api/sets/:id/nodes/:nodeId", async (req, reply) => {
     const { id, nodeId } = req.params;
     if (!core.store.getSet(id)) return reply.status(404).send({ error: "set not found" });
     core.store.removeFromSet(id, nodeId);
-    return { ok: true };
+    return { ok: true, nodeIds: core.store.membersOf(id) };
   });
 }
 
@@ -8769,7 +9365,7 @@ async function buildExportZip(image, baseName, presetIds) {
   const chosen = EXPORT_PRESETS.filter((p) => presetIds.includes(p.id));
   if (chosen.length === 0) throw new Error("No valid export presets selected");
   for (const p of chosen) {
-    const buf = p.width && p.height ? await sharp20(image).resize(p.width, p.height, { fit: "cover", position: "attention" }).png().toBuffer() : image;
+    const buf = p.width && p.height ? await sharp21(image).resize(p.width, p.height, { fit: "cover", position: "attention" }).png().toBuffer() : image;
     zip.file(`${baseName}-${p.id}.png`, buf);
   }
   return zip.generateAsync({ type: "nodebuffer" });
@@ -8915,23 +9511,136 @@ function readme(json, missing) {
 ${missing} referenced image${missing === 1 ? " was" : "s were"} missing and left out.` : ""
   ].join("\n");
 }
+var THUMB_WIDTHS = [640, 160];
+var isThumbWidth = (w) => THUMB_WIDTHS.includes(w);
+var QUALITY = { 640: 82, 160: 75 };
+function createThumbStore(core, opts = {}) {
+  const dir = join(core.home, "thumbs");
+  let enabled = true;
+  try {
+    mkdirSync(dir, { recursive: true, mode: 448 });
+  } catch {
+    enabled = false;
+  }
+  const pathFor = (hash, w) => join(dir, `${hash}-w${w}.webp`);
+  const inflight = /* @__PURE__ */ new Map();
+  const failed = /* @__PURE__ */ new Set();
+  const concurrency = Math.max(1, opts.concurrency ?? 2);
+  let active = 0;
+  const waiting = [];
+  const acquire = () => new Promise((resolve) => {
+    if (active < concurrency) {
+      active++;
+      resolve();
+    } else waiting.push(resolve);
+  });
+  const release = () => {
+    const next = waiting.shift();
+    if (next) next();
+    else active--;
+  };
+  async function make(hash, w) {
+    const final = pathFor(hash, w);
+    const tmp = `${final}.${process.pid}.${Math.random().toString(36).slice(2, 8)}.tmp`;
+    await acquire();
+    try {
+      await sharp21(core.images.pathFor(hash)).resize({ width: w, withoutEnlargement: true }).webp({ quality: QUALITY[w], effort: 4 }).toFile(tmp);
+      await rename(tmp, final);
+      return final;
+    } catch {
+      await unlink(tmp).catch(() => {
+      });
+      failed.add(`${hash}-w${w}`);
+      return null;
+    } finally {
+      release();
+    }
+  }
+  return {
+    dir,
+    async ensure(hash, w) {
+      if (!enabled || !/^[a-f0-9]{32}$/.test(hash)) return null;
+      const key = `${hash}-w${w}`;
+      if (failed.has(key)) return null;
+      const final = pathFor(hash, w);
+      try {
+        await access(final);
+        return final;
+      } catch {
+      }
+      let job = inflight.get(key);
+      if (!job) {
+        job = make(hash, w).finally(() => inflight.delete(key));
+        inflight.set(key, job);
+      }
+      return job;
+    },
+    warm(hash) {
+      for (const w of THUMB_WIDTHS) void this.ensure(hash, w);
+    },
+    async settle() {
+      await Promise.allSettled([...inflight.values()]);
+    },
+    clear() {
+      failed.clear();
+      rmSync(dir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+      try {
+        mkdirSync(dir, { recursive: true, mode: 448 });
+      } catch {
+        enabled = false;
+      }
+    },
+    stream: (path) => createReadStream(path)
+  };
+}
+async function fileSize(path) {
+  try {
+    const s = await stat(path);
+    return s.isFile() ? s.size : null;
+  } catch {
+    return null;
+  }
+}
 
 // src/routes/images.ts
+var IMMUTABLE = "public, max-age=31536000, immutable";
 function registerImageRoutes(app, deps) {
-  const { core } = deps;
+  const { core, thumbs } = deps;
   app.get("/api/images/:hash", async (req, reply) => {
     const hash = String(req.params.hash);
-    if (!core.images.has(hash)) return reply.status(404).send({ error: "image not found" });
-    reply.header("content-type", "image/png").header("cache-control", "public, max-age=31536000, immutable");
-    return reply.send(core.images.read(hash));
+    if (!/^[a-f0-9]{32}$/.test(hash)) return reply.status(404).send({ error: "image not found" });
+    const path = core.images.pathFor(hash);
+    const size = await fileSize(path);
+    if (size === null) return reply.status(404).send({ error: "image not found" });
+    const etag = `"${hash}"`;
+    reply.header("cache-control", IMMUTABLE).header("etag", etag);
+    if (req.headers["if-none-match"] === etag) return reply.status(304).send();
+    reply.header("content-type", "image/png").header("content-length", String(size));
+    return reply.send(createReadStream(path));
+  });
+  app.get("/api/images/:hash/thumb", async (req, reply) => {
+    const hash = String(req.params.hash);
+    const w = Number(req.query?.w);
+    if (!isThumbWidth(w)) return reply.status(400).send({ error: "w must be 640 or 160" });
+    if (!/^[a-f0-9]{32}$/.test(hash)) return reply.status(404).send({ error: "image not found" });
+    const etag = `"${hash}-w${w}"`;
+    if (req.headers["if-none-match"] === etag) return reply.status(304).header("cache-control", IMMUTABLE).send();
+    if (await fileSize(core.images.pathFor(hash)) === null)
+      return reply.status(404).send({ error: "image not found" });
+    const path = await thumbs.ensure(hash, w);
+    if (!path) return reply.header("cache-control", "no-store").redirect(`/api/images/${hash}`, 307);
+    const size = await fileSize(path);
+    if (size === null) return reply.header("cache-control", "no-store").redirect(`/api/images/${hash}`, 307);
+    reply.header("content-type", "image/webp").header("cache-control", IMMUTABLE).header("etag", etag).header("content-length", String(size));
+    return reply.send(thumbs.stream(path));
   });
   app.post("/api/images", async (req, reply) => {
     const part = await req.file();
     if (!part) return reply.status(400).send({ error: "multipart file field required" });
     const buf = await part.toBuffer();
     if (buf.length === 0) return reply.status(400).send({ error: "empty file" });
-    const fmt = (await sharp20(buf).metadata().catch(() => null))?.format;
-    const png = fmt === "svg" ? await toMarkPng(buf) : await sharp20(buf).rotate().png().toBuffer();
+    const fmt = (await sharp21(buf).metadata().catch(() => null))?.format;
+    const png = fmt === "svg" ? await toMarkPng(buf) : await sharp21(buf).rotate().png().toBuffer();
     return { hash: core.images.save(png) };
   });
   app.post("/api/diff", async (req, reply) => {
@@ -8966,6 +9675,48 @@ function registerImageRoutes(app, deps) {
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.8.1",
+    date: "2026-09-03",
+    title: "The same speed at any size.",
+    sections: [
+      {
+        heading: "Create",
+        body: "The feed opens on its first page and brings in more as you scroll, so a brand holding ten shots and a brand holding ten thousand open in the same moment. Pictures arrive as light copies sized for where they are shown, and the full image only where you actually look at it, so a long feed scrolls smoothly and a shot opens with its picture already in hand. Search reads the whole brand from the third letter you type, and finds shots by the products, people and scenes they were made with as well as by their words."
+      },
+      {
+        heading: "Library",
+        body: "Opening Scenri no longer slows down as your library grows. The first start after this update builds a search index once, which takes a moment on a very large library; every start after that is immediate. Clearing every shot from the danger zone now removes their thumbnails too, which used to stay on disk with nothing left that could find them."
+      },
+      {
+        heading: "Fixes",
+        body: "Dragging a chip to reorder it shows the insertion mark in the gap you are pointing at, rather than a chip or two further along, and a drag that changes nothing leaves the caret where it was. A drag released outside the brief no longer leaves the line unable to take a caret at all. A shot that is still rendering now shows the same selection ring as every other tile when you open it."
+      }
+    ]
+  },
+  {
+    version: "0.8.0",
+    date: "2026-09-02",
+    title: "The composer, rebuilt around what a shot is made of.",
+    sections: [
+      {
+        heading: "Create",
+        body: "Ingredients are compact chips now, each carrying the picture it stands for, and hovering one shows you what it is holding. A shot can hold twelve of them: the ones your engine can photograph are lit, and the rest ride along in words rather than being dropped, with every chip saying which it is. Photos go out in the order you wrote them, so the first thing you named is the first thing pictured. The asset panel beside the brief is a second door into it, so a tile ticks when its chip is in and clicking it again takes the chip out."
+      },
+      {
+        heading: "Refine",
+        body: "The panel beside an open shot has been redrawn, and its edge can be dragged to the width you want. Above the brief it shows what the picture is actually made of, resolved through the whole chain of refinements rather than just the last one, so nothing is repeated and nothing is lost at depth."
+      },
+      {
+        heading: "Brand",
+        body: "A product name is something to show in a shot, never lettering to paint into it, and a brand colour is now spoken as a note rather than an instruction, which keeps invented signage out of your pictures. Brand rules apply to every shot from Settings, so the composer no longer carries a row to say so."
+      },
+      {
+        heading: "Fixes",
+        body: "A finished shot appears the moment it lands instead of waiting for the rest of its batch, and a batch sent from a set files every shot in it. Typing around a chip behaves: the chip owns the space beside it, one press removes it, and two chips always keep the single space between them. Two presenters in a scene no longer compose one of them out."
+      }
+    ]
+  },
   {
     version: "0.7.5",
     date: "2026-09-01",
@@ -9740,21 +10491,20 @@ function registerUpdateRoutes(app, deps) {
   });
 }
 function registerSystemRoutes(app, deps) {
-  const { core } = deps;
+  const { core, thumbs } = deps;
   app.get("/api/home", async () => {
     const imagesDir = join(core.home, "images");
-    let files = 0, bytes = 0;
-    if (existsSync(imagesDir)) {
-      for (const f of readdirSync(imagesDir)) {
-        try {
-          bytes += statSync(join(imagesDir, f)).size;
-          files++;
-        } catch {
-        }
-      }
+    let files = 0;
+    let bytes = 0;
+    const names = await readdir(imagesDir).catch(() => []);
+    const sizes = await Promise.all(names.map((f) => stat(join(imagesDir, f)).catch(() => null)));
+    for (const s of sizes) {
+      if (!s?.isFile()) continue;
+      bytes += s.size;
+      files++;
     }
     const dbPath = join(core.home, "scenri.db");
-    const dbBytes = existsSync(dbPath) ? statSync(dbPath).size : 0;
+    const dbBytes = (await stat(dbPath).catch(() => null))?.size ?? 0;
     return { dir: core.home, dbPath, images: files, bytes: bytes + dbBytes };
   });
   app.post("/api/system/reveal", async (_req, reply) => {
@@ -9799,10 +10549,11 @@ function registerSystemRoutes(app, deps) {
           removed++;
         }
       }
+      thumbs.clear();
       return { ok: true, scope, projects: removed };
     }
     core.close();
-    for (const name of ["scenri.db", "scenri.db-wal", "scenri.db-shm", "images", "backups"]) {
+    for (const name of ["scenri.db", "scenri.db-wal", "scenri.db-shm", "images", "thumbs", "backups"]) {
       rmSync(join(core.home, name), { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
     }
     return { ok: true, scope };
@@ -9826,6 +10577,7 @@ function buildServer(opts) {
   registerAccessGuard(app, opts.access);
   const reserved = /* @__PURE__ */ new Map();
   const runningGenerations = /* @__PURE__ */ new Map();
+  const thumbs = createThumbStore(core);
   const { scenes } = loadScenes(opts.templatesDir);
   const resolveScene = sceneResolver(scenes);
   const sceneFor = (brandJson) => (id) => brandSceneById(brandJson, id) ?? resolveScene(id);
@@ -9856,7 +10608,7 @@ function buildServer(opts) {
       // Measured as stored (post-toMarkPng), so the scrape judges the same
       // pixels the compiler will one day attach.
       probeLongEdge: async (buf) => {
-        const m = await sharp20(await toMarkPng(buf)).metadata();
+        const m = await sharp21(await toMarkPng(buf)).metadata();
         return Math.max(m.width ?? 0, m.height ?? 0) || null;
       },
       createdWith: `${meta.name}/${meta.version}`
@@ -9945,7 +10697,7 @@ function buildServer(opts) {
       fetchImpl: opts.fetchImpl,
       saveAsset: async (buf) => `asset:${core.images.save(await toMarkPng(buf))}`,
       probeLongEdge: async (buf) => {
-        const m = await sharp20(await toMarkPng(buf)).metadata();
+        const m = await sharp21(await toMarkPng(buf)).metadata();
         return Math.max(m.width ?? 0, m.height ?? 0) || null;
       },
       createdWith: `${meta.name}/${meta.version}`
@@ -10128,6 +10880,7 @@ function buildServer(opts) {
     const compileCtx = {
       brand: brandJson,
       images: core.images,
+      wordsFor: shotWordsFor(core, brandId),
       engineCaps: uncapped,
       template: brief.templateId ? sceneById(String(brief.templateId)) : void 0,
       templateById: sceneById,
@@ -10164,25 +10917,19 @@ function buildServer(opts) {
       }).map((a) => ({ ...a, inherited: true }));
     }
     const cap2 = Math.max(0, engineCaps.maxReferenceImages - 1);
-    const merged = mergeEditAttachments(compiled2.attachments, inheritedAttachments, cap2);
+    const merged = mergeEditAttachments(compiled2.seated, inheritedAttachments, cap2);
     const prompt = compileBrief(brief, { ...compileCtx, presentAttachments: merged.kept }).prompt;
     const warnings = [...compiled2.warnings, ...identityWarnings.filter((w) => !compiled2.warnings.includes(w))];
     if (inherited.truncated)
       warnings.push("This thread is deeper than 64 steps, so identity attached before that could not be carried.");
-    if (merged.dropped.length) {
-      if (engineCaps.maxReferenceImages <= 1) {
-        warnings.push(`The identity rides on the shot itself \u2014 ${engineCaps.displayName} reads no other images.`);
-      } else {
-        const keptLabels = new Set(merged.kept.map((a) => a.label));
-        const names = [...new Set(merged.dropped.map((d) => d.label))].filter((l) => !keptLabels.has(l));
-        if (names.length)
-          warnings.push(`${names.join(" and ")} ${names.length === 1 ? "was" : "were"} left out of this refinement.`);
-      }
-    }
+    if (merged.dropped.length && engineCaps.maxReferenceImages <= 1)
+      warnings.push(`The identity rides on the shot itself \u2014 ${engineCaps.displayName} reads no other images.`);
     return {
       compiled: { ...compiled2, prompt },
       inheritedTokens,
       merged,
+      /** The seats this refinement had: the engine's, less the source frame. */
+      cap: cap2,
       warnings,
       editScope: verdict.scope,
       editRemoval: verdict.removal ?? false
@@ -10211,7 +10958,11 @@ function buildServer(opts) {
         // missing-photo identities; the budget losses live on the merge.
         dropped: [...edit.compiled.dropped, ...edit.merged.dropped],
         warnings: edit.warnings,
-        referenceCount: edit.merged.kept.length
+        referenceCount: edit.merged.kept.length,
+        // How many photo groups this refine can carry in total: the engine's
+        // slots less the one the source frame holds. The composer refuses a
+        // pick past it rather than warning after the fact.
+        cap: edit.cap
       };
     }
     const brandJson = await brandJsonWithIdentityCrops(
@@ -10235,14 +10986,27 @@ function buildServer(opts) {
     const compiled2 = compileBrief(brief, {
       brand: brandJson,
       images: core.images,
+      wordsFor: shotWordsFor(core, brand.id),
       engineCaps: engine.capabilities(),
       template: brief.templateId ? sceneById(String(brief.templateId)) : void 0,
       templateById: sceneById
     });
     const { referenceImages, ...rest } = compiled2;
-    return { ...rest, referenceCount: referenceImages.length };
+    return { ...rest, referenceCount: referenceImages.length, cap: engine.capabilities().maxReferenceImages };
+  });
+  registerProjectRoutes(app, {
+    core,
+    // what a search may match a brief token by: every name a token can carry today
+    tokenNames: (brand) => [
+      ...core.catalog.listLibraryProducts(brand.id, brand.json).map((p) => ({ id: p.id, name: p.name })),
+      ...demoProducts.map((p) => ({ id: p.id, name: p.name })),
+      ...brandCharacters(brand.json).map((c) => ({ id: String(c.id), name: String(c.name ?? "") })),
+      ...presenters.map((p) => ({ id: p.id, name: p.name })),
+      ...brandScenes(brand.json).map((sc) => ({ id: sc.id, name: sc.name })),
+      ...scenes.map((sc) => ({ id: sc.id, name: sc.name }))
+    ],
+    engineNames: () => engines.all().map((e) => ({ id: e.capabilities().id, name: e.capabilities().displayName }))
   });
-  registerProjectRoutes(app, { core });
   registerCodexSetupRoutes(app, { codexSetup: opts.codexSetup, codexRunner: engines.codexRunner });
   app.get("/api/engines", async () => {
     const list2 = [];
@@ -10306,11 +11070,11 @@ function buildServer(opts) {
     const out = [];
     for (const h of images) {
       const buf = core.images.read(h);
-      const meta2 = await sharp20(buf).metadata().catch(() => null);
+      const meta2 = await sharp21(buf).metadata().catch(() => null);
       if (!meta2?.width || !meta2.height) throw new Error("engine returned an undecodable image");
       const oriented = (meta2.orientation ?? 1) !== 1;
       out.push(
-        buf.subarray(0, 8).equals(PNG_SIG) && !oriented ? h : core.images.save(await sharp20(buf).rotate().png().toBuffer())
+        buf.subarray(0, 8).equals(PNG_SIG) && !oriented ? h : core.images.save(await sharp21(buf).rotate().png().toBuffer())
       );
     }
     return out;
@@ -10322,7 +11086,7 @@ function buildServer(opts) {
       const out = [];
       for (const h of images) {
         const buf = core.images.read(h);
-        const meta2 = await sharp20(buf).metadata();
+        const meta2 = await sharp21(buf).metadata();
         if (!meta2.width || !meta2.height) {
           out.push(h);
           continue;
@@ -10335,7 +11099,7 @@ function buildServer(opts) {
         }
         const w = got > target ? Math.round(meta2.height * target) : meta2.width;
         const hpx = got > target ? meta2.height : Math.round(meta2.width / target);
-        const cropped = await sharp20(buf).resize(w, hpx, { fit: "cover", position: "attention" }).png().toBuffer();
+        const cropped = await sharp21(buf).resize(w, hpx, { fit: "cover", position: "attention" }).png().toBuffer();
         app.log.info(
           { nodeId, got: `${meta2.width}x${meta2.height}`, want: `${w}x${hpx}` },
           "canvas: cropped a drifted frame to the asked ratio"
@@ -10354,7 +11118,7 @@ function buildServer(opts) {
   async function assertAspect(images, expect) {
     const want = expect.width / expect.height;
     for (const h of images) {
-      const meta2 = await sharp20(core.images.read(h)).metadata();
+      const meta2 = await sharp21(core.images.read(h)).metadata();
       if (!meta2.width || !meta2.height) continue;
       const got = meta2.width / meta2.height;
       if (Math.abs(got - want) / want > ASPECT_TOLERANCE)
@@ -10377,58 +11141,69 @@ function buildServer(opts) {
     }, bound);
     const startedAt = Date.now();
     const settled = /* @__PURE__ */ new Set();
+    const settleSlot = async (slot, hash) => {
+      const id = nodeIds[slot];
+      try {
+        let own = await normalizePngs([hash]);
+        const post = postFor?.(id);
+        if (post) own = await post(own);
+        if (expect) await assertAspect(own, expect);
+        try {
+          const meta2 = await sharp21(core.images.read(own[0])).metadata();
+          const node = core.store.getNode(id);
+          if (node && meta2.width && meta2.height) {
+            const brief = node.brief ?? {};
+            const asked = expect ? { requestedSize: [expect.width, expect.height] } : {};
+            core.store.setBrief(id, { ...brief, rendered: { sizes: [[meta2.width, meta2.height]], ...asked } });
+            if (node.kind === "generation" && engineId === "codex-cli" && expect && expect.width !== expect.height && meta2.width === expect.width && meta2.height === expect.height)
+              app.log.warn(
+                { nodeId: id },
+                "codex delivered exactly the requested pixels; its image tool cannot pin size - suggests a forbidden shell resize"
+              );
+          }
+        } catch {
+        }
+        core.store.completeNode(id, { images: own, costUsd: 0, durationMs: Date.now() - startedAt });
+        thumbs.warm(own[0]);
+      } catch (err) {
+        core.store.failNode(id, String(err?.message ?? err));
+      } finally {
+        settled.add(id);
+      }
+    };
+    const landing = /* @__PURE__ */ new Map();
+    let accepting = true;
+    const onImage = (slot, hash) => {
+      if (!accepting || !Number.isInteger(slot) || slot < 0 || slot >= nodeIds.length || landing.has(slot)) return;
+      landing.set(slot, settleSlot(slot, hash));
+    };
     try {
-      const result = await work(ctrl.signal);
+      const result = await work(ctrl.signal, onImage);
+      accepting = false;
       clearTimeout(watchdog);
-      const images = await normalizePngs(result.images);
+      await Promise.allSettled(landing.values());
       const raw = result.raw;
       const bySlot = new Array(nodeIds.length);
-      images.forEach((h, k) => {
+      result.images.forEach((h, k) => {
         const slot = raw?.variantIndexes?.[k] ?? k;
         if (slot < nodeIds.length && bySlot[slot] === void 0) bySlot[slot] = h;
       });
-      const wall = Date.now() - startedAt;
       const failures = [...raw?.partialFailures ?? []];
       for (let slot = 0; slot < nodeIds.length; slot++) {
-        const id = nodeIds[slot];
+        if (landing.has(slot)) continue;
         const hash = bySlot[slot];
         if (hash === void 0) {
-          core.store.failNode(id, failures.shift() ?? "the engine returned no image for this shot");
-          settled.add(id);
+          core.store.failNode(nodeIds[slot], failures.shift() ?? "the engine returned no image for this shot");
+          settled.add(nodeIds[slot]);
           continue;
         }
-        try {
-          let own = [hash];
-          const post = postFor?.(id);
-          if (post) own = await post(own);
-          if (expect) await assertAspect(own, expect);
-          try {
-            const meta2 = await sharp20(core.images.read(own[0])).metadata();
-            const node = core.store.getNode(id);
-            if (node && meta2.width && meta2.height) {
-              const brief = node.brief ?? {};
-              const asked = expect ? { requestedSize: [expect.width, expect.height] } : {};
-              core.store.setBrief(id, { ...brief, rendered: { sizes: [[meta2.width, meta2.height]], ...asked } });
-              if (node.kind === "generation" && engineId === "codex-cli" && expect && expect.width !== expect.height && meta2.width === expect.width && meta2.height === expect.height)
-                app.log.warn(
-                  { nodeId: id },
-                  "codex delivered exactly the requested pixels; its image tool cannot pin size - suggests a forbidden shell resize"
-                );
-            }
-          } catch {
-          }
-          core.store.completeNode(id, {
-            images: own,
-            costUsd: slot === 0 ? result.costUsd : 0,
-            durationMs: wall
-          });
-        } catch (err) {
-          core.store.failNode(id, String(err?.message ?? err));
-        }
-        settled.add(id);
+        await settleSlot(slot, hash);
       }
+      core.store.chargeNode(nodeIds[0], result.costUsd);
       core.ledger.recordCost(engineId, nodeIds[0], result.costUsd);
     } catch (err) {
+      accepting = false;
+      await Promise.allSettled(landing.values());
       for (const id of nodeIds) {
         if (settled.has(id)) continue;
         if (watchdogFired) core.store.failNode(id, `generation timed out after ${Math.round(bound / 6e4)} minutes`);
@@ -10483,7 +11258,7 @@ function buildServer(opts) {
         crop: window
       });
       const work2 = async () => ({
-        images: [core.images.save(await sharp20(args.srcBuf).extract(window).png().toBuffer())],
+        images: [core.images.save(await sharp21(args.srcBuf).extract(window).png().toBuffer())],
         costUsd: 0
       });
       void runNode([node2.id], null, 0, work2, { width: plan2.width, height: plan2.height }).catch(
@@ -10492,7 +11267,7 @@ function buildServer(opts) {
       return reply.status(202).send(args.note ? { ...node2, warnings: [args.note] } : node2);
     };
     if (kind === "edit" && reshape === "crop") {
-      const rootForCrop = core.store.treeFor(project.id).find((n) => n.kind === "root");
+      const rootForCrop = core.store.rootFor(project.id);
       if (!rootForCrop) return reply.status(500).send({ error: "project has no root node" });
       const cropParentId = parentId ? String(parentId) : rootForCrop.id;
       if (brief && Array.isArray(brief.tokens)) {
@@ -10508,7 +11283,7 @@ function buildServer(opts) {
       if (!srcHash || !core.images.has(String(srcHash)))
         return reply.status(400).send({ error: "edit needs a parent node with an image (sourceImage)" });
       const srcBuf = core.images.read(String(srcHash));
-      const srcMeta = await sharp20(srcBuf).metadata();
+      const srcMeta = await sharp21(srcBuf).metadata();
       if (!srcMeta.width || !srcMeta.height) return reply.status(400).send({ error: "source image unreadable" });
       return runCropNode({
         parentId: cropParentId,
@@ -10524,7 +11299,7 @@ function buildServer(opts) {
     if (!avail.ok) return reply.status(400).send({ error: avail.reason ?? "engine unavailable" });
     if (kind !== "generation" && kind !== "edit")
       return reply.status(400).send({ error: "kind must be generation|edit" });
-    const rootNode = core.store.treeFor(project.id).find((n) => n.kind === "root");
+    const rootNode = core.store.rootFor(project.id);
     if (!rootNode) return reply.status(500).send({ error: "project has no root node" });
     const resolvedParentId = parentId ? String(parentId) : rootNode.id;
     const ctx = brandContext(core, project.brandId);
@@ -10580,6 +11355,7 @@ function buildServer(opts) {
         compiled2 = compileBrief(brief, {
           brand: brandJson,
           images: core.images,
+          wordsFor: shotWordsFor(core, project.brandId),
           engineCaps: engine.capabilities(),
           template: brief.templateId ? sceneById(String(brief.templateId)) : void 0,
           templateById: sceneById
@@ -10617,6 +11393,7 @@ function buildServer(opts) {
       compiled2 = compileBrief(legacyBrief, {
         brand: brandJson,
         images: core.images,
+        wordsFor: shotWordsFor(core, project.brandId),
         engineCaps: engine.capabilities(),
         templateById: sceneFor(brandJson)
       });
@@ -10641,7 +11418,8 @@ function buildServer(opts) {
     if (kind === "generation") {
       const cap2 = engine.capabilities().maxReferenceImages;
       const wantedCount = Math.min(Math.max(1, Number(count)), 8);
-      const lostIdentity = engine.capabilities().placeholder ? [] : (compiled2?.dropped ?? []).filter((d) => d.essential);
+      const blind = engine.capabilities().maxReferenceImages === 0;
+      const lostIdentity = engine.capabilities().placeholder ? [] : (compiled2?.dropped ?? []).filter((d) => d.essential && (d.reason === "missing" || blind));
       if (lostIdentity.length) {
         const missing = lostIdentity.filter((d) => d.reason === "missing");
         if (missing.length) {
@@ -10692,7 +11470,7 @@ function buildServer(opts) {
         ...variations.length ? { variations } : {}
       };
       estimate = await engine.costEstimate(genReq);
-      work = (signal) => engine.generate(genReq, signal);
+      work = (signal, onImage) => engine.generate(genReq, signal, onImage);
       expectShape = { width, height };
     } else {
       const parent = core.store.getNode(resolvedParentId);
@@ -10720,7 +11498,7 @@ function buildServer(opts) {
         );
       }
       const srcBuf = core.images.read(String(srcHash));
-      const srcMeta = await sharp20(srcBuf).metadata();
+      const srcMeta = await sharp21(srcBuf).metadata();
       if (srcMeta.width && srcMeta.height) expectShape = { width: srcMeta.width, height: srcMeta.height };
       const parentFormat = parent?.brief?.tokens?.find((t) => t?.t === "format");
       const parentNominal = parentFormat && Number(parentFormat.w) > 0 && Number(parentFormat.h) > 0 ? { width: Number(parentFormat.w), height: Number(parentFormat.h) } : null;
@@ -10754,7 +11532,7 @@ function buildServer(opts) {
         } else if (decision.op === "extend") {
           if (decision.assist) {
             expandAssist = { width: decision.assist.width, height: decision.assist.height };
-            workBuf = await sharp20(srcBuf).extract(decision.assist).png().toBuffer();
+            workBuf = await sharp21(srcBuf).extract(decision.assist).png().toBuffer();
             workSize = { width: decision.assist.width, height: decision.assist.height };
           }
           expandPlan = planExpand(workSize, targetRatio);
@@ -10775,7 +11553,7 @@ function buildServer(opts) {
         const fit = fitExpandToBudget(expandPlan, workSize, runEngine.capabilities().editPixelBudget);
         if (fit.scale < 1) {
           expandPlan = fit.plan;
-          workBuf = await sharp20(workBuf).resize(fit.source.width, fit.source.height, { fit: "fill", kernel: "lanczos3" }).png().toBuffer();
+          workBuf = await sharp21(workBuf).resize(fit.source.width, fit.source.height, { fit: "fill", kernel: "lanczos3" }).png().toBuffer();
           workSize = fit.source;
           extraWarnings.push(
             `${runEngine.capabilities().displayName} draws about ${((runEngine.capabilities().editPixelBudget ?? 0) / 1e6).toFixed(1)} megapixels, so this shape continues as a ${fit.plan.width}x${fit.plan.height} frame with the photograph riding inside it at ${fit.source.width}x${fit.source.height}. Nothing is upscaled; the stored size is the size the engine truly drew.`
@@ -10794,10 +11572,11 @@ function buildServer(opts) {
         expectShape = { width: expandPlan.width, height: expandPlan.height };
       }
       const editPixelBudget = runEngine.capabilities().editPixelBudget;
-      if (!expandPlan && editPixelBudget && srcMeta.width && srcMeta.height && srcMeta.width * srcMeta.height > editPixelBudget) {
-        sentSize = budgetSize(srcMeta.width, srcMeta.height, editPixelBudget);
+      const stepped = !expandPlan && editPixelBudget && srcMeta.width && srcMeta.height && srcMeta.width * srcMeta.height > editPixelBudget ? budgetSize(srcMeta.width, srcMeta.height, editPixelBudget) : null;
+      if (editPixelBudget && stepped && (stepped.width !== srcMeta.width || stepped.height !== srcMeta.height)) {
+        sentSize = stepped;
         budgetSourceHash = core.images.save(
-          await sharp20(srcBuf).resize(sentSize.width, sentSize.height, { fit: "fill", kernel: "lanczos3" }).png().toBuffer()
+          await sharp21(srcBuf).resize(sentSize.width, sentSize.height, { fit: "fill", kernel: "lanczos3" }).png().toBuffer()
         );
         if (!gradeOnlyAsk)
           extraWarnings.push(
@@ -10930,18 +11709,18 @@ function buildServer(opts) {
           }
         } : {},
         // What the refinement carried, recorded apart from what it asked for:
-        // the detail view shows both, and remix reads tokens alone.
+        // the detail view shows both, and reuse setup merges both (mergeCarried).
         ...kind === "edit" && inheritedTokens.length ? { inherited: inheritedTokens } : {}
       });
     const plan = expandPlan;
     const original = editedFrom ? core.images.read(editedFrom) : null;
     const localScope = kind === "edit" && !plan && editScope === "local" && original;
     const enforceEditCanvas = async (images) => {
-      const srcMeta = await sharp20(original).metadata();
+      const srcMeta = await sharp21(original).metadata();
       if (!srcMeta.width || !srcMeta.height) return images;
       const out = [];
       for (const h of images) {
-        const meta2 = await sharp20(core.images.read(h)).metadata();
+        const meta2 = await sharp21(core.images.read(h)).metadata();
         const got = { width: meta2.width ?? 0, height: meta2.height ?? 0 };
         const verdict = judgeEditSize({ width: srcMeta.width, height: srcMeta.height }, got, {
           pixelBudget: runEngine.capabilities().editPixelBudget
@@ -10971,7 +11750,7 @@ function buildServer(opts) {
           );
           out.push(
             core.images.save(
-              await sharp20(core.images.read(h)).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).png().toBuffer()
+              await sharp21(core.images.read(h)).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).png().toBuffer()
             )
           );
           try {
@@ -10993,7 +11772,7 @@ function buildServer(opts) {
       const out = [];
       for (const h of images) {
         const answer = core.images.read(h);
-        const got = await sharp20(answer).metadata();
+        const got = await sharp21(answer).metadata();
         if (got.width !== plan.width || got.height !== plan.height)
           app.log.info(
             { nodeId: node.id, got: `${got.width}x${got.height}`, want: `${plan.width}x${plan.height}` },
@@ -11101,13 +11880,13 @@ function buildServer(opts) {
     const n = core.store.getNode(req.params.id);
     if (!n) return reply.status(404).send({ error: "node not found" });
     core.store.setKept(n.id, Boolean(req.body?.kept ?? true));
-    return core.store.getNode(n.id);
+    return core.store.getFeedNode(n.id);
   });
   app.post("/api/nodes/:id/archive", async (req, reply) => {
     const n = core.store.getNode(req.params.id);
     if (!n) return reply.status(404).send({ error: "node not found" });
     core.store.setArchived(n.id, Boolean(req.body?.archived ?? true));
-    return core.store.getNode(n.id);
+    return core.store.getFeedNode(n.id);
   });
   app.delete("/api/nodes/:id", async (req, reply) => {
     const n = core.store.getNode(req.params.id);
@@ -11129,7 +11908,7 @@ function buildServer(opts) {
     }
     return { ok: true, deleted };
   });
-  registerImageRoutes(app, { core });
+  registerImageRoutes(app, { core, thumbs });
   const runtime = opts.runtime ?? { installKind: "unknown", supervised: false };
   const updates = createUpdateChecker({ name: meta.name, store: core.store, fetchImpl: opts.fetchImpl });
   app.decorate("updates", updates);
@@ -11154,12 +11933,13 @@ function buildServer(opts) {
       while (runningGenerations.size > 0 && Date.now() < deadline) {
         await new Promise((r) => setTimeout(r, 25));
       }
+      await thumbs.settle();
       await app.close();
       core.close();
     })();
     return drained;
   });
-  registerSystemRoutes(app, { core });
+  registerSystemRoutes(app, { core, thumbs });
   if (opts.studioDist && existsSync(opts.studioDist)) {
     const dist = opts.studioDist;
     app.register(fastifyStatic, { root: dist });
@@ -11213,7 +11993,7 @@ async function serve() {
 }
 async function run() {
   const core = createCore();
-  const stubs = process.env.SCENRI_DEMO_ENGINE === "1" ? [createDemoEngine((b) => core.images.save(b))] : [];
+  const stubs = process.env.SCENRI_DEMO_ENGINE === "1" ? [createDemoEngine((b) => core.images.save(b), demoOptionsFromEnv(process.env))] : [];
   const engines = createEngineRegistry(core, stubs);
   const here = dirname(fileURLToPath(import.meta.url));
   const candidates = [join(here, "..", "..", "..", "apps", "studio", "dist"), join(here, "..", "studio-dist")];
@@ -11223,7 +12003,6 @@ async function run() {
   const onlyThisMachine = LOOPBACK2.includes(HOST);
   const token = onlyThisMachine ? void 0 : randomBytes(24).toString("base64url");
   const reachableAt = onlyThisMachine ? [] : HOST === "0.0.0.0" || HOST === "::" ? lanAddresses() : [HOST];
-  await repairPresenterCrops(core, (line) => console.log(line));
   const app = buildServer({
     core,
     engines,
@@ -11285,6 +12064,7 @@ async function run() {
   };
   process.on("SIGINT", shutdown);
   process.on("SIGTERM", shutdown);
+  void repairPresenterCrops(core, (line) => console.log(line)).catch(() => void 0);
   app.updates.schedule();
   app.content.schedule();
   const query = token ? `/?t=${token}` : "";
@@ -11328,8 +12108,8 @@ async function verify() {
     const db = new Database2(":memory:");
     db.pragma("user_version");
     db.close();
-    const { default: sharp21 } = await import('sharp');
-    await sharp21({ create: { width: 1, height: 1, channels: 3, background: "#000" } }).png().toBuffer();
+    const { default: sharp22 } = await import('sharp');
+    await sharp22({ create: { width: 1, height: 1, channels: 3, background: "#000" } }).png().toBuffer();
     console.log(JSON.stringify({ ok: true, version: readMeta().version }));
   } catch (err) {
     console.log(JSON.stringify({ ok: false, error: String(err?.message ?? err) }));