Improve fallout-migrate: NuGet-scoped version pin, TFM warning/bump, confirmation prompt, async pipeline by dennisdoomen · Pull Request #509 · Fallout-build/Fallout

dennisdoomen · 2026-07-18T12:21:08Z

Summary

A set of focused improvements to fallout-migrate: pin the migrated Fallout.Common reference to the latest NuGet release instead of the running tool's own version, warn and optionally bump an outdated build-project TFM, ask for confirmation before writing files, and convert the migration pipeline to async.

Changes

Bump Fallout.Migrate to the 10.x version line — version bump.

Resolve Fallout.Common version from NuGet, scoped to the tool's own major — ResolveFalloutVersionStep now queries NuGet's flat-container index for the latest non-prerelease Fallout.Common release matching the running tool's own major (calendar year), instead of only reading the tool's own AssemblyInformationalVersion. Falls back to the tool's own version when NuGet can't be reached or has no matching-major stable release yet.

Warn when the build project targets an older TFM than .NET 10 — VerifyBuildTargetFrameworkStep reads _build.csproj's TargetFramework(s) and warns for any moniker older than net10.0.

Ask for confirmation before the migration writes any files — ConfirmMigrationStep prompts via AnsiConsole.Confirm immediately before the first file-mutating step. Declining sets Summary.Cancelled and stops the pipeline. Skipped for --dry-run and when stdin is redirected.

Fold CsprojRewriter into RewriteCsprojsStep — CsprojRewriter.Rewrite had a single caller; merged directly into the step.

Bump build project to net10.0 and global.json SDK to 10.0.100 — BumpDotNetVersionStep rewrites _build.csproj's TargetFramework and global.json's sdk.version when either is behind the minimum, leaving already-current or newer values untouched. Build projects don't multi-target, so only the singular TargetFramework element is matched.

Make IMigrationStep and the migration pipeline asynchronous — IMigrationStep.Execute is now Task ExecuteAsync; replaces the blocking GetAsync(...).GetAwaiter().GetResult() in ResolveFalloutVersionStep with a proper await.

Deduplicate the TFM-minimum check shared by two migration steps — extract the modern-moniker regex and minimum-check logic duplicated between BumpDotNetVersionStep and VerifyBuildTargetFrameworkStep into a shared TargetFrameworkMonikers helper.

Reorder ResolveFalloutVersionStep by invocation order and tag NuGet requests — reorder private methods to match invocation order; add a User-Agent header to the NuGet flat-container HttpClient so requests aren't sent as anonymous script traffic.

Combined effect

fallout-migrate now pins migrated references to a real, published Fallout.Common release, flags/fixes an outdated build-project TFM, confirms before mutating files, and runs its pipeline asynchronously.

Migration.Run() hard-coded four migration actions as private methods sharing private helpers, making it awkward to add the steps planned next. Split into: - Common/ -- MigrationContext (plain data), Summary, RewriteResult, IMigrationStep, and MigrationFileOperations (shared EnumerateFiles / ApplyRewrite / RelativePath helpers) - Steps/ -- one class per step (ResolveFalloutVersionStep, RewriteCsprojsStep, RewriteCsFilesStep, RewriteBootstrapScriptsStep, RenameNukeDirectoryStep), each paired with the rewriter it drives (CsprojRewriter, CodeRewriter, ScriptRewriter) Migration.Run() now just builds a MigrationContext and iterates a fixed, ordered step list. Adding a future step is one new class plus one line in that list. No behavior change; MigrationIntegrationSpecs pass unchanged. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Replace the plain Console.WriteLine calls in MigrateCommand's banner and summary printing with Spectre.Console's AnsiConsole: bold banner, yellow dry-run notice and warnings, green completion messages, dimmed guide link. Interpolated values (paths, warning text) go through MarkupLineInterpolated so user-controlled content can't be misinterpreted as markup. Left Console.Error.WriteLine for the two error messages (stderr semantics matter for piping/exit codes) and the TextWriter-based per-file/per-rename logging in the Steps/Common classes untouched -- that log stays plain text so MigrationIntegrationSpecs can keep capturing it via TextWriter.Null without a console. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

…ajor ResolveFalloutVersionStep now queries NuGet's flat-container index for the latest non-prerelease Fallout.Common release matching the running tool's own major (calendar year), instead of only reading the tool's own AssemblyInformationalVersion. This keeps a migration pinned to what's actually installable without jumping to a newer, potentially breaking yearly major the tool wasn't built against. Falls back to the tool's own version when NuGet can't be reached or has no matching-major stable release yet, and logs via AnsiConsole which path was taken so the resolved version is never a silent guess. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Fallout's tooling is built and tested against .NET 10; a build project still on an older TFM can hit tool incompatibilities that this migration's other, purely textual rewrites won't catch. VerifyBuildTargetFrameworkStep reads _build.csproj's TargetFramework(s) and adds a warning for any moniker that isn't a modern net10.0+ (catching net8.0, net48, netstandard2.0, netcoreapp3.1, etc.). Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

ConfirmMigrationStep runs immediately before RewriteCsprojsStep, the first step that mutates files, and prompts via AnsiConsole.Confirm before letting the migration proceed. Declining sets the new Summary.Cancelled flag, which Migration.Run checks to stop executing further steps, and MigrateCommand returns exit code 1 without printing the (now meaningless) summary. The prompt is skipped for --dry-run (nothing would be written) and when stdin is redirected (CI, piped input, automated tests) since there's nothing to prompt against. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

CsprojRewriter.Rewrite had a single caller (RewriteCsprojsStep). Move its regex fields and Rewrite method directly into the step and delete the now-empty class. Rename the spec file/class to match. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Add BumpDotNetVersionStep: rewrites _build.csproj's TargetFramework(s) to net10.0 and global.json's sdk.version to 10.0.100 during migration, matching the versions Fallout's own tooling targets. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

