Expose VersionSourceIncrement property in output variables

[Copilot]

Adds VersionSourceIncrement to GitVersion output variables, exposing which increment strategy (None, Patch, Minor, Major) was used for the next version calculation.

Core pipeline

• Added VersionSourceIncrement (VersionField) to SemanticVersionBuildMetaData, propagated through copy constructor
• NextVersionCalculator.FindVersion() extracts increment from BaseVersion.Operator.Increment and sets it on final BuildMetaData
• Threaded through SemanticVersionFormatValues → VariableProvider → GitVersionVariables

Output & serialization

• Added to VersionVariablesJsonModel with JsonPropertyDescription
• Fixed VersionVariableSerializer.FromDictionary to use SingleOrDefault instead of Single for backward compatibility with cached JSON missing new fields

MSBuild integration

• Added [Output] VersionSourceIncrement to GetVersion task
• Added output binding and DefineConstants entry in .targets

Docs & API surface

• Updated variables.md with JSON example and description table entry
• Updated PublicAPI.Unshipped.txt for both GitVersion.Core and GitVersion.MsBuild

Test updates

• Updated all approved snapshot files (Core JSON, cs/fs/vb GitVersionInfo, Wix)
• Added VersionSourceIncrement to versionCacheFileContent in GitVersionExecutorTests

{
  "Major": 3,
  "Minor": 22,
  "Patch": 11,
  "VersionSourceIncrement": "Minor",
  "SemVer": "3.22.11-beta.99"
}

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Expose the VersionSourceIncrement property in output variables</issue_title>
<issue_description>The VersionSourceIncrement property gives the information about which increment has been used for the next version calculation. Possible values are:

• None
• Patch
• Minor
• Major

Originally posted by @HHobeck in #4803 (reply in thread)</issue_description>

<agent_instructions>Make sure the new Output property in GitVersion variables is included in the docs as well as in the tests</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes Expose the VersionSourceIncrement property in output variables #4814

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[Copilot]

Pull request overview

Adds a new VersionSourceIncrement output variable to GitVersion so consumers can see which increment strategy (None, Patch, Minor, Major) was used during next-version calculation, and threads it through JSON/MSBuild output + docs + snapshots.

Changes:

• Propagates VersionSourceIncrement from version calculation (NextVersionCalculator) through format values/variable provider into GitVersionVariables.
• Exposes the variable via JSON output model and MSBuild task/targets integration.
• Updates docs and approved snapshot outputs to include the new variable.

Reviewed changes

Copilot reviewed 37 out of 37 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/GitVersion.Core/SemVer/SemanticVersionBuildMetaData.cs	Adds VersionSourceIncrement to build metadata + copy ctor propagation.
src/GitVersion.Core/VersionCalculation/VersionCalculators/NextVersionCalculator.cs	Extracts increment strategy from base version and attaches it to final build metadata.
src/GitVersion.Core/VersionCalculation/SemanticVersioning/SemanticVersionFormatValues.cs	Exposes VersionSourceIncrement as a formatted value.
src/GitVersion.Core/VersionCalculation/VariableProvider.cs	Threads the new formatted value into GitVersionVariables.
src/GitVersion.Core/OutputVariables/GitVersionVariables.cs	Adds VersionSourceIncrement variable (but also changes record primary ctor ordering).
src/GitVersion.Output/Serializer/VersionVariablesJsonModel.cs	Adds VersionSourceIncrement to JSON model for serialized output.
src/GitVersion.MsBuild/Tasks/GetVersion.cs	Adds MSBuild task output property VersionSourceIncrement.
src/GitVersion.MsBuild/msbuild/tools/GitVersion.MsBuild.targets	Binds the new output to MSBuild properties/WiX constants (contains a define-constant typo).
src/GitVersion.Core/PublicAPI.Unshipped.txt	Records new public API surface for core outputs/format values/build metadata.
src/GitVersion.MsBuild/PublicAPI.Unshipped.txt	Records new public API surface for MSBuild task output.
src/GitVersion.Core.Tests/Core/GitVersionExecutorTests.cs	Updates version-cache JSON test content to include new field.
src/GitVersion.Core.Tests/Helpers/TestableGitVersionVariables.cs	Updates test helper to include new variable in construction.
src/GitVersion.Core.Tests/VersionCalculation/Approved/*.approved.txt	Updates approved JSON snapshots to include VersionSourceIncrement.
src/GitVersion.Output.Tests/Output/Approved/cs/*.approved.txt	Updates approved C# GitVersionInfo output snapshots.
src/GitVersion.Output.Tests/Output/Approved/fs/*.approved.txt	Updates approved F# GitVersionInfo output snapshots.
src/GitVersion.Output.Tests/Output/Approved/vb/*.approved.txt	Updates approved VB GitVersionInfo output snapshots.
src/GitVersion.Output.Tests/Output/Approved/WixFileTests.*.approved.txt	Updates approved WiX defines snapshots.
docs/input/docs/reference/variables.md	Documents the new output variable and updates JSON example/table.
docs/input/docs/reference/version-increments.md	Updates conventional-commits reference link.
docs/input/docs/reference/configuration.md	Updates conventional-commits reference link.
docs/input/docs/reference/mdsource/configuration.source.md	Updates conventional-commits reference link.
docs/input/docs/reference/build-servers/teamcity.md	Removes a “Guides” link section.
build/common/Utilities/Models.cs	Adjusts build-metadata null handling in build utilities.
build/common/Addins/GitVersion/GitVersionAliases.cs	Minor alias API/documentation tweak.
build/common/Addins/GitVersion/GitVersion.cs	Updates build addin GitVersion model to include new output + refreshed docs/types.

[Copilot]

Pull request overview

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

[Copilot]

Pull request overview

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

[arturcic]

@HHobeck please have a look on the changes Copilot did and please make sure the GitVersion variable is properly set