waterplane 0.0.1 → 0.1.6

package/node_modules/@waterplane/shared/dist/schedule/schedclean.js

@@ -0,0 +1,180 @@
+// Cut from schedule.ts (move only): cleaning a rule or action off disk
+// The one door stays `./schedule.js`; this slice imports its siblings directly, never the barrel.
+import { cleanSessionBudget } from "../sessionbudget.js";
+import { cleanLaunchOpts } from "../launch.js";
+import { INTENT_MAX_STEPS } from "./schedaction.js";
+import { zoneOffsetMs } from "./schedzone.js";
+const clampInt = (v, lo, hi, dflt) => {
+    const n = Math.round(Number(v));
+    return Number.isFinite(n) ? Math.min(hi, Math.max(lo, n)) : dflt;
+};
+/**
+ * A run window, or nothing.
+ *
+ * Neither end is CLAMPED and nothing here is interpreted: a value that is not
+ * already a minute of day is refused, and so is a pair that does not name two
+ * DIFFERENT minutes. `from === to` has two readings — "every minute" and "no
+ * minute" — and a sanitiser that picks one silently turns a typo into a
+ * schedule that never fires again.
+ *
+ * Clamping had the same shape one step further out: `{from: 5000, to: 100}`
+ * became `{from: 1439, to: 100}`, a 23:59–01:40 night window nobody typed, on a
+ * rule that then quietly never ran in the daytime. The phone's `<input
+ * type=time>` cannot produce a value outside 0..1439, so anything outside is a
+ * corrupt file or a hostile draft, and the honest answer to both is the same as
+ * for `from === to`: drop it. Absent is the old behaviour — any hour — which is
+ * the one thing a dropped field is always safe to be here.
+ */
+function cleanHours(v) {
+    if (!v || typeof v !== "object")
+        return undefined;
+    const minute = (x) => {
+        const n = Math.round(Number(x));
+        return Number.isFinite(n) && n >= 0 && n <= 1439 ? n : -1;
+    };
+    const from = minute(v.from);
+    const to = minute(v.to);
+    if (from < 0 || to < 0 || from === to)
+        return undefined;
+    return { from, to };
+}
+/** Sanitize a rule from the wire or a hand-edited file. Never throws. */
+export function cleanRule(v) {
+    const raw = v && typeof v === "object" ? v : {};
+    // A lead time longer than a week would silently re-order occurrences; a day
+    // either side covers every real "before the reset" case.
+    const offsetMin = clampInt(raw.offsetMin ?? 0, -1440, 1440, 0);
+    // Quiet hours are a policy over the anchor, so they survive every kind —
+    // "at 03:00 but not while I am asleep" and "the moment the weekly window is
+    // back, but not at 04:00" are the same instruction about two anchors.
+    const hours = cleanHours(raw.hours);
+    // An unresolvable zone would make every occurrence fall back to host-local
+    // silently — drop it to undefined instead, which the UI shows as "host time".
+    const tz = typeof raw.tz === "string" && raw.tz.trim() && zoneOffsetMs(raw.tz.trim(), Date.now()) != null
+        ? raw.tz.trim() : undefined;
+    // **`hours` carries its zone on EVERY kind, not just `weekly`.** `hours` is
+    // documented as minutes of day IN `tz`, and `inHours`/`hoursOpenFrom` read
+    // `rule.tz || null` — so a `window` or `once` rule that lost its zone here is
+    // evaluated against `getHours()`, the DAEMON's clock. The same rule
+    // {window, 07:00–22:00} was open at 05:30Z under `TZ=Asia/Tokyo` and shut
+    // under `TZ=UTC`: launchd sets no `TZ` so a Mac in the user's own zone
+    // happened to be right, and a `TZ` in the plist, a Linux host or a person
+    // travelling shifted the whole window by the offset in silence. This is the
+    // drift the weekly zone has always been stored to prevent; quiet hours are a
+    // policy over every anchor (see `hours` above), so they carry the same fact.
+    //
+    // Tied to `hours` rather than kept unconditionally: a `window` rule's anchor
+    // is a reset instant and a `once` rule's is absolute, so on those two kinds a
+    // zone with no window to read means nothing, and storing one would invite the
+    // next reader to think it moved the anchor.
+    const only = hours ? (tz ? { hours, tz } : { hours }) : {};
+    if (raw.kind === "window") {
+        const edge = raw.edge === "after" ? "after" : "before";
+        // A percentage is a COUNT-shaped field and is clamped like one. `null` (no
+        // condition) and 0 (a condition that always passes) are different things
+        // and both are kept — writing 0 is how somebody says "any headroom at all".
+        const pct = raw.minPctLeft;
+        const minPctLeft = pct == null || pct === "" ? undefined : clampInt(pct, 0, 100, 0);
+        const window = raw.window === "weekly" ? "weekly" : "session";
+        // A guard naming the window the rule is already anchored to is not a guard,
+        // and keeping it would leave two fields saying one thing — the next reader
+        // has to work out that they agree before they can read either. Only the
+        // other window survives.
+        const guard = (raw.guardWindow === "weekly" || raw.guardWindow === "session") && raw.guardWindow !== window ? raw.guardWindow : undefined;
+        // The condition survives an `after` edge ONLY behind a guard. Without one
+        // it would be a question about a window that has just emptied — the reading
+        // that can only ever mean "never run", which is why it has always been
+        // dropped here rather than stored and quietly ignored at fire time.
+        const keepPct = minPctLeft != null && (edge === "before" || guard != null);
+        return {
+            kind: "window",
+            window,
+            ...(typeof raw.periodId === "string" && raw.periodId && raw.periodId !== "session" && raw.periodId !== "weekly" ? { periodId: raw.periodId } : {}),
+            edge,
+            // `before` must be a LEAD: a positive offset there would place the run
+            // after the reset it claims to precede, which is the one reading of this
+            // rule nobody could act on.
+            offsetMin: edge === "before" ? Math.min(0, offsetMin) : Math.max(0, offsetMin),
+            ...(keepPct ? { minPctLeft } : {}),
+            ...(guard ? { guardWindow: guard } : {}),
+            ...(raw.oneShot === true ? { oneShot: true } : {}),
+            ...only,
+        };
+    }
+    if (raw.kind === "once") {
+        const at = Number(raw.at);
+        return { kind: "once", at: Number.isFinite(at) ? at : 0, offsetMin, ...only };
+    }
+    const rawDays = Array.isArray(raw.days) ? raw.days.map((d) => clampInt(d, 0, 6, 0)) : [];
+    const days = [...new Set(rawDays)].sort((a, b) => a - b);
+    return {
+        kind: "weekly",
+        days,
+        hour: clampInt(raw.hour ?? 9, 0, 23, 9),
+        minute: clampInt(raw.minute ?? 0, 0, 59, 0),
+        tz,
+        offsetMin,
+        ...(raw.oneShot === true ? { oneShot: true } : {}),
+        ...only,
+    };
+}
+/** Sanitize an action. Returns null when it names nothing runnable. */
+export function cleanAction(v) {
+    const raw = v && typeof v === "object" ? v : {};
+    const text = typeof raw.text === "string" ? raw.text.trim() : "";
+    if (!text)
+        return null;
+    if (raw.kind === "backlog") {
+        const repoDir = typeof raw.repoDir === "string" ? raw.repoDir : "";
+        if (!repoDir)
+            return null;
+        // The chain, bounded on the COUNT and never on the words — the same
+        // constant `cleanIntentPayload` applies downstream, declared above because
+        // `intent.ts` imports THIS file. A chain of exactly the head is not a
+        // chain: `[text]` is stored as absent, so a rule written before this field
+        // and one written after it read back identically and `intentToSchedule` has
+        // nothing to invent.
+        const rawSteps = Array.isArray(raw.steps)
+            ? raw.steps.filter((s) => typeof s === "string" && !!s.trim()).slice(0, INTENT_MAX_STEPS)
+            : [];
+        const steps = rawSteps.length > 1 ? rawSteps : undefined;
+        // `steps[0]` REPEATS `text` by contract, and until now nothing enforced it:
+        // `scheduleToIntent` trusts `steps`, `intentToSchedule` re-derives
+        // `text = steps[0]`, so a rule stored with the two disagreeing came back
+        // from one round trip with a `text` nobody wrote. The head is the copy that
+        // survives — it is what actually RUNS as turn one — and the rule's own
+        // `text` follows it rather than the sheet's label quietly rewriting turn
+        // one. Nothing is clipped: this picks which of two existing strings is the
+        // head, it never edits either.
+        const head = steps ? steps[0] : text;
+        return {
+            kind: "backlog", repoDir, text: head,
+            label: typeof raw.label === "string" && raw.label.trim() ? raw.label.trim().slice(0, 80) : undefined,
+            // Default ON: a scheduled item that waits for a human tap is not a schedule.
+            autoFire: raw.autoFire !== false,
+            ...(steps ? { steps } : {}),
+            ...(typeof raw.closeWhenDone === "boolean" ? { closeWhenDone: raw.closeWhenDone } : {}),
+            ...(raw.flagWhenDone === true ? { flagWhenDone: true } : {}),
+            ...actionBudget(raw.budget),
+            ...(cleanLaunchOpts(raw.launch) ? { launch: cleanLaunchOpts(raw.launch) } : {}),
+        };
+    }
+    const rawDirs = Array.isArray(raw.dirs) ? raw.dirs.filter((d) => typeof d === "string" && d) : [];
+    const dirs = [...new Set(rawDirs)].slice(0, 60);
+    if (!dirs.length)
+        return null;
+    return { kind: "fanout", dirs, text, launch: cleanLaunchOpts(raw.launch), ...actionBudget(raw.budget) };
+}
+/**
+ * An action's budget, three ways: a valid cap, an explicit `null` (the person
+ * CLEARED it — `upsert()` drops the stored cap), or absent (nobody said — the
+ * stored cap is kept). Anything else that is not a valid cap is absent, never
+ * a clear: a malformed field must not delete a cap somebody set.
+ */
+function actionBudget(raw) {
+    if (raw === null)
+        return { budget: null };
+    const b = cleanSessionBudget(raw);
+    return b ? { budget: b } : {};
+}
+//# sourceMappingURL=schedclean.js.map

