@wwkit/opm 1.0.9 → 1.0.11

package/src/tools/webwork/index.js

@@ -1,73 +1,50 @@
 /**
  * webwork 命令组 — WebWork 开发环境一键安装/管理
  *
- * 编排安装 7 个组件，复用已有 manager / group 能力，不重复实现：
- *   1. Python（确保系统 python3 可用，版本 >= config.python.defaultVersion）
- *   2. blues-lib（pip 全局安装，已安装则跳过）
- *   3. cft（Chrome for Testing 二进制安装，已安装则跳过）
- *   4. Node.js（确保可用，版本 >= config.node.defaultVersion）
- *   5. opencode（npm 全局安装 opencode-ai，已安装则跳过）
- *   6. harness（npm 全局安装 @wwkit/harness，已安装则跳过）
- *   7. sshproxy（npm 全局安装 @wwkit/sshproxy，已安装则跳过）
+ * 只负责运行环境本身（node/python/blues-lib），插件（cft/opencode/harness/sshproxy）
+ * 由 blues-lib 提供的 ww init / ww init -u 全权处理，不再单独安装/检查。
  *
- * npm 包安装使用 --dangerously-allow-all-scripts（npm >= 11）放行 postinstall 脚本。
+ * install 流程（5 步）：
+ *   镜像检查(必查 npm/pip/cft + 按需 nvm/node/uv) → ensure node/python → 写 NPM/PIP/CFT_REGISTRY → 装 blues-lib → ww init
+ * upgrade 流程（4 步）：
+ *   镜像检查(必查 npm/pip/cft) → 写 NPM/PIP/CFT_REGISTRY → pip 升级 blues-lib → ww init -u
  *
- * install 流程：镜像可达检查 → 安装组件 → 初始化 → 验证
- * init 流程：ww config init → 写运行时路径(cft/harness) → ww sqlite init → ww web init → summary
- * verify 流程：ww doctor → ww sqlite debug → ww run debug → ww web status → ww webdriver debug
- *
- * 命令: version / versions / installed / install / init / verify / uninstall / upgrade / help
+ * 命令: version / versions / installed / install / uninstall / upgrade / help
  */
 
-import fs from 'node:fs'
-import path from 'node:path'
 import { execSync } from 'node:child_process'
 
-import { Shell, getXdgConfigDir } from '@wwkit/shared'
+import { Shell } from '@wwkit/shared'
 import { parseFlags } from '../../cli/helpers/args.js'
 import { output } from '../../formatter.js'
 import { getActiveProxy, getConfig, getActiveRegistry } from '../../config.js'
-import { NpmManager } from '../../managers/npm.js'
 import { PipManager } from '../../managers/pip.js'
 import { PythonManager, isUvInstalled, installUv } from '../../managers/python.js'
 import { NodeManager, isNvmInstalled, installNvm } from '../../managers/node.js'
-import { CftGroup } from '../../binaries/cft/index.js'
 import { checkReachability } from '../../cli/groups/ping.js'
 
 const shell = new Shell()
 
 const COMPONENTS = [
   { key: 'python', label: 'Python' },
-  { key: 'blues-lib', label: 'blues-lib' },
-  { key: 'cft', label: 'cft' },
   { key: 'node', label: 'Node.js' },
-  { key: 'opencode', label: 'opencode' },
-  { key: 'harness', label: 'harness' },
-  { key: 'sshproxy', label: 'sshproxy' },
+  { key: 'blues-lib', label: 'blues-lib' },
 ]
 
