Applies to stratifiers

[elsaperelli]

Summary

This PR does two things: fixes an error that was occurring when running calculateMeasureReports on measure bundles whose group.stratifiers did not have code.text and adds functionality in measure report calculation for stratifiers that have the cqfm-appliesTo extension.

New behavior

Measure report calculation no longer errors out with the measure bundle provided in the most recent fqm-execution issue- stratifiers are now either identified with s.code OR s.id. Additionally, if a stratifier has a cqfm-appliesTo extension, then only that associated population is included on the stratifier.population array in the MeasureReport. If the extension is not present, then the stratifier applies to all populations in the group. This specification is described in the CQFM Computable Measure Profile.

Code changes

• src/calculation/DetailedResultsBuilder.ts - use strata.id if strata.code.text does not exist
• src/calculation/MeasureReportBuilder.ts - use id when setting up the population groups in the Measure Report, add cqfm-appliesTo extension functionality
• test/unit/MeasureReportBuilder.test.ts - unit tests for stratifiers with cqfm-appliesTo
• test/unit/fixtures/measure/proportion-measure-with-stratifiers.json - test measure with stratifiers that have the cqfm-appliesTo extension

Testing guidance

• npm run check
• npm run test:integration & regression testing
• Run MeasureReports with the measure bundle and patient provided in the fqm-execution issue. There are a couple ways to do this, but I use the cli in the following command: npm run cli -- reports -m <measureBundle> -p <patientBundle> --debug -o -s 2025-01-01 -e 2025-12-31 --trust-meta-profile true

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟢	Statements	85.25% (+0.09% 🔼)	2405/2821
🟡	Branches	72.79% (-0.22% 🔻)	2253/3095
🟢	Functions	87.37% (-0.1% 🔻)	429/491
🟢	Lines	85.56% (+0.09% 🔼)	2323/2715

Show files with reduced coverage 🔻

St.❔	File	Statements	Branches	Functions	Lines
🟢	... / DetailedResultsBuilder.ts	87.74%	80% (-0.1% 🔻)	84.38%	87.98%

Test suite run success

454 tests passing in 31 suites.

Report generated by 🧪jest coverage report action from ccd7cd3

[hossenlopp]

Small change for report output.

I feel like this could use a test that adds results for two patients to make sure it properly makes use of the appliesTo (as we understand it now) and keeps with only having results for the single population on the stratifier output.

[lmd59]

Just a small comment!