trainbud 0.5.0

package/dist/history/capture.js

@@ -0,0 +1,63 @@
+import fs from "node:fs";
+import path from "node:path";
+// SECTION: Fixture capture
+//
+// The stress mapper shipped broken because its test was written against a
+// payload nobody had ever received: it read `overallStressLevel`, Connect sends
+// `avgStressLevel`, and the test passed because it asserted against the same
+// invention. tests/rawApi.test.ts still carries both versions side by side as
+// the record of it.
+//
+// Detectors are far more elaborate than that mapper, so their fixtures have to
+// come off the wire. Ingest is already keeping the raw responses; this only
+// scrubs the identifiers so one can be committed.
+const REDACTION = "<redacted>";
+/**
+ * Matched case-insensitively against the key name. Identity and credentials
+ * only -- never a measurement, never a date. A fixture with its numbers
+ * redacted would be worse than the invented payload it replaces.
+ */
+export const REDACTED_KEYS = [
+    "userprofilepk",
+    "userprofileid",
+    "userid",
+    "displayname",
+    "fullname",
+    "email",
+    "ownerid",
+    "ownerdisplayname",
+    "ownerfullname",
+    "ownerprofileimageurl",
+    "devicename",
+    "deviceid",
+    "unitid",
+];
+function isRedactedKey(key) {
+    const lower = key.toLowerCase();
+    if (REDACTED_KEYS.includes(lower)) {
+        return true;
+    }
+    return lower.endsWith("token") || lower.endsWith("key") || lower.endsWith("secret");
+}
+/** Deep clone with identity fields replaced. Never mutates its input. */
+export function redactPayload(payload) {
+    if (payload === null || typeof payload !== "object") {
+        return payload;
+    }
+    if (Array.isArray(payload)) {
+        return payload.map((entry) => redactPayload(entry));
+    }
+    const redacted = {};
+    for (const [key, value] of Object.entries(payload)) {
+        redacted[key] = isRedactedKey(key) ? REDACTION : redactPayload(value);
+    }
+    return redacted;
+}
+/** Writes one redacted response to `<dir>/<source>-<date>.json`. */
+export function writeFixture(directory, source, date, payload) {
+    fs.mkdirSync(directory, { recursive: true });
+    const file = path.join(directory, `${source}-${date}.json`);
+    fs.writeFileSync(file, `${JSON.stringify(redactPayload(payload), null, 2)}\n`, "utf8");
+    return file;
+}
+//# sourceMappingURL=capture.js.map

package/dist/history/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/history/capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,2BAA2B;AAC3B,EAAE;AACF,0EAA0E;AAC1E,gFAAgF;AAChF,6EAA6E;AAC7E,8EAA8E;AAC9E,oBAAoB;AACpB,EAAE;AACF,+EAA+E;AAC/E,4EAA4E;AAC5E,kDAAkD;AAElD,MAAM,SAAS,GAAG,YAAY,CAAC;AAE/B;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,eAAe;IACf,eAAe;IACf,QAAQ;IACR,aAAa;IACb,UAAU;IACV,OAAO;IACP,SAAS;IACT,kBAAkB;IAClB,eAAe;IACf,sBAAsB;IACtB,YAAY;IACZ,UAAU;IACV,QAAQ;CACT,CAAC;AAEF,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAEhC,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACtF,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACpD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAE7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAkC,CAAC,EAAE,CAAC;QAC9E,QAAQ,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,MAAoB,EACpB,IAAY,EACZ,OAAgB;IAEhB,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,MAAM,IAAI,IAAI,OAAO,CAAC,CAAC;IAC5D,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEvF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/history/context.d.ts

