@wwkit/opm 1.0.8 → 1.0.10

package/src/cli/groups/package.js

@@ -50,14 +50,13 @@ const MANAGER_DESC = {
 }
 
 const ACTIONS = {
-  version:    { desc: 'Show manager version' },
+  version:    { desc: 'Show manager or package version' },
   installed:  { desc: 'Check if the manager itself is installed' },
   registry:   { desc: 'Query or set registry/mirror address' },
   search:     { desc: 'Check if a package is available in the source' },
-  view:       { desc: 'Check if a package is already installed' },
+  view:       { desc: 'Check package in global and project scopes' },
   info:       { desc: 'Show package details' },
   versions:   { desc: 'List all available versions of a package' },
-  list:       { desc: 'List all installed packages' },
   outdated:   { desc: 'List outdated packages' },
   install:    { desc: 'Install a package' },
   uninstall:  { desc: 'Uninstall a package' },
@@ -105,8 +104,18 @@ export class PackageGroup {
 
     switch (action) {
       case 'version': {
-        const result = await manager.getVersion()
-        output((result.version || '').replace(/^v/, ''))
+        const name = positional[0]
+        if (name) {
+          const result = await manager.scopedInstalled(name, { proxy: opts.proxy })
+          output({
+            name: result.name,
+            global: { installed: result.global.installed, ...(result.global.version ? { version: result.global.version } : {}) },
+            project: { installed: result.project.installed, ...(result.project.version ? { version: result.project.version } : {}) },
+          })
+        } else {
+          const result = await manager.getVersion()
+          output((result.version || '').replace(/^v/, ''))
+        }
         break
       }
 
@@ -151,10 +160,10 @@ export class PackageGroup {
       case 'view': {
         const name = positional[0]
         if (!name) {
-          console.error(`Usage: opm ${this.name} view <name> [-g]`)
+          console.error(`Usage: opm ${this.name} view <name>`)
           process.exit(1)
         }
-        const result = await manager.isInstalled(name, { global: !!opts.global })
+        const result = await manager.scopedInstalled(name, { proxy: opts.proxy })
         output(result)
         break
       }
@@ -181,12 +190,6 @@ export class PackageGroup {
         break
       }
 
-      case 'list': {
-        const result = await manager.listInstalled({ global: !!opts.global })
-        output(result)
-        break
-      }
-
       case 'outdated': {
         const result = await manager.listOutdated({ global: !!opts.global, proxy: opts.proxy })
         output(result)
@@ -254,16 +257,15 @@ export class PackageGroup {
 Usage: opm ${this.name} <action> [args] [options]
 
 Actions:
-  version                   Show ${this.name} version
+  version [name]             Show manager version, or package version in global+project scopes
   installed                 Check if ${this.name} itself is installed
   registry                   Show active registry (from opm config)
   registry set <url|preset>  Set active registry (writes opm config)
   registry presets           List available mirror presets
   search <name> [version]    Check package availability in source
-  view <name> [-g]           Check if package is installed (local or global)
+  view <name>                Show package in global and project scopes
   info <name>                Show package details
   versions <name>            List all available versions
-  list [-g]                   List all installed packages
   outdated [-g]               List outdated packages
   install <name> [version]   Install a package
   uninstall <name>           Uninstall a package
@@ -285,7 +287,6 @@ Examples:
   opm ${this.name} view <name>
   opm ${this.name} info <name>
   opm ${this.name} versions <name>
-  opm ${this.name} list
   opm ${this.name} outdated
   opm ${this.name} install <name>
   opm ${this.name} uninstall <name>
@@ -363,7 +364,7 @@ export class RuntimeGroup extends PackageGroup {
       return
     }
 
-    const runtimeActions = new Set(['use', 'current', 'default', 'installed', 'dir', 'install', 'upgrade', 'search', 'versions'])
+    const runtimeActions = new Set(['use', 'current', 'default', 'installed', 'dir', 'install', 'upgrade', 'search', 'versions', 'version', 'view', 'list'])
     if (runtimeActions.has(action)) {
       const manager = MANAGERS[this.name]()
       const parsed = parseFlags(rest)
@@ -465,6 +466,29 @@ export class RuntimeGroup extends PackageGroup {
         break
       }
 
+      case 'version': {
+        const result = await manager.getVersion()
+        output((result.version || '').replace(/^v/, ''))
+        break
+      }
+
+      case 'view': {
+        const version = positional[0]
+        if (!version) {
+          console.error(`Usage: opm ${this.name} view <version>`)
+          process.exit(1)
+        }
+        const result = await manager.isInstalled(version, { global: false })
+        output(result)
+        break
+      }
+
+      case 'list': {
+        const result = await manager.listInstalled({ global: false })
+        output(result)
+        break
+      }
+
       default:
         return super._dispatch(manager, action, parsed, opts)
     }

package/src/cli/groups/phpenv.js

@@ -14,7 +14,7 @@ import os from 'node:os'
 import { ToolManagerGroup } from './version-manager.js'
 import { Shell } from '@wwkit/shared'
 import { getActiveRegistry } from '../../config.js'
-import { installPhpenv } from '../../managers/php.js'
+import { installPhpenv, parsePhpenvInstalled } from '../../managers/php.js'
 
 const shell = new Shell()
 
@@ -47,6 +47,8 @@ export class PhpenvGroup extends ToolManagerGroup {
         const m = out.trim().match(/phpenv\s+([\d.]+)/)
         return m ? m[1] : out.trim()
       },
+      listCmd: () => `${getPhpenvBin()} versions`,
+      parseList: parsePhpenvInstalled,
       install: () => installPhpenv(),
       upgrade: () => {
         execSync(`cd "${getPhpenvRoot()}" && git remote set-url origin "${getActiveRegistry('phpenv')}" && git pull --tags`, {
@@ -74,6 +76,7 @@ export class PhpenvGroup extends ToolManagerGroup {
         ['upgrade', 'Update phpenv and php-build plugin (git pull)'],
         ['uninstall', 'Remove phpenv (~/.phpenv)'],
         ['dir', 'Show phpenv install directory'],
+        ['list', 'List installed PHP versions (phpenv versions)'],
         ['help', 'Show this help'],
       ],
       examples: [
@@ -83,6 +86,7 @@ export class PhpenvGroup extends ToolManagerGroup {
         'opm phpenv install',
         'opm phpenv upgrade',
         'opm phpenv dir',
+        'opm phpenv list',
       ],
     })
   }

package/src/cli/groups/uv.js

@@ -11,7 +11,7 @@ import fs from 'node:fs'
 import path from 'node:path'
 import os from 'node:os'
 import { ToolManagerGroup } from './version-manager.js'
-import { installUv, getUvBin } from '../../managers/python.js'
+import { installUv, getUvBin, parseUvInstalled } from '../../managers/python.js'
 
 export class UvGroup extends ToolManagerGroup {
   constructor() {
@@ -29,6 +29,8 @@ export class UvGroup extends ToolManagerGroup {
       getPath: () => getUvBin(),
       versionCmd: () => `${getUvBin()} --version`,
       parseVersion: (out) => out.trim(),
+      listCmd: () => `${getUvBin()} python list --only-installed`,
+      parseList: parseUvInstalled,
       install: (proxy) => installUv(proxy),
       upgrade: () => {
         execSync(`${getUvBin()} self update`, { stdio: 'inherit' })
@@ -56,6 +58,7 @@ export class UvGroup extends ToolManagerGroup {
         ['upgrade', 'Update uv (uv self update)'],
         ['uninstall', 'Remove uv (~/.local/bin/uv + ~/.local/share/uv)'],
         ['dir', 'Show uv install directory'],
+        ['list', 'List installed Python versions (uv python list --only-installed)'],
         ['help', 'Show this help'],
       ],
       examples: [
@@ -67,6 +70,7 @@ export class UvGroup extends ToolManagerGroup {
         'opm uv install',
         'opm uv upgrade',
         'opm uv dir',
+        'opm uv list',
         'opm uv uninstall',
       ],
     })

package/src/cli/groups/version-manager.js

@@ -25,6 +25,8 @@ const shell = new Shell()
  * @property {() => string} getPath - view 展示的安装路径
  * @property {() => string} versionCmd - 返回查询版本的 shell 命令
  * @property {(out: string) => string} [parseVersion] - 解析版本输出
+ * @property {() => string} [listCmd] - 返回列出已安装版本的 shell 命令（缺省则 list 输出空列表）
+ * @property {(out: string) => { name: string, version: string, current: boolean }[]} [parseList] - 解析 list 输出
  * @property {(proxy?: string) => Object} install - 安装并返回结果字段（失败时 throw）
  * @property {() => Object} upgrade - 升级并返回结果字段（失败时 throw）
  * @property {() => Object} uninstall - 卸载并返回结果字段（失败时 throw）
@@ -81,6 +83,8 @@ export class ToolManagerGroup {
         return this._uninstall(parsed)
       case 'dir':
         return this._dir()
+      case 'list':
+        return this._list()
       default:
         console.error(`Unknown action: ${action}`)
         this.printHelp()
@@ -193,6 +197,29 @@ const out = execSync(this.cfg.versionCmd(), { encoding: 'utf8', shell: shell.she
     output(result)
   }
 
+  /**
+   * 列出工具已安装的版本
+   * @returns {void}
+   * @private
+   */
+  _list() {
+    if (!this.cfg.isInstalled()) {
+      output({ name: this.name, installed: false, hint: `Run \`opm ${this.name} install\` first` })
+      return
+    }
+    if (!this.cfg.listCmd) {
+      output({ name: this.name, count: 0, versions: [] })
+      return
+    }
+    try {
+      const out = execSync(this.cfg.listCmd(), { encoding: 'utf8', shell: shell.shellForExec(this.cfg.needsBash) })
+      const versions = this.cfg.parseList ? this.cfg.parseList(out) : []
+      output({ name: this.name, count: versions.length, versions })
+    } catch {
+      output({ name: this.name, count: 0, versions: [] })
+    }
+  }
+
   printHelp() {
     const actionLines = this.cfg.actions.map(([sig, desc]) => `  ${sig.padEnd(34)} ${desc}`).join('\n')
     const exampleLines = this.cfg.examples.map((e) => `  ${e}`).join('\n')

package/src/cli/index.js

@@ -20,12 +20,14 @@ import { DockerGroup } from './groups/docker.js'
 import { EnsureGroup } from './groups/ensure.js'
 import { PingGroup } from './groups/ping.js'
 import { ProcGroup } from './groups/proc.js'
+import { OverlayGroup } from './groups/overlay.js'
 import { FtpGroup } from '../tools/ftp/index.js'
 import { GitGroup } from '../tools/git/index.js'
 import { ShareGroup } from '../tools/share/index.js'
 import { WebworkGroup } from '../tools/webwork/index.js'
 import { HarnessGroup } from '../harnesses/base.js'
 import { opencodeHarness } from '../harnesses/opencode/index.js'
+import { harnessCfg } from '../harnesses/harness/index.js'
 import { CftGroup } from '../binaries/cft/index.js'
 import { generateDocHtml } from './doc.js'
 
@@ -58,10 +60,12 @@ const GROUPS = {
   uv: new UvGroup(),
   config: new ConfigGroup(),
   opencode: new HarnessGroup(opencodeHarness),
+  harness: new HarnessGroup(harnessCfg),
   cft: new CftGroup(),
   ensure: new EnsureGroup(),
   ping: new PingGroup(),
   proc: new ProcGroup(),
+  overlay: new OverlayGroup(),
 }
 
 class CLI {

package/src/config.json5

@@ -227,6 +227,7 @@
     env: {
       OPENCODE_CONFIG_DIR: "{pkg:@wwkit/harness}",
       OPENCODE_CONFIG_CONTENT: "",
+      OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS: "true",
     },
   },
 

package/src/harnesses/base.js

@@ -2,7 +2,12 @@
  * AI harness 统一命令组基类
  *
  * 各 harness（opencode / claude / …）共享同一套命令：
- *   version / installed / install / uninstall / upgrade / config / clear / dir
+ *   version / installed / install / uninstall / upgrade / config / clear / dir / env
+ * 内容型 harness（harness/@wwkit/harness 插件）额外提供：
+ *   list（列出 skills/agents/commands） / status（安装 + env 健康检查）
+ *
+ * 支持的动作按 cfg 能力动态裁剪（_supportedActions）：只有 cfg 提供了对应的
+ * 实现（list/status/clear/getConfigFile/getEnvVars）时才出现在帮助与路由中。
  *
  * install/uninstall/upgrade 委托 NpmManager（global），自动使用 opm 配置的
  * npm registry 镜像与 proxy，而非裸 npm。
@@ -25,7 +30,9 @@ const ACTIONS = {
   upgrade:    { desc: 'Upgrade to latest via npm -g (uses opm npm registry + proxy)' },
   config:     { desc: 'Show config file content' },
   clear:      { desc: 'Clear sessions / data' },
-  dir:        { desc: 'Show data / db / log / config paths' },
+  dir:        { desc: 'Show install / data / db / log / config paths' },
+  list:       { desc: 'List installed content (skills/agents/commands)' },
+  status:     { desc: 'Show install status + environment health' },
   env:        { desc: 'Show harness environment variables' },
   help:       { desc: 'Show this help' },
 }
@@ -35,12 +42,15 @@ const ACTIONS = {
  * @property {string} name - harness 名（命令名）
  * @property {string} desc - 描述
  * @property {string} npmPackage - npm 全局包名
- * @property {() => string|null} getConfigFile - 配置文件路径
- * @property {() => string} getDataDir - 数据目录
- * @property {() => string} getDbPath - DB 路径
- * @property {() => string} getLogPath - 日志路径
- * @property {(argv: string[]) => Promise<void>} clear - 清理实现
+ * @property {() => string|null} [getConfigFile] - 配置文件路径
+ * @property {() => string} [getDataDir] - 数据目录
+ * @property {() => string} [getDbPath] - DB 路径
+ * @property {() => string} [getLogPath] - 日志路径
+ * @property {(argv: string[]) => Promise<void>} [clear] - 清理实现
  * @property {string[][]} [clearOptions] - clear 子选项帮助 [flag, desc]
+ * @property {() => Promise<Object>} [list] - 列出包内容（skills/agents/commands）
+ * @property {() => Promise<Object>} [status] - 安装/环境健康检查
+ * @property {() => Promise<Object>} [dirInfo] - 自定义 dir 输出（覆盖默认 npm install 路径）
  */
 
 export class HarnessGroup {
@@ -62,9 +72,19 @@ export class HarnessGroup {
     }
 
     if (!action || !ACTIONS[action]) {
+      if (!this.cfg.open) {
+        this.printHelp()
+        return
+      }
       return this._open(argv)
     }
 
+    if (!this._supportedActions().includes(action)) {
+      console.error(`Action "${action}" is not supported for ${this.cfg.name}`)
+      this.printHelp()
+      process.exit(1)
+    }
+
     switch (action) {
       case 'version':
         return this._version()
@@ -82,6 +102,10 @@ export class HarnessGroup {
         return this._clear(rest)
       case 'dir':
         return this._dir()
+      case 'list':
+        return this._list()
+      case 'status':
+        return this._status()
       case 'env':
         return this._env()
       default:
@@ -91,6 +115,23 @@ export class HarnessGroup {
     }
   }
 
+  /**
+   * 本 harness 支持的动作列表（按 cfg 能力动态裁剪）
+   * @returns {string[]}
+   * @private
+   */
+  _supportedActions() {
+    return Object.keys(ACTIONS).filter((sig) => {
+      if (sig === 'help') return true
+      if (sig === 'list') return Boolean(this.cfg.list)
+      if (sig === 'status') return Boolean(this.cfg.status)
+      if (sig === 'clear') return Boolean(this.cfg.clear)
+      if (sig === 'config') return Boolean(this.cfg.getConfigFile)
+      if (sig === 'env') return Boolean(this.cfg.getEnvVars)
+      return true
+    })
+  }
+
   /**
    * 解析 proxy（-p/--proxy 优先，否则回退配置 active proxy）
    * @param {string[]} argv
@@ -152,6 +193,22 @@ export class HarnessGroup {
     output({ file, content })
   }
 
+  async _list() {
+    if (!this.cfg.list) {
+      output({ name: this.cfg.name, error: 'list not supported for this harness' })
+      return
+    }
+    output(await this.cfg.list())
+  }
+
+  async _status() {
+    if (!this.cfg.status) {
+      output({ name: this.cfg.name, error: 'status not supported for this harness' })
+      return
+    }
+    output(await this.cfg.status())
+  }
+
   async _clear(rest) {
     const parsed = parseFlags(rest)
     if (parsed.flags.help === 'true') {
@@ -162,6 +219,10 @@ export class HarnessGroup {
   }
 
   async _dir() {
+    if (this.cfg.dirInfo) {
+      output(await this.cfg.dirInfo())
+      return
+    }
     const npm = new NpmManager()
     const npmResult = await npm.isInstalled(this.cfg.npmPackage, { global: true })
     const configFile = this.cfg.getConfigFile()
@@ -218,18 +279,34 @@ export class HarnessGroup {
   }
 
   printHelp() {
-    const actionLines = Object.entries(ACTIONS)
-      .map(([sig, { desc }]) => `  ${sig.padEnd(12)} ${desc}`)
+    const actionLines = this._supportedActions()
+      .map((sig) => `  ${sig.padEnd(12)} ${ACTIONS[sig].desc}`)
       .join('\n')
 
     let clearSection = ''
-    if (this.cfg.clearOptions && this.cfg.clearOptions.length > 0) {
+    if (this._supportedActions().includes('clear') && this.cfg.clearOptions && this.cfg.clearOptions.length > 0) {
       const optLines = this.cfg.clearOptions
         .map(([flag, desc]) => `  ${flag.padEnd(20)} ${desc}`)
         .join('\n')
       clearSection = `\nClear options:\n${optLines}\n`
     }
 
+    const supported = this._supportedActions()
+    const examples = [
+      '  opm ' + this.cfg.name + ' version',
+      '  opm ' + this.cfg.name + ' install',
+      '  opm ' + this.cfg.name + ' upgrade',
+      ...(supported.includes('list') ? [`  opm ${this.cfg.name} list`] : []),
+      ...(supported.includes('status') ? [`  opm ${this.cfg.name} status`] : []),
+      ...(supported.includes('env') ? [`  opm ${this.cfg.name} env`] : []),
+      ...(supported.includes('dir') ? [`  opm ${this.cfg.name} dir`] : []),
+    ]
+    if (this.cfg.open) {
+      examples.push(`  opm ${this.cfg.name}                           Launch TUI in current directory`)
+      examples.push(`  opm ${this.cfg.name} -d /path/to/project`)
+      examples.push(`  opm ${this.cfg.name} -c config --agent work    Pass through args to opencode`)
+    }
+
     console.log(`
 Usage: opm ${this.cfg.name} <action> [options]
 
@@ -242,16 +319,7 @@ Options:
   -h, --help          Show this help
 
 Examples:
-  opm ${this.cfg.name} version
-  opm ${this.cfg.name} install
-  opm ${this.cfg.name} upgrade
-  opm ${this.cfg.name} config
-  opm ${this.cfg.name} clear
-  opm ${this.cfg.name} dir
-  opm ${this.cfg.name} env
-  opm ${this.cfg.name}                           Launch TUI in current directory
-  opm ${this.cfg.name} -d /path/to/project
-  opm ${this.cfg.name} -c config --agent work    Pass through args to opencode
+${examples.join('\n')}
 `)
   }
 }

package/src/harnesses/harness/index.js

@@ -0,0 +1,132 @@
+/**
+ * @wwkit/harness harness 配置
+ *
+ * @wwkit/harness 是 opencode 插件包（skills/agents/commands/scripts），
+ * 通过 npm 全局安装；postinstall 设置 OPENCODE_CONFIG_DIR 指向包根目录，
+ * 使 opencode 自动加载其 skills/agents/commands。
+ *
+ * 与 opencode（AI agent CLI）不同：无独立配置文件、无 DB/日志/会话，
+ * 因此不支持 config/clear；而提供 list（列出包内容）与 status（健康检查）。
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { NpmManager } from '../../managers/npm.js'
+
+const CONTENT_DIRS = ['skills', 'agents', 'commands']
+const ENV_VARS = ['OPENCODE_CONFIG_DIR', 'OPENCODE_EXPERIMENTAL_LSP_TOOL']
+const NAME = 'harness'
+const NPM_PACKAGE = '@wwkit/harness'
+
+/**
+ * 已安装的 @wwkit/harness 全局包信息
+ * @returns {Promise<{ installed: boolean, version?: string, path?: string }>}
+ * @private
+ */
+async function getInstalled() {
+  const npm = new NpmManager()
+  return npm.isInstalled(NPM_PACKAGE, { global: true })
+}
+
+/**
+ * 读取 env 变量当前值
+ * @returns {Record<string, string>}
+ */
+export function getEnvVars() {
+  const result = {}
+  for (const key of ENV_VARS) {
+    result[key] = process.env[key] || ''
+  }
+  return result
+}
+
+/**
+ * 列出包根目录下 skills/agents/commands 内容
+ * @param {string} root - 已安装包根目录
+ * @returns {Record<string, string[]>}
+ */
+export function readContentDirs(root) {
+  const result = {}
+  for (const dir of CONTENT_DIRS) {
+    const full = path.join(root, dir)
+    result[dir] = fs.existsSync(full) ? fs.readdirSync(full).sort() : []
+  }
+  return result
+}
+
+/**
+ * list：列出安装包提供的 skills/agents/commands
+ * @returns {Promise<Object>}
+ */
+async function list() {
+  const installed = await getInstalled()
+  if (!installed.installed || !installed.path) {
+    return { name: NAME, installed: false, hint: `Run \`opm ${NAME} install\` to install ${NPM_PACKAGE}` }
+  }
+  const content = readContentDirs(installed.path)
+  const counts = {}
+  for (const dir of CONTENT_DIRS) counts[dir] = content[dir].length
+  return { name: NAME, installed: true, version: installed.version, install: installed.path, counts, ...content }
+}
+
+/**
+ * status：健康检查（安装 + env + 内容目录完整性）
+ * @returns {Promise<Object>}
+ */
+async function status() {
+  const installed = await getInstalled()
+  const env = getEnvVars()
+  if (!installed.installed || !installed.path) {
+    return {
+      name: NAME,
+      installed: false,
+      ok: false,
+      env,
+      hint: `Run \`opm ${NAME} install\` to install ${NPM_PACKAGE}`,
+    }
+  }
+  const content = readContentDirs(installed.path)
+  const contentOk = {}
+  for (const dir of CONTENT_DIRS) contentOk[dir] = content[dir].length > 0
+  const envDirOk = env.OPENCODE_CONFIG_DIR === installed.path
+  const envLspOk = env.OPENCODE_EXPERIMENTAL_LSP_TOOL === 'true'
+  const ok = envDirOk && envLspOk && Object.values(contentOk).every(Boolean)
+  return {
+    name: NAME,
+    installed: true,
+    version: installed.version,
+    ok,
+    envDirOk,
+    envLspOk,
+    contentDirs: contentOk,
+    env,
+    ...(!ok ? { hint: 'Environment or content is not fully ready, see fields above' } : {}),
+  }
+}
+
+/**
+ * dir：安装路径 + skills/agents/commands 目录
+ * @returns {Promise<Object>}
+ */
+async function dirInfo() {
+  const installed = await getInstalled()
+  if (!installed.installed || !installed.path) {
+    return { name: NAME, install: '', hint: `Run \`opm ${NAME} install\` to install ${NPM_PACKAGE}` }
+  }
+  const paths = { install: installed.path }
+  for (const dir of CONTENT_DIRS) {
+    paths[dir] = path.join(installed.path, dir)
+  }
+  return { name: NAME, ...paths }
+}
+
+export const harnessCfg = {
+  name: NAME,
+  desc: '@wwkit/harness opencode plugin (skills/agents/commands)',
+  npmPackage: NPM_PACKAGE,
+  envVars: ENV_VARS,
+  getEnvVars,
+  list,
+  status,
+  dirInfo,
+}

package/src/harnesses/opencode/index.js

@@ -21,7 +21,7 @@ const shell = new Shell()
 /**
  * opencode 专属环境变量名
  */
-const ENV_VARS = ['OPENCODE_CONFIG_DIR', 'OPENCODE_CONFIG_CONTENT']
+const ENV_VARS = ['OPENCODE_CONFIG_DIR', 'OPENCODE_CONFIG_CONTENT', 'OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS']
 
 /**
  * 查找 opencode 配置文件路径（优先 .jsonc，其次 .json）

package/src/index.js

@@ -11,6 +11,7 @@ export { PackageGroup, RuntimeGroup } from './cli/groups/package.js'
 export { ConfigGroup } from './cli/groups/config.js'
 export { HarnessGroup } from './harnesses/base.js'
 export { opencodeHarness } from './harnesses/opencode/index.js'
+export { harnessCfg } from './harnesses/harness/index.js'
 export { BinaryGroup } from './binaries/base.js'
 export { CftGroup } from './binaries/cft/index.js'
 export { NvmGroup } from './cli/groups/nvm.js'
@@ -21,6 +22,7 @@ export { WslGroup } from './cli/groups/wsl.js'
 export { DockerGroup } from './cli/groups/docker.js'
 export { PingGroup } from './cli/groups/ping.js'
 export { ProcGroup } from './cli/groups/proc.js'
+export { OverlayGroup } from './cli/groups/overlay.js'
 export { FtpGroup } from './tools/ftp/index.js'
 export { GitGroup } from './tools/git/index.js'
 export { ShareGroup } from './tools/share/index.js'

package/src/managers/apt.js

@@ -249,6 +249,9 @@ export class AptManager extends PackageManager {
   }
 
   async isInstalled(name, opts = {}) {
+    if (opts.global === false) {
+      return { name, installed: false, hint: 'no project scope (system-level manager)' }
+    }
     const args = ['query', '-W', '-f=${Status} ${Version}', name]
     const out = this._exec(args, { allowNonZero: true })
     const m = out.trim().match(/^install ok installed\s+(\S+)$/)
@@ -323,18 +326,6 @@ export class AptManager extends PackageManager {
     return { name, versions, registry }
   }
 
-  async listInstalled(opts = {}) {
-    const out = this._exec(['list', '--installed'], { allowNonZero: true })
-    const items = []
-    for (const line of this._parseLines(out)) {
-      const m = line.match(/^(\S+?)\/(?:\S+,)?now\s+(\S+)\s+(\S+)\s+\[/)
-      if (m) {
-        items.push({ name: m[1], version: m[2] })
-      }
-    }
-    return items
-  }
-
   async listOutdated(opts = {}) {
     const out = this._exec(['list', '--upgradable', ...this._proxyArgs(opts.proxy)], { allowNonZero: true })
     const items = []