@wwkit/opm 1.0.3 → 1.0.4

package/src/tools/webwork/index.js

@@ -0,0 +1,558 @@
+/**
+ * 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，已安装则跳过）
+ *
+ * 命令: version / versions / installed / install / uninstall / upgrade / help
+ */
+
+import { execSync } from 'node:child_process'
+
+import { parseFlags } from '../../cli/helpers/args.js'
+import { output } from '../../formatter.js'
+import { getActiveProxy, getConfig } 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'
+
+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' },
+]
+
+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 in order (python -> blues-lib -> cft -> node -> opencode -> harness -> sshproxy)' },
+  uninstall: { desc: 'Uninstall all components in reverse order (sshproxy -> harness -> opencode -> node -> cft -> blues-lib)' },
+  upgrade:   { desc: 'Upgrade all components to latest' },
+  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)'
+  }
+
+  async run(argv) {
+    const [action, ...rest] = argv
+
+    if (!action || action === '-h' || action === '--help' || action === 'help') {
+      this.printHelp()
+      return
+    }
+
+    const parsed = parseFlags(rest)
+
+    switch (action) {
+      case 'version':
+        return this._version()
+      case 'versions':
+        return this._versions(parsed)
+      case 'installed':
+        return this._installed()
+      case 'install':
+        return this._install(parsed)
+      case 'uninstall':
+        return this._uninstall(parsed)
+      case 'upgrade':
+        return this._upgrade(parsed)
+      default:
+        console.error(`Unknown action: ${action}`)
+        this.printHelp()
+        process.exit(1)
+    }
+  }
+
+  _resolveProxy(parsed) {
+    let proxy = parsed.flags.p || parsed.flags.proxy || ''
+    if (proxy === 'true') proxy = ''
+    if (!proxy) proxy = getActiveProxy()
+    return proxy
+  }
+
+  async _version() {
+    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)
+
+    output(result)
+  }
+
+  async _versions(parsed) {
+    const proxy = this._resolveProxy(parsed)
+    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)
+
+    output(result)
+  }
+
+  async _installed() {
+    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)
+
+    output(result)
+  }
+
+  /**
+   * 批量执行组件操作（install/uninstall/upgrade 共用）
+   * 每步打印 [n/total] 组件名 + 跳过/成功/失败日志，最后汇总
+   * @param {string} verb - install|uninstall|upgrade
+   * @param {Array} components - 组件列表
+   * @param {string} proxy - 代理地址
+   * @param {Function} fn - (key, proxy) => Promise<result>
+   * @returns {Promise<void>}
+   * @private
+   */
+  async _runBatch(verb, components, proxy, fn) {
+    const results = []
+    const total = components.length
+    const verbUpper = verb.charAt(0).toUpperCase() + verb.slice(1)
+
+    for (let i = 0; i < components.length; i++) {
+      const { key, label } = components[i]
+      console.log(`\n[${i + 1}/${total}] ${verbUpper} ${label}...`)
+      try {
+        const r = await fn(key, proxy)
+        const action = r.action || 'ok'
+        if (action === 'skipped') {
+          console.log(`  → skipped: ${r.reason || 'already satisfied'}`)
+        } else {
+          console.log(`  ✓ ${label} ${action}` + (r.version ? ` ${r.version}` : ''))
+        }
+        results.push({ component: key, status: 'ok', ...r })
+      } catch (err) {
+        results.push({ component: key, status: 'failed', error: err.message })
+        console.error(`  ✗ ${label} failed: ${err.message}`)
+      }
+    }
+
+    const ok = results.filter((r) => r.status === 'ok').length
+    const failed = results.filter((r) => r.status === 'failed').length
+    const skipped = results.filter((r) => r.action === 'skipped').length
+    console.log(`\n${verbUpper} summary: ${ok} ok, ${skipped} skipped, ${failed} failed`)
+
+    output({ action: verb, results, summary: { ok, skipped, failed, total } })
+
+    if (failed > 0) {
+      process.exit(1)
+    }
+  }
+
+  async _install(parsed) {
+    const proxy = this._resolveProxy(parsed)
+    await this._runBatch('install', COMPONENTS, proxy, (key, p) => this._installComponent(key, p))
+  }
+
+  async _uninstall(parsed) {
+    const proxy = this._resolveProxy(parsed)
+    const reversed = [...COMPONENTS].reverse()
+    await this._runBatch('uninstall', reversed, proxy, (key, p) => this._uninstallComponent(key, p))
+  }
+
+  async _upgrade(parsed) {
+    const proxy = this._resolveProxy(parsed)
+    await this._runBatch('upgrade', COMPONENTS, proxy, (key, p) => this._upgradeComponent(key, p))
+  }
+
+  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)
+      default:
+        throw new Error(`Unknown component: ${key}`)
+    }
+  }
+
+  _pythonInstalled() {
+    return this._pythonVersion() !== '-'
+  }
+
+  /**
+   * 比较两个语义化版本号
+   * @param {string} a - 版本号 a（如 "3.12.1"）
+   * @param {string} b - 版本号 b（如 "3.12"）
+   * @returns {number} -1 (a<b), 0 (a==b), 1 (a>b)
+   * @private
+   */
+  _compareVersion(a, b) {
+    const pa = a.split('.').map((n) => parseInt(n, 10) || 0)
+    const pb = b.split('.').map((n) => parseInt(n, 10) || 0)
+    const len = Math.max(pa.length, pb.length)
+    for (let i = 0; i < len; i++) {
+      const va = pa[i] ?? 0
+      const vb = pb[i] ?? 0
+      if (va < vb) return -1
+      if (va > vb) return 1
+    }
+    return 0
+  }
+
+  async _pythonVersion() {
+    for (const cmd of ['python3', 'python']) {
+      try {
+        const out = execSync(`${cmd} --version`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+        const m = out.trim().match(/Python\s+(\d+\.\d+\.\d+)/)
+        if (m) return m[1]
+      } catch {}
+    }
+    return '-'
+  }
+
+  async _pythonLatest(proxy) {
+    const mgr = new PythonManager()
+    try {
+      const out = mgr._exec(mgr.cfg.listRemoteCmd, { allowNonZero: true, proxy })
+      const versions = mgr._parseRemote(out)
+      return versions[versions.length - 1] || '-'
+    } catch {
+      return '-'
+    }
+  }
+
+  async _installPython(proxy) {
+    const defaultVersion = getConfig().python?.defaultVersion || '3.12'
+    const installed = await this._pythonVersion()
+    if (installed !== '-' && this._compareVersion(installed, defaultVersion) >= 0) {
+      return { action: 'skipped', reason: `python ${installed} >= ${defaultVersion}`, version: installed }
+    }
+    if (installed !== '-') {
+      console.log(`  current: ${installed}, required: >= ${defaultVersion}`)
+    } else {
+      console.log(`  python not found, installing ${defaultVersion}`)
+    }
+    if (!isUvInstalled()) {
+      console.log('  uv not found, installing uv...')
+      installUv(proxy)
+    }
+    const mgr = new PythonManager()
+    mgr._execInherit(mgr.cfg.installCmd(defaultVersion), { proxy })
+    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() !== '-'
+  }
+
+  _nodeVersion() {
+    try {
+      const out = execSync('node --version', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+      const m = out.trim().match(/v(\d+\.\d+\.\d+)/)
+      if (m) return m[1]
+    } catch {}
+    return '-'
+  }
+
+  async _nodeLatest(proxy) {
+    const mgr = new NodeManager()
+    if (!isNvmInstalled()) return '-'
+    try {
+      const out = mgr._exec(mgr.cfg.listRemoteCmd, { allowNonZero: true, proxy })
+      const versions = mgr._parseRemote(out)
+      return versions[versions.length - 1]?.replace(/^v/, '') || '-'
+    } catch {
+      return '-'
+    }
+  }
+
+  async _installNode(proxy) {
+    const defaultVersion = getConfig().node?.defaultVersion || '24'
+    const installed = this._nodeVersion()
+    if (installed !== '-' && this._compareVersion(installed, defaultVersion) >= 0) {
+      return { action: 'skipped', reason: `node ${installed} >= ${defaultVersion}`, version: installed }
+    }
+    if (installed !== '-') {
+      console.log(`  current: ${installed}, required: >= ${defaultVersion}`)
+    } else {
+      console.log(`  node not found, installing ${defaultVersion}`)
+    }
+    if (!isNvmInstalled()) {
+      console.log('  nvm not found, installing nvm...')
+      installNvm(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 }
+  }
+
+  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 })
+    return result.installed
+  }
+
+  async _pipVersion(name) {
+    const pip = new PipManager()
+    const result = await pip.isInstalled(name, { global: true })
+    return result.version || '-'
+  }
+
+  async _pipLatest(name, proxy) {
+    const pip = new PipManager()
+    const result = await pip.searchPackage(name, null, { proxy })
+    return result.latest || '-'
+  }
+
+  async _installPipPackage(name, proxy) {
+    const pip = new PipManager()
+    const existing = await pip.isInstalled(name, { global: true })
+    if (existing.installed) {
+      return { action: 'skipped', reason: `${name} ${existing.version} already installed`, version: existing.version }
+    }
+    return pip.install(name, null, { global: true, proxy })
+  }
+
+  async _upgradePipPackage(name, proxy) {
+    const pip = new PipManager()
+    return pip.upgrade(name, { global: true, proxy })
+  }
+
+  async _uninstallPipPackage(name) {
+    const pip = new PipManager()
+    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 })
+  }
+
+  async _upgradeNpmPackage(name, proxy) {
+    const npm = new NpmManager()
+    return npm.upgrade(name, { global: true, proxy })
+  }
+
+  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}`)
+      .join('\n')
+    console.log(`
+Usage: opm webwork <action> [options]
+
+WebWork development environment orchestration.
+Components (in install order): python, blues-lib, cft, node, opencode, harness, sshproxy
+
+Actions:
+${actionLines}
+
+Options:
+  -p, --proxy <url>  Proxy for install/upgrade/versions (overrides config proxy.active)
+  -h, --help         Show this help
+
+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       Install all components in order
+  opm webwork uninstall     Uninstall all components in reverse order
+  opm webwork upgrade       Upgrade all components to latest
+`)
+  }
+}