waterplane 0.1.25 → 0.1.26

package/CHANGELOG.md

@@ -5,6 +5,35 @@ version — so entries are grouped by the release they shipped in. A fixed secur
 vulnerability in what ships is listed under a **Security:** bullet of the release that
 fixed it, with its CVE or GHSA id when one exists.
 
+## 0.1.26
+
+### New
+
+- **Dollar figures now come from Anthropic's published price list.** The host reads the price page once a day and at boot, and keeps the last good read. Token stats and the VS Code status bar say which list priced a figure and when it was read. Past spend re-prices when the rates change. A desktop setup row shows the state, and `WATERPLANE_PRICE_FETCH=0` turns it off.
+- **A "skills & plugins" screen switches skills and plugins on and off per repo.** You edit a draft, pick the level, and save to one named settings file. Each row shows its weight and how often it was used. Skills an author has locked count nothing and say so. Doors lead to it from the context-weight row and the request breakdown.
+- **Recommend suggests which skills to switch off.** It is one tapped call that returns a pre-ticked list with the savings. Nothing applies until you tap Apply.
+- **Token stats have an "Agent readings over time" card.** It shows start context, looks before the first edit, requests per committing session and subagent start, by day or week. Markers show where instructions, model, CLI version, memory or skills changed. Tapping a marker compares 14 days before and after, with the band of normal variation.
+- **Disk space ships in the release, off until you switch it on.** It now covers Linux and Windows through WSL, including Windows caches and old temp files. The scan runs in two parts, so rows appear as soon as the fast part is measured.
+- **Links ships in the release, off until you switch it on.** Its cloud search uses this desktop's gcloud sign-in.
+- **Snippets can be ticked and inserted together, one per line.** A plain tap on a row still inserts one at once. The most recently used come first on this phone. A person with no list sees eight starter snippets.
+- **Local dictation can be set up from a tap.** The Settings row shows the state, model choice, progress and any failure reason. The installer has an optional `--dictation` step. The fallback pill says the phone recogniser is weaker and may send audio to Google.
+- **A busy CPU on the desktop sheet names the culprits.** At 80% or more it lists the top three programs and the coding sessions behind it. Tapping a session opens it.
+- **The speed-test sheet has a connection test.** It makes 20 timed round trips and gives the median, jitter, best and worst, lost packets and a one-sentence verdict. Connection health and the desktop's edit form have doors to the connection test, the speed test and the desktop addresses.
+- **Reader tables wrap long prose columns instead of scrolling sideways.** Short cells stay on one line. A toggle goes back to one line per row.
+- **The model wheel button shows a Sparkles badge when the CLI confirmed ultracode is on.**
+
+### Fixed
+
+- **A retry now wakes the phone when the link drops in a pocket.** Before, a lost socket could stay lost for minutes until the screen came on.
+- **A prompt no longer overtakes the picture it names.** A failed upload holds back the prompt that names it. The host also waits up to 5 minutes for fresh inbox files before typing.
+- **The first prompt sent on a new screen while offline now rides inside the create.** The desktop types it once the link is back, even if the link comes back only briefly.
+- **Words written on a pending screen that nothing can reach any more go to the pad.** Before, they were lost after the X or a retry.
+- **The close check no longer reads an unknown unmerged count as nothing to lose.** It now says so. It also measures against the right base branch in repos that don't use main or master.
+- **The update button no longer refuses because an agent ran an install in some repo.** Only an install that names the CLI's package counts.
+- **The network retry card keeps its text readable.** The line and error sit above the buttons, and Retry now also works while waiting.
+- **The request chip stays hidden while the link is connecting.** The header already says so.
+- **Screens that also run in a desktop browser say "this device", not "this phone".**
+
 ## 0.1.25
 
 ### New

package/SECURITY.md

@@ -54,8 +54,9 @@ authorized caller can do once inside.**
   "loopback" there means any process on the Windows machine, the same local-machine boundary as on a
   Mac. The `Origin`/`Host` checks still apply to browsers on it.
 - Never bind a public interface. `WATERPLANE_ALLOW_PUBLIC=1` adds LAN interfaces behind a password gate
-  (below) and is an explicit opt-in. Plain HTTP on a LAN has no defence against a man in the middle: if
-  that network is not trusted, do not enable it.
+  (below) and is an explicit opt-in. A browser on the LAN speaks plain HTTP, which has no defence against
+  a man in the middle: if that network is not trusted, do not enable it. The Android app instead
+  reaches the desktop on the encrypted LAN port with a pinned key (see LAN TLS and the pin).
 
 ### In scope
 
@@ -368,8 +369,9 @@ itself arrives unprotected, and the token is still exposed to the relay.
 
 (`packages/host/src/lantls.ts`.) Only where `WATERPLANE_ALLOW_PUBLIC=1` already binds LAN addresses, the
 host also listens on `WATERPLANE_TLS_PORT` (default port + 1) on those same addresses, with the same
-handler and gate, so a caller there is still peer kind `lan` and needs its token. Off with
-`WATERPLANE_TLS=0`; never on loopback or the tailnet; nothing without the opt-in.
+handler and gate, so a caller there is still peer kind `lan` and needs its token. It is on by default
+with the opt-in and off with `WATERPLANE_TLS=0`; a busy port is logged and the host carries on plain.
+Never on loopback or the tailnet; nothing without the opt-in.
 
 The key is P-256 in `<state dir>/lan-tls.json` (0600), kept across restarts. The certificate is
 self-signed and re-issued on the same key when the addresses change, so the phone's pin (SHA-256 of the
@@ -387,6 +389,14 @@ from a CA; a self-signed one is read as self-signed) it serves the app, and the
 - A first install of the APK over the network (Android accepts any signature then).
 - Code already running in the page, a browser, and dropping packets.
 
+The app learns the desktop's key over Tailscale (or a sealed pairing) and pins it per saved desktop. In
+the Edit desktop screen the Wi-Fi address is typed plain (`192.168.0.64` or `http://192.168.0.64:8770`):
+the app then dials `https://<ip>:8771` with the pin by itself. A typed `https://` bare IP is dialled as
+written (the plain port never speaks TLS) and is never matched to the pin, so the screen offers "use
+<ip>"; an `https` name, such as a front door with a real certificate, is left alone. The screen says per
+row whether the link is encrypted, not yet encrypted (the key is learned by itself on the next
+Tailscale connection) or cannot be (an old APK).
+
 The pin is a property of current APK builds; an older APK ignores it and stays on plain LAN with the
 warnings. The way out of a pinned desktop whose TLS port is off is a confirmed "use plain HTTP for this
 desktop" on its row; nothing does it by itself. The measurements behind this, taken on two emulator
@@ -495,6 +505,16 @@ the accident, not a wrapper script the rule cannot see or an agent talking you i
   directory entry counts) neither descend into nor list the contents of a link whose target is outside
   the worktree; the link itself is shown as a link, nothing more.
 
+### Outbound reads the host makes on its own
+
+- **Anthropic's price page** (`pricefetch.ts`): one `GET` of the fixed HTTPS URL
+  `platform.claude.com/docs/en/about-claude/pricing.md`, at boot when the last read is over a day old,
+  once a day, and at most hourly when a ledger meets an unpriced Claude model. Generic user agent
+  (`waterplane-pricecheck`), no cookies, no identifiers, no body. A redirect is followed only to
+  HTTPS on `claude.com` or `anthropic.com` (or a subdomain); anywhere else is refused. The answer is
+  parsed strictly and a page that does not parse changes no price. The phone gets the host's read in
+  `welcome` and never fetches it itself. `WATERPLANE_PRICE_FETCH=0` turns it off.
+
 ### A repo's own repo-health engine
 
 (`tools/repohealth.mjs`, run by the host after one approval, `repohealthapproval.ts`.) The engine is

package/node_modules/@waterplane/shared/dist/agentseries/compare.d.ts

@@ -0,0 +1,8 @@
+import type { CompareOpts, CompareResult, SeriesAbsent, SeriesPoint } from "./types.js";
+export declare const COMPARE_DEFAULT_DAYS = 14;
+/** Fewest day blocks on each side. */
+export declare const COMPARE_MIN_DAYS = 4;
+/** Fewest sessions on each side. */
+export declare const COMPARE_MIN_N = 10;
+export declare const COMPARE_PERMUTATIONS = 500;
+export declare function compareAround(points: readonly SeriesPoint[], atMs: number, opts: CompareOpts): CompareResult | SeriesAbsent;

