@wwkit/opm 1.0.1

package/src/harnesses/opencode/sqlite.js

@@ -0,0 +1,200 @@
+/**
+ * 跨平台 SQLite 访问驱动
+ *
+ * 优先使用 Node 内置 node:sqlite（Node >= 22.5，零依赖）；
+ * 不可用时回退到 sqlite3 CLI（跨平台均可用，依赖本机 sqlite3）；
+ * 两者皆不可用时抛出带提示的错误。
+ *
+ * 统一接口（供清理逻辑使用）：
+ *   listBefore(boundaryMs)   -> [{ id, title, time_created }]（按时间倒序）
+ *   listSessionsAsc()        -> [{ id, title, time_created }]（按时间正序，供 -n/--num 用）
+ *   listAll()                -> [{ id, title }]
+ *   countBefore(boundaryMs)  -> number
+ *   deleteBefore(boundaryMs) -> void（删除会话 + 关联事件，并 VACUUM）
+ *   deleteSessions(ids)      -> void（删除指定 id 的会话 + 关联事件，并 VACUUM）
+ *   checkpoint()             -> void（尽力 WAL 落盘，失败忽略）
+ *   close()                  -> void
+ */
+
+import { execFileSync } from 'node:child_process'
+
+const BOUNDARY_COL = 'time_created'
+
+export async function detectDriver() {
+  try {
+    await import('node:sqlite')
+    return 'node'
+  } catch {}
+  if (hasSqlite3Cli()) {
+    return 'cli'
+  }
+  return null
+}
+
+export async function openDb(dbPath) {
+  const driver = await detectDriver()
+  if (driver === 'node') {
+    const { DatabaseSync } = await import('node:sqlite')
+    return new NodeSqliteDriver(new DatabaseSync(dbPath))
+  }
+  if (driver === 'cli') {
+    return new CliSqliteDriver(dbPath)
+  }
+  throw new Error(
+    'no SQLite backend available: upgrade to Node >= 22.5 (built-in node:sqlite) ' +
+    'or install the sqlite3 CLI to use "opm opencode clear"'
+  )
+}
+
+function hasSqlite3Cli() {
+  try {
+    execFileSync('sqlite3', ['--version'], { stdio: 'ignore' })
+    return true
+  } catch {
+    return false
+  }
+}
+
+export class NodeSqliteDriver {
+  constructor(db) {
+    this.db = db
+    this.db.exec('PRAGMA foreign_keys=ON')
+  }
+
+  listBefore(boundaryMs) {
+    const stmt = this.db.prepare(
+      `SELECT id, title, ${BOUNDARY_COL} AS time_created
+       FROM session WHERE ${BOUNDARY_COL} < ? ORDER BY ${BOUNDARY_COL} DESC`
+    )
+    return stmt.all(boundaryMs)
+  }
+
+  listSessionsAsc() {
+    const stmt = this.db.prepare(
+      `SELECT id, title, ${BOUNDARY_COL} AS time_created
+       FROM session ORDER BY ${BOUNDARY_COL} ASC`
+    )
+    return stmt.all()
+  }
+
+  listAll() {
+    const stmt = this.db.prepare('SELECT id, title FROM session ORDER BY time_created DESC')
+    return stmt.all()
+  }
+
+  countBefore(boundaryMs) {
+    const stmt = this.db.prepare(`SELECT COUNT(*) AS n FROM session WHERE ${BOUNDARY_COL} < ?`)
+    return Number(stmt.get(boundaryMs).n)
+  }
+
+  deleteBefore(boundaryMs) {
+    this._deleteWhere(`${BOUNDARY_COL} < ${boundaryMs}`)
+  }
+
+  deleteSessions(ids) {
+    const list = ids.map((id) => `'${String(id).replace(/'/g, "''")}'`).join(', ')
+    this._deleteWhere(`id IN (${list})`)
+  }
+
+  _deleteWhere(condition) {
+    this.db.exec('BEGIN')
+    try {
+      this.db.prepare(
+        `DELETE FROM event_sequence WHERE aggregate_id IN (SELECT id FROM session WHERE ${condition})`
+      ).run()
+      this.db.prepare(`DELETE FROM session WHERE ${condition}`).run()
+      this.db.exec('COMMIT')
+    } catch (err) {
+      this.db.exec('ROLLBACK')
+      throw err
+    }
+    this.db.exec('VACUUM')
+  }
+
+  checkpoint() {
+    try {
+      this.db.exec('PRAGMA wal_checkpoint(FULL)')
+    } catch {}
+  }
+
+  close() {
+    try {
+      this.db.close()
+    } catch {}
+  }
+}
+
+export class CliSqliteDriver {
+  constructor(dbPath) {
+    this.dbPath = dbPath
+  }
+
+  _run(sql) {
+    return execFileSync('sqlite3', [this.dbPath, sql], { encoding: 'utf8' })
+  }
+
+  _parseRows(out) {
+    const rows = []
+    for (const line of out.trim().split('\n')) {
+      if (!line) continue
+      const parts = line.split('\u0001')
+      if (parts.length >= 3) {
+        rows.push({ id: parts[0], title: parts[1], time_created: Number(parts[2]) })
+      }
+    }
+    return rows
+  }
+
+  listBefore(boundaryMs) {
+    const sql = `SELECT id || char(1) || title || char(1) || ${BOUNDARY_COL}
+       FROM session WHERE ${BOUNDARY_COL} < ${boundaryMs} ORDER BY ${BOUNDARY_COL} DESC;`
+    return this._parseRows(this._run(sql))
+  }
+
+  listSessionsAsc() {
+    const sql = `SELECT id || char(1) || title || char(1) || ${BOUNDARY_COL}
+       FROM session ORDER BY ${BOUNDARY_COL} ASC;`
+    return this._parseRows(this._run(sql))
+  }
+
+  listAll() {
+    const sql = `SELECT id || char(1) || title
+       FROM session ORDER BY time_created DESC;`
+    const out = this._run(sql)
+    const rows = []
+    for (const line of out.trim().split('\n')) {
+      if (!line) continue
+      const idx = line.indexOf('\u0001')
+      if (idx > 0) {
+        rows.push({ id: line.slice(0, idx), title: line.slice(idx + 1) })
+      }
+    }
+    return rows
+  }
+
+  countBefore(boundaryMs) {
+    const out = this._run(`SELECT count(*) FROM session WHERE ${BOUNDARY_COL} < ${boundaryMs};`).trim()
+    return Number(out || 0)
+  }
+
+  deleteBefore(boundaryMs) {
+    this._deleteWhere(`${BOUNDARY_COL} < ${boundaryMs}`)
+  }
+
+  deleteSessions(ids) {
+    const list = ids.map((id) => `'${String(id).replace(/'/g, "''")}'`).join(', ')
+    this._deleteWhere(`id IN (${list})`)
+  }
+
+  _deleteWhere(condition) {
+    const sql = `PRAGMA foreign_keys=ON;
+DELETE FROM event_sequence WHERE aggregate_id IN (SELECT id FROM session WHERE ${condition});
+DELETE FROM session WHERE ${condition};
+VACUUM;`
+    this._run(sql)
+  }
+
+  checkpoint() {}
+
+  close() {}
+}

