Merge pull request #85 from debugmcp/chore/node-22-floor

chore: raise minimum Node.js to 22 and upgrade which 6 → 7

Author: debugmcpdev

.github/PULL_REQUEST_TEMPLATE.md

@@ -38,7 +38,7 @@ npm test
 
 **Test Configuration**:
 - OS: [e.g., Ubuntu 22.04]
-- Node version: [e.g., 20.11.0]
+- Node version: [e.g., 22.x]
 - Python version: [e.g., 3.11.5]
 
 ## 📸 Screenshots (if applicable)

.nvmrc

@@ -0,0 +1 @@
+22

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+- **Minimum Node.js raised to 22.** All packages now declare `engines.node >=22.0.0`, and the Docker image builds on `node:22-slim`. Node 18 and 20 are no longer supported (Node 20 reached end-of-life April 2026).
+
+### Dependencies
+- Bumped `which` 6 → 7 (requires Node 22+). The API is unchanged, and `which` is bundled into the `@debugmcp/mcp-debugger` npx CLI, so end-user installs are unaffected. (supersedes #76)
+
 ## [0.20.0] - 2026-03-29
 
 ### Added

CLAUDE.md

@@ -327,7 +327,7 @@ packages/adapter-{language}/
 - The system will auto-detect Python path or use `PYTHON_PATH` env var
 
 ### JavaScript/Node.js
-- Node.js 18+ must be installed
+- Node.js 22+ must be installed
 - Uses bundled js-debug adapter (VSCode's debugger)
 - Supports JavaScript and TypeScript debugging
 - Auto-detects TypeScript configuration

CONTRIBUTING.md

@@ -22,7 +22,7 @@ This project adheres to the [Contributor Covenant Code of Conduct](CODE_OF_CONDU
 
 ### Prerequisites
 
-- Node.js 18+ (20.x recommended)
+- Node.js 22+
 - pnpm (required — `workspace:*` protocol needs pnpm, not npm)
 - Python 3.7+ (for debugging Python code)
 - Go 1.18+ and Delve (for debugging Go code, optional)

Dockerfile

@@ -1,7 +1,7 @@
 # Stage 1: Build and bundle the TypeScript application
 ARG DISABLE_LANGUAGES=rust
 
-FROM node:20-slim@sha256:f93745c153377ee2fbbdd6e24efcd03cd2e86d6ab1d8aa9916a3790c40313a55 AS builder
+FROM node:22-slim@sha256:7af03b14a13c8cdd38e45058fd957bf00a72bbe17feac43b1c15a689c029c732 AS builder
 ARG DISABLE_LANGUAGES
 ENV DEBUG_MCP_DISABLE_LANGUAGES=${DISABLE_LANGUAGES}
 

docs/ACT_LOCAL_CI_TESTING.md

@@ -226,7 +226,7 @@ act -j build-and-test
 
 4. **Use smaller images** for simple jobs:
    ```bash
-   act -j lint -P ubuntu-latest=node:20
+   act -j lint -P ubuntu-latest=node:22
    ```
 
 ## Project-Specific Notes

docs/architecture/adapter-development-guide.md

@@ -16,7 +16,7 @@ Benefits:
 
 ## Prerequisites
 
-- Node.js 18+
+- Node.js 22+
 - pnpm (not npm) — the monorepo uses `workspace:*` protocol
 - TypeScript 5.9+
 - Familiarity with the [Debug Adapter Protocol (DAP)](https://microsoft.github.io/debug-adapter-protocol/)

docs/architecture/system-overview.md

@@ -199,7 +199,7 @@ sequenceDiagram
 ## Technology Stack
 
 ### Core Technologies
-- **Runtime**: Node.js 18+ with ES modules
+- **Runtime**: Node.js 22+ with ES modules
 - **Language**: TypeScript 5.x with strict mode
 - **Protocol**: Model Context Protocol (MCP) over stdio or Streamable HTTP (legacy SSE deprecated)
 - **Debugging**: Debug Adapter Protocol (DAP) 1.51.0

docs/development/setup-guide.md

@@ -6,7 +6,7 @@ This guide will help you set up your development environment for working on the
 
 ### Required Software
 
-1. **Node.js** (v18.0.0 or higher, 20.x recommended)
+1. **Node.js** (v22.0.0 or higher)
    - Download from [nodejs.org](https://nodejs.org/)
    - Verify installation: `node --version`
 
@@ -326,9 +326,9 @@ npm install -g npm@latest
 # Install nvm
 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
 
-# Install and use Node 18
-nvm install 18
-nvm use 18
+# Install and use Node 22
+nvm install 22
+nvm use 22
 ```
 
 ### Python Issues