Add unit tests for versionHeightOffsetAppliesTo functionality

Co-authored-by: AArnott <[email protected]>

Author: Copilot

test/Nerdbank.GitVersioning.Tests/ReleaseManagerTests.cs

@@ -703,6 +703,47 @@ public void PrepareRelease_WithCustomCommitMessagePattern(string initialVersion,
         Assert.Equal(expectedCommitMessage, releaseBranchCommit.MessageShort);
     }
 
+    [Fact]
+    public void PrepareRelease_ResetsVersionHeightOffsetAppliesTo()
+    {
+        // create and configure repository
+        this.InitializeSourceControl();
+
+        var initialVersionOptions = new VersionOptions()
+        {
+            Version = SemanticVersion.Parse("1.0-beta"),
+            VersionHeightOffset = 5,
+            VersionHeightOffsetAppliesTo = SemanticVersion.Parse("1.0-beta"),
+        };
+
+        var expectedReleaseVersionOptions = new VersionOptions()
+        {
+            Version = SemanticVersion.Parse("1.0"),
+            VersionHeightOffset = 5,
+            VersionHeightOffsetAppliesTo = SemanticVersion.Parse("1.0-beta"),
+        };
+
+        var expectedMainVersionOptions = new VersionOptions()
+        {
+            Version = SemanticVersion.Parse("1.1-alpha"),
+        };
+
+        // create version.json
+        this.WriteVersionFile(initialVersionOptions);
+
+        Commit tipBeforePrepareRelease = this.LibGit2Repository.Head.Tip;
+
+        var releaseManager = new ReleaseManager();
+        releaseManager.PrepareRelease(this.RepoPath);
+
+        this.SetContextToHead();
+        VersionOptions newVersion = this.Context.VersionFile.GetVersion();
+        Assert.Equal(expectedMainVersionOptions, newVersion);
+
+        VersionOptions releaseVersion = this.GetVersionOptions(committish: this.LibGit2Repository.Branches["v1.0"].Tip.Sha);
+        Assert.Equal(expectedReleaseVersionOptions, releaseVersion);
+    }
+
     /// <inheritdoc/>
     protected override void InitializeSourceControl(bool withInitialCommit = true)
     {

test/Nerdbank.GitVersioning.Tests/VersionOracleTests.cs

@@ -219,6 +219,63 @@ public void HeightInBuildMetadata()
         Assert.Equal(2, oracle.VersionHeightOffset);
     }
 
+    [Fact]
+    public void VersionHeightOffsetAppliesTo_Matching()
+    {
+        // When VersionHeightOffsetAppliesTo matches the current version, the offset should be applied
+        VersionOptions workingCopyVersion = new VersionOptions
+        {
+            Version = SemanticVersion.Parse("7.8.9-beta"),
+            VersionHeightOffset = 5,
+            VersionHeightOffsetAppliesTo = SemanticVersion.Parse("7.8.9-beta"),
+        };
+        this.WriteVersionFile(workingCopyVersion);
+        this.InitializeSourceControl();
+        var oracle = new VersionOracle(this.Context);
+
+        // The offset should be applied because the version matches
+        Assert.Equal(5, oracle.VersionHeightOffset);
+        Assert.Equal(1, oracle.VersionHeight);
+    }
+
+    [Fact]
+    public void VersionHeightOffsetAppliesTo_NotMatching()
+    {
+        // When VersionHeightOffsetAppliesTo doesn't match the current version, the offset should NOT be applied
+        VersionOptions workingCopyVersion = new VersionOptions
+        {
+            Version = SemanticVersion.Parse("7.9-beta"),
+            VersionHeightOffset = 5,
+            VersionHeightOffsetAppliesTo = SemanticVersion.Parse("7.8-beta"),
+        };
+        this.WriteVersionFile(workingCopyVersion);
+        this.InitializeSourceControl();
+        var oracle = new VersionOracle(this.Context);
+
+        // The offset should NOT be applied because the version changed (7.8 -> 7.9)
+        Assert.Equal(0, oracle.VersionHeightOffset);
+        Assert.Equal(1, oracle.VersionHeight);
+    }
+
+    [Fact]
+    public void VersionHeightOffsetAppliesTo_BuildNumberChange()
+    {
+        // When VersionHeightOffsetAppliesTo has a different build number, the offset should NOT be applied
+        VersionOptions workingCopyVersion = new VersionOptions
+        {
+            Version = SemanticVersion.Parse("7.9-beta"),
+            VersionHeightOffset = 5,
+            VersionHeightOffsetAppliesTo = SemanticVersion.Parse("7.8-beta"),
+        };
+        this.WriteVersionFile(workingCopyVersion);
+        this.InitializeSourceControl();
+        var oracle = new VersionOracle(this.Context);
+
+        // The offset should NOT be applied because the minor version changed (7.8 -> 7.9)
+        Assert.Equal(0, oracle.VersionHeightOffset);
+        Assert.Equal(1, oracle.VersionHeight);
+    }
+
     [Theory]
     [InlineData("7.8.9-foo.25", "7.8.9-foo-0025")]
     [InlineData("7.8.9-foo.25s", "7.8.9-foo-25s")]