@wwkit/opm 1.0.8 → 1.0.10

package/src/managers/base.js

@@ -81,13 +81,27 @@ export class PackageManager {
   /**
    * 查询包是否已安装
    * @param {string} name - 包名
-   * @param {{ global?: boolean }} [opts] - 选项
-   * @returns {Promise<InstalledResult>}
+   * @param {{ global?: boolean }} [opts] - 选项；global: true = 全局/系统作用域，false/缺省 = 项目/当前作用域
+   * @returns {Promise<InstalledResult>} - name/installed/version?/path?；单作用域管理器对不支持的作用域返回 { name, installed: false, hint }
    */
   async isInstalled(name, opts) {
     throw new Error(`${this.name}: isInstalled not implemented`)
   }
 
+  /**
+   * 查询包在全局与项目双作用域的安装状态
+   * @param {string} name - 包名
+   * @param {{ proxy?: string }} [opts] - 选项
+   * @returns {Promise<{ name: string, global: InstalledResult, project: InstalledResult }>}
+   */
+  async scopedInstalled(name, opts = {}) {
+    const [global, project] = await Promise.all([
+      this.isInstalled(name, { ...opts, global: true }),
+      this.isInstalled(name, { ...opts, global: false }),
+    ])
+    return { name, global, project }
+  }
+
   /**
    * 查询包详情
    * @param {string} name - 包名
@@ -110,6 +124,7 @@ export class PackageManager {
 
   /**
    * 列出所有已安装包
+   * // 仅运行时管理器（node/php/python）实现；包管理器不再实现此方法
    * @param {{ global?: boolean }} [opts] - 选项
    * @returns {Promise<InstalledItem[]>}
    */

package/src/managers/brew.js

@@ -299,6 +299,9 @@ export class BrewManager extends PackageManager {
   }
 
   async isInstalled(name, opts = {}) {
+    if (opts.global === false) {
+      return { name, installed: false, hint: 'no project scope (system-level manager)' }
+    }
     const out = this._exec(['list', '--versions', name], { allowNonZero: true })
     const items = this._parseListVersions(out)
     const hit = items.find((i) => i.name === name)
@@ -337,11 +340,6 @@ export class BrewManager extends PackageManager {
     return { name, versions, registry }
   }
 
-  async listInstalled(opts = {}) {
-    const out = this._exec(['list', '--versions'], { allowNonZero: true })
-    return this._parseListVersions(out)
-  }
-
   async listOutdated(opts = {}) {
     const out = this._exec(['outdated', '--json=v2'], { allowNonZero: true, proxy: opts.proxy })
     return this._parseOutdatedJson(out)

package/src/managers/bun.js

@@ -269,24 +269,6 @@ export class BunManager extends PackageManager {
     return { name, versions, registry }
   }
 
-  async listInstalled(opts = {}) {
-    const args = ['pm', 'ls']
-    if (opts.global) args.push('-g')
-    try {
-      const out = this._exec(args, { allowNonZero: true })
-      const items = []
-      for (const line of out.split('\n')) {
-        const m = line.match(/([^\s]+)@([\d.]+)/)
-        if (m) {
-          items.push({ name: m[1], version: m[2], ...(opts.global ? { global: true } : {}) })
-        }
-      }
-      return items
-    } catch {
-      return []
-    }
-  }
-
   async listOutdated(opts = {}) {
     const args = ['outdated']
     if (opts.global) args.push('-g')

package/src/managers/composer.js

@@ -11,6 +11,7 @@
 
 import { execSync, spawnSync } from 'node:child_process'
 import fs from 'node:fs'
+import os from 'node:os'
 import path from 'node:path'
 import { PackageManager } from './base.js'
 import { fetchText } from './http.js'
@@ -197,7 +198,71 @@ export class ComposerManager extends PackageManager {
     }
   }
 
+  /**
+   * 获取 composer 全局 home 目录
+   *
+   * 优先级：$COMPOSER_HOME → ~/.config/composer → ~/.composer（旧版）
+   * @returns {string}
+   * @private
+   */
+  _getComposerHome() {
+    if (process.env.COMPOSER_HOME) return process.env.COMPOSER_HOME
+    const xdg = path.join(os.homedir(), '.config', 'composer')
+    if (fs.existsSync(xdg)) return xdg
+    return path.join(os.homedir(), '.composer')
+  }
+
+  /**
+   * 读取 composer 全局 installed.json
+   * @returns {object[]|null}
+   * @private
+   */
+  _readGlobalInstalledJson() {
+    const home = this._getComposerHome()
+    const p = path.join(home, 'vendor', 'composer', 'installed.json')
+    if (!fs.existsSync(p)) return null
+    try {
+      const data = JSON.parse(fs.readFileSync(p, 'utf8'))
+      return Array.isArray(data.packages) ? data.packages : null
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * 通过 PATH 查找 bin 路径（Linux: which / Windows: where）
+   * @param {string} name - bin 名
+   * @returns {string|null} bin 路径或 null
+   * @private
+   */
+  _whichBin(name) {
+    const cmd = process.platform === 'win32' ? `where ${name}` : `which ${name}`
+    try {
+      const out = execSync(cmd, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+      const lines = out.trim().split(/\r?\n/).filter(Boolean)
+      return lines[0] || null
+    } catch {
+      return null
+    }
+  }
+
   async isInstalled(name, opts = {}) {
+    if (opts.global === true) {
+      const packages = this._readGlobalInstalledJson()
+      if (packages) {
+        const pkg = packages.find((p) => p.name === name)
+        if (pkg) {
+          return { name, installed: true, version: pkg.version || 'unknown', global: true }
+        }
+      }
+
+      const binPath = this._whichBin(name)
+      if (binPath) {
+        return { name, installed: true, global: true, path: binPath }
+      }
+
+      return { name, installed: false, global: true }
+    }
     const packages = this._readInstalledJson()
     if (packages) {
       const pkg = packages.find((p) => p.name === name)
@@ -233,15 +298,6 @@ export class ComposerManager extends PackageManager {
     return { name, versions, registry }
   }
 
-  async listInstalled(opts = {}) {
-    const packages = this._readInstalledJson()
-    if (!packages) return []
-    return packages.map((p) => ({
-      name: p.name,
-      version: p.version || 'unknown',
-    }))
-  }
-
   async listOutdated(opts = {}) {
     const out = this._exec(['outdated', '--format=json'], { allowNonZero: true, proxy: opts.proxy })
     try {

package/src/managers/dnf.js

@@ -240,6 +240,9 @@ export class DnfManager extends PackageManager {
   }
 
   async isInstalled(name, opts = {}) {
+    if (opts.global === false) {
+      return { name, installed: false, hint: 'no project scope (system-level manager)' }
+    }
     const args = ['repoquery', '--installed', '--qf', '%{VERSION}-%{RELEASE}', name]
     const out = this._exec(args, { allowNonZero: true })
     const versions = this._parseLines(out)
@@ -316,18 +319,6 @@ export class DnfManager extends PackageManager {
     return { name, versions, registry }
   }
 
-  async listInstalled(opts = {}) {
-    const out = this._exec(['repoquery', '--installed', '--qf', '%{NAME} %{VERSION}-%{RELEASE}'], { allowNonZero: true })
-    const items = []
-    for (const line of this._parseLines(out)) {
-      const parts = line.split(/\s+/)
-      if (parts.length >= 2) {
-        items.push({ name: parts[0], version: parts[1] })
-      }
-    }
-    return items
-  }
-
   async listOutdated(opts = {}) {
     const args = ['list', '--upgrades', ...this._proxyArgs(opts.proxy)]
     const out = this._exec(args, { allowNonZero: true })

package/src/managers/node.js

@@ -68,6 +68,22 @@ export function installNvm(proxy) {
   }
 }
 
+/**
+ * 解析 nvm ls 输出为已安装版本列表
+ * @param {string} out
+ * @returns {{ name: string, version: string, current: boolean }[]}
+ */
+export function parseNvmInstalled(out) {
+  const items = []
+  for (const line of out.split('\n')) {
+    const m = line.match(/^(->)?\s*v(\d+\.\d+\.\d+)\b/)
+    if (m) {
+      items.push({ name: `v${m[2]}`, version: m[2], current: !!m[1] })
+    }
+  }
+  return items
+}
+
 export class NodeManager extends RuntimeManager {
   constructor() {
     super({
@@ -127,14 +143,7 @@ export class NodeManager extends RuntimeManager {
    * @private
    */
   _parseInstalled(out) {
-    const items = []
-    for (const line of out.split('\n')) {
-      const m = line.match(/^(->)?\s*v(\d+\.\d+\.\d+)\b/)
-      if (m) {
-        items.push({ name: `v${m[2]}`, version: m[2], current: !!m[1] })
-      }
-    }
-    return items
+    return parseNvmInstalled(out)
   }
 
   /**

package/src/managers/npm.js

@@ -290,8 +290,31 @@ export class NpmManager extends PackageManager {
     return null
   }
 
+  /**
+   * 通过 PATH 查找 bin 路径（Linux: which / Windows: where）
+   * @param {string} name - bin 名
+   * @returns {string|null} bin 路径或 null
+   * @private
+   */
+  _whichBin(name) {
+    const cmd = process.platform === 'win32' ? `where ${name}` : `which ${name}`
+    try {
+      const out = execSync(cmd, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+      const lines = out.trim().split(/\r?\n/).filter(Boolean)
+      return lines[0] || null
+    } catch {
+      return null
+    }
+  }
+
   /**
    * 查询全局安装的包
+   *
+   * 三段式检查：
+   * 1. npm list -g <name>（当前激活 node 全局）
+   * 2. npm root -g 目录直查（同上，兜底）
+   * 3. PATH 回退：which <name> → realpath → 推导全局 node_modules
+   *    覆盖通过其他 node 版本/路径安装的包（如非 nvm 管理的独立 node）
    * @param {string} name - 包名
    * @returns {Promise<InstalledResult>}
    * @private
@@ -316,6 +339,30 @@ export class NpmManager extends PackageManager {
       }
     } catch {}
 
+    // PATH 回退：which <name> → realpath → 推导全局 node_modules
+    try {
+      const binPath = this._whichBin(name)
+      if (binPath) {
+        const realBin = fs.realpathSync(binPath)
+        const binDir = path.dirname(realBin)
+        const candidates = [
+          path.join(binDir, '..', 'package.json'),
+          path.join(binDir, '..', 'lib', 'node_modules', name, 'package.json'),
+          path.join(binDir, '..', 'node_modules', name, 'package.json')
+        ]
+        for (const pkgPath of candidates) {
+          try {
+            if (fs.existsSync(pkgPath)) {
+              const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+              return { name, installed: true, version: pkg.version, path: path.dirname(pkgPath), global: true }
+            }
+          } catch {}
+        }
+        // 找到 bin 但推导不到 package.json（极端情况）
+        return { name, installed: true, global: true }
+      }
+    } catch {}
+
     return { name, installed: false, global: true }
   }
 
@@ -375,48 +422,6 @@ export class NpmManager extends PackageManager {
     return { name, versions: [], registry }
   }
 
-  async listInstalled(opts = {}) {
-    if (opts.global) {
-      try {
-        const data = this._execJson(['list', '-g', '--depth=0'])
-        const deps = data?.dependencies || {}
-        return Object.entries(deps)
-          .filter(([, info]) => info && info.version)
-          .map(([name, info]) => ({ name, version: info.version, global: true }))
-      } catch (err) {
-        throw new Error(`npm list -g failed: ${err.message}`)
-      }
-    }
-
-    const declared = this._readDeclaredDeps()
-    const workspaces = this._readWorkspacePackages()
-    const items = []
-    const seen = new Set()
-
-    for (const { name, version, dir } of workspaces) {
-      if (seen.has(name)) continue
-      seen.add(name)
-      const resolved = this._resolveInstalled(name)
-      items.push({
-        name,
-        version: resolved ? resolved.version : version,
-        path: resolved ? resolved.path : dir
-      })
-    }
-
-    for (const [name, declaredVersion] of Object.entries(declared)) {
-      if (seen.has(name)) continue
-      seen.add(name)
-      const resolved = this._resolveInstalled(name)
-      items.push({
-        name,
-        version: resolved ? resolved.version : declaredVersion
-      })
-    }
-
-    return items
-  }
-
   async listOutdated(opts = {}) {
     try {
       const args = ['outdated']
@@ -455,7 +460,8 @@ export class NpmManager extends PackageManager {
 
   /**
    * 构造 --dangerously-allow-all-scripts 参数（仅 npm >= 11 支持）
-   * npm < 11 默认放行所有脚本，无需此 flag；npm >= 11 默认阻止，需显式放行
+   * npm < 11 默认放行所有脚本，无需此 flag；npm >= 11 默认阻止，需显式放行。
+   * install/upgrade 始终追加，保持与 npm < 11 一致的脚本行为（postinstall 可执行）。
    * @param {string} name - 包名（保留签名兼容，未使用）
    * @returns {string[]}
    * @private
@@ -470,7 +476,7 @@ export class NpmManager extends PackageManager {
     if (opts.global) args.push('-g')
     args.push(...this._proxyArgs(opts.proxy))
     args.push(...this._registryArgs())
-    if (opts.allowScripts) args.push(...this._allowScriptsArgs(name))
+    args.push(...this._allowScriptsArgs(name))
 
     this._execInherit(args)
     return { name, version: version || 'latest', action: 'installed' }
@@ -489,7 +495,7 @@ export class NpmManager extends PackageManager {
     if (opts.global) args.push('-g')
     args.push(...this._proxyArgs(opts.proxy))
     args.push(...this._registryArgs())
-    if (opts.allowScripts) args.push(...this._allowScriptsArgs(name))
+    args.push(...this._allowScriptsArgs(name))
 
     this._execInherit(args)
     return { name, version: 'latest', action: 'upgraded' }

package/src/managers/php.js

@@ -70,6 +70,22 @@ export function installPhpenv() {
   }
 }
 
+/**
+ * 解析 phpenv versions 输出为已安装版本列表
+ * @param {string} out
+ * @returns {{ name: string, version: string, current: boolean }[]}
+ */
+export function parsePhpenvInstalled(out) {
+  const items = []
+  for (const line of out.split('\n')) {
+    const m = line.match(/^(\*)?\s+(\d+\.\d+\.\d+)\b/)
+    if (m) {
+      items.push({ name: m[2], version: m[2], current: !!m[1] })
+    }
+  }
+  return items
+}
+
 export class PhpManager extends RuntimeManager {
   constructor() {
     super({
@@ -134,14 +150,7 @@ export class PhpManager extends RuntimeManager {
    * @private
    */
   _parseInstalled(out) {
-    const items = []
-    for (const line of out.split('\n')) {
-      const m = line.match(/^(\*)?\s+(\d+\.\d+\.\d+)\b/)
-      if (m) {
-        items.push({ name: m[2], version: m[2], current: !!m[1] })
-      }
-    }
-    return items
+    return parsePhpenvInstalled(out)
   }
 
   /**

package/src/managers/pip.js

@@ -429,6 +429,23 @@ export class PipManager extends PackageManager {
     return null
   }
 
+  /**
+   * 通过 PATH 查找 bin 路径（Linux: which / Windows: where）
+   * @param {string} name - bin 名
+   * @returns {string|null} bin 路径或 null
+   * @private
+   */
+  _whichBin(name) {
+    const cmd = process.platform === 'win32' ? `where ${name}` : `which ${name}`
+    try {
+      const out = execSync(cmd, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+      const lines = out.trim().split(/\r?\n/).filter(Boolean)
+      return lines[0] || null
+    } catch {
+      return null
+    }
+  }
+
   async isInstalled(name, opts = {}) {
     const info = this._parsePipShow(name, opts)
     if (info) {
@@ -441,6 +458,13 @@ export class PipManager extends PackageManager {
       }
     }
 
+    if (opts.global) {
+      const binPath = this._whichBin(name)
+      if (binPath) {
+        return { name, installed: true, global: true, path: binPath }
+      }
+    }
+
     return { name, installed: false, ...(opts.global ? { global: true } : {}) }
   }
 
@@ -487,24 +511,6 @@ export class PipManager extends PackageManager {
     return { name, versions: [], registry }
   }
 
-  async listInstalled(opts = {}) {
-    try {
-      const out = this._execPip(['list', '--format=freeze'], opts)
-      const items = []
-      for (const line of out.split('\n')) {
-        const trimmed = line.trim()
-        if (!trimmed) continue
-        const match = trimmed.match(/^([a-zA-Z0-9_-]+)==(.+)$/)
-        if (match) {
-          items.push({ name: match[1], version: match[2], ...(opts.global ? { global: true } : {}) })
-        }
-      }
-      return items
-    } catch (err) {
-      throw new Error(`pip list failed: ${err.message}`)
-    }
-  }
-
   async listOutdated(opts = {}) {
     try {
       const args = ['list', '--outdated', '--format=json']

package/src/managers/python.js

@@ -67,6 +67,23 @@ export function installUv(proxy) {
   return { action: 'installed', hint: 'Restart shell or ensure ~/.local/bin is in PATH' }
 }
 
+/**
+ * 解析 uv python list --only-installed 输出为已安装版本列表
+ * 输出格式: cpython-3.12.4-linux-x86_64-gnu     /path/to/python
+ * @param {string} out
+ * @returns {{ name: string, version: string, current: boolean }[]}
+ */
+export function parseUvInstalled(out) {
+  const items = []
+  for (const line of out.split('\n')) {
+    const m = line.match(/cpython-(\d+\.\d+\.\d+)/)
+    if (m) {
+      items.push({ name: m[1], version: m[1], current: false })
+    }
+  }
+  return items
+}
+
 export class PythonManager extends RuntimeManager {
   constructor() {
     super({
@@ -129,14 +146,7 @@ export class PythonManager extends RuntimeManager {
    * @private
    */
   _parseInstalled(out) {
-    const items = []
-    for (const line of out.split('\n')) {
-      const m = line.match(/cpython-(\d+\.\d+\.\d+)/)
-      if (m) {
-        items.push({ name: m[1], version: m[1], current: false })
-      }
-    }
-    return items
+    return parseUvInstalled(out)
   }
 
   /**

package/src/managers/winget.js

@@ -175,6 +175,9 @@ export class WingetManager extends PackageManager {
   }
 
   async isInstalled(name, opts = {}) {
+    if (opts.global === false) {
+      return { name, installed: false, hint: 'no project scope (system-level manager)' }
+    }
     const out = this._exec(
       ['list', name, '--accept-source-agreements', '--disable-interactivity'],
       { allowNonZero: true }
@@ -218,19 +221,6 @@ export class WingetManager extends PackageManager {
     }
   }
 
-  async listInstalled(opts = {}) {
-    const out = this._exec(
-      ['list', '--accept-source-agreements', '--disable-interactivity'],
-      { allowNonZero: true }
-    )
-    return this._parseTable(out).map((r) => ({
-      name: r.Name || r.Id,
-      id: r.Id,
-      version: r.Version || 'unknown',
-      source: r.Source || '',
-    }))
-  }
-
   async listOutdated(opts = {}) {
     const out = this._exec(
       ['list', '--upgrade-available', '--accept-source-agreements', '--disable-interactivity'],