@indaco/garmin-personal-mcp 0.2.0 → 0.3.0

package/dist/index.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import process$1 from "node:process";
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
+import { spawn } from "node:child_process";
+import { appendFileSync, existsSync, mkdirSync, readFileSync, realpathSync, renameSync, statSync } from "node:fs";
 import { copyFile, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
-import { appendFileSync, mkdirSync, readFileSync, renameSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { delimiter, dirname, join, resolve } from "node:path";
 import { randomBytes } from "node:crypto";
 import { createRequire } from "module";
 // node_modules/.pnpm/@modelcontextprotocol+server@2.4.0/node_modules/@modelcontextprotocol/server/dist/chunk-vYduTEsO.mjs
@@ -24093,17 +24094,9 @@ function serveStdio(factory, options = {}) {
 function toError(value) {
 	return value instanceof Error ? value : new Error(String(value));
 }
-// src/config.ts
-/** Defaults reuse an existing ~/.config/garmin-mcp/api-key and ~/workspace/garmin-data. */
-function loadConfig(env = process.env) {
-	return {
-		baseUrl: env.GARMIN_BASE_URL || "https://personal.connectapi.garmin.com",
-		apiKeyFile: env.GARMIN_API_KEY_FILE || join(homedir(), ".config/garmin-mcp/api-key"),
-		dataDir: env.GARMIN_DATA_DIR || join(homedir(), "workspace/garmin-data")
-	};
-}
 // package.json
-var version = "0.2.0";
+var name = "@indaco/garmin-personal-mcp";
+var version = "0.3.0";
 // src/log.ts
 /** Past this size the log moves to `<file>.1`, replacing the one before, and a new log starts. */
 const MAX_BYTES = 1e6;
@@ -59005,13 +58998,13 @@ function round(v, decimals) {
 	const f = 10 ** decimals;
 	return Math.round(v * f) / f;
 }
-const pad = (n) => String(n).padStart(2, "0");
+const pad$1 = (n) => String(n).padStart(2, "0");
 function hms(seconds) {
 	const s = Math.round(seconds);
 	const h = Math.floor(s / 3600);
 	const m = Math.floor(s % 3600 / 60);
 	const sec = s % 60;
-	return h > 0 ? `${h}:${pad(m)}:${pad(sec)}` : `${m}:${pad(sec)}`;
+	return h > 0 ? `${h}:${pad$1(m)}:${pad$1(sec)}` : `${m}:${pad$1(sec)}`;
 }
 // src/tools.ts
 const DAY_MS = 864e5;
@@ -59029,7 +59022,8 @@ var GarminTools = class {
 		this.api = api;
 		this.dataDir = dataDir;
 	}
-	async listActivities(startDate, endDate, activityType, limit, raw) {
+	async listActivities(startDate, endDate, activityType, limit, raw, names) {
+		const wanted = names?.map((n) => n.toLowerCase()).filter(Boolean) ?? [];
 		const asked = limit == null || limit <= 0 ? 20 : Math.min(limit, 200);
 		const search = (max, type, subType) => this.api.getJson("/activitylist-service/activities/search/activities", {
 			start: "0",
@@ -59040,14 +59034,15 @@ var GarminTools = class {
 			activitySubType: subType
 		});
 		const refused = (e) => activityType !== void 0 && e instanceof GarminApiError && /-> HTTP 400\b/.test(e.message);
+		const max = wanted.length > 0 ? 200 : asked;
 		let json;
 		let local = false;
 		try {
-			json = await search(asked, activityType);
+			json = await search(max, activityType);
 		} catch (e) {
 			if (!refused(e)) throw e;
 			try {
-				json = await search(asked, void 0, activityType);
+				json = await search(max, void 0, activityType);
 				log("INFO", `activityType ${activityType} refused, asked as activitySubType`);
 			} catch (e2) {
 				if (!refused(e2)) throw e2;
@@ -59058,8 +59053,13 @@ var GarminTools = class {
 		}
 		const list = Array.isArray(json) ? json : firstArray(json);
 		if (!list) return JSON.stringify(json);
-		const rows = local ? list.filter((a) => field$1(isObject$3(a) ? a.activityType : void 0, "typeKey") === activityType).slice(0, asked) : list;
-		return JSON.stringify(raw === true ? local ? rows : json : rows.map((a) => summarize(isObject$3(a) ? a : {})));
+		const named = (a) => {
+			const name = isObject$3(a) ? a.activityName : void 0;
+			return typeof name === "string" && wanted.some((n) => name.toLowerCase().includes(n));
+		};
+		const filtered = local || wanted.length > 0;
+		const rows = filtered ? list.filter((a) => (!local || field$2(isObject$3(a) ? a.activityType : void 0, "typeKey") === activityType) && (wanted.length === 0 || named(a))).slice(0, asked) : list;
+		return JSON.stringify(raw === true ? filtered ? rows : json : rows.map((a) => summarize(isObject$3(a) ? a : {})));
 	}
 	async getActivity(activityId) {
 		return JSON.stringify(await this.api.getJson(`/activity-service/activity/${activityId}`, {}));
@@ -59182,7 +59182,7 @@ function summarize(a) {
 	const o = {};
 	copy$1(a, o, "activityId", "id");
 	copy$1(a, o, "activityName", "name");
-	const typeKey = asString$1(field$1(a.activityType, "typeKey"));
+	const typeKey = asString$1(field$2(a.activityType, "typeKey"));
 	if (typeKey !== null) o.type = typeKey;
 	const sport = Number.isInteger(a.sportTypeId) ? SPORTS[a.sportTypeId] : void 0;
 	if (sport !== void 0) o.sport = sport;
@@ -59198,7 +59198,7 @@ function summarize(a) {
 	copy$1(a, o, "elevationGain", "ascentM");
 	const elapsedS = asDouble(a.duration, 0);
 	if (elapsedS - durS >= 60) o.elapsed = hms(elapsedS);
-	if (asString$1(field$1(a.eventType, "typeKey")) === "race") o.race = true;
+	if (asString$1(field$2(a.eventType, "typeKey")) === "race") o.race = true;
 	putRounded(a, o, "activityTrainingLoad", "trainingLoad", 1);
 	putRounded(a, o, "aerobicTrainingEffect", "aerobicTE", 1);
 	putRounded(a, o, "anaerobicTrainingEffect", "anaerobicTE", 1);
@@ -59242,13 +59242,13 @@ function summarize(a) {
 	}
 	if (Object.keys(best).length > 0) o.best = best;
 	for (const split of Array.isArray(a.splitSummaries) ? a.splitSummaries : []) {
-		const type = asString$1(field$1(split, "splitType")) ?? "";
-		const speed = asDouble(field$1(split, "averageSpeed"), 0);
+		const type = asString$1(field$2(split, "splitType")) ?? "";
+		const speed = asDouble(field$2(split, "averageSpeed"), 0);
 		if (type === "RWD_RUN" && speed > 0) {
 			const runWalk = o.runWalk ??= {};
 			runWalk.runPace = `${hms(1e3 / speed)}/km`;
-			runWalk.runKm = round(asDouble(field$1(split, "distance"), 0) / 1e3, 2);
-		} else if (type === "RWD_WALK") (o.runWalk ??= {}).walkTime = hms(asDouble(field$1(split, "duration"), 0));
+			runWalk.runKm = round(asDouble(field$2(split, "distance"), 0) / 1e3, 2);
+		} else if (type === "RWD_WALK") (o.runWalk ??= {}).walkTime = hms(asDouble(field$2(split, "duration"), 0));
 	}
 	return o;
 }
@@ -59288,7 +59288,7 @@ function copy$1(from, to, name, as) {
 function isObject$3(v) {
 	return typeof v === "object" && v !== null && !Array.isArray(v);
 }
-function field$1(v, name) {
+function field$2(v, name) {
 	return isObject$3(v) ? v[name] : void 0;
 }
 /** A number, or text holding one (spaces around it allowed); the default otherwise (null too). */
@@ -59349,9 +59349,10 @@ function registerTools(server, tools) {
 			endDate: string().describe("End date yyyy-MM-dd (optional)").optional(),
 			activityType: string().describe("Activity type key (optional): a parent type such as running or cycling, or a subtype such as trail_running").optional(),
 			limit: number$1().int().describe("Max number of activities, default 20").optional(),
-			raw: boolean().describe("Return Garmin's raw JSON instead of the summary").optional()
+			raw: boolean().describe("Return Garmin's raw JSON instead of the summary").optional(),
+			names: array(string()).describe("Activity names (optional): keep only the activities whose name contains one of them, ignoring case").optional()
 		})
-	}, async (a) => text(await tools.listActivities(a.startDate, a.endDate, a.activityType, a.limit, a.raw)));
+	}, async (a) => text(await tools.listActivities(a.startDate, a.endDate, a.activityType, a.limit, a.raw, a.names)));
 	server.registerTool("getActivity", {
 		description: "Get the full detail of one activity (summary, metadata, splits/laps) as JSON.",
 		inputSchema: object({ activityId })
@@ -59588,16 +59589,16 @@ var GarminDashboard = class {
 				failed = true;
 				continue;
 			}
-			const summaries = field(json, "hrvSummaries");
+			const summaries = field$1(json, "hrvSummaries");
 			for (const h of Array.isArray(summaries) ? summaries : []) {
-				const day = date(field(h, "calendarDate"));
+				const day = date(field$1(h, "calendarDate"));
 				if (day === void 0) continue;
 				const o = { date: day };
 				copy(h, o, "lastNightAvg", "hrv");
 				copy(h, o, "weeklyAvg", "weeklyAvg");
 				copy(h, o, "status", "status");
-				copy(field(h, "baseline"), o, "balancedLow", "low");
-				copy(field(h, "baseline"), o, "balancedUpper", "high");
+				copy(field$1(h, "baseline"), o, "balancedLow", "low");
+				copy(field$1(h, "baseline"), o, "balancedUpper", "high");
 				byDate[day] = o;
 			}
 		}
@@ -59691,10 +59692,10 @@ function recoveryRow(day, sleep, summary) {
 	hours(sleep, r, "lightSleepSeconds", "light");
 	hours(sleep, r, "remSleepSeconds", "rem");
 	hours(sleep, r, "awakeSleepSeconds", "awake");
-	copy(field(field(sleep, "sleepScores"), "overall"), r, "value", "sleepScore");
-	const need = field(field(sleep, "sleepNeed"), "actual");
+	copy(field$1(field$1(sleep, "sleepScores"), "overall"), r, "value", "sleepScore");
+	const need = field$1(field$1(sleep, "sleepNeed"), "actual");
 	if (typeof need === "number") r.needH = round2(need / 60);
-	const bed = field(sleep, "sleepStartTimestampLocal");
+	const bed = field$1(sleep, "sleepStartTimestampLocal");
 	if (typeof bed === "number") {
 		const t = new Date(Math.trunc(bed));
 		r.bedMin = t.getUTCHours() * 60 + t.getUTCMinutes();
@@ -59705,7 +59706,7 @@ function recoveryRow(day, sleep, summary) {
 	copy(summary, r, "averageStressLevel", "stress");
 	copy(summary, r, "totalSteps", "steps");
 	copy(summary, r, "dailyStepGoal", "stepGoal");
-	const floors = field(summary, "floorsAscended");
+	const floors = field$1(summary, "floorsAscended");
 	if (typeof floors === "number") r.floors = Math.round(floors);
 	return r;
 }
@@ -59766,7 +59767,7 @@ function setCovered(cache, fromField, toField, [from, to]) {
 	cache[toField] = to;
 }
 function dayOf$1(a) {
-	const s = field(a, "start");
+	const s = field$1(a, "start");
 	return typeof s === "string" && s.length >= 10 ? date(s.slice(0, 10)) : void 0;
 }
 /** A yyyy-MM-dd date; undefined when missing or not a real date, so the range is fetched again. */
@@ -59776,11 +59777,11 @@ function date(v) {
 	return !Number.isNaN(t) && new Date(t).toISOString().startsWith(v) ? v : void 0;
 }
 function copy(from, to, name, as) {
-	const v = field(from, name);
+	const v = field$1(from, name);
 	if (v !== void 0 && v !== null) to[as] = v;
 }
 function hours(from, to, name, as) {
-	const v = field(from, name);
+	const v = field$1(from, name);
 	if (typeof v === "number") to[as] = round2(v / 3600);
 }
 function round2(v) {
@@ -59789,7 +59790,7 @@ function round2(v) {
 function isObject$2(v) {
 	return typeof v === "object" && v !== null && !Array.isArray(v);
 }
-function field(v, name) {
+function field$1(v, name) {
 	return isObject$2(v) ? v[name] : void 0;
 }
 /** Text, or a number as text; "" for anything else. */
@@ -60348,6 +60349,7 @@ const BUILT_IN = {
 		"footer.license": "Licenza MIT",
 		"menu.language": "Lingua",
 		"lang.auto": "Automatica",
+		"lang.missing": "{language} non è ancora in questa pagina. Chiedi al tuo assistente di aggiungere la lingua.",
 		"themeGroup.auto": "Automatico",
 		"themeGroup.dark": "Scuri",
 		"themeGroup.light": "Chiari",
@@ -60368,6 +60370,13 @@ const BUILT_IN = {
 		"window.all": "Tutte",
 		"window.from": "Dalla settimana",
 		"window.to": "Alla settimana",
+		"names.label": "Nomi delle attività",
+		"names.all": "Tutti",
+		"names.count": "{n} scelto|{n} scelti",
+		"names.search": "Cerca nomi",
+		"names.noMatch": "Nessun nome corrisponde.",
+		"names.remove": "Togli {name}",
+		"names.clear": "Mostra tutte",
 		"type.all": "Tutte",
 		"type.recovery": "Recupero",
 		"type.running": "Corsa",
@@ -60499,6 +60508,8 @@ const BUILT_IN = {
 		"add.close": "Chiudi",
 		"add.hiddenGroup": "Nascosti in questa scheda",
 		"add.none": "Tutti i widget sono già in questa scheda.",
+		"add.search": "Cerca widget",
+		"add.noMatch": "Nessun widget corrisponde.",
 		"copy.title": "Copia layout",
 		"copy.hint": "Questo layout è salvato solo in questo browser. Per tenerlo nella pagina, incolla questo testo al tuo assistente e chiedigli di salvare il layout della dashboard.",
 		"copy.copy": "Copia",
@@ -60791,6 +60802,7 @@ const BUILT_IN = {
 		"footer.license": "MIT-Lizenz",
 		"menu.language": "Sprache",
 		"lang.auto": "Automatisch",
+		"lang.missing": "{language} ist noch nicht auf dieser Seite. Bitte deinen Assistenten, die Sprache hinzuzufügen.",
 		"themeGroup.auto": "Automatisch",
 		"themeGroup.dark": "Dunkel",
 		"themeGroup.light": "Hell",
@@ -60811,6 +60823,13 @@ const BUILT_IN = {
 		"window.all": "Alle",
 		"window.from": "Von Woche",
 		"window.to": "Bis Woche",
+		"names.label": "Aktivitätsnamen",
+		"names.all": "Alle",
+		"names.count": "{n} gewählt|{n} gewählt",
+		"names.search": "Namen suchen",
+		"names.noMatch": "Kein Name passt.",
+		"names.remove": "{name} entfernen",
+		"names.clear": "Alle zeigen",
 		"type.all": "Alle",
 		"type.recovery": "Erholung",
 		"type.running": "Laufen",
@@ -60942,6 +60961,8 @@ const BUILT_IN = {
 		"add.close": "Schließen",
 		"add.hiddenGroup": "Auf diesem Board ausgeblendet",
 		"add.none": "Alle Widgets sind auf diesem Board.",
+		"add.search": "Widgets suchen",
+		"add.noMatch": "Kein Widget passt.",
 		"copy.title": "Layout kopieren",
 		"copy.hint": "Dieses Layout ist nur in diesem Browser gespeichert. Um es in der Seite zu behalten, füge diesen Text bei deinem Assistenten ein und bitte ihn, das Dashboard-Layout zu speichern.",
 		"copy.copy": "Kopieren",
@@ -61234,6 +61255,7 @@ const BUILT_IN = {
 		"footer.license": "Licence MIT",
 		"menu.language": "Langue",
 		"lang.auto": "Automatique",
+		"lang.missing": "{language} n'est pas encore dans cette page. Demande à ton assistant d'ajouter la langue.",
 		"themeGroup.auto": "Automatique",
 		"themeGroup.dark": "Sombres",
 		"themeGroup.light": "Clairs",
@@ -61254,6 +61276,13 @@ const BUILT_IN = {
 		"window.all": "Toutes",
 		"window.from": "De la semaine",
 		"window.to": "À la semaine",
+		"names.label": "Noms des activités",
+		"names.all": "Tous",
+		"names.count": "{n} choisi|{n} choisis",
+		"names.search": "Rechercher un nom",
+		"names.noMatch": "Aucun nom ne correspond.",
+		"names.remove": "Retirer {name}",
+		"names.clear": "Tout afficher",
 		"type.all": "Toutes",
 		"type.recovery": "Récupération",
 		"type.running": "Course",
@@ -61385,6 +61414,8 @@ const BUILT_IN = {
 		"add.close": "Fermer",
 		"add.hiddenGroup": "Masqués sur ce tableau",
 		"add.none": "Tous les widgets sont sur ce tableau.",
+		"add.search": "Rechercher un widget",
+		"add.noMatch": "Aucun widget ne correspond.",
 		"copy.title": "Copier la mise en page",
 		"copy.hint": "Cette mise en page est enregistrée uniquement dans ce navigateur. Pour la garder dans la page, colle ce texte à ton assistant et demande-lui d'enregistrer la mise en page du tableau de bord.",
 		"copy.copy": "Copier",
@@ -61677,6 +61708,7 @@ const BUILT_IN = {
 		"footer.license": "Licencia MIT",
 		"menu.language": "Idioma",
 		"lang.auto": "Automático",
+		"lang.missing": "{language} aún no está en esta página. Pide a tu asistente que añada el idioma.",
 		"themeGroup.auto": "Automático",
 		"themeGroup.dark": "Oscuros",
 		"themeGroup.light": "Claros",
@@ -61697,6 +61729,13 @@ const BUILT_IN = {
 		"window.all": "Todas",
 		"window.from": "Desde la semana",
 		"window.to": "Hasta la semana",
+		"names.label": "Nombres de actividad",
+		"names.all": "Todos",
+		"names.count": "{n} elegido|{n} elegidos",
+		"names.search": "Buscar nombres",
+		"names.noMatch": "Ningún nombre coincide.",
+		"names.remove": "Quitar {name}",
+		"names.clear": "Mostrar todas",
 		"type.all": "Todas",
 		"type.recovery": "Recuperación",
 		"type.running": "Carrera",
@@ -61828,6 +61867,8 @@ const BUILT_IN = {
 		"add.close": "Cerrar",
 		"add.hiddenGroup": "Ocultos en esta pestaña",
 		"add.none": "Todos los widgets ya están en esta pestaña.",
+		"add.search": "Buscar widgets",
+		"add.noMatch": "Ningún widget coincide.",
 		"copy.title": "Copiar diseño",
 		"copy.hint": "Este diseño solo está guardado en este navegador. Para conservarlo en la página, pega este texto a tu asistente y pídele que guarde el diseño del panel.",
 		"copy.copy": "Copiar",
@@ -62120,6 +62161,7 @@ const BUILT_IN = {
 		"footer.license": "Licença MIT",
 		"menu.language": "Idioma",
 		"lang.auto": "Automático",
+		"lang.missing": "{language} ainda não está nesta página. Peça ao seu assistente para adicionar o idioma.",
 		"themeGroup.auto": "Automático",
 		"themeGroup.dark": "Escuros",
 		"themeGroup.light": "Claros",
@@ -62140,6 +62182,13 @@ const BUILT_IN = {
 		"window.all": "Todas",
 		"window.from": "Da semana",
 		"window.to": "Até a semana",
+		"names.label": "Nomes das atividades",
+		"names.all": "Todos",
+		"names.count": "{n} escolhido|{n} escolhidos",
+		"names.search": "Pesquisar nomes",
+		"names.noMatch": "Nenhum nome corresponde.",
+		"names.remove": "Remover {name}",
+		"names.clear": "Mostrar todas",
 		"type.all": "Todas",
 		"type.recovery": "Recuperação",
 		"type.running": "Corrida",
@@ -62271,6 +62320,8 @@ const BUILT_IN = {
 		"add.close": "Fechar",
 		"add.hiddenGroup": "Ocultos neste quadro",
 		"add.none": "Todos os widgets já estão neste quadro.",
+		"add.search": "Pesquisar widgets",
+		"add.noMatch": "Nenhum widget corresponde.",
 		"copy.title": "Copiar layout",
 		"copy.hint": "Este layout está salvo apenas neste navegador. Para mantê-lo na página, cole este texto na conversa com o seu assistente e peça que ele salve o layout do painel.",
 		"copy.copy": "Copiar",
@@ -62565,6 +62616,7 @@ var en_default = {
 	"footer.license": "MIT License",
 	"menu.language": "Language",
 	"lang.auto": "Auto",
+	"lang.missing": "{language} is not in this page yet. Ask your assistant to add it.",
 	"themeGroup.auto": "Auto",
 	"themeGroup.dark": "Dark",
 	"themeGroup.light": "Light",
@@ -62585,6 +62637,13 @@ var en_default = {
 	"window.all": "All",
 	"window.from": "From week",
 	"window.to": "To week",
+	"names.label": "Activity names",
+	"names.all": "All",
+	"names.count": "{n} chosen|{n} chosen",
+	"names.search": "Search names",
+	"names.noMatch": "No name matches.",
+	"names.remove": "Remove {name}",
+	"names.clear": "Show all",
 	"type.all": "All",
 	"type.recovery": "Recovery",
 	"type.running": "Run",
@@ -62716,6 +62775,8 @@ var en_default = {
 	"add.close": "Close",
 	"add.hiddenGroup": "Hidden on this board",
 	"add.none": "Every widget is on this board.",
+	"add.search": "Search widgets",
+	"add.noMatch": "No widget matches.",
 	"copy.title": "Copy layout",
 	"copy.hint": "This layout is saved in this browser only. To keep it in the page, paste this text to your assistant and ask it to save the dashboard layout.",
 	"copy.copy": "Copy",
@@ -63219,22 +63280,25 @@ ctx gives:
 - ctx.data: the getDashboardData result (activities, previousActivities, hrv, recovery, zones, fitnessAge, sync, units) and notes (plain text). The data is always metric (km, m, kg, seconds per km); units is the measurement system of the Garmin profile (metric, statute_us or statute_uk).
 - ctx.type: "all" or the board the widget shows: running, strengthTraining, walking, hiking, cycling, swimming, racket, generic (Other), or another SDK sport name such as alpineSkiing. Each activity has type (the Garmin type key) and sport (the SDK sport name).
 - ctx.from, ctx.to: Mondays of the first and last week of the window; ctx.weeks: every Monday in it.
-- ctx.activities: the activities of the window and of ctx.type. ctx.allActivities: every type. ctx.ofType(list): the same type filter for any list.
+- ctx.activities: the activities of the window and of ctx.type. ctx.allActivities: every type. ctx.ofType(list): the same type filter for any list. When the user chooses activity names on the page, ctx.activities and ctx.ofType keep only the activities with those names; ctx.allActivities and ctx.data keep every activity.
 - ctx.t(key, params): a page text; ctx.lang: the page language.
+- ctx.text(key, params): a text of the widget's own texts in the page language, else in English, with its {placeholders} filled from params.
 - ctx.fmt: num(v, digits), pct(v), day("yyyy-MM-dd"), longDay(d), hms(seconds), hours(seconds), na (the text for a missing value). In the profile's units, from metric data: dist(km, digits), pace(secondsPerKm), speed(kmh), elev(m), mass(kg), swimPace(secondsPer100m). ctx.fmt.to.dist/pace/speed/elev/mass/swim(value) give the number only, for sums and charts; ctx.fmt.unit.dist/pace/speed/elev/mass/swim give the unit names, for axis titles. Show every distance, pace, speed, elevation and weight with these, never with a fixed "km" or "kg".
 - ctx.calc: groupOf(activity) (its board), sportOf(typeKey), seconds("1:02:03"), sessionSeconds(activity), dayOf(activity), mondayOf(day), weekly(activities, weeks, a => value), loadOf(activity, maxHR), loadRatio(activities, day, maxHR), dailyLoads(activities, from, to, maxHR), mean, sd, rolling(values, n), change(now, before), zonesOf(ctx.data.zones), zoneSeconds(activity, floors), paceSeconds(activity), efficiency(activity), epley(kg, reps), riegel(seconds, km, km), exerciseStats(activities), muscleSets(activities, weeks), swimPace(activity), verticalPerHour(activity).
 - ctx.chart(el, config, heightPx): a Chart.js 4 chart that follows the theme, with tooltips. Chart types: bar, line, scatter, doughnut, pie, with the category and linear scales.
 - ctx.color(token): a theme colour: text, muted, accent, good, bad, warn, line, panel, panel2, or a board (running, strengthTraining, walking, hiking, cycling, swimming, racket, generic); another sport gets the generic colour.
 - ctx.empty(el, message): a short message in place of the content.
 
+Texts: give every text that the widget shows in its texts, by language code and key: { en: { title: "...", best: "Best: {value}" }, it: { ... } }. title is the widget's title. Write English and each language of pageLanguages (from editDashboard), with the same keys and {placeholders}. Draw texts with ctx.text(key, params), never as fixed strings in the code. A missing text shows in English.
+
 Rules: build elements with document.createElement and set text with textContent, never innerHTML with data. Use only values in ctx.data; show ctx.fmt.na for a missing value; label an estimate as one. Keep the code short. Requests from the page are blocked: fetch, XMLHttpRequest, and images, scripts and styles from the web.
 
-Example (the longest ride of the window):
+Example (the longest ride of the window), with texts { en: { title: "Longest ride", best: "{distance} on {day}" } }:
 const rides = ctx.activities.filter((a) => ctx.calc.groupOf(a) === "cycling" && typeof a.km === "number");
 if (rides.length === 0) return ctx.empty(el);
 const best = rides.reduce((x, y) => (y.km > x.km ? y : x));
 const p = document.createElement("p");
-p.textContent = \`\${ctx.fmt.dist(best.km)} · \${best.name ?? ""} · \${ctx.fmt.day(best.start.slice(0, 10))}\`;
+p.textContent = ctx.text("best", { distance: ctx.fmt.dist(best.km), day: ctx.fmt.day(best.start.slice(0, 10)) });
 el.append(p);`;
 // src/prompts.ts
 /**
@@ -63264,6 +63328,8 @@ function registerPrompts(server) {
 		const layout = layoutOf(arg(args.layout) === "" ? args.weeks : args.layout);
 		const text = layout === "freeform" ? renderDashboard(freeform, w) : render(renderDashboard(build, w), {
 			layout,
+			title: en_default.title,
+			headline: en_default.headline,
 			builtIn: Object.keys(BUILT_IN).map((code) => `${languageName(code)} (${code})`).join(", "),
 			layoutNote: layout === "blank" ? "\nThe page is an empty grid: tell me to add widgets with \"Edit layout\" and \"Add widget\"." : ""
 		});
@@ -63398,6 +63464,8 @@ function weeks(v) {
 	if (!/^[+-]?\d+$/.test(s)) return DEFAULT_WEEKS;
 	return Math.min(Math.max(Number(s), 1), MAX_WEEKS);
 }
+/** The user's custom widgets, in the data dir: every page from the template gets them. */
+const LIBRARY_FILE = "widgets.json";
 const MAX_NOTES = 5;
 const REUSE_MS = 9e5;
 const marker = (b) => new RegExp(`/\\*\\s*garmin-${b}:start\\s*\\*/([\\s\\S]*?)/\\*\\s*garmin-${b}:end\\s*\\*/`);
@@ -63497,6 +63565,8 @@ function withData(page, data, s, notes) {
 	return writeBlock(next, "data", {
 		...filterData(data, s),
 		v: 3,
+		server: version,
+		updated: (/* @__PURE__ */ new Date()).toISOString(),
 		notes: kept.map(escapeHtml)
 	});
 }
@@ -63577,13 +63647,14 @@ var DashboardWriter = class {
 		this.#queue = run.catch(() => {});
 		return run;
 	}
-	async #write({ weeks, notes = [], layout, page, path, settings }) {
+	async #write({ weeks, notes = [], layout, page, path, settings, onlyExisting }) {
 		if (layout && page) throw new Error("Give either `layout` (a page from the template) or `page` (your own page), not both");
 		if (page !== void 0 && !marker("data").test(page)) throw new Error("`page` has no /* garmin-data:start */ ... /* garmin-data:end */ block");
 		if (notes.length > MAX_NOTES) throw new Error(`At most ${MAX_NOTES} notes`);
 		const asked = settings === void 0 ? void 0 : checkSettings(settings);
 		const target = this.#target(path);
 		const old = await readExisting(target);
+		if (onlyExisting && old === void 0) throw new Error(`${target} does not exist: make it first with the training-dashboard prompt`);
 		let oldSettings;
 		let unreadable = false;
 		try {
@@ -63618,6 +63689,7 @@ var DashboardWriter = class {
 		}
 		if (Object.keys(own).length > 0 && !marker("settings").test(next)) throw new Error("Settings need a page from the template; this page has no garmin-settings block");
 		if (page === void 0 && next !== old) next = styled(next, own);
+		if (page === void 0) next = await this.#withLibrary(next, old);
 		const raw = JSON.parse(await this.#data(weeks ?? weeksOf(old)));
 		next = withData(next, raw, own, notes);
 		let backup;
@@ -63634,7 +63706,9 @@ var DashboardWriter = class {
 			digest: digest(filterData(raw, own)),
 			pageLanguages: pageLanguages(next, own),
 			settings: own,
-			...hasLanguages(next) ? { languages: missingTexts(next) } : {}
+			...hasLanguages(next) ? { languages: missingTexts(next) } : {},
+			...page === void 0 && missingLanguage(next, raw.locale) ? { missingProfileLanguage: raw.locale } : {},
+			...page === void 0 ? withMissing(widgetGaps(next, pageLanguages(next, own))) : {}
 		};
 	}
 	/** Changes the layout, the custom widgets or the languages of a page from the template; no options only reads. */
@@ -63650,6 +63724,7 @@ var DashboardWriter = class {
 		let page = old;
 		let layout;
 		let widgets;
+		let library;
 		let texts;
 		let settings;
 		try {
@@ -63662,6 +63737,8 @@ var DashboardWriter = class {
 		} catch (e) {
 			throw new Error(`${e.message} in ${target}`, { cause: e });
 		}
+		library = await this.#library(widgets);
+		widgets = merged(widgets, library);
 		let layoutChanged = false;
 		if (o.layout !== void 0) {
 			layout = parseLayout(o.layout);
@@ -63670,8 +63747,26 @@ var DashboardWriter = class {
 		for (const w of o.widgets ?? []) {
 			const clean = checkWidget(w);
 			widgets = [...widgets.filter((x) => x.id !== clean.id), clean];
+			library = [...library.filter((x) => x.id !== clean.id), clean];
+		}
+		for (const [id, byLang] of Object.entries(o.widgetTexts ?? {})) {
+			const w = widgets.find((x) => x.id === id);
+			if (!w) throw new Error(`Unknown custom widget ${id}`);
+			const own = { ...w.texts };
+			for (const [lang, entries] of Object.entries(byLang)) own[lang] = {
+				...own[lang],
+				...entries
+			};
+			const clean = checkWidget({
+				...w,
+				texts: own
+			});
+			widgets = widgets.map((x) => x.id === id ? clean : x);
+			library = library.map((x) => x.id === id ? clean : x);
 		}
-		for (const id of o.removeWidgets ?? []) {
+		const forget = new Set(o.forgetWidgets);
+		library = library.filter((x) => !forget.has(x.id));
+		for (const id of [...o.removeWidgets ?? [], ...forget]) {
 			widgets = widgets.filter((x) => x.id !== id);
 			for (const [board, list] of Object.entries(layout.boards)) if (list.some((i) => i.widget === id)) {
 				layout = withBoard(layout, board, list.filter((i) => i.widget !== id));
@@ -63698,7 +63793,8 @@ var DashboardWriter = class {
 			if (!Object.hasOwn(texts, lang)) throw new Error(`The page has no added texts for ${lang}: built-in languages are chosen with writeDashboard settings.languages`);
 			delete texts[lang];
 		}
-		const changed = layoutChanged || o.widgets !== void 0 || o.removeWidgets !== void 0 || o.languages !== void 0 || o.removeLanguages !== void 0;
+		const changed = layoutChanged || o.widgets !== void 0 || o.removeWidgets !== void 0 || o.forgetWidgets !== void 0 || o.widgetTexts !== void 0 || o.languages !== void 0 || o.removeLanguages !== void 0;
+		if (o.widgets !== void 0 || o.forgetWidgets !== void 0 || o.widgetTexts !== void 0) await this.#saveLibrary(library);
 		if (changed) {
 			if (layoutChanged) layout = {
 				...layout,
@@ -63713,12 +63809,15 @@ var DashboardWriter = class {
 			path: target,
 			changed,
 			layout,
-			customWidgets: widgets.map(({ id, title, span, types }) => ({
-				id,
-				title,
-				span: span ?? 1,
-				...types ? { types } : {}
+			customWidgets: widgets.map((w) => ({
+				id: w.id,
+				title: w.title,
+				span: spanOf(w.span),
+				...w.types ? { types: w.types } : {},
+				...w.texts ? { texts: w.texts } : {},
+				library: library.some((l) => l.id === w.id)
 			})),
+			pageLanguages: pageLanguages(page, settings),
 			languages: missingTexts(page),
 			catalogue: CATALOGUE.filter((c) => !c.needs || !settings.exclude?.includes(c.needs)).map((c) => ({
 				id: c.id,
@@ -63731,6 +63830,38 @@ var DashboardWriter = class {
 			...o.englishTexts ? { englishTexts: en_default } : {}
 		};
 	}
+	/**
+	* The widget library. Without a library file, the first page that has custom widgets starts it, so
+	* the widgets made before the library existed join it.
+	*/
+	async #library(seed) {
+		const file = resolve(this.dataDir, LIBRARY_FILE);
+		let text;
+		try {
+			text = await readFile(file, "utf8");
+		} catch (e) {
+			if (e.code !== "ENOENT") throw e;
+			if (seed.length > 0) await this.#saveLibrary(seed);
+			return seed;
+		}
+		try {
+			const list = JSON.parse(text);
+			if (!Array.isArray(list)) throw new Error("not a list of widgets");
+			return list.map((w) => checkWidget(w));
+		} catch (e) {
+			throw new Error(`${file}: ${e.message}; correct or delete the file`, { cause: e });
+		}
+	}
+	#saveLibrary(widgets) {
+		return writeAtomically(resolve(this.dataDir, LIBRARY_FILE), `${JSON.stringify(widgets, null, 2)}\n`);
+	}
+	/** The page with the library in its widgets block; `old` is the page that it replaces, to start the library. */
+	async #withLibrary(page, old) {
+		if (!marker("widgets").test(page)) return page;
+		const own = readBlock(page, "widgets") ?? [];
+		const before = old === void 0 ? [] : readBlock(old, "widgets") ?? [];
+		return writeBlock(page, "widgets", merged(own, await this.#library(before)));
+	}
 	/** The data for `weeks`; the same snapshot for 15 minutes, so the notes match the digest they come from. */
 	async #data(weeks) {
 		const covered = weeksCovered(weeks);
@@ -63746,11 +63877,15 @@ var DashboardWriter = class {
 	}
 	/** The page file: relative paths sit in the data dir; only .html files. */
 	#target(path) {
-		const target = resolve(this.dataDir, (path ?? "garmin-dashboard.html").replace(/^~(?=$|[/\\])/, homedir()));
-		if (!/\.html$/i.test(target)) throw new Error(`The dashboard must be an .html file: ${target}`);
-		return target;
+		return pageTarget(this.dataDir, path);
 	}
 };
+/** The absolute page file: a relative path is inside the data dir; only .html files. */
+function pageTarget(dataDir, path) {
+	const target = resolve(dataDir, (path || "garmin-dashboard.html").replace(/^~(?=$|[/\\])/, homedir()));
+	if (!/\.html$/i.test(target)) throw new Error(`The dashboard must be an .html file: ${target}`);
+	return target;
+}
 /** The boards: All, Recovery, the type boards, and a board for any other SDK sport. */
 const TYPES = /* @__PURE__ */ new Set([
 	"all",
@@ -63759,6 +63894,8 @@ const TYPES = /* @__PURE__ */ new Set([
 	...Object.values(Profile.types.sport)
 ]);
 const spanOf = (v) => Math.min(3, Math.max(1, Math.round(Number(v) || 1)));
+/** The page's custom widgets and the library; the library version wins on the same id. */
+const merged = (own, library) => [...own.filter((w) => !library.some((l) => l.id === w.id)), ...library];
 /** A custom widget that the page can run; throws with what is wrong. */
 function checkWidget(w) {
 	if (CATALOGUE.some((c) => c.id === w.id)) throw new Error(`${w.id} is a built-in widget: give the custom widget another id`);
@@ -63767,14 +63904,41 @@ function checkWidget(w) {
 	if (!w.code?.trim() || w.code.length > 2e4) throw new Error("A widget needs code, at most 20000 characters");
 	const unknown = (w.types ?? []).filter((t) => !TYPES.has(t));
 	if (unknown.length > 0) throw new Error(`Unknown widget types: ${unknown.join(", ")}`);
+	const texts = checkWidgetTexts(w);
 	return {
 		id: w.id,
 		title: w.title.trim(),
 		code: w.code,
 		span: spanOf(w.span),
-		...w.types?.length ? { types: w.types } : {}
+		...w.types?.length ? { types: w.types } : {},
+		...texts ? { texts } : {}
 	};
 }
+/** The texts of a custom widget: language codes, short keys, and the placeholders of the English text. */
+function checkWidgetTexts(w) {
+	const texts = w.texts;
+	if (texts === void 0 || Object.keys(texts).length === 0) return void 0;
+	if (JSON.stringify(texts).length > 2e4) throw new Error(`The texts of ${w.id} are too long: at most 20000 characters`);
+	const problems = [];
+	for (const [lang, entries] of Object.entries(texts)) {
+		if (!/^[a-z]{2,3}(-[A-Z]{2})?$/.test(lang)) {
+			problems.push(`bad language code ${lang}`);
+			continue;
+		}
+		if (!entries || typeof entries !== "object" || Array.isArray(entries)) {
+			problems.push(`${lang}: texts by key`);
+			continue;
+		}
+		for (const [key, text] of Object.entries(entries)) {
+			const english = texts.en?.[key];
+			if (!/^[a-zA-Z][\w.-]{0,40}$/.test(key)) problems.push(`bad key ${key}`);
+			else if (typeof text !== "string" || !text.trim() || text.length > 500) problems.push(`${lang}.${key}: 1 to 500 characters`);
+			else if (english !== void 0 && placeholders(text) !== placeholders(english)) problems.push(`${lang}.${key}: keep the placeholders ${placeholders(english) || "(none)"}`);
+		}
+	}
+	if (problems.length > 0) throw new Error(`Texts of ${w.id}: ${problems.join("; ")}`);
+	return texts;
+}
 const placeholders = (s) => [...new Set(s.match(/\{\w+\}/g) ?? [])].toSorted().join(" ");
 /** Texts of a language: known keys only, strings, with the placeholders of the English text. */
 function checkTexts(lang, entries) {
@@ -63799,6 +63963,30 @@ function pageLanguages(page, s) {
 	];
 	return [...new Set(codes)];
 }
+/**
+* For each custom widget with texts, the page languages it has no texts in. A widget without texts
+* (written before widgets had them) shows fixed text, so there is nothing to add.
+*/
+function widgetGaps(page, languages) {
+	const out = {};
+	for (const w of readBlock(page, "widgets") ?? []) {
+		if (!w.texts) continue;
+		const gaps = languages.filter((code) => !w.texts[code] && !w.texts[code.slice(0, 2)]);
+		if (gaps.length > 0) out[w.id] = gaps;
+	}
+	return out;
+}
+const withMissing = (gaps) => Object.keys(gaps).length > 0 ? { missingWidgetTexts: gaps } : {};
+/** True when the profile locale is not English, not built in and not added to the page. */
+function missingLanguage(page, locale) {
+	if (typeof locale !== "string" || !locale) return false;
+	const known = [
+		"en",
+		...Object.keys(BUILT_IN),
+		...Object.keys(readBlock(page, "i18n") ?? {})
+	];
+	return ![locale, locale.slice(0, 2)].some((code) => known.includes(code));
+}
 /** For each language of the page, the keys that it does not translate. */
 function missingTexts(page) {
 	const t = readBlock(page, "i18n") ?? {};
@@ -63819,14 +64007,19 @@ function registerDashboardWriter(server, writer) {
 			"last `weeks` weeks, and returns its path and a short digest of the data (totals, weekly sums, load,",
 			"best efforts, races, strength top sets, HRV, recovery, fitness age, sync) for the coach notes.",
 			"An existing page keeps all its code, layout and widgets: only its data is replaced. A page from an",
-			"older template gets the new template and keeps its layout and widgets. `layout` writes a new page",
+			"older template gets the new template and keeps its layout and widgets. Every page from the template",
+			"also gets the custom widgets of the widget library (<data-dir>/widgets.json), not placed on a board.",
+			"`layout` writes a new page",
 			"from the template: `preset` (the default widgets) or `blank` (empty boards). `page` writes your own",
 			"page code instead; it must contain /* garmin-data:start */null/* garmin-data:end */. A replaced",
 			"page is kept as <file>.bak. `notes`: at most 5 plain-text coach notes; the server escapes them.",
 			"`settings` replace the page's settings (title, headline, sports, data to leave out, languages,",
 			"themes); without them the page keeps its own. The page holds only the data, languages and themes",
 			"they keep. `pageLanguages` in the result lists the languages of the page's Language menu, and",
-			"`settings` the settings that the page keeps.",
+			"`settings` the settings that the page keeps. `missingProfileLanguage` is the language of the Garmin",
+			"profile when the page has no texts in it (it shows English); editDashboard `languages` adds it.",
+			"`missingWidgetTexts` lists the custom widgets that miss texts in a language of the page, with",
+			"those languages; editDashboard `widgetTexts` adds them.",
 			"`preview: true` writes nothing: it returns the digest and the activities of each board."
 		].join("\n"),
 		inputSchema: object({
@@ -63858,7 +64051,10 @@ function registerDashboardWriter(server, writer) {
 			"custom widgets, the missing texts of each language, the catalogue of built-in widgets and `widgetApi`,",
 			"the guide to writing a custom widget. `layout` replaces the whole layout (the text of the page's",
 			"'Copy layout'); `place` adds widgets at the end of a board; `widgets` adds or replaces custom widgets",
-			"by id; `removeWidgets` removes them, also from the boards. `languages` adds texts by key, e.g.",
+			"by id and saves them in the widget library (<data-dir>/widgets.json), which every page from the",
+			"template gets; `removeWidgets` removes them from this page and its boards, `forgetWidgets` also",
+			"from the library. `widgetTexts` adds texts to custom widgets by id, language and key, e.g.",
+			"{\"longest-ride\": {\"de\": {\"title\": \"Längste Fahrt\"}}}. `languages` adds page texts by key, e.g.",
 			"{\"de\": {\"title\": \"Training + Erholung\"}}: keys and {placeholders} as in `englishTexts: true`; a",
 			"text with \"|\" has a singular and a plural form. Missing texts show in English.",
 			"`removeLanguages` removes languages that `languages` added."
@@ -63876,9 +64072,12 @@ function registerDashboardWriter(server, writer) {
 				title: string(),
 				code: string().describe("The body of a function (el, ctx): see widgetApi"),
 				span: number$1().int().optional(),
-				types: array(string()).describe("Types the widget can show").optional()
+				types: array(string()).describe("Types the widget can show").optional(),
+				texts: record(string(), record(string(), string())).describe("Texts by language code and key; title is the title: see widgetApi").optional()
 			})).optional(),
-			removeWidgets: array(string()).describe("Ids of custom widgets").optional(),
+			removeWidgets: array(string()).describe("Ids of custom widgets to remove from this page").optional(),
+			forgetWidgets: array(string()).describe("Ids of custom widgets to remove from the library and from this page").optional(),
+			widgetTexts: record(string(), record(string(), record(string(), string()))).describe("Texts of custom widgets by widget id, language code and key").optional(),
 			languages: record(string(), record(string(), string())).describe("Texts by language code and key").optional(),
 			removeLanguages: array(string()).describe("Codes of added languages, e.g. de").optional(),
 			englishTexts: boolean().describe("Also return the English texts to translate").optional(),
@@ -63889,24 +64088,584 @@ function registerDashboardWriter(server, writer) {
 		text: JSON.stringify(await writer.edit(a))
 	}] }));
 }
+// src/schedule.ts
+/**
+* The automatic refresh of dashboard pages: one job in the scheduler of the operating system (launchd,
+* cron or Task Scheduler) runs `refresh --auto`, which updates the pages listed in
+* `<data-dir>/auto-refresh.json`. Nothing is installed until the user asks.
+*/
+const DAYS = [
+	"sunday",
+	"monday",
+	"tuesday",
+	"wednesday",
+	"thursday",
+	"friday",
+	"saturday"
+];
+const MONTHS = [
+	"January",
+	"February",
+	"March",
+	"April",
+	"May",
+	"June",
+	"July",
+	"August",
+	"September",
+	"October",
+	"November",
+	"December"
+];
+/** Garmin gets about 8 requests per refresh: two runs must be at least this far apart. */
+const MIN_GAP_MINUTES = 60;
+/** Runs a command without a shell; its output never reaches our stdout. */
+const run = (cmd, args, input) => new Promise((ok, fail) => {
+	const p = spawn(cmd, args, { stdio: "pipe" });
+	let stdout = "";
+	let stderr = "";
+	p.stdout.on("data", (d) => stdout += d);
+	p.stderr.on("data", (d) => stderr += d);
+	p.on("error", fail);
+	p.on("close", (code) => ok({
+		code: code ?? 1,
+		stdout,
+		stderr
+	}));
+	p.stdin.end(input ?? "");
+});
+const STATE_FILE = "auto-refresh.json";
+const DEFAULT_CRON = "0 7 * * *";
+const LABEL = "com.indaco.garmin-personal-mcp.refresh";
+const TASK = "garmin-personal-mcp refresh";
+const MARK = "# garmin-personal-mcp refresh";
+const FIELDS = [
+	[
+		"minute",
+		0,
+		59
+	],
+	[
+		"hour",
+		0,
+		23
+	],
+	[
+		"day of month",
+		1,
+		31
+	],
+	[
+		"month",
+		1,
+		12
+	],
+	[
+		"weekday",
+		0,
+		7
+	]
+];
+/** One cron field: *, n, a-b, with an optional /step, separated by commas. */
+function field(text, [label, min, max]) {
+	const values = /* @__PURE__ */ new Set();
+	for (const part of text.split(",")) {
+		const m = /^(\*|(\d+)(?:-(\d+))?)(?:\/(\d+))?$/.exec(part);
+		const from = m?.[2] === void 0 ? min : Number(m[2]);
+		const to = m?.[3] !== void 0 ? Number(m[3]) : m?.[2] === void 0 || m[4] ? max : from;
+		const step = m?.[4] === void 0 ? 1 : Number(m[4]);
+		if (!m || from < min || to > max || from > to || step < 1) throw new Error(`Cron ${label}: "${part}" is not ${min}-${max}, a list, a range or a /step`);
+		for (let v = from; v <= to; v += step) values.add(label === "weekday" && v === 7 ? 0 : v);
+	}
+	return [...values].toSorted((a, b) => a - b);
+}
+/** Reads and checks a cron expression: numbers only, and at least an hour between two runs. */
+function parseCron(text) {
+	const parts = text.trim().split(/\s+/);
+	if (parts.length !== 5) throw new Error(`Cron: 5 fields, minute hour day-of-month month weekday (0 = Sunday), e.g. "0 7 * * 1"`);
+	const [minutes, hours, days, months, weekdays] = parts.map((p, i) => field(p, FIELDS[i]));
+	const times = hours.flatMap((h) => minutes.map((m) => h * 60 + m)).toSorted((a, b) => a - b);
+	const gaps = times.map((t, i) => (i === 0 ? t + 1440 : t) - times[(i || times.length) - 1]);
+	if (times.length > 1 && Math.min(...gaps) < MIN_GAP_MINUTES) throw new Error("Cron: the runs must be at least 1 hour apart");
+	const cron = {
+		text: parts.join(" "),
+		times,
+		...parts[2].startsWith("*") ? {} : { days },
+		...parts[3].startsWith("*") ? {} : { months },
+		...parts[4].startsWith("*") ? {} : { weekdays }
+	};
+	if (nextRuns(cron, /* @__PURE__ */ new Date(), 1).length === 0) throw new Error("Cron: this date never comes");
+	return cron;
+}
+/** The CLI forms: daily [HH:MM], weekdays [HH:MM], weekly <day> [HH:MM], or a cron expression. */
+function cronOf(words) {
+	if (words.length === 1 && words[0].trim().includes(" ")) return words[0];
+	const [kind, ...rest] = words.map((w) => w.toLowerCase());
+	const day = kind === "weekly" && rest[0] && !rest[0].includes(":") ? DAYS.indexOf(rest.shift()) : 1;
+	const m = /^([01]?\d|2[0-3]):([0-5]\d)$/.exec(rest[0] ?? "07:00");
+	const weekday = {
+		daily: "*",
+		weekdays: "1-5",
+		weekly: String(day)
+	}[kind ?? ""];
+	if (!weekday || !m || rest.length > 1 || day < 0) throw new Error("Schedule: daily [HH:MM], weekdays [HH:MM], weekly <day> [HH:MM] or a cron expression in quotes, e.g. \"0 7 * * 1\"");
+	return `${Number(m[2])} ${Number(m[1])} * * ${weekday}`;
+}
+/** Whether the job runs on that day. */
+function runsOn(c, d) {
+	if (c.months && !c.months.includes(d.getMonth() + 1)) return false;
+	if (c.days && c.weekdays) return c.days.includes(d.getDate()) || c.weekdays.includes(d.getDay());
+	if (c.days) return c.days.includes(d.getDate());
+	return c.weekdays?.includes(d.getDay()) ?? true;
+}
+const pad = (n) => String(n).padStart(2, "0");
+/** The next `count` runs after `from`, as local "YYYY-MM-DD HH:MM"; empty when the date never comes. */
+function nextRuns(c, from, count) {
+	const runs = [];
+	for (let i = 0; i < 2928 && runs.length < count; i++) {
+		const d = new Date(from.getFullYear(), from.getMonth(), from.getDate() + i);
+		if (!runsOn(c, d)) continue;
+		for (const t of c.times) {
+			const at = new Date(d.getFullYear(), d.getMonth(), d.getDate(), Math.floor(t / 60), t % 60);
+			if (at > from && runs.length < count) runs.push(`${at.getFullYear()}-${pad(at.getMonth() + 1)}-${pad(at.getDate())} ${pad(at.getHours())}:${pad(at.getMinutes())}`);
+		}
+	}
+	return runs;
+}
+const xml = (s) => s.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+/** launchd has no cron syntax: each run time is a dict, and a run matches any dict of the array. */
+function calendar(c) {
+	const months = c.months ?? [void 0];
+	const days = c.days || c.weekdays ? [...(c.days ?? []).map((d) => ({ Day: d })), ...(c.weekdays ?? []).map((w) => ({ Weekday: w }))] : [{}];
+	return c.times.flatMap((t) => months.flatMap((m) => days.map((d) => ({
+		...m === void 0 ? {} : { Month: m },
+		...d,
+		Hour: Math.floor(t / 60),
+		Minute: t % 60
+	}))));
+}
+function plist(job, c) {
+	const when = calendar(c).map((e) => `    <dict>${Object.entries(e).map(([k, v]) => `<key>${k}</key><integer>${v}</integer>`).join("")}</dict>`);
+	const strings = (xs) => xs.map((x) => `    <string>${xml(x)}</string>`).join("\n");
+	const env = Object.entries(job.env).map(([k, v]) => `    <key>${k}</key><string>${xml(v)}</string>`).join("\n");
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>${LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${strings([job.program, ...job.args])}
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+${env}
+  </dict>
+  <key>StartCalendarInterval</key>
+  <array>
+${when.join("\n")}
+  </array>
+  <key>StandardOutPath</key><string>${xml(job.log)}</string>
+  <key>StandardErrorPath</key><string>${xml(job.log)}</string>
+</dict>
+</plist>
+`;
+}
+const sh = (s) => `'${s.replaceAll("'", `'\\''`)}'`;
+/** The crontab line; % is a newline for cron, so it is escaped. */
+function cronLine(job, c) {
+	const command = [
+		...Object.entries(job.env).map(([k, v]) => `${k}=${sh(v)}`),
+		sh(job.program),
+		...job.args.map(sh),
+		">>",
+		sh(job.log),
+		"2>&1"
+	].join(" ");
+	return `${c.text} ${command.replaceAll("%", "\\%")} ${MARK}`;
+}
+/** The crontab with our line replaced (or removed when `line` is undefined); other lines stay. */
+function withCronLine(crontab, line) {
+	return [...crontab.split("\n").filter((l) => l.trim() !== "" && !l.endsWith(MARK)), ...line ? [line] : []].map((l) => `${l}\n`).join("");
+}
+/** The .cmd file the Windows task runs. */
+function windowsScript(job) {
+	const env = Object.entries(job.env).map(([k, v]) => k === "PATH" ? `set "PATH=${v};%PATH%"` : `set "${k}=${v}"`);
+	const command = [job.program, ...job.args].map((a) => `"${a}"`).join(" ");
+	return [
+		"@echo off",
+		...env,
+		`call ${command} >> "${job.log}" 2>&1`,
+		""
+	].join("\r\n");
+}
+const tags = (names) => names.map((n) => `<${n} />`).join("");
+/**
+* The Task Scheduler task: schtasks /SC cannot say most cron schedules, so each run time is a calendar
+* trigger. StartWhenAvailable runs a time that the computer missed, as launchd does.
+*/
+function taskXml(script, c) {
+	const months = `<Months>${tags((c.months ?? MONTHS.map((_, i) => i + 1)).map((m) => MONTHS[m - 1]))}</Months>`;
+	const weekdays = c.weekdays ? `<DaysOfWeek>${tags(c.weekdays.map((w) => DAYS[w][0].toUpperCase() + DAYS[w].slice(1)))}</DaysOfWeek>` : "";
+	const byMonth = (days) => `<ScheduleByMonth><DaysOfMonth>${days.map((d) => `<Day>${d}</Day>`).join("")}</DaysOfMonth>${months}</ScheduleByMonth>`;
+	const schedules = [
+		...c.days ? [byMonth(c.days)] : [],
+		...c.weekdays ? [c.months ? `<ScheduleByMonthDayOfWeek><Weeks><Week>1</Week><Week>2</Week><Week>3</Week><Week>4</Week><Week>Last</Week></Weeks>${weekdays}${months}</ScheduleByMonthDayOfWeek>` : `<ScheduleByWeek><WeeksInterval>1</WeeksInterval>${weekdays}</ScheduleByWeek>`] : [],
+		...c.days || c.weekdays ? [] : [c.months ? byMonth(Array.from({ length: 31 }, (_, i) => i + 1)) : "<ScheduleByDay><DaysInterval>1</DaysInterval></ScheduleByDay>"]
+	];
+	const triggers = c.times.flatMap((t) => schedules.map((s) => `    <CalendarTrigger><StartBoundary>2026-01-01T${pad(Math.floor(t / 60))}:${pad(t % 60)}:00</StartBoundary>${s}</CalendarTrigger>`));
+	return `<?xml version="1.0" encoding="UTF-16"?>
+<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
+  <RegistrationInfo><Description>Updates the Garmin dashboard pages (${xml(c.text)})</Description></RegistrationInfo>
+  <Triggers>
+${triggers.join("\n")}
+  </Triggers>
+  <Settings>
+    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
+    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
+    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
+    <StartWhenAvailable>true</StartWhenAvailable>
+    <ExecutionTimeLimit>PT1H</ExecutionTimeLimit>
+  </Settings>
+  <Actions><Exec><Command>${xml(script)}</Command></Exec></Actions>
+</Task>
+`;
+}
+var AutoRefresh = class {
+	config;
+	platform;
+	home;
+	exec;
+	nodeDir;
+	entry;
+	constructor(config, platform = process.platform, home = homedir(), exec = run, nodeDir = dirname(process.execPath), entry = realEntry(process.argv[1])) {
+		this.config = config;
+		this.platform = platform;
+		this.home = home;
+		this.exec = exec;
+		this.nodeDir = nodeDir;
+		this.entry = entry;
+	}
+	get #stateFile() {
+		return join(this.config.dataDir, STATE_FILE);
+	}
+	get #plist() {
+		return join(this.home, "Library/LaunchAgents", `${LABEL}.plist`);
+	}
+	get #script() {
+		return join(this.config.dataDir, "auto-refresh.cmd");
+	}
+	get #taskFile() {
+		return join(this.config.dataDir, "auto-refresh-task.xml");
+	}
+	get #log() {
+		return join(this.home, ".cache/garmin-personal-mcp/refresh.log");
+	}
+	get #scheduler() {
+		return {
+			darwin: "launchd",
+			linux: "cron",
+			win32: "Task Scheduler"
+		}[this.platform];
+	}
+	/** The pages that `refresh --auto` updates. */
+	async pages() {
+		return (await this.#state())?.pages ?? [];
+	}
+	async status() {
+		const state = await this.#state();
+		if (!state) return { scheduled: false };
+		return {
+			scheduled: true,
+			cron: state.cron,
+			next: nextRuns(parseCron(state.cron), /* @__PURE__ */ new Date(), 3),
+			pages: state.pages,
+			scheduler: this.#scheduler,
+			installed: await this.#installed(),
+			log: this.#log
+		};
+	}
+	/** Adds the page (default: the main dashboard) and sets the cron, or keeps the current one. */
+	async set(o) {
+		if (!this.#scheduler) throw new Error("Automatic refresh works on macOS, Linux and Windows");
+		if (!existsSync(this.config.apiKeyFile)) throw new Error(`Save the API key in ${this.config.apiKeyFile} first: a scheduled job cannot read the key from your MCP client`);
+		const page = pageTarget(this.config.dataDir, o.path);
+		if (!existsSync(page)) throw new Error(`${page} does not exist: make it first with the training-dashboard prompt`);
+		const old = await this.#state();
+		const cron = parseCron(o.cron ?? old?.cron ?? DEFAULT_CRON);
+		const pages = [.../* @__PURE__ */ new Set([...old?.pages ?? [], page])];
+		await this.#install(cron);
+		await writeFile(this.#stateFile, `${JSON.stringify({
+			cron: cron.text,
+			pages
+		}, null, 2)}\n`);
+		return this.status();
+	}
+	/** Removes the page; without a page, or when no page is left, removes the job. */
+	async off(path) {
+		const old = await this.#state();
+		if (!old) return { scheduled: false };
+		const pages = path ? old.pages.filter((p) => p !== pageTarget(this.config.dataDir, path)) : [];
+		if (pages.length > 0) {
+			await writeFile(this.#stateFile, `${JSON.stringify({
+				...old,
+				pages
+			}, null, 2)}\n`);
+			return this.status();
+		}
+		await this.#uninstall();
+		await rm(this.#stateFile, { force: true });
+		return { scheduled: false };
+	}
+	#job() {
+		const win = this.platform === "win32";
+		const npx = this.entry === "" || /[/\\]_npx[/\\]/.test(this.entry);
+		return {
+			program: join(this.nodeDir, npx ? win ? "npx.cmd" : "npx" : win ? "node.exe" : "node"),
+			args: [
+				...npx ? ["-y", `${name}@latest`] : [this.entry],
+				"refresh",
+				"--auto"
+			],
+			env: {
+				GARMIN_DATA_DIR: this.config.dataDir,
+				GARMIN_API_KEY_FILE: this.config.apiKeyFile,
+				GARMIN_BASE_URL: this.config.baseUrl,
+				PATH: win ? this.nodeDir : [
+					this.nodeDir,
+					"/usr/bin",
+					"/bin"
+				].join(delimiter)
+			},
+			log: this.#log
+		};
+	}
+	async #install(c) {
+		await mkdir(dirname(this.#log), { recursive: true });
+		const job = this.#job();
+		if (this.platform === "darwin") {
+			await mkdir(dirname(this.#plist), { recursive: true });
+			await writeFile(this.#plist, plist(job, c));
+			await this.exec("launchctl", [
+				"bootout",
+				this.#domain(),
+				this.#plist
+			]);
+			await this.#must("launchctl", [
+				"bootstrap",
+				this.#domain(),
+				this.#plist
+			]);
+		} else if (this.platform === "linux") await this.#must("crontab", ["-"], withCronLine(await this.#crontab(), cronLine(job, c)));
+		else {
+			await writeFile(this.#script, windowsScript(job));
+			await writeFile(this.#taskFile, Buffer.from(`\ufeff${taskXml(this.#script, c)}`, "utf16le"));
+			await this.#must("schtasks", [
+				"/Create",
+				"/F",
+				"/TN",
+				TASK,
+				"/XML",
+				this.#taskFile
+			]);
+		}
+	}
+	async #uninstall() {
+		if (this.platform === "darwin") {
+			await this.exec("launchctl", [
+				"bootout",
+				this.#domain(),
+				this.#plist
+			]);
+			await rm(this.#plist, { force: true });
+		} else if (this.platform === "linux") await this.#must("crontab", ["-"], withCronLine(await this.#crontab(), void 0));
+		else {
+			await this.exec("schtasks", [
+				"/Delete",
+				"/F",
+				"/TN",
+				TASK
+			]);
+			await rm(this.#script, { force: true });
+			await rm(this.#taskFile, { force: true });
+		}
+	}
+	async #installed() {
+		if (this.platform === "darwin") return existsSync(this.#plist);
+		if (this.platform === "linux") return (await this.#crontab()).includes(MARK);
+		return (await this.exec("schtasks", [
+			"/Query",
+			"/TN",
+			TASK
+		])).code === 0;
+	}
+	#domain() {
+		return `gui/${process.getuid()}`;
+	}
+	/** The user's crontab; "" when there is none (crontab -l then exits with 1). */
+	async #crontab() {
+		const r = await this.exec("crontab", ["-l"]);
+		return r.code === 0 ? r.stdout : "";
+	}
+	async #must(cmd, args, input) {
+		const r = await this.exec(cmd, args, input);
+		if (r.code !== 0) throw new Error(`${cmd} failed (${r.code}): ${(r.stderr || r.stdout).trim()}`);
+	}
+	async #state() {
+		const text = await readFile(this.#stateFile, "utf8").catch(() => void 0);
+		return text === void 0 ? void 0 : JSON.parse(text);
+	}
+};
+/** The real path of the running script, so the job does not follow a link that can change. */
+function realEntry(path) {
+	try {
+		return path ? realpathSync(path) : "";
+	} catch {
+		return "";
+	}
+}
+/** Updates each page; one failure does not stop the others. Returns one log line per page. */
+async function refreshPages(writer, pages) {
+	const lines = [];
+	let failed = false;
+	for (const path of pages) {
+		const at = (/* @__PURE__ */ new Date()).toISOString();
+		try {
+			await writer.write({
+				path,
+				onlyExisting: true
+			});
+			lines.push(`${at} updated ${path}`);
+		} catch (e) {
+			failed = true;
+			lines.push(`${at} failed ${path}: ${e.message}`);
+		}
+	}
+	return {
+		lines,
+		failed
+	};
+}
+/** Registers scheduleDashboardRefresh. */
+function registerSchedule(server, auto) {
+	server.registerTool("scheduleDashboardRefresh", {
+		description: [
+			"Turns on, changes or stops the automatic refresh of a dashboard page. Use it only when the user",
+			"asks for it or says yes to the question of a dashboard prompt. A job in the scheduler of the",
+			"computer (launchd, cron or Task Scheduler) replaces the data of the page at the given times, also",
+			"with no assistant open. The refresh removes the coach notes, because old notes do not agree",
+			"with new data. The computer must be on at that time. The page must exist (writeDashboard first).",
+			"`cron`: convert what the user says, in any language, into a 5-field cron expression in local",
+			"time: minute hour day-of-month month weekday, numbers only (0 = Sunday), e.g. \"0 7 * * 1-5\" for",
+			"weekdays at 7. Two runs must be at least 1 hour apart. The cron is for all scheduled pages;",
+			"`path` adds that page (default the main page); `off` stops the refresh of `path`, or of every",
+			"page when no `path` is given. Without arguments it only reads. The reply has `next`, the next",
+			"runs in local time: tell them to the user in their language, so they can check the schedule."
+		].join("\n"),
+		inputSchema: object({
+			cron: string().describe("minute hour day-of-month month weekday, e.g. \"0 7 * * *\"; default 0 7 * * *").optional(),
+			path: string().describe("The .html file; relative paths are inside the data dir").optional(),
+			off: boolean().describe("Stop the refresh").optional()
+		})
+	}, async ({ cron, path, off }) => {
+		const status = off ? await auto.off(path) : cron !== void 0 || path !== void 0 ? await auto.set({
+			cron,
+			path
+		}) : await auto.status();
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(status)
+		}] };
+	});
+}
+// src/cli.ts
+/** The commands for a terminal or a scheduler; any other start is the MCP server. */
+const COMMANDS = ["refresh", "schedule"];
+/**
+* Runs `refresh [page.html | --auto]` or
+* `schedule [daily|weekdays|weekly <day>] [HH:MM] | "<cron>" | off`, each with an optional page.
+* Not MCP, so the result may go to stdout.
+*/
+async function cli(command, args, auto, writer) {
+	try {
+		if (command === "refresh") {
+			const pages = args[0] === "--auto" ? await auto.pages() : [args[0] ?? ""];
+			const { lines, failed } = await refreshPages(writer(), pages);
+			return {
+				code: failed ? 1 : 0,
+				stdout: lines.join("\n")
+			};
+		}
+		const rest = [...args];
+		const path = rest.at(-1)?.toLowerCase().endsWith(".html") ? rest.pop() : void 0;
+		return {
+			code: 0,
+			stdout: summary(rest[0] === "off" ? await auto.off(path) : rest.length === 0 && path === void 0 ? await auto.status() : await auto.set({
+				...rest.length > 0 ? { cron: cronOf(rest) } : {},
+				path
+			}))
+		};
+	} catch (e) {
+		return {
+			code: 1,
+			stderr: `${command} failed: ${e.message}`
+		};
+	}
+}
+function summary(s) {
+	if (!s.scheduled) return "Automatic refresh is off.";
+	return [
+		`Automatic refresh "${s.cron}" with ${s.scheduler}, next: ${s.next.join(", ")}`,
+		"Pages:",
+		...s.pages.map((p) => `  ${p}`),
+		...s.installed ? [] : [`The job is missing from ${s.scheduler}: run the schedule again.`],
+		`Log: ${s.log}`
+	].join("\n");
+}
+// src/config.ts
+/** Defaults reuse an existing ~/.config/garmin-mcp/api-key and ~/workspace/garmin-data. */
+function loadConfig(env = process.env) {
+	return {
+		baseUrl: env.GARMIN_BASE_URL || "https://personal.connectapi.garmin.com",
+		apiKeyFile: env.GARMIN_API_KEY_FILE || join(homedir(), ".config/garmin-mcp/api-key"),
+		dataDir: env.GARMIN_DATA_DIR || join(homedir(), "workspace/garmin-data")
+	};
+}
 // src/server.ts
 /** The page template; the build writes it next to dist/index.js. */
 const template = () => readFile(new URL("./dashboard.html", import.meta.url), "utf8");
-/** The garmin-personal MCP server with its 15 tools and 5 prompts. */
+/** The tools, the dashboard data and the page writer, wired to one API client. */
+function createParts(config) {
+	const api = new GarminApiClient(config);
+	const tools = new GarminTools(api, config.dataDir);
+	const dashboard = new GarminDashboard(tools, api, config.dataDir);
+	return {
+		tools,
+		dashboard,
+		writer: new DashboardWriter((weeks) => dashboard.getDashboardData(weeks), config.dataDir, template)
+	};
+}
+/** The garmin-personal MCP server with its tools and prompts. */
 function createServer(config) {
 	const server = new McpServer({
 		name: "garmin-personal",
 		version
 	});
-	const api = new GarminApiClient(config);
-	const tools = new GarminTools(api, config.dataDir);
+	const { tools, dashboard, writer } = createParts(config);
 	registerTools(server, tools);
-	const dashboard = new GarminDashboard(tools, api, config.dataDir);
 	registerDashboard(server, dashboard);
-	registerDashboardWriter(server, new DashboardWriter((weeks) => dashboard.getDashboardData(weeks), config.dataDir, template));
+	registerDashboardWriter(server, writer);
+	registerSchedule(server, new AutoRefresh(config));
 	registerPrompts(server);
 	return server;
 }
 // src/index.ts
-serveStdio(() => createServer(loadConfig()));
+const [command = "", ...args] = process.argv.slice(2);
+if (COMMANDS.includes(command)) {
+	const config = loadConfig();
+	const r = await cli(command, args, new AutoRefresh(config), () => createParts(config).writer);
+	if (r.stdout) process.stdout.write(`${r.stdout}\n`);
+	if (r.stderr) process.stderr.write(`${r.stderr}\n`);
+	process.exitCode = r.code;
+} else serveStdio(() => createServer(loadConfig()));
 export {};