scenri 0.8.0 → 0.8.2

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) {
@@ -823,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,
@@ -842,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) : []
       }));
     },
@@ -979,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,
@@ -1388,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,
@@ -1421,7 +1831,7 @@ function libraryMethods(db) {
           status: p.status,
           shots,
           hiddenShots,
-          variants: variantsFor(db, p.id)
+          variants: variantsBy.get(p.id) ?? []
         };
       });
       return [...manual, ...catalog];
@@ -3098,7 +3508,7 @@ function createDemoEngine(saveImage, opts = {}) {
       <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() {
@@ -3289,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;
 }
@@ -3389,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;
@@ -3546,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: {} },
@@ -3559,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;
 };
@@ -3574,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 {
@@ -4221,18 +4638,9 @@ function shotWords(prompt, max = 160) {
   return clipped.replace(/[.\s]+$/, "");
 }
 function shotWordsFor(core, brandId) {
-  let byHash = null;
+  const byHash = /* @__PURE__ */ new Map();
   return (hash) => {
-    if (!byHash) {
-      byHash = /* @__PURE__ */ new Map();
-      for (const p of core.store.listProjects(brandId)) {
-        for (const n of core.store.treeFor(p.id)) {
-          const words = shotWords(n.prompt);
-          if (!words) continue;
-          for (const h of n.images ?? []) if (!byHash.has(h)) byHash.set(h, words);
-        }
-      }
-    }
+    if (!byHash.has(hash)) byHash.set(hash, shotWords(core.store.promptForImage(brandId, hash)));
     return byHash.get(hash) ?? null;
   };
 }
@@ -6231,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,
@@ -6709,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) => {
@@ -6763,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;
@@ -6834,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;
@@ -6863,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;
@@ -6901,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;
@@ -6916,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);
@@ -7267,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 };
@@ -7330,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 };
@@ -7504,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);
@@ -7657,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;
@@ -7720,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;
@@ -7775,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;
@@ -7790,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";
@@ -7833,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;
@@ -7868,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;
@@ -7891,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,
@@ -7910,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;
@@ -8001,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] });
@@ -8018,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 });
@@ -8071,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;
@@ -8082,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 };
@@ -8128,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 };
   });
@@ -8250,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 {
@@ -8273,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;
@@ -8782,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" });
@@ -8807,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);
@@ -8843,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) };
   });
 }
 
@@ -8892,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" });
@@ -9038,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) => {
@@ -9089,6 +9675,35 @@ function registerImageRoutes(app, deps) {
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.8.2",
+    date: "2026-09-03",
+    sections: [
+      {
+        heading: "Security",
+        body: "The server Scenri runs on and the URL parser under it are on their patched releases. Nothing about how Scenri works changes."
+      }
+    ]
+  },
+  {
+    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",
@@ -9886,21 +10501,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) => {
@@ -9945,10 +10559,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 };
@@ -9972,6 +10587,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);
@@ -10002,7 +10618,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}`
@@ -10091,7 +10707,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}`
@@ -10388,7 +11004,19 @@ function buildServer(opts) {
     const { referenceImages, ...rest } = compiled2;
     return { ...rest, referenceCount: referenceImages.length, cap: engine.capabilities().maxReferenceImages };
   });
-  registerProjectRoutes(app, { core });
+  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 }))
+  });
   registerCodexSetupRoutes(app, { codexSetup: opts.codexSetup, codexRunner: engines.codexRunner });
   app.get("/api/engines", async () => {
     const list2 = [];
@@ -10452,11 +11080,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;
@@ -10468,7 +11096,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;
@@ -10481,7 +11109,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"
@@ -10500,7 +11128,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)
@@ -10531,7 +11159,7 @@ function buildServer(opts) {
         if (post) own = await post(own);
         if (expect) await assertAspect(own, expect);
         try {
-          const meta2 = await sharp20(core.images.read(own[0])).metadata();
+          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 ?? {};
@@ -10546,6 +11174,7 @@ function buildServer(opts) {
         } 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 {
@@ -10639,7 +11268,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(
@@ -10648,7 +11277,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)) {
@@ -10664,7 +11293,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,
@@ -10680,7 +11309,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);
@@ -10879,7 +11508,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;
@@ -10913,7 +11542,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);
@@ -10934,7 +11563,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.`
@@ -10957,7 +11586,7 @@ function buildServer(opts) {
       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(
@@ -11097,11 +11726,11 @@ function buildServer(opts) {
     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
@@ -11131,7 +11760,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 {
@@ -11153,7 +11782,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}` },
@@ -11261,13 +11890,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);
@@ -11289,7 +11918,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);
@@ -11314,12 +11943,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 });
@@ -11383,7 +12013,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,
@@ -11445,6 +12074,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}` : "";
@@ -11488,8 +12118,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) }));