Dotnetup: add env command to update PathPreference mode

src/Installer/dotnetup.Library/Commands/Env/EnvClearCommand.cs

@@ -0,0 +1,39 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System.CommandLine;
+using Microsoft.DotNet.Tools.Bootstrapper.Shell;
+
+namespace Microsoft.DotNet.Tools.Bootstrapper.Commands.Env;
+
+/// <summary>
+/// Fully removes everything dotnetup wrote into the environment: equivalent to
+/// <c>env set none --dotnetup-on-path false</c>. Removes the managed profile block and the
+/// dotnetup PATH entry, leaving no dotnet access and no dotnetup-on-PATH. The closest thing
+/// to an "env uninstall" since dotnetup has no uninstall command.
+/// </summary>
+internal class EnvClearCommand : CommandBase
+{
+    private readonly IDotnetEnvironmentManager _dotnetEnvironment;
+    private readonly IEnvironmentStateInspector _inspector;
+    private readonly IEnvShellProvider? _shellProvider;
+
+    public EnvClearCommand(ParseResult result, IDotnetEnvironmentManager? dotnetEnvironment = null, IEnvironmentStateInspector? inspector = null) : base(result)
+    {
+        _dotnetEnvironment = dotnetEnvironment ?? new DotnetEnvironmentManager();
+        _inspector = inspector ?? new EnvironmentStateInspector(_dotnetEnvironment);
+        _shellProvider = result.GetValue(CommonOptions.ShellOption);
+    }
+
+    protected override string GetCommandName() => "env clear";
+
+    protected override void ExecuteCore()
+    {
+        EnvSettingsWriter.ApplyAndPersist(
+            DotnetAccessMode.None,
+            targetDotnetupOnPath: false,
+            _dotnetEnvironment,
+            _shellProvider,
+            _inspector);
+    }
+}

src/Installer/dotnetup.Library/Commands/Env/EnvClearCommandParser.cs

@@ -0,0 +1,17 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System.CommandLine;
+
+namespace Microsoft.DotNet.Tools.Bootstrapper.Commands.Env;
+
+internal static class EnvClearCommandParser
+{
+    public static Command ConstructCommand()
+    {
+        Command command = new("clear", "Remove all dotnetup environment wiring (equivalent to 'env set none --dotnetup-on-path false').");
+        command.Options.Add(CommonOptions.ShellOption);
+        command.SetAction(parseResult => new EnvClearCommand(parseResult).Execute());
+        return command;
+    }
+}

src/Installer/dotnetup.Library/Commands/Env/EnvCommandParser.cs

@@ -0,0 +1,26 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System.CommandLine;
+
+namespace Microsoft.DotNet.Tools.Bootstrapper.Commands.Env;
+
+internal static class EnvCommandParser
+{
+    private static readonly Command s_envCommand = ConstructCommand();
+
+    public static Command GetCommand() => s_envCommand;
+
+    private static Command ConstructCommand()
+    {
+        Command command = new("env", "Manage the dotnetup environment configuration (PATH and DOTNET_ROOT wiring).");
+
+        command.Subcommands.Add(EnvSetCommandParser.ConstructCommand());
+        command.Subcommands.Add(EnvClearCommandParser.ConstructCommand());
+        command.Subcommands.Add(EnvShowCommandParser.ConstructCommand());
+        command.Subcommands.Add(EnvScriptCommandParser.ConstructCommand(name: "script"));
+
+        return command;
+    }
+}
+

src/Installer/dotnetup.Library/Commands/Env/EnvDriftAnalyzer.cs

@@ -0,0 +1,68 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System.Globalization;
+
+namespace Microsoft.DotNet.Tools.Bootstrapper.Commands.Env;
+
+/// <summary>
+/// Pure comparison of the configured env settings against an observed environment snapshot,
+/// producing human-readable drift descriptions. Kept free of any environment reads (the
+/// <see cref="EnvironmentStateInspector"/> does those) so it can be unit-tested without touching
+/// the registry or shell profiles. Used by <see cref="EnvShowCommand"/>.
+/// </summary>
+internal static class EnvDriftAnalyzer
+{
+    public static IReadOnlyList<string> Compare(DotnetupConfigData config, ObservedEnvironmentState observed)
+    {
+        ArgumentNullException.ThrowIfNull(config);
+        ArgumentNullException.ThrowIfNull(observed);
+
+        var drift = new List<string>();
+
+        bool expectsProfileDotnet = config.AccessMode is DotnetAccessMode.Shell or DotnetAccessMode.All;
+        bool expectsProfileBlock = expectsProfileDotnet || config.DotnetupOnPath;
+        bool expectsDotnetEnvVars = config.AccessMode == DotnetAccessMode.All;
+
+        // Profile-block presence: only assert when the profile state is known.
+        if (observed.ProfileBlockPresent is bool profileBlockPresent)
+        {
+            if (expectsProfileBlock && !profileBlockPresent)
+            {
+                drift.Add("Shell profile is missing the dotnetup managed block.");
+            }
+            else if (!expectsProfileBlock && profileBlockPresent)
+            {
+                drift.Add("Shell profile contains a dotnetup managed block but neither dotnet access nor dotnetup-on-PATH is configured.");
+            }
+        }
+
+        if (OperatingSystem.IsWindows())
+        {
+            if (expectsDotnetEnvVars && !observed.DotnetUserEnvVarsComplete)
+            {
+                drift.Add("Windows user PATH / DOTNET_ROOT / system PATH do not match 'all' mode expectations.");
+            }
+            else if (!expectsDotnetEnvVars && observed.DotnetUserEnvVarsPresent)
+            {
+                drift.Add(string.Format(
+                    CultureInfo.InvariantCulture,
+                    "Windows user PATH / DOTNET_ROOT still has 'all'-mode wiring (expected dotnet access: '{0}').",
+                    config.AccessMode.ToString().ToLowerInvariant()));
+            }
+
+            // The user-scope PATH is authoritative for dotnetup-on-PATH on Windows (the profile
+            // block copy is just a convenience).
+            if (config.DotnetupOnPath && !observed.DotnetupOnUserPath)
+            {
+                drift.Add("dotnetup is configured to be on PATH but is missing from the user PATH.");
+            }
+            else if (!config.DotnetupOnPath && observed.DotnetupOnUserPath)
+            {
+                drift.Add("dotnetup is on the user PATH but is configured to be off.");
+            }
+        }
+
+        return drift;
+    }
+}