@indaco/garmin-personal-mcp 0.3.1 → 0.3.2

package/README.md

@@ -39,7 +39,8 @@
 
 ## What you can ask
 
-With this server, you can ask your assistant:
+Ask your assistant anything about your Garmin data, in your own words and in any language. The
+assistant chooses the tools and can combine their data. Some examples:
 
 - Activities: "List my last 5 activities, with pace and heart rate."
 - Activities: "How much time did I spend in each HR zone on my runs this month?"
@@ -211,7 +212,9 @@ In Claude Code, the arguments are in order and separated by spaces: first `weeks
 You can also give only the layout: `/garmin-personal:training-dashboard freeform`.
 
 With `preset` and `blank`, the assistant first asks for the title and the headline (the line under
-the title) of the page. Keep them or type your own. Updates and the automatic update keep them.
+the title) of the page. Keep them or type your own. Updates and the automatic update keep them. When
+the page has other settings, for example only one sport, the assistant tells you these settings and
+asks you to keep them, to use the defaults or to type your own choice.
 
 The assistant gives you the path of the page and the command to open it. The page has a board for
 all your training, a Recovery board and a board for each sport, with 11 themes, in English and the

package/dist/index.js

@@ -24096,7 +24096,7 @@ function toError(value) {
 }
 // package.json
 var name = "@indaco/garmin-personal-mcp";
-var version = "0.3.1";
+var version = "0.3.2";
 // 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;
@@ -63517,6 +63517,10 @@ function settingsOf(page) {
 	const s = page === void 0 ? void 0 : readBlock(page, "settings");
 	return s && typeof s === "object" ? s : {};
 }
+/** The settings block of the page cannot be read: only new settings, or a new file, help. */
+function unreadable(e, target) {
+	return new Error(`${e.message} in ${target}: give new settings, or delete the file`, { cause: e });
+}
 /** The number of items for each key. */
 function countBy(items, key) {
 	const out = {};
@@ -63636,12 +63640,18 @@ var DashboardWriter = class {
 		const run = this.#queue.then(async () => {
 			const target = this.#target(options.path);
 			const old = await readExisting(target);
-			const settings = options.settings ? checkSettings(options.settings) : settingsOf(old);
+			let settings;
+			try {
+				settings = options.settings ? checkSettings(options.settings) : settingsOf(old);
+			} catch (e) {
+				throw options.settings ? e : unreadable(e, target);
+			}
 			const data = JSON.parse(await this.#data(options.weeks ?? weeksOf(old)));
 			return {
 				path: target,
 				boards: countBy(listOf(data.activities), groupOf),
-				digest: digest(filterData(data, settings))
+				digest: digest(filterData(data, settings)),
+				settings
 			};
 		});
 		this.#queue = run.catch(() => {});
@@ -63656,13 +63666,13 @@ var DashboardWriter = class {
 		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;
+		let broken = false;
 		try {
 			oldSettings = settingsOf(old);
 		} catch (e) {
-			if (asked === void 0) throw new Error(`${e.message} in ${target}: give new settings, or delete the file`, { cause: e });
+			if (asked === void 0) throw unreadable(e, target);
 			oldSettings = {};
-			unreadable = true;
+			broken = true;
 		}
 		const own = asked ?? oldSettings;
 		const template = await this.template();
@@ -63678,7 +63688,7 @@ var DashboardWriter = class {
 				boards: {}
 			});
 			kind = old === void 0 ? "created" : "replaced";
-		} else if (templateVersion(old) > 0 && (templateVersion(old) < templateVersion(template) || !same(own, oldSettings) || unreadable)) {
+		} else if (templateVersion(old) > 0 && (templateVersion(old) < templateVersion(template) || !same(own, oldSettings) || broken)) {
 			next = writeBlock(template, "layout", readBlock(old, "layout") ?? null);
 			next = writeBlock(next, "widgets", readBlock(old, "widgets") ?? []);
 			next = writeBlock(next, "i18n", readBlock(old, "i18n") ?? {});
@@ -64020,7 +64030,8 @@ function registerDashboardWriter(server, writer) {
 			"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."
+			"`preview: true` writes nothing: it returns the digest, the activities of each board and the",
+			"`settings` of the page."
 		].join("\n"),
 		inputSchema: object({
 			weeks: number$1().int().describe("Weeks to cover, default 12, max 52").optional(),
@@ -64038,7 +64049,7 @@ function registerDashboardWriter(server, writer) {
 				themes: array(string()).describe(`Themes to keep: ${THEMES.map((t) => t.id).join(", ")}`).optional(),
 				theme: string().describe("Default theme").optional()
 			}).describe("The page settings; replaces the page's own").optional(),
-			preview: boolean().describe("Write nothing: return the digest and the activities of each board").optional()
+			preview: boolean().describe("Write nothing: return the digest, the activities of each board and the page settings").optional()
 		})
 	}, async ({ preview, ...a }) => ({ content: [{
 		type: "text",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indaco/garmin-personal-mcp",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "MCP server for the official Garmin Connect Personal API",
   "homepage": "https://github.com/indaco/garmin-personal-mcp#readme",
   "bugs": "https://github.com/indaco/garmin-personal-mcp/issues",

package/prompts/training-dashboard.md

@@ -2,23 +2,34 @@ You are a data-minded endurance coach. Using the tools of the `garmin-personal`
 personal **training + recovery dashboard** for the last **{{weeks}} weeks** (today is {{today}}).
 Answer in my language.
 
-1. First ask two questions. If your client has a tool for questions with choices, use it; without
-   one, ask in chat as numbered lists, with the default first:
-   - **Title**: options "Keep the title" (default: the title of the page, "{{title}}" for a new
-     page) and "Type my own".
-   - **Headline** (the line under the title): options "Keep the headline" (default: the headline of
-     the page, "{{headline}}" for a new page) and "Type my own".
+1. Call `writeDashboard` with `preview` = true and `weeks` = {{weeks}}. It writes nothing. Its
+   `settings` are the settings of the page, or none when there is no page.
+2. Then ask the questions below. If your client has a tool for questions with choices, use it;
+   without one, ask in chat as numbered lists, with the default first:
+   - **Settings**: only when `settings` has more than `title` and `headline`. Tell me those settings
+     in words, for example "only strength training", "without sleep data" or "Italian only". If
+     `settings` has `exclude`, name each item it leaves out and say that the defaults put them back
+     into the page, also on each automatic update: this matters for a page that I share.
+     Options "Keep these settings" (default) and "Use the defaults: all sports, all data, English and
+     the language of my Garmin profile, all themes, opens in midnight". Say that I can type my own
+     choice, for example "all sports, keep the rest".
+   - **Title**: options "Keep the title" (default: the `title` of `settings`, else "{{title}}") and
+     "Type my own".
+   - **Headline** (the line under the title): options "Keep the headline" (default: the `headline`
+     of `settings`, else "{{headline}}") and "Type my own".
    When I choose "Type my own" and give no text, ask for the text in chat.
-2. Call `writeDashboard` with `weeks` = {{weeks}} and `layout` = "{{layout}}". The server gets the
-   data, writes the page from its template, and returns the path of the page and a digest of the
-   data. An existing page stays as a `.bak` file.
-3. Write at most 5 coach notes from the digest. Each note names a specific number of the digest, for
+3. Call `writeDashboard` with `weeks` = {{weeks}} and `layout` = "{{layout}}". If I chose the
+   defaults, also give `settings` = only the `title` and `headline` of `settings`, the ones that it
+   has. If I typed my own choice, give `settings` = `settings` changed as I said. The server gets
+   the data, writes the page from its template, and returns the path of the page and a digest of
+   the data. An existing page stays as a `.bak` file.
+4. Write at most 5 coach notes from the digest. Each note names a specific number of the digest, for
    example "load ratio 1.18 while HRV was under its weekly average on 3 of the last 7 nights".
    Training suggestions only, no medical advice. Plain text, in my language.
-4. Call `writeDashboard` again with the same `weeks` and the `notes`, without `layout`. The page keeps
+5. Call `writeDashboard` again with the same `weeks` and the `notes`, without `layout`. The page keeps
    its layout. If I typed my own title or headline, also give `settings` = the `settings` of the
    last result with `title` and `headline` set to my texts: the other settings of the page stay.
-5. If the result has `missingProfileLanguage`, say first that my Garmin profile uses that language,
+6. If the result has `missingProfileLanguage`, say first that my Garmin profile uses that language,
    that the page has no texts in it yet, so the page shows English, and that you can add it.
    Make that language the default of the question below instead of "No".
    Tell me the languages of the page (`pageLanguages` of the result) and ask whether to add one.