@wwkit/opm 1.0.21 → 1.0.23

package/src/tools/webwork/index.js

@@ -4,15 +4,15 @@
  * 只负责运行环境本身（node/python/blues-lib），插件（cft/opencode/harness/sshproxy）
  * 由 blues-lib 提供的 ww init / ww init -u 全权处理，不再单独安装/检查。
  *
- * install 流程（5 步）：
- *   镜像检查(必查 npm/pip + 按需 nvm/node/uv) → ensure node/python → 写 NPM/PIP_REGISTRY/REGISTRY_PROXY → 装 blues-lib → ww init
+ * install 流程（6 步）：
+ *   镜像检查(必查 npm/pip + 按需 node/uv) → ensure node/python → 写 NPM/PIP_REGISTRY/REGISTRY_PROXY → 装 blues-lib → ww init → 插件命令 PATH 保障
  * upgrade 流程（3 步）：
  *   镜像检查(必查 npm/pip) → 写 NPM/PIP_REGISTRY/REGISTRY_PROXY → ww upgrade
  *
  * 命令: version / versions / installed / install / uninstall / upgrade / help
  */
 
-import { execSync } from 'node:child_process'
+import { execSync, spawnSync } from 'node:child_process'
 
 import { Shell } from '@wwkit/shared'
 import { parseFlags } from '../../cli/helpers/args.js'
@@ -20,7 +20,8 @@ import { output } from '../../formatter.js'
 import { getActiveProxy, getConfig, getActiveRegistry } from '../../config.js'
 import { PipManager } from '../../managers/pip.js'
 import { PythonManager, isUvInstalled, installUv } from '../../managers/python.js'
-import { NodeManager, isNvmInstalled, installNvm } from '../../managers/node.js'
+import { NodeManager, isMiseInstalled, installMise, getMiseInstallDir, detectSystemNodeConflict, prependSystemPathDirs } from '../../managers/node.js'
+import { getMiseShimsDir } from '../../cli/groups/mise.js'
 import { checkReachability } from '../../cli/groups/ping.js'
 
 const shell = new Shell()
@@ -35,7 +36,7 @@ const ACTIONS = {
   version:   { desc: 'Show installed version of each component' },
   versions:  { desc: 'Show latest available versions (default 10, -n <count>)' },
   installed: { desc: 'Show install status (true/false) of each component' },
-  install:   { desc: 'Mirror check + ensure runtime + write registry env + blues-lib + ww init' },
+  install:   { desc: 'Mirror check + ensure runtime + write registry env + blues-lib + ww init + PATH 保障' },
   uninstall: { desc: 'Uninstall all components in reverse order' },
   upgrade:   { desc: 'Mirror check + write registry env + ww upgrade' },
   help:      { desc: 'Show this help' },
@@ -55,7 +56,7 @@ export class WebworkGroup {
       return
     }
 
-    const parsed = parseFlags(rest)
+    const parsed = parseFlags(rest, { booleans: ['f', 'force'] })
 
     switch (action) {
       case 'version':
@@ -117,9 +118,9 @@ export class WebworkGroup {
     output(result)
   }
 
-/**
-    * 批量执行组件操作（uninstall 用）
-    * 每步打印 [n/total] 组件名 + 跳过/成功/失败日志，最后汇总
+  /**
+   * 批量执行组件操作（uninstall 用）
+   * 每步打印 [n/total] 组件名 + 跳过/成功/失败日志，最后汇总
    * @param {string} verb - install|uninstall|upgrade
    * @param {Array} components - 组件列表
    * @param {string} proxy - 代理地址
@@ -160,14 +161,78 @@ export class WebworkGroup {
     return { results, ok, skipped, failed }
   }
 
+  /**
+   * 检测当前进程是否以管理员权限运行（Windows）
+   *
+   * 首选 `net session`（快）：管理员返回 0，普通权限 Access Denied。
+   * net session 依赖 LanmanServer 服务——被禁用时管理员也会失败，故失败时用
+   * PowerShell IsInRole 复核（准确但慢 ~1s），避免误判阻止合法的管理员用户。
+   * 非 Windows 恒返回 true（无此概念）。
+   * @param {Function} [execSyncImpl] - 可注入的 execSync（测试用）
+   * @returns {boolean}
+   * @private
+   */
+  _isWindowsAdmin(execSyncImpl = execSync) {
+    if (!shell.isWindows) return true
+    try {
+      execSyncImpl('net session', { stdio: ['pipe', 'pipe', 'pipe'] })
+      return true
+    } catch {}
+    try {
+      const out = execSyncImpl(
+        'powershell -NoProfile -Command "[int]([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)"',
+        { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }
+      )
+      return String(out).trim() === '1'
+    } catch {
+      return false
+    }
+  }
+
+  /**
+   * Windows 下要求管理员权限运行 install：非管理员直接阻止（fail fast）。
+   *
+   * install 需要写系统/用户环境变量（PATH、注册表）让 node 在任意新终端可用；
+   * 普通权限无法修复系统 PATH 的旧 node 冲突，会留下"装完但终端看不到"的半成品
+   * 环境，故在入口直接阻止并给出提权指导。非 Windows 直接放行。
+   * @param {Function} [execSyncImpl] - 可注入的 execSync（测试用）
+   * @returns {boolean} true = 已阻止（调用方应终止）；false = 放行
+   * @private
+   */
+  _requireWindowsAdmin(execSyncImpl = execSync) {
+    if (!shell.isWindows) return false
+    if (this._isWindowsAdmin(execSyncImpl)) return false
+    console.error(
+      [
+        '',
+        '✗ 需要管理员权限：opm webwork install 已阻止执行',
+        '',
+        '  原因：install 要写系统/用户环境变量（PATH、注册表），让 mise 管理的 node/npm',
+        '  在任意新终端可用。普通权限无法修复系统 PATH 中的旧版 node 冲突，',
+        '  会导致"安装完成但终端看到的仍是旧版 node"的半成品状态。',
+        '',
+        '  请以管理员身份重新运行：',
+        '    Win11：右键开始按钮 → "终端(管理员)"（或按 Win+X 再按 A）',
+        '    Win10：搜索 PowerShell → 右键 → "以管理员身份运行"',
+        '    然后执行：opm webwork install',
+        '',
+      ].join('\n')
+    )
+    return true
+  }
+
   async _install(parsed) {
+    if (this._requireWindowsAdmin()) {
+      process.exit(1)
+    }
     const proxy = this._resolveProxy(parsed)
+    const force = !!(parsed.flags.force || parsed.flags.f)
 
-    console.log('\n========== 步骤 1/5: 镜像可达检查 ==========')
+    console.log('\n========== 步骤 1/6: 镜像可达检查 ==========')
     const env = await this._checkEnv()
     await this._checkMirrors(proxy, env)
 
-    console.log('\n========== 步骤 2/5: Ensure node / python ==========')
+    console.log('\n========== 步骤 2/6: Ensure node / python ==========')
     const ensured = []
     if (!env.node.satisfied) {
       console.log(`  [ENSURE] node >= ${env.node.required}...`)
@@ -184,21 +249,28 @@ export class WebworkGroup {
       console.log(`  → python ${env.python.provided} 已满足`)
     }
 
-    console.log('\n========== 步骤 3/5: 写入 NPM_REGISTRY / PIP_REGISTRY / REGISTRY_PROXY ==========')
+    console.log('\n========== 步骤 3/6: 写入 NPM_REGISTRY / PIP_REGISTRY / REGISTRY_PROXY ==========')
     this._writeRegistryEnv(proxy)
 
-    console.log('\n========== 步骤 4/5: 安装 blues-lib ==========')
-    const blue = await this._installPipPackage('blues-lib', proxy)
+    console.log('\n========== 步骤 4/6: 安装 blues-lib ==========')
+    const blue = await this._installPipPackage('blues-lib', proxy, force)
     if (blue.action === 'skipped') {
       console.log(`  → blues-lib ${blue.version} 已安装，跳过`)
+    } else if (blue.action === 'upgraded') {
+      console.log(`  ✓ blues-lib 已升级到最新（提供 ww 命令）`)
     } else {
       console.log(`  ✓ blues-lib 安装完成（提供 ww 命令）`)
     }
 
-    console.log('\n========== 步骤 5/5: ww init ==========')
+    console.log('\n========== 步骤 5/6: ww init ==========')
     this._runWwInit('init')
 
-    output({ action: 'install', env, ensured, bluesLib: blue, init: 'ww init' })
+    console.log('\n========== 步骤 6/6: 插件命令 PATH 保障 ==========')
+    const pathFix = this._ensurePluginCommandsOnPath()
+    const shimsFix = this._ensureMiseShimsOnPath()
+    this._printCftEnvHint()
+
+    output({ action: 'install', env, ensured, bluesLib: blue, init: 'ww init', pathFix, shimsFix })
   }
 
   async _upgrade(parsed) {
@@ -226,6 +298,191 @@ export class WebworkGroup {
     execSync(`ww ${action}`, { encoding: 'utf8', stdio: 'inherit' })
   }
 
+  /**
+   * 获取 npm 全局 bin 目录（npm config get prefix）
+   *
+   * Windows 上该目录即 npm 全局安装的 shim 目录（.cmd/.ps1/无扩展名脚本）；
+   * ww init 的插件安装（cft/opencode/sshproxy/harness）把命令装在这里。
+   * @returns {string|null}
+   * @private
+   */
+  _npmGlobalBin() {
+    try {
+      const out = execSync('npm config get prefix', {
+        encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
+      })
+      return out.trim() || null
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * 检查注册表 HKCU\Environment 是否存在指定用户环境变量（Windows）
+   * @param {string} name - 环境变量名
+   * @returns {boolean}
+   * @private
+   */
+  _registryEnvHas(name) {
+    if (!shell.isWindows) return false
+    try {
+      execSync(`reg query "HKCU\\Environment" /v ${name}`, {
+        stdio: ['pipe', 'pipe', 'pipe'],
+      })
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  /**
+   * Windows 下确保 npm 全局 bin 目录进入持久化用户 PATH（幂等）
+   *
+   * 解决场景：ww init 在 MINGW64 / bash（PATH 含 nvm node）中运行时，
+   * `npm install -g` 会把插件装到 shell 会话专属前缀（如 ~/.nvm/.../bin/），
+   * 而该目录不在系统/用户 PATH，其他 shell（cmd/PowerShell/Git Bash 默认）
+   * 里 cft/opencode/sshproxy 命令不可用。此方法把该目录追加进
+   * HKCU\Environment\Path（REG_EXPAND_SZ），重启终端后全局生效。
+   *
+   * @param {Shell} [shellImpl] - 可注入的 Shell 实例（测试用），默认模块级 shell
+   * @returns {{ bin: string|null, added: boolean, inPath: boolean }}
+   * @private
+   */
+  _ensurePluginCommandsOnPath(shellImpl = shell) {
+    if (!shellImpl.isWindows) {
+      return { bin: null, added: false, inPath: false }
+    }
+    const bin = this._npmGlobalBin()
+    if (!bin) {
+      console.log('  [WARN] 无法获取 npm 全局目录（npm config get prefix 失败），跳过 PATH 保障')
+      return { bin: null, added: false, inPath: false }
+    }
+    const userPath = typeof shellImpl.getUserPath === 'function' ? shellImpl.getUserPath() : ''
+    const inPath = shellImpl.dirInPath(bin, userPath)
+    if (inPath) {
+      console.log(`  ✓ npm 全局 bin 已在用户 PATH: ${bin}`)
+      return { bin, added: false, inPath: true }
+    }
+    const added = shellImpl.ensurePathEntry(bin)
+    console.log(
+      added
+        ? `  ✓ 已追加 npm 全局 bin 到用户 PATH（重启终端后生效）: ${bin}`
+        : `  ✗ 追加用户 PATH 失败，请手动将以下目录加入 PATH 后重启终端:\n    ${bin}`
+    )
+    return { bin, added, inPath: false }
+  }
+
+  /**
+   * 确保 mise shims 在当前进程 PATH，并在 Windows 上持久化到用户 PATH（幂等）
+   *
+   * 所有平台：把 mise 安装目录 + shims 目录前置到当前进程 PATH，让 webwork install
+   * 后续步骤（ww init 的 npm install -g）用 mise 管理的 node，而非系统残留旧版。
+   * Windows 额外把目录写入持久化用户 PATH（HKCU 注册表）并检测/修复系统 PATH 冲突；
+   * Linux/macOS 不写 profile（靠 mise activate 管理 shell rc），仅前置当前进程 PATH。
+   * mise 未安装时跳过（node 由其他方式管理，无 shims 可保障）。
+   *
+   * @param {Shell} [shellImpl] - 可注入的 Shell 实例（测试用），默认模块级 shell
+   * @param {Function} [isMiseOk] - 可注入的 mise 安装检测（测试用），默认 isMiseInstalled
+   * @returns {{ shims: string|null, added: boolean, inPath: boolean }}
+   * @private
+   */
+  _ensureMiseShimsOnPath(shellImpl = shell, isMiseOk = isMiseInstalled) {
+    // mise 未安装：所有平台跳过（无 shims 可保障）
+    if (!isMiseOk()) {
+      if (shellImpl.isWindows) {
+        console.log('  [SKIP] mise 未安装，跳过 mise shims PATH 保障')
+      }
+      return { shims: null, added: false, inPath: false }
+    }
+    // 需要两个目录都在 PATH：
+    //   1. mise 安装目录（~/.local/bin，mise 二进制本身）——node shim 内部调用 `mise x -- node`
+    //   2. mise shims 目录（node/npm/npx shim）——mise 为激活工具生成的 shim
+    // 缺任一，node 命令都不可用（shim 找不到 mise，或 PATH 无 shim）。
+    const dirs = [getMiseInstallDir(), getMiseShimsDir()]
+    // 所有平台：把 mise 目录前置到当前进程 PATH，让本进程后续命令（ww init 的 npm）用 mise node。
+    // 进程从旧 PATH 启动时不含 mise shims；webwork install 内部 node/npm 命令必须用 mise 的 node，
+    // 故显式前置（幂等：已在则移到最前）。
+    if (typeof shellImpl.prependProcPath === 'function') {
+      shellImpl.prependProcPath(dirs)
+    }
+    // Linux/macOS：不写持久化 profile（靠 mise activate 管理 shell rc），仅前置当前进程 PATH
+    if (!shellImpl.isWindows) {
+      return { shims: dirs[1], added: false, inPath: false }
+    }
+    const userPath = typeof shellImpl.getUserPath === 'function' ? shellImpl.getUserPath() : ''
+    const inPath = dirs.every((d) => shellImpl.dirInPath(d, userPath))
+    // 逐个前置到用户 PATH（幂等：已在最前 → false；在末尾/缺失 → 移到最前）。
+    // 前置（而非追加）：系统 PATH 可能已有旧版 node（如 D:\library\nodejs），
+    // 只有把 mise 目录前置才能让新 shell 优先用 mise 管理的 node。
+    let added = false
+    for (const d of dirs) {
+      if (shellImpl.prependPathEntry(d)) added = true
+    }
+    if (inPath && !added) {
+      console.log(`  ✓ mise 目录已在用户 PATH 最前: ${dirs.join('; ')}`)
+    } else {
+      console.log(
+        added
+          ? `  ✓ 已前置 mise 目录到用户 PATH（重启终端后 node/npm 可用）: ${dirs.join('; ')}`
+          : `  ✗ 前置 mise 目录失败，请手动将以下目录加入 PATH 后重启终端:\n    ${dirs.join('\n    ')}`
+      )
+    }
+    // 系统 PATH 优先于用户 PATH：若系统 PATH 有旧版 node，会抢先于 mise shims。
+    // 自动尝试修复（管理员运行本命令时直接成功）；无权限才提示用户处理。
+    const sysNode = this._detectSystemNodeConflict()
+    if (sysNode) {
+      if (this._tryFixSystemNode(dirs)) {
+        console.log(`  ✓ 系统 PATH 含旧版 node（${sysNode}），已自动把 mise 目录前置到系统 PATH（重启终端后生效）`)
+      } else {
+        console.log(`  [WARN] 系统 PATH 含旧版 node（${sysNode}），优先于 mise shims，修复系统 PATH 需管理员权限`)
+        console.log('    → 以管理员身份运行 `opm node fix-path`，或以管理员身份重跑 `opm webwork install` 自动完成')
+      }
+    }
+    return { shims: dirs[1], added, inPath }
+  }
+
+  /**
+   * 尝试把 mise 目录前置到系统 PATH（HKLM）——管理员运行时成功，普通权限失败
+   * @param {string[]} dirs - mise 安装目录 + shims 目录
+   * @param {Function} [spawnSyncImpl] - 可注入的 spawnSync（测试用）
+   * @returns {boolean} 是否修复成功
+   * @private
+   */
+  _tryFixSystemNode(dirs, spawnSyncImpl = spawnSync) {
+    return prependSystemPathDirs(dirs, spawnSyncImpl)
+  }
+
+  /**
+   * 检测系统 PATH（HKLM）中是否含 node.exe 的目录（Windows）
+   *
+   * Windows 新进程 PATH = 系统 PATH + 用户 PATH，系统 PATH 优先。若系统 PATH 有
+   * 旧版 node（如 D:\library\nodejs\node.exe），会抢先于用户 PATH 的 mise shims，
+   * 导致新终端中 node 仍是旧版。返回该目录路径；无冲突返回空串。
+   * @returns {string}
+   * @private
+   */
+  _detectSystemNodeConflict() {
+    return detectSystemNodeConflict()
+  }
+
+  /**
+   * 打印 CFT 环境变量状态提示（Windows）
+   *
+   * SELENIUM_CFT_* 由 @wwkit/cft postinstall 经 setx 写入注册表，但已打开的
+   * shell 不会刷新注册表变更 —— 需重启终端后 ww webdriver 检查才识别到 CFT。
+   * @private
+   */
+  _printCftEnvHint() {
+    if (!shell.isWindows) return
+    if (this._registryEnvHas('SELENIUM_CFT_DIR')) {
+      console.log('  ✓ SELENIUM_CFT_* 已写入注册表（由 @wwkit/cft postinstall 设置）')
+      console.log('    → 重启终端后 ww webdriver status 将识别到 CFT 安装')
+    } else {
+      console.log('  [WARN] SELENIUM_CFT_DIR 未写入注册表，cft postinstall 可能未执行')
+      console.log('    → 请运行 ww plugin init -u 重装 cft 插件')
+    }
+  }
+
   /**
    * 将 NPM_REGISTRY / PIP_REGISTRY / REGISTRY_PROXY 写入 shell profile，并同步到当前会话 env
    * blues-lib 的相关命令依赖镜像，写入后保持与 opm 配置一致；代理同理，ww init 用同一机制读取
@@ -281,7 +538,7 @@ export class WebworkGroup {
   /**
    * 检查镜像可达性（HEAD 请求，不可达则抛错）
    * 必查：npm / pip（blues-lib 依赖，环境必然可用）
-   * 条件查：nvm + node（仅 env.node 不满足时）、uv（仅 env.python 不满足时）
+   * 条件查：node（仅 env.node 不满足时）、uv（仅 env.python 不满足时）
    * cft 不查：由 ww init 全权处理插件安装，不再单独检查。
    * @param {string} proxy
    * @param {{ node: { satisfied: boolean }, python: { satisfied: boolean } } | null} env
@@ -301,7 +558,6 @@ export class WebworkGroup {
       { name: 'npm', url: getActiveRegistry('npm') },
       { name: 'pip', url: getActiveRegistry('pip') },
       ...(needNode ? [
-        { name: 'nvm', url: getActiveRegistry('nvm') },
         { name: 'node', url: getActiveRegistry('node') },
       ] : []),
       ...(needPython ? [
@@ -431,7 +687,7 @@ export class WebworkGroup {
 
   async _nodeVersions(proxy, num) {
     const mgr = new NodeManager()
-    if (!isNvmInstalled()) return []
+    if (!isMiseInstalled()) return []
     try {
       const out = mgr._exec(mgr.cfg.listRemoteCmd, { allowNonZero: true, proxy })
       const versions = mgr._parseRemote(out).map((v) => v.replace(/^v/, ''))
@@ -443,6 +699,9 @@ export class WebworkGroup {
 
   async _installNode(proxy) {
     const defaultVersion = getConfig().node?.defaultVersion || '24'
+    // 先前置 mise 目录到当前进程 PATH，让 _nodeVersion() 用 mise 管理的 node 判断，
+    // 而非系统残留的旧版 node（避免误判不满足而重复安装）。
+    if (isMiseInstalled()) this._ensureMiseShimsOnPath()
     const installed = this._nodeVersion()
     if (installed !== '-' && this._compareVersion(installed, defaultVersion) >= 0) {
       return { action: 'skipped', reason: `node ${installed} >= ${defaultVersion}`, version: installed }
@@ -452,15 +711,50 @@ export class WebworkGroup {
     } else {
       console.log(`  node not found, installing ${defaultVersion}`)
     }
-    if (!isNvmInstalled()) {
-      console.log('  nvm not found, installing nvm...')
-      installNvm(proxy)
+    if (!isMiseInstalled()) {
+      console.log('  mise not found, installing mise...')
+      await installMise(proxy)
     }
     const mgr = new NodeManager()
     mgr._execInherit(mgr.cfg.installCmd(defaultVersion), { proxy })
-    mgr._execInherit(mgr.cfg.useCmd(defaultVersion), { proxy })
-    mgr._execInherit(mgr.cfg.defaultCmd(defaultVersion), { proxy })
-    return { action: 'installed', version: defaultVersion }
+    // mise install node@<major> 会自动 use 最新 <major>.x；但 default 别名需要完整版本号。
+    // 优先 mise current 解析完整版本；失败则回退 mise ls --json 的当前激活版本；
+    // 都失败则跳过 use/default（install 已自动激活），绝不回退主版本别名。
+    const useVersion = this._resolveInstalledNodeVersion(mgr, proxy)
+    if (useVersion) {
+      mgr._execInherit(mgr.cfg.useCmd(useVersion), { proxy })
+      mgr._execInherit(mgr.cfg.defaultCmd(useVersion), { proxy })
+    } else {
+      console.log('  [WARN] 无法解析已安装的完整 node 版本，跳过 use/default 设置（mise install 已自动激活）')
+    }
+    // 装完 node 后立即把 mise 目录前置到当前进程 PATH，确保后续步骤（blues-lib/ww init）
+    // 的 node/npm 命令用 mise 管理的 node，而非系统残留的旧版 node。
+    this._ensureMiseShimsOnPath()
+    return { action: 'installed', version: useVersion || defaultVersion }
+  }
+
+  /**
+   * 解析 mise install 后实际激活的完整 node 版本
+   *
+   * 优先 mise current；失败回退 mise ls --json 的当前激活版本（带 current 标记）；
+   * 都失败返回空串（调用方跳过 use/default，绝不回退主版本别名）。
+   * @param {NodeManager} mgr
+   * @param {string} proxy
+   * @returns {string}
+   * @private
+   */
+  _resolveInstalledNodeVersion(mgr, proxy) {
+    try {
+      const currentOut = mgr._exec(mgr.cfg.currentCmd, { allowNonZero: true, proxy })
+      const parsed = mgr.cfg.parseCurrent(currentOut)
+      if (parsed) return parsed.replace(/^v/, '')
+    } catch {}
+    try {
+      const lsOut = mgr._exec(mgr.cfg.listCmd, { allowNonZero: true, proxy })
+      const current = mgr._parseInstalled(lsOut).find((i) => i.current)
+      if (current) return current.version
+    } catch {}
+    return ''
   }
 
   async _pipInstalled(name) {
@@ -497,10 +791,13 @@ export class WebworkGroup {
       .slice(0, num)
   }
 
-  async _installPipPackage(name, proxy) {
+  async _installPipPackage(name, proxy, force = false) {
     const pip = new PipManager()
     const existing = await pip.isInstalled(name, { global: true })
     if (existing.installed) {
+      if (force) {
+        return pip.upgrade(name, { global: true, proxy })
+      }
       return { action: 'skipped', reason: `${name} ${existing.version} already installed`, version: existing.version }
     }
     return pip.install(name, null, { global: true, proxy })
@@ -531,6 +828,7 @@ ${actionLines}
 
 Options:
   -p, --proxy <url>  Proxy for install/upgrade/versions (overrides config proxy.active)
+  -f, --force        Force upgrade blues-lib even if already installed (install only)
   -h, --help         Show this help
 
 Examples:
@@ -538,6 +836,7 @@ Examples:
   opm webwork versions      Show latest available versions (default 10, -n <num>)
   opm webwork installed     Show install status of all components
   opm webwork install       Mirror check + ensure runtime + registry env + blues-lib + ww init
+  opm webwork install -f    Same as install, but force upgrade blues-lib to latest
   opm webwork uninstall     Uninstall all components in reverse order
   opm webwork upgrade       Mirror check + write registry env + ww upgrade
 `)

package/docs/managers/nvm.md

@@ -1,36 +0,0 @@
-# nvm 命令对照表
-
-`@wwkit/opm` 统一命令管理 nvm 自身（安装/升级/卸载）。
-
-## 命令对照
-
-| 统一命令 | 原始命令 | 说明 |
-|---------|---------|------|
-| `opm nvm version` | `nvm --version` | 查看 nvm 版本 |
-| `opm nvm registry` | 读 `~/.config/opm/config.json5` 的 `nvm.registry.active` | 查询 nvm git 镜像 |
-| `opm nvm registry set <url\|preset>` | 写 `~/.config/opm/config.json5` | 设置 nvm git 镜像 |
-| `opm nvm registry presets` | — | 列出可用镜像预设 |
-| `opm nvm install` | `git clone <mirror> ~/.nvm` + 写 shell profile | 安装 nvm |
-| `opm nvm upgrade` | `cd ~/.nvm && git pull --tags` | 更新 nvm |
-| `opm nvm uninstall` | `rm -rf ~/.nvm` | 卸载 nvm |
-| `opm nvm dir` | 返回 `~/.nvm` 安装目录 |
-| `opm nvm list` | `nvm ls --no-colors` | 列出已安装 Node.js 版本 |
-
-## 镜像预设
-
-| 预设名 | 地址 |
-|--------|------|
-| `official` | `https://github.com/nvm-sh/nvm.git` |
-| `gitee` | `https://gitee.com/mirrors/nvm.git` |
-
-## 示例
-
-```bash
-opm nvm version
-opm nvm registry set gitee
-opm nvm install
-opm nvm upgrade
-opm nvm list
-opm nvm dir
-opm nvm uninstall
-```

package/src/cli/groups/nvm.js

@@ -1,81 +0,0 @@
-/**
- * nvm 命令组 — 管理 nvm 自身
- *
- * nvm 是 shell function，通过 git clone 安装；
- * install = git clone + 写 shell profile；upgrade = git pull；uninstall = rm -rf ~/.nvm。
- * registry 是 nvm 的 git 镜像地址（official / gitee）。
- */
-
-import { execSync } from 'node:child_process'
-import fs from 'node:fs'
-import path from 'node:path'
-import os from 'node:os'
-import { ToolManagerGroup } from './version-manager.js'
-import { Shell } from '@wwkit/shared'
-import { getActiveRegistry } from '../../config.js'
-import { installNvm, parseNvmInstalled } from '../../managers/node.js'
-
-const shell = new Shell()
-
-/**
- * 获取 nvm 目录
- * @returns {string}
- */
-function getNvmDir() {
-  return process.env.NVM_DIR || path.join(os.homedir(), '.nvm')
-}
-
-export class NvmGroup extends ToolManagerGroup {
-  constructor() {
-    super({
-      name: 'nvm',
-      desc: 'nvm version manager (manage nvm itself)',
-      needsBash: true,
-      isInstalled: () => fs.existsSync(path.join(getNvmDir(), 'nvm.sh')),
-      getPath: () => getNvmDir(),
-      versionCmd: () => `source "${path.join(getNvmDir(), 'nvm.sh')}" && nvm --version`,
-      parseVersion: (out) => out.trim(),
-      listCmd: () => `source "${path.join(getNvmDir(), 'nvm.sh')}" && nvm ls --no-colors`,
-      parseList: parseNvmInstalled,
-      install: (proxy) => installNvm(proxy),
-      upgrade: () => {
-        const nvmDir = getNvmDir()
-        if (!fs.existsSync(path.join(nvmDir, '.git'))) {
-          throw new Error(`${nvmDir} is not a git repository (nvm was not installed via git clone). Run \`opm nvm uninstall -y\` then \`opm nvm install\` to reinstall.`)
-        }
-        execSync(`cd "${nvmDir}" && git remote set-url origin "${getActiveRegistry('nvm')}" && git pull --tags`, {
-          stdio: shell.stdioForExec(true),
-          shell: shell.resolveBash(),
-        })
-        return { action: 'upgraded' }
-      },
-      uninstall: () => {
-        fs.rmSync(getNvmDir(), { recursive: true, force: true })
-        return { action: 'uninstalled', hint: 'Remove NVM_DIR/source line from shell profile manually' }
-      },
-      usage: 'opm nvm <action> [args] [options]',
-      actions: [
-        ['version', 'Show nvm version'],
-        ['installed', 'Check if nvm is installed'],
-        ['registry', 'Show active nvm git mirror (from opm config)'],
-        ['registry set <url|preset>', 'Set active nvm git mirror (writes opm config)'],
-        ['registry presets', 'List available mirror presets'],
-        ['install', 'Install nvm (git clone + shell profile setup)'],
-        ['upgrade', 'Update nvm (git pull)'],
-        ['uninstall', 'Remove nvm (~/.nvm)'],
-        ['dir', 'Show nvm install directory'],
-        ['list', 'List installed Node.js versions (nvm ls --no-colors)'],
-        ['help', 'Show this help'],
-      ],
-      examples: [
-        'opm nvm version',
-        'opm nvm installed',
-        'opm nvm registry set gitee',
-        'opm nvm install',
-        'opm nvm upgrade',
-        'opm nvm dir',
-        'opm nvm list',
-      ],
-    })
-  }
-}