scenri 0.9.4 → 0.10.1

package/CHANGELOG.md

@@ -1,5 +1,89 @@
 # Changelog
 
+## [0.10.1](https://github.com/tonygorb/Scenri/compare/v0.10.0...v0.10.1) (2026-09-16)
+
+
+### Features
+
+* add placeTip function for hover card positioning ([de6d069](https://github.com/tonygorb/Scenri/commit/de6d069024b3d0c4b305f945a15322b1290d6458))
+* add presenter duplication and deletion functionality ([11c83be](https://github.com/tonygorb/Scenri/commit/11c83be7ee167435fc8a6656c938380ec9b08c68))
+* duplicate or delete a saved presenter from its card ([2e4dc00](https://github.com/tonygorb/Scenri/commit/2e4dc008f3bccbf9a9b2e444331bd2627775f1f4))
+* enhance presenter view and retry functionality ([dbeb9e9](https://github.com/tonygorb/Scenri/commit/dbeb9e9e48c52510ebb9ca2949a27e0cebfb69ca))
+
+
+### Bug Fixes
+
+* a fresh library keeps started_at through the status rebuild ([14aced1](https://github.com/tonygorb/Scenri/commit/14aced1fa5d0b841e8202b639e3ae95b615598ac))
+* centre the Create first run and dock the assets panel from 1024 ([b102204](https://github.com/tonygorb/Scenri/commit/b102204d3e42107319a72923aea28de3e04298f2))
+* retry in the same card, side profiles, chip fields and rails ([0fd3099](https://github.com/tonygorb/Scenri/commit/0fd309969320b0fe8f22cba0940cdf16f5bc68a4))
+* type and lint errors in the chip field and the reference set ([53e5314](https://github.com/tonygorb/Scenri/commit/53e5314120de03cf7a5c4c3ef1d9946655e567a3))
+
+
+### Miscellaneous Chores
+
+* **release:** pin the next version to 0.10.1 ([85a5df4](https://github.com/tonygorb/Scenri/commit/85a5df4711c81c30b60b18dfbd4a16098adff98b))
+
+## [0.10.0](https://github.com/tonygorb/Scenri/compare/v0.9.4...v0.10.0) (2026-09-16)
+
+
+### Features
+
+* presenter creation as a conversation, with a view and an editor ([39e1a36](https://github.com/tonygorb/Scenri/commit/39e1a3633ab27712a628508fd5c1db51c3bcfb51))
+* **presenter:** the studio arrives the way everything else you make here does ([7fee9b7](https://github.com/tonygorb/Scenri/commit/7fee9b77160475490c5e4dc39dd19725f7e2ba53))
+* **studio:** show an import where you are, and fill the wall as it lands ([667d8ac](https://github.com/tonygorb/Scenri/commit/667d8acd913818400b5ea7fee0502439e06fc0e9))
+
+
+### Bug Fixes
+
+* **brand:** teach the brand scraper the manners the crawler already had ([b62f4da](https://github.com/tonygorb/Scenri/commit/b62f4da7d929dc9a3fdbdba5c4840e5bba3c9c84))
+* **catalog:** a card asks for a thumbnail, not the picture it will import ([2a91200](https://github.com/tonygorb/Scenri/commit/2a91200a96cc240e7b0e144ece6670747efccee3))
+* **catalog:** capture the site's own icon, and open the import from its dock ([cb76556](https://github.com/tonygorb/Scenri/commit/cb76556c1b85bd001deffbc9e1f3f35595bca679))
+* **catalog:** count a catalogue the budget can actually reach ([8ba5d85](https://github.com/tonygorb/Scenri/commit/8ba5d85111e46c6c4a0afb7c48c9b972c067a168))
+* **catalog:** count the pictures a run owes, not the ones it has looked at ([7913f21](https://github.com/tonygorb/Scenri/commit/7913f21949ea58823f0eab1a19bd175a84ae376c))
+* **catalog:** count what a person is missing, in the unit they asked in ([e763b93](https://github.com/tonygorb/Scenri/commit/e763b93cdf0cfce12a84fe6a5e703e55bc7db973))
+* **catalog:** read a guarded endpoint as guarded, not as a busy one ([1643170](https://github.com/tonygorb/Scenri/commit/1643170dcb93c80cc06d5be565e85d6aa7dfdc9a))
+* **catalog:** reliable website import — accurate counts, guarded endpoints, live progress ([37658f5](https://github.com/tonygorb/Scenri/commit/37658f53a846d42bc87b7fc522c68c589aef20a6))
+* **cli:** a revision does not carry a picture of the face it replaced ([072a353](https://github.com/tonygorb/Scenri/commit/072a353f8c43328df3e8b066a1f78637398c5394))
+* **cli:** putting a picture back is a swap, not a decision to build the next view ([12d1787](https://github.com/tonygorb/Scenri/commit/12d17879e711a8275e34f27879030f5082226439))
+* **composer:** a chip for a presenter who is gone says so ([58de149](https://github.com/tonygorb/Scenri/commit/58de1497623ab4b512eca3a3ac7e77d73a067f24))
+* **core:** a draft becoming a saved presenter is one write ([970c0dd](https://github.com/tonygorb/Scenri/commit/970c0dd2c1a571ba524a719bf05c4b06d653f454))
+* **presenter:** "Describe someone instead" describes someone ([b115d2e](https://github.com/tonygorb/Scenri/commit/b115d2e70a1e0642b4350d74c1149ba3804539b8))
+* **presenter:** a record from before the studio opens, reads right, and can be drawn ([24f6ae1](https://github.com/tonygorb/Scenri/commit/24f6ae1dfaa3a92148c9caad2c915965eb702755))
+* **presenter:** a reload is not a way of holding state ([3f7231d](https://github.com/tonygorb/Scenri/commit/3f7231dd6d5e51ae71ac46dbf58dcd2dc6df77fa))
+* **presenter:** a view drawn from a face that moved lands stale, not current ([ce7d5fe](https://github.com/tonygorb/Scenri/commit/ce7d5fe6b40c93173a937095902089803352fe4b))
+* **presenter:** an answer is installed only for the draft it was asked about ([c62ae1a](https://github.com/tonygorb/Scenri/commit/c62ae1ac9a261d319295f30e76f113bec1a6f845))
+* **presenter:** arriving at a draft that is drawing reads its conversation ([edec9e3](https://github.com/tonygorb/Scenri/commit/edec9e35d213a0e6db30f78792cd1cffd098daff))
+* **presenter:** Create presenter is a new presenter, every time ([4188c42](https://github.com/tonygorb/Scenri/commit/4188c4230865981366fb3ccccfe4c55ea40788b3))
+* **presenter:** deleting a presenter reaches every surface, and takes its session with it ([73ceea2](https://github.com/tonygorb/Scenri/commit/73ceea292f3c124aeb85903dc0b40677e1cdf4c7))
+* **presenter:** opening a draft does not ask a question it is about to withdraw ([4e4c6a4](https://github.com/tonygorb/Scenri/commit/4e4c6a427797f721cdb936474f3d7778a4de3a6b))
+* **presenter:** the close on a phone head sits on the screen, and in the middle of the bar ([54634bd](https://github.com/tonygorb/Scenri/commit/54634bdcd5a050ad3cabc032bef67a68d22e001f))
+* **presenter:** the editor gets the latch the creation flow already has ([56119c7](https://github.com/tonygorb/Scenri/commit/56119c7731ab71d69806a99944531b33235eedf3))
+* **presenter:** the picture is simply there, and a picture put back brings its view up ([8665646](https://github.com/tonygorb/Scenri/commit/866564696cab338829c77dee9851bb65a69f7cef))
+* **presenter:** the question over a picture put back says what happened to it ([d678a96](https://github.com/tonygorb/Scenri/commit/d678a969aa92260d0d02f6dcb615b78eb477dd80))
+* **presenter:** the stage is the shape of the picture, so a bad draw is not a crop ([52f6bde](https://github.com/tonygorb/Scenri/commit/52f6bde7b6dfbade987b1e24324315c62a950a48))
+* **presenter:** throwing an unfinished person away asks first ([9226470](https://github.com/tonygorb/Scenri/commit/9226470fe7cb0001695699f446d5e4c2f16ad579))
+* **presenter:** without an engine, the photo is the face rather than a dead end ([8ddae49](https://github.com/tonygorb/Scenri/commit/8ddae49a74a191e126024d65340ee89ab78d84c9))
+* **studio:** a discarded draft hands its place on, instead of dropping focus ([5180237](https://github.com/tonygorb/Scenri/commit/5180237bcbf18d2d76eff0cbe64f6644084ad071))
+* **studio:** a kit you walk away from is not a brand you made ([03b3613](https://github.com/tonygorb/Scenri/commit/03b36139699e665669e75d7722c170930c8ec87b))
+* **studio:** close the silent paths through onboarding and import ([441d310](https://github.com/tonygorb/Scenri/commit/441d310ecdd6e30ab63f117c19507036bff06513))
+* **studio:** count one thing in the task row, and say what a stop kept ([0aba7e5](https://github.com/tonygorb/Scenri/commit/0aba7e5ee42b1a05b9a4635a2557c3a0bca2a5c3))
+* **studio:** offer the products a listing found, not only the ones read ([4ea36ef](https://github.com/tonygorb/Scenri/commit/4ea36ef0890a854e19375a865e2c8190e97b78c7))
+* **studio:** one press is one act, for Enter and for a confirm ([d43a8c7](https://github.com/tonygorb/Scenri/commit/d43a8c7f99a083f2d8d559d02475f89e03952464))
+* **studio:** say what was kept, not only what went wrong ([70f1855](https://github.com/tonygorb/Scenri/commit/70f1855ce4945d72f56bf43ece8080b5050cafa5))
+* **studio:** say when the look for a shop did not finish ([be0e2f6](https://github.com/tonygorb/Scenri/commit/be0e2f600673f3f1c8f8aef36d80b7cba0430212))
+* **studio:** Start over keeps drawn work, and lets go of a draft with none ([f5d1328](https://github.com/tonygorb/Scenri/commit/f5d132824d030ab604cf52a97f71c5a73118464f))
+* **studio:** the import pill wears the brand's mark and a clock ([4b78b1a](https://github.com/tonygorb/Scenri/commit/4b78b1a6e93780e5389ce2990af929c3dc515638))
+* **studio:** the presenter studio says what it will spend, like the other two flows ([3bb039c](https://github.com/tonygorb/Scenri/commit/3bb039cf22c5950fd5226f22b93405477a216a4c))
+* **test:** keep the private repo out of the battery drivers' defaults ([cd0f674](https://github.com/tonygorb/Scenri/commit/cd0f674d4f7b98490bf70c840ef8c9292c5f8f53))
+* **test:** read the reference image's basename, not its POSIX split ([442cc07](https://github.com/tonygorb/Scenri/commit/442cc07bdedb02c62a695b9c22ac090caee2d890))
+* **test:** the analyzer's imagePaths assertion had the same split('/') bug ([7877088](https://github.com/tonygorb/Scenri/commit/787708802c94f46be158c4f3e93c147e0973ee97))
+
+
+### Performance Improvements
+
+* **catalog:** ask the listing for a chosen set, not a page each ([cfe9a3c](https://github.com/tonygorb/Scenri/commit/cfe9a3c3aa7411ae1e8fe6d5002a2f1b4397de53))
+* **catalog:** keep the catalogue the store already handed over ([9630378](https://github.com/tonygorb/Scenri/commit/9630378ed2e076f6cb9b7ce50dde28c68e615548))
+
 ## [0.9.4](https://github.com/tonygorb/Scenri/compare/v0.9.3...v0.9.4) (2026-09-14)
 
 

package/dist/{chunk-3ZRMKVBB.js → chunk-UUYMUOZQ.js}

@@ -2,7 +2,7 @@ import { homedir } from 'os';
 import { join } from 'path';
 import Database from 'better-sqlite3';
 import { randomUUID, createHash } from 'crypto';
-import { mkdirSync, existsSync, chmodSync, readFileSync, writeFileSync, readdirSync, rmSync } from 'fs';
+import { mkdirSync, existsSync, chmodSync, rmSync, readFileSync, writeFileSync, readdirSync } from 'fs';
 
 // ../core/src/index.ts
 
@@ -173,6 +173,14 @@ CREATE TABLE IF NOT EXISTS import_jobs (
   finished_at TEXT
 );
 CREATE INDEX IF NOT EXISTS idx_import_jobs_brand ON import_jobs(brand_id);
+CREATE TABLE IF NOT EXISTS presenter_drafts (
+  id TEXT PRIMARY KEY,
+  brand_id TEXT NOT NULL REFERENCES brands(id) ON DELETE CASCADE,
+  json TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_presenter_drafts_brand ON presenter_drafts(brand_id);
 `;
 function widenNodeStatusCheck(db) {
   const row = db.prepare("SELECT sql FROM sqlite_master WHERE type='table' AND name='nodes'").get();
@@ -197,12 +205,13 @@ function widenNodeStatusCheck(db) {
         brief TEXT,
         archived INTEGER NOT NULL DEFAULT 0,
         duration_ms INTEGER,
+        started_at TEXT,
         batch_id TEXT,
         batch_index INTEGER NOT NULL DEFAULT 0
       );
       INSERT INTO nodes_new
         SELECT id, project_id, parent_id, kind, prompt, engine_id, status, images, cost_usd, kept, error,
-               created_at, overlays, brief, archived, duration_ms, batch_id, batch_index
+               created_at, overlays, brief, archived, duration_ms, started_at, batch_id, batch_index
         FROM nodes;
       DROP TABLE nodes;
       ALTER TABLE nodes_new RENAME TO nodes;
@@ -517,6 +526,9 @@ function openDb(homeDir) {
   if (!nodeCols.includes("duration_ms")) {
     db.exec("ALTER TABLE nodes ADD COLUMN duration_ms INTEGER");
   }
+  if (!nodeCols.includes("started_at")) {
+    db.exec("ALTER TABLE nodes ADD COLUMN started_at TEXT");
+  }
   if (!nodeCols.includes("batch_id")) {
     db.exec("ALTER TABLE nodes ADD COLUMN batch_id TEXT");
   }
@@ -577,6 +589,12 @@ function createImageStore(homeDir) {
     },
     has(hash) {
       return /^[a-f0-9]{32}$/.test(hash) && EXTS.some((ext) => existsSync(fileFor(hash, ext)));
+    },
+    remove(hash) {
+      const file = this.pathFor(hash);
+      if (!existsSync(file)) return false;
+      rmSync(file, { force: true });
+      return true;
     }
   };
 }
@@ -674,6 +692,9 @@ function uniqueSetSlug(db, brandId, name, id) {
   return firstFree(slugifyWithId(name, id, "set"), (c) => !!stmt.get(brandId, c, id));
 }
 var SET_NAME_SEP = String.fromCharCode(31);
+function rowToPresenterDraft(r) {
+  return { id: r.id, brandId: r.brand_id, json: JSON.parse(r.json), createdAt: r.created_at, updatedAt: r.updated_at };
+}
 function rowToSet(r) {
   return {
     id: r.id,
@@ -690,7 +711,7 @@ var LINEAGE_SIBLINGS_RADIUS = 25;
 var LINEAGE_CHILDREN_MAX = 60;
 var LINEAGE_HISTORY_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.engine_id, n.status, n.images, n.cost_usd, n.duration_ms, n.kept, n.error, n.created_at, n.started_at, n.brief, n.archived,
   n.batch_id, n.batch_index, ${CHILD_COUNT_SQL} AS child_count`;
 function rowToFeedNode(r) {
   return {
@@ -707,6 +728,7 @@ function rowToFeedNode(r) {
     kept: !!r.kept,
     error: r.error,
     createdAt: r.created_at,
+    startedAt: r.started_at ?? r.created_at,
     brief: r.brief ? JSON.parse(r.brief) : null,
     archived: !!r.archived,
     batchId: r.batch_id ?? null,
@@ -850,6 +872,21 @@ function createStore(db) {
       );
       return this.getBrand(id);
     },
+    /**
+     * A draft becoming a saved asset: the document and the row move together.
+     *
+     * These were two statements with nothing holding them. A crash between
+     * them left the presenter in the brand AND its draft row alive, so the
+     * wall showed a finished person and an unfinished one, and saving that
+     * draft again appended a second copy of the same person.
+     */
+    updateBrandAndDropPresenterDraft(id, json, draftId) {
+      return db.transaction(() => {
+        const row = this.updateBrand(id, json);
+        this.deletePresenterDraft(draftId);
+        return row;
+      })();
+    },
     deleteBrand(id) {
       db.prepare("DELETE FROM brands WHERE id=?").run(id);
     },
@@ -972,6 +1009,42 @@ function createStore(db) {
     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);
     },
+    // presenter drafts
+    /** Upsert: the same id replaces the json and moves updated_at forward; created_at stays. */
+    putPresenterDraft(row) {
+      db.prepare(
+        // Millisecond stamps, the nodes table's own format: a draft is touched
+        // on every step, and two touches inside one second must still order.
+        `INSERT INTO presenter_drafts (id, brand_id, json, created_at, updated_at)
+           VALUES (?,?,?, strftime('%Y-%m-%d %H:%M:%f','now'), strftime('%Y-%m-%d %H:%M:%f','now'))
+         ON CONFLICT(id) DO UPDATE SET json=excluded.json, updated_at=strftime('%Y-%m-%d %H:%M:%f','now')`
+      ).run(row.id, row.brandId, JSON.stringify(row.json));
+      return this.getPresenterDraft(row.id);
+    },
+    getPresenterDraft(id) {
+      const r = db.prepare("SELECT * FROM presenter_drafts WHERE id=?").get(id);
+      return r ? rowToPresenterDraft(r) : null;
+    },
+    /** Most recently touched first, the same order sets keep. */
+    listPresenterDrafts(brandId) {
+      return db.prepare("SELECT * FROM presenter_drafts WHERE brand_id=? ORDER BY updated_at DESC, created_at DESC, id").all(brandId).map(rowToPresenterDraft);
+    },
+    deletePresenterDraft(id) {
+      db.prepare("DELETE FROM presenter_drafts WHERE id=?").run(id);
+    },
+    /**
+     * Whether any row still points at a stored image: a shot's images, a
+     * shot's brief (source image, attachments), an imported catalog image, or
+     * another presenter draft. The store is content-addressed, so the same
+     * photo uploaded twice is one file; whoever removes an image asks this
+     * first, and the brand documents are the caller's half of the answer.
+     */
+    imageReferenced(hash) {
+      if (!/^[a-f0-9]{32}$/.test(hash)) return false;
+      const like = `%${hash}%`;
+      const hit = (sql, ...args) => !!db.prepare(sql).get(...args);
+      return hit("SELECT 1 FROM nodes WHERE images LIKE ? LIMIT 1", `%"${hash}"%`) || hit("SELECT 1 FROM nodes WHERE brief LIKE ? LIMIT 1", like) || hit("SELECT 1 FROM catalog_images WHERE asset_ref LIKE ? LIMIT 1", like) || hit("SELECT 1 FROM presenter_drafts WHERE json LIKE ? LIMIT 1", like);
+    },
     // nodes / version tree
     addNode(input) {
       if (input.parentId) {
@@ -1044,6 +1117,19 @@ function createStore(db) {
     cancelNode(id) {
       db.prepare("UPDATE nodes SET status='cancelled' WHERE id=?").run(id);
     },
+    /**
+     * Run this shot again on the same row. The card keeps its place: id,
+     * brief, prompt, parent and created_at stay put. Status goes back to
+     * running, the old error and pictures go, so the tile becomes the wait.
+     * started_at moves to now so the clock on the card is this run, not the
+     * minutes the first attempt already spent.
+     */
+    reopenNode(id) {
+      db.prepare(
+        "UPDATE nodes SET status='running', error=NULL, images='[]', duration_ms=NULL, cost_usd=0, started_at=strftime('%Y-%m-%d %H:%M:%f','now') WHERE id=?"
+      ).run(id);
+      return this.getNode(id);
+    },
     getNode(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;
@@ -1711,6 +1797,24 @@ function productImportMethods(db) {
          WHERE product_id=? AND source_url=?`
       ).run(assetRef, meta?.width ?? null, meta?.height ?? null, productId, sourceUrl);
     },
+    /**
+     * How many pictures are still owed, for a progress that can be trusted.
+     *
+     * The importer used to add up the rounds it had fetched and call that the
+     * total, so the total was really "pictures discovered so far": it grew by
+     * sixty every round, and the fraction fell back every time it did. A run
+     * went 60/60, then 64/120, then 122/172 - a bar sliding backwards twice
+     * while nothing had gone wrong. Counting what is left is one query and it
+     * is the actual answer.
+     */
+    countImagesNeedingAssets(brandId, imagesPerProduct) {
+      const row = db.prepare(
+        `SELECT COUNT(*) AS n FROM catalog_images i
+         JOIN catalog_products p ON p.id = i.product_id
+         WHERE p.brand_id=? AND (i.asset_ref IS NULL OR i.asset_ref='') AND i.position < ?`
+      ).get(brandId, imagesPerProduct);
+      return row?.n ?? 0;
+    },
     listImagesNeedingAssets(brandId, limit = 500) {
       return db.prepare(
         `SELECT i.* FROM catalog_images i
@@ -1730,6 +1834,38 @@ function productImportMethods(db) {
         excluded: !!r.excluded
       }));
     },
+    /**
+     * Hide pictures that turn up on product after product.
+     *
+     * A photograph of a thing belongs to that thing. A picture the crawl found
+     * on eighteen different product pages is the shop talking, not the
+     * product: a promotion flash, a collection sticker, a delivery badge.
+     * Measured on a real storefront, three addresses out of 265 were shared
+     * past this threshold and all three were merchandising furniture, while
+     * every genuine packshot appeared once.
+     *
+     * Names nothing and knows nothing about any platform, which is the point:
+     * the badges that caused this carry no word a filter could match, and the
+     * next store's will be different words.
+     *
+     * Excluded rather than deleted, the same state the picture chooser uses,
+     * so anything wrongly caught is still there to be put back.
+     */
+    excludeSharedImages(sourceId, minProducts = 3) {
+      const r = db.prepare(
+        `UPDATE catalog_images SET excluded=1
+             WHERE excluded=0
+               AND product_id IN (SELECT id FROM catalog_products WHERE source_id=?)
+               AND source_url IN (
+                 SELECT ci.source_url FROM catalog_images ci
+                   JOIN catalog_products cp ON cp.id = ci.product_id
+                  WHERE cp.source_id=?
+                  GROUP BY ci.source_url
+                 HAVING COUNT(DISTINCT ci.product_id) >= ?
+               )`
+      ).run(sourceId, sourceId, minProducts);
+      return r.changes;
+    },
     markMissingUnavailable(sourceId, seenExternalKeys) {
       if (!seenExternalKeys.length) {
         const r2 = db.prepare(
@@ -1952,6 +2088,12 @@ function createCatalogStore(db) {
 var REFERENCE_ROLE_DIRECTIVE = {
   product: "the exact product \u2014 preserve its label, shape, colors and design faithfully; do not redesign it",
   character: "the exact person \u2014 match their face, facial structure, skin, hair and build exactly; their clothing, pose and background are capture context, not styling to reproduce",
+  // One thing in the picture, and nothing else in it. A person uploads a pair
+  // of glasses they like, or the exact tattoo, and every other role would have
+  // handed the model a second face to blend with the first: `character` says
+  // "this is who they are", `style` takes the mood of the whole frame. This
+  // says take the object and leave the rest of the photograph behind.
+  detail: "a reference for one detail only \u2014 match the design, shape, proportions, colours and finish of the thing itself, exactly as drawn or made. Take nothing else from this image: not the identity of anyone in it, not their face, skin, hair, body or build, not their clothing, not the background, not the lighting. The person in the picture being drawn is somebody else entirely",
   brand: "the brand's own mark \u2014 if the direction calls for the mark to appear, reproduce it exactly as drawn, same colours, letterforms and proportions, every character down to the smallest secondary lettering, in its original script and reading direction, never translated, transliterated or re-spelled; otherwise take only its colour and treatment, and never its subject, geometry or composition",
   // Only a figure-led scene attaches one of these now, so this says what that
   // case actually needs. It used to read "environment and light only - take no
@@ -1976,6 +2118,7 @@ var REFERENCE_ROLE_DIRECTIVE = {
 var EDIT_REFERENCE_ROLE_DIRECTIVE = {
   product: "the exact product: keep or restore its label, shape and design faithfully",
   character: "the exact person: keep their face, facial structure, skin, hair and build faithfully; take no clothing, pose or background from this reference, and keep the source image's existing outfit unless the instruction changes it",
+  detail: "one detail to match: its design, shape, colours and finish only. Take no identity, skin, hair, body, clothing or background from it",
   brand: "the brand's own mark: reproduce it exactly as drawn wherever it appears \u2014 every character down to the smallest secondary lettering, in its original script and reading direction \u2014 never redrawn, re-lettered, translated or transliterated",
   scene: "a reference for environment, light and treatment only \u2014 take no identity from any person in it",
   composition: "a reference for framing and pose only",
@@ -2032,5 +2175,5 @@ function createCore(homeDir = defaultHome()) {
 }
 
 export { ASPECT_TOLERANCE, BUDGET_EXHAUSTED, EDIT_REFERENCE_ROLE_DIRECTIVE, REFERENCE_ROLE_DIRECTIVE, SCHEMA_VERSION, STEM_MIN, SchemaTooNewError, SpendCapError, TRIGRAM_MIN, budgetSize, createCatalogStore, createCore, createStore, defaultHome, fold, ftsMatch, matchesQuery, ratioLabel, searchTerms, termMatches, uniqueProjectSlug, uniqueSetSlug, uniqueSlug };
-//# sourceMappingURL=chunk-3ZRMKVBB.js.map
-//# sourceMappingURL=chunk-3ZRMKVBB.js.map
+//# sourceMappingURL=chunk-UUYMUOZQ.js.map
+//# sourceMappingURL=chunk-UUYMUOZQ.js.map

package/dist/{cli-MQO66C5O.js → cli-3KKS7BE4.js}

@@ -463,7 +463,7 @@ async function addOrRepair(ownEntry, say, over) {
 }
 async function rememberDecline(home) {
   try {
-    const { createCore } = await import('./src-3ITTV2UE.js');
+    const { createCore } = await import('./src-QZZDZM7I.js');
     const core = createCore(home);
     try {
       core.store.setSetting("desktop.prompt", "declined");
@@ -530,5 +530,5 @@ function tail(path, bytes = 4096) {
 }
 
 export { addToDesktop, assetsDirFor, installDeps, runDesktopCommand, runExecFile, runOpenCommand };
-//# sourceMappingURL=cli-MQO66C5O.js.map
-//# sourceMappingURL=cli-MQO66C5O.js.map
+//# sourceMappingURL=cli-3KKS7BE4.js.map
+//# sourceMappingURL=cli-3KKS7BE4.js.map

package/dist/index.js

@@ -86,12 +86,12 @@ try {
       break;
     }
     case "desktop": {
-      const { runDesktopCommand } = await import('./cli-MQO66C5O.js');
+      const { runDesktopCommand } = await import('./cli-3KKS7BE4.js');
       process.exit(await runDesktopCommand(command, fileURLToPath(import.meta.url)));
       break;
     }
     case "open": {
-      const { runOpenCommand } = await import('./cli-MQO66C5O.js');
+      const { runOpenCommand } = await import('./cli-3KKS7BE4.js');
       process.exit(await runOpenCommand(fileURLToPath(import.meta.url)));
       break;
     }