Skip to content

Lower minimum Node version to 22.16#154

Merged
lzehrung merged 2 commits into
mainfrom
lower-node-requirement
Jul 12, 2026
Merged

Lower minimum Node version to 22.16#154
lzehrung merged 2 commits into
mainfrom
lower-node-requirement

Conversation

@lzehrung

Copy link
Copy Markdown
Owner

Summary

  • lower the supported Node.js floor from 24.10 to 22.16
  • run CI at the new minimum and align Node type declarations
  • preserve Node 22.16 SQLite statement APIs through a narrow local type bridge
  • update installation guidance and the bundled Codegraph skill
  • add the IDE-style agent navigation and refactor implementation plan

Why Node 22.16

Node 20 does not provide node:sqlite. Node 22.16 is the first Node 22 release containing both StatementSync.setReturnArrays() and StatementSync.columns(), which Codegraph's SQLite layer requires.

Verification

  • npx --yes --package=node@22.16.0 -- npm run build
  • npx --yes node@22.16.0 ./node_modules/vitest/vitest.mjs run tests/sqlite.test.ts tests/package-metadata.test.ts (58 passed)
  • npm run test:integration (130 passed)
  • Node 22.16 orient --root . --budget small --json smoke test
  • git diff --cached --check

Node 22.16 emits its upstream experimental warning when node:sqlite is loaded; behavior is otherwise covered by the focused SQLite suite.

@lzehrung lzehrung requested a review from Copilot July 12, 2026 14:43
@kilo-code-bot

kilo-code-bot Bot commented Jul 12, 2026

Copy link
Copy Markdown
Contributor

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (8 files)
  • .github/workflows/on-demand-ci.yml
  • README.md
  • codegraph-skill/codegraph/SKILL.md
  • docs/installation.md
  • docs/plans/2026-07-12-ide-style-agent-navigation-refactor.md
  • package.json
  • src/sqlite-driver.ts
  • tests/package-metadata.test.ts

Reviewed by kimi-k2.6 · Input: 371.9K · Output: 17K · Cached: 1.3M

@lzehrung lzehrung merged commit fad8113 into main Jul 12, 2026
3 checks passed

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Lowers Codegraph’s minimum supported Node.js runtime from 24.10 to 22.16, updating CI, TypeScript Node typings, and user-facing installation guidance accordingly, while keeping required node:sqlite statement-metadata APIs usable via a local type bridge.

Changes:

  • Drop the engines.node floor to >=22.16 and align @types/node to the Node 22.16 line.
  • Update CI and documentation to reflect the new minimum Node version.
  • Add a large implementation plan doc for IDE-style agent navigation/refactor capabilities.

Reviewed changes

Copilot reviewed 8 out of 9 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
tests/package-metadata.test.ts Updates the asserted Node engine floor to >=22.16 and clarifies the SQLite API requirement wording.
src/sqlite-driver.ts Introduces a narrow NodeSqliteStatement bridge and updates statement handling to match Node 22.16 SQLite metadata APIs.
README.md Updates the “Try it” Node.js requirement to 22.16+.
package.json Lowers engines.node and pins @types/node to ~22.16.0.
package-lock.json Updates lockfile entries for Node typings and transitive dependencies.
docs/plans/2026-07-12-ide-style-agent-navigation-refactor.md Adds a detailed design/implementation plan document.
docs/installation.md Updates the documented Node.js requirement to 22.16+.
codegraph-skill/codegraph/SKILL.md Updates the bundled skill installation requirement to Node.js 22.16+.
.github/workflows/on-demand-ci.yml Runs CI on Node 22.16.0 to validate the new minimum runtime.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread src/sqlite-driver.ts
Comment on lines 132 to 134
prepare(sql: string): SqliteStatement {
return new SqliteStatement(this.db.prepare(sql));
return new SqliteStatement(this.db.prepare(sql) as NodeSqliteStatement);
}
Comment on lines 19 to 23
- name: Setup Node
uses: actions/setup-node@v6
with:
node-version: 24.10.0
node-version: 22.16.0
cache: npm
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