🚀 [Feature]: Add PR-based release name and notes options

.github/dependabot.yml

@@ -12,3 +12,7 @@ updates:
       - github-actions
     schedule:
       interval: weekly
+    groups:
+      github-actions:
+        patterns:
+          - '*'

.github/workflows/Action-Test.yml

@@ -23,6 +23,8 @@ jobs:
     steps:
       - name: Checkout repo
         uses: actions/checkout@v6
+        with:
+          persist-credentials: false
 
       - name: Action-Test
         uses: ./

.github/workflows/Auto-Release.yml

@@ -2,6 +2,7 @@ name: Auto-Release
 
 run-name: "Auto-Release - [${{ github.event.pull_request.title }} #${{ github.event.pull_request.number }}] by @${{ github.actor }}"
 
+# zizmor: ignore[dangerous-triggers] intentional - Auto-Release needs write access to create releases on PR merge
 on:
   pull_request_target:
     branches:
@@ -27,8 +28,11 @@ jobs:
     steps:
       - name: Checkout Code
         uses: actions/checkout@v6
+        with:
+          persist-credentials: false
 
       - name: Auto-Release
+        # zizmor: ignore[unpinned-uses] not our action
         uses: PSModule/Auto-Release@v1
         with:
           IncrementalPrerelease: false

.github/workflows/Linter.yml

@@ -22,11 +22,14 @@ jobs:
         uses: actions/checkout@v6
         with:
           fetch-depth: 0
+          persist-credentials: false
 
       - name: Lint code base
+        # zizmor: ignore[unpinned-uses] not our action
         uses: super-linter/super-linter@latest
         env:
           GITHUB_TOKEN: ${{ github.token }}
+          VALIDATE_BIOME_FORMAT: false
           VALIDATE_JSON_PRETTIER: false
           VALIDATE_MARKDOWN_PRETTIER: false
           VALIDATE_YAML_PRETTIER: false

action.yml

@@ -57,11 +57,24 @@ inputs:
     description: The working directory where the script will run from.
     required: false
     default: '.'
+  UsePRTitleAsReleaseName:
+    description: When enabled, uses the pull request title as the name for the GitHub release. If not set, the version string is used.
+    required: false
+    default: 'false'
+  UsePRBodyAsReleaseNotes:
+    description: When enabled, uses the pull request body as the release notes for the GitHub release. If not set, the release notes are auto-generated.
+    required: false
+    default: 'true'
+  UsePRTitleAsNotesHeading:
+    description: When enabled, the release notes will begin with the pull request title as a H1 heading followed by the pull request body. The title will reference the pull request number.
+    required: false
+    default: 'true'
 
 runs:
   using: composite
   steps:
     - name: Install-PSModuleHelpers
+      # zizmor: ignore[unpinned-uses] not our action
       uses: PSModule/Install-PSModuleHelpers@v1
 
     - name: Run Publish-PSModule
