incremnt 0.8.4 → 0.8.6

package/package.json

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

package/src/ask-answer-verifier.js

@@ -786,6 +786,30 @@ function checkObservationFollowupVoice(answer, route) {
   }];
 }
 
+const ASK_REPORT_VOICE_PATTERNS = [
+  { label: 'What I see', pattern: /\bWhat I see\b/i },
+  { label: 'What that means', pattern: /\bWhat that means\b/i },
+  { label: 'Recent pattern', pattern: /\bRecent pattern\b/i },
+  { label: 'Facts:', pattern: /^\s*Facts:/im },
+  { label: 'Interpretation:', pattern: /^\s*Interpretation(?:\s*\[[^\]]+\])?:/im },
+  { label: 'Recommendation:', pattern: /^\s*Recommendation(?:\s*\[[^\]]+\])?:/im },
+  { label: 'coach observation', pattern: /\bcoach observations?\b/i },
+  { label: 'planning check', pattern: /\bplanning check\b/i }
+];
+
+function checkAskReportVoice(answer, route) {
+  if (route === 'coach_observation_followup') return [];
+  const hits = uniqueStrings(ASK_REPORT_VOICE_PATTERNS
+    .filter(({ pattern }) => pattern.test(answer))
+    .map(({ label }) => label));
+  if (hits.length === 0) return [];
+  return [{
+    key: 'ask_report_voice',
+    severity: 'advisory',
+    reason: `Ask answer used report/artifact phrasing instead of coach voice: ${hits.join(', ')}.`
+  }];
+}
+
 function checkExpansiveCompleteness(answer, snapshot, routingMetadata, { executeTool = executeCoachReadTool } = {}) {
   const responseProfile = routingMetadata?.responseProfile ?? routingMetadata?.intent?.responseProfile;
   if (responseProfile !== 'expansive') return [];
@@ -916,6 +940,7 @@ export function verifyAskAnswer({
 
   const failures = [
     ...voiceFailures,
+    ...checkAskReportVoice(normalized, route),
     ...checkSnapshotClaims(normalized, snapshot, routingMetadata, { today, exclude }),
     ...checkToolProvenance(normalized, snapshot, routingMetadata, { today, exclude, strictMentionProvenance, executeTool }),
     ...checkSessionObservationProvenance(normalized, routingMetadata),

package/src/ask-coach.js

@@ -278,7 +278,53 @@ function inferredSinceDate(question, today = new Date()) {
   return candidate > dateOnlyString(today) ? `${year - 1}-${monthPart}-01` : candidate;
 }
 
-function routeAskQuestion(snapshot, question, { today = new Date() } = {}) {
+function deloadScheduleContextFromText(text) {
+  const raw = String(text ?? '');
+  if (!/\bd(?:e)?load\b/i.test(raw)) return null;
+  const match = raw.match(/\b(this|next|coming)\s+(?:training\s+)?week\b/i);
+  if (!match) return null;
+  return {
+    week: match[1].toLowerCase() === 'this' ? 'this' : 'next'
+  };
+}
+
+function latestDeloadScheduleContext(history = []) {
+  const messages = (Array.isArray(history) ? history : []).slice(-2);
+  for (let index = messages.length - 1; index >= 0; index -= 1) {
+    const message = messages[index];
+    if (!['user', 'assistant'].includes(message?.role) || typeof message.content !== 'string') continue;
+    const context = deloadScheduleContextFromText(message.content);
+    if (context) return context;
+  }
+  return null;
+}
+
+function isDeloadScheduleConfirmation(question) {
+  const text = String(question ?? '').trim().toLowerCase();
+  if (!text) return false;
+  if (/\b(no|don'?t|do not|cancel|undo|stop|never mind|nevermind)\b/i.test(text)) return false;
+  const wordCount = text.split(/\s+/).filter(Boolean).length;
+  if (wordCount > 8) return false;
+  return /^(yes|yeah|yep|ok|okay|sure)\b/i.test(text) ||
+    /\b(do it|schedule it|set it|make it happen|schedule that|set that)\b/i.test(text);
+}
+
+function hasProgramHistoryLanguage(question, { previousRoute = null, isFollowUp = false } = {}) {
+  const text = String(question ?? '').toLowerCase();
+  const hasProgramLanguage = /\b(program|plan|routine|split)\b/i.test(text);
+  if (/\bwhat changed\b[\s\S]{0,80}\b(program|plan|routine|split)\b/i.test(text) ||
+    /\b(program|plan|routine|split)\b[\s\S]{0,80}\bwhat changed\b/i.test(text) ||
+    /\bwhy\b[\s\S]{0,80}\b(program|plan|routine|split)\b[\s\S]{0,80}\bchang/i.test(text)) {
+    return true;
+  }
+
+  const restoreLanguage = /\b(undo that|undo it|revert that|revert it|restore that|restore it|change it back|previous version|last change)\b/i.test(text);
+  if (!restoreLanguage) return false;
+  if (hasProgramLanguage) return true;
+  return isFollowUp && ['program_history', 'program_progress', 'program_schedule_action'].includes(previousRoute);
+}
+
+function routeAskQuestion(snapshot, question, { today = new Date(), previousRoute = null, isFollowUp = false } = {}) {
   const normalizedQuestion = normalizeExerciseName(question ?? '');
   const namedExercises = namedExercisesFromQuestion(snapshot, question);
   const sessionReference = referencedSessionFromQuestion(snapshot, question);
@@ -287,6 +333,11 @@ function routeAskQuestion(snapshot, question, { today = new Date() } = {}) {
   const progressLanguage = /\b(progress|progressing|improve|improved|improvement|better|stronger|moved|moving|stalled|flat|since)\b/i.test(question ?? '');
   const profileLanguage = /\b(know about me|about me as a lifter|me as a lifter|lifter profile|training profile)\b/i.test(question ?? '');
   const programLanguage = /\b(program|plan|split|routine|full gym|ppl|upper lower)\b/i.test(question ?? '');
+  const deloadWord = 'd(?:e)?load';
+  const deloadScheduleContext = deloadScheduleContextFromText(question);
+  const deloadScheduleVerb = '(?:make|schedule|set|program|turn|change|adjust)';
+  const deloadScheduleLanguage = new RegExp(`\\b${deloadScheduleVerb}\\b[\\s\\S]{0,120}\\b(?:this|next|coming)\\s+(?:training\\s+)?week\\b[\\s\\S]{0,120}\\b${deloadWord}\\b`, 'i').test(question ?? '') ||
+    new RegExp(`\\b${deloadScheduleVerb}\\b[\\s\\S]{0,120}\\b${deloadWord}\\b[\\s\\S]{0,120}\\b(?:this|next|coming)\\s+(?:training\\s+)?week\\b`, 'i').test(question ?? '');
   const windowDays = inferredRelativeWindowDays(question);
   const reviewVerb = /\b(doing|going|look(?:s|ing|ed)?|progress\w*|train(?:s|ing)?|workouts?|fitness)\b/i.test(question ?? '');
   const explicitReview = /\b(on (?:the )?(?:right )?track|right track|making (?:good )?progress|overall progress|review (?:my|the)\b|check (?:out\s+)?my\b|how(?:'?s| is| has| have)\s+(?:my|the)\s+(?:training|progress|fitness))\b/i.test(question ?? '');
@@ -303,6 +354,13 @@ function routeAskQuestion(snapshot, question, { today = new Date() } = {}) {
     /\b(pr|prs|record|records|max|maxes|1rm|one rep max|one-rep max|strongest)\b/i.test(question ?? '') ||
     /\b(next|tomorrow|up next|coming session|do next|what should i do)\b/i.test(question ?? '');
 
+  if (deloadScheduleLanguage) {
+    return { route: 'program_schedule_action', namedExercises, deloadScheduleContext };
+  }
+  if (hasProgramHistoryLanguage(question, { previousRoute, isFollowUp })) {
+    return { route: 'program_history', namedExercises, deloadScheduleContext };
+  }
+
   // Broad "how am I doing / on the right track / last N weeks" reviews fan out to
   // sessions + volume + records + body weight rather than a single narrow route.
   // Requires an explicit review cue, or a relative window paired with a review verb.
@@ -311,16 +369,16 @@ function routeAskQuestion(snapshot, question, { today = new Date() } = {}) {
     (!narrowSingleTopic || compositeReviewCue) &&
     broadReviewIntent
   ) {
-    return { route: 'progress_review', namedExercises, since };
+    return { route: 'progress_review', namedExercises, since, deloadScheduleContext };
   }
   if (/\b(body ?weight|weigh|weight trends?|current weight|my weight)\b/i.test(question ?? '')) {
-    return { route: 'body_weight', namedExercises };
+    return { route: 'body_weight', namedExercises, deloadScheduleContext };
   }
   if (profileLanguage) {
-    return { route: 'training_profile', namedExercises, since };
+    return { route: 'training_profile', namedExercises, since, deloadScheduleContext };
   }
   if (programLanguage && progressLanguage) {
-    return { route: 'program_progress', namedExercises, since };
+    return { route: 'program_progress', namedExercises, since, deloadScheduleContext };
   }
   if (since && progressLanguage) {
     return { route: 'exercise_progress_summary', namedExercises, since };
@@ -374,6 +432,9 @@ function isTerseFollowUpQuestion(question) {
 
 function requestedActionForRoute(route, question, { isFollowUp = false, carriedPreviousTopic = false } = {}) {
   const text = String(question ?? '').toLowerCase();
+  if (route === 'program_schedule_action') return 'schedule_program_action';
+  if (route === 'program_history' && /\b(undo|revert|restore|change it back|previous version)\b/.test(text)) return 'explain_restore_status';
+  if (route === 'program_history') return 'explain_program_history';
   if (/\b(why|how come)\b/.test(text)) return 'explain_cause';
   if (/\b(build|create|make|generate|draft|rewrite|revise|update)\b/.test(text)) return 'draft_plan';
   if (/\badjust\b/.test(text) && /\b(program|plan|split|routine)\b/.test(text)) return 'draft_plan';
@@ -388,6 +449,7 @@ function requestedActionForRoute(route, question, { isFollowUp = false, carriedP
     exercise_progress: 'explain_exercise',
     volume: 'explain_volume',
     next_session: 'recommend_next_session',
+    program_history: 'explain_program_history',
     recovery: 'explain_recovery',
     score: 'explain_score',
     records: 'summarize_records',
@@ -406,6 +468,7 @@ export const ASK_RESPONSE_PROFILES = Object.freeze({
 });
 
 function responseProfileForAskIntent(route, requestedAction, question) {
+  if (route === 'program_schedule_action' || requestedAction === 'schedule_program_action') return ASK_RESPONSE_PROFILES.structured;
   if (route === 'program_design' || requestedAction === 'draft_plan') return ASK_RESPONSE_PROFILES.structured;
   const text = String(question ?? '').toLowerCase();
   if (
@@ -445,23 +508,36 @@ function ambiguityFlagsForIntent({ route, namedExercises, question, isFollowUp,
   return flags;
 }
 
-function classifyAskIntentWithPrevious(snapshot, question, { previousIntent = null, today = new Date() } = {}) {
-  const current = routeAskQuestion(snapshot, question, { today });
+function classifyAskIntentWithPrevious(snapshot, question, { previousIntent = null, previousDeloadScheduleContext = null, today = new Date() } = {}) {
   const previous = previousIntent
     ? {
         route: previousIntent.route,
         since: previousIntent.timeframe?.since ?? null,
         namedExercises: previousIntent.entities?.exercises ?? [],
         sessionLabel: previousIntent.entities?.sessionLabel ?? null,
-        sessionReference: previousIntent.entities?.sessionReference ?? null
+        sessionReference: previousIntent.entities?.sessionReference ?? null,
+        deloadScheduleContext: previousIntent.deloadScheduleContext ?? null
       }
     : null;
-  const isFollowUp = Boolean(previous && isTerseFollowUpQuestion(question));
+  const isFollowUp = Boolean((previous || previousDeloadScheduleContext) && isTerseFollowUpQuestion(question));
+  const current = routeAskQuestion(snapshot, question, {
+    today,
+    previousRoute: previous?.route ?? null,
+    isFollowUp
+  });
+  const currentDeloadScheduleContext = current.deloadScheduleContext ?? deloadScheduleContextFromText(question);
+  const carriedDeloadScheduleContext = currentDeloadScheduleContext ?? previousDeloadScheduleContext ?? previous?.deloadScheduleContext ?? null;
+  const isDeloadScheduleFollowUp = current.route !== 'program_schedule_action' &&
+    Boolean(carriedDeloadScheduleContext) &&
+    isDeloadScheduleConfirmation(question);
   let route = current.route;
   let since = current.since ?? null;
   let carriedPreviousTopic = false;
 
-  if (
+  if (isDeloadScheduleFollowUp) {
+    route = 'program_schedule_action';
+    since = null;
+  } else if (
     isFollowUp &&
     previous?.route &&
     current.namedExercises.length > 0 &&
@@ -508,6 +584,9 @@ function classifyAskIntentWithPrevious(snapshot, question, { previousIntent = nu
     responseProfile,
     isFollowUp,
     previousRoute: previous?.route ?? null,
+    deloadScheduleContext: route === 'program_schedule_action'
+      ? carriedDeloadScheduleContext
+      : currentDeloadScheduleContext,
     ambiguityFlags: ambiguityFlagsForIntent({
       route,
       namedExercises,
@@ -523,7 +602,11 @@ export function classifyAskIntent(snapshot, question, { history = [], today = ne
   for (const previousQuestion of historyUserQuestions(history)) {
     previousIntent = classifyAskIntentWithPrevious(snapshot, previousQuestion, { previousIntent, today });
   }
-  return classifyAskIntentWithPrevious(snapshot, question, { previousIntent, today });
+  return classifyAskIntentWithPrevious(snapshot, question, {
+    previousIntent,
+    previousDeloadScheduleContext: latestDeloadScheduleContext(history),
+    today
+  });
 }
 
 function pushAskContextHeader(lines, snapshot, today = new Date()) {
@@ -542,6 +625,7 @@ const ASK_FACT_KIND_BY_ROUTE = Object.freeze({
   exercise_progress: ['goal_signal', 'injury', 'constraint', 'preference', 'tone'],
   exercise_progress_summary: ['goal_signal', 'injury', 'constraint', 'preference', 'tone'],
   program_progress: ['goal_signal', 'preference', 'constraint', 'injury', 'tone'],
+  program_schedule_action: ['goal_signal', 'preference', 'constraint', 'injury', 'tone'],
   training_profile: ['goal_signal', 'preference', 'constraint', 'injury', 'tone'],
   program_design: ['goal_signal', 'preference', 'constraint', 'injury', 'tone'],
   next_session: ['constraint', 'injury', 'preference', 'goal_signal', 'tone'],
@@ -650,6 +734,8 @@ const ASK_ROUTE_REQUIRED_TOOLS = Object.freeze({
   exercise_progress: ['get_exercise_history'],
   exercise_progress_summary: ['get_exercise_progress_summary'],
   program_progress: ['get_program_progress', 'get_exercise_progress_summary', 'get_cycle_progression_summary'],
+  program_history: ['get_program_change_history'],
+  program_schedule_action: ['get_program_progress', 'get_recent_sessions', 'get_readiness_snapshot'],
   training_profile: ['get_training_profile'],
   records: ['get_records'],
   recent_session: ['get_recent_sessions'],
@@ -1123,6 +1209,83 @@ function buildNextSessionAskContext(snapshot, { exclude = new Set(), today = new
   return { context: lines.join('\n'), sections, tools: [nextSession], provenance: [coachToolProvenance('next_session_plan', nextSession)] };
 }
 
+function mondayWeekStartDateOnly(today = new Date(), weekOffset = 0) {
+  const base = new Date(`${dateOnlyString(today)}T00:00:00.000Z`);
+  const day = base.getUTCDay();
+  const daysSinceMonday = (day + 6) % 7;
+  base.setUTCDate(base.getUTCDate() - daysSinceMonday + weekOffset * 7);
+  return base.toISOString().slice(0, 10);
+}
+
+function deloadScheduleStartDate(question, today = new Date(), scheduleContext = null) {
+  if (/\bthis\s+(?:training\s+)?week\b/i.test(question ?? '')) {
+    return mondayWeekStartDateOnly(today, 0);
+  }
+  if (/\b(?:next|coming)\s+(?:training\s+)?week\b/i.test(question ?? '')) {
+    return mondayWeekStartDateOnly(today, 1);
+  }
+  return scheduleContext?.week === 'this'
+    ? mondayWeekStartDateOnly(today, 0)
+    : mondayWeekStartDateOnly(today, 1);
+}
+
+function appendProgramScheduleActionRequest(lines, { startDate, hasActiveProgram }) {
+  lines.push('');
+  lines.push('Program schedule action request:');
+  if (!hasActiveProgram) {
+    lines.push('  No active program is available. Do not append a <program_schedule_action> block.');
+    return;
+  }
+  lines.push('  The user wants to schedule a one-week whole-program deload. This is not a new program draft and not an exercise-specific plan changeset.');
+  lines.push('  If the request is clear, keep prose to 1-2 short sentences and append exactly one trailing <program_schedule_action>{JSON}</program_schedule_action>.');
+  lines.push(`  Use this exact JSON shape: {"action":"schedule_deload_week","startDate":"${startDate}","durationWeeks":1,"rationale":"..."}.`);
+  lines.push('  The app will compute the weight changes when the week starts. Do not include weights, reps, set counts, deltas, targets, or any extra JSON keys.');
+  lines.push('  Do not append a <program_draft> or <plan_changeset> block.');
+}
+
+function buildProgramScheduleActionAskContext(snapshot, question, { exclude = new Set(), today = new Date(), scheduleContext = null } = {}) {
+  const lines = [];
+  const programProgress = executeCoachReadTool(snapshot, 'get_program_progress', { since: null, today, limitExercises: 10 });
+  const recentSessions = executeCoachReadTool(snapshot, 'get_recent_sessions', { limit: 5, today });
+  const readiness = executeCoachReadTool(snapshot, 'get_readiness_snapshot', { today });
+  const program = activeProgram(snapshot);
+  const startDate = deloadScheduleStartDate(question, today, scheduleContext);
+
+  pushAskContextHeader(lines, snapshot, today);
+  lines.push('');
+  lines.push(`Program schedule target: ${program?.name ?? 'No active program'}.`);
+  const trainingLoad = programProgress.facts?.trainingLoad;
+  if (trainingLoad) {
+    const readinessBand = trainingLoad.readiness?.readinessBand ? `, readiness ${trainingLoad.readiness.readinessBand}` : '';
+    lines.push(`Training-load signal: status ${trainingLoad.status ?? 'unknown'}${readinessBand}.`);
+  }
+  if (readiness.facts?.readinessBand) {
+    lines.push(`Readiness signal: ${readiness.facts.readinessBand}.`);
+  }
+  appendActiveProgramScheduleContext(lines, snapshot);
+  if (recentSessions.rows?.length > 0) {
+    lines.push('');
+    lines.push('Recent sessions:');
+    for (const row of recentSessions.rows.slice(0, 5)) {
+      const title = row.title ?? row.dayName ?? row.programDayTitle ?? 'Workout';
+      lines.push(`  ${row.date ?? 'unknown date'} - ${title}`);
+    }
+  }
+  appendProgramScheduleActionRequest(lines, { startDate, hasActiveProgram: Boolean(program) });
+  appendExcludeNote(lines, exclude);
+  return {
+    context: lines.join('\n'),
+    sections: ['header', 'program_schedule_action', 'current_program_schedule', 'recent_sessions'],
+    programScheduleActionStartDate: startDate,
+    tools: [programProgress, recentSessions, readiness],
+    provenance: [
+      coachToolProvenance('program_schedule_program_progress', programProgress),
+      coachToolProvenance('program_schedule_recent_sessions', recentSessions),
+      coachToolProvenance('program_schedule_readiness', readiness)
+    ]
+  };
+}
+
 function buildExerciseProgressAskContext(snapshot, namedExercises, { exclude = new Set(), today = new Date() } = {}) {
   const lines = [];
   const exerciseHistoryTool = executeCoachReadTool(snapshot, 'get_exercise_history', { exercises: namedExercises, limit: 6, today });
@@ -1286,6 +1449,37 @@ function buildProgramProgressAskContext(snapshot, { exclude = new Set(), since =
   };
 }
 
+function buildProgramHistoryAskContext(snapshot, { exclude = new Set(), today = new Date() } = {}) {
+  const lines = [];
+  const history = executeCoachReadTool(snapshot, 'get_program_change_history', { limit: 20 });
+  pushAskContextHeader(lines, snapshot, today);
+  lines.push('');
+  lines.push(`Program change history: ${history.facts?.programName ?? 'No active program'}.`);
+  if (history.rows.length === 0) {
+    lines.push('  No durable program change records are available yet.');
+  } else {
+    for (const change of history.rows.slice(0, 10)) {
+      const when = change.createdAt ? String(change.createdAt).slice(0, 10) : 'unknown date';
+      const source = change.source ? `, source ${change.source}` : '';
+      const status = change.status ? `, status ${change.status}` : '';
+      lines.push(`  ${when}: ${change.summary ?? change.kind ?? 'Program changed'} (${change.kind ?? 'unknown'}${source}${status}, id ${change.id ?? 'unknown'}).`);
+      const exercises = change.affectedExercises?.length ? `exercises ${change.affectedExercises.slice(0, 4).join(', ')}` : null;
+      const fields = change.affectedFields?.length ? `fields ${change.affectedFields.slice(0, 5).join(', ')}` : null;
+      if (exercises || fields) lines.push(`    Affected: ${[exercises, fields].filter(Boolean).join('; ')}.`);
+      if (change.rationale) lines.push(`    Rationale: ${change.rationale}`);
+    }
+  }
+  lines.push('');
+  lines.push('Restore status: automatic restore is not available in this slice. You may identify the likely change to restore, but do not claim the app restored or changed the program.');
+  appendExcludeNote(lines, exclude);
+  return {
+    context: lines.join('\n'),
+    sections: ['header', 'program_change_history'],
+    tools: [history],
+    provenance: [coachToolProvenance('program_change_history', history)]
+  };
+}
+
 function buildTrainingProfileAskContext(snapshot, { exclude = new Set(), since = null, today = new Date() } = {}) {
   const lines = [];
   const trainingProfile = executeCoachReadTool(snapshot, 'get_training_profile', { since, today });
@@ -2037,10 +2231,13 @@ function confidenceBand(intentConfidence, missingDataFlags = []) {
   return 'high';
 }
 
-function recommendedActionsForAsk(route, requestedAction, programDraft) {
+function recommendedActionsForAsk(route, requestedAction, programDraft, programScheduleAction = null) {
   if (programDraft) {
     return [{ id: 'review-program-draft', label: 'Review drafted plan', kind: 'program_draft' }];
   }
+  if (programScheduleAction) {
+    return [{ id: 'review-program-schedule-action', label: 'Review scheduled deload', kind: 'program_schedule_action' }];
+  }
   if (requestedAction === 'draft_plan') {
     return [{ id: 'ask-for-plan-draft', label: 'Ask for a plan draft', kind: 'follow_up' }];
   }
@@ -2124,6 +2321,7 @@ function followUpSuggestionsForAsk(route, intent, { question = '', missingDataFl
     body_weight: bodyWeightFollowUpCandidates(missingDataFlags),
     score: ['What is pulling my score down?', 'What should I focus on this week?'],
     program_progress: ['Pull this block summary.', 'Break down a specific lift.', 'What is the next decision?'],
+    program_history: ['What changed most recently?', 'Why did that change happen?', 'Can that be restored later?'],
     program_design: ['Make this plan more conservative.', 'Explain the main changes.']
   };
   let candidates;
@@ -2178,7 +2376,7 @@ export function sanitizeAskAnswerVerificationReceipt(value) {
   return Object.keys(result).length > 0 ? result : null;
 }
 
-export function buildAskStructuredResponse(answer, routingMetadata = {}, { programDraft = null, planChangeset = null, question = '' } = {}) {
+export function buildAskStructuredResponse(answer, routingMetadata = {}, { programDraft = null, planChangeset = null, programScheduleAction = null, question = '' } = {}) {
   const contextBundle = routingMetadata.contextBundle ?? {};
   const intent = routingMetadata.intent ?? contextBundle.intent ?? {};
   const answerVerification = sanitizeAskAnswerVerificationReceipt(routingMetadata.answerVerification);
@@ -2192,12 +2390,13 @@ export function buildAskStructuredResponse(answer, routingMetadata = {}, { progr
     answer,
     confidence,
     evidenceUsed: contextBundle.evidenceUsed ?? evidenceUsedFromProvenance(routingMetadata.provenance ?? [], routingMetadata.tools ?? []),
-    recommendedActions: recommendedActionsForAsk(intent.route ?? routingMetadata.route, intent.requestedAction, programDraft),
+    recommendedActions: recommendedActionsForAsk(intent.route ?? routingMetadata.route, intent.requestedAction, programDraft, programScheduleAction),
     followUpSuggestions: followUpSuggestionsForAsk(intent.route ?? routingMetadata.route, intent, { question, missingDataFlags }),
     limitations: missingDataFlags.filter((flag) => !HIDDEN_LIMITATION_FLAGS.has(flag)).map(limitationText),
     answerVerification,
     programDraft: programDraft ?? null,
-    planChangeset: planChangeset ?? null
+    planChangeset: planChangeset ?? null,
+    programScheduleAction: programScheduleAction ?? null
   };
 }
 
@@ -2222,29 +2421,30 @@ function appendCoachObservationsContextBeforeExcludeNote(lines, observations, ex
   }
   const section = [
     '',
-    'Coach observations (derived from training data, not user-stated facts).',
-    'These are durable longer-window patterns, not automatic verdicts about the current session.',
-    'Each observation separates Facts (raw pattern in the data), Interpretation (what we infer),',
-    'and Recommendation (suggested user action). Treat Facts as load-bearing; treat Interpretation',
-    'as a hypothesis the user may contradict; Recommendation is a default, not a directive.'
+    'Longer-window training patterns (derived from training data, not user-stated facts).',
+    'Use these as background unless session evidence below says the current workout directly supports them.',
+    'Treat Evidence as load-bearing. Treat Coach read as a grounded read the user may contradict.',
+    'Treat Next move as a default coaching nudge, not a directive.'
   ];
   for (const observation of usable) {
+    const title = typeof observation.title === 'string' && observation.title.trim()
+      ? observation.title.trim()
+      : null;
     const header = [
-      `- [${observation.kind ?? 'observation'}]`,
-      observation.sourceComponent ? `component=${observation.sourceComponent}` : null,
-      observation.sourceExercise ? `exercise=${observation.sourceExercise}` : null,
+      `- pattern-id=${observation.id}`,
+      observation.kind ? `kind=${observation.kind}` : null,
+      observation.sourceComponent ? `source-component=${observation.sourceComponent}` : null,
+      observation.sourceExercise ? `source-exercise=${observation.sourceExercise}` : null,
       `confidence=${Number(observation.confidence ?? 0).toFixed(2)}`,
-      `observation-id=${observation.id}`
     ].filter(Boolean).join(' ');
     section.push(header);
-    section.push(`    Facts: ${observation.summary}`);
+    if (title) section.push(`    Pattern: ${title}`);
+    section.push(`    Evidence: ${observation.summary}`);
     if (observation.interpretationText) {
-      const tag = observation.interpretationKind ? ` [${observation.interpretationKind}]` : '';
-      section.push(`    Interpretation${tag}: ${observation.interpretationText}`);
+      section.push(`    Coach read: ${observation.interpretationText}`);
     }
     if (observation.actionText) {
-      const tag = observation.recommendationKind ? ` [${observation.recommendationKind}]` : '';
-      section.push(`    Recommendation${tag}: ${observation.actionText}`);
+      section.push(`    Next move: ${observation.actionText}`);
     }
     if (observation.outcomeStatus) {
       const observedAt = observation.outcomeObservedAt ? ` observed ${observation.outcomeObservedAt}` : '';
@@ -2387,6 +2587,14 @@ function appendAskAnswerContract(lines, {
     contract.push('  End with this goal-clarifying question when no clear goal decides the tradeoff: "What are we measuring this against - size, strength, or staying lean?"');
   }
 
+  if (route === 'program_history') {
+    contract.push('Answer contract: program change history.');
+    contract.push('  Answer only from the durable program change history evidence.');
+    contract.push('  If the user asks to undo, revert, restore, or change it back, say automatic restore is not available yet in this slice.');
+    contract.push('  Identify the likely target change by date, summary, kind, and id when the evidence supports it.');
+    contract.push('  Do not claim the program was changed, restored, reverted, or updated.');
+  }
+
   if (route === 'recent_session' && sessionObservationComparisons.length > 0) {
     contract.push('Answer contract: current session plus durable observations.');
     contract.push('  Say what improved in the current session first.');
@@ -2581,7 +2789,7 @@ function humanObservationEvidenceRows(observation) {
 
 function appendCoachPatternToRecheck(lines, observation) {
   lines.push('');
-  lines.push('Coach pattern I previously flagged; re-check it before answering:');
+  lines.push('Training pattern I previously flagged; re-check it before answering:');
   lines.push(`  Pattern: ${observation.title}`);
   lines.push(`  pattern-id=${observation.id}; kind=${observation.kind}; confidence=${observation.confidence.toFixed(2)}`);
   if (observation.windowStart || observation.windowEnd) {
@@ -2593,14 +2801,12 @@ function appendCoachPatternToRecheck(lines, observation) {
       observation.sourceExercise ? `exercise=${observation.sourceExercise}` : null
     ].filter(Boolean).join('; ')}`);
   }
-  lines.push(`  Facts: ${observation.summary}`);
+  lines.push(`  Evidence: ${observation.summary}`);
   if (observation.interpretationText) {
-    const tag = observation.interpretationKind ? ` [${observation.interpretationKind}]` : '';
-    lines.push(`  Interpretation${tag}: ${observation.interpretationText}`);
+    lines.push(`  Coach read: ${observation.interpretationText}`);
   }
   if (observation.actionText) {
-    const tag = observation.recommendationKind ? ` [${observation.recommendationKind}]` : '';
-    lines.push(`  Recommendation${tag}: ${observation.actionText}`);
+    lines.push(`  Next move: ${observation.actionText}`);
   }
   if (observation.outcomeStatus || observation.outcomeObservedAt || observation.outcomeNotes) {
     lines.push(`  Stored outcome: ${[
@@ -2845,7 +3051,7 @@ export function askObservationFollowUpContext(snapshot, question, observation, {
   pushAskContextHeader(lines, snapshot, today);
   appendCoachPatternToRecheck(lines, target);
   lines.push('');
-  lines.push('Follow-up voice rule: answer as the coach who flagged the pattern. Never use artifact phrases like "the coach observation", "this note", "the card", or "this system". Use first-person coaching language such as "I flagged...", "your data shows...", or "I would change...".');
+  lines.push('Follow-up voice rule: answer as the coach who flagged the pattern. Do not name the product artifact, card, note, system, or tooling. Use first-person coaching language such as "I flagged...", "your data shows...", or "I would change...".');
   lines.push('Outcome rule: treat the prior pattern as a hypothesis. If current evidence still supports it, say it is still active. If the evidence is improving but not clean, say it is partly true. If current evidence contradicts it or it is stale, say you would retire it now before giving advice.');
   appendSessionObservationComparisonsBeforeExcludeNote(lines, comparisonTool.rows, exclude);
   for (const tool of [scoreTool, recentTool, exerciseTool, readinessTool, bodyWeightTool].filter(Boolean)) {
@@ -2954,7 +3160,7 @@ export function askMissingObservationFollowUpContext(snapshot, _question, reques
   const lines = [];
   pushAskContextHeader(lines, snapshot, today);
   lines.push('');
-  lines.push('Requested coach observation follow-up:');
+  lines.push('Requested training-pattern follow-up:');
   lines.push(`  observation-id=${String(requestedObservation?.id ?? '').trim() || 'unknown'}; status=missing_current_server_observation`);
   lines.push('  The client requested an observation follow-up, but the observation did not match current server observations.');
   if (followUpIntent === 'successor_plan') {
@@ -3067,6 +3273,14 @@ export function askRoutedContext(snapshot, question, { exclude = new Set(), coac
     built = buildExerciseProgressSummaryAskContext(contextSnapshot, namedExerciseItems, { exclude, since, today });
   } else if (route === 'program_progress') {
     built = buildProgramProgressAskContext(contextSnapshot, { exclude, since, today });
+  } else if (route === 'program_history') {
+    built = buildProgramHistoryAskContext(contextSnapshot, { exclude, today });
+  } else if (route === 'program_schedule_action') {
+    built = buildProgramScheduleActionAskContext(contextSnapshot, question, {
+      exclude,
+      today,
+      scheduleContext: evidencePlan.intent?.deloadScheduleContext ?? null
+    });
   } else if (route === 'training_profile') {
     built = buildTrainingProfileAskContext(contextSnapshot, { exclude, since, today });
   } else if (route === 'records') {
@@ -3171,7 +3385,8 @@ export function askRoutedContext(snapshot, question, { exclude = new Set(), coac
       ...(includedFacts.length > 0 ? ['coach_facts'] : []),
       ...(includedCoachObservationIds.length > 0 ? ['coach_observations'] : []),
       ...(sessionObservationComparisons.length > 0 ? ['session_observation_comparisons'] : [])
-    ]
+    ],
+    programScheduleActionStartDate: built.programScheduleActionStartDate
   };
   const finalizedEvidencePlan = finalizeEvidencePlan(evidencePlan, tools);
   const toolMetadata = askToolMetadata(tools, provenance, { requiredTools: finalizedEvidencePlan.requiredTools });
@@ -3211,6 +3426,7 @@ export function askRoutedContext(snapshot, question, { exclude = new Set(), coac
       includedCoachObservationIds,
       coachObservationIds: includedCoachObservationIds,
       currentSessionIds,
+      ...(built.programScheduleActionStartDate ? { programScheduleActionStartDate: built.programScheduleActionStartDate } : {}),
       sessionObservationComparisons,
       evidencePlan: finalizedEvidencePlan,
       contextBundle: contextBundleForMetadata(contextBundle),

package/src/coach-prompt-assembly.js

@@ -0,0 +1,34 @@
+import { SECURITY_PREAMBLE } from './prompt-security.js';
+import {
+  ASK_COACH_INTRO,
+  ASK_CORE_RULES,
+  ASK_DEFENSIVE_RULES,
+  ASK_EXPANSIVE_RULES,
+  ASK_STRUCTURED_RULES,
+  COACH_SOUL
+} from './coach-prompt-layers.js';
+
+export function composeAskPrompt(profile = 'expansive') {
+  const profileRules = profile === 'structured'
+    ? `${ASK_DEFENSIVE_RULES}\n\n${ASK_STRUCTURED_RULES}`
+    : profile === 'defensive'
+      ? ASK_DEFENSIVE_RULES
+      : ASK_EXPANSIVE_RULES;
+  return `${SECURITY_PREAMBLE}${ASK_COACH_INTRO}
+
+${COACH_SOUL}
+
+${ASK_CORE_RULES}
+
+${profileRules}`;
+}
+
+export const ASK_PROMPT = composeAskPrompt('expansive');
+export const ASK_DEFENSIVE_PROMPT = composeAskPrompt('defensive');
+export const ASK_STRUCTURED_PROMPT = composeAskPrompt('structured');
+
+export function askPromptForResponseProfile(responseProfile) {
+  if (responseProfile === 'structured') return ASK_STRUCTURED_PROMPT;
+  if (responseProfile === 'defensive') return ASK_DEFENSIVE_PROMPT;
+  return ASK_PROMPT;
+}