From 169d5be00ce15529b5f2833cdb8023b5a56964b9 Mon Sep 17 00:00:00 2001
From: RocketQuack <202538874+Rocket-Quack@users.noreply.github.com>
Date: Tue, 14 Apr 2026 13:49:21 +0200
Subject: [PATCH 1/4] ci(docs): pin pnpm version for pages build

---
 .github/workflows/publish_docs.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish_docs.yml b/.github/workflows/publish_docs.yml
index 31a72e4a..130c3402 100644
--- a/.github/workflows/publish_docs.yml
+++ b/.github/workflows/publish_docs.yml
@@ -35,14 +35,14 @@ jobs:
       - name: Install pnpm
         uses: pnpm/action-setup@v6
         with:
-          version: 10
+          version: 10.28.2
 
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
           cache: "pnpm"
-          cache-dependency-path: ./docs
+          cache-dependency-path: ./docs/pnpm-lock.yaml
 
       - name: Install dependencies
         run: pnpm i --frozen-lockfile

From 0feb49d00a2d2534efcc1895e99a99e8c502cd1a Mon Sep 17 00:00:00 2001
From: RocketQuack <202538874+Rocket-Quack@users.noreply.github.com>
Date: Tue, 14 Apr 2026 13:55:29 +0200
Subject: [PATCH 2/4] ci(docs): add lockfile debug output for pages workflow

---
 .github/workflows/publish_docs.yml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/.github/workflows/publish_docs.yml b/.github/workflows/publish_docs.yml
index 130c3402..4b52f9e8 100644
--- a/.github/workflows/publish_docs.yml
+++ b/.github/workflows/publish_docs.yml
@@ -44,6 +44,23 @@ jobs:
           cache: "pnpm"
           cache-dependency-path: ./docs/pnpm-lock.yaml
 
+      - name: Debug lockfile on runner
+        run: |
+          pwd
+          ls -la
+          echo "sha256 (workspace file):"
+          sha256sum pnpm-lock.yaml
+          echo "sha256 (git blob at HEAD):"
+          git show HEAD:docs/pnpm-lock.yaml | sha256sum
+          echo "lockfileVersion count:"
+          grep -c '^lockfileVersion:' pnpm-lock.yaml || true
+          echo "yaml document markers:"
+          grep -nE '^---$|^\\.\\.\\.$|^<<<<<<<|^=======|^>>>>>>>$' pnpm-lock.yaml || true
+          echo "first 20 lines:"
+          sed -n '1,20p' pnpm-lock.yaml
+          echo "last 20 lines:"
+          tail -n 20 pnpm-lock.yaml
+
       - name: Install dependencies
         run: pnpm i --frozen-lockfile
 

From 1d957628157f66cba6daa1dd54b7b2c955390feb Mon Sep 17 00:00:00 2001
From: RocketQuack <202538874+Rocket-Quack@users.noreply.github.com>
Date: Tue, 14 Apr 2026 14:02:04 +0200
Subject: [PATCH 3/4] ci(docs): switch pages workflow to corepack-managed pnpm

---
 .github/workflows/publish_docs.yml | 31 +++++++++++-------------------
 1 file changed, 11 insertions(+), 20 deletions(-)

diff --git a/.github/workflows/publish_docs.yml b/.github/workflows/publish_docs.yml
index 4b52f9e8..adbac6ea 100644
--- a/.github/workflows/publish_docs.yml
+++ b/.github/workflows/publish_docs.yml
@@ -32,11 +32,6 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v6
 
-      - name: Install pnpm
-        uses: pnpm/action-setup@v6
-        with:
-          version: 10.28.2
-
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v6
         with:
@@ -44,22 +39,18 @@ jobs:
           cache: "pnpm"
           cache-dependency-path: ./docs/pnpm-lock.yaml
 
-      - name: Debug lockfile on runner
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Activate pnpm
+        run: corepack prepare pnpm@10.28.2 --activate
+
+      - name: Show tool versions
         run: |
-          pwd
-          ls -la
-          echo "sha256 (workspace file):"
-          sha256sum pnpm-lock.yaml
-          echo "sha256 (git blob at HEAD):"
-          git show HEAD:docs/pnpm-lock.yaml | sha256sum
-          echo "lockfileVersion count:"
-          grep -c '^lockfileVersion:' pnpm-lock.yaml || true
-          echo "yaml document markers:"
-          grep -nE '^---$|^\\.\\.\\.$|^<<<<<<<|^=======|^>>>>>>>$' pnpm-lock.yaml || true
-          echo "first 20 lines:"
-          sed -n '1,20p' pnpm-lock.yaml
-          echo "last 20 lines:"
-          tail -n 20 pnpm-lock.yaml
+          node --version
+          corepack --version
+          pnpm --version
+          which pnpm
 
       - name: Install dependencies
         run: pnpm i --frozen-lockfile

From adc72561a148b5e315bb48a9cafda43160765b65 Mon Sep 17 00:00:00 2001
From: RocketQuack <202538874+Rocket-Quack@users.noreply.github.com>
Date: Tue, 14 Apr 2026 14:04:05 +0200
Subject: [PATCH 4/4] ci(docs): remove setup-node pnpm cache for corepack flow

---
 .github/workflows/publish_docs.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/publish_docs.yml b/.github/workflows/publish_docs.yml
index adbac6ea..ffecb82c 100644
--- a/.github/workflows/publish_docs.yml
+++ b/.github/workflows/publish_docs.yml
@@ -36,8 +36,6 @@ jobs:
         uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
-          cache: "pnpm"
-          cache-dependency-path: ./docs/pnpm-lock.yaml
 
       - name: Enable Corepack
         run: corepack enable