🪲 [Fix]: Resolve to the current version on non-PR events (workflow_dispatch, schedule) (#10)

On non–pull-request events (for example `workflow_dispatch` and
`schedule`), the action now resolves to the current published version
instead of throwing. This is the root-cause fix for the `Plan` failures
consumers see on scheduled and manual runs.

- Part of the fix for PSModule/Process-PSModule#373

## Fixed: no more throw on non–pull-request events

Previously the action required a `pull_request` payload and threw
`"...must be run from a pull_request event"` on any other event. Because
Process-PSModule's `Plan` job runs this on every event, that failed the
whole run on `schedule` / `workflow_dispatch` for every consumer.

Now, when the event has no `pull_request`, `Get-GitHubPullRequest`
returns `$null` and the caller resolves a no-op decision: no bump, no
prerelease, nothing published — so `Get-NextModuleVersion` returns the
**current published version** unchanged.

## New: non-PR runs report the current version

There are no PR labels on `workflow_dispatch` / `schedule`, so there's
nothing to bump from. The action keeps the latest published version
(GitHub Release / PS Gallery), which is what a scheduled or manual
re-test should build and test against. For a module that has never been
released this floors at `0.0.0`. Pull-request and
merge-to-default-branch behavior is unchanged — labels drive the bump,
with patch as the default.

## Technical Details

- `scripts/Resolve-PSModuleVersion.Helpers.psm1`:
`Get-GitHubPullRequest` returns `$null` on a non-PR event instead of
throwing.
- `scripts/main.ps1`: builds a no-op release decision (all flags
`false`, empty prerelease) when there is no pull request, otherwise
calls `Resolve-ReleaseDecision` as before. `Get-NextModuleVersion` then
returns `LatestVersion` unchanged.
- `tests/`: added cases asserting the no-op decision keeps the current
version (`1.2.3` and the `0.0.0` floor) with no bump and no prerelease.
Full suite: 159 passed, PSScriptAnalyzer clean.
- Follow-up: once released, Process-PSModule bumps its `Resolve-Version`
pin to this version, which lets its `Plan.yml` gate + `999.0.0` fallback
in PR #375 be dropped.

Author: MariusStorhaug

scripts/Resolve-PSModuleVersion.Helpers.psm1

@@ -126,11 +126,14 @@ function Get-GitHubPullRequest {
         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.
+        Loads the GitHub event from the input override or from the event path file. On a
+        pull_request event it returns the pull request head ref and labels. On any other
+        event (for example workflow_dispatch or schedule) there is no pull request, so it
+        returns $null and the caller resolves the current version without a version bump.
 
         .OUTPUTS
-        PSCustomObject with HeadRef and Labels properties.
+        PSCustomObject with HeadRef and Labels properties for a pull_request event, or
+        $null when the event has no pull request (non-PR events).
 
         .EXAMPLE
         $pullRequest = Get-GitHubPullRequest
@@ -149,7 +152,9 @@ function Get-GitHubPullRequest {
 
         $pr = $githubEvent.pull_request
         if (-not $pr) {
-            throw 'GitHub event does not contain pull_request data. This action must be run from a pull_request event.'
+            Write-Host 'GitHub event does not contain pull_request data (non-PR event, e.g. workflow_dispatch or schedule).'
+            Write-Host 'No pull request context is available; the caller keeps the current version without a bump.'
+            return $null
         }
 
         $labels = @()

scripts/main.ps1

@@ -9,7 +9,24 @@ Import-Module -Name "$PSScriptRoot/Resolve-PSModuleVersion.Helpers.psm1" -Force
 $actionInput = Read-ActionInput
 $config = Get-PublishConfiguration -SettingsJson $actionInput.SettingsJson
 $pullRequest = Get-GitHubPullRequest
-$decision = Resolve-ReleaseDecision -Configuration $config -PullRequest $pullRequest
+
+$decision = if ($null -eq $pullRequest) {
+    # Non-PR event (for example workflow_dispatch or schedule): there are no pull request
+    # labels to determine a version bump, so keep the current published version and publish
+    # nothing. For a module that has never been released this floors at 0.0.0.
+    [PSCustomObject]@{
+        ShouldPublish    = $false
+        CreateRelease    = $false
+        CreatePrerelease = $false
+        MajorRelease     = $false
+        MinorRelease     = $false
+        PatchRelease     = $false
+        HasVersionBump   = $false
+        PrereleaseName   = ''
+    }
+} else {
+    Resolve-ReleaseDecision -Configuration $config -PullRequest $pullRequest
+}
 
 $releases = Get-GitHubRelease
 $ghVersion = Get-LatestGitHubVersion -Releases $releases

tests/Resolve-PSModuleVersion.Helpers.Tests.ps1

@@ -188,3 +188,73 @@ Describe 'End-to-end: Resolve-ReleaseDecision + Get-NextModuleVersion' {
         }
     }
 }
+
+Describe 'Non-PR event keeps the current version' {
+    # main.ps1 builds this decision when the event has no pull_request (for example
+    # workflow_dispatch or schedule): no bump, no prerelease, no publish. Get-NextModuleVersion
+    # must then return the current published version unchanged, floored at 0.0.0 when nothing
+    # has ever been released.
+    BeforeAll {
+        Mock -CommandName Find-PSResource -ModuleName 'Resolve-PSModuleVersion.Helpers' -MockWith { @() }
+        $emptyReleases = @([PSCustomObject]@{ tagName = 'v0.0.0'; isLatest = $false; isPrerelease = $false })
+        $config = [PSCustomObject]@{
+            AutoPatching          = $false
+            IncrementalPrerelease = $true
+            DatePrereleaseFormat  = ''
+            VersionPrefix         = 'v'
+            ReleaseType           = 'None'
+            IgnoreLabels          = @()
+            MajorLabels           = @('major')
+            MinorLabels           = @('minor')
+            PatchLabels           = @('patch')
+        }
+        $noReleaseDecision = [PSCustomObject]@{
+            ShouldPublish    = $false
+            CreateRelease    = $false
+            CreatePrerelease = $false
+            MajorRelease     = $false
+            MinorRelease     = $false
+            PatchRelease     = $false
+            HasVersionBump   = $false
+            PrereleaseName   = ''
+        }
+    }
+
+    It 'keeps the current version <LatestVersion> with no bump and no prerelease' -ForEach @(
+        @{ LatestVersion = '1.2.3' }
+        @{ LatestVersion = '0.0.0' }
+    ) {
+        $latestVer = New-PSSemVer -Version $LatestVersion
+        $result = Get-NextModuleVersion -LatestVersion $latestVer -Decision $noReleaseDecision `
+            -Configuration $config -ModuleName 'TestModule' -Releases $emptyReleases
+        "$($result.Major).$($result.Minor).$($result.Patch)" | Should -Be $LatestVersion
+        $result.Prerelease | Should -BeNullOrEmpty
+    }
+}
+
+Describe 'Get-GitHubPullRequest' {
+    # Covers the non-PR branch: on an event without a pull_request (workflow_dispatch/schedule)
+    # the function must return $null so the caller keeps the current version, and it must still
+    # return the head ref + labels on a pull_request event.
+    AfterEach {
+        Remove-Item Env:PSMODULE_RESOLVE_PSMODULEVERSION_INPUT_EventJson -ErrorAction SilentlyContinue
+    }
+
+    It 'returns $null when the event has no pull_request (non-PR event)' {
+        $env:PSMODULE_RESOLVE_PSMODULEVERSION_INPUT_EventJson = '{ "action": "workflow_dispatch" }'
+        Get-GitHubPullRequest | Should -BeNullOrEmpty
+    }
+
+    It 'returns the head ref and labels for a pull_request event' {
+        $eventJson = @{
+            pull_request = @{
+                head   = @{ ref = 'feat/example' }
+                labels = @(@{ name = 'patch' }, @{ name = 'prerelease' })
+            }
+        } | ConvertTo-Json -Depth 5
+        $env:PSMODULE_RESOLVE_PSMODULEVERSION_INPUT_EventJson = $eventJson
+        $result = Get-GitHubPullRequest
+        $result.HeadRef | Should -Be 'feat/example'
+        ($result.Labels -join ',') | Should -Be 'patch,prerelease'
+    }
+}