@wwkit/opm 1.0.1

package/src/cli/groups/config.js

@@ -0,0 +1,78 @@
+/**
+ * 配置命令组
+ *
+ * 显示合并后的 opm 配置文件（内置默认 + 用户 ~/.config/opm/config.json5）。
+ * 可用段名由 getConfig() 动态生成（top-level 段 + 含 registry 的 `.registry` 子段），
+ * 新增配置段无需改动本文件。
+ */
+
+import { parseFlags } from '../helpers/args.js'
+import { getConfig, getSection } from '../../config.js'
+import { output } from '../../formatter.js'
+
+/**
+ * 由配置动态生成可用段名列表
+ * @param {object} config
+ * @returns {string[]}
+ */
+function sectionNames(config) {
+  const names = []
+  for (const key of Object.keys(config)) {
+    names.push(key)
+    if (config[key] && typeof config[key] === 'object' && config[key].registry) {
+      names.push(`${key}.registry`)
+    }
+  }
+  return names
+}
+
+export class ConfigGroup {
+  constructor() {
+    this.name = 'config'
+    this.desc = 'Show merged config (proxy + all registry sections)'
+  }
+
+  async run(argv) {
+    const parsed = parseFlags(argv)
+
+    const config = await getConfig()
+    const section = parsed.positional.join('.')
+    const result = getSection(config, section)
+    if (result === undefined) {
+      console.error(`Unknown config section: ${section || '(empty)'}`)
+      console.error(`Available sections: ${sectionNames(config).join(', ')}`)
+      process.exit(1)
+    }
+    output(result)
+  }
+
+  printHelp() {
+    const sectionLines = sectionNames(getConfig())
+      .map((s) => {
+        const desc = s === 'proxy'
+          ? 'Show proxy presets + active (empty = no proxy)'
+          : (s.endsWith('.registry')
+            ? `Show ${s.slice(0, -9)} registry presets + active`
+            : `Show ${s} section`)
+        return `  ${s.padEnd(30)} ${desc}`
+      })
+      .join('\n')
+
+    console.log(`
+Usage: opm config [section] [options]
+
+Sections:
+${sectionLines}
+
+Config file: ~/.config/opm/config.json5 (merged with builtin defaults)
+
+Options:
+  -h, --help      Show help
+
+Examples:
+  opm config
+  opm config proxy
+  opm config npm.registry
+`)
+  }
+}

package/src/cli/groups/ensure.js

@@ -0,0 +1,96 @@
+/**
+ * ensure 命令组 — 确保运行时已安装（组合现有命令）
+ *
+ * opm ensure <node|php|python> [version]
+ *
+ * 逻辑：
+ * 1. 检查当前是否已满足（已安装，且若指定 version 则该版本已安装）
+ * 2. 不满足则安装（自动安装版本管理器 + 安装版本）
+ */
+
+import { parseFlags } from '../helpers/args.js'
+import { NodeManager } from '../../managers/node.js'
+import { PhpManager } from '../../managers/php.js'
+import { PythonManager } from '../../managers/python.js'
+import { getActiveProxy } from '../../config.js'
+import { output } from '../../formatter.js'
+
+const RUNTIMES = {
+  node: () => new NodeManager(),
+  php: () => new PhpManager(),
+  python: () => new PythonManager(),
+}
+
+export class EnsureGroup {
+  constructor() {
+    this.name = 'ensure'
+    this.desc = 'Ensure a runtime is installed (node/php/python)'
+  }
+
+  async run(argv) {
+    const parsed = parseFlags(argv)
+    const [runtime, version] = parsed.positional
+
+    if (!runtime || runtime === '-h' || runtime === '--help' || runtime === 'help' || !RUNTIMES[runtime]) {
+      if (runtime && runtime !== '-h' && runtime !== '--help' && runtime !== 'help') {
+        console.error(`Unknown runtime: ${runtime}`)
+      }
+      this.printHelp()
+      process.exit(runtime && RUNTIMES[runtime] === undefined ? 1 : 0)
+    }
+
+    let proxy = parsed.flags.proxy || parsed.flags.p || ''
+    if (proxy === 'true') proxy = ''
+    if (!proxy) proxy = getActiveProxy()
+
+    const manager = RUNTIMES[runtime]()
+
+    let satisfied = false
+    let currentVersion = ''
+
+    if (version) {
+      const result = await manager.isInstalled(version)
+      satisfied = result.installed
+      if (satisfied) currentVersion = result.version || version
+    } else {
+      const result = await manager.getVersion()
+      satisfied = result.installed
+      currentVersion = result.version || ''
+    }
+
+    if (satisfied) {
+      output({ name: runtime, version: currentVersion, ensured: true, satisfied: true })
+      return
+    }
+
+    const installVersion = version || (manager.getDefaultVersion ? manager.getDefaultVersion() : '')
+    if (!installVersion) {
+      console.error(`No version specified and no defaultVersion configured for ${runtime}`)
+      process.exit(1)
+    }
+
+    await manager.install(runtime, installVersion, { proxy })
+    output({ name: runtime, version: installVersion, ensured: true, satisfied: false, action: 'installed' })
+  }
+
+  printHelp() {
+    console.log(`
+Usage: opm ensure <runtime> [version] [options]
+
+Runtimes:
+  node                    Ensure Node.js is installed
+  php                     Ensure PHP is installed
+  python                  Ensure Python is installed
+
+Options:
+  -p, --proxy <url>  Proxy address (for install)
+  -h, --help          Show this help
+
+Examples:
+  opm ensure node             Ensure node is installed (uses defaultVersion from config)
+  opm ensure node 22          Ensure node 22 is installed
+  opm ensure python 3.12      Ensure python 3.12 is installed
+  opm ensure php 8.3          Ensure php 8.3 is installed
+`)
+  }
+}

