Clinical Commander

All dossiers
symptom.nausea_vomiting.ed.v1

Acute nausea & vomiting (ED triage — undifferentiated adult)

symptomacuteundifferentiatedadultacute

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)

  • symptom
    Acute nausea + vomiting without alarm features — usually viral gastroenteritis OR functional dyspepsia (Quigley ACG 2013 PMID 29407306)
    acute_nausea_vomiting_isolated
  • symptom
    Vomiting + crampy abdominal pain + distension + obstipation — small bowel obstruction → route gi.small-bowel-obstruction.core.v1
    vomiting_with_abdominal_pain_distension
  • symptom
    Vomiting + RLQ pain + anorexia + fever + leukocytosis — appendicitis → route gi.acute-appendicitis.core.v1
    vomiting_with_rlq_pain_anorexia
  • symptom
    Vomiting + 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
  • symptom
    Vomiting + RUQ pain + Murphy sign + fever + leukocytosis + gallbladder thickening — acute cholecystitis → route gi.acute-cholecystitis.core.v1
    vomiting_with_ruq_pain_murphy
  • symptom
    Vomiting + polyuria + polydipsia + ketones + glucose >250 + acidosis — DKA → route endo.dka.core.v1
    vomiting_with_polyuria_polydipsia_dm
  • symptom
    Vomiting + severe hyperglycemia (>600) + dehydration + altered mental status WITHOUT acidosis — HHS → route endo.hhs.core.v1
    vomiting_with_severe_hyperglycemia_no_ketones
  • symptom
    Vomiting + hypotension + abdominal pain + hyperkalemia + hyponatremia + hyperpigmentation OR known adrenal insufficiency / steroid withdrawal — adrenal crisis → route endo.adrenal-crisis.core.v1
    vomiting_with_hypotension_hyperpigmentation
  • symptom
    Vomiting + 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
  • symptom
    Vomiting + unilateral throbbing headache + photophobia + phonophobia + aura — migraine → route neuro.migraine.core.v1
    vomiting_with_headache_photophobia
  • symptom
    Vomiting (especially morning, projectile) + headache + papilledema + focal neuro deficit — raised ICP / mass / ICH → STAT NCCT + neurosurgery; route neuro stroke/ICH engines
    vomiting_with_neuro_papilledema_focal
  • symptom
    Recurrent stereotypical episodes of intense vomiting separated by symptom-free intervals — cyclic vomiting syndrome (functional GI disorder; ROME IV)
    cyclic_vomiting_episodic
  • symptom
    Chronic cannabis use + cyclic vomiting + abdominal pain + compulsive hot-water bathing for relief — cannabinoid hyperemesis (Habboushe 2018 PMID 25965476)
    cannabinoid_hyperemesis_chronic_use
  • symptom
    Vomiting + diaphoresis + dyspnea + elderly OR diabetic OR female (atypical) — atypical ACS → ECG + troponin → route cardio.nstemi.core.v1 OR cardio.stemi.core.v1
    vomiting_with_chest_pain_diabetic_or_elderly
  • symptom
    Vomiting + spinning vertigo + nystagmus + ataxia — peripheral vs central vertigo → route symptom.vertigo.v1; central → posterior circulation stroke workup
    vomiting_with_vertigo
  • history
    Chemotherapy / opioid / radiation — drug-induced emesis; prophylactic ondansetron / aprepitant / olanzapine (ASCO antiemetic guideline)
    chemo_or_opioid_induced_emesis
  • history
    Recent food poisoning outbreak / travel — bacterial / viral / parasitic gastroenteritis → cross-link symptom.diarrhea.ed.v1
    food_outbreak_or_recent_travel

