Conformance

octofhir-sof runs the official FHIR/sql-on-fhir.js v2.1 content-test suite (vendored under crates/octofhir-sof/tests/spec/). Both execution paths — the database-free in-memory evaluator and the generated PostgreSQL — pass the full suite:

TOTAL  144/144

The DuckDB SQL path is additionally verified through the duckdb CLI.

Running the suite

just conformance         # in-memory (no database)
just conformance-pg      # against PostgreSQL (needs Docker)
just conformance-duckdb  # against DuckDB (needs the `duckdb` CLI)
just conformance-report  # emit a result file for the sql-on-fhir.org registry

Refresh the vendored tests with just update-spec-tests.

The result file for the registry

sql-on-fhir.org aggregates a public registry of implementations; each entry points at a testResultsUrl whose document is keyed by test-file name with a tests array of { name, result: { passed, reason? } }. just conformance-report writes conformance-results.json in exactly that shape (set a custom path with out=results.json).

For the full result-file format and how to submit the OctoFHIR SoF entry to the implementation registry, see CONFORMANCE.md in the repository.