Align Questionnaire Catalog with Grove FHIR

[PSchmiedmayer]

♻️ Current situation & Problem

The Questionnaire catalog predates the current Grove FHIR contract. Its localized resources use obsolete profile metadata, nonstandard context coding, legacy Quantity extensions, and structural defaults that no longer validate cleanly. The catalog also has no executable guarantee that English and Spanish definitions preserve the same canonical and answer contract or that Grove can import and export every Questionnaire.

Localized instruments were also published as separate resources under one url|version, which the Grove FHIR contract (SchmiedmayerLab/grove-fhir#42) now forbids: one instrument is one multilingual Questionnaire.

⚙️ Release Notes

• Align all 28 localized Questionnaires with the Grove Questionnaire profile and stable My Heart Counts canonical URLs.
• Declare every Questionnaire active, version 0.1.0, with the standard semantic-version algorithm.
• Replace legacy fixed-unit and numeric-bound extensions with questionnaire-unitOption and the SDC Quantity bounds.
• Correct usage-context and item-control coding, remove invalid page controls, duplicate nested element ids, empty metadata, and redundant default flags.
• Pin Grove 050ba883b2fdea6a91d93d2405e4121ca9a736cf (Disable lowered deployment targets by default Grove#116), including the FHIR APIs and standard deployment targets, while the coordinated repositories land.
• Export one multilingual Questionnaire per instrument: the en-US base with es-US translation extensions, merged from the per-locale sources, which stay the authoring format.
• Localize the Spanish HeartRisk units and vital-signs category, and drop the WHO-5 test Markdown that showed English copy to Spanish participants.
• Build the Linux leg with --build-system native until Swift 6.4.x ships the fix for [SwiftBuild] Dependencies of conditionally excluded deps get compiled swiftlang/swift-package-manager#10538.
• Add Grove Questionnaire import/export dependencies to the test target only.
• Bump studyRevision from 44 to 48.

📚 Documentation

The validated Questionnaire resources remain the authoritative catalog. The README describes the per-locale sources, the multilingual export, and the rule that any translation change needs a new version.

✅ Testing

• swift test passes, including Grove diagnostics, import, and export for every localized Questionnaire.
• Contract tests verify canonical uniqueness, profile, version, status, semantic-version metadata, item hierarchy, fixed Quantity semantics, and English/Spanish parity.
• Strict SwiftLint passes with no violations.
• The deterministic Grove Questionnaire validator passes all 28 resources.
• The official HL7 FHIR Validator accepts all 28 resources against the current Grove Questionnaire package.
• Against Grove 66f0a88e and grove-fhir 9c5eff4: 8 tests pass on macOS and on Linux (native build system); the export yields 14 merged Questionnaires whose every translation matches its source, and grove-fhir's paired and official validators accept them together with an English HeartRisk and a Spanish GAD-7 response.

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.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 7b7682be-107f-4bfb-8d75-1844cf162d75

---

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.}