claude-nomad 0.22.2 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.23.0](https://github.com/funkadelic/claude-nomad/compare/v0.22.3...v0.23.0) (2026-05-23)
+
+
+### Added
+
+* **doctor:** warn when host node is below engines.node minimum ([#116](https://github.com/funkadelic/claude-nomad/issues/116)) ([3caf8d0](https://github.com/funkadelic/claude-nomad/commit/3caf8d09362b2f290af3d0efd9ea79a64aac39c1))
+
+
+### Changed
+
+* **tests:** add lockfile drift gate to catch release-please mismatches ([#114](https://github.com/funkadelic/claude-nomad/issues/114)) ([5847553](https://github.com/funkadelic/claude-nomad/commit/58475538ed405e1d2d1d00662ea6730ad124da42))
+
+## [0.22.3](https://github.com/funkadelic/claude-nomad/compare/v0.22.2...v0.22.3) (2026-05-23)
+
+
+### Changed
+
+* **deps:** resync package-lock with manifest after 0.22.2 ([#109](https://github.com/funkadelic/claude-nomad/issues/109)) ([7317fd4](https://github.com/funkadelic/claude-nomad/commit/7317fd4bb375c5a5fb9c05c327fc75423946b0f0))
+
 ## [0.22.2](https://github.com/funkadelic/claude-nomad/compare/v0.22.1...v0.22.2) (2026-05-23)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-nomad",
-  "version": "0.22.2",
+  "version": "0.23.0",
   "type": "module",
   "description": "Sync Claude Code config (~/.claude/) across machines via a private Git repo, with path remapping and per-host settings overrides.",
   "keywords": [

package/src/commands.doctor.engine.ts

@@ -0,0 +1,90 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+import { green, okGlyph, warnGlyph, yellow } from './color.ts';
+import { addItem, type DoctorSection } from './commands.doctor.format.ts';
+import { compareSemver } from './commands.doctor.version.ts';
+
+/**
+ * Soft host-fitness check appended to the Version section of `nomad doctor`.
+ * Compares the running node version (`process.version`) to the minimum required
+ * by `engines.node` in `package.json`, emitting one of:
+ *   - `✓ node: vX.Y.Z (satisfies >=A.B.C)` when current >= required
+ *   - `⚠︎ node: vX.Y.Z (below required >=A.B.C, run \`nvm install\`)` when below
+ * Every failure path (missing engines, unsupported range syntax, unreadable
+ * `package.json`) is a SILENT skip; this module never sets `process.exitCode`
+ * and never writes to stderr. Mirrors the philosophy of the sibling release-
+ * version check in `commands.doctor.version.ts`.
+ */
+
+/** Strict `>=X.Y.Z` matcher. The project's `engines.node` field has always
+ * used this form; anything more exotic (`^`, `~`, exact pin, OR ranges) is
+ * out of scope and triggers the silent-skip path so we never falsely PASS or
+ * falsely WARN on a spec we cannot parse with full confidence. */
+const ENGINES_GTE = /^>=\s*(\d+\.\d+\.\d+)$/;
+
+/**
+ * Peel the minimum strict-semver out of an `engines.node` spec when the spec
+ * is `>=X.Y.Z` (optional whitespace after `>=`). Returns the bare `X.Y.Z`
+ * string. Any other shape (`^X.Y.Z`, `~X.Y.Z`, exact pins, OR ranges, bare
+ * versions) returns `null` so the caller silently skips the diagnostic.
+ */
+export function parseMinVersion(spec: string): string | null {
+  const m = ENGINES_GTE.exec(spec);
+  return m ? m[1] : null;
+}
+
+/**
+ * Locate and parse the local `package.json`, returning the `engines.node`
+ * string when present, non-empty, and a string. Any throw (missing file,
+ * parse error, etc.) becomes a `null` return so the caller silently skips.
+ */
+function readEnginesNode(): string | null {
+  try {
+    const pkgPath = fileURLToPath(new URL('../package.json', import.meta.url));
+    const parsed = JSON.parse(readFileSync(pkgPath, 'utf8')) as {
+      engines?: { node?: unknown };
+    };
+    const node = parsed.engines?.node;
+    if (typeof node === 'string' && node.length > 0) return node;
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Emit a single, non-fatal node-engine diagnostic for `nomad doctor` by
+ * comparing `process.version` to the minimum required by `engines.node`.
+ *
+ * Logs one of:
+ * - `✓ node: vX.Y.Z (satisfies >=A.B.C)` when current is at or above the minimum
+ * - `⚠︎ node: vX.Y.Z (below required >=A.B.C, run \`nvm install\`)` when below
+ *
+ * Any failure to read `package.json`, locate `engines.node`, or parse the
+ * range spec results in no output and does not change `process.exitCode`.
+ */
+export function reportNodeEngineCheck(section: DoctorSection): void {
+  const required = readEnginesNode();
+  if (required === null) return;
+  const min = parseMinVersion(required);
+  if (min === null) return;
+  const current = process.version.replace(/^v/, '');
+  // Belt-and-suspenders: official Node release builds always produce a strict
+  // `vX.Y.Z`, but prerelease/nightly builds can carry a suffix
+  // (e.g. `v22.0.0-rc.1`) that compareSemver classifies as undecidable
+  // (returns 0). Without this guard, an undecidable comparison would fall
+  // through to the green PASS branch and falsely claim the host satisfies the
+  // engine constraint. Silent-skip matches the module's "err on the side of
+  // saying nothing" philosophy.
+  if (!/^\d+\.\d+\.\d+$/.test(current)) return;
+  const cmp = compareSemver(current, min);
+  if (cmp === -1) {
+    addItem(
+      section,
+      `${yellow(warnGlyph)} node: ${process.version} (below required >=${min}, run \`nvm install\`)`,
+    );
+    return;
+  }
+  addItem(section, `${green(okGlyph)} node: ${process.version} (satisfies >=${min})`);
+}

package/src/commands.doctor.ts

@@ -12,6 +12,7 @@ import {
   reportRepoState,
   reportSharedLinks,
 } from './commands.doctor.checks.ts';
+import { reportNodeEngineCheck } from './commands.doctor.engine.ts';
 import { renderDoctor, section } from './commands.doctor.format.ts';
 import { reportVersionCheck } from './commands.doctor.version.ts';
 
@@ -51,6 +52,7 @@ export function cmdDoctor(): void {
 
   const version = section('Version');
   reportVersionCheck(version);
+  reportNodeEngineCheck(version);
 
   renderDoctor([version, host, links, settings, pathMap, neverSync, repository]);
 }