[BUG] Terminology validation errors & unresolved canonicals in PH Core IG v0.2.0 (from PR #332 and #333)

[niccoreyes]

Did you test the latest branch Main?

• Yes, I have tested on the latest main branch

Bug Description

The validation report for PH Core Implementation Guide v0.2.0 (from PR #332 and #333) shows major terminology validation errors and unresolved canonical references.

• HealthcareService resource errors:

  • HealthcareService.category.coding[0] and HealthcareService.type.coding[0] failed with Error: op.addIssueNoId is not a function (HL7 terminology server). This points to a terminology server bug or mis-specified CodeSystem/ValueSet references.
  • HealthcareService.identifier[0].system uses http://pgh.gov.ph/fhir/Identifier/service-id, which cannot be validated because the identifier system has no definition available.

• StructureDefinition issues:

  • Multiple ambiguous canonical references (e.g., patient-nationality, patient-religion) with both R4 and R5 versions available. Validator suggests pinning to a specific version (e.g., |5.3.0).
  • Slicing mismatches against http://hl7.org/fhir/StructureDefinition/obligation|5.3.0 for extensions in PH Core Patient profile.

• Other resource warnings:

  • Identifiers use local systems (e.g., http://my-hospital.org/internal-id, http://prc.gov.ph/fhir/Identifier/prc-license) that are not formally defined and cannot be validated.
  • Patient extensions reference local PSA classification URLs lacking published CodeSystem definitions (https://psa.gov.ph/classification/psced/level, etc.).

Bug Timeline

Occurred in v0.2.0 validation (see PRs #332, #333). Noticed during QA run.

Expected Behavior

The IG validates successfully, with all CodeSystem/ValueSet and canonical references resolvable/bindable without validator errors. No terminology server hard errors. Local or custom systems should be registered or properly defined.

Actual Behavior

Validation fails with hard errors on terminology binding for HealthcareService resources and ambiguous/unresolvable canonical references. IG cannot pass QA and is blocked from advancing.

Steps to Reproduce

1. Check out branch for PR [FR-U] Align Medication examples (#325) #332 or [FR-U] Align Procedure and ServiceRequest examples (#327) #333
2. Run IG build (./_genonce.sh or equivalent build command)
3. Review validation report (output/qa.html): terminology binding failures, unresolved canonical URLs, and slicing warnings/errors
4. See validator errors as described above

Version of IG

0.2.0 (as validated in PR #332/#333)

Additional Information & File Uploads

See output/qa.html validation report for details. Core issue: local/draft CodeSystems or ambiguous canonicals that HL7 validator cannot resolve or check. HealthcareService terminology server bug is blocking QA.