fix(ci): restore strict npm ci and standardize minimum Node engine to >=22.12.0

Author: EhsanCreator

.github/workflows/ci.yml

@@ -34,8 +34,8 @@ jobs:
       - name: Install Dependencies
         shell: bash
         run: |
-          npm install --no-audit 2>&1 | tee npm-install.log || {
-            echo "::error::$(tail -n 10 npm-install.log | tr '\n' ' ')"
+          npm ci 2>&1 | tee npm-ci.log || {
+            echo "::error::$(tail -n 10 npm-ci.log | tr '\n' ' ')"
             exit 1
           }
 

README.md

@@ -119,7 +119,7 @@ OpenCode Router provides genuine cross-platform support with dedicated native la
 | **Windows 11 (x64)** | **Tested & Verified** | Native PowerShell & CMD launchers; per-user AppData storage; native `xray.exe`. |
 | **Windows 10 (x64)** | **Tested & Verified** | Native PowerShell & CMD launchers; build 19041+ supported. |
 | **Ubuntu 24.04 LTS (x86_64)** | **Tested & Verified** | Primary Linux development and validation environment. |
-| Ubuntu 22.04 LTS / Debian 12 | *Compatible* | Requires Node.js >= 20.19.0 or >= 22.12.0 and standard bash. |
+| Ubuntu 22.04 LTS / Debian 12 | *Compatible* | Requires Node.js >= 22.12.0 and standard bash. |
 | Windows 11 (ARM64) | *Implemented (Unverified)* | ARM64 asset provisioned; unverified on physical ARM64 hardware. |
 | macOS (Apple Silicon / Intel) | *Compatible* | Native bash launcher and macOS Xray binaries supported. |
 
@@ -132,13 +132,13 @@ OpenCode Router provides genuine cross-platform support with dedicated native la
 
 ### On Windows
 - **Operating System**: Windows 10 (Build 19041+) or Windows 11 (64-bit x64 primary target; ARM64 asset implemented)
-- **Node.js Runtime**: v20.19.0+ or v22.12.0+ ([Download Node.js](https://nodejs.org)) — *strictly required by Vite 8*
+- **Node.js Runtime**: v22.12.0+ ([Download Node.js](https://nodejs.org)) — *strictly required by better-sqlite3 and Vite 8*
 - **Shell**: Windows PowerShell 5.1+, PowerShell 7+, Windows Terminal, or CMD
 - **Target Application**: OpenCode CLI installed (`npm install -g opencode-ai`)
 
 ### On Linux
 - **Operating System**: Ubuntu 24.04 LTS / Debian 12 / Compatible Linux (64-bit)
-- **Node.js Runtime**: v20.19.0+ or v22.12.0+ (`node -v`) — *strictly required by Vite 8*
+- **Node.js Runtime**: v22.12.0+ (`node -v`) — *strictly required by better-sqlite3 and Vite 8*
 - **Package Manager**: npm (`npm -v`)
 - **Target Application**: OpenCode CLI installed (e.g. `/usr/local/bin/opencode`)
 

docs/guide/installation.md

@@ -32,14 +32,14 @@ sudo apt update
 # Install system utilities
 sudo apt install -y curl unzip git
 
-# Verify Node.js (version 18.0.0 or higher required)
+# Verify Node.js (version 22.12.0 or higher required)
 node -v
 npm -v
 ```
 
 If Node.js is not installed, install it using the official NodeSource repository or nvm:
 ```bash
-curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
 sudo apt install -y nodejs
 ```
 

scripts/package-portable.ts

@@ -98,7 +98,7 @@ OpenCode Router v${version} - Native Windows Portable Edition
 ==========================================================
 
 Prerequisites (Host Machine):
-  1. Node.js 20.19+ or 22.12+ (https://nodejs.org) [Required for Vite 8 / Server runtime]
+  1. Node.js 22.12+ (https://nodejs.org) [Required for Vite 8 / better-sqlite3 / Server runtime]
   2. OpenCode CLI: npm install -g opencode-ai
 
 Note on Architecture:

scripts/windows/check-environment.ps1

@@ -23,29 +23,26 @@ $osArch = (Get-CimInstance Win32_Processor).AddressWidth
 Write-Host "[[v]] Operating System: " -NoNewline -ForegroundColor Green
 Write-Host "$($os.Caption) ($osArch-bit, Build $($os.BuildNumber))"
 
-# 2. Node.js Runtime (Vite 8 requires Node.js 20.19+ or 22.12+)
+# 2. Node.js Runtime (better-sqlite3 and Vite 8 require Node.js >= 22.12.0)
 $nodeCmd = Get-Command node -ErrorAction SilentlyContinue
 if ($nodeCmd) {
     $nodeVer = (node -v).Trim().TrimStart('v')
     $parts = $nodeVer.Split('.')
     $major = [int]$parts[0]
     $minor = if ($parts.Length -gt 1) { [int]$parts[1] } else { 0 }
 
-    $isVite8Compatible = ($major -eq 20 -and $minor -ge 19) -or ($major -ge 22 -and $minor -ge 12) -or ($major -gt 22)
+    $isNodeCompatible = ($major -eq 22 -and $minor -ge 12) -or ($major -gt 22)
 
-    if ($isVite8Compatible) {
+    if ($isNodeCompatible) {
         Write-Host "[[v]] Node.js Runtime:  " -NoNewline -ForegroundColor Green
         Write-Host "v$nodeVer ($($nodeCmd.Source))"
-    } elseif ($major -ge 20) {
-        Write-Host "[!] Node.js Runtime:  " -NoNewline -ForegroundColor Yellow
-        Write-Host "v$nodeVer (Warning: Vite 8 requires Node.js 20.19+ or 22.12+)"
     } else {
         Write-Host "[[x]] Node.js Runtime:  " -NoNewline -ForegroundColor Red
-        Write-Host "v$nodeVer (Incompatible: Vite 8 strictly requires Node.js 20.19+ or 22.12+)"
+        Write-Host "v$nodeVer (Incompatible: better-sqlite3 and Vite 8 strictly require Node.js >= 22.12.0)"
         $allPassed = $false
     }
 } else {
-    Write-Host "[[x]] Node.js Runtime:  Not found in PATH! (Node.js 20.19+ or 22.12+ required: https://nodejs.org)" -ForegroundColor Red
+    Write-Host "[[x]] Node.js Runtime:  Not found in PATH! (Node.js >= 22.12.0 required: https://nodejs.org)" -ForegroundColor Red
     $allPassed = $false
 }
 

scripts/windows/verify-release.ps1

@@ -4,7 +4,7 @@
 .DESCRIPTION
     Non-privileged verification suite for Windows 10/11 x64:
     - Host Windows OS & architecture
-    - Node.js runtime version (^20.19.0 || >=22.12.0)
+    - Node.js runtime version (>=22.12.0)
     - Native SQLite (better-sqlite3) binary module loading
     - Native C# launcher (opencode-vpn.exe) compilation & execution
     - OpenCode CLI discovery & resolution
@@ -90,8 +90,8 @@ if ($nodeCmd) {
     $nodeVerStr = (& node -v).Trim()
     $results.node.version = $nodeVerStr
     $nodeVer = [version]($nodeVerStr -replace '^v', '')
-    $nodeValid = ($nodeVer.Major -eq 20 -and $nodeVer.Minor -ge 18) -or ($nodeVer.Major -ge 22 -and $nodeVer.Minor -ge 12) -or ($nodeVer.Major -gt 22)
-    Log-Test "Node.js Version Requirement (^20.18.0 || >=22.12.0)" $nodeValid "Detected: $nodeVerStr ($($nodeCmd.Source))"
+    $nodeValid = ($nodeVer.Major -eq 22 -and $nodeVer.Minor -ge 12) -or ($nodeVer.Major -gt 22)
+    Log-Test "Node.js Version Requirement (>=22.12.0)" $nodeValid "Detected: $nodeVerStr ($($nodeCmd.Source))"
 } else {
     Log-Test "Node.js Runtime Installed" $false "Node.js executable not found in PATH"
 }