Clinical Commander

All dossiers
pulm.ctd-ild.v1

Connective-tissue-disease-associated ILD (CTD-ILD / IPAF)

pulmonologychronicsubacuteadultoutpatientinpatient

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)

  • history
    Known CTD (SSc/RA/IIM/Sjögren/MCTD/SLE) + new dyspnea / cough / PFT decline / HRCT change (ACR/CHEST 2023)
    known_ctd_with_new_respiratory_disease
  • imaging
    HRCT ILD pattern (NSIP > UIP; RA-ILD often UIP) in a patient with autoimmune features (ACR/CHEST 2023)
    hrct_ild_pattern
  • symptom
    Progressive exertional dyspnea + dry cough with extrapulmonary autoimmune features (ACR/CHEST 2023)
    progressive_exertional_dyspnea
  • lab_abnormality
    Newly discovered ILD + positive ANA/ENA/RF/CCP/myositis serology (IPAF — Fischer ERS/ATS 2015)
    positive_autoantibody_in_new_ild
  • symptom
    Acute hypoxemic ILD + amyopathic-DM skin signs (Gottron/heliotrope) — anti-MDA5 RP-ILD emergency (Tsuji 2020)
    rapidly_progressive_hypoxemic_ild

Required inputs (18)

  • agerequired
    demographic • used at CONTEXT
    CTD subtype distribution + immunosuppression/transplant candidacy (ACR/CHEST 2023)
  • sexrequired
    demographic • used at CONTEXT
    CTD epidemiology (female-predominant SSc/SLE/Sjögren); pregnancy status gates teratogenic IS (ACR/CHEST 2023)
  • pregnancy_statusrequired
    demographic • used at CONTEXT
    CYC + MMF are teratogenic/contraindicated in pregnancy — switch to pregnancy-compatible IS pre-conception (DailyMed MMF/CYC labels)
  • spo2_room_airrequired
    vital • used at CONTEXT
    Resting + ambulatory hypoxemia drives severity, O2, and RP-ILD recognition (ACR/CHEST 2023)
  • blood_pressurerequired
    vital • used at CONTEXT
    Accelerated/malignant HTN is the scleroderma renal crisis pivot — steroid is a precipitant (SSc subtype caution)
  • autoantibody_panel_ctdrequired
    lab • used at INITIAL_WORKUP
    ANA/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_aldolase
    lab • used at INITIAL_WORKUP
    Myopathy screen for IIM/anti-synthetase; anti-MDA5 DM is often amyopathic (normal CK) — do not exclude on normal CK
  • ferritin
    lab • used at INITIAL_WORKUP
    Markedly elevated ferritin is a poor-prognosis marker in anti-MDA5 RP-ILD (Tsuji 2020 PMID 31524333)
  • cbcrequired
    lab • used at INITIAL_WORKUP
    Pre-immunosuppression baseline; cytopenia screen (SLE); CYC/MMF myelosuppression (DailyMed labels)
  • bmp_lftrequired
    lab • used at INITIAL_WORKUP
    Renal crisis (SSc) creatinine + nintedanib/MMF/CYC hepatic-renal baseline + serial (DailyMed labels)
  • bnp
    lab • used at INITIAL_WORKUP
    SSc PH-ILD screen / cardiac involvement vs ILD-driven dyspnea (ACR/CHEST 2023)
  • hrctrequired
    imaging • used at INITIAL_WORKUP
    NSIP-vs-UIP pattern + extent (>20% extensive; Goh staging in SSc) is the central radiologic axis (ACR/CHEST 2023)
  • spirometry_dlcorequired
    imaging • used at INITIAL_WORKUP
    FVC + DLCO baseline + decline rate drive severity and PPF determination (ATS/ERS 2022 PPF)
  • ambulatory_desaturation_test
    imaging • used at INITIAL_WORKUP
    ACR/CHEST 2023 conditionally recommends ambulatory desaturation for MONITORING (not screening) of CTD-ILD
  • tte_for_ph
    imaging • used at BRANCHING_WORKUP
    Screen SSc PH-ILD (TRV, RV function); PH is a strong poor-prognosis modifier (ACR/CHEST 2023)
  • current_medsrequired
    medication • used at CONTEXT
    MTX-pneumotoxicity confounder in RA-ILD; amiodarone/ICI/nitrofurantoin drug-ILD differential; IS drug-interaction screen (ACR/CHEST 2023)
  • extrapulmonary_autoimmune_featuresrequired
    history • used at CONTEXT
    Raynaud, sicca, mechanic’s hands, Gottron/heliotrope, sclerodactyly, dysphagia, arthritis — clinical domain for which-CTD + IPAF (Fischer 2015)
  • occupational_environmental
    history • used at CONTEXT
    Antigen/asbestos exposure for HP/asbestosis differential when serology negative (ATS/JRS/ALAT 2020 HP)

12-phase flow (12)

  1. 1FRAME
    Adult 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_ctd
    advance: CTD-ILD/IPAF confirmed at MDD
  2. 2ENTRY
    Two 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, sex
    advance: Engine entered
  3. 3CONTEXT
    CTD 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_environmental
    advance: CTD + drug + pregnancy + BP context complete
  4. 4RED_FLAGS
    Anti-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, ferritin
    actions: ild_acute_exac
    advance: Emergency excluded or RP-ILD/renal-crisis pathway activated
  5. 5INITIAL_WORKUP
    HRCT (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 2023
    inputs: hrct, spirometry_dlco, autoantibody_panel_ctd, cbc, bmp_lft
    actions: panel.cbc, panel.lft, panel.renal
    advance: Stage-1 returned
  6. 6BRANCHING_WORKUP
    BAL 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_aldolase
    actions: ild_acute_exac, pulmonary_nodule
    advance: MDD complete (CTD-ILD/IPAF confirmed or routed to sibling engine)
  7. 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_features
    advance: CTD subtype + ILD pattern confirmed at MDD or routed to sibling engine
  8. 8RISK_STRATIFICATION
    Extent 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 treatment
    inputs: spirometry_dlco, hrct, autoantibody_panel_ctd
    actions: calc.mmrc
    advance: Extent + severity + decline-rate + PPF status documented
  9. 9TREATMENT
    TREAT 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_lft
    advance: CTD-directed IS + antifibrotic add-on + steroid-caution + RP-ILD pathway documented
  10. 10DISPOSITION
    Admit (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
  11. 11MONITORING
    PFT (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 visit
    inputs: spirometry_dlco, bmp_lft, cbc
    advance: Surveillance schedule + PPF re-assessment thresholds documented
  12. 12FOLLOWUP
    Rheumatology + 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