trainerroad-cli 0.1.1 → 0.3.0

package/src/commands/workout-mutations.mjs

@@ -0,0 +1,310 @@
+const ALTERNATE_CATEGORIES = new Set(["similar", "easier", "harder", "longer", "shorter"]);
+const SWITCH_MODES = new Set(["inside", "outside"]);
+
+function toIsoDateFromApiDate(date) {
+  if (!date || typeof date !== "object") return null;
+  const year = String(date.year ?? "").padStart(4, "0");
+  const month = String(date.month ?? "").padStart(2, "0");
+  const day = String(date.day ?? "").padStart(2, "0");
+  if (!year.trim() || !month.trim() || !day.trim()) return null;
+  return `${year}-${month}-${day}`;
+}
+
+function summarizePlannedActivity(activity) {
+  if (!activity || typeof activity !== "object") return null;
+  const workout = activity.workout ?? null;
+  return {
+    plannedActivityId: activity.id ?? null,
+    date: toIsoDateFromApiDate(activity.date),
+    timeOfDay: activity.timeOfDay ?? null,
+    workoutId: workout?.id ?? null,
+    workoutName: workout?.name ?? activity.name ?? null,
+    isOutside: workout?.isOutside ?? null,
+    durationMinutes:
+      workout?.duration ??
+      (Number.isFinite(Number(activity.durationInSeconds))
+        ? Math.round(Number(activity.durationInSeconds) / 60)
+        : null),
+    tss: activity.tss ?? workout?.tss ?? null,
+    canMove: activity.canMove ?? null,
+    recommendationReason: activity.recommendationReason ?? null,
+  };
+}
+
+function summarizeAlternateWorkout(workout) {
+  if (!workout || typeof workout !== "object") return null;
+  return {
+    workoutId: workout.id ?? null,
+    workoutName: workout.workoutName ?? workout.name ?? null,
+    durationMinutes: workout.duration ?? null,
+    tss: workout.tss ?? null,
+    intensityFactor: workout.intensityFactor ?? null,
+    prescribedLevel: workout.prescribedLevel ?? null,
+    isOutside: workout.isOutside ?? null,
+    hasOutsideEquivalent: workout.hasOutsideEquivalent ?? null,
+    zoneId: workout.zoneId ?? null,
+    profileId: workout.profileId ?? null,
+  };
+}
+
+async function requirePrivateMember(flags, deps) {
+  const { withClient } = deps;
+  const client = await withClient(flags);
+  let memberInfo;
+  try {
+    memberInfo = await client.getMemberInfo();
+  } catch {
+    throw new Error(
+      "This command requires private authenticated mode. Login first with trainerroad-cli login.",
+    );
+  }
+  return { client, memberInfo };
+}
+
+export async function commandWorkoutAlternates(flags, deps) {
+  const { isJsonMode, requireFlag, writeOutput } = deps;
+  const category = String(flags.category ?? "similar").toLowerCase();
+  const plannedActivityId = String(requireFlag("workout-alternates", flags, "id"));
+  if (!ALTERNATE_CATEGORIES.has(category)) {
+    throw new Error(
+      `Invalid --category "${category}". Expected one of: ${Array.from(ALTERNATE_CATEGORIES).join(", ")}.`,
+    );
+  }
+
+  const { client, memberInfo } = await requirePrivateMember(flags, deps);
+  const plannedActivity = await client.getPlannedActivity(plannedActivityId, memberInfo.username);
+  const alternates = await client.getPlannedActivityAlternates(
+    plannedActivityId,
+    category,
+    memberInfo.username,
+  );
+  const records = (Array.isArray(alternates?.workouts) ? alternates.workouts : [])
+    .map((item) => summarizeAlternateWorkout(item))
+    .filter(Boolean);
+
+  const payload = {
+    generatedAt: new Date().toISOString(),
+    command: "workout-alternates",
+    member: { memberId: memberInfo.memberId, username: memberInfo.username },
+    query: { plannedActivityId, category },
+    plannedActivity: summarizePlannedActivity(plannedActivity),
+    count: records.length,
+    records,
+  };
+
+  if (!isJsonMode(flags)) {
+    await writeOutput(payload, flags, (value) => {
+      const lines = [
+        `Alternates (${value.count}) for ${value.plannedActivity?.workoutName ?? "workout"} [category=${value.query.category}]`,
+      ];
+      for (const item of value.records) {
+        lines.push(
+          `- ${item.workoutName ?? "(untitled)"} | workoutId=${item.workoutId} | duration=${item.durationMinutes ?? "?"}m | tss=${item.tss ?? "?"} | outside=${item.isOutside === null ? "?" : item.isOutside}`,
+        );
+      }
+      return lines.join("\n");
+    });
+    return;
+  }
+
+  await writeOutput(payload, { ...flags, json: !flags.jsonl });
+}
+
+export async function commandMoveWorkout(flags, deps) {
+  const { isJsonMode, requireFlag, toBoolean, writeOutput } = deps;
+  const dryRun = toBoolean(flags["dry-run"], false);
+  const plannedActivityId = String(requireFlag("move-workout", flags, "id"));
+  const newDate = String(requireFlag("move-workout", flags, "to"));
+  const { client, memberInfo } = await requirePrivateMember(flags, deps);
+  const before = await client.getPlannedActivity(plannedActivityId, memberInfo.username);
+  const beforeSummary = summarizePlannedActivity(before);
+  const noop = beforeSummary?.date === newDate;
+
+  if (dryRun || noop) {
+    const payload = {
+      generatedAt: new Date().toISOString(),
+      command: "move-workout",
+      member: { memberId: memberInfo.memberId, username: memberInfo.username },
+      query: { plannedActivityId, to: newDate },
+      dryRun,
+      noop,
+      before: beforeSummary,
+      after: noop ? beforeSummary : { ...beforeSummary, date: newDate },
+      mutation: null,
+      message: noop
+        ? `Workout is already scheduled on ${newDate}.`
+        : `Would move ${beforeSummary?.workoutName ?? "workout"} to ${newDate}.`,
+    };
+
+    if (!isJsonMode(flags)) {
+      await writeOutput(payload, flags, (value) => {
+        if (value.noop) {
+          return `No changes: plannedActivityId=${value.query.plannedActivityId} is already on ${value.query.to}`;
+        }
+        return `Would move ${value.before?.workoutName ?? "workout"} | plannedActivityId=${value.query.plannedActivityId} | ${value.before?.date ?? "?"} -> ${value.query.to}\nNo changes made.`;
+      });
+      return;
+    }
+
+    await writeOutput(payload, { ...flags, json: !flags.jsonl });
+    return;
+  }
+
+  const mutation = await client.movePlannedActivity(plannedActivityId, newDate, memberInfo.username);
+  const after = await client.getPlannedActivity(plannedActivityId, memberInfo.username);
+
+  const payload = {
+    generatedAt: new Date().toISOString(),
+    command: "move-workout",
+    member: { memberId: memberInfo.memberId, username: memberInfo.username },
+    query: { plannedActivityId, to: newDate },
+    before: summarizePlannedActivity(before),
+    after: summarizePlannedActivity(after),
+    mutation,
+  };
+
+  if (!isJsonMode(flags)) {
+    await writeOutput(payload, flags, (value) => {
+      return `Moved ${value.after?.workoutName ?? "workout"} | plannedActivityId=${value.query.plannedActivityId} | ${value.before?.date ?? "?"} -> ${value.after?.date ?? "?"}`;
+    });
+    return;
+  }
+
+  await writeOutput(payload, { ...flags, json: !flags.jsonl });
+}
+
+export async function commandReplaceWorkout(flags, deps) {
+  const { isJsonMode, requireFlag, toBoolean, writeOutput } = deps;
+  const dryRun = toBoolean(flags["dry-run"], false);
+  const plannedActivityId = String(requireFlag("replace-workout", flags, "id"));
+  const alternateWorkoutId = Number(requireFlag("replace-workout", flags, "alternate-id"));
+  if (!Number.isFinite(alternateWorkoutId)) {
+    throw new Error(`Invalid --alternate-id "${flags["alternate-id"]}". Expected a numeric workout ID.`);
+  }
+  const updateDuration = toBoolean(flags["update-duration"], false);
+  const { client, memberInfo } = await requirePrivateMember(flags, deps);
+  const before = await client.getPlannedActivity(plannedActivityId, memberInfo.username);
+  const beforeSummary = summarizePlannedActivity(before);
+  const noop = Number(beforeSummary?.workoutId) === alternateWorkoutId;
+
+  if (dryRun || noop) {
+    const payload = {
+      generatedAt: new Date().toISOString(),
+      command: "replace-workout",
+      member: { memberId: memberInfo.memberId, username: memberInfo.username },
+      query: { plannedActivityId, alternateWorkoutId, updateDuration },
+      dryRun,
+      noop,
+      before: beforeSummary,
+      after: noop ? beforeSummary : null,
+      mutation: null,
+      message: noop
+        ? `Workout already uses alternate workout ${alternateWorkoutId}.`
+        : `Would replace workout ${beforeSummary?.workoutId ?? "?"} with ${alternateWorkoutId}.`,
+    };
+
+    if (!isJsonMode(flags)) {
+      await writeOutput(payload, flags, (value) => {
+        if (value.noop) {
+          return `No changes: plannedActivityId=${value.query.plannedActivityId} already uses workoutId=${value.query.alternateWorkoutId}`;
+        }
+        return `Would replace workout | plannedActivityId=${value.query.plannedActivityId} | workoutId=${value.before?.workoutId ?? "?"} -> alternateWorkoutId=${value.query.alternateWorkoutId}\nNo changes made.`;
+      });
+      return;
+    }
+
+    await writeOutput(payload, { ...flags, json: !flags.jsonl });
+    return;
+  }
+
+  const mutation = await client.replacePlannedActivityWithAlternate(plannedActivityId, alternateWorkoutId, {
+    updateDuration,
+    usernameForReferer: memberInfo.username,
+  });
+  const after = await client.getPlannedActivity(plannedActivityId, memberInfo.username);
+
+  const payload = {
+    generatedAt: new Date().toISOString(),
+    command: "replace-workout",
+    member: { memberId: memberInfo.memberId, username: memberInfo.username },
+    query: { plannedActivityId, alternateWorkoutId, updateDuration },
+    before: summarizePlannedActivity(before),
+    after: summarizePlannedActivity(after),
+    mutation: summarizePlannedActivity(mutation),
+  };
+
+  if (!isJsonMode(flags)) {
+    await writeOutput(payload, flags, (value) => {
+      return `Replaced workout | plannedActivityId=${value.query.plannedActivityId} | ${value.before?.workoutName ?? "?"} -> ${value.after?.workoutName ?? "?"}`;
+    });
+    return;
+  }
+
+  await writeOutput(payload, { ...flags, json: !flags.jsonl });
+}
+
+export async function commandSwitchWorkout(flags, deps) {
+  const { isJsonMode, requireFlag, toBoolean, writeOutput } = deps;
+  const dryRun = toBoolean(flags["dry-run"], false);
+  const plannedActivityId = String(requireFlag("switch-workout", flags, "id"));
+  const mode = String(requireFlag("switch-workout", flags, "mode")).toLowerCase();
+  if (!SWITCH_MODES.has(mode)) {
+    throw new Error(`Invalid --mode "${mode}". Expected one of: ${Array.from(SWITCH_MODES).join(", ")}.`);
+  }
+  const { client, memberInfo } = await requirePrivateMember(flags, deps);
+  const before = await client.getPlannedActivity(plannedActivityId, memberInfo.username);
+  const beforeSummary = summarizePlannedActivity(before);
+  const noop = beforeSummary?.isOutside === (mode === "outside");
+
+  if (dryRun || noop) {
+    const payload = {
+      generatedAt: new Date().toISOString(),
+      command: "switch-workout",
+      member: { memberId: memberInfo.memberId, username: memberInfo.username },
+      query: { plannedActivityId, mode },
+      dryRun,
+      noop,
+      before: beforeSummary,
+      after: noop ? beforeSummary : { ...beforeSummary, isOutside: mode === "outside" },
+      mutation: null,
+      message: noop
+        ? `Workout is already in ${mode} mode.`
+        : `Would switch workout to ${mode} mode.`,
+    };
+
+    if (!isJsonMode(flags)) {
+      await writeOutput(payload, flags, (value) => {
+        if (value.noop) {
+          return `No changes: plannedActivityId=${value.query.plannedActivityId} is already ${value.query.mode}`;
+        }
+        return `Would switch workout | plannedActivityId=${value.query.plannedActivityId} | outside=${value.before?.isOutside} -> ${value.query.mode === "outside"}\nNo changes made.`;
+      });
+      return;
+    }
+
+    await writeOutput(payload, { ...flags, json: !flags.jsonl });
+    return;
+  }
+
+  const mutation = await client.switchPlannedActivityMode(plannedActivityId, mode, memberInfo.username);
+  const after = await client.getPlannedActivity(plannedActivityId, memberInfo.username);
+
+  const payload = {
+    generatedAt: new Date().toISOString(),
+    command: "switch-workout",
+    member: { memberId: memberInfo.memberId, username: memberInfo.username },
+    query: { plannedActivityId, mode },
+    before: summarizePlannedActivity(before),
+    after: summarizePlannedActivity(after),
+    mutation: summarizePlannedActivity(mutation),
+  };
+
+  if (!isJsonMode(flags)) {
+    await writeOutput(payload, flags, (value) => {
+      return `Switched workout | plannedActivityId=${value.query.plannedActivityId} | outside=${value.before?.isOutside} -> ${value.after?.isOutside}`;
+    });
+    return;
+  }
+
+  await writeOutput(payload, { ...flags, json: !flags.jsonl });
+}