IT-VBFK · 2026-07-18T13:53:06Z

+    {
+        try
+        {
+            using HttpResponseMessage response = httpClient.GetAsync(FlatContainerIndex).GetAwaiter().GetResult();


Can this be "real async" here?

Yeah, was thinking about that as well.

BumpDotNetVersionStep previously overwrote any TargetFramework/SDK version that wasn't an exact match, including newer ones. Now it compares against the minimum (net10.0 / 10.0.100) and leaves anything already at or above it untouched. Multi-targeting bumps only the monikers that are behind. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Build projects don't multi-target, so only match the singular TargetFramework element instead of splitting/rejoining a TargetFrameworks list. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

MinimumSupportedMajor (10) had to be kept in sync by hand with TargetFramework (net10.0). Parse it from the constant instead so there's a single source of truth. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Replace the blocking GetAsync(...).GetAwaiter().GetResult() in ResolveFalloutVersionStep with a proper await. IMigrationStep.Execute is now Task ExecuteAsync; Migration.Run is Migration.RunAsync; MigrateCommand is now an AsyncCommand<MigrateSettings>; Program.Main awaits CommandApp.RunAsync. ConfirmMigrationStep now awaits ConfirmationPrompt.ShowAsync instead of the blocking AnsiConsole.Confirm. Steps with no async work simply return Task.CompletedTask. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

…nvocation order, tag NuGet requests Extract the modern-moniker regex and IsOlderThanMinimumSupported logic duplicated between BumpDotNetVersionStep and VerifyBuildTargetFrameworkStep into a shared TargetFrameworkMonikers helper. VerifyBuildTargetFrameworkStep now reads BumpDotNetVersionStep.MinimumSupportedMajor instead of maintaining its own separate constant. Reorder ResolveFalloutVersionStep's private methods to match the order they're invoked from ExecuteAsync (assembly, then major, then NuGet). Add a User-Agent header to the NuGet flat-container HttpClient so requests aren't sent as anonymous script traffic. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

ChrisonSimtian

some small things :-)

ChrisonSimtian · 2026-07-19T12:58:34Z

probably something that could move a bit closer to the core instead of sitting in this satellite. Looks useful :-)

ChrisonSimtian · 2026-07-19T13:00:34Z

+    /// <summary>
+    /// The version to fall back to when the assembly carries no build-metadata suffix.
+    /// </summary>
    private const string Fallback = "10.3.49";


how do we remember to bump this with a new release?
Should this be more central? collection of constants somewhere grouped together as a one-stop-shop maybe?

ChrisonSimtian · 2026-07-19T13:01:46Z

+
    /// <inheritdoc />
-    public void Execute(MigrationContext context, Summary summary)
+    public async Task ExecuteAsync(MigrationContext context, Summary summary)


no CancellationToken?

ChrisonSimtian · 2026-07-19T13:01:56Z

+        string localVersion = ResolveFromAssembly();
+        int localMajor = ExtractMajor(localVersion);
+
+        string nuGetVersion = await ResolveFromNuGetAsync(localMajor);


no CancellationToken?

ChrisonSimtian · 2026-07-19T13:02:27Z

+    /// <param name="major">The major version (calendar year) to restrict the lookup to.</param>
+    /// <returns>The latest published stable version within <paramref name="major"/>, or <c>null</c>
+    /// if NuGet couldn't be reached or has no matching-major stable version.</returns>
+    private static async Task<string> ResolveFromNuGetAsync(int major)


no CancellationToken?

ChrisonSimtian · 2026-07-19T13:02:59Z

+    {
+        try
+        {
+            using HttpResponseMessage response = await httpClient.GetAsync(FlatContainerIndex);


pretty sure this one lets us pass through a token, mind having a look at that and passing it all the way through if so?

ChrisonSimtian · 2026-07-19T13:04:24Z

+    /// script traffic.
+    /// </summary>
+    /// <returns>A configured <see cref="HttpClient"/>.</returns>
+    private static HttpClient CreateHttpClient()


nit: can we make this a factory instead?

dennisdoomen and others added 6 commits July 18, 2026 13:29

Bump Fallout.Migrate to the 10.x version line

67cb799

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

dennisdoomen added enhancement New feature or request target/vCurrent Targets the current version labels Jul 18, 2026

dennisdoomen and others added 2 commits July 18, 2026 14:26

IT-VBFK reviewed Jul 18, 2026

View reviewed changes

dennisdoomen and others added 5 commits July 19, 2026 08:55

Drop multi-targeting handling from BumpDotNetVersionStep

7735145

Build projects don't multi-target, so only match the singular TargetFramework element instead of splitting/rejoining a TargetFrameworks list. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

dennisdoomen changed the title ~~Improve fallout-migrate: NuGet-scoped version pin, TFM warning, confirmation prompt~~ Improve fallout-migrate: NuGet-scoped version pin, TFM warning/bump, confirmation prompt, async pipeline Jul 19, 2026

ChrisonSimtian reviewed Jul 19, 2026

View reviewed changes

dennisdoomen force-pushed the migrate-ansiconsole-output branch from 38d0437 to 8affb45 Compare July 19, 2026 15:14

Base automatically changed from migrate-ansiconsole-output to main July 19, 2026 15:28

dennisdoomen marked this pull request as ready for review July 19, 2026 18:12

dennisdoomen requested a review from a team as a code owner July 19, 2026 18:12

Uh oh!

Uh oh!

Conversation

dennisdoomen commented Jul 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Combined effect

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ChrisonSimtian left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

dennisdoomen commented Jul 18, 2026 •

edited

Loading