fix(ci): pin Node to 24.18.1 to match runtime; surface app startup logs

The `test` job intermittently fails at "Wait for app availability" because
`npm run dev` crashes on startup:

    node::RemoveEnvironmentCleanupHook(...) at ../src/api/hooks.cc:142
    Assertion failed: (env) != nullptr
      Statement::~Statement()  [better-sqlite3/build/Release/better_sqlite3.node]

Node >= 24.19.0 added node::ObjectWrap cleanup hooks that are incompatible
with NAN-style native addons such as better-sqlite3 (11.9.1, this project's
pinned version), tripping that assertion on teardown. It is intermittent (a
race during native cleanup), so the job fails on some runs and passes on
others.

The app ships on Node 24.18.1 (both Dockerfiles and .nvmrc), which predates
the breaking change, so production is unaffected. Only CI hit it, because
`setup-node` with `node-version: '24'` floats to the latest 24.x (24.20.0 at
time of failure). Pinning CI to 24.18.1 makes it test the version that
actually ships and avoids the regression.

Also capture `npm run dev` output to app.log and fail fast (printing it) if
the process exits early, so a future startup failure is diagnosable instead
of surfacing only as "App failed to start" after a 25s wait.

(Longer term, upgrading better-sqlite3 to v12+ restores Node 24.19+ support;
pinning the runtime is the minimal, prod-matching fix.)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Parikshith
2026-09-08 16:22:39 +05:30
parent 17375348b0
commit 938d7f145c
2 changed files with 20 additions and 4 deletions
+3 -1
View File
@@ -26,7 +26,9 @@ jobs:
- name: Set up Node.js
uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
with:
node-version: '24'
# Match the version the app ships on (Dockerfile / .nvmrc)
# rather than floating to the latest 24.x.
node-version: '24.18.1'
- name: Install dependencies
run: npm ci
+17 -3
View File
@@ -19,7 +19,12 @@ jobs:
- name: Install Node
uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
with:
node-version: '24'
# Pin to the version the app actually ships on (Dockerfile / .nvmrc).
# A bare '24' floats to the latest 24.x; Node >= 24.19.0 added
# node::ObjectWrap cleanup hooks that crash better-sqlite3 on teardown
# ("Assertion failed: (env) != nullptr" in RemoveEnvironmentCleanupHook),
# which intermittently kills `npm run dev` in the step below.
node-version: '24.18.1'
- name: Copy config file
run: cp config/config.example.yml config/config.yml
@@ -43,7 +48,9 @@ jobs:
run: npx tsc --noEmit
- name: Start app in background
run: nohup npm run dev &
run: |
nohup npm run dev > app.log 2>&1 &
echo $! > app.pid
- name: Wait for app availability
run: |
@@ -52,10 +59,17 @@ jobs:
echo "App is up"
exit 0
fi
# Fail fast (and show why) if the process already exited.
if ! kill -0 "$(cat app.pid)" 2>/dev/null; then
echo "App process exited before becoming available. Output:"
cat app.log
exit 1
fi
echo "Waiting for the app... attempt $i"
sleep 5
done
echo "App failed to start"
echo "App failed to start. Output:"
cat app.log
exit 1
build-sqlite: