@cleocode/paths 2026.5.129 → 2026.5.131

package/dist/cleo-paths.d.ts

@@ -125,6 +125,29 @@ export interface ResolvedProject {
     /** The legacy UUID from project-info.json, if present. */
     legacyUUID?: string;
 }
+/**
+ * Canonicalize a filesystem path across operating systems — resolve symlinks
+ * and mount/alias divergence (macOS `/var` → `/private/var`, Windows
+ * drive-letter case + 8.3 short names, Linux bind-mounts) via
+ * {@link realpathSync}.
+ *
+ * Falls back to the lexically-resolved absolute path when the target does not
+ * exist on disk, so identity/root computations never throw for a moved,
+ * deleted, or not-yet-created project path.
+ *
+ * **SSoT:** this is the single path-canonicalization entry point for the CLEO
+ * SDK. Never call `realpathSync` ad-hoc for path identity — route through here
+ * so the OS-specific normalization stays consistent across every consumer and
+ * test (notably the macOS `/var` vs `/private/var` split).
+ *
+ * @param p - A relative or absolute filesystem path.
+ * @returns The realpath-canonicalized absolute path, or the lexically-resolved
+ *   absolute path when the target does not exist.
+ *
+ * @public
+ * @task T11023
+ */
+export declare function canonicalizePath(p: string): string;
 /**
  * Compute the canonical project ID for a given repository path (T9149/T11023).
  *

package/dist/cleo-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cleo-paths.d.ts","sourceRoot":"","sources":["../src/cleo-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAM7B;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAE9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAelD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAMvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAuDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA8CxE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiExE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}
+{"version":3,"file":"cleo-paths.d.ts","sourceRoot":"","sources":["../src/cleo-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAwB7B;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAE9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAelD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAMvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAuDD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASlD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA0CxE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkExE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}

package/dist/cleo-paths.js

@@ -11,11 +11,24 @@
 import { execFileSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import { existsSync, readFileSync, realpathSync } from 'node:fs';
+import { createRequire } from 'node:module';
 import { homedir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
-import { DatabaseSync } from 'node:sqlite';
 import { createPlatformPathsResolver, } from './platform-paths.js';
 const TEMPLATES_SUBDIR = 'templates';
+/**
+ * Returns the `node:sqlite` `DatabaseSync` constructor, loaded on first use.
+ *
+ * Loaded via `createRequire` so that importing this module does not eagerly pull
+ * in `node:sqlite` — preserving the lazy-init invariant (T1331/T11280).
+ *
+ * @internal
+ */
+function getDatabaseSyncCtor() {
+    const _require = createRequire(import.meta.url);
+    const mod = _require('node:sqlite');
+    return mod.DatabaseSync;
+}
 const cleoResolver = createPlatformPathsResolver('cleo', 'CLEO_HOME', 'CLEO_CONFIG_HOME');
 /**
  * Get OS-appropriate paths for CLEO's global directories.
@@ -201,6 +214,39 @@ function _readProjectInfoName(repoRoot) {
         return undefined;
     }
 }
+/**
+ * Canonicalize a filesystem path across operating systems — resolve symlinks
+ * and mount/alias divergence (macOS `/var` → `/private/var`, Windows
+ * drive-letter case + 8.3 short names, Linux bind-mounts) via
+ * {@link realpathSync}.
+ *
+ * Falls back to the lexically-resolved absolute path when the target does not
+ * exist on disk, so identity/root computations never throw for a moved,
+ * deleted, or not-yet-created project path.
+ *
+ * **SSoT:** this is the single path-canonicalization entry point for the CLEO
+ * SDK. Never call `realpathSync` ad-hoc for path identity — route through here
+ * so the OS-specific normalization stays consistent across every consumer and
+ * test (notably the macOS `/var` vs `/private/var` split).
+ *
+ * @param p - A relative or absolute filesystem path.
+ * @returns The realpath-canonicalized absolute path, or the lexically-resolved
+ *   absolute path when the target does not exist.
+ *
+ * @public
+ * @task T11023
+ */
+export function canonicalizePath(p) {
+    const resolved = resolve(p);
+    try {
+        return realpathSync(resolved);
+    }
+    catch {
+        // Target does not exist (moved / deleted / not-yet-created) — the
+        // lexically-resolved absolute path is the best canonical form available.
+        return resolved;
+    }
+}
 /**
  * Compute the canonical project ID for a given repository path (T9149/T11023).
  *
@@ -221,7 +267,7 @@ function _readProjectInfoName(repoRoot) {
  * @task T9149
  */
 export function computeCanonicalProjectId(repoPath) {
-    const realRepoPath = realpathSync(resolve(repoPath));
+    const realRepoPath = canonicalizePath(repoPath);
     const gitRoot = _findGitRootSync(realRepoPath);
     const effectiveRoot = gitRoot ?? realRepoPath;
     const remoteUrl = gitRoot ? _findGitRemoteUrlSync(gitRoot) : null;
@@ -281,17 +327,12 @@ export function resolveProjectByCwd(cwd) {
                 const raw = readFileSync(infoPath, 'utf-8');
                 const data = JSON.parse(raw);
                 if (typeof data.projectId === 'string' && data.projectId.length > 0) {
-                    // T11023: Normalize projectRoot via realpathSync to handle cross-mount
-                    // divergence — same repo at /mnt/projects/X and /workspace/X resolves
-                    // to the same real path (AC2, AC3).
-                    let realRoot;
-                    try {
-                        realRoot = realpathSync(current);
-                    }
-                    catch {
-                        // realpathSync fails on nonexistent paths — fall back to resolved path
-                        realRoot = current;
-                    }
+                    // T11023: Normalize projectRoot via the canonicalizePath SSoT to
+                    // handle cross-mount + cross-OS divergence — same repo at
+                    // /mnt/projects/X and /workspace/X (and macOS /var vs /private/var)
+                    // resolves to the same real path (AC2, AC3). Falls back to the
+                    // lexical path when `current` no longer exists on disk.
+                    const realRoot = canonicalizePath(current);
                     // T11023: Compute canonical projectId using T9149 algorithm
                     // (git-root + realpath fingerprint) for mount-invariant identity (AC1).
                     const canonicalId = computeCanonicalProjectId(realRoot);
@@ -343,6 +384,7 @@ export function resolveCanonicalCleoDir(projectId) {
         return null;
     let db;
     try {
+        const DatabaseSync = getDatabaseSyncCtor();
         db = new DatabaseSync(nexusDbPath, { readOnly: true }); // db-open-allowed: leaf path package cannot depend on core DB chokepoint
         // Try direct project_registry lookup first.
         const directStmt = db.prepare('SELECT project_path FROM project_registry WHERE project_id = ? LIMIT 1');

package/dist/cleo-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"cleo-paths.js","sourceRoot":"","sources":["../src/cleo-paths.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cleo-paths.js","sourceRoot":"","sources":["../src/cleo-paths.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -21,7 +21,8 @@
  * @task T11008
  */
 export { isAbsolutePath } from './abs-path.js';
-export { _resetCleoPlatformPathsCache, computeCanonicalProjectId, getCanonicalTemplatesTildePath, getCleoHome, getCleoPlatformPaths, getCleoSystemInfo, getCleoTemplatesTildePath, legacyProjectId, type ResolvedProject, resolveCanonicalCleoDir, resolveLegacyCleoDir, resolveProjectByCwd, } from './cleo-paths.js';
+export { _resetCleoPlatformPathsCache, canonicalizePath, computeCanonicalProjectId, getCanonicalTemplatesTildePath, getCleoHome, getCleoPlatformPaths, getCleoSystemInfo, getCleoTemplatesTildePath, legacyProjectId, type ResolvedProject, resolveCanonicalCleoDir, resolveLegacyCleoDir, resolveProjectByCwd, } from './cleo-paths.js';
+export { type EnforceOptions, enforceNodeVersion, evaluateNodeVersion, FALLBACK_MIN_NODE, getRequiredNodeVersion, type NodeManager, type NodeVersionVerdict, parseSemver, type Semver, type UpgradeHint, } from './node-version-gate.js';
 export { createPlatformPathsResolver, type PlatformPaths, type PlatformPathsResolver, type SystemInfo, } from './platform-paths.js';
 export { computeProjectHash, getCleoWorktreesRoot, resolveTaskWorktreePath, resolveWorktreeIndexPath, resolveWorktreeRootForHash, } from './worktree-paths.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,8BAA8B,EAC9B,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,KAAK,eAAe,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,EAChB,yBAAyB,EACzB,8BAA8B,EAC9B,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,KAAK,eAAe,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,cAAc,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,WAAW,EACX,KAAK,MAAM,EACX,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -21,7 +21,8 @@
  * @task T11008
  */
 export { isAbsolutePath } from './abs-path.js';
-export { _resetCleoPlatformPathsCache, computeCanonicalProjectId, getCanonicalTemplatesTildePath, getCleoHome, getCleoPlatformPaths, getCleoSystemInfo, getCleoTemplatesTildePath, legacyProjectId, resolveCanonicalCleoDir, resolveLegacyCleoDir, resolveProjectByCwd, } from './cleo-paths.js';
+export { _resetCleoPlatformPathsCache, canonicalizePath, computeCanonicalProjectId, getCanonicalTemplatesTildePath, getCleoHome, getCleoPlatformPaths, getCleoSystemInfo, getCleoTemplatesTildePath, legacyProjectId, resolveCanonicalCleoDir, resolveLegacyCleoDir, resolveProjectByCwd, } from './cleo-paths.js';
+export { enforceNodeVersion, evaluateNodeVersion, FALLBACK_MIN_NODE, getRequiredNodeVersion, parseSemver, } from './node-version-gate.js';
 export { createPlatformPathsResolver, } from './platform-paths.js';
 export { computeProjectHash, getCleoWorktreesRoot, resolveTaskWorktreePath, resolveWorktreeIndexPath, resolveWorktreeRootForHash, } from './worktree-paths.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,8BAA8B,EAC9B,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EAEf,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,GAI5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,EAChB,yBAAyB,EACzB,8BAA8B,EAC9B,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EAEf,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EAGtB,WAAW,GAGZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,2BAA2B,GAI5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/node-version-gate.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Node runtime-version enforcement gate (SSoT).
+ *
+ * Single source of truth for "is the running Node new enough to run CLEO".
+ * The minimum is read from this package's own shipped `engines.node` at
+ * runtime — NOT a hardcoded constant — so bumping the floor is a one-line
+ * `package.json` edit and the gate evolves with it. A CI lint
+ * (`scripts/lint-node-engine-ssot.mjs`) keeps every workspace package's
+ * `engines.node` equal to root's, so the value the gate reads is authoritative.
+ *
+ * Lives in `@cleocode/paths` — the zero-dep leaf (only `env-paths`) that is
+ * importable BEFORE any `@cleocode/core` import. The CLI guard must run here,
+ * not at `node:sqlite` load, so an under-floor Node fails with an actionable
+ * message instead of a cryptic `ERR_UNKNOWN_BUILTIN_MODULE` / divergent-SQLite
+ * behavior. (Importing this package does NOT eagerly load `node:sqlite` — that
+ * is lazy via `createRequire`; see `cleo-paths.ts`.)
+ *
+ * Why a full-semver floor and not a major-only check: 24.13.1 satisfies
+ * `major >= 24` yet is below 24.16.0, where the bundled SQLite WAL-reset
+ * corruption fix (SQLite 3.53.0) landed. The major-only guards
+ * (`cli/index.ts`, `dependencies.ts:checkNode`) waved it through, then the
+ * persistence layer diverged from CI. This gate compares full semver.
+ *
+ * @packageDocumentation
+ * @task T11281
+ * @task T11242
+ */
+/**
+ * Last-resort floor used only when this package's `engines.node` cannot be
+ * read (e.g. a corrupted install). Kept equal to root `engines.node` by the
+ * `lint-node-engine-ssot` CI gate so it can never silently lie.
+ */
+export declare const FALLBACK_MIN_NODE = "24.16.0";
+/** A parsed `major.minor.patch` triple. */
+export interface Semver {
+    major: number;
+    minor: number;
+    patch: number;
+}
+/**
+ * Parse the first `x.y.z` triple out of a version fragment such as
+ * `24.16.0`, `v24.16.0`, or a range like `>=24.16.0 <27`.
+ *
+ * @param raw - The version or range string.
+ * @returns The parsed {@link Semver}, or `null` when no triple is present.
+ */
+export declare function parseSemver(raw: string): Semver | null;
+/**
+ * Read the minimum Node version from this package's shipped `engines.node`
+ * (the SSoT). Falls back to {@link FALLBACK_MIN_NODE} when the manifest is
+ * unreadable or declares no parseable version.
+ *
+ * @returns A normalized `major.minor.patch` string.
+ *
+ * @public
+ */
+export declare function getRequiredNodeVersion(): string;
+/** A version manager (or platform installer) CLEO can suggest for upgrading. */
+export type NodeManager = 'fnm' | 'nvm' | 'n' | 'volta' | 'asdf' | 'brew' | 'winget' | 'choco' | 'nodesource';
+/** A concrete, copy-pasteable upgrade instruction. */
+export interface UpgradeHint {
+    manager: NodeManager;
+    command: string;
+    note?: string;
+}
+/** Result of evaluating the running Node against the required floor. */
+export interface NodeVersionVerdict {
+    compliant: boolean;
+    current: string;
+    required: string;
+    platform: NodeJS.Platform;
+    arch: string;
+    /** Ordered best-first; empty when compliant. */
+    hints: UpgradeHint[];
+}
+/**
+ * Evaluate the running Node against the required floor. Pure and
+ * side-effect-free (no `process.exit`, no I/O beyond the SSoT manifest read) —
+ * safe to call from `doctor`/`health` and unit tests.
+ *
+ * @param currentRaw - The Node version to evaluate. Defaults to
+ *   `process.versions.node`.
+ * @returns The {@link NodeVersionVerdict}.
+ *
+ * @public
+ */
+export declare function evaluateNodeVersion(currentRaw?: string): NodeVersionVerdict;
+/** Options controlling {@link enforceNodeVersion}. */
+export interface EnforceOptions {
+    /**
+     * `enforce` (default): print guidance + exit 1.
+     * `warn`: print guidance + continue.
+     * `auto`: best-effort install, then exit 1 ("open a new shell + re-run").
+     * Default resolves to `auto` when `CLEO_NODE_AUTO_UPGRADE=1`, else `enforce`.
+     */
+    mode?: 'enforce' | 'warn' | 'auto';
+    /** stderr writer (injectable for tests). */
+    write?: (s: string) => void;
+    /** process exit (injectable for tests). */
+    exit?: (code: number) => never;
+    /**
+     * Node version to evaluate. Defaults to `process.versions.node`. Injectable
+     * so tests assert a fixed verdict deterministically on any runtime (otherwise
+     * the same assertion flips between a below-floor dev box and a compliant CI).
+     */
+    current?: string;
+}
+/**
+ * The runtime gate. A microsecond no-op when Node is compliant; otherwise
+ * prints an exact, OS-/manager-aware upgrade instruction and (by default)
+ * exits non-zero.
+ *
+ * Auto mode (opt-in via `CLEO_NODE_AUTO_UPGRADE=1`) runs the install command,
+ * then STILL exits non-zero: version managers switch Node via shell shims, so
+ * a child process cannot hot-swap the interpreter already executing — the user
+ * must open a new shell and re-run. Silent toolchain mutation is deliberately
+ * never the default.
+ *
+ * @param opts - {@link EnforceOptions}.
+ * @returns The {@link NodeVersionVerdict} (for the compliant no-op path, and
+ *   for tests that stub `exit`).
+ *
+ * @public
+ */
+export declare function enforceNodeVersion(opts?: EnforceOptions): NodeVersionVerdict;
+//# sourceMappingURL=node-version-gate.d.ts.map

package/dist/node-version-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-version-gate.d.ts","sourceRoot":"","sources":["../src/node-version-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAQH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,2CAA2C;AAC3C,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAItD;AAWD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAW/C;AAED,gFAAgF;AAChF,MAAM,MAAM,WAAW,GACnB,KAAK,GACL,KAAK,GACL,GAAG,GACH,OAAO,GACP,MAAM,GACN,MAAM,GACN,QAAQ,GACR,OAAO,GACP,YAAY,CAAC;AAEjB,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AA6DD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,GAAE,MAA8B,GACzC,kBAAkB,CAepB;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACnC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;IAC/B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,cAAmB,GAAG,kBAAkB,CA4ChF"}

package/dist/node-version-gate.js

@@ -0,0 +1,224 @@
+/**
+ * Node runtime-version enforcement gate (SSoT).
+ *
+ * Single source of truth for "is the running Node new enough to run CLEO".
+ * The minimum is read from this package's own shipped `engines.node` at
+ * runtime — NOT a hardcoded constant — so bumping the floor is a one-line
+ * `package.json` edit and the gate evolves with it. A CI lint
+ * (`scripts/lint-node-engine-ssot.mjs`) keeps every workspace package's
+ * `engines.node` equal to root's, so the value the gate reads is authoritative.
+ *
+ * Lives in `@cleocode/paths` — the zero-dep leaf (only `env-paths`) that is
+ * importable BEFORE any `@cleocode/core` import. The CLI guard must run here,
+ * not at `node:sqlite` load, so an under-floor Node fails with an actionable
+ * message instead of a cryptic `ERR_UNKNOWN_BUILTIN_MODULE` / divergent-SQLite
+ * behavior. (Importing this package does NOT eagerly load `node:sqlite` — that
+ * is lazy via `createRequire`; see `cleo-paths.ts`.)
+ *
+ * Why a full-semver floor and not a major-only check: 24.13.1 satisfies
+ * `major >= 24` yet is below 24.16.0, where the bundled SQLite WAL-reset
+ * corruption fix (SQLite 3.53.0) landed. The major-only guards
+ * (`cli/index.ts`, `dependencies.ts:checkNode`) waved it through, then the
+ * persistence layer diverged from CI. This gate compares full semver.
+ *
+ * @packageDocumentation
+ * @task T11281
+ * @task T11242
+ */
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { arch as osArch, platform as osPlatform } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Last-resort floor used only when this package's `engines.node` cannot be
+ * read (e.g. a corrupted install). Kept equal to root `engines.node` by the
+ * `lint-node-engine-ssot` CI gate so it can never silently lie.
+ */
+export const FALLBACK_MIN_NODE = '24.16.0';
+/**
+ * Parse the first `x.y.z` triple out of a version fragment such as
+ * `24.16.0`, `v24.16.0`, or a range like `>=24.16.0 <27`.
+ *
+ * @param raw - The version or range string.
+ * @returns The parsed {@link Semver}, or `null` when no triple is present.
+ */
+export function parseSemver(raw) {
+    const m = /(\d+)\.(\d+)\.(\d+)/.exec(raw.trim());
+    if (!m)
+        return null;
+    return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) };
+}
+/**
+ * `a >= b` for {@link Semver} (major, then minor, then patch).
+ */
+function gte(a, b) {
+    if (a.major !== b.major)
+        return a.major > b.major;
+    if (a.minor !== b.minor)
+        return a.minor > b.minor;
+    return a.patch >= b.patch;
+}
+/**
+ * Read the minimum Node version from this package's shipped `engines.node`
+ * (the SSoT). Falls back to {@link FALLBACK_MIN_NODE} when the manifest is
+ * unreadable or declares no parseable version.
+ *
+ * @returns A normalized `major.minor.patch` string.
+ *
+ * @public
+ */
+export function getRequiredNodeVersion() {
+    try {
+        const pkgPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        const parsed = parseSemver(pkg.engines?.node ?? '');
+        return parsed ? `${parsed.major}.${parsed.minor}.${parsed.patch}` : FALLBACK_MIN_NODE;
+    }
+    catch {
+        return FALLBACK_MIN_NODE;
+    }
+}
+/**
+ * Build OS- and manager-aware upgrade hints from environment + platform ONLY
+ * (no `child_process` spawns), so the compliant fast-path stays a no-op.
+ *
+ * @param required - The required Node version (e.g. `24.16.0`).
+ * @param platform - The current `process.platform`.
+ */
+function upgradeHints(required, platform) {
+    const hints = [];
+    const e = process.env;
+    if (e['FNM_DIR'] || e['FNM_MULTISHELL_PATH']) {
+        hints.push({
+            manager: 'fnm',
+            command: `fnm install ${required} && fnm use ${required} && fnm default ${required}`,
+        });
+    }
+    if (e['NVM_DIR']) {
+        hints.push({
+            manager: 'nvm',
+            command: `nvm install ${required} && nvm alias default ${required}`,
+        });
+    }
+    if (e['VOLTA_HOME']) {
+        hints.push({ manager: 'volta', command: `volta install node@${required}` });
+    }
+    if (e['ASDF_DIR'] || e['ASDF_DATA_DIR']) {
+        hints.push({
+            manager: 'asdf',
+            command: `asdf install nodejs ${required} && asdf global nodejs ${required}`,
+        });
+    }
+    // Platform fallbacks when no manager env is detected.
+    if (hints.length === 0) {
+        if (platform === 'win32') {
+            hints.push({ manager: 'winget', command: 'winget install OpenJS.NodeJS' });
+            hints.push({ manager: 'choco', command: `choco upgrade nodejs --version=${required}` });
+        }
+        else if (platform === 'darwin') {
+            hints.push({ manager: 'brew', command: 'brew upgrade node' });
+            hints.push({
+                manager: 'fnm',
+                command: `curl -fsSL https://fnm.vercel.app/install | bash && fnm install ${required}`,
+            });
+        }
+        else {
+            hints.push({
+                manager: 'fnm',
+                command: `curl -fsSL https://fnm.vercel.app/install | bash && fnm install ${required}`,
+            });
+            hints.push({
+                manager: 'nodesource',
+                command: '# see https://github.com/nodesource/distributions',
+                note: 'system-wide install',
+            });
+        }
+    }
+    return hints;
+}
+/**
+ * Evaluate the running Node against the required floor. Pure and
+ * side-effect-free (no `process.exit`, no I/O beyond the SSoT manifest read) —
+ * safe to call from `doctor`/`health` and unit tests.
+ *
+ * @param currentRaw - The Node version to evaluate. Defaults to
+ *   `process.versions.node`.
+ * @returns The {@link NodeVersionVerdict}.
+ *
+ * @public
+ */
+export function evaluateNodeVersion(currentRaw = process.versions.node) {
+    const required = getRequiredNodeVersion();
+    const cur = parseSemver(currentRaw);
+    const req = parseSemver(required) ?? parseSemver(FALLBACK_MIN_NODE);
+    const platform = osPlatform();
+    // `req` is non-null: FALLBACK_MIN_NODE is a valid triple by construction.
+    const compliant = cur !== null && req !== null && gte(cur, req);
+    return {
+        compliant,
+        current: currentRaw,
+        required,
+        platform,
+        arch: osArch(),
+        hints: compliant ? [] : upgradeHints(required, platform),
+    };
+}
+/**
+ * The runtime gate. A microsecond no-op when Node is compliant; otherwise
+ * prints an exact, OS-/manager-aware upgrade instruction and (by default)
+ * exits non-zero.
+ *
+ * Auto mode (opt-in via `CLEO_NODE_AUTO_UPGRADE=1`) runs the install command,
+ * then STILL exits non-zero: version managers switch Node via shell shims, so
+ * a child process cannot hot-swap the interpreter already executing — the user
+ * must open a new shell and re-run. Silent toolchain mutation is deliberately
+ * never the default.
+ *
+ * @param opts - {@link EnforceOptions}.
+ * @returns The {@link NodeVersionVerdict} (for the compliant no-op path, and
+ *   for tests that stub `exit`).
+ *
+ * @public
+ */
+export function enforceNodeVersion(opts = {}) {
+    const verdict = evaluateNodeVersion(opts.current);
+    if (verdict.compliant)
+        return verdict; // fast path — the common case
+    const write = opts.write ?? ((s) => void process.stderr.write(s));
+    const exit = opts.exit ?? ((c) => process.exit(c));
+    const mode = opts.mode ?? (process.env['CLEO_NODE_AUTO_UPGRADE'] === '1' ? 'auto' : 'enforce');
+    const primary = verdict.hints[0]?.command ?? `# install Node >= ${verdict.required}`;
+    const extra = verdict.hints
+        .slice(1)
+        .map((h) => `  (${h.manager}) ${h.command}\n`)
+        .join('');
+    write(`\nError: cleo requires Node.js >= ${verdict.required}\n` +
+        `You are running Node ${verdict.current} (${verdict.platform}/${verdict.arch}).\n\n` +
+        `Node ${verdict.required} bundles the SQLite WAL-reset corruption fix CLEO's\n` +
+        `persistence layer (node:sqlite, zero native deps) depends on. Older 24.x\n` +
+        `builds pass a major-only check but diverge at runtime (e.g. sqlite_master\n` +
+        `DEFENSIVE-mode handling), causing local results to differ from CI.\n\n` +
+        `Update to proceed:\n    ${primary}\n\n` +
+        (extra ? `Other options:\n${extra}\n` : ''));
+    if (mode === 'warn')
+        return verdict;
+    if (mode === 'auto') {
+        // Deferred require keeps child_process off the compliant fast-path. A
+        // version-manager install mutates the SHELL, not this process, so we run it
+        // then still exit non-zero below asking for a fresh shell + re-run.
+        try {
+            const req = createRequire(import.meta.url);
+            const { execSync } = req('node:child_process');
+            write(`Attempting: ${primary}\n`);
+            // execSync runs through a shell by default, so compound `&&` commands work.
+            execSync(primary, { stdio: 'inherit' });
+            write(`\nInstalled Node ${verdict.required}. Open a NEW shell and re-run cleo.\n`);
+        }
+        catch {
+            write('\nAuto-upgrade failed — run the command above manually.\n');
+        }
+    }
+    return exit(1);
+}
+//# sourceMappingURL=node-version-gate.js.map

package/dist/node-version-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-version-gate.js","sourceRoot":"","sources":["../src/node-version-gate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/paths",
-  "version": "2026.5.129",
+  "version": "2026.5.131",
   "private": false,
   "type": "module",
   "description": "CLEO XDG/env-paths SSoT — createPlatformPathsResolver factory, cleo-bound platform paths, project hash + worktree root primitives, isAbsolutePath. Zero-dep leaf package consumed by core, worktree, brain, adapters, and caamp.",
@@ -24,7 +24,7 @@
     "platform"
   ],
   "engines": {
-    "node": ">=24.0.0"
+    "node": ">=24.16.0"
   },
   "author": "CLEO Code <hello@cleocode.dev>",
   "license": "MIT",