@giovannijecha/jecode 0.1.7 → 0.1.8

package/README.md

@@ -20,10 +20,15 @@
 <p align="center">
   <a href="https://github.com/giovannijecha/jecode/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/giovannijecha/jecode/actions/workflows/ci.yml/badge.svg"></a>
   <a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-669BD2"></a>
-  <img alt="Node.js 24+" src="https://img.shields.io/badge/node-%3E%3D24-86CB92">
+  <img alt="Node.js 22.18+ or 24+" src="https://img.shields.io/badge/node-22.18%2B%20%7C%2024%2B-86CB92">
   <img alt="Runtime dependencies: zero" src="https://img.shields.io/badge/runtime_dependencies-0-8DB4DD">
 </p>
 
+<p align="center">
+  <a href="https://github.com/giovannijecha/jecode/blob/main/CHANGELOG.md">Changelog</a> ·
+  <a href="https://github.com/giovannijecha/jecode/releases">Releases</a>
+</p>
+
 > Jecode is an early 0.1.x release. The core loop is usable today; commands and
 > terminal interactions may still evolve before 1.0.
 
@@ -38,12 +43,12 @@
 - **Provider-neutral.** Use Anthropic, OpenAI, or a local/remote Ollama server
   without changing the workflow.
 - **Lean by construction.** Jecode installs as plain JavaScript, runs on
-  Node.js 24, executes no installation scripts, and has zero third-party
-  runtime dependencies.
+  Node.js 22.18+ (22.x) or Node.js 24+, executes no installation scripts, and
+  has zero third-party runtime dependencies.
 
 ## Install
 
-Jecode requires **Node.js 24 or newer** and npm:
+Jecode requires **Node.js 22.18+ on the 22.x line, or Node.js 24+**, and npm:
 
 ~~~console
 npm install --global @giovannijecha/jecode
@@ -82,6 +87,18 @@ npm install --global @giovannijecha/jecode
 jecode --version
 ~~~
 
+If you installed Jecode from GitHub before the scoped npm package existed,
+remove the old unscoped package once before updating:
+
+~~~console
+npm uninstall --global jecode
+npm install --global @giovannijecha/jecode
+~~~
+
+An `EEXIST` error for a `bin/jecode` path usually means that this legacy
+executable still owns the command. Remove it instead of installing with
+`--force`.
+
 ### Uninstall
 
 ~~~console
@@ -95,10 +112,22 @@ when you intentionally want to erase Jecode's local data.
 ### Linux and WSL
 
 WSL has its own Node.js installation and `PATH`; the Node.js version installed
-on Windows does not apply inside it. If installation succeeds but `jecode` is
-not found, run **npm config get prefix** and ensure its **bin/** directory is on
-your Linux `PATH`. Do not ignore an `EBADENGINE` warning: **node --version** must
-report 24 or newer.
+on Windows does not apply inside it. Keep user-installed npm commands in the
+Linux user path and put that path before inherited Windows entries:
+
+~~~console
+npm config set prefix "$HOME/.local"
+export PATH="$HOME/.local/bin:$PATH"
+npm install --global @giovannijecha/jecode
+hash -r
+command -v jecode
+jecode --version
+~~~
+
+Persist the `PATH` export in `~/.profile` or your shell's startup file. Inside
+WSL, **command -v jecode** should resolve below `/home/...`, not below
+`/mnt/c/.../Volta`. Do not ignore an `EBADENGINE` warning: **node --version**
+must report 22.18+ on the 22.x line, or 24+.
 
 ### Build from source
 

package/bin/jecode.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 
-const major = Number.parseInt(process.versions.node, 10);
-if (major < 24) {
+const [major = 0, minor = 0] = process.versions.node.split(".").map(Number);
+const supported = major >= 24 || (major === 22 && minor >= 18);
+if (!supported) {
   process.stderr.write(
-    `jecode requires Node.js 24 or newer (current: ${process.versions.node})\n`,
+    `jecode requires Node.js 22.18+ (22.x) or Node.js 24+ (current: ${process.versions.node})\n`,
   );
   process.exitCode = 1;
 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giovannijecha/jecode",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "An owned coding agent with zero external runtime dependencies.",
   "license": "MIT",
   "repository": {
@@ -29,7 +29,7 @@
     "jecode": "bin/jecode.js"
   },
   "engines": {
-    "node": ">=24"
+    "node": "^22.18.0 || >=24.0.0"
   },
   "publishConfig": {
     "access": "public",