Varied question openers, readable rationales, plain practice score
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 30s

- Stems no longer all open the same way: the writing rules, batch prompt and
  planner ask for varied openings (age openings stay part of the mix), and when
  one opener covers more than a quarter of a quiz the excess stems have only
  their opening reworded, keeping every number, before the check.
- Rationales are asked for as Markdown (a bold key point, then short bullets);
  older one-paragraph rationales are laid out the same way on display.
- The practice score in the quiz header is a plain "x/y correct", with no
  percentage or colour.
- Fix a flaky assertion: the mock's answer-key fix is a no-op when the shuffle
  already put the answer in place.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Elijah 2026-11-16 12:05:46 -07:00
parent 10be5c39da
commit 517278be71
15 changed files with 382 additions and 24 deletions

74
shared/rationale.ts Normal file
View file

@ -0,0 +1,74 @@
/**
* Rationale layout. New rationales are written as Markdown (a bold key point, then short
* bullets); older ones are often one long paragraph. `formatRationale` breaks such a paragraph
* into readable pieces for display: the first sentence on its own, then short paragraphs, and
* a list when it walks through the choices ("Option A…", "Choice 2…"). Text that already has
* structure (line breaks, lists, headings) is returned unchanged.
*/
/** Words that end with a period without ending the sentence. */
const ABBREVIATIONS = /(?:^|\s|\()(?:e\.g|i\.e|vs|etc|approx|dr|mr|mrs|ms|st|no|fig|min|max|hr|hrs|mg|mcg|kg|ml|mL|dL|mEq|U|gtt|q|b\.i\.d|t\.i\.d|q\.i\.d|p\.r\.n|a\.m|p\.m)\.$/i;
/** Splits plain prose into sentences, keeping decimals ("2.5 mg") and abbreviations together. */
export function splitSentences(text: string): string[] {
const out: string[] = [];
let start = 0;
const re = /([.!?])(["'”’)*_]*)\s+(?=["“'(*_]*[A-Z0-9])/g;
let m: RegExpExecArray | null;
while ((m = re.exec(text))) {
const end = m.index + m[1].length + m[2].length;
const piece = text.slice(start, end);
if (m[1] === '.' && ABBREVIATIONS.test(text.slice(start, m.index + 1))) continue;
if (piece.trim()) out.push(piece.trim());
start = re.lastIndex;
}
const rest = text.slice(start).trim();
if (rest) out.push(rest);
return out;
}
const CHOICE_START = /^(?:\*\*)?(?:option|choice|answer|distractor)\s*(?:[A-F]|[1-6])\b/i;
const FOLLOW_ON = /^(?:it|this|that|these|those|they|however|instead|also|because|but)\b/i;
export function formatRationale(text: string): string {
const value = text.trim();
// Already laid out, or short enough to read at a glance.
if (value.length < 260 || /\n/.test(value)) return value;
const sentences = splitSentences(value);
if (sentences.length < 3) return value;
const [lead, ...rest] = sentences;
// The key point leads in bold, as new rationales do (unless it already has emphasis).
const blocks: string[] = [/[*_]/.test(lead!) ? lead! : `**${lead}**`];
let paragraph: string[] = [];
const flush = () => {
if (paragraph.length) blocks.push(paragraph.join(' '));
paragraph = [];
};
let bullets: string[] = [];
const flushBullets = () => {
if (bullets.length) blocks.push(bullets.map((b) => `- ${b}`).join('\n'));
bullets = [];
};
// Walk-throughs of the choices become a list when there are at least two of them.
const choiceCount = rest.filter((s) => CHOICE_START.test(s)).length;
for (const sentence of rest) {
if (choiceCount >= 2 && CHOICE_START.test(sentence)) {
flush();
bullets.push(sentence);
continue;
}
if (bullets.length) {
// A follow-on sentence about the same choice ("It…", "This…") stays in its bullet.
if (FOLLOW_ON.test(sentence) && sentence.length < 160) {
bullets[bullets.length - 1] += ` ${sentence}`;
continue;
}
flushBullets();
}
paragraph.push(sentence);
if (paragraph.length >= 2 || paragraph.join(' ').length > 220) flush();
}
flush();
flushBullets();
return blocks.join('\n\n');
}