incremnt 0.1.17 → 0.1.18

package/package.json

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

package/src/contract.js

@@ -1,4 +1,4 @@
-export const contractVersion = 1;
+export const contractVersion = 4;
 
 export const capabilities = {
   readOnly: false,
@@ -124,6 +124,18 @@ export const commandSchema = [
       { name: 'days', type: 'number', required: false, description: 'Last N days (default: 14)' }
     ]
   },
+  {
+    command: 'health ai',
+    id: 'health-ai',
+    description: 'Latest AI vitals summary and history',
+    options: []
+  },
+  {
+    command: 'training load',
+    id: 'training-load',
+    description: 'Training load analysis (7-day vs 28-day comparison, effort scores, readiness via ATL/CTL/TSB, per-type breakdown)',
+    options: []
+  },
   {
     command: 'ask history',
     id: 'ask-history',

package/src/format.js

@@ -463,6 +463,45 @@ function formatCycleSummaryShow(payload) {
   return lines.join('\n');
 }
 
+function formatAskHistory(payload) {
+  const conversations = payload?.conversations;
+  if (!Array.isArray(conversations) || conversations.length === 0) {
+    return 'No conversations found.';
+  }
+
+  const lines = [header('COACH CONVERSATIONS'), ''];
+
+  for (const c of conversations) {
+    const date = formatShortDate(c.createdAt);
+    const preview = c.preview || chalk.dim('(no preview)');
+    const msgs = `${c.messageCount} msg${c.messageCount !== 1 ? 's' : ''}`;
+    lines.push(` ${chalk.bold(date)}  ${preview}${dimDot()}${chalk.dim(msgs)}${dimDot()}${chalk.dim(c.id)}`);
+  }
+
+  return lines.join('\n');
+}
+
+function formatAskShow(payload) {
+  if (!payload || !Array.isArray(payload.messages)) {
+    return 'Conversation not found.';
+  }
+
+  const date = formatShortDate(payload.createdAt);
+  const lines = [` ${chalk.bold('CONVERSATION')}${dimDot()}${date}`, ''];
+
+  for (const msg of payload.messages) {
+    const label = msg.role === 'user' ? chalk.cyan('You') : chalk.green('Coach');
+    lines.push(` ${label}`);
+    for (const line of (msg.content ?? '').split('\n')) {
+      lines.push(`   ${line}`);
+    }
+    lines.push('');
+  }
+
+  if (lines.at(-1) === '') lines.pop();
+  return lines.join('\n');
+}
+
 function formatProposalDismissed(payload) {
   if (!payload) return 'Proposal not found.';
   return ` Proposal ${chalk.bold(payload.id)} dismissed.`;
@@ -526,6 +565,8 @@ export function formatPretty(command, payload) {
     'why-did-this-change': formatWhyDidThisChange,
     'cycle-summary-list': formatCycleSummaryList,
     'cycle-summary-show': formatCycleSummaryShow,
+    'ask-history': formatAskHistory,
+    'ask-show': formatAskShow,
     'programs-propose': formatProposalCreated,
     'programs-proposals': formatProposalsList,
     'proposal-dismiss': formatProposalDismissed

package/src/mcp.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
@@ -82,6 +83,6 @@ async function main() {
   await server.connect(transport);
 }
 
-if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+if (process.argv[1] && fs.realpathSync(path.resolve(process.argv[1])) === fileURLToPath(import.meta.url)) {
   await main();
 }

package/src/openrouter.js

@@ -1,68 +1,108 @@
 const SUMMARY_MODEL_CHAIN = [
-  'deepseek/deepseek-v3.2-20251201',
+  'deepseek/deepseek-v3.2',
   'anthropic/claude-3.5-haiku'
 ];
 const ASK_MODEL_CHAIN = [
   'anthropic/claude-3.5-haiku',
-  'deepseek/deepseek-v3.2-20251201'
+  'deepseek/deepseek-v3.2'
 ];
-const TIMEOUT_PER_MODEL_MS = 12_000;
-const ASK_TIMEOUT_MS = 8_000;
+const TIMEOUT_PER_MODEL_MS = 15_000;
+const ASK_TIMEOUT_MS = 15_000;
 const DEFAULT_MAX_TOKENS = 500;
 
-async function callOpenRouter(messages, { apiKey, models, temperature, maxTokens, timeoutMs }) {
+function callModel(model, messages, { apiKey, temperature, maxTokens, timeoutMs, signal }) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  if (signal) signal.addEventListener('abort', () => controller.abort(), { once: true });
+  const start = Date.now();
+
+  return fetch('https://openrouter.ai/api/v1/chat/completions', {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${apiKey}`,
+      'Content-Type': 'application/json',
+      'HTTP-Referer': 'https://incremnt.app',
+      'X-Title': 'incremnt'
+    },
+    body: JSON.stringify({
+      model,
+      messages,
+      max_tokens: maxTokens ?? DEFAULT_MAX_TOKENS,
+      temperature: temperature ?? 0.5
+    }),
+    signal: controller.signal
+  }).then(async (response) => {
+    if (!response.ok) {
+      const text = await response.text().catch(() => '');
+      throw new Error(`OpenRouter API error ${response.status}: ${text}`);
+    }
+    const data = await response.json();
+    const content = data.choices?.[0]?.message?.content;
+    if (!content) {
+      throw new Error('No content in OpenRouter response');
+    }
+    return { text: content.trim(), model, durationMs: Date.now() - start };
+  }).catch((err) => {
+    if (err.name === 'AbortError' && signal?.aborted) return null; // cancelled by race winner
+    err.model = err.model ?? model;
+    err.durationMs = err.durationMs ?? (Date.now() - start);
+    throw err;
+  }).finally(() => {
+    clearTimeout(timer);
+  });
+}
+
+async function callOpenRouter(messages, { apiKey, models, temperature, maxTokens, timeoutMs, race }) {
   const chain = models ?? SUMMARY_MODEL_CHAIN;
   const timeout = timeoutMs ?? TIMEOUT_PER_MODEL_MS;
-  const errors = [];
-
   const startTotal = Date.now();
+  const opts = { apiKey, temperature, maxTokens, timeoutMs: timeout };
 
-  for (const model of chain) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeout);
-    const startModel = Date.now();
-
+  if (race && chain.length > 1) {
+    const raceController = new AbortController();
+    const promises = chain.map((model) =>
+      callModel(model, messages, { ...opts, signal: raceController.signal })
+    );
     try {
-      const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
-        method: 'POST',
-        headers: {
-          'Authorization': `Bearer ${apiKey}`,
-          'Content-Type': 'application/json',
-          'HTTP-Referer': 'https://incremnt.app',
-          'X-Title': 'incremnt'
-        },
-        body: JSON.stringify({
-          model,
-          messages,
-          max_tokens: maxTokens ?? DEFAULT_MAX_TOKENS,
-          temperature: temperature ?? 0.5
-        }),
-        signal: controller.signal
-      });
-
-      if (!response.ok) {
-        const text = await response.text().catch(() => '');
-        throw new Error(`OpenRouter API error ${response.status}: ${text}`);
-      }
-
-      const data = await response.json();
-      const content = data.choices?.[0]?.message?.content;
-      if (!content) {
-        throw new Error('No content in OpenRouter response');
-      }
+      const result = await Promise.any(promises);
+      raceController.abort(); // cancel losers
+      // Collect errors from models that failed before the winner resolved
+      const settled = await Promise.allSettled(promises);
+      const errors = settled
+        .filter((s) => s.status === 'rejected')
+        .map((s) => ({ model: s.reason.model, error: s.reason.message, durationMs: s.reason.durationMs }));
+      return {
+        ...result,
+        fallback: result.model !== chain[0],
+        durationMs: Date.now() - startTotal,
+        errors: errors.length > 0 ? errors : undefined
+      };
+    } catch (aggregate) {
+      const errors = aggregate.errors.map((e) => ({
+        model: e.model, error: e.message, durationMs: e.durationMs
+      }));
+      errors.forEach((e) => console.error(`OpenRouter ${e.model} failed (${e.durationMs}ms): ${e.error}`));
+      const err = new Error(`All models failed: ${errors.map((e) => `${e.model}: ${e.error}`).join('; ')}`);
+      err.modelErrors = errors;
+      err.durationMs = Date.now() - startTotal;
+      throw err;
+    }
+  }
 
+  // Sequential fallback (for single-model calls or explicit sequential mode)
+  const errors = [];
+  for (const model of chain) {
+    try {
+      const result = await callModel(model, messages, opts);
       return {
-        text: content.trim(),
-        model,
+        ...result,
         fallback: model !== chain[0],
         durationMs: Date.now() - startTotal,
         errors: errors.length > 0 ? errors : undefined
       };
     } catch (err) {
-      errors.push({ model, error: err.message, durationMs: Date.now() - startModel });
-      console.error(`OpenRouter ${model} failed (${Date.now() - startModel}ms): ${err.message}`);
-    } finally {
-      clearTimeout(timer);
+      errors.push({ model: err.model, error: err.message, durationMs: err.durationMs });
+      console.error(`OpenRouter ${err.model} failed (${err.durationMs}ms): ${err.message}`);
     }
   }
 
@@ -78,7 +118,7 @@ Your job is to give a cycle-level review — not a session-by-session recap. The
 
 The data tells the story — your job is to interpret it honestly, not to make the trainee feel good.
 
-Cover these in order of relevance (skip any that don't apply):
+Cover these in order of relevance (skip any that don't apply). If "Priority signals (ranked)" are present in context, treat them as the ordering anchor:
 1. Overall cycle assessment: was this a build/deload/peak week? Did volume and intensity match the intent? If it was a deload, don't flag low numbers as a problem.
 2. Progression commentary: the app made auto-progression decisions listed below. Comment on whether they look right given the data.
 3. Multi-cycle trends: if previous cycle data is provided, note meaningful trends. Don't force trends where there aren't any.
@@ -89,18 +129,32 @@ Only state what the data shows. Never claim how something "felt." Reference spec
 
 If you catch yourself writing something that sounds like a performance review or a fitness influencer post, rewrite it. No -ing clauses that add fake depth. No bullet points or lists.`;
 
+export const FIRST_WEEK_CYCLE_PROMPT = `You are a strength coach reviewing a trainee's first completed week on a new program. Write 2-3 short paragraphs separated by blank lines.
+
+This is their first week — there are no prior cycles to compare against, no trends to analyze, and no progression history yet. Do NOT try to identify trends, compare to previous weeks, or analyze progression patterns. There is nothing to compare to.
+
+Your job is to acknowledge the work they put in this week, referencing specific exercises and numbers from the data so it is obvious you actually looked at what they did. Set expectations clearly: this week is the baseline, and from next week onward you'll be able to track trends, flag plateaus, and give real coaching feedback. If there are PRs listed, mention them, but frame them as first-week baselines rather than breakthroughs.
+
+Keep it short and direct. No fake enthusiasm, no cheerleading, no "great job!" filler. But do be genuinely encouraging — they showed up and logged real work, which is the hardest part. A matter-of-fact "solid first week" tone is right.
+
+Write like a training partner, not a motivational poster. Short sentences, no filler. If you catch yourself writing something that sounds like a fitness influencer post, rewrite it. No bullet points or lists.`;
+
 export async function generateCoachingSummary(cycleContext, { apiKey, model, timeoutMs } = {}) {
   const userContent = formatCycleContext(cycleContext);
+  const isFirstWeek = cycleContext.cycleNumber === 1
+    && (!cycleContext.previousCycles || cycleContext.previousCycles.length === 0);
+  const systemPrompt = isFirstWeek ? FIRST_WEEK_CYCLE_PROMPT : CYCLE_SUMMARY_PROMPT;
   return callOpenRouter(
     [
-      { role: 'system', content: CYCLE_SUMMARY_PROMPT },
+      { role: 'system', content: systemPrompt },
       { role: 'user', content: userContent }
     ],
     {
       apiKey,
       models: model ? [model] : SUMMARY_MODEL_CHAIN,
       temperature: 0.5,
-      timeoutMs
+      timeoutMs,
+      race: !model
     }
   );
 }
@@ -111,6 +165,15 @@ export function formatCycleContext(ctx) {
     `Program: ${ctx.programName}, Week ${ctx.cycleNumber}${intentLabel}, ${ctx.totalSessions} session(s).`
   ];
 
+  if (ctx.prioritySignals?.length > 0) {
+    lines.push('');
+    lines.push('Priority signals (ranked):');
+    for (const signal of ctx.prioritySignals) {
+      lines.push(`  [${signal.rank}] ${signal.summary} (score ${signal.score})`);
+      if (signal.detail) lines.push(`    ${signal.detail}`);
+    }
+  }
+
   if (ctx.setCompletionRate) {
     const pct = ctx.setCompletionRate.planned > 0
       ? Math.round(ctx.setCompletionRate.completed / ctx.setCompletionRate.planned * 100)
@@ -136,7 +199,9 @@ export function formatCycleContext(ctx) {
         ? `${ex.completedSets}/${ex.plannedSets} sets`
         : `${ex.completedSets} sets`;
       const topPart = ex.topSet
-        ? ` (top: ${ex.topSet.weight}×${ex.topSet.reps})`
+        ? ex.isBodyweight
+          ? ` (top: BW×${ex.topSet.reps})`
+          : ` (top: ${ex.topSet.weight}×${ex.topSet.reps})`
         : '';
       lines.push(`  ${ex.exerciseName}: ${setPart}${topPart}`);
     }
@@ -150,6 +215,16 @@ export function formatCycleContext(ctx) {
     }
   }
 
+  if (ctx.bwPrsThisCycle?.length > 0) {
+    if (ctx.prsThisCycle.length === 0) {
+      lines.push('');
+      lines.push('PRs this cycle:');
+    }
+    for (const pr of ctx.bwPrsThisCycle) {
+      lines.push(`  ${pr.exerciseName}: BW×${pr.reps} (prev best ${pr.previousBest} reps)`);
+    }
+  }
+
   if (ctx.progressionDecisions?.length > 0) {
     lines.push('');
     lines.push('Progression decisions made by the app:');
@@ -191,8 +266,17 @@ export function formatCycleContext(ctx) {
     lines.push('');
     lines.push('Exercise trends (last 3 cycles):');
     for (const et of ctx.exerciseTrends) {
-      const trendStr = et.trend.map((t) => t.e1RM).join(' → ');
-      lines.push(`  ${et.exerciseName} e1RM: ${trendStr}`);
+      if (et.isBodyweight) {
+        const trendStr = et.trend.map((t) =>
+          t.bestReps != null ? `${t.bestReps} reps` : `${t.e1RM} e1RM`
+        ).join(' → ');
+        lines.push(`  ${et.exerciseName} (BW) best reps: ${trendStr}`);
+      } else {
+        const trendStr = et.trend.map((t) =>
+          t.e1RM != null ? t.e1RM : `${t.bestReps} reps`
+        ).join(' → ');
+        lines.push(`  ${et.exerciseName} e1RM: ${trendStr}`);
+      }
     }
   }
 
@@ -226,11 +310,13 @@ export const WORKOUT_COACH_PROMPT = `You are reviewing a training session log. W
 
 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. The data tells the story — your job is to interpret it honestly, not to make the user feel good.
 
-Focus on plan deviations (exercises swapped, skipped, or added vs the plan), set completion (if they did fewer sets than planned, note it and ask about it), and cross-session patterns (volume direction on specific lifts, consistent cutoffs, same weight for weeks). If exercises are marked "first session" they have zero prior history — state this plainly, don't frame it as "exploring" or "a new loading strategy." If this is an adhoc session, note any overlap with programmed exercises.
+Focus on plan deviations (exercises swapped, skipped, or added vs the plan), set completion (if they did fewer sets than planned, note it and ask about it), and cross-session patterns (volume direction on specific lifts, consistent cutoffs, same weight for weeks). Use "Priority signals (ranked)" as the first pass for what to address. If exercises are marked "no prior sessions logged" they have zero prior history for that exact exercise — state this plainly. If the context says the program changed since the previous session, treat new exercises as part of that switch instead of framing them as unexplained experimentation. If this is an adhoc session, note any overlap with programmed exercises.
+
+The app generates and assigns training programs automatically — the user does not choose them. Never ask why the user picked or switched to a particular program. If a program change occurred, acknowledge it factually and focus on how the new exercises went, not why the change was made.
 
-Never name an exercise that does not appear in the workout data below. [first session] means no prior history for that exact exercise. It does not mean the user switched from another exercise.
+Never name an exercise that does not appear in the workout data below. "No prior sessions logged" means no prior history for that exact exercise. It does not mean the user switched from another exercise unless the context explicitly shows a program change.
 
-Ask 1-2 genuine questions about choices that look interesting or unusual. This is the most valuable thing you can do — a good question is worth more than restating what happened.
+Ask 1-2 genuine questions about in-workout decisions that look interesting or unusual, like swaps, cutoffs, repeated loads, or unexpected set outcomes. This is the most valuable thing you can do — a good question is worth more than restating what happened.
 
 Only state what the data shows. Never claim how something "felt." Be specific — use numbers and exercise names. Don't soften with "suggests", "appears to", "seems", "might." State it. Don't start sentences with "The session shows", "Your performance indicates", "It's worth noting." Just say it.
 
@@ -247,7 +333,8 @@ export async function generateWorkoutCoachingSummary(workoutContext, { apiKey, m
       apiKey,
       models: model ? [model] : SUMMARY_MODEL_CHAIN,
       temperature: 0.5,
-      timeoutMs
+      timeoutMs,
+      race: !model
     }
   );
 }
@@ -258,16 +345,28 @@ export function formatWorkoutContext(ctx) {
     : `Session: ${ctx.dayName}, ${ctx.sessionDate}, program "${ctx.programName}", ${ctx.totalVolume} kg total volume.`;
   const lines = [sessionLabel];
 
+  if (ctx.prioritySignals?.length > 0) {
+    lines.push('Priority signals (ranked):');
+    for (const signal of ctx.prioritySignals) {
+      lines.push(`  [${signal.rank}] ${signal.summary} (score ${signal.score})`);
+      if (signal.detail) lines.push(`    ${signal.detail}`);
+    }
+  }
+
   if (ctx.effortScore) {
     lines.push(`Effort rating: ${ctx.effortScore}/10.`);
   }
 
   lines.push('Exercises:');
   for (const ex of ctx.exercises) {
-    const topPart = ex.topSet ? ` (top: ${ex.topSet.weight}×${ex.topSet.reps})` : '';
+    const topPart = ex.topSet
+      ? ex.isBodyweight
+        ? ` (top: BW×${ex.topSet.reps})`
+        : ` (top: ${ex.topSet.weight}×${ex.topSet.reps})`
+      : '';
     const historyPart = ex.priorSessions === 0
-      ? ' [first session]'
-      : ` [${ex.priorSessions} prior sessions]`;
+      ? ' (no prior sessions logged)'
+      : ` (${ex.priorSessions} prior sessions)`;
     lines.push(`  ${ex.exerciseName}: ${ex.completedSets} sets${topPart}${historyPart}`);
   }
 
@@ -278,6 +377,20 @@ export function formatWorkoutContext(ctx) {
     }
   }
 
+  if (ctx.bwPrs?.length > 0) {
+    lines.push('Bodyweight rep PRs this session:');
+    for (const pr of ctx.bwPrs) {
+      lines.push(`  ${pr.exerciseName}: BW×${pr.reps} (prev best ${pr.previousBest} reps)`);
+    }
+  }
+
+  if (ctx.repPrs?.length > 0) {
+    lines.push('Rep PRs this session (most reps at weight or higher):');
+    for (const pr of ctx.repPrs) {
+      lines.push(`  ${pr.exerciseName}: ${pr.weight}×${pr.reps}`);
+    }
+  }
+
   if (ctx.recentComparisons.length > 0) {
     lines.push('Recent same-day sessions for comparison:');
     for (const comp of ctx.recentComparisons) {
@@ -306,6 +419,16 @@ export function formatWorkoutContext(ctx) {
     }
   }
 
+  if (ctx.programChange) {
+    const previousProgram = ctx.programChange.previousProgramName ?? 'adhoc training';
+    const currentProgram = ctx.programChange.currentProgramName ?? 'adhoc training';
+    lines.push(
+      `Program change since previous session: ${ctx.programChange.previousSessionDate} ` +
+      `${ctx.programChange.previousDayName} in "${previousProgram}" -> ` +
+      `${ctx.programChange.currentDayName} in "${currentProgram}".`
+    );
+  }
+
   // Recovery context
   const recoveryParts = [];
   if (ctx.restingHROnDay) recoveryParts.push(`resting HR ${Math.round(ctx.restingHROnDay)} bpm`);
@@ -326,6 +449,88 @@ export function formatWorkoutContext(ctx) {
       if (w.effortScore) parts.push(`effort ${w.effortScore}/10`);
       lines.push(`  ${w.date} ${w.workoutType}: ${parts.join(', ')}`);
     }
+    const totalSecs = ctx.nearbyCardio.reduce((sum, w) => sum + (w.durationSecs ?? 0), 0);
+    const totalMins = Math.round(totalSecs / 60);
+    const totalKm = ctx.nearbyCardio.reduce((sum, w) => sum + (w.distanceKm ?? 0), 0);
+    const distPart = totalKm > 0 ? `, ${totalKm.toFixed(1)} km total` : '';
+    lines.push(`  Total: ${ctx.nearbyCardio.length} sessions, ${totalMins} min${distPart}`);
+  }
+
+  return lines.join('\n');
+}
+
+const VITALS_SUMMARY_PROMPT = `You are a concise fitness recovery coach. Given a user's current health vitals and recent training data, write a 2-3 sentence morning summary. Be direct and actionable. Focus on what matters today: recovery status, readiness to train, and any notable changes. If "Priority signals" are present, anchor your summary on those first. Do not list numbers — interpret them. If data is missing, focus on what's available. Never give medical advice.`;
+
+export async function generateVitalsSummary(context, { apiKey, model, timeoutMs } = {}) {
+  return callOpenRouter(
+    [
+      { role: 'system', content: VITALS_SUMMARY_PROMPT },
+      { role: 'user', content: context }
+    ],
+    {
+      apiKey,
+      models: model ? [model] : SUMMARY_MODEL_CHAIN,
+      temperature: 0.5,
+      maxTokens: 200,
+      timeoutMs,
+      race: !model
+    }
+  );
+}
+
+export const CHECKPOINT_SUMMARY_PROMPT = `You are a strength coach reviewing a trainee's mid-plan checkpoint. They are partway through an 8-week strength plan with specific e1RM targets for each lift. Write 2-3 short paragraphs separated by blank lines.
+
+Your job is to assess goal trajectory — are they on pace, ahead, or behind for each lift target? The app already shows raw numbers and progress bars — do NOT repeat those. Synthesize across exercises and identify patterns.
+
+Cover in order of relevance (skip any that don't apply):
+1. Overall trajectory: given current progress vs expected linear pace, will they hit their 8-week targets? Be honest if some goals look unrealistic at this point.
+2. Exercise-level detail: which lifts are behind and why that might be (frequency, fatigue, technique plateau). Which are ahead. If this is a week 6 checkpoint and week 3 data is available, note acceleration or deceleration since then.
+3. Actionable suggestions for the remaining weeks. Be specific — name exercises, rep ranges, or frequency changes. One or two concrete things, not a laundry list.
+
+Only state what the data shows. Never claim how something "felt." Reference specific exercises, weights, and percentages — use numbers, not vague descriptions. Write like a training partner looking at a logbook. Short sentences, no filler, no cheerleading. If a goal is already hit, say so and suggest what to do with the remaining weeks.
+
+If you catch yourself writing something that sounds like a performance review or a fitness influencer post, rewrite it. No -ing clauses that add fake depth. No bullet points or lists.`;
+
+export async function generateCheckpointSummary(checkpointContext, { apiKey, model, timeoutMs } = {}) {
+  const userContent = formatCheckpointContext(checkpointContext);
+  return callOpenRouter(
+    [
+      { role: 'system', content: CHECKPOINT_SUMMARY_PROMPT },
+      { role: 'user', content: userContent }
+    ],
+    {
+      apiKey,
+      models: model ? [model] : SUMMARY_MODEL_CHAIN,
+      temperature: 0.5,
+      timeoutMs,
+      race: !model
+    }
+  );
+}
+
+export function formatCheckpointContext(ctx) {
+  const lines = [
+    `Program: ${ctx.programName}, Checkpoint at week ${ctx.checkpointWeek} of ${ctx.totalWeeks}.`
+  ];
+
+  lines.push('');
+  lines.push('Exercise targets:');
+  for (const ex of ctx.exercises) {
+    const gained = ex.currentE1RM - ex.startingE1RM;
+    const gainedStr = gained >= 0 ? `+${gained.toFixed(1)}` : gained.toFixed(1);
+    lines.push(`  ${ex.name}: ${ex.startingE1RM} → ${ex.currentE1RM} (target ${ex.targetE1RM}), ${ex.progressPercent}% done, ${ex.status} (${gainedStr} kg)`);
+    if (ex.deltaFromLastCheckpoint != null) {
+      lines.push(`    Since week 3 checkpoint: ${ex.deltaFromLastCheckpoint >= 0 ? '+' : ''}${ex.deltaFromLastCheckpoint.toFixed(1)} kg`);
+    }
+  }
+
+  if (ctx.previousCycleNotes.length > 0) {
+    lines.push('');
+    lines.push('Recent cycle coach notes:');
+    for (const note of ctx.previousCycleNotes) {
+      const firstLine = note.split('\n')[0].slice(0, 150);
+      lines.push(`  "${firstLine}"`);
+    }
   }
 
   return lines.join('\n');
@@ -336,6 +541,7 @@ export const ASK_PROMPT = `You are a strength coach answering questions from the
 Rules:
 - Use only the data provided. If the data does not support a claim, do not make it.
 - Focus on trend, weak points, tradeoffs, and next steps. Be specific with exercises, weights, reps, volume, and timing when relevant.
+- If the context includes "Priority signals", prioritize those before broader commentary.
 - Match the response length to the question. Short or playful prompts get a short conversational reply plus an invitation to ask something specific.
 - Keep the tone natural and direct. No hype, no filler, no emoji, no "let's dive in", no performance-review language.
 - Never name an exercise that does not appear in the training data below.
@@ -365,7 +571,8 @@ export async function generateAskAnswer(context, question, { apiKey, model, time
       apiKey,
       models: model ? [model] : ASK_MODEL_CHAIN,
       temperature: 0.3,
-      timeoutMs: timeoutMs ?? ASK_TIMEOUT_MS
+      timeoutMs: timeoutMs ?? ASK_TIMEOUT_MS,
+      race: !model
     }
   );
 }