@@ -0,0 +1,51 @@
+import type { ContextKind, SubjectiveKind } from "./schema.js";
+export interface ContextEntry {
+    id: number;
+    kind: ContextKind;
+    text: string;
+    effectiveFrom: string;
+    effectiveTo: string | null;
+    createdAt: number;
+}
+export interface SubjectivePoint {
+    date: string;
+    value: number;
+    note: string | null;
+}
+export interface AddContextOptions {
+    effectiveFrom?: string;
+    effectiveTo?: string;
+}
+/**
+ * Entries carry a date range rather than an is-current flag. An injury heals
+ * and a race happens, and an entry that can only ever be "current" has to be
+ * deleted to stop being true -- which loses the fact that it *was* true. "How
+ * did the last build go, when the achilles was bad" is exactly the question
+ * this layer exists to answer.
+ */
+export declare function addContextEntry(kind: ContextKind, text: string, options?: AddContextOptions): ContextEntry;
+/** Everything true on the given date, newest first. */
+export declare function activeContext(onDate: string): ContextEntry[];
+/**
+ * Entries dated after `onDate`, soonest first.
+ *
+ * activeContext deliberately excludes these: an entry is "true on a date" only
+ * from its effective_from onwards, and a race in six weeks is not a fact about
+ * today. But a future race is the single most useful piece of context this
+ * store holds — it changes what every other number means, because the same load
+ * ratio is a warning eleven weeks out and the plan three days out — and until
+ * now nothing could read one, because the only reader excluded it by design.
+ */
+export declare function upcomingContext(onDate: string): ContextEntry[];
+/** Every entry ever recorded, newest first — for a dashboard or a tool listing. */
+export declare function allContext(): ContextEntry[];
+/** Ends an entry without deleting it. Returns false if there was no such entry. */
+export declare function closeContextEntry(id: number, onDate?: string): boolean;
+/**
+ * The 1-10 scale is what makes these comparable across days, so a 0 or a 12 is
+ * a typo rather than a reading. Storing it silently would poison every average
+ * built on top.
+ */
+export declare function logSubjective(date: string, kind: SubjectiveKind, value: number, note?: string): void;
+export declare function subjectiveSeries(kind: SubjectiveKind, startDate: string, endDate: string): SubjectivePoint[];
+//# sourceMappingURL=context.d.ts.map

package/dist/history/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/history/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAS/D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAaD,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,YAAY,CAuBd;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAgB5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAe9D;AAED,mFAAmF;AACnF,wBAAgB,UAAU,IAAI,YAAY,EAAE,CAc3C;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,OAAO,CAM/E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,CAiBN;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,eAAe,EAAE,CAQnB"}

package/dist/history/context.js

@@ -0,0 +1,122 @@
+import { DateTime } from "luxon";
+import { getHistoryDb } from "./store.js";
+const SUBJECTIVE_MIN = 1;
+const SUBJECTIVE_MAX = 10;
+function nowSeconds() {
+    return Math.floor(Date.now() / 1000);
+}
+function today() {
+    return DateTime.local().toISODate() ?? "";
+}
+/**
+ * Entries carry a date range rather than an is-current flag. An injury heals
+ * and a race happens, and an entry that can only ever be "current" has to be
+ * deleted to stop being true -- which loses the fact that it *was* true. "How
+ * did the last build go, when the achilles was bad" is exactly the question
+ * this layer exists to answer.
+ */
+export function addContextEntry(kind, text, options = {}) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0) {
+        throw new Error("Context entry text cannot be empty.");
+    }
+    const entry = {
+        kind,
+        text: trimmed,
+        effectiveFrom: options.effectiveFrom ?? today(),
+        effectiveTo: options.effectiveTo ?? null,
+        createdAt: nowSeconds(),
+    };
+    const result = getHistoryDb()
+        .prepare(`INSERT INTO context_entry (kind, text, effective_from, effective_to, created_at)
+       VALUES (?, ?, ?, ?, ?)`)
+        .run(entry.kind, entry.text, entry.effectiveFrom, entry.effectiveTo, entry.createdAt);
+    return { id: Number(result.lastInsertRowid), ...entry };
+}
+/** Everything true on the given date, newest first. */
+export function activeContext(onDate) {
+    return getHistoryDb()
+        .prepare(`SELECT
+         id,
+         kind,
+         text,
+         effective_from AS effectiveFrom,
+         effective_to   AS effectiveTo,
+         created_at     AS createdAt
+       FROM context_entry
+       WHERE effective_from <= ?
+         AND (effective_to IS NULL OR effective_to > ?)
+       ORDER BY effective_from DESC, id DESC`)
+        .all(onDate, onDate);
+}
+/**
+ * Entries dated after `onDate`, soonest first.
+ *
+ * activeContext deliberately excludes these: an entry is "true on a date" only
+ * from its effective_from onwards, and a race in six weeks is not a fact about
+ * today. But a future race is the single most useful piece of context this
+ * store holds — it changes what every other number means, because the same load
+ * ratio is a warning eleven weeks out and the plan three days out — and until
+ * now nothing could read one, because the only reader excluded it by design.
+ */
+export function upcomingContext(onDate) {
+    return getHistoryDb()
+        .prepare(`SELECT
+         id,
+         kind,
+         text,
+         effective_from AS effectiveFrom,
+         effective_to   AS effectiveTo,
+         created_at     AS createdAt
+       FROM context_entry
+       WHERE effective_from > ?
+       ORDER BY effective_from ASC, id ASC`)
+        .all(onDate);
+}
+/** Every entry ever recorded, newest first — for a dashboard or a tool listing. */
+export function allContext() {
+    return getHistoryDb()
+        .prepare(`SELECT
+         id,
+         kind,
+         text,
+         effective_from AS effectiveFrom,
+         effective_to   AS effectiveTo,
+         created_at     AS createdAt
+       FROM context_entry
+       ORDER BY effective_from DESC, id DESC`)
+        .all();
+}
+/** Ends an entry without deleting it. Returns false if there was no such entry. */
+export function closeContextEntry(id, onDate = today()) {
+    const result = getHistoryDb()
+        .prepare("UPDATE context_entry SET effective_to = ? WHERE id = ?")
+        .run(onDate, id);
+    return result.changes > 0;
+}
+/**
+ * The 1-10 scale is what makes these comparable across days, so a 0 or a 12 is
+ * a typo rather than a reading. Storing it silently would poison every average
+ * built on top.
+ */
+export function logSubjective(date, kind, value, note) {
+    if (!Number.isFinite(value) || value < SUBJECTIVE_MIN || value > SUBJECTIVE_MAX) {
+        throw new Error(`A ${kind} rating must be a number between ${SUBJECTIVE_MIN} and ${SUBJECTIVE_MAX}.`);
+    }
+    getHistoryDb()
+        .prepare(`INSERT INTO subjective (date, kind, value, note, created_at)
+       VALUES (?, ?, ?, ?, ?)
+       ON CONFLICT(date, kind) DO UPDATE SET
+         value = excluded.value,
+         note = excluded.note,
+         created_at = excluded.created_at`)
+        .run(date, kind, value, note?.trim() || null, nowSeconds());
+}
+export function subjectiveSeries(kind, startDate, endDate) {
+    return getHistoryDb()
+        .prepare(`SELECT date, value, note FROM subjective
+       WHERE kind = ? AND date >= ? AND date <= ?
+       ORDER BY date ASC`)
+        .all(kind, startDate, endDate);
+}
+//# sourceMappingURL=context.js.map

package/dist/history/context.js.map

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

package/dist/history/fallback.d.ts

