Function IsCompatible

pkg/semverutil/semverutil.go:162–183

IsCompatible reports whether pinVersion is semver-compatible with requestedVersion. Semver compatibility is defined as both versions sharing the same major version. Examples: - IsCompatible("v5.0.0", "v5") → true - IsCompatible("v5.1.0", "v5.0.0") → true - IsCompatible("v6.0.0", "v5") → false

(pinVersion, requestedVersion string)

//   - IsCompatible("v5.1.0", "v5.0.0") → true
//   - IsCompatible("v6.0.0", "v5")    → false
func IsCompatible(pinVersion, requestedVersion string) bool {
	pinVersion = EnsureVPrefix(pinVersion)
	requestedVersion = EnsureVPrefix(requestedVersion)

	// Guard: both versions must be valid semver before comparing majors.
	// semver.Major returns "" for invalid input, causing "" == "" to
	// incorrectly report two invalid versions as compatible.
	if !IsValid(pinVersion) || !IsValid(requestedVersion) {
		semverLog.Printf("IsCompatible: one or both versions are invalid: pin=%s, requested=%s",
			pinVersion, requestedVersion)
		return false
	}

	pinMajor := semver.Major(pinVersion)
	requestedMajor := semver.Major(requestedVersion)

	compatible := pinMajor == requestedMajor
	semverLog.Printf("Checking semver compatibility: pin=%s (major=%s), requested=%s (major=%s) -> %v",
		pinVersion, pinMajor, requestedVersion, requestedMajor, compatible)

	return compatible
}