Heart failure (chronic, GDMT titration)
HFpEF and HFrEF currently share this dossier. Per inventory gap list, splitting into cardio.hfref.core.v1 and cardio.hfpef.core.v1 is a planned next step so each pillar can have its own evidence + regimen axis. Calculator gaps: MAGGIC, ADHERE, NEWS2 are not yet in clinical-tools-registry.ts — add before promoting to PRODUCTION. DEPTH-PASS-2 2026-05-16 (shard-07-cardio-chronic, golden-template mirrored on cardio.htn.core.v1) added: (1) co-located _design-brief.md + _research-bundle.md per §5.5 items 1+2 (24 verified PMIDs, named trials + effect sizes + 95% CI, retrieval-dated 2026-05-16, Consensus→PubMed-primary fallback logged; design_brief field repointed to src/lib/dossiers/cardio.hf.core.v1._design-brief.md); (2) cardio.hf.core.v1 ros+differentials+finding-lrs seed files DEEPENED in place (12 differentials w/ cohort-anchored priors incl. HFmrEF + ATTR + look-alikes, 14 ROS, 38 LR rows = 22 LR+/16 LR−, 3 conditional-dependency rules — NT-proBNP|obesity/AF/age, H2FPEF|EF, S3/JVD co-congestion — T_test≈5%/T_treat≈60%); (3) regimen axes refactored to 2 phenotypic axes: gdmt_4_pillar_hfref now a 4-step RAPID-SIMULTANEOUS-initiation ladder (STRONG-HF + 2024 ACC Consensus) and new hf_phenotype_comorbidity_matrix encoding drug × EF-band × comorbidity (CKD/AF/T2DM/iron/low-BP/ATTR) gating as DATA; (4) RxCUI bugs fixed vs canonical DrugEffectProfile registry (rxnav:validate run live): sacubitril/valsartan 1656340→1656339, metoprolol-succ 866427→221124, finerenone 2168780→2562811, metolazone 4109→6916; setting_playbook drug_action rxcui placeholders repointed; (5) 2026-guideline content refresh: 6 stale/fabricated evidence PMIDs corrected (FINEARTS-HF 39264738→39225278 [was a vanadium-chemistry paper], STEP-HFpEF 37622663→37622681, DELIVER 36027571→36027570, COPERNICUS 11386262→11386263, MERIT-HF 10377659→10376614, guideline 35379504→35363499/35379503), 2 SUSPECTED_FABRICATION PMIDs (29766750/23900119) removed, vericiguat (VICTORIA) + ATTR-CM (ATTR-ACT) + finerenone-HFpEF + SGLT2i-across-full-EF folded in; evidence.pmids 23→26 verified; last_reconciled 2026-05-13→2026-05-16. PRODUCTION blockers remaining: some triggers ("LVEF<=40", "K<5.0") are plain-English and not yet machine-evaluable; vericiguat RxCUI corrected 2557097→2475830 (RxNorm vericiguat ingredient, RxNav-verified 2026-05-24) and tirzepatide-SUMMIT PMID corrected 39536361 [was a 3-membered-ring medicinal-chemistry paper]→39555826 (NEJM 2025, esummary-verified 2026-05-24); vericiguat still has no DrugEffectProfile (non-profile, flagged); MAGGIC/ADHERE calculator registry gap unchanged (owned by registry terminal, not this depth shard). DEPTH-PASS-3 2026-05-26 (lane-E): +NMA (Vaduganathan Lancet 2020 cross-trial comprehensive-disease-modifying HFrEF HR 0.38 0.30–0.47; Kotecha Lancet 2014 BB IPD HF+sinus vs HF+AF; Taylor 2019 EXTRAMATCH II exercise-CR IPD) +Cochrane (Long 2019 CD003331 exercise-based CR for HF) +USPSTF (HF screening explicitly NOT a USPSTF topic; HTN A-2021 + obesity B-2018 + statin B-2022 + smoking A-2021 hooks) +ICER (Bhatt JAMA Cardiol 2023 sac/val $76,852/QALY; Davis/McEwan EJHF 2024 dapa £6,470/QALY UK NHS; Cohen JAMA Cardiol 2023 SGLT2i HFpEF $141,200/QALY) +Pauker-Kassirer decision thresholds explicit (T_test≈5%/T_treat≈60% diagnostic; T_treat raised for ATTR-CM tafamidis on economic-harm grounds); side-car at cardio.hf.core.v1._depth-pass-3.md. Zero schema churn; 8 new PMIDs live-verified via PubMed MCP 2026-05-26. Three prompt-supplied PMIDs rejected (26747508/33871957/36925878 — wrong articles by live verification) and replaced with the correct authors' actual papers.
Entry points (5)
- symptomDyspnea on exertion / orthopnea / PNDdyspnea
- symptomLower-extremity edemalower_extremity_edema
- lab_abnormalityNT-proBNP elevatednt_probnp_elevated
- imagingEcho LVEF reduced/borderlineecho_lvef_reduced
- problem_listExisting HF on problem list (titration visit)heart_failure
Required inputs (17)
- agerequireddemographic • used at CONTEXTAge cutoffs for ARNi vs ACEi tolerability + dose adjustment — ACC/AHA 2022
- sbprequiredvital • used at CONTEXTGDMT initiation requires SBP ≥ 100 mmHg — ACC/AHA 2022; titration requires monitoring for hypotension
- hrrequiredvital • used at CONTEXTBeta-blocker titration target HR; ivabradine candidacy ≥ 70 bpm sinus — ACC/AHA 2022
- creatininerequiredlab • used at CONTEXTeGFR for SGLT2i (≥20 — DAPA-HF 2019), ACEi/ARB initiation, MRA monitoring — ACC/AHA 2022
- potassiumrequiredlab • used at CONTEXTMRA contraindicated K > 5.0 (RALES, Pitt NEJM 1999); baseline before ACEi/ARB/MRA — ACC/AHA 2022
- lvefrequiredimaging • used at DIFFERENTIALBranches HFrEF (≤40) / HFmrEF (41–49) / HFpEF (≥50) — ACC/AHA 2022 universal definition; drives 4-pillar regimen choice
- nt_probnplab • used at INITIAL_WORKUPDiagnostic confirmation + monitoring; age-adjusted thresholds — ACC/AHA 2022 Class I
- tshlab • used at INITIAL_WORKUPHyper/hypothyroidism as reversible HF cause/aggravator — ACC/AHA 2022 §4.3
- iron_panellab • used at INITIAL_WORKUPIV iron in HFrEF + iron deficiency (FAIR-HF/CONFIRM-HF/AFFIRM-AHF)
- a1clab • used at INITIAL_WORKUPDiabetes co-prevalence drives SGLT2i + GLP-1 selection; HFpEF + obesity → semaglutide/tirzepatide (STEP-HFpEF, Kosiborod NEJM 2023)
- past_mihistory • used at CONTEXTIschemic vs non-ischemic etiology branches workup — ACC/AHA 2022 §4.1
- atrial_fibrillationhistory • used at CONTEXTRate vs rhythm strategy; anticoagulation — ACC/AHA 2022 §7.3.7
- ckdhistory • used at CONTEXTCKD stage gates SGLT2i, ACEi/ARB titration, MRA risk — KDIGO 2021 + ACC/AHA 2022
- dm2history • used at CONTEXTDual cardiorenal indication — favors SGLT2i (DAPA-HF 2019) + GLP-1 — ADA 2026
- current_medsmedication • used at CONTEXTDetect existing GDMT components for titration vs initiation; flag NSAIDs/CCB-non-DHP — ACC/AHA 2022 §7.3
- ecgimaging • used at INITIAL_WORKUPQRS ≥150ms LBBB → CRT candidacy — ACC/AHA 2022 §7.5; AF rhythm; ischemic Q-waves
- nyha_classsymptom • used at RISK_STRATIFICATIONNYHA II-IV classification drives device + advanced therapy thresholds — ACC/AHA 2022 §3
12-phase flow (12)
- 1FRAMEConfirm chronic HF scope — exclude acute decompensation that should route to cardio.acute-hf.core.v1 — ACC/AHA 2022 §3inputs: nyha_classadvance: patient is hemodynamically stable and not in acute pulmonary edema
- 2ENTRYRecognize triggering symptom, lab, or imaging finding and capture patient identityinputs: ageadvance: one entry trigger present and basic demographics captured
- 3CONTEXTCapture vitals, key comorbidities (CKD, DM, AF, prior MI), allergies, current GDMT componentsinputs: sbp, hr, creatinine, potassium, past_mi, atrial_fibrillation, ckd, dm2, current_medsadvance: all hard_required vitals/labs and comorbidity screen complete
- 4RED_FLAGSScreen for acute decompensation, cardiogenic shock, hyperkalemia, AKI on CKD — ACC/AHA 2022 §10inputs: sbp, creatinine, potassiumactions: cardiogenic_shockadvance: no red flags or red flags routed to acute pathway
- 5INITIAL_WORKUPBNP/NT-proBNP, BMP, TSH, iron panel, A1c, ECG, echo (if not on file) — ACC/AHA 2022 §4inputs: nt_probnp, tsh, iron_panel, a1c, ecgactions: panel.cardiac, panel.renal, panel.thyroidadvance: baseline labs returned; LVEF documented
- 6BRANCHING_WORKUPEtiology workup if newly diagnosed: ischemic vs non-ischemic, valvular, infiltrative — ACC/AHA 2022 §4.1inputs: lvef, past_miactions: workup.le_edemaadvance: etiology established or referred for further imaging (cardiac MRI, cath)
- 7DIFFERENTIALPhenotype as HFrEF (≤40) / HFmrEF (41–49) / HFpEF (≥50) / HF-improved — ACC/AHA 2022 universal definitioninputs: lvefadvance: phenotype assigned
- 8RISK_STRATIFICATIONNYHA class, MAGGIC/Seattle/ADHERE risk; CRT/ICD eligibility check — ACC/AHA 2022 §7.5inputs: nyha_classadvance: NYHA documented; high-risk flag triggered if applicable
- 9TREATMENTBuild/titrate 4-pillar GDMT for HFrEF (ACC/AHA 2022 Class I) or SGLT2i + diuretic + finerenone for HFpEF (DELIVER 2022, FINEARTS-HF 2024); treat reversible driversinputs: lvef, sbp, hr, creatinine, potassium, dm2, ckdadvance: every applicable pillar prescribed at lowest tolerated dose with monitoring plan
- 10DISPOSITIONTitration visit cadence; refer to advanced HF if stage D triggers met — ACC/AHA 2022 §8inputs: nyha_classadvance: next visit interval set; advanced HF referral made if NYHA IV / inotrope-dep / VAD candidacy
- 11MONITORINGBMP within 1–2 weeks of GDMT change, then at each titration — ACC/AHA 2022; weight + symptom diary; iron repletion check (FAIR-HF 2009)inputs: creatinine, potassiumactions: panel.renaladvance: monitoring plan documented and patient educated
- 12FOLLOWUPVisit cadence by NYHA + recent titration; cardiac rehab referral; vaccination check (flu, pneumococcal, COVID) — ACC/AHA 2022 §7.3.8advance: follow-up scheduled and patient given return precautions