Natural reworded openers and exam formatting on finished quizzes
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 29s

Checked against a quiz generated from four neuro and mental health
lectures:
- The opener rewording now asks for the plain, active openings a real
  exam uses and rules out inverted sentences ("Two days of vomiting have
  left a client weak", "An order is received for…"). It steps in only
  above 30% of a quiz, since the exam's most common opener was 24%.
- The finished set is tidied after review: plain stems, no closing
  period on phrase choices, and first-person choices to a "Which
  statement…" question in quotes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Elijah 2026-11-16 15:17:24 -07:00
parent 39a85ebb0c
commit f738fbe7be
5 changed files with 68 additions and 15 deletions

View file

@ -86,8 +86,8 @@ checks; answer order is shuffled whenever a quiz is taken.
Before the check, **openers are varied** (`server/ai/openers.ts`). Models tend to open nearly
every stem the same way ("A 72-year-old client…"). The first two words of each stem are compared,
with ages and numbers folded together. When one opener covers more than a quarter of a quiz of 8 or
more, a spread-out quarter is kept. The rest have only their opening reworded (`submit_stems`); the
with ages and numbers folded together. When one opener covers more than 30% of a quiz of 8 or
more, a spread-out 30% is kept (a real course exam's most common opener covered about a quarter). The rest have only their opening reworded (`submit_stems`); the
options, answer and rationale stay the same. A rewording is kept only when it holds every number
from the original, keeps "Select all that apply." and no longer opens the repeated way.
Calculations keep their wording. The writing rules, the batch prompt (which names openers already
@ -98,8 +98,10 @@ Templates as "NCLEX style"). Stems are short and plain, usually 15 to 30 words:
needed, then one direct question in the exam's own phrasing ("Which action should the nurse take
first?", "Which statement by the parent indicates a need for further teaching?"), in one
paragraph with no scene-setting that does not change the answer. About a third may ask directly
about a fact the nurse uses (an injection site, a pain tool, expected lab results). Bold or
underlined words are removed from generated stems (`plainStem`). Choices are concise and
about a fact the nurse uses (an injection site, a pain tool, expected lab results). The finished
set is tidied to match the exam's formatting: bold or underlined words are removed from stems
(`plainStem`), a phrase choice loses its closing period (`plainChoice`), and first-person choices
to a "Which statement…" question are put in quotes (`quoteStatement`). Choices are concise and
parallel: a term or value when that is what is asked, a 4 to 12 word action or finding, or quoted
speech for client statements and nurse responses. Explanations go in each choice's "why" (1 or
2 sentences), not on the end of the choice. Distractors come from related facts in the material.