incremnt 0.7.0 → 0.7.2

package/src/prompt-changelog.js

@@ -0,0 +1,94 @@
+// Append-only semantic changelog for AI prompt versions.
+//
+// Every value in AI_PROMPT_VERSIONS (openrouter.js) must have a matching entry
+// here — enforced by prompt-changelog.test.js. A version string records THAT a
+// prompt changed; this records WHAT changed and WHY, so a bump is never a silent
+// edit. For `fix` and `safety` changes, reference the eval/validator that guards
+// the change (`eval`), so a regression has a named tripwire.
+//
+// Entry shape:
+//   { version, surface, date (YYYY-MM-DD), type, summary, eval? }
+//   type: 'init' | 'fix' | 'safety' | 'tuning' | 'feature'
+//
+// Add new entries at the top of the array for that surface; do not rewrite
+// existing entries.
+
+export const PROMPT_CHANGELOG_TYPES = Object.freeze([
+  'init',
+  'fix',
+  'safety',
+  'tuning',
+  'feature'
+]);
+
+export const PROMPT_CHANGELOG = Object.freeze([
+  {
+    version: 'workout_v2026_05_23_1',
+    surface: 'workout',
+    date: '2026-05-23',
+    type: 'fix',
+    summary:
+      'Keep skipped-exercise mentions generic unless plan comparison supports naming the lift; anchor the note to completed-session work.',
+    eval: 'exercise_mentions'
+  },
+  {
+    version: 'ask_v2026_05_23_1',
+    surface: 'ask',
+    date: '2026-05-23',
+    type: 'fix',
+    summary:
+      'Carry relevant typed coach facts through explicitly (including tone preferences like concise cues); never claim one note/fact is the only relevant one; name warmups when disproving an apparent within-session drop-off.',
+    eval: 'ask_claims'
+  },
+  {
+    version: 'cycle_v2026_04_18_1',
+    surface: 'cycle',
+    date: '2026-04-18',
+    type: 'init',
+    summary: 'Cycle close-out note baseline — synthesize the week, do not restate the UI.'
+  },
+  {
+    version: 'vitals_v2026_04_16_1',
+    surface: 'vitals',
+    date: '2026-04-16',
+    type: 'init',
+    summary: 'Morning vitals/readiness summary baseline — interpret signals, never give medical advice.'
+  },
+  {
+    version: 'checkpoint_v2026_04_16_1',
+    surface: 'checkpoint',
+    date: '2026-04-16',
+    type: 'init',
+    summary: 'Mid-plan checkpoint summary baseline against e1RM targets.'
+  },
+  {
+    version: 'weekly_checkin_v2026_04_23_1',
+    surface: 'weeklyCheckin',
+    date: '2026-04-23',
+    type: 'init',
+    summary: 'Sunday weekly check-in ritual baseline.'
+  },
+  {
+    version: 'coach_commitments_v2026_04_25_1',
+    surface: 'coachCommitments',
+    date: '2026-04-25',
+    type: 'init',
+    summary: 'Coach commitment extraction baseline.'
+  },
+  {
+    version: 'coach_facts_v2026_04_25_1',
+    surface: 'coachFacts',
+    date: '2026-04-25',
+    type: 'init',
+    summary: 'Typed coach-fact extraction baseline.'
+  }
+]);
+
+/** The most recent changelog entry per surface, by array order (newest first). */
+export function latestChangelogBySurface() {
+  const latest = new Map();
+  for (const entry of PROMPT_CHANGELOG) {
+    if (!latest.has(entry.surface)) latest.set(entry.surface, entry);
+  }
+  return latest;
+}