Release

Property	Value
description	Release discipline, packaging, and published release history policy for MAC CLI.
related	MAC CLI Log, Testing, RepoHelpers, GitHub CLI
urls	GitHub Releases

MAC CLI uses a dev -> main -> tag release flow.

Branch Discipline

• normal work happens on dev
• main stays release-only
• release verification happens on dev
• main is fast-forwarded from dev for the release
• the release tag is created from main
• the repo should end back on dev

Current Version Carriers

Release version is currently carried in:

• RepoHelpers/RepoHelpers.psd1
• AuthHelpers/AuthHelpers.psd1

Both manifests should stay aligned for normal releases.

Release Assets

Tagged releases publish:

• RepoHelpers-vX.Y.Z.zip
• AuthHelpers-vX.Y.Z.zip
• mac-cli-vX.Y.Z.zip
• SHA256SUMS.txt

Packaging and validation are handled through:

• scripts/build-release-assets.ps1
• scripts/upload-release-assets.ps1
• .github/workflows/ci.yml
• .github/workflows/release.yml

Minimum Release Validation

.\mac-cli-test.ps1
pwsh -NoProfile -File .\scripts\invoke-script-analyzer.ps1
pwsh -NoProfile -File .\scripts\build-release-assets.ps1 -Version v1.0.0 -Validate

Published History Policy

Published MAC CLI history starts at v1.0.0.

The current release log intentionally documents:

• the recreated v1.0.0 stable baseline
• future releases from that point forward

Older pre-reset tags are intentionally not part of the published product history.

Official Release History

See the published release history here:

• MAC CLI Log