mfoltz · mfoltz · May 18, 2026 · Oct 23, 2025 · Oct 23, 2025 · Oct 24, 2025
diff --git a/.codex/scripts/bump-version.ps1 b/.codex/scripts/bump-version.ps1
@@ -0,0 +1,108 @@
+param(
+    [Parameter(Mandatory = $true)]
+    [ValidatePattern('^\d+\.\d+\.\d+$')]
+    [string]$Version,
+
+    [switch]$AllowEmptyChangelog
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+$ScriptRoot = Split-Path -Parent $MyInvocation.MyCommand.Path
+$RepoRoot = Split-Path -Parent (Split-Path -Parent $ScriptRoot)
+
+$ProjectPath = Join-Path $RepoRoot "RetroCamera.csproj"
+$ThunderstorePath = Join-Path $RepoRoot "thunderstore.toml"
+$ChangelogPath = Join-Path $RepoRoot "CHANGELOG.md"
+
+function Set-TextPreservingUtf8Bom {
+    param(
+        [Parameter(Mandatory = $true)]
+        [string]$Path,
+        [Parameter(Mandatory = $true)]
+        [string]$Value
+    )
+
+    $Bytes = [System.IO.File]::ReadAllBytes($Path)
+    $HasUtf8Bom = $Bytes.Length -ge 3 -and $Bytes[0] -eq 0xEF -and $Bytes[1] -eq 0xBB -and $Bytes[2] -eq 0xBF
+    $Encoding = [System.Text.UTF8Encoding]::new($HasUtf8Bom)
+    [System.IO.File]::WriteAllText($Path, $Value, $Encoding)
+}
+
+function Update-Changelog {
+    param(
+        [Parameter(Mandatory = $true)]
+        [string]$Path,
+        [Parameter(Mandatory = $true)]
+        [string]$Version,
+        [Parameter(Mandatory = $true)]
+        [bool]$AllowEmpty
+    )
+
+    $Text = Get-Content -Raw -Path $Path
+
+    if ($Text -notmatch '(?m)^# Changelog\s*$') {
+        throw "CHANGELOG.md must start with a '# Changelog' heading."
+    }
+
+    $VersionHeadingPattern = '(?m)^## v' + [regex]::Escape($Version) + '$'
+    if ($Text -match $VersionHeadingPattern) {
+        throw "CHANGELOG.md already contains a v$Version entry."
+    }
+
+    $UnreleasedPattern = '(?ms)^## Unreleased\s*(?<body>.*?)(?=^## |\z)'
+    $Match = [regex]::Match($Text, $UnreleasedPattern)
+    if (-not $Match.Success) {
+        throw "CHANGELOG.md must contain an '## Unreleased' section before bumping."
+    }
+
+    $Body = $Match.Groups["body"].Value.Trim()
+    if (-not $AllowEmpty -and [string]::IsNullOrWhiteSpace($Body)) {
+        throw "CHANGELOG.md '## Unreleased' is empty. Use -AllowEmptyChangelog to bump anyway."
+    }
+
+    $ReleasedBody = if ([string]::IsNullOrWhiteSpace($Body)) { "- No user-facing changes recorded." } else { $Body }
+    $Replacement = "## Unreleased`r`n`r`n## v$Version`r`n`r`n$ReleasedBody`r`n`r`n"
+    $Updated = $Text.Substring(0, $Match.Index) + $Replacement + $Text.Substring($Match.Index + $Match.Length)
+    Set-TextPreservingUtf8Bom -Path $Path -Value $Updated
+}
+
+function Update-FirstMatch {
+    param(
+        [Parameter(Mandatory = $true)]
+        [string]$Path,
+        [Parameter(Mandatory = $true)]
+        [string]$Pattern,
+        [Parameter(Mandatory = $true)]
+        [string]$Replacement,
+        [Parameter(Mandatory = $true)]
+        [string]$Description
+    )
+
+    $Text = Get-Content -Raw -Path $Path
+    $Regex = [regex]::new($Pattern, [System.Text.RegularExpressions.RegexOptions]::Multiline)
+    $Match = $Regex.Match($Text)
+    if (-not $Match.Success) {
+        throw "Unable to update $Description in $Path."
+    }
+
+    $Updated = $Text.Substring(0, $Match.Index) + $Regex.Replace($Match.Value, $Replacement, 1) + $Text.Substring($Match.Index + $Match.Length)
+    Set-TextPreservingUtf8Bom -Path $Path -Value $Updated
+}
+
+Update-FirstMatch `
+    -Path $ProjectPath `
+    -Pattern '<Version>[^<]+</Version>' `
+    -Replacement "<Version>$Version</Version>" `
+    -Description "project version"
+
+Update-FirstMatch `
+    -Path $ThunderstorePath `
+    -Pattern '^versionNumber = "[^"]+"' `
+    -Replacement "versionNumber = `"$Version`"" `
+    -Description "Thunderstore version"
+
+Update-Changelog -Path $ChangelogPath -Version $Version -AllowEmpty:$AllowEmptyChangelog.IsPresent
+
+Write-Host "Updated RetroCamera version metadata to $Version."
diff --git a/.codex/scripts/prerelease-notes.sh b/.codex/scripts/prerelease-notes.sh
@@ -0,0 +1,171 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(dirname "$(dirname "$SCRIPT_DIR")")"
+
+CHANGELOG_PATH="$REPO_ROOT/CHANGELOG.md"
+VERSION=""
+TAG=""
+BRANCH=""
+COMMIT=""
+RUN_ID=""
+OUTPUT_PATH=""
+CHECK_ONLY="false"
+
+fail() {
+    echo "Error: $1" >&2
+    exit 1
+}
+
+usage() {
+    cat >&2 <<'EOF'
+Usage: prerelease-notes.sh --version X.Y.Z [options]
+
+Options:
+  --changelog PATH   CHANGELOG.md path to read.
+  --tag TAG          GitHub Release tag. Defaults to vX.Y.Z-pre.
+  --branch NAME      Source branch name for the notes card.
+  --commit SHA       Source commit SHA for the notes card.
+  --run-id ID        GitHub Actions run id for the notes card.
+  --output PATH      Markdown file to write.
+  --check-only       Validate changelog turnover without writing notes.
+EOF
+}
+
+while [ "$#" -gt 0 ]; do
+    case "$1" in
+        --changelog)
+            CHANGELOG_PATH="${2:-}"
+            shift 2
+            ;;
+        --version)
+            VERSION="${2:-}"
+            shift 2
+            ;;
+        --tag)
+            TAG="${2:-}"
+            shift 2
+            ;;
+        --branch)
+            BRANCH="${2:-}"
+            shift 2
+            ;;
+        --commit)
+            COMMIT="${2:-}"
+            shift 2
+            ;;
+        --run-id)
+            RUN_ID="${2:-}"
+            shift 2
+            ;;
+        --output)
+            OUTPUT_PATH="${2:-}"
+            shift 2
+            ;;
+        --check-only)
+            CHECK_ONLY="true"
+            shift
+            ;;
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        *)
+            usage
+            fail "Unknown argument '$1'."
+            ;;
+    esac
+done
+
+if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+    fail "--version must use canonical X.Y.Z format."
+fi
+
+if [ -z "$TAG" ]; then
+    TAG="v${VERSION}-pre"
+fi
+
+if [ ! -f "$CHANGELOG_PATH" ]; then
+    fail "Unable to locate changelog at '$CHANGELOG_PATH'."
+fi
+
+if ! grep -Eq '^##[[:space:]]*Unreleased[[:space:]]*$' "$CHANGELOG_PATH"; then
+    fail "CHANGELOG.md must contain a ## Unreleased section before creating or publishing a prerelease."
+fi
+
+unreleased_body=$(
+    awk '
+        /^##[[:space:]]*Unreleased[[:space:]]*$/ { in_unreleased = 1; next }
+        in_unreleased && /^## / { exit }
+        in_unreleased { print }
+    ' "$CHANGELOG_PATH"
+)
+
+if printf '%s' "$unreleased_body" | grep -q '[^[:space:]]'; then
+    fail "CHANGELOG.md ## Unreleased must be empty before creating or publishing a prerelease."
+fi
+
+version_body=$(
+    awk -v version="$VERSION" '
+        $0 == "## v" version { in_version = 1; next }
+        in_version && /^## / { exit }
+        in_version { print }
+    ' "$CHANGELOG_PATH"
+)
+
+if ! printf '%s' "$version_body" | grep -q '[^[:space:]]'; then
+    fail "CHANGELOG.md does not contain notes for '$VERSION'."
+fi
+
+if [ "$CHECK_ONLY" = "true" ]; then
+    echo "prerelease-notes: changelog turnover validated for $VERSION."
+    exit 0
+fi
+
+if [ -z "$OUTPUT_PATH" ]; then
+    fail "--output is required unless --check-only is used."
+fi
+
+BRANCH="${BRANCH:-unknown}"
+COMMIT="${COMMIT:-unknown}"
+RUN_ID="${RUN_ID:-unknown}"
+short_commit="$COMMIT"
+if [ ${#short_commit} -gt 12 ]; then
+    short_commit="${short_commit:0:12}"
+fi
+
+run_detail="\`$RUN_ID\`"
+if [ -n "${GITHUB_REPOSITORY:-}" ] && [ "$RUN_ID" != "unknown" ]; then
+    run_detail="[${RUN_ID}](https://github.com/${GITHUB_REPOSITORY}/actions/runs/${RUN_ID})"
+fi
+
+handoff_heading="### Thunderstore handoff"
+if [ -n "${GITHUB_REPOSITORY:-}" ] && [ "$COMMIT" != "unknown" ]; then
+    handoff_heading="<p><img src=\"https://raw.githubusercontent.com/${GITHUB_REPOSITORY}/${COMMIT}/.github/assets/ts_badge.png\" alt=\"Thunderstore handoff\" width=\"96\" /></p>"
+fi
+
+mkdir -p "$(dirname "$OUTPUT_PATH")"
+cat > "$OUTPUT_PATH" <<EOF
+## RetroCamera ${VERSION} pre-release
+
+> [!NOTE]
+> This GitHub pre-release is the source artifact for the matching Thunderstore publish. Thunderstore receives package version \`${VERSION}\` from tag \`${TAG}\`.
+
+${handoff_heading}
+
+| Signal | Detail |
+| --- | --- |
+| Changelog | \`## Unreleased\` is empty; notes below come from \`v${VERSION}\`. |
+| Branch | \`${BRANCH}\` |
+| Commit | \`${short_commit}\` |
+| Run | ${run_detail} |
+| Tag | \`${TAG}\` |
+| Package | \`${VERSION}\` |
+
+### Changes
+
+${version_body}
+EOF
+
+echo "prerelease-notes: wrote $OUTPUT_PATH"