@wwkit/opm 1.0.9 → 1.0.10

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/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'

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/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/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)
   }
 
   /**