incremnt 0.1.9 → 0.1.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "incremnt",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Command-line tool for querying your incremnt strength training data",
   "license": "MIT",
   "type": "module",

package/src/contract.js

@@ -98,6 +98,23 @@ export const commandSchema = [
     options: [
       { name: 'id', type: 'string', required: true, description: 'Plan ID' }
     ]
+  },
+  {
+    command: 'cycles list',
+    id: 'cycle-summary-list',
+    description: 'List cycle summaries',
+    options: [
+      { name: 'program-id', type: 'string', required: false, description: 'Filter by program ID' }
+    ]
+  },
+  {
+    command: 'cycles show',
+    id: 'cycle-summary-show',
+    description: 'Show cycle summary details',
+    usage: 'cycles show --id <summary-id>',
+    options: [
+      { name: 'id', type: 'string', required: true, description: 'Cycle summary ID' }
+    ]
   }
 ];
 

package/src/format.js

@@ -403,6 +403,58 @@ function formatProposalsList(payload) {
   return lines.join('\n');
 }
 
+function formatCycleSummaryList(payload) {
+  if (!Array.isArray(payload) || payload.length === 0) {
+    return 'No cycle summaries found.';
+  }
+
+  const lines = [header('CYCLE SUMMARIES'), ''];
+
+  for (const summary of payload) {
+    const date = formatShortDate(summary.completedDate);
+    const sets = `${summary.totalSetsCompleted}/${summary.totalSetsPlanned} sets`;
+    const progressions = summary.progressionCount > 0 ? `${summary.progressionCount} progressions` : '';
+    const ai = summary.hasAISummary ? chalk.green('AI') : '';
+    const parts = [chalk.dim(sets), progressions ? chalk.dim(progressions) : '', ai].filter(Boolean);
+
+    lines.push(` ${chalk.bold(date)}  ${summary.programName}${dimDot()}${parts.join(dimDot())}`);
+  }
+
+  return lines.join('\n');
+}
+
+function formatCycleSummaryShow(payload) {
+  if (!payload) {
+    return 'Cycle summary not found.';
+  }
+
+  const date = formatDayAndDate(payload.completedDate);
+  const lines = [` ${chalk.bold('CYCLE SUMMARY')}${dimDot()}${date}`, ''];
+
+  lines.push(keyValue('Program', payload.programName));
+  lines.push(keyValue('Sets', `${payload.totalSetsCompleted}/${payload.totalSetsPlanned}`));
+
+  if (payload.progressionUpdates.length > 0) {
+    lines.push('');
+    lines.push(` ${chalk.bold('Progressions')}`);
+
+    for (const update of payload.progressionUpdates) {
+      const icon = update.kind === 'deload' ? chalk.yellow('\u2193') : chalk.green('\u2191');
+      lines.push(`   ${icon} ${update.exerciseName.padEnd(24)} ${chalk.dim(update.change)}`);
+    }
+  }
+
+  if (payload.aiSummary) {
+    lines.push('');
+    lines.push(` ${chalk.bold('AI Summary')}`);
+    for (const line of payload.aiSummary.split('\n')) {
+      lines.push(`   ${line}`);
+    }
+  }
+
+  return lines.join('\n');
+}
+
 function formatProposalDismissed(payload) {
   if (!payload) return 'Proposal not found.';
   return ` Proposal ${chalk.bold(payload.id)} dismissed.`;
@@ -459,6 +511,8 @@ export function formatPretty(command, payload) {
     'program-detail': formatProgramDetail,
     'planned-vs-actual': formatPlannedVsActual,
     'why-did-this-change': formatWhyDidThisChange,
+    'cycle-summary-list': formatCycleSummaryList,
+    'cycle-summary-show': formatCycleSummaryShow,
     'programs-propose': formatProposalCreated,
     'programs-proposals': formatProposalsList,
     'proposal-dismiss': formatProposalDismissed

package/src/openrouter.js

@@ -100,16 +100,24 @@ function formatCycleContext(ctx) {
   return lines.join('\n');
 }
 
-export const WORKOUT_COACH_PROMPT = `You are a strength coach writing a brief note after reviewing one training session. Write 2-3 short paragraphs separated by blank lines.
+export const WORKOUT_COACH_PROMPT = `You are reviewing a training session log. Write 2-3 short paragraphs separated by blank lines.
+
+Your job is to surface things the user wouldn't notice from glancing at their workout summary. The app already shows them PRs, total volume, effort score, and exercise breakdown — do NOT repeat any of that.
+
+Focus on:
+- Plan deviations: exercises swapped, skipped, or added vs the plan. Ask why if something looks unusual.
+- Set completion: if they did fewer sets than planned on an exercise, note it and ask about it.
+- Cross-session patterns: trends across recent sessions (volume direction on specific lifts, consistent cutoffs, same weight for weeks).
+- Ask 1-2 genuine questions about choices that look interesting or unusual.
 
 Rules:
-- Reference specific exercises, weights, and reps from the data. Use numbers, not vague praise.
-- If there are PRs, mention them matter-of-factly. Do not celebrate or inflate them.
-- Compare volume or effort to recent sessions if the data is there. Just state what changed.
-- End with one concrete suggestion for next session. Be specific about which exercise and what to try.
-- Write like a real person texting a training partner — short sentences, no filler, no cheerleading.
-- Never use words like: impressive, crushed, solid, demonstrating, significant, incredible, fantastic, highlighting.
+- Only state what the data shows. Never claim how something "felt" — you have numbers, not feelings.
+- Never use words like: impressive, crushed, solid, demonstrating, significant, incredible, fantastic, smooth, controlled.
 - Never use -ing clauses that add fake depth ("indicating progressive overload", "demonstrating strength gains").
+- Never say things "felt smooth", "felt controlled", "feels about average" — you cannot know this.
+- Never restate PRs, total volume, or effort score — the user already sees these in the app.
+- Write like a training partner looking at a logbook, not a motivational coach.
+- Short sentences, no filler, no cheerleading. Questions are good.
 - No bullet points or lists.`;
 
 export async function generateWorkoutCoachingSummary(workoutContext, { apiKey, model, timeoutMs } = {}) {
@@ -189,5 +197,24 @@ export function formatWorkoutContext(ctx) {
     }
   }
 
+  if (ctx.planComparison) {
+    const planLines = [];
+    if (ctx.planComparison.skipped.length > 0) {
+      planLines.push(`  Skipped: ${ctx.planComparison.skipped.join(', ')}`);
+    }
+    if (ctx.planComparison.added.length > 0) {
+      planLines.push(`  Added: ${ctx.planComparison.added.join(', ')}`);
+    }
+    for (const sc of ctx.planComparison.setsComparison) {
+      if (sc.completed !== sc.planned) {
+        planLines.push(`  ${sc.exercise}: ${sc.completed}/${sc.planned} sets`);
+      }
+    }
+    if (planLines.length > 0) {
+      lines.push('Plan comparison:');
+      lines.push(...planLines);
+    }
+  }
+
   return lines.join('\n');
 }

package/src/queries.js

@@ -2,6 +2,44 @@ function completionDateForSession(session) {
   return session.completedAt ?? session.summary?.date ?? session.date;
 }
 
+function buildPlanComparison(session, performedExercises, plannedExercises) {
+  if (!Array.isArray(plannedExercises) || plannedExercises.length === 0) {
+    return undefined;
+  }
+
+  const plannedNames = plannedExercises.map((exercise) =>
+    normalizeExerciseName(exercise.name ?? exercise.exerciseName)
+  );
+  const performedNames = performedExercises.map((exercise) =>
+    normalizeExerciseName(exercise.exerciseName)
+  );
+
+  const skipped = plannedExercises
+    .filter((exercise) => !performedNames.includes(normalizeExerciseName(exercise.name ?? exercise.exerciseName)))
+    .map((exercise) => exercise.name ?? exercise.exerciseName);
+
+  const added = (session.exercises ?? [])
+    .filter((exercise) => !plannedNames.includes(normalizeExerciseName(exercise.name)))
+    .map((exercise) => exercise.name);
+
+  const setsComparison = plannedExercises
+    .filter((exercise) => performedNames.includes(normalizeExerciseName(exercise.name ?? exercise.exerciseName)))
+    .map((planned) => {
+      const plannedName = planned.name ?? planned.exerciseName;
+      const performed = (session.exercises ?? []).find(
+        (exercise) => normalizeExerciseName(exercise.name) === normalizeExerciseName(plannedName)
+      );
+      const completedSets = (performed?.sets ?? []).filter((set) => set.isComplete).length;
+      return {
+        exercise: plannedName,
+        planned: Array.isArray(planned.sets) ? planned.sets.length : (planned.targetSets ?? []).length,
+        completed: completedSets
+      };
+    });
+
+  return { skipped, added, setsComparison };
+}
+
 function sessionSummary(session) {
   return {
     sessionId: session.id,
@@ -19,7 +57,8 @@ function sessionSummary(session) {
     exerciseCount: (session.exercises ?? []).length,
     recommendations: session.recommendations ?? {},
     historicalContext: session.historicalContext ?? null,
-    prescriptionSnapshot: session.prescriptionSnapshot ?? null
+    prescriptionSnapshot: session.prescriptionSnapshot ?? null,
+    aiCoachNotes: session.aiCoachNotes ?? null
   };
 }
 
@@ -207,6 +246,7 @@ export function sessionDetails(snapshot, sessionId) {
   summary.exercises = (session.exercises ?? []).map((exercise) => ({
     name: exercise.name,
     muscleGroup: exercise.muscleGroup ?? null,
+    swappedFrom: exercise.swappedFrom ?? null,
     sets: (exercise.sets ?? []).filter((s) => s.isComplete).map((s) => ({
       weight: s.weight ?? null,
       reps: s.reps ?? null,
@@ -235,6 +275,7 @@ export function plannedVsActual(snapshot, sessionId) {
       return {
         exerciseName: exercise.name,
         muscleGroup: exercise.muscleGroup,
+        swappedFrom: exercise.swappedFrom ?? null,
         plannedSets: planned?.targetSets ?? [],
         actualSets: (exercise.sets ?? []).filter((set) => set.isComplete),
         plannedRir: planned?.rir ?? null,
@@ -347,6 +388,43 @@ export function goalDetail(snapshot, planId) {
   };
 }
 
+export function cycleSummaryList(snapshot, programId) {
+  const summaries = snapshot.cycleSummaries ?? [];
+  const filtered = programId
+    ? summaries.filter((s) => s.programId === programId)
+    : summaries;
+
+  return [...filtered]
+    .sort((a, b) => String(b.completedDate).localeCompare(String(a.completedDate)))
+    .map((s) => ({
+      id: s.id,
+      programId: s.programId,
+      programName: s.programName,
+      completedDate: s.completedDate,
+      totalSetsCompleted: s.totalSetsCompleted ?? 0,
+      totalSetsPlanned: s.totalSetsPlanned ?? 0,
+      progressionCount: (s.progressionUpdates ?? []).length,
+      hasAISummary: !!s.aiSummary
+    }));
+}
+
+export function cycleSummaryShow(snapshot, summaryId) {
+  const summaries = snapshot.cycleSummaries ?? [];
+  const summary = summaries.find((s) => s.id === summaryId);
+  if (!summary) return null;
+
+  return {
+    id: summary.id,
+    programId: summary.programId,
+    programName: summary.programName,
+    completedDate: summary.completedDate,
+    totalSetsCompleted: summary.totalSetsCompleted ?? 0,
+    totalSetsPlanned: summary.totalSetsPlanned ?? 0,
+    progressionUpdates: summary.progressionUpdates ?? [],
+    aiSummary: summary.aiSummary ?? null
+  };
+}
+
 export function cycleSummaryContext(snapshot, programId) {
   const programs = snapshot.programs ?? [];
   const program = programId
@@ -561,7 +639,21 @@ export function workoutSummaryContext(snapshot, sessionId) {
     }
   }
 
-  return {
+  // Plan comparison — prefer the logged point-in-time prescription snapshot.
+  let planComparison;
+  if (session.prescriptionSnapshot?.exercises?.length > 0) {
+    planComparison = buildPlanComparison(session, exercises, session.prescriptionSnapshot.exercises);
+  } else if (session.programId) {
+    const program = (snapshot.programs ?? []).find(p => p.id === session.programId);
+    const matchingDay = Number.isInteger(session.programDayIndex)
+      ? program?.days?.[session.programDayIndex]
+      : program?.days?.find(d => d.title === dayName);
+    if (matchingDay) {
+      planComparison = buildPlanComparison(session, exercises, matchingDay.exercises ?? []);
+    }
+  }
+
+  const result = {
     sessionDate,
     dayName,
     totalVolume: session.summary?.totalVolume ?? session.volume ?? 0,
@@ -570,6 +662,8 @@ export function workoutSummaryContext(snapshot, sessionId) {
     recentComparisons,
     prs
   };
+  if (planComparison) result.planComparison = planComparison;
+  return result;
 }
 
 function requiredOption(options, primaryKey, legacyKey = null) {
@@ -674,5 +768,24 @@ export function executeReadCommand(snapshot, normalizedCommand, options = {}) {
     return { ok: true, payload };
   }
 
+  if (normalizedCommand === 'cycle-summary-list') {
+    const programId = requiredOption(options, 'program-id');
+    return { ok: true, payload: cycleSummaryList(snapshot, programId ?? null) };
+  }
+
+  if (normalizedCommand === 'cycle-summary-show') {
+    const summaryId = requiredOption(options, 'id');
+    if (!summaryId) {
+      return { ok: false, error: '--id is required' };
+    }
+
+    const payload = cycleSummaryShow(snapshot, summaryId);
+    if (!payload) {
+      return { ok: false, error: `Cycle summary not found: ${summaryId}` };
+    }
+
+    return { ok: true, payload };
+  }
+
   return { ok: false, error: `Unknown read command: ${normalizedCommand}` };
 }