GitVersion 7.0.0-beta.2
The second beta of GitVersion 7 is ready for testing. It restores Intel macOS support while retaining Apple Silicon packages.
Changes since beta.1
- Restore Intel macOS (
osx-x64) .NET tool packages and standalone archives alongside Apple Silicon (osx-arm64). #5490, #5491. - Update JsonSchema.Net to 9.7.0 and JsonSchema.Net.Generation to 7.5.0. #5487, #5488.
- Improve release README publication and refresh hosted CI runner images. #5485, #5486.
Before upgrading
This is a prerelease intended for evaluation. GitVersion 7 introduces breaking CLI, configuration and output changes. Read the v6-to-v7 migration guide and test against your repositories and CI pipelines before adopting it.
The .NET tool supports .NET 10 and .NET 11. Standalone archives include the .NET 10 runtime. Both Intel and Apple Silicon macOS distributions are included.
Install the exact beta in a separate directory:
dotnet tool install GitVersion.Tool --tool-path ./.gitversion-beta2 --version 7.0.0-beta.2Please report reproducible issues, including your configuration and representative Git history.
Consolidated v7 changelog
The following changes are tracked in the final 7.0.0 milestone. Build-only changes are excluded from the categorized list.
Breaking changes
- [ISSUE]: next-version must include tag-prefix (#5228)
- Discuss replacing dotted Azure Pipelines output variable names (#5219)
- v7.0: default to v7 parser, nested configuration and managed Git (#5135)
- Implement versioned calculation and output configuration (#5132)
- [Feature] Group configuration under calculation and output sections with migration support (#5131)
- Use the managed Git backend by default (#5039)
- Drop .NET 8 and .NET 9 target frameworks (end of support 2026-11-10) (#4997)
- Remove obsolete
CommitsSinceVersionSourceoutput variable (#4996) - Rename
PreReleaseTagandPreReleaseLabel(#4603) - [Improvement] Separate SemVerSource from CommitCountSource (#3041)
- New CLI (#2272)
Features
- [FEATURE]: Add privacy-preserving CLI usage telemetry (#5426)
- [Feature] Add a repository-independent config validate command for v7 (#5360)
- [Feature] Export an OpenCLI-compliant command description with --cli-schema (#5263)
- Query an individual effective configuration property (#5253)
- Use managed Git backend for package builds (#5175)
- feat: support regex tag exclusions (#5147)
- Add POSIX configuration migration and legacy-format warnings (#5133)
- [Feature] Support regex-based branch and tag exclusions in ignore configuration (#5130)
- feat(git): fully managed Git backend selectable via GITVERSION_GIT_BACKEND (#5084)
- feat: managed Git backend implements the Core abstractions behind GITVERSION_GIT_BACKEND (Phase B.5) (#5053)
- feat: managed Git backend implements the Core abstractions behind GITVERSION_GIT_BACKEND (Phase B.5) (#5051)
- feat: managed Git object store — loose objects, packfiles, multi-pack-index (Phase B.1) (#5043)
- GitVersion.Git adapter: managed reader behind the backend switch (Phase B.5) (#5037)
- Managed tree diff and working-tree status (Phase B.4) (#5036)
- Managed history traversal: revwalk and merge-base with libgit2 parity (Phase B.3) (#5035)
- Managed refs and repository discovery: packed-refs, worktrees, shallow (Phase B.2) (#5034)
- Managed Git object store: loose objects, packfiles, multi-pack-index (Phase B.1) (#5033)
- Git CLI backend for mutating and network operations (Phase A) (#5032)
- Add support for .NET 11 (#4998)
- Check if we can have dedicated package per os for dotnet 10 (#4899)
- Track migration to POSIX-style CLI arguments (#4844)
- [ISSUE]: Replace the custom ILog implementation with the standard Microsoft.Extensions.Logging.Abstractions with Serilog (#4742)
- [FEATURE]: Support of '=semver: none|minor|major|patch' bump message to suppress the version increment (#4144)
- [Feature] Include a value for an int version useful for Android ApplicationVersion (#3340)
- Version is not incrementing on develop after creating the release branch (#3149)
- Feature request : Generating PEP440 compliant versions (#2065)
- Add configuration param to define PreReleaseTag separator (#1674)
Bugs
- Restore Intel macOS (osx-x64) packages for GitVersion 7 (#5490)
- fix: deduplicate tool settings and stabilize docs builds (#5386)
- [Bug] Git CLI HTTP errors misclassified when URLs or paths contain status-code digits (#5365)
- fix(ci): exempt Mergify queue branches from linear history check (#5322)
- fix: resolve remaining SonarCloud assertion and VB template findings (#5320)
- fix: correct hotspot suppression and document Sonar false positives (#5318)
- fix: resolve SonarCloud new-code findings (#5316)
- Version calculation performs one revision walk per version tag (O(tags x commits)) (#5245)
- fix(deps): add dedicated Polly update group (#5242)
- [ISSUE]:
masterconfig key has undocumented breaking changes when upgrading from v5 (#5074) - fix(new-cli): repair new-cli build broken by the dedup refactor (missing ILogger using) (#5060)
- fix(git): unescape git config values in managed backend (Windows remote URL parity) (#5059)
- fix(git): managed status-calculator parity with libgit2 (symlinks, eol, global excludes) (#5058)
- [ISSUE]: Gitlab CI remote ref detection for tags failing (#4825)
- [ISSUE] Incorrect output for assembly-informational-version (#4654)
- [ISSUE]: GitVersion crashes in GitHub Actions when an action is dispatched on a tag (#4212)
- [Bug] -c is only used if -diag is also enabled (#3297)
- [Bug] Closing pull request from hotfix to support failed to inherit Increment branch configuration (#3020)
- [Bug] options /c and /verbosity don't have any effect (#2435)
Improvements
- Complete .NET 11 GA adoption and compatibility validation (#5394)
- perf: avoid per-byte allocations in random access stream (#5389)
- refactor: simplify Git process capture on .NET 11 (#5383)
- refactor: separate executor configuration display and tool execution (#5323)
- fix: support non-root Docker images and artifact tests (#5315)
- Evaluate .NET 11 SDK, runtime and BCL improvements (#5210)
- Modernize selected code using C# 12–14 features (#5208)
- perf(ci): reduce validation time (#5153)
- Order configuration properties alphabetically (#5151)
- refactor: resolve configuration once per execution (#5150)
- next/v7 (#5083)
- refactor(git): internalize LibGit2Sharp extensions, add ICommitish, fix cache key (#5073)
- Migrate GitVersion.Testing fixtures to git CLI writes (Phase D) (#5038)
- Use the environment variable GIT_BRANCH as the current branch everywhere (#3954)
- Enable support for {Sha} and {ShortSha} variables inside tag property (#3035)
Dependencies
- (deps): Bump JsonSchema.Net.Generation in /src (#5488)
- (deps): Bump JsonSchema.Net in /src (#5487)
- (build deps): bump reviewdog/action-actionlint from 1.84.0 to 1.84.1 in /.github/workflows in the reviewdog group across 1 directory (#5475)
- (deps): Bump AngleSharp in /build (#5471)
- (deps): Bump Microsoft.CodeAnalysis.Analyzers and 2 others (#5470)
- (deps): Bump PolySharp in /new-cli (#5466)
- (docs deps): bump mermaid from 12.2.0 to 12.3.0 (#5462)
- (docs deps): bump jsdom from 30.1.3 to 31.0.0 (#5461)
- (deps): Bump the microsoft group with 12 updates (#5458)
- build: exempt SDK and Microsoft packages from Dependabot cooldown (#5457)
- (deps): Bump the microsoft group with 1 update (#5456)
- (docker deps): bump dotnet/sdk from
212fe4cto65f3c7cin /.devcontainer in the docker group across 1 directory (#5455) - (deps): Bump Scriban in /new-cli (#5452)
- (devcontainer deps): bump ghcr.io/devcontainers/features/powershell from 2.0.3 to 2.0.4 in the devcontainers group (#5449)
- (build deps): bump the reviewdog group across 1 directory with 2 updates (#5446)
- (build deps): bump step-security/harden-runner from 2.22.3 to 2.22.4 in /.github/workflows (#5442)
- (deps): Bump SharpYaml in /src (#5439)
- (deps): Bump Polly across 2 directories (#5438)
- (build deps): bump the codeql group across 1 directory with 3 updates (#5437)
- (build deps): bump actions/setup-dotnet from 6.0.0 to 6.1.0 in /.github/workflows in the actions group across 1 directory (#5434)
- fix: patch vulnerable npm documentation dependencies (#5429)
- (deps): Bump JsonSchema.Net in /src (#5427)
- (deps): Bump JunitXml.TestLogger in /src (#5417)
- (sdk): bump dotnet-sdk from 11.0.100-rc.2.26504.105 to 11.0.100-rc.3.26522.148 (#5413)
- (docs deps): bump undici (#5409)
- build: fix remaining Scorecard dependency vulnerabilities (#5404)
- (docs deps): bump dompurify from 3.4.16 to 3.4.17 (#5402)
- build: update Mermaid to resolve vulnerable KaTeX (#5401)
- (deps): Bump JsonSchema.Net.Generation in /src (#5378)
- (build deps): bump actions/create-github-app-token from 3.2.0 to 3.3.0 in /.github/workflows in the actions group across 1 directory (#5364)
- (deps): bump MSBuild.ProjectCreation from 19.1.4 to 20.0.0 (#5358)
- (build): exclude Microsoft packages from Dependabot catch-all (#5348)
- (build): group Microsoft Dependabot updates (#5335)
- (build deps): bump ossf/scorecard-action from 2.4.4 to 2.5.0 in /.github/workflows (#5328)
- (deps): Bump NUnit3TestAdapter across 2 directories (#5303)
- (build deps): bump the actions group across 1 directory with 2 updates (#5301)
- (devcontainer deps): bump ghcr.io/devcontainers/features/common-utils from 2.7.0 to 2.7.1 in the devcontainers group (#5297)
- (devcontainer deps): bump ghcr.io/devcontainers/features/docker-in-docker from 4.1.2 to 4.1.3 in the devcontainers group (#5292)
- (docs deps): bump http-cache-semantics from 4.1.1 to 4.3.0 (#5289)
- (build): Remove redundant analyzer dependency group (#5283)
- (deps): Bump the roslynator group with 2 updates (#5280)
- (build): Group Roslynator dependency updates (#5278)
- (deps): Bump NUnit from 4.6.1 to 5.0.0 (#5270)
- (deps): Bump the other-dependencies group with 3 updates (#5269)
- (docs deps): bump brace-expansion from 1.1.18 to 1.1.21 (#5265)
- fix(ci): unblock dependency configuration PRs (#5260)
- (devcontainer deps): bump the devcontainers group with 2 updates (#5254)
- fix(deps): group all NuGet updates across directories (#5239)
- (build deps): bump codecov/codecov-action from 7.1.0 to 7.1.1 in /.github/workflows (#5234)
- (deps): Bump Cake.Frosting from 6.2.0 to 6.3.0 (#5229)
- (docs deps): bump js-yaml from 4.3.1 to 4.3.2 (#5214)
- (deps): Bump the analyzers group with 1 update (#5212)
- fix(devcontainer): pin feature versions for Dependabot (#5172)
- chore(dependabot): group NUnit3TestAdapter updates by name (#5169)
- (deps): Bump Cake.Json from 8.0.0 to 11.0.0 (#5166)
- (deps): Bump the microsoft group with 3 updates (#5129)
- (deps): Bump NSubstitute from 6.1.0 to 6.2.0 (#5122)
- (build deps): Bump actions/stale from 10.4.0 to 11.0.0 in /.github/workflows in the actions group across 1 directory (#5099)
- (deps): Bump LibGit2Sharp from 0.31.0 to 0.32.0 (#5097)
- (deps): Bump Serilog from 4.3.0 to 4.4.0 (#5086)
- (build deps): bump actions/checkout from 7.0.0 to 7.0.1 in /.github/workflows in the actions group across 1 directory (#5079)
Documentation
- docs: fix agent instruction heading hierarchy (#5477)
- docs: remove calculation source fingerprint review gate (#5390)
- docs: add v7 agent onboarding guide and setup toolbar (#5362)
- docs: resolve remaining CSS important findings (#5359)
- docs: resolve CSS important findings with scoped overrides (#5357)
- docs: clarify non-root Docker migration and usage (#5355)
- Keep version-calculation documentation aligned with the v7 algorithm (#5300)
- Convert inline links to reference links across all documentation and enforce the style (#5224)
- Improve documentation navigation and version clarity (#5187)
- docs: add SnapX to Using Section (#5165)
- Publish v7 configuration schemas and migration guidance (#5134)
- Replace PlantUML documentation diagrams with Mermaid (#5108)
- docs(migration): document GITVERSION_GIT_BACKEND and v7 env vars in the v6→v7 guide (#5065)
- [Docs] Document TrunkBased flow (#3915)
Contributors
Thanks to @aloisklink, @arturcic, @asbjornu, @BrycensRanch, @diegosasw, @flikkes, @franknarf8, @HHobeck, @judgeaxl, @kalmykov-sergey, @MarvinZacher, @MeisterBob, @micdenny, @mk185147, @mouradchama, @phatcher, @rdanilin and everyone who reported issues and tested prereleases.