From 3b5ac24edb994b2d6b54b9d97f0ae2a6b3191152 Mon Sep 17 00:00:00 2001
From: Roger Deng <13251150+rogerdigital@users.noreply.github.com>
Date: Tue, 14 Apr 2026 20:49:36 +0800
Subject: [PATCH] ci: add stage-docs/runtime-env checks and native addon build
 tools

---
 .github/workflows/ci.yml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index a928916..3409188 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -13,7 +13,7 @@ permissions:
   contents: read
 
 jobs:
-  # ── 1. Lint (Biome) ────────────────────────────────────────────────────────
+  # ── 1. Lint + static checks ────────────────────────────────────────────────
   lint:
     name: Lint
     runs-on: ubuntu-latest
@@ -26,6 +26,8 @@ jobs:
       - run: npm ci
       - run: npm run check:workspaces
       - run: npm run check:lockfile
+      - run: npm run check:stage-docs
+      - run: npm run check:runtime-env
       - run: npm run lint
 
   # ── 2. Type Check ─────────────────────────────────────────────────────────
@@ -61,6 +63,9 @@ jobs:
         with:
           node-version: '22'
           cache: npm
+      # better-sqlite3 may need to compile from source if no prebuilt matches
+      - name: Install build tools (for native addons)
+        run: sudo apt-get install -y python3 make g++
       - run: npm ci
       - run: npm run test:${{ matrix.suite }}