trainbud 0.5.0

package/dist/detect/index.js

@@ -0,0 +1,114 @@
+import { DateTime } from "luxon";
+import { getActivitiesBetween, getMetricSeries } from "../history/store.js";
+import { detectHrvTrendBreak, detectLoadRatio, detectRestingHrElevation, detectSleepDebt, } from "./detectors.js";
+// SECTION: Running the detectors
+/** Below this, the store describes a fortnight's mood rather than a person. */
+const READY_DAYS = 14;
+/**
+ * How old the newest measurement may be before "nothing stands out" stops being
+ * an answer.
+ *
+ * Coverage counted total days and ignored recency, so a store holding 74 days
+ * that stopped three weeks ago reported `ready: true` and every detector then
+ * correctly found nothing -- because there was nothing recent to find. The app
+ * told the user, confidently, that nothing stood out. That is the exact failure
+ * the cold-start guard exists to prevent: an absence rendered as a clean bill of
+ * health. It just was not looking at the right absence.
+ *
+ * Three days of grace: Garmin finalises a sleep score hours after waking, and a
+ * watch that has not been synced since yesterday is normal.
+ */
+const MAX_STALE_DAYS = 3;
+/** Every metric a detector reads, for the coverage figure. */
+const COVERAGE_KINDS = ["resting_hr", "sleep_seconds", "hrv_overnight"];
+const SEVERITY_ORDER = {
+    warn: 0,
+    notice: 1,
+    info: 2,
+};
+export function describeFindingsCoverage(coverage) {
+    if (coverage.ready) {
+        return { state: "ready", detail: `${coverage.days} days of history`, fix: null };
+    }
+    // Depth is present and the record has simply stopped. Note this is tested
+    // before the day count: a store can be both short and stale, and "go and
+    // fetch" is the useful answer in that case too.
+    if (coverage.throughDate !== null && coverage.staleDays > MAX_STALE_DAYS) {
+        return {
+            state: "stale",
+            detail: `${coverage.days} days of history are stored, but the record stops at ` +
+                `${coverage.throughDate} — ${coverage.staleDays} days ago. Nothing is known about the days since. ` +
+                `The stored history is real and still worth reasoning about; what is missing is only the days after that date.`,
+            fix: "Run `trainbud backfill --days 20` to bring the record up to date.",
+        };
+    }
+    return {
+        state: "cold",
+        detail: `Still gathering data — ${coverage.days} of the ${READY_DAYS} days needed before anything can be compared against a baseline.`,
+        fix: "Run `trainbud backfill` to pull what Garmin already holds.",
+    };
+}
+/** The only function here that touches the store. */
+export function buildDetectorInput(now = DateTime.local()) {
+    const startOfDay = now.startOf("day");
+    return {
+        now,
+        series: (kind, days) => {
+            const start = startOfDay.minus({ days }).toISODate() ?? "";
+            const end = startOfDay.toISODate() ?? "";
+            return getMetricSeries(kind, start, end);
+        },
+        activities: (days) => {
+            const start = startOfDay.minus({ days }).toISODate() ?? "";
+            const end = startOfDay.toISODate() ?? "";
+            return getActivitiesBetween(start, end);
+        },
+    };
+}
+/**
+ * Cold start is a first-class case, not an edge one. With no history every
+ * detector correctly returns null, and an empty array on its own is
+ * indistinguishable from a clean bill of health. `ready` is what lets a surface
+ * say "still gathering data" instead of implying everything is fine -- so
+ * surfaces read the flag, never the length of the array.
+ */
+export function runDetectors(input = buildDetectorInput()) {
+    const series = COVERAGE_KINDS.map((kind) => input.series(kind, 365));
+    const days = Math.max(0, ...series.map((points) => points.length));
+    // The newest measurement of any kind, and how old it is. A detector compares
+    // a recent day against a baseline; with no recent day there is nothing to
+    // compare, and saying "nothing stands out" would be a claim about a day that
+    // was never recorded.
+    const throughDate = series
+        .map((points) => points.at(-1)?.date ?? null)
+        .filter((date) => date !== null)
+        .sort()
+        .at(-1) ?? null;
+    const today = input.now.startOf("day");
+    const staleDays = throughDate === null
+        ? Number.MAX_SAFE_INTEGER
+        : Math.max(0, Math.round(today.diff(DateTime.fromISO(throughDate).startOf("day"), "days").days));
+    const findings = [
+        detectRestingHrElevation(input),
+        detectHrvTrendBreak(input),
+        detectLoadRatio(input),
+        detectSleepDebt(input),
+    ].filter((finding) => finding !== null);
+    // Severity first, then a fixed detector order via the kind. The watch shows
+    // the first couple, and findings that shuffled between syncs would read as
+    // the data having changed when it has not.
+    findings.sort((left, right) => {
+        const bySeverity = SEVERITY_ORDER[left.severity] - SEVERITY_ORDER[right.severity];
+        return bySeverity !== 0 ? bySeverity : left.kind.localeCompare(right.kind);
+    });
+    return {
+        findings,
+        coverage: {
+            days,
+            ready: days >= READY_DAYS && staleDays <= MAX_STALE_DAYS,
+            throughDate,
+            staleDays: throughDate === null ? 0 : staleDays,
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/detect/index.js.map

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

package/dist/detect/sleepQuality.d.ts

@@ -0,0 +1,21 @@
+import type { DetectorInput } from "./findings.js";
+export type SleepConsistency = "steady" | "variable" | "erratic" | "unknown";
+export interface SleepQuality {
+    /** This person's own habitual nightly sleep, in hours. */
+    habitualHours: number | null;
+    /** Hours slept last night, or null if it was not recorded. */
+    lastNightHours: number | null;
+    /**
+     * Net hours under habitual across the last seven nights. Positive is a debt;
+     * negative means they slept more than usual. Null without a habitual figure.
+     */
+    debtHours: number | null;
+    /** Nights that actually carry a measurement in the debt window. */
+    nightsCounted: number;
+    /** Typical night-to-night swing, in minutes. */
+    variationMinutes: number | null;
+    consistency: SleepConsistency;
+    summary: string;
+}
+export declare function analyseSleep(input: DetectorInput): SleepQuality;
+//# sourceMappingURL=sleepQuality.d.ts.map

package/dist/detect/sleepQuality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleepQuality.d.ts","sourceRoot":"","sources":["../../src/detect/sleepQuality.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AA0CnD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,8DAA8D;IAC9D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAuCD,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAoH/D"}

package/dist/detect/sleepQuality.js

@@ -0,0 +1,164 @@
+import { DateTime } from "luxon";
+import { median } from "./baseline.js";
+// SECTION: Sleep debt and consistency
+//
+// The Sleep card shows last night. Last night is the least informative sleep
+// number there is: everyone has a bad night, and a single figure cannot tell a
+// late film from a fortnight of five-hour nights.
+//
+// Two things it cannot say and this can:
+//
+//   * DEBT -- how far the last week sits under what this person actually
+//     sleeps. Against their own median, not against eight hours. Eight hours is
+//     a population figure and telling a habitual seven-hour sleeper they are an
+//     hour down every night of their life is how a health app becomes noise.
+//
+//   * CONSISTENCY -- how much the nights vary. Regularity predicts how rested
+//     someone is well beyond duration, and it is invisible in any single night.
+//     Measured as median absolute deviation rather than standard deviation, for
+//     the same reason every baseline here does: one 11-hour recovery sleep
+//     after a race would inflate a standard deviation and make a metronomic
+//     sleeper look erratic.
+//
+// Neither number is a diagnosis and neither mentions one.
+const NEED_WINDOW_DAYS = 28;
+const DEBT_WINDOW_DAYS = 7;
+const CONSISTENCY_WINDOW_DAYS = 14;
+/** Below this the figures describe a fortnight's mood rather than a person. */
+const MIN_NIGHTS_FOR_NEED = 14;
+/**
+ * How old the newest row may be and still be called "last night".
+ *
+ * One day: a watch that has not been synced since this morning is ordinary. Two
+ * weeks is not, and the store's newest row was being reported as last night
+ * however old it was.
+ */
+const LAST_NIGHT_GRACE_DAYS = 1;
+const MIN_NIGHTS_FOR_CONSISTENCY = 7;
+const SECONDS_PER_HOUR = 3600;
+function round(value, places = 1) {
+    const factor = 10 ** places;
+    return Math.round(value * factor) / factor;
+}
+/**
+ * Bands are in minutes of typical swing. Half an hour either side of your own
+ * median is an ordinary life; two hours is a different sleep pattern every
+ * night, and that is worth naming even when the total is fine -- which is
+ * exactly the case a duration-only card cannot see.
+ */
+function bandFor(variationMinutes) {
+    if (variationMinutes <= 30) {
+        return "steady";
+    }
+    return variationMinutes <= 60 ? "variable" : "erratic";
+}
+/**
+ * Nights inside the last `days` calendar days, newest last.
+ *
+ * NOT `slice(-days)`. Seven array positions are seven nights only when the
+ * store has no holes, and it routinely does -- a night gets a row only when the
+ * watch was worn. `split()` in detectors.ts carries a long comment about
+ * exactly this fault, written after a resting heart rate elevated in June was
+ * reported as "3 days running" in August. The same slice survived here, and on
+ * the live store, whose record ends 2026-08-21, this file reported that night
+ * as "last night" on 2026-09-03 and computed a debt over 08-15..08-21 while
+ * calling it "the last 7 nights".
+ */
+function withinDays(points, days, now) {
+    const cutoff = now.startOf("day").minus({ days }).toISODate() ?? "";
+    return points.filter((point) => point.date > cutoff);
+}
+export function analyseSleep(input) {
+    const window = input.series("sleep_seconds", NEED_WINDOW_DAYS);
+    const hours = window.map((point) => point.value / SECONDS_PER_HOUR);
+    const empty = {
+        habitualHours: null,
+        lastNightHours: null,
+        debtHours: null,
+        nightsCounted: 0,
+        variationMinutes: null,
+        consistency: "unknown",
+        summary: "Not enough nights recorded yet to describe your sleep pattern.",
+    };
+    if (hours.length === 0) {
+        return empty;
+    }
+    // "Last night" is a claim about last night. The newest row in the store is
+    // only that if it is dated last night; grace of one day for a watch that has
+    // not synced yet, and nothing beyond.
+    const newest = window.at(-1);
+    const newestAge = newest === undefined
+        ? null
+        : Math.round(input.now.startOf("day").diff(DateTime.fromISO(newest.date).startOf("day"), "days").days);
+    const lastNightHours = newest !== undefined && newestAge !== null && newestAge <= LAST_NIGHT_GRACE_DAYS
+        ? round(newest.value / SECONDS_PER_HOUR)
+        : null;
+    if (hours.length < MIN_NIGHTS_FOR_NEED) {
+        return {
+            ...empty,
+            lastNightHours,
+            nightsCounted: hours.length,
+            summary: `Only ${hours.length} nights recorded so far; ${MIN_NIGHTS_FOR_NEED} are needed before a personal baseline means anything.`,
+        };
+    }
+    const habitual = median(hours);
+    if (habitual === null) {
+        return { ...empty, lastNightHours, nightsCounted: hours.length };
+    }
+    const debtNights = withinDays(window, DEBT_WINDOW_DAYS, input.now);
+    // A week with nothing recorded in it has no deficit; it has no week. Stating
+    // a debt of zero here would read as "you slept exactly your usual amount",
+    // which is the absence-rendered-as-a-measurement fault this file's own
+    // neighbours were fixed for.
+    if (debtNights.length === 0) {
+        return {
+            ...empty,
+            habitualHours: round(habitual),
+            lastNightHours,
+            summary: `No nights recorded in the last ${DEBT_WINDOW_DAYS} days, so there is nothing to compare against your usual ${round(habitual)}h. The record stops at ${newest?.date ?? "an earlier date"}.`,
+        };
+    }
+    const debtWindow = debtNights.map((point) => point.value / SECONDS_PER_HOUR);
+    const debt = debtWindow.reduce((total, night) => total + (habitual - night), 0);
+    const consistencyWindow = withinDays(window, CONSISTENCY_WINDOW_DAYS, input.now).map((point) => point.value / SECONDS_PER_HOUR);
+    let variationMinutes = null;
+    let consistency = "unknown";
+    if (consistencyWindow.length >= MIN_NIGHTS_FOR_CONSISTENCY) {
+        const centre = median(consistencyWindow);
+        if (centre !== null) {
+            const deviations = consistencyWindow.map((night) => Math.abs(night - centre));
+            const mad = median(deviations);
+            if (mad !== null) {
+                variationMinutes = Math.round(mad * 60);
+                consistency = bandFor(variationMinutes);
+            }
+        }
+    }
+    const habitualHours = round(habitual);
+    const debtHours = round(debt);
+    // Names the number of nights actually MEASURED, and the window they sit in,
+    // because those are two different numbers whenever the watch went unworn.
+    const covered = debtWindow.length === DEBT_WINDOW_DAYS
+        ? `the last ${DEBT_WINDOW_DAYS} nights`
+        : `${debtWindow.length} recorded nights in the last ${DEBT_WINDOW_DAYS} days`;
+    const debtSentence = debtHours >= 1
+        ? `You are ${debtHours}h under your own usual ${habitualHours}h across ${covered}.`
+        : debtHours <= -1
+            ? `You are ${round(-debtHours)}h above your own usual ${habitualHours}h across ${covered}.`
+            : `Your sleep across ${covered} is close to your usual ${habitualHours}h.`;
+    const consistencySentence = consistency === "unknown"
+        ? ""
+        : consistency === "steady"
+            ? ` Your nights are steady, within about ${variationMinutes} minutes of each other.`
+            : ` Your nights swing by about ${variationMinutes} minutes, which is ${consistency === "erratic" ? "a different pattern most nights" : "more variable than steady"}.`;
+    return {
+        habitualHours,
+        lastNightHours,
+        debtHours,
+        nightsCounted: debtWindow.length,
+        variationMinutes,
+        consistency,
+        summary: debtSentence + consistencySentence,
+    };
+}
+//# sourceMappingURL=sleepQuality.js.map

package/dist/detect/sleepQuality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleepQuality.js","sourceRoot":"","sources":["../../src/detect/sleepQuality.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAIvC,sCAAsC;AACtC,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,kDAAkD;AAClD,EAAE;AACF,yCAAyC;AACzC,EAAE;AACF,yEAAyE;AACzE,gFAAgF;AAChF,gFAAgF;AAChF,6EAA6E;AAC7E,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,2EAA2E;AAC3E,4EAA4E;AAC5E,4BAA4B;AAC5B,EAAE;AACF,0DAA0D;AAE1D,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC,+EAA+E;AAC/E,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAsBrC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,SAAS,KAAK,CAAC,KAAa,EAAE,MAAM,GAAG,CAAC;IACtC,MAAM,MAAM,GAAG,EAAE,IAAI,MAAM,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,SAAS,OAAO,CAAC,gBAAwB;IACvC,IAAI,gBAAgB,IAAI,EAAE,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,UAAU,CAAC,MAAqB,EAAE,IAAY,EAAE,GAAa;IACpE,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IACpE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAoB;IAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAAC,CAAC;IAEpE,MAAM,KAAK,GAAiB;QAC1B,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,IAAI;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,CAAC;QAChB,gBAAgB,EAAE,IAAI;QACtB,WAAW,EAAE,SAAS;QACtB,OAAO,EAAE,gEAAgE;KAC1E,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2EAA2E;IAC3E,6EAA6E;IAC7E,sCAAsC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,SAAS,GACb,MAAM,KAAK,SAAS;QAClB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,KAAK,CACR,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CACzF,CAAC;IACR,MAAM,cAAc,GAClB,MAAM,KAAK,SAAS,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,IAAI,qBAAqB;QAC9E,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,gBAAgB,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC;IAEX,IAAI,KAAK,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;QACvC,OAAO;YACL,GAAG,KAAK;YACR,cAAc;YACd,aAAa,EAAE,KAAK,CAAC,MAAM;YAC3B,OAAO,EAAE,QAAQ,KAAK,CAAC,MAAM,4BAA4B,mBAAmB,wDAAwD;SACrI,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAEnE,6EAA6E;IAC7E,2EAA2E;IAC3E,uEAAuE;IACvE,6BAA6B;IAC7B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,GAAG,KAAK;YACR,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC;YAC9B,cAAc;YACd,OAAO,EAAE,kCAAkC,gBAAgB,4DAA4D,KAAK,CAAC,QAAQ,CAAC,0BAA0B,MAAM,EAAE,IAAI,IAAI,iBAAiB,GAAG;SACrM,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAEhF,MAAM,iBAAiB,GAAG,UAAU,CAAC,MAAM,EAAE,uBAAuB,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAClF,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAC1C,CAAC;IACF,IAAI,gBAAgB,GAAkB,IAAI,CAAC;IAC3C,IAAI,WAAW,GAAqB,SAAS,CAAC;IAE9C,IAAI,iBAAiB,CAAC,MAAM,IAAI,0BAA0B,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;YAC9E,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;gBACxC,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAE9B,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,OAAO,GACX,UAAU,CAAC,MAAM,KAAK,gBAAgB;QACpC,CAAC,CAAC,YAAY,gBAAgB,SAAS;QACvC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,gCAAgC,gBAAgB,OAAO,CAAC;IAElF,MAAM,YAAY,GAChB,SAAS,IAAI,CAAC;QACZ,CAAC,CAAC,WAAW,SAAS,0BAA0B,aAAa,YAAY,OAAO,GAAG;QACnF,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;YACf,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,SAAS,CAAC,0BAA0B,aAAa,YAAY,OAAO,GAAG;YAC3F,CAAC,CAAC,qBAAqB,OAAO,2BAA2B,aAAa,IAAI,CAAC;IAEjF,MAAM,mBAAmB,GACvB,WAAW,KAAK,SAAS;QACvB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,WAAW,KAAK,QAAQ;YACxB,CAAC,CAAC,yCAAyC,gBAAgB,yBAAyB;YACpF,CAAC,CAAC,+BAA+B,gBAAgB,sBAAsB,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,2BAA2B,GAAG,CAAC;IAE5K,OAAO;QACL,aAAa;QACb,cAAc;QACd,SAAS;QACT,aAAa,EAAE,UAAU,CAAC,MAAM;QAChC,gBAAgB;QAChB,WAAW;QACX,OAAO,EAAE,YAAY,GAAG,mBAAmB;KAC5C,CAAC;AACJ,CAAC"}

package/dist/detect/trimp.d.ts

@@ -0,0 +1,22 @@
+import type { MetricPoint, StoredActivity } from "../history/store.js";
+export interface HrProfile {
+    restingHr: number;
+    maxHr: number;
+}
+/**
+ * `maxHr` is the highest daily maximum ever recorded, which is an *observed*
+ * maximum rather than a true one -- the user may simply never have gone that
+ * hard. It is the best available without asking their age, and it errs toward
+ * rating sessions harder rather than softer, which is the safer direction for a
+ * load warning.
+ */
+export declare function estimateHrProfile(restingPoints: MetricPoint[], maxPoints: MetricPoint[]): HrProfile | null;
+/**
+ * Null, never zero, when the session cannot be scored. A zero is a claim that
+ * the session was easy; null is the truth, which is that a strength session
+ * recorded without a heart rate says nothing about load either way.
+ */
+export declare function trimpFor(activity: StoredActivity, profile: HrProfile): number | null;
+/** Load per calendar day. Two sessions on one date sum into a single entry. */
+export declare function dailyTrimp(activities: StoredActivity[], profile: HrProfile): Map<string, number>;
+//# sourceMappingURL=trimp.d.ts.map

package/dist/detect/trimp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trimp.d.ts","sourceRoot":"","sources":["../../src/detect/trimp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAuBvE,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,WAAW,EAAE,EAC5B,SAAS,EAAE,WAAW,EAAE,GACvB,SAAS,GAAG,IAAI,CAoBlB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAqBpF;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CACxB,UAAU,EAAE,cAAc,EAAE,EAC5B,OAAO,EAAE,SAAS,GACjB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAarB"}

package/dist/detect/trimp.js

@@ -0,0 +1,77 @@
+import { clamp } from "../utils/helpers.js";
+// SECTION: Training load
+//
+// The activity payload this project fetches carries no load at all -- no
+// activityTrainingLoad, no training effect, no zone time -- so Garmin's own
+// number is not available, and where it does exist it is absent for many
+// activity types. Banister TRIMP needs only duration and average heart rate,
+// which every recorded activity has, and the definition is ours and testable
+// rather than opaque and undocumented.
+//
+//   HRr   = (avgHr - restingHr) / (maxHr - restingHr)   clamped to [0, 1]
+//   TRIMP = minutes x HRr x 0.64 x e^(1.92 x HRr)
+//
+// The exponential is what makes an hour hard worth more than two hours easy.
+//
+// This will not match anything Connect shows, because Connect is not computing
+// TRIMP. Anything that surfaces the number says so.
+const INTENSITY_COEFFICIENT = 0.64;
+const INTENSITY_EXPONENT = 1.92;
+/**
+ * `maxHr` is the highest daily maximum ever recorded, which is an *observed*
+ * maximum rather than a true one -- the user may simply never have gone that
+ * hard. It is the best available without asking their age, and it errs toward
+ * rating sessions harder rather than softer, which is the safer direction for a
+ * load warning.
+ */
+export function estimateHrProfile(restingPoints, maxPoints) {
+    const resting = restingPoints
+        .map((point) => point.value)
+        .filter((value) => Number.isFinite(value) && value > 0);
+    const maxima = maxPoints
+        .map((point) => point.value)
+        .filter((value) => Number.isFinite(value) && value > 0);
+    if (resting.length === 0 || maxima.length === 0) {
+        return null;
+    }
+    const restingHr = Math.min(...resting);
+    const maxHr = Math.max(...maxima);
+    if (maxHr <= restingHr) {
+        return null;
+    }
+    return { restingHr, maxHr };
+}
+/**
+ * Null, never zero, when the session cannot be scored. A zero is a claim that
+ * the session was easy; null is the truth, which is that a strength session
+ * recorded without a heart rate says nothing about load either way.
+ */
+export function trimpFor(activity, profile) {
+    const { avgHr, durationSeconds } = activity;
+    if (avgHr === null || durationSeconds === null) {
+        return null;
+    }
+    if (!Number.isFinite(avgHr) || !Number.isFinite(durationSeconds) || durationSeconds <= 0) {
+        return null;
+    }
+    const range = profile.maxHr - profile.restingHr;
+    if (range <= 0) {
+        return null;
+    }
+    const reserve = clamp((avgHr - profile.restingHr) / range, 0, 1);
+    const minutes = durationSeconds / 60;
+    return (minutes * reserve * INTENSITY_COEFFICIENT * Math.exp(INTENSITY_EXPONENT * reserve));
+}
+/** Load per calendar day. Two sessions on one date sum into a single entry. */
+export function dailyTrimp(activities, profile) {
+    const byDay = new Map();
+    for (const activity of activities) {
+        const score = trimpFor(activity, profile);
+        if (score === null) {
+            continue;
+        }
+        byDay.set(activity.date, (byDay.get(activity.date) ?? 0) + score);
+    }
+    return byDay;
+}
+//# sourceMappingURL=trimp.js.map

package/dist/detect/trimp.js.map

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

package/dist/detect/week.d.ts

@@ -0,0 +1,31 @@
+import { type LoadForecast } from "./forecast.js";
+import { type SleepQuality } from "./sleepQuality.js";
+import type { DetectorInput } from "./findings.js";
+export type Direction = "up" | "down" | "flat" | "unknown";
+export interface WeekMetric {
+    key: string;
+    label: string;
+    unit: string;
+    current: number | null;
+    previous: number | null;
+    delta: number | null;
+    direction: Direction;
+    /** True when the change is large enough to be worth reading. */
+    notable: boolean;
+}
+export interface WeekReview {
+    start: string;
+    end: string;
+    /** False when there is not enough history for the comparison to mean anything. */
+    ready: boolean;
+    sessions: number;
+    previousSessions: number;
+    movingMinutes: number;
+    previousMovingMinutes: number;
+    metrics: WeekMetric[];
+    forecast: LoadForecast;
+    sleep: SleepQuality;
+    headline: string;
+}
+export declare function buildWeekReview(input: DetectorInput): WeekReview;
+//# sourceMappingURL=week.d.ts.map

package/dist/detect/week.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"week.d.ts","sourceRoot":"","sources":["../../src/detect/week.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAgCnD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAkFD,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAoHhE"}

package/dist/detect/week.js

@@ -0,0 +1,184 @@
+import { median } from "./baseline.js";
+import { forecastLoad } from "./forecast.js";
+import { analyseSleep } from "./sleepQuality.js";
+import { dailyTrimp, estimateHrProfile } from "./trimp.js";
+// SECTION: Weekly review
+//
+// Every other surface in this app answers "how am I today". None of them
+// answers "how was the week", which is the unit training is actually planned
+// in -- and it is the question the store has been able to answer since the
+// memory layer landed without anything ever asking it.
+//
+// Each line is this week against last week, both measured from the same store,
+// so the comparison is like for like. Where a metric is missing on either side
+// the line says so rather than showing a delta against zero: an unworn watch is
+// not a resting heart rate of nothing, and this project's bug history is full
+// of absences that were rendered as measurements.
+const WEEK_DAYS = 7;
+/**
+ * How far back to ask for, to get exactly two seven-day weeks.
+ *
+ * `series(kind, n)` returns `today - n .. today` INCLUSIVE, so it spans n + 1
+ * calendar days. Asked for `WEEK_DAYS * 2` and split at `today - 7`, the halves
+ * came out 7 and 8: every wellness metric and the session count compared a
+ * seven-day week against an eight-day one, while the TRIMP load line beside
+ * them summed two explicit seven-day windows and was right. One card
+ * disagreeing with itself, and the wrong half is the one a reader quotes.
+ *
+ * Thirteen gives `today - 13 .. today`: fourteen days, seven each side.
+ */
+const COMPARISON_DAYS = WEEK_DAYS * 2 - 1;
+/** Two full weeks, because the review is a comparison and one week compares to nothing. */
+const READY_DAYS = 14;
+const SECONDS_PER_HOUR = 3600;
+const SECONDS_PER_MINUTE = 60;
+function round(value, places = 1) {
+    const factor = 10 ** places;
+    return Math.round(value * factor) / factor;
+}
+function directionFor(delta, threshold) {
+    if (delta === null) {
+        return "unknown";
+    }
+    if (Math.abs(delta) < threshold) {
+        return "flat";
+    }
+    return delta > 0 ? "up" : "down";
+}
+/**
+ * Splits a series into this week and the week before by date rather than by
+ * position. Position slicing silently misaligns the moment a day is missing --
+ * fourteen points is not necessarily fourteen consecutive days, and on this
+ * store it usually is not.
+ */
+function weekHalves(input, kind) {
+    const today = input.now.startOf("day");
+    const cutoff = today.minus({ days: WEEK_DAYS }).toISODate() ?? "";
+    const points = input.series(kind, COMPARISON_DAYS);
+    const current = [];
+    const previous = [];
+    for (const point of points) {
+        if (point.date > cutoff) {
+            current.push(point.value);
+        }
+        else {
+            previous.push(point.value);
+        }
+    }
+    return { current, previous };
+}
+function metricFrom(key, label, unit, current, previous, options) {
+    const scale = options.scale ?? 1;
+    const places = options.places ?? 1;
+    const currentValue = median(current);
+    const previousValue = median(previous);
+    const scaled = currentValue === null ? null : round(currentValue / scale, places);
+    const scaledPrevious = previousValue === null ? null : round(previousValue / scale, places);
+    const delta = scaled === null || scaledPrevious === null ? null : round(scaled - scaledPrevious, places);
+    return {
+        key,
+        label,
+        unit,
+        current: scaled,
+        previous: scaledPrevious,
+        delta,
+        direction: directionFor(delta, options.notableDelta),
+        notable: delta !== null && Math.abs(delta) >= options.notableDelta,
+    };
+}
+export function buildWeekReview(input) {
+    const today = input.now.startOf("day");
+    const start = today.minus({ days: WEEK_DAYS - 1 }).toISODate() ?? "";
+    const end = today.toISODate() ?? "";
+    const cutoff = today.minus({ days: WEEK_DAYS }).toISODate() ?? "";
+    const activities = input.activities(COMPARISON_DAYS);
+    const thisWeek = activities.filter((activity) => activity.date > cutoff);
+    const lastWeek = activities.filter((activity) => activity.date <= cutoff);
+    const movingSeconds = (list) => list.reduce((total, activity) => total + (activity.durationSeconds ?? 0), 0);
+    const sleep = weekHalves(input, "sleep_seconds");
+    const restingHr = weekHalves(input, "resting_hr");
+    const hrv = weekHalves(input, "hrv_overnight");
+    const stress = weekHalves(input, "stress_avg");
+    const metrics = [
+        metricFrom("sleep", "Sleep", "h", sleep.current, sleep.previous, {
+            scale: SECONDS_PER_HOUR,
+            notableDelta: 0.5,
+        }),
+        metricFrom("resting_hr", "Resting HR", "bpm", restingHr.current, restingHr.previous, {
+            places: 0,
+            notableDelta: 2,
+        }),
+        metricFrom("hrv", "HRV", "ms", hrv.current, hrv.previous, {
+            places: 0,
+            notableDelta: 5,
+        }),
+        metricFrom("stress", "Stress", "", stress.current, stress.previous, {
+            places: 0,
+            notableDelta: 5,
+        }),
+    ];
+    // Load gets its own line: it is a sum over the week, not a typical day, so
+    // taking a median of it the way the wellness metrics are taken would be
+    // meaningless.
+    const profile = estimateHrProfile(input.series("resting_hr", WEEK_DAYS * 4), input.series("max_hr", WEEK_DAYS * 4));
+    if (profile) {
+        const byDay = dailyTrimp(activities, profile);
+        const sumWindow = (fromDaysAgo) => {
+            let total = 0;
+            for (let offset = fromDaysAgo; offset < fromDaysAgo + WEEK_DAYS; offset += 1) {
+                const date = today.minus({ days: offset }).toISODate();
+                if (date) {
+                    total += byDay.get(date) ?? 0;
+                }
+            }
+            return total;
+        };
+        const currentLoad = Math.round(sumWindow(0));
+        const previousLoad = Math.round(sumWindow(WEEK_DAYS));
+        const delta = currentLoad - previousLoad;
+        metrics.unshift({
+            key: "load",
+            label: "Load",
+            unit: "TRIMP",
+            current: currentLoad,
+            previous: previousLoad,
+            delta,
+            direction: directionFor(delta, Math.max(20, previousLoad * 0.15)),
+            notable: Math.abs(delta) >= Math.max(20, previousLoad * 0.15),
+        });
+    }
+    // Deliberately NOT narrowed to COMPARISON_DAYS along with the windows above.
+    // `ready` needs READY_DAYS recorded days, and over a fourteen-day span that
+    // would mean fourteen out of fourteen -- no missing day allowed, on a store
+    // where a day only gets a row when the watch was worn. Tightening that is a
+    // change to what "enough history" means, not a fix to the seven-versus-eight
+    // comparison, and it belongs in its own change with its own argument.
+    const coverageDays = Math.max(input.series("resting_hr", WEEK_DAYS * 2).length, input.series("sleep_seconds", WEEK_DAYS * 2).length);
+    const ready = coverageDays >= READY_DAYS;
+    const forecast = forecastLoad(input);
+    const sleepQuality = analyseSleep(input);
+    const notable = metrics.filter((metric) => metric.notable);
+    const headline = !ready
+        ? `Only ${coverageDays} of the last 14 days are recorded, so this week cannot be compared to last week yet.`
+        : notable.length === 0
+            ? `${thisWeek.length} session${thisWeek.length === 1 ? "" : "s"} this week, and nothing moved much against last week.`
+            : `${thisWeek.length} session${thisWeek.length === 1 ? "" : "s"} this week. ` +
+                notable
+                    .map((metric) => `${metric.label} ${metric.direction === "up" ? "up" : "down"} ${Math.abs(metric.delta ?? 0)}${metric.unit}`)
+                    .join(", ") +
+                " versus last week.";
+    return {
+        start,
+        end,
+        ready,
+        sessions: thisWeek.length,
+        previousSessions: lastWeek.length,
+        movingMinutes: Math.round(movingSeconds(thisWeek) / SECONDS_PER_MINUTE),
+        previousMovingMinutes: Math.round(movingSeconds(lastWeek) / SECONDS_PER_MINUTE),
+        metrics,
+        forecast,
+        sleep: sleepQuality,
+        headline,
+    };
+}
+//# sourceMappingURL=week.js.map