ci: Skip linting on Node 16.x due to ESLint 9 requirements

facundofarias · claude · facundofarias · commit e443bf2d5063 · 2025-11-11T08:30:42.000+01:00
ESLint 9.x requires Node.js 18.18+ (uses structuredClone internally). Since we support Node 16+ for runtime but ESLint is a dev tool, skip linting on Node 16.x in CI while keeping it for 18.x, 20.x, and 22.x. Changes: - Skip linting step for Node 16.x in CI workflow - Document development requirements (Node 18+) in README - Update CLAUDE.md to clarify runtime vs development requirements The MCP server still runs perfectly on Node 16+, but development tools (ESLint, etc.) require Node 18+. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -29,6 +29,7 @@ jobs:
         run: npm ci
 
       - name: Run linter
+        if: matrix.node-version != '16.x'
         run: npm run lint
 
       - name: Run type check
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -159,4 +159,6 @@ For stdio testing, use absolute path to `dist/stdio.js` in client configs to avo
 
 ## Important: Node Version
 
-Requires Node.js >=16.0.0 (specified in package.json engines). The server uses node-fetch for HTTP requests to ensure compatibility with Node 16+, which is commonly used by Claude Desktop/Code installations.
+**Runtime**: Requires Node.js >=16.0.0 (specified in package.json engines). The server uses node-fetch for HTTP requests to ensure compatibility with Node 16+, which is commonly used by Claude Desktop/Code installations.
+
+**Development**: Requires Node.js >=18.0.0 for development tools (ESLint 9.x requires Node 18.18+). If you're on Node 16, you can still build and test, but skip linting with `npm run build && npm run type-check`.
diff --git a/README.md b/README.md
@@ -139,6 +139,10 @@ Once configured, you can ask Claude to interact with DeployHQ:
 
 ## &#128295; Local Development
 
+**Development Requirements:**
+- Node.js 18+ (for ESLint 9.x and other dev tools)
+- Runtime supports Node.js 16+
+
 ### 1. Clone the repository
 
 ```bash