package/src/index.js

@@ -0,0 +1,46 @@
+/**
+ * @wwkit/opm 库入口
+ *
+ * 统一命令行工具（包管理 npm/pip/dnf/apt/brew/composer/bun + 运行时版本管理
+ * node/php/python + 版本管理器 nvm/phpenv/uv + opencode 运维），
+ * CLI 与各组件的可复用 API 均从此导出。
+ */
+
+export { CLI, GROUPS } from './cli/index.js'
+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 { BinaryGroup } from './binaries/base.js'
+export { CftGroup } from './binaries/cft/index.js'
+export { NvmGroup } from './cli/groups/nvm.js'
+export { PhpenvGroup } from './cli/groups/phpenv.js'
+export { UvGroup } from './cli/groups/uv.js'
+export { ToolManagerGroup } from './cli/groups/version-manager.js'
+export { parseFlags } from './cli/helpers/args.js'
+
+export { PackageManager } from './managers/base.js'
+export { RuntimeManager } from './managers/runtime.js'
+export { NpmManager } from './managers/npm.js'
+export { PipManager } from './managers/pip.js'
+export { DnfManager } from './managers/dnf.js'
+export { AptManager } from './managers/apt.js'
+export { BrewManager } from './managers/brew.js'
+export { ComposerManager } from './managers/composer.js'
+export { BunManager } from './managers/bun.js'
+export { NodeManager, isNvmInstalled, getNvmSh } from './managers/node.js'
+export { PhpManager, isPhpenvInstalled, getPhpenvBin } from './managers/php.js'
+export { PythonManager, isUvInstalled, getUvBin } from './managers/python.js'
+
+export {
+  NPM_PRESETS, PIP_PRESETS, DNF_PRESETS, APT_PRESETS, BREW_PRESETS, COMPOSER_PRESETS,
+  BUN_PRESETS, NVM_PRESETS, NODE_PRESETS, PHPENV_PRESETS, PHP_PRESETS, PYTHON_PRESETS,
+  getPresets, resolveRegistryInput,
+} from './presets.js'
+export { PROXY_PRESETS } from './proxy-presets.js'
+export { output } from './formatter.js'
+export { downloadToFile, fetchText } from './managers/http.js'
+export {
+  getConfig, getSection, copyBuiltinConfig, getActiveRegistry, setActiveRegistry,
+  getUserConfigDir, getUserConfigFile, getActiveProxy,
+} from './config.js'

