scenri 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.13.0](https://github.com/tonygorb/Scenri/compare/v0.12.0...v0.13.0) (2026-09-21)
+
+
+### Features
+
+* **studio:** rebuild transient alerts as a quiet toast stack ([7b44141](https://github.com/tonygorb/Scenri/commit/7b44141b57cc6748942d97bc6acc27a022260207))
+* **studio:** turn first-use on, with a tutor that can go back ([df6b799](https://github.com/tonygorb/Scenri/commit/df6b799708d65cf31130233dabe2fd0ee1095a28))
+
+
+### Bug Fixes
+
+* **cli:** an install that has made a shot is not offered the first-use welcome ([4dae292](https://github.com/tonygorb/Scenri/commit/4dae292f3e833180448b2310a81573b641408bcc))
+* **create:** keep the feed still when a shot archives or the rail toggles ([b3276cd](https://github.com/tonygorb/Scenri/commit/b3276cd1f68315455e8b29d7dfdf13c768a0438a))
+* **studio:** a lesson on its first step has not begun, and Learn cannot take the app down ([cf0540b](https://github.com/tonygorb/Scenri/commit/cf0540b1ecd1e8fbdde2e3d203538f9e13f46d8c))
+* **studio:** a lesson owns its progress, and only the screen is shared ([8c58bdb](https://github.com/tonygorb/Scenri/commit/8c58bdbc06124d2f9fda0775a41f84fa156e10ea))
+* **studio:** a library lesson keeps its button in sight on narrow screens ([93869f4](https://github.com/tonygorb/Scenri/commit/93869f4f1f1fa8791c15ff893ef8ac536deda721))
+* **studio:** a step scrolled out of sight is not gone ([49ceccb](https://github.com/tonygorb/Scenri/commit/49ceccb8d7dc41daf8327ecefb8353f98ed94e70))
+* **studio:** alerts stand above a docked composer instead of over its buttons ([b6756c7](https://github.com/tonygorb/Scenri/commit/b6756c79c63419ca2ed146fc2e3c6d868eeb6f79))
+* **studio:** Learn gives the keyboard back to whichever control opened it ([e9c5945](https://github.com/tonygorb/Scenri/commit/e9c5945d60e6ceb55704da1130fe23a988c6044f))
+* **studio:** no empty alert on every page, and a held toast stays held ([3305f75](https://github.com/tonygorb/Scenri/commit/3305f7542fb38f604c9b4087c59aa7cfe0d4cf6b))
+* **studio:** refining teaches how to find a shot, instead of picking one for you ([228938f](https://github.com/tonygorb/Scenri/commit/228938f2440e17b48d9bab836e7c4aeeb0a74cef))
+
 ## [0.12.0](https://github.com/tonygorb/Scenri/compare/v0.11.1...v0.12.0) (2026-09-20)
 
 

package/dist/serve.js

@@ -11716,6 +11716,25 @@ function registerImageRoutes(app, deps) {
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.13.0",
+    date: "2026-09-21",
+    title: "Learn teaches Scenri one lesson at a time, alerts are quieter, and the Create feed holds still.",
+    sections: [
+      {
+        heading: "Learn",
+        body: "Learn sits in the top bar, or under Help on a smaller screen, and teaches Scenri in six short lessons: your first shot, adding a product, a presenter, a scene, using a product again, and refining a shot. Each lesson keeps its own place, so you can set one down, take up another and come back to it. A new install is offered a guided first shot, and the guide can step back when you change your mind."
+      },
+      {
+        heading: "Alerts",
+        body: "Alerts are smaller and stack at the bottom of the screen, above the composer rather than over it. The same event twice shares one card, an error stays until you close it, and an alert holds still while you point at it or tab into it."
+      },
+      {
+        heading: "Create",
+        body: "Archiving a shot no longer makes the pictures around it blink, and opening or closing the side panel rearranges the feed in one step."
+      }
+    ]
+  },
   {
     version: "0.12.0",
     date: "2026-09-20",
@@ -12835,14 +12854,24 @@ function registerSystemRoutes(app, deps) {
 }
 
 // src/routes/guide.ts
-var TASKS = ["first-shot", "refine", "product", "presenter", "scene"];
+var TASKS = ["first-shot", "refine", "product", "presenter", "scene", "reuse"];
 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 };
+  return {
+    v: 2,
+    eligible,
+    welcome: null,
+    hidden: null,
+    done: {},
+    lessons: {},
+    dismissed: [],
+    active: null,
+    progress: {}
+  };
 }
 function parse2(raw) {
   if (!raw) return null;
@@ -12854,9 +12883,47 @@ function parse2(raw) {
     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 lessons = {};
+    if (j.lessons && typeof j.lessons === "object") {
+      for (const [k, at] of Object.entries(j.lessons)) if (isTask(k) && typeof at === "string") lessons[k] = at;
+    }
+    const asTask = (a2) => {
+      const b2 = a2?.baseline;
+      return a2 && isTask(a2.task) && typeof a2.brandId === "string" && typeof a2.since === "string" ? {
+        task: a2.task,
+        brandId: a2.brandId,
+        since: a2.since,
+        baseline: { products: num2(b2?.products), presenters: num2(b2?.presenters), scenes: num2(b2?.scenes) },
+        ...a2.paused === true ? { paused: true } : {}
+      } : null;
+    };
+    const asProgress = (v) => {
+      const p = v;
+      const b2 = p?.baseline;
+      return p && typeof p.brandId === "string" && typeof p.since === "string" ? {
+        brandId: p.brandId,
+        since: p.since,
+        baseline: { products: num2(b2?.products), presenters: num2(b2?.presenters), scenes: num2(b2?.scenes) },
+        reached: Array.isArray(p.reached) ? p.reached.filter((m) => typeof m === "string") : [],
+        ...p.paused === true ? { paused: true } : {}
+      } : null;
+    };
+    const progress = {};
+    if (j.progress && typeof j.progress === "object") {
+      for (const [k, v] of Object.entries(j.progress)) {
+        const p = asProgress(v);
+        if (isTask(k) && p) progress[k] = p;
+      }
+    }
+    if (j.parked && typeof j.parked === "object") {
+      for (const [k, v] of Object.entries(j.parked)) {
+        const t = asTask(v);
+        if (isTask(k) && t && !progress[k]) progress[k] = { ...t, reached: [], paused: true };
+      }
+    }
     const a = j.active;
     const b = a?.baseline;
-    const active = a && isTask(a.task) && typeof a.brandId === "string" && typeof a.since === "string" ? {
+    const held = a && isTask(a.task) && typeof a.brandId === "string" && typeof a.since === "string" ? {
       task: a.task,
       brandId: a.brandId,
       since: a.since,
@@ -12869,8 +12936,11 @@ function parse2(raw) {
       welcome: j.welcome === "taken" || j.welcome === "declined" ? j.welcome : null,
       hidden: typeof j.hidden === "boolean" ? j.hidden : null,
       done,
+      lessons,
       dismissed: Array.isArray(j.dismissed) ? j.dismissed.filter(isTask) : [],
-      active
+      // an old record's one task in hand is that lesson's progress now
+      active: typeof j.active === "string" && isTask(j.active) ? j.active : held?.task ?? null,
+      progress: held && !progress[held.task] ? { ...progress, [held.task]: { ...held, reached: [] } } : progress
     };
   } catch {
     return null;
@@ -12929,21 +12999,33 @@ function readGuide(core, env) {
       changed = true;
     }
   }
-  if (r.active && !core.store.getBrand(r.active.brandId)) {
-    r.active = null;
+  for (const [t, p] of Object.entries(r.progress)) {
+    if (core.store.getBrand(p.brandId)) continue;
+    delete r.progress[t];
+    if (r.active === t) 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";
+  const on = r.active ? r.progress[r.active] : null;
+  const a = r.active && on ? {
+    task: r.active,
+    brandId: on.brandId,
+    since: on.since,
+    baseline: on.baseline,
+    ...on.paused ? { paused: true } : {}
+  } : null;
+  const nodeKind = a?.task === "first-shot" || a?.task === "reuse" ? "generation" : a?.task === "refine" ? "edit" : null;
+  const settled = r.welcome === null && !!r.done.shot;
+  const eligible = r.eligible && !settled && env.SCENRI_NO_GUIDE !== "1";
   return {
     eligible,
     welcome: r.welcome,
     hidden: r.hidden ?? !eligible,
     done: r.done,
+    lessons: r.lessons,
     dismissed: r.dismissed,
     active: a,
+    progress: r.progress,
     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
@@ -12961,19 +13043,34 @@ function applyIntent(core, body) {
     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 };
+    const guiding = r.active ? r.progress[r.active] : null;
+    if (r.active && r.active !== s.task && guiding) r.progress[r.active] = { ...guiding, paused: true };
+    const mine = r.progress[s.task];
+    if (mine && mine.brandId === s.brandId) {
+      const { paused: _, ...going } = mine;
+      r.progress[s.task] = going;
+    } else r.progress[s.task] = { brandId: s.brandId, since: core.store.now(), baseline, reached: [] };
+    r.active = s.task;
     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;
+    if (!r.lessons[b.finish]) r.lessons[b.finish] = (/* @__PURE__ */ new Date()).toISOString();
+    if (r.active === b.finish) r.active = null;
+    delete r.progress[b.finish];
   } 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 };
+    const shut = r.progress[b.dismiss];
+    if (shut) r.progress[b.dismiss] = { ...shut, paused: true };
+    if (r.active === b.dismiss) r.active = null;
+  } else if ("reached" in b) {
+    const w = b.reached ?? {};
+    if (!isTask(w.task)) return "unknown task";
+    if (typeof w.moment !== "string" || !w.moment) return "moment required";
+    const p = r.progress[w.task];
+    if (!p) return null;
+    if (p.reached.includes(w.moment)) return null;
+    r.progress[w.task] = { ...p, reached: [...p.reached, w.moment].slice(-24) };
   } else if ("hidden" in b) {
     if (typeof b.hidden !== "boolean") return "hidden is true or false";
     r.hidden = b.hidden;

package/package.json

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