🩹 [Patch]: Prerelease cleanup no longer depends on module artifact (#400)

Prerelease cleanup now runs as an independent workflow action, so
publish logic and cleanup logic can execute in the right scenarios
without being coupled to module artifact download.

## Changed: Publish and cleanup are now separate actions
`Publish-PSModule` now only performs artifact download and
publish/release work, while cleanup moved into a dedicated
`Cleanup-PSModulePrereleases` action.

## Fixed: No-build cleanup paths no longer depend on publish action
internals
`Publish-Module.yml` now runs publish only when `ReleaseType != 'None'`,
and runs cleanup independently when `ReleaseType != 'Prerelease'` with
existing AutoCleanup and WhatIf controls.

## Technical Details
- Removed cleanup inputs and cleanup step from
`.github/actions/Publish-PSModule/action.yml`.
- Added `.github/actions/Cleanup-PSModulePrereleases/` with its own
composite action and cleanup script.
- Updated `.github/workflows/Publish-Module.yml` to call the two actions
as separate, scenario-gated steps.
- Preserved release-tag exclusion by passing
`PSMODULE_PUBLISH_PSMODULE_CONTEXT_ReleaseTag` into the cleanup action
when publish ran earlier in the job.
- Implementation plan progress: completed the decoupling requested in
issue #376 by separating cleanup from publish artifact flow.

<details>
<summary>Related issues</summary>

- Fixes #376

</details>

---------

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: MariusStorhaug

.github/actions/Cleanup-PSModulePrereleases/action.yml

@@ -0,0 +1,34 @@
+name: Cleanup-PSModulePrereleases
+description: Cleanup prerelease GitHub releases associated with the current pull request branch.
+author: PSModule
+
+inputs:
+  AutoCleanup:
+    description: Control whether to automatically delete prerelease tags.
+    required: false
+    default: 'true'
+  WhatIf:
+    description: If specified, the action will only log the changes it would make.
+    required: false
+    default: 'false'
+  WorkingDirectory:
+    description: The working directory where the script will run from.
+    required: false
+    default: '.'
+
+runs:
+  using: composite
+  steps:
+    - name: Install-PSModule
+      uses: ./_wf/.github/actions/Install-PSModule
+
+    - name: Cleanup Prereleases
+      if: inputs.AutoCleanup == 'true' || inputs.WhatIf == 'true'
+      shell: pwsh
+      working-directory: ${{ inputs.WorkingDirectory }}
+      env:
+        PSMODULE_CLEANUP_PSMODULEPRERELEASES_INPUT_WhatIf: ${{ inputs.WhatIf }}
+        PSMODULE_CLEANUP_PSMODULEPRERELEASES_CONTEXT_ReleaseTag: ${{ env.PSMODULE_PUBLISH_PSMODULE_CONTEXT_ReleaseTag }}
+      run: |
+        # Cleanup prerelease tags
+        ${{ github.action_path }}/src/cleanup.ps1

…actions/Publish-PSModule/src/cleanup.ps1 …anup-PSModulePrereleases/src/cleanup.ps1.github/actions/Publish-PSModule/src/cleanup.ps1 renamed to .github/actions/Cleanup-PSModulePrereleases/src/cleanup.ps1 .github/actions/Publish-PSModule/src/cleanup.ps1 renamed to .github/actions/Cleanup-PSModulePrereleases/src/cleanup.ps1

@@ -7,7 +7,7 @@ Import-Module -Name 'Helpers' -Force
 
 #region Load inputs
 LogGroup 'Load inputs' {
-    $whatIf = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_WhatIf -eq 'true'
+    $whatIf = $env:PSMODULE_CLEANUP_PSMODULEPRERELEASES_INPUT_WhatIf -eq 'true'
 
     $githubEventJson = Get-Content -Raw $env:GITHUB_EVENT_PATH
     $githubEvent = $githubEventJson | ConvertFrom-Json
@@ -27,7 +27,7 @@ LogGroup 'Load inputs' {
     Write-Host "Prerelease name:  [$prereleaseName]"
     Write-Host "WhatIf:           [$whatIf]"
 
-    $publishedReleaseTag = $env:PSMODULE_PUBLISH_PSMODULE_CONTEXT_ReleaseTag
+    $publishedReleaseTag = $env:PSMODULE_CLEANUP_PSMODULEPRERELEASES_CONTEXT_ReleaseTag
     if (-not [string]::IsNullOrWhiteSpace($publishedReleaseTag)) {
         Write-Host "Published tag:    [$publishedReleaseTag] (excluded from cleanup)"
     }

.github/actions/Publish-PSModule/action.yml

@@ -7,16 +7,12 @@ inputs:
     description: Name of the module to publish.
     required: false
   ModulePath:
-    description: Path to the folder containing the <Name>/ module subdirectory from Build-PSModule. A module artifact must exist before invoking this action.
+    description: Path to the folder containing the <Name>/ module subdirectory from Build-PSModule.
     required: false
     default: outputs/module
   APIKey:
     description: PowerShell Gallery API Key.
     required: true
-  AutoCleanup:
-    description: Control whether to automatically delete the prerelease tags after the stable release is created.
-    required: false
-    default: 'true'
   WhatIf:
     description: If specified, the action will only log the changes it would make, but will not actually create or delete any releases or tags.
     required: false
@@ -71,14 +67,3 @@ runs:
         PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRTitleAsReleaseName: ${{ inputs.UsePRTitleAsReleaseName }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRTitleAsNotesHeading: ${{ inputs.UsePRTitleAsNotesHeading }}
       run: ${{ github.action_path }}/src/publish.ps1
-
-    - name: Cleanup Prereleases
-      if: env.PSMODULE_PUBLISH_PSMODULE_CONTEXT_IsPrerelease != 'true' && (inputs.AutoCleanup == 'true' || inputs.WhatIf == 'true')
-      shell: pwsh
-      working-directory: ${{ inputs.WorkingDirectory }}
-      env:
-        PSMODULE_PUBLISH_PSMODULE_INPUT_WhatIf: ${{ inputs.WhatIf }}
-        PSMODULE_PUBLISH_PSMODULE_CONTEXT_ReleaseTag: ${{ env.PSMODULE_PUBLISH_PSMODULE_CONTEXT_ReleaseTag }}
-      run: |
-        # Cleanup prerelease tags
-        ${{ github.action_path }}/src/cleanup.ps1

.github/actions/Publish-PSModule/src/publish.ps1

@@ -140,9 +140,7 @@ LogGroup 'Resolve version from manifest' {
         PRHeadRef        = $prHeadRef
     } | Format-List | Out-String
 
-    # Expose publish context to subsequent steps so the cleanup step can gate on release type.
-    $envLine = "PSMODULE_PUBLISH_PSMODULE_CONTEXT_IsPrerelease=$($createPrerelease.ToString().ToLower())"
-    $envLine | Out-File -Path $env:GITHUB_ENV -Append -Encoding utf8NoBOM
+    # Expose release tag to subsequent steps so cleanup can exclude the just-published tag.
     "PSMODULE_PUBLISH_PSMODULE_CONTEXT_ReleaseTag=$releaseTag" | Out-File -Path $env:GITHUB_ENV -Append -Encoding utf8NoBOM
 }
 #endregion Resolve version from manifest

.github/workflows/Publish-Module.yml

@@ -38,6 +38,7 @@ jobs:
           persist-credentials: false
 
       - name: Publish module
+        if: fromJson(inputs.Settings).Publish.Module.Resolution.ReleaseType != 'None'
         uses: ./_wf/.github/actions/Publish-PSModule
         env:
           GH_TOKEN: ${{ github.token }}
@@ -46,8 +47,17 @@ jobs:
           ModulePath: outputs/module
           APIKey: ${{ secrets.APIKey }}
           WhatIf: ${{ github.repository == 'PSModule/Process-PSModule' }}
-          AutoCleanup: ${{ fromJson(inputs.Settings).Publish.Module.AutoCleanup }}
           UsePRTitleAsReleaseName: ${{ fromJson(inputs.Settings).Publish.Module.UsePRTitleAsReleaseName }}
           UsePRBodyAsReleaseNotes: ${{ fromJson(inputs.Settings).Publish.Module.UsePRBodyAsReleaseNotes }}
           UsePRTitleAsNotesHeading: ${{ fromJson(inputs.Settings).Publish.Module.UsePRTitleAsNotesHeading }}
           WorkingDirectory: ${{ fromJson(inputs.Settings).WorkingDirectory }}
+
+      - name: Cleanup prereleases
+        if: fromJson(inputs.Settings).Publish.Module.Resolution.ReleaseType != 'Prerelease'
+        uses: ./_wf/.github/actions/Cleanup-PSModulePrereleases
+        env:
+          GH_TOKEN: ${{ github.token }}
+        with:
+          WhatIf: ${{ github.repository == 'PSModule/Process-PSModule' }}
+          AutoCleanup: ${{ fromJson(inputs.Settings).Publish.Module.AutoCleanup }}
+          WorkingDirectory: ${{ fromJson(inputs.Settings).WorkingDirectory }}