ci(release): populate PSData.ReleaseNotes from CHANGELOG at publish time

So the PowerShell Gallery release-notes panel shows curated, user-facing notes per
version (matching the GitHub release) instead of a static link.

- build.depend.psd1: add ChangelogManagement 3.1.0.
- build.psake.ps1: new UpdateReleaseNotes task (Depends Build) that sets the built
  manifest's PrivateData.PSData.ReleaseNotes from the matching CHANGELOG entry via
  Update-ModuleManifest, wired in through $PSBPublishDependency. Non-fatal at every
  step so a release is never blocked.

Verified: ChangelogManagement parses this repo's CHANGELOG.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: tablackburn

build.depend.psd1

@@ -25,6 +25,11 @@
     'PSScriptAnalyzer' = @{
         Version = '1.24.0'
     }
+    # Parses CHANGELOG.md (Keep a Changelog format) so the Publish task can populate the
+    # built manifest's PSData.ReleaseNotes from the matching version's entry.
+    'ChangelogManagement' = @{
+        Version = '3.1.0'
+    }
     'PlexAutomationToolkit' = @{
         Version = '0.6.3'
     }

build.psake.ps1

@@ -146,5 +146,60 @@ Task -Name 'DownloadTestTools' -Description 'Download test dependencies (UnRAR)'
     }
 }
 
+# Populate the built manifest's ReleaseNotes from the matching CHANGELOG.md entry so the
+# PowerShell Gallery release-notes panel shows the curated, user-facing notes (the same
+# content used for the GitHub release) instead of just a link. Depends on Build so the
+# staged manifest in ModuleOutDir exists; runs before Publish (see $PSBPublishDependency
+# below). Non-fatal at every step so a release is never blocked.
+Task -Name 'UpdateReleaseNotes' -Depends 'Build' -Description 'Set built manifest ReleaseNotes from the matching CHANGELOG.md entry' {
+    $changelogPath = Join-Path -Path $PSScriptRoot -ChildPath 'CHANGELOG.md'
+    if (-not (Test-Path -Path $changelogPath)) {
+        Write-Warning 'CHANGELOG.md not found; leaving ReleaseNotes unchanged.'
+        return
+    }
+
+    $moduleVersion = $PSBPreference.General.ModuleVersion
+    try {
+        Import-Module -Name 'ChangelogManagement' -ErrorAction Stop
+        $changelogData = Get-ChangelogData -Path $changelogPath -ErrorAction Stop
+    }
+    catch {
+        Write-Warning "Could not read CHANGELOG.md ($($_.Exception.Message)); leaving ReleaseNotes unchanged."
+        return
+    }
+
+    $releaseEntry = $changelogData.Released |
+        Where-Object { [string]$_.Version -eq [string]$moduleVersion } |
+        Select-Object -First 1
+    if (-not $releaseEntry) {
+        Write-Warning "No CHANGELOG.md entry found for version $moduleVersion; leaving ReleaseNotes unchanged."
+        return
+    }
+
+    $releaseNotes = $releaseEntry.RawData.Trim()
+    if ([string]::IsNullOrWhiteSpace($releaseNotes)) {
+        Write-Warning "CHANGELOG.md entry for version $moduleVersion is empty; leaving ReleaseNotes unchanged."
+        return
+    }
+    $builtManifest = Join-Path -Path $PSBPreference.Build.ModuleOutDir -ChildPath "$($PSBPreference.General.ModuleName).psd1"
+    if (-not (Test-Path -Path $builtManifest)) {
+        Write-Warning "Built manifest not found at '$builtManifest'; leaving ReleaseNotes unchanged."
+        return
+    }
+    try {
+        Update-ModuleManifest -Path $builtManifest -ReleaseNotes $releaseNotes -ErrorAction Stop
+        Write-Host "  Set ReleaseNotes on built manifest from CHANGELOG [$($releaseEntry.Version)] ($($releaseNotes.Length) chars)" -ForegroundColor Gray
+    }
+    catch {
+        # Keep publishing unblocked: a failure here just leaves the manifest's existing
+        # ReleaseNotes in place rather than aborting the release.
+        Write-Warning "Failed to set ReleaseNotes on the built manifest ($($_.Exception.Message)); leaving it unchanged."
+    }
+}
+
+# Inject ReleaseNotes into the built manifest before publishing (PowerShellBuild's Publish
+# defaults to depending only on 'Test').
+$PSBPublishDependency = @('Test', 'UpdateReleaseNotes')
+
 # Import the Test task from PowerShellBuild (uses $PSBTestDependency which includes Pester and Analyze)
 Task -Name 'Test' -FromModule 'PowerShellBuild' -MinimumVersion '0.7.3'