Clinical Commander

All dossiers
pulm.idiopathic_pulmonary_fibrosis.v1

Idiopathic pulmonary fibrosis (IPF)

pulmonologychronicsubacuteadultgeriatricoutpatientacuteinpatienttransition

IPF dossier (depth-pass 2026-05-16) — folds _briefs/pulm.idiopathic_pulmonary_fibrosis.v1.depth.md payload into the .ts. UIP pattern + MDD diagnosis; pirfenidone (ASCEND PMID 24836312) or nintedanib (INPULSIS PMID 24836310) slow FVC decline; lung transplant only disease-modifying option. PANTHER-IPF (PMID 22607134) — prednisone+azathioprine+NAC triple therapy HARMFUL: stop legacy triple. AE-IPF (Collard 2016 PMID 27299520) 50-60% in-hospital mortality; corticosteroid weak/no-RCT. GAP index (Ley 2012 PMID 22586007) Stage I/II/III 1-yr mortality 6/16/39% drives transplant + palliative timing. Anti-reflux is CONDITIONAL (symptomatic GERD only) per 2022 update. PMID set fully re-verified via PubMed 2026-05-16 — prior set corrupted (35772019 kidney-dysplasia; 24836310 mislabeled ASCEND→is INPULSIS; CAPACITY/GAP/Collard/INPULSIS-ON wrong-article). All 11 now PubMed-confirmed. RxCUIs verified vs RxNav REST 2026-05-16: pirfenidone 1592254, nintedanib 1592737, omeprazole 7646, esomeprazole 283742, methylprednisolone 6902, prednisone 8640, oxygen 7806 — all correct, no fixes needed. Sibling differentiation expanded to 4 real on-disk engine_ids (pulm.sarcoidosis.v1, pulm.copd.core.v1 CPFE, pulm.pe.core.v1 AE-IPF mimic, pulm.pulmonary_htn_group2_to_5.v1 Group-3 PH-ILD). HP/CTD-ILD/drug-induced ILD have no on-disk dossier — encoded as differential-as-data in severity_triggers + DIFFERENTIAL phase. Schema-gap log (no invented fields used): GAP/FVC%-predicted/DLCO%-predicted calculators not in clinical-tools-registry; manifest/atoms/problem-package/engine-specific test not yet authored. See .depth.md §schema-gap. DEPTH-PASS-2 2026-05-18 (shard-07-cardio-chronic, IPF chronic depth target, golden-template = cardio.htn.core.v1): (1) co-located _design-brief.md + _research-bundle.md authored per §5.5 items 1+2 (22 verified PMIDs w/ effect sizes + 95% CI, retrieval-dated 2026-05-18, Consensus→WebSearch+RxNav-REST fallback logged); design_brief: repointed from _briefs/...md to the co-located _design-brief.md. (2) Bayesian seed deepened to htn shapes exactly (ENGINE_ID pulm.idiopathic_pulmonary_fibrosis.v1): 11 differentials w/ MDD-cohort-anchored priors (UIP-vs-mimics MECE partition + behaviour strata stable/PPF/AE-IPF), 15 ROS, 40 LR rows = 34 LR+ (>1) / 35 LR− (<1) both ≥15, 40 unique lr_ids, 3 conditional-dependency rules (definite-UIP composite subsumes sub-features; biopsy-need|HRCT-pattern-certainty; idiopathic-AE-IPF is exclusion dx, D-dimer non-diagnostic), T_test≈5% / T_treat≈50% definite-UIP header. (3) 2nd regimen axis added: ipf_phenotype_matrix (GAP-stage × phenotype drug-gating as DATA; PANTHER-IPF triple-immunosuppression harm encoded as hard contraindication rule; non-IPF-PPF→nintedanib INBUILD; do-not-adopt anchors ZEPHYRUS-1/STARSCAPE). (4) 2025 content refresh: NEW positive FIBRONEER-IPF nerandomilast (PMID 40387033, FVC Δ +68.8 mL, FDA Jascayd Oct-2025) added to evidence; negative pamrevlumab/zinpentraxin encoded as do-not-adopt; AE-IPF steroid sharpened w/ Farrand 2019 (OS HR 6.17); antacid refreshed to Kreuter pooled (no benefit, ↑infection). (5) Seed PMID corruption fixed: 26844465→26844464 (Sellarés Velcro crackles; 26844465 was a CKD/CIED-infection paper), 16234501 re-labelled "Wong CL JAMA 2009"→Wang CS JAMA 2005 dyspneic-CHF Rational Clinical Exam. (6) RxNav: registry drugs OK (methylpred 6902/prednisone 8640/esomeprazole 283742/omeprazole 7646); antifibrotics not in DrugEffectProfile registry → flagged NEEDS_RXNAV_VALIDATION, RxNav-REST-resolved (pirfenidone 1592254, nintedanib 1592737, oxygen 7806) all match — no RxCUI bug. 96-fail registry baseline OUT OF SCOPE (incl. unrelated n_acetylcysteine 7299 mismatch; NAC is the PANTHER harmful triple component, not a positive drug here). evidence.pmids 11→21; status unchanged (PRODUCTION). DEPTH-PASS-3 2026-05-26 (lane-E): +NMA +USPSTF +Cochrane +ICER stubs +decision thresholds, side-car at pulm.idiopathic_pulmonary_fibrosis.v1._depth-pass-3.md.

Entry points (5)

  • symptom
    Progressive dyspnea on exertion (>3–6 mo) (ATS/ERS 2022)
    progressive_exertional_dyspnea
  • symptom
    Persistent dry cough (ATS/ERS 2022)
    dry_persistent_cough
  • symptom
    Bibasilar Velcro inspiratory crackles ± digital clubbing (ATS 2018 dx)
    bibasilar_velcro_crackles
  • imaging
    HRCT UIP pattern (basal, subpleural, reticulation, honeycombing, traction bronchiectasis) (ATS 2018 dx)
    hrct_uip_pattern
  • history
    Familial pulmonary fibrosis or telomere-related history (ATS/ERS 2022)
    family_history_ipf

Required inputs (16)

  • agerequired
    demographic • used at CONTEXT
    IPF typically >60; GAP age points; transplant candidacy (ATS/ERS 2022)
  • sexrequired
    demographic • used at CONTEXT
    GAP "G" term — male sex confers worse prognosis (Ley 2012 PMID 22586007)
  • spo2_room_airrequired
    vital • used at CONTEXT
    Resting + ambulatory hypoxemia drives O2 prescription; LTOT trigger SpO2 ≤88% (ATS/ERS 2022)
  • ana_rf_ccp_myositis_panelrequired
    lab • used at INITIAL_WORKUP
    Exclude CTD-ILD before labelling IPF — ANA/RF/CCP/Scl-70/Jo-1/PL-7/PL-12/MDA5/Ro52 (ATS 2018 dx)
  • hp_panel_igG
    lab • used at INITIAL_WORKUP
    IgG precipitins for chronic fibrotic HP differential (ATS/JRS/ALAT 2020 HP)
  • cbcrequired
    lab • used at INITIAL_WORKUP
    Anemia worsens dyspnea; pre-antifibrotic baseline; nintedanib bleeding risk (ATS/ERS 2022)
  • bmp_lftrequired
    lab • used at INITIAL_WORKUP
    Pirfenidone / nintedanib hepatotoxicity baseline + serial LFT (DailyMed labels)
  • bnp
    lab • used at INITIAL_WORKUP
    HF / Group-2 PH differential vs Group-3 PH-ILD (ATS/ERS 2022)
  • hrctrequired
    imaging • used at INITIAL_WORKUP
    UIP-pattern HRCT is the central diagnostic axis; definite-UIP obviates biopsy (ATS 2018 dx)
  • spirometry_dlcorequired
    imaging • used at INITIAL_WORKUP
    FVC + DLCO baseline + GAP physiology; FVC trend drives progression/transplant (ATS/ERS 2022)
  • six_minute_walk_testrequired
    imaging • used at INITIAL_WORKUP
    Functional capacity + exertional desaturation; nadir SpO2 prognostic (ATS/ERS 2022)
  • tte_for_ph
    imaging • used at BRANCHING_WORKUP
    Screen Group-3 PH-ILD (TRV, RV function) — poor-prognosis modifier (ATS/ERS 2022)
  • lung_biopsy
    imaging • used at BRANCHING_WORKUP
    Surgical/cryobiopsy ONLY when HRCT not definite UIP and MDD requires histology (ATS 2018 dx)
  • occupational_environmentalrequired
    history • used at CONTEXT
    Asbestos / silica / mold / bird / hot-tub exposure for asbestosis & HP (ATS 2018 dx)
  • gerd_history
    history • used at CONTEXT
    GERD highly prevalent; anti-reflux is a CONDITIONAL ATS/ERS 2022 recommendation
  • current_medsrequired
    medication • used at CONTEXT
    Drug-induced ILD screen (amiodarone, MTX, nitrofurantoin, ICI, T-DXd); nintedanib + anticoagulant/CYP interactions (ATS/ERS 2022)

12-phase flow (12)

  1. 1FRAME
    Adult chronic progressive fibrosing ILD — confirm UIP pattern on HRCT and adjudicate via multidisciplinary discussion (MDD: pulm + thoracic radiology + pathology) per ATS/ERS/JRS/ALAT 2022; scope excludes secondary fibrosis (CTD/drug/sarcoid), NSIP, HP
    inputs: hrct, ana_rf_ccp_myositis_panel
    advance: IPF confirmed at MDD
  2. 2ENTRY
    Suspicion: progressive exertional dyspnea + dry cough + bibasilar Velcro crackles ± clubbing + restrictive PFT + ↓DLCO in patient >60 → obtain HRCT looking for UIP (ATS 2018 dx)
    inputs: age, sex
    advance: Engine entered
  3. 3CONTEXT
    Smoking pack-years, occupational/environmental antigen + dust exposure, family history (familial pulmonary fibrosis / telomeropathy), autoimmune review of systems (Raynaud, sicca, mechanic hands, Gottron, arthritis), GERD, OSA, full medication review for drug-induced ILD per ATS 2018
    inputs: occupational_environmental, gerd_history, current_meds, spo2_room_air
    advance: Exposure + autoimmune + drug context complete
  4. 4RED_FLAGS
    Acute exacerbation of IPF (AE-IPF — Collard 2016 PMID 27299520): acute worsening dyspnea <30 d + new bilateral GGO/consolidation on HRCT NOT fully explained by HF, fluid overload, PE or infection. Differential: (a) infection (viral PCR + bacterial + PCP if immunosuppressed); (b) PE (CTPA — D-dimer non-diagnostic in IPF → pulm.pe.core.v1); (c) cardiogenic edema (BNP, echo); (d) aspiration; (e) drug-induced ILD; (f) idiopathic AE-IPF. Also: severe resting hypoxemia (LTOT trigger SpO2 ≤88%), Group-3 PH decompensation (TTE TRV high + RV dysfunction + syncope)
    inputs: spo2_room_air
    actions: ild_acute_exac
    advance: Stabilised or escalated
  5. 5INITIAL_WORKUP
    HRCT (UIP pattern grading), spirometry + DLCO, 6MWT with continuous SpO2, autoimmune serology (ANA/RF/CCP/myositis/Scl-70/Ro52), HP IgG precipitins, CBC, BMP/LFT baseline (pre-antifibrotic), BNP per ATS 2018/2022
    inputs: hrct, spirometry_dlco, six_minute_walk_test, ana_rf_ccp_myositis_panel, cbc, bmp_lft
    actions: panel.cbc, panel.lft, panel.renal
    advance: Stage-1 returned
  6. 6BRANCHING_WORKUP
    If HRCT NOT definite/probable UIP → MDD ± surgical lung biopsy or transbronchial lung cryobiopsy (ATS 2018); BAL only when alternate dx (HP lymphocytosis >30%, sarcoid, infection) suspected; TTE → right heart cath if PH-ILD suspected (route pulm.pulmonary_htn_group2_to_5.v1)
    inputs: lung_biopsy, tte_for_ph
    actions: ild_acute_exac, pulmonary_nodule
    advance: MDD complete (definite UIP or biopsy-confirmed UIP)
  7. 7DIFFERENTIAL
    §5.5.2 differential-as-data — IPF/UIP vs NSIP (younger, ground-glass-predominant, no honeycomb, steroid-responsive) vs chronic fibrotic HP (antigen Hx, mosaic air-trapping 3-density sign, BAL lymphocytosis >30%, IgG precipitins → reconsider HP) vs CTD-ILD (female, +ANA/RF/CCP/Scl-70/Jo-1/MDA5, extrathoracic features → rheum MDD) vs drug-induced ILD (temporal drug exposure — amiodarone/MTX/nitrofurantoin/ICI/T-DXd; reversible if stopped) vs sarcoidosis (upper-lobe, perilymphatic nodules, hilar adenopathy → pulm.sarcoidosis.v1) vs CPFE (upper-lobe emphysema + lower-lobe fibrosis, preserved spirometric volumes, severely ↓DLCO, disproportionate PH → pulm.copd.core.v1 overlap) vs asbestosis (asbestos Hx + pleural plaques). Definite-UIP HRCT has high specificity (~90-100%) for histologic UIP → biopsy can be omitted (ATS 2018 PMID 30168753)
    inputs: hrct, ana_rf_ccp_myositis_panel, hp_panel_igG
    advance: IPF confirmed at MDD or routed to sibling engine
  8. 8RISK_STRATIFICATION
    GAP index (Gender, Age, FVC%, DLCO%; Ley 2012 PMID 22586007) → Stage I/II/III with 1-yr mortality 6% / 16% / 39%; rate of FVC decline (≥10% relative in 6–12 mo = progression); DLCO ≤35% / 6MWT desat <88% / PH-ILD as poor-prognosis modifiers; gate transplant referral timing
    inputs: spirometry_dlco, six_minute_walk_test, age, sex
    actions: calc.mmrc
    advance: GAP stage + progression risk documented
  9. 9TREATMENT
    Antifibrotic axis — pirfenidone OR nintedanib (start regardless of FVC; choose by comorbidity/tolerability — see regimen_axes); supplemental O2 if SpO2 ≤88% rest/exertion; pulmonary rehab; vaccinations; anti-reflux CONDITIONAL (ATS/ERS 2022); EARLY lung transplant referral; AE-IPF — supportive + high-dose corticosteroid (WEAK evidence, no RCT) + treat precipitant; NO triple therapy (PANTHER harm PMID 22607134); palliative care + advance directives
    inputs: bmp_lft, spo2_room_air
    advance: Antifibrotic + supportive + transplant + palliative plan documented
  10. 10DISPOSITION
    Admit if AE-IPF / hypoxemic respiratory failure (ICU + ECMO only as bridge-to-transplant in candidates — otherwise high mortality, align with goals of care); outpatient ILD/pulmonology otherwise (ATS/ERS 2022)
    advance: Disposition documented
  11. 11MONITORING
    FVC q3–6 mo + DLCO q6–12 mo (progression trend drives transplant), 6MWT q6 mo, HRCT annually or per change. Antifibrotic safety: LFT monthly ×6 then q3 mo (both drugs), CBC, weight (nintedanib GI), photosensitivity counselling (pirfenidone). Track ≥10% relative FVC decline = progression trigger (ATS/ERS 2022)
    inputs: bmp_lft, spirometry_dlco
    advance: Surveillance schedule + progression thresholds documented
  12. 12FOLLOWUP
    ILD clinic q3–6 mo, transplant clinic co-management, comorbidity sweep (Group-3 PH, CPFE, GERD, OSA, lung-cancer surveillance — IPF raises lung-ca risk, depression), pulmonary rehab continuity, palliative care + advance care planning (ATS/ERS 2022)
    advance: Follow-up + transplant + comorbidity + palliative loop booked