-const NPM_PACKAGES = {
-  opencode: 'opencode-ai',
-  harness: '@wwkit/harness',
-  sshproxy: '@wwkit/sshproxy',
-}
-
 const ACTIONS = {
   version:   { desc: 'Show installed version of each component' },
   versions:  { desc: 'Show latest available version of each component (remote)' },
   installed: { desc: 'Show install status (true/false) of each component' },
-  install:   { desc: 'Install all components + init + verify' },
-  init:      { desc: 'Initialize runtime (config/webdriver/opencode/sqlite)' },
-  verify:    { desc: 'Verify installation (sqlite/run/web/webdriver)' },
+  install:   { desc: 'Mirror check + ensure runtime + write registry env + blues-lib + ww init' },
   uninstall: { desc: 'Uninstall all components in reverse order' },
-  upgrade:   { desc: 'Upgrade all components to latest' },
+  upgrade:   { desc: 'Upgrade blues-lib + ww init -u' },
   help:      { desc: 'Show this help' },
 }
 
 export class WebworkGroup {
   constructor() {
     this.name = 'webwork'
-    this.desc = 'WebWork dev environment (python/blues-lib/cft/node/opencode/harness/sshproxy)'
+    this.desc = 'WebWork dev environment (python/node/blues-lib + ww init)'
   }
 
   async run(argv) {
@@ -89,10 +66,6 @@ export class WebworkGroup {
         return this._installed()
       case 'install':
         return this._install(parsed)
-      case 'init':
-        return this._init(parsed)
-      case 'verify':
-        return this._verify(parsed)
       case 'uninstall':
         return this._uninstall(parsed)
       case 'upgrade':
@@ -115,12 +88,8 @@ export class WebworkGroup {
     const result = {}
 
     result['python'] = await this._pythonVersion()
-    result['blues-lib'] = await this._pipVersion('blues-lib')
-    result['cft'] = this._cftVersion()
     result['node'] = this._nodeVersion()
-    result['opencode'] = await this._npmVersion(NPM_PACKAGES.opencode)
-    result['harness'] = await this._npmVersion(NPM_PACKAGES.harness)
-    result['sshproxy'] = await this._npmVersion(NPM_PACKAGES.sshproxy)
+    result['blues-lib'] = await this._pipVersion('blues-lib')
 
     output(result)
   }
@@ -130,12 +99,8 @@ export class WebworkGroup {
     const result = {}
 
     result['python'] = await this._pythonLatest(proxy)
-    result['blues-lib'] = await this._pipLatest('blues-lib', proxy)
-    result['cft'] = await this._cftLatest(proxy)
     result['node'] = await this._nodeLatest(proxy)
-    result['opencode'] = await this._npmLatest(NPM_PACKAGES.opencode, proxy)
-    result['harness'] = await this._npmLatest(NPM_PACKAGES.harness, proxy)
-    result['sshproxy'] = await this._npmLatest(NPM_PACKAGES.sshproxy, proxy)
+    result['blues-lib'] = await this._pipLatest('blues-lib', proxy)
 
     output(result)
   }
@@ -144,19 +109,15 @@ export class WebworkGroup {
     const result = {}
 
     result['python'] = this._pythonInstalled()
-    result['blues-lib'] = await this._pipInstalled('blues-lib')
-    result['cft'] = this._cftInstalled()
     result['node'] = this._nodeInstalled()
-    result['opencode'] = await this._npmInstalled(NPM_PACKAGES.opencode)
-    result['harness'] = await this._npmInstalled(NPM_PACKAGES.harness)
-    result['sshproxy'] = await this._npmInstalled(NPM_PACKAGES.sshproxy)
+    result['blues-lib'] = await this._pipInstalled('blues-lib')
 
     output(result)
   }
 
-  /**
-   * 批量执行组件操作（install/uninstall/upgrade 共用）
-   * 每步打印 [n/total] 组件名 + 跳过/成功/失败日志，最后汇总
+/**
+    * 批量执行组件操作（uninstall 用）
+    * 每步打印 [n/total] 组件名 + 跳过/成功/失败日志，最后汇总
    * @param {string} verb - install|uninstall|upgrade
    * @param {Array} components - 组件列表
    * @param {string} proxy - 代理地址
@@ -200,56 +161,140 @@ export class WebworkGroup {
   async _install(parsed) {
     const proxy = this._resolveProxy(parsed)
 
-    console.log('\n========== 步骤 1/3: 检查镜像可达性 ==========')
-    await this._checkMirrors(proxy)
+    console.log('\n========== 步骤 1/5: 镜像可达检查 ==========')
+    const env = await this._checkEnv()
+    await this._checkMirrors(proxy, env)
 
-    console.log('\n========== 步骤 2/3: 安装组件 ==========')
-    await this._runBatch('install', COMPONENTS, proxy, (key, p) => this._installComponent(key, p))
+    console.log('\n========== 步骤 2/5: Ensure node / python ==========')
+    const ensured = []
+    if (!env.node.satisfied) {
+      console.log(`  [ENSURE] node >= ${env.node.required}...`)
+      ensured.push(await this._installNode(proxy))
+    } else {
+      ensured.push({ action: 'skipped', reason: `node ${env.node.provided} already satisfied` })
+      console.log(`  → node ${env.node.provided} 已满足`)
+    }
+    if (!env.python.satisfied) {
+      console.log(`  [ENSURE] python >= ${env.python.required}...`)
+      ensured.push(await this._installPython(proxy))
+    } else {
+      ensured.push({ action: 'skipped', reason: `python ${env.python.provided} already satisfied` })
+      console.log(`  → python ${env.python.provided} 已满足`)
+    }
 
-    console.log('\n========== 步骤 3/3: 初始化 + 验证 ==========')
-    await this._init(parsed)
-    await this._verify(parsed)
+    console.log('\n========== 步骤 3/5: 写入 NPM_REGISTRY / PIP_REGISTRY / CFT_REGISTRY ==========')
+    this._writeRegistryEnv()
+
+    console.log('\n========== 步骤 4/5: 安装 blues-lib ==========')
+    const blue = await this._installPipPackage('blues-lib', proxy)
+    if (blue.action === 'skipped') {
+      console.log(`  → blues-lib ${blue.version} 已安装，跳过`)
+    } else {
+      console.log(`  ✓ blues-lib 安装完成（提供 ww 命令）`)
+    }
+
+    console.log('\n========== 步骤 5/5: ww init ==========')
+    execSync('ww init', { encoding: 'utf8', stdio: 'inherit' })
+
+    output({ action: 'install', env, ensured, bluesLib: blue, init: 'ww init' })
   }
 
-  async _uninstall(parsed) {
+  async _upgrade(parsed) {
     const proxy = this._resolveProxy(parsed)
-    const reversed = [...COMPONENTS].reverse()
-    await this._runBatch('uninstall', reversed, proxy, (key, p) => this._uninstallComponent(key, p))
+
+    console.log('\n========== 步骤 1/4: 镜像可达检查 ==========')
+    await this._checkMirrors(proxy, null)
+
+    console.log('\n========== 步骤 2/4: 写入 NPM_REGISTRY / PIP_REGISTRY / CFT_REGISTRY ==========')
+    this._writeRegistryEnv()
+
+    console.log('\n========== 步骤 3/4: 升级 blues-lib ==========')
+    const blue = await this._upgradePipPackage('blues-lib', proxy)
+    console.log(`  ✓ blues-lib 升级完成`)
+
+    console.log('\n========== 步骤 4/4: ww init -u ==========')
+    execSync('ww init -u', { encoding: 'utf8', stdio: 'inherit' })
+
+    output({ action: 'upgrade', bluesLib: blue, init: 'ww init -u' })
   }
 
-  async _upgrade(parsed) {
+  /**
+   * 将 NPM_REGISTRY / PIP_REGISTRY / CFT_REGISTRY 写入 shell profile（与 SELENIUM_CFT_DIR 同机制）
+   * blues-lib 的相关命令依赖镜像，写入后保持与 opm 配置一致
+   */
+  _writeRegistryEnv() {
+    const entries = [
+      ['NPM_REGISTRY', getActiveRegistry('npm')],
+      ['PIP_REGISTRY', getActiveRegistry('pip')],
+      ['CFT_REGISTRY', getActiveRegistry('cft')],
+    ]
+    for (const [name, url] of entries) {
+      if (!url) continue
+      shell.setEnvVar(name, url)
+      console.log(`  [OK] ${name}=${url}`)
+    }
+  }
+
+  /**
+   * 环境检查：node >= defaultVersion、python >= defaultVersion
+   * @returns {Promise<{ node: Object, python: Object }>}
+   */
+  async _checkEnv() {
+    const nodeVersion = this._nodeVersion()
+    const nodeRequired = getConfig().node?.defaultVersion || '24'
+    const nodeSatisfied = nodeVersion !== '-' && this._compareVersion(nodeVersion, nodeRequired) >= 0
+
+    const pythonVersion = await this._pythonVersion()
+    const pythonRequired = getConfig().python?.defaultVersion || '3.12'
+    const pythonSatisfied = pythonVersion !== '-' && this._compareVersion(pythonVersion, pythonRequired) >= 0
+
+    const env = {
+      node: { provided: nodeVersion, required: nodeRequired, satisfied: nodeSatisfied },
+      python: { provided: pythonVersion, required: pythonRequired, satisfied: pythonSatisfied },
+    }
+    console.log(`  node:   ${nodeVersion} (required >= ${nodeRequired}) ${nodeSatisfied ? '✓' : '✗'}`)
+    console.log(`  python: ${pythonVersion} (required >= ${pythonRequired}) ${pythonSatisfied ? '✓' : '✗'}`)
+
+    return env
+  }
+
+  async _uninstall(parsed) {
     const proxy = this._resolveProxy(parsed)
-    await this._runBatch('upgrade', COMPONENTS, proxy, (key, p) => this._upgradeComponent(key, p))
+    const reversed = [...COMPONENTS].reverse()
+    await this._runBatch('uninstall', reversed, proxy, (key, p) => this._uninstallComponent(key, p))
   }
 
   /**
-   * 检查所有镜像可达性（HEAD 请求，不可达则抛错）
+   * 检查镜像可达性（HEAD 请求，不可达则抛错）
+   * 必查：npm / pip / cft（blues-lib 依赖，环境必然可用）
+   * 条件查：nvm + node（仅 env.node 不满足时）、uv（仅 env.python 不满足时）
    * @param {string} proxy
+   * @param {{ node: { satisfied: boolean }, python: { satisfied: boolean } } | null} env
+   *        null 表示不做条件检查（upgrade 场景，不装 runtime）
    */
-  async _checkMirrors(proxy) {
+  async _checkMirrors(proxy, env) {
     const tool = shell.getNetProbeTool()
     if (!tool) {
       console.log('  [WARN] No network probe tool (ping/curl/wget), skipping mirror check')
       return
     }
 
+    const needNode = env ? !env.node.satisfied : false
+    const needPython = env ? !env.python.satisfied : false
+
     const checks = [
       { name: 'npm', url: getActiveRegistry('npm') },
       { name: 'pip', url: getActiveRegistry('pip') },
+      { name: 'cft', url: getActiveRegistry('cft') },
+      ...(needNode ? [
+        { name: 'nvm', url: getActiveRegistry('nvm') },
+        { name: 'node', url: getActiveRegistry('node') },
+      ] : []),
+      ...(needPython ? [
+        { name: 'uv', url: getActiveRegistry('uv') },
+      ] : []),
     ]
 
-    if (!isNvmInstalled()) {
-      checks.push({ name: 'nvm', url: getActiveRegistry('nvm') })
-      checks.push({ name: 'node', url: getActiveRegistry('node') })
-    }
-
-    const tool2 = new CftGroup()
-    if (tool2._listInstalled().length === 0) {
-      const config = getConfig()
-      const cftUrl = config.cft?.registry?.active || config.cft?.registry?.npmmirror || ''
-      if (cftUrl) checks.push({ name: 'cft', url: cftUrl })
-    }
-
     let allOk = true
     for (const { name, url } of checks) {
       if (!url) {
@@ -275,269 +320,14 @@ export class WebworkGroup {
     }
   }
 
-  /**
-   * 运行时初始化（依赖 blues-lib 已安装）
-   * @param {object} parsed
-   */
-  async _init(parsed) {
-    const steps = [
-      { name: 'config', cmd: 'ww config init', required: true },
-      { name: 'sqlite', cmd: 'ww sqlite init', required: true },
-      { name: 'web', cmd: 'ww web init', required: true, hint: 'Start web service :7901' },
-    ]
-
-    for (const step of steps) {
-      console.log(`  [INIT] ${step.name}...`)
-      try {
-        execSync(step.cmd, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
-        console.log(`  [OK] ${step.name}`)
-        if (step.name === 'config') {
-          this._writeRuntimePaths()
-        }
-      } catch (err) {
-        if (step.required) {
-          throw new Error(`${step.name} init failed: ${err.message}`)
-        }
-        console.error(`  [WARN] ${step.name}: ${err.message}`)
-      }
-    }
-
-    await this._summary()
-  }
-
-  /**
-   * 将 cft/harness 的实际安装路径写入 webwork.json5（替代 post.py 的配置集成）
-   * 在 ww config init 之后执行，确保 webwork.json5 已存在
-   */
-  _writeRuntimePaths() {
-    const configDir = getXdgConfigDir('webwork')
-    let configPath = null
-    for (const fname of ['webwork.json5', 'webwork.json']) {
-      const p = path.join(configDir, fname)
-      if (fs.existsSync(p)) { configPath = p; break }
-    }
-    if (!configPath) {
-      console.log('  [SKIP] webwork.json5 not found, skip runtime paths')
-      return
-    }
-
-    let cfg
-    try {
-      cfg = JSON.parse(fs.readFileSync(configPath, 'utf8'))
-    } catch {
-      console.log('  [SKIP] webwork.json5 parse failed, skip runtime paths')
-      return
-    }
-
-    let changed = false
-
-    const cft = new CftGroup()
-    const cftActive = cft._readActive()
-    if (cftActive) {
-      const cftPath = cft._versionRoot(cftActive)
-      if (fs.existsSync(path.join(cftPath, 'installed.json'))) {
-        cfg.webdriver = cfg.webdriver || {}
-        cfg.webdriver.chromium = cfg.webdriver.chromium || {}
-        cfg.webdriver.chromium.cft = cfg.webdriver.chromium.cft || {}
-        cfg.webdriver.chromium.cft.location = cftPath
-        console.log(`  [OK] webdriver.chromium.cft.location = ${cftPath}`)
-        changed = true
-      }
-    }
-
-    try {
-      const npmRoot = execSync('npm root -g', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim()
-      const harnessDir = path.join(npmRoot, '@wwkit', 'harness')
-      if (fs.existsSync(harnessDir)) {
-        cfg.plugin = cfg.plugin || {}
-        cfg.plugin.opencode = cfg.plugin.opencode || {}
-        cfg.plugin.opencode.config_dir = harnessDir
-        console.log(`  [OK] plugin.opencode.config_dir = ${harnessDir}`)
-        changed = true
-      }
-    } catch {}
-
-    if (changed) {
-      fs.writeFileSync(configPath, JSON.stringify(cfg, null, 2), 'utf8')
-      console.log('  [OK] webwork.json5 updated with runtime paths')
-    }
-  }
-
-  /**
-   * 打印安装状态汇总（对齐 ww init 的 _step_summary）
-   */
-  async _summary() {
-    console.log('  [SUMMARY]')
-    console.log(`    OS:           ${process.platform} ${process.arch}`)
-    console.log(`    Node:         ${process.version}`)
-    try {
-      const npmVer = execSync('npm --version', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim()
-      console.log(`    npm:          ${npmVer}`)
-    } catch {}
-    console.log('  [Components]')
-    for (const { key, label } of COMPONENTS) {
-      try {
-        const installed = await this._isComponentInstalled(key)
-        const version = await this._getComponentVersion(key)
-        console.log(`    ${label.padEnd(14)} ${version || '-'} ${installed ? '✓' : '✗'}`)
-      } catch {
-        console.log(`    ${label.padEnd(14)} - ?`)
-      }
-    }
-    console.log('  [Config]')
-    try {
-      const npmRegistry = getActiveRegistry('npm')
-      console.log(`    npm mirror:   ${npmRegistry || '(未配置)'}`)
-    } catch {}
-  }
-
-  async _isComponentInstalled(key) {
-    switch (key) {
-      case 'python': return this._pythonInstalled()
-      case 'blues-lib': return await this._pipInstalled('blues-lib')
-      case 'cft': return this._cftInstalled()
-      case 'node': return this._nodeInstalled()
-      case 'opencode': return await this._npmInstalled(NPM_PACKAGES.opencode)
-      case 'harness': return await this._npmInstalled(NPM_PACKAGES.harness)
-      case 'sshproxy': return await this._npmInstalled(NPM_PACKAGES.sshproxy)
-      default: return false
-    }
-  }
-
-  async _getComponentVersion(key) {
-    switch (key) {
-      case 'python': return await this._pythonVersion()
-      case 'blues-lib': return await this._pipVersion('blues-lib')
-      case 'cft': return this._cftVersion()
-      case 'node': return this._nodeVersion()
-      case 'opencode': return await this._npmVersion(NPM_PACKAGES.opencode)
-      case 'harness': return await this._npmVersion(NPM_PACKAGES.harness)
-      case 'sshproxy': return await this._npmVersion(NPM_PACKAGES.sshproxy)
-      default: return '-'
-    }
-  }
-
-  /**
-   * 验证安装结果
-   * @param {object} parsed
-   */
-  async _verify(parsed) {
-    console.log('  [VERIFY] doctor (ww doctor)...')
-    try {
-      execSync('ww doctor', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
-      console.log('  [OK] doctor')
-    } catch (err) {
-      const out = err.stdout ? err.stdout.toString().trim() : ''
-      console.error(`  [WARN] doctor:\n${out || err.message}`)
-    }
-
-    const checks = [
-      { name: 'sqlite', cmd: 'ww sqlite debug', pattern: /访问成功|ok|success/i },
-      { name: 'run', cmd: 'ww run debug', pattern: /run debug/i },
-      { name: 'web', cmd: 'ww web status', pattern: /running/i, optional: true },
-    ]
-
-    for (const check of checks) {
-      console.log(`  [VERIFY] ${check.name}...`)
-      try {
-        const out = execSync(check.cmd, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
-        if (check.pattern.test(out)) {
-          console.log(`  [OK] ${check.name}`)
-        } else {
-          if (check.optional) {
-            console.log(`  [WARN] ${check.name}: not running (optional)`)
-          } else {
-            console.error(`  [FAIL] ${check.name}: output doesn't match expected pattern`)
-          }
-        }
-      } catch (err) {
-        if (check.optional) {
-          console.log(`  [WARN] ${check.name}: ${err.message}`)
-        } else {
-          console.error(`  [FAIL] ${check.name}: ${err.message}`)
-        }
-      }
-    }
-
-    try {
-      const staticIndex = execSync(
-        `python3 -c "import os, blues_lib.web; print(os.path.join(os.path.dirname(blues_lib.web.__file__), 'static', 'index.html'))"`,
-        { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }
-      ).trim()
-      if (staticIndex) {
-        console.log(`  [VERIFY] webdriver...`)
-        const out = execSync(`ww webdriver debug -u file://${staticIndex} --headless`, {
-          encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 60000
-        })
-        if (/webwork/i.test(out)) {
-          console.log(`  [OK] webdriver`)
-        } else {
-          console.error(`  [FAIL] webdriver: output doesn't contain 'webwork'`)
-        }
-      }
-    } catch (err) {
-      console.error(`  [WARN] webdriver: ${err.message}`)
-    }
-  }
-
-  async _installComponent(key, proxy) {
-    switch (key) {
-      case 'python':
-        return this._installPython(proxy)
-      case 'blues-lib':
-        return this._installPipPackage('blues-lib', proxy)
-      case 'cft':
-        return this._installCft(proxy)
-      case 'node':
-        return this._installNode(proxy)
-      case 'opencode':
-        return this._installNpmPackage(NPM_PACKAGES.opencode, proxy)
-      case 'harness':
-        return this._installNpmPackage(NPM_PACKAGES.harness, proxy)
-      case 'sshproxy':
-        return this._installNpmPackage(NPM_PACKAGES.sshproxy, proxy)
-      default:
-        throw new Error(`Unknown component: ${key}`)
-    }
-  }
-
   async _uninstallComponent(key, proxy) {
     switch (key) {
       case 'python':
         return { action: 'skipped', reason: 'python is a system dependency, not uninstalled' }
-      case 'blues-lib':
-        return this._uninstallPipPackage('blues-lib')
-      case 'cft':
-        return this._uninstallCft()
       case 'node':
         return { action: 'skipped', reason: 'node is a system dependency, not uninstalled' }
-      case 'opencode':
-        return this._uninstallNpmPackage(NPM_PACKAGES.opencode)
-      case 'harness':
-        return this._uninstallNpmPackage(NPM_PACKAGES.harness)
-      case 'sshproxy':
-        return this._uninstallNpmPackage(NPM_PACKAGES.sshproxy)
-      default:
-        throw new Error(`Unknown component: ${key}`)
-    }
-  }
-
-  async _upgradeComponent(key, proxy) {
-    switch (key) {
-      case 'python':
-        return this._upgradePython(proxy)
       case 'blues-lib':
-        return this._upgradePipPackage('blues-lib', proxy)
-      case 'cft':
-        return this._installCft(proxy)
-      case 'node':
-        return this._upgradeNode(proxy)
-      case 'opencode':
-        return this._upgradeNpmPackage(NPM_PACKAGES.opencode, proxy)
-      case 'harness':
-        return this._upgradeNpmPackage(NPM_PACKAGES.harness, proxy)
-      case 'sshproxy':
-        return this._upgradeNpmPackage(NPM_PACKAGES.sshproxy, proxy)
+        return this._uninstallPipPackage('blues-lib')
       default:
         throw new Error(`Unknown component: ${key}`)
     }
@@ -609,22 +399,6 @@ export class WebworkGroup {
     return { action: 'installed', version: defaultVersion }
   }
 
-  async _upgradePython(proxy) {
-    if (!isUvInstalled()) {
-      console.log('  uv not found, installing uv...')
-      installUv(proxy)
-    }
-    const mgr = new PythonManager()
-    const out = mgr._exec(mgr.cfg.listRemoteCmd, { allowNonZero: true, proxy })
-    const versions = mgr._parseRemote(out)
-    const latest = versions[versions.length - 1]
-    if (!latest) {
-      return { action: 'skipped', reason: 'no remote version found' }
-    }
-    mgr._execInherit(mgr.cfg.installCmd(latest), { proxy })
-    return { action: 'upgraded', version: latest }
-  }
-
   _nodeInstalled() {
     return this._nodeVersion() !== '-'
   }
@@ -672,25 +446,6 @@ export class WebworkGroup {
     return { action: 'installed', version: defaultVersion }
   }
 
-  async _upgradeNode(proxy) {
-    if (!isNvmInstalled()) {
-      console.log('  nvm not found, installing nvm...')
-      installNvm(proxy)
-    }
-    const mgr = new NodeManager()
-    const out = mgr._exec(mgr.cfg.listRemoteCmd, { allowNonZero: true, proxy })
-    const versions = mgr._parseRemote(out)
-    const latest = versions[versions.length - 1]
-    if (!latest) {
-      return { action: 'skipped', reason: 'no remote version found' }
-    }
-    const ver = latest.replace(/^v/, '')
-    mgr._execInherit(mgr.cfg.installCmd(ver), { proxy })
-    mgr._execInherit(mgr.cfg.useCmd(ver), { proxy })
-    mgr._execInherit(mgr.cfg.defaultCmd(ver), { proxy })
-    return { action: 'upgraded', version: ver }
-  }
-
   async _pipInstalled(name) {
     const pip = new PipManager()
     const result = await pip.isInstalled(name, { global: true })
@@ -728,90 +483,6 @@ export class WebworkGroup {
     return pip.uninstall(name, { global: true })
   }
 
-  _cftInstalled() {
-    const cft = new CftGroup()
-    const list = cft._listInstalled()
-    return list.length > 0
-  }
-
-  _cftVersion() {
-    const cft = new CftGroup()
-    const active = cft._readActive()
-    return active || '-'
-  }
-
-  async _cftLatest(proxy) {
-    const cft = new CftGroup()
-    try {
-      const data = await cft._fetchVersions(proxy)
-      const versions = data.versions || []
-      return versions[versions.length - 1] || '-'
-    } catch {
-      return '-'
-    }
-  }
-
-  async _installCft(proxy) {
-    const cft = new CftGroup()
-    const version = cft.cfg.getDefaultVersion()
-    if (!version) {
-      throw new Error('No cft default version configured')
-    }
-    const existing = cft._readInstalledInfo(version)
-    if (existing) {
-      return { action: 'skipped', reason: `cft ${version} already installed`, version }
-    }
-    await cft._install([version])
-    return { action: 'installed', version }
-  }
-
-  async _uninstallCft() {
-    const cft = new CftGroup()
-    await cft._clear([])
-    return { action: 'uninstalled' }
-  }
-
-  async _npmInstalled(name) {
-    const npm = new NpmManager()
-    const result = await npm.isInstalled(name, { global: true })
-    return result.installed
-  }
-
-  async _npmVersion(name) {
-    const npm = new NpmManager()
-    const result = await npm.isInstalled(name, { global: true })
-    return result.version || '-'
-  }
-
-  async _npmLatest(name, proxy) {
-    const npm = new NpmManager()
-    try {
-      const data = await npm.searchPackage(name, null, { proxy })
-      return data.latest || '-'
-    } catch {
-      return '-'
-    }
-  }
-
-  async _installNpmPackage(name, proxy) {
-    const npm = new NpmManager()
-    const existing = await npm.isInstalled(name, { global: true })
-    if (existing.installed) {
-      return { action: 'skipped', reason: `${name} ${existing.version} already installed`, version: existing.version }
-    }
-    return npm.install(name, null, { global: true, proxy, allowScripts: true })
-  }
-
-  async _upgradeNpmPackage(name, proxy) {
-    const npm = new NpmManager()
-    return npm.upgrade(name, { global: true, proxy, allowScripts: true })
-  }
-
-  async _uninstallNpmPackage(name) {
-    const npm = new NpmManager()
-    return npm.uninstall(name, { global: true })
-  }
-
   printHelp() {
     const actionLines = Object.entries(ACTIONS)
       .map(([sig, { desc }]) => `  ${sig.padEnd(12)} ${desc}`)
@@ -820,7 +491,7 @@ export class WebworkGroup {
 Usage: opm webwork <action> [options]
 
 WebWork development environment orchestration.
-Components (in install order): python, blues-lib, cft, node, opencode, harness, sshproxy
+Components: python, node, blues-lib (plugins cft/opencode/harness/sshproxy handled by ww init)
 
 Actions:
 ${actionLines}
@@ -833,11 +504,9 @@ Examples:
   opm webwork version       Show installed versions of all components
   opm webwork versions      Show latest available versions (remote)
   opm webwork installed     Show install status of all components
-  opm webwork install       Full install (mirror check + components + init + verify)
-  opm webwork init          Initialize runtime only (config/webdriver/opencode/sqlite)
-  opm webwork verify        Verify installation only
+  opm webwork install       Mirror check + ensure runtime + registry env + blues-lib + ww init
   opm webwork uninstall     Uninstall all components in reverse order
-  opm webwork upgrade       Upgrade all components to latest
+  opm webwork upgrade       Upgrade blues-lib + ww init -u
 `)
   }
 }