Acute nausea & vomiting (ED triage — undifferentiated adult)
Phase C shard-3-neuro-sym wave-10 expansion (2026-05-15) — pattern-matches symptom.cough.ed.v1 (this wave), symptom.weakness.ed.v1 (c1c2bc96 wave-9), symptom.chest_pain.ed_undifferentiated.v1 (be7b7d2f). Engine scope: ED triage + risk-stratification + disposition for adult acute nausea/vomiting, covering surgical abdomen (SBO/appendicitis/pancreatitis/cholecystitis/mesenteric ischemia/perforation), metabolic (DKA/HHS/adrenal crisis), neuro (migraine/raised ICP), pregnancy (hyperemesis), atypical ACS, vertigo overlay, drug-induced (chemo/opioid/cannabis), functional (CVS/CHS/dyspepsia), volume-depletion overlay. Bayesian linkage (LR+, LR−, T_treat, T_test, pre-test priors by age, Alvarado/Ranson/BISAP/HEART thresholds) lives in companion depth bundle _briefs/symptom.nausea_vomiting.ed.v1.depth.md — schema has no first-class likelihood-ratio field. 13 sibling-differentiation rows cover key look-alikes (SBO / appendicitis / pancreatitis / cholecystitis / DKA / HHS / adrenal crisis / migraine / atypical NSTEMI / STEMI / vertigo overlay / hyponatremia / diarrhea overlay). 14 severity triggers (≥10 per spec): surgical_abdomen + sbo_strangulation + appendicitis + pancreatitis + cholecystitis_cholangitis + dka + hhs + adrenal_crisis + hyperemesis_gravidarum + atypical_acs + raised_icp + mesenteric_ischemia + migraine + cannabinoid_hyperemesis. Calculators wired (3): calc.heart (atypical ACS phenotype), calc.wells_pe + calc.perc (rare PE with vomiting overlay). Alvarado / Ranson / BISAP / APACHE-II / qSOFA — schema-blocked; ticketed in shard-3 state file. Panels wired: panel.cbc + panel.renal + panel.lft + panel.cardiac + panel.inflammation. Schema-blocked: workup.nausea_vomiting / workup.gi_exam / calc.alvarado / calc.ranson / calc.bisap / calc.qsofa — NOT in clinical-tools-registry; manual application in setting playbook required_assessments + ticketed in shard-3 state file. Regimen_axes intentionally empty — engine is triage-only. Supportive drug actions (NS/LR, ondansetron, metoclopramide, prochlorperazine, pyridoxine+doxylamine for NVP, hydrocortisone for adrenal crisis, insulin for DKA/HHS, KCl repletion, PPI for UGIB, sumatriptan for migraine, aprepitant+ondansetron+dex for CINV, capsaicin + haloperidol for CHS) live in setting_playbooks.ed.drug_actions; definitive treatment is owned by downstream routed engines. Setting playbook: single `ed` per user spec — outpatient cyclic vomiting / chronic gastroparesis / IBS dyspepsia is a future engine. SCAFFOLDED status: no workup.nausea_vomiting in clinical-tools-registry; PRODUCTION audit would fail. Will promote once registry entries land.
Entry points (17)
- symptomAcute nausea + vomiting without alarm features — usually viral gastroenteritis OR functional dyspepsia (Quigley ACG 2013 PMID 29407306)acute_nausea_vomiting_isolated
- symptomVomiting + crampy abdominal pain + distension + obstipation — small bowel obstruction → route gi.small-bowel-obstruction.core.v1vomiting_with_abdominal_pain_distension
- symptomVomiting + RLQ pain + anorexia + fever + leukocytosis — appendicitis → route gi.acute-appendicitis.core.v1vomiting_with_rlq_pain_anorexia
- symptomVomiting + epigastric pain radiating to back + lipase elevation — acute pancreatitis → route gi.acute-pancreatitis.core.v1 (Tenner ACG 2013 PMID 23589549)vomiting_with_epigastric_radiating_pain
- symptomVomiting + RUQ pain + Murphy sign + fever + leukocytosis + gallbladder thickening — acute cholecystitis → route gi.acute-cholecystitis.core.v1vomiting_with_ruq_pain_murphy
- symptomVomiting + polyuria + polydipsia + ketones + glucose >250 + acidosis — DKA → route endo.dka.core.v1vomiting_with_polyuria_polydipsia_dm
- symptomVomiting + severe hyperglycemia (>600) + dehydration + altered mental status WITHOUT acidosis — HHS → route endo.hhs.core.v1vomiting_with_severe_hyperglycemia_no_ketones
- symptomVomiting + hypotension + abdominal pain + hyperkalemia + hyponatremia + hyperpigmentation OR known adrenal insufficiency / steroid withdrawal — adrenal crisis → route endo.adrenal-crisis.core.v1vomiting_with_hypotension_hyperpigmentation
- symptomVomiting + pregnancy + dehydration + ketosis + weight loss + electrolyte derangement (>5% weight loss) — hyperemesis gravidarum → ob route + thiamine + IV fluids (RCOG NVP PMID 25584725; SOM Canada 2016 PMID 28209253)vomiting_pregnancy_hyperemesis
- symptomVomiting + unilateral throbbing headache + photophobia + phonophobia + aura — migraine → route neuro.migraine.core.v1vomiting_with_headache_photophobia
- symptomVomiting (especially morning, projectile) + headache + papilledema + focal neuro deficit — raised ICP / mass / ICH → STAT NCCT + neurosurgery; route neuro stroke/ICH enginesvomiting_with_neuro_papilledema_focal
- symptomRecurrent stereotypical episodes of intense vomiting separated by symptom-free intervals — cyclic vomiting syndrome (functional GI disorder; ROME IV)cyclic_vomiting_episodic
- symptomChronic cannabis use + cyclic vomiting + abdominal pain + compulsive hot-water bathing for relief — cannabinoid hyperemesis (Habboushe 2018 PMID 25965476)cannabinoid_hyperemesis_chronic_use
- symptomVomiting + diaphoresis + dyspnea + elderly OR diabetic OR female (atypical) — atypical ACS → ECG + troponin → route cardio.nstemi.core.v1 OR cardio.stemi.core.v1vomiting_with_chest_pain_diabetic_or_elderly
- symptomVomiting + spinning vertigo + nystagmus + ataxia — peripheral vs central vertigo → route symptom.vertigo.v1; central → posterior circulation stroke workupvomiting_with_vertigo
- historyChemotherapy / opioid / radiation — drug-induced emesis; prophylactic ondansetron / aprepitant / olanzapine (ASCO antiemetic guideline)chemo_or_opioid_induced_emesis
- historyRecent food poisoning outbreak / travel — bacterial / viral / parasitic gastroenteritis → cross-link symptom.diarrhea.ed.v1food_outbreak_or_recent_travel
Required inputs (42)
- agerequireddemographic • used at CONTEXTAge shifts priors: SBO / mesenteric ischemia / atypical ACS rise with age; pregnancy + cyclic vomiting + cannabinoid hyperemesis in younger adults (Quigley 2013 PMID 29407306)
- sexrequireddemographic • used at CONTEXTFemale + childbearing age → pregnancy mandatory; female + atypical chest symptoms → atypical ACS prior raised; PONV female-predominant
- vomiting_onset_durationrequiredsymptom • used at FRAMEAcute <24-48 h vs subacute days vs chronic >1 week; episodic stereotypical → cyclic vomiting (Quigley 2013)
- vomiting_character_bilious_bloody_fecalrequiredsymptom • used at FRAMEBilious vomit → distal obstruction; bloody/coffee ground → UGIB → route gi.ugib.core.v1; feculent → distal SBO/colonic; non-bilious → proximal/gastric; projectile → ICP
- vomiting_timing_postprandial_morningrequiredsymptom • used at FRAMEPostprandial → gastric outlet obstruction / gastroparesis / pregnancy / functional; morning → pregnancy / uremia / ICP / alcohol; nocturnal/cyclic → CVS/CHS
- associated_abdominal_painrequiredsymptom • used at ENTRYVomiting + abdominal pain mandatory triage; localization narrows DDx (RUQ/cholecystitis; RLQ/appendicitis; epigastric/pancreatitis; periumbilical → migratory RLQ → appendicitis; diffuse → gastroenteritis/SBO/ischemia)
- associated_diarrhearequiredsymptom • used at ENTRYVomiting + diarrhea → gastroenteritis (route symptom.diarrhea.ed.v1 if diarrhea-predominant); vomiting WITHOUT diarrhea + distension → obstruction
- associated_feverrequiredsymptom • used at ENTRYFever + vomiting → infection (gastroenteritis, cholangitis, pyelonephritis, meningitis); afebrile → metabolic / mechanical / drug-induced / pregnancy / migraine
- associated_headache_photophobiarequiredsymptom • used at ENTRYVomiting + headache + photophobia/phonophobia → migraine; + papilledema/focal → raised ICP/ICH/SAH; + neck stiffness + fever → meningitis
- associated_chest_symptomsrequiredsymptom • used at ENTRYVomiting + chest pain/dyspnea/diaphoresis → atypical ACS workup (diabetic/elderly/female); ECG + troponin always when paired
- associated_vertigo_dizzinessrequiredsymptom • used at ENTRYVomiting + vertigo → peripheral (BPPV, vestibular neuritis, Ménière) vs central (posterior stroke, cerebellar) → HINTS exam + posterior MRI if concerning (route symptom.vertigo.v1)
- pregnancy_status_lmprequiredsymptom • used at CONTEXTALL women of childbearing age (10-55) — pregnancy test mandatory; hyperemesis vs molar/heterotopic/ectopic; route ob; first-trimester pyridoxine + doxylamine + ondansetron risk (Cleft palate risk debated)
- recent_food_or_outbreaksymptom • used at CONTEXTRecent outbreak / sick contacts / travel → Norwalk/rotavirus/Salmonella/Shigella/STEC/parasitic; cross-link symptom.diarrhea.ed.v1
- sbprequiredvital • used at CONTEXTHypotension + vomiting → volume depletion / sepsis / adrenal crisis / hemorrhage / anaphylaxis / mesenteric ischemia / massive PE
- hrrequiredvital • used at CONTEXTTachycardia + vomiting → dehydration / sepsis / ACS / anxiety / thyroid storm / hypoglycemia; relative bradycardia → typhoid, ICP
- rrrequiredvital • used at CONTEXTTachypnea + vomiting → DKA (Kussmaul) / sepsis / aspiration; bradypnea → opioid / ICP
- spo2requiredvital • used at CONTEXTHypoxia + vomiting → aspiration pneumonia / Mallory-Weiss bleed / cardiogenic / Boerhaave
- temprequiredvital • used at CONTEXTFever + vomiting → infectious DDx; hypothermia + vomiting → severe sepsis / adrenal crisis / hypothyroid
- prior_abdominal_surgery_bowel_obstructionrequiredhistory • used at CONTEXTPrior abdominal surgery → adhesive SBO #1 cause; chronic constipation + distension → fecal impaction / colonic obstruction
- diabetes_meds_insulinrequiredhistory • used at CONTEXTDM2 + missed insulin + vomiting → DKA/HHS; metformin + lactic acidosis (rare)
- chronic_steroid_or_adrenal_insufficiencyrequiredhistory • used at CONTEXTChronic steroid use abruptly stopped OR known Addison → adrenal crisis with vomiting + hypotension + hyperK + hypoNa
- chemo_radiation_within_5_daysrequiredhistory • used at CONTEXTChemo within 5 days → CINV (acute or delayed); platinum-based & anthracycline highly emetogenic; aprepitant + ondansetron + dexamethasone
- opioid_use_chronic_or_acuterequiredhistory • used at CONTEXTOpioid use → opioid-induced nausea; constipation + obstruction; consider naloxone if respiratory depression
- cannabis_chronic_daily_usehistory • used at CONTEXTChronic daily cannabis + cyclic vomiting + hot-water bathing relief → cannabinoid hyperemesis (Habboushe PMID 25965476); supportive + cessation
- migraine_historyrequiredhistory • used at CONTEXTKnown migraineur → migraine-with-emesis recurrence; IV metoclopramide / prochlorperazine / sumatriptan
- cad_diabetic_elderly_femalerequiredhistory • used at CONTEXTCAD / diabetic / elderly / female → atypical ACS prior raised; ECG + troponin if vomiting + chest/diaphoresis/dyspnea
- cirrhosis_or_portal_htnhistory • used at CONTEXTCirrhosis + vomiting + hematemesis → variceal bleed → route gi.variceal_bleed.v1; SBP / hepatic encephalopathy overlay
- cbc_with_diffrequiredlab • used at INITIAL_WORKUPLeukocytosis + left shift → infection (appendicitis, cholangitis, cholecystitis, gastroenteritis, peritonitis); anemia → bleeding (UGIB), chronic disease
- bmp_glucose_anion_gaprequiredlab • used at INITIAL_WORKUPGlucose (DKA/HHS/hypoglycemia stroke mimic), Na/K (vomiting alkalosis hypokalemia; adrenal crisis hyperK/hypoNa), BUN/Cr (volume depletion / AKI), anion gap (DKA, salicylate, toxic alcohols)
- lft_lipaserequiredlab • used at INITIAL_WORKUPAST/ALT/bili/ALP (hepatitis, cholangitis, cholecystitis, choledocholithiasis); lipase >3× ULN → acute pancreatitis (Tenner ACG 2013 PMID 23589549)
- urine_pregnancy_testrequiredlab • used at INITIAL_WORKUPMANDATORY for ALL women of childbearing age (10-55) — guides ob route + imaging choice + drug selection
- urinalysisrequiredlab • used at INITIAL_WORKUPUA — ketones (DKA / starvation / pregnancy), nitrites/leukocyte esterase (UTI/pyelonephritis), specific gravity (volume status), glucose (DKA/HHS)
- lactate_venouslab • used at INITIAL_WORKUPLactate ≥4 → severe sepsis OR mesenteric ischemia; supports SSC bundle activation
- troponin_hslab • used at INITIAL_WORKUPAtypical ACS workup if vomiting + chest/diaphoresis/dyspnea + diabetic/elderly/female
- beta_hcg_quantlab • used at INITIAL_WORKUPQuantitative beta-hCG if pregnant — ectopic vs molar vs viable; trend with TVUS
- ecg_12_leadrequiredimaging • used at INITIAL_WORKUPECG — atypical ACS phenotype; hyperK/hypoK changes; long QT pre-ondansetron; LVH
- cxr_pa_lateralimaging • used at INITIAL_WORKUPCXR — free air (perforation), aspiration, pneumonia, pneumomediastinum (Boerhaave)
- abdominal_xray_upright_supineimaging • used at INITIAL_WORKUPAcute abdominal series (upright + supine + CXR) — dilated loops, air-fluid levels, free air; first-line for SBO suspicion (low sensitivity for early SBO)
- ct_abdomen_pelvis_iv_contrastimaging • used at BRANCHING_WORKUPCT abdomen/pelvis with IV contrast — gold-standard for SBO transition point, appendicitis, pancreatitis severity, mesenteric ischemia, perforation, abscess (PMID 24698526)
- us_abdomen_ruqimaging • used at BRANCHING_WORKUPUS RUQ — gallstones, gallbladder thickening, sonographic Murphy → acute cholecystitis; first-line in pregnancy / radiation-avoidance
- tvus_pregnancyimaging • used at BRANCHING_WORKUPTransvaginal US in pregnant patient with abdominal pain + bleeding → ectopic vs viable; correlate with beta-hCG
- ncct_headimaging • used at BRANCHING_WORKUPNCCT head if vomiting + headache + neuro deficit / papilledema / projectile / new-onset — rule out ICH/SAH/mass/raised ICP
12-phase flow (12)
- 1FRAMEOnset (acute vs subacute vs chronic; episodic vs persistent), character (bilious vs feculent vs bloody vs projectile), timing (postprandial vs morning vs cyclic) — anchors DDx (Quigley 2013 PMID 29407306)inputs: vomiting_onset_duration, vomiting_character_bilious_bloody_fecal, vomiting_timing_postprandial_morningadvance: pattern characterized
- 2ENTRYAssociated abdominal pain (location), diarrhea, fever, headache/photophobia, chest symptoms, vertigo — DDx-narrowing featuresinputs: associated_abdominal_pain, associated_diarrhea, associated_fever, associated_headache_photophobia, associated_chest_symptoms, associated_vertigo_dizzinessadvance: phenotype-defining features captured
- 3CONTEXTAge, sex, pregnancy status, vitals, prior abdominal surgery, DM/insulin, chronic steroid/adrenal, chemo/opioid/cannabis use, migraine history, CAD/diabetic/elderly/female (atypical ACS), cirrhosis (PMID 23589549; PMID 25584725; PMID 28209253; PMID 25965476)inputs: age, sex, sbp, hr, rr, spo2, temp, pregnancy_status_lmp, prior_abdominal_surgery_bowel_obstruction, diabetes_meds_insulin, chronic_steroid_or_adrenal_insufficiency, chemo_radiation_within_5_days, opioid_use_chronic_or_acute, migraine_history, cad_diabetic_elderly_femaleadvance: context complete
- 4RED_FLAGSSurgical abdomen (peritonitis, perforation, ischemia, obstruction with strangulation); ICH/SAH/mass (vomiting + headache + focal neuro); atypical ACS (vomiting + chest/diaphoresis); adrenal crisis (vomiting + hypotension + steroid history); DKA/HHS (vomiting + hyperglycemia); ectopic pregnancy with rupture; UGIB (hematemesis/coffee-ground)inputs: sbp, associated_abdominal_pain, associated_headache_photophobia, associated_chest_symptoms, vomiting_character_bilious_bloody_fecaladvance: no immediate life-threat OR emergent intervention activated
- 5INITIAL_WORKUPCBC, BMP (glucose, anion gap, K, Na, BUN/Cr), LFT + lipase, urine pregnancy (mandatory women 10-55), UA (ketones, nitrites), lactate (if septic appearance), troponin (if atypical ACS), beta-hCG quant (if pregnant), ECG, CXR (if perforation/aspiration suspected), abdominal X-ray series (SBO suspicion)inputs: cbc_with_diff, bmp_glucose_anion_gap, lft_lipase, urine_pregnancy_test, urinalysis, lactate_venous, troponin_hs, ecg_12_lead, cxr_pa_lateral, abdominal_xray_upright_supineactions: panel.cbc, panel.renal, panel.lft, panel.cardiac, panel.inflammationadvance: initial workup reviewed + phenotype narrowed
- 6BRANCHING_WORKUPSBO: CT abdomen with contrast → gi.small-bowel-obstruction.core.v1. Appendicitis: CT or US (peds/pregnancy) → gi.acute-appendicitis.core.v1. Pancreatitis: lipase + CT severity → gi.acute-pancreatitis.core.v1. Cholecystitis: US RUQ → gi.acute-cholecystitis.core.v1. DKA: pH/HCO3 + ketones → endo.dka.core.v1. HHS: glucose + osm → endo.hhs.core.v1. Adrenal crisis: ACTH-stim + cortisol → endo.adrenal-crisis.core.v1. Migraine: clinical + neuroimaging only if red flags → neuro.migraine.core.v1. Raised ICP: NCCT → neuro engines. Pregnancy: TVUS + beta-hCG quant → ob. Atypical ACS: ECG + troponin → cardio.nstemi.core.v1 / cardio.stemi.core.v1. Vertigo: HINTS exam → symptom.vertigo.v1. CHS: clinical + cessationinputs: ct_abdomen_pelvis_iv_contrast, us_abdomen_ruq, tvus_pregnancy, ncct_head, beta_hcg_quantadvance: definitive pathway selected
- 7DIFFERENTIALAcute self-limited (~60-70%): viral gastroenteritis (Norwalk, rotavirus), food poisoning, food intolerance. Surgical abdomen: SBO, appendicitis, pancreatitis, cholecystitis, mesenteric ischemia, perforation. Metabolic: DKA, HHS, adrenal crisis, uremia, hyperCa. Neuro: migraine, raised ICP, ICH, SAH, vertigo (central/peripheral). Pregnancy: morning sickness, hyperemesis, molar, ectopic. Cardiac: atypical ACS (diabetic/elderly/female). Drug-induced: chemo, opioids, antibiotics. Functional: cyclic vomiting, cannabinoid hyperemesis, functional dyspepsia, gastroparesis. Vestibular. Toxic ingestion (acetaminophen, salicylate, ethanol, methanol)advance: phenotype ranked with pre-test priors
- 8RISK_STRATIFICATIONqSOFA (sepsis), SIRS, lactate clearance for volume-depleted septic; Alvarado for appendicitis (schema-blocked); Ranson/BISAP/APACHE-II for pancreatitis (schema-blocked); HEART for atypical ACS phenotype (wired calc.heart); PE Wells/PERC if vomiting + pleuritic chest (calc.wells_pe / calc.perc — though PE less common with isolated emesis)actions: calc.heart, calc.wells_pe, calc.percadvance: risk scores documented
- 9TREATMENTVolume + electrolyte resuscitation (IV NS or LR; correct K early in vomiting alkalosis). Antiemetics: ondansetron 4-8 mg IV (caution QTc), metoclopramide 10 mg IV (avoid in obstruction), prochlorperazine 5-10 mg IV, droperidol 0.625-1.25 mg IV, promethazine 12.5-25 mg IV. Pregnancy: pyridoxine + doxylamine first-line; ondansetron second (RCOG NVP PMID 25584725). DKA/HHS: insulin + K + fluids (route endo). Adrenal crisis: hydrocortisone 100 mg IV stat + fluids (route endo.adrenal-crisis.core.v1). Migraine: IV metoclopramide/prochlorperazine ± dihydroergotamine ± sumatriptan + diphenhydramine to prevent EPS. Surgical abdomen: NPO, NG decompression, fluids, antibiotics, surgical consult. CHS: hot showers, capsaicin cream, cessation. Atypical ACS: ASA + heparin + cath route (cardio.nstemi / cardio.stemi). UGIB: PPI + variceal protocol if cirrhoticinputs: sbp, bmp_glucose_anion_gap, pregnancy_status_lmpadvance: definitive intervention initiated
- 10DISPOSITIONDischarge: viral gastroenteritis tolerating PO + stable vitals + adequate hydration; resolved migraine; mild pregnancy NVP with home antiemetics. Observation: persistent vomiting with mild dehydration; cyclic vomiting episode resolving; CHS post-cessation. Ward: SBO non-operative trial, pancreatitis mild, cholecystitis pre-op, adrenal crisis stabilized, HHS, hyperemesis with electrolyte derangement. Telemetry: atypical ACS, severe DKA. ICU: shock (septic, hemorrhagic, adrenal, ACS), severe pancreatitis (organ failure), mesenteric ischemia post-op, severe HHS with AMS. OR: appendicitis, complicated cholecystitis, perforation, strangulated SBO, ectopic ruptureadvance: disposition assigned + downstream handoff complete
- 11MONITORINGVitals q1-4h, I/O, K/Na/BUN/Cr q4-6h while vomiting; glucose q1h in DKA; lipase trend in pancreatitis; ECG monitoring if ondansetron + electrolyte derangement (QTc); fetal monitoring if pregnant; serial abdominal exam in surgical phenotypeinputs: sbp, hr, bmp_glucose_anion_gapadvance: stability achieved or escalation triggered
- 12FOLLOWUPOutpatient GI for cyclic vomiting / functional / gastroparesis / IBS overlay; OB for hyperemesis; endocrine for adrenal insufficiency / chronic DM; cardiology for atypical ACS post-cath; neurology for migraine prevention; addiction support for CHS / opioids; chemotherapy team for CINV optimizationadvance: discharge bundle prescribed + follow-up scheduled