ci(release): include beta notes in stable releases

Author: RealWhyKnot

.github/scripts/Resolve-ReleaseBaseTag.ps1

@@ -0,0 +1,23 @@
+#!/usr/bin/env pwsh
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory = $true)]
+    [string] $Tag
+)
+
+$ErrorActionPreference = 'Stop'
+
+function Test-IsPrereleaseTag([string]$Tag) {
+    return $Tag -like '*-*'
+}
+
+$describeArgs = @('describe', '--tags', '--abbrev=0')
+if (-not (Test-IsPrereleaseTag -Tag $Tag)) {
+    $describeArgs += @('--exclude', '*-*')
+}
+$describeArgs += "$Tag^"
+
+$prevRef = & git @describeArgs 2>$null
+if ($LASTEXITCODE -eq 0 -and $prevRef) {
+    $prevRef.Trim()
+}

.github/scripts/Test-ResolveReleaseBaseTag.ps1

@@ -0,0 +1,67 @@
+#!/usr/bin/env pwsh
+[CmdletBinding()]
+param()
+
+$ErrorActionPreference = 'Stop'
+
+$resolver = Join-Path $PSScriptRoot 'Resolve-ReleaseBaseTag.ps1'
+$repo = Join-Path ([System.IO.Path]::GetTempPath()) ("release-base-test-" + [System.Guid]::NewGuid().ToString('N'))
+
+function Invoke-Git {
+    param(
+        [Parameter(Mandatory = $true)]
+        [string[]] $Arguments
+    )
+
+    & git @Arguments | Out-Null
+    if ($LASTEXITCODE -ne 0) {
+        throw "git $($Arguments -join ' ') failed with exit code $LASTEXITCODE"
+    }
+}
+
+function Add-TestCommit {
+    param(
+        [Parameter(Mandatory = $true)]
+        [string] $Content,
+        [Parameter(Mandatory = $true)]
+        [string] $Subject
+    )
+
+    Set-Content -LiteralPath (Join-Path $repo 'sample.txt') -Value $Content -Encoding UTF8
+    Invoke-Git @('add', 'sample.txt')
+    Invoke-Git @('commit', '-m', $Subject)
+}
+
+try {
+    New-Item -ItemType Directory -Path $repo -Force | Out-Null
+    Push-Location $repo
+
+    Invoke-Git @('init', '-q')
+    Invoke-Git @('config', 'user.email', 'release-test@example.com')
+    Invoke-Git @('config', 'user.name', 'Release Test')
+
+    Add-TestCommit -Content 'base' -Subject 'chore: base'
+    Invoke-Git @('tag', 'v2026.5.1.0')
+
+    Add-TestCommit -Content 'pre' -Subject 'feat: prerelease patch'
+    Invoke-Git @('tag', 'v2026.5.2.0-beta')
+
+    Add-TestCommit -Content 'stable' -Subject 'fix: stable patch'
+    Invoke-Git @('tag', 'v2026.5.3.0')
+
+    $stableBase = & $resolver -Tag 'v2026.5.3.0'
+    if ($stableBase -ne 'v2026.5.1.0') {
+        throw "Stable base was '$stableBase', expected 'v2026.5.1.0'."
+    }
+
+    $preBase = & $resolver -Tag 'v2026.5.2.0-beta'
+    if ($preBase -ne 'v2026.5.1.0') {
+        throw "Prerelease base was '$preBase', expected 'v2026.5.1.0'."
+    }
+
+    Write-Host 'Resolve-ReleaseBaseTag tests passed.'
+}
+finally {
+    Pop-Location
+    Remove-Item -LiteralPath $repo -Recurse -Force
+}

.github/workflows/release.yml

@@ -28,6 +28,10 @@ jobs:
           # commits against the previous version tag for the changelog.
           fetch-depth: 0
 
+      - name: Test release base selection
+        shell: pwsh
+        run: ./.github/scripts/Test-ResolveReleaseBaseTag.ps1
+
       - uses: actions/setup-go@v5
         with:
           go-version: '1.22'
@@ -101,9 +105,7 @@ jobs:
           # changelog grouped by type, extracted from `git log $prev..$tag`.
           # Bottom section is the static install snippet.
 
-          $prevTag = git tag --list 'v*' --sort=-version:refname |
-                     Where-Object { $_ -ne $env:TAG_NAME } |
-                     Select-Object -First 1
+          $prevTag = & ./.github/scripts/Resolve-ReleaseBaseTag.ps1 -Tag $env:TAG_NAME
 
           $sections = [ordered]@{
               feat     = 'Features'