Skip to content

Require Node.js 22.12 or newer (AUG-294) - #87

Merged
cursor[bot] merged 2 commits into
mainfrom
cursor/node-22-12-cli-0e61
Oct 15, 2026
Merged

cursor[bot] merged 2 commits into
mainfrom
cursor/node-22-12-cli-0e61

Conversation

@hamzahskafi

@hamzahskafi hamzahskafi commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Raises the CLI minimum Node.js version to 22.12. Node.js 20 reached end of life in April 2026, and commander@15 and vitest@5 already require 22.12. Resolves AUG-294. Part of AUG-348 (plan items N.1 to N.4). The website half stays a separate ticket.

  • Base 2da59a837a1afc7bb184b954d34e1e7e3f4f03d5 (main)
  • Head 8c118ec7ea96f91a36865a85c5590f3310f043a5
  • Package version stays 0.3.9. Nothing is tagged, released, or published. @augmentworks/cli@0.3.9 remains the last release that supports Node.js 20.
  • engines.node is >=22.12. tsup targets node22.
  • CI matrix is Node.js 22.12.0, 22, 24, and 26 on Ubuntu, macOS, and Windows (12 jobs). The 22.12.0 lane installs with npm ci --engine-strict.
  • Source discovery manifests declare >=22.12. The independently inspected 0.3.9 receipt stays >=20.
  • Windows file-identity checks tolerate libuv 1.49/1.50 (Node.js 22.12.0–22.16.x and 24.0.0–24.1.x). Path stat reports dev: 0 and fstat reports the volume serial, which made every open look like a replacement. The file index still has to match, and two nonzero device ids still have to match.
  • Billing contract unchanged: aw-billing/1 from 650472d91442a6866a7b6ef18e6dacc23a2a9260, schema 1c0929d4f15b6b3b2017d7416e1eff50c9116b0b50fe7b82b5d96d732d807941, fixtures a4b9234b426f98132ddbd8e82755caa0aa718c4ec1e3bf17064d1bf364a6cb84
  • Run-report contract unchanged: aw-run-report/1, schema 7726ec277d33e435d2832e8be0898baf9337631d779f073a10c7795fc7de38ff, fixtures febd2626c96672d0e79afc4706b3a5136598b61bbebbdeb0f8ec1bdbc44cd806, source AW-QA-1
  • Real-data contract unchanged: aw-real-data/1 from b198906188bab2dac9ae2a1ad539405807e46e1e, schema 6a53d04f297eb4db275bb7074bf7705a08137d932be823a3f4087d84cfdf7121, fixtures 26033843d55dcb9b49ccf68fa96f7de9ec34aa6c299e8ab28b605cad37572230, releaseEnabled=false

Test plan

  • npm run check on Node.js v22.14.0: typecheck, 111 test files (1096 passed, 1 skipped), build (target: node22), discovery, billing, run-report, and real-data contract checks
  • CI: all 12 matrix jobs green (22.12.0 / 22 / 24 / 26 × Ubuntu / macOS / Windows), including the previously failing Node 22.12.0 Windows lane
  • Confirm the package is not published and no tag or GitHub release is created

Linear Issue: AUG-294

Open in Web Open in Cursor 

cursoragent and others added 2 commits October 15, 2026 00:38
Node.js 20 reached end of life in April 2026. Raise engines, the build
target, CI, discovery, and docs to 22.12 without bumping 0.3.9.

Co-authored-by: hamzahskafi <hamzahskafi@users.noreply.github.com>
Node 22.12.0 through 22.16.x ship libuv 1.49, which reports dev 0 from
path stat and the volume serial from fstat. Compare inodes, and compare
device ids only when both are nonzero, so the 22.12.0 Windows lane can
open files.

Co-authored-by: hamzahskafi <hamzahskafi@users.noreply.github.com>
hamzahskafi pushed a commit that referenced this pull request Oct 15, 2026
Cursor fixed the Windows Node 22.12-22.16 file-identity mismatch on
PR #87 (8c118ec) by treating a zero path-stat dev as unknown, so the
22.12 floor stays.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GDyUamKnmW15VzoFLkwnX5
@cursor
cursor Bot merged commit cac5ba6 into main Oct 15, 2026
12 checks passed
hamzahskafi pushed a commit that referenced this pull request Oct 15, 2026
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GDyUamKnmW15VzoFLkwnX5
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants