Skip to content

Run CI on Node 24 and raise the engines floor - #214

Open
francoisferrand wants to merge 5 commits into
development/8.3from
improvement/GDL-16
Open

francoisferrand wants to merge 5 commits into
development/8.3from
improvement/GDL-16

Conversation

@francoisferrand

Copy link
Copy Markdown
Contributor

Node 20 went end-of-life in April 2026, but the manifest still advertised >=20 — support for a runtime nobody tests. CI now runs a 22/24 matrix and engines.node moves to >=22.

Deliberately not >=24: this config is consumed by repos still on 22, and raising the floor before they move would break their installs. That drops to >=24 in a later pass, or when Node 22 goes EOL in April 2027.

Dependencies

Went looking for bumps worth taking alongside the runtime change, and found more than expected.

markdownlint 0.31.1 → 0.38.0. 0.31.1 pinned markdown-it 13, which carries the linkify-it ReDoS advisory plus two of its own — the audit findings every consumer of this package inherited. 0.38.0 drops markdown-it entirely, so the chain leaves their trees rather than being pinned forward. An override here wouldn't have helped: resolutions are root-only and never ship to consumers. yarn audit goes 26 → 0.

Worth knowing: the replacement pulls in micromark + katex, so the production closure grows from 9 to 46 packages (~8.8MB, mostly a LaTeX renderer for $math$ support). That only lands in CI installs — every consumer has this as a devDependency — but expect a slower yarn install and don't attribute it to whatever else lands that week.

markdownlint is ESM-only now, so the sync API is imported dynamically. That keeps mdlint CommonJS and working on older Node 22 patches where require() can't load an ES module — utapi still pins 22.11.0. MD059 is new in this release and fires on links that already exist in backbeat and cloudserver, so it's off until those are reworded.

globals was never declared. index.js requires it, and nothing in the manifest mentioned it — installs only worked because eslint happens to pull it in transitively and yarn hoists it to the top level. Under pnpm, or if eslint ever drops that path, every consumer breaks at once. Pinned ^14.0.0 to match what's already resolved, so no second copy appears.

eslint and prettier are now peers. They stay out of dependencies — consumers run their own, and a second eslint in the tree is how plugins end up loaded twice — but the package was shipping lint rules while declaring no opinion at all about what it plugs into. Scoped to ^9 rather than >=9 since eslint 10 is untested here. prettier is optional: three consumers don't use it.

commander dropped. commander.parse(process.argv).args is process.argv.slice(2) when no options are declared, and every consumer calls mdlint with a bare file list. It bought an empty help screen.

Verification

yarn install --frozen-lockfile, yarn test and yarn audit all clean on Node 22.11.0, 22.23.2 and 24.21.0. 22.11.0 is in there on purpose — it's utapi's pin and the one version where the dynamic import matters.

Ships as 8.3.3, which is in the manifest but was never tagged.

Issue: GDL-16

Node 20 reached end-of-life in April 2026, so the manifest advertised
support for a runtime nobody tests. Node 24 is Active LTS until April
2028 and is where we are heading.

Both versions stay in the matrix while consumers straddle them; the
floor moves to 24 in a later pass, once they have all moved over.

Issue: GDL-16
markdownlint 0.31.1 dragged in markdown-it 13, and with it the
linkify-it ReDoS advisory - the one audit finding every consumer of this
package inherited. 0.38.0 drops markdown-it altogether, so the chain
disappears from their trees rather than being pinned forward: an
override here would not have reached them anyway.

It ships as ESM, so the sync API now comes from markdownlint/sync.
require() handles that natively, and the package stays CommonJS so
consumers requiring the config are unaffected. MD059 is new in this
release and fires on links that already exist in backbeat and
cloudserver, so it is off until those are reworded.

eslint and prettier move up to versions that support 24, and
brace-expansion and flatted get re-resolved - the lockfile was holding
them below what their ranges already allowed.

Issue: GDL-16
require() only loads an ES module from Node 22.12 onwards, and utapi
still pins 22.11.0 in CI, so it would hit ERR_REQUIRE_ESM the moment it
picks up this release. A dynamic import keeps the script CommonJS and
works on anything from Node 12 up, which costs nothing here and saves
coordinating a runtime bump in another repo first.

Issue: GDL-16
index.js requires globals but nothing declared it: installs only worked
because eslint happens to pull it in transitively and yarn hoists it to
the top level. Under pnpm, or if eslint ever drops that path, every
consumer breaks at once. Pinning ^14 matches what is already resolved,
so no second copy appears.

eslint and prettier stay out of dependencies - consumers run their own,
and a second eslint in the tree is how plugins end up loaded twice - but
they belong in peerDependencies so a mismatch is visible at install
rather than halfway through a lint run. prettier is optional: the config
and prettier-diff are opt-in, and three consumers do not use them.

Issue: GDL-16
commander.parse(process.argv).args is process.argv.slice(2) for every way
this tool is called - no options are declared, and all four consumers
invoke it as a bare file list. What it added was an auto-generated help
screen with nothing in it, and rejection of unknown flags, at the cost of
a runtime dependency shipped into every consumer's tree.

Filenames starting with a dash used to be rejected as unknown options;
they now lint like any other file.

Issue: GDL-16
@bert-e

bert-e commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

Hello francoisferrand,

My role is to assist you with the merge of this
pull request. Please type @bert-e help to get information
on this process, or consult the user documentation.

Available options
name description privileged authored
/after_pull_request Wait for the given pull request id to be merged before continuing with the current one.
/bypass_author_approval Bypass the pull request author's approval
/bypass_build_status Bypass the build and test status
/bypass_commit_size Bypass the check on the size of the changeset TBA
/bypass_incompatible_branch Bypass the check on the source branch prefix
/bypass_jira_check Bypass the Jira issue check
/bypass_peer_approval Bypass the pull request peers' approval
/bypass_leader_approval Bypass the pull request leaders' approval
/bypass_source_branch_lineage Bypass the cross-branch contamination check
/approve Instruct Bert-E that the author has approved the pull request. ✍️
/create_pull_requests Allow the creation of integration pull requests.
/create_integration_branches Allow the creation of integration branches.
/no_octopus Prevent Wall-E from doing any octopus merge and use multiple consecutive merge instead
/unanimity Change review acceptance criteria from one reviewer at least to all reviewers
/wait Instruct Bert-E not to run until further notice.
Available commands
name description privileged
/help Print Bert-E's manual in the pull request.
/status Print Bert-E's current status in the pull request.
/clear Remove all comments from Bert-E from the history TBA
/retry Re-start a fresh build TBA
/build Re-start a fresh build TBA
/force_reset Delete integration branches & pull requests, and restart merge process from the beginning.
/reset Try to remove integration branches unless there are commits on them which do not appear on the source branch.

Status report is not available.

@bert-e

bert-e commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

Waiting for approval

The following approvals are needed before I can proceed with the merge:

  • the author

  • 2 peers

@scality scality deleted a comment from bert-e Sep 16, 2026
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.

4 participants