Adult immunization (preventive)
Depth-deepened 2026-05-16 (preventive frame): PMID audit + effect sizes + special-pop matrix + CI-vs-precaution decision-as-data + design brief authored. PMID AUDIT: 7 of 8 pre-existing pmids resolved to WRONG articles on PubMed (clinical-safety defect) and were CULLED; only 25785969 (CAPiTA) was correct. Replaced with 14 PubMed-verified PMIDs (effect-size + ACIP-statement anchors). See _briefs/prev.adult-immunization.core.v1.depth.md §1. RxCUI AUDIT: pre-existing vaccine CUIs were almost all wrong (1659929→naloxone injection; 2468231→a SARS-CoV-2 mRNA concept mislabeled PCV20; 854930→single-serotype pneumococcal antigen not PPSV23; 197572→desonide lotion; 197579/197581→dexamethasone tablets; 798356/798357/1658151/2599455/2599458/2468986→NULL in RxNav). Only RxNav-verifiable codes were corrected (Shingrix 1986830 SBD; Recombivax-HB 1658155 SBD). All other vaccine CUIs set undefined + flagged NEEDS_RXNAV_VALIDATION rather than hand-authored — most U.S. vaccine products are keyed by CVX and are not surfaced by RxNav drugs.json by ACIP/brand name. GUIDELINE CURRENCY (verified 2026-05-16): pneumococcal recommendation now ≥50 yr (Kobayashi MMWR 2025 39773952), PCV21/CAPVAXIVE added (39264843); RSV expanded April-2025 — all adults ≥75 plus 50-74 at increased risk, one-time dose only; COVID-19 2025-26 directive — shared/individual-based decision-making ≥65 and 6mo-64yr. Dossier text updated from the prior 2024 framing. DECISION-AS-DATA: contraindication-vs-precaution logic encoded in severity_triggers (contraindication_vs_precaution_decision), RED_FLAGS/DIFFERENTIAL phase purpose, and per-axis contraindication_rules (true_CI / precaution / not_a_CI / substitute prefixes). Egg allergy explicitly NOT a CI for any IIV (ACIP 2023). Live-vaccine CD4 gate (≥200 permits MMR/varicella) encoded. CROSS-DOSSIER: workups[].branches_to and sibling_differentiation wire id.influenza.core.v1 (treatment sibling), allergy.anaphylaxis.v1 (post-vaccine anaphylaxis), id.hiv-initial.chronic.v1 (CD4-gated live-vaccine logic) — all engine_ids confirmed present in src/lib/dossiers/. SCHEMA GAPS (logged in depth.md §schema-gap): no first-class vaccine-efficacy/NNT field (effect sizes carried in rationale + evidence comments); no contraindication-classification enum (encoded via string prefixes + severity_triggers); RequiredCalculator unused (no calculator applies to a preventive engine); RegimenDrug.rxcui optional so undefined+NEEDS_RXNAV_VALIDATION is schema-valid. PROMOTED 2026-05-25 (PLANNED→INTEGRATED): dedicated manifest prisma/seed/manifests/prev.adult-immunization.core.v1.ts authored (specialty_pack preventive_medicine; terminology projected 1:1; rxnorm limited to the 2 RxNav-confirmed codes 1986830/1658155); manifest field repointed; all 13 evidence PMIDs re-verified live against PubMed E-utilities (every title matched its inline claim — no fabrications, no duplicates); the 2 verified RxCUIs re-confirmed via RxNav property.json. NEXT STEPS (remaining): build age/risk vaccine-due decision atoms; integrate IIS lookup; resolve CVX→RxCUI mapping for all flagged NEEDS_RXNAV_VALIDATION vaccines.
Entry points (5)
- historyRoutine wellness or preventive visit — review immunization status per current ACIP adult schedule (CDC 2025-26 addendum)routine_preventive_visit
- historyCatch-up immunization for incompletely vaccinated adult — MMR, varicella, HepB, HPV (ACIP adult schedule 2025-26)immunization_catch_up
- historyImmunocompromised patient requiring modified vaccine schedule — live vaccine avoidance, additional PCV/COVID doses (ACIP 2025-26)immunocompromised_assessment
- historyPrenatal visit — Tdap (27-36 wk each pregnancy), influenza any trimester, RSV maternal RSVpreF (32-36 wk seasonal), AVOID live vaccines (Kampmann NEJM 2023; Amirthalingam Lancet 2014)pregnancy_immunization
- historyAsplenia / complement deficiency — MenACWY + MenB + PCV indicated (ACIP adult schedule)asplenia_meningococcal_assessment
Required inputs (13)
- agerequireddemographic • used at CONTEXTAge determines eligibility for every vaccine (PCV/RSV thresholds revised: PCV ≥50, RSV ≥75 or 50-74 high-risk per April-2025 ACIP)
- sexrequireddemographic • used at CONTEXTPregnancy status relevant for Tdap timing, maternal RSV, live-vaccine contraindications (ACIP 2025-26)
- pregnancy_statusrequiredhistory • used at RED_FLAGSTdap each pregnancy 27-36 wk (Amirthalingam 25037990 91% VE); influenza any trimester; maternal RSVpreF 32-36 wk seasonal (Kampmann 37018474); avoid LIVE vaccines (MMR/varicella/LAIV)
- immunization_historyrequiredhistory • used at CONTEXTPrior vaccine records map age/risk → vaccine-due as data (ACIP 2025-26)
- immunocompromised_statusrequiredhistory • used at RED_FLAGSImmunocompromised → additional PCV/COVID doses, Shingrix ≥19 (not a live vaccine — Lal 25916341), AVOID live MMR/varicella/LAIV (ACIP 2025-26)
- chronic_conditionsrequiredhistory • used at RISK_STRATIFICATIONDiabetes, CKD/dialysis (HepB double-dose), chronic liver disease, heart/lung disease, asplenia, HIV alter vaccine recommendations and risk tier (ACIP 2025-26)
- occupation_travelhistory • used at RISK_STRATIFICATIONHealthcare workers (HepB + anti-HBs titer, annual influenza, 2-dose MMR/varicella), travel, lab workers (meningococcal) (ACIP 2025-26)
- allergy_historyrequiredhistory • used at RED_FLAGSAnaphylaxis to a vaccine component = true CI; egg allergy NO LONGER a CI for any IIV (ACIP 2023); yeast (HepB/HPV), PEG/polysorbate (mRNA COVID-19), gelatin/neomycin (MMR/varicella)
- prior_adverse_reactionsrequiredhistory • used at RED_FLAGSAnaphylaxis to a prior dose/component = CI; GBS ≤6 wk of prior tetanus/influenza vaccine = precaution; encephalopathy ≤7 d of pertussis vaccine = CI to pertussis component
- hep_b_serologylab • used at INITIAL_WORKUPHBsAg/anti-HBs/anti-HBc before vaccination; post-vaccination anti-HBs <10 mIU/mL in HCW/immunocompromised → revaccinate (ACIP 2022 35358162)
- varicella_titerlab • used at INITIAL_WORKUPVaricella IgG confirms immunity; negative = 2-dose catch-up if NOT pregnant/immunocompromised (live vaccine)
- mmr_titerslab • used at INITIAL_WORKUPRubella IgG for pregnancy/reproductive-age screening; measles/mumps IgG for HCW (ACIP 2025-26)
- cd4_countlab • used at BRANCHING_WORKUPHIV: CD4 ≥200 cells/µL (≥15%, ≥6 mo) permits MMR/varicella; CD4 <200 = CI to MMR/varicella (live-vaccine gate) (ACIP 2025-26)
12-phase flow (12)
- 1FRAMEConfirm adult preventive immunization context: age ≥19, not acutely ill with a contraindication — scope excludes pediatric schedule and travel-only vaccines (ACIP adult schedule 2025-26)inputs: age, sexadvance: Patient confirmed as adult eligible for routine immunization assessment
- 2ENTRYTrigger: routine wellness, catch-up request, pregnancy, immunocompromised reassessment, asplenia, or post-exposure prophylaxis (ACIP 2025-26)advance: Entry trigger captured
- 3CONTEXTCollect immunization history, chronic conditions, occupation/travel, pregnancy — cross-reference with the current ACIP adult schedule to map age/risk → due/overdue vaccines AS DATA (PCV threshold now ≥50; RSV ≥75 or 50-74 high-risk)inputs: immunization_history, chronic_conditions, pregnancy_statusadvance: Vaccination history and risk factors documented
- 4RED_FLAGSContraindication-vs-precaution screen: anaphylaxis to a vaccine component = TRUE CI; severe immunocompromise/pregnancy = CI to LIVE vaccines (MMR/varicella/LAIV); encephalopathy ≤7 d of pertussis vaccine = CI to pertussis component; moderate/severe acute illness = DEFER (precaution); GBS ≤6 wk of prior tetanus/influenza = precaution; egg allergy is NOT a CI for any IIV (ACIP 2023)inputs: allergy_history, prior_adverse_reactions, immunocompromised_status, pregnancy_statusactions: flag:live_vaccine_contraindication_if_immunocompromised_or_pregnant, flag:anaphylaxis_history_to_specific_component_is_true_CIadvance: Each potential barrier classified true-CI vs precaution vs none
- 5INITIAL_WORKUPPre-vaccination serology where indicated: HBsAg/anti-HBs/anti-HBc (ACIP 2022 35358162), varicella IgG (uncertain history), rubella IgG (reproductive-age/pregnancy), measles/mumps IgG (HCW)inputs: hep_b_serology, varicella_titer, mmr_titersactions: panel.hep_b_serology, panel.varicella_igg, panel.mmr_titers, workup.pre_vaccination_serologyadvance: Pre-vaccination serology obtained or deemed unnecessary
- 6BRANCHING_WORKUPSpecial-population branching as data: immunocompromised (additional PCV/COVID doses, Shingrix ≥19, NO live vaccines), asplenia/complement deficiency (MenACWY + MenB + PCV), HIV (CD4-gated MMR/varicella), pregnancy (Tdap 27-36 wk, maternal RSVpreF 32-36 wk seasonal, IIV any trimester), renal/dialysis & chronic liver (HepB high-dose/double), HCW (anti-HBs titer + annual flu + 2-dose MMR/varicella)inputs: cd4_countactions: workup.pneumococcal_pcv20, workup.covid19_updated, workup.shingrixadvance: Special-population vaccine set and live-vaccine eligibility resolved
- 7DIFFERENTIALDisposition the CI-vs-precaution decision: TRUE contraindication (anaphylaxis to component; severe immunocompromise/pregnancy for LIVE vaccines; pertussis-component encephalopathy) → withhold that vaccine; PRECAUTION (moderate/severe acute illness; GBS ≤6 wk; mRNA myocarditis ≤3 wk) → defer/individualized; NONE (mild illness, egg allergy, breastfeeding, prior local reaction) → vaccinate nowadvance: Each candidate vaccine classified administer-now / defer / withhold
- 8RISK_STRATIFICATIONAge + risk group → vaccine set: 19-26 (HPV routine — FUTURE II 17494925), 27-45 (HPV shared decision), ≥50 (Shingrix — Lal 25916341; PCV per Jan-2025 ACIP 39773952), 50-59 high-risk + ≥75 + 50-74 high-risk (RSV — Papi 36791160), ≥65 (high-dose/adjuvanted/recombinant influenza — DiazGranados 25119609; PCV; COVID shared-decision), immunocompromised (enhanced schedule), HCW (annual flu + HepB titer)inputs: chronic_conditions, occupation_traveladvance: Risk tier and age-appropriate vaccine set identified
- 9TREATMENTAdminister indicated vaccines: influenza annual (age-appropriate formulation), COVID-19 (current formulation, shared-decision ≥65 and 6mo-64yr per 2025-26 directive), PCV single dose ≥50 or 19-49 high-risk (PCV20/PCV21 or PCV15→PPSV23 — Bonten 25785969), Shingrix 2-dose ≥50 or immunocompromised ≥19 (Lal 25916341 / Cunningham 27626517), Tdap once then Td q10yr + each pregnancy (Amirthalingam 25037990), HepB 2-dose Heplisav-B or 3-dose Engerix-B universal 19-59 (Weng 35358162), HPV 2-3 dose ≤26 + shared 27-45, RSV single dose ≥75 or 50-74 high-risk or maternal 32-36 wk (Papi 36791160 / Kampmann 37018474), MMR/varicella catch-up if non-immune and not CIactions: workup.influenza_annual, workup.covid19_updated, workup.pneumococcal_pcv20, workup.shingrix, workup.tdap_td, workup.hepb, workup.hpv, workup.rsv, workup.mmr_catchup, workup.varicella_catchupadvance: All indicated, non-contraindicated vaccines administered or scheduled
- 10DISPOSITIONOutpatient — all routine immunizations ambulatory; observe ≥15 min post-vaccination (30 min if syncope history) for anaphylaxis; document in immunization information system (ACIP 2025-26)advance: Post-vaccination observation complete, registry updated
- 11MONITORINGTrack multi-dose series completion: Shingrix dose 2 at 2-6 mo (or 1-2 mo if immunocompromised), HepB Heplisav-B dose 2 at 1 mo / Engerix-B at 1 & 6 mo, HPV dose 2-3, PCV15→PPSV23 at ≥1 yr (≥8 wk if immunocompromised); annual influenza and current COVID-19 reminders; post-vaccination anti-HBs in HCW/immunocompromised (ACIP 2022 35358162)advance: Series completion dates scheduled and recall system active
- 12FOLLOWUPPatient education: expected local/systemic reactions (Shingrix grade-3 reactogenicity expected — Lal 25916341), VAERS reporting for adverse events, return precautions (anaphylaxis, fever, neurologic symptoms), next vaccine due dates in patient portal and IIS (ACIP 2025-26)advance: Education delivered and follow-up scheduled