package/node_modules/@waterplane/shared/dist/agentseries/compare.js

@@ -0,0 +1,103 @@
+/**
+ * `compareAround` — one reading `days` before an instant against `days` after it,
+ * beside the band of ratios day-to-day variation alone produces.
+ *
+ * The band: every session keeps its value, but the DAY blocks of the window
+ * (a day the instant splits is two blocks) are shuffled between the two sides,
+ * keeping each side's block count, and the pooled-median ratio is taken again —
+ * `COMPARE_PERMUTATIONS` times from a fixed seed, so the same data always gives
+ * the same band. Days, not sessions, are shuffled because sessions on one day
+ * are alike (same task, same cache), which a session shuffle would hide and
+ * draw the band too narrow. The band is its 2.5–97.5 percentiles.
+ *
+ * Same model only: a window whose sessions ran more than one model id (or do
+ * not say which) is ABSENT unless a model is named — a model change moves these
+ * readings more than any instruction edit does.
+ */
+import { addLocalDays } from "../calday.js";
+import { seriesFilter, seriesReadingOf } from "./series.js";
+import { localDayOf, medianOf, percentileSorted, seededRandom } from "./stats.js";
+export const COMPARE_DEFAULT_DAYS = 14;
+/** Fewest day blocks on each side. */
+export const COMPARE_MIN_DAYS = 4;
+/** Fewest sessions on each side. */
+export const COMPARE_MIN_N = 10;
+export const COMPARE_PERMUTATIONS = 500;
+const SEED = 0x5eed2a11;
+const absent = (why) => ({ absent: why });
+/** Pooled-median ratio after/before of a split of the blocks; null when the before median is 0 or a side is empty. */
+function ratioOf(blocks, isBefore) {
+    const b = [];
+    const a = [];
+    blocks.forEach((bl, i) => (isBefore(i) ? b : a).push(...bl.vals));
+    const mb = medianOf(b);
+    const ma = medianOf(a);
+    if (mb === null || ma === null || mb <= 0)
+        return null;
+    return { before: mb, after: ma, ratio: ma / mb };
+}
+export function compareAround(points, atMs, opts) {
+    if (!Number.isFinite(atMs))
+        return absent("No instant to compare around.");
+    const days = Math.max(1, Math.min(90, Math.floor(opts.days ?? COMPARE_DEFAULT_DAYS)));
+    const lo = addLocalDays(atMs, -days);
+    const hi = addLocalDays(atMs, days);
+    const inWin = seriesFilter(points, opts)
+        .filter((p) => p.t0 >= lo && p.t0 < hi && seriesReadingOf(p, opts.reading) !== undefined);
+    let model = opts.model;
+    if (model === undefined) {
+        const models = new Set(inWin.map((p) => p.model ?? ""));
+        if (models.has(""))
+            return absent("Some of these sessions do not record their model, so a model change in the window cannot be ruled out.");
+        if (models.size > 1)
+            return absent(`More than one model ran in this window (${[...models].sort().join(", ")}); compare one model at a time.`);
+        model = models.size === 1 ? [...models][0] : undefined;
+    }
+    const byKey = new Map();
+    for (const p of inWin) {
+        const before = p.t0 < atMs;
+        const key = `${localDayOf(p.t0)}|${before ? "b" : "a"}`;
+        const bl = byKey.get(key) ?? { before, vals: [] };
+        bl.vals.push(seriesReadingOf(p, opts.reading));
+        byKey.set(key, bl);
+    }
+    const blocks = [...byKey.keys()].sort().map((k) => byKey.get(k));
+    const daysBefore = blocks.filter((b) => b.before).length;
+    const daysAfter = blocks.length - daysBefore;
+    const nBefore = blocks.filter((b) => b.before).reduce((s, b) => s + b.vals.length, 0);
+    const nAfter = inWin.length - nBefore;
+    if (daysBefore < COMPARE_MIN_DAYS || daysAfter < COMPARE_MIN_DAYS) {
+        return absent(`${daysBefore} days with sessions before and ${daysAfter} after; a comparison needs at least ${COMPARE_MIN_DAYS} on each side.`);
+    }
+    if (nBefore < COMPARE_MIN_N || nAfter < COMPARE_MIN_N) {
+        return absent(`${nBefore} sessions before and ${nAfter} after; a comparison needs at least ${COMPARE_MIN_N} on each side.`);
+    }
+    const seen = ratioOf(blocks, (i) => blocks[i].before);
+    if (!seen)
+        return absent("The median before is 0, so there is no ratio to take.");
+    const rand = seededRandom(SEED);
+    const order = blocks.map((_, i) => i);
+    const ratios = [];
+    for (let k = 0; k < COMPARE_PERMUTATIONS; k++) {
+        for (let i = order.length - 1; i > 0; i--) {
+            const j = Math.floor(rand() * (i + 1));
+            [order[i], order[j]] = [order[j], order[i]];
+        }
+        const sideOf = new Array(blocks.length);
+        order.forEach((blockIdx, pos) => { sideOf[blockIdx] = pos < daysBefore; });
+        const r = ratioOf(blocks, (i) => sideOf[i]);
+        if (r)
+            ratios.push(r.ratio);
+    }
+    if (ratios.length < COMPARE_PERMUTATIONS / 2)
+        return absent("Too many shuffled splits had a median of 0 before to draw a band.");
+    ratios.sort((x, y) => x - y);
+    const band = [percentileSorted(ratios, 0.025), percentileSorted(ratios, 0.975)];
+    return {
+        before: seen.before, after: seen.after, ratio: seen.ratio, band,
+        inside: seen.ratio >= band[0] && seen.ratio <= band[1],
+        nBefore, nAfter, daysBefore, daysAfter,
+        ...(model !== undefined ? { model } : {}),
+    };
+}
+//# sourceMappingURL=compare.js.map

package/node_modules/@waterplane/shared/dist/agentseries/compare.js.map

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

package/node_modules/@waterplane/shared/dist/agentseries/markers.d.ts

@@ -0,0 +1,17 @@
+import type { AgentMarker, SeriesPoint } from "./types.js";
+/** A day-median of a listing's chars moving by at least this much is a marker. */
+export declare const LISTING_STEP_CHARS = 1000;
+/** Fewest sessions a day needs before its dominant model/CLI or listing median counts. */
+export declare const MARKER_MIN_N = 3;
+/** Fold same-kind markers of one local day (and one repo) into one carrying `count`; sorted by time. */
+export declare function collapseMarkers(markers: readonly AgentMarker[]): AgentMarker[];
+/**
+ * Markers derived from the points: model, CLI version, memory and skills-listing steps.
+ * `listings: false` leaves the last two out: memory is each project's own index and the skills
+ * listing includes project skills, so a day median pooled over several repos moves when the repo
+ * mix does, which would read as an instruction change. Pooled (no `repo`) callers pass it.
+ */
+export declare function derivedMarkers(points: readonly SeriesPoint[], opts?: {
+    repo?: string;
+    listings?: boolean;
+}): AgentMarker[];

package/node_modules/@waterplane/shared/dist/agentseries/markers.js

@@ -0,0 +1,125 @@
+/**
+ * Markers the points themselves show — the competing explanations drawn on the
+ * same axis as the readings: the model changed, a new CLI version took over,
+ * the memory or skills listing a fresh session carries stepped. Plus
+ * `collapseMarkers`, the ONE fold of same-kind markers on one local day
+ * (the host's git markers go through it too).
+ *
+ * Words are neutral: a marker says what changed and by how much, never whether
+ * that was good.
+ */
+import { hourKeyMs } from "../costwindow.js";
+import { seriesReadingOf } from "./series.js";
+import { localDayOf, medianOf } from "./stats.js";
+/** A day-median of a listing's chars moving by at least this much is a marker. */
+export const LISTING_STEP_CHARS = 1000;
+/** Fewest sessions a day needs before its dominant model/CLI or listing median counts. */
+export const MARKER_MIN_N = 3;
+const dayStart = (day) => hourKeyMs(`${day}T00`);
+const fmt = (n) => Math.round(n).toLocaleString("en-US");
+/** The value held by more than half of `xs`, else null (a split day names no winner). */
+function dominant(xs) {
+    if (xs.length < MARKER_MIN_N)
+        return null;
+    const c = new Map();
+    for (const x of xs)
+        c.set(x, (c.get(x) ?? 0) + 1);
+    for (const [k, n] of c)
+        if (n * 2 > xs.length)
+            return k;
+    return null;
+}
+/** Fold same-kind markers of one local day (and one repo) into one carrying `count`; sorted by time. */
+export function collapseMarkers(markers) {
+    const by = new Map();
+    for (const m of markers) {
+        if (!m || !Number.isFinite(m.t))
+            continue;
+        const k = `${localDayOf(m.t)}|${m.kind}|${m.repo ?? ""}`;
+        const list = by.get(k);
+        if (list)
+            list.push(m);
+        else
+            by.set(k, [m]);
+    }
+    const out = [];
+    for (const list of by.values()) {
+        list.sort((a, b) => a.t - b.t);
+        const total = list.reduce((s, m) => s + (m.count ?? 1), 0);
+        if (total === 1) {
+            out.push(list[0]);
+            continue;
+        }
+        const last = list[list.length - 1];
+        const labels = [...new Set(list.map((m) => m.label))];
+        out.push({
+            ...last,
+            t: list[0].t,
+            count: total,
+            detail: labels.slice(0, 5).join("; ") + (labels.length > 5 ? `; and ${labels.length - 5} more` : ""),
+        });
+    }
+    return out.sort((a, b) => a.t - b.t || a.kind.localeCompare(b.kind));
+}
+const LISTINGS = [
+    { part: "memory", kind: "memory", words: "memory" },
+    { part: "skills", kind: "skills", words: "skills listing" },
+];
+/**
+ * Markers derived from the points: model, CLI version, memory and skills-listing steps.
+ * `listings: false` leaves the last two out: memory is each project's own index and the skills
+ * listing includes project skills, so a day median pooled over several repos moves when the repo
+ * mix does, which would read as an instruction change. Pooled (no `repo`) callers pass it.
+ */
+export function derivedMarkers(points, opts = {}) {
+    const byDay = new Map();
+    for (const p of points) {
+        if (!p || !Number.isFinite(p.t0) || p.fresh !== true || p.sub === true)
+            continue;
+        if (opts.repo !== undefined && p.repo !== opts.repo)
+            continue;
+        const d = localDayOf(p.t0);
+        const list = byDay.get(d);
+        if (list)
+            list.push(p);
+        else
+            byDay.set(d, [p]);
+    }
+    const days = [...byDay.keys()].sort();
+    const repo = opts.repo !== undefined ? { repo: opts.repo } : {};
+    const out = [];
+    let prevModel = null;
+    const cliSeen = new Set();
+    const prevListing = new Map();
+    for (const day of days) {
+        const ps = byDay.get(day);
+        const t = dayStart(day);
+        const model = dominant(ps.map((p) => p.model).filter((m) => typeof m === "string" && m !== ""));
+        if (model !== null) {
+            if (prevModel !== null && model !== prevModel)
+                out.push({ t, kind: "model", label: `model ${prevModel} to ${model}`, ...repo });
+            prevModel = model;
+        }
+        const cli = dominant(ps.map((p) => p.cli).filter((c) => typeof c === "string" && c !== ""));
+        if (cli !== null && !cliSeen.has(cli)) {
+            if (cliSeen.size > 0)
+                out.push({ t, kind: "cli", label: `CLI ${cli}`, ...repo });
+            cliSeen.add(cli);
+        }
+        const startSet = ps.filter((p) => seriesReadingOf(p, "start") !== undefined);
+        for (const { part, kind, words } of opts.listings === false ? [] : LISTINGS) {
+            const xs = startSet.map((p) => p.parts?.[part]).filter((x) => typeof x === "number" && Number.isFinite(x));
+            if (xs.length < MARKER_MIN_N)
+                continue;
+            const med = medianOf(xs);
+            const prev = prevListing.get(part);
+            if (prev !== undefined && Math.abs(med - prev) >= LISTING_STEP_CHARS) {
+                const d = med - prev;
+                out.push({ t, kind, label: `${words} ${d > 0 ? "+" : "−"}${fmt(Math.abs(d))} chars`, detail: `${fmt(prev)} to ${fmt(med)} chars, day median`, ...repo });
+            }
+            prevListing.set(part, med);
+        }
+    }
+    return collapseMarkers(out);
+}
+//# sourceMappingURL=markers.js.map

package/node_modules/@waterplane/shared/dist/agentseries/markers.js.map

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

package/node_modules/@waterplane/shared/dist/agentseries/series.d.ts

@@ -0,0 +1,16 @@
+import type { SeriesBucket, SeriesOpts, SeriesPoint, SeriesReading } from "./types.js";
+/** Fewest sessions a bucket's median is taken over. */
+export declare const SERIES_MIN_N = 5;
+/** The value `p` contributes to `reading`, or undefined when it is not one of that reading's sessions. */
+export declare function seriesReadingOf(p: SeriesPoint, reading: SeriesReading): number | undefined;
+/** The sentence for too few sessions behind a reading. */
+export declare function seriesTooFewText(n: number, reading: SeriesReading | "part", min?: number): string;
+/** Points kept by the model/repo filters (a model filter drops points with no model id). */
+export declare function seriesFilter(points: readonly SeriesPoint[], opts: {
+    model?: string;
+    repo?: string;
+}): SeriesPoint[];
+/** The bucket key of an instant: its local day, or the Monday of that day's ISO week. */
+export declare function seriesBucketKey(t: number, grain: "day" | "week"): string | null;
+/** The readings per bucket, oldest first; only buckets holding at least one point. */
+export declare function seriesOf(points: readonly SeriesPoint[], opts: SeriesOpts): SeriesBucket[];

package/node_modules/@waterplane/shared/dist/agentseries/series.js

@@ -0,0 +1,93 @@
+/**
+ * `seriesOf` — the agent readings per local day or ISO week.
+ *
+ * Which sessions each reading is over (`seriesReadingOf` is the ONE answer, the
+ * before/after uses it too):
+ * - `start`: fresh, interactive (not headless), not a subagent, with a first request;
+ * - `subStart`: subagent logs with a first request;
+ * - `look`: fresh, not a subagent, reached an edit (`look` present);
+ * - `req`: fresh, not a subagent, committed.
+ * A bucket with fewer than `SERIES_MIN_N` sessions for a reading has that reading
+ * ABSENT with the sentence why — never a median of one or two.
+ */
+import { isoWeekOf } from "../healthindex.js";
+import { localDayOf, medianOf } from "./stats.js";
+/** Fewest sessions a bucket's median is taken over. */
+export const SERIES_MIN_N = 5;
+const num = (x) => typeof x === "number" && Number.isFinite(x) && x >= 0;
+const isFreshMain = (p) => p.fresh === true && p.sub !== true;
+/** The value `p` contributes to `reading`, or undefined when it is not one of that reading's sessions. */
+export function seriesReadingOf(p, reading) {
+    switch (reading) {
+        case "start": return isFreshMain(p) && p.headless !== true && num(p.start) ? p.start : undefined;
+        case "subStart": return p.sub === true && num(p.start) ? p.start : undefined;
+        case "look": return isFreshMain(p) && num(p.look) ? p.look : undefined;
+        case "req": return isFreshMain(p) && p.commit === true && num(p.req) ? p.req : undefined;
+    }
+}
+// closed: SeriesReading is a parameter of these pure functions, never read off the wire
+const READING_WORDS = {
+    start: "fresh interactive sessions with a first request",
+    subStart: "subagent logs with a first request",
+    look: "fresh sessions that reached an edit",
+    req: "fresh sessions that committed",
+};
+/** The sentence for too few sessions behind a reading. */
+export function seriesTooFewText(n, reading, min = SERIES_MIN_N) {
+    const what = reading === "part" ? "fresh interactive sessions that measured this part" : READING_WORDS[reading];
+    return `${n} ${what} here; a median needs at least ${min}.`;
+}
+/** Points kept by the model/repo filters (a model filter drops points with no model id). */
+export function seriesFilter(points, opts) {
+    return points.filter((p) => p && Number.isFinite(p.t0)
+        && (opts.repo === undefined || p.repo === opts.repo)
+        && (opts.model === undefined || p.model === opts.model));
+}
+function valueOf(xs, reading) {
+    if (xs.length < SERIES_MIN_N)
+        return { absent: seriesTooFewText(xs.length, reading) };
+    return { median: medianOf(xs), n: xs.length };
+}
+function bucketOf(key, ps) {
+    const vals = (r) => ps.map((p) => seriesReadingOf(p, r)).filter((x) => x !== undefined);
+    const startSet = ps.filter((p) => seriesReadingOf(p, "start") !== undefined);
+    const parts = {};
+    const ids = [...new Set(startSet.flatMap((p) => Object.keys(p.parts ?? {})))].sort();
+    for (const part of ids) {
+        const xs = startSet.map((p) => p.parts?.[part]).filter(num);
+        if (xs.length > 0)
+            parts[part] = valueOf(xs, "part");
+    }
+    return {
+        key,
+        fresh: ps.filter(isFreshMain).length,
+        start: valueOf(vals("start"), "start"),
+        parts,
+        look: valueOf(vals("look"), "look"),
+        req: valueOf(vals("req"), "req"),
+        subStart: valueOf(vals("subStart"), "subStart"),
+    };
+}
+/** The bucket key of an instant: its local day, or the Monday of that day's ISO week. */
+export function seriesBucketKey(t, grain) {
+    if (!Number.isFinite(t))
+        return null;
+    const day = localDayOf(t);
+    return grain === "day" ? day : isoWeekOf(day);
+}
+/** The readings per bucket, oldest first; only buckets holding at least one point. */
+export function seriesOf(points, opts) {
+    const by = new Map();
+    for (const p of seriesFilter(points, opts)) {
+        const k = seriesBucketKey(p.t0, opts.grain);
+        if (!k)
+            continue;
+        const list = by.get(k);
+        if (list)
+            list.push(p);
+        else
+            by.set(k, [p]);
+    }
+    return [...by.keys()].sort().map((k) => bucketOf(k, by.get(k)));
+}
+//# sourceMappingURL=series.js.map

package/node_modules/@waterplane/shared/dist/agentseries/series.js.map

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

package/node_modules/@waterplane/shared/dist/agentseries/stats.d.ts

@@ -0,0 +1,8 @@
+/** Median of finite numbers; null for none. */
+export declare function medianOf(xs: readonly number[]): number | null;
+/** Linear-interpolated percentile (`p` in 0..1) of an ascending array; null for none. */
+export declare function percentileSorted(sorted: readonly number[], p: number): number | null;
+/** mulberry32: a small deterministic PRNG, uniform in [0, 1). */
+export declare function seededRandom(seed: number): () => number;
+/** The local calendar day (`YYYY-MM-DD`) an instant falls in. */
+export declare const localDayOf: (t: number) => string;

package/node_modules/@waterplane/shared/dist/agentseries/stats.js

@@ -0,0 +1,33 @@
+/** Medians, percentiles and a seeded PRNG for the agent series — pure, no clock. */
+import { hourKey } from "../costwindow.js";
+/** Median of finite numbers; null for none. */
+export function medianOf(xs) {
+    const v = xs.filter((x) => Number.isFinite(x)).sort((a, b) => a - b);
+    if (v.length === 0)
+        return null;
+    const m = v.length >> 1;
+    return v.length % 2 ? v[m] : (v[m - 1] + v[m]) / 2;
+}
+/** Linear-interpolated percentile (`p` in 0..1) of an ascending array; null for none. */
+export function percentileSorted(sorted, p) {
+    if (sorted.length === 0)
+        return null;
+    const at = Math.min(1, Math.max(0, p)) * (sorted.length - 1);
+    const lo = Math.floor(at);
+    const hi = Math.ceil(at);
+    return sorted[lo] + (sorted[hi] - sorted[lo]) * (at - lo);
+}
+/** mulberry32: a small deterministic PRNG, uniform in [0, 1). */
+export function seededRandom(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a = (a + 0x6d2b79f5) >>> 0;
+        let t = a;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/** The local calendar day (`YYYY-MM-DD`) an instant falls in. */
+export const localDayOf = (t) => hourKey(t).slice(0, 10);
+//# sourceMappingURL=stats.js.map

package/node_modules/@waterplane/shared/dist/agentseries/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/agentseries/stats.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,+CAA+C;AAC/C,MAAM,UAAU,QAAQ,CAAC,EAAqB;IAC5C,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IACxB,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAAC,MAAyB,EAAE,CAAS;IACnE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7D,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC,EAAE,CAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,GAAG,MAAM,CAAC,EAAE,CAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACnB,OAAO,GAAG,EAAE;QACV,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC"}