sdkvm 1.0.0 → 1.0.1

package/dist/index.js

@@ -16,7 +16,7 @@ var SdkvmError = class extends Error {
 };
 function toSdkvmError(err) {
   if (err instanceof SdkvmError) return err;
-  if (err instanceof Error) return new SdkvmError(err.message, { hint: err.stack });
+  if (err instanceof Error) return new SdkvmError(err.message);
   return new SdkvmError(String(err));
 }
 
@@ -24,16 +24,14 @@ function toSdkvmError(err) {
 import pc from "picocolors";
 
 // src/core/env.ts
-function envOverride(newName, legacyName) {
-  const fresh = process.env[newName];
-  if (fresh !== void 0 && fresh !== "") return fresh;
-  const legacy = process.env[legacyName];
-  if (legacy !== void 0 && legacy !== "") return legacy;
+function envGet(name) {
+  const value = process.env[name];
+  if (value !== void 0 && value !== "") return value;
   return void 0;
 }
 
 // src/ui/log.ts
-var isQuiet = () => Boolean(envOverride("SDKVM_QUIET", "JVM_QUIET"));
+var isQuiet = () => Boolean(envGet("SDKVM_QUIET"));
 var label = {
   info: pc.cyan("sdkvm"),
   ok: pc.green("sdkvm"),
@@ -77,9 +75,9 @@ function detectPlatform(override) {
     aarch64: "aarch64",
     x64: "x64"
   };
-  const os6 = osMap[rawPlatform];
+  const os5 = osMap[rawPlatform];
   const arch = archMap[rawArch];
-  if (!os6) {
+  if (!os5) {
     throw new SdkvmError(`Unsupported operating system: ${rawPlatform}`, {
       hint: "sdkvm currently supports macOS, Linux and Windows."
     });
@@ -89,11 +87,11 @@ function detectPlatform(override) {
       hint: "sdkvm currently supports aarch64 (Apple Silicon / ARM) and x64."
     });
   }
-  return { os: os6, arch, rawPlatform, rawArch };
+  return { os: os5, arch, rawPlatform, rawArch };
 }
 
 // src/core/config.ts
-import fs4 from "fs";
+import fs5 from "fs";
 import path4 from "path";
 
 // src/core/version.ts
@@ -295,6 +293,62 @@ function parseFlutterUserSpec(input) {
     hint: "Expected: 3.47, 3.47.5, 3.49.0-0.1.pre, latest, or with vendor prefix like flutter-3.47"
   });
 }
+var NODE_VENDOR_IDS = ["nodejs"];
+function parseNodeVersion(vendor, input) {
+  const raw = input.trim();
+  const s = raw.replace(/^nodejs-/i, "").replace(/^node-/i, "").replace(/^v/i, "");
+  const m = /^(\d+)\.(\d+)\.(\d+)$/.exec(s);
+  if (!m || !m[1] || !m[2] || !m[3]) {
+    throw new SdkvmError(`Invalid Node.js version: "${input}"`, {
+      hint: "Expected forms: 22, 22.20.0, lts, latest"
+    });
+  }
+  return {
+    vendor,
+    major: Number(m[1]),
+    minor: Number(m[2]),
+    patch: Number(m[3]),
+    extra: null,
+    build: null,
+    raw
+  };
+}
+function formatNodeVersion(v) {
+  return `${v.major}.${v.minor}.${v.patch ?? 0}`;
+}
+function parseNodeDirName(dir) {
+  const m = new RegExp(`^(${NODE_VENDOR_IDS.join("|")})-(.+)$`).exec(dir);
+  if (!m || !m[1] || !m[2]) return null;
+  try {
+    return parseNodeVersion(m[1], m[2]);
+  } catch {
+    return null;
+  }
+}
+function parseNodeUserSpec(input) {
+  let s = input.trim().toLowerCase();
+  let vendor;
+  const m = /^(nodejs|node)-(.+)$/.exec(s);
+  if (m && m[2]) {
+    vendor = "nodejs";
+    s = m[2];
+  }
+  if (s === "latest") return { vendor, spec: { kind: "latest" } };
+  if (s === "lts" || s === "--lts") return { vendor, spec: { kind: "lts" } };
+  if (/^\d+\.\d+\.\d+$/.test(s)) return { vendor, spec: { kind: "full", version: s } };
+  if (/^\d+$/.test(s)) return { vendor, spec: { kind: "major", major: Number(s) } };
+  if (/^\d+\.\d+$/.test(s)) {
+    throw new SdkvmError(`Invalid Node.js version: "${input}"`, {
+      hint: 'Node lines are major-only \u2014 use "22" or a full version like "22.20.0"'
+    });
+  }
+  throw new SdkvmError(`Invalid Node.js version: "${input}"`, {
+    hint: "Expected: 22, 22.20.0, lts, latest, or with vendor prefix like nodejs-22.20.0"
+  });
+}
+
+// src/core/lock.ts
+import fs4 from "fs";
 
 // src/core/paths.ts
 import fs3 from "fs";