package/src/cli/groups/homebrew.js

@@ -0,0 +1,73 @@
+/**
+ * homebrew 命令组 — 管理 Homebrew（brew）自身
+ *
+ * Homebrew 无独立版本管理器，通过官方 shell 脚本安装/卸载。
+ * 安装方式：curl 管道执行 install.sh（与 uv 同模式）；
+ * upgrade = brew update；uninstall = curl 管道执行 uninstall.sh。
+ * brew 自身无镜像源（包镜像走 opm brew registry），故无 registry action。
+ * 仅支持 macOS / Linux，Windows 不支持。
+ */
+
+import { execSync } from 'node:child_process'
+import fs from 'node:fs'
+import { ToolManagerGroup } from './version-manager.js'
+import { getBrewBin, isHomebrewInstalled, installHomebrew } from '../../managers/brew.js'
+
+const BREW_UNINSTALL_URL = 'https://raw.githubusercontent.com/Homebrew/uninstall/HEAD/uninstall.sh'
+
+/**
+ * 获取 brew 安装根目录
+ * @returns {string}
+ */
+function getBrewRoot() {
+  const bin = getBrewBin()
+  if (bin === 'brew') return ''
+  return bin.replace(/\/bin\/brew$/, '')
+}
+
+export class HomebrewGroup extends ToolManagerGroup {
+  constructor() {
+    super({
+      name: 'homebrew',
+      desc: 'Homebrew manager (install/upgrade/uninstall brew itself)',
+      hasRegistry: false,
+      isInstalled: () => isHomebrewInstalled(),
+      getPath: () => getBrewRoot(),
+      versionCmd: () => `${getBrewBin()} --version`,
+      parseVersion: (out) => {
+        const m = out.trim().match(/^Homebrew\s+(\S+)/)
+        return m ? m[1] : out.trim()
+      },
+      install: () => installHomebrew(),
+      upgrade: () => {
+        execSync(`${getBrewBin()} update`, { stdio: 'inherit' })
+        return { action: 'upgraded' }
+      },
+      uninstall: () => {
+        if (process.platform === 'win32') {
+          throw new Error('Homebrew is not supported on Windows')
+        }
+        execSync(`curl -fsSL "${BREW_UNINSTALL_URL}" | bash`, { stdio: 'inherit', shell: true })
+        return { action: 'uninstalled' }
+      },
+      usage: 'opm homebrew <action> [options]',
+      actions: [
+        ['version', 'Show Homebrew version'],
+        ['installed', 'Check if Homebrew is installed'],
+        ['install', 'Install Homebrew (curl installer from GitHub)'],
+        ['upgrade', 'Update Homebrew (brew update)'],
+        ['uninstall', 'Remove Homebrew (curl uninstaller from GitHub)'],
+        ['dir', 'Show Homebrew install directory'],
+        ['help', 'Show this help'],
+      ],
+      examples: [
+        'opm homebrew version',
+        'opm homebrew installed',
+        'opm homebrew install',
+        'opm homebrew upgrade',
+        'opm homebrew dir',
+        'opm homebrew uninstall',
+      ],
+    })
+  }
+}

package/src/cli/groups/nvm.js

@@ -0,0 +1,73 @@
+/**
+ * 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 } 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(),
+      install: () => installNvm(),
+      upgrade: () => {
+        execSync(`cd "${getNvmDir()}" && git remote set-url origin "${getActiveRegistry('nvm')}" && git pull --tags`, {
+          stdio: 'inherit',
+          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'],
+        ['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',
+      ],
+    })
+  }
+}