Add boundary-aware suffix fallback for git checkout ref resolution

[soimkim]

Description

When exact, v-prefix, and semver matching all fail, fall back to finding refs that end with the input version string at a separator boundary (-, _, /, .). This allows e.g. input "stable202002" to match branch "edk2-stable202002" while preventing false positives like input "2" matching ref "3.02".

Summary by CodeRabbit

• Bug Fixes
  • Improved version reference resolution with enhanced fallback matching when standard methods fail
  • Now supports case-insensitive partial matching for greater reliability in locating requested versions
  • Prioritizes most specific matches when multiple candidates qualify

[coderabbitai]

📝 Walkthrough

Walkthrough

This change extends the checkout base resolution logic with a case-insensitive partial matching fallback. When exact ref and semver-based resolution strategies fail, the code now scans available refs for suffix matches constrained by separator boundaries, selects the shortest match, and returns it with the clarified version.

Changes

Checkout Base Resolution Enhancement

Layer / File(s)	Summary
Partial match fallback implementation src/fosslight_util/download.py	Added fallback logic in _try_resolve_checkout_base() that performs case-insensitive suffix matching on refs at separator boundaries, selects the shortest match, logs it as "Partial match", and returns the matched ref with clarified version.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Add boundary-aware suffix fallback for git checkout ref resolution' directly and specifically describes the main change: adding a new fallback mechanism with boundary awareness to the git checkout ref resolution logic.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch ver

---

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 and usage tips.}