M⚠️ ◾ Automated Package Update

.github/scripts/Update-DotNetSdkVersions.ps1

@@ -0,0 +1,359 @@
+<#
+.SYNOPSIS
+    Updates .NET SDK and MSBuild SDK versions in global.json file.
+
+.DESCRIPTION
+    Updates the .NET SDK version by querying the latest release from aka.ms redirects,
+    and updates MSBuild SDK package versions using 'dotnet package search'.
+
+.PARAMETER GlobalJsonPath
+    Relative path to the global.json file from the source directory.
+    Default: "global.json"
+
+.PARAMETER SdkChannel
+    The .NET SDK release channel to track. Options: STS, LTS, 8.0, 9.0, etc.
+    Default: "STS"
+
+.PARAMETER SourcesDirectory
+    The root source directory containing the global.json file.
+    Default: $env:BUILD_SOURCESDIRECTORY (Azure Pipelines variable)
+
+.PARAMETER FailOnError
+    If $true, throws an exception on SDK lookup failures. If $false, logs warnings and continues.
+    Default: $false
+
+.NOTES
+    Verbose logging is automatically enabled when Azure Pipelines System.Debug is set to 'true'.
+    To enable verbose logging, set the system.debug variable in your pipeline or run with:
+    variables:
+      system.debug: true
+
+.EXAMPLE
+    .\Update-DotNetSdkVersions.ps1
+
+.EXAMPLE
+    .\Update-DotNetSdkVersions.ps1 -SdkChannel "LTS" -FailOnError $true
+
+.EXAMPLE
+    $env:SYSTEM_DEBUG = 'true'; .\Update-DotNetSdkVersions.ps1 -GlobalJsonPath "global.json"
+#>
+
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory = $false)]
+    [string]$GlobalJsonPath = "global.json",
+
+    [Parameter(Mandatory = $false)]
+    [string]$SdkChannel = "STS",
+
+    [Parameter(Mandatory = $false)]
+    [string]$SourcesDirectory = $env:BUILD_SOURCESDIRECTORY,
+
+    [Parameter(Mandatory = $false)]
+    [bool]$FailOnError = $false
+)
+
+# Auto-detect verbose logging from Azure Pipelines System.Debug variable
+$EnableVerboseLogging = ($env:SYSTEM_DEBUG -eq 'true') -or ($env:SYSTEM_DEBUG -eq '1')
+
+$ErrorActionPreference = if ($FailOnError) { "Stop" } else { "Continue" }
+
+# Helper function for version comparison
+function Get-LatestVersionFromString {
+    param (
+        [string]$First,
+        [string]$Second
+    )
+
+    if (-not $First) { return $Second }
+    if (-not $Second) { return $First }
+
+    function Get-VersionFromString {
+        param ([string]$Value)
+
+        $splitIndex = $Value.IndexOf('-')
+        if ($splitIndex -eq -1) {
+            $versionString = $Value
+            $suffix = ''
+        } else {
+            $versionString = $Value.Substring(0, $splitIndex)
+            $suffix = $Value.Substring($splitIndex)
+        }
+
+        $version = $null
+        if (-not [System.Version]::TryParse($versionString, [ref]$version)) {
+            $version = $versionString
+        }
+
+        return [PSCustomObject]@{ Version = $version; Suffix = $suffix }
+    }
+
+    $firstVersionObject = Get-VersionFromString $First
+    $secondVersionObject = Get-VersionFromString $Second
+
+    if ($firstVersionObject.Version -eq $secondVersionObject.Version) {
+        if (-not $firstVersionObject.Suffix) { return $First }
+        if (-not $secondVersionObject.Suffix) { return $Second }
+        if ($firstVersionObject.Suffix -lt $secondVersionObject.Suffix) { return $Second }
+        return $First
+    }
+
+    if ($firstVersionObject.Version -lt $secondVersionObject.Version) { return $Second }
+    return $First
+}
+
+function Test-PreReleaseVersion {
+    param ([string]$Version)
+    return $Version.Contains('-')
+}
+
+function Get-LatestSdkVersion {
+    param ([string]$Channel = "STS")
+
+    $sdkRedirectUrl = "https://aka.ms/dotnet/$Channel/dotnet-sdk-win-x64.zip"
+
+    try {
+        if ($EnableVerboseLogging) {
+            Write-Host "  [VERBOSE] Querying SDK redirect URL: $sdkRedirectUrl"
+        }
+
+        # Follow redirects automatically and get final URL
+        $response = Invoke-WebRequest -Uri $sdkRedirectUrl -Method HEAD -MaximumRedirection 10 -UseBasicParsing
+
+        if ($EnableVerboseLogging) {
+            Write-Host "  [VERBOSE] Response status: $($response.StatusCode)"
+            Write-Host "  [VERBOSE] Response headers: $($response.Headers | ConvertTo-Json -Compress)"
+        }
+
+        # PowerShell Core: Get final URL from response object
+        $finalUrl = $response.BaseResponse.RequestMessage.RequestUri.AbsoluteUri
+
+        if (-not $finalUrl) {
+            throw "Could not determine final redirect URL from response"
+        }
+
+        Write-Host "Resolved SDK URL: $finalUrl"
+
+        # URL format: https://dotnetcli.azureedge.net/dotnet/Sdk/<version>/dotnet-sdk-<version>-win-x64.zip
+        # Pattern: \d+ for major/minor to support multi-digit versions (e.g., 10.0.101)
+        $version = ($finalUrl | Select-String -Pattern "\d+\.\d+\.\d{3}").Matches.Value
+        if (-not $version) {
+            throw "Failed to extract version from URL: $finalUrl"
+        }
+
+        Write-Host "Latest .NET SDK version: $version"
+        return $version
+    }
+    catch {
+        $errorMsg = "Failed to retrieve SDK version from ${sdkRedirectUrl}: $($_.Exception.Message)"
+        if ($FailOnError) {
+            throw $errorMsg
+        } else {
+            Write-Warning $errorMsg
+            return $null
+        }
+    }
+}
+
+function Get-LatestPackageVersion {
+    param (
+        [string]$PackageId,
+        [bool]$IncludePrerelease
+    )
+
+    try {
+        $prereleaseFlag = if ($IncludePrerelease) { "--prerelease" } else { "" }
+
+        # Check if NuGet.config exists in the sources directory
+        $nugetConfigPath = Join-Path $SourcesDirectory "NuGet.config"
+        $configSourceFlag = ""
+        if (Test-Path $nugetConfigPath) {
+            $configSourceFlag = "--configfile `"$nugetConfigPath`""
+            if ($EnableVerboseLogging) {
+                Write-Host "  [VERBOSE] Using NuGet.config from: $nugetConfigPath"
+            }
+        } else {
+            Write-Warning "NuGet.config not found at: $nugetConfigPath - search may not find private feeds"
+        }
+
+        $searchCmd = "dotnet package search `"$PackageId`" --exact-match --format json $prereleaseFlag $configSourceFlag"
+
+        if ($EnableVerboseLogging) {
+            Write-Host "  [VERBOSE] Executing: $searchCmd"
+        }
+
+        Write-Host "Searching for MSBuild SDK: $PackageId"
+
+        $output = Invoke-Expression $searchCmd 2>&1 | Out-String
+
+        if ($LASTEXITCODE -ne 0) {
+            $errorMsg = "Failed to search for package '$PackageId': $output"
+            if ($FailOnError) {
+                throw $errorMsg
+            } else {
+                Write-Warning $errorMsg
+                return $null
+            }
+        }
+
+        if ($EnableVerboseLogging) {
+            Write-Host "  [VERBOSE] Raw output: $output"
+        }
+
+        $result = $output | ConvertFrom-Json
+
+        if (-not $result.searchResult -or $result.searchResult.Count -eq 0) {
+            $errorMsg = "Package '$PackageId' not found in any configured feed"
+            if ($FailOnError) {
+                throw $errorMsg
+            } else {
+                Write-Warning $errorMsg
+                return $null
+            }
+        }
+
+        # Iterate through all sources and packages to find the latest version
+        # The JSON structure is: searchResult[].packages[].version
+        $latestVersion = $null
+        foreach ($source in $result.searchResult) {
+            if ($source.packages) {
+                foreach ($package in $source.packages) {
+                    if ($package.id -eq $PackageId) {
+                        $latestVersion = Get-LatestVersionFromString -First $latestVersion -Second $package.version
+                    }
+                }
+            }
+        }
+
+        if ($EnableVerboseLogging) {
+            Write-Host "  [VERBOSE] Found latest version: $latestVersion"
+        }
+
+        return $latestVersion
+    }
+    catch {
+        $errorMsg = "Error searching for package '$PackageId': $_"
+        if ($FailOnError) {
+            throw $errorMsg
+        } else {
+            Write-Warning $errorMsg
+            return $null
+        }
+    }
+}
+
+# Main script execution
+Write-Host "==============================================================================="
+Write-Host ".NET SDK Version Update Script"
+Write-Host "==============================================================================="
+Write-Host "Global JSON Path: $GlobalJsonPath"
+Write-Host "SDK Channel: $SdkChannel"
+Write-Host "Sources Directory: $SourcesDirectory"
+Write-Host "Verbose Logging: $EnableVerboseLogging"
+Write-Host "Fail On Error: $FailOnError"
+Write-Host "==============================================================================="
+
+$globalJsonFile = Join-Path $SourcesDirectory $GlobalJsonPath
+Write-Host "Full path to global.json: $globalJsonFile"
+
+if (-not (Test-Path $globalJsonFile)) {
+    $errorMsg = "global.json file not found at: $globalJsonFile"
+    if ($FailOnError) {
+        throw $errorMsg
+    } else {
+        Write-Warning $errorMsg
+        exit 1
+    }
+}
+
+Write-Host "Updating SDK versions in: $globalJsonFile"
+Write-Host "Using SDK channel: $SdkChannel"
+
+# Load global.json
+$globalJson = Get-Content $globalJsonFile -Raw | ConvertFrom-Json
+
+if ($EnableVerboseLogging) {
+    Write-Host "[VERBOSE] Loaded global.json content:"
+    Write-Host ($globalJson | ConvertTo-Json -Depth 10)
+}
+
+$updateCount = 0
+
+# Update .NET SDK version
+$currentSdkVersion = $globalJson.sdk.version
+Write-Host "Current .NET SDK version: $currentSdkVersion"
+
+$latestSdkVersion = Get-LatestSdkVersion -Channel $SdkChannel
+
+if ($latestSdkVersion) {
+    $selectedVersion = Get-LatestVersionFromString -First $currentSdkVersion -Second $latestSdkVersion
+
+    if ($EnableVerboseLogging) {
+        Write-Host "[VERBOSE] SDK version comparison: current=$currentSdkVersion, latest=$latestSdkVersion, selected=$selectedVersion"
+    }
+
+    if ($selectedVersion -ne $currentSdkVersion) {
+        Write-Host "##[section]Updating .NET SDK from '$currentSdkVersion' to '$latestSdkVersion'"
+        $globalJson.sdk.version = $latestSdkVersion
+        $updateCount++
+    } else {
+        Write-Host ".NET SDK already at latest version '$currentSdkVersion'"
+    }
+}
+
+# Update MSBuild SDKs
+if ($globalJson.'msbuild-sdks') {
+    $msbuildSdks = $globalJson.'msbuild-sdks'
+
+    if ($EnableVerboseLogging) {
+        Write-Host "[VERBOSE] Found $($msbuildSdks.PSObject.Properties.Count) MSBuild SDK(s) to check"
+    }
+
+    foreach ($property in $msbuildSdks.PSObject.Properties) {
+        $packageName = $property.Name
+        $currentVersion = $property.Value
+
+        Write-Host "Checking MSBuild SDK: $packageName (current: $currentVersion)"
+
+        $includePrerelease = Test-PreReleaseVersion -Version $currentVersion
+
+        if ($EnableVerboseLogging) {
+            Write-Host "  [VERBOSE] Include prerelease: $includePrerelease"
+        }
+
+        $latestVersion = Get-LatestPackageVersion -PackageId $packageName -IncludePrerelease $includePrerelease
+
+        if (-not $latestVersion) {
+            Write-Host "No update available for '$packageName'"
+            continue
+        }
+
+        $selectedVersion = Get-LatestVersionFromString -First $currentVersion -Second $latestVersion
+
+        if ($EnableVerboseLogging) {
+            Write-Host "  [VERBOSE] Version comparison: current=$currentVersion, latest=$latestVersion, selected=$selectedVersion"
+        }
+
+        if ($selectedVersion -ne $currentVersion) {
+            Write-Host "##[section]Updating MSBuild SDK '$packageName' from '$currentVersion' to '$latestVersion'"
+            $msbuildSdks.$packageName = $latestVersion
+            $updateCount++
+        } else {
+            Write-Host "MSBuild SDK '$packageName' already at latest version '$currentVersion'"
+        }
+    }
+}
+
+if ($updateCount -gt 0) {
+    Write-Host "##[section]Saving $updateCount SDK updates to $globalJsonFile"
+
+    # Save with consistent JSON formatting (2-space indent)
+    $globalJson | ConvertTo-Json -Depth 10 | Set-Content $globalJsonFile -NoNewline
+    Write-Host "Successfully updated $updateCount SDK(s)"
+} else {
+    Write-Host "No SDK updates needed"
+}
+
+Write-Host "==============================================================================="
+Write-Host ".NET SDK Update Complete"
+Write-Host "==============================================================================="