package/src/commands/workout-recommend.mjs

@@ -0,0 +1,175 @@
+import { queryWorkoutLibrary } from "./workout-library.mjs";
+
+async function requirePrivateMember(flags, deps) {
+  const { withClient } = deps;
+  const client = await withClient(flags);
+  try {
+    const memberInfo = await client.getMemberInfo();
+    return { client, memberInfo };
+  } catch {
+    throw new Error(
+      "workout-recommend requires private authenticated mode. Login first with trainerroad-cli login.",
+    );
+  }
+}
+
+function numericOrNull(value, deps) {
+  if (value == null) return null;
+  return deps.requireNumber(value, null);
+}
+
+function deriveTarget(explicit, min, max) {
+  if (explicit != null) return explicit;
+  if (min != null && max != null) return (min + max) / 2;
+  return null;
+}
+
+function compareValues(left, right) {
+  if (left === right) return 0;
+  if (left == null) return 1;
+  if (right == null) return -1;
+  if (typeof left === "string" || typeof right === "string") {
+    return String(left).localeCompare(String(right));
+  }
+  return Number(left) - Number(right);
+}
+
+function scoreWorkout(item, targets) {
+  let score = 0;
+  const reasons = [];
+
+  if (targets.level != null && item.progressionLevel != null) {
+    const delta = Math.abs(item.progressionLevel - targets.level);
+    score += delta * 10;
+    reasons.push({ metric: "level", target: targets.level, actual: item.progressionLevel, delta });
+  }
+
+  if (targets.duration != null && item.durationMinutes != null) {
+    const delta = Math.abs(item.durationMinutes - targets.duration);
+    score += delta / 5;
+    reasons.push({ metric: "duration", target: targets.duration, actual: item.durationMinutes, delta });
+  }
+
+  if (targets.tss != null && item.tss != null) {
+    const delta = Math.abs(item.tss - targets.tss);
+    score += delta / 10;
+    reasons.push({ metric: "tss", target: targets.tss, actual: item.tss, delta });
+  }
+
+  if (targets.searchText) {
+    const text = String(item.workoutName ?? "").toLowerCase();
+    const query = String(targets.searchText).toLowerCase();
+    if (text === query) score -= 2;
+    else if (text.includes(query)) score -= 1;
+  }
+
+  if (item.hasInstructions) score -= 0.15;
+  if (item.isOutside === false) score -= 0.05;
+
+  return { score, reasons };
+}
+
+export async function commandWorkoutRecommend(flags, deps) {
+  const { isJsonMode, requirePositiveInteger, requireNumber, toBoolean, writeOutput } = deps;
+  const { client, memberInfo } = await requirePrivateMember(flags, deps);
+
+  const count = requirePositiveInteger(flags.count, 5);
+  const candidateLimit = requirePositiveInteger(flags["candidate-limit"], 100);
+  const minDuration = numericOrNull(flags["min-duration"], deps);
+  const maxDuration = numericOrNull(flags["max-duration"], deps);
+  const minTss = numericOrNull(flags["min-tss"], deps);
+  const maxTss = numericOrNull(flags["max-tss"], deps);
+  const minLevel = numericOrNull(flags["min-level"], deps);
+  const maxLevel = numericOrNull(flags["max-level"], deps);
+  const targetDuration = deriveTarget(numericOrNull(flags["target-duration"], deps), minDuration, maxDuration);
+  const targetTss = deriveTarget(numericOrNull(flags["target-tss"], deps), minTss, maxTss);
+  const targetLevel = deriveTarget(numericOrNull(flags["target-level"], deps), minLevel, maxLevel);
+  const searchText = String(flags.search ?? "").trim();
+
+  const library = await queryWorkoutLibrary(client, memberInfo, {
+    searchText,
+    zone: flags.zone,
+    zoneId: flags["zone-id"],
+    profile: flags.profile,
+    profileId: flags["profile-id"],
+    outside: flags.outside == null ? null : toBoolean(flags.outside, false),
+    hasInstructions:
+      flags["has-instructions"] == null ? null : toBoolean(flags["has-instructions"], false),
+    minDuration,
+    maxDuration,
+    minTss,
+    maxTss,
+    minLevel,
+    maxLevel,
+    sort: String(flags.sort ?? "level"),
+    limit: candidateLimit,
+    pageSize: requirePositiveInteger(flags["page-size"], 50),
+  });
+
+  const targets = {
+    duration: targetDuration,
+    tss: targetTss,
+    level: targetLevel,
+    searchText,
+  };
+
+  const recommendations = library.records
+    .map((item) => {
+      const ranking = scoreWorkout(item, targets);
+      return { ...item, recommendationScore: ranking.score, rationale: ranking.reasons };
+    })
+    .sort(
+      (a, b) =>
+        compareValues(a.recommendationScore, b.recommendationScore) ||
+        compareValues(a.progressionLevel, b.progressionLevel) ||
+        compareValues(a.durationMinutes, b.durationMinutes) ||
+        compareValues(a.workoutName, b.workoutName),
+    )
+    .slice(0, count);
+
+  const payload = {
+    generatedAt: new Date().toISOString(),
+    command: "workout-recommend",
+    member: { memberId: memberInfo.memberId, username: memberInfo.username },
+    query: {
+      searchText,
+      zone: flags.zone ?? null,
+      zoneId: flags["zone-id"] ?? null,
+      profile: flags.profile ?? null,
+      profileId: flags["profile-id"] ?? null,
+      outside: flags.outside ?? null,
+      hasInstructions: flags["has-instructions"] ?? null,
+      minDuration,
+      maxDuration,
+      minTss,
+      maxTss,
+      minLevel,
+      maxLevel,
+      targetDuration,
+      targetTss,
+      targetLevel,
+      count,
+      candidateLimit,
+    },
+    fetch: library.fetch,
+    recommendationCount: recommendations.length,
+    records: recommendations,
+  };
+
+  if (!isJsonMode(flags)) {
+    await writeOutput(payload, flags, (value) => {
+      const lines = [
+        `Workout recommendations (${value.recommendationCount}) candidates=${value.fetch.fetchedCount}/${value.fetch.serverTotalCount ?? "?"}`,
+      ];
+      for (const item of value.records) {
+        lines.push(
+          `- ${item.workoutName ?? "(untitled)"} | workoutId=${item.workoutId} | score=${item.recommendationScore.toFixed(2)} | level=${item.progressionLevel ?? "?"} | duration=${item.durationMinutes ?? "?"}m | tss=${item.tss ?? "?"}`,
+        );
+      }
+      return lines.join("\n");
+    });
+    return;
+  }
+
+  await writeOutput(payload, { ...flags, json: !flags.jsonl });
+}