Clinical Commander

All dossiers
prev.adult-immunization.core.v1

Adult immunization (preventive)

general_internal_medicinechronicadultoutpatient

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)

  • history
    Routine wellness or preventive visit — review immunization status per current ACIP adult schedule (CDC 2025-26 addendum)
    routine_preventive_visit
  • history
    Catch-up immunization for incompletely vaccinated adult — MMR, varicella, HepB, HPV (ACIP adult schedule 2025-26)
    immunization_catch_up
  • history
    Immunocompromised patient requiring modified vaccine schedule — live vaccine avoidance, additional PCV/COVID doses (ACIP 2025-26)
    immunocompromised_assessment
  • history
    Prenatal 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
  • history
    Asplenia / complement deficiency — MenACWY + MenB + PCV indicated (ACIP adult schedule)
    asplenia_meningococcal_assessment

Required inputs (13)

  • agerequired
    demographic • used at CONTEXT
    Age determines eligibility for every vaccine (PCV/RSV thresholds revised: PCV ≥50, RSV ≥75 or 50-74 high-risk per April-2025 ACIP)
  • sexrequired
    demographic • used at CONTEXT
    Pregnancy status relevant for Tdap timing, maternal RSV, live-vaccine contraindications (ACIP 2025-26)
  • pregnancy_statusrequired
    history • used at RED_FLAGS
    Tdap 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_historyrequired
    history • used at CONTEXT
    Prior vaccine records map age/risk → vaccine-due as data (ACIP 2025-26)
  • immunocompromised_statusrequired
    history • used at RED_FLAGS
    Immunocompromised → additional PCV/COVID doses, Shingrix ≥19 (not a live vaccine — Lal 25916341), AVOID live MMR/varicella/LAIV (ACIP 2025-26)
  • chronic_conditionsrequired
    history • used at RISK_STRATIFICATION
    Diabetes, CKD/dialysis (HepB double-dose), chronic liver disease, heart/lung disease, asplenia, HIV alter vaccine recommendations and risk tier (ACIP 2025-26)
  • occupation_travel
    history • used at RISK_STRATIFICATION
    Healthcare workers (HepB + anti-HBs titer, annual influenza, 2-dose MMR/varicella), travel, lab workers (meningococcal) (ACIP 2025-26)
  • allergy_historyrequired
    history • used at RED_FLAGS
    Anaphylaxis 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_reactionsrequired
    history • used at RED_FLAGS
    Anaphylaxis 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_serology
    lab • used at INITIAL_WORKUP
    HBsAg/anti-HBs/anti-HBc before vaccination; post-vaccination anti-HBs <10 mIU/mL in HCW/immunocompromised → revaccinate (ACIP 2022 35358162)
  • varicella_titer
    lab • used at INITIAL_WORKUP
    Varicella IgG confirms immunity; negative = 2-dose catch-up if NOT pregnant/immunocompromised (live vaccine)
  • mmr_titers
    lab • used at INITIAL_WORKUP
    Rubella IgG for pregnancy/reproductive-age screening; measles/mumps IgG for HCW (ACIP 2025-26)
  • cd4_count
    lab • used at BRANCHING_WORKUP
    HIV: 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)

  1. 1FRAME
    Confirm 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, sex
    advance: Patient confirmed as adult eligible for routine immunization assessment
  2. 2ENTRY
    Trigger: routine wellness, catch-up request, pregnancy, immunocompromised reassessment, asplenia, or post-exposure prophylaxis (ACIP 2025-26)
    advance: Entry trigger captured
  3. 3CONTEXT
    Collect 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_status
    advance: Vaccination history and risk factors documented
  4. 4RED_FLAGS
    Contraindication-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_status
    actions: flag:live_vaccine_contraindication_if_immunocompromised_or_pregnant, flag:anaphylaxis_history_to_specific_component_is_true_CI
    advance: Each potential barrier classified true-CI vs precaution vs none
  5. 5INITIAL_WORKUP
    Pre-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_titers
    actions: panel.hep_b_serology, panel.varicella_igg, panel.mmr_titers, workup.pre_vaccination_serology
    advance: Pre-vaccination serology obtained or deemed unnecessary
  6. 6BRANCHING_WORKUP
    Special-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_count
    actions: workup.pneumococcal_pcv20, workup.covid19_updated, workup.shingrix
    advance: Special-population vaccine set and live-vaccine eligibility resolved
  7. 7DIFFERENTIAL
    Disposition 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 now
    advance: Each candidate vaccine classified administer-now / defer / withhold
  8. 8RISK_STRATIFICATION
    Age + 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_travel
    advance: Risk tier and age-appropriate vaccine set identified
  9. 9TREATMENT
    Administer 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 CI
    actions: 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_catchup
    advance: All indicated, non-contraindicated vaccines administered or scheduled
  10. 10DISPOSITION
    Outpatient — 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
  11. 11MONITORING
    Track 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
  12. 12FOLLOWUP
    Patient 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