@wwkit/opm 1.0.1

package/src/harnesses/base.js

@@ -0,0 +1,205 @@
+/**
+ * AI harness 统一命令组基类
+ *
+ * 各 harness（opencode / claude / …）共享同一套命令：
+ *   version / installed / install / uninstall / upgrade / config / clear / dir
+ *
+ * install/uninstall/upgrade 委托 NpmManager（global），自动使用 opm 配置的
+ * npm registry 镜像与 proxy，而非裸 npm。
+ *
+ * 新增 harness：在 src/harnesses/<name>/ 下提供 config 后在此注册即可。
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { parseFlags } from '../cli/helpers/args.js'
+import { NpmManager } from '../managers/npm.js'
+import { getActiveProxy } from '../config.js'
+import { output } from '../formatter.js'
+
+const ACTIONS = {
+  version:    { desc: 'Show installed version' },
+  installed:  { desc: 'Check if installed' },
+  install:    { desc: 'Install via npm -g (uses opm npm registry + proxy)' },
+  uninstall:  { desc: 'Uninstall the npm global package' },
+  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' },
+  help:       { desc: 'Show this help' },
+}
+
+/**
+ * @typedef {Object} HarnessConfig
+ * @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[][]} [clearOptions] - clear 子选项帮助 [flag, desc]
+ */
+
+export class HarnessGroup {
+  /**
+   * @param {HarnessConfig} cfg
+   */
+  constructor(cfg) {
+    this.name = cfg.name
+    this.desc = cfg.desc
+    this.cfg = cfg
+  }
+
+  async run(argv) {
+    const [action, ...rest] = argv
+
+    if (!action || action === '-h' || action === '--help' || action === 'help') {
+      this.printHelp()
+      return
+    }
+
+    switch (action) {
+      case 'version':
+        return this._version()
+      case 'installed':
+        return this._installed()
+      case 'install':
+        return this._install(rest)
+      case 'uninstall':
+        return this._uninstall()
+      case 'upgrade':
+        return this._upgrade(rest)
+      case 'config':
+        return this._config()
+      case 'clear':
+        return this._clear(rest)
+      case 'dir':
+        return this._dir()
+      default:
+        console.error(`Unknown action: ${action}`)
+        this.printHelp()
+        process.exit(1)
+    }
+  }
+
+  /**
+   * 解析 proxy（-p/--proxy 优先，否则回退配置 active proxy）
+   * @param {string[]} argv
+   * @returns {string}
+   * @private
+   */
+  _resolveProxy(argv) {
+    const parsed = parseFlags(argv)
+    let proxy = parsed.flags.proxy || parsed.flags.p || ''
+    if (proxy === 'true') proxy = ''
+    if (!proxy) proxy = getActiveProxy()
+    return proxy
+  }
+
+  async _version() {
+    const npm = new NpmManager()
+    const result = await npm.isInstalled(this.cfg.npmPackage, { global: true })
+    output((result.version || '').replace(/^v/, ''))
+  }
+
+  async _installed() {
+    const npm = new NpmManager()
+    const result = await npm.isInstalled(this.cfg.npmPackage, { global: true })
+    output({
+      name: this.cfg.name,
+      installed: result.installed,
+      ...(result.version ? { version: result.version } : {}),
+      ...(result.installed ? {} : { hint: `Run \`opm ${this.cfg.name} install\` to install` }),
+    })
+  }
+
+  async _install(rest) {
+    const proxy = this._resolveProxy(rest)
+    const npm = new NpmManager()
+    const result = await npm.install(this.cfg.npmPackage, null, { global: true, proxy })
+    output({ ...result, name: this.cfg.name, package: this.cfg.npmPackage })
+  }
+
+  async _uninstall() {
+    const npm = new NpmManager()
+    const result = await npm.uninstall(this.cfg.npmPackage, { global: true })
+    output({ ...result, name: this.cfg.name, package: this.cfg.npmPackage })
+  }
+
+  async _upgrade(rest) {
+    const proxy = this._resolveProxy(rest)
+    const npm = new NpmManager()
+    const result = await npm.upgrade(this.cfg.npmPackage, { global: true, proxy })
+    output({ ...result, name: this.cfg.name, package: this.cfg.npmPackage })
+  }
+
+  async _config() {
+    const file = this.cfg.getConfigFile()
+    if (!file) {
+      output({ error: `${this.cfg.name} config not found`, hint: `Expected ${this.cfg.name} config file` })
+      return
+    }
+    const content = fs.readFileSync(file, 'utf8')
+    output({ file, content })
+  }
+
+  async _clear(rest) {
+    const parsed = parseFlags(rest)
+    if (parsed.flags.help === 'true') {
+      this.printHelp()
+      return
+    }
+    await this.cfg.clear(rest)
+  }
+
+  async _dir() {
+    const npm = new NpmManager()
+    const npmResult = await npm.isInstalled(this.cfg.npmPackage, { global: true })
+    const configFile = this.cfg.getConfigFile()
+    const configDir = configFile ? path.dirname(configFile) : ''
+    output({
+      name: this.cfg.name,
+      install: npmResult.installed ? npmResult.path || '' : '',
+      config: configDir,
+      dataDir: this.cfg.getDataDir(),
+      dbPath: this.cfg.getDbPath(),
+      logPath: this.cfg.getLogPath(),
+      configFile: configFile || '(not found)',
+    })
+  }
+
+  printHelp() {
+    const actionLines = Object.entries(ACTIONS)
+      .map(([sig, { desc }]) => `  ${sig.padEnd(12)} ${desc}`)
+      .join('\n')
+
+    let clearSection = ''
+    if (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`
+    }
+
+    console.log(`
+Usage: opm ${this.cfg.name} <action> [options]
+
+Actions:
+${actionLines}
+${clearSection}
+Options:
+  -p, --proxy <url>  Proxy for install/upgrade (overrides config proxy.active)
+  -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
+`)
+  }
+}

package/src/harnesses/opencode/clear.js

@@ -0,0 +1,239 @@
+/**
+ * opm opencode clear 实现
+ *
+ * 参考 docs/clean-opencode-db.sh，用 Node 实现，跨平台：
+ *   1. 预览待删除会话
+ *   2. 确认（--dry-run 仅预览，-y 跳过确认）
+ *   3. 关闭 opencode 进程（尽力而为）
+ *   4. 备份数据库
+ *   5. 删除过期会话（event_sequence + session）并 VACUUM
+ *   6. 清空日志、报告清理结果
+ *
+ * 保留策略参数（三选一，缺省 -d 1 即只保留今天）：
+ *   -d/--days <n>   保留最近 n 天（对齐本地零点，含今天）
+ *   -h/--hours <n>  保留最近 n 小时（滚动窗口）
+ *   -n/--num <n>    保留最近 n 个会话（按 time_created 倒序取最新 n 个）
+ */
+
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import readline from 'node:readline/promises'
+import { spawnSync } from 'node:child_process'
+import { parseFlags } from '../../cli/helpers/args.js'
+import { openDb } from './sqlite.js'
+import { getDbPath, getLogPath } from './db.js'
+
+/**
+ * 某毫秒时间戳所在「天」的本地零点
+ * @param {number} ts - epoch ms
+ * @returns {number}
+ */
+export function startOfDayLocal(ts) {
+  const d = new Date(ts)
+  return new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime()
+}
+
+/**
+ * 解析 -d/--days | -h/--hours | -n/--num 的计数参数
+ * @param {string|undefined} value
+ * @param {string} name - 参数名（days/hours/num），用于报错提示
+ * @returns {number|null} 未提供返回 null，否则返回正整数
+ */
+export function parseCount(value, name) {
+  if (value === undefined) return null
+  const n = Number(value)
+  if (!Number.isInteger(n) || n < 1) {
+    throw new Error(`invalid --${name} value: "${value}" (expect a positive integer)`)
+  }
+  return n
+}
+
+/**
+ * 计算时间清理边界（毫秒）
+ * days: 最近 n 天，对齐本地零点（含今天），边界 = 今天零点 - (n-1) 天
+ * hours: 最近 n 小时，滚动窗口，边界 = now - n 小时
+ * @param {{ days?: number|null, hours?: number|null }} opts
+ * @returns {number}
+ */
+export function computeBoundary({ days = null, hours = null } = {}) {
+  const now = Date.now()
+  if (days !== null) {
+    return startOfDayLocal(now) - (days - 1) * 86400000
+  }
+  if (hours !== null) {
+    return now - hours * 3600000
+  }
+  return startOfDayLocal(now)
+}
+
+/**
+ * 本地时间格式化 YYYY-MM-DD HH:mm:ss
+ * @param {number} ms
+ * @returns {string}
+ */
+export function formatLocal(ms) {
+  const d = new Date(ms)
+  const pad = (n) => String(n).padStart(2, '0')
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`
+}
+
+/**
+ * 人类可读文件大小
+ * @param {number} bytes
+ * @returns {string}
+ */
+export function formatSize(bytes) {
+  if (bytes >= 1024 * 1024) return `${(bytes / 1024 / 1024).toFixed(2)} MB`
+  if (bytes >= 1024) return `${(bytes / 1024).toFixed(1)} KB`
+  return `${bytes} B`
+}
+
+function killOpencodeProcesses() {
+  try {
+    if (process.platform === 'win32') {
+      spawnSync('taskkill', ['/IM', 'opencode.exe', '/F'], { stdio: 'ignore' })
+    } else {
+      spawnSync('pkill', ['-f', 'bin/opencode'], { stdio: 'ignore' })
+    }
+  } catch {}
+}
+
+/**
+ * 备份目录：$XDG_DATA_HOME/opm/opencode-backup（默认 ~/.local/share/opm/opencode-backup）
+ * @returns {string}
+ */
+export function getBackupDir() {
+  const xdgData = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share')
+  return path.join(xdgData, 'opm', 'opencode-backup')
+}
+
+function backupDb(dbPath) {
+  const backupDir = getBackupDir()
+  fs.mkdirSync(backupDir, { recursive: true })
+  const backupPath = path.join(backupDir, `opencode.db.bak.${Date.now()}`)
+  fs.copyFileSync(dbPath, backupPath)
+  return backupPath
+}
+
+function clearLog() {
+  const logPath = getLogPath()
+  if (fs.existsSync(logPath)) {
+    try {
+      fs.writeFileSync(logPath, '', 'utf8')
+    } catch {}
+  }
+}
+
+async function promptConfirm(message) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+  try {
+    const ans = await rl.question(message)
+    return /^[yY]/.test(ans.trim())
+  } finally {
+    rl.close()
+  }
+}
+
+/**
+ * opencode clear 主流程
+ * @param {string[]} argv - opencode clear 之后的参数
+ */
+export async function runClear(argv) {
+  const parsed = parseFlags(argv)
+  const flags = parsed.flags
+
+  const dryRun = flags['dry-run'] === 'true'
+  const yes = flags.y === 'true' || flags.yes === 'true'
+  const backup = flags.backup === 'true'
+  const dbPath = flags.db || getDbPath()
+
+  const days = parseCount(flags.days ?? flags.d, 'days')
+  const hours = parseCount(flags.hours ?? flags.h, 'hours')
+  const num = parseCount(flags.num ?? flags.n, 'num')
+
+  const given = ['days', 'hours', 'num'].filter((k) => ({ days, hours, num })[k] !== null)
+  if (given.length > 1) {
+    throw new Error('--days / --hours / --num are mutually exclusive')
+  }
+
+  const mode = given[0] || 'days'
+  const count = mode === 'days' ? (days ?? 1) : mode === 'hours' ? hours : num
+
+  if (!fs.existsSync(dbPath)) {
+    throw new Error(`opencode database not found: ${dbPath}`)
+  }
+
+  const driver = await openDb(dbPath)
+  try {
+    let rows
+    let scopeDesc
+    let boundary = null
+
+    if (mode === 'num') {
+      const all = driver.listSessionsAsc()
+      const keep = Math.min(count, all.length)
+      rows = all.slice(0, all.length - keep)
+      scopeDesc = `仅保留最新 ${keep} 个会话`
+    } else {
+      boundary = computeBoundary({ days, hours })
+      rows = driver.listBefore(boundary)
+      scopeDesc = `删除 ${mode === 'days' ? `最近 ${count} 天` : `最近 ${count} 小时`}（${formatLocal(boundary)}）之前的会话`
+    }
+
+    console.log(`==> DB: ${dbPath}`)
+    console.log(`==> 清理范围: ${scopeDesc}`)
+    console.log(`==> 待删除会话 (${rows.length} 个):`)
+
+    for (const row of rows) {
+      console.log(`    - ${formatLocal(row.time_created)}  ${row.title} (${row.id})`)
+    }
+
+    if (rows.length === 0) {
+      console.log('==> 没有符合条件的会话，无需清理')
+      return
+    }
+
+    if (dryRun) {
+      console.log('==> DRY_RUN 模式：仅预览，未修改任何数据')
+      return
+    }
+
+    if (!yes) {
+      const ok = await promptConfirm(`==> 确认删除以上 ${rows.length} 个会话？[y/N] `)
+      if (!ok) {
+        console.log('已取消')
+        return
+      }
+    }
+
+    console.log('==> 关闭 opencode 进程')
+    killOpencodeProcesses()
+
+    let backupPath = null
+    if (backup) {
+      console.log('==> 备份数据库')
+      backupPath = backupDb(dbPath)
+    }
+
+    console.log('==> 删除过期会话并压缩数据库')
+    driver.checkpoint()
+    if (mode === 'num') {
+      driver.deleteSessions(rows.map((row) => row.id))
+    } else {
+      driver.deleteBefore(boundary)
+    }
+    clearLog()
+
+    console.log(`==> 清理后数据库大小: ${formatSize(fs.statSync(dbPath).size)}`)
+    if (backupPath) {
+      console.log(`==> 备份文件: ${backupPath}`)
+    }
+    console.log('==> 剩余会话:')
+    for (const row of driver.listAll()) {
+      console.log(`    - ${row.title} (${row.id})`)
+    }
+  } finally {
+    driver.close()
+  }
+}

package/src/harnesses/opencode/db.js

@@ -0,0 +1,39 @@
+/**
+ * opencode 数据路径解析
+ *
+ * 跨平台定位 opencode 数据目录（与 opencode 实际行为一致）：
+ *   - macOS/Linux: $XDG_DATA_HOME/opencode (默认 ~/.local/share/opencode)
+ *   - Windows:     %APPDATA%/opencode
+ * 可通过环境变量 OPM_OPENCODE_DATA_DIR 覆盖。
+ */
+
+import os from 'node:os'
+import path from 'node:path'
+import { existsSync } from 'node:fs'
+
+export function getDataDir() {
+  const override = process.env.OPM_OPENCODE_DATA_DIR
+  if (override) return override
+
+  if (process.platform === 'win32') {
+    return process.env.APPDATA
+      ? path.join(process.env.APPDATA, 'opencode')
+      : path.join(os.homedir(), 'AppData', 'Roaming', 'opencode')
+  }
+
+  if (process.platform === 'darwin') {
+    const macDir = path.join(os.homedir(), 'Library', 'Application Support', 'opencode')
+    if (existsSync(macDir)) return macDir
+  }
+
+  const xdgData = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share')
+  return path.join(xdgData, 'opencode')
+}
+
+export function getDbPath() {
+  return path.join(getDataDir(), 'opencode.db')
+}
+
+export function getLogPath() {
+  return path.join(getDataDir(), 'log', 'opencode.log')
+}

package/src/harnesses/opencode/index.js

@@ -0,0 +1,46 @@
+/**
+ * opencode harness 配置
+ *
+ * opencode 是 AI coding agent，通过 npm 全局包 opencode-ai 安装（binary: opencode）。
+ * 数据目录跨平台（db.js），会话清理复用 clear.js。
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { getDataDir, getDbPath, getLogPath } from './db.js'
+import { runClear } from './clear.js'
+
+/**
+ * 查找 opencode 配置文件路径（优先 .jsonc，其次 .json）
+ * @returns {string|null}
+ */
+function findConfigFile() {
+  const dir = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config')
+  const base = path.join(dir, 'opencode')
+  for (const file of ['opencode.jsonc', 'opencode.json']) {
+    const full = path.join(base, file)
+    if (fs.existsSync(full)) return full
+  }
+  return null
+}
+
+export const opencodeHarness = {
+  name: 'opencode',
+  desc: 'opencode AI coding agent',
+  npmPackage: 'opencode-ai',
+  getConfigFile: findConfigFile,
+  getDataDir,
+  getDbPath,
+  getLogPath,
+  clear: runClear,
+  clearOptions: [
+    ['-d, --days <n>', 'Keep sessions from the last n days (default 1)'],
+    ['-h, --hours <n>', 'Keep sessions from the last n hours'],
+    ['-n, --num <n>', 'Keep the most recent n sessions'],
+    ['--dry-run', 'Preview only, do not modify anything'],
+    ['-y, --yes', 'Skip the confirmation prompt'],
+    ['--backup', 'Backup the DB before deleting (default: off)'],
+    ['--db <path>', 'Override the opencode database path'],
+  ],
+}