@@ -81,4 +94,7 @@ runs:
         PSMODULE_PUBLISH_PSMODULE_INPUT_PatchLabels: ${{ inputs.PatchLabels }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_VersionPrefix: ${{ inputs.VersionPrefix }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_WhatIf: ${{ inputs.WhatIf }}
+        PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRBodyAsReleaseNotes: ${{ inputs.UsePRBodyAsReleaseNotes }}
+        PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRTitleAsReleaseName: ${{ inputs.UsePRTitleAsReleaseName }}
+        PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRTitleAsNotesHeading: ${{ inputs.UsePRTitleAsNotesHeading }}
       run: ${{ github.action_path }}/scripts/main.ps1

scripts/helpers/Publish-PSModule.ps1

@@ -48,18 +48,24 @@
         $majorLabels = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_MajorLabels -split ',' | ForEach-Object { $_.Trim() }
         $minorLabels = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_MinorLabels -split ',' | ForEach-Object { $_.Trim() }
         $patchLabels = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_PatchLabels -split ',' | ForEach-Object { $_.Trim() }
+        $usePRBodyAsReleaseNotes = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRBodyAsReleaseNotes -eq 'true'
+        $usePRTitleAsReleaseName = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRTitleAsReleaseName -eq 'true'
+        $usePRTitleAsNotesHeading = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRTitleAsNotesHeading -eq 'true'
 
         [pscustomobject]@{
-            AutoCleanup           = $autoCleanup
-            AutoPatching          = $autoPatching
-            IncrementalPrerelease = $incrementalPrerelease
-            DatePrereleaseFormat  = $datePrereleaseFormat
-            VersionPrefix         = $versionPrefix
-            WhatIf                = $whatIf
-            IgnoreLabels          = $ignoreLabels
-            MajorLabels           = $majorLabels
-            MinorLabels           = $minorLabels
-            PatchLabels           = $patchLabels
+            AutoCleanup              = $autoCleanup
+            AutoPatching             = $autoPatching
+            IncrementalPrerelease    = $incrementalPrerelease
+            DatePrereleaseFormat     = $datePrereleaseFormat
+            VersionPrefix            = $versionPrefix
+            WhatIf                   = $whatIf
+            IgnoreLabels             = $ignoreLabels
+            MajorLabels              = $majorLabels
+            MinorLabels              = $minorLabels
+            PatchLabels              = $patchLabels
+            UsePRBodyAsReleaseNotes  = $usePRBodyAsReleaseNotes
+            UsePRTitleAsReleaseName  = $usePRTitleAsReleaseName
+            UsePRTitleAsNotesHeading = $usePRTitleAsNotesHeading
         } | Format-List | Out-String
     }
 
@@ -358,25 +364,45 @@
 
         Set-GitHubLogGroup 'New-GitHubRelease' {
             Write-Output 'Create new GitHub release'
+            $releaseCreateCommand = @('release', 'create', $newVersion.ToString())
+
+            # Add title parameter
+            if ($usePRTitleAsReleaseName -and $pull_request.title) {
+                $prTitle = $pull_request.title
+                $releaseCreateCommand += @('--title', $prTitle)
+                Write-Output "Using PR title as release name: [$prTitle]"
+            } else {
+                $releaseCreateCommand += @('--title', $newVersion.ToString())
+            }
+
+            # Add notes parameter
+            if ($usePRTitleAsNotesHeading -and $pull_request.title -and $pull_request.body) {
+                $prTitle = $pull_request.title
+                $prNumber = $pull_request.number
+                $prBody = $pull_request.body
+                $notes = "# $prTitle (#$prNumber)`n`n$prBody"
+                $releaseCreateCommand += @('--notes', $notes)
+                Write-Output 'Using PR title as H1 heading with link and body as release notes'
+            } elseif ($usePRBodyAsReleaseNotes -and $pull_request.body) {
+                $prBody = $pull_request.body
+                $releaseCreateCommand += @('--notes', $prBody)
+                Write-Output 'Using PR body as release notes'
+            } else {
+                $releaseCreateCommand += '--generate-notes'
+            }
+
+            # Add remaining parameters
             if ($createPrerelease) {
-                if ($whatIf) {
-                    Write-Output "WhatIf: gh release create $newVersion --title $newVersion --target $prHeadRef --generate-notes --prerelease"
-                } else {
-                    $releaseURL = gh release create $newVersion --title $newVersion --target $prHeadRef --generate-notes --prerelease
-                    if ($LASTEXITCODE -ne 0) {
-                        Write-Error "Failed to create the release [$newVersion]."
-                        exit $LASTEXITCODE
-                    }
-                }
+                $releaseCreateCommand += @('--target', $prHeadRef, '--prerelease')
+            }
+
+            if ($whatIf) {
+                Write-Output "WhatIf: gh $($releaseCreateCommand -join ' ')"
             } else {
-                if ($whatIf) {
-                    Write-Output "WhatIf: gh release create $newVersion --title $newVersion --generate-notes"
-                } else {
-                    $releaseURL = gh release create $newVersion --title $newVersion --generate-notes
-                    if ($LASTEXITCODE -ne 0) {
-                        Write-Error "Failed to create the release [$newVersion]."
-                        exit $LASTEXITCODE
-                    }
+                $releaseURL = gh @releaseCreateCommand
+                if ($LASTEXITCODE -ne 0) {
+                    Write-Error "Failed to create the release [$newVersion]."
+                    exit $LASTEXITCODE
                 }
             }
             if ($whatIf) {