feat: update eas-build.yml to remove path filters on push; enhance self-hosted macOS runner documentation with setup and troubleshooting details

Author: Lalit Sharma

.github/workflows/eas-build.yml

@@ -3,10 +3,6 @@ name: Self-Hosted Mobile Build & Submit
 on:
   push:
     branches: [main]
-    paths:
-      - "apps/mobile/**"
-      - "packages/**"
-      - "pnpm-lock.yaml"
   workflow_dispatch:
     inputs:
       platform:

documents/self-hosted-macos-runner.md

@@ -9,6 +9,26 @@ The updated workflows run on the label set:
 
 Assumption: builds stay local (`eas build --local`) so they do not consume EAS cloud build quota.
 
+## 0. Runner requirements from workflow files
+
+The current workflows require this exact label set in `runs-on`:
+
+- `self-hosted`
+- `macOS`
+- `eclipse-timer`
+
+Where this is used:
+
+- `.github/workflows/ci.yml`
+- `.github/workflows/eas-build.yml` (all jobs)
+
+If a workflow is queued and never picked up, first check in GitHub UI:
+
+1. `Settings -> Actions -> Runners`.
+2. Open your runner.
+3. Confirm labels include all three values above, especially custom label `eclipse-timer`.
+4. Confirm the runner group is allowed for this repository.
+
 ## 1. One-time machine prerequisites
 
 Run these on the Mac mini:
@@ -43,10 +63,16 @@ Node and pnpm:
 
 ```bash
 node -v
-corepack enable
+npm -v
+npm install -g pnpm@9
 pnpm -v
 ```
 
+Notes:
+
+1. Node 25 may not include `corepack` by default.
+2. Workflow jobs use Node 20 (`actions/setup-node@v4` with `node-version: 20`), so using Node 20 on the Mac mini keeps behavior closest to CI.
+
 ## 2. Create the self-hosted runner
 
 In GitHub:
@@ -75,9 +101,42 @@ From `~/actions-runner`:
 ./svc.sh status
 ```
 
-If your org policy allows it, also set the Mac mini to auto-login and prevent sleep while plugged in for stable CI uptime.
+Headless caveat:
+
+1. On some headless setups, `svc.sh` (LaunchAgent) may fail to load without an active GUI user session.
+2. If that happens, use foreground mode (`./run.sh`) or the background fallback below.
+
+## 4. Headless fallback (works without LaunchAgent)
+
+Start in background (from `~/actions-runner`):
+
+```bash
+cd ~/actions-runner
+nohup ./run.sh > runner.log 2>&1 &
+echo $! > runner.pid
+disown
+```
+
+Check status/log:
+
+```bash
+cd ~/actions-runner
+ps -p "$(cat runner.pid)" -o pid,command
+tail -n 100 runner.log
+```
+
+Stop runner:
 
-## 4. Repo secrets needed
+```bash
+cd ~/actions-runner
+if [ -f runner.pid ]; then
+  kill "$(cat runner.pid)" || true
+  rm -f runner.pid
+fi
+pkill -f "Runner.Listener run" || true
+```
+
+## 5. Repo secrets needed
 
 Set these in `Settings -> Secrets and variables -> Actions`:
 
@@ -89,7 +148,7 @@ If you use automated submit:
 1. Make sure EAS submit credentials are already configured for Apple and Google Play.
 2. Keep `submit` job gated by the `production` environment approval in GitHub.
 
-## 5. Workflow behavior after this change
+## 6. Workflow behavior after this change
 
 - `.github/workflows/ci.yml`: runs typecheck/lint/test on self-hosted macOS runner.
 - `.github/workflows/eas-build.yml`:
@@ -100,7 +159,16 @@ If you use automated submit:
   - Uploads local artifacts (`ios.ipa`, `android.aab`) to the workflow run.
   - Optional submit job sends those artifacts using `eas submit --path ...`.
 
-## 6. First validation run
+Trigger conditions:
+
+1. `ci.yml` runs only on:
+   - push to `main`
+   - pull request targeting `main`
+2. `eas-build.yml` runs on:
+   - every push to `main`
+   - manual `workflow_dispatch`
+
+## 7. First validation run
 
 1. In GitHub Actions, run `Self-Hosted Mobile Build & Submit`.
 2. Inputs:
@@ -109,10 +177,13 @@ If you use automated submit:
 3. Confirm build artifacts are attached to the run.
 4. Then run once with `submit: true` when store credentials are confirmed.
 
-## 7. Common issues
+## 8. Common issues
 
 1. Runner never picked:
-   - Check runner is online and has label `eclipse-timer`.
+   - Check runner is online.
+   - Check labels include `self-hosted`, `macOS`, and `eclipse-timer`.
+   - Check runner group permissions include this repository.
+   - If `svc.sh` mode fails on headless macOS, run with `nohup ./run.sh ...`.
 2. iOS signing failures:
    - Re-check distribution cert/profile setup in your EAS credentials.
 3. Android signing failures: