kahunas-cli 1.0.4 → 1.0.5

package/README.md

@@ -63,7 +63,7 @@ Tokens are saved to:
 - `kahunas workout latest`
   - Loads the most recently updated program.
 - `kahunas workout events`
-  - Lists workout log events with dates (from the calendar endpoint).
+  - Lists workout log events with dates and a human-friendly workout summary (from the calendar endpoint).
 - `kahunas workout program <id>`
   - Fetches a program by UUID.
 
@@ -84,7 +84,7 @@ Raw output (`--raw`) prints the API response only.
 
 ### Workout events (dates)
 
-To see when workouts happened, the calendar endpoint returns log events with timestamps. By default each event is enriched with the full program payload (best effort; falls back to cached summary if needed).
+To see when workouts happened, the calendar endpoint returns log events with timestamps. By default each event is summarized into a human-friendly structure (total volume sets, exercises, supersets). Use `--full` to return the full program payload (best effort; falls back to cached summary if needed).
 
 ```bash
 pnpm kahunas -- workout events --user <user-uuid>
@@ -105,9 +105,9 @@ pnpm kahunas -- workout events --program <program-uuid>
 pnpm kahunas -- workout events --workout <workout-uuid>
 ```
 
-Use `--minimal` to return the raw event objects without program enrichment.
+Use `--minimal` to return the raw event objects without program enrichment. Use `--full` to return the full enriched output. Use `--latest` for only the most recent event, or `--limit N` for the most recent N events. Use `--debug-preview` to log where preview HTML was discovered (stderr only).
 
-The user UUID is saved automatically after `checkins list`, or you can set it:
+If the user UUID is missing, `workout events` will attempt to discover it from check-ins and save it. You can also set it directly:
 
 - `KAHUNAS_USER_UUID=...`
 - `--user <uuid>`

package/dist/cli.js

@@ -272,7 +272,7 @@ function extractUserUuidFromCheckins(payload) {
 
 //#endregion
 //#region src/utils.ts
-function parseNumber(value, fallback) {
+function parseNumber$1(value, fallback) {
 	if (!value) return fallback;
 	const parsed = Number.parseInt(value, 10);
 	if (Number.isNaN(parsed)) return fallback;
@@ -532,7 +532,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] [--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 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
@@ -663,8 +663,8 @@ async function handleCheckins(positionals, options) {
 	if (!token) if (autoLogin) token = await loginAndPersist(options, config, "silent");
 	else throw new Error("Missing auth token. Set KAHUNAS_TOKEN or run 'kahunas auth login'.");
 	const baseUrl = resolveBaseUrl(options, config);
-	const page = parseNumber(options.page, 1);
-	const rpp = parseNumber(options.rpp, 12);
+	const page = parseNumber$1(options.page, 1);
+	const rpp = parseNumber$1(options.rpp, 12);
 	const rawOutput = isFlagEnabled(options, "raw");
 	let response = await postJson("/api/v2/checkin/list", token, baseUrl, {
 		page,
@@ -715,6 +715,727 @@ function enrichWorkoutEvents(events, programDetails) {
 		};
 	});
 }
+const HTML_ENTITY_MAP = {
+	"&quot;": "\"",
+	"&#34;": "\"",
+	"&apos;": "'",
+	"&#39;": "'",
+	"&amp;": "&",
+	"&lt;": "<",
+	"&gt;": ">"
+};
+const DAY_INDEX_KEYS = [
+	"day_index",
+	"workout_day_index",
+	"day",
+	"workout_day",
+	"day_number",
+	"workout_day_number"
+];
+function formatWorkoutEventsOutput(events, programDetails, options) {
+	return {
+		source: "calendar",
+		timezone: options.timezone,
+		filters: {
+			program: options.program ?? null,
+			workout: options.workout ?? null
+		},
+		events: events.map((event) => formatWorkoutEvent(event, programDetails))
+	};
+}
+function parseWorkoutDayPreview(html, dayIndex) {
+	const dayBlocks = extractWorkoutDayBlocks(html);
+	const selected = selectWorkoutDayBlock(dayBlocks, dayIndex);
+	if (dayBlocks.size > 1 && !selected) return null;
+	const dayHtml = selected?.html ?? html;
+	if (!dayHtml) return null;
+	const totalVolumeSets = parseTotalVolumeSets(dayHtml);
+	const sections = [];
+	const warmupHtml = extractSectionHtml(dayHtml, "table_warmup");
+	if (warmupHtml) {
+		const groups = buildExerciseGroups(warmupHtml);
+		if (groups.length > 0) sections.push({
+			type: "warm_up",
+			label: "Warm Up",
+			groups
+		});
+	}
+	const workoutHtml = extractSectionHtml(dayHtml, "table_workout");
+	if (workoutHtml) {
+		const groups = buildExerciseGroups(workoutHtml);
+		if (groups.length > 0) sections.push({
+			type: "workout",
+			label: "Workout",
+			groups
+		});
+	}
+	if (totalVolumeSets.length === 0 && sections.length === 0) return null;
+	const resolvedIndex = selected?.index ?? dayIndex;
+	return {
+		day_index: resolvedIndex,
+		day_label: resolvedIndex === void 0 ? void 0 : `Day ${resolvedIndex + 1}`,
+		total_volume_sets: totalVolumeSets,
+		sections
+	};
+}
+function formatWorkoutEvent(event, programDetails) {
+	const record = event;
+	const programUuid = typeof record.program === "string" ? record.program : void 0;
+	const program = programUuid ? programDetails[programUuid] : void 0;
+	const programSummary = programUuid ? extractProgramSummary(programUuid, program) : null;
+	const dayIndex = resolveEventDayIndex(record, program);
+	const previewHtml = (findWorkoutPreviewHtmlMatch(record) ?? (program ? findWorkoutPreviewHtmlMatch(program) : void 0))?.html;
+	let workoutDay = previewHtml ? parseWorkoutDayPreview(previewHtml, dayIndex) : null;
+	if (!workoutDay) workoutDay = deriveWorkoutDayFromProgram(program ?? record, record);
+	return {
+		event: {
+			id: typeof record.id === "number" || typeof record.id === "string" ? record.id : void 0,
+			start: typeof record.start === "string" ? record.start : void 0,
+			end: typeof record.end === "string" ? record.end : void 0,
+			title: typeof record.title === "string" ? record.title : void 0
+		},
+		program: programSummary,
+		workout_day: workoutDay
+	};
+}
+function deriveWorkoutDayFromProgram(program, event) {
+	if (!program || typeof program !== "object") return null;
+	const candidates = extractProgramDayCandidates(program);
+	if (candidates.length === 0) return null;
+	const dayIndex = resolveEventDayIndex(event, program) ?? parseDayIndexFromTitle(event.title);
+	if (dayIndex !== void 0) {
+		const match = candidates.find((candidate) => candidate.day_index === dayIndex) ?? candidates.find((candidate) => candidate.day_index === dayIndex - 1);
+		if (match) return match;
+	}
+	const title = typeof event.title === "string" ? event.title.trim() : "";
+	if (title) {
+		const normalizedTitle = normalizeLabel(title);
+		const match = candidates.find((candidate) => {
+			if (!candidate.day_label) return false;
+			const normalizedLabel = normalizeLabel(candidate.day_label);
+			return normalizedLabel.includes(normalizedTitle) || normalizedTitle.includes(normalizedLabel);
+		});
+		if (match) return match;
+	}
+	if (candidates.length === 1) return candidates[0];
+	return null;
+}
+function extractProgramDayCandidates(program) {
+	const candidates = [];
+	const queue = [program];
+	while (queue.length > 0) {
+		const value = queue.shift();
+		if (!value) continue;
+		if (Array.isArray(value)) {
+			queue.push(...value);
+			continue;
+		}
+		if (typeof value !== "object") continue;
+		const record = value;
+		const sections = extractSectionsFromRecord(record);
+		if (sections.length > 0) {
+			const dayIndex = resolveDayIndexFromRecord(record);
+			const dayLabel = resolveDayLabelFromRecord(record, dayIndex);
+			const totalVolume = extractTotalVolumeFromRecord(record);
+			candidates.push({
+				day_index: dayIndex,
+				day_label: dayLabel,
+				total_volume_sets: totalVolume,
+				sections
+			});
+		}
+		queue.push(...Object.values(record));
+	}
+	return candidates;
+}
+function extractSectionsFromRecord(record) {
+	const sections = [];
+	const exerciseListSections = extractSectionsFromExerciseList(record.exercise_list);
+	if (exerciseListSections.length > 0) return exerciseListSections;
+	const warmup = extractExercisesFromValue(record.warmup ?? record.warm_up ?? record.warm_up_exercises ?? record.warmups);
+	if (warmup.length > 0) sections.push({
+		type: "warm_up",
+		label: "Warm Up",
+		groups: wrapExercises(warmup)
+	});
+	const workout = extractExercisesFromValue(record.workout ?? record.workout_exercises ?? record.exercises ?? record.exercise);
+	if (workout.length > 0) sections.push({
+		type: "workout",
+		label: "Workout",
+		groups: wrapExercises(workout)
+	});
+	return sections;
+}
+function extractSectionsFromExerciseList(value) {
+	if (!value || typeof value !== "object") return [];
+	const record = value;
+	const sections = [];
+	const warmupGroups = extractExerciseGroupsFromList(record.warmup ?? record.warm_up);
+	if (warmupGroups.length > 0) sections.push({
+		type: "warm_up",
+		label: "Warm Up",
+		groups: warmupGroups
+	});
+	const workoutGroups = extractExerciseGroupsFromList(record.workout ?? record.main);
+	if (workoutGroups.length > 0) sections.push({
+		type: "workout",
+		label: "Workout",
+		groups: workoutGroups
+	});
+	const cooldownGroups = extractExerciseGroupsFromList(record.cooldown ?? record.cool_down);
+	if (cooldownGroups.length > 0) sections.push({
+		type: "workout",
+		label: "Cooldown",
+		groups: cooldownGroups
+	});
+	return sections;
+}
+function extractExerciseGroupsFromList(value) {
+	if (!Array.isArray(value)) return [];
+	const groups = [];
+	for (const entry of value) {
+		if (!entry || typeof entry !== "object") continue;
+		const record = entry;
+		const exercises = extractExercisesFromValue(record.list ?? record.exercises ?? record.exercise ?? record.items);
+		if (exercises.length === 0) continue;
+		const groupType = (typeof record.type === "string" ? record.type.toLowerCase() : "").includes("superset") ? "superset" : "straight";
+		groups.push({
+			type: groupType,
+			exercises
+		});
+	}
+	return groups;
+}
+function extractExercisesFromValue(value) {
+	if (!value) return [];
+	if (Array.isArray(value)) return extractExercisesFromArray(value);
+	if (typeof value === "object") {
+		const record = value;
+		if (looksLikeExerciseRecord(record)) {
+			const parsed = parseExerciseFromRecord(record);
+			return parsed ? [parsed] : [];
+		}
+		const exercises = [];
+		for (const entry of Object.values(record)) exercises.push(...extractExercisesFromValue(entry));
+		return exercises;
+	}
+	return [];
+}
+function extractExercisesFromArray(entries) {
+	const exerciseEntries = entries.filter((entry) => entry && typeof entry === "object").map((entry) => entry);
+	if (!exerciseEntries.some((entry) => looksLikeExerciseRecord(entry))) {
+		const nested = [];
+		for (const entry of exerciseEntries) nested.push(...extractExercisesFromValue(entry));
+		return nested;
+	}
+	return exerciseEntries.map((entry) => parseExerciseFromRecord(entry)).filter((entry) => Boolean(entry));
+}
+function looksLikeExerciseRecord(record) {
+	if (typeof record.exercise_name === "string") return true;
+	if (typeof record.exercise_uuid === "string") return true;
+	if (typeof record.name === "string" && (record.sets !== void 0 || record.reps !== void 0)) return true;
+	const nested = record.exercise;
+	if (nested && typeof nested === "object") {
+		const nestedRecord = nested;
+		if (typeof nestedRecord.name === "string" || typeof nestedRecord.exercise_name === "string") return true;
+		if (typeof nestedRecord.uuid === "string" || typeof nestedRecord.exercise_uuid === "string") return true;
+	}
+	return false;
+}
+function parseExerciseFromRecord(record) {
+	const nested = record.exercise && typeof record.exercise === "object" ? record.exercise : void 0;
+	const name = typeof record.exercise_name === "string" ? record.exercise_name : typeof record.name === "string" ? record.name : typeof nested?.name === "string" ? nested.name : typeof nested?.exercise_name === "string" ? nested.exercise_name : typeof nested?.title === "string" ? nested.title : void 0;
+	if (!name) return null;
+	const sets = parseNumber(record.sets);
+	const reps = typeof record.reps === "string" ? record.reps : typeof record.reps === "number" ? String(record.reps) : typeof record.rep === "string" ? record.rep : typeof record.repetition === "string" ? record.repetition : void 0;
+	const rest = parseNumber(record.rest_period ?? record.rest ?? record.rest_seconds);
+	const time = parseNumber(record.time_period ?? record.time ?? record.duration);
+	const bodyParts = extractBodyPartsFromValue(record.bodypart ?? record.body_parts ?? nested?.bodypart ?? nested?.body_parts);
+	const sequence = typeof record.number === "string" || typeof record.number === "number" ? String(record.number) : typeof record.sequence === "string" || typeof record.sequence === "number" ? String(record.sequence) : typeof record.order === "string" || typeof record.order === "number" ? String(record.order) : typeof record.exercise_order === "string" || typeof record.exercise_order === "number" ? String(record.exercise_order) : typeof record.group_order === "string" || typeof record.group_order === "number" ? String(record.group_order) : void 0;
+	return {
+		name,
+		uuid: typeof record.exercise_uuid === "string" ? record.exercise_uuid : typeof nested?.uuid === "string" ? nested.uuid : typeof nested?.exercise_uuid === "string" ? nested.exercise_uuid : void 0,
+		sets: sets ?? parseNumber(nested?.sets),
+		reps,
+		rest_seconds: rest ?? parseNumber(nested?.rest_period),
+		time_seconds: time ?? parseNumber(nested?.time_period),
+		notes: typeof record.notes === "string" ? record.notes : void 0,
+		sequence,
+		body_parts: bodyParts.length > 0 ? bodyParts : void 0
+	};
+}
+function extractBodyPartsFromValue(value) {
+	if (!value) return [];
+	if (!Array.isArray(value)) return [];
+	return value.filter((entry) => entry && typeof entry === "object").map((entry) => entry).map((entry) => {
+		const name = typeof entry.body_part_name === "string" ? entry.body_part_name : void 0;
+		if (!name) return;
+		const rawVolume = typeof entry.body_volume === "number" ? entry.body_volume : typeof entry.body_volume === "string" ? Number.parseFloat(entry.body_volume) : void 0;
+		const volume = Number.isFinite(rawVolume ?? NaN) ? rawVolume : void 0;
+		const result = { name };
+		if (volume !== void 0) result.volume = volume;
+		return result;
+	}).filter((entry) => Boolean(entry && entry.name));
+}
+function extractTotalVolumeFromRecord(record) {
+	const bodypart = record.bodypart ?? record.body_parts;
+	if (!Array.isArray(bodypart)) return [];
+	const totals = [];
+	for (const entry of bodypart) {
+		if (!entry || typeof entry !== "object") continue;
+		const data = entry;
+		if (typeof data.body_part_name !== "string") continue;
+		const setsValue = typeof data.body_volume === "number" ? data.body_volume : typeof data.body_volume === "string" ? Number.parseFloat(data.body_volume) : void 0;
+		if (setsValue === void 0 || !Number.isFinite(setsValue)) continue;
+		totals.push({
+			body_part: data.body_part_name,
+			sets: setsValue
+		});
+	}
+	return totals;
+}
+function wrapExercises(exercises) {
+	return [...exercises].sort((a, b) => {
+		const aSeq = parseSequence(a.sequence);
+		const bSeq = parseSequence(b.sequence);
+		if (aSeq !== void 0 && bSeq !== void 0) return aSeq - bSeq;
+		if (aSeq !== void 0) return -1;
+		if (bSeq !== void 0) return 1;
+		return 0;
+	}).map((exercise) => ({
+		type: "straight",
+		exercises: [exercise]
+	}));
+}
+function parseSequence(value) {
+	if (!value) return;
+	const parsed = Number.parseFloat(value);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+function resolveDayIndexFromRecord(record) {
+	for (const key of DAY_INDEX_KEYS) {
+		const parsed = parseIndex(record[key]);
+		if (parsed !== void 0) return parsed;
+	}
+}
+function resolveDayLabelFromRecord(record, dayIndex) {
+	const label = typeof record.day_title === "string" ? record.day_title : typeof record.day_name === "string" ? record.day_name : typeof record.title === "string" ? record.title : typeof record.name === "string" ? record.name : void 0;
+	if (label) return label.trim();
+	if (dayIndex !== void 0) return `Day ${dayIndex + 1}`;
+}
+function parseDayIndexFromTitle(value) {
+	if (typeof value !== "string") return;
+	const match = value.match(/\\bday\\s*(\\d+)/i);
+	if (!match) return;
+	const parsed = Number.parseInt(match[1], 10);
+	if (!Number.isFinite(parsed)) return;
+	return parsed - 1;
+}
+function normalizeLabel(value) {
+	return value.trim().toLowerCase();
+}
+function resolveWorkoutEventDayIndex(event, program) {
+	return resolveEventDayIndex(event, program);
+}
+function findWorkoutPreviewHtmlMatch(value) {
+	const queue = [{
+		value,
+		path: "$"
+	}];
+	while (queue.length > 0) {
+		const current = queue.shift();
+		if (!current) continue;
+		const { value: entry, path } = current;
+		if (typeof entry === "string") {
+			if (entry.includes("workoutdays_data") || entry.includes("preview_day_content") || entry.includes("table_workout")) return {
+				html: entry,
+				source: path
+			};
+			continue;
+		}
+		if (Array.isArray(entry)) {
+			entry.forEach((item, index) => {
+				queue.push({
+					value: item,
+					path: `${path}[${index}]`
+				});
+			});
+			continue;
+		}
+		if (entry && typeof entry === "object") for (const [key, child] of Object.entries(entry)) queue.push({
+			value: child,
+			path: `${path}.${formatPathKey(key)}`
+		});
+	}
+}
+function resolveEventDayIndex(event, program) {
+	for (const key of DAY_INDEX_KEYS) {
+		const value = event[key];
+		const parsed = parseIndex(value);
+		if (parsed !== void 0) return parsed;
+	}
+	const workoutUuid = typeof event.workout === "string" ? event.workout : typeof event.workout_uuid === "string" ? event.workout_uuid : void 0;
+	if (workoutUuid) {
+		const found = findDayIndexByWorkoutUuid(program, workoutUuid);
+		if (found !== void 0) return found;
+	}
+	const workoutDayUuid = typeof event.workout_day_uuid === "string" ? event.workout_day_uuid : void 0;
+	if (workoutDayUuid) {
+		const found = findDayIndexByUuid(program, workoutDayUuid);
+		if (found !== void 0) return found;
+	}
+	const workoutDayId = parseIndex(event.workout_day_id ?? event.day_id);
+	if (workoutDayId !== void 0) {
+		const found = findDayIndexById(program, workoutDayId);
+		if (found !== void 0) return found;
+	}
+}
+function extractProgramSummary(uuid, program) {
+	if (!program || typeof program !== "object") return { uuid };
+	const record = program;
+	return {
+		uuid,
+		title: typeof record.title === "string" ? record.title : typeof record.name === "string" ? record.name : void 0
+	};
+}
+function extractWorkoutDayBlocks(html) {
+	const blocks = /* @__PURE__ */ new Map();
+	const regex = /<div[^>]*\bid=(["'])day_content_(\d+)\1[^>]*>/gi;
+	let match;
+	while ((match = regex.exec(html)) !== null) {
+		const index = Number.parseInt(match[2], 10);
+		if (Number.isNaN(index)) continue;
+		const start = match.index;
+		const block = extractDivBlock(html, start);
+		if (block) blocks.set(index, block);
+	}
+	return blocks;
+}
+function selectWorkoutDayBlock(blocks, dayIndex) {
+	if (dayIndex !== void 0) {
+		const direct = blocks.get(dayIndex);
+		if (direct) return {
+			index: dayIndex,
+			html: direct
+		};
+		const adjusted = blocks.get(dayIndex - 1);
+		if (adjusted && dayIndex > 0) return {
+			index: dayIndex - 1,
+			html: adjusted
+		};
+	}
+	if (blocks.size === 1) {
+		const [index, html] = Array.from(blocks.entries())[0];
+		return {
+			index,
+			html
+		};
+	}
+	for (const [index, html] of blocks.entries()) if (/display\s*:\s*block/i.test(html)) return {
+		index,
+		html
+	};
+	if (blocks.size > 0) {
+		const [index, html] = Array.from(blocks.entries())[0];
+		return {
+			index,
+			html
+		};
+	}
+}
+function extractDivBlock(html, startIndex) {
+	const tagRegex = /<div\b[^>]*>|<\/div\s*>/gi;
+	tagRegex.lastIndex = startIndex;
+	let depth = 0;
+	let match;
+	while ((match = tagRegex.exec(html)) !== null) if (match[0].startsWith("</")) {
+		depth -= 1;
+		if (depth === 0) return html.slice(startIndex, tagRegex.lastIndex);
+	} else depth += 1;
+	return html.slice(startIndex);
+}
+function extractSectionHtml(html, className) {
+	const marker = html.indexOf(className);
+	if (marker === -1) return;
+	const divStart = html.lastIndexOf("<div", marker);
+	if (divStart === -1) return;
+	return extractDivBlock(html, divStart);
+}
+function parseTotalVolumeSets(html) {
+	const results = [];
+	const regex = /<span[^>]*total-volume-span[^>]*>(.*?)<\/span>/gi;
+	let match;
+	while ((match = regex.exec(html)) !== null) {
+		const parsed = parseBodyPartVolume(decodeHtmlEntities(match[1].trim()));
+		if (parsed) results.push(parsed);
+	}
+	return results;
+}
+function parseBodyPartVolume(value) {
+	const match = value.match(/^(.*?)(?:\s+)(-?\d+(?:\.\d+)?)$/);
+	if (!match) return;
+	const sets = Number.parseFloat(match[2]);
+	if (!Number.isFinite(sets)) return;
+	return {
+		body_part: match[1].trim(),
+		sets
+	};
+}
+function buildExerciseGroups(sectionHtml) {
+	const supersetTables = extractSupersetTables(sectionHtml);
+	const supersetRanges = supersetTables.map((table) => ({
+		start: table.start,
+		end: table.end
+	}));
+	const supersetGroups = [];
+	for (const table of supersetTables) {
+		const exercises = parseExercisesWithIndex(table.html).map((row) => row.exercise);
+		if (exercises.length === 0) continue;
+		supersetGroups.push({
+			index: table.start,
+			group: {
+				type: "superset",
+				label: "Superset",
+				exercises
+			}
+		});
+	}
+	const straightGroups = [];
+	for (const row of parseExercisesWithIndex(sectionHtml)) {
+		if (isIndexInRanges(row.index, supersetRanges)) continue;
+		if (row.classValue.includes("subrow")) continue;
+		straightGroups.push({
+			index: row.index,
+			group: {
+				type: "straight",
+				exercises: [row.exercise]
+			}
+		});
+	}
+	return [...supersetGroups, ...straightGroups].sort((a, b) => a.index - b.index).map((entry) => entry.group);
+}
+function parseExercisesWithIndex(html) {
+	const rows = [];
+	const regex = /<tr\b[^>]*\bdata-exercise_name=(["']).*?\1[^>]*>/gi;
+	let match;
+	while ((match = regex.exec(html)) !== null) {
+		const tag = match[0];
+		const exercise = parseExerciseFromTag(tag);
+		if (!exercise) continue;
+		rows.push({
+			index: match.index,
+			exercise,
+			classValue: extractAttribute(tag, "class") ?? ""
+		});
+	}
+	return rows;
+}
+function parseExerciseFromTag(tag) {
+	const attrs = extractDataAttributes(tag);
+	const name = attrs["exercise_name"];
+	if (!name) return null;
+	const sets = parseNumber(attrs["sets"]);
+	const restSeconds = parseNumber(attrs["rest_period"]);
+	const timeSeconds = parseNumber(attrs["time_period"]);
+	const bodyParts = parseBodyParts(attrs["bodypart"]);
+	const media = parseMedia(attrs["media"]);
+	return {
+		name,
+		uuid: attrs["exercise_uuid"],
+		sets,
+		reps: attrs["reps"] || void 0,
+		rest_seconds: restSeconds,
+		time_seconds: timeSeconds,
+		notes: attrs["notes"] || void 0,
+		sequence: attrs["number"] || void 0,
+		body_parts: bodyParts.length > 0 ? bodyParts : void 0,
+		media: media.length > 0 ? media : void 0
+	};
+}
+function extractSupersetTables(html) {
+	const candidates = extractTableBlocks(html).filter((table) => /Superset/i.test(table.html));
+	return candidates.filter((candidate) => !containsSmallerSuperset(candidate, candidates));
+}
+function containsSmallerSuperset(candidate, candidates) {
+	const candidateSize = candidate.end - candidate.start;
+	return candidates.some((other) => {
+		if (other === candidate) return false;
+		const otherSize = other.end - other.start;
+		return other.start >= candidate.start && other.end <= candidate.end && otherSize < candidateSize;
+	});
+}
+function extractTableBlocks(html) {
+	const blocks = [];
+	const regex = /<table\b[^>]*>/gi;
+	let match;
+	while ((match = regex.exec(html)) !== null) {
+		const start = match.index;
+		const block = extractTableBlock(html, start);
+		if (!block) continue;
+		blocks.push({
+			start,
+			end: block.end,
+			html: block.html
+		});
+	}
+	return blocks;
+}
+function extractTableBlock(html, startIndex) {
+	const tagRegex = /<table\b[^>]*>|<\/table\s*>/gi;
+	tagRegex.lastIndex = startIndex;
+	let depth = 0;
+	let match;
+	while ((match = tagRegex.exec(html)) !== null) if (match[0].startsWith("</")) {
+		depth -= 1;
+		if (depth === 0) return {
+			html: html.slice(startIndex, tagRegex.lastIndex),
+			end: tagRegex.lastIndex
+		};
+	} else depth += 1;
+	return {
+		html: html.slice(startIndex),
+		end: html.length
+	};
+}
+function parseBodyParts(value) {
+	if (!value) return [];
+	const parsed = parseJson(decodeHtmlEntities(value));
+	if (!Array.isArray(parsed)) return [];
+	const results = [];
+	for (const entry of parsed) {
+		if (!entry || typeof entry !== "object") continue;
+		const record = entry;
+		const name = typeof record.body_part_name === "string" ? record.body_part_name : void 0;
+		if (!name) continue;
+		const volumeValue = typeof record.body_volume === "number" ? record.body_volume : typeof record.body_volume === "string" ? Number.parseFloat(record.body_volume) : void 0;
+		results.push({
+			name,
+			volume: Number.isFinite(volumeValue) ? volumeValue : void 0
+		});
+	}
+	return results;
+}
+function parseMedia(value) {
+	if (!value) return [];
+	const parsed = parseJson(decodeHtmlEntities(value));
+	if (!Array.isArray(parsed)) return [];
+	const results = [];
+	for (const entry of parsed) {
+		if (!entry || typeof entry !== "object") continue;
+		const record = entry;
+		const fileUrl = typeof record.file_url === "string" ? record.file_url : void 0;
+		const fileType = typeof record.file_type === "number" ? record.file_type : void 0;
+		const mediaEntry = { file_type: fileType };
+		if (fileType === 2) mediaEntry.thumbnail_url = fileUrl;
+		else mediaEntry.file_url = fileUrl;
+		if (mediaEntry.file_url || mediaEntry.thumbnail_url) results.push(mediaEntry);
+	}
+	return results;
+}
+function extractDataAttributes(tag) {
+	const attrs = {};
+	const regex = /\sdata-([a-z0-9_-]+)=(["'])(.*?)\2/gi;
+	let match;
+	while ((match = regex.exec(tag)) !== null) attrs[match[1]] = decodeHtmlEntities(match[3]);
+	return attrs;
+}
+function extractAttribute(tag, name) {
+	const regex = new RegExp(`\\s${name}=(["'])(.*?)\\1`, "i");
+	const match = tag.match(regex);
+	return match ? match[2] : void 0;
+}
+function decodeHtmlEntities(value) {
+	let result = value;
+	for (const [entity, replacement] of Object.entries(HTML_ENTITY_MAP)) result = result.split(entity).join(replacement);
+	return result;
+}
+function isIndexInRanges(index, ranges) {
+	return ranges.some((range) => index >= range.start && index < range.end);
+}
+function parseNumber(value) {
+	if (!value) return;
+	const parsed = Number.parseFloat(value);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+function parseIndex(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string" && value.trim() !== "") {
+		const parsed = Number.parseInt(value, 10);
+		return Number.isFinite(parsed) ? parsed : void 0;
+	}
+}
+function parseJson(value) {
+	try {
+		return JSON.parse(value);
+	} catch {
+		return;
+	}
+}
+function findDayIndexByWorkoutUuid(program, workoutUuid) {
+	const queue = [{ value: program }];
+	while (queue.length > 0) {
+		const { value, indexInArray } = queue.shift() ?? {};
+		if (value === void 0 || value === null) continue;
+		if (Array.isArray(value)) {
+			value.forEach((entry, index) => {
+				queue.push({
+					value: entry,
+					indexInArray: index
+				});
+			});
+			continue;
+		}
+		if (typeof value === "object") {
+			const record = value;
+			const candidateUuid = typeof record.workout_uuid === "string" ? record.workout_uuid : typeof record.workout === "string" ? record.workout : typeof record.uuid === "string" ? record.uuid : void 0;
+			if (candidateUuid && candidateUuid === workoutUuid) {
+				for (const key of DAY_INDEX_KEYS) {
+					const parsed = parseIndex(record[key]);
+					if (parsed !== void 0) return parsed;
+				}
+				if (indexInArray !== void 0) return indexInArray;
+			}
+			for (const entry of Object.values(record)) queue.push({ value: entry });
+		}
+	}
+}
+function findDayIndexByUuid(program, uuid) {
+	return findDayIndexByMatcher(program, (record) => record.uuid === uuid);
+}
+function findDayIndexById(program, id) {
+	return findDayIndexByMatcher(program, (record) => record.id === id);
+}
+function findDayIndexByMatcher(program, matcher) {
+	const queue = [{ value: program }];
+	while (queue.length > 0) {
+		const { value, indexInArray } = queue.shift() ?? {};
+		if (value === void 0 || value === null) continue;
+		if (Array.isArray(value)) {
+			value.forEach((entry, index) => {
+				queue.push({
+					value: entry,
+					indexInArray: index
+				});
+			});
+			continue;
+		}
+		if (typeof value === "object") {
+			const record = value;
+			if (matcher(record)) {
+				for (const key of DAY_INDEX_KEYS) {
+					const parsed = parseIndex(record[key]);
+					if (parsed !== void 0) return parsed;
+				}
+				if (indexInArray !== void 0) return indexInArray;
+			}
+			for (const entry of Object.values(record)) queue.push({ value: entry });
+		}
+	}
+}
+function formatPathKey(key) {
+	if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)) return key;
+	return `\"${key.replace(/\"/g, "\\\"")}\"`;
+}
 
 //#endregion
 //#region src/commands/workout.ts
@@ -734,8 +1455,8 @@ async function handleWorkout(positionals, options) {
 	};
 	const baseUrl = resolveBaseUrl(options, config);
 	const rawOutput = isFlagEnabled(options, "raw");
-	const page = parseNumber(options.page, 1);
-	const rpp = parseNumber(options.rpp, 12);
+	const page = parseNumber$1(options.page, 1);
+	const rpp = parseNumber$1(options.rpp, 12);
 	const listRpp = action === "latest" && options.rpp === void 0 ? 100 : rpp;
 	const fetchList = async () => {
 		await ensureToken();
@@ -821,12 +1542,39 @@ async function handleWorkout(positionals, options) {
 		const webOrigin = new URL(baseWebUrl).origin;
 		const timezone = options.timezone ?? process.env.TZ ?? Intl.DateTimeFormat().resolvedOptions().timeZone ?? "Europe/London";
 		let userUuid = resolveUserUuid(options, config);
-		if (!userUuid) throw new Error("Missing user uuid. Use --user or set KAHUNAS_USER_UUID.");
+		if (!userUuid) try {
+			await ensureToken();
+			let checkinsResponse = await postJson("/api/v2/checkin/list", token, baseUrl, {
+				page: 1,
+				rpp: 1
+			});
+			if (autoLogin && isTokenExpiredResponse(checkinsResponse.json)) {
+				token = await loginAndPersist(options, config, "silent");
+				checkinsResponse = await postJson("/api/v2/checkin/list", token, baseUrl, {
+					page: 1,
+					rpp: 1
+				});
+			}
+			if (checkinsResponse.ok) {
+				const extracted = extractUserUuidFromCheckins(checkinsResponse.json);
+				if (extracted) {
+					userUuid = extracted;
+					if (userUuid !== config.userUuid) writeConfig({
+						...config,
+						userUuid
+					});
+				}
+			}
+		} catch {}
+		if (!userUuid) throw new Error("Missing user uuid. Use --user or run 'kahunas checkins list' once.");
 		if (userUuid !== config.userUuid) writeConfig({
 			...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);
@@ -896,8 +1644,9 @@ async function handleWorkout(positionals, options) {
 			return;
 		}
 		const sorted = sortWorkoutEvents(filterWorkoutEvents(payload, options.program, options.workout));
+		const limited = limit > 0 ? sorted.slice(-limit) : sorted;
 		if (minimal) {
-			console.log(JSON.stringify(sorted, null, 2));
+			console.log(JSON.stringify(limited, null, 2));
 			return;
 		}
 		let programIndex;
@@ -945,8 +1694,27 @@ async function handleWorkout(positionals, options) {
 			} catch {}
 			programDetails[programId$1] = programIndex?.[programId$1] ?? null;
 		}
-		const enriched = enrichWorkoutEvents(sorted, programDetails);
-		console.log(JSON.stringify(enriched, null, 2));
+		if (debugPreview) for (const entry of limited) {
+			const record = entry;
+			const eventId = typeof record.id === "string" || typeof record.id === "number" ? record.id : "unknown";
+			const programUuid = typeof record.program === "string" ? record.program : void 0;
+			const program = programUuid ? programDetails[programUuid] : void 0;
+			const match = findWorkoutPreviewHtmlMatch(record) ?? (program ? findWorkoutPreviewHtmlMatch(program) : void 0);
+			const dayIndex = resolveWorkoutEventDayIndex(entry, program);
+			const source = match ? match.source : "not_found";
+			console.error(`debug-preview event=${eventId} program=${programUuid ?? "unknown"} day_index=${dayIndex ?? "none"} source=${source}`);
+		}
+		if (full) {
+			const enriched = enrichWorkoutEvents(limited, programDetails);
+			console.log(JSON.stringify(enriched, null, 2));
+			return;
+		}
+		const formatted = formatWorkoutEventsOutput(limited, programDetails, {
+			timezone,
+			program: options.program,
+			workout: options.workout
+		});
+		console.log(JSON.stringify(formatted, null, 2));
 		return;
 	}
 	if (action === "sync") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kahunas-cli",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "",
   "main": "dist/cli.js",
   "bin": {