package/src/managers/apt.js

@@ -0,0 +1,377 @@
+/**
+ * apt 包管理器实现
+ *
+ * 通过执行 apt / apt-cache / dpkg-query CLI 命令实现统一接口（Debian / Ubuntu 系）。
+ * apt 是系统级包管理器，所有操作均作用于系统（无用户级/local 概念）。
+ *
+ * 源查询使用 apt-cache，本地查询使用 dpkg-query / apt list。
+ */
+
+import { execSync, spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import { PackageManager } from './base.js'
+import { getActiveRegistry, setActiveRegistry } from '../config.js'
+
+const SOURCES_LIST = '/etc/apt/sources.list'
+const SOURCES_DIR = '/etc/apt/sources.list.d'
+
+const SHOW_KEYS = new Set([
+  'package', 'version', 'architecture', 'maintainer', 'installed-size',
+  'homepage', 'priority', 'section', 'description'
+])
+
+export class AptManager extends PackageManager {
+  constructor() {
+    super()
+    this.name = 'apt'
+  }
+
+  /**
+   * 对包含特殊字符的参数进行 shell 转义（单引号包裹）
+   * @param {string} arg
+   * @returns {string}
+   * @private
+   */
+  _quoteArg(arg) {
+    if (arg && /[\s'"$`\\]/.test(arg)) {
+      return `'${arg.replace(/'/g, `'\\''`)}'`
+    }
+    return arg
+  }
+
+  /**
+   * 执行 apt 命令，返回 stdout
+   * @param {string[]} args
+   * @param {object} [opts]
+   * @returns {string}
+   * @private
+   */
+  _exec(args, opts = {}) {
+    const cmd = ['apt', ...args].map((a) => this._quoteArg(a)).join(' ')
+    try {
+      return execSync(cmd, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], ...opts })
+    } catch (err) {
+      if (opts.allowNonZero) {
+        return err.stdout ? err.stdout.toString() : ''
+      }
+      const stderr = err.stderr ? err.stderr.toString().trim() : ''
+      if (stderr && !stderr.startsWith('W:') && !stderr.startsWith('N:')) {
+        throw new Error(stderr)
+      }
+      return err.stdout ? err.stdout.toString() : ''
+    }
+  }
+
+  /**
+   * 执行 apt 命令，输出直接继承到终端（用于 install/remove/upgrade）
+   * @param {string[]} args
+   * @private
+   */
+  _execInherit(args) {
+    const result = spawnSync('apt', args, { stdio: 'inherit', shell: true })
+    if (result.error) {
+      throw new Error(result.error.message)
+    }
+    if (result.status !== 0) {
+      throw new Error(`apt ${args.join(' ')} exited with code ${result.status}`)
+    }
+  }
+
+  /**
+   * 构造 apt 代理参数（http/https 代理）
+   * @param {string} [proxy] - 代理地址
+   * @returns {string[]}
+   * @private
+   */
+  _proxyArgs(proxy) {
+    if (!proxy) return []
+    return ['-o', `Acquire::http::Proxy=${proxy}`, '-o', `Acquire::https::Proxy=${proxy}`]
+  }
+
+  /**
+   * 过滤 apt 输出中的噪音行，返回有意义的行
+   * @param {string} out
+   * @returns {string[]}
+   * @private
+   */
+  _parseLines(out) {
+    const lines = []
+    for (const line of out.split('\n')) {
+      const trimmed = line.trim()
+      if (!trimmed) continue
+      if (trimmed.startsWith('W:') || trimmed.startsWith('N:')) continue
+      if (trimmed.startsWith('Listing')) continue
+      lines.push(trimmed)
+    }
+    return lines
+  }
+
+  /**
+   * 解析 apt 源文件文本（sources.list / *.list）中的二进制 deb 行
+   *
+   * 仅支持经典的 deb 行语法（含 [arch=...] 选项），不支持 deb822（*.sources）格式。
+   * 支持反斜杠续行。
+   *
+   * @param {string} text
+   * @returns {{ id: string, url: string }[]}
+   * @private
+   */
+  _parseSources(text) {
+    const repos = []
+    let continuation = ''
+    for (const rawLine of text.split('\n')) {
+      let line = rawLine.trim()
+      if (continuation) {
+        line = continuation + ' ' + line
+        continuation = ''
+      }
+      if (line.endsWith('\\')) {
+        continuation = line.slice(0, -1)
+        continue
+      }
+      if (!line || line.startsWith('#')) continue
+      const parts = line.split(/\s+/)
+      if (parts[0] !== 'deb') continue
+      const urlIdx = parts.findIndex((p) => /^https?:\/\//.test(p))
+      if (urlIdx < 0) continue
+      const suite = parts[urlIdx + 1] || 'deb'
+      repos.push({ id: suite, url: parts[urlIdx] })
+    }
+    return repos
+  }
+
+  /**
+   * 读取启用的 apt 源（不调用 apt，纯读配置文件）
+   *
+   * 解析 /etc/apt/sources.list 与 /etc/apt/sources.list.d/*.list，
+   * 提取 deb 行中的源 URL 与 suite 作为仓库 id。
+   *
+   * @param {string} [dir] - sources 目录（默认 /etc/apt/sources.list.d，测试可注入临时目录）
+   * @returns {{ id: string, url: string }[]}
+   * @private
+   */
+  _readEnabledRepos(dir = SOURCES_DIR) {
+    const repos = []
+    let files = [SOURCES_LIST]
+    try {
+      files = [SOURCES_LIST, ...fs.readdirSync(dir).map((f) => path.join(dir, f))]
+    } catch {}
+
+    for (const file of files) {
+      if (file !== SOURCES_LIST && !file.endsWith('.list')) continue
+      let text
+      try {
+        text = fs.readFileSync(file, 'utf8')
+      } catch {
+        continue
+      }
+      repos.push(...this._parseSources(text))
+    }
+    return repos
+  }
+
+  /**
+   * 查询某个包在所有源中的可用版本（去重，保留 madison 输出顺序）
+   * @param {string} name - 包名
+   * @param {{ proxy?: string }} [opts]
+   * @returns {string[]}
+   * @private
+   */
+  _availableVersions(name, opts = {}) {
+    const args = ['cache', 'madison', name, ...this._proxyArgs(opts.proxy)]
+    const out = this._exec(args, { allowNonZero: true })
+    const versions = []
+    for (const line of this._parseLines(out)) {
+      const parts = line.split('|').map((s) => s.trim())
+      if (parts.length >= 2 && !parts[1].includes(' ')) {
+        versions.push(parts[1])
+      }
+    }
+    return [...new Set(versions)]
+  }
+
+  async getVersion() {
+    try {
+      const out = this._exec(['--version'], { allowNonZero: true })
+      const match = out.match(/(\d+(?:\.\d+)+)/)
+      if (match) {
+        return { name: 'apt', installed: true, version: match[1] }
+      }
+      if (out.trim()) {
+        return { name: 'apt', installed: true, version: out.trim().split('\n')[0] }
+      }
+    } catch {}
+    return { name: 'apt', version: '', installed: false, hint: 'apt is the package manager for Debian / Ubuntu-based systems' }
+  }
+
+  async getRegistry() {
+    const registry = getActiveRegistry('apt') || '(no active registry in opm config)'
+    return { registry }
+  }
+
+  async setRegistry(url) {
+    const resolved = setActiveRegistry('apt', url)
+    const line = resolved.startsWith('deb ')
+      ? resolved
+      : `deb ${resolved} stable main`
+    const repoFile = path.join(SOURCES_DIR, 'opm.list')
+    try {
+      fs.writeFileSync(repoFile, `${line}\n`, 'utf8')
+    } catch (err) {
+      throw new Error(`failed to write ${repoFile}: ${err.message}`)
+    }
+    return { registry: line }
+  }
+
+  async searchPackage(name, version, opts = {}) {
+    const { registry } = await this.getRegistry()
+    const versions = this._availableVersions(name, opts)
+
+    if (versions.length === 0) {
+      if (version) {
+        return { name, version, exists: false, available: false, registry }
+      }
+      return { name, exists: false, registry }
+    }
+
+    if (version) {
+      return { name, version, exists: true, available: versions.includes(version), registry }
+    }
+
+    return {
+      name,
+      exists: true,
+      latest: versions[versions.length - 1],
+      versions,
+      registry
+    }
+  }
+
+  async isInstalled(name, opts = {}) {
+    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+)$/)
+    if (m) {
+      return { name, installed: true, version: m[1] }
+    }
+    return { name, installed: false }
+  }
+
+  /**
+   * 解析 apt-cache show 输出为字段映射（取第一个包段）
+   * @param {string} out
+   * @returns {Record<string, string>|null}
+   * @private
+   */
+  _parseShow(out) {
+    const info = {}
+    let descriptionLines = []
+    let inDescription = false
+
+    for (const rawLine of out.split('\n')) {
+      const idx = rawLine.indexOf(':')
+      if (idx > 0) {
+        const key = rawLine.slice(0, idx).trim().toLowerCase()
+        if (SHOW_KEYS.has(key)) {
+          const val = rawLine.slice(idx + 1).trim()
+          if (key === 'description') {
+            descriptionLines = [val]
+            inDescription = true
+            continue
+          }
+          if (!(key in info)) {
+            info[key] = val
+          }
+          inDescription = false
+          continue
+        }
+      }
+      if (inDescription && rawLine.trim()) {
+        descriptionLines.push(rawLine.trim())
+      }
+    }
+
+    if (descriptionLines.length > 0) {
+      info.description = descriptionLines.join(' ')
+    }
+
+    return info.package ? info : null
+  }
+
+  async packageInfo(name, opts = {}) {
+    const out = this._exec(['cache', 'show', name, ...this._proxyArgs(opts.proxy)], { allowNonZero: true })
+    const info = this._parseShow(out)
+    if (!info) {
+      return { name, description: '(not found)' }
+    }
+
+    return {
+      name,
+      description: info.description || '',
+      latest: info.version || '',
+      homepage: info.homepage || '',
+      license: '',
+      author: info.maintainer || '',
+      repository: info.section || ''
+    }
+  }
+
+  async packageVersions(name, opts = {}) {
+    const { registry } = await this.getRegistry()
+    const versions = this._availableVersions(name, opts)
+    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 = []
+    for (const line of this._parseLines(out)) {
+      const m = line.match(/^(\S+?)\/(\S+)\s+(\S+)\s+(\S+)\s+\[(.*?)\]$/)
+      if (m) {
+        const from = m[5].match(/upgradable from:\s*(\S+)/)
+        items.push({
+          name: m[1],
+          current: from ? from[1] : '',
+          latest: m[3]
+        })
+      }
+    }
+    return items
+  }
+
+  async install(name, version, opts = {}) {
+    const spec = version ? `${name}=${version}` : name
+    const args = ['get', 'install', '-y', spec, ...this._proxyArgs(opts.proxy)]
+    this._execInherit(args)
+    return { name, version: version || 'latest', action: 'installed' }
+  }
+
+  async uninstall(name, opts = {}) {
+    this._execInherit(['get', 'remove', '-y', name])
+    return { name, action: 'uninstalled' }
+  }
+
+  async upgrade(name, opts = {}) {
+    const args = ['get', 'install', '--only-upgrade', '-y', name, ...this._proxyArgs(opts.proxy)]
+    this._execInherit(args)
+    return { name, version: 'latest', action: 'upgraded' }
+  }
+
+  async cleanCache() {
+    this._execInherit(['get', 'clean'])
+    return { action: 'cache cleaned' }
+  }
+}