Release: bump to 1.0.0 and publish to PSGallery

[tablackburn]

Part of #120 (Phase 5 — Release). This is the destination.

Scope

• Bump ModuleVersion to 1.0.0 in PowerShellBuild.psd1
• In the same commit, point the PSData URLs (LicenseUri, IconUri, ReleaseNotes) at /main/ rather than /master/. There is no master branch; those links resolve today only through GitHub's branch-rename redirect.
• Cut the 1.0.0 GitHub Release. Publishing it triggers .github/workflows/publish.yaml, which runs the full test suite and then Publish-Module with the PSGALLERY_API_KEY repository secret — the path that published 0.8.0, 0.8.1 and 0.8.2.

Cut 1.0.0-rc1 and soak ≥ 7 days — dropped 2026-09-04. The install-time risk the rc existed for is covered two other ways: Publish-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

• Release: finalize the migration guide, test the AI prompt, write the 1.0.0 changelog #159 closed — the guide's coherence pass and the 1.0.0 changelog entry
• CI: Install the built module from a local repository to verify install-time dependency behaviour #229 green on main
• A workflow_dispatch run of publish.yaml against main has completed — done 2026-09-04, run 33914510553: checkout@v7, bootstrap, and the psake chain Init Clean Build Analyze Pester all ran on the ubuntu runner (558 passed, 0 failed, 33 Windows-only skips), and the only failure was Publish-Module refusing 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 ci: bump actions/checkout from 4 to 7 in the github-actions group #214), bootstrap and the full suite on the runner, and is expected to fail only at Publish-Module because 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 — Tests: Clear-PSBuildOutputFolder #94 and Tests: Initialize-PSBuild #95 unmilestoned during charting and since closed. Tests: Build-PSBuildModule #98 and Tests: Publish-PSBuildModule #103 were restored to v1.0.0 on 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 cover Build-PSBuildModule asserts on file text only, so it passes over a module that exports nothing ($PSBPreference.Build.CompileModule can silently produce a module that exports nothing #201)
• Every public function has coverage of its own, and $PSBPreference.Build.CompileModule can silently produce a module that exports nothing #201 is resolved
• The migration guide is complete and the AI prompt is tested against a sample consumer build.ps1
• 1.0.0-rc1 has soaked ≥ 7 days with no blocker reports

Done when

PowerShellBuild 1.0.0 is on PSGallery. The map is complete.