🚀 [Feature]: Plan job decides version before build so tested artifact equals published artifact

.github/workflows/Build-Module.yml

@@ -12,6 +12,16 @@
         description: Name of the artifact to upload.
         required: false
         default: module
+      ModuleVersion:
+        type: string
+        description: The Major.Minor.Patch version to stamp into the built manifest. Empty falls back to '999.0.0'.
+        required: false
+        default: ''
+      ModulePrerelease:
+        type: string
+        description: Optional prerelease tag to stamp into the built manifest.
+        required: false
+        default: ''
 
 permissions:
   contents: read # to checkout the repository
@@ -30,8 +40,10 @@
           fetch-depth: 0
 
       - name: Build module
-        uses: PSModule/Build-PSModule@345728124d201f371a8b0f1aacb98f89000a06dc # v4.0.14
+        uses: PSModule/Build-PSModule@main
         with:
           Name: ${{ fromJson(inputs.Settings).Name }}
+          Version: ${{ inputs.ModuleVersion }}
+          Prerelease: ${{ inputs.ModulePrerelease }}
           ArtifactName: ${{ inputs.ArtifactName }}
           WorkingDirectory: ${{ fromJson(inputs.Settings).WorkingDirectory }}

.github/workflows/Get-Settings.yml → .github/workflows/Plan.yml

@@ -1,4 +1,10 @@
-name: Get-Settings
+name: Plan
+
+# The Plan job is the single decision point for the workflow.
+# It runs two steps:
+#   1. Get-PSModuleSettings  - loads and resolves configuration
+#   2. Resolve-PSModuleVersion - calculates the next version from settings + PR labels
+# All downstream jobs consume the Settings JSON and the resolved version outputs from this job.
 
 on:
   workflow_call:
@@ -45,19 +51,39 @@
 
     outputs:
       Settings:
-        description: The complete settings object including test suites
-        value: ${{ jobs.Get-Settings.outputs.Settings }}
+        description: The complete settings object including test suites.
+        value: ${{ jobs.Plan.outputs.Settings }}
+      ModuleVersion:
+        description: The Major.Minor.Patch part of the next version.
+        value: ${{ jobs.Plan.outputs.ModuleVersion }}
+      ModulePrerelease:
+        description: The prerelease tag, empty string when not a prerelease.
+        value: ${{ jobs.Plan.outputs.ModulePrerelease }}
+      ModuleFullVersion:
+        description: The full version string including prefix and prerelease tag (for example v1.4.0).
+        value: ${{ jobs.Plan.outputs.ModuleFullVersion }}
+      ReleaseType:
+        description: The release type - Release, Prerelease, or None.
+        value: ${{ jobs.Plan.outputs.ReleaseType }}
+      CreateRelease:
+        description: 'true when a release/prerelease should actually be created.'
+        value: ${{ jobs.Plan.outputs.CreateRelease }}
 
 permissions:
   contents: read        # to checkout the repo
-  pull-requests: write  # to add labels to PRs
+  pull-requests: write  # to add labels / comments to PRs
 
 jobs:
-  Get-Settings:
-    name: Get-Settings
+  Plan:
+    name: Plan
     runs-on: ubuntu-latest
     outputs:
       Settings: ${{ steps.Get-Settings.outputs.Settings }}
+      ModuleVersion: ${{ steps.Resolve-Version.outputs.Version }}
+      ModulePrerelease: ${{ steps.Resolve-Version.outputs.Prerelease }}
+      ModuleFullVersion: ${{ steps.Resolve-Version.outputs.FullVersion }}
+      ReleaseType: ${{ steps.Resolve-Version.outputs.ReleaseType }}
+      CreateRelease: ${{ steps.Resolve-Version.outputs.CreateRelease }}
     steps:
       - name: Checkout Code
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
@@ -76,3 +102,18 @@
           Version: ${{ inputs.Version }}
           WorkingDirectory: ${{ inputs.WorkingDirectory }}
           ImportantFilePatterns: ${{ inputs.ImportantFilePatterns }}
+
+      - name: Resolve-Version
+        # Resolve only when the workflow is going to create a release/prerelease.
+        if: fromJson(steps.Get-Settings.outputs.Settings).Publish.Module.ReleaseType != 'None'
+        uses: PSModule/Resolve-PSModuleVersion@main
+        id: Resolve-Version
+        env:
+          GH_TOKEN: ${{ github.token }}
+        with:
+          Settings: ${{ steps.Get-Settings.outputs.Settings }}
+          Debug: ${{ inputs.Debug }}
+          Prerelease: ${{ inputs.Prerelease }}
+          Verbose: ${{ inputs.Verbose }}
+          Version: ${{ inputs.Version }}
+          WorkingDirectory: ${{ inputs.WorkingDirectory }}

.github/workflows/Publish-Module.yml

@@ -13,7 +13,7 @@
         required: true
 
 permissions:
-  contents: write # to checkout the repo and create releases
+  contents: write # to checkout the repo, create releases, and upload release artifacts
   pull-requests: write # to comment on PRs
 
 jobs:
@@ -30,7 +30,7 @@
           fetch-depth: 0
 
       - name: Publish module
-        uses: PSModule/Publish-PSModule@8917aed588dae1bd1aa2873b1caec1c50c20d255 # v2.2.4
+        uses: PSModule/Publish-PSModule@main
         env:
           GH_TOKEN: ${{ github.token }}
         with:
@@ -39,15 +39,6 @@
           APIKey: ${{ secrets.APIKEY }}
           WhatIf: ${{ github.repository == 'PSModule/Process-PSModule' }}
           AutoCleanup: ${{ fromJson(inputs.Settings).Publish.Module.AutoCleanup }}
-          AutoPatching: ${{ fromJson(inputs.Settings).Publish.Module.AutoPatching }}
-          DatePrereleaseFormat: ${{ fromJson(inputs.Settings).Publish.Module.DatePrereleaseFormat }}
-          IgnoreLabels: ${{ fromJson(inputs.Settings).Publish.Module.IgnoreLabels }}
-          ReleaseType: ${{ fromJson(inputs.Settings).Publish.Module.ReleaseType }}
-          IncrementalPrerelease: ${{ fromJson(inputs.Settings).Publish.Module.IncrementalPrerelease }}
-          MajorLabels: ${{ fromJson(inputs.Settings).Publish.Module.MajorLabels }}
-          MinorLabels: ${{ fromJson(inputs.Settings).Publish.Module.MinorLabels }}
-          PatchLabels: ${{ fromJson(inputs.Settings).Publish.Module.PatchLabels }}
-          VersionPrefix: ${{ fromJson(inputs.Settings).Publish.Module.VersionPrefix }}
           UsePRTitleAsReleaseName: ${{ fromJson(inputs.Settings).Publish.Module.UsePRTitleAsReleaseName }}
           UsePRBodyAsReleaseNotes: ${{ fromJson(inputs.Settings).Publish.Module.UsePRBodyAsReleaseNotes }}
           UsePRTitleAsNotesHeading: ${{ fromJson(inputs.Settings).Publish.Module.UsePRTitleAsNotesHeading }}