🚀 [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@v4.1
         with:
           Name: ${{ fromJson(inputs.Settings).Name }}
+          Version: ${{ inputs.ModuleVersion }}
+          Prerelease: ${{ inputs.ModulePrerelease }}
           ArtifactName: ${{ inputs.ArtifactName }}
           WorkingDirectory: ${{ fromJson(inputs.Settings).WorkingDirectory }}

.github/workflows/Plan.yml

@@ -0,0 +1,119 @@
+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:
+    inputs:
+      SettingsPath:
+        type: string
+        description: The path to the settings file.
+        required: false
+      Debug:
+        type: boolean
+        description: Enable debug output.
+        required: false
+        default: false
+      Verbose:
+        type: boolean
+        description: Enable verbose output.
+        required: false
+        default: false
+      Version:
+        type: string
+        description: Specifies the version of the GitHub module to be installed. The value must be an exact version.
+        required: false
+        default: ''
+      Prerelease:
+        type: boolean
+        description: Whether to use a prerelease version of the 'GitHub' module.
+        required: false
+        default: false
+      WorkingDirectory:
+        type: string
+        description: The path to the root of the repo.
+        required: false
+        default: '.'
+      ImportantFilePatterns:
+        type: string
+        description: |
+          Newline-separated list of regex patterns that identify important files.
+          Changes matching these patterns trigger build, test, and publish stages.
+          When set, fully replaces the defaults (^src/ and ^README\.md$).
+        required: false
+        default: |
+          ^src/
+          ^README\.md$
+
+    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 / comments to PRs
+
+jobs:
+  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
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+
+      - name: Get-Settings
+        uses: PSModule/Get-PSModuleSettings@1e3d156786c56e6fbd839a1ba5ab21ff8858090e # v1.5.0
+        id: Get-Settings
+        with:
+          SettingsPath: ${{ inputs.SettingsPath }}
+          Debug: ${{ inputs.Debug }}
+          Prerelease: ${{ inputs.Prerelease }}
+          Verbose: ${{ inputs.Verbose }}
+          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@65b7cb026cb3414943778473fd82ee6cf4f0363e # v1.0.1
+        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 }}