trainbud 0.5.0

package/dist/profile.js

@@ -0,0 +1,327 @@
+import { z } from "zod";
+import { getSetting, setSetting } from "./appDb.js";
+// The Ask menu's own limits. Imported rather than restated: a second copy of
+// "five" and "32" here would drift from the file that decides what the watch
+// draws, and the drift would look like a working setting.
+import { PROMPT_MAX_LENGTH, PROMPT_SLOTS } from "./promptSuggestions.js";
+// SECTION: Profile — everything TrainBud knows about you that Garmin does not
+//
+// Garmin measures you. It has no idea what you are training for, which units
+// you think in, which screens you care about, or what "a bad night" means for
+// your body rather than for the population. All of that lives here, in one
+// row of app.db, and every surface reads it from this module.
+//
+// Two rules hold this together.
+//
+// A corrupt or partial row must never take the server down. `getProfile` is on
+// the path of every watch fetch, every dashboard paint and several CLI
+// commands; a JSON parse error in a settings row is not a reason for any of
+// them to fail. Anything unreadable falls back to its default, field by field,
+// and the readable neighbours survive.
+//
+// Thresholds are resolved HERE and nowhere else. The watch used to carry its
+// own copies of these bands in Monkey C -- `recoveryColor`, `sleepColor`,
+// `stressColor`, `heartRateColor` -- which meant the number on the wrist and
+// the number in the browser could disagree about whether the same score was
+// good, and personalising the bands would have made that certain. The server
+// sends a resolved state; the watch maps state to colour and knows nothing
+// about where the line falls.
+/** The cards the carousel can show, in shipping order. */
+export const CARD_IDS = [
+    "today",
+    "ask",
+    "insight",
+    "week",
+    "overview",
+    "recovery",
+    "sleep",
+    "activity",
+    "stress",
+];
+/**
+ * Metrics that can be graded, and which direction is better.
+ *
+ * `restingHrDelta` is deliberately a delta rather than a rate. 58 bpm is
+ * unremarkable for one person and a warning for another; the distance from
+ * that person's own median is the only version of this number that means
+ * anything, and the detectors already compute the median.
+ */
+export const GRADED_METRICS = {
+    recovery: "higher",
+    sleepHours: "higher",
+    stress: "lower",
+    restingHrDelta: "lower",
+};
+const bandSchema = z.object({
+    good: z.number(),
+    caution: z.number(),
+});
+const thresholdsSchema = z.object({
+    recovery: bandSchema,
+    sleepHours: bandSchema,
+    stress: bandSchema,
+    restingHrDelta: bandSchema,
+});
+const profileSchema = z.object({
+    displayName: z.string().max(60).nullable(),
+    units: z.enum(["metric", "imperial"]),
+    timezone: z.string().max(64).nullable(),
+    primarySport: z
+        .enum(["running", "cycling", "swimming", "strength", "mixed"])
+        .nullable(),
+    weeklyGoal: z.object({
+        sessions: z.number().int().min(0).max(30).nullable(),
+        minutes: z.number().int().min(0).max(10_000).nullable(),
+    }),
+    thresholds: thresholdsSchema,
+    cards: z.object({
+        order: z.array(z.string()),
+        hidden: z.array(z.string()),
+    }),
+    ai: z.object({
+        tone: z.enum(["direct", "supportive", "technical"]),
+        length: z.enum(["short", "normal", "detailed"]),
+        // Constrained to models this build can price. An unpriced model would
+        // record its tokens with an unknown cost and quietly make the monthly cap
+        // unenforceable, so the choice is limited to what `usage.ts` has rates for.
+        model: z.enum(["claude-haiku-4-5", "claude-sonnet-5", "claude-opus-5"]),
+        // The Ask menu the user writes for themselves. Bounded by what the menu
+        // can show rather than by a round number: five slots, and a width the
+        // watch can draw without clipping. It shipped in 0.5.0 as `max(120)` and
+        // `max(8)` with nothing reading it, which stored questions that could not
+        // have appeared and questions that would have been cut off mid-word.
+        customPrompts: z
+            .array(z.string().trim().min(1).max(PROMPT_MAX_LENGTH))
+            .max(PROMPT_SLOTS),
+    }),
+    budget: z.object({
+        monthlyUsd: z.number().min(0).max(10_000).nullable(),
+    }),
+    analytics: z.object({
+        enabled: z.boolean(),
+    }),
+});
+/**
+ * Bands chosen to match what the watch already drew, so nobody's colours move
+ * on upgrade. They are a starting point, not a claim about physiology -- the
+ * whole reason they are editable is that the population defaults are wrong for
+ * most individuals.
+ */
+export const DEFAULT_PROFILE = {
+    displayName: null,
+    units: "metric",
+    timezone: null,
+    primarySport: null,
+    weeklyGoal: { sessions: null, minutes: null },
+    thresholds: {
+        recovery: { good: 70, caution: 50 },
+        sleepHours: { good: 7.5, caution: 6.5 },
+        stress: { good: 25, caution: 50 },
+        restingHrDelta: { good: 2, caution: 5 },
+    },
+    cards: { order: [...CARD_IDS], hidden: [] },
+    // Haiku by default: these answers are two or three sentences read on a
+    // watch, and the user pays for every one of them out of their own key.
+    ai: { tone: "direct", length: "short", model: "claude-haiku-4-5", customPrompts: [] },
+    budget: { monthlyUsd: null },
+    analytics: { enabled: true },
+};
+const PROFILE_KEY = "profile";
+let cached = null;
+/** Tests reach into the cache; nothing else should. */
+export function __resetProfileCacheForTests() {
+    cached = null;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Merge a stored value over a default, field by field, keeping whatever is
+ * readable.
+ *
+ * A whole-object `safeParse` is the wrong tool for reading storage: one bad
+ * enum in one nested object discards the twelve fields around it that were
+ * perfectly good. Writes are validated strictly (see `updateProfile`); reads
+ * salvage.
+ */
+function salvage(stored, fallback, schema) {
+    const direct = schema.safeParse(stored);
+    if (direct.success) {
+        return direct.data;
+    }
+    if (!isRecord(stored) || !isRecord(fallback)) {
+        return fallback;
+    }
+    const merged = { ...fallback };
+    for (const [key, value] of Object.entries(stored)) {
+        if (!(key in fallback)) {
+            continue;
+        }
+        const fallbackValue = fallback[key];
+        const candidate = { ...merged, [key]: value };
+        if (schema.safeParse(candidate).success) {
+            merged[key] = value;
+            continue;
+        }
+        // The field itself is bad, but it may be an object with good parts.
+        if (isRecord(value) && isRecord(fallbackValue)) {
+            const nested = { ...fallbackValue };
+            for (const [nestedKey, nestedValue] of Object.entries(value)) {
+                if (!(nestedKey in fallbackValue)) {
+                    continue;
+                }
+                const nestedCandidate = { ...merged, [key]: { ...nested, [nestedKey]: nestedValue } };
+                if (schema.safeParse(nestedCandidate).success) {
+                    nested[nestedKey] = nestedValue;
+                }
+            }
+            merged[key] = nested;
+        }
+    }
+    const result = schema.safeParse(merged);
+    return result.success ? result.data : fallback;
+}
+export function getProfile() {
+    if (cached) {
+        return cached;
+    }
+    const raw = getSetting(PROFILE_KEY);
+    if (raw === null) {
+        cached = DEFAULT_PROFILE;
+        return cached;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        // A row that is not JSON is wreckage, not configuration. Defaults are a
+        // working server; a throw here would take down every watch fetch.
+        cached = DEFAULT_PROFILE;
+        return cached;
+    }
+    cached = normalizeCards(salvage(parsed, DEFAULT_PROFILE, profileSchema));
+    return cached;
+}
+/**
+ * Put the card list back into a state the carousel can render.
+ *
+ * Unknown ids are dropped and missing ids are appended, which is what stops an
+ * older client from deleting a card it has never heard of simply by leaving it
+ * out of the order it sends.
+ */
+function normalizeCards(profile) {
+    const known = new Set(CARD_IDS);
+    const seen = new Set();
+    const order = [];
+    for (const id of profile.cards.order) {
+        if (known.has(id) && !seen.has(id)) {
+            order.push(id);
+            seen.add(id);
+        }
+    }
+    for (const id of CARD_IDS) {
+        if (!seen.has(id)) {
+            order.push(id);
+        }
+    }
+    const hidden = profile.cards.hidden.filter((id) => known.has(id));
+    return { ...profile, cards: { order, hidden } };
+}
+function deepMerge(base, patch) {
+    if (!isRecord(base) || !isRecord(patch)) {
+        return patch ?? base;
+    }
+    const out = { ...base };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === undefined) {
+            continue;
+        }
+        const current = out[key];
+        if (isRecord(value) && isRecord(current)) {
+            out[key] = deepMerge(current, value);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+export class ProfileValidationError extends Error {
+}
+/**
+ * Apply a partial change.
+ *
+ * Unlike reads, writes are strict: a caller sending a unit we do not know is a
+ * bug in that caller, and storing it would mean every later read has to
+ * salvage around it. The error names the field so the dashboard can say which
+ * input was refused.
+ */
+export function updateProfile(patch) {
+    const merged = deepMerge(getProfile(), patch);
+    const parsed = profileSchema.safeParse(merged);
+    if (!parsed.success) {
+        const issue = parsed.error.issues[0];
+        const path = issue?.path.join(".") || "profile";
+        throw new ProfileValidationError(`${path}: ${issue?.message ?? "invalid value"}`);
+    }
+    const next = parsed.data;
+    for (const id of next.cards.order) {
+        if (!CARD_IDS.includes(id)) {
+            throw new ProfileValidationError(`cards.order: unknown card "${id}"`);
+        }
+    }
+    for (const id of next.cards.hidden) {
+        if (!CARD_IDS.includes(id)) {
+            throw new ProfileValidationError(`cards.hidden: unknown card "${id}"`);
+        }
+    }
+    if (next.cards.hidden.length >= CARD_IDS.length) {
+        throw new ProfileValidationError("cards.hidden: at least one card must stay visible");
+    }
+    for (const [metric, direction] of Object.entries(GRADED_METRICS)) {
+        const band = next.thresholds[metric];
+        const ordered = direction === "higher" ? band.good > band.caution : band.good < band.caution;
+        if (!ordered) {
+            throw new ProfileValidationError(direction === "higher"
+                ? `thresholds.${metric}: good must be above caution`
+                : `thresholds.${metric}: good must be below caution`);
+        }
+    }
+    const normalized = normalizeCards(next);
+    setSetting(PROFILE_KEY, JSON.stringify(normalized));
+    cached = normalized;
+    return normalized;
+}
+/** Card ids in the user's order, with hidden ones removed. */
+export function visibleCards(profile = getProfile()) {
+    const hidden = new Set(profile.cards.hidden);
+    return profile.cards.order.filter((id) => !hidden.has(id));
+}
+/**
+ * Grade one value against this user's bands.
+ *
+ * A missing value returns `unknown`, never `hard`. An unworn watch is not a
+ * recovery score of zero, and colouring an absence red is how a UI invents a
+ * measurement it was never given.
+ */
+export function stateFor(metric, value, profile = getProfile()) {
+    if (value === null || value === undefined || !Number.isFinite(value)) {
+        return "unknown";
+    }
+    const band = profile.thresholds[metric];
+    const higherIsBetter = GRADED_METRICS[metric] === "higher";
+    if (higherIsBetter) {
+        if (value >= band.good)
+            return "good";
+        if (value >= band.caution)
+            return "caution";
+        return "hard";
+    }
+    if (value <= band.good)
+        return "good";
+    if (value <= band.caution)
+        return "caution";
+    return "hard";
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

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

package/dist/promptApi.d.ts

@@ -0,0 +1,43 @@
+import { buildWatchSummary } from "./watchApi.js";
+import { type DetectionResult } from "./detect/index.js";
+import { type ContextEntry } from "./history/context.js";
+/** True when AI features are usable, from either source. */
+export declare function isAiConfigured(): boolean;
+/**
+ * What the model is told before it writes a sentence.
+ *
+ * This used to be four current numbers, which is why the daily insight read
+ * like a horoscope: with nothing but today's figures there was nothing to say
+ * that the numbers did not already say themselves. Findings refer to things
+ * that happened -- a run of days, a deficit against a personal median -- and
+ * context says who it is happening to.
+ *
+ * Cold start is stated explicitly. Handed an empty findings list with no
+ * explanation, a model will confidently reassure the user out of no data at all.
+ */
+export declare function formatFindingsContext(result: DetectionResult, context: ContextEntry[]): string;
+export declare function formatHealthContext(summary: Awaited<ReturnType<typeof buildWatchSummary>>): string;
+export interface SubmitPromptResult {
+    job_id: string;
+}
+export declare function submitPrompt(prompt: string): SubmitPromptResult;
+export interface PromptJobStatus {
+    status: "pending" | "running" | "done" | "error";
+    result?: string;
+    error?: string;
+}
+export declare function getPromptStatus(id: string): PromptJobStatus | null;
+/**
+ * The daily insight used to be generated inline on every /api/watch request, so
+ * a cold fetch blocked the watch for a full Claude round trip and spent API
+ * credit on every sync. It is now generated once per local day and cached in the
+ * settings table.
+ */
+export declare function generateDailyInsight(summary: Awaited<ReturnType<typeof buildWatchSummary>>, options?: {
+    force?: boolean;
+}): Promise<string | null>;
+/** Returns today's cached insight without contacting the API. */
+export declare function getCachedDailyInsight(): string | null;
+/** Drops today's cached insight so the next request regenerates it. */
+export declare function clearDailyInsight(): void;
+//# sourceMappingURL=promptApi.d.ts.map

package/dist/promptApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptApi.d.ts","sourceRoot":"","sources":["../src/promptApi.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAuBxE,4DAA4D;AAC5D,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,YAAY,EAAE,GACtB,MAAM,CA0CR;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,GAAG,MAAM,CA6ElG;AA2GD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAU/D;AAwBD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAQlE;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,EACtD,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmCxB;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}