Skip to content

docs: correct Node engines floor to >=20.0.0 in CLAUDE.md#880

Open
Dashsoap wants to merge 1 commit into
colbymchenry:mainfrom
Dashsoap:docs/claude-node-engines-20
Open

docs: correct Node engines floor to >=20.0.0 in CLAUDE.md#880
Dashsoap wants to merge 1 commit into
colbymchenry:mainfrom
Dashsoap:docs/claude-node-engines-20

Conversation

@Dashsoap

Copy link
Copy Markdown

What

CLAUDE.md '## Build, Test, Run' section says:

Node engines: >=18.0.0 <25.0.0.

The actual supported floor is Node 20, not 18. This one-line doc fix aligns it with the code.

Why

Three sources of truth all say 20, only this doc line says 18:

  • package.json"engines": { "node": ">=20.0.0 <25.0.0" }
  • src/bin/node-version-check.tsexport const MIN_NODE_MAJOR = 20;, hard-enforced at CLI bootstrap (not just an npm warning). Its own JSDoc: "Lowest supported Node.js major version. Matches the engines floor in package.json."
  • buildNodeTooOldBanner — the banner shown below the floor reads "CodeGraph requires Node.js 20 or newer."

So the CLI hard-exits on Node 18, but the LLM-readable architecture doc tells agents 18 is fine. Diff:

-Node engines: `>=18.0.0 <25.0.0`. There is a hard exit on Node 25.x (see `src/bin/node-version-check.ts`).
+Node engines: `>=20.0.0 <25.0.0`. There is a hard exit on Node 25.x (see `src/bin/node-version-check.ts`).

Docs-only, no code change.

CLAUDE.md stated `>=18.0.0 <25.0.0`, but the actual supported floor is
Node 20. Three sources agree on 20, not 18:

  - package.json "engines": ">=20.0.0 <25.0.0"
  - src/bin/node-version-check.ts: MIN_NODE_MAJOR = 20 (hard-enforced
    at CLI bootstrap, with a 'requires Node.js 20 or newer' banner)
  - the buildNodeTooOldBanner text shown below that floor

Align the doc with the enforced floor so the LLM-readable guidance
doesn't claim Node 18 works when the CLI hard-exits below 20.
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.

1 participant