@@ -0,0 +1,72 @@
+import type { DayFetchResult } from "../garmin/partial.js";
+import type { ActivitySummary } from "../garmin/types.js";
+import type { IngestSource, MetricKind } from "./schema.js";
+/** Where the days in an answer came from. Additive; the watch ignores it. */
+export interface StoredFallbackInfo {
+    /** How many days in the answer came from the local store, not from Garmin. */
+    storedDays: number;
+    /** Newest date the stored part covers, so a reader can say how old it is. */
+    storedThrough: string | null;
+    /**
+     * True when the days returned are NOT the days asked about.
+     *
+     * Every tool's window is anchored to today. With the record ending
+     * 2026-08-21 and Garmin unreachable on 2026-09-03, "the last 7 nights"
+     * selects seven days the store has no row for, so the fallback found nothing
+     * and the tool reported an absence -- with seventy nights in the table. The
+     * window moves to the newest days on record instead, and this flag is what
+     * forces every renderer to say so. A reader that ignored it would present
+     * a fortnight-old week as this week, which is a worse failure than the one
+     * being fixed.
+     */
+    storedWindowMoved: boolean;
+}
+export interface FallbackResult<T> extends DayFetchResult<T>, StoredFallbackInfo {
+}
+export interface FallbackOptions<T> {
+    /** The days asked about, in the order the caller wants them back. */
+    dates: Date[];
+    source: IngestSource;
+    /** The live fetch. May reject; that is the case this exists for. */
+    live: () => Promise<DayFetchResult<T>>;
+    /** The live mapper, re-run over an archived response. */
+    fromRaw: (date: Date, payload: unknown) => T | null;
+    /** Thin reconstruction for a day older than the raw archive. */
+    fromMetrics?: (date: string, metrics: Map<MetricKind, number>) => T | null;
+    /**
+     * The date a value belongs to. Usually the day asked about; for VO2 max it is
+     * the day the measurement was actually taken, which is what collapses one
+     * reading returned for thirty requested days into one entry.
+     */
+    dateOf: (value: T) => string;
+}
+/** The newest archived response for a day, or null when none was kept. */
+export declare function storedRawPayload(date: string, source: IngestSource): unknown;
+export declare function fetchDaysOrStore<T>(options: FallbackOptions<T>): Promise<FallbackResult<T>>;
+/**
+ * A value that leans on the store is cached briefly, not for the full TTL.
+ *
+ * A stored answer is correct and it is also a symptom: the connection is down.
+ * Freezing it in for two hours would keep serving yesterday's record for two
+ * hours after the tunnel came back.
+ */
+export declare function isPartialOrStored(result: {
+    unreachableDays: number;
+    storedDays: number;
+}): boolean;
+/**
+ * The one sentence that keeps three different facts apart: nothing was
+ * recorded, nothing could be fetched, and this came from our own record rather
+ * than from Connect just now.
+ *
+ * The third is the one that matters. "No sleep data found for the last 7
+ * nights" is an assertion about the user's life, and it was being produced by a
+ * failed login on top of a store holding ten weeks of nights.
+ */
+export declare function storedFetchNote(result: DayFetchResult<unknown> & StoredFallbackInfo, noun: string): string;
+/**
+ * Activities are not addressed by date upstream -- they are a paged list -- so
+ * they get their own reader rather than going through `fetchDaysOrStore`.
+ */
+export declare function storedActivitiesBetween(startDate: string, endDate: string): ActivitySummary[];
+//# sourceMappingURL=fallback.d.ts.map

package/dist/history/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/history/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAuC5D,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;;;;;;;;OAWG;IACH,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC,EAAE,kBAAkB;CAAG;AAEnF,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,qEAAqE;IACrE,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,oEAAoE;IACpE,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,yDAAyD;IACzD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,KAAK,CAAC,GAAG,IAAI,CAAC;IACpD,gEAAgE;IAChE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC3E;;;;OAIG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;CAC9B;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAgB5E;AAyBD,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CA6F5B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAEV;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,kBAAkB,EACpD,IAAI,EAAE,MAAM,GACX,MAAM,CA6BR;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,eAAe,EAAE,CAgBnB"}

package/dist/history/fallback.js

