dotnetup: classify PATH dotnet by managed hive; fix env config doc

[dsplaisted]

Follow-up to #54545 addressing review feedback (especially #54545 (comment)). Also includes improvement to some wording I noticed when testing.

Copilot description:

Changes

1. Classify the PATH dotnet by "is it a dotnetup-managed hive?" (not system vs user)

GetCurrentPathConfiguration previously returned an InstallType (User/System) derived from IsAdminInstallPath. But the consumers actually need to know whether the dotnet winning on PATH is a hive dotnetup owns — something it may run or uninstall from. Under the old axis, a dotnet that merely lives in a user-writable location (e.g. a hand-extracted C:\dotnet on PATH) was labeled User, so dotnetup dotnet and dotnetup uninstall (without --install-path) would run or target an install dotnetup does not own.

• DotnetInstallRootConfiguration.InstallType → bool IsDotnetupHive.
• IsDotnetupHive is true only when the resolved root is dotnetup's managed hive (today, the default install path; configurable hives tracked in dotnetup: Support custom dotnet roots #55346).
• Consumers realigned: DotnetCommand / UninstallWorkflow act on the configured path only when it's the hive; InitWorkflows uses InstallPathClassifier.IsAdminInstallPath directly where it genuinely needs "is this a system install?"; install telemetry records the existing install's location bucket via ClassifyInstallPath.
• Tests updated to the hive semantics, plus a new test locking in that an unmanaged user install falls back to the default hive.

Behavior change: dotnetup dotnet / uninstall no longer act on a non-managed dotnet that happens to win on PATH; they fall back to the managed hive.

2. Doc fix: DotnetAccessMode legacy spellings are not accepted

The dotnetup env design doc claimed the JSON converter accepts legacy spellings (full / fullpathreplacement). It does not — DotnetAccessModeJsonConverter is a plain camel-case string-enum converter (integer values rejected), and unrecognized values are treated as a corrupt config that re-defaults on next write. Corrected the doc to match the code and the rest of the doc.

Testing

Built dotnetup.Tests (Release); the affected UninstallWorkflowTests and DotnetCommandTests pass (23/23).

[azure-pipelines]

Azure Pipelines:
Successfully started running 2 pipeline(s).
1 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

[Copilot]

Pull request overview

This PR refines dotnetup’s notion of the dotnet that wins on PATH to distinguish dotnetup-managed hives from arbitrary user-writable installs, preventing dotnetup dotnet/uninstall from acting on installs it does not own. It also aligns documentation with actual DotnetAccessMode JSON parsing behavior and updates a user-facing env message (with localization updates).

Changes:

• Replaces InstallType (User/System) classification from GetCurrentPathConfiguration with IsDotnetupHive and realigns DotnetCommand, UninstallWorkflow, and InitWorkflows accordingly.
• Updates telemetry for “existing install type” to use InstallPathClassifier.ClassifyInstallPath buckets.
• Updates tests and documentation; adjusts one env-related user-facing string and propagates it to XLFs.

Reviewed changes

Copilot reviewed 23 out of 23 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
test/dotnetup.Tests/UninstallWorkflowTests.cs	Updates uninstall path-resolution tests to reflect “dotnetup hive vs not” semantics and adds a regression test for unmanaged user installs.
test/dotnetup.Tests/DotnetCommandTests.cs	Updates dotnetup dotnet tests to gate use of the PATH-resolved root on IsDotnetupHive.
src/Installer/dotnetup.Library/xlf/Strings.zh-Hant.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.zh-Hans.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.tr.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.ru.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.pt-BR.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.pl.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.ko.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.ja.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.it.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.fr.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.es.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.de.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/xlf/Strings.cs.xlf	Updates localized resource unit for the changed env message.
src/Installer/dotnetup.Library/Strings.resx	Updates the source string shown after env changes so it’s clearer that restarts are required for other terminals/apps.
src/Installer/dotnetup.Library/IDotnetEnvironmentManager.cs	Updates the contract to return DotnetInstallRootConfiguration with IsDotnetupHive and adds clarifying XML docs.
src/Installer/dotnetup.Library/DotnetEnvironmentManager.cs	Implements hive classification by comparing the PATH-resolved root to the default dotnetup install path.
src/Installer/dotnetup.Library/Commands/Shared/UninstallWorkflow.cs	Ensures uninstall only targets the PATH-resolved root when it’s a dotnetup-managed hive.
src/Installer/dotnetup.Library/Commands/Shared/InstallWorkflow.cs	Records “existing install type” telemetry using path classification buckets rather than InstallType.
src/Installer/dotnetup.Library/Commands/Init/InitWorkflows.cs	Restores explicit “is system/admin install” checks where that’s the real requirement (migration display).
src/Installer/dotnetup.Library/Commands/Dotnet/DotnetCommand.cs	Ensures dotnetup dotnet only uses the PATH-resolved root when it’s the managed hive.
documentation/general/dotnetup/designs/dotnetup-env.md	Corrects the design doc to match actual JSON converter behavior (legacy spellings are not accepted).