🚀 [Feature]: Add PrereleaseLabels support and ReleaseType calculation (#6)

The workflow now supports configurable prerelease labels and introduces
`ReleaseType` as a single source of truth for determining what action
the publish workflow should take. Previously, the `prerelease` label
check was hardcoded while all other labels were configurable, and adding
a prerelease label to a PR did not trigger the publish workflow.

## PrereleaseLabels Configuration

You can now customize which labels trigger a prerelease build via the
`PSModule.yml` settings file:

```yaml
Publish:
  Module:
    PrereleaseLabels: prerelease, beta, alpha
```

The default value is `prerelease`, maintaining backward compatibility.

## ReleaseType - Single Source of Truth

A new `ReleaseType` property is now calculated and included in the `Run`
object with these values:

| Value | Trigger | Action |
|-------|---------|--------|
| `Release` | PR merged to default branch | Create stable release |
| `Prerelease` | PR has prerelease label OR prerelease label just added
| Create prerelease |
| `Cleanup` | PR closed without merge (abandoned) | Delete old
prereleases |
| `None` | Any other scenario | Skip publishing |

This simplifies the publish logic and makes debugging easier since
`ReleaseType` is visible in the Get-Settings logs.

## Changes

- Added `PrereleaseLabels` setting with default value `prerelease`
- Added detection for when a prerelease label is added via the `labeled`
action
- Introduced `ReleaseType` calculation as the single source of truth
- Updated `PublishModule` condition to use `$releaseType -ne 'None'`
- Added `ReleaseType` to the `Run` object for downstream consumption
- Updated JSON schema with `PrereleaseLabels` and `ReleaseType`
definitions

Author: MariusStorhaug

scripts/Settings.schema.json

@@ -162,6 +162,10 @@
               "type": "string",
               "description": "Comma-separated labels that prevent release"
             },
+            "PrereleaseLabels": {
+              "type": "string",
+              "description": "Comma-separated labels that trigger a prerelease"
+            },
             "UsePRTitleAsReleaseName": {
               "type": "boolean",
               "description": "Use pull request title as the GitHub release name"
@@ -328,6 +332,11 @@
           "type": "boolean",
           "description": "Publish the module"
         },
+        "ReleaseType": {
+          "type": "string",
+          "enum": ["Release", "Prerelease", "Cleanup", "None"],
+          "description": "The type of release to create: Release (stable), Prerelease, Cleanup (delete old prereleases), or None"
+        },
         "BuildDocs": {
           "type": "boolean",
           "description": "Build documentation"

scripts/main.ps1

@@ -172,6 +172,7 @@ $settings = [pscustomobject]@{
             MinorLabels              = $settings.Publish.Module.MinorLabels ?? 'minor, feature'
             PatchLabels              = $settings.Publish.Module.PatchLabels ?? 'patch, fix'
             IgnoreLabels             = $settings.Publish.Module.IgnoreLabels ?? 'NoRelease'
+            PrereleaseLabels         = $settings.Publish.Module.PrereleaseLabels ?? 'prerelease'
             UsePRTitleAsReleaseName  = $settings.Publish.Module.UsePRTitleAsReleaseName ?? $false
             UsePRBodyAsReleaseNotes  = $settings.Publish.Module.UsePRBodyAsReleaseNotes ?? $true
             UsePRTitleAsNotesHeading = $settings.Publish.Module.UsePRTitleAsNotesHeading ?? $true
@@ -243,12 +244,36 @@ LogGroup 'Calculate Job Run Conditions:' {
     $isMergedPR = $isPR -and $pullRequestAction -eq 'closed' -and $pullRequestIsMerged -eq $true
     $isNotAbandonedPR = -not $isAbandonedPR
 
+    # Check if a prerelease label was added or exists on the PR
+    $prereleaseLabels = $settings.Publish.Module.PrereleaseLabels -split ',' | ForEach-Object { $_.Trim() }
+    $prLabels = @($pullRequest.labels.name)
+    $hasPrereleaseLabel = ($prLabels | Where-Object { $prereleaseLabels -contains $_ }).Count -gt 0
+    $labelName = $eventData.Label.name
+    $isPrereleaseLabeled = $pullRequestAction -eq 'labeled' -and ($prereleaseLabels -contains $labelName)
+    $shouldPrerelease = $isPR -and (($isOpenOrUpdatedPR -and $hasPrereleaseLabel) -or $isPrereleaseLabeled)
+
+    # Determine ReleaseType - single source of truth for what Publish-PSModule should do
+    # Values: 'Release', 'Prerelease', 'Cleanup', 'None'
+    $releaseType = if (-not $isPR) {
+        'None'
+    } elseif ($isMergedPR) {
+        'Release'
+    } elseif ($isAbandonedPR) {
+        'Cleanup'
+    } elseif ($shouldPrerelease) {
+        'Prerelease'
+    } else {
+        'None'
+    }
+
     [pscustomobject]@{
         isPR              = $isPR
         isOpenOrUpdatedPR = $isOpenOrUpdatedPR
         isAbandonedPR     = $isAbandonedPR
         isMergedPR        = $isMergedPR
         isNotAbandonedPR  = $isNotAbandonedPR
+        shouldPrerelease  = $shouldPrerelease
+        ReleaseType       = $releaseType
     } | Format-List | Out-String
 }
 
@@ -438,7 +463,8 @@ LogGroup 'Calculate Job Run Conditions:' {
         GetCodeCoverage      = $isNotAbandonedPR -and (-not $settings.Test.CodeCoverage.Skip) -and (
             ($null -ne $settings.TestSuites.PSModule) -or ($null -ne $settings.TestSuites.Module)
         )
-        PublishModule        = $isPR -and ($isAbandonedPR -or ($isOpenOrUpdatedPR -or $isMergedPR))
+        PublishModule        = $releaseType -ne 'None'
+        ReleaseType          = $releaseType  # 'Release', 'Prerelease', 'Cleanup', or 'None'
         BuildDocs            = $isNotAbandonedPR -and (-not $settings.Build.Docs.Skip)
         BuildSite            = $isNotAbandonedPR -and (-not $settings.Build.Site.Skip)
         PublishSite          = $isMergedPR