Support multiple template paths and matching

[AButler]

No description provided.

[Copilot]

Pull request overview

This PR improves OpenAPI path matching when multiple templated paths could match the same request path, aiming to choose the most specific template match and making the result independent of path-definition order. It also expands the test OpenAPI documents and adds regression tests around literal-vs-templated ambiguity.

Changes:

• Add a scoring mechanism to select the “best” matching templated path when more than one template matches a request path.
• Extend existing OpenAPI test data with additional overlapping templated/literal paths and add a reversed-definition-order variant.
• Add new response validation tests to cover the new ambiguous path scenarios.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
test/OpenApiValidate.Tests/TestData/LiteralAndTemplatedPathReversed.yaml	New test OpenAPI document with reversed path definition order to validate deterministic matching.
test/OpenApiValidate.Tests/TestData/LiteralAndTemplatedPath.yaml	Extend test OpenAPI document with additional overlapping role paths to exercise template specificity.
test/OpenApiValidate.Tests/ResponseValidatorTests.cs	Add regression tests validating DELETE matching for overlapping literal/templated role paths (including reversed spec order).
src/OpenApiValidate/Helpers/OpenApiExtensions.cs	Implement template “best match” selection logic for TryMatchPath and refactor template-segment detection.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.