(GH-4696) Update GitVersion.Tool to 6.5.1 and migrate configuration

- Update GitVersion.Tool from 5.12.0 to 6.5.1
- Migrate GitVersion.yml configuration for v6.0.0+ compatibility:
  * Rename 'tag' property to 'label' (breaking change in v6.0.0)
  * Update deployment modes: ContinuousDelivery->ManualDeployment for master, ContinuousDeployment→ContinuousDelivery for develop
  * Remove deprecated properties: prevent-increment-of-merged-branch-version and track-merge-target
  * Add prevent-increment.when-current-commit-tagged for develop branch
  * Add explicit regex patterns for branch matching
- Reconstruct LegacySemVerPadded format removed in GitVersion 6.0.0:
  * Add GetLegacySemVerPadded helper method to maintain backward compatibility
  * Format: {MajorMinorPatch}-{PreReleaseLabel}{PreReleaseNumber:D4}
  * Example: 6.1.0-alpha0041
- fixes #4696

Author: devlead

GitVersion.yml

@@ -1,18 +1,17 @@
 next-version: 6.0.0
 branches:
-  master:
-    regex: main
-    mode: ContinuousDelivery
-    tag:
+  main:
+    regex: ^main$
+    mode: ManualDeployment
+    label: null
     increment: Patch
-    prevent-increment-of-merged-branch-version: true
-    track-merge-target: false
   develop:
-    mode: ContinuousDeployment
-    tag: alpha
+    regex: ^develop$
+    mode: ContinuousDelivery
+    label: alpha
     increment: Minor
-    prevent-increment-of-merged-branch-version: false
-    track-merge-target: true
+    prevent-increment:
+      when-current-commit-tagged: false
 ignore:
   sha:
     - 2a4757b270f7946122ba6622e3d2e72b2b2808a7

build.cake

@@ -2,7 +2,7 @@
 #addin "nuget:https://api.nuget.org/v3/index.json?package=Cake.Twitter&version=5.0.0"
 
 // Install .NET Core Global tools.
-#tool "dotnet:https://api.nuget.org/v3/index.json?package=GitVersion.Tool&version=5.12.0"
+#tool "dotnet:https://api.nuget.org/v3/index.json?package=GitVersion.Tool&version=6.5.1"
 #tool "dotnet:https://api.nuget.org/v3/index.json?package=GitReleaseManager.Tool&version=0.20.0"
 #tool "dotnet:https://api.nuget.org/v3/index.json?package=sign&version=0.9.1-beta.25379.1&prerelease"
 

build/version.cake

@@ -44,7 +44,11 @@ public record BuildVersion(
                 });
 
                 version = context.EnvironmentVariable("GitVersion_MajorMinorPatch");
-                semVersion = context.EnvironmentVariable("GitVersion_LegacySemVerPadded");
+                var preReleaseNumberStr = context.EnvironmentVariable("GitVersion_PreReleaseNumber");
+                semVersion = GetLegacySemVerPadded(
+                    context.EnvironmentVariable("GitVersion_MajorMinorPatch"),
+                    context.EnvironmentVariable("GitVersion_PreReleaseLabel"),
+                    !string.IsNullOrEmpty(preReleaseNumberStr) && int.TryParse(preReleaseNumberStr, out int num) ? num : (int?)null);
                 milestone = string.Concat("v", version);
             }
 
@@ -58,7 +62,10 @@ public record BuildVersion(
             });
 
             version = assertedVersions.MajorMinorPatch;
-            semVersion = assertedVersions.LegacySemVerPadded;
+            semVersion = GetLegacySemVerPadded(
+                assertedVersions.MajorMinorPatch,
+                assertedVersions.PreReleaseLabel,
+                assertedVersions.PreReleaseNumber);
             milestone = string.Concat("v", version);
             branchName = assertedVersions.BranchName;
 
@@ -87,6 +94,28 @@ public record BuildVersion(
         );
     }
 
+    /// <summary>
+    /// Constructs the LegacySemVerPadded format that was removed in GitVersion 6.0.0.
+    /// Format: {MajorMinorPatch}-{PreReleaseLabel}{PreReleaseNumber:D4}
+    /// Example: 6.1.0-alpha-0041
+    /// </summary>
+    private static string GetLegacySemVerPadded(string majorMinorPatch, string preReleaseLabel, int? preReleaseNumber)
+    {
+        if (string.IsNullOrEmpty(majorMinorPatch))
+        {
+            return string.Empty;
+        }
+
+        // If no pre-release label or number, return just the version
+        if (string.IsNullOrEmpty(preReleaseLabel) || !preReleaseNumber.HasValue)
+        {
+            return majorMinorPatch;
+        }
+
+        // Format with 4-digit padding
+        return $"{majorMinorPatch}-{preReleaseLabel}{preReleaseNumber.Value:D4}";
+    }
+
     public static string ReadSolutionInfoVersion(ICakeContext context)
     {
         var solutionInfo = context.ParseAssemblyInfo("./src/SolutionInfo.cs");