Acute diarrhea (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.nausea_vomiting.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 diarrhea, covering viral / invasive bacterial / EHEC HUS / C diff / IBD flare / ischemic colitis / parasitic / microscopic colitis / drug-induced / hyperthyroid / VIPoma-carcinoid / radiation/chemo / ICI colitis / fecal impaction / immunocompromised opportunistic. Bayesian linkage (LR+, LR−, T_treat, T_test, pre-test priors by age, Truelove-Witts/BWPS/qSOFA thresholds) lives in companion depth bundle _briefs/symptom.diarrhea.ed.v1.depth.md — schema has no first-class likelihood-ratio field. 12 sibling-differentiation rows cover key look-alikes (Crohn flare / UC flare / thyroid storm / adrenal crisis overlay / nausea/vomiting overlay / hyponatremia overlay / sepsis / appendicitis with diarrhea / cirrhosis-SBP / hepatic encephalopathy / immunocompromised opportunistic / HUS-TTP). 14 severity triggers (≥10 per spec): severe_volume_depletion_shock + fulminant_c_diff + ehec_with_hus_risk + toxic_megacolon + invasive_bacterial_dysentery + severe_ibd_flare + ischemic_colitis_with_gangrene + thyroid_storm_with_diarrhea + ici_checkpoint_colitis + parasitic_traveler + microscopic_colitis_drug_induced + fecal_impaction_with_overflow + immunocompromised_opportunistic + severe_nagma_with_hypokalemia. KEY SAFETY RULES: AVOID antibiotics in EHEC O157:H7 (Tarr 2005 PMID 21228399 — promotes Shiga toxin release + HUS); AVOID loperamide in invasive/bloody/C diff/IBD; AVOID antidiarrheal in fecal impaction overflow. Calculators wired (3): calc.heart + calc.wells_pe + calc.perc (cross-symptom overlay phenotypes — rare with isolated diarrhea). Truelove-Witts / qSOFA / SOFA / BWPS — schema-blocked; ticketed in shard-3 state file. Panels wired: panel.cbc + panel.renal + panel.lft + panel.inflammation + panel.cardiac. Schema-blocked: workup.diarrhea / workup.stool_exam / calc.truelove_witts / 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, KCl, ORS, loperamide-with-exclusions, cipro/azithro for bacterial, vancomycin/fidaxomicin for C diff, methylprednisolone for IBD, infliximab for steroid-refractory/ICI, tinidazole/metronidazole/nitazoxanide for parasites, beta-blocker+PTU+steroid+iodine for thyroid storm) live in setting_playbooks.ed.drug_actions; definitive treatment is owned by downstream routed engines. Setting playbook: single `ed` per user spec — outpatient chronic diarrhea workup (IBS-D / SIBO / celiac / pancreatic insufficiency) is a future engine. SCAFFOLDED status: no workup.diarrhea in clinical-tools-registry; PRODUCTION audit would fail. Will promote once registry entries land.
Entry points (16)
- symptomAcute watery diarrhea (3+ loose stools/24 h, <14 days) WITHOUT blood — most often viral (norovirus / rotavirus); supportive only (Shane IDSA 2017 PMID 29074568)acute_watery_diarrhea_no_blood
- symptomBloody dysentery + fever + tenesmus — invasive bacterial (Salmonella / Shigella / Campylobacter / EHEC O157:H7); STOOL CULTURE + Shiga toxin (AVOID antibiotics for EHEC — HUS risk per Tarr Lancet 2005 PMID 21228399)bloody_dysentery_invasive_bacterial
- symptomDiarrhea + recent antibiotic (clindamycin, fluoroquinolone, cephalosporin) OR hospitalized — C difficile NAAT + GDH + toxin → IDSA 2021 fidaxomicin or vancomycin (Kelly ACG PMID 32198213)diarrhea_post_antibiotic_or_hospital
- symptomDiarrhea + crampy abdominal pain + blood + weight loss + extraintestinal manifestations + known IBD OR concerning presentation — Crohn / UC flare → route gi.crohns.core.v1 / gi.ulcerative-colitis.core.v1 (Truelove-Witts severity)diarrhea_ibd_flare
- symptomDiarrhea + hypotension + tachycardia + oliguria + AMS + lactate ≥4 — severe volume depletion / septic shock (route id.sepsis.core.v1 if sepsis criteria)diarrhea_with_severe_dehydration_shock
- symptomDiarrhea + recent international travel (esp. developing countries) + ≥2 weeks — Giardia / Cryptosporidium / Entamoeba / cyclospora; stool O&P + PCR; metronidazole/tinidazole/nitazoxanidediarrhea_traveler_parasitic
- symptomAcute LLQ pain + bloody diarrhea + elderly vasculopath + AFib / CAD / hypercoagulable — ischemic colitis; CT abdomen with contrast + colonoscopy if non-gangrenous (Brandt ACG)diarrhea_ischemic_colitis_elderly_vasculopath
- symptomChronic non-bloody diarrhea + PPI / NSAID / SSRI / acarbose / ranitidine — microscopic colitis; colonoscopy with biopsies (lymphocytic/collagenous); discontinue trigger drugdiarrhea_microscopic_colitis_drug_induced
- symptomChronic / postprandial diarrhea + bloating + dairy ingestion — lactose intolerance; trial elimination dietdiarrhea_lactose_intolerance_or_food_allergy
- symptomDiarrhea + weight loss + tachycardia + tremor + heat intolerance + suppressed TSH + elevated free T4 — hyperthyroidism / thyroid storm → route endo.thyroid-storm.core.v1diarrhea_hyperthyroidism
- symptomChronic watery diarrhea + flushing (carcinoid) OR hypokalemia (VIPoma) OR refractory peptic ulcers (Zollinger-Ellison) — neuroendocrine tumor workup; outpatient endocrinologydiarrhea_secretory_vipoma_carcinoid_zes
- symptomDiarrhea + recent radiation (pelvic) OR chemotherapy (5-FU, irinotecan, ICI immunotherapy) — radiation enteritis / chemotherapy-induced; loperamide + octreotide if refractory; CT enterocolitis workup; ICI checkpoint colitis → steroids + infliximabdiarrhea_radiation_or_chemo_induced
- symptomDiarrhea (paradoxical) + chronic constipation + elderly + nursing home — fecal impaction with overflow; DRE + manual disimpaction + enemas; avoid antidiarrhealsdiarrhea_fecal_impaction_overflow
- symptomDiarrhea + immunocompromised (HIV/AIDS, transplant, chemo, biologics) — CMV colitis / HIV enteropathy / MAC / cryptosporidium / microsporidium; flexible sig with biopsy + PCRdiarrhea_immunocompromised_cmv_hiv
- lab_abnormalityK <2.5 with diarrhea — VIPoma OR severe acute diarrhea; aggressive K repletion + cause workupsevere_hypokalemia_with_diarrhea
- lab_abnormalityNAGMA (HCO3 <15, normal anion gap) with diarrhea — bicarbonate loss; LR resuscitation; correct K simultaneouslysevere_metabolic_acidosis_with_diarrhea
Required inputs (37)
- agerequireddemographic • used at CONTEXTAge shifts priors: elderly → ischemic colitis / fecal impaction / drug-induced; young adult → IBD / travel parasites / IBS (Shane IDSA 2017 PMID 29074568)
- sexrequireddemographic • used at CONTEXTSex-based — IBS female predominant; microscopic colitis older female predominant; rare anatomic concerns
- diarrhea_durationrequiredsymptom • used at FRAMEAcute <14 days vs persistent 14-30 vs chronic >30 days (Shane PMID 29074568) — anchors DDx; chronic shifts toward IBD/IBS/microscopic/malabsorption/neuroendocrine
- diarrhea_frequency_volumerequiredsymptom • used at FRAMEFrequency (3+/24 h definition) + volume (low/moderate/high) + nocturnal (organic vs functional)
- diarrhea_character_bloody_mucus_steatorrhearequiredsymptom • used at FRAMEBloody → invasive bacterial / EHEC / IBD / ischemic; mucus → IBD / IBS / amoebic; steatorrhea (greasy, floating, foul) → malabsorption (pancreatic insufficiency, celiac, SIBO)
- associated_feverrequiredsymptom • used at ENTRYFever + diarrhea → infectious (especially invasive bacterial) / IBD / appendicitis-mimic; afebrile → viral / functional / drug-induced / microscopic / ischemic
- associated_abdominal_painrequiredsymptom • used at ENTRYCrampy + relieved by BM → IBS / IBD; severe + out of proportion → ischemic; LLQ + bloody → ischemic colitis; periumbilical migratory → appendicitis; RUQ → cholecystitis with diarrhea overlay
- associated_vomitingrequiredsymptom • used at ENTRYVomiting + diarrhea → gastroenteritis (route symptom.nausea_vomiting.ed.v1 if vomiting-predominant); food poisoning (S. aureus, B. cereus emetic)
- associated_tenesmus_bloodyrequiredsymptom • used at ENTRYTenesmus + bloody → invasive bacterial (Shigella, EHEC) OR IBD; rectal involvement
- associated_weight_lossrequiredsymptom • used at ENTRYWeight loss + diarrhea → IBD / malabsorption / neuroendocrine / hyperthyroidism / TB / cancer (>5% in 3 months alarm)
- associated_nocturnal_diarrhearequiredsymptom • used at ENTRYNocturnal diarrhea waking patient → organic (IBD, microscopic, infectious); against functional
- recent_antibiotic_or_hospitalrequiredhistory • used at CONTEXTRecent antibiotic (clindamycin, FQ, cephalosporin, PPI) OR hospitalization within 12 weeks → C diff (Kelly ACG PMID 32198213)
- recent_travel_food_outbreakrequiredhistory • used at CONTEXTInternational travel (developing countries) → ETEC, Salmonella, Shigella, parasites; outbreak / cruise → norovirus
- known_ibd_or_celiacrequiredhistory • used at CONTEXTKnown IBD / celiac → flare workup; medication compliance / triggers; route gi.crohns.core.v1 / gi.ulcerative-colitis.core.v1
- immunocompromised_staterequiredhistory • used at CONTEXTHIV / transplant / chemo / biologics → CMV colitis / cryptosporidium / MAC / microsporidium / atypical presentations
- medications_ppi_nsaid_ssri_metformin_chemorequiredhistory • used at CONTEXTPPI / NSAID / SSRI / metformin / acarbose / colchicine / chemo / radiation / ICI → drug-induced or microscopic colitis or ICI colitis (steroids + infliximab if severe)
- cardiac_vascular_risk_afib_cadrequiredhistory • used at CONTEXTAFib / CAD / hypercoagulable / atherosclerotic → ischemic colitis (acute LLQ + bloody)
- thyroid_disease_or_storm_triggershistory • used at CONTEXTKnown hyperthyroid / Graves / multinodular toxic → storm trigger (infection, surgery, contrast) → thyroid storm with diarrhea (route endo.thyroid-storm.core.v1)
- chronic_constipation_elderly_immobilehistory • used at CONTEXTChronic constipation + elderly + immobile + nursing home → fecal impaction with overflow (paradoxical diarrhea) — DRE + manual disimpaction
- sbprequiredvital • used at CONTEXTHypotension + diarrhea → severe volume depletion / sepsis / adrenal crisis (overlap); hypovolemic vs distributive
- hrrequiredvital • used at CONTEXTTachycardia + diarrhea → volume depletion / sepsis / thyroid storm / hyperthyroid
- rrrequiredvital • used at CONTEXTTachypnea + diarrhea → metabolic acidosis (NAGMA from HCO3 loss) / sepsis
- spo2requiredvital • used at CONTEXTHypoxia + diarrhea → severe sepsis / aspiration overlay
- temprequiredvital • used at CONTEXTFever + diarrhea → invasive bacterial / IBD / appendicitis; hypothermia → severe sepsis / adrenal crisis
- cbc_with_diffrequiredlab • used at INITIAL_WORKUPLeukocytosis + left shift → invasive bacterial / C diff; eosinophilia → parasitic; anemia → IBD / chronic blood loss / malabsorption
- bmp_anion_gap_bicarbonaterequiredlab • used at INITIAL_WORKUPNa/K/Cl/HCO3 (NAGMA from HCO3 loss), BUN/Cr (volume depletion / AKI), glucose, anion gap; severe hypokalemia → ECG monitoring
- lactate_venouslab • used at INITIAL_WORKUPLactate ≥4 → severe sepsis OR ischemic colitis / mesenteric ischemia → STAT CT angio + vascular surgery
- crp_pctlab • used at INITIAL_WORKUPCRP + PCT (panel.inflammation) — PCT supports bacterial; CRP ≥100 + albumin <30 → severe IBD flare
- lft_albuminrequiredlab • used at INITIAL_WORKUPAlbumin <30 → severe IBD flare (Truelove-Witts); LFT for hepatic / cholangitis overlay
- tsh_t4_freelab • used at INITIAL_WORKUPTSH suppressed + T4 elevated → hyperthyroidism / thyroid storm (route endo.thyroid-storm.core.v1)
- stool_studieslab • used at INITIAL_WORKUPStool culture (Salmonella, Shigella, Campylobacter, E coli incl. O157:H7 — STEC), C diff NAAT + GDH + toxin, ova & parasites + Giardia/Crypto antigen, multipathogen GI PCR panel; selective per phenotype (Shane IDSA 2017 PMID 29074568)
- stool_inflammation_markerslab • used at BRANCHING_WORKUPStool calprotectin / lactoferrin → distinguishes inflammatory (IBD) vs functional (IBS); not for ED acute use but downstream
- fecal_occult_bloodlab • used at INITIAL_WORKUPHeme-positive stool → bleeding (invasive bacterial / IBD / ischemic colitis / cancer); macroscopic blood obvious
- abdominal_xray_upright_supineimaging • used at BRANCHING_WORKUPAcute abdominal series — toxic megacolon (transverse colon >6 cm), thumbprinting (ischemic colitis), free air (perforation)
- ct_abdomen_pelvis_iv_contrastimaging • used at BRANCHING_WORKUPCT abdomen/pelvis with IV + PO contrast — IBD pattern, ischemic colitis, mesenteric ischemia, complications (abscess, perforation, megacolon)
- colonoscopy_flexible_sigimaging • used at BRANCHING_WORKUPFlex sig (ED) or colonoscopy (planned) for IBD diagnosis, ischemic colitis, microscopic colitis, CMV colitis, infectious overlap; AVOID in toxic megacolon
- ecg_12_leadimaging • used at INITIAL_WORKUPECG for hypokalemia (U waves), hyperkalemia changes (rare in diarrhea), AFib (ischemic colitis prior), QTc pre-antiemetic
12-phase flow (12)
- 1FRAMEDuration (acute <14d / persistent 14-30 / chronic >30), frequency + volume + nocturnal, character (watery / bloody / mucus / steatorrhea) — anchors DDx (Shane IDSA 2017 PMID 29074568)inputs: diarrhea_duration, diarrhea_frequency_volume, diarrhea_character_bloody_mucus_steatorrheaadvance: pattern characterized
- 2ENTRYAssociated fever, abdominal pain, vomiting, tenesmus, weight loss, nocturnal — DDx-narrowing featuresinputs: associated_fever, associated_abdominal_pain, associated_vomiting, associated_tenesmus_bloody, associated_weight_loss, associated_nocturnal_diarrheaadvance: phenotype-defining features captured
- 3CONTEXTAge, sex, vitals + temp, recent antibiotic/hospitalization (C diff), travel/food outbreak, known IBD/celiac, immunocompromised, medications (PPI/NSAID/SSRI/chemo/ICI), cardiac/vascular risk (ischemic colitis), thyroid, chronic constipation (fecal impaction) — Shane IDSA 2017 PMID 29074568; Kelly ACG PMID 32198213inputs: age, sex, sbp, hr, rr, spo2, temp, recent_antibiotic_or_hospital, recent_travel_food_outbreak, known_ibd_or_celiac, immunocompromised_state, medications_ppi_nsaid_ssri_metformin_chemo, cardiac_vascular_risk_afib_cadadvance: context complete
- 4RED_FLAGSSevere volume depletion / shock; toxic megacolon (transverse colon >6 cm + systemic toxicity); EHEC with HUS risk (AVOID antibiotics); C diff fulminant (pseudomembranous colitis, shock, megacolon); severe IBD flare (Truelove-Witts severe); ischemic colitis with gangrene; mesenteric ischemia (pain out of proportion + lactate); severe NAGMA + hypokalemia; ICI checkpoint colitis (steroids + infliximab); typhoid with intestinal perforationinputs: sbp, temp, associated_tenesmus_bloody, lactate_venousadvance: no immediate life-threat OR emergent intervention activated
- 5INITIAL_WORKUPCBC, BMP (electrolytes, anion gap, BUN/Cr, glucose), LFT + albumin, lactate (severe), CRP+PCT (selective), TSH (selective), stool studies (selective by phenotype — culture, C diff NAAT+GDH+toxin, O&P, GI PCR panel, Shiga toxin if bloody), fecal occult blood, ECG (electrolyte derangement)inputs: cbc_with_diff, bmp_anion_gap_bicarbonate, lactate_venous, crp_pct, lft_albumin, stool_studies, fecal_occult_blood, ecg_12_leadactions: panel.cbc, panel.renal, panel.lft, panel.inflammationadvance: initial workup reviewed + phenotype narrowed
- 6BRANCHING_WORKUPBacterial dysentery: stool culture + Shiga toxin → IDSA guideline (Shane PMID 29074568); AVOID antibiotics if EHEC suspected (Tarr Lancet 2005 PMID 21228399). C diff: NAAT + GDH + toxin → IDSA 2021 vancomycin/fidaxomicin (Kelly ACG PMID 32198213). IBD flare: CRP, albumin, calprotectin, CT, colonoscopy → gi.crohns.core.v1 / gi.ulcerative-colitis.core.v1. Ischemic colitis: CT with contrast + colonoscopy (non-gangrenous). Parasitic: O&P + Giardia/Crypto antigen + GI PCR panel; tinidazole/metronidazole/nitazoxanide. Microscopic: colonoscopy with biopsies. Hyperthyroid: TSH + T4 → endo.thyroid-storm.core.v1. ICI checkpoint colitis: stop ICI + steroids + infliximab. Fecal impaction: DRE + manual disimpaction. Immunocompromised: flex sig + CMV PCR + crypto/microsporidiuminputs: abdominal_xray_upright_supine, ct_abdomen_pelvis_iv_contrast, colonoscopy_flexible_sig, stool_inflammation_markersadvance: definitive pathway selected
- 7DIFFERENTIALAcute self-limited (~60-70%): viral (norovirus #1, rotavirus, enteric adeno), bacterial non-invasive (ETEC, Vibrio non-cholera, B cereus, S aureus, C perfringens). Invasive bacterial: Salmonella, Shigella, Campylobacter, EHEC O157:H7 (HUS), C difficile (post-antibiotic / hospital), Yersinia. Parasitic: Giardia, Cryptosporidium, Entamoeba, Cyclospora, Strongyloides. IBD: Crohn / UC flare. Ischemic colitis: elderly vasculopath. Microscopic colitis: drug-induced. Functional: IBS-D, IBS-mixed. Malabsorption: celiac, SIBO, pancreatic insufficiency, lactose intolerance. Hyperthyroid. Neuroendocrine: VIPoma, carcinoid, ZES, mastocytosis. Drug-induced: chemo, radiation, ICI colitis, laxative abuse, PPI/NSAID/SSRI. Fecal impaction. Immunocompromised opportunistic: CMV, MAC, cryptosporidium, microsporidiumadvance: phenotype ranked with pre-test priors
- 8RISK_STRATIFICATIONqSOFA / SIRS for septic phenotype; Truelove-Witts severity for UC flare (schema-blocked); Hinchey for diverticulitis overlap; HEART if chest symptoms overlap (rare); volume-depletion severity (clinical) drives fluid bolus + admissionadvance: risk scores documented
- 9TREATMENTVolume + electrolyte resuscitation (IV NS or LR; correct K early — diarrhea hypokalemia common). Empiric antibiotics ONLY for: severe bacterial dysentery (NOT EHEC), C diff (vancomycin 125 mg PO q6h or fidaxomicin 200 mg PO BID per IDSA 2021), traveler diarrhea (ciprofloxacin or azithromycin), severe immunocompromised. AVOID antibiotics for EHEC O157:H7 (HUS risk per Tarr 2005 PMID 21228399); AVOID loperamide in invasive/bloody diarrhea. IBD flare: IV methylprednisolone 40-60 mg/day × 5 d; rescue with infliximab or cyclosporine in steroid-refractory severe UC (route gi.ulcerative-colitis.core.v1 / gi.crohns.core.v1). Hyperthyroid / storm: beta-blocker + PTU/methimazole + hydrocortisone + iodine (route endo.thyroid-storm.core.v1). Parasitic: tinidazole 2 g PO single dose for Giardia; nitazoxanide 500 mg PO BID × 3 d for Crypto. ICI colitis: hold ICI + methylprednisolone 1-2 mg/kg + infliximab if refractory. Microscopic colitis: discontinue offending drug + budesonide. Fecal impaction: manual disimpaction + enemas (NO antidiarrheal). Loperamide: 4 mg then 2 mg per loose stool max 16 mg/d ONLY in non-invasive non-bloody diarrhea with no fever; not in C diff or IBD flareinputs: sbp, bmp_anion_gap_bicarbonateadvance: definitive intervention initiated
- 10DISPOSITIONDischarge: viral gastroenteritis tolerating PO + stable vitals + mild dehydration corrected + reliable follow-up; uncomplicated traveler diarrhea on PO antibiotics; mild C diff with PO vancomycin/fidaxomicin and follow-up. Observation: moderate dehydration responding to IV fluids; pending stool studies. Ward: severe dehydration; C diff with concerning features; ischemic colitis non-gangrenous; IBD flare moderate-severe; fecal impaction post-disimpaction; HUS workup. Telemetry: severe electrolyte derangement (K <2.5); hyperthyroid storm. ICU: shock, fulminant C diff (megacolon, hypotension, ileus), perforation, severe ischemic colitis, thyroid storm, severe ICI colitis. OR: toxic megacolon (failed medical), perforation, gangrenous ischemic colitis, severe IBD with megacolon failing rescueadvance: disposition assigned + downstream handoff complete
- 11MONITORINGVitals q1-4h, I/O, BMP q4-6h while diarrhea ongoing (K, Na, HCO3, BUN/Cr); stool frequency + character; abdominal exam q4h in severe phenotype; serial lactate in ischemic colitis / sepsis; CRP/albumin trend in IBD flare; ECG monitoring if K <3.0; renal function trend if HUS riskinputs: sbp, hr, bmp_anion_gap_bicarbonateadvance: stability achieved or escalation triggered
- 12FOLLOWUPOutpatient GI for IBD chronic management; PCP for IBS-D; endocrinology for hyperthyroid / neuroendocrine; chronic IBD on biologic/immunomodulator; C diff recurrence protocol; HUS hematology + nephrology; traveler diarrhea preventive education; fecal impaction bowel regimen; ICI immune-related AE clinic; deprescribing offending drugs (PPI/NSAID/SSRI in microscopic colitis)advance: discharge bundle prescribed + follow-up scheduled