v10.4.0

[ChrisonSimtian]

v10.4

It has been a while since we released a new version and we've been cooking a bit in the background, going from me being the sole maintainer and contributor to onboarding new people into this project and revitalising the Nuke or rather now the Fallout community with new life.
First of all, thanks to those who have decided to come forward and partake in keeping the vision of Nuke alive! And welcome to those who are brave enough to migrate their projects from Nuke to Fallout.
With this long awaited release, we're bringing you mostly stabilisation, long awaited PR merges and minor improvements, while we're preparing the architectural structure to move Fallout into a new future.

Please let us know if anything is missing, broken or not quite working as intended. The easiest way to do so is to create an issue here on Github.

What's Changed

✨ New Features

• Add project-scoped skill for restructuring PR commit history by @dennisdoomen in Add project-scoped skill for restructuring PR commit history #416
• Adds a public Env property to GitHubActionsAttribute by @avidenic in Adds a public Env property to GitHubActionsAttribute #417
• Use different ansi escape code for yellow on gitlab by @ITaluone in Use different ansi escape code for yellow on gitlab #390
• Emit custom runs-on label arrays for self-hosted runners ([GitHubActions] generator: custom runs-on label arrays for self-hosted runners #387) by @avidenic in Emit custom runs-on label arrays for self-hosted runners (#387) #418
• Control the shell for run steps via DefaultShell by @avidenic in Control the shell for run steps via DefaultShell #430
• Allow arbitrary extra with: inputs on the checkout step of [GitHubActions] by @avidenic in Allow arbitrary extra with: inputs on the checkout step of [GitHubActions] #431
• Allow UTF-8 console input by @ITaluone in Allow UTF-8 console input #425
• Support for Windows not on the C drive by @ITaluone in Support for Windows not on the C drive #462
• Properly implement FancyNames feature for solution generator by @ITaluone in Properly implement FancyNames feature for solution generator #455
• Add ClickOnce settings definition for MSBuild by @ITaluone in Add ClickOnce settings definition for MSBuild #466
• Add .slnx support in GlobalTool's setup by @ITaluone in Add .slnx support in GlobalTool's setup #461
• [GitHubActions] generator: typed workflow_dispatch inputs (string, boolean, number, choice, environment) by @avidenic in [GitHubActions] generator: typed workflow_dispatch inputs (string, boolean, number, choice, environment) #440
• Support git worktrees by @ITaluone in Support git worktrees #465
• Emit build-graph.json for editor tooling by @ChrisonSimtian in Emit build-graph.json for editor tooling #486
• Add a typed step-injection pipeline to the GitHub Actions generator by @avidenic in Add a typed step-injection pipeline to the GitHub Actions generator #475
• Add XmlAdd extension to XmlTasks by @ITaluone in Add XmlAdd extension to XmlTasks #489
• Add missing ArtifactsPath property to dotnet restore by @IT-VBFK in Add missing ArtifactsPath property to dotnet restore #506
• Add tool definition for cmake by @IT-VBFK in Add tool definition for cmake #504
• Add SetBinaryLog support to DotNetPackSettings by @IT-VBFK in Add SetBinaryLog support to DotNetPackSettings #502
• Add tool wrapper definition for Stryker by @IT-VBFK in Add tool wrapper definition for Stryker #503
• Improve fallout-migrate: NuGet-scoped version pin, TFM warning/bump, confirmation prompt, async pipeline by @dennisdoomen in Improve fallout-migrate: NuGet-scoped version pin, TFM warning/bump, confirmation prompt, async pipeline #509

🐛 Bug Fixes

• Handle numeric fields in GitVersion 6.x JSON output (GitVersion parsing fails with error #218) by @dennisdoomen in Handle numeric fields in GitVersion 6.x JSON output (#218) #222
• Re-brand the mermaid execution plan (--plan) by @ITaluone in Re-brand the mermaid execution plan (--plan) #382
• Fix CS1734 warning in TransitionShimGenerator attribute XML doc by @SonnyRR in Fix CS1734 warning in TransitionShimGenerator attribute XML doc #415
• Fix errors/warnings for pre-existing code smells after reintroducing editorconfig et al by @ChrisonSimtian in Fix errors/warnings for pre-existing code smells after reintroducing editorconfig et al #393
• Fix MSBuild tool resolve for VS2026 by @ITaluone in Fix MSBuild tool resolve for VS2026 #420
• Handle missing changelog (sections) during pack by @dennisdoomen in Handle missing changelog (sections) during pack #433
• Fix Pack when CHANGELOG.md is missing by @dennisdoomen in Fix Pack when CHANGELOG.md is missing #437
• Relax DotNetTasks diagnostic ID log level patterns to reduce false negatives by @taiscrummaster in Relax DotNetTasks diagnostic ID log level patterns to reduce false negatives #467
• Treat lower case npm warn also as warning by @ITaluone in Treat lower case npm warn also as warning #463
• Fix bug, where a string stated as content is handled like a path by @ITaluone in Fix bug, where a string stated as content is handled like a path #490
• Escape single quotes correctly in YAML CI writers by @YousifSala7 in Escape single quotes correctly in YAML CI writers #493
• Fix crash when git branch config has a duplicate key by @dennisdoomen in Fix crash when git branch config has a duplicate key #511
• Promote main onto the 10.4 release line and fix release version stamping by @ChrisonSimtian in Promote main onto the 10.4 release line and fix release version stamping #563
• Make the workflow_dispatch publish path actually publish by @ChrisonSimtian in Make the workflow_dispatch publish path actually publish #566
• Point the nuget-org environment at the real nuget.org profile by @ChrisonSimtian in Point the nuget-org environment at the real nuget.org profile #569
• Cherry-pick the Fallout.Common.ProjectModel migration path onto 10.4 by @ChrisonSimtian in Cherry-pick the Fallout.Common.ProjectModel migration path onto 10.4 #590
• Cherry-pick the Fallout.GlobalTool package id onto 10.4 by @ChrisonSimtian in Cherry-pick the Fallout.GlobalTool package id onto 10.4 #593
• [Backport/10.4]: Add an additional type converter for System.Text.Json by @ITaluone in [Backport/10.4]: Add an additional type converter for System.Text.Json #611

📖 Documentation

• chore(release)!: bump version.json 10.3 → 11.0 + add semver policy to CLAUDE.md by @ChrisonSimtian in chore(release)!: bump version.json 10.3 → 11.0 + add semver policy to CLAUDE.md #220
• docs(agents): adopt AGENTS.md as canonical AI brief; restructure into TOC + sub-files by @ChrisonSimtian in docs(agents): adopt AGENTS.md as canonical AI brief; restructure into TOC + sub-files #247
• docs(agents): release-branch model + branch-protection policy for release/vN by @ChrisonSimtian in docs(agents): release-branch model + branch-protection policy for release/vN #278
• docs: release-branch model — CONTRIBUTING + branching-and-release runbook + ADR by @ChrisonSimtian in docs: release-branch model — CONTRIBUTING + branching-and-release runbook + ADR #295
• docs: adopt calendar versioning + dual-pace edge/stable channels (ADR-0004) by @ChrisonSimtian in docs: adopt calendar versioning + dual-pace edge/stable channels (ADR-0004) #301
• docs(experimental): establish [Experimental] API convention + FALLOUT0xx registry by @ChrisonSimtian in docs(experimental): establish [Experimental] API convention + FALLOUT0xx registry #316
• docs: align CONTRIBUTING/README/roadmap with CalVer + dual-pace channels (ADR-0004) by @ChrisonSimtian in docs: align CONTRIBUTING/README/roadmap with CalVer + dual-pace channels (ADR-0004) #317
• docs: correct edge version shape to the as-built NB.GV form by @ChrisonSimtian in docs: correct edge version shape to the as-built NB.GV form #319
• Fix remaining stale ChrisonSimtian repo URLs missed by Update all ChrisonSimtian/Fallout URLs to Fallout-build org #379 by @ChrisonSimtian in Fix remaining stale ChrisonSimtian repo URLs missed by #379 #412
• Replace remaining nuke command text with fallout by @dennisdoomen in Replace remaining nuke command text with fallout #424
• Add obsolete-APIs diagnostic-ID registry (FALLOUTOBS0xx) by @avidenic in Add obsolete-APIs diagnostic-ID registry (FALLOUTOBS0xx) #472
• Make release.yml the PR-label source of truth; label PRs at creation by @ChrisonSimtian in Make release.yml the PR-label source of truth; label PRs at creation #480
• Drop gh-pages from ADR-0008 steady-state branches by @ChrisonSimtian in Drop gh-pages from ADR-0008 steady-state branches #484
• Align docs on evergreen target/vCurrent + target/vNext labels by @ChrisonSimtian in Align docs on evergreen target/vCurrent + target/vNext labels #485

New Contributors

• @SonnyRR made their first contribution in Fix CS1734 warning in TransitionShimGenerator attribute XML doc #415
• @avidenic made their first contribution in Adds a public Env property to GitHubActionsAttribute #417
• @taiscrummaster made their first contribution in Relax DotNetTasks diagnostic ID log level patterns to reduce false negatives #467
• @JSap0914 made their first contribution in Fix ADR AGENTS.md docs link #468
• @GeorgDangl made their first contribution in Fix typo in tool installation command #494

Full Changelog: 10.3.47...v10.4.0

---

⚠️ Breaking Changes since v10.3

Solution, SolutionAttribute, Project, and the solution-graph extension methods moved from Fallout.Common.ProjectModel to Fallout.Solutions.

A transition shim re-exports Solution and SolutionAttribute, so this keeps compiling unchanged:

using Fallout.Common.ProjectModel;

[Solution] readonly Solution Solution;

The shim covers the common case only. It does not cover Project or the extension methods. A build that reads the project graph — Solution.GetProject(…), Solution.AllProjects — fails to compile:

error CS0246: The type or namespace name 'Project' could not be found

Fix it with fallout-migrate, which rewrites the namespace and everything else the rename touched:

dotnet tool install -g Fallout.Migrate --version 10.4.0
fallout-migrate <path-to-your-repo>

fallout-migrate is not only for moving from NUKE to Fallout. It also handles upgrades between Fallout versions. If you prefer to do it by hand, the change is one line: using Fallout.Common.ProjectModel; becomes using Fallout.Solutions;.

See #619 for the full analysis.

Security

This release resolves five high-severity advisories in System.Security.Cryptography.Xml. 10.4.0 depends on the patched 10.0.10; 10.3.x pinned 10.0.6. If you migrated a repo while on 10.3.x and hit NU1903 on restore, upgrading to 10.4.0 clears it. See #618.

Global tool package id

The tool ships as Fallout.GlobalTool — the same id 10.3.x consumers already pin, so dotnet tool update reaches 10.4.0 with no manifest edit.

Fallout.GlobalTools (plural) existed briefly at 10.4.0-rc.4 and is now unlisted and deprecated. If you installed from it, switch back:

dotnet tool uninstall -g Fallout.GlobalTools
dotnet tool install -g Fallout.GlobalTool

See #575.

---

This discussion was created from the release v10.4.0.