Clinical Commander

All dossiers
symptom.jaundice.v1

Jaundice (adult)

symptomacutesubacutechronicundifferentiatedadultoutpatientacuteinpatient

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)

  • symptom
    Yellow eyes / skin (scleral icterus or jaundice) (ACG 2021)
    yellow_eyes_or_skin
  • symptom
    Dark urine + pale stool — cholestasis (BSG 2017)
    dark_urine_pale_stool
  • lab_abnormality
    Elevated total bilirubin on LFTs (ACG 2021)
    elevated_bilirubin
  • symptom
    Rapid-onset jaundice + altered mental status — concern for ALF (AASLD 2023 / Lee 2011 PMID 22213561)
    rapid_jaundice_with_encephalopathy
  • symptom
    Jaundice + fever + RUQ pain (Charcot triad) — concern for acute cholangitis (Tokyo TG18 Kiriyama 2018 PMID 29032610)
    jaundice_with_fever_and_ruq_pain
  • symptom
    Painless jaundice + weight loss in older adult — pancreatic / biliary malignancy concern (NICE 2024)
    painless_jaundice_in_older_adult
  • lab_abnormality
    ALT >3x ULN + T-bili >2x ULN without obstruction — Hy's Law DILI concern (Reuben 2010 PMID 20949552)
    hys_law_pattern

Required inputs (31)

  • agerequired
    demographic • used at CONTEXT
    Older adult + painless jaundice = pancreatic/biliary Ca; younger = viral / Wilson / Gilbert / autoimmune (ACG 2021)
  • sexrequired
    demographic • used at CONTEXT
    PBC strongly female-skewed; PSC male-skewed (EASL 2017 PBC); MELD 3.0 sex-adjusted (Kim 2021)
  • pregnancy_statusrequired
    demographic • used at FRAME
    Pregnancy-specific phenotypes — HELLP / AFLP / ICP have distinct management vs general adult workup (ACOG 2024)
  • symptom_onset_temporequired
    history • used at FRAME
    Acute (<2 wk — viral / DILI / APAP / cholangitis) vs subacute vs chronic (cirrhosis / PBC / PSC / malignancy) narrows differential (BSG 2017)
  • alcohol_userequired
    history • used at CONTEXT
    Alcoholic hepatitis / cirrhosis — chronic use ≥40 g/day or binge episodes (AASLD 2023; STOPAH 2015 PMID 25901427)
  • current_medsrequired
    medication • used at CONTEXT
    DILI: APAP, isoniazid, nitrofurantoin, augmentin, statins, anabolic steroids, methotrexate, valproate, herbals (kava, green tea, chaparral) — LiverTox NIH (Reuben 2010 PMID 20949552)
  • apap_ingestion_quantity_timingrequired
    history • used at RED_FLAGS
    APAP 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_userequired
    history • used at CONTEXT
    HAV / HBV / HCV / HEV exposure (AASLD 2023; AASLD HBV 2018 PMID 29405329)
  • pruritus_pain_patternrequired
    history • used at FRAME
    Painless = malignancy / PSC; pruritus = cholestasis (PBC, PSC, obstruction, ICP); RUQ pain = stones / cholangitis (Charcot triad) (BSG 2017)
  • family_history_liver_disease
    history • used at CONTEXT
    Wilson / hemochromatosis / α1AT / autoimmune (AASLD 2023)
  • pregnancy_weeks_gestation
    history • used at CONTEXT
    ICP usually 3rd trimester; AFLP late 3rd; HELLP 2nd-3rd; pre-eclampsia (ACOG 2024)
  • cbcrequired
    lab • used at INITIAL_WORKUP
    Hemolysis (anemia + retic + low haptoglobin), thrombocytopenia (cirrhosis or HELLP) (ACG 2021)
  • lftrequired
    lab • used at INITIAL_WORKUP
    AST/ALT/ALP/total + direct bilirubin (fractionation) /GGT — R-factor (ALT/ULN ÷ ALP/ULN); >5 hepatocellular, <2 cholestatic, 2-5 mixed (ACG 2021)
  • inrrequired
    lab • used at INITIAL_WORKUP
    Synthetic function — ALF if INR ≥1.5 + encephalopathy (no prior cirrhosis); King's College criterion (O'Grady 1989 PMID 2490426)
  • albuminrequired
    lab • used at INITIAL_WORKUP
    Synthetic function (chronic) — Child-Pugh component (AASLD 2023)
  • lipaserequired
    lab • used at INITIAL_WORKUP
    Pancreatitis as obstruction cause; gallstone pancreatitis (ACG 2021)
  • ammonia
    lab • used at RED_FLAGS
    Adjunct to clinical encephalopathy assessment in ALF / cirrhosis (not specific) (AASLD 2023)
  • lactate
    lab • used at RED_FLAGS
    Tissue hypoperfusion in cholangitis / sepsis / ALF; metabolic acidosis (AASLD 2023; Tokyo TG18 PMID 29032610)
  • apap_level
    lab • used at RED_FLAGS
    Acetaminophen level — interpret on Rumack-Matthew nomogram if known time of ingestion (Smilkstein 1988 PMID 3059186)
  • haptoglobin_retic_ldh_coombs
    lab • used at BRANCHING_WORKUP
    Hemolysis pattern (low haptoglobin + high retic + high LDH + indirect bilirubin + direct Coombs); smear for schistocytes (MAHA, HELLP) (BSG 2017)
  • viral_hepatitis_panelrequired
    lab • used at INITIAL_WORKUP
    HAV IgM, HBsAg + anti-HBc IgM + HBV DNA, anti-HCV + HCV RNA, HEV IgM (immunocompromised / pregnant / travel) (AASLD 2023; AASLD HBV 2018)
  • autoimmune_panel
    lab • used at BRANCHING_WORKUP
    AMA for PBC; ANA + ASMA + anti-LKM-1 + IgG for AIH; pANCA for PSC (AASLD 2023; EASL 2017 PBC PMID 28427765)
  • ceruloplasmin
    lab • used at BRANCHING_WORKUP
    Wilson 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_antitrypsin
    lab • used at BRANCHING_WORKUP
    α1AT deficiency phenotype (PiZZ) — quantitative + phenotyping (AASLD 2023)
  • iron_studies
    lab • used at BRANCHING_WORKUP
    Hemochromatosis — ferritin + transferrin saturation, HFE gene (AASLD 2023)
  • bile_acids_pregnancy
    lab • used at BRANCHING_WORKUP
    Total bile acids >10 µmol/L in pregnancy = ICP; >40 = severe (ACOG 2024)
  • ruq_ultrasoundrequired
    imaging • used at INITIAL_WORKUP
    Stones, ductal dilation, mass, cirrhosis morphology, ascites, portal vein flow — first-line (ACG 2021; BSG 2017)
  • mrcp_or_eus
    imaging • used at BRANCHING_WORKUP
    Detail biliary tree if obstruction suspected on US but cause unclear; EUS for distal CBD / pancreatic head (BSG 2017)
  • ercp
    imaging • used at BRANCHING_WORKUP
    Therapeutic biliary decompression — emergent for grade III cholangitis or impacted stone (Tokyo TG18 PMID 29032610)
  • ct_abdomen_pancreatic_protocol
    imaging • used at BRANCHING_WORKUP
    Pancreatic mass / cholangiocarcinoma / staging (NICE 2024)
  • fibroscan_or_biopsy
    imaging • used at BRANCHING_WORKUP
    Stage fibrosis non-invasively (FibroScan); biopsy for unclear hepatocellular (AIH overlap, drug vs autoimmune) (AASLD 2023)

12-phase flow (12)

  1. 1FRAME
    Confirm 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_status
    advance: Pattern + R-factor + bilirubin fractionation classified
  2. 2ENTRY
    Yellow 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: age
    advance: Entry pattern recognized
  3. 3CONTEXT
    Alcohol, 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_gestation
    advance: Context complete
  4. 4RED_FLAGS
    Acute 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, lactate
    actions: workup.acute_liver_failure, workup.acute_cholangitis, workup.apap_overdose
    advance: ALF / cholangitis / APAP / DILI / pregnancy phenotype identified or excluded
  5. 5INITIAL_WORKUP
    CBC, 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_ultrasound
    actions: panel.cbc, panel.lft, panel.coag, panel.pancreas, workup.abnormal_lft
    advance: Stage-1 returned
  6. 6BRANCHING_WORKUP
    By 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_biopsy
    actions: workup.hcv_initial, workup.hemolysis, workup.acute_cholangitis
    advance: Branch workup completed
  7. 7DIFFERENTIAL
    By 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
  8. 8RISK_STRATIFICATION
    MELD-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 threshold
    actions: calc.meld_na, calc.meld3
    advance: Severity scored
  9. 9TREATMENT
    Diagnosis-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
  10. 10DISPOSITION
    Home (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
  11. 11MONITORING
    Serial 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
  12. 12FOLLOWUP
    Hepatology / 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