Release: bump to 1.0.0 and publish to PSGallery
Nobody has claimed this yet.
- Dominant language
- PowerShell
- Stars
- 145
- Forks
- 27
- Avg merge
- 10h 16m
- Merged PRs (30d)
- 34
Description
Part of #120 (Phase 5 — Release). This is the destination.
Scope
- Bump
ModuleVersionto1.0.0inPowerShellBuild.psd1 - In the same commit, point the
PSDataURLs (LicenseUri,IconUri,ReleaseNotes) at/main/rather than/master/. There is nomasterbranch; those links resolve today only through GitHub's branch-rename redirect. - Cut the
1.0.0GitHub Release. Publishing it triggers.github/workflows/publish.yaml, which runs the full test suite and thenPublish-Modulewith thePSGALLERY_API_KEYrepository secret — the path that published 0.8.0, 0.8.1 and 0.8.2.
Cut — dropped 2026-09-04. The install-time risk the rc existed for is covered two other ways: 1.0.0-rc1 and soak ≥ 7 daysPublish-Module itself refuses to publish a package whose RequiredModules cannot be resolved on the destination repository, so an unsatisfiable dependency fails the release rather than reaching consumers; and #229 installs the built module from a local repository in CI on both editions. What the rc uniquely offered was consumer exposure, which prerelease build tooling does not get in practice. Recorded on #120.
Pre-flight before tagging
- #159 closed — the guide's coherence pass and the 1.0.0 changelog entry
- #229 green on
main - A
workflow_dispatchrun ofpublish.yamlagainstmainhas completed — done 2026-09-04, run 33914510553:checkout@v7, bootstrap, and the psake chainInit Clean Build Analyze Pesterall ran on the ubuntu runner (558 passed, 0 failed, 33 Windows-only skips), and the only failure wasPublish-Modulerefusing 0.8.2 as already published on the gallery. The manual-trigger recovery path is therefore proven too. It exercises checkout v7 (first use since #214), bootstrap and the full suite on the runner, and is expected to fail only atPublish-Modulebecause 0.8.2 already exists on the gallery — the whole workflow proven except the upload, at zero risk. The manual trigger failed the one time it was used and its logs have expired, so this also verifies the recovery path in advance.
Gate
Blocked on the release documentation being final. Everything else in the map must be closed or explicitly ruled out of scope before this opens.
Definition of done (from #120)
- Every in-scope item is closed
- The Phase 4 milestone discrepancy is resolved — #94 and #95 unmilestoned during charting and since closed. #98 and #103 were restored to
v1.0.0on 2026-08-28 and now block this issue: they are the only two public functions without coverage of their own, and the compile-mode test that appeared to coverBuild-PSBuildModuleasserts on file text only, so it passes over a module that exports nothing (#201) - Every public function has coverage of its own, and #201 is resolved
- The migration guide is complete and the AI prompt is tested against a sample consumer
build.ps1 1.0.0-rc1has soaked ≥ 7 days with no blocker reports
Done when
PowerShellBuild 1.0.0 is on PSGallery. The map is complete.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with PowerShellBuild.psd1 and .github/workflows/publish.yaml, then verify the pre-flight dependencies #159, #229, #98, #103, and #201 before changing release metadata. Confirm the documentation and coverage gates are complete, then create the 1.0.0 GitHub Release so the workflow publishes the module to PSGallery. Done means PowerShellBuild 1.0.0 is available on PSGallery and the release map is complete.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github-actions, powershell
- Domain
- ci-cd, release
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100