scenri 0.10.2 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## [0.11.0](https://github.com/tonygorb/Scenri/compare/v0.10.3...v0.11.0) (2026-09-18)
+
+
+### Features
+
+* first use, a tutor that walks the real task, with First steps and Learn ([47e9775](https://github.com/tonygorb/Scenri/commit/47e977569049803f0544ce19ad0289cdc8e187f5))
+* Learn, every lesson in one place, begun and continued with the same tutor ([1d378e1](https://github.com/tonygorb/Scenri/commit/1d378e17f22a8ebf64878d67caa0996027e5f1f6))
+* **studio:** New lands on Create with the add panel open ([674bf9c](https://github.com/tonygorb/Scenri/commit/674bf9cbb369443e75b78586210a0b0b12c94826))
+* **studio:** New's plus rides a gold disc ([673a17b](https://github.com/tonygorb/Scenri/commit/673a17b1e48eb491ecc2c9a1d122955d11e24d0d))
+* **studio:** the brand menu leads with where you have been and stays one height ([e28a857](https://github.com/tonygorb/Scenri/commit/e28a8573f797f75815687239cd58c1b4d01518e7))
+* **studio:** the new top bar ([e1d262b](https://github.com/tonygorb/Scenri/commit/e1d262b9eb21a4fd788dae8acd487096223b87c6))
+
+
+### Bug Fixes
+
+* a product made from the picker is named, and Enter on a control is that control's ([7383c7b](https://github.com/tonygorb/Scenri/commit/7383c7baa6fde61dcbf060c68cb429960caee73a))
+* a task ended on a surface is not begun there again, and an empty chip panel foot is not drawn ([2b450fd](https://github.com/tonygorb/Scenri/commit/2b450fd3b7aeb875fee5649b670f3839af0f7894))
+* closing Learn gives the keyboard back to Help when what opened it is gone ([c12d690](https://github.com/tonygorb/Scenri/commit/c12d690fad3e7ce4d1cfaed05aa6982a97d5de4c))
+* in the walk a chip comes in through its ask and leaves only through Back ([a0e9fea](https://github.com/tonygorb/Scenri/commit/a0e9fea7426755ba020f766f0a0678df96542e2c))
+* **studio:** a bar menu answers the next click, even while it is closing ([7b0af47](https://github.com/tonygorb/Scenri/commit/7b0af476d0af0691be60616687955c3521171787))
+* **studio:** a brand icon that is its own ground fills its circle ([0f356fb](https://github.com/tonygorb/Scenri/commit/0f356fbbd19e899ae41751851f873fedbce4d9b5))
+* **studio:** a brand's circle shows its icon, or its initial, never a shrunken wordmark ([6c8415d](https://github.com/tonygorb/Scenri/commit/6c8415da61b261629cee734366a1cece630a58c4))
+* **studio:** New pressed with the add panel open leaves it open and focuses the brief ([37050a4](https://github.com/tonygorb/Scenri/commit/37050a4e4b99f431649f97423ab6596f8ba52dad))
+* **studio:** New wears round ends, the mark shows its box, and Clear all joins its list ([2ed412e](https://github.com/tonygorb/Scenri/commit/2ed412e1faf4d60378b0996f02373ea804b27fe9))
+* **studio:** New's plus sits on an ink disc, and the bar no longer shrinks ([86ceaa3](https://github.com/tonygorb/Scenri/commit/86ceaa33dc16856a1c3fa2e4950360d1a77c5eec))
+* **studio:** pointing at New's plus lights the whole button ([d3a4973](https://github.com/tonygorb/Scenri/commit/d3a4973dc8ee9a0ce090e24fd3f3f8a591c1b0f5))
+* **studio:** the bar wears the full Scenri lockup, bare ([25efd02](https://github.com/tonygorb/Scenri/commit/25efd0292c1d0982ec1f027364489306cf294bea))
+* **studio:** the brand list ends on a whole row ([a20da23](https://github.com/tonygorb/Scenri/commit/a20da23fd89240fd533944ad222c62144795a12e))
+* **studio:** the brand list fades into the line under it while there is more ([18073f8](https://github.com/tonygorb/Scenri/commit/18073f8ea67157c64bbb7b676eb9aade51276614))
+* **studio:** the brand list is ten rows tall ([df5b4e1](https://github.com/tonygorb/Scenri/commit/df5b4e1b834aabf9b4dc22338e83ce99a19550e3))
+* **studio:** the brand list runs straight into the line under it ([402e017](https://github.com/tonygorb/Scenri/commit/402e0176e3bb7ae5cc799af77de4852e92608ba1))
+* **studio:** the brand menu is one compact list ([1e3dc70](https://github.com/tonygorb/Scenri/commit/1e3dc7002cae58fbc8bacc567cf3a924a38a6a1c))
+* **studio:** the brand menu is one list, and the help button leaves this branch ([2e717d1](https://github.com/tonygorb/Scenri/commit/2e717d1474f45e625e85bef36b69d3397cb20925))
+* the tutor keeps what a moment is about in sight, and lets people go their own way ([41e667e](https://github.com/tonygorb/Scenri/commit/41e667e94a930d85bf1ad88fbba4bf00ae6f5ece))
+* the welcome reads top to bottom, speaks plainly, and opens again from Help ([7edb94f](https://github.com/tonygorb/Scenri/commit/7edb94f289e17c1c4255cc6ef683758bc21aea17))
+
+## [0.10.3](https://github.com/tonygorb/Scenri/compare/v0.10.2...v0.10.3) (2026-09-18)
+
+
+### Bug Fixes
+
+* look for npm without freezing the server ([db1bde3](https://github.com/tonygorb/Scenri/commit/db1bde3e1450353bd0f62c7ecf2a2796ea2af75d))
+* look for npm without freezing the server ([cec4b03](https://github.com/tonygorb/Scenri/commit/cec4b0327f2dd4f1846e9c9192926876db851ada))
+
 ## [0.10.2](https://github.com/tonygorb/Scenri/compare/v0.10.1...v0.10.2) (2026-09-17)
 
 

package/dist/{chunk-UUYMUOZQ.js → chunk-K6IELFL3.js}

@@ -1344,6 +1344,55 @@ function createStore(db) {
     setOverlays(id, overlays) {
       db.prepare("UPDATE nodes SET overlays=? WHERE id=?").run(JSON.stringify(overlays), id);
     },
+    // first use: what the library already proves, read by the guide record
+    /** The database's own clock, in the format every node's created_at uses. */
+    now() {
+      return db.prepare("SELECT strftime('%Y-%m-%d %H:%M:%f','now') AS t").get().t;
+    },
+    /** Whether any brand holds a finished shot, or a finished refinement, with a picture. */
+    hasFinishedNode(kind) {
+      return !!db.prepare("SELECT 1 FROM nodes WHERE kind=? AND status='done' AND images != '[]' LIMIT 1").get(kind);
+    },
+    /** Whether any brand has imported a product from a store. */
+    hasCatalogProduct() {
+      return !!db.prepare("SELECT 1 FROM catalog_products LIMIT 1").get();
+    },
+    /** A brand's shots of one kind made at or after a moment, newest first: what a guided task has made. */
+    nodesSince(brandId, kind, since, limit = 8) {
+      const rows = db.prepare(
+        `SELECT id, kind, status, images, created_at FROM nodes
+            WHERE project_id IN (SELECT id FROM projects WHERE brand_id = ?)
+              AND kind = ? AND created_at >= ?
+            ORDER BY created_at DESC, id DESC LIMIT ?`
+      ).all(brandId, kind, since, limit);
+      return rows.map((r) => ({
+        id: r.id,
+        kind: r.kind,
+        status: r.status,
+        images: (() => {
+          try {
+            const a = JSON.parse(r.images);
+            return Array.isArray(a) ? a.length : 0;
+          } catch {
+            return 0;
+          }
+        })(),
+        createdAt: r.created_at
+      }));
+    },
+    /** The newest presenter draft a brand started at or after a moment, never an edit session's. */
+    presenterDraftSince(brandId, since) {
+      const rows = db.prepare(
+        "SELECT id, json FROM presenter_drafts WHERE brand_id = ? AND created_at >= ? ORDER BY created_at DESC, id DESC"
+      ).all(brandId, since);
+      for (const r of rows) {
+        try {
+          if (!JSON.parse(r.json)?.presenterId) return r.id;
+        } catch {
+        }
+      }
+      return null;
+    },
     // settings
     getSetting(key) {
       const r = db.prepare("SELECT value FROM settings WHERE key=?").get(key);
@@ -2175,5 +2224,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-UUYMUOZQ.js.map
-//# sourceMappingURL=chunk-UUYMUOZQ.js.map
+//# sourceMappingURL=chunk-K6IELFL3.js.map
+//# sourceMappingURL=chunk-K6IELFL3.js.map

package/dist/{chunk-FYQ5BAFA.js → chunk-YK37H6DM.js}

@@ -1,5 +1,5 @@
 import { stagingDir, versionsDir, isValidVersionDir, pruneStaged, entryOf } from './chunk-4MAFHYAD.js';
-import { spawnSync, spawn } from 'child_process';
+import { spawn, execFile } from 'child_process';
 import { existsSync, rmSync, mkdirSync, readFileSync, renameSync } from 'fs';
 import { join, dirname } from 'path';
 
@@ -122,37 +122,46 @@ function createUpdateChecker(deps) {
     }
   };
 }
-function findNpm(opts = {}) {
+async function findNpm(opts = {}) {
   const env = opts.env ?? process.env;
   const platform = opts.platform ?? process.platform;
-  const canRun = opts.canRun ?? ((argv) => {
-    try {
-      return spawnSync(argv[0], [...argv.slice(1), "--version"], { stdio: "ignore", timeout: 1e4 }).status === 0;
-    } catch {
-      return false;
-    }
-  });
-  if (platform !== "win32" && canRun(["npm"])) return ["npm"];
+  const canRun = opts.canRun ?? answersVersion;
+  if (platform !== "win32" && await canRun(["npm"])) return ["npm"];
   const ep = env.npm_execpath?.replace(/npx-cli\.js$/, "npm-cli.js");
-  if (ep && /npm-cli\.js$/.test(ep) && canRun([process.execPath, ep])) return [process.execPath, ep];
+  if (ep && /npm-cli\.js$/.test(ep) && await canRun([process.execPath, ep])) return [process.execPath, ep];
   if (platform === "win32") {
-    const cli = windowsNpmCli();
-    if (cli && canRun([process.execPath, cli])) return [process.execPath, cli];
+    const cli = await windowsNpmCli();
+    if (cli && await canRun([process.execPath, cli])) return [process.execPath, cli];
   }
   return null;
 }
+function answersVersion(argv) {
+  return new Promise((resolve) => {
+    try {
+      const child = spawn(argv[0], [...argv.slice(1), "--version"], { stdio: "ignore", timeout: 1e4 });
+      child.on("error", () => resolve(false));
+      child.on("exit", (code) => resolve(code === 0));
+    } catch {
+      resolve(false);
+    }
+  });
+}
 function windowsNpmCli() {
-  try {
-    const out = spawnSync("where", ["npm"], { encoding: "utf8", timeout: 1e4 });
-    if (out.status !== 0 || !out.stdout) return null;
-    for (const line of out.stdout.split(/\r?\n/)) {
-      if (!/npm(\.cmd)?$/i.test(line.trim())) continue;
-      const cli = join(dirname(line.trim()), "node_modules", "npm", "bin", "npm-cli.js");
-      if (existsSync(cli)) return cli;
+  return new Promise((resolve) => {
+    try {
+      execFile("where", ["npm"], { encoding: "utf8", timeout: 1e4 }, (err, stdout) => {
+        if (err || !stdout) return resolve(null);
+        for (const line of stdout.split(/\r?\n/)) {
+          if (!/npm(\.cmd)?$/i.test(line.trim())) continue;
+          const cli = join(dirname(line.trim()), "node_modules", "npm", "bin", "npm-cli.js");
+          if (existsSync(cli)) return resolve(cli);
+        }
+        resolve(null);
+      });
+    } catch {
+      resolve(null);
     }
-  } catch {
-  }
-  return null;
+  });
 }
 function run(argv) {
   return new Promise((resolve) => {
@@ -181,7 +190,7 @@ async function runVerify(entry) {
 }
 async function stageVersion(deps) {
   const env = deps.env ?? process.env;
-  const npmArgv = deps.npmArgv !== void 0 ? deps.npmArgv : findNpm({ env });
+  const npmArgv = deps.npmArgv !== void 0 ? deps.npmArgv : await findNpm({ env });
   if (!npmArgv) {
     return { ok: false, reason: "no-npm", detail: "npm is not reachable from this process" };
   }
@@ -247,5 +256,5 @@ async function stageVersion(deps) {
 }
 
 export { classify, createUpdateChecker, fetchDistTagLatest, findNpm, isReleaseTriplet, stageVersion };
-//# sourceMappingURL=chunk-FYQ5BAFA.js.map
-//# sourceMappingURL=chunk-FYQ5BAFA.js.map
+//# sourceMappingURL=chunk-YK37H6DM.js.map
+//# sourceMappingURL=chunk-YK37H6DM.js.map

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

@@ -463,7 +463,7 @@ async function addOrRepair(ownEntry, say, over) {
 }
 async function rememberDecline(home) {
   try {
-    const { createCore } = await import('./src-QZZDZM7I.js');
+    const { createCore } = await import('./src-TC4UQ7H6.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-3KKS7BE4.js.map
-//# sourceMappingURL=cli-3KKS7BE4.js.map
+//# sourceMappingURL=cli-GMRPOISO.js.map
+//# sourceMappingURL=cli-GMRPOISO.js.map

package/dist/{cli-KSKENGIR.js → cli-VBJGIJI4.js}

@@ -1,4 +1,4 @@
-import { stageVersion, fetchDistTagLatest, findNpm } from './chunk-FYQ5BAFA.js';
+import { stageVersion, fetchDistTagLatest, findNpm } from './chunk-YK37H6DM.js';
 import { readMeta } from './chunk-Y3ZPBPLP.js';
 import { defaultHome, newestStaged, compareSemver } from './chunk-4MAFHYAD.js';
 
@@ -41,7 +41,7 @@ async function runUpdateCommand(opts) {
     console.log(`  ${latest} is available. Stage it with: scenri update`);
     return 0;
   }
-  if (!findNpm()) {
+  if (!await findNpm()) {
     console.error("  npm is not reachable from here, so nothing can be downloaded.");
     console.error("  Run the newest version directly with: npx scenri@latest");
     console.error("  (or install Node.js with npm and try again)");
@@ -63,5 +63,5 @@ async function runUpdateCommand(opts) {
 }
 
 export { runUpdateCommand };
-//# sourceMappingURL=cli-KSKENGIR.js.map
-//# sourceMappingURL=cli-KSKENGIR.js.map
+//# sourceMappingURL=cli-VBJGIJI4.js.map
+//# sourceMappingURL=cli-VBJGIJI4.js.map

package/dist/index.js

@@ -81,17 +81,17 @@ try {
       await (await import('./serve.js')).serve();
       break;
     case "update": {
-      const { runUpdateCommand } = await import('./cli-KSKENGIR.js');
+      const { runUpdateCommand } = await import('./cli-VBJGIJI4.js');
       process.exit(await runUpdateCommand(command));
       break;
     }
     case "desktop": {
-      const { runDesktopCommand } = await import('./cli-3KKS7BE4.js');
+      const { runDesktopCommand } = await import('./cli-GMRPOISO.js');
       process.exit(await runDesktopCommand(command, fileURLToPath(import.meta.url)));
       break;
     }
     case "open": {
-      const { runOpenCommand } = await import('./cli-3KKS7BE4.js');
+      const { runOpenCommand } = await import('./cli-GMRPOISO.js');
       process.exit(await runOpenCommand(fileURLToPath(import.meta.url)));
       break;
     }

package/dist/serve.js

@@ -1,6 +1,6 @@
-import { createUpdateChecker, classify, isReleaseTriplet, findNpm, stageVersion } from './chunk-FYQ5BAFA.js';
+import { createUpdateChecker, classify, findNpm, isReleaseTriplet, stageVersion } from './chunk-YK37H6DM.js';
 import { shouldAdoptRunning, anotherScenriLines, portBusyLines } from './chunk-CMLJGPYC.js';
-import { SchemaTooNewError, createCore, BUDGET_EXHAUSTED, SpendCapError, EDIT_REFERENCE_ROLE_DIRECTIVE, REFERENCE_ROLE_DIRECTIVE, ratioLabel, searchTerms, termMatches, budgetSize, SCHEMA_VERSION, ASPECT_TOLERANCE } from './chunk-UUYMUOZQ.js';
+import { SchemaTooNewError, createCore, BUDGET_EXHAUSTED, SpendCapError, EDIT_REFERENCE_ROLE_DIRECTIVE, REFERENCE_ROLE_DIRECTIVE, ratioLabel, searchTerms, termMatches, budgetSize, SCHEMA_VERSION, ASPECT_TOLERANCE } from './chunk-K6IELFL3.js';
 import { detectInstallKind } from './chunk-PAIAXRAC.js';
 export { detectInstallKind } from './chunk-PAIAXRAC.js';
 import { readMeta, repoSlug } from './chunk-Y3ZPBPLP.js';
@@ -1287,12 +1287,12 @@ function createCodexAnalyzer(opts = {}) {
   };
 }
 function buildPrompt(req, refCount, problems) {
-  const evidence = refCount === 0 ? "You have no reference images. Work from the description alone." : refCount === 1 ? "One reference image is attached." : `${refCount} reference images are attached.`;
+  const evidence2 = refCount === 0 ? "You have no reference images. Work from the description alone." : refCount === 1 ? "One reference image is attached." : `${refCount} reference images are attached.`;
   const body = req.kind === "presenter" ? presenterBody(req, refCount) : sceneBody(req);
   const revision = req.priorDraft ? ` You are revising an existing record, not starting over: keep everything that is not being corrected. Current record: ${JSON.stringify(req.priorDraft)}.` : "";
   const correction = req.correction ? ` The correction to apply: ${req.correction}.` : "";
   const retry = problems.length ? ` Your last answer was rejected: ${problems.join(" ")} Fix exactly that and write the file again.` : "";
-  return `${evidence}${revision}${correction} ${body} Write strict JSON, and nothing but JSON, to a file called ${OUT_FILE} in the current directory (you may run the commands needed to write it). Do not browse the web or explore files. No prose, no markdown fences, no commentary.${retry}`;
+  return `${evidence2}${revision}${correction} ${body} Write strict JSON, and nothing but JSON, to a file called ${OUT_FILE} in the current directory (you may run the commands needed to write it). Do not browse the web or explore files. No prose, no markdown fences, no commentary.${retry}`;
 }
 function presenterBody(req, refCount) {
   const same = refCount > 1 ? " Every attached photograph is the same person." : "";
@@ -3248,7 +3248,7 @@ function compileBrief(brief, ctx) {
     );
     if (names.length) {
       warnings.push(
-        `${names.join(" and ")} ${names.length === 1 ? "was" : "were"} left out \u2014 ${ctx.engineCaps.displayName} reads no reference images.`
+        `${names.join(" and ")} ${names.length === 1 ? "was" : "were"} left out: ${ctx.engineCaps.displayName} reads no reference images.`
       );
     }
   }
@@ -5207,18 +5207,18 @@ function mergeScrape(existing, scraped) {
 async function inspectMark(buf, toPng2) {
   const png = await toPng2(buf);
   const meta = await sharp21(png).metadata();
-  let blank = false;
+  let blank2 = false;
   try {
     const flat = await sharp21(png).flatten({ background: "#ffffff" }).toBuffer();
     const stats = await sharp21(flat).stats();
-    blank = stats.channels.slice(0, 3).every((c) => c.min > 200);
+    blank2 = stats.channels.slice(0, 3).every((c) => c.min > 200);
   } catch {
   }
   return {
     longEdge: Math.max(meta.width ?? 0, meta.height ?? 0) || null,
     width: meta.width ?? null,
     height: meta.height ?? null,
-    blank
+    blank: blank2
   };
 }
 
@@ -11287,7 +11287,7 @@ function defaultShowcaseDir() {
 
 // src/routes/showcase.ts
 function registerShowcaseRoutes(app, deps) {
-  const { templatesRoot } = deps;
+  const { templatesRoot, thumbs } = deps;
   const { showcase } = loadShowcase(join(templatesRoot, "showcase"));
   const showcaseHeroPath = (id) => contentFile(templatesRoot, "previews", "showcase", `${id}.jpg`);
   const decorateShowcase = (s) => ({
@@ -11301,7 +11301,8 @@ function registerShowcaseRoutes(app, deps) {
   app.get("/api/showcase-previews/:file", async (req, reply) => {
     const m = /^([a-z0-9-]+)\.jpg$/.exec(String(req.params.file));
     if (!m || !existsSync(showcaseHeroPath(m[1]))) return reply.status(404).send({ error: "no preview" });
-    return serveJpeg(req, reply, showcaseHeroPath(m[1]));
+    const path = showcaseHeroPath(m[1]);
+    return serveJpegSized(req, reply, path, thumbs, fileKey("showcase", m[1], path));
   });
 }
 
@@ -11703,6 +11704,39 @@ function registerImageRoutes(app, deps) {
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.11.0",
+    date: "2026-09-18",
+    title: "A new top bar, and a tutor that makes your first shot with you.",
+    sections: [
+      {
+        heading: "Top bar",
+        body: "The five places sit in the middle of the bar, with the one you are on underlined. New opens Create with the add panel open, and its arrow adds a product, presenter or scene instead. Activity replaces the bell: while a shot renders it shows that picture inside a filling ring, and its panel lists what is in progress and your notifications together, with Mark all read and Clear all. On a phone every panel in the bar opens as a sheet."
+      },
+      {
+        heading: "Brand",
+        body: "The brand menu is one short list, the brand you are in first and the rest A to Z, with a search once it grows long, so Settings and Shut down stay in reach. A brand's circle shows its icon, or its initial, never a shrunken wordmark."
+      },
+      {
+        heading: "Learn",
+        body: "A new install is welcomed and makes its first shot with a tutor, one step at a time: a product, a presenter, a scene, then the words. First steps on Home lists four lessons to start with and leaves once they are done, and Learn holds all five, from adding your product to refining a shot. Help sits in the corner of the page from 1024 pixels wide and in the bar below that, with Learn, the welcome, keyboard shortcuts and What's new."
+      },
+      {
+        heading: "Fixes",
+        body: "A product made from the picker goes into the brief by its name instead of as a missing product, and Enter on a focused control in Create presses that control rather than opening the selected shot."
+      }
+    ]
+  },
+  {
+    version: "0.10.3",
+    date: "2026-09-18",
+    sections: [
+      {
+        heading: "Fixes",
+        body: "Scenri no longer stops answering for a moment right after the studio opens, while it checks whether one-click updates can run here. On Windows that pause could last several seconds, long enough for a second click on the desktop icon to start Scenri again instead of opening the one already running."
+      }
+    ]
+  },
   {
     version: "0.10.2",
     date: "2026-09-17",
@@ -12530,14 +12564,22 @@ function registerUpdateRoutes(app, deps) {
     return applyState;
   };
   const REQUIRED_PROTOCOL = 1;
-  let npmProbe = null;
+  let npmFound = false;
+  let npmAsked = null;
+  const npmKnown = () => {
+    if (runtime.installKind === "dev" || !runtime.supervised || deps.stageImpl) return Promise.resolve();
+    npmAsked ??= findNpm().then((argv) => {
+      npmFound = argv !== null;
+    }).catch(() => {
+    });
+    return npmAsked;
+  };
   const blockReason = () => {
     if (runtime.installKind === "dev") return "dev";
     if (!runtime.supervised) return "unsupervised";
     if ((runtime.launcherProtocol ?? 1) < REQUIRED_PROTOCOL) return "launcher-too-old";
     if (deps.stageImpl) return null;
-    npmProbe ??= findNpm() !== null;
-    return npmProbe ? null : "no-npm";
+    return npmFound ? null : "no-npm";
   };
   const startStaging = (target) => {
     applyState = { phase: "staging", version: target, error: null };
@@ -12565,12 +12607,13 @@ function registerUpdateRoutes(app, deps) {
   };
   updates.onResult(maybeAutoStage);
   const bootLook = setTimeout(() => {
-    updates.check().then(maybeAutoStage).catch(() => {
+    npmKnown().then(() => updates.check()).then(maybeAutoStage).catch(() => {
     });
   }, deps.bootLookMs ?? 15e3);
   bootLook.unref();
   app.addHook("onClose", async () => clearTimeout(bootLook));
   const updateStatus = async (force = false) => {
+    await npmKnown();
     const r = await updates.check(force);
     const kind = r.latest ? classify(meta.version, r.latest) : null;
     const apply = effectiveApply();
@@ -12601,6 +12644,7 @@ function registerUpdateRoutes(app, deps) {
     if (busy > 0) {
       return reply.status(409).send({ error: `work is still running (${busy} task${busy === 1 ? "" : "s"})` });
     }
+    await npmKnown();
     const block = blockReason();
     if (block)
       return reply.status(409).send({ error: `one-click update cannot run here (${block})`, blockReason: block });
@@ -12745,6 +12789,165 @@ function registerSystemRoutes(app, deps) {
   });
 }
 
+// src/routes/guide.ts
+var TASKS = ["first-shot", "refine", "product", "presenter", "scene"];
+var MILESTONES = ["shot", "refine", "product", "presenter", "scene"];
+var KEY = "guide";
+var isTask = (t) => TASKS.includes(t);
+var isMilestone = (m) => MILESTONES.includes(m);
+var num2 = (n) => typeof n === "number" && Number.isFinite(n) && n >= 0 ? n : 0;
+function blank(eligible) {
+  return { v: 2, eligible, welcome: null, hidden: null, done: {}, dismissed: [], active: null };
+}
+function parse2(raw) {
+  if (!raw) return null;
+  try {
+    const j = JSON.parse(raw);
+    if (typeof j.eligible !== "boolean") return null;
+    if (j.v !== 2) return null;
+    const done = {};
+    if (j.done && typeof j.done === "object") {
+      for (const [k, at] of Object.entries(j.done)) if (isMilestone(k) && typeof at === "string") done[k] = at;
+    }
+    const a = j.active;
+    const b = a?.baseline;
+    const active = a && isTask(a.task) && typeof a.brandId === "string" && typeof a.since === "string" ? {
+      task: a.task,
+      brandId: a.brandId,
+      since: a.since,
+      baseline: { products: num2(b?.products), presenters: num2(b?.presenters), scenes: num2(b?.scenes) },
+      ...a.paused === true ? { paused: true } : {}
+    } : null;
+    return {
+      v: 2,
+      eligible: j.eligible,
+      welcome: j.welcome === "taken" || j.welcome === "declined" ? j.welcome : null,
+      hidden: typeof j.hidden === "boolean" ? j.hidden : null,
+      done,
+      dismissed: Array.isArray(j.dismissed) ? j.dismissed.filter(isTask) : [],
+      active
+    };
+  } catch {
+    return null;
+  }
+}
+function write(store, r) {
+  store.setSetting(KEY, JSON.stringify(r));
+}
+function stampGuide(store, version) {
+  if (store.getSetting(KEY) !== null) return;
+  const eligible = store.listBrands().length === 0;
+  if (eligible) {
+    if (!store.getSetting("install.firstVersion")) store.setSetting("install.firstVersion", version);
+    const seen = store.getSetting("whatsnew.seen");
+    if (!seen || compareSemver(seen, version) < 0) store.setSetting("whatsnew.seen", version);
+  }
+  write(store, blank(eligible));
+}
+function countsOf(core, brandId) {
+  const brand = core.store.getBrand(brandId);
+  if (!brand) return null;
+  const json = brand.json;
+  const characters = Array.isArray(json?.characters) ? json.characters : [];
+  return {
+    presenters: characters.filter((c) => c?.origin === "custom" && !c?.supersededBy).length,
+    scenes: Array.isArray(json?.scenes) ? json.scenes.length : 0,
+    products: core.catalog.listLibraryProducts(brandId, json).length
+  };
+}
+var ownPresenter = (b) => (b.json?.characters ?? []).some((c) => c?.origin === "custom" && !c?.supersededBy);
+function evidence(core, m) {
+  const { store } = core;
+  switch (m) {
+    case "shot":
+      return store.hasFinishedNode("generation");
+    case "refine":
+      return store.hasFinishedNode("edit");
+    case "presenter":
+      return store.listBrands().some(ownPresenter);
+    case "scene":
+      return store.listBrands().some((b) => (b.json?.scenes ?? []).length > 0);
+    case "product":
+      return store.hasCatalogProduct() || store.listBrands().some((b) => (b.json?.products ?? []).length > 0);
+  }
+}
+function load2(store) {
+  return parse2(store.getSetting(KEY)) ?? blank(false);
+}
+function readGuide(core, env) {
+  const r = load2(core.store);
+  let changed = false;
+  const at = (/* @__PURE__ */ new Date()).toISOString();
+  for (const m of MILESTONES) {
+    if (!r.done[m] && evidence(core, m)) {
+      r.done[m] = at;
+      changed = true;
+    }
+  }
+  if (r.active && !core.store.getBrand(r.active.brandId)) {
+    r.active = null;
+    changed = true;
+  }
+  if (changed) write(core.store, r);
+  const a = r.active;
+  const nodeKind = a?.task === "first-shot" ? "generation" : a?.task === "refine" ? "edit" : null;
+  const eligible = r.eligible && env.SCENRI_NO_GUIDE !== "1";
+  return {
+    eligible,
+    welcome: r.welcome,
+    hidden: r.hidden ?? !eligible,
+    done: r.done,
+    dismissed: r.dismissed,
+    active: a,
+    activeNodes: a && nodeKind ? core.store.nodesSince(a.brandId, nodeKind, a.since) : [],
+    activeDraftId: a?.task === "presenter" ? core.store.presenterDraftSince(a.brandId, a.since) : null,
+    counts: a ? countsOf(core, a.brandId) : null
+  };
+}
+function applyIntent(core, body) {
+  const b = body ?? {};
+  const r = load2(core.store);
+  if ("welcome" in b) {
+    if (b.welcome !== "taken" && b.welcome !== "declined") return "welcome is taken or declined";
+    r.welcome = b.welcome;
+  } else if ("start" in b) {
+    const s = b.start ?? {};
+    if (!isTask(s.task)) return "unknown task";
+    if (typeof s.brandId !== "string") return "brandId required";
+    const baseline = countsOf(core, s.brandId);
+    if (!baseline) return "brand not found";
+    const held = r.active;
+    if (held && held.paused && held.task === s.task && held.brandId === s.brandId) {
+      const { paused: _, ...going } = held;
+      r.active = going;
+    } else r.active = { task: s.task, brandId: s.brandId, since: core.store.now(), baseline };
+    r.dismissed = r.dismissed.filter((t) => t !== s.task);
+  } else if ("finish" in b) {
+    if (!isTask(b.finish)) return "unknown task";
+    if (r.active?.task === b.finish) r.active = null;
+  } else if ("dismiss" in b) {
+    if (!isTask(b.dismiss)) return "unknown task";
+    if (!r.dismissed.includes(b.dismiss)) r.dismissed.push(b.dismiss);
+    if (r.active?.task === b.dismiss) r.active = { ...r.active, paused: true };
+  } else if ("hidden" in b) {
+    if (typeof b.hidden !== "boolean") return "hidden is true or false";
+    r.hidden = b.hidden;
+  } else return "unknown intent";
+  write(core.store, r);
+  return null;
+}
+function registerGuideRoutes(app, deps) {
+  const { core } = deps;
+  const env = deps.env ?? process.env;
+  stampGuide(core.store, deps.version);
+  app.get("/api/guide", async () => readGuide(core, env));
+  app.post("/api/guide", async (req, reply) => {
+    const error = applyIntent(core, req.body);
+    if (error) return reply.status(400).send({ error });
+    return readGuide(core, env);
+  });
+}
+
 // src/routes/desktop.ts
 function registerDesktopRoutes(app, deps) {
   const { core, runtime } = deps;
@@ -12759,7 +12962,7 @@ function registerDesktopRoutes(app, deps) {
         record: null
       };
     }
-    const { installDeps } = await import('./cli-3KKS7BE4.js');
+    const { installDeps } = await import('./cli-GMRPOISO.js');
     const { desktopStatus } = await import('./install-VXJPLYWM.js');
     return desktopStatus(installDeps(runtime.entry));
   });
@@ -12767,7 +12970,7 @@ function registerDesktopRoutes(app, deps) {
     if (!runtime.entry) {
       return { ok: false, reason: "unsupported", message: "Desktop shortcuts are not available on this system yet." };
     }
-    const { addToDesktop } = await import('./cli-3KKS7BE4.js');
+    const { addToDesktop } = await import('./cli-GMRPOISO.js');
     return addToDesktop(runtime.entry);
   });
   app.get("/api/desktop", async () => {
@@ -13060,7 +13263,7 @@ function buildServer(opts) {
   const { demoProducts } = loadDemoProducts(join(templatesRoot, "demo-products"));
   const demoProductById = demoProductResolver(demoProducts);
   registerDemoProductRoutes(app, { templatesRoot, demoProducts, demoProductById, thumbs });
-  registerShowcaseRoutes(app, { templatesRoot });
+  registerShowcaseRoutes(app, { templatesRoot, thumbs });
   app.get("/api/formats", async () => FORMATS);
   function briefInputsOnly(brief) {
     const {
@@ -14240,6 +14443,7 @@ function buildServer(opts) {
     return drained;
   });
   registerSystemRoutes(app, { core, thumbs });
+  registerGuideRoutes(app, { core, version: meta.version });
   registerDesktopRoutes(app, {
     core,
     runtime,
@@ -14407,7 +14611,7 @@ async function run() {
     }
   }
   const ownEntry = fileURLToPath(import.meta.url);
-  const { addToDesktop, installDeps } = await import('./cli-3KKS7BE4.js');
+  const { addToDesktop, installDeps } = await import('./cli-GMRPOISO.js');
   const { refreshLauncher } = await import('./refresh-5HBDLLLB.js');
   const { askOnTerminal, offerDesktop, shouldOfferDesktop } = await import('./offer-W6NJXMWT.js');
   const { launcherInstalled } = await import('./paths-6ZXRZUHY.js');

package/dist/{src-QZZDZM7I.js → src-TC4UQ7H6.js}

@@ -1,3 +1,3 @@
-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 } from './chunk-UUYMUOZQ.js';
-//# sourceMappingURL=src-QZZDZM7I.js.map
-//# sourceMappingURL=src-QZZDZM7I.js.map
+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 } from './chunk-K6IELFL3.js';
+//# sourceMappingURL=src-TC4UQ7H6.js.map
+//# sourceMappingURL=src-TC4UQ7H6.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scenri",
-  "version": "0.10.2",
+  "version": "0.11.0",
   "author": "Tony Gorb <hello@scenri.co>",
   "license": "AGPL-3.0-only",
   "type": "module",