Required inputs (42)

  • agerequired
    demographic • used at CONTEXT
    Age shifts priors: SBO / mesenteric ischemia / atypical ACS rise with age; pregnancy + cyclic vomiting + cannabinoid hyperemesis in younger adults (Quigley 2013 PMID 29407306)
  • sexrequired
    demographic • used at CONTEXT
    Female + childbearing age → pregnancy mandatory; female + atypical chest symptoms → atypical ACS prior raised; PONV female-predominant
  • vomiting_onset_durationrequired
    symptom • used at FRAME
    Acute <24-48 h vs subacute days vs chronic >1 week; episodic stereotypical → cyclic vomiting (Quigley 2013)
  • vomiting_character_bilious_bloody_fecalrequired
    symptom • used at FRAME
    Bilious 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_morningrequired
    symptom • used at FRAME
    Postprandial → gastric outlet obstruction / gastroparesis / pregnancy / functional; morning → pregnancy / uremia / ICP / alcohol; nocturnal/cyclic → CVS/CHS
  • associated_abdominal_painrequired
    symptom • used at ENTRY
    Vomiting + abdominal pain mandatory triage; localization narrows DDx (RUQ/cholecystitis; RLQ/appendicitis; epigastric/pancreatitis; periumbilical → migratory RLQ → appendicitis; diffuse → gastroenteritis/SBO/ischemia)
  • associated_diarrhearequired
    symptom • used at ENTRY
    Vomiting + diarrhea → gastroenteritis (route symptom.diarrhea.ed.v1 if diarrhea-predominant); vomiting WITHOUT diarrhea + distension → obstruction
  • associated_feverrequired
    symptom • used at ENTRY
    Fever + vomiting → infection (gastroenteritis, cholangitis, pyelonephritis, meningitis); afebrile → metabolic / mechanical / drug-induced / pregnancy / migraine
  • associated_headache_photophobiarequired
    symptom • used at ENTRY
    Vomiting + headache + photophobia/phonophobia → migraine; + papilledema/focal → raised ICP/ICH/SAH; + neck stiffness + fever → meningitis
  • associated_chest_symptomsrequired
    symptom • used at ENTRY
    Vomiting + chest pain/dyspnea/diaphoresis → atypical ACS workup (diabetic/elderly/female); ECG + troponin always when paired
  • associated_vertigo_dizzinessrequired
    symptom • used at ENTRY
    Vomiting + 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_lmprequired
    symptom • used at CONTEXT
    ALL 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_outbreak
    symptom • used at CONTEXT
    Recent outbreak / sick contacts / travel → Norwalk/rotavirus/Salmonella/Shigella/STEC/parasitic; cross-link symptom.diarrhea.ed.v1
  • sbprequired
    vital • used at CONTEXT
    Hypotension + vomiting → volume depletion / sepsis / adrenal crisis / hemorrhage / anaphylaxis / mesenteric ischemia / massive PE
  • hrrequired
    vital • used at CONTEXT
    Tachycardia + vomiting → dehydration / sepsis / ACS / anxiety / thyroid storm / hypoglycemia; relative bradycardia → typhoid, ICP
  • rrrequired
    vital • used at CONTEXT
    Tachypnea + vomiting → DKA (Kussmaul) / sepsis / aspiration; bradypnea → opioid / ICP
  • spo2required
    vital • used at CONTEXT
    Hypoxia + vomiting → aspiration pneumonia / Mallory-Weiss bleed / cardiogenic / Boerhaave
  • temprequired
    vital • used at CONTEXT
    Fever + vomiting → infectious DDx; hypothermia + vomiting → severe sepsis / adrenal crisis / hypothyroid
  • prior_abdominal_surgery_bowel_obstructionrequired
    history • used at CONTEXT
    Prior abdominal surgery → adhesive SBO #1 cause; chronic constipation + distension → fecal impaction / colonic obstruction
  • diabetes_meds_insulinrequired
    history • used at CONTEXT
    DM2 + missed insulin + vomiting → DKA/HHS; metformin + lactic acidosis (rare)
  • chronic_steroid_or_adrenal_insufficiencyrequired
    history • used at CONTEXT
    Chronic steroid use abruptly stopped OR known Addison → adrenal crisis with vomiting + hypotension + hyperK + hypoNa
  • chemo_radiation_within_5_daysrequired
    history • used at CONTEXT
    Chemo within 5 days → CINV (acute or delayed); platinum-based & anthracycline highly emetogenic; aprepitant + ondansetron + dexamethasone
  • opioid_use_chronic_or_acuterequired
    history • used at CONTEXT
    Opioid use → opioid-induced nausea; constipation + obstruction; consider naloxone if respiratory depression
  • cannabis_chronic_daily_use
    history • used at CONTEXT
    Chronic daily cannabis + cyclic vomiting + hot-water bathing relief → cannabinoid hyperemesis (Habboushe PMID 25965476); supportive + cessation
  • migraine_historyrequired
    history • used at CONTEXT
    Known migraineur → migraine-with-emesis recurrence; IV metoclopramide / prochlorperazine / sumatriptan
  • cad_diabetic_elderly_femalerequired
    history • used at CONTEXT
    CAD / diabetic / elderly / female → atypical ACS prior raised; ECG + troponin if vomiting + chest/diaphoresis/dyspnea
  • cirrhosis_or_portal_htn
    history • used at CONTEXT
    Cirrhosis + vomiting + hematemesis → variceal bleed → route gi.variceal_bleed.v1; SBP / hepatic encephalopathy overlay
  • cbc_with_diffrequired
    lab • used at INITIAL_WORKUP
    Leukocytosis + left shift → infection (appendicitis, cholangitis, cholecystitis, gastroenteritis, peritonitis); anemia → bleeding (UGIB), chronic disease
  • bmp_glucose_anion_gaprequired
    lab • used at INITIAL_WORKUP
    Glucose (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_lipaserequired
    lab • used at INITIAL_WORKUP
    AST/ALT/bili/ALP (hepatitis, cholangitis, cholecystitis, choledocholithiasis); lipase >3× ULN → acute pancreatitis (Tenner ACG 2013 PMID 23589549)
  • urine_pregnancy_testrequired
    lab • used at INITIAL_WORKUP
    MANDATORY for ALL women of childbearing age (10-55) — guides ob route + imaging choice + drug selection
  • urinalysisrequired
    lab • used at INITIAL_WORKUP
    UA — ketones (DKA / starvation / pregnancy), nitrites/leukocyte esterase (UTI/pyelonephritis), specific gravity (volume status), glucose (DKA/HHS)
  • lactate_venous
    lab • used at INITIAL_WORKUP
    Lactate ≥4 → severe sepsis OR mesenteric ischemia; supports SSC bundle activation
  • troponin_hs
    lab • used at INITIAL_WORKUP
    Atypical ACS workup if vomiting + chest/diaphoresis/dyspnea + diabetic/elderly/female
  • beta_hcg_quant
    lab • used at INITIAL_WORKUP
    Quantitative beta-hCG if pregnant — ectopic vs molar vs viable; trend with TVUS
  • ecg_12_leadrequired
    imaging • used at INITIAL_WORKUP
    ECG — atypical ACS phenotype; hyperK/hypoK changes; long QT pre-ondansetron; LVH
  • cxr_pa_lateral
    imaging • used at INITIAL_WORKUP
    CXR — free air (perforation), aspiration, pneumonia, pneumomediastinum (Boerhaave)
  • abdominal_xray_upright_supine
    imaging • used at INITIAL_WORKUP
    Acute 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_contrast
    imaging • used at BRANCHING_WORKUP
    CT abdomen/pelvis with IV contrast — gold-standard for SBO transition point, appendicitis, pancreatitis severity, mesenteric ischemia, perforation, abscess (PMID 24698526)
  • us_abdomen_ruq
    imaging • used at BRANCHING_WORKUP
    US RUQ — gallstones, gallbladder thickening, sonographic Murphy → acute cholecystitis; first-line in pregnancy / radiation-avoidance
  • tvus_pregnancy
    imaging • used at BRANCHING_WORKUP
    Transvaginal US in pregnant patient with abdominal pain + bleeding → ectopic vs viable; correlate with beta-hCG
  • ncct_head
    imaging • used at BRANCHING_WORKUP
    NCCT head if vomiting + headache + neuro deficit / papilledema / projectile / new-onset — rule out ICH/SAH/mass/raised ICP

12-phase flow (12)

  1. 1FRAME
    Onset (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_morning
    advance: pattern characterized
  2. 2ENTRY
    Associated abdominal pain (location), diarrhea, fever, headache/photophobia, chest symptoms, vertigo — DDx-narrowing features
    inputs: associated_abdominal_pain, associated_diarrhea, associated_fever, associated_headache_photophobia, associated_chest_symptoms, associated_vertigo_dizziness
    advance: phenotype-defining features captured
  3. 3CONTEXT
    Age, 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_female
    advance: context complete
  4. 4RED_FLAGS
    Surgical 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_fecal
    advance: no immediate life-threat OR emergent intervention activated
  5. 5INITIAL_WORKUP
    CBC, 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_supine
    actions: panel.cbc, panel.renal, panel.lft, panel.cardiac, panel.inflammation
    advance: initial workup reviewed + phenotype narrowed
  6. 6BRANCHING_WORKUP
    SBO: 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 + cessation
    inputs: ct_abdomen_pelvis_iv_contrast, us_abdomen_ruq, tvus_pregnancy, ncct_head, beta_hcg_quant
    advance: definitive pathway selected
  7. 7DIFFERENTIAL
    Acute 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
  8. 8RISK_STRATIFICATION
    qSOFA (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.perc
    advance: risk scores documented
  9. 9TREATMENT
    Volume + 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 cirrhotic
    inputs: sbp, bmp_glucose_anion_gap, pregnancy_status_lmp
    advance: definitive intervention initiated
  10. 10DISPOSITION
    Discharge: 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 rupture
    advance: disposition assigned + downstream handoff complete
  11. 11MONITORING
    Vitals 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 phenotype
    inputs: sbp, hr, bmp_glucose_anion_gap
    advance: stability achieved or escalation triggered
  12. 12FOLLOWUP
    Outpatient 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 optimization
    advance: discharge bundle prescribed + follow-up scheduled