🚀 [Feature]: Version output always emitted regardless of publish decision

action.yml

@@ -66,6 +66,7 @@ runs:
       shell: pwsh
       working-directory: ${{ inputs.WorkingDirectory }}
       env:
+        GH_TOKEN: ${{ github.token }}
         PSMODULE_RESOLVE_PSMODULEVERSION_INPUT_Settings: ${{ inputs.Settings }}
         PSMODULE_RESOLVE_PSMODULEVERSION_INPUT_Name: ${{ inputs.Name }}
         PSMODULE_RESOLVE_PSMODULEVERSION_INPUT_EventJson: ${{ inputs.EventJson }}

scripts/Helpers.psm1

@@ -1,13 +1,13 @@
 function Split-CommaSeparatedList {
     <#
-    .SYNOPSIS
-    Splits a comma-separated string into a trimmed, non-empty array.
+        .SYNOPSIS
+        Splits a comma-separated string into a trimmed, non-empty array.
 
-    .EXAMPLE
-    Split-CommaSeparatedList -Value 'Major, Minor, Patch'
+        .EXAMPLE
+        Split-CommaSeparatedList -Value 'Major, Minor, Patch'
 
-    Returns @('Major', 'Minor', 'Patch').
-#>
+        Returns @('Major', 'Minor', 'Patch').
+    #>
     [CmdletBinding()]
     [OutputType([string[]])]
     param(
@@ -21,19 +21,19 @@
 
 function Read-ActionInput {
     <#
-    .SYNOPSIS
-    Reads and validates action inputs from environment variables.
+        .SYNOPSIS
+        Reads and validates action inputs from environment variables.
 
-    .DESCRIPTION
-    Reads the module name and settings JSON from GitHub Actions environment variables.
-    Falls back to the repository name when the module name input is not provided.
+        .DESCRIPTION
+        Reads the module name and settings JSON from GitHub Actions environment variables.
+        Falls back to the repository name when the module name input is not provided.
 
-    .OUTPUTS
-    PSCustomObject with Name and SettingsJson properties.
+        .OUTPUTS
+        PSCustomObject with Name and SettingsJson properties.
 
-    .EXAMPLE
-    $actionInput = Read-ActionInput
-#>
+        .EXAMPLE
+        $actionInput = Read-ActionInput
+    #>
     [CmdletBinding()]
     [OutputType([PSCustomObject])]
     param()
@@ -62,19 +62,19 @@ function Read-ActionInput {
 
 function Get-PublishConfiguration {
     <#
-    .SYNOPSIS
-    Parses the settings JSON into a publish configuration object.
+        .SYNOPSIS
+        Parses the settings JSON into a publish configuration object.
 
-    .DESCRIPTION
-    Extracts publish module settings including auto-patching flags, version prefix,
-    release type, and label classification arrays.
+        .DESCRIPTION
+        Extracts publish module settings including auto-patching flags, version prefix,
+        release type, and label classification arrays.
 
-    .OUTPUTS
-    PSCustomObject with publish configuration properties.
+        .OUTPUTS
+        PSCustomObject with publish configuration properties.
 
-    .EXAMPLE
-    $config = Get-PublishConfiguration -SettingsJson $actionInput.SettingsJson
-#>
+        .EXAMPLE
+        $config = Get-PublishConfiguration -SettingsJson $actionInput.SettingsJson
+    #>
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '',
         Justification = 'Parameter is used inside LogGroup script block.')]
     [CmdletBinding()]
@@ -122,19 +122,19 @@ function Get-PublishConfiguration {
 
 function Get-GitHubPullRequest {
     <#
-    .SYNOPSIS
-    Reads and validates the GitHub pull request from the event payload.
+        .SYNOPSIS
+        Reads and validates the GitHub pull request from the event payload.
 
-    .DESCRIPTION
-    Loads the GitHub event from the input override or from the event path file,
-    then validates and extracts pull request data.
+        .DESCRIPTION
+        Loads the GitHub event from the input override or from the event path file,
+        then validates and extracts pull request data.
 
-    .OUTPUTS
-    PSCustomObject with HeadRef and Labels properties.
+        .OUTPUTS
+        PSCustomObject with HeadRef and Labels properties.
 
-    .EXAMPLE
-    $pullRequest = Get-GitHubPullRequest
-#>
+        .EXAMPLE
+        $pullRequest = Get-GitHubPullRequest
+    #>
     [CmdletBinding()]
     [OutputType([PSCustomObject])]
     param()
@@ -171,20 +171,20 @@ function Get-GitHubPullRequest {
 
 function Resolve-ReleaseDecision {
     <#
-    .SYNOPSIS
-    Determines whether to publish a release and what kind of version bump to apply.
+        .SYNOPSIS
+        Determines whether to publish a release and what kind of version bump to apply.
 
-    .DESCRIPTION
-    Evaluates the PR labels against the configured label categories and release type
-    to produce a complete release decision.
+        .DESCRIPTION
+        Evaluates the PR labels against the configured label categories and release type
+        to produce a complete release decision.
 
-    .OUTPUTS
-    PSCustomObject with ShouldPublish, CreateRelease, CreatePrerelease, MajorRelease,
-    MinorRelease, PatchRelease, HasVersionBump, and PrereleaseName properties.
+        .OUTPUTS
+        PSCustomObject with ShouldPublish, CreateRelease, CreatePrerelease, MajorRelease,
+        MinorRelease, PatchRelease, HasVersionBump, and PrereleaseName properties.
 
-    .EXAMPLE
-    $decision = Resolve-ReleaseDecision -Configuration $config -PullRequest $pullRequest
-#>
+        .EXAMPLE
+        $decision = Resolve-ReleaseDecision -Configuration $config -PullRequest $pullRequest
+    #>
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '',
         Justification = 'Parameter is used inside LogGroup script block.')]
     [CmdletBinding()]
@@ -222,10 +222,14 @@ function Resolve-ReleaseDecision {
             $shouldPublish = $false
         }
 
+        # Defaults: always produce a prerelease patch version.
         $majorRelease = $false
         $minorRelease = $false
-        $patchRelease = $false
-        $hasVersionBump = $false
+        $patchRelease = $true
+        $hasVersionBump = $true
+        if (-not $shouldPublish) {
+            $createPrerelease = $true
+        }
 
         if ($shouldPublish) {
             $majorRelease = ($labels | Where-Object { $Configuration.MajorLabels -contains $_ }).Count -gt 0
@@ -238,6 +242,9 @@ function Resolve-ReleaseDecision {
             if (-not $hasVersionBump) {
                 Write-Host 'No version bump label found and AutoPatching is disabled. No release will be created.'
                 $shouldPublish = $false
+                $createPrerelease = $true
+                $patchRelease = $true
+                $hasVersionBump = $true
             }
         }
 
@@ -268,15 +275,15 @@ function Resolve-ReleaseDecision {
 
 function Get-GitHubRelease {
     <#
-    .SYNOPSIS
-    Retrieves all releases from the current GitHub repository.
+        .SYNOPSIS
+        Retrieves all releases from the current GitHub repository.
 
-    .OUTPUTS
-    Array of release objects.
+        .OUTPUTS
+        Array of release objects.
 
-    .EXAMPLE
-    $releases = Get-GitHubReleases
-#>
+        .EXAMPLE
+        $releases = Get-GitHubReleases
+    #>
     [CmdletBinding()]
     [OutputType([array])]
     param()
@@ -300,15 +307,15 @@ function Get-GitHubRelease {
 
 function Get-LatestGitHubVersion {
     <#
-    .SYNOPSIS
-    Extracts the latest stable version from a GitHub releases list.
+        .SYNOPSIS
+        Extracts the latest stable version from a GitHub releases list.
 
-    .OUTPUTS
-    PSSemVer representing the latest GitHub release version.
+        .OUTPUTS
+        PSSemVer representing the latest GitHub release version.
 
-    .EXAMPLE
-    $ghVersion = Get-LatestGitHubVersion -Releases $releases
-#>
+        .EXAMPLE
+        $ghVersion = Get-LatestGitHubVersion -Releases $releases
+    #>
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '',
         Justification = 'Parameter is used inside LogGroup script block.')]
     [CmdletBinding()]
@@ -337,19 +344,19 @@ function Get-LatestGitHubVersion {
 
 function Get-LatestPSGalleryVersion {
     <#
-    .SYNOPSIS
-    Finds the latest stable version of a module in the PowerShell Gallery.
+        .SYNOPSIS
+        Finds the latest stable version of a module in the PowerShell Gallery.
 
-    .DESCRIPTION
-    Queries the PowerShell Gallery for the latest published version of the module.
-    Retries up to five times with a ten-second delay between attempts.
+        .DESCRIPTION
+        Queries the PowerShell Gallery for the latest published version of the module.
+        Retries up to five times with a ten-second delay between attempts.
 
-    .OUTPUTS
-    PSSemVer representing the latest PSGallery version.
+        .OUTPUTS
+        PSSemVer representing the latest PSGallery version.
 
-    .EXAMPLE
-    $psGalleryVersion = Get-LatestPSGalleryVersion -ModuleName 'MyModule'
-#>
+        .EXAMPLE
+        $psGalleryVersion = Get-LatestPSGalleryVersion -ModuleName 'MyModule'
+    #>
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '',
         Justification = 'Parameter is used inside LogGroup script block.')]
     [CmdletBinding()]
@@ -395,15 +402,15 @@ function Get-LatestPSGalleryVersion {
 
 function Get-LatestPublishedVersion {
     <#
-    .SYNOPSIS
-    Returns the highest version between GitHub and the PowerShell Gallery.
+        .SYNOPSIS
+        Returns the highest version between GitHub and the PowerShell Gallery.
 
-    .OUTPUTS
-    PSSemVer representing the highest known published version.
+        .OUTPUTS
+        PSSemVer representing the highest known published version.
 
-    .EXAMPLE
-    $latestVersion = Get-LatestPublishedVersion -GitHubVersion $ghVersion -PSGalleryVersion $psGalleryVersion
-#>
+        .EXAMPLE
+        $latestVersion = Get-LatestPublishedVersion -GitHubVersion $ghVersion -PSGalleryVersion $psGalleryVersion
+    #>
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '',
         Justification = 'Parameter is used inside LogGroup script block.')]
     [CmdletBinding()]
@@ -429,20 +436,20 @@ function Get-LatestPublishedVersion {
 
 function Get-NextPrereleaseNumber {
     <#
-    .SYNOPSIS
-    Calculates the next incremental prerelease number across GitHub and PSGallery.
+        .SYNOPSIS
+        Calculates the next incremental prerelease number across GitHub and PSGallery.
 
-    .DESCRIPTION
-    Queries both GitHub releases and the PowerShell Gallery for existing prereleases
-    matching the base version and prerelease name, then returns the next number
-    zero-padded to three digits.
+        .DESCRIPTION
+        Queries both GitHub releases and the PowerShell Gallery for existing prereleases
+        matching the base version and prerelease name, then returns the next number
+        zero-padded to three digits.
 
-    .OUTPUTS
-    String. A zero-padded three-digit number (e.g. '001').
+        .OUTPUTS
+        String. A zero-padded three-digit number (e.g. '001').
 
-    .EXAMPLE
-    $number = Get-NextPrereleaseNumber -ModuleName 'MyModule' -BaseVersion '1.2.3' -PrereleaseName 'mybranch' -Releases $releases
-#>
+        .EXAMPLE
+        $number = Get-NextPrereleaseNumber -ModuleName 'MyModule' -BaseVersion '1.2.3' -PrereleaseName 'mybranch' -Releases $releases
+    #>
     [CmdletBinding()]
     [OutputType([string])]
     param(
@@ -502,20 +509,20 @@ function Get-NextPrereleaseNumber {
 
 function Get-NextModuleVersion {
     <#
-    .SYNOPSIS
-    Calculates the next module version based on the release decision.
+        .SYNOPSIS
+        Calculates the next module version based on the release decision.
 
-    .DESCRIPTION
-    Increments the current version according to the version bump type (major, minor, or patch),
-    then optionally appends a prerelease suffix with support for date-based and incremental numbering.
+        .DESCRIPTION
+        Increments the current version according to the version bump type (major, minor, or patch),
+        then optionally appends a prerelease suffix with support for date-based and incremental numbering.
 
-    .OUTPUTS
-    PSSemVer representing the resolved next version.
+        .OUTPUTS
+        PSSemVer representing the resolved next version.
 
-    .EXAMPLE
-    $newVersion = Get-NextModuleVersion -LatestVersion $latestVersion -Decision $decision `
-        -Configuration $config -ModuleName 'MyModule' -Releases $releases
-#>
+        .EXAMPLE
+        $newVersion = Get-NextModuleVersion -LatestVersion $latestVersion -Decision $decision `
+            -Configuration $config -ModuleName 'MyModule' -Releases $releases
+    #>
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '',
         Justification = 'Parameter is used inside LogGroup script block.')]
     [CmdletBinding()]
@@ -569,7 +576,7 @@ function Get-NextModuleVersion {
                 $newVersion.Prerelease += "$(Get-Date -Format $Configuration.DatePrereleaseFormat)"
             }
 
-            if ($Configuration.IncrementalPrerelease) {
+            if ($Configuration.IncrementalPrerelease -or -not $Decision.ShouldPublish) {
                 $baseVersionString = "$($newVersion.Major).$($newVersion.Minor).$($newVersion.Patch)"
                 $params = @{
                     ModuleName     = $ModuleName
@@ -588,12 +595,12 @@ function Get-NextModuleVersion {
 
 function Write-ActionOutput {
     <#
-    .SYNOPSIS
-    Emits the resolved version and release type as GitHub Actions step outputs.
+        .SYNOPSIS
+        Emits the resolved version and release type as GitHub Actions step outputs.
 
-    .EXAMPLE
-    Write-ActionOutput -Decision $decision -NewVersion $newVersion
-#>
+        .EXAMPLE
+        Write-ActionOutput -Decision $decision -NewVersion $newVersion
+    #>
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '',
         Justification = 'Parameter is used inside LogGroup script block.')]
     [CmdletBinding()]
@@ -602,21 +609,15 @@ function Write-ActionOutput {
         [Parameter(Mandatory)]
         [PSCustomObject] $Decision,
 
-        # The resolved next version, or $null when no release will be created.
-        [Parameter()]
+        # The resolved next version.
+        [Parameter(Mandatory)]
         [object] $NewVersion
     )
 
     LogGroup 'Emit outputs' {
-        $versionString = ''
-        $prereleaseString = ''
-        $fullVersionString = ''
-
-        if ($NewVersion) {
-            $versionString = "$($NewVersion.Major).$($NewVersion.Minor).$($NewVersion.Patch)"
-            $prereleaseString = [string]$NewVersion.Prerelease
-            $fullVersionString = $NewVersion.ToString()
-        }
+        $versionString = "$($NewVersion.Major).$($NewVersion.Minor).$($NewVersion.Patch)"
+        $prereleaseString = [string]$NewVersion.Prerelease
+        $fullVersionString = $NewVersion.ToString()
 
         $resolvedReleaseType = if ($Decision.ShouldPublish) {
             if ($Decision.CreateRelease) { 'Release' } else { 'Prerelease' }