package/node_modules/@waterplane/shared/dist/schedule/schedclean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedclean.js","sourceRoot":"","sources":["../../src/schedule/schedclean.ts"],"names":[],"mappings":"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"}

package/node_modules/@waterplane/shared/dist/schedule/schedfire.d.ts

@@ -0,0 +1,76 @@
+import { type ScheduleRule, type WindowResets } from "./schedrule.js";
+/**
+ * The next instant this rule fires, strictly after `after`. Null when it never
+ * will again (a `once` whose time has passed).
+ *
+ * The weekly search walks CANDIDATE ANCHOR DAYS, not fire days: with a negative
+ * offset the fire lands on the previous evening (or the previous day entirely,
+ * for a big lead time), so the window starts two days back — otherwise
+ * "Monday 01:00 minus 3h" would skip the Sunday-evening fire that is due
+ * tonight. Every candidate is resolved through the zone afresh, which is what
+ * keeps a DST weekend from moving the sweep an hour.
+ */
+export declare function nextFireAt(rule: ScheduleRule, after: number, resets?: WindowResets): number | null;
+/**
+ * A ONE-OFF whose instant is behind us — spent, as opposed to switched off.
+ *
+ * The two are one field on the wire: `intentToSchedule` derives `enabled` from
+ * `nextAt !== null` because an intent has no second flag, so `enabled === false`
+ * covers both "somebody disarmed this" and "this was a `once` and its moment has
+ * passed". Only the first can be undone, and every screen that offered *switch
+ * it on* for the second offered a tap that cannot do anything: re-arming asks
+ * `nextFireAt` again, which answers null again, and nothing changes — a button
+ * that reports success and moves nothing.
+ *
+ * The CLOCK decides, not the result: a one-off that never fired (the host was
+ * asleep past its grace) is exactly as unre-armable as one that ran.
+ *
+ * A `weekly`- or `window`-anchored one-shot cannot be asked the same way a
+ * `once` is: `nextFireAt` does not know about `oneShot` at all (it is a
+ * recurrence question and arming is an anchor question), so it always finds a
+ * future weekly slot and a `window` rule is never "past its instant" — there
+ * is no clock to be behind. The only honest evidence such a rule is OVER is
+ * that it already fired (`lastOccurrence`); short of that it is either armed
+ * (`nextAt` set) or waiting to be (a `window` rule with no reading yet), and
+ * either way it is not spent.
+ */
+export declare function isSpentOnce(e: {
+    rule: ScheduleRule;
+    nextAt?: number | null;
+    lastOccurrence?: number;
+    enabled?: boolean;
+}, now: number): boolean;
+/**
+ * **Is this row still a SCHEDULE, or is it history?**
+ *
+ * A schedule list is a list of things that are going to happen. A one-off whose
+ * instant has passed is not one of them and never will be again: it is an
+ * account of a prompt that ran (or did not), which is exactly what Activity
+ * holds, one row for its whole life. Ten of them sitting in Schedules under a
+ * chip reading "10 not armed" said the opposite of what had happened — nothing
+ * was waiting to be armed, everything had already been spent — and the only
+ * verb the sheet could offer on them was *post it again*.
+ *
+ * So this is the cut, and it feeds BOTH the launcher's count and the sheet's
+ * list, for the reason every other count here does: a number is a promise that
+ * a list somewhere holds exactly those rows.
+ *
+ * A row with no `rule` (the horizon's callers may carry only an instant) is
+ * never spent — the absence of a rule is not evidence that it is over.
+ */
+export declare function isStandingSchedule(e: {
+    rule?: ScheduleRule;
+    nextAt?: number | null;
+    lastOccurrence?: number;
+    enabled?: boolean;
+}, now: number): boolean;
+/**
+ * What every surface says about a spent one-off, in ONE place.
+ *
+ * The schedule sheet and Activity each wrote their own, and they disagreed on
+ * the one thing that matters: whether *now* still works. It does — the host
+ * revives the row in place and fires it (`IntentManager.runNow`), and a
+ * schedule missed while the desktop slept is precisely the one you want to fire
+ * by hand. Activity refused it with a sentence saying so.
+ */
+export declare const SPENT_ONCE_TEXT = "that instant has passed and a one-off cannot be re-armed \u2014 run it now, edit it, or post it again";

package/node_modules/@waterplane/shared/dist/schedule/schedfire.js

@@ -0,0 +1,122 @@
+// Cut from schedule.ts (move only): the next fire instant
+// The one door stays `./schedule.js`; this slice imports its siblings directly, never the barrel.
+import { ruleRecurs, windowResetAt } from "./schedrule.js";
+import { wallClockToEpoch, zoneDate } from "./schedzone.js";
+/**
+ * The next instant this rule fires, strictly after `after`. Null when it never
+ * will again (a `once` whose time has passed).
+ *
+ * The weekly search walks CANDIDATE ANCHOR DAYS, not fire days: with a negative
+ * offset the fire lands on the previous evening (or the previous day entirely,
+ * for a big lead time), so the window starts two days back — otherwise
+ * "Monday 01:00 minus 3h" would skip the Sunday-evening fire that is due
+ * tonight. Every candidate is resolved through the zone afresh, which is what
+ * keeps a DST weekend from moving the sweep an hour.
+ */
+export function nextFireAt(rule, after, resets) {
+    const offsetMs = (rule.offsetMin ?? 0) * 60_000;
+    if (rule.kind === "window") {
+        // The anchor is a fact the host reads off the CLI, not a clock this module
+        // can compute. Unknown ⇒ NOT ARMED (`null`), which the tick re-asks on
+        // every pass — so a rule stays visibly un-armed until the first usage
+        // scrape lands, rather than being placed at a guessed instant that then
+        // moves under it.
+        const reset = windowResetAt(rule, resets);
+        if (reset == null)
+            return null;
+        // `after` fires AT the reset; `before` fires `offsetMin` (negative) ahead
+        // of it. Both add the offset, which is why one field covers both edges.
+        const at = reset + (rule.edge === "after" ? Math.max(0, offsetMs) : offsetMs);
+        return at > after ? at : null;
+    }
+    if (rule.kind === "once") {
+        const at = (rule.at ?? 0) + offsetMs;
+        return at > after ? at : null;
+    }
+    const hour = rule.hour ?? 0;
+    const minute = rule.minute ?? 0;
+    const tz = rule.tz || null;
+    const days = rule.days?.length ? rule.days : null;
+    const today = zoneDate(tz, after);
+    for (let k = -2; k <= 9; k++) {
+        // Date.UTC normalises the day roll (month/year ends) for us.
+        const dow = new Date(Date.UTC(today.y, today.mo, today.d + k)).getUTCDay();
+        if (days && !days.includes(dow))
+            continue;
+        const fire = wallClockToEpoch(today.y, today.mo, today.d + k, hour, minute, tz) + offsetMs;
+        if (fire > after)
+            return fire;
+    }
+    return null;
+}
+/**
+ * A ONE-OFF whose instant is behind us — spent, as opposed to switched off.
+ *
+ * The two are one field on the wire: `intentToSchedule` derives `enabled` from
+ * `nextAt !== null` because an intent has no second flag, so `enabled === false`
+ * covers both "somebody disarmed this" and "this was a `once` and its moment has
+ * passed". Only the first can be undone, and every screen that offered *switch
+ * it on* for the second offered a tap that cannot do anything: re-arming asks
+ * `nextFireAt` again, which answers null again, and nothing changes — a button
+ * that reports success and moves nothing.
+ *
+ * The CLOCK decides, not the result: a one-off that never fired (the host was
+ * asleep past its grace) is exactly as unre-armable as one that ran.
+ *
+ * A `weekly`- or `window`-anchored one-shot cannot be asked the same way a
+ * `once` is: `nextFireAt` does not know about `oneShot` at all (it is a
+ * recurrence question and arming is an anchor question), so it always finds a
+ * future weekly slot and a `window` rule is never "past its instant" — there
+ * is no clock to be behind. The only honest evidence such a rule is OVER is
+ * that it already fired (`lastOccurrence`); short of that it is either armed
+ * (`nextAt` set) or waiting to be (a `window` rule with no reading yet), and
+ * either way it is not spent.
+ */
+export function isSpentOnce(e, now) {
+    if (ruleRecurs(e.rule))
+        return false;
+    if (e.nextAt != null)
+        return false;
+    if (e.rule.kind === "once")
+        return nextFireAt(e.rule, now) === null;
+    // A one-shot SKIPPED on its condition is kept for the next reset with its
+    // next instant not read yet: `nextAt` UNDEFINED on an intent, and on a
+    // `ScheduleEntry` (whose wire field collapses that to null) still `enabled`,
+    // which the host derives from `nextAt !== null`. Only an explicit null — the
+    // host retiring the row — is spent.
+    if (e.nextAt === undefined || e.enabled === true)
+        return false;
+    return e.lastOccurrence != null;
+}
+/**
+ * **Is this row still a SCHEDULE, or is it history?**
+ *
+ * A schedule list is a list of things that are going to happen. A one-off whose
+ * instant has passed is not one of them and never will be again: it is an
+ * account of a prompt that ran (or did not), which is exactly what Activity
+ * holds, one row for its whole life. Ten of them sitting in Schedules under a
+ * chip reading "10 not armed" said the opposite of what had happened — nothing
+ * was waiting to be armed, everything had already been spent — and the only
+ * verb the sheet could offer on them was *post it again*.
+ *
+ * So this is the cut, and it feeds BOTH the launcher's count and the sheet's
+ * list, for the reason every other count here does: a number is a promise that
+ * a list somewhere holds exactly those rows.
+ *
+ * A row with no `rule` (the horizon's callers may carry only an instant) is
+ * never spent — the absence of a rule is not evidence that it is over.
+ */
+export function isStandingSchedule(e, now) {
+    return !e.rule || !isSpentOnce({ rule: e.rule, nextAt: e.nextAt, lastOccurrence: e.lastOccurrence, enabled: e.enabled }, now);
+}
+/**
+ * What every surface says about a spent one-off, in ONE place.
+ *
+ * The schedule sheet and Activity each wrote their own, and they disagreed on
+ * the one thing that matters: whether *now* still works. It does — the host
+ * revives the row in place and fires it (`IntentManager.runNow`), and a
+ * schedule missed while the desktop slept is precisely the one you want to fire
+ * by hand. Activity refused it with a sentence saying so.
+ */
+export const SPENT_ONCE_TEXT = "that instant has passed and a one-off cannot be re-armed — run it now, edit it, or post it again";
+//# sourceMappingURL=schedfire.js.map

