From 949e8971d538c3a9a13134bb75e780e09825521f Mon Sep 17 00:00:00 2001
From: Netherwarlord <cclendening@midmich.edu>
Date: Wed, 29 Jul 2026 05:48:57 -0400
Subject: [PATCH] feat: add macOS testing workflow for comprehensive CI
 coverage

---
 .gitea/workflows/release.yml     | 14 +++++-
 .gitea/workflows/tests-macos.yml | 75 ++++++++++++++++++++++++++++++++
 2 files changed, 88 insertions(+), 1 deletion(-)
 create mode 100644 .gitea/workflows/tests-macos.yml

diff --git a/.gitea/workflows/release.yml b/.gitea/workflows/release.yml
index 32722a1..dae03d5 100644
--- a/.gitea/workflows/release.yml
+++ b/.gitea/workflows/release.yml
@@ -52,8 +52,20 @@ jobs:
           --tag "${{ github.ref_name }}"
           dist/LM-Gambit-*.zip dist/LM-Gambit-*.tar.gz
 
+      # Without this the dry run is only half a test: the archives are built,
+      # listed, and then destroyed with the job container, so nobody can open
+      # one. On a tag the archives reach the release instead, which is why this
+      # is scoped to the tagless path.
+      - name: Upload archives for inspection
+        if: ${{ !startsWith(github.ref, 'refs/tags/v') }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: LM-Gambit-archives
+          path: dist/LM-Gambit-*
+          if-no-files-found: error
+
       - name: Dry run note
         if: ${{ !startsWith(github.ref, 'refs/tags/v') }}
         run: |
-          echo "No tag — archives built but not published."
+          echo "No tag — archives built and uploaded as artifacts, not published."
           ls -lh dist/
diff --git a/.gitea/workflows/tests-macos.yml b/.gitea/workflows/tests-macos.yml
new file mode 100644
index 0000000..22cd8b7
--- /dev/null
+++ b/.gitea/workflows/tests-macos.yml
@@ -0,0 +1,75 @@
+name: tests-macos
+
+# Separate from tests.yml on purpose. This runs on a laptop, and a laptop is
+# sometimes asleep. Keeping it in its own workflow means a queued macOS job
+# leaves *this* run pending instead of holding the main test result hostage.
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: tests-macos-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  macos:
+    # Homebrew act_runner executes jobs directly on the host — there is no
+    # container. Change this label if the runner was registered with a
+    # different one; it has to match what the runner declared.
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      # No setup-python / setup-node here, deliberately. Those actions install
+      # a toolchain into a container that does not exist in host mode. Using
+      # whatever Homebrew provides is also the better test: it is the
+      # environment an actual macOS user would have, rather than a pinned one
+      # nobody runs.
+      - name: Show toolchain
+        run: |
+          python3 --version
+          node --version
+          npm --version
+          uname -m
+
+      # A venv rather than --user: Homebrew's Python is externally managed
+      # (PEP 668), so a plain pip install into it is refused outright.
+      - name: Install Python dependencies
+        run: |
+          python3 -m venv .ci-venv
+          .ci-venv/bin/python -m pip install --quiet --upgrade pip
+          .ci-venv/bin/python -m pip install -r requirements-ci.txt
+
+      # requirements-ci.txt omits llama-cpp-python, so this covers suite
+      # loading, grading, reporting and the HTTP surface — not inference.
+      # Exercising .apple_silicon needs model weights CI does not have, and
+      # remains a manual check.
+      - name: Run Python tests
+        run: .ci-venv/bin/python tests_py/run_all.py
+
+      - name: Install web dependencies
+        working-directory: web
+        run: npm ci
+
+      - name: Type-check and build
+        working-directory: web
+        run: npm run build
+
+      - name: Run UI tests
+        working-directory: web
+        run: npm test
+
+      # Proves the shipped artifact actually works on macOS, which is a
+      # different claim from "it built". Catches launcher and layout problems
+      # that never show up in a source checkout.
+      - name: Smoke-test the packaged archive
+        run: |
+          .ci-venv/bin/python packaging/build.py --platform macos --skip-web
+          cd dist
+          tar xzf LM-Gambit-*-macos.tar.gz
+          cd LM-Gambit-*-macos
+          test -x LM-Gambit.sh || { echo "launcher is not executable"; exit 1; }
+          head -1 LM-Gambit.sh | grep -q '^#!/usr/bin/env bash$' || { echo "bad shebang"; exit 1; }
+          ../../.ci-venv/bin/python auto-test.py --suites