Jaundice (adult)
Phase C shard-3-neuro-sym deepening pass (2026-05-14) — full §5.5 contract depth. Pattern peers: symptom.vertigo.v1 (Phase C deepened) + symptom.chest_pain.ed_undifferentiated.v1. Engine scope: adult jaundice triage + workup + risk stratification + disposition across home / ED / ICU / inpatient / outpatient. R-factor (ALT/ULN ÷ ALP/ULN) is the primary classification axis: >5 hepatocellular, <2 cholestatic, 2-5 mixed. Bilirubin fractionation (direct vs indirect) is the first branch. Bayesian linkage, R-factor classification tree, King's College ALF criteria (APAP vs non-APAP), Tokyo 2018 cholangitis grading I/II/III, Hy's Law DILI threshold, Bhutani neonatal nomogram, cross-engine routing live in companion depth bundle _briefs/symptom.jaundice.v1.depth.md — schema has no first-class likelihood-ratio field. 5 setting playbooks (home, ed, icu, inpatient, outpatient). 12 severity triggers (≥6 per spec): unconjugated_hyperbili + conjugated_hepatocellular + conjugated_cholestatic + alf_kings_college + cholangitis_tokyo + pregnancy_phenotype + neonatal_phenotype + dili_hys_law + sepsis_cholestasis + cirrhosis_decompensated + severe_alcoholic_hepatitis + painless_jaundice_malignancy. 3 sibling differentiation rows (gi.cirrhosis.core.v1 + gi.hepatic-encephalopathy.core.v1 + tox.acetaminophen-overdose.core.v1) — all verified to exist in ALL_DOSSIERS registry. Schema-blocked items surfaced: MELD-Na (✓ in registry), MELD 3.0 (✓), Child-Pugh, King's College ALF score, Maddrey, GAHS, R-factor, Bhutani, Tokyo cholangitis grading codifier — most NOT in clinical-tools-registry.ts; tickets surfaced in depth bundle for shard-0. Modern view captured: NAC for APAP within window + non-APAP ALF (ALFSG); Tokyo TG18 grading drives ERCP timing; Hy's Law defines severe DILI; Bhutani nomogram for neonatal phototherapy; HELLP/AFLP/ICP distinct pregnancy phenotypes; King's College criteria for transplant listing. PMIDs (10): AASLD ALF (Lee 2011) 22213561 + King's College O'Grady 1989 2490426 + Tokyo TG18 29032610 + APAP NAC Smilkstein 1988 3059186 + Hy's Law Reuben 2010 20949552 + AASLD HCC Marrero 2018 29624699 + MELD-Na Kim 2008 18768945 + STOPAH 2015 25901427 + EASL PBC 2017 28427765 + AASLD HBV 2018 29405329. All NEEDS_SOURCE_REVIEW per shard convention.
Entry points (7)
- symptomYellow eyes / skin (scleral icterus or jaundice) (ACG 2021)yellow_eyes_or_skin
- symptomDark urine + pale stool — cholestasis (BSG 2017)dark_urine_pale_stool
- lab_abnormalityElevated total bilirubin on LFTs (ACG 2021)elevated_bilirubin
- symptomRapid-onset jaundice + altered mental status — concern for ALF (AASLD 2023 / Lee 2011 PMID 22213561)rapid_jaundice_with_encephalopathy
- symptomJaundice + fever + RUQ pain (Charcot triad) — concern for acute cholangitis (Tokyo TG18 Kiriyama 2018 PMID 29032610)jaundice_with_fever_and_ruq_pain
- symptomPainless jaundice + weight loss in older adult — pancreatic / biliary malignancy concern (NICE 2024)painless_jaundice_in_older_adult
- lab_abnormalityALT >3x ULN + T-bili >2x ULN without obstruction — Hy's Law DILI concern (Reuben 2010 PMID 20949552)hys_law_pattern
Required inputs (31)
- agerequireddemographic • used at CONTEXTOlder adult + painless jaundice = pancreatic/biliary Ca; younger = viral / Wilson / Gilbert / autoimmune (ACG 2021)
- sexrequireddemographic • used at CONTEXTPBC strongly female-skewed; PSC male-skewed (EASL 2017 PBC); MELD 3.0 sex-adjusted (Kim 2021)
- pregnancy_statusrequireddemographic • used at FRAMEPregnancy-specific phenotypes — HELLP / AFLP / ICP have distinct management vs general adult workup (ACOG 2024)
- symptom_onset_temporequiredhistory • used at FRAMEAcute (<2 wk — viral / DILI / APAP / cholangitis) vs subacute vs chronic (cirrhosis / PBC / PSC / malignancy) narrows differential (BSG 2017)
- alcohol_userequiredhistory • used at CONTEXTAlcoholic hepatitis / cirrhosis — chronic use ≥40 g/day or binge episodes (AASLD 2023; STOPAH 2015 PMID 25901427)
- current_medsrequiredmedication • used at CONTEXTDILI: APAP, isoniazid, nitrofurantoin, augmentin, statins, anabolic steroids, methotrexate, valproate, herbals (kava, green tea, chaparral) — LiverTox NIH (Reuben 2010 PMID 20949552)
- apap_ingestion_quantity_timingrequiredhistory • used at RED_FLAGSAPAP toxic dose >150 mg/kg single ingestion or >4 g/24 h in alcoholic / malnourished; Rumack-Matthew nomogram timing dependent on 4-h post-ingestion level (Smilkstein NEJM 1988 PMID 3059186)
- travel_or_sexual_or_iv_drug_userequiredhistory • used at CONTEXTHAV / HBV / HCV / HEV exposure (AASLD 2023; AASLD HBV 2018 PMID 29405329)
- pruritus_pain_patternrequiredhistory • used at FRAMEPainless = malignancy / PSC; pruritus = cholestasis (PBC, PSC, obstruction, ICP); RUQ pain = stones / cholangitis (Charcot triad) (BSG 2017)
- family_history_liver_diseasehistory • used at CONTEXTWilson / hemochromatosis / α1AT / autoimmune (AASLD 2023)
- pregnancy_weeks_gestationhistory • used at CONTEXTICP usually 3rd trimester; AFLP late 3rd; HELLP 2nd-3rd; pre-eclampsia (ACOG 2024)
- cbcrequiredlab • used at INITIAL_WORKUPHemolysis (anemia + retic + low haptoglobin), thrombocytopenia (cirrhosis or HELLP) (ACG 2021)
- lftrequiredlab • used at INITIAL_WORKUPAST/ALT/ALP/total + direct bilirubin (fractionation) /GGT — R-factor (ALT/ULN ÷ ALP/ULN); >5 hepatocellular, <2 cholestatic, 2-5 mixed (ACG 2021)
- inrrequiredlab • used at INITIAL_WORKUPSynthetic function — ALF if INR ≥1.5 + encephalopathy (no prior cirrhosis); King's College criterion (O'Grady 1989 PMID 2490426)
- albuminrequiredlab • used at INITIAL_WORKUPSynthetic function (chronic) — Child-Pugh component (AASLD 2023)
- lipaserequiredlab • used at INITIAL_WORKUPPancreatitis as obstruction cause; gallstone pancreatitis (ACG 2021)
- ammonialab • used at RED_FLAGSAdjunct to clinical encephalopathy assessment in ALF / cirrhosis (not specific) (AASLD 2023)
- lactatelab • used at RED_FLAGSTissue hypoperfusion in cholangitis / sepsis / ALF; metabolic acidosis (AASLD 2023; Tokyo TG18 PMID 29032610)
- apap_levellab • used at RED_FLAGSAcetaminophen level — interpret on Rumack-Matthew nomogram if known time of ingestion (Smilkstein 1988 PMID 3059186)
- haptoglobin_retic_ldh_coombslab • used at BRANCHING_WORKUPHemolysis pattern (low haptoglobin + high retic + high LDH + indirect bilirubin + direct Coombs); smear for schistocytes (MAHA, HELLP) (BSG 2017)
- viral_hepatitis_panelrequiredlab • used at INITIAL_WORKUPHAV IgM, HBsAg + anti-HBc IgM + HBV DNA, anti-HCV + HCV RNA, HEV IgM (immunocompromised / pregnant / travel) (AASLD 2023; AASLD HBV 2018)
- autoimmune_panellab • used at BRANCHING_WORKUPAMA for PBC; ANA + ASMA + anti-LKM-1 + IgG for AIH; pANCA for PSC (AASLD 2023; EASL 2017 PBC PMID 28427765)
- ceruloplasminlab • used at BRANCHING_WORKUPWilson if age <40 or family history; serum ceruloplasmin <20 mg/dL + 24-h urine copper >40 µg + slit-lamp K-F rings (AASLD 2023)
- alpha1_antitrypsinlab • used at BRANCHING_WORKUPα1AT deficiency phenotype (PiZZ) — quantitative + phenotyping (AASLD 2023)
- iron_studieslab • used at BRANCHING_WORKUPHemochromatosis — ferritin + transferrin saturation, HFE gene (AASLD 2023)
- bile_acids_pregnancylab • used at BRANCHING_WORKUPTotal bile acids >10 µmol/L in pregnancy = ICP; >40 = severe (ACOG 2024)
- ruq_ultrasoundrequiredimaging • used at INITIAL_WORKUPStones, ductal dilation, mass, cirrhosis morphology, ascites, portal vein flow — first-line (ACG 2021; BSG 2017)
- mrcp_or_eusimaging • used at BRANCHING_WORKUPDetail biliary tree if obstruction suspected on US but cause unclear; EUS for distal CBD / pancreatic head (BSG 2017)
- ercpimaging • used at BRANCHING_WORKUPTherapeutic biliary decompression — emergent for grade III cholangitis or impacted stone (Tokyo TG18 PMID 29032610)
- ct_abdomen_pancreatic_protocolimaging • used at BRANCHING_WORKUPPancreatic mass / cholangiocarcinoma / staging (NICE 2024)
- fibroscan_or_biopsyimaging • used at BRANCHING_WORKUPStage fibrosis non-invasively (FibroScan); biopsy for unclear hepatocellular (AIH overlap, drug vs autoimmune) (AASLD 2023)
12-phase flow (12)
- 1FRAMEConfirm jaundice (scleral icterus, T-bili >2.5 mg/dL); rule out carotenoderma (palms/soles only, no scleral involvement); fractionate bilirubin (direct vs indirect); compute R-factor (ALT/ULN)/(ALP/ULN) — >5 hepatocellular, <2 cholestatic, 2-5 mixed; identify pregnancy phenotype if applicable (ACG 2021; ACOG 2024)inputs: symptom_onset_tempo, pruritus_pain_pattern, pregnancy_statusadvance: Pattern + R-factor + bilirubin fractionation classified
- 2ENTRYYellow eyes / skin, dark urine, pale stool, elevated bilirubin, Charcot triad (jaundice + fever + RUQ pain), painless jaundice + weight loss in older adult (ACG 2021; Tokyo TG18 PMID 29032610)inputs: ageadvance: Entry pattern recognized
- 3CONTEXTAlcohol, drugs (APAP quantity/timing, isoniazid, augmentin, statins, herbals — LiverTox), travel, IV drug use, sexual, transfusion, occupational, family history, pregnancy weeks of gestation (AASLD 2023)inputs: alcohol_use, current_meds, travel_or_sexual_or_iv_drug_use, sex, pregnancy_weeks_gestationadvance: Context complete
- 4RED_FLAGSAcute liver failure (INR ≥1.5 + encephalopathy + no prior cirrhosis — King's College O'Grady 1989 PMID 2490426), acute cholangitis (Charcot triad + grade I-III Tokyo TG18 PMID 29032610), APAP toxicity (Rumack-Matthew nomogram — Smilkstein 1988 PMID 3059186), Hy's Law DILI (ALT >3x + T-bili >2x without obstruction — Reuben 2010 PMID 20949552), HELLP / AFLP in pregnancy (ACOG 2024)inputs: inr, apap_ingestion_quantity_timing, apap_level, ammonia, lactateactions: workup.acute_liver_failure, workup.acute_cholangitis, workup.apap_overdoseadvance: ALF / cholangitis / APAP / DILI / pregnancy phenotype identified or excluded
- 5INITIAL_WORKUPCBC, LFT (fractionated bilirubin + R-factor), INR, albumin, lipase, viral hep panel A/B/C/E, RUQ US (ACG 2021; BSG 2017; AASLD 2023)inputs: cbc, lft, inr, albumin, lipase, viral_hepatitis_panel, ruq_ultrasoundactions: panel.cbc, panel.lft, panel.coag, panel.pancreas, workup.abnormal_lftadvance: Stage-1 returned
- 6BRANCHING_WORKUPBy pattern. Hepatocellular (R >5): autoimmune panel + iron + ceruloplasmin (<40) + α1AT + HEV + biopsy if unclear. Cholestatic (R <2): MRCP / EUS first-line; ERCP if intervention planned (Tokyo TG18 PMID 29032610); AMA for PBC (EASL 2017 PMID 28427765); pANCA for PSC. Unconjugated: haptoglobin + retic + LDH + smear + Coombs for hemolysis. Pregnancy: bile acids + PT/PTT + fibrinogen + glucose for AFLP. Neonatal: Bhutani nomogram + Coombs + G6PD (route to peds engine if exists) (AASLD 2023; ACOG 2024)inputs: haptoglobin_retic_ldh_coombs, autoimmune_panel, ceruloplasmin, alpha1_antitrypsin, iron_studies, mrcp_or_eus, ct_abdomen_pancreatic_protocol, bile_acids_pregnancy, fibroscan_or_biopsyactions: workup.hcv_initial, workup.hemolysis, workup.acute_cholangitisadvance: Branch workup completed
- 7DIFFERENTIALBy bilirubin fractionation + R-factor. UNCONJUGATED: Gilbert, hemolysis (immune AIHA, MAHA, mechanical, G6PD), ineffective erythropoiesis, drug-induced (rifampin, probenecid), Crigler-Najjar, resorbing hematoma. CONJUGATED HEPATOCELLULAR (R>5): viral A/B/C/D/E, autoimmune, ischemic (shock liver), drug-induced (APAP, INH, augmentin), Wilson, hemochromatosis, α1AT, severe NAFLD/MASH. CONJUGATED CHOLESTATIC (R<2): choledocholithiasis, cholangitis, pancreatic Ca, cholangiocarcinoma, PSC, PBC, DILI cholestatic, sepsis-related, biliary stricture, parasitic. PREGNANCY: ICP, HELLP, AFLP, pre-eclampsia. NEONATAL: physiologic, breast-milk, Crigler, hemolysis, biliary atresia (AASLD 2023; ACOG 2024)advance: Differential narrowed by R-factor + fractionation
- 8RISK_STRATIFICATIONMELD-Na (Kim NEJM 2008 PMID 18768945), MELD 3.0, Child-Pugh, King's College for ALF (O'Grady 1989 — APAP arm: pH <7.30 OR all of [INR >6.5 + creat >3.4 + grade 3-4 HE]; non-APAP arm: INR >6.5 OR any 3 of 5 [age <10 or >40, non-A-non-B/halothane/DILI, jaundice-to-encephalopathy >7 d, INR >3.5, bilirubin >17.5]), Maddrey discriminant function ≥32 + Glasgow Alcoholic Hepatitis Score (GAHS) ≥9 + Lille d-7 score for alcoholic hepatitis (STOPAH 2015 PMID 25901427), Hy's Law (ALT >3x ULN + T-bili >2x ULN without obstruction) for DILI severity (Reuben 2010 PMID 20949552), Tokyo TG18 grade I/II/III for cholangitis (Kiriyama 2018 PMID 29032610), Bhutani nomogram for neonatal phototherapy thresholdactions: calc.meld_na, calc.meld3advance: Severity scored
- 9TREATMENTDiagnosis-directed: NAC IV 21-h protocol for APAP within window + non-APAP ALF per ALFSG (Smilkstein 1988 PMID 3059186), DAA for HCV (AASLD/IDSA), entecavir/tenofovir for HBV (AASLD 2018 PMID 29405329), prednisolone 40 mg PO × 28 d if Maddrey ≥32 + Lille d-7 to continue/stop (STOPAH 2015 PMID 25901427), ursodeoxycholic for PBC + obeticholic 2nd-line (EASL 2017 PMID 28427765), prednisone + azathioprine for AIH, ceftriaxone + metronidazole + ERCP within 6-12 h for grade III cholangitis or 24-48 h for grade I-II (Tokyo TG18 PMID 29032610), URSO for ICP + early delivery if severe (ACOG 2024), magnesium + early delivery for HELLP/AFLP, transplant evaluation for ALF / decompensated (AASLD 2023; Lee 2011 PMID 22213561)advance: Diagnosis-directed plan documented
- 10DISPOSITIONHome (rare, outpatient initiation), ED (acute presentation, ALF rule-out, biliary obstruction), ICU (ALF, severe cholangitis with sepsis), inpatient (ALF management, ERCP, transplant evaluation), outpatient (chronic workup) (ACG 2021)advance: Disposition documented
- 11MONITORINGSerial LFT + INR + ammonia (ALF), HCC surveillance US ± AFP q6 mo if cirrhotic (AASLD HCC 2018 PMID 29624699), EGD q1-3 yr if cirrhotic, audiometry if Wilson on chelation, repeat MELD-Na for transplant list (AASLD 2023)advance: Monitoring plan documented
- 12FOLLOWUPHepatology / GI / oncology / transplant evaluation; route decompensated cirrhosis → gi.cirrhosis.core.v1; route HE → gi.hepatic-encephalopathy.core.v1; route APAP → tox.acetaminophen-overdose.core.v1 (AASLD 2023)advance: Referrals scheduled