trainbud 0.5.0

package/dist/usage.js

@@ -0,0 +1,247 @@
+import { DateTime } from "luxon";
+import { getAppDb } from "./appDb.js";
+import { getProfile } from "./profile.js";
+import { logger } from "./utils/logger.js";
+/**
+ * Published per-million-token rates.
+ *
+ * Deliberately a small table of the models this product can actually be
+ * pointed at, rather than a guess at a general pricing API. A model missing
+ * from here is unpriced, and says so.
+ */
+const PRICES_PER_MTOK = {
+    "claude-haiku-4-5": { input: 1.0, output: 5.0 },
+    "claude-sonnet-5": { input: 2.0, output: 10.0 },
+    "claude-opus-5": { input: 5.0, output: 25.0 },
+};
+/** Cache reads bill at about a tenth of fresh input; writes at about 1.25x. */
+const CACHE_READ_MULTIPLIER = 0.1;
+const CACHE_WRITE_MULTIPLIER = 1.25;
+/** Cost in USD, or null when this model has no price here. */
+export function priceOf(model, tokens) {
+    const rate = PRICES_PER_MTOK[model];
+    if (!rate) {
+        return null;
+    }
+    const perToken = (perMTok) => perMTok / 1_000_000;
+    return (tokens.inputTokens * perToken(rate.input) +
+        tokens.outputTokens * perToken(rate.output) +
+        (tokens.cacheReadTokens ?? 0) * perToken(rate.input) * CACHE_READ_MULTIPLIER +
+        (tokens.cacheWriteTokens ?? 0) * perToken(rate.input) * CACHE_WRITE_MULTIPLIER);
+}
+export function recordAiUsage(input) {
+    const at = input.at ?? Math.floor(Date.now() / 1000);
+    const costUsd = priceOf(input.model, input);
+    const row = { ...input, at, costUsd };
+    try {
+        getAppDb()
+            .prepare(`INSERT INTO ai_usage
+           (at, kind, model, source, input_tokens, output_tokens,
+            cache_read_tokens, cache_write_tokens, cost_usd)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(at, input.kind, input.model, input.source, input.inputTokens, input.outputTokens, input.cacheReadTokens ?? 0, input.cacheWriteTokens ?? 0, costUsd);
+    }
+    catch (err) {
+        // Accounting must not take down the answer it was accounting for.
+        logger.warn({ err }, "could not record AI usage");
+    }
+    return row;
+}
+export function aiSpendSince(sinceUnixSeconds) {
+    try {
+        const row = getAppDb()
+            .prepare(`SELECT COUNT(*)                                   AS calls,
+                COALESCE(SUM(input_tokens), 0)             AS input_tokens,
+                COALESCE(SUM(output_tokens), 0)            AS output_tokens,
+                COALESCE(SUM(cost_usd), 0)                 AS cost_usd,
+                COALESCE(SUM(cost_usd IS NULL), 0)         AS unpriced
+           FROM ai_usage
+          WHERE at >= ?`)
+            .get(sinceUnixSeconds);
+        return {
+            calls: row.calls,
+            inputTokens: row.input_tokens,
+            outputTokens: row.output_tokens,
+            costUsd: row.cost_usd,
+            unpricedCalls: row.unpriced,
+        };
+    }
+    catch (err) {
+        logger.warn({ err }, "could not read AI usage");
+        return { calls: 0, inputTokens: 0, outputTokens: 0, costUsd: 0, unpricedCalls: 0 };
+    }
+}
+/**
+ * Spend since the first of the current month, in the user's own local time.
+ *
+ * A rolling thirty days would be a different and worse number: a monthly cap
+ * that resets on a sliding window never resets, and the user compares this
+ * against a bill that runs calendar months.
+ */
+export function monthToDateSpend() {
+    const start = DateTime.local().startOf("month").toSeconds();
+    return aiSpendSince(Math.floor(start));
+}
+export function budgetState() {
+    const cap = getProfile().budget.monthlyUsd;
+    const spend = monthToDateSpend();
+    if (cap === null) {
+        return {
+            capUsd: null,
+            spentUsd: spend.costUsd,
+            remainingUsd: null,
+            exceeded: false,
+            incomplete: spend.unpricedCalls > 0,
+        };
+    }
+    const remaining = Math.max(0, cap - spend.costUsd);
+    return {
+        capUsd: cap,
+        spentUsd: spend.costUsd,
+        remainingUsd: remaining,
+        exceeded: spend.costUsd >= cap,
+        incomplete: spend.unpricedCalls > 0,
+    };
+}
+/** Thrown when a request is refused because the user's own cap is reached. */
+export class BudgetExceededError extends Error {
+    constructor(state) {
+        super(`Monthly AI budget of $${state.capUsd?.toFixed(2)} reached ` +
+            `($${state.spentUsd.toFixed(2)} spent). Raise or clear the cap in the dashboard.`);
+    }
+}
+/** Throws when a cap is set and already reached. No cap means never throws. */
+export function assertWithinBudget() {
+    const state = budgetState();
+    if (state.exceeded) {
+        throw new BudgetExceededError(state);
+    }
+}
+/** The most recent calls, newest first — the ledger behind the total. */
+export function recentAiUsage(limit = 20) {
+    try {
+        const rows = getAppDb()
+            .prepare(`SELECT at, kind, model, source, input_tokens, output_tokens, cost_usd
+           FROM ai_usage
+          ORDER BY at DESC, id DESC
+          LIMIT ?`)
+            .all(limit);
+        return rows.map((row) => ({
+            at: row.at,
+            kind: row.kind,
+            model: row.model,
+            source: row.source,
+            inputTokens: row.input_tokens,
+            outputTokens: row.output_tokens,
+            costUsd: row.cost_usd,
+        }));
+    }
+    catch (err) {
+        logger.warn({ err }, "could not read recent AI usage");
+        return [];
+    }
+}
+/**
+ * Cost per day for the last `days` days, including the days that cost nothing.
+ *
+ * The zero days are the point. A chart built only from rows that exist draws a
+ * continuous line through a week the user never opened the app, which reads as
+ * steady daily spend rather than as the four days it actually was.
+ */
+export function dailyAiSpend(days = 30) {
+    const today = DateTime.local().startOf("day");
+    const byDay = new Map();
+    for (let i = days - 1; i >= 0; i -= 1) {
+        const day = today.minus({ days: i }).toISODate();
+        if (day) {
+            byDay.set(day, { day, costUsd: 0, calls: 0 });
+        }
+    }
+    try {
+        const since = Math.floor(today.minus({ days: days - 1 }).toSeconds());
+        const rows = getAppDb()
+            .prepare("SELECT at, cost_usd FROM ai_usage WHERE at >= ?")
+            .all(since);
+        for (const row of rows) {
+            const day = DateTime.fromSeconds(row.at).toISODate();
+            const bucket = day ? byDay.get(day) : undefined;
+            if (bucket) {
+                bucket.costUsd += row.cost_usd ?? 0;
+                bucket.calls += 1;
+            }
+        }
+    }
+    catch (err) {
+        logger.warn({ err }, "could not read daily AI spend");
+    }
+    return [...byDay.values()];
+}
+/**
+ * Count one use of one feature, today.
+ *
+ * Everything about this is best-effort. It is called from render paths and
+ * request handlers that have real work to do, and a counter that can throw is
+ * a counter that takes down the feature it was measuring.
+ */
+export function recordFeature(name) {
+    try {
+        if (!getProfile().analytics.enabled) {
+            return;
+        }
+        const day = DateTime.local().toISODate();
+        if (!day) {
+            return;
+        }
+        const trimmed = name.slice(0, 64);
+        getAppDb()
+            .prepare(`INSERT INTO feature_usage (name, day, count) VALUES (?, ?, 1)
+         ON CONFLICT(name, day) DO UPDATE SET count = count + 1`)
+            .run(trimmed, day);
+    }
+    catch (err) {
+        logger.warn({ err }, "could not record feature usage");
+    }
+}
+export function featureCounts(days = 30) {
+    try {
+        const since = DateTime.local().minus({ days }).toISODate();
+        if (!since) {
+            return [];
+        }
+        return getAppDb()
+            .prepare(`SELECT name, SUM(count) AS count
+           FROM feature_usage
+          WHERE day >= ?
+          GROUP BY name
+          ORDER BY count DESC, name ASC`)
+            .all(since);
+    }
+    catch (err) {
+        logger.warn({ err }, "could not read feature usage");
+        return [];
+    }
+}
+/**
+ * Delete every stored feature counter.
+ *
+ * Offered because "stop counting" and "forget what you counted" are different
+ * requests, and a privacy control that only does the first is the kind that
+ * gets described as a privacy control and is not one. AI spend is deliberately
+ * NOT cleared here: that is the user's own billing record against a cap they
+ * set, and losing it would make the cap wrong for the rest of the month.
+ */
+export function clearFeatureUsage() {
+    try {
+        getAppDb().prepare("DELETE FROM feature_usage").run();
+    }
+    catch (err) {
+        logger.warn({ err }, "could not clear feature usage");
+    }
+}
+/** Tests only. */
+export function __clearUsageForTests() {
+    const db = getAppDb();
+    db.prepare("DELETE FROM ai_usage").run();
+    db.prepare("DELETE FROM feature_usage").run();
+}
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

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

package/dist/utils/batch.d.ts

@@ -0,0 +1,2 @@
+export declare function mapInBatches<T, R>(items: T[], fn: (item: T) => Promise<R>, concurrency?: number): Promise<R[]>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/utils/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/utils/batch.ts"],"names":[],"mappings":"AAEA,wBAAsB,YAAY,CAAC,CAAC,EAAE,CAAC,EACrC,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC3B,WAAW,SAAsB,GAChC,OAAO,CAAC,CAAC,EAAE,CAAC,CAkBd"}

package/dist/utils/batch.js

@@ -0,0 +1,18 @@
+const DEFAULT_CONCURRENCY = 6;
+export async function mapInBatches(items, fn, concurrency = DEFAULT_CONCURRENCY) {
+    if (items.length === 0) {
+        return [];
+    }
+    const results = new Array(items.length);
+    let index = 0;
+    async function worker() {
+        while (index < items.length) {
+            const current = index++;
+            results[current] = await fn(items[current]);
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=batch.js.map

package/dist/utils/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../src/utils/batch.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAU,EACV,EAA2B,EAC3B,WAAW,GAAG,mBAAmB;IAEjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,UAAU,MAAM;QACnB,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,32 @@
+import { DateTime } from "luxon";
+import type { ActivitySummary } from "../garmin/types.js";
+export type TrendDirection = "improving" | "declining" | "stable" | "insufficient_data";
+export declare function parseIsoDate(value: string): Date;
+export declare function formatIsoDate(date: Date): string;
+export declare function getDateRange(days: number): Date[];
+export declare function getYesterday(): Date;
+export declare function getDatesBetween(startDate: string, endDate: string): Date[];
+export declare function parseActivityLocalDateTime(value: string): DateTime;
+export declare function filterActivitiesByRange(activities: ActivitySummary[], startDate: string, endDate: string): ActivitySummary[];
+export declare function formatDuration(seconds: number | null | undefined): string;
+/**
+ * Distance in the units the user thinks in.
+ *
+ * The unit is a parameter rather than a lookup so these stay pure functions --
+ * every caller already sits inside a tool that knows the profile, and reaching
+ * for a database from a string formatter is how a formatter becomes untestable.
+ *
+ * This exists because the setting shipped before the conversion did: the
+ * profile accepted `imperial`, the system prompt told the model to answer in
+ * miles, and every number it was given was still in kilometres. A setting that
+ * claims to change the units and does not is worse than no setting -- the
+ * reader has no way to tell which one they are looking at.
+ */
+export declare function formatDistanceMeters(meters: number | null | undefined, units?: "metric" | "imperial"): string;
+export declare function formatPaceMetersPerSecond(metersPerSecond: number | null | undefined, units?: "metric" | "imperial"): string;
+export declare function calculateTrend(values: number[], lowerIsBetter?: boolean): TrendDirection;
+export declare function average(values: number[]): number;
+export declare function clamp(value: number, min: number, max: number): number;
+export declare function hashParams(params: Record<string, unknown>): string;
+export declare function sanitizeErrorMessage(message: string): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AAuBxF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMhD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,CASjD;AAED,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,CAqB1E;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAYlE;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,eAAe,EAAE,EAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,eAAe,EAAE,CAYnB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAkBzE;AAKD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,KAAK,GAAE,QAAQ,GAAG,UAAqB,GACtC,MAAM,CAkBR;AAED,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC1C,KAAK,GAAE,QAAQ,GAAG,UAAqB,GACtC,MAAM,CAsBR;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,aAAa,UAAQ,GAAG,cAAc,CA6BtF;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAMhD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAGlE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK5D"}

package/dist/utils/helpers.js

@@ -0,0 +1,188 @@
+import { DateTime } from "luxon";
+// SECTION: Calendar days
+//
+// Every Date in this file is LOCAL midnight for the day it names, not UTC
+// midnight.
+//
+// That is not a style choice. garmin-connect turns a Date into the day it asks
+// Garmin about with `toDateString`, which subtracts getTimezoneOffset() and
+// then reads the UTC date -- a function that round-trips a LOCAL-midnight Date
+// and shifts a UTC-midnight one. Feeding it UTC midnight therefore asked for the
+// wrong calendar day everywhere west of UTC: at UTC-5, `new Date("2026-08-19")`
+// is 2026-08-18T19:00 local, and the library asked Garmin for the 18th while
+// this code stored the answer under the 19th. Every daily metric -- sleep,
+// heart rate, stress, weight -- was off by one day for those users, silently,
+// with plausible numbers under the wrong dates.
+//
+// It never showed up here because the machine this was written on is UTC+4,
+// where the shift lands inside the same day.
+//
+// A calendar day is a local question anyway: "how did I sleep on Tuesday" means
+// the user's Tuesday.
+export function parseIsoDate(value) {
+    const parsed = DateTime.fromISO(value);
+    if (!parsed.isValid) {
+        throw new Error(`Invalid date "${value}". Use ISO 8601 format such as 2026-06-01.`);
+    }
+    return parsed.toJSDate();
+}
+export function formatIsoDate(date) {
+    return DateTime.fromJSDate(date).toISODate() ?? "";
+}
+export function getDateRange(days) {
+    const dates = [];
+    const today = DateTime.local().startOf("day");
+    for (let offset = 0; offset < days; offset += 1) {
+        dates.push(today.minus({ days: offset }).toJSDate());
+    }
+    return dates;
+}
+export function getYesterday() {
+    return DateTime.local().minus({ days: 1 }).startOf("day").toJSDate();
+}
+export function getDatesBetween(startDate, endDate) {
+    const start = DateTime.fromISO(startDate).startOf("day");
+    const end = DateTime.fromISO(endDate).startOf("day");
+    if (!start.isValid || !end.isValid) {
+        throw new Error("Invalid date range. Use ISO 8601 dates such as 2026-06-01.");
+    }
+    if (end < start) {
+        throw new Error("end_date must be on or after start_date.");
+    }
+    const dates = [];
+    let cursor = start;
+    while (cursor <= end) {
+        dates.push(cursor.toJSDate());
+        cursor = cursor.plus({ days: 1 });
+    }
+    return dates;
+}
+export function parseActivityLocalDateTime(value) {
+    const fromIso = DateTime.fromISO(value, { setZone: true });
+    if (fromIso.isValid) {
+        return fromIso;
+    }
+    const fromSql = DateTime.fromSQL(value, { setZone: true });
+    if (fromSql.isValid) {
+        return fromSql;
+    }
+    return DateTime.invalid("unparsable");
+}
+export function filterActivitiesByRange(activities, startDate, endDate) {
+    const start = DateTime.fromISO(startDate).startOf("day");
+    const end = DateTime.fromISO(endDate).startOf("day");
+    return activities.filter((activity) => {
+        const activityDay = parseActivityLocalDateTime(activity.startTimeLocal).startOf("day");
+        if (!activityDay.isValid) {
+            return false;
+        }
+        return activityDay.toMillis() >= start.toMillis() && activityDay.toMillis() <= end.toMillis();
+    });
+}
+export function formatDuration(seconds) {
+    if (seconds === null || seconds === undefined || !Number.isFinite(seconds)) {
+        return "n/a";
+    }
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const remainingSeconds = Math.floor(seconds % 60);
+    if (hours > 0) {
+        return `${hours}h ${minutes}m ${remainingSeconds}s`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${remainingSeconds}s`;
+    }
+    return `${remainingSeconds}s`;
+}
+const METRES_PER_MILE = 1609.344;
+const METRES_PER_FOOT = 0.3048;
+/**
+ * Distance in the units the user thinks in.
+ *
+ * The unit is a parameter rather than a lookup so these stay pure functions --
+ * every caller already sits inside a tool that knows the profile, and reaching
+ * for a database from a string formatter is how a formatter becomes untestable.
+ *
+ * This exists because the setting shipped before the conversion did: the
+ * profile accepted `imperial`, the system prompt told the model to answer in
+ * miles, and every number it was given was still in kilometres. A setting that
+ * claims to change the units and does not is worse than no setting -- the
+ * reader has no way to tell which one they are looking at.
+ */
+export function formatDistanceMeters(meters, units = "metric") {
+    if (meters === null || meters === undefined || !Number.isFinite(meters)) {
+        return "n/a";
+    }
+    if (units === "imperial") {
+        // A quarter of a mile is the point below which a runner thinks in feet.
+        if (meters >= METRES_PER_MILE / 4) {
+            return `${(meters / METRES_PER_MILE).toFixed(2)} mi`;
+        }
+        return `${(meters / METRES_PER_FOOT).toFixed(0)} ft`;
+    }
+    if (meters >= 1000) {
+        return `${(meters / 1000).toFixed(2)} km`;
+    }
+    return `${meters.toFixed(0)} m`;
+}
+export function formatPaceMetersPerSecond(metersPerSecond, units = "metric") {
+    if (metersPerSecond === null ||
+        metersPerSecond === undefined ||
+        !Number.isFinite(metersPerSecond) ||
+        metersPerSecond <= 0) {
+        return "n/a";
+    }
+    const perUnit = units === "imperial" ? METRES_PER_MILE : 1000;
+    const secondsPerUnit = perUnit / metersPerSecond;
+    const minutes = Math.floor(secondsPerUnit / 60);
+    const seconds = Math.round(secondsPerUnit % 60);
+    // 4:60 /km is not a pace. Rounding the seconds can carry, and the carry has
+    // to reach the minutes or the string is wrong once every sixty paces.
+    const carried = seconds === 60;
+    const finalMinutes = carried ? minutes + 1 : minutes;
+    const finalSeconds = carried ? 0 : seconds;
+    return `${finalMinutes}:${finalSeconds.toString().padStart(2, "0")} ${units === "imperial" ? "/mi" : "/km"}`;
+}
+export function calculateTrend(values, lowerIsBetter = false) {
+    const filtered = values.filter((value) => Number.isFinite(value));
+    if (filtered.length < 2) {
+        return "insufficient_data";
+    }
+    const midpoint = Math.floor(filtered.length / 2);
+    const recent = filtered.slice(0, midpoint);
+    const older = filtered.slice(midpoint);
+    if (recent.length === 0 || older.length === 0) {
+        return "insufficient_data";
+    }
+    const recentAverage = average(recent);
+    const olderAverage = average(older);
+    const delta = recentAverage - olderAverage;
+    const threshold = Math.max(Math.abs(olderAverage) * 0.02, 0.5);
+    if (Math.abs(delta) <= threshold) {
+        return "stable";
+    }
+    if (lowerIsBetter) {
+        return delta < 0 ? "improving" : "declining";
+    }
+    return delta > 0 ? "improving" : "declining";
+}
+export function average(values) {
+    if (values.length === 0) {
+        return 0;
+    }
+    return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+export function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+export function hashParams(params) {
+    const sortedEntries = Object.entries(params).sort(([left], [right]) => left.localeCompare(right));
+    return JSON.stringify(Object.fromEntries(sortedEntries));
+}
+export function sanitizeErrorMessage(message) {
+    return message
+        .replace(/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g, "[email]")
+        .replace(/(?:[A-Za-z]:\\|\/)[^\s]+/g, "[path]")
+        .replace(/\bpassword[^\s]*/gi, "[redacted]");
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

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

package/dist/utils/jsonFile.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Windows PowerShell 5.1's `Set-Content -Encoding utf8` writes a BOM, and
+ * `JSON.parse` treats a leading U+FEFF as a syntax error. Every JSON file this
+ * project reads can have been written or edited by a Windows tool: the watch
+ * setup file is written by `scripts/start-watch-stack.ps1`, and Claude Desktop
+ * and Cursor both ship BOM'd config on Windows.
+ *
+ * This was not theoretical. `.trainbud/watch-setup.json` held the correct
+ * tunnel URL, and `appConfig.publicUrl` returned "" for it, because the parse
+ * threw on the BOM and the getter's `catch` swallowed the reason. `trainbud
+ * doctor` then reported "No public URL is configured, so the watch has no
+ * address to call" while the tunnel was up and answering 200 — a diagnostic
+ * naming the wrong fault, about the one file whose whole job is to name an
+ * address.
+ */
+export declare function stripBom(text: string): string;
+/** Read and parse a JSON file, tolerating a byte order mark. Throws like JSON.parse. */
+export declare function readJsonFile<T>(filePath: string): T;
+//# sourceMappingURL=jsonFile.d.ts.map

package/dist/utils/jsonFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonFile.d.ts","sourceRoot":"","sources":["../../src/utils/jsonFile.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAEnD"}

package/dist/utils/jsonFile.js

@@ -0,0 +1,24 @@
+import fs from "node:fs";
+/**
+ * Windows PowerShell 5.1's `Set-Content -Encoding utf8` writes a BOM, and
+ * `JSON.parse` treats a leading U+FEFF as a syntax error. Every JSON file this
+ * project reads can have been written or edited by a Windows tool: the watch
+ * setup file is written by `scripts/start-watch-stack.ps1`, and Claude Desktop
+ * and Cursor both ship BOM'd config on Windows.
+ *
+ * This was not theoretical. `.trainbud/watch-setup.json` held the correct
+ * tunnel URL, and `appConfig.publicUrl` returned "" for it, because the parse
+ * threw on the BOM and the getter's `catch` swallowed the reason. `trainbud
+ * doctor` then reported "No public URL is configured, so the watch has no
+ * address to call" while the tunnel was up and answering 200 — a diagnostic
+ * naming the wrong fault, about the one file whose whole job is to name an
+ * address.
+ */
+export function stripBom(text) {
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+/** Read and parse a JSON file, tolerating a byte order mark. Throws like JSON.parse. */
+export function readJsonFile(filePath) {
+    return JSON.parse(stripBom(fs.readFileSync(filePath, "utf8")));
+}
+//# sourceMappingURL=jsonFile.js.map

package/dist/utils/jsonFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonFile.js","sourceRoot":"","sources":["../../src/utils/jsonFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,YAAY,CAAI,QAAgB;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAM,CAAC;AACtE,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,4 @@
+import type { Logger } from "pino";
+export declare function configureLogger(logPath?: string): void;
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAiGnC,wBAAgB,eAAe,CAAC,OAAO,SAAoB,GAAG,IAAI,CAEjE;AAED,eAAO,MAAM,MAAM,EAAE,MAMnB,CAAC"}