From 581ef911ea03dc6277870c33cab3c0b3e306617d Mon Sep 17 00:00:00 2001
From: patrick brisbin <pbrisbin@gmail.com>
Date: Mon, 19 Oct 2026 09:01:36 -0400
Subject: [PATCH 1/2] fix(ci): fix for macOS linker errors

---
 .github/workflows/example.yml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.github/workflows/example.yml b/.github/workflows/example.yml
index 9c53272..a0bb31c 100644
--- a/.github/workflows/example.yml
+++ b/.github/workflows/example.yml
@@ -78,6 +78,11 @@ jobs:
           name: dist
           path: dist # overwrite dist/index.js
 
+      # https://github.com/freckle/stack-action/issues/489
+      - if: ${{ startsWith(matrix.runner, 'macOS-') }}
+        run: |
+          sudo xcode-select -s /Library/Developer/CommandLineTools
+
       - id: stack
         uses: ./
         with:

From c00ccf0068f703d9449946de386b41a49a3c3870 Mon Sep 17 00:00:00 2001
From: patrick brisbin <pbrisbin@gmail.com>
Date: Mon, 19 Oct 2026 09:03:55 -0400
Subject: [PATCH 2/2] chore(docs): add linker fix to README

---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.md b/README.md
index 5b6986c..884f808 100644
--- a/README.md
+++ b/README.md
@@ -180,6 +180,23 @@ jobs:
 See [generate-matrix/action.yml](./generate-matrix/action.yml) for more details.
 This has been available since version 4 of this action.
 
+## MacOS Linker Errors
+
+On certain `macOS` runners, you may encounter:
+
+```
+ld: multiple errors: tapi error: malformed file
+```
+
+To fix, add the following:
+
+```yaml
+- run: |
+    sudo xcode-select -s /Library/Developer/CommandLineTools
+```
+
+See https://github.com/freckle/stack-action/issues/489 for more details.
+
 ## Development
 
 - **Package manager**: pnpm (Node version pinned in `.nvmrc`)