Add version management commands (check, list, update)

[jfversluis]

Summary

Ports functionality from jfversluis/maui-version into the maui CLI as subcommands of maui version.

New Commands

Command	Description
maui version check	Show installed MAUI package versions in a project, resolve $(MauiVersion)
maui version list	Query available versions from stable or nightly NuGet feeds
maui version update --latest	Update to latest stable (sets $(MauiVersion))
maui version update --latest-nightly	Switch to latest nightly build
maui version update --version <v>	Install a specific version (e.g. from a PR build)

Examples

# Check what version your project uses
maui version check

# List available nightly versions
maui version list --channel nightly

# Switch to nightly + set up NuGet.config
maui version update --latest-nightly --nuget-config

# Install a specific PR build version
maui version update --version 10.0.0-preview.5.25180.1

# Preview changes without modifying files
maui version update --latest --dry-run

Implementation

• NuGetVersionService: Queries nuget.org (stable) and maui-nightly AzDO feed using NuGet.Protocol
• ProjectVersionService: Parses csproj XML, replaces package versions, runs dotnet restore, manages NuGet.config
• Follows existing patterns: partial class command groups (like AndroidCommands), IOutputFormatter for JSON/Spectre output, global --json/--dry-run support
• maui version (bare) still shows CLI version info as before

Dependencies

• Adds NuGet.Protocol 6.13.1 to the CLI project

Tests

All 119 existing tests pass. New service tests to follow.

[Copilot]

Pull request overview

Adds maui version subcommands to the CLI to inspect and manage .NET MAUI package versions in a project, including querying NuGet feeds and updating project references.

Changes:

• Introduces maui version check, maui version list, and maui version update commands under a new VersionCommands command group.
• Adds NuGetVersionService (NuGet feed querying) and ProjectVersionService (project parsing/updating + dotnet operations).
• Updates CLI docs and central package management to include NuGet.Protocol.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 14 comments.

Show a summary per file

File	Description
src/Cli/README.md	Documents the new maui version subcommands and examples.
src/Cli/Microsoft.Maui.Cli/Services/ProjectVersionService.cs	New service to detect/update MAUI package versions and manage NuGet.config.
src/Cli/Microsoft.Maui.Cli/Services/NuGetVersionService.cs	New service to query stable/nightly feeds for MAUI package versions.
src/Cli/Microsoft.Maui.Cli/ServiceConfiguration.cs	Registers the new version services with DI.
src/Cli/Microsoft.Maui.Cli/Program.cs	Switches root command registration to VersionCommands.
src/Cli/Microsoft.Maui.Cli/Microsoft.Maui.Cli.csproj	Adds NuGet.Protocol package reference.
src/Cli/Microsoft.Maui.Cli/Commands/VersionCommands.Update.cs	Implements maui version update behavior/options.
src/Cli/Microsoft.Maui.Cli/Commands/VersionCommands.List.cs	Implements maui version list behavior/options.
src/Cli/Microsoft.Maui.Cli/Commands/VersionCommands.Check.cs	Implements maui version check behavior/options.
src/Cli/Microsoft.Maui.Cli/Commands/VersionCommand.cs	Converts existing maui version into a command group + subcommands.
eng/Versions.props	Adds NuGetProtocolVersion property.
Directory.Packages.props	Pins NuGet.Protocol via central package management.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.