kahunas-cli 1.0.5 → 1.0.6

package/README.md

@@ -64,6 +64,8 @@ Tokens are saved to:
   - Loads the most recently updated program.
 - `kahunas workout events`
   - Lists workout log events with dates and a human-friendly workout summary (from the calendar endpoint).
+- `kahunas workout serve`
+  - Starts a local dev server with a workout preview page and a JSON endpoint that matches the CLI output.
 - `kahunas workout program <id>`
   - Fetches a program by UUID.
 
@@ -112,6 +114,27 @@ If the user UUID is missing, `workout events` will attempt to discover it from c
 - `KAHUNAS_USER_UUID=...`
 - `--user <uuid>`
 
+### Workout preview server
+
+Run a local dev server to preview workouts in a browser:
+
+```bash
+pnpm kahunas -- workout serve
+```
+
+The HTML page is available at `http://127.0.0.1:3000` and the JSON endpoint is at `http://127.0.0.1:3000/api/workout`.
+The JSON response matches the CLI output for `workout events --latest`, so there is only one data shape to maintain.
+
+Options:
+
+```bash
+pnpm kahunas -- workout serve --program <program-uuid>
+pnpm kahunas -- workout serve --workout <workout-uuid>
+pnpm kahunas -- workout serve --limit 3
+```
+
+Use `?day=<index>` to switch the selected workout day tab in the browser.
+
 ## Auto-login
 
 Most commands auto-login by default if a token is missing or expired. To disable:

package/dist/cli.js

@@ -34,6 +34,7 @@ let node_path = require("node:path");
 node_path = __toESM(node_path);
 let node_readline = require("node:readline");
 node_readline = __toESM(node_readline);
+let node_http = require("node:http");
 
 //#region src/args.ts
 function parseArgs(argv) {
@@ -532,7 +533,7 @@ async function loginAndPersist(options, config, outputMode) {
 //#endregion
 //#region src/usage.ts
 function printUsage() {
-	console.log(`kahunas - CLI for Kahunas API\n\nUsage:\n  kahunas auth set <token> [--base-url URL] [--csrf CSRF] [--web-base-url URL] [--cookie COOKIE] [--csrf-cookie VALUE]\n  kahunas auth token [--csrf CSRF] [--cookie COOKIE] [--csrf-cookie VALUE] [--web-base-url URL] [--raw]\n  kahunas auth login [--web-base-url URL] [--headless] [--raw]\n  kahunas auth status [--token TOKEN] [--base-url URL] [--auto-login] [--headless]\n  kahunas auth show\n  kahunas checkins list [--page N] [--rpp N] [--token TOKEN] [--base-url URL] [--raw] [--no-auto-login] [--headless]\n  kahunas workout list [--page N] [--rpp N] [--token TOKEN] [--base-url URL] [--raw] [--no-auto-login] [--headless]\n  kahunas workout pick [--page N] [--rpp N] [--token TOKEN] [--base-url URL] [--raw] [--no-auto-login] [--headless]\n  kahunas workout latest [--token TOKEN] [--base-url URL] [--raw] [--no-auto-login] [--headless]\n  kahunas workout events [--user UUID] [--timezone TZ] [--program UUID] [--workout UUID] [--minimal] [--full] [--latest] [--limit N] [--debug-preview] [--raw] [--no-auto-login] [--headless]\n  kahunas workout sync [--headless]\n  kahunas workout program <id> [--csrf CSRF] [--token TOKEN] [--base-url URL] [--raw] [--no-auto-login] [--headless]\n\nEnv:\n  KAHUNAS_TOKEN=...\n  KAHUNAS_CSRF=...\n  KAHUNAS_CSRF_COOKIE=...\n  KAHUNAS_COOKIE=...\n  KAHUNAS_WEB_BASE_URL=...\n  KAHUNAS_USER_UUID=...\n\nConfig:\n  ${CONFIG_PATH}`);
+	console.log(`kahunas - CLI for Kahunas API\n\nUsage:\n  kahunas auth set <token> [--base-url URL] [--csrf CSRF] [--web-base-url URL] [--cookie COOKIE] [--csrf-cookie VALUE]\n  kahunas auth token [--csrf CSRF] [--cookie COOKIE] [--csrf-cookie VALUE] [--web-base-url URL] [--raw]\n  kahunas auth login [--web-base-url URL] [--headless] [--raw]\n  kahunas auth status [--token TOKEN] [--base-url URL] [--auto-login] [--headless]\n  kahunas auth show\n  kahunas checkins list [--page N] [--rpp N] [--token TOKEN] [--base-url URL] [--raw] [--no-auto-login] [--headless]\n  kahunas workout list [--page N] [--rpp N] [--token TOKEN] [--base-url URL] [--raw] [--no-auto-login] [--headless]\n  kahunas workout pick [--page N] [--rpp N] [--token TOKEN] [--base-url URL] [--raw] [--no-auto-login] [--headless]\n  kahunas workout latest [--token TOKEN] [--base-url URL] [--raw] [--no-auto-login] [--headless]\n  kahunas workout events [--user UUID] [--timezone TZ] [--program UUID] [--workout UUID] [--minimal] [--full] [--latest] [--limit N] [--debug-preview] [--raw] [--no-auto-login] [--headless]\n  kahunas workout serve [--host HOST] [--port N] [--timezone TZ] [--program UUID] [--workout UUID] [--limit N] [--cache-ttl MS] [--no-auto-login] [--headless]\n  kahunas workout sync [--headless]\n  kahunas workout program <id> [--csrf CSRF] [--token TOKEN] [--base-url URL] [--raw] [--no-auto-login] [--headless]\n\nEnv:\n  KAHUNAS_TOKEN=...\n  KAHUNAS_CSRF=...\n  KAHUNAS_CSRF_COOKIE=...\n  KAHUNAS_COOKIE=...\n  KAHUNAS_WEB_BASE_URL=...\n  KAHUNAS_USER_UUID=...\n\nConfig:\n  ${CONFIG_PATH}`);
 }
 
 //#endregion
@@ -688,6 +689,32 @@ async function handleCheckins(positionals, options) {
 
 //#endregion
 //#region src/events.ts
+function summarizeWorkoutProgramDays(program) {
+	const candidates = extractProgramDayCandidates(program);
+	if (candidates.length === 0) return [];
+	const seen = /* @__PURE__ */ new Set();
+	const unique = [];
+	for (const candidate of candidates) {
+		const key = [
+			candidate.day_index ?? "none",
+			candidate.day_label ?? "unknown",
+			candidate.sections.length
+		].join("|");
+		if (seen.has(key)) continue;
+		seen.add(key);
+		unique.push(candidate);
+	}
+	return unique.sort((a, b) => {
+		const aIndex = a.day_index;
+		const bIndex = b.day_index;
+		if (aIndex !== void 0 && bIndex !== void 0) return aIndex - bIndex;
+		if (aIndex !== void 0) return -1;
+		if (bIndex !== void 0) return 1;
+		const aLabel = a.day_label ?? "";
+		const bLabel = b.day_label ?? "";
+		return aLabel.localeCompare(bLabel);
+	});
+}
 function filterWorkoutEvents(payload, programFilter, workoutFilter) {
 	if (!Array.isArray(payload)) return [];
 	return payload.filter((entry) => {
@@ -1437,6 +1464,355 @@ function formatPathKey(key) {
 	return `\"${key.replace(/\"/g, "\\\"")}\"`;
 }
 
+//#endregion
+//#region src/server/workout-view.ts
+function renderWorkoutPage(options) {
+	const { summary, days, selectedDayIndex, timezone, apiPath, refreshPath, isLatest } = options;
+	const eventTitle = summary?.event.title ?? "Workout";
+	const eventStart = summary?.event.start ?? "";
+	const programTitle = summary?.program?.title ?? "Program";
+	const selected = selectedDayIndex !== void 0 && days[selectedDayIndex] ? days[selectedDayIndex] : summary?.workout_day ?? null;
+	const tabs = days.length > 0 ? `<nav class="tabs">${days.map((day, index) => {
+		const label = escapeHtml(day.day_label ?? `Day ${index + 1}`);
+		return `<a class="tab ${index === selectedDayIndex ? "active" : ""}" href="/?day=${index}">${label}</a>`;
+	}).join("")}</nav>` : "";
+	const totalVolumeSets = selected?.total_volume_sets ?? [];
+	const totalVolumeSection = totalVolumeSets.length > 0 ? `
+        <section class="section">
+          <h2>Total Volume Sets</h2>
+          <div class="chips">
+            ${totalVolumeSets.map((entry) => `<span class="chip">${escapeHtml(entry.body_part)} ${formatNumber(entry.sets)}</span>`).join("")}
+          </div>
+        </section>
+      ` : "";
+	const sections = selected?.sections?.length ? selected.sections.map((section) => {
+		const groups = section.groups.map((group, groupIndex) => {
+			return `<div class="group">${group.type === "superset" ? `<div class="group-label">Superset</div>` : ""}${group.exercises.map((exercise, rowIndex) => renderExerciseRow(exercise, groupIndex + rowIndex)).join("")}</div>`;
+		}).join("");
+		return `
+            <section class="section">
+              <h2>${escapeHtml(section.label)}</h2>
+              <div class="section-body">${groups}</div>
+            </section>
+          `;
+	}).join("") : `<div class="empty">No workout data found for this day.</div>`;
+	return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${escapeHtml(programTitle)} | Workout</title>
+    <style>
+      @import url("https://fonts.googleapis.com/css2?family=Fraunces:wght@600;700&family=Spline+Sans:wght@400;500;600&display=swap");
+
+      :root {
+        --bg-1: #f6f7fb;
+        --bg-2: #eef3f9;
+        --card: #ffffff;
+        --ink: #1f2430;
+        --muted: #6b7280;
+        --line: #e3e8f2;
+        --accent: #2f7f6f;
+        --accent-soft: #e7f5f1;
+        --chip: #eaf5ff;
+        --shadow: 0 12px 30px rgba(31, 36, 48, 0.08);
+      }
+
+      * {
+        box-sizing: border-box;
+      }
+
+      body {
+        margin: 0;
+        font-family: "Spline Sans", sans-serif;
+        color: var(--ink);
+        background: linear-gradient(160deg, var(--bg-1), var(--bg-2));
+        min-height: 100vh;
+      }
+
+      body::before {
+        content: "";
+        position: fixed;
+        inset: 0;
+        background: radial-gradient(circle at top right, rgba(47, 127, 111, 0.12), transparent 45%);
+        pointer-events: none;
+      }
+
+      .page {
+        max-width: 1120px;
+        margin: 0 auto;
+        padding: 40px 24px 72px;
+      }
+
+      .hero {
+        background: var(--card);
+        border-radius: 28px;
+        padding: 28px 32px;
+        box-shadow: var(--shadow);
+        display: grid;
+        gap: 20px;
+      }
+
+      .title {
+        font-family: "Fraunces", serif;
+        font-size: 32px;
+        margin: 0;
+      }
+
+      .subtitle {
+        color: var(--muted);
+        font-size: 14px;
+        letter-spacing: 0.02em;
+      }
+
+      .meta {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 12px;
+        align-items: center;
+      }
+
+      .meta-pill {
+        background: var(--accent-soft);
+        color: var(--accent);
+        padding: 6px 12px;
+        border-radius: 999px;
+        font-weight: 600;
+        font-size: 12px;
+      }
+
+      .meta-pill.latest {
+        background: #1f2a3d;
+        color: #f5f7ff;
+      }
+
+      .actions {
+        display: flex;
+        gap: 12px;
+        flex-wrap: wrap;
+      }
+
+      .button {
+        display: inline-flex;
+        align-items: center;
+        gap: 8px;
+        background: var(--card);
+        border: 1px solid var(--line);
+        border-radius: 999px;
+        padding: 8px 16px;
+        text-decoration: none;
+        color: var(--ink);
+        font-weight: 600;
+      }
+
+      .tabs {
+        display: flex;
+        gap: 10px;
+        flex-wrap: wrap;
+        padding: 18px 0 4px;
+      }
+
+      .tab {
+        padding: 8px 14px;
+        border-radius: 999px;
+        border: 1px solid var(--line);
+        text-decoration: none;
+        color: var(--muted);
+        font-weight: 600;
+        background: #f9fbff;
+      }
+
+      .tab.active {
+        color: var(--accent);
+        border-color: var(--accent);
+        background: #f2fbf8;
+      }
+
+      .section {
+        margin-top: 28px;
+      }
+
+      .section h2 {
+        margin: 0 0 14px;
+        font-size: 18px;
+        font-weight: 700;
+      }
+
+      .section-body {
+        display: grid;
+        gap: 14px;
+      }
+
+      .group {
+        display: grid;
+        gap: 10px;
+      }
+
+      .group-label {
+        font-size: 12px;
+        text-transform: uppercase;
+        letter-spacing: 0.1em;
+        color: var(--muted);
+        padding-left: 6px;
+      }
+
+      .exercise {
+        background: var(--card);
+        border-radius: 16px;
+        border: 1px solid var(--line);
+        padding: 16px 18px;
+        display: grid;
+        grid-template-columns: 56px 1fr auto;
+        gap: 12px;
+        align-items: center;
+        box-shadow: 0 4px 16px rgba(31, 36, 48, 0.04);
+        animation: fadeSlide 0.5s ease both;
+        animation-delay: var(--delay, 0s);
+      }
+
+      .badge {
+        width: 46px;
+        height: 46px;
+        border-radius: 14px;
+        background: var(--chip);
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        font-weight: 700;
+        color: #275b8b;
+      }
+
+      .exercise h3 {
+        margin: 0;
+        font-size: 16px;
+        font-weight: 700;
+      }
+
+      .exercise p {
+        margin: 4px 0 0;
+        color: var(--muted);
+        font-size: 13px;
+      }
+
+      .metrics {
+        display: flex;
+        flex-direction: column;
+        gap: 6px;
+        font-size: 13px;
+        color: var(--muted);
+        min-width: 140px;
+        text-align: right;
+      }
+
+      .chips {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 8px;
+        margin-top: 12px;
+      }
+
+      .chip {
+        padding: 6px 12px;
+        border-radius: 999px;
+        background: #e9f7f2;
+        color: #2f7f6f;
+        font-size: 12px;
+        font-weight: 600;
+      }
+
+      .chip.muted {
+        background: #f1f3f7;
+        color: var(--muted);
+      }
+
+      .empty {
+        margin-top: 20px;
+        padding: 24px;
+        border-radius: 16px;
+        border: 1px dashed var(--line);
+        color: var(--muted);
+        background: rgba(255, 255, 255, 0.6);
+      }
+
+      @keyframes fadeSlide {
+        from { opacity: 0; transform: translateY(6px); }
+        to { opacity: 1; transform: translateY(0); }
+      }
+
+      @media (max-width: 720px) {
+        .exercise {
+          grid-template-columns: 48px 1fr;
+        }
+        .metrics {
+          text-align: left;
+        }
+      }
+    </style>
+  </head>
+  <body>
+    <div class="page">
+      <header class="hero">
+        <div>
+          <div class="subtitle">${escapeHtml(programTitle)}</div>
+          <h1 class="title">${escapeHtml(eventTitle)}</h1>
+      <div class="meta">
+        ${eventStart ? `<span class="meta-pill">${escapeHtml(eventStart)}</span>` : ""}
+        <span class="meta-pill">${escapeHtml(timezone)}</span>
+        ${isLatest ? `<span class="meta-pill latest">Latest event</span>` : ""}
+      </div>
+        </div>
+        <div class="actions">
+          <a class="button" href="${escapeHtml(refreshPath)}">Refresh</a>
+          <a class="button" href="${escapeHtml(apiPath)}" target="_blank">JSON</a>
+        </div>
+        ${tabs}
+      </header>
+
+      ${totalVolumeSection}
+      ${sections}
+    </div>
+  </body>
+</html>`;
+}
+function renderExerciseRow(exercise, index) {
+	const badge = escapeHtml(exercise.sequence ?? String(index + 1));
+	const metrics = [
+		exercise.sets !== void 0 ? `Sets ${exercise.sets}` : null,
+		exercise.reps ? `Reps ${escapeHtml(exercise.reps)}` : null,
+		exercise.rest_seconds !== void 0 ? `Rest ${formatDuration(exercise.rest_seconds)}` : null,
+		exercise.time_seconds !== void 0 ? `Time ${formatDuration(exercise.time_seconds)}` : null
+	].filter(Boolean).join(" | ");
+	return `
+    <div class="exercise" style="--delay: ${Math.min(index * .04, .4)}s">
+      <div class="badge">${badge}</div>
+      <div>
+        <h3>${escapeHtml(exercise.name)}</h3>
+        <p>${metrics || "No prescription"}</p>
+      </div>
+      <div class="metrics">
+        ${exercise.body_parts?.length ? formatBodyParts(exercise.body_parts) : ""}
+      </div>
+    </div>
+  `;
+}
+function formatBodyParts(parts) {
+	return parts.slice(0, 3).map((part) => `${escapeHtml(part.name)}${part.volume !== void 0 ? ` ${formatNumber(part.volume)}` : ""}`).join("<br />");
+}
+function formatDuration(value) {
+	const total = Math.max(0, Math.round(value));
+	const minutes = Math.floor(total / 60);
+	const seconds = total % 60;
+	if (minutes > 0) return `${minutes}m ${seconds}s`;
+	return `${seconds}s`;
+}
+function formatNumber(value) {
+	if (Number.isInteger(value)) return String(value);
+	return value.toFixed(1).replace(/\.0$/, "");
+}
+function escapeHtml(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/\"/g, "&quot;").replace(/'/g, "&#39;");
+}
+
 //#endregion
 //#region src/commands/workout.ts
 async function handleWorkout(positionals, options) {
@@ -1453,6 +1829,14 @@ async function handleWorkout(positionals, options) {
 		else throw new Error("Missing auth token. Set KAHUNAS_TOKEN or run 'kahunas auth login'.");
 		return token;
 	};
+	let webLoginInFlight = null;
+	const ensureWebLogin = async () => {
+		if (!autoLogin) return;
+		if (!webLoginInFlight) webLoginInFlight = loginAndPersist(options, config, "silent").then(() => void 0).finally(() => {
+			webLoginInFlight = null;
+		});
+		await webLoginInFlight;
+	};
 	const baseUrl = resolveBaseUrl(options, config);
 	const rawOutput = isFlagEnabled(options, "raw");
 	const page = parseNumber$1(options.page, 1);
@@ -1477,67 +1861,7 @@ async function handleWorkout(positionals, options) {
 			cache
 		};
 	};
-	if (action === "list") {
-		const { response, plans, cache } = await fetchList();
-		if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.text}`);
-		if (rawOutput) {
-			printResponse(response, rawOutput);
-			return;
-		}
-		const output = {
-			source: cache ? "api+cache" : "api",
-			cache: cache ? {
-				updated_at: cache.updatedAt,
-				count: cache.plans.length,
-				path: WORKOUT_CACHE_PATH
-			} : void 0,
-			data: { workout_plan: plans }
-		};
-		console.log(JSON.stringify(output, null, 2));
-		return;
-	}
-	if (action === "pick") {
-		const { response, plans } = await fetchList();
-		if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.text}`);
-		if (plans.length === 0) throw new Error("No workout programs found.");
-		if (!rawOutput) {
-			console.log("Pick a workout program:");
-			plans.forEach((plan, index) => {
-				console.log(`${index + 1}) ${formatWorkoutSummary(plan)}`);
-			});
-		}
-		const answer = await askQuestion(`Enter number (1-${plans.length}): `);
-		const selection = Number.parseInt(answer, 10);
-		if (Number.isNaN(selection) || selection < 1 || selection > plans.length) throw new Error("Invalid selection.");
-		const chosen = plans[selection - 1];
-		if (!chosen.uuid) throw new Error("Selected workout is missing a uuid.");
-		const csrfToken$1 = resolveCsrfToken(options, config);
-		let responseProgram$1 = await fetchWorkoutProgram(await ensureToken(), baseUrl, chosen.uuid, csrfToken$1);
-		if (autoLogin && isTokenExpiredResponse(responseProgram$1.json)) {
-			token = await loginAndPersist(options, config, "silent");
-			responseProgram$1 = await fetchWorkoutProgram(token, baseUrl, chosen.uuid, csrfToken$1);
-		}
-		if (!responseProgram$1.ok) throw new Error(`HTTP ${responseProgram$1.status}: ${responseProgram$1.text}`);
-		printResponse(responseProgram$1, rawOutput);
-		return;
-	}
-	if (action === "latest") {
-		const { response, plans } = await fetchList();
-		if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.text}`);
-		if (plans.length === 0) throw new Error("No workout programs found.");
-		const chosen = pickLatestWorkout(plans);
-		if (!chosen || !chosen.uuid) throw new Error("Latest workout is missing a uuid.");
-		const csrfToken$1 = resolveCsrfToken(options, config);
-		let responseProgram$1 = await fetchWorkoutProgram(await ensureToken(), baseUrl, chosen.uuid, csrfToken$1);
-		if (autoLogin && isTokenExpiredResponse(responseProgram$1.json)) {
-			token = await loginAndPersist(options, config, "silent");
-			responseProgram$1 = await fetchWorkoutProgram(token, baseUrl, chosen.uuid, csrfToken$1);
-		}
-		if (!responseProgram$1.ok) throw new Error(`HTTP ${responseProgram$1.status}: ${responseProgram$1.text}`);
-		printResponse(responseProgram$1, rawOutput);
-		return;
-	}
-	if (action === "events") {
+	const fetchWorkoutEventsPayload = async () => {
 		const baseWebUrl = resolveWebBaseUrl(options, config);
 		const webOrigin = new URL(baseWebUrl).origin;
 		const timezone = options.timezone ?? process.env.TZ ?? Intl.DateTimeFormat().resolvedOptions().timeZone ?? "Europe/London";
@@ -1571,17 +1895,13 @@ async function handleWorkout(positionals, options) {
 			...config,
 			userUuid
 		});
-		const minimal = isFlagEnabled(options, "minimal");
-		const full = isFlagEnabled(options, "full");
-		const debugPreview = isFlagEnabled(options, "debug-preview");
-		const limit = isFlagEnabled(options, "latest") || isFlagEnabled(options, "last") ? 1 : parseNumber$1(options.limit, 0);
 		let csrfToken$1 = resolveCsrfToken(options, config);
 		let csrfCookie = resolveCsrfCookie(options, config);
 		let authCookie = resolveAuthCookie(options, config);
 		let effectiveCsrfToken = csrfCookie ?? csrfToken$1;
 		let cookieHeader = authCookie ?? (effectiveCsrfToken ? `csrf_kahunas_cookie_token=${effectiveCsrfToken}` : void 0);
 		if ((!csrfToken$1 || !cookieHeader || !authCookie) && autoLogin) {
-			await loginAndPersist(options, config, "silent");
+			await ensureWebLogin();
 			const refreshed = readConfig();
 			csrfToken$1 = resolveCsrfToken(options, refreshed);
 			csrfCookie = resolveCsrfCookie(options, refreshed);
@@ -1611,7 +1931,7 @@ async function handleWorkout(positionals, options) {
 		let text = await response.text();
 		if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
 		if (autoLogin && isLikelyLoginHtml(text)) {
-			await loginAndPersist(options, config, "silent");
+			await ensureWebLogin();
 			const refreshed = readConfig();
 			csrfToken$1 = resolveCsrfToken(options, refreshed);
 			csrfCookie = resolveCsrfCookie(options, refreshed);
@@ -1634,21 +1954,14 @@ async function handleWorkout(positionals, options) {
 			text = await retry.text();
 			if (!retry.ok) throw new Error(`HTTP ${retry.status}: ${text}`);
 		}
-		if (rawOutput) {
-			console.log(text);
-			return;
-		}
 		const payload = parseJsonText(text);
-		if (!Array.isArray(payload)) {
-			console.log(text);
-			return;
-		}
-		const sorted = sortWorkoutEvents(filterWorkoutEvents(payload, options.program, options.workout));
-		const limited = limit > 0 ? sorted.slice(-limit) : sorted;
-		if (minimal) {
-			console.log(JSON.stringify(limited, null, 2));
-			return;
-		}
+		return {
+			text,
+			payload,
+			timezone
+		};
+	};
+	const buildProgramDetails = async (events) => {
 		let programIndex;
 		let plans = readWorkoutCache()?.plans ?? [];
 		try {
@@ -1664,8 +1977,11 @@ async function handleWorkout(positionals, options) {
 			if (listResponse.ok) plans = mergeWorkoutPlans(extractWorkoutPlans(listResponse.json), plans);
 		} catch {}
 		if (plans.length > 0) programIndex = buildWorkoutPlanIndex(plans);
+		const refreshed = readConfig();
+		const csrfToken$1 = resolveCsrfToken(options, refreshed);
+		const effectiveCsrfToken = resolveCsrfCookie(options, refreshed) ?? csrfToken$1;
 		const programDetails = {};
-		const programIds = Array.from(new Set(sorted.map((entry) => {
+		const programIds = Array.from(new Set(events.map((entry) => {
 			if (!entry || typeof entry !== "object") return;
 			const record = entry;
 			return typeof record.program === "string" ? record.program : void 0;
@@ -1694,6 +2010,109 @@ async function handleWorkout(positionals, options) {
 			} catch {}
 			programDetails[programId$1] = programIndex?.[programId$1] ?? null;
 		}
+		return programDetails;
+	};
+	const resolveSelectedDayIndex = (days, eventDayIndex, eventDayLabel, dayParam) => {
+		const parseOptionalInt = (value) => {
+			if (!value) return;
+			const parsed = Number.parseInt(value, 10);
+			return Number.isFinite(parsed) ? parsed : void 0;
+		};
+		const normalize = (value) => value.trim().toLowerCase();
+		const paramIndex = parseOptionalInt(dayParam);
+		if (paramIndex !== void 0 && days[paramIndex]) return paramIndex;
+		if (eventDayIndex !== void 0) {
+			const matchIndex = days.findIndex((day) => day.day_index === eventDayIndex);
+			if (matchIndex >= 0) return matchIndex;
+		}
+		if (eventDayLabel) {
+			const normalized = normalize(eventDayLabel);
+			const matchIndex = days.findIndex((day) => day.day_label ? normalize(day.day_label).includes(normalized) : false);
+			if (matchIndex >= 0) return matchIndex;
+		}
+		if (days.length > 0) return 0;
+	};
+	if (action === "list") {
+		const { response, plans, cache } = await fetchList();
+		if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.text}`);
+		if (rawOutput) {
+			printResponse(response, rawOutput);
+			return;
+		}
+		const output = {
+			source: cache ? "api+cache" : "api",
+			cache: cache ? {
+				updated_at: cache.updatedAt,
+				count: cache.plans.length,
+				path: WORKOUT_CACHE_PATH
+			} : void 0,
+			data: { workout_plan: plans }
+		};
+		console.log(JSON.stringify(output, null, 2));
+		return;
+	}
+	if (action === "pick") {
+		const { response, plans } = await fetchList();
+		if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.text}`);
+		if (plans.length === 0) throw new Error("No workout programs found.");
+		if (!rawOutput) {
+			console.log("Pick a workout program:");
+			plans.forEach((plan, index) => {
+				console.log(`${index + 1}) ${formatWorkoutSummary(plan)}`);
+			});
+		}
+		const answer = await askQuestion(`Enter number (1-${plans.length}): `);
+		const selection = Number.parseInt(answer, 10);
+		if (Number.isNaN(selection) || selection < 1 || selection > plans.length) throw new Error("Invalid selection.");
+		const chosen = plans[selection - 1];
+		if (!chosen.uuid) throw new Error("Selected workout is missing a uuid.");
+		const csrfToken$1 = resolveCsrfToken(options, config);
+		let responseProgram$1 = await fetchWorkoutProgram(await ensureToken(), baseUrl, chosen.uuid, csrfToken$1);
+		if (autoLogin && isTokenExpiredResponse(responseProgram$1.json)) {
+			token = await loginAndPersist(options, config, "silent");
+			responseProgram$1 = await fetchWorkoutProgram(token, baseUrl, chosen.uuid, csrfToken$1);
+		}
+		if (!responseProgram$1.ok) throw new Error(`HTTP ${responseProgram$1.status}: ${responseProgram$1.text}`);
+		printResponse(responseProgram$1, rawOutput);
+		return;
+	}
+	if (action === "latest") {
+		const { response, plans } = await fetchList();
+		if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.text}`);
+		if (plans.length === 0) throw new Error("No workout programs found.");
+		const chosen = pickLatestWorkout(plans);
+		if (!chosen || !chosen.uuid) throw new Error("Latest workout is missing a uuid.");
+		const csrfToken$1 = resolveCsrfToken(options, config);
+		let responseProgram$1 = await fetchWorkoutProgram(await ensureToken(), baseUrl, chosen.uuid, csrfToken$1);
+		if (autoLogin && isTokenExpiredResponse(responseProgram$1.json)) {
+			token = await loginAndPersist(options, config, "silent");
+			responseProgram$1 = await fetchWorkoutProgram(token, baseUrl, chosen.uuid, csrfToken$1);
+		}
+		if (!responseProgram$1.ok) throw new Error(`HTTP ${responseProgram$1.status}: ${responseProgram$1.text}`);
+		printResponse(responseProgram$1, rawOutput);
+		return;
+	}
+	if (action === "events") {
+		const minimal = isFlagEnabled(options, "minimal");
+		const full = isFlagEnabled(options, "full");
+		const debugPreview = isFlagEnabled(options, "debug-preview");
+		const limit = isFlagEnabled(options, "latest") || isFlagEnabled(options, "last") ? 1 : parseNumber$1(options.limit, 0);
+		const { text, payload, timezone } = await fetchWorkoutEventsPayload();
+		if (rawOutput) {
+			console.log(text);
+			return;
+		}
+		if (!Array.isArray(payload)) {
+			console.log(text);
+			return;
+		}
+		const sorted = sortWorkoutEvents(filterWorkoutEvents(payload, options.program, options.workout));
+		const limited = limit > 0 ? sorted.slice(-limit) : sorted;
+		if (minimal) {
+			console.log(JSON.stringify(limited, null, 2));
+			return;
+		}
+		const programDetails = await buildProgramDetails(sorted);
 		if (debugPreview) for (const entry of limited) {
 			const record = entry;
 			const eventId = typeof record.id === "string" || typeof record.id === "number" ? record.id : "unknown";
@@ -1717,6 +2136,96 @@ async function handleWorkout(positionals, options) {
 		console.log(JSON.stringify(formatted, null, 2));
 		return;
 	}
+	if (action === "serve") {
+		const host = options.host ?? "127.0.0.1";
+		const port = parseNumber$1(options.port, 3e3);
+		const limit = parseNumber$1(options.limit, 1);
+		const cacheTtlMs = parseNumber$1(options["cache-ttl"], 3e4);
+		const loadSummary = async () => {
+			const { text, payload, timezone } = await fetchWorkoutEventsPayload();
+			if (!Array.isArray(payload)) throw new Error(`Unexpected calendar response: ${text.slice(0, 200)}`);
+			const sorted = sortWorkoutEvents(filterWorkoutEvents(payload, options.program, options.workout));
+			const bounded = limit > 0 ? sorted.slice(-limit) : sorted;
+			const programDetails = await buildProgramDetails(sorted);
+			const formatted = formatWorkoutEventsOutput(bounded, programDetails, {
+				timezone,
+				program: options.program,
+				workout: options.workout
+			});
+			const summary = formatted.events[0];
+			const programUuid = summary?.program?.uuid ?? (bounded[0] && typeof bounded[0] === "object" ? bounded[0].program : void 0);
+			return {
+				formatted,
+				days: summarizeWorkoutProgramDays(programUuid ? programDetails[programUuid] : void 0),
+				summary,
+				timezone
+			};
+		};
+		let cached;
+		let summaryInFlight = null;
+		const getSummary = async (forceRefresh) => {
+			if (!forceRefresh && cached && Date.now() - cached.fetchedAt < cacheTtlMs) return cached.data;
+			if (!forceRefresh && summaryInFlight) return summaryInFlight;
+			const pending = loadSummary().finally(() => {
+				summaryInFlight = null;
+			});
+			summaryInFlight = pending;
+			const data = await pending;
+			cached = {
+				data,
+				fetchedAt: Date.now()
+			};
+			return data;
+		};
+		(0, node_http.createServer)(async (req, res) => {
+			try {
+				const url = new URL(req.url ?? "/", `http://${host}:${port}`);
+				const wantsRefresh = url.searchParams.get("refresh") === "1";
+				if (url.pathname === "/api/workout") {
+					const data$1 = await getSummary(wantsRefresh);
+					res.statusCode = 200;
+					res.setHeader("content-type", "application/json; charset=utf-8");
+					res.setHeader("cache-control", "no-store");
+					res.end(JSON.stringify(data$1.formatted, null, 2));
+					return;
+				}
+				if (url.pathname === "/favicon.ico") {
+					res.statusCode = 204;
+					res.end();
+					return;
+				}
+				if (url.pathname !== "/") {
+					res.statusCode = 404;
+					res.end("Not found");
+					return;
+				}
+				const data = await getSummary(wantsRefresh);
+				const dayParam = url.searchParams.get("day");
+				const selectedDayIndex = resolveSelectedDayIndex(data.days, data.summary?.workout_day?.day_index, data.summary?.workout_day?.day_label, dayParam);
+				const html = renderWorkoutPage({
+					summary: data.summary,
+					days: data.days,
+					selectedDayIndex,
+					timezone: data.timezone,
+					apiPath: "/api/workout",
+					refreshPath: "/?refresh=1",
+					isLatest: limit === 1
+				});
+				res.statusCode = 200;
+				res.setHeader("content-type", "text/html; charset=utf-8");
+				res.setHeader("cache-control", "no-store");
+				res.end(html);
+			} catch (error) {
+				res.statusCode = 500;
+				res.setHeader("content-type", "text/plain; charset=utf-8");
+				res.end(error instanceof Error ? error.message : "Server error");
+			}
+		}).listen(port, host, () => {
+			console.log(`Local workout server running at http://${host}:${port}`);
+			console.log(`JSON endpoint at http://${host}:${port}/api/workout`);
+		});
+		return;
+	}
 	if (action === "sync") {
 		const captured = await captureWorkoutsFromBrowser(options, config);
 		const nextConfig = { ...config };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kahunas-cli",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "",
   "main": "dist/cli.js",
   "bin": {
@@ -23,6 +23,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.10.5",
+    "lefthook": "^2.0.15",
     "rolldown": "1.0.0-beta.59",
     "typescript": "^5.7.3",
     "vitest": "^1.6.0"