@@ -384,8 +438,8 @@ async function httpText(url) {
 
 // src/vendor/temurin.ts
 var API = "https://api.adoptium.net";
-async function resolveLatestRedirect(major, os6, arch) {
-  const url = `${API}/v3/binary/latest/${major}/ga/${os6}/${arch}/jdk/hotspot/normal/eclipse`;
+async function resolveLatestRedirect(major, os5, arch) {
+  const url = `${API}/v3/binary/latest/${major}/ga/${os5}/${arch}/jdk/hotspot/normal/eclipse`;
   const res = await httpFetch(url, { redirect: "manual" });
   if (res.status !== 302 && res.status !== 307 && res.status !== 308) {
     throw new SdkvmError(`Adoptium API returned ${res.status} for JDK ${major}`);
@@ -399,12 +453,12 @@ function versionFromGithubUrl(url) {
   if (!m || !m[1]) throw new SdkvmError(`Cannot parse version from Adoptium URL: ${url}`);
   return decodeURIComponent(m[1]);
 }
-function githubAssetUrl(version, os6, arch) {
+function githubAssetUrl(version, os5, arch) {
   const v = parseVersion("temurin", version);
   const major = v.major;
-  const ext = os6 === "windows" ? "zip" : "tar.gz";
+  const ext = os5 === "windows" ? "zip" : "tar.gz";
   const underscored = formatVersion(v).replace("+", "_");
-  const file = `OpenJDK${major}U-jdk_${arch}_${os6}_hotspot_${underscored}.${ext}`;
+  const file = `OpenJDK${major}U-jdk_${arch}_${os5}_hotspot_${underscored}.${ext}`;
   return `https://github.com/adoptium/temurin${major}-binaries/releases/download/jdk-${encodeURIComponent(version)}/${file}`;
 }
 async function fetchAvailable() {
@@ -457,6 +511,12 @@ var temurinVendor = {
   }
 };
 
+// src/cli/cmdname.ts
+var CLI_BIN = "sdkvm";
+function cmdPath(type) {
+  return type === "java" ? CLI_BIN : `${CLI_BIN} ${type}`;
+}
+
 // src/vendor/zulu.ts
 var API2 = "https://api.azul.com/metadata/v1";
 function azulParams(platform) {
@@ -465,13 +525,20 @@ function azulParams(platform) {
     arch: platform.arch === "aarch64" ? "arm" : "x64"
   };
 }
+function zuluVersionMatches(javaVersion, wanted) {
+  if (!wanted) return true;
+  const actual = javaVersion.join(".");
+  if (actual === wanted) return true;
+  if (/^\d+$/.test(wanted)) return javaVersion[0] === Number(wanted);
+  return actual.startsWith(`${wanted}.`);
+}
 function pickPlainJdk(packages, platform, versionPrefix) {
   const ext = platform.os === "windows" ? ".zip" : ".tar.gz";
   const wanted = versionPrefix ?? "";
   const candidates = packages.filter((p) => {
     if (!/^zulu[\d.]+-ca-jdk[\d.]*-/i.test(p.name)) return false;
     if (!p.name.endsWith(ext)) return false;
-    if (wanted && !p.java_version.join(".").startsWith(wanted)) return false;
+    if (wanted && !zuluVersionMatches(p.java_version, wanted)) return false;
     return true;
   });
   candidates.sort((a, b) => {
@@ -483,8 +550,8 @@ function pickPlainJdk(packages, platform, versionPrefix) {
   return candidates[candidates.length - 1] ?? null;
 }
 async function queryPackages(javaVersion, platform) {
-  const { os: os6, arch } = azulParams(platform);
-  const url = `${API2}/zulu/packages/?java_version=${javaVersion}&os=${os6}&arch=${arch}&hw_bitness=64&release_status=ga&page_size=50`;
+  const { os: os5, arch } = azulParams(platform);
+  const url = `${API2}/zulu/packages/?java_version=${javaVersion}&os=${os5}&arch=${arch}&hw_bitness=64&release_status=ga&page_size=50`;
   const data = await httpJson(url);
   return Array.isArray(data) ? data : [];
 }
@@ -495,14 +562,12 @@ var zuluVendor = {
   supportsFullVersionList: true,
   async listMajors() {
     const universe = await temurinVendor.listMajors();
+    const platform = detectPlatform();
     const results = await Promise.all(
       universe.map(async ({ key }) => {
         try {
-          const packages = await queryPackages(key, {
-            os: "mac",
-            arch: "aarch64"
-          });
-          const pick = pickPlainJdk(packages, { os: "mac", arch: "aarch64" });
+          const packages = await queryPackages(key, platform);
+          const pick = pickPlainJdk(packages, platform);
           if (!pick) return null;
           return { key, lts: LTS_MAJORS.has(Number(key)), latestFullVersion: pick.java_version.join(".") };
         } catch {
@@ -530,7 +595,7 @@ var zuluVendor = {
     const pick = pickPlainJdk(packages, platform, versionPrefix);
     if (!pick) {
       throw new SdkvmError(`No Zulu JDK build matches "${versionPrefix}"`, {
-        hint: "Run `jvm ls -r` to see available versions."
+        hint: `Run \`${cmdPath("java")} ls -r\` to see available versions.`
       });
     }
     const versionStr = pick.java_version.join(".");
@@ -619,12 +684,6 @@ var correttoVendor = {
   }
 };
 
-// src/cli/cmdname.ts
-var CLI_BIN = "sdkvm";
-function cmdPath(type) {
-  return type === "java" ? CLI_BIN : `${CLI_BIN} ${type}`;
-}
-
 // src/vendor/golang.ts
 var LIST_URL = "https://go.dev/dl/?mode=json&include=all";
 var GO_OS = { mac: "darwin", linux: "linux", windows: "windows" };
@@ -791,14 +850,102 @@ var flutterVendor = {
   }
 };
 
+// src/vendor/nodejs.ts
+var DIST = "https://nodejs.org/dist";
+function tryParseEntry(e) {
+  try {
+    return parseNodeVersion("nodejs", e.version);
+  } catch {
+    return null;
+  }
+}
+async function fetchIndex() {
+  const entries = await httpJson(`${DIST}/index.json`);
+  return entries.map((e) => ({ e, v: tryParseEntry(e) })).filter((x) => x.v !== null).sort((a, b) => compareVersions(b.v, a.v)).map((x) => x.e);
+}
+async function fetchShasums(version) {
+  const text = await httpText(`${DIST}/${version}/SHASUMS256.txt`);
+  const sums = /* @__PURE__ */ new Map();
+  for (const line of text.split("\n")) {
+    const m = /^([0-9a-f]{64})\s+(\S+)$/.exec(line.trim());
+    if (m && m[1] && m[2]) sums.set(m[2], m[1]);
+  }
+  return sums;
+}
+var nodejsVendor = {
+  id: "nodejs",
+  label: "Node.js",
+  sdk: "node",
+  supportsFullVersionList: true,
+  async listMajors() {
+    const entries = await fetchIndex();
+    const lines = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const e of entries) {
+      const v = tryParseEntry(e);
+      if (!v || seen.has(v.major)) continue;
+      seen.add(v.major);
+      lines.push({ key: String(v.major), lts: e.lts !== false, latestFullVersion: formatNodeVersion(v) });
+    }
+    return lines;
+  },
+  async resolve(spec, platform) {
+    const entries = await fetchIndex();
+    let entry;
+    if (spec.kind === "latest") {
+      entry = entries[0];
+    } else if (spec.kind === "lts") {
+      entry = entries.find((e) => e.lts !== false);
+    } else if (spec.kind === "major") {
+      entry = entries.find((e) => tryParseEntry(e)?.major === spec.major);
+    } else if (spec.kind === "full") {
+      entry = entries.find((e) => {
+        const v = tryParseEntry(e);
+        return v !== null && formatNodeVersion(v) === spec.version.replace(/^v/, "");
+      });
+    }
+    if (!entry) {
+      const what = spec.kind === "full" ? spec.version : spec.kind === "major" ? String(spec.major) : spec.kind;
+      throw new SdkvmError(`No Node.js release matches "${what}"`, {
+        hint: "Run `sdkvm node ls -r` to list available major lines"
+      });
+    }
+    const version = parseNodeVersion("nodejs", entry.version);
+    const sums = await fetchShasums(entry.version);
+    const plat = platform.os === "mac" ? "darwin" : platform.os === "linux" ? "linux" : "win";
+    const arch = platform.arch === "aarch64" ? "arm64" : "x64";
+    const base = `node-${entry.version}-${plat}-${arch}`;
+    const candidates = platform.os === "windows" ? [`${base}.zip`] : [`${base}.tar.xz`, `${base}.tar.gz`];
+    const filename = candidates.find((f) => sums.has(f));
+    if (!filename) {
+      throw new SdkvmError(`No Node.js ${formatNodeVersion(version)} archive for ${platform.os}/${platform.arch}`, {
+        hint: "Run `sdkvm node ls -r` and pick a line that ships this platform (arm64 needs newer lines)"
+      });
+    }
+    const archive = filename.endsWith(".zip") ? "zip" : filename.endsWith(".tar.xz") ? "tar.xz" : "tar.gz";
+    const display = formatNodeVersion(version);
+    return {
+      vendorId: "nodejs",
+      version,
+      dirName: `nodejs-${display}`,
+      displayName: `Node.js ${display}`,
+      downloadUrl: `${DIST}/${entry.version}/${filename}`,
+      checksum: { kind: "sha256", expected: sums.get(filename) },
+      archive
+    };
+  }
+};
+
 // src/vendor/index.ts
 var JAVA_VENDORS = [temurinVendor, zuluVendor, correttoVendor];
 var GO_VENDORS = [golangVendor];
 var FLUTTER_VENDORS = [flutterVendor];
+var NODE_VENDORS = [nodejsVendor];
 function vendorsFor(type) {
   if (type === "java") return JAVA_VENDORS;
   if (type === "go") return GO_VENDORS;
   if (type === "flutter") return FLUTTER_VENDORS;
+  if (type === "node") return NODE_VENDORS;
   throw new SdkvmError(`Unknown SDK type: ${type}`);
 }
 function allVendorIds(type) {
@@ -833,6 +980,7 @@ var javaSdk = {
   currentLinkName: "current-java",
   envVar: "JAVA_HOME",
   supportsLts: true,
+  isLtsMajor: (major) => LTS_MAJORS.has(major),
   vendors: JAVA_VENDORS,
   parseUserSpec,
   parseDirName,
@@ -841,6 +989,9 @@ var javaSdk = {
   binRelPath(platform) {
     return `bin/${platform.os === "windows" ? "java.exe" : "java"}`;
   },
+  envBinSuffix(platform) {
+    return platform.os === "windows" ? "\\bin" : "/bin";
+  },
   locateHome(root) {
     const contentsHome = path2.join(root, "Contents", "Home");
     return fs2.existsSync(path2.join(contentsHome, "bin")) ? contentsHome : root;
@@ -854,7 +1005,7 @@ var goSdk = {
   label: "Go",
   installDirName: "gos",
   currentLinkName: "current-go",
-  envVar: "GOROOT",
+  envVar: "GO_HOME",
   supportsLts: false,
   vendors: GO_VENDORS,
   parseUserSpec: parseGoUserSpec,
@@ -864,6 +1015,9 @@ var goSdk = {
   binRelPath(platform) {
     return `bin/${platform.os === "windows" ? "go.exe" : "go"}`;
   },
+  envBinSuffix(platform) {
+    return platform.os === "windows" ? "\\bin" : "/bin";
+  },
   // go 归档是单根 go/ 目录，无 macOS bundle 概念
   locateHome: (root) => root,
   versionCheck: { args: ["version"], stream: "stdout" }
@@ -875,7 +1029,7 @@ var flutterSdk = {
   label: "Flutter",
   installDirName: "flutters",
   currentLinkName: "current-flutter",
-  envVar: "FLUTTER_ROOT",
+  envVar: "FLUTTER_HOME",
   supportsLts: false,
   vendors: FLUTTER_VENDORS,
   parseUserSpec: parseFlutterUserSpec,
@@ -885,18 +1039,48 @@ var flutterSdk = {
   binRelPath(platform) {
     return `bin/${platform.os === "windows" ? "flutter.bat" : "flutter"}`;
   },
+  envBinSuffix(platform) {
+    return platform.os === "windows" ? "\\bin" : "/bin";
+  },
   // flutter 归档是单根 flutter/ 目录，无 macOS bundle 概念
   locateHome: (root) => root,
   versionCheck: { args: ["--version"], stream: "stdout" }
 };
 
+// src/sdk/node.ts
+var nodeSdk = {
+  id: "node",
+  label: "Node.js",
+  installDirName: "nodes",
+  currentLinkName: "current-node",
+  envVar: "NODE_HOME",
+  supportsLts: true,
+  // Node.js LTS 发布线为偶数年 major（18 / 20 / 22 / 24 …）
+  isLtsMajor: (major) => major >= 4 && major % 2 === 0,
+  vendors: NODE_VENDORS,
+  parseUserSpec: parseNodeUserSpec,
+  parseDirName: parseNodeDirName,
+  formatVersion: formatNodeVersion,
+  compareVersions,
+  binRelPath(platform) {
+    return platform.os === "windows" ? "node.exe" : "bin/node";
+  },
+  envBinSuffix(platform) {
+    return platform.os === "windows" ? "" : "/bin";
+  },
+  // node 归档是单根 node-v{ver}-{plat}-{arch}/ 目录
+  locateHome: (root) => root,
+  versionCheck: { args: ["--version"], stream: "stdout" }
+};
+
 // src/sdk/index.ts
 var SPECS = {
   java: javaSdk,
   go: goSdk,
-  flutter: flutterSdk
+  flutter: flutterSdk,
+  node: nodeSdk
 };
-var SDK_TYPES = ["java", "go", "flutter"];
+var SDK_TYPES = ["java", "go", "flutter", "node"];
 function getSdkType(id) {
   const spec = SPECS[id];
   if (!spec) throw new SdkvmError(`Unknown SDK type: ${id}`);
@@ -905,7 +1089,7 @@ function getSdkType(id) {
 
 // src/core/paths.ts
 function sdkvmHome() {
-  return envOverride("SDKVM_HOME", "JVM_HOME") ?? path3.join(os.homedir(), ".sdkvm");
+  return envGet("SDKVM_HOME") ?? path3.join(os.homedir(), ".sdkvm");
 }
 var paths = {
   root: sdkvmHome,
@@ -925,116 +1109,192 @@ function ensureLayout() {
   }
 }
 
+// src/core/lock.ts
+var STALE_MS = 5 * 60 * 1e3;
+var HEARTBEAT_MS = 60 * 1e3;
+function lockInfoPath() {
+  return `${paths.lock()}/info.json`;
+}
+function readLockPid() {
+  try {
+    const raw = fs4.readFileSync(lockInfoPath(), "utf8");
+    const parsed = JSON.parse(raw);
+    return typeof parsed.pid === "number" ? parsed.pid : null;
+  } catch {
+    return null;
+  }
+}
+function isProcessAlive(pid) {
+  if (pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function writeLockInfo(startedAt) {
+  fs4.writeFileSync(
+    lockInfoPath(),
+    JSON.stringify({ pid: process.pid, startedAt, heartbeatAt: Date.now() })
+  );
+}
+function touchLock() {
+  const lockDir = paths.lock();
+  if (!fs4.existsSync(lockDir)) return;
+  const now = /* @__PURE__ */ new Date();
+  try {
+    fs4.utimesSync(lockDir, now, now);
+  } catch {
+  }
+  try {
+    const pid = readLockPid() ?? process.pid;
+    let startedAt = Date.now();
+    try {
+      const raw = JSON.parse(fs4.readFileSync(lockInfoPath(), "utf8"));
+      if (typeof raw.startedAt === "number") startedAt = raw.startedAt;
+    } catch {
+    }
+    if (pid === process.pid) writeLockInfo(startedAt);
+  } catch {
+  }
+}
+function acquireLock() {
+  const lockDir = paths.lock();
+  fs4.mkdirSync(paths.root(), { recursive: true });
+  try {
+    fs4.mkdirSync(lockDir);
+    writeLockInfo(Date.now());
+  } catch (err) {
+    const e = err;
+    if (e.code === "EEXIST") {
+      const holder = readLockPid();
+      if (holder != null && !isProcessAlive(holder)) {
+        fs4.rmSync(lockDir, { recursive: true, force: true });
+        return acquireLock();
+      }
+      const stat = fs4.statSync(lockDir);
+      if (Date.now() - stat.mtimeMs > STALE_MS) {
+        fs4.rmSync(lockDir, { recursive: true, force: true });
+        return acquireLock();
+      }
+      throw new SdkvmError("Another sdkvm operation is in progress", {
+        hint: "If this is wrong, remove ~/.sdkvm/.lock manually."
+      });
+    }
+    throw e;
+  }
+}
+function releaseLock() {
+  fs4.rmSync(paths.lock(), { recursive: true, force: true });
+}
+async function withLock(fn) {
+  acquireLock();
+  const timer = setInterval(() => touchLock(), HEARTBEAT_MS);
+  timer.unref?.();
+  try {
+    return await fn();
+  } finally {
+    clearInterval(timer);
+    releaseLock();
+  }
+}
+
 // src/core/config.ts
 var DEFAULT_CONFIG = {
   version: 1,
   defaultVendor: "temurin",
-  mirror: {}
+  mirror: {},
+  npmRegistries: {}
 };
 function loadConfig() {
   const file = paths.config();
-  if (!fs4.existsSync(file)) return { ...DEFAULT_CONFIG, mirror: {} };
+  if (!fs5.existsSync(file)) return { ...DEFAULT_CONFIG, mirror: {}, npmRegistries: {} };
   try {
-    const parsed = JSON.parse(fs4.readFileSync(file, "utf8"));
+    const parsed = JSON.parse(fs5.readFileSync(file, "utf8"));
     const config = {
       version: 1,
       defaultVendor: parsed.defaultVendor && JAVA_VENDOR_IDS.includes(parsed.defaultVendor) ? parsed.defaultVendor : "temurin",
-      mirror: {}
+      mirror: {},
+      npmRegistries: {}
     };
     if (parsed.mirror && typeof parsed.mirror === "object") {
       for (const [id, v] of Object.entries(parsed.mirror)) {
         if (typeof v === "string" && v.length > 0) config.mirror[id] = v;
       }
     }
+    if (parsed.npmRegistries && typeof parsed.npmRegistries === "object") {
+      for (const [id, v] of Object.entries(parsed.npmRegistries)) {
+        if (typeof v === "string" && v.length > 0) config.npmRegistries[id] = v;
+      }
+    }
     return config;
   } catch (err) {
     const bak = `${file}.bak`;
     try {
-      fs4.renameSync(file, bak);
+      fs5.renameSync(file, bak);
       log.warn(`config.json was corrupted; backed up to ${bak}, using defaults`);
     } catch {
     }
     void err;
-    return { ...DEFAULT_CONFIG, mirror: {} };
+    return { ...DEFAULT_CONFIG, mirror: {}, npmRegistries: {} };
   }
 }
 function saveConfig(config) {
   ensureLayout();
   const file = paths.config();
   const tmp = path4.join(path4.dirname(file), `.config.json.tmp-${process.pid}`);
-  fs4.writeFileSync(tmp, `${JSON.stringify(config, null, 2)}
+  fs5.writeFileSync(tmp, `${JSON.stringify(config, null, 2)}
 `);
-  fs4.renameSync(tmp, file);
-}
-
-// src/core/lock.ts
-import fs5 from "fs";
-var STALE_MS = 5 * 60 * 1e3;
-function acquireLock() {
-  const lockDir = paths.lock();
-  fs5.mkdirSync(paths.root(), { recursive: true });
-  try {
-    fs5.mkdirSync(lockDir);
-    fs5.writeFileSync(
-      `${lockDir}/info.json`,
-      JSON.stringify({ pid: process.pid, startedAt: Date.now() })
-    );
-  } catch (err) {
-    const e = err;
-    if (e.code === "EEXIST") {
-      const stat = fs5.statSync(lockDir);
-      if (Date.now() - stat.mtimeMs > STALE_MS) {
-        fs5.rmSync(lockDir, { recursive: true, force: true });
-        return acquireLock();
-      }
-      throw new SdkvmError("Another sdkvm operation is in progress", {
-        hint: "If this is wrong, remove ~/.sdkvm/.lock manually."
-      });
-    }
-    throw e;
-  }
-}
-function releaseLock() {
-  fs5.rmSync(paths.lock(), { recursive: true, force: true });
+  fs5.renameSync(tmp, file);
 }
-async function withLock(fn) {
+function updateConfig(mutator) {
   acquireLock();
   try {
-    return await fn();
+    const config = loadConfig();
+    mutator(config);
+    saveConfig(config);
+    return config;
   } finally {
     releaseLock();
   }
 }
 
 // src/vendor/mirror.ts
-function applyMirror(artifact, platform, mirrorRoot) {
-  if (!mirrorRoot) return artifact;
+var MIRROR_REWRITE_VENDORS = /* @__PURE__ */ new Set(["temurin", "golang", "flutter", "nodejs"]);
+function applyMirrorDetail(artifact, platform, mirrorRoot) {
+  if (!mirrorRoot?.trim()) return { artifact, applied: false };
+  const root = mirrorRoot.trim().replace(/\/+$/, "");
   if (artifact.vendorId === "golang") {
-    const root2 = mirrorRoot.replace(/\/+$/, "");
     const file = artifact.downloadUrl.split("/").pop();
-    if (!file) return artifact;
-    return { ...artifact, downloadUrl: `${root2}/${file}` };
+    if (!file) return { artifact, applied: false };
+    return { artifact: { ...artifact, downloadUrl: `${root}/${file}` }, applied: true };
   }
   if (artifact.vendorId === "flutter") {
-    const root2 = mirrorRoot.replace(/\/+$/, "");
     const url2 = artifact.downloadUrl.replace(
       /^https:\/\/storage\.googleapis\.com\/flutter_infra_release/,
-      root2
+      root
     );
-    return { ...artifact, downloadUrl: url2 };
+    if (url2 === artifact.downloadUrl) return { artifact, applied: false };
+    return { artifact: { ...artifact, downloadUrl: url2 }, applied: true };
+  }
+  if (artifact.vendorId === "nodejs") {
+    const url2 = artifact.downloadUrl.replace(/^https:\/\/nodejs\.org\/dist/, root);
+    if (url2 === artifact.downloadUrl) return { artifact, applied: false };
+    return { artifact: { ...artifact, downloadUrl: url2 }, applied: true };
   }
-  if (artifact.vendorId !== "temurin") return artifact;
+  if (artifact.vendorId !== "temurin") return { artifact, applied: false };
   const m = /^https:\/\/github\.com\/adoptium\/temurin(\d+)-binaries\/releases\/download\/[^/]+\/(.+)$/.exec(
     artifact.downloadUrl
   );
-  if (!m || !m[1] || !m[2]) return artifact;
-  const root = mirrorRoot.replace(/\/+$/, "");
+  if (!m || !m[1] || !m[2]) return { artifact, applied: false };
   const url = `${root}/${m[1]}/jdk/${platform.arch}/${platform.os}/${m[2]}`;
-  return { ...artifact, downloadUrl: url };
+  return { artifact: { ...artifact, downloadUrl: url }, applied: true };
 }
 
 // src/net/download.ts
 import crypto from "crypto";
+import { once } from "events";
 import fs6 from "fs";
 import path5 from "path";
 var IDLE_TIMEOUT_MS = 6e4;
@@ -1044,6 +1304,7 @@ async function downloadFile(url, destFile, onProgress) {
   const out = fs6.createWriteStream(partFile);
   let bytes = 0;
   let total = null;
+  let encoded2 = false;
   let stalled = false;
   const ac = new AbortController();
   const timer = setTimeout(() => {
@@ -1051,13 +1312,17 @@ async function downloadFile(url, destFile, onProgress) {
     ac.abort();
   }, IDLE_TIMEOUT_MS);
   try {
-    const res = await httpFetch(url, { signal: ac.signal });
+    const res = await httpFetch(url, {
+      signal: ac.signal,
+      headers: { "accept-encoding": "identity" }
+    });
     timer.refresh();
     total = Number(res.headers.get("content-length")) || null;
+    encoded2 = Boolean(res.headers.get("content-encoding"));
     if (!res.body) throw new SdkvmError(`Empty response body: ${url}`);
     for await (const chunk of res.body) {
       timer.refresh();
-      out.write(chunk);
+      if (!out.write(chunk)) await once(out, "drain");
       hash.update(chunk);
       bytes += chunk.byteLength;
       onProgress?.(bytes, total);
@@ -1084,7 +1349,7 @@ async function downloadFile(url, destFile, onProgress) {
     fs6.rmSync(partFile, { force: true });
     throw new SdkvmError(`Download incomplete: 0 bytes`, { hint: url });
   }
-  if (total !== null && bytes !== total) {
+  if (total !== null && !encoded2 && bytes !== total) {
     fs6.rmSync(partFile, { force: true });
     throw new SdkvmError(`Download incomplete: ${bytes}/${total} bytes`, { hint: url });
   }
@@ -1111,9 +1376,15 @@ function extractExpectedChecksum(text) {
   const token = trimmed.split(/\s+/)[0] ?? "";
   return HEX64.test(token) ? token.toLowerCase() : null;
 }
-async function verifyChecksum(artifact, actual) {
+async function verifyChecksum(artifact, actual, opts = {}) {
+  const strict = opts.strict === true;
   const info = artifact.checksum;
   if (!info) {
+    if (strict) {
+      throw new SdkvmError(`No checksum source for ${artifact.displayName}`, {
+        hint: "Mirrored downloads require a verifiable checksum; unset the mirror or use the official source."
+      });
+    }
     log.warn(`no checksum source for ${artifact.displayName}, skipping verification`);
     return;
   }
@@ -1121,12 +1392,23 @@ async function verifyChecksum(artifact, actual) {
   if (!expected && info.url) {
     try {
       expected = extractExpectedChecksum(await httpText(info.url));
-    } catch {
+    } catch (err) {
+      if (strict) {
+        const detail = err instanceof Error ? err.message.split("\n")[0] : String(err);
+        throw new SdkvmError(`Cannot fetch checksum for ${artifact.displayName}`, {
+          hint: `${detail}. Mirrored installs need the official checksum URL to be reachable.`
+        });
+      }
       log.warn(`cannot fetch checksum for ${artifact.displayName}, skipping verification`);
       return;
     }
   }
   if (!expected) {
+    if (strict) {
+      throw new SdkvmError(`Checksum source has no valid hash for ${artifact.displayName}`, {
+        hint: "Mirrored downloads require a verifiable checksum."
+      });
+    }
     log.warn(`checksum source has no valid hash for ${artifact.displayName}, skipping`);
     return;
   }
@@ -1252,6 +1534,18 @@ function createProgress(label2) {
 }
 
 // src/cli/install.ts
+async function renameWithRetry(from, to, attempts = 3) {
+  for (let i = 1; ; i++) {
+    try {
+      fs9.renameSync(from, to);
+      return;
+    } catch (err) {
+      if (i >= attempts) throw err;
+      log.warn(`rename blocked (attempt ${i}/${attempts}), retrying in 1s ...`);
+      await new Promise((r) => setTimeout(r, 1e3));
+    }
+  }
+}
 async function installCommand(type, specInput, opts) {
   const platform = detectPlatform();
   const config = loadConfig();
@@ -1260,20 +1554,31 @@ async function installCommand(type, specInput, opts) {
   const vendor = getVendor(type, vendorId);
   log.info(`resolving ${vendor.label} ${specInput} for ${platform.os}/${platform.arch} ...`);
   const resolved = await vendor.resolve(spec, platform);
-  const mirrorRoot = envOverride("SDKVM_MIRROR", "JVM_MIRROR") ?? config.mirror[vendorId] ?? null;
-  const artifact = applyMirror(resolved, platform, mirrorRoot);
-  const finalDir = path8.join(paths.sdks(type), artifact.dirName);
-  const hintVersion = type === "java" ? String(artifact.version.major) : `${artifact.version.major}.${artifact.version.minor}`;
-  if (fs9.existsSync(finalDir)) {
-    if (!opts.force) {
-      log.warn(`${artifact.displayName} is already installed`);
-      log.info(`run: ${cmdPath(type)} use ${hintVersion}`);
-      return;
+  const mirrorRoot = envGet("SDKVM_MIRROR") ?? config.mirror[vendorId] ?? null;
+  const { artifact, applied } = applyMirrorDetail(resolved, platform, mirrorRoot);
+  if (mirrorRoot?.trim() && !applied) {
+    if (!MIRROR_REWRITE_VENDORS.has(vendorId)) {
+      log.warn(
+        `mirror is set but ${vendorId} downloads are not mirrored; using the official URL`
+      );
+    } else {
+      log.warn(
+        `mirror root did not rewrite the download URL for ${vendorId}; using the official source`
+      );
     }
-    log.warn(`--force: removing existing ${artifact.dirName}`);
   }
+  const finalDir = path8.join(paths.sdks(type), artifact.dirName);
+  const hintVersion = type === "java" || type === "node" ? String(artifact.version.major) : `${artifact.version.major}.${artifact.version.minor}`;
   await withLock(async () => {
     ensureLayout();
+    if (fs9.existsSync(finalDir)) {
+      if (!opts.force) {
+        log.warn(`${artifact.displayName} is already installed`);
+        log.info(`run: ${cmdPath(type)} use ${hintVersion}`);
+        return;
+      }
+      log.warn(`--force: removing existing ${artifact.dirName}`);
+    }
     for (const f of fs9.readdirSync(paths.cache())) {
       if (f.endsWith(".part")) fs9.rmSync(path8.join(paths.cache(), f), { force: true });
     }
@@ -1282,28 +1587,41 @@ async function installCommand(type, specInput, opts) {
     log.info(`downloading ${artifact.downloadUrl}`);
     const dl = await downloadFile(artifact.downloadUrl, dest, (b, t) => progress.update(b, t));
     progress.done(dl.bytes, null);
-    await verifyChecksum(artifact, dl.sha256);
+    await verifyChecksum(artifact, dl.sha256, { strict: applied });
     const tmp = tmpExtractDir(paths.tmp());
+    const bak = `${finalDir}.bak`;
     let finalTmp = tmp;
     try {
       log.info("extracting ...");
       await extractArchive(dest, artifact.archive, tmp, platform);
       const normalized = normalizeExtracted(tmp, platform, type);
       finalTmp = normalized.root;
-      if (fs9.existsSync(finalDir)) fs9.rmSync(finalDir, { recursive: true, force: true });
-      fs9.renameSync(normalized.root, finalDir);
+      fs9.rmSync(bak, { recursive: true, force: true });
+      if (fs9.existsSync(finalDir)) fs9.renameSync(finalDir, bak);
+      try {
+        await renameWithRetry(normalized.root, finalDir);
+      } catch (err) {
+        if (fs9.existsSync(bak) && !fs9.existsSync(finalDir)) {
+          try {
+            fs9.renameSync(bak, finalDir);
+          } catch {
+          }
+        }
+        throw err;
+      }
+      fs9.rmSync(bak, { recursive: true, force: true });
     } catch (err) {
       fs9.rmSync(finalTmp, { recursive: true, force: true });
       fs9.rmSync(tmp, { recursive: true, force: true });
-      throw err instanceof SdkvmError ? err : err;
+      throw err;
     } finally {
       fs9.rmSync(dest, { force: true });
       fs9.rmSync(paths.tmp(), { recursive: true, force: true });
       fs9.mkdirSync(paths.tmp(), { recursive: true });
     }
+    log.ok(`installed ${artifact.displayName} \u2192 ${finalDir}`);
+    log.info(`switch to it: ${cmdPath(type)} use ${hintVersion}`);
   });
-  log.ok(`installed ${artifact.displayName} \u2192 ${finalDir}`);
-  log.info(`switch to it: ${cmdPath(type)} use ${hintVersion}`);
 }
 
 // src/cli/use.ts
@@ -1391,12 +1709,13 @@ function findInstalled(type, specInput, vendorArg) {
       (j) => j.version.major === parsed.major && j.version.minor === parsed.minor
     );
   } else if (parsed.kind === "lts") {
-    if (!spec.supportsLts) {
-      throw new SdkvmError("Go has no LTS releases", {
+    const isLtsMajor = spec.isLtsMajor;
+    if (!spec.supportsLts || !isLtsMajor) {
+      throw new SdkvmError(`${spec.label} has no LTS releases`, {
         hint: `Try: ${cmdPath(type)} install latest`
       });
     }
-    matched = candidates.filter((j) => LTS_MAJORS.has(j.version.major));
+    matched = candidates.filter((j) => isLtsMajor(j.version.major));
   } else if (parsed.kind === "latest") {
     matched = candidates;
   } else {
@@ -1438,8 +1757,6 @@ function detectRcFile(platform) {
 import fs12 from "fs";
 import os3 from "os";
 import path12 from "path";
-var LEGACY_RC_BEGIN = "# >>> jvm init >>>";
-var LEGACY_RC_END = "# <<< jvm init <<<";
 function rcBegin(type) {
   return `# >>> ${CLI_BIN} ${type} init >>>`;
 }
@@ -1448,28 +1765,27 @@ function rcEnd(type) {
 }
 function rcBlock(type) {
   const spec = getSdkType(type);
+  const binSuffix = spec.envBinSuffix(detectPlatform()).replace(/\\/g, "/");
   const abs = paths.current(type);
   const rel = path12.relative(os3.homedir(), abs);
-  const link = rel.startsWith("..") ? abs : `$HOME/${rel}`;
+  const toPosix = (p) => p.split(path12.sep).join("/");
+  const link = rel.startsWith("..") || path12.isAbsolute(rel) ? toPosix(abs) : `$HOME/${toPosix(rel)}`;
   return [
     rcBegin(type),
     `export ${spec.envVar}="${link}"`,
-    `case ":$PATH:" in *":$${spec.envVar}/bin:"*) ;; *) export PATH="$${spec.envVar}/bin:$PATH";; esac`,
+    `case ":$PATH:" in *":$${spec.envVar}${binSuffix}:"*) ;; *) export PATH="$${spec.envVar}${binSuffix}:$PATH";; esac`,
     rcEnd(type)
   ].join("\n");
 }
 function stripRcBlock(content, type) {
   return stripBlockBetween(content, rcBegin(type), rcEnd(type));
 }
-function stripLegacyRcBlock(content) {
-  return stripBlockBetween(content, LEGACY_RC_BEGIN, LEGACY_RC_END);
-}
 function stripBlockBetween(content, begin, end) {
   const re = new RegExp(`\\n*${escapeRegex(begin)}[\\s\\S]*?${escapeRegex(end)}\\n*`, "g");
   return content.replace(re, "\n");
 }
 function upsertRcContent(content, type) {
-  const stripped = stripLegacyRcBlock(stripRcBlock(content, type)).replace(/\s+$/, "");
+  const stripped = stripRcBlock(content, type).replace(/\s+$/, "");
   return `${stripped}
 
 ${rcBlock(type)}
@@ -1490,11 +1806,30 @@ function encoded(ps) {
   return ["-NoProfile", "-NonInteractive", "-EncodedCommand", Buffer.from(ps, "utf16le").toString("base64")];
 }
 function currentLinkWin(type) {
-  const rel = path13.relative(os4.homedir(), paths.current(type));
+  const abs = paths.current(type);
+  const rel = path13.relative(os4.homedir(), abs);
+  if (rel.startsWith("..") || path13.isAbsolute(rel)) {
+    return abs;
+  }
   return `%USERPROFILE%\\${rel.split(path13.sep).join("\\")}`;
 }
+function broadcastPs() {
+  return [
+    `$sig='[DllImport("user32.dll", SetLastError=true, CharSet=CharSet.Auto)] public static extern IntPtr SendMessageTimeout(IntPtr hWnd, uint Msg, UIntPtr wParam, string lParam, uint fuFlags, uint uTimeout, out UIntPtr lpdwResult);'`,
+    "Add-Type -MemberDefinition $sig -Name NativeMethods -Namespace Win32",
+    "$r=[UIntPtr]::Zero",
+    "[Win32.NativeMethods]::SendMessageTimeout([IntPtr]0xffff, 0x1A, [UIntPtr]::Zero, 'Environment', 2, 5000, [ref]$r) | Out-Null"
+  ];
+}
 async function setEnvWin(name, value) {
-  await run("setx", [name, value]);
+  const escaped = value.replace(/'/g, "''");
+  const ps = [
+    "$k=[Microsoft.Win32.Registry]::CurrentUser.OpenSubKey('Environment',$true)",
+    "if(-not $k){ throw 'no Environment key' }",
+    `$k.SetValue('${name.replace(/'/g, "''")}', '${escaped}', [Microsoft.Win32.RegistryValueKind]::ExpandString)`,
+    ...broadcastPs()
+  ].join("\n");
+  await run("powershell.exe", encoded(ps));
 }
 async function setSdkEnvWin(type) {
   const spec = getSdkType(type);
@@ -1513,15 +1848,13 @@ async function ensureUserPathWin(entry) {
     "  if($k.GetValueKind('Path') -eq [Microsoft.Win32.RegistryValueKind]::String){ $kind=[Microsoft.Win32.RegistryValueKind]::String }",
     "  $k.SetValue('Path', ($parts -join ';'), $kind)",
     "}",
-    `$sig='[DllImport("user32.dll", SetLastError=true, CharSet=CharSet.Auto)] public static extern IntPtr SendMessageTimeout(IntPtr hWnd, uint Msg, UIntPtr wParam, string lParam, uint fuFlags, uint uTimeout, out UIntPtr lpdwResult);'`,
-    "Add-Type -MemberDefinition $sig -Name NativeMethods -Namespace Win32",
-    "$r=[UIntPtr]::Zero",
-    "[Win32.NativeMethods]::SendMessageTimeout([IntPtr]0xffff, 0x1A, [UIntPtr]::Zero, 'Environment', 2, 5000, [ref]$r) | Out-Null"
+    ...broadcastPs()
   ].join("\n");
   await run("powershell.exe", encoded(ps));
 }
 function sdkPathEntry(type) {
-  return `%${getSdkType(type).envVar}%\\bin`;
+  const spec = getSdkType(type);
+  return `%${spec.envVar}%${spec.envBinSuffix(detectPlatform())}`;
 }
 
 // src/cli/use.ts
@@ -1532,9 +1865,10 @@ async function showSdkVersion(binPath, type) {
     const { stdout, stderr } = await execFileAsync2(binPath, spec.versionCheck.args, {
       timeout: 3e4
     });
-    const text = spec.versionCheck.stream === "stdout" ? stdout : stderr;
-    const line = (text || "").split("\n").find((l) => l.includes("version"));
-    if (line) log.info(line.trim());
+    const text = (spec.versionCheck.stream === "stdout" ? stdout : stderr) || "";
+    const lines = text.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+    const line = lines.find((l) => /version/i.test(l)) ?? lines[0];
+    if (line) log.info(line);
   } catch {
   }
 }
@@ -1543,7 +1877,9 @@ async function useCommand(type, specInput, opts) {
   const spec = getSdkType(type);
   const installed = findInstalled(type, specInput, opts.vendor);
   const label2 = `${installed.version.vendor}-${spec.formatVersion(installed.version)}`;
-  setCurrent(type, installed.home, platform);
+  await withLock(async () => {
+    setCurrent(type, installed.home, platform);
+  });
   log.ok(`current \u2192 ${label2}`);
   if (platform.os === "windows") {
     await setSdkEnvWin(type);
@@ -1655,153 +1991,644 @@ async function uninstallCommand(type, specInput, opts) {
   log.ok(`removed ${installed.version.vendor}-${spec.formatVersion(installed.version)}`);
 }
 
-// src/cli/mirror.ts
-var RECOMMENDED = {
-  temurin: "https://mirrors.nju.edu.cn/adoptium",
-  golang: "https://golang.google.cn/dl",
-  flutter: "https://mirror.nju.edu.cn/flutter/flutter_infra_release"
+// src/cli/mirror-presets.ts
+var MIRRORABLE_BY_TYPE = {
+  java: ["temurin"],
+  go: ["golang"],
+  flutter: ["flutter"],
+  node: ["nodejs"]
 };
-function mirrorCommand(type, action, urlOrVendor, maybeUrl) {
-  const config = loadConfig();
-  const mirrorable = allVendorIds(type).filter((id) => id in RECOMMENDED);
-  const first = mirrorable[0] ?? allVendorIds(type)[0] ?? "";
+var MIRROR_SITE_PRESETS = [
+  {
+    name: "nju",
+    list: true,
+    vendors: {
+      temurin: "https://mirrors.nju.edu.cn/adoptium",
+      golang: "https://mirror.nju.edu.cn/golang",
+      flutter: "https://mirror.nju.edu.cn/flutter/flutter_infra_release",
+      nodejs: "https://mirror.nju.edu.cn/nodejs-release"
+    }
+  },
+  {
+    name: "tuna",
+    aliases: ["tsinghua"],
+    list: true,
+    vendors: {
+      temurin: "https://mirrors.tuna.tsinghua.edu.cn/Adoptium",
+      flutter: "https://mirrors.tuna.tsinghua.edu.cn/flutter/flutter_infra_release"
+    }
+  },
+  {
+    name: "aliyun",
+    aliases: ["ali"],
+    list: true,
+    vendors: {
+      golang: "https://mirrors.aliyun.com/golang",
+      nodejs: "https://mirrors.aliyun.com/nodejs-release"
+    }
+  },
+  {
+    name: "huawei",
+    list: true,
+    vendors: {
+      nodejs: "https://repo.huaweicloud.com/nodejs"
+    }
+  },
+  {
+    name: "official",
+    list: true,
+    vendors: {}
+  }
+];
+function normalizeMirrorUrl(url) {
+  const trimmed = url.trim().replace(/\/+$/, "");
+  try {
+    const u = new URL(trimmed);
+    const path16 = `${u.pathname}${u.search}${u.hash}`.replace(/\/+$/, "") || "";
+    return `${u.protocol.toLowerCase()}//${u.host.toLowerCase()}${path16}`;
+  } catch {
+    return trimmed;
+  }
+}
+function parseMirrorRootUrl(url) {
+  const trimmed = url.trim();
+  let parsed;
+  try {
+    parsed = new URL(trimmed);
+  } catch {
+    throw new Error(`invalid URL: ${url}`);
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new Error(`invalid URL protocol: ${parsed.protocol}`);
+  }
+  return trimmed.replace(/\/+$/, "");
+}
+function mirrorableVendors(type) {
+  return MIRRORABLE_BY_TYPE[type];
+}
+function siteVendorsForType(site, type) {
+  const out = {};
+  for (const id of mirrorableVendors(type)) {
+    const url = site.vendors[id];
+    if (url) out[id] = url.replace(/\/+$/, "");
+  }
+  return out;
+}
+function findMirrorSite(name) {
+  const key = name.trim().toLowerCase();
+  return MIRROR_SITE_PRESETS.find(
+    (s) => s.name.toLowerCase() === key || s.aliases?.some((a) => a.toLowerCase() === key)
+  );
+}
+function listMirrorSitesForType(type) {
+  return MIRROR_SITE_PRESETS.filter((s) => {
+    if (!s.list) return false;
+    if (s.name === "official") return true;
+    return Object.keys(siteVendorsForType(s, type)).length > 0;
+  });
+}
+function matchMirrorSiteName(type, mirror) {
+  const vendors = mirrorableVendors(type);
+  const allOfficial = vendors.every((id) => {
+    const v = mirror[id];
+    return v == null || v === "";
+  });
+  if (allOfficial) return "official";
+  for (const site of MIRROR_SITE_PRESETS) {
+    if (site.name === "official" || !site.list) continue;
+    const scoped = siteVendorsForType(site, type);
+    const ids = Object.keys(scoped);
+    if (ids.length === 0) continue;
+    const hit = ids.every((id) => {
+      const configured = mirror[id];
+      if (configured == null || configured === "") return false;
+      return normalizeMirrorUrl(configured) === normalizeMirrorUrl(scoped[id]);
+    });
+    if (hit) return site.name;
+  }
+  return null;
+}
+function formatMirrorListLine(name, detail, current) {
+  const mark = current ? "*" : " ";
+  const padded = `${name} `.padEnd(14, "-");
+  return `${mark} ${padded} ${detail}`;
+}
+function availableSiteNamesForType(type) {
+  return listMirrorSitesForType(type).map((s) => s.name);
+}
+
+// src/cli/mirror.ts
+function mirrorableIds(type) {
+  return [...mirrorableVendors(type)];
+}
+function firstMirrorable(type) {
+  return mirrorableVendors(type)[0] ?? "";
+}
+function mirrorCommand(type, action, arg1, arg2) {
+  const mirrorable = mirrorableIds(type);
+  const first = firstMirrorable(type);
+  const prefix = cmdPath(type);
+  if (action === "ls" || action === "list") {
+    const config2 = loadConfig();
+    const matched2 = matchMirrorSiteName(type, config2.mirror);
+    for (const site of listMirrorSitesForType(type)) {
+      let detail;
+      if (site.name === "official") {
+        detail = "(official source)";
+      } else {
+        const scoped = siteVendorsForType(site, type);
+        detail = Object.entries(scoped).map(([id, url]) => mirrorable.length === 1 ? url : `${id}=${url}`).join(" ");
+      }
+      log.raw(formatMirrorListLine(site.name, detail, matched2 === site.name));
+    }
+    if (matched2 == null) {
+      const parts = mirrorable.map((id) => {
+        const url = config2.mirror[id];
+        return url ? `${id}=${url}` : `${id}=(official)`;
+      });
+      log.raw(formatMirrorListLine("custom", parts.join(" "), true));
+    }
+    return;
+  }
+  if (action === "use") {
+    const name = arg1;
+    if (!name) {
+      throw new SdkvmError(`usage: ${prefix} mirror use <site>`, {
+        hint: `Available: ${availableSiteNamesForType(type).join(", ")}`
+      });
+    }
+    const site = findMirrorSite(name);
+    if (!site || site.name !== "official" && Object.keys(siteVendorsForType(site, type)).length === 0) {
+      throw new SdkvmError(`Unknown or unsupported mirror site "${name}" for ${type}`, {
+        hint: `Available: ${availableSiteNamesForType(type).join(", ")}`
+      });
+    }
+    if (site.name === "official") {
+      updateConfig((config2) => {
+        for (const id of mirrorable) {
+          delete config2.mirror[id];
+        }
+      });
+      log.ok(`mirror for ${type} \u2192 official`);
+      return;
+    }
+    const scoped = siteVendorsForType(site, type);
+    const changed = [];
+    updateConfig((config2) => {
+      for (const [id, url] of Object.entries(scoped)) {
+        config2.mirror[id] = url;
+        changed.push(`${id} \u2192 ${url}`);
+      }
+    });
+    log.ok(`mirror site ${site.name}: ${changed.join("; ")}`);
+    return;
+  }
+  if (action === "current") {
+    const config2 = loadConfig();
+    const matched2 = matchMirrorSiteName(type, config2.mirror);
+    if (matched2 === "official") {
+      log.raw(`official \u2192 (no mirror)`);
+      for (const id of allVendorIds(type)) {
+        log.raw(`  ${id.padEnd(8)} (official)`);
+      }
+      return;
+    }
+    if (matched2) {
+      const site = findMirrorSite(matched2);
+      const scoped = siteVendorsForType(site, type);
+      const firstUrl = Object.values(scoped)[0] ?? "";
+      log.raw(`${matched2} \u2192 ${firstUrl}`);
+    } else {
+      log.raw("custom \u2192");
+    }
+    for (const id of allVendorIds(type)) {
+      const url = config2.mirror[id];
+      log.raw(`  ${id.padEnd(8)} ${url ?? "(official)"}`);
+    }
+    return;
+  }
   if (action === "set") {
     let vendor;
     let url;
-    if (maybeUrl !== void 0) {
-      vendor = urlOrVendor ?? "";
-      url = maybeUrl;
+    if (arg2 !== void 0) {
+      vendor = arg1 ?? "";
+      url = arg2;
     } else {
       vendor = first;
-      url = urlOrVendor;
+      url = arg1;
+    }
+    if (!url) throw new SdkvmError(`usage: ${prefix} mirror set [vendor] <url>`);
+    const siteHit = findMirrorSite(url);
+    if (!url.includes("://") && siteHit) {
+      throw new SdkvmError(`"${url}" is a mirror site name, not a URL`, {
+        hint: `Use: ${prefix} mirror use ${siteHit.name}`
+      });
     }
-    if (!url) throw new SdkvmError(`usage: ${cmdPath(type)} mirror set [vendor] <url>`);
     if (!mirrorable.includes(vendor)) {
       throw new SdkvmError(`mirroring is only supported for ${mirrorable.join(", ") || "none"} (got "${vendor}")`, {
-        hint: `recommended: ${cmdPath(type)} mirror set ${first} ${RECOMMENDED[first] ?? ""}`.trim()
+        hint: first ? `recommended: ${prefix} mirror use nju  (or set URL: ${prefix} mirror set ${first} <url>)` : void 0
       });
     }
+    let normalized;
     try {
-      new URL(url);
-    } catch {
-      throw new SdkvmError(`invalid URL: ${url}`);
+      normalized = parseMirrorRootUrl(url);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      throw new SdkvmError(msg, {
+        hint: msg.includes("protocol") ? "Expected http:// or https://" : void 0
+      });
     }
-    config.mirror[vendor] = url.replace(/\/+$/, "");
-    saveConfig(config);
-    log.ok(`mirror for ${vendor} \u2192 ${config.mirror[vendor]}`);
+    updateConfig((config2) => {
+      config2.mirror[vendor] = normalized;
+    });
+    log.ok(`mirror for ${vendor} \u2192 ${normalized}`);
     return;
   }
   if (action === "unset") {
-    const vendor = urlOrVendor ?? first;
+    const vendor = arg1 ?? first;
+    if (vendor && findMirrorSite(vendor)?.name === "official") {
+      throw new SdkvmError(`To clear mirrors, use: ${prefix} mirror use official`, {
+        hint: `Or: ${prefix} mirror unset ${first || "<vendor>"}`
+      });
+    }
     if (!mirrorable.includes(vendor)) {
       throw new SdkvmError(`mirroring is only supported for ${mirrorable.join(", ") || "none"}`);
     }
-    config.mirror[vendor] = null;
-    saveConfig(config);
+    updateConfig((config2) => {
+      delete config2.mirror[vendor];
+    });
     log.ok(`mirror for ${vendor} cleared (official source)`);
     return;
   }
-  log.raw("mirrors:");
+  if (action !== void 0 && action !== "show") {
+    throw new SdkvmError(`unknown mirror action "${action}"`, {
+      hint: `usage: ${prefix} mirror ls|use|current|show|set|unset`
+    });
+  }
+  const config = loadConfig();
+  const matched = matchMirrorSiteName(type, config.mirror);
+  log.raw(`mirrors${matched ? ` (${matched})` : ""}:`);
   for (const id of allVendorIds(type)) {
     const url = config.mirror[id];
     log.raw(`  ${id.padEnd(8)} ${url ?? "(official)"}`);
   }
-  if (first in RECOMMENDED) {
-    log.raw(`recommended for CN users: ${cmdPath(type)} mirror set ${first} ${RECOMMENDED[first]}`);
+  if (first) {
+    log.raw(`list sites: ${prefix} mirror ls`);
+    log.raw(`use a site: ${prefix} mirror use nju`);
   }
 }
 
-// src/core/migrate.ts
+// src/cli/upgrade.ts
+import { spawn } from "child_process";
 import fs14 from "fs";
-import os5 from "os";
 import path15 from "path";
-async function migrateLegacyHomeIfNeeded(opts = {}) {
-  const oldHome = opts.oldHome ?? path15.join(os5.homedir(), ".jvm");
-  const newHome = opts.newHome ?? sdkvmHome();
-  if (opts.newHome === void 0 && envOverride("SDKVM_HOME", "JVM_HOME")) return "not-needed";
-  if (!fs14.existsSync(oldHome)) return "not-needed";
-  if (fs14.existsSync(newHome)) {
-    log.warn(`found both ${oldHome} and ${newHome}; keeping ${newHome}, not merging`);
-    log.warn(`move SDKs into ${newHome} manually if needed, then remove ${oldHome}`);
-    return "conflict";
-  }
-  const platform = opts.platform ?? detectPlatform();
-  const rc = opts.rcFile !== void 0 ? opts.rcFile : detectRcFile(platform.os);
-  const oldLock = path15.join(oldHome, ".lock");
-  if (fs14.existsSync(oldLock)) {
-    const stat = fs14.statSync(oldLock);
-    if (Date.now() - stat.mtimeMs <= 5 * 60 * 1e3) {
-      log.warn("another sdkvm operation seems in progress; skipping migration this run");
-      return "not-needed";
-    }
-  }
-  fs14.renameSync(oldHome, newHome);
-  const prevHome = process.env.SDKVM_HOME;
-  process.env.SDKVM_HOME = newHome;
-  try {
-    await fixupAfterRename(oldHome, newHome, platform, rc);
-  } finally {
-    if (prevHome === void 0) delete process.env.SDKVM_HOME;
-    else process.env.SDKVM_HOME = prevHome;
+import { fileURLToPath as fileURLToPath2 } from "url";
+var RELEASE_REPO = "QInJ1995/sdkvm";
+var RELEASE_ASSET = "sdkvm.tgz";
+var RELEASE_SUMS = "SHA256SUMS";
+function packageRoot(metaUrl = import.meta.url) {
+  return path15.resolve(path15.dirname(fileURLToPath2(metaUrl)), "..");
+}
+function isScriptInstall(probe = {}) {
+  const home = path15.resolve(probe.home ?? sdkvmHome());
+  const cliRoot = path15.resolve(path15.join(home, "cli"));
+  const runtimeRoot = path15.resolve(path15.join(home, "runtime"));
+  const pkg = path15.resolve(probe.packageRoot ?? packageRoot());
+  if (pkg === cliRoot) return true;
+  const exec = path15.resolve(probe.execPath ?? process.execPath);
+  return exec === runtimeRoot || exec.startsWith(runtimeRoot + path15.sep);
+}
+function releaseBase() {
+  const fromEnv = process.env.SDKVM_RELEASE_BASE?.replace(/\/+$/, "");
+  return fromEnv || `https://github.com/${RELEASE_REPO}/releases`;
+}
+function releaseAssetUrl(name, base = releaseBase()) {
+  return `${base}/latest/download/${name}`;
+}
+function checksumFor(sumsText, fileName) {
+  for (const line of sumsText.split("\n")) {
+    const match = /^([0-9a-f]{64})\s+\*?(\S+)\s*$/i.exec(line.trim());
+    const hash = match?.[1];
+    const name = match?.[2];
+    if (hash && name === fileName) return hash.toLowerCase();
   }
-  log.ok(`migrated ${oldHome} \u2192 ${newHome} (your installed JDKs are untouched)`);
-  return "migrated";
+  return null;
 }
-async function fixupAfterRename(oldHome, newHome, platform, rc) {
+async function prepareCliPackage(archiveFile, home = sdkvmHome()) {
+  const staging = path15.join(home, "cli.next");
+  fs14.rmSync(staging, { recursive: true, force: true });
+  fs14.mkdirSync(home, { recursive: true });
+  await extractArchive(archiveFile, "tar.gz", staging, detectPlatform());
+  const unpacked = path15.join(staging, "package");
+  if (!fs14.existsSync(path15.join(unpacked, "package.json"))) {
+    fs14.rmSync(staging, { recursive: true, force: true });
+    throw new SdkvmError("Release archive is missing package/package.json", { hint: archiveFile });
+  }
+  return unpacked;
+}
+async function replaceCliPackage(archiveFile, home = sdkvmHome()) {
+  const staging = path15.join(home, "cli.next");
+  const bak = path15.join(home, "cli.bak");
+  const cli = path15.join(home, "cli");
+  const unpacked = await prepareCliPackage(archiveFile, home);
+  fs14.rmSync(bak, { recursive: true, force: true });
+  if (fs14.existsSync(cli)) fs14.renameSync(cli, bak);
   try {
-    const oldLink = path15.join(newHome, "current");
-    let target = null;
-    try {
-      const st = fs14.lstatSync(oldLink);
-      if (st.isSymbolicLink()) {
-        target = path15.resolve(path15.dirname(oldLink), fs14.readlinkSync(oldLink));
+    fs14.renameSync(unpacked, cli);
+  } catch (err) {
+    if (fs14.existsSync(bak) && !fs14.existsSync(cli)) {
+      try {
+        fs14.renameSync(bak, cli);
+      } catch {
       }
-    } catch {
     }
-    if (target) {
-      const newTarget = target.startsWith(oldHome) ? newHome + target.slice(oldHome.length) : target;
-      if (fs14.existsSync(newTarget)) setCurrent("java", newTarget, platform);
+    fs14.rmSync(staging, { recursive: true, force: true });
+    throw err;
+  }
+  fs14.rmSync(bak, { recursive: true, force: true });
+  fs14.rmSync(staging, { recursive: true, force: true });
+}
+function windowsUpgradeScript(home) {
+  return [
+    "@echo off",
+    "setlocal",
+    `set "HOME=${home}"`,
+    "timeout /t 2 /nobreak >nul",
+    'if exist "%HOME%\\cli.bak" rmdir /s /q "%HOME%\\cli.bak"',
+    'if exist "%HOME%\\cli" move /y "%HOME%\\cli" "%HOME%\\cli.bak" >nul',
+    'move /y "%HOME%\\cli.next\\package" "%HOME%\\cli" >nul',
+    'if exist "%HOME%\\cli\\package.json" (',
+    '  if exist "%HOME%\\cli.bak" rmdir /s /q "%HOME%\\cli.bak"',
+    '  if exist "%HOME%\\cli.next" rmdir /s /q "%HOME%\\cli.next"',
+    ") else (",
+    '  if exist "%HOME%\\cli.bak" if not exist "%HOME%\\cli" move /y "%HOME%\\cli.bak" "%HOME%\\cli" >nul',
+    ")",
+    'del "%~f0"',
+    ""
+  ].join("\r\n");
+}
+function scheduleWindowsCliReplace(home) {
+  const script = path15.join(home, "upgrade-apply.cmd");
+  fs14.writeFileSync(script, windowsUpgradeScript(home), "utf8");
+  const child = spawn("cmd.exe", ["/c", script], {
+    detached: true,
+    stdio: "ignore",
+    windowsHide: true
+  });
+  child.unref();
+}
+async function upgradeCommand() {
+  if (!isScriptInstall()) {
+    log.info("this install came from npm; upgrade with: npm update -g sdkvm");
+    log.info("or: pnpm update -g sdkvm / yarn global upgrade sdkvm / bun update -g sdkvm");
+    return;
+  }
+  await withLock(async () => {
+    const sumsUrl = releaseAssetUrl(RELEASE_SUMS);
+    const assetUrl = releaseAssetUrl(RELEASE_ASSET);
+    log.info(`checking ${assetUrl}`);
+    const expected = checksumFor(await httpText(sumsUrl), RELEASE_ASSET);
+    if (!expected) {
+      throw new SdkvmError(`No checksum for ${RELEASE_ASSET}`, { hint: sumsUrl });
     }
+    fs14.mkdirSync(paths.cache(), { recursive: true });
+    const dest = path15.join(paths.cache(), RELEASE_ASSET);
     try {
-      fs14.rmSync(oldLink, { force: true });
-    } catch {
-      fs14.rmSync(oldLink, { recursive: true, force: true });
+      const downloaded = await downloadFile(assetUrl, dest);
+      if (downloaded.sha256 !== expected) {
+        throw new SdkvmError(`Checksum mismatch for ${RELEASE_ASSET}`, {
+          hint: `expected ${expected}, got ${downloaded.sha256}`
+        });
+      }
+      const before = getVersion();
+      const home = sdkvmHome();
+      if (process.platform === "win32") {
+        await prepareCliPackage(dest, home);
+        scheduleWindowsCliReplace(home);
+        log.ok(
+          `upgrade ${before} scheduled; exit this process and wait a moment for ${path15.join(home, "cli")} to refresh`
+        );
+        return;
+      }
+      await replaceCliPackage(dest, home);
+      const after = getVersion();
+      log.ok(
+        `upgraded CLI ${before} \u2192 ${after} in ${path15.join(home, "cli")}; runtime and installed SDKs were left in place`
+      );
+    } finally {
+      fs14.rmSync(dest, { force: true });
+      fs14.rmSync(`${dest}.part`, { force: true });
     }
+  });
+}
+
+// src/cli/nrm.ts
+var NPM_REGISTRY_PRESETS = [
+  { name: "npm", url: "https://registry.npmjs.org/", list: true },
+  { name: "yarn", url: "https://registry.yarnpkg.com/", list: true },
+  { name: "tencent", url: "https://mirrors.tencent.com/npm/", list: true },
+  { name: "cnpm", url: "https://r.cnpmjs.org/", list: true },
+  { name: "taobao", url: "https://registry.npmmirror.com/", list: true },
+  { name: "npmmirror", url: "https://registry.npmmirror.com/", list: false },
+  { name: "npmMirror", url: "https://skimdb.npmjs.com/registry/", list: true },
+  { name: "huawei", url: "https://repo.huaweicloud.com/repository/npm/", list: true }
+];
+var NAME_RE = /^[A-Za-z][A-Za-z0-9_-]*$/;
+var TEST_TIMEOUT_MS = 5e3;
+function normalizeRegistryUrl(url) {
+  return url.trim().replace(/\/+$/, "").toLowerCase();
+}
+function isBuiltinRegistryName(name) {
+  const key = name.trim().toLowerCase();
+  return NPM_REGISTRY_PRESETS.some((p) => p.name.toLowerCase() === key);
+}
+function listRegistryEntries() {
+  const custom = loadConfig().npmRegistries;
+  const out = [...NPM_REGISTRY_PRESETS];
+  for (const [name, url] of Object.entries(custom)) {
+    out.push({ name, url, list: true, custom: true });
+  }
+  return out;
+}
+function findRegistryByName(name) {
+  const key = name.trim();
+  const all = listRegistryEntries();
+  return all.find((p) => p.name === key || p.name.toLowerCase() === key.toLowerCase());
+}
+function matchListedRegistryName(registryUrl) {
+  const norm = normalizeRegistryUrl(registryUrl);
+  const hit = listRegistryEntries().find((p) => p.list && normalizeRegistryUrl(p.url) === norm);
+  return hit?.name ?? null;
+}
+function formatNrmListLine(name, url, current) {
+  const mark = current ? "*" : " ";
+  const padded = `${name} `.padEnd(14, "-");
+  return `${mark} ${padded} ${url}`;
+}
+async function defaultNpmRunner(args) {
+  try {
+    return await run("npm", args);
   } catch (err) {
-    log.warn(
-      `current link not migrated (${err instanceof Error ? err.message : String(err)}); run: sdkvm java use <version>`
-    );
+    if (err instanceof SdkvmError && /Failed to run npm/.test(err.message)) {
+      throw new SdkvmError("npm is not available", {
+        hint: "Install Node.js first, or run: sdkvm node use lts"
+      });
+    }
+    throw err;
   }
-  if (platform.os === "windows") {
-    try {
-      await setSdkEnvWin("java");
-    } catch (err) {
-      log.warn(`registry JAVA_HOME not updated: ${err instanceof Error ? err.message : String(err)}`);
+}
+async function defaultRegistryProbe(url) {
+  const target = url.replace(/\/+$/, "") + "/";
+  const started = Date.now();
+  const res = await fetch(target, {
+    method: "HEAD",
+    redirect: "follow",
+    signal: AbortSignal.timeout(TEST_TIMEOUT_MS)
+  });
+  if (res.status >= 500) {
+    throw new Error(`HTTP ${res.status}`);
+  }
+  return Date.now() - started;
+}
+async function getNpmRegistry(npmRun = defaultNpmRunner) {
+  const { stdout } = await npmRun(["config", "get", "registry"]);
+  const url = stdout.trim();
+  if (!url || url === "undefined") {
+    throw new SdkvmError("npm config get registry returned empty", {
+      hint: "Check your npm installation: npm config get registry"
+    });
+  }
+  return url;
+}
+async function setNpmRegistry(url, npmRun = defaultNpmRunner) {
+  await npmRun(["config", "set", "registry", url, "--location=user"]);
+}
+async function nrmLs(npmRun = defaultNpmRunner) {
+  const current = await getNpmRegistry(npmRun);
+  const matched = matchListedRegistryName(current);
+  for (const p of listRegistryEntries()) {
+    if (!p.list) continue;
+    log.raw(formatNrmListLine(p.name, p.url, matched === p.name));
+  }
+  if (!matched) {
+    log.raw(formatNrmListLine("custom", current, true));
+  }
+}
+async function nrmCurrent(npmRun = defaultNpmRunner) {
+  const current = await getNpmRegistry(npmRun);
+  const matched = matchListedRegistryName(current);
+  if (matched) {
+    log.raw(`${matched} \u2192 ${current}`);
+  } else {
+    log.raw(`custom \u2192 ${current}`);
+  }
+}
+async function nrmUse(name, npmRun = defaultNpmRunner) {
+  const entry = findRegistryByName(name);
+  if (!entry) {
+    const names = listRegistryEntries().map((p) => p.name).join(", ");
+    throw new SdkvmError(`Unknown registry "${name}"`, {
+      hint: `Available: ${names}`
+    });
+  }
+  await setNpmRegistry(entry.url, npmRun);
+  log.ok(`npm registry \u2192 ${entry.name} (${entry.url})`);
+}
+function nrmAdd(name, url) {
+  const key = name.trim();
+  if (!NAME_RE.test(key)) {
+    throw new SdkvmError(`Invalid registry name "${name}"`, {
+      hint: "Use letters, digits, _ or -; must start with a letter"
+    });
+  }
+  if (isBuiltinRegistryName(key)) {
+    throw new SdkvmError(`Cannot overwrite built-in registry "${key}"`, {
+      hint: "Pick another name, or use: sdkvm nrm use " + key
+    });
+  }
+  let parsed;
+  try {
+    parsed = new URL(url.trim());
+  } catch {
+    throw new SdkvmError(`Invalid URL: ${url}`);
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new SdkvmError(`Invalid URL protocol: ${parsed.protocol}`, {
+      hint: "Expected http:// or https://"
+    });
+  }
+  parsed.pathname = parsed.pathname.replace(/\/+$/, "") + "/";
+  const normalized = parsed.href;
+  updateConfig((config) => {
+    const existingKey = Object.keys(config.npmRegistries).find(
+      (k) => k.toLowerCase() === key.toLowerCase()
+    );
+    if (existingKey && existingKey !== key) {
+      delete config.npmRegistries[existingKey];
+    }
+    config.npmRegistries[key] = normalized;
+  });
+  log.ok(`added registry ${key} \u2192 ${normalized}`);
+}
+function nrmDel(name) {
+  const key = name.trim();
+  if (isBuiltinRegistryName(key)) {
+    throw new SdkvmError(`Cannot delete built-in registry "${key}"`);
+  }
+  let deleted;
+  updateConfig((config) => {
+    const existing = Object.keys(config.npmRegistries).find((k) => k.toLowerCase() === key.toLowerCase());
+    if (!existing) {
+      throw new SdkvmError(`Unknown custom registry "${name}"`, {
+        hint: "Only registries added with sdkvm nrm add can be deleted"
+      });
     }
+    delete config.npmRegistries[existing];
+    deleted = existing;
+  });
+  log.ok(`deleted registry ${deleted}`);
+}
+async function nrmTest(name, opts = {}) {
+  const npmRun = opts.npmRun ?? defaultNpmRunner;
+  const probe = opts.probe ?? defaultRegistryProbe;
+  const current = await getNpmRegistry(npmRun);
+  const matched = matchListedRegistryName(current);
+  let targets = listRegistryEntries().filter((p) => p.list);
+  if (name) {
+    const entry = findRegistryByName(name);
+    if (!entry) {
+      throw new SdkvmError(`Unknown registry "${name}"`, {
+        hint: "Run: sdkvm nrm ls"
+      });
+    }
+    targets = [{ ...entry, list: true }];
   }
-  if (rc && fs14.existsSync(rc)) {
+  for (const p of targets) {
+    const isCurrent = matched === p.name || normalizeRegistryUrl(p.url) === normalizeRegistryUrl(current);
     try {
-      if (fs14.readFileSync(rc, "utf8").includes(LEGACY_RC_BEGIN)) upsertRcFile(rc, "java");
-    } catch {
-      log.warn(`rc file not updated: ${rc}`);
+      const ms = await probe(p.url);
+      log.raw(formatNrmListLine(p.name, `${ms} ms`, isCurrent));
+    } catch (err) {
+      const detail = err instanceof Error ? err.message.split("\n")[0] : String(err);
+      log.raw(formatNrmListLine(p.name, `Fetch Error (${detail})`, isCurrent));
     }
   }
 }
 
 // src/index.ts
 var program = new Command();
-program.name("sdkvm").description("SDK version manager \u2014 install & switch JDKs (Temurin / Zulu / Corretto), Go toolchains, and Flutter SDKs").version(getVersion());
+program.name("sdkvm").description("SDK version manager \u2014 install & switch JDKs (Temurin / Zulu / Corretto), Go toolchains, Flutter SDKs, and Node.js runtimes").version(getVersion());
 function registerSdkCommands(cmd, type) {
   const s = getSdkType(type);
   const isJava = type === "java";
-  const installHelp = isJava ? "21 | lts | 21.0.5 | 21.0.5+11 | temurin-21" : type === "go" ? "1.24 | 1.24.5 | latest | golang-1.24" : "3.47 | 3.47.5 | 3.49.0-0.1.pre | latest | flutter-3.47";
+  const installHelp = isJava ? "21 | lts | 21.0.5 | 21.0.5+11 | temurin-21" : type === "go" ? "1.24 | 1.24.5 | latest | golang-1.24" : type === "flutter" ? "3.47 | 3.47.5 | 3.49.0-0.1.pre | latest | flutter-3.47" : "22 | 22.20.0 | lts | latest | nodejs-22.20.0";
   const vendorIds = s.vendors.map((v) => v.id).join(" | ");
   cmd.command("install").description(`install a ${s.label}: ${installHelp}`).argument("<version>", "version spec (optional vendor- prefix)").option("--vendor <id>", `vendor: ${vendorIds}`).option("--force", "reinstall even if already installed").action((v, o) => installCommand(type, v, o));
-  cmd.command("use").description(`switch the current ${s.label} (updates ${s.envVar} / PATH)`).argument("<version>", `installed version, e.g. ${isJava ? "21 / temurin-21.0.5+11" : type === "go" ? "1.24 / golang-1.24.5" : "3.47 / flutter-3.47.5"}`).option("--vendor <id>", "restrict matching to a vendor").action((v, o) => useCommand(type, v, o));
+  cmd.command("use").description(`switch the current ${s.label} (updates ${s.envVar} / PATH)`).argument("<version>", `installed version, e.g. ${isJava ? "21 / temurin-21.0.5+11" : type === "go" ? "1.24 / golang-1.24.5" : type === "flutter" ? "3.47 / flutter-3.47.5" : "22 / nodejs-22.20.0"}`).option("--vendor <id>", "restrict matching to a vendor").action((v, o) => useCommand(type, v, o));
   cmd.command("ls").alias("list").description(`list installed ${s.label}s (\u2192 marks current); -r lists installable versions`).option("-r, --remote", "list installable versions from all vendors").option("--vendor <id>", "filter --remote output to one vendor").action((o) => lsCommand(type, o));
   cmd.command("current").description(`show the current ${s.label}`).action(() => currentCommand([type]));
-  cmd.command("uninstall").description(`remove an installed ${s.label}`).argument("<version>", `installed version, e.g. ${isJava ? "21 / temurin-21.0.5+11" : type === "go" ? "1.24 / golang-1.24.5" : "3.47 / flutter-3.47.5"}`).option("--vendor <id>", "restrict matching to a vendor").action((v, o) => uninstallCommand(type, v, o));
-  cmd.command("mirror").description("show or set the download mirror").argument("[action]", "show | set | unset").argument("[vendor]", "vendor id").argument("[url]", "mirror root URL").action(
+  cmd.command("uninstall").description(`remove an installed ${s.label}`).argument("<version>", `installed version, e.g. ${isJava ? "21 / temurin-21.0.5+11" : type === "go" ? "1.24 / golang-1.24.5" : type === "flutter" ? "3.47 / flutter-3.47.5" : "22 / nodejs-22.20.0"}`).option("--vendor <id>", "restrict matching to a vendor").action((v, o) => uninstallCommand(type, v, o));
+  cmd.command("mirror").description("show, set, or switch download mirror sites for this SDK").argument("[action]", "ls | use | current | show | set | unset").argument("[nameOrVendor]", "site name, vendor id, or URL").argument("[url]", "mirror root URL (for set)").action(
     (a, v, u) => mirrorCommand(type, a, v, u)
   );
 }
@@ -1815,11 +2642,20 @@ goCmd.action(() => goCmd.help());
 var flutterCmd = program.command("flutter").description("Flutter SDK subcommands");
 registerSdkCommands(flutterCmd, "flutter");
 flutterCmd.action(() => flutterCmd.help());
+var nodeCmd = program.command("node").description("Node.js subcommands");
+registerSdkCommands(nodeCmd, "node");
+nodeCmd.action(() => nodeCmd.help());
 program.commands.find((c) => c.name() === "current")?.action(() => currentCommand());
 program.command("version").description("print sdkvm CLI version").action(versionCommand);
-program.hook("preAction", async () => {
-  await migrateLegacyHomeIfNeeded();
-});
+program.command("upgrade").description("upgrade the sdkvm CLI (script install replaces ~/.sdkvm/cli; npm install prints npm update -g)").action(upgradeCommand);
+var nrmCmd = program.command("nrm").description("npm registry manager (like nrm)");
+nrmCmd.command("ls").alias("list").description("list npm registries (* marks current)").action(() => nrmLs());
+nrmCmd.command("current").description("print the current npm registry").action(() => nrmCurrent());
+nrmCmd.command("use").description("switch the user-level npm registry").argument("<name>", "registry name, e.g. npm / taobao / myprivate").action((name) => nrmUse(name));
+nrmCmd.command("add").description("add a custom npm registry").argument("<name>", "registry name").argument("<url>", "registry URL").action((name, url) => nrmAdd(name, url));
+nrmCmd.command("del").alias("delete").alias("rm").description("delete a custom npm registry").argument("<name>", "custom registry name").action((name) => nrmDel(name));
+nrmCmd.command("test").description("ping registries and print latency").argument("[name]", "optional registry name; omit to test all").action((name) => nrmTest(name));
+nrmCmd.action(() => nrmCmd.help());
 program.parseAsync(process.argv).catch((err) => {
   const e = toSdkvmError(err);
   log.error(e.message);