🌟 [Major]: Module manifests now stamped with the resolved version at build time

[Marius Storhaug (MariusStorhaug)]

Module manifests are now stamped with the resolved version and prerelease tag at build time. The resulting artifact contains its final ModuleVersion (and PrivateData.PSData.Prerelease) before tests run, so the bytes that are tested are the bytes that ship.

• Fixes Move version calculation to a Plan job (Resolve-PSModuleVersion) so Build and Publish never calculate or mutate versions Process-PSModule#326

Inputs on Build-PSModule

Build-PSModule now exposes new module-centric inputs:

Input	Required	Description
Name	No	Name of the module to build. Defaults to the repository name.
Version	Yes	Module version (Major.Minor.Patch) to stamp into the manifest. Build fails with a clear error when omitted or malformed.
Prerelease	No	Prerelease tag (for example mybranch001) to stamp into PrivateData.PSData.Prerelease. When empty, no prerelease tag is written.
OutputFolder	No	Path (relative to WorkingDirectory) where the built module is placed. Defaults to outputs/module.

Typical usage downstream of PSModule/Resolve-PSModuleVersion:

- name: Build module
  uses: PSModule/Build-PSModule@v5
  with:
    Version: ${{ steps.resolve.outputs.Version }}
    Prerelease: ${{ steps.resolve.outputs.Prerelease }}

Breaking changes

• Version is now required. Callers that previously omitted it (relying on the 999.0.0 placeholder) must now pass an explicit version in Major.Minor.Patch format. Builds fail immediately with a clear error when Version is missing or malformed.

Technical details

• action.yml: adds OutputFolder (default outputs/module), Version (required: true), and Prerelease inputs; Name remains optional and still defaults to the repository name.
• src/main.ps1: reads OutputFolder, Version, and Prerelease from env; throws immediately when Version is missing or not in Major.Minor.Patch format.
• src/helpers/Build-PSModule.ps1: ModuleVersion parameter is now [Parameter(Mandatory)].
• src/helpers/Build/Build-PSModuleManifest.ps1: ModuleVersion is [Parameter(Mandatory)]; the 999.0.0 fallback is removed — the version is assigned directly.

Related PRs:

• 🌟 [Major]: Module version resolution now available as a standalone action Resolve-PSModuleVersion#1 — emits the Version and Prerelease values consumed here.
• 🌟 [Major]: Version calculation removed — artifact must be pre-stamped before publish Publish-PSModule#71 — drops its own version stamping; expects the artifact to arrive pre-stamped.
• 🚀 [Feature]: Plan job decides version before build so tested artifact equals published artifact Process-PSModule#342 — wires the workflow end-to-end.

[Copilot]

Pull request overview

This PR updates the Build-PSModule GitHub Action so module manifests are stamped at build time with the resolved ModuleVersion and optional prerelease tag, ensuring the tested artifact matches what will be published.

Changes:

• Add/propagate action inputs for Version, Prerelease, and OutputFolder, and require Version.
• Stamp ModuleVersion (and prerelease via manifest generation) during Build-PSModuleManifest.
• Extend the Action-Test workflow to verify the generated manifest contains the expected version/prerelease values.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/main.ps1	Reads Version/Prerelease/OutputFolder inputs, enforces Version is provided, and passes values into Build-PSModule.
src/helpers/Build/Build-PSModuleManifest.ps1	Accepts ModuleVersion/ModulePrerelease parameters and uses them when generating the output manifest.
src/helpers/Build-PSModule.ps1	Makes ModuleVersion mandatory and forwards version/prerelease to manifest generation.
action.yml	Defines new inputs/environment wiring and marks Version as required.
.github/workflows/Action-Test.yml	Adds manifest verification steps (including prerelease scenario) and supplies required Version input in tests.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.