package/node_modules/@waterplane/shared/dist/schedule/schedfire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedfire.js","sourceRoot":"","sources":["../../src/schedule/schedfire.ts"],"names":[],"mappings":"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"}

package/node_modules/@waterplane/shared/dist/schedule/schedhorizon.d.ts

@@ -0,0 +1,78 @@
+import type { ScheduleRule } from "./schedrule.js";
+/**
+ * **What is armed, bucketed by how far out it is.**
+ *
+ * A count on its own does not answer the question people actually ask of a
+ * schedule list. "7 scheduled" is the same badge whether all seven fire tonight
+ * or the next one is a fortnight away, and those are opposite situations: one
+ * is something to look at before bed, the other is furniture.
+ *
+ * The buckets are DISJOINT and the wording says so (`more`), because the
+ * alternative — cumulative counts — reads as a total that keeps growing and
+ * makes "2 in 24h and 5 in 2d" mean 5 to one person and 7 to the next.
+ *
+ * `unarmed` is kept apart from every horizon rather than folded into "later":
+ * a rule with nothing armed is not far away, it is not coming at all, and the
+ * two reasons for it (switched off, or a `window` rule still waiting for its
+ * first usage reading) are both things a person can act on.
+ *
+ * **A spent one-off is not one of those reasons and is not counted here at
+ * all** (`isStandingSchedule`). It cannot be armed, so filing it under "not
+ * armed" described a state nobody could leave — and being counted into `total`
+ * it made the badge say "10 armed rules" about a desktop holding none.
+ */
+export interface ScheduleHorizon {
+    /** Inside the hour — the only bucket worth interrupting anybody for. */
+    soon: number;
+    /** 1h … 24h. */
+    day: number;
+    /** 24h … 48h. */
+    twoDay: number;
+    /** 48h … 7d. */
+    week: number;
+    /** Beyond a week. */
+    later: number;
+    /** Armed at nothing: switched off, or waiting for a reading. */
+    unarmed: number;
+    /** Everything above, including `unarmed`. */
+    total: number;
+}
+/** Which bucket an instant falls in. `unarmed` is the absence of one. */
+export type HorizonBucket = keyof Omit<ScheduleHorizon, "total">;
+/**
+ * The bucket names, as the chip says them — the ONE spelling.
+ *
+ * A count on screen is a promise that a list somewhere holds exactly those
+ * rows, so the words on the chip and the words on the filtered list's own bar
+ * come from here, and the boundaries that produced the count are
+ * `horizonBucket` and nothing else. Two copies of `<= 24h` is how "2 within
+ * the hour" opens a list of three.
+ */
+export declare const HORIZON_LABEL: Record<HorizonBucket, string>;
+/** The bucket one armed instant falls in. The only place the edges live. */
+export declare function horizonBucket(at: number | null | undefined, now: number): HorizonBucket;
+/**
+ * Bucket a set of armed instants. Rows are anything carrying a `nextAt`, and a
+ * row that also carries its `rule` is put through `isStandingSchedule` first:
+ * a one-off that has been and gone is history, and this counts what is coming.
+ */
+export declare function scheduleHorizon(rows: readonly {
+    nextAt?: number | null;
+    rule?: ScheduleRule;
+}[], now: number): ScheduleHorizon;
+/**
+ * The bucket the chip's LEADING number counts — what tapping it filters to.
+ *
+ * `null` when the chip says nothing, so a tap that would open an empty list
+ * cannot happen.
+ */
+export declare function horizonLead(h: ScheduleHorizon): HorizonBucket | null;
+/**
+ * The horizon as one line. `null` when there is nothing armed at all — a badge
+ * that says "0 scheduled" is a badge that trains people not to read badges.
+ *
+ * At most the two nearest non-empty buckets, because this is read at a glance
+ * on a phone and the third number is never the one that changes a decision.
+ * The full breakdown belongs in the sheet the chip opens.
+ */
+export declare function horizonWords(h: ScheduleHorizon): string | null;

