ci(release): derive canary version from git tags (single source of truth)

Every release workflow hardcoded a canary base version (0.5.0 in
Apple/Android/rpm/flatpak/deb, 0.3 in windows-msix/windows-host/decky) that
had to be hand-bumped on each stable release and wasn't. With stable at
v0.6.0, every canary was a version *behind* stable — e.g. the Apple canary
showed up on TestFlight as 0.5.0 while 0.6.0 was already published.

Add scripts/ci/pf-version.{sh,ps1} (bash + pwsh twin) as the single source of
truth: stable = the vX.Y.Z tag; canary = latest stable tag with minor+1,
patch 0 (v0.6.0 -> 0.7.0), so canary is always exactly one minor ahead of the
newest release with zero maintenance. Falls back to the workspace Cargo.toml
version when no tag is fetchable. All workflows now eval/call it and format
their own channel suffix off $PF_BASE; only the canary branch changed, stable
branches and per-channel suffixes are untouched. channels.md drops the old
manual "bump the canary base" release step.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-07-03 22:40:25 +00:00
parent 38078fe7ee
commit 4de543c146
10 changed files with 186 additions and 22 deletions
+55
View File
@@ -0,0 +1,55 @@
# Single source of truth for punktfunk release/canary version numbers (Windows runners).
#
# The pwsh twin of scripts/ci/pf-version.sh — see that file for the full rationale. Same rule:
# * stable (vX.Y.Z tag) -> PF_BASE = X.Y.Z (minus any -rc/+meta suffix)
# * canary (main push) -> PF_BASE = <latest stable tag with minor+1, patch 0> (always one ahead)
#
# Returns a hashtable AND (when $env:GITHUB_ENV is set) appends the same keys there for later
# steps. Usage in a pwsh workflow step:
# $pf = & "$env:GITHUB_WORKSPACE/scripts/ci/pf-version.ps1"
# $base = $pf.PF_BASE # e.g. "0.7.0"
# # numeric-version channels (MSIX/host installer) build "<major>.<minor>.<run>":
# $v = "$($pf.PF_MAJOR).$($pf.PF_MINOR).$env:GITHUB_RUN_NUMBER"
$ErrorActionPreference = 'Stop'
# A non-zero native-command exit (e.g. a `git fetch` with no network) must NOT abort — the
# Cargo.toml fallback below covers it. On PS 7.4+ this pref would otherwise throw under -Stop.
$PSNativeCommandUseErrorActionPreference = $false
$root = (Resolve-Path (Join-Path $PSScriptRoot '..\..')).Path
# checkout is shallow + tagless by default — canary needs the tag list. Best-effort.
try { git -C $root fetch --tags --force --quiet 2>$null } catch { }
$stable = (git -C $root tag -l 'v*' 2>$null) |
ForEach-Object { if ($_ -match '^v(\d+\.\d+\.\d+)$') { $Matches[1] } } |
Sort-Object { [version]$_ } |
Select-Object -Last 1
if (-not $stable) {
$stable = (Select-String -Path (Join-Path $root 'Cargo.toml') -Pattern '^version = "(\d+\.\d+\.\d+)"' |
Select-Object -First 1).Matches.Groups[1].Value
}
if (-not $stable) { $stable = '0.0.0' }
if ($env:GITHUB_REF -like 'refs/tags/v*') {
$channel = 'stable'
$base = (($env:GITHUB_REF_NAME -replace '^v', '') -replace '[-+].*$', '')
} else {
$channel = 'canary'
$p = $stable.Split('.')
$base = "$($p[0]).$([int]$p[1] + 1).0"
}
$b = $base.Split('.')
$out = [ordered]@{
PF_CHANNEL = $channel
PF_BASE = $base
PF_MAJOR = $b[0]
PF_MINOR = $b[1]
PF_PATCH = $b[2]
PF_STABLE_TAG = $stable
}
foreach ($k in $out.Keys) {
Write-Output ("{0}={1}" -f $k, $out[$k]) | Out-Null
if ($env:GITHUB_ENV) { "$k=$($out[$k])" | Out-File -FilePath $env:GITHUB_ENV -Append -Encoding utf8 }
}
$out