@vibes.diy/prompts 14.1.37 → 14.1.38

package/llms/backend.md

@@ -842,6 +842,87 @@ And **only say a thing you computed.** "Tonight", "this morning", "in an hour"
 are claims about the reader's clock; if the code did not derive them from that
 reader's zone, name the moment instead and let them place it.
 
+### Recurring reminders on somebody's clock
+
+**A recurring reminder fires on each person's own clock, never the server's.**
+Once a reminder repeats — "every weekday at 7" — the zone stops being one
+setting on one schedule document and becomes a property of each person the
+reminder is for. Everything below is per person, and none of it is the
+server's day or the server's hour.
+
+**Capture the zone as an effect, not as a question.** Do not ask them for a
+timezone: the browser already knows it, so write it once when they first sign
+in and leave it alone. Store it where the reminder is addressed — on the
+person's own profile document when the list is shared — and guard the write so
+it only ever happens on a real change, or the effect re-fires forever.
+
+**Derive the weekday and the hour together, in that zone, from one
+`formatToParts` call.** `getUTCDay()`/`getUTCHours()` answer a question about
+the machine the handler happens to be running on; at 07:00 in Los Angeles it is
+already a different day in UTC, so a weekday gate on the server's clock silently
+drops Monday mornings and fires on Saturday ones.
+
+**An unrecognised zone string throws.** `Intl.DateTimeFormat` raises a
+`RangeError` on a zone it does not know, so in a loop over people the formatting
+goes in a `try` and a bad profile is skipped — one stale record must not stop
+everybody else's reminder.
+
+The unit of work is that person's local date (`en-CA` formats it as
+`YYYY-MM-DD`), keyed per person, per "A tick that repeats is not a run that
+repeats" above: the interval is only how often the handler wakes up.
+
+App.jsx — write the zone once, when they arrive:
+
+```jsx
+useEffect(() => {
+  if (!me?.userHandle) return;
+  const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  if (!timeZone || myProfile?.timeZone === timeZone) return; // already stored — don't churn
+  database.put({ _id: `profile:${me.userHandle}`, type: "profile", userHandle: me.userHandle, timeZone });
+}, [me?.userHandle, myProfile?.timeZone]);
+```
+
+backend.js — evaluate each person in their own zone:
+
+```js
+export const config = { scheduled: { interval: "15m" } };
+const WEEKDAYS = new Set(["Mon", "Tue", "Wed", "Thu", "Fri"]);
+
+export async function scheduled(event, ctx) {
+  const at = new Date(event.scheduledTime);
+  const profiles = await ctx.db.query({ db: DB, field: "type", key: "profile", limit: 500 });
+  ctx.log("debug", "reminder tick", { profiles: profiles.length });
+
+  for (const profile of profiles) {
+    const { timeZone, userHandle } = profile;
+    if (!timeZone || !userHandle) continue;
+    let weekday, hour, dateKey;
+    try {
+      // One formatter, one zone: the weekday and the hour must agree about the day.
+      const parts = new Intl.DateTimeFormat("en-US", {
+        timeZone,
+        weekday: "short",
+        hour: "2-digit",
+        hourCycle: "h23",
+      }).formatToParts(at);
+      weekday = parts.find((p) => p.type === "weekday")?.value;
+      hour = Number(parts.find((p) => p.type === "hour")?.value);
+      dateKey = new Intl.DateTimeFormat("en-CA", { timeZone }).format(at); // "2026-09-18", their day
+    } catch {
+      continue; // unrecognised zone on one profile — skip the person, not the tick
+    }
+    if (!WEEKDAYS.has(weekday) || hour !== 7) continue;
+
+    const id = `morningReminder:${userHandle}:${dateKey}`; // the unit of work, per person
+    if (await ctx.db.get(id, { db: DB })) continue; // this morning is already done
+    await ctx.db.put(
+      { _id: id, type: "morningReminder", ownerHandle: userHandle, date: dateKey, checkedAt: at.toISOString() },
+      { db: DB }
+    );
+  }
+}
+```
+
 ### An unattended tick reports what it did
 
 **An unattended tick earns its spend.** Nobody is watching a scheduled run, so

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibes.diy/prompts",
-  "version": "14.1.37",
+  "version": "14.1.38",
   "type": "module",
   "main": "./index.js",
   "exports": {
@@ -34,9 +34,9 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@adviser/cement": "~0.5.34",
-    "@vibes.diy/call-ai-v2": "14.1.37",
-    "@vibes.diy/identity": "14.1.37",
-    "@vibes.diy/use-vibes-types": "14.1.37",
+    "@vibes.diy/call-ai-v2": "14.1.38",
+    "@vibes.diy/identity": "14.1.38",
+    "@vibes.diy/use-vibes-types": "14.1.38",
     "arktype": "~2.2.3",
     "json-schema-faker": "~0.6.3"
   },