package/node_modules/@waterplane/shared/dist/schedule/schedhorizon.js

@@ -0,0 +1,98 @@
+// Cut from schedule.ts (move only): how much is coming, and how soon
+// The one door stays `./schedule.js`; this slice imports its siblings directly, never the barrel.
+import { isStandingSchedule } from "./schedfire.js";
+const H = 3_600_000;
+/**
+ * The bucket names, as the chip says them — the ONE spelling.
+ *
+ * A count on screen is a promise that a list somewhere holds exactly those
+ * rows, so the words on the chip and the words on the filtered list's own bar
+ * come from here, and the boundaries that produced the count are
+ * `horizonBucket` and nothing else. Two copies of `<= 24h` is how "2 within
+ * the hour" opens a list of three.
+ */
+export const HORIZON_LABEL = {
+    soon: "within the hour",
+    day: "in 24h",
+    twoDay: "in 2d",
+    week: "this week",
+    later: "later",
+    unarmed: "not armed",
+};
+/** The bucket one armed instant falls in. The only place the edges live. */
+export function horizonBucket(at, now) {
+    if (at == null)
+        return "unarmed";
+    const inMs = at - now;
+    // An instant already behind us is due NOW, not "later" — a missed
+    // occurrence inside its grace is the most urgent thing in this list, and
+    // bucketing it by raw distance would file it under "beyond a week" on the
+    // wrong side of zero.
+    if (inMs <= H)
+        return "soon";
+    if (inMs <= 24 * H)
+        return "day";
+    if (inMs <= 48 * H)
+        return "twoDay";
+    if (inMs <= 7 * 24 * H)
+        return "week";
+    return "later";
+}
+/**
+ * Bucket a set of armed instants. Rows are anything carrying a `nextAt`, and a
+ * row that also carries its `rule` is put through `isStandingSchedule` first:
+ * a one-off that has been and gone is history, and this counts what is coming.
+ */
+export function scheduleHorizon(rows, now) {
+    const h = { soon: 0, day: 0, twoDay: 0, week: 0, later: 0, unarmed: 0, total: 0 };
+    for (const r of rows) {
+        if (!isStandingSchedule(r, now))
+            continue;
+        h.total++;
+        h[horizonBucket(r.nextAt, now)]++;
+    }
+    return h;
+}
+/** Buckets in the order the chip reads them: nearest first, `unarmed` last. */
+const HORIZON_ORDER = ["soon", "day", "twoDay", "week", "later", "unarmed"];
+/**
+ * The bucket the chip's LEADING number counts — what tapping it filters to.
+ *
+ * `null` when the chip says nothing, so a tap that would open an empty list
+ * cannot happen.
+ */
+export function horizonLead(h) {
+    return HORIZON_ORDER.find((k) => h[k] > 0) ?? null;
+}
+/**
+ * The horizon as one line. `null` when there is nothing armed at all — a badge
+ * that says "0 scheduled" is a badge that trains people not to read badges.
+ *
+ * At most the two nearest non-empty buckets, because this is read at a glance
+ * on a phone and the third number is never the one that changes a decision.
+ * The full breakdown belongs in the sheet the chip opens.
+ */
+export function horizonWords(h) {
+    const parts = HORIZON_ORDER
+        .filter((k) => k !== "unarmed")
+        .map((k) => ({ n: h[k], label: HORIZON_LABEL[k] }))
+        .filter((p) => p.n > 0);
+    if (!parts.length) {
+        // Armed at nothing is still worth a word — it is the state somebody has to
+        // do something about, and silence here reads as "nothing is scheduled"
+        // when the truth is "everything scheduled is stuck".
+        return h.unarmed > 0 ? `${h.unarmed} ${HORIZON_LABEL.unarmed}` : null;
+    }
+    const [a, b] = parts;
+    // `more` is what makes the buckets legibly disjoint in the one place the
+    // reader cannot see their definitions.
+    return b ? `${a.n} ${a.label} · ${b.n} more ${b.label}` : `${a.n} ${a.label}`;
+}
+// ── When a piece of work will fire, in words ─────────────────────────
+//
+// Moved here from the web's `sendIntent.ts`, unchanged, because a second
+// reader needs the same sentence: the host's agent route (`agentintents.ts`)
+// answers an agent that posted a prompt for later with "when will this fire",
+// and a second phrasing of that is two opinions about one row. The send sheet
+// re-exports all four, so no web call site moved.
+//# sourceMappingURL=schedhorizon.js.map

package/node_modules/@waterplane/shared/dist/schedule/schedhorizon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedhorizon.js","sourceRoot":"","sources":["../../src/schedule/schedhorizon.ts"],"names":[],"mappings":"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"}