Connective-tissue-disease-associated ILD (CTD-ILD / IPAF)
CTD-ILD / IPAF dossier (design-disease-first NEW build 2026-05-16) — prior attempt produced nothing; authored fresh. engine_id pulm.ctd-ild.v1 (did not exist; referenced as key differential by pulm.idiopathic_pulmonary_fibrosis.v1 + pulm.hypersensitivity-pneumonitis.v1). Two converging entry routes (known CTD + new respiratory disease; OR new ILD + autoimmune serology/features) → rheum+pulm+radiology MDD. Bayesian which-CTD-by-serology + NSIP-vs-UIP pattern. Unlike IPF, immunosuppression is FIRST-LINE (MMF — SLS II PMID 27469583), antifibrotic is ADD-ON (nintedanib SENSCIS PMID 31112379 / INBUILD PMID 31566307). Two emergencies encoded: anti-MDA5 RP-ILD (Tsuji 2020 PMID 31524333 — up-front combination GC+tacrolimus+IV CYC 89% vs 33% 6-mo survival, time-critical) and scleroderma renal crisis (glucocorticoid is a PRECIPITANT — steroid CAUTION encoded in contraindication_rules + severity_triggers, NOT a taper_plan field which does not exist in _types.ts). Effect sizes (≥10): SLS I FVC +2.53% (16790698); SLS II MMF≈CYC (27469583); SENSCIS -52.4 vs -93.3 mL/yr (31112379); INBUILD -80.8 vs -187.8 (31566307); INBUILD autoimmune subgroup +104.0 mL/yr (32145830); RECITAL -40 mL n.s. (36375479); focuSSced FVC LSM 4.2 p=0.0002 (32866440); anti-MDA5 89% vs 33% (31524333). 12 PMIDs all PubMed-verified 2026-05-16 (title/journal/DOI/effect size). Cross-dossier engine_ids — confirmed on disk via ls/grep src/lib/dossiers/: pulm.idiopathic_pulmonary_fibrosis.v1, pulm.hypersensitivity-pneumonitis.v1, pulm.sarcoidosis.v1, pulm.pe.core.v1, rheum.sle-flare.core.v1 (sibling_differentiation 4 rows + workups[].branches_to + severity_triggers routes). Drug-induced ILD / IPAF have no on-disk dossier — differential-as-data only. Registry ids reused (all resolve in clinical-tools-registry.ts): workup.ild_acute_exac, workup.pulmonary_nodule; calc.mmrc (required), calc.bode, calc.aa_gradient, calc.rox; panel.cbc/panel.lft/panel.renal/panel.abg/panel.cardiac. No invented unresolved ids. RxCUIs verified vs RxNav REST /REST/rxcui/{cui}/properties.json 2026-05-16 (all tty=IN): mycophenolate mofetil 68149, cyclophosphamide 3002, rituximab 121191, nintedanib 1592737, tocilizumab 612865, tacrolimus 42316, prednisone 8640, methylprednisolone 6902 — no fixes needed. Schema-gap log (no invented fields; _types.ts respected, no taper_plan): ILD-GAP/Goh-staging/FVC%-pred/DLCO%-pred calculators not in registry → calc.mmrc/calc.bode/calc.aa_gradient adjuncts + narrative RISK_STRATIFICATION + severity_triggers. manifest repointed to existing prisma/seed/manifests/id.sepsis.core.v1.ts (HP/IPF repoint pattern); not registered in _registry.ts (strict scope) — not exercised by ALL_DOSSIERS contract test; correctness via npm run lint (tsc). No manifest/atoms/problem-package/engine-specific test authored. settings=[outpatient,inpatient] (DossierSetting has NO acute). Status PLANNED. See _briefs/pulm.ctd-ild.v1.depth.md §schema-gap.
Entry points (5)
- historyKnown CTD (SSc/RA/IIM/Sjögren/MCTD/SLE) + new dyspnea / cough / PFT decline / HRCT change (ACR/CHEST 2023)known_ctd_with_new_respiratory_disease
- imagingHRCT ILD pattern (NSIP > UIP; RA-ILD often UIP) in a patient with autoimmune features (ACR/CHEST 2023)hrct_ild_pattern
- symptomProgressive exertional dyspnea + dry cough with extrapulmonary autoimmune features (ACR/CHEST 2023)progressive_exertional_dyspnea
- lab_abnormalityNewly discovered ILD + positive ANA/ENA/RF/CCP/myositis serology (IPAF — Fischer ERS/ATS 2015)positive_autoantibody_in_new_ild
- symptomAcute hypoxemic ILD + amyopathic-DM skin signs (Gottron/heliotrope) — anti-MDA5 RP-ILD emergency (Tsuji 2020)rapidly_progressive_hypoxemic_ild
Required inputs (18)
- agerequireddemographic • used at CONTEXTCTD subtype distribution + immunosuppression/transplant candidacy (ACR/CHEST 2023)
- sexrequireddemographic • used at CONTEXTCTD epidemiology (female-predominant SSc/SLE/Sjögren); pregnancy status gates teratogenic IS (ACR/CHEST 2023)
- pregnancy_statusrequireddemographic • used at CONTEXTCYC + MMF are teratogenic/contraindicated in pregnancy — switch to pregnancy-compatible IS pre-conception (DailyMed MMF/CYC labels)
- spo2_room_airrequiredvital • used at CONTEXTResting + ambulatory hypoxemia drives severity, O2, and RP-ILD recognition (ACR/CHEST 2023)
- blood_pressurerequiredvital • used at CONTEXTAccelerated/malignant HTN is the scleroderma renal crisis pivot — steroid is a precipitant (SSc subtype caution)
- autoantibody_panel_ctdrequiredlab • used at INITIAL_WORKUPANA/ENA/RF/anti-CCP/Scl-70/RNA-pol-III/Jo-1/PL-7/PL-12/MDA5/Ro52 set which-CTD + IPAF serologic domain (ACR/CHEST 2023; Fischer 2015)
- ck_aldolaselab • used at INITIAL_WORKUPMyopathy screen for IIM/anti-synthetase; anti-MDA5 DM is often amyopathic (normal CK) — do not exclude on normal CK
- ferritinlab • used at INITIAL_WORKUPMarkedly elevated ferritin is a poor-prognosis marker in anti-MDA5 RP-ILD (Tsuji 2020 PMID 31524333)
- cbcrequiredlab • used at INITIAL_WORKUPPre-immunosuppression baseline; cytopenia screen (SLE); CYC/MMF myelosuppression (DailyMed labels)
- bmp_lftrequiredlab • used at INITIAL_WORKUPRenal crisis (SSc) creatinine + nintedanib/MMF/CYC hepatic-renal baseline + serial (DailyMed labels)
- bnplab • used at INITIAL_WORKUPSSc PH-ILD screen / cardiac involvement vs ILD-driven dyspnea (ACR/CHEST 2023)
- hrctrequiredimaging • used at INITIAL_WORKUPNSIP-vs-UIP pattern + extent (>20% extensive; Goh staging in SSc) is the central radiologic axis (ACR/CHEST 2023)
- spirometry_dlcorequiredimaging • used at INITIAL_WORKUPFVC + DLCO baseline + decline rate drive severity and PPF determination (ATS/ERS 2022 PPF)
- ambulatory_desaturation_testimaging • used at INITIAL_WORKUPACR/CHEST 2023 conditionally recommends ambulatory desaturation for MONITORING (not screening) of CTD-ILD
- tte_for_phimaging • used at BRANCHING_WORKUPScreen SSc PH-ILD (TRV, RV function); PH is a strong poor-prognosis modifier (ACR/CHEST 2023)
- current_medsrequiredmedication • used at CONTEXTMTX-pneumotoxicity confounder in RA-ILD; amiodarone/ICI/nitrofurantoin drug-ILD differential; IS drug-interaction screen (ACR/CHEST 2023)
- extrapulmonary_autoimmune_featuresrequiredhistory • used at CONTEXTRaynaud, sicca, mechanic’s hands, Gottron/heliotrope, sclerodactyly, dysphagia, arthritis — clinical domain for which-CTD + IPAF (Fischer 2015)
- occupational_environmentalhistory • used at CONTEXTAntigen/asbestos exposure for HP/asbestosis differential when serology negative (ATS/JRS/ALAT 2020 HP)
12-phase flow (12)
- 1FRAMEAdult chronic/subacute SARD-associated ILD or IPAF — confirm CTD subtype + ILD pattern at rheumatology + pulmonology + thoracic-radiology MDD per ACR/CHEST 2023 + ATS/ERS PPF 2022; scope excludes IPF/UIP without autoimmunity, chronic fibrotic HP, drug-induced ILD, sarcoidosis (encoded as differential-as-data)inputs: hrct, autoantibody_panel_ctdadvance: CTD-ILD/IPAF confirmed at MDD
- 2ENTRYTwo converging routes: (a) known CTD (SSc/RA/IIM/Sjögren/MCTD/SLE) + new respiratory symptom / PFT decline / HRCT change; (b) newly discovered ILD + autoimmune features (Raynaud, sicca, mechanic’s hands, Gottron, sclerodactyly, dysphagia, arthritis) → obtain autoantibody panel (ACR/CHEST 2023; Fischer 2015 IPAF)inputs: age, sexadvance: Engine entered
- 3CONTEXTCTD review of systems + autoantibody history, smoking, occupational/environmental antigen exposure (HP/asbestos overlap), FULL medication review (MTX — RA-ILD pneumotoxicity confounder AND drug-ILD; amiodarone/ICI/nitrofurantoin drug-ILD), pregnancy status (CYC/MMF teratogenic — gate teratogenic IS), BP (scleroderma renal-crisis precursor)inputs: extrapulmonary_autoimmune_features, current_meds, pregnancy_status, blood_pressure, spo2_room_air, occupational_environmentaladvance: CTD + drug + pregnancy + BP context complete
- 4RED_FLAGSAnti-MDA5 RP-ILD EMERGENCY (Tsuji 2020 PMID 31524333): acute hypoxemic ILD + amyopathic-DM skin signs (Gottron papules, heliotrope, mechanic’s hands, palmar papules) + ferritin↑↑ + MDA5+ → ~50% untreated mortality, time-critical combination immunosuppression. Scleroderma renal crisis: accelerated/malignant HTN + AKI + microangiopathic hemolysis (esp. early dcSSc, RNA-pol-III+, recent glucocorticoid >15 mg/day prednisone-equiv — STEROID IS A PRECIPITANT). Acute exacerbation of CTD-ILD; severe resting hypoxemia (SpO2 ≤88%)inputs: spo2_room_air, blood_pressure, ferritinactions: ild_acute_exacadvance: Emergency excluded or RP-ILD/renal-crisis pathway activated
- 5INITIAL_WORKUPHRCT (NSIP-vs-UIP pattern + extent — >20% extensive / Goh limited-vs-extensive in SSc), spirometry + DLCO, autoantibody panel (ANA/ENA/RF/anti-CCP/Scl-70/RNA-pol-III/Jo-1/PL-7/PL-12/MDA5/Ro52), CK/aldolase + ferritin, CBC/BMP/LFT (pre-immunosuppression baseline), ambulatory desaturation, BNP/TTE (PH screen, esp. SSc) per ACR/CHEST 2023inputs: hrct, spirometry_dlco, autoantibody_panel_ctd, cbc, bmp_lftactions: panel.cbc, panel.lft, panel.renaladvance: Stage-1 returned
- 6BRANCHING_WORKUPBAL ONLY if infection / alternate dx suspected (esp. before/during immunosuppression — PJP/CMV); surgical lung biopsy STRONGLY recommended against for screening (ACR/CHEST 2023) and rarely needed when CTD + compatible HRCT; nailfold capillaroscopy (SSc); TTE → right heart cath if PH-ILD (SSc). If serology negative + UIP pattern → reconsider IPF / chronic fibrotic HP / drug-ILD (route real sibling engines)inputs: tte_for_ph, ck_aldolaseactions: ild_acute_exac, pulmonary_noduleadvance: MDD complete (CTD-ILD/IPAF confirmed or routed to sibling engine)
- 7DIFFERENTIAL§5.5.2 differential-as-data — CTD-ILD vs IPF/UIP (older, male, no autoimmunity, definite-UIP HRCT, antifibrotic-only — route pulm.idiopathic_pulmonary_fibrosis.v1) vs chronic fibrotic HP (antigen Hx, mosaic air-trapping, BAL lymphocytosis >30%, IgG precipitins — route pulm.hypersensitivity-pneumonitis.v1) vs drug-induced ILD (temporal MTX/amiodarone/ICI/nitrofurantoin exposure — STOP drug, often reversible) vs sarcoidosis (upper-lobe perilymphatic nodules + hilar adenopathy — route pulm.sarcoidosis.v1) vs IPAF (autoimmune features short of CTD criteria — Fischer 2015 domains). WHICH-CTD-BY-SEROLOGY: Scl-70/RNA-pol-III/centromere → SSc (NSIP>UIP; ILD leading SSc-mortality cause); anti-CCP/RF → RA-ILD (often UIP); Jo-1/PL-7/PL-12/EJ/OJ → anti-synthetase syndrome (NSIP/OP); MDA5 → amyopathic DM RP-ILD emergency; anti-Ro52 amplifies ILD risk/severity across IIM; SSA/SSB → Sjögren (NSIP/LIP); U1-RNP → MCTD; ANA/dsDNA/Sm → SLE. NSIP predominates in most CTDs; RA-ILD is the notable UIP-predominant exception (worse prognosis, antifibrotic-relevant)inputs: autoantibody_panel_ctd, hrct, extrapulmonary_autoimmune_featuresadvance: CTD subtype + ILD pattern confirmed at MDD or routed to sibling engine
- 8RISK_STRATIFICATIONExtent of fibrosis on HRCT (>20% = extensive; Goh staging in SSc: extensive disease + FVC <70% = poor prognosis), FVC/DLCO severity + decline rate, PROGRESSIVE PULMONARY FIBROSIS (ATS/ERS 2022 PPF — ≥2 of 3: worsening symptoms, radiologic progression, physiologic progression within 1 yr, no alternative explanation), anti-MDA5 RP-ILD phenotype (ferritin↑↑, rapid HRCT progression), PH-ILD modifier. SSc-ILD is the leading cause of SSc-related death — drives early treatmentinputs: spirometry_dlco, hrct, autoantibody_panel_ctdactions: calc.mmrcadvance: Extent + severity + decline-rate + PPF status documented
- 9TREATMENTTREAT THE UNDERLYING CTD + immunosuppression axis — MMF first-line (SLS II PMID 27469583: MMF ≈ oral CYC on FVC, less toxic); CYC (SLS I PMID 16790698) or rituximab (RECITAL PMID 36375479: not superior to IV CYC but equivalent with fewer adverse events) for severe/rapidly progressive; tocilizumab (focuSSced PMID 32866440: FVC%-pred preserved) for early dcSSc-ILD with raised acute-phase reactants. ANTIFIBROTIC ADD-ON — nintedanib for SSc-ILD (SENSCIS PMID 31112379) and for any CTD-ILD meeting PPF criteria (INBUILD PMID 31566307; autoimmune subgroup +104.0 mL/yr PMID 32145830) — add-on, not replacement, for IS. GLUCOCORTICOID background/bridge with SSc RENAL-CRISIS CAUTION (prednisone-equiv >15 mg/day in dcSSc/RNA-pol-III+ is a precipitant). ANTI-MDA5 RP-ILD = combination high-dose GC + tacrolimus + IV CYC ± JAK-inhibitor ± plasmapheresis, time-critical (Tsuji 2020: 89% vs 33% 6-mo survival)inputs: autoantibody_panel_ctd, cbc, bmp_lftadvance: CTD-directed IS + antifibrotic add-on + steroid-caution + RP-ILD pathway documented
- 10DISPOSITIONAdmit (ICU) for anti-MDA5 RP-ILD, scleroderma renal crisis, or hypoxemic respiratory failure / acute exacerbation; outpatient rheumatology + pulmonology ILD co-clinic otherwise. Transplant referral for progressive disease refractory to IS + antifibrotic (ISHLT principles)advance: Disposition documented
- 11MONITORINGPFT (FVC/DLCO) q3–6 mo + HRCT + ambulatory desaturation per ACR/CHEST 2023 (PFT/HRCT/ambulatory-desaturation conditionally recommended for monitoring; 6MWD/CXR/bronchoscopy recommended against). Immunosuppression safety: CBC + LFT periodic, infection surveillance, PJP prophylaxis on high-dose/combination IS, CMV monitoring in anti-MDA5 RP-ILD combination IS (Tsuji 2020 — frequent CMV reactivation). SSc: BP + creatinine for renal crisis. Antifibrotic: LFT + GI tolerance (nintedanib). Re-assess PPF criteria each visitinputs: spirometry_dlco, bmp_lft, cbcadvance: Surveillance schedule + PPF re-assessment thresholds documented
- 12FOLLOWUPRheumatology + pulmonology ILD co-clinic q3–6 mo, PPF re-assessment driving antifibrotic add-on, transplant referral for progressive refractory disease, vaccination, pregnancy planning (switch off teratogenic CYC/MMF pre-conception), comorbidity sweep (PH-ILD, GERD-aspiration in SSc, lung-cancer surveillance), palliative integration for advanced disease (ACR/CHEST 2023)advance: Co-clinic + PPF loop + transplant + pregnancy + palliative plan booked