Implement canonical version matching for partial versions in FHIR validation

[Copilot]

This PR implements support for partial version matching in canonical URLs as per the FHIR specification, addressing the requirement to support version matching in IAsyncResourceResolver implementations.

Problem

The current implementation only supports exact version matching for canonical URLs. According to the FHIR canonical matching specification, partial version matching should be supported where "1.5" matches "1.5.0", "1.5.1", etc.

For example, this scenario would fail before this fix:

// Profile reference with partial version
var canonical = "http://fhir.abda.de/eRezeptAbgabedaten/StructureDefinition/DAV-PR-ERP-AbgabedatenBundle|1.5";
// Actual profile version in repository: "1.5.0"
var profile = resolver.ResolveByCanonicalUri(canonical); 
// Result: null (should find the 1.5.0 version)

Solution

This PR implements FHIR-compliant canonical version matching across all resolver implementations:

Modified Components

1. ArtifactSummaryExtensions.cs (Conformance & STU3 versions): Updated FindConformanceResources method to use a new MatchesVersion helper that implements FHIR-compliant canonical matching rules

2. InMemoryResourceResolver.cs: Enhanced ResolveByCanonicalUri method to support partial version matching for in-memory resolvers

3. Added comprehensive test coverage to verify both backward compatibility and new functionality

FHIR Canonical Matching Rules Implemented

• Exact matching: 1.5.0 matches exactly 1.5.0 (backward compatible)
• Partial matching: 1.5 matches 1.5.0, 1.5.1, 1.5.10, etc.
• Non-matching: 1.5 does not match 1.4.0, 1.6.0, or 2.5.0
• Empty version handling: Resources without versions only match queries without versions

Example Usage

// This will now work when profile has version "1.5.0"
var canonical = "http://example.org/StructureDefinition/MyProfile|1.5";
var profile = resolver.ResolveByCanonicalUri(canonical); // ✅ Resolves successfully

// Exact matching still works as before
var exactCanonical = "http://example.org/StructureDefinition/MyProfile|1.5.0";
var exactProfile = resolver.ResolveByCanonicalUri(exactCanonical); // ✅ Still works

Testing

• ✅ All existing tests continue to pass (backward compatibility preserved)
• ✅ New comprehensive test validates partial version matching works correctly
• ✅ Verified exact version matching still works as before
• ✅ Tested edge cases like non-matching versions return null
• ✅ Full solution builds successfully across all target frameworks

Backward Compatibility

This change is fully backward compatible. All existing exact version matching continues to work unchanged, while adding support for partial version matching as specified in the FHIR standard.

Fixes #3216.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.