Publish SensorKit Recordings as FHIR Observations

[PSchmiedmayer]

♻️ Current situation & Problem

SensorKit recordings had no FHIR representation at all, so sensor data could not be exported alongside the HealthKit and questionnaire resources Grove already publishes.

⚙️ Release Notes

• Adds GroveSensorKitFHIR, which publishes SensorKit recordings as FHIR Observations conforming to the profiles the guides define.
• Sensor batches are carried as a document with a compressed archive, so a recording round-trips without inflating the resource.
• Sample identity is hashed so the same recording maps to a stable identifier across exports.

📚 Documentation

The new module documents which sensors map to which observation shapes, and how a batch archive is laid out.

✅ Testing

• GroveSensorKit on iOS: 3 suites, covering the observation mapping, the batch archive, and the existing SensorKit behaviour.
• The module is added to the iOS test matrix, the all-platform test plan, and the conformance fixture run.

Code of Conduct & Contributing Guidelines

By creating and submitting this pull request, you agree to follow our Code of Conduct and Contributing Guidelines:

• I agree to follow the Code of Conduct and Contributing Guidelines.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 56e3c579-bab1-47de-aa5f-953b7ffb7905

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[PSchmiedmayer]

This implementation should be preserved, but its contract target is changing. grove-fhir #10 now tracks the platform-neutral model for coded sensor events, bounded waveforms, multichannel samples, significant-location/device-usage summaries, and large raw recordings.

Before this PR is treated as the final conformant SensorKit layer, it should be restacked/reworked against the accepted generalized shapes rather than the provisional SensorKit-specific profiles. The existing mappings, archive utilities, identifiers, tests, and fixtures remain valuable implementation evidence. The design also needs parity with the actual My Heart Counts workload: ECG/PPG, accelerometer and other raw series, DocumentReference plus summary relationships, study context, and location/device-usage privacy.

This deliberately keeps the PR available while #10 is resolved; it is not a request to discard the branch, merge it now, or change any runner assignment.

[PSchmiedmayer]

Superseded by #69, which rewrites this work on the catalog-driven converter and the published v0.2 profiles. Sensor coverage, stable output identity, metadata-key handling and device provenance all carry over; the vocabulary is now sourced from the grove-fhir catalogs with a CI drift check rather than a golden dump in this repo.