trainbud 0.5.0

package/dist/dashboardData.js

@@ -0,0 +1,228 @@
+import { DateTime } from "luxon";
+import { getPendingPairings } from "./pairApi.js";
+import { activeContext, upcomingContext } from "./history/context.js";
+import { appConfig } from "./config.js";
+import { isAiConfigured, getCachedDailyInsight } from "./promptApi.js";
+import { getMetricSeries } from "./history/store.js";
+import { buildDetectorInput, describeFindingsCoverage, runDetectors } from "./detect/index.js";
+import { buildWeekReview } from "./detect/week.js";
+import { nextRace } from "./detect/countdown.js";
+import { median } from "./detect/baseline.js";
+import { getProfile, stateFor } from "./profile.js";
+import { budgetState, dailyAiSpend, featureCounts, monthToDateSpend, } from "./usage.js";
+import { densify } from "./dashboardCharts.js";
+// SECTION: Dashboard data
+//
+// Everything the dashboard draws, assembled from local SQLite and nothing else.
+//
+// That is a deliberate constraint, not a shortcut. The old page needed no data
+// beyond a pairing list, so nobody had to decide; a training dashboard could
+// easily have reached for the same six Garmin calls the watch makes, and the
+// page would then take as long to paint as Connect takes to answer, fail when
+// the session expires, and spend rate limit on every refresh. Every number
+// below is already in the history store, which is the whole reason the memory
+// layer exists.
+//
+// The one number that is NOT here is the recovery score, because Garmin
+// computes it and never stores it. Rather than block the page on one call, the
+// dashboard shows what this machine actually knows -- which is also the half
+// Connect itself cannot show the user, since it does not compare anything to
+// their own baseline.
+const TREND_DAYS = 30;
+function seriesFor(kind, days, transform) {
+    const today = DateTime.local();
+    const start = today.minus({ days: days - 1 }).toISODate() ?? "";
+    const end = today.toISODate() ?? "";
+    const raw = getMetricSeries(kind, start, end).map((point) => ({
+        date: point.date,
+        value: transform ? transform(point.value) : point.value,
+    }));
+    const values = raw.map((point) => point.value);
+    return {
+        points: densify(raw, days, today),
+        // A median, not a mean: one unrecorded-looking outlier should not move the
+        // line the user is being compared against.
+        baseline: median(values),
+        unit: "",
+    };
+}
+function round(value, places = 1) {
+    const factor = 10 ** places;
+    return Math.round(value * factor) / factor;
+}
+/** The newest measured value in a densified series, or null. */
+function latest(points) {
+    return latestPoint(points)?.value ?? null;
+}
+/** The newest measured point, with its date, or null. */
+function latestPoint(points) {
+    for (let i = points.length - 1; i >= 0; i -= 1) {
+        const point = points[i];
+        if (point && point.value !== null && point.value !== undefined) {
+            return { date: point.date, value: point.value };
+        }
+    }
+    return null;
+}
+/**
+ * What to call the most recent night.
+ *
+ * "Last night" is a claim about a date, and the store's newest night is only
+ * last night if it was recorded. Read at two in the morning the newest row is
+ * the night BEFORE last, and the tile said "Last night" over it -- the same
+ * fault as the sleep card calling a fortnight-old night "last night", which
+ * this project has already fixed once on the watch.
+ */
+export function nightLabel(date, today = DateTime.local()) {
+    if (date === null) {
+        return "Last night";
+    }
+    const recorded = DateTime.fromISO(date).startOf("day");
+    const yesterday = today.startOf("day").minus({ days: 1 });
+    if (!recorded.isValid || recorded >= yesterday) {
+        return "Last night";
+    }
+    return `Night of ${recorded.toFormat("d LLL")}`;
+}
+/**
+ * The four tiles.
+ *
+ * Every one of them carries a comparison, because the number on its own is
+ * what Connect already shows on the same wrist. "58 bpm" is a fact; "58 bpm,
+ * 2 above your 30-day median" is the only version that tells the user
+ * anything they could act on.
+ */
+function buildTiles(profile, trends, hrv) {
+    const tiles = [];
+    const sleepPoint = latestPoint(trends.sleep.points);
+    const sleep = sleepPoint?.value ?? null;
+    tiles.push({
+        key: "sleep",
+        label: nightLabel(sleepPoint?.date ?? null),
+        value: sleep === null ? "—" : `${round(sleep)} h`,
+        note: trends.sleep.baseline === null || sleep === null
+            ? null
+            : `${sleep >= trends.sleep.baseline ? "+" : ""}${round(sleep - trends.sleep.baseline)} h vs your usual`,
+        state: stateFor("sleepHours", sleep, profile),
+    });
+    const rhr = latest(trends.restingHr.points);
+    const rhrDelta = rhr === null || trends.restingHr.baseline === null ? null : round(rhr - trends.restingHr.baseline);
+    tiles.push({
+        key: "resting_hr",
+        label: "Resting HR",
+        value: rhr === null ? "—" : `${Math.round(rhr)} bpm`,
+        note: rhrDelta === null ? null : `${rhrDelta >= 0 ? "+" : ""}${rhrDelta} vs your median`,
+        // Graded on the distance from this person's own median, never the rate.
+        state: stateFor("restingHrDelta", rhrDelta, profile),
+    });
+    const stress = latest(trends.stress.points);
+    tiles.push({
+        key: "stress",
+        label: "Stress",
+        value: stress === null ? "—" : String(Math.round(stress)),
+        note: trends.stress.baseline === null || stress === null
+            ? null
+            : `median ${Math.round(trends.stress.baseline)}`,
+        state: stateFor("stress", stress, profile),
+    });
+    const hrvNow = latest(hrv.points);
+    tiles.push({
+        key: "hrv",
+        label: "HRV",
+        value: hrvNow === null ? "—" : `${Math.round(hrvNow)} ms`,
+        note: hrv.baseline === null || hrvNow === null ? null : `median ${Math.round(hrv.baseline)}`,
+        // HRV has no user-facing band: it is meaningful only as a trend, and a
+        // green or red HRV number would be a claim this product cannot support.
+        state: "unknown",
+    });
+    return tiles;
+}
+export function getDashboardStatus(publicUrl) {
+    const now = Math.floor(Date.now() / 1000);
+    const today = DateTime.local().toISODate() ?? "";
+    return {
+        pending: getPendingPairings().map((token) => ({
+            code: token.code,
+            expires_in: Math.max(0, token.expires_at - now),
+        })),
+        ai_configured: isAiConfigured(),
+        insight: getCachedDailyInsight(),
+        public_url: publicUrl ?? appConfig.publicUrl,
+        context: [...activeContext(today), ...upcomingContext(today)].map((entry) => ({
+            id: entry.id,
+            kind: entry.kind,
+            text: entry.text,
+            effective_from: entry.effectiveFrom,
+            effective_to: entry.effectiveTo,
+        })),
+    };
+}
+export function getDashboardData(publicUrl) {
+    const status = getDashboardStatus(publicUrl);
+    const profile = getProfile();
+    const today = DateTime.local().toISODate() ?? "";
+    const detection = runDetectors();
+    const coverage = describeFindingsCoverage(detection.coverage);
+    const trends = {
+        restingHr: { ...seriesFor("resting_hr", TREND_DAYS), unit: " bpm" },
+        sleep: { ...seriesFor("sleep_seconds", TREND_DAYS, (value) => value / 3600), unit: " h" },
+        stress: { ...seriesFor("stress_avg", TREND_DAYS), unit: "" },
+    };
+    const hrv = seriesFor("hrv_overnight", TREND_DAYS);
+    const review = buildWeekReview(buildDetectorInput());
+    const rows = [
+        { label: "Sessions", unit: "", current: review.sessions, previous: review.previousSessions },
+        {
+            label: "Moving",
+            unit: " min",
+            current: review.movingMinutes,
+            previous: review.previousMovingMinutes,
+        },
+        ...review.metrics.map((metric) => ({
+            label: metric.label,
+            unit: metric.unit === "TRIMP" ? "" : metric.unit,
+            current: metric.current,
+            previous: metric.previous,
+        })),
+    ];
+    const race = nextRace([...activeContext(today), ...upcomingContext(today)], today);
+    return {
+        ...status,
+        profile,
+        tiles: buildTiles(profile, trends, hrv),
+        findings: detection.findings.map((finding) => ({
+            severity: finding.severity,
+            headline: finding.headline,
+            detail: finding.detail,
+        })),
+        // An empty findings list means two opposite things, and the page has to say
+        // which. "Nothing stands out" is a clean bill of health; "the record stops
+        // three weeks ago" is a claim about days nobody measured.
+        coverageNote: coverage.state === "ready"
+            ? null
+            : coverage.fix
+                ? `${coverage.detail} ${coverage.fix}`
+                : coverage.detail,
+        coverageDays: detection.coverage.days,
+        coverageThrough: detection.coverage.throughDate,
+        week: {
+            ready: review.ready,
+            headline: review.headline,
+            rows,
+            forecastRatio: review.forecast.projectedRatio,
+            forecastVerdict: review.forecast.verdict,
+            sleepDebtHours: review.sleep.debtHours,
+        },
+        trends,
+        race: race ? { text: race.text, daysAway: race.daysAway, phase: race.phase } : null,
+        usage: {
+            month: monthToDateSpend(),
+            budget: budgetState(),
+            daily: dailyAiSpend(TREND_DAYS),
+            features: featureCounts(TREND_DAYS),
+        },
+    };
+}
+/** Tests only. */
+export const __nightLabelForTests = nightLabel;
+//# sourceMappingURL=dashboardData.js.map

package/dist/dashboardData.js.map

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

package/dist/detect/baseline.d.ts

@@ -0,0 +1,17 @@
+import type { MetricPoint } from "../history/store.js";
+export interface Baseline {
+    median: number;
+    mad: number;
+    count: number;
+}
+export declare function median(values: number[]): number | null;
+export declare function buildBaseline(points: MetricPoint[], minimumCount?: number): Baseline | null;
+/**
+ * Returns null when the series never varies. A MAD of zero divides to Infinity,
+ * which compares true against every threshold and would fire every detector at
+ * once on the most stable data in the store -- the exact opposite of what the
+ * data says.
+ */
+export declare function robustZ(value: number, baseline: Baseline): number | null;
+export declare function meanOf(points: MetricPoint[]): number | null;
+//# sourceMappingURL=baseline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../src/detect/baseline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAoBvD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CActD;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,YAAY,SAAwB,GACnC,QAAQ,GAAG,IAAI,CAmBjB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAMxE;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,GAAG,IAAI,CAQ3D"}

package/dist/detect/baseline.js

@@ -0,0 +1,62 @@
+// SECTION: Robust baselines
+//
+// Every detector compares a recent value against the user's own history rather
+// than against a population figure, so the shape of "normal" has to come from
+// the series itself.
+//
+// Median and median-absolute-deviation, not mean and standard deviation. Both
+// of those are dragged by exactly the outlier a detector most wants to notice:
+// one 11-hour recovery sleep after a race lifts the mean and inflates the
+// deviation, so the bar rises and the next three short nights read as normal.
+// The median ignores it.
+/** Makes MAD comparable to a standard deviation for normally distributed data. */
+const MAD_TO_SIGMA = 0.6745;
+/** Two weeks is the least that describes a person rather than a fortnight's mood. */
+const DEFAULT_MINIMUM_COUNT = 14;
+export function median(values) {
+    const sorted = values.filter((value) => Number.isFinite(value)).sort((a, b) => a - b);
+    if (sorted.length === 0) {
+        return null;
+    }
+    const middle = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 1) {
+        return sorted[middle] ?? null;
+    }
+    return ((sorted[middle - 1] ?? 0) + (sorted[middle] ?? 0)) / 2;
+}
+export function buildBaseline(points, minimumCount = DEFAULT_MINIMUM_COUNT) {
+    const values = points.map((point) => point.value).filter((value) => Number.isFinite(value));
+    if (values.length < minimumCount) {
+        return null;
+    }
+    const centre = median(values);
+    if (centre === null) {
+        return null;
+    }
+    const deviations = values.map((value) => Math.abs(value - centre));
+    return {
+        median: centre,
+        mad: median(deviations) ?? 0,
+        count: values.length,
+    };
+}
+/**
+ * Returns null when the series never varies. A MAD of zero divides to Infinity,
+ * which compares true against every threshold and would fire every detector at
+ * once on the most stable data in the store -- the exact opposite of what the
+ * data says.
+ */
+export function robustZ(value, baseline) {
+    if (baseline.mad <= 0 || !Number.isFinite(value)) {
+        return null;
+    }
+    return (MAD_TO_SIGMA * (value - baseline.median)) / baseline.mad;
+}
+export function meanOf(points) {
+    const values = points.map((point) => point.value).filter((value) => Number.isFinite(value));
+    if (values.length === 0) {
+        return null;
+    }
+    return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+//# sourceMappingURL=baseline.js.map

package/dist/detect/baseline.js.map

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

package/dist/detect/countdown.d.ts

@@ -0,0 +1,30 @@
+import type { ContextEntry } from "../history/context.js";
+/** How the current week relates to the event. */
+export type RacePhase = "race_week" | "taper" | "build" | "far_out";
+export interface RaceCountdown {
+    text: string;
+    date: string;
+    daysAway: number;
+    phase: RacePhase;
+    /** Short enough for a watch card. */
+    label: string;
+}
+/**
+ * The next race on or after `today`, nearest first.
+ *
+ * A race entry's effective_from is the day of the event. Entries whose date has
+ * passed are not returned -- but they are deliberately not deleted either, so
+ * "how did the last build go" still has something to read.
+ *
+ * A race with no parseable date is skipped rather than guessed at. Showing a
+ * countdown to the wrong day is worse than showing none: the whole point of the
+ * number is that the user stops doing their own arithmetic.
+ */
+export declare function nextRace(entries: ContextEntry[], today: string): RaceCountdown | null;
+/**
+ * One sentence for the model's context. Says what the phase means for training
+ * and nothing about how the user should feel or whether they are ready --
+ * neither is knowable from a date.
+ */
+export declare function describeRace(race: RaceCountdown | null): string | null;
+//# sourceMappingURL=countdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"countdown.d.ts","sourceRoot":"","sources":["../../src/detect/countdown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAa1D,iDAAiD;AACjD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAeD;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAwCrF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAiBtE"}

package/dist/detect/countdown.js

@@ -0,0 +1,79 @@
+import { DateTime } from "luxon";
+const TAPER_DAYS = 21;
+const FAR_OUT_DAYS = 84;
+function phaseFor(daysAway) {
+    if (daysAway <= 7) {
+        return "race_week";
+    }
+    if (daysAway <= TAPER_DAYS) {
+        return "taper";
+    }
+    return daysAway <= FAR_OUT_DAYS ? "build" : "far_out";
+}
+/**
+ * The next race on or after `today`, nearest first.
+ *
+ * A race entry's effective_from is the day of the event. Entries whose date has
+ * passed are not returned -- but they are deliberately not deleted either, so
+ * "how did the last build go" still has something to read.
+ *
+ * A race with no parseable date is skipped rather than guessed at. Showing a
+ * countdown to the wrong day is worse than showing none: the whole point of the
+ * number is that the user stops doing their own arithmetic.
+ */
+export function nextRace(entries, today) {
+    const from = DateTime.fromISO(today).startOf("day");
+    if (!from.isValid) {
+        return null;
+    }
+    let best = null;
+    for (const entry of entries) {
+        if (entry.kind !== "race") {
+            continue;
+        }
+        const date = DateTime.fromISO(entry.effectiveFrom).startOf("day");
+        if (!date.isValid) {
+            continue;
+        }
+        const daysAway = Math.round(date.diff(from, "days").days);
+        if (daysAway < 0) {
+            continue;
+        }
+        if (best === null || daysAway < best.daysAway) {
+            best = {
+                text: entry.text,
+                date: entry.effectiveFrom,
+                daysAway,
+                phase: phaseFor(daysAway),
+                label: daysAway === 0
+                    ? "Today"
+                    : daysAway === 1
+                        ? "Tomorrow"
+                        : `${daysAway} days`,
+            };
+        }
+    }
+    return best;
+}
+/**
+ * One sentence for the model's context. Says what the phase means for training
+ * and nothing about how the user should feel or whether they are ready --
+ * neither is knowable from a date.
+ */
+export function describeRace(race) {
+    if (!race) {
+        return null;
+    }
+    const lead = `${race.text} is in ${race.daysAway} day${race.daysAway === 1 ? "" : "s"} (${race.date}).`;
+    switch (race.phase) {
+        case "race_week":
+            return `${lead} This is race week: load should be coming down, and a light week is the plan rather than a lapse.`;
+        case "taper":
+            return `${lead} This is the taper window, so a falling load ratio is intended.`;
+        case "build":
+            return `${lead} Still in the build, so load should be climbing gradually rather than holding flat.`;
+        default:
+            return `${lead} Far enough out that this week's training is general rather than race-specific.`;
+    }
+}
+//# sourceMappingURL=countdown.js.map

package/dist/detect/countdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"countdown.js","sourceRoot":"","sources":["../../src/detect/countdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AA0BjC,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,SAAS,QAAQ,CAAC,QAAgB;IAChC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAuB,EAAE,KAAa;IAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAI,GAAyB,IAAI,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9C,IAAI,GAAG;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,aAAa;gBACzB,QAAQ;gBACR,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC;gBACzB,KAAK,EACH,QAAQ,KAAK,CAAC;oBACZ,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,QAAQ,KAAK,CAAC;wBACd,CAAC,CAAC,UAAU;wBACZ,CAAC,CAAC,GAAG,QAAQ,OAAO;aAC3B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAA0B;IACrD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,QAAQ,OAAO,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;IAExG,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,GAAG,IAAI,mGAAmG,CAAC;QACpH,KAAK,OAAO;YACV,OAAO,GAAG,IAAI,iEAAiE,CAAC;QAClF,KAAK,OAAO;YACV,OAAO,GAAG,IAAI,qFAAqF,CAAC;QACtG;YACE,OAAO,GAAG,IAAI,iFAAiF,CAAC;IACpG,CAAC;AACH,CAAC"}

package/dist/detect/detectors.d.ts

@@ -0,0 +1,20 @@
+import type { DetectorInput, Finding } from "./findings.js";
+/**
+ * How far this person's recent resting heart rate sits above their own median,
+ * whether or not that is far enough to be a finding.
+ *
+ * Split out because two things need it and only one of them is a threshold. The
+ * detector fires at a fixed bar; the colour on a watch card is graded against
+ * the band the user chose, which may be tighter or looser. Deriving the colour
+ * from "did a finding fire" would mean the card could only ever be green or
+ * red, and would move whenever the detector's own constants moved.
+ *
+ * Null when there is not enough history to have a baseline at all -- which is
+ * different from a delta of zero, and has to stay different.
+ */
+export declare function restingHrDeltaBpm(input: DetectorInput): number | null;
+export declare function detectRestingHrElevation(input: DetectorInput): Finding | null;
+export declare function detectSleepDebt(input: DetectorInput): Finding | null;
+export declare function detectHrvTrendBreak(input: DetectorInput): Finding | null;
+export declare function detectLoadRatio(input: DetectorInput): Finding | null;
+//# sourceMappingURL=detectors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detectors.d.ts","sourceRoot":"","sources":["../../src/detect/detectors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAiF5D;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAerE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI,CA6C7E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI,CA+DpE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI,CA6BxE;AA4CD,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI,CAiEpE"}