@@ -0,0 +1,185 @@
+import { partialFetchNote } from "../garmin/partial.js";
+import { formatIsoDate, parseIsoDate } from "../utils/helpers.js";
+import { logger } from "../utils/logger.js";
+import { getActivitiesBetween, getMetricsOn, newestStoredDates, rawPayloadRevisions, } from "./store.js";
+/** The newest archived response for a day, or null when none was kept. */
+export function storedRawPayload(date, source) {
+    const revisions = rawPayloadRevisions(date, source);
+    const newest = revisions.at(-1);
+    if (!newest) {
+        return null;
+    }
+    try {
+        return JSON.parse(newest.json);
+    }
+    catch (error) {
+        // An archive row that will not parse is a corrupt row, not an answer.
+        // Recorded rather than swallowed: this is the class of fault that spent a
+        // session being reported as "no public URL is configured".
+        logger.warn({ err: error, date, source }, "Archived payload could not be parsed");
+        return null;
+    }
+}
+function readStoredDay(date, jsDate, options) {
+    const raw = storedRawPayload(date, options.source);
+    if (raw !== null) {
+        const mapped = options.fromRaw(jsDate, raw);
+        if (mapped !== null) {
+            return mapped;
+        }
+    }
+    if (!options.fromMetrics) {
+        return null;
+    }
+    const metrics = getMetricsOn(date);
+    return metrics.size > 0 ? options.fromMetrics(date, metrics) : null;
+}
+function sortNewestFirst(byDate) {
+    return Array.from(byDate.entries())
+        .sort(([left], [right]) => right.localeCompare(left))
+        .map(([, value]) => value);
+}
+export async function fetchDaysOrStore(options) {
+    const requestedDays = options.dates.length;
+    let live;
+    let liveFailed = false;
+    try {
+        live = await options.live();
+    }
+    catch (error) {
+        liveFailed = true;
+        // The whole call failed rather than a day inside it: no session, a login
+        // rate limit, no network. Every day is unreachable, which is exactly the
+        // state the store was built for. The error is not rethrown -- it used to
+        // reach the MCP client as a tool error, and a tool error is what a model
+        // reports as "I cannot access your data".
+        logger.info({ err: error, source: options.source, days: requestedDays }, "Live fetch failed; answering from the stored history");
+        live = { values: [], unreachableDays: requestedDays, requestedDays };
+    }
+    if (live.unreachableDays === 0) {
+        return { ...live, storedDays: 0, storedThrough: null, storedWindowMoved: false };
+    }
+    const byDate = new Map();
+    for (const value of live.values) {
+        byDate.set(options.dateOf(value), value);
+    }
+    const storedDates = [];
+    for (const jsDate of options.dates) {
+        const date = formatIsoDate(jsDate);
+        if (byDate.has(date)) {
+            continue;
+        }
+        const stored = readStoredDay(date, jsDate, options);
+        if (stored === null) {
+            continue;
+        }
+        // Keyed by the value's own date rather than by the date asked about, so a
+        // reading that answers for many requested days lands once.
+        const key = options.dateOf(stored);
+        if (byDate.has(key)) {
+            continue;
+        }
+        byDate.set(key, stored);
+        storedDates.push(key);
+    }
+    let values = sortNewestFirst(byDate);
+    // Nothing anywhere for the days asked about, and the live call is down: the
+    // window is pointing at days that were never recorded. Move it to the newest
+    // days the store does hold rather than reporting an absence.
+    let storedWindowMoved = false;
+    if (values.length === 0 && liveFailed) {
+        for (const date of newestStoredDates(options.source, requestedDays)) {
+            const stored = readStoredDay(date, parseIsoDate(date), options);
+            if (stored === null) {
+                continue;
+            }
+            const key = options.dateOf(stored);
+            if (byDate.has(key)) {
+                continue;
+            }
+            byDate.set(key, stored);
+            storedDates.push(key);
+            storedWindowMoved = true;
+        }
+        values = sortNewestFirst(byDate);
+    }
+    return {
+        values,
+        // Days the store could not answer either. A day covered from the archive is
+        // no longer unreachable, and reporting it as such would put the sentence
+        // "could not be fetched" next to the figures it just fetched. A moved
+        // window answers none of the days asked about, so all of them stay counted.
+        unreachableDays: storedWindowMoved
+            ? live.unreachableDays
+            : Math.max(0, live.unreachableDays - storedDates.length),
+        requestedDays,
+        storedDays: storedDates.length,
+        storedThrough: storedDates.length > 0 ? (storedDates.slice().sort().at(-1) ?? null) : null,
+        storedWindowMoved,
+    };
+}
+/**
+ * A value that leans on the store is cached briefly, not for the full TTL.
+ *
+ * A stored answer is correct and it is also a symptom: the connection is down.
+ * Freezing it in for two hours would keep serving yesterday's record for two
+ * hours after the tunnel came back.
+ */
+export function isPartialOrStored(result) {
+    return result.unreachableDays > 0 || result.storedDays > 0;
+}
+/**
+ * The one sentence that keeps three different facts apart: nothing was
+ * recorded, nothing could be fetched, and this came from our own record rather
+ * than from Connect just now.
+ *
+ * The third is the one that matters. "No sleep data found for the last 7
+ * nights" is an assertion about the user's life, and it was being produced by a
+ * failed login on top of a store holding ten weeks of nights.
+ */
+export function storedFetchNote(result, noun) {
+    if (result.storedDays === 0) {
+        return partialFetchNote(result, noun);
+    }
+    const through = result.storedThrough ?? "an earlier date";
+    const liveDays = result.values.length - result.storedDays;
+    // The window moved. This has to be unmissable: the dates below are NOT the
+    // dates asked about, and a reader that assumed otherwise would describe a
+    // fortnight-old week as this week.
+    if (result.storedWindowMoved) {
+        return [
+            `Garmin could not be reached, and TrainBud's record holds nothing at all for the last ${result.requestedDays} ${noun}.`,
+            `THESE ARE NOT THE LAST ${result.requestedDays} ${noun.toUpperCase()}. They are the ${result.storedDays} most recent ${noun} on record, ending ${through}.`,
+            `Every date is given below; use them. Say which period this describes, and that the record stops at ${through} because the connection is down — not because there is no data about this user.`,
+        ].join(" ");
+    }
+    const stored = liveDays > 0
+        ? `Note: Garmin could not be reached for ${result.storedDays} of ${result.requestedDays} ${noun}, so those came from TrainBud's own stored history (through ${through}). They are measurements previously fetched, not estimates.`
+        : `Garmin could not be reached just now, so these ${result.storedDays} ${noun} come from TrainBud's own stored history, through ${through}. These are real measurements previously fetched from Connect — this is a connection problem, not an absence of data about this user.`;
+    if (result.unreachableDays === 0) {
+        return stored;
+    }
+    return `${stored} ${result.unreachableDays} of the ${result.requestedDays} ${noun} asked about are in neither place.`;
+}
+/**
+ * Activities are not addressed by date upstream -- they are a paged list -- so
+ * they get their own reader rather than going through `fetchDaysOrStore`.
+ */
+export function storedActivitiesBetween(startDate, endDate) {
+    return getActivitiesBetween(startDate, endDate)
+        .map((row) => ({
+        activityId: row.activityId,
+        name: row.name,
+        type: row.type,
+        startTimeLocal: row.startTimeLocal,
+        distanceMeters: row.distanceMeters,
+        durationSeconds: row.durationSeconds,
+        averageHeartRate: row.avgHr,
+        maxHeartRate: row.maxHr,
+        elevationGainMeters: row.elevationGainMeters,
+        calories: row.calories,
+        averageSpeedMps: row.averageSpeedMps,
+    }))
+        .sort((left, right) => right.startTimeLocal.localeCompare(left.startTimeLocal));
+}
+//# sourceMappingURL=fallback.js.map

package/dist/history/fallback.js.map

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

package/dist/history/ingest.d.ts

@@ -0,0 +1,44 @@
+import { DateTime } from "luxon";
+import type { GarminConnectInstance } from "../garmin/garminConnect.js";
+import type { IngestOutcome, IngestSource } from "./schema.js";
+/** The sources a full run covers. Exported so no caller keeps its own copy. */
+export declare const DEFAULT_SOURCES: IngestSource[];
+export interface IngestOptions {
+    days?: number;
+    delayMs?: number;
+    sources?: IngestSource[];
+    now?: DateTime;
+    signal?: AbortSignal;
+    onProgress?: (progress: IngestProgress) => void;
+    /** Write each redacted response here, for use as a test fixture. */
+    captureDir?: string;
+    /** Abandon a source after this many consecutive empty days. 0 disables. */
+    stopAfterEmptyDays?: number;
+}
+export interface IngestProgress {
+    date: string;
+    source: IngestSource;
+    outcome: IngestOutcome;
+    done: number;
+    total: number;
+}
+export interface IngestResult {
+    fetched: number;
+    skipped: number;
+    errors: number;
+    firstDate: string | null;
+    lastDate: string | null;
+    /**
+     * Set when the run stopped early because the upstream asked it to. The days
+     * not reached are counted in `skipped` and are deliberately not checkpointed,
+     * so the next run picks them up.
+     */
+    stoppedBy?: "rate_limit";
+}
+export interface IngestUnit {
+    date: string;
+    source: IngestSource;
+}
+export declare function pendingWork(options?: IngestOptions): IngestUnit[];
+export declare function runIngest(client: GarminConnectInstance, options?: IngestOptions): Promise<IngestResult>;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/history/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/history/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAQjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAexE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AA8B3E,+EAA+E;AAC/E,eAAO,MAAM,eAAe,EAAE,YAAY,EAOzC,CAAC;AAQF,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B;AAcD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;CACtB;AAuDD,wBAAgB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,UAAU,EAAE,CAqCrE;AAkJD,wBAAsB,SAAS,CAC7B,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAuJvB"}