Merge pull request #89 from VariableThe/fix/linux-glibc-runner

fix(ci): pin Linux runner to ubuntu-22.04 for glibc 2.35 compatibility

Author: VariableThe

.github/workflows/ci.yml

@@ -8,7 +8,7 @@ jobs:
   ci:
     strategy:
       matrix:
-        os: [macos-latest, ubuntu-latest, windows-latest]
+        os: [macos-latest, ubuntu-22.04, windows-latest]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
@@ -23,7 +23,7 @@ jobs:
       - run: npm run format:check
       - run: npm run test
       - name: Check version bump and new features note
-        if: matrix.os == 'ubuntu-latest' && github.event_name == 'pull_request'
+        if: startsWith(matrix.os, 'ubuntu') && github.event_name == 'pull_request'
         run: |
           git fetch origin main
           MAIN_VERSION=$(git show origin/main:package.json | grep '"version"' | head -1 | awk -F: '{ print $2 }' | sed 's/[", ]//g')

.github/workflows/release.yml

@@ -32,7 +32,7 @@ jobs:
     needs: create-tag
     strategy:
       matrix:
-        os: [macos-latest, ubuntu-latest, windows-latest]
+        os: [macos-latest, ubuntu-22.04, windows-latest]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
@@ -45,7 +45,7 @@ jobs:
           toolchain: stable
 
       - name: Install dependencies (Ubuntu only)
-        if: matrix.os == 'ubuntu-latest'
+        if: startsWith(matrix.os, 'ubuntu')
         run: |
           sudo apt-get update
           sudo apt-get install -y libwebkit2gtk-4.1-dev build-essential curl wget file libssl-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev

AUDIT_LOG.md

@@ -2,6 +2,16 @@
 
 This log tracks all significant changes, updates, and versions in the PaperCache project.
 
+## 2026-06-30 (Linux Runner Pinning for `glibc` Compatibility Fix)
+**Change:** fix(ci): pin Linux workflow runner to `ubuntu-22.04` across CI and release workflows to ensure `glibc 2.35` compatibility
+
+**Details/Why:**
+1. **Linux `glibc` Compatibility**: GitHub Actions updated `ubuntu-latest` to Ubuntu 24.04 LTS, which links built Tauri binaries and AppImages against `glibc 2.38`. When users on Ubuntu 22.04 LTS or Debian 12 attempted to launch the Linux AppImage or run the binary, the dynamic linker failed with `version glibc 2.38 not found`. Changed runner matrix from `ubuntu-latest` to `ubuntu-22.04` and updated conditional steps (`startsWith(matrix.os, 'ubuntu')`) so that compiled Linux artifacts target `glibc 2.35` and run seamlessly on Ubuntu 22.04 LTS and newer distros without requiring OS upgrades.
+
+**Files changed:** `.github/workflows/ci.yml`, `.github/workflows/release.yml`, `CHANGELOG.md`, `AUDIT_LOG.md`.
+
+---
+
 ## 2026-06-29 (v0.5.8 Release: Custom Evaluator, Strict Mode, Dep Cleanup)
 **Change:** chore(release): bump version to 0.5.8; replace expr-eval with custom arithmetic evaluator; enable TypeScript strict mode; remove unused dependencies; fix any type in onEvent helper; add coverage thresholds
 

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+- **Linux Compatibility (`glibc` version mismatch)**: Pinned GitHub Actions Linux runner to `ubuntu-22.04` across CI and release workflows instead of `ubuntu-latest` (Ubuntu 24.04). This ensures built Linux binaries and AppImages link against `glibc 2.35` so they can run out-of-the-box on Ubuntu 22.04 LTS, Debian 12, and other distributions without throwing `version glibc 2.38 not found` errors.
+
+
 ## [v0.5.8] - 2026-06-29
 
 ### Added