chore(mcp): test against Node 22 and 24, and declare an engines range

[tobydoescode]

Follow-up to #10. Two related gaps that bump surfaced.

Node matrix

mcp/ is published to npm as @evoio/apple-bridge-mcp, so it runs on whatever Node a consumer has — but CI only ever exercised one version. #10 moved that from 22 to 24, which silently dropped 22 from coverage entirely.

-    name: MCP server
+    name: MCP server (node ${{ matrix.node }})
     runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node: [22, 24]

22 and 24 are the two lines still receiving updates now that 20 is EOL. fail-fast: false so a break on one version doesn't mask the other's result. Both legs are ~15s Linux jobs.

engines

"engines": {
  "node": ">=22"
},

The package previously made no claim at all, so consumers got no signal at install time.

This is a support statement, not a technical floor. src/index.ts needs global fetch and nothing more exotic — no top-level await — so it may well run on older releases. 22 is simply the oldest version CI actually covers. If you want the real floor, add 20 to the matrix temporarily and see what breaks.

Also note npm only warns on an engines mismatch unless the consumer sets engine-strict=true.

package-lock.json picked up the matching engines entry via npm install --package-lock-only, so the lock doesn't drift on the next install.

Two consequences worth knowing

Renovate loses this pin. #10 worked because node-version: 24 was a plain scalar it could regex. It cannot bump a matrix list, so these versions are hand-maintained now — there's a comment in the workflow saying so, pointing at the engines range to keep them in step.

Check names change from MCP server to MCP server (node 22) / MCP server (node 24). No effect today, but that's what you'd name if required status checks are ever configured on main.

Verification

• npx js-yaml parses the workflow; matrix resolves to [22, 24], node-version wired to ${{ matrix.node }}
• Locally on Node 22.22.2 (the lower matrix leg): npm ci clean, typecheck clean, 21/21 tests
• Node 24 leg was already proven green in Update dependency node to v24 #10

🤖 Generated with Claude Code