From 29a4a5d229b3506f6767c649840ee21dc927d447 Mon Sep 17 00:00:00 2001
From: Aditya <slayermk57@gmail.com>
Date: Tue, 30 Jun 2026 21:14:03 +0530
Subject: [PATCH] fix(ci): pin Linux workflow runner to ubuntu-22.04 for glibc
 2.35 compatibility

---
 .github/workflows/ci.yml      |  4 ++--
 .github/workflows/release.yml |  4 ++--
 AUDIT_LOG.md                  | 10 ++++++++++
 CHANGELOG.md                  |  4 ++++
 4 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index ca1a255..661b8ce 100644
--- a/.github/workflows/ci.yml
+++ b/.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')
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 3d5b68d..cc5cc42 100644
--- a/.github/workflows/release.yml
+++ b/.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
diff --git a/AUDIT_LOG.md b/AUDIT_LOG.md
index 0deb1f6..03f91d1 100644
--- a/AUDIT_LOG.md
+++ b/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
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2d16018..1b72ef0 100644
--- a/CHANGELOG.md
+++ b/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