scenri 0.9.2 → 0.9.3

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # Changelog
 
+## [0.9.3](https://github.com/tonygorb/Scenri/compare/v0.9.2...v0.9.3) (2026-09-14)
+
+
+### Features
+
+* **catalog:** look for a shop without reading the whole catalog ([65774cd](https://github.com/tonygorb/Scenri/commit/65774cdcc7e45dc5468b564bfb7596d2fcbb1500))
+* **catalog:** make a whole-catalogue import something a machine can hold ([9c44842](https://github.com/tonygorb/Scenri/commit/9c44842e2f421671543a418cb2a884b12e02f26e))
+* **cli:** scan a site for a shop, and import only what was chosen ([3f02cc5](https://github.com/tonygorb/Scenri/commit/3f02cc592ec025ba920de6e63683977113e5854f))
+* **composer:** the insert menu pages, and stops moving under the caret ([d3fa697](https://github.com/tonygorb/Scenri/commit/d3fa69744e02cd69ae6ab708b095ef7c45933f48))
+* one website, a brand and its products ([ced5f4c](https://github.com/tonygorb/Scenri/commit/ced5f4cccbb5aedc500332b166d4e42c95d344ac))
+* **studio:** reach every product, take them all, and watch it happen ([3f19576](https://github.com/tonygorb/Scenri/commit/3f195767d59204c68fdd8c0870f2faf2349585a5))
+* **studio:** say what a website had on it, products included ([45665e7](https://github.com/tonygorb/Scenri/commit/45665e70c10a8f307bf57ee22f4a22ee936d6870))
+* the composer insert menu pages, and stops moving under the caret ([1c36667](https://github.com/tonygorb/Scenri/commit/1c3666772b46552b4c4a76123f4a00fd7b651c69))
+
+
+### Bug Fixes
+
+* **brand:** a website is a brand source, and "Invalid URL" is not a sentence ([cde0841](https://github.com/tonygorb/Scenri/commit/cde0841bcd79c49f8d0d3ed29da4c3429718f284))
+* **brand:** find the logo and the colours a site actually has, safely ([a6e7d3b](https://github.com/tonygorb/Scenri/commit/a6e7d3be87196fd0386448c91f6dca712dfc0b94))
+* **brand:** never crown a logo the evidence does not support ([07b427d](https://github.com/tonygorb/Scenri/commit/07b427d7e7b4acd4d4c03ac3f23ed4722f297b61))
+* **brand:** pick the wordmark out of the nav, not a photo two elements later ([55cb444](https://github.com/tonygorb/Scenri/commit/55cb444b1c00abdd4ec28640375dc5dad518f8f0))
+* **brand:** read the palette a site declares, for the theme it is wearing ([323b722](https://github.com/tonygorb/Scenri/commit/323b7229c8f89c2dac9b58c60d596eb157362715))
+* **brand:** show the kit that was just built, instead of flashing it ([5f5672f](https://github.com/tonygorb/Scenri/commit/5f5672ff811f54e83fa44442e2f7db9a40f272cb))
+* **brand:** stop inventing products, and stop crawling sites nobody asked about ([5a70c7d](https://github.com/tonygorb/Scenri/commit/5a70c7d9cff539ae4c8cae6a8b40f4c219ee5e49))
+* **catalog:** a finished import says finished ([640a8a1](https://github.com/tonygorb/Scenri/commit/640a8a1fa8f08d1920fe83078f054303958646cd))
+* **catalog:** a slow catalog is not a shut one ([06c8ba4](https://github.com/tonygorb/Scenri/commit/06c8ba491a4c2e65d585c33d2543cda286c5aba9))
+* **catalog:** four pictures at once too, and count a refusal that threw ([c773029](https://github.com/tonygorb/Scenri/commit/c77302904c933f3b4b1c220a7ff2c8d529536b5f))
+* **catalog:** import in batches, and stop the setup screen losing the products ([4257515](https://github.com/tonygorb/Scenri/commit/4257515a46bb07594dd88657d87046daa665a850))
+* **catalog:** read a shop at a rate it will tolerate, and say when it stops ([98c2e53](https://github.com/tonygorb/Scenri/commit/98c2e53d573d037ba4f1f72e5212b97083f5afab))
+* **catalog:** read the product pages a blocked storefront API still serves ([21ab82b](https://github.com/tonygorb/Scenri/commit/21ab82b0427f0cc30a6884637663439981bd1c29))
+* **catalog:** stop reading the same catalog once per language ([1a870aa](https://github.com/tonygorb/Scenri/commit/1a870aabd1fd5b627d36e253787d6ef08b33337f))
+* **catalog:** stop the crawler being pointed anywhere a caller likes ([d4a0204](https://github.com/tonygorb/Scenri/commit/d4a0204892b3cb7c6f94e03153505a9bad8d97e4))
+* **catalog:** two things eight real websites found ([1c938f6](https://github.com/tonygorb/Scenri/commit/1c938f6babc0da62b55fa1fce6d04de069e04ae4))
+* **codex:** ready now means a real codex run authenticated ([33cf286](https://github.com/tonygorb/Scenri/commit/33cf28653d63cdfeab267db9557ae0b696197bd0))
+* **composer:** type the insert menu's page state as a number ([86ec924](https://github.com/tonygorb/Scenri/commit/86ec924f70c56e7d96e0bc5772331883ee64ef88))
+* **deps:** take the patched vitest line, closing three Dependabot alerts ([9ec12d0](https://github.com/tonygorb/Scenri/commit/9ec12d0989b3cb9b033a61bb00c1b3c7e891bd32))
+* **desktop:** say why the icon failed, not which PowerShell command failed ([8108827](https://github.com/tonygorb/Scenri/commit/81088274944b8df1042e2095451552d09a33c6df))
+* **desktop:** the icon offer can no longer stop Scenri from starting ([dacdbba](https://github.com/tonygorb/Scenri/commit/dacdbba142709d11e7fac0c57828cbdd9acf0a2d))
+* **install:** stop sending Windows users to an administrator they do not need ([42c43ea](https://github.com/tonygorb/Scenri/commit/42c43ea36f6b9d22bc4dae0d296a0cee7634cf18))
+* **notifications:** the Tasks tab holds work in flight, not every import ever run ([8d67c75](https://github.com/tonygorb/Scenri/commit/8d67c7598b6a217478021274d91184a5d5bb957b))
+* **products:** a hand-made product keeps all of its pictures ([14e6120](https://github.com/tonygorb/Scenri/commit/14e6120da46ee78cabf6e86fc0f2661255037259))
+* **studio:** a building card is the wait, not a caption ([7ddc983](https://github.com/tonygorb/Scenri/commit/7ddc98337e8d98452e408798e0ec7cc88a561b33))
+* **studio:** keep the store's half of the library as the server sorted it ([11bb05f](https://github.com/tonygorb/Scenri/commit/11bb05fd75edf5a0c4d8efed8227f7e0357b8f2a))
+* **studio:** show the products arriving, and stop asking for more than can land ([62ebca0](https://github.com/tonygorb/Scenri/commit/62ebca0a0cff29bf0a5e914499363d750ecd0ee0))
+* **studio:** your own work, newest first ([4bbfda2](https://github.com/tonygorb/Scenri/commit/4bbfda2d3e17bf586d974a93cad822af2e84d09f))
+* Windows first run, Codex readiness and website brand import ([0831502](https://github.com/tonygorb/Scenri/commit/0831502163385fb12a04919d26acf5677d761427))
+* your own work newest first, and a quieter building card ([20c4e1c](https://github.com/tonygorb/Scenri/commit/20c4e1c1cfd629ef88e4aa512e855103ad3e502a))
+
+
+### Performance Improvements
+
+* **catalog:** crawl a whole store in batches, and close jobs a crash left open ([98f1ce9](https://github.com/tonygorb/Scenri/commit/98f1ce9daaa5fa70e97ac308c075269fdcbe3254))
+* **catalog:** import one product at a time, pictures alongside ([a86abc8](https://github.com/tonygorb/Scenri/commit/a86abc886ae644ba265cdf5c6d316dc15dbad09b))
+* **catalog:** make a large import progressive, bounded and watchable ([fff18dc](https://github.com/tonygorb/Scenri/commit/fff18dca84156b794d9eb67a582709f55b3f94b3))
+* **catalog:** read twelve product pages at once, and stop cutting them short ([c137cfd](https://github.com/tonygorb/Scenri/commit/c137cfd3dc319093f8484e2b719f5aaae607ee87))
+* **products:** a waiting card holds its space, and its picture is asked for early ([5a20f91](https://github.com/tonygorb/Scenri/commit/5a20f91c960ceeecfa813d503c437965449091f7))
+
+
+### Miscellaneous Chores
+
+* **release:** pin the next version to 0.9.3 ([1b019ba](https://github.com/tonygorb/Scenri/commit/1b019bae1ab357421287c10d1765111e843134ae))
+
 ## [0.9.2](https://github.com/tonygorb/Scenri/compare/v0.9.1...v0.9.2) (2026-09-07)
 
 

package/README.md

@@ -63,7 +63,9 @@ Scenri runs on [Node.js](https://nodejs.org), version 22 or newer. If you are no
 npx scenri
 ```
 
-That is the whole install. npm asks once whether to proceed, downloads the current release, and opens `http://127.0.0.1:4747`. Keep the terminal window open while you work; closing it stops Scenri. Tomorrow the same command opens it again, with everything where you left it.
+That is the whole install. npm asks once whether to proceed, downloads the current release, and opens `http://127.0.0.1:4747`. Keep the terminal window open while you work; closing it stops Scenri. Tomorrow the same command opens it again, with everything where you left it. Nothing here needs an administrator.
+
+On Windows, if PowerShell answers `npx.ps1 cannot be loaded because running scripts is disabled on this system`, that is a stock Windows setting, not a fault: type `npx.cmd scenri` instead, or use Command Prompt. Still no administrator required.
 
 On macOS and Windows, Scenri then asks once whether to put a **Scenri icon on your desktop**. Say yes and from then on a double-click starts Scenri and opens it in your browser, no terminal needed; the icon works offline and keeps working across updates. Said no? Settings, then About, then **Add to desktop**, or `npx scenri desktop` in a terminal. Scenri stays what it is, a local server and your browser: the icon is a launcher, not an app.
 

package/dist/{chunk-SDVL5OJF.js → chunk-3BGDI4HI.js}

@@ -146,12 +146,35 @@ async function writeLnk(runImpl, opts) {
 // src/desktop/install.ts
 var UNSUPPORTED = "Desktop shortcuts are not available on this system yet.";
 var NO_DESKTOP = "Your Desktop folder could not be found.";
+var PROBE_FAILED = "This computer did not answer where your Desktop folder is.";
 var COLLISION = "Something else named Scenri is already on your desktop. Move or rename it, then try again.";
 var DENIED = "macOS did not allow writing to your Desktop. Allow it under System Settings > Privacy & Security > Files and Folders, then try again.";
 var SUPPORT_FILES = ["launch.mjs", "Scenri.icns", "scenri.ico"];
+function failureDetail(err) {
+  const e = err;
+  const lineOf = (text) => text.split("\n").map((l) => l.trim()).filter(Boolean)[0] ?? "";
+  const stderr = typeof e.stderr === "string" ? lineOf(e.stderr) : "";
+  if (stderr) return stderr.slice(0, 200);
+  if (e.killed === true || e.code === "ETIMEDOUT") return "it did not answer in time";
+  const message = err instanceof Error ? err.message : String(err);
+  const useful = message.split("\n").map((l) => l.trim()).filter(Boolean).find((l) => !/^Command failed:/i.test(l));
+  return (useful ?? "the command did not finish").slice(0, 200);
+}
 async function installDesktop(deps) {
+  try {
+    return await install(deps);
+  } catch (err) {
+    return { ok: false, reason: "failed", message: `Scenri could not add the desktop icon (${failureDetail(err)}).` };
+  }
+}
+async function install(deps) {
   if (!isSupportedPlatform(deps.platform)) return { ok: false, reason: "unsupported", message: UNSUPPORTED };
-  const desktop = await desktopDir(deps);
+  let desktop;
+  try {
+    desktop = await desktopDir(deps);
+  } catch (err) {
+    return { ok: false, reason: "probe-failed", message: `${PROBE_FAILED} (${failureDetail(err)})` };
+  }
   if (!desktop) return { ok: false, reason: "no-desktop", message: NO_DESKTOP };
   const darwin = deps.platform === "darwin";
   const support = launcherDir(deps.homedir);
@@ -164,7 +187,15 @@ async function installDesktop(deps) {
   }
   const nodeMajor = runningNodeMajor();
   const nodePath = stableExecPath(deps.execPath, deps.platform);
-  writeSupportFiles({ ...deps, execPath: nodePath, nodeMajor }, support);
+  try {
+    writeSupportFiles({ ...deps, execPath: nodePath, nodeMajor }, support);
+  } catch (err) {
+    return {
+      ok: false,
+      reason: "failed",
+      message: `Scenri could not write its launcher files to ${support} (${failureDetail(err)}).`
+    };
+  }
   try {
     if (darwin) {
       writeMacBundle({
@@ -186,18 +217,25 @@ async function installDesktop(deps) {
     const code = err.code;
     if (darwin && (code === "EPERM" || code === "EACCES"))
       return { ok: false, reason: "desktop-denied", message: DENIED };
-    const detail = err instanceof Error ? err.message.split("\n")[0] : String(err);
-    return { ok: false, reason: "failed", message: `Scenri could not write ${artifact} (${detail}).` };
+    return { ok: false, reason: "failed", message: `Scenri could not write ${artifact} (${failureDetail(err)}).` };
+  }
+  try {
+    writeLauncherRecord(deps.homedir, {
+      schema: LAUNCHER_SCHEMA,
+      createdBy: deps.version,
+      home: deps.home,
+      nodePath,
+      nodeMajor,
+      env: recordedEnv(deps.env),
+      artifact: { kind, path: artifact }
+    });
+  } catch (err) {
+    return {
+      ok: false,
+      reason: "failed",
+      message: `Scenri added the icon but could not record where it points (${failureDetail(err)}).`
+    };
   }
-  writeLauncherRecord(deps.homedir, {
-    schema: LAUNCHER_SCHEMA,
-    createdBy: deps.version,
-    home: deps.home,
-    nodePath,
-    nodeMajor,
-    env: recordedEnv(deps.env),
-    artifact: { kind, path: artifact }
-  });
   return { ok: true, kind, path: artifact };
 }
 var runningNodeMajor = () => Number(process.versions.node.split(".")[0]);
@@ -250,6 +288,6 @@ async function desktopStatus(deps) {
   return { supported, platform: deps.platform, installed, path, current, record };
 }
 
-export { MAC_SCRIPT, POWERSHELL_ARGS, UNSUPPORTED, desktopStatus, installDesktop, isOurMacBundle, macPlist, removeDesktop, runningNodeMajor, stableExecPath, writeLnk, writeMacBundle, writeSupportFiles };
-//# sourceMappingURL=chunk-SDVL5OJF.js.map
-//# sourceMappingURL=chunk-SDVL5OJF.js.map
+export { MAC_SCRIPT, POWERSHELL_ARGS, UNSUPPORTED, desktopStatus, failureDetail, installDesktop, isOurMacBundle, macPlist, removeDesktop, runningNodeMajor, stableExecPath, writeLnk, writeMacBundle, writeSupportFiles };
+//# sourceMappingURL=chunk-3BGDI4HI.js.map
+//# sourceMappingURL=chunk-3BGDI4HI.js.map

package/dist/{chunk-OJAG3FRX.js → chunk-Y5L3KLX5.js}

@@ -551,23 +551,32 @@ function openDb(homeDir) {
 function createImageStore(homeDir) {
   const dir = join(homeDir, "images");
   mkdirSync(dir, { recursive: true, mode: 448 });
-  const fileFor = (hash) => join(dir, `${hash}.png`);
+  const EXTS = ["png", "jpg", "jpeg", "webp", "gif", "avif"];
+  const fileFor = (hash, ext = "png") => join(dir, `${hash}.${ext}`);
+  const resolve = (hash) => {
+    for (const ext of EXTS) {
+      const file = fileFor(hash, ext);
+      if (existsSync(file)) return file;
+    }
+    return fileFor(hash);
+  };
   return {
-    save(buf) {
+    save(buf, ext = "png") {
+      const clean = /^[a-z0-9]{2,5}$/i.test(ext) ? ext.toLowerCase() : "png";
       const hash = createHash("sha256").update(buf).digest("hex").slice(0, 32);
-      const file = fileFor(hash);
+      const file = fileFor(hash, clean);
       if (!existsSync(file)) writeFileSync(file, buf);
       return hash;
     },
     pathFor(hash) {
       if (!/^[a-f0-9]{32}$/.test(hash)) throw new Error("invalid image hash");
-      return fileFor(hash);
+      return resolve(hash);
     },
     read(hash) {
       return readFileSync(this.pathFor(hash));
     },
     has(hash) {
-      return /^[a-f0-9]{32}$/.test(hash) && existsSync(fileFor(hash));
+      return /^[a-f0-9]{32}$/.test(hash) && EXTS.some((ext) => existsSync(fileFor(hash, ext)));
     }
   };
 }
@@ -1335,8 +1344,9 @@ var productById = (db, id) => {
   const r = db.prepare("SELECT * FROM catalog_products WHERE id=?").get(id);
   return r ? rowProduct(r) : null;
 };
+var LIST_COLS = "id, source_id, brand_id, external_key, title, description_html, url, handle, vendor, product_type, tags, category, price, compare_at_price, currency, available, status, variant, material, dimensions, created_at, updated_at";
 var productsFor = (db, brandId) => db.prepare(
-  "SELECT * FROM catalog_products WHERE brand_id=? AND status!='unavailable' ORDER BY title COLLATE NOCASE"
+  `SELECT ${LIST_COLS} FROM catalog_products WHERE brand_id=? AND status!='unavailable' ORDER BY created_at DESC, rowid DESC`
 ).all(brandId).map(rowProduct);
 var rowVariant = (r) => ({
   id: r.id,
@@ -1469,14 +1479,58 @@ function jobMethods(db) {
       const r = db.prepare("SELECT * FROM import_jobs WHERE id=?").get(id);
       return r ? rowJob(r) : null;
     },
+    /**
+     * What the notifications bell needs: work in flight, and what has just
+     * stopped.
+     *
+     * `listJobs` answers with every import the brand has ever run, and the
+     * bell rendered all of them as tasks - so one finished import sat in the
+     * Tasks tab, and in its count, for ever, and a brand with a few imports
+     * behind it opened onto a list of things that were over. An hour is long
+     * enough for the panel to still be showing you what landed while you were
+     * on another screen, and short enough that it is never a history.
+     */
+    listRecentJobs(brandId) {
+      return db.prepare(
+        `SELECT * FROM import_jobs
+              WHERE brand_id=?
+                AND (finished_at IS NULL OR finished_at > datetime('now','-1 hour'))
+              ORDER BY created_at DESC`
+      ).all(brandId).map(rowJob);
+    },
     listJobs(brandId) {
       return db.prepare("SELECT * FROM import_jobs WHERE brand_id=? ORDER BY created_at DESC").all(brandId).map(rowJob);
     },
+    /**
+     * Close every job that was still running when the process last stopped.
+     *
+     * A job lives in the database and its worker lives in the process, so a
+     * quit, a crash or a restart leaves a row that says `fetching_products`
+     * with no `finished_at` and nothing on earth still working on it. The bell
+     * then shows a task running for ever, and no later write can correct it
+     * because nothing is left to do the writing. Nothing is in flight at
+     * startup by definition, so anything unfinished here was interrupted.
+     *
+     * Whatever it had already saved stays saved; only the row is closed.
+     */
+    reconcileInterruptedJobs() {
+      const { changes } = db.prepare(
+        `UPDATE import_jobs
+              SET stage='cancelled',
+                  finished_at=datetime('now'),
+                  message=CASE WHEN upserted > 0
+                    THEN 'Interrupted when Scenri stopped, after saving ' || upserted || ' products'
+                    ELSE 'Interrupted when Scenri stopped' END
+            WHERE finished_at IS NULL`
+      ).run();
+      return changes;
+    },
     updateJob(id, patch) {
       const cur = jobById(db, id);
       if (!cur) return null;
+      if (cur.finishedAt) return cur;
       const stage = patch.stage ?? cur.stage;
-      const finished = patch.finished || stage === "completed" || stage === "partial" || stage === "failed";
+      const finished = patch.finished || stage === "completed" || stage === "partial" || stage === "no_catalog" || stage === "cancelled" || stage === "failed";
       db.prepare(
         `UPDATE import_jobs SET
           source_id=?, platform=?, stage=?, discovered=?, fetched=?, upserted=?,
@@ -1779,6 +1833,18 @@ function mutationMethods(db) {
 }
 
 // ../core/src/catalog/library.ts
+var lighten = (p) => ({
+  id: p.id,
+  name: p.name,
+  origin: p.origin,
+  category: p.category ?? null,
+  variant: p.variant ?? null,
+  material: p.material ?? null,
+  dimensions: p.dimensions ?? null,
+  status: p.status,
+  shots: p.shots.slice(0, 1),
+  shotCount: p.shots.length
+});
 function libraryMethods(db) {
   return {
     listLibraryProducts(brandId, brandJson) {
@@ -1836,6 +1902,29 @@ function libraryMethods(db) {
         };
       });
       return [...manual, ...catalog];
+    },
+    /**
+     * The whole library, in the shape the studio reads.
+     *
+     * Newest first, so an import lands where someone is watching and nothing
+     * already on screen moves under them. Manual products keep their place at
+     * the head - they are the ones a person made by hand.
+     */
+    listLibraryIndex(brandId, brandJson) {
+      return this.listLibraryProducts(brandId, brandJson).map(
+        (p) => (
+          // Only what came from a store. A manual product's pictures are already
+          // in the brand document this was built from, so trimming them saves
+          // nothing - and the product page asks the server for the whole record
+          // only for catalog products, so a hand-made product with four
+          // references was left showing one, everywhere, for good.
+          p.origin === "catalog" ? lighten(p) : { ...lighten(p), shots: p.shots, shotCount: p.shots.length }
+        )
+      );
+    },
+    /** One product, whole, for the page that shows all of its pictures. */
+    libraryProduct(brandId, brandJson, productId) {
+      return this.listLibraryProducts(brandId, brandJson).find((p) => p.id === productId) ?? null;
     }
   };
 }
@@ -1936,5 +2025,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-OJAG3FRX.js.map
-//# sourceMappingURL=chunk-OJAG3FRX.js.map
+//# sourceMappingURL=chunk-Y5L3KLX5.js.map
+//# sourceMappingURL=chunk-Y5L3KLX5.js.map

package/dist/{cli-FYWM4HBN.js → cli-SX46UQO6.js}

@@ -2,10 +2,10 @@ import { adoptRunningInstall } from './chunk-ECS5LRHB.js';
 import { detectInstallKind } from './chunk-PAIAXRAC.js';
 import { readMeta } from './chunk-Y3ZPBPLP.js';
 import { defaultHome, newestStaged, listStaged, compareSemver, entryOf } from './chunk-4MAFHYAD.js';
-import { removeDesktop, installDesktop, POWERSHELL_ARGS } from './chunk-SDVL5OJF.js';
+import { removeDesktop, failureDetail, installDesktop, POWERSHELL_ARGS } from './chunk-3BGDI4HI.js';
 import { launcherDir, logsDir, powershellPath } from './chunk-2IGINCPU.js';
 import { execFile, spawn } from 'child_process';
-import { existsSync, closeSync, readFileSync, writeFileSync, mkdirSync, openSync, rmSync, statSync, renameSync, appendFileSync } from 'fs';
+import { closeSync, existsSync, readFileSync, writeFileSync, mkdirSync, openSync, rmSync, statSync, renameSync, appendFileSync } from 'fs';
 import { homedir } from 'os';
 import { join, dirname, delimiter, win32 } from 'path';
 import { createServer } from 'http';
@@ -419,6 +419,15 @@ async function runDesktopCommand(opts, ownEntry) {
   return (await addToDesktop(ownEntry)).ok ? 0 : 1;
 }
 async function addToDesktop(ownEntry, say = console.log, over = {}) {
+  try {
+    return await addOrRepair(ownEntry, say, over);
+  } catch (err) {
+    const message = `Scenri could not add the desktop icon (${failureDetail(err)}).`;
+    say(`  ${message}`);
+    return { ok: false, reason: "failed", message };
+  }
+}
+async function addOrRepair(ownEntry, say, over) {
   const deps = { ...installDeps(ownEntry), ...over };
   const pkg = over.pkg ?? readMeta().name;
   const installKind = over.installKind ?? detectInstallKind(ownEntry, deps.home);
@@ -454,7 +463,7 @@ async function addToDesktop(ownEntry, say = console.log, over = {}) {
 }
 async function rememberDecline(home) {
   try {
-    const { createCore } = await import('./src-CSR34EBZ.js');
+    const { createCore } = await import('./src-F3KJZNZT.js');
     const core = createCore(home);
     try {
       core.store.setSetting("desktop.prompt", "declined");
@@ -519,8 +528,7 @@ function tail(path, bytes = 4096) {
     return "";
   }
 }
-var supportInstalled = () => existsSync(join(launcherDir(homedir()), "launcher.json"));
 
-export { addToDesktop, assetsDirFor, installDeps, runDesktopCommand, runExecFile, runOpenCommand, supportInstalled };
-//# sourceMappingURL=cli-FYWM4HBN.js.map
-//# sourceMappingURL=cli-FYWM4HBN.js.map
+export { addToDesktop, assetsDirFor, installDeps, runDesktopCommand, runExecFile, runOpenCommand };
+//# sourceMappingURL=cli-SX46UQO6.js.map
+//# sourceMappingURL=cli-SX46UQO6.js.map

package/dist/index.js

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

package/dist/install-VXJPLYWM.js

@@ -0,0 +1,4 @@
+export { UNSUPPORTED, desktopStatus, failureDetail, installDesktop, removeDesktop, runningNodeMajor, stableExecPath, writeSupportFiles } from './chunk-3BGDI4HI.js';
+import './chunk-2IGINCPU.js';
+//# sourceMappingURL=install-VXJPLYWM.js.map
+//# sourceMappingURL=install-VXJPLYWM.js.map

package/dist/offer-W6NJXMWT.js

@@ -0,0 +1,71 @@
+import { createInterface } from 'readline';
+
+// src/desktop/offer.ts
+function shouldOfferDesktop(i) {
+  if (i.env.SCENRI_NO_DESKTOP === "1") return false;
+  if (!i.stdinTTY || !i.stdoutTTY) return false;
+  if (i.env.CI) return false;
+  if (i.env.SSH_TTY) return false;
+  if (i.platform !== "darwin" && i.platform !== "win32") return false;
+  if (i.installKind === "dev") return false;
+  if (i.launcherInstalled) return false;
+  if (i.declined) return false;
+  return true;
+}
+var OFFER_QUESTION = "  Add Scenri to your desktop? Then you can open it without a terminal. [Y/n] ";
+var LATER_LINE = "  Not now. Add it later with: npx scenri desktop, or from Settings > About.";
+var STILL_RUNNING_LINE = "  Scenri is running anyway. Add the icon later from Settings > About.";
+var ASK_TIMEOUT_MS = 12e4;
+function parseOfferAnswer(raw) {
+  const answer = raw.trim().toLowerCase();
+  if (answer === "" || answer.startsWith("y")) return "yes";
+  return "no";
+}
+async function offerDesktop(deps) {
+  let answer;
+  try {
+    answer = await deps.ask(OFFER_QUESTION);
+  } catch {
+    deps.say("");
+    deps.say(LATER_LINE);
+    return;
+  }
+  if (parseOfferAnswer(answer) === "no") {
+    deps.decline();
+    deps.say(LATER_LINE);
+    return;
+  }
+  try {
+    const res = await deps.add();
+    if (!res.ok) deps.say(STILL_RUNNING_LINE);
+  } catch {
+    deps.say("  Could not add the desktop icon.");
+    deps.say(STILL_RUNNING_LINE);
+  }
+}
+function askOnTerminal(question, timeoutMs = ASK_TIMEOUT_MS, io = {
+  input: process.stdin,
+  output: process.stdout
+}) {
+  return new Promise((resolve, reject) => {
+    const rl = createInterface({ input: io.input, output: io.output, terminal: false });
+    let done = false;
+    const finish = (fn) => {
+      if (done) return;
+      done = true;
+      clearTimeout(timer);
+      rl.close();
+      fn();
+    };
+    const timer = setTimeout(() => finish(() => reject(new Error("nobody answered"))), timeoutMs);
+    timer.unref?.();
+    rl.question(question, (answer) => finish(() => resolve(answer)));
+    rl.once("close", () => {
+      if (!done) finish(() => reject(new Error("stdin closed")));
+    });
+  });
+}
+
+export { OFFER_QUESTION, askOnTerminal, offerDesktop, parseOfferAnswer, shouldOfferDesktop };
+//# sourceMappingURL=offer-W6NJXMWT.js.map
+//# sourceMappingURL=offer-W6NJXMWT.js.map

package/dist/{refresh-FKQABJOC.js → refresh-5HBDLLLB.js}

@@ -1,6 +1,6 @@
 import { adoptRunningInstall } from './chunk-ECS5LRHB.js';
 import { newestStaged, compareSemver } from './chunk-4MAFHYAD.js';
-import { runningNodeMajor, stableExecPath, isOurMacBundle, MAC_SCRIPT, macPlist, writeSupportFiles, writeMacBundle, writeLnk } from './chunk-SDVL5OJF.js';
+import { runningNodeMajor, stableExecPath, isOurMacBundle, MAC_SCRIPT, macPlist, writeSupportFiles, writeMacBundle, writeLnk } from './chunk-3BGDI4HI.js';
 import { readLauncherRecord, launcherDir, LAUNCHER_SCHEMA, writeLauncherRecord } from './chunk-2IGINCPU.js';
 import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
@@ -101,5 +101,5 @@ function sameFile(a, b) {
 }
 
 export { refreshLauncher };
-//# sourceMappingURL=refresh-FKQABJOC.js.map
-//# sourceMappingURL=refresh-FKQABJOC.js.map
+//# sourceMappingURL=refresh-5HBDLLLB.js.map
+//# sourceMappingURL=refresh-5HBDLLLB.js.map