How projecttacoma/fqm-execution works
fqm-execution is a library for evaluating FHIR eCQMs whose measure logic is supplied as ELM. Its main workflow accepts a Measure/Library bundle and patient Bundles, executes the CQL/ELM, and returns patient- and population-level results with detailed statements, clauses, and highlighted logic. Related APIs expose data requirements and query filters, gaps-in-care, and FHIR MeasureReports; ValueSet resolution and a CLI are also documented capabilities. The README and tree establish these capabilities, but sampled excerpts do not show the Calculator implementation’s internal call wiring, so those links are omitted.
Main entry points: Calculator.ts Calculator API · RetrievesHelper.ts Retrieve discovery · QueryFilterParser.ts Query info · ELMHelpers.ts ELM helpers
Components 19
Measure calculation
- Calculator API
src/calculation/Calculator.ts - CQL execution engine
- Execution support
src/execution/Execution.ts - Command-line interface
src/cli.ts
Measure analysis
- Data requirements
src/helpers/DataRequirementHelpers.ts - Retrieve discovery
src/helpers/elm/RetrievesHelper.ts - Query info
src/helpers/elm/QueryFilterParser.ts - ELM helpers
src/helpers/elm/ELMHelpers.ts - ELM dependencies
src/helpers/elm/ELMDependencyHelpers.ts
Results and reports
- Detailed results
src/calculation/DetailedResultsBuilder.ts - Clause results
src/calculation/ClauseResultsBuilder.ts - Gaps in care
src/calculation/GapsReportBuilder.ts - Measure reports
src/calculation/MeasureReportBuilder.ts - Composite reports
src/calculation/CompositeReportBuilder.ts - Logic highlighting
src/calculation/HTMLBuilder.ts
Terminology resolution
- ValueSet preparation
src/execution/ValueSetHelper.ts - ValueSet resolver
src/execution/ValueSetResolver.ts - VSAC service
Other components
- Library caller
Connections 12
- Library caller → Calculator API: calls calculation
- Calculator API → CQL execution engine: executes ELM
- Calculator API → Data requirements: calculates requirements
- Calculator API → Query info: calculates query info
- Calculator API → Gaps in care: calculates gaps
- Calculator API → Measure reports: builds reports
- Retrieve discovery → ELM helpers: finds clauses
- Retrieve discovery → ELM dependencies: resolves references
- Query info → ELM helpers: finds clauses
- Execution support → ValueSet preparation: prepares ValueSets
- ValueSet resolver → VSAC service: resolves remotely
- Command-line interface → Calculator API: invokes calculation