# Release Process PureYAML versioning is driven by Git tags. The current release is 0.4.1. ## 0.4.1 Release - Swift tools version: 6.1 - Products: `PureYAML`, `PureYAMLJSON` - SwiftPM dependencies: none - Source targets: Swift only, no C targets and no generated parser targets - Hosted CI matrix: macOS build and test, Linux build and test, Windows build and test, WASM build - Release notes file: `docs/releases/pureyaml-0-4-1.md` ## Local Verification Run the full gate from a clean checkout before tagging: ```sh git status --short --branch bash scripts/check-all.sh ``` `scripts/check-all.sh` expands to: ```sh bash scripts/check-style.sh bash scripts/check-namespacing.sh bash scripts/check-forbidden-patterns.sh bash scripts/check-changelog-touched.sh swiftformat . --config .swiftformat --lint swiftlint --config .swiftlint.yml --strict swift build swift test bash scripts/check-linux.sh bash scripts/check-wasm.sh ``` The Linux and Windows checks must exercise build and tests. The WASM check must build the library target with the configured Swift Wasm SDK. On the machine that hosts the Swift SDKs and the swift.org toolchain on an external disk (`/Volumes/Code2/DeveloperExt/swift`, with a README), name the installed ones, since the script defaults to 6.3.2: ```sh SWIFT_WASM_SDK_ID=swift-6.3.3-RELEASE_wasm \ SWIFT_WASM_SWIFT="$HOME/Library/Developer/Toolchains/swift-6.3.3-RELEASE.xctoolchain/usr/bin/swift" \ bash scripts/check-wasm.sh ``` ## Hosted Verification Push `main` and wait for the CI workflow to pass: ```sh git push origin main ``` Watch the run at . Until the full platform matrix runs on Codeberg runners, the authoritative platform gates are the local ones (`scripts/check-all.sh` covers macOS, the Linux relay, and WASM); Windows verification is deferred and must be disclosed in the release notes. ## Tag and Publish Only run these commands after the local gates pass and hosted CI passes. ```sh git status --short --branch git tag -a 0.4.1 -m "PureYAML 0.4.1" git push origin main 0.4.1 tea releases create --login aleahim --repo NodetteHQ/PureYAML \ --tag 0.4.1 --title "PureYAML 0.4.1" \ --note "$(cat docs/releases/pureyaml-0-4-1.md)" ``` After publishing, verify the release exists: ```sh git ls-remote --tags origin 0.4.1 tea releases list --login aleahim --repo NodetteHQ/PureYAML | head ``` ## Do Not Tag If - `Package.swift` has any external dependency. - `Sources/` contains C, JavaScript, WebAssembly blobs, or generated parser runtime files. - Any Swift source imports Foundation in the library target. - The changelog does not have a dated section for the version being tagged. - The release notes omit known deferred issues. - Any locally runnable platform gate (macOS, Linux relay, WASM) is red, or a skipped platform is not disclosed in the release notes.