@esign-ai/veriagent-cli 1.0.0

package/README.md

@@ -0,0 +1,115 @@
+# @esign-ai/veriagent-cli
+
+VeriAgent CLI 是统一安装入口，用于在当前终端为 OpenClaw 或 Hermes 安装并初始化 VeriAgent 插件。
+
+## 功能概览
+
+| 能力 | 说明 |
+|---|---|
+| 交互安装 | 让用户选择安装到 OpenClaw 或 Hermes |
+| 指定目标安装 | 通过命令参数直接指定 OpenClaw 或 Hermes |
+| 依赖检查 | 检查目标 CLI 是否可用，Hermes 会校验最低版本 |
+| 插件安装 | 调用目标宿主的插件安装命令 |
+| 初始化 | 安装后自动进入 VeriAgent 初始化流程 |
+
+## 环境要求
+
+| 项 | 要求 |
+|---|---|
+| Node.js | 18 或以上 |
+| OpenClaw | 安装 OpenClaw 时需要当前终端可执行 `openclaw` |
+| Hermes | 安装 Hermes 时需要当前终端可执行 `hermes` |
+| 浏览器 | VeriAgent 初始化流程需要打开授权页面 |
+| 网络 | 可访问目标插件源和 VeriAgent 服务 |
+
+## 使用方式
+
+交互选择：
+
+```bash
+npx -y @esign-ai/veriagent-cli install
+```
+
+指定安装到 OpenClaw：
+
+```bash
+npx -y @esign-ai/veriagent-cli install openclaw
+```
+
+指定安装到 Hermes：
+
+```bash
+npx -y @esign-ai/veriagent-cli install hermes
+```
+
+## OpenClaw 安装流程
+
+```text
+veriagent-cli install openclaw
+  -> 检查 openclaw 命令
+  -> 安装 @esign-ai/openclaw-veriagent
+  -> 重启 OpenClaw Gateway
+  -> 执行 openclaw veriagent init
+  -> 打开授权页面并完成 VeriAgent 初始化
+```
+
+等价执行：
+
+```bash
+openclaw plugins install clawhub:@esign-ai/openclaw-veriagent
+openclaw gateway restart
+openclaw veriagent init
+```
+
+如果插件已存在，CLI 会继续执行 Gateway 重启和 VeriAgent 初始化。
+
+## Hermes 安装流程
+
+```text
+veriagent-cli install hermes
+  -> 检查 hermes 命令
+  -> 校验 Hermes 版本
+  -> 安装 hermes-veriagent 插件
+  -> 启用 hermes-veriagent 插件
+  -> 执行 hermes veriagent init
+  -> 打开授权页面并完成 VeriAgent 初始化
+```
+
+等价执行：
+
+```bash
+hermes --version
+hermes plugins install https://github.com/esign-ai/hermes-veriagent.git
+hermes plugins enable hermes-veriagent
+hermes veriagent init
+```
+
+Hermes 版本需要满足 CLI 内置的最低版本要求。
+
+## 初始化结果
+
+安装完成后，可在目标宿主中查看 VeriAgent 状态。
+
+OpenClaw：
+
+```bash
+openclaw veriagent status
+```
+
+Hermes：
+
+```bash
+hermes veriagent status
+```
+
+状态中应包含本地 `agentId` 和 `certificateFile`。
+
+## 注意事项
+
+| 事项 | 说明 |
+|---|---|
+| 当前终端执行 | CLI 会在当前终端顺序执行目标宿主命令 |
+| 重复安装 | 已安装插件时会继续执行后续初始化步骤 |
+| 浏览器授权 | 初始化过程中需要用户在浏览器完成授权 |
+| Hermes 版本 | 版本不足时需要先升级 Hermes |
+| OpenClaw Gateway | OpenClaw 插件安装后会重启 Gateway |

package/index.js

@@ -0,0 +1,475 @@
+#!/usr/bin/env node
+
+const fs = require('fs')
+const os = require('os')
+const path = require('path')
+const { spawn } = require('child_process')
+const readline = require('readline')
+
+const OPENCLAW_PACKAGE_NAME = '@esign-ai/openclaw-veriagent'
+const HERMES_PLUGIN_SOURCE = 'https://github.com/esign-ai/hermes-veriagent.git'
+const OPENCLAW_COMMAND = 'openclaw'
+const HERMES_COMMAND = 'hermes'
+const MIN_HERMES_VERSION = '0.14.0'
+const OPENCLAW_GATEWAY_WAIT_MS = 1000
+const HERMES_GATEWAY_WAIT_MS = 1000
+const LOG_PREFIX = ''
+const LOG_PREFIX_COLOR = [104, 194, 206]
+
+main().catch(error => {
+  const message = String(error && error.message ? error.message : error)
+  console.error(`\n${formatPrefixedMessage(`安装未完成：${message}`)}`)
+  process.exitCode = 1
+})
+
+async function main() {
+  const cliArgs = parseCliArgs(process.argv.slice(2))
+  const arg = cliArgs.targetArg
+  const requestedVersion = cliArgs.requestedVersion
+
+  if (cliArgs.showHelp) {
+    printHelp()
+    return
+  }
+
+  const target = await resolveTarget(arg, requestedVersion)
+  console.log(formatPrefixedMessage(`已选择：${target.label}`))
+  console.log(formatPrefixedMessage('将执行以下命令：'))
+  target.steps.filter(step => !step.silent).forEach((step, index) => {
+    console.log(`  ${index + 1}. ${describeStep(step)}`)
+  })
+
+  for (const step of target.steps) {
+    await runStep(step)
+  }
+
+  console.log(`\n${formatPrefixedMessage(`${target.label} 安装流程已执行完成。`)}`)
+}
+
+function printHelp() {
+  console.log('@esign-ai/veriagent-cli')
+  console.log('')
+  console.log('用法：')
+  console.log('  npx -y @esign-ai/veriagent-cli install')
+  console.log('  npx -y @esign-ai/veriagent-cli install openclaw')
+  console.log('  npx -y @esign-ai/veriagent-cli install hermes')
+  console.log('')
+  console.log('当前支持的目标：')
+  getTargets().forEach(target => {
+    console.log(`  - ${target.id}: ${target.description}`)
+  })
+}
+
+function parseCliArgs(argv) {
+  const args = argv.map(item => String(item || '').trim()).filter(Boolean)
+  const firstArg = String(args[0] || '').toLowerCase()
+
+  if (!firstArg) {
+    return {
+      showHelp: false,
+      targetArg: '',
+      requestedVersion: '',
+    }
+  }
+
+  if (firstArg === '--help' || firstArg === '-h' || firstArg === 'help') {
+    return {
+      showHelp: true,
+      targetArg: '',
+      requestedVersion: '',
+    }
+  }
+
+  if (firstArg === 'install') {
+    return {
+      showHelp: false,
+      targetArg: String(args[1] || '').toLowerCase(),
+      requestedVersion: normalizeVersionArg(args[2]),
+    }
+  }
+
+  return {
+    showHelp: false,
+    targetArg: firstArg,
+    requestedVersion: normalizeVersionArg(args[1]),
+  }
+}
+
+async function resolveTarget(arg, requestedVersion) {
+  const targets = getTargets(requestedVersion)
+
+  if (arg) {
+    const target = targets.find(item => item.id === arg || (item.aliases || []).includes(arg))
+    if (!target) {
+      const availableTargets = targets
+        .flatMap(item => [item.id].concat(item.aliases || []))
+        .join(', ')
+      throw new Error(`不支持的目标：${arg}。可用值：${availableTargets}`)
+    }
+    return target
+  }
+
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return targets[0]
+  }
+
+  return promptTargetSelection(targets)
+}
+
+function promptTargetSelection(targets) {
+  return new Promise((resolve, reject) => {
+    console.log('支持的 Agent 安装目标：')
+    targets.forEach((target, index) => {
+      console.log(`  ${index + 1}. ${target.label} - ${target.description}`)
+    })
+
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    })
+
+    rl.question('请选择要安装的目标，默认 1：', answer => {
+      rl.close()
+      const normalized = String(answer || '').trim()
+      if (!normalized) {
+        resolve(targets[0])
+        return
+      }
+
+      const index = Number(normalized)
+      if (!Number.isInteger(index) || index < 1 || index > targets.length) {
+        reject(new Error(`无效选项：${normalized}`))
+        return
+      }
+
+      resolve(targets[index - 1])
+    })
+  })
+}
+
+async function runStep(step) {
+  if (step.type === 'delay') {
+    if (!step.silent) {
+      console.log(`\n${formatPrefixedMessage(step.label)}`)
+      console.log(formatPrefixedMessage(step.message))
+    }
+    await sleep(step.durationMs)
+    return
+  }
+
+  if (step.type === 'hermes-version-check') {
+    console.log(`\n${formatPrefixedMessage(step.label)}`)
+    await checkHermesVersion(step.minimumVersion)
+    return
+  }
+
+  console.log(`\n${formatPrefixedMessage(step.label)}`)
+  console.log(formatPrefixedMessage(formatCommand(step.command, step.args)))
+
+  const commandAvailable = await isCommandAvailable(step.command)
+  if (!commandAvailable) {
+    throw new Error(`找不到命令 \`${step.command}\`，请先确认本机已安装，并且在当前终端环境中可直接执行。`)
+  }
+
+  await new Promise((resolve, reject) => {
+    const spawnConfig = createSpawnConfig(step.command, step.args)
+    const shouldCaptureOutput = Array.isArray(step.continueOnOutput) && step.continueOnOutput.length > 0
+    const child = spawn(spawnConfig.command, spawnConfig.args, {
+      ...spawnConfig.options,
+      stdio: shouldCaptureOutput ? ['inherit', 'pipe', 'pipe'] : 'inherit',
+    })
+    let output = ''
+
+    if (shouldCaptureOutput) {
+      child.stdout.on('data', chunk => {
+        output += String(chunk)
+        process.stdout.write(chunk)
+      })
+      child.stderr.on('data', chunk => {
+        output += String(chunk)
+        process.stderr.write(chunk)
+      })
+    }
+
+    child.on('error', error => {
+      if (error && error.code === 'ENOENT') {
+        reject(new Error(`找不到命令 \`${step.command}\`，请先确认本机已安装，并且在当前终端环境中可直接执行。`))
+        return
+      }
+      reject(error)
+    })
+
+    child.on('exit', code => {
+      if (code === 0) {
+        resolve()
+        return
+      }
+      if (code === 127) {
+        reject(new Error(`找不到命令 \`${step.command}\`，请先确认本机已安装，并且在登录 shell 中可直接执行。`))
+        return
+      }
+      if (shouldContinueAfterStepFailure(step, output)) {
+        console.log(formatPrefixedMessage(step.continueMessage || '检测到当前步骤已完成，继续执行后续流程。'))
+        resolve()
+        return
+      }
+      reject(new Error(`命令退出码异常：${code}`))
+    })
+  })
+}
+
+function shouldContinueAfterStepFailure(step, output) {
+  const patterns = Array.isArray(step.continueOnOutput) ? step.continueOnOutput : []
+  const normalizedOutput = String(output || '')
+  return patterns.some(pattern => pattern.test(normalizedOutput))
+}
+
+function formatCommand(command, args) {
+  return [command].concat(args).join(' ')
+}
+
+function describeStep(step) {
+  if (step.type === 'delay') {
+    return step.message
+  }
+  if (step.type === 'hermes-version-check') {
+    return `检查 Hermes 版本 >= ${step.minimumVersion}`
+  }
+  return formatCommand(step.command, step.args)
+}
+
+function createSpawnConfig(command, args) {
+  return {
+    command,
+    args,
+    options: {
+      stdio: 'inherit',
+      shell: true,
+    },
+  }
+}
+
+function formatShellCommand(command, args) {
+  return [command].concat(args).map(quoteShellArg).join(' ')
+}
+
+function quoteShellArg(value) {
+  const raw = String(value)
+  if (!raw) {
+    return "''"
+  }
+  return `'${raw.replace(/'/g, `'\\''`)}'`
+}
+
+function resolveShell() {
+  const shell = String(process.env.SHELL || '').trim()
+  return shell || '/bin/bash'
+}
+
+function formatPrefixedMessage(message) {
+  return `${formatLogPrefix()} ${message}`
+}
+
+function formatLogPrefix() {
+  if (!process.stdout.isTTY && !process.stderr.isTTY) {
+    return LOG_PREFIX
+  }
+
+  const [red, green, blue] = LOG_PREFIX_COLOR
+  return `\x1b[38;2;${red};${green};${blue}m${LOG_PREFIX}\x1b[0m`
+}
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms))
+}
+
+function getTargets(requestedVersion) {
+  return [
+    {
+      id: 'openclaw',
+      label: 'OpenClaw',
+      description: '安装 OpenClaw VeriAgent 插件并直接调用 VeriAgent CLI 安装流程',
+      steps: [
+        {
+          label: '安装 OpenClaw 插件',
+          command: OPENCLAW_COMMAND,
+          args: ['plugins', 'install', buildOpenClawPackageSpecifier(requestedVersion)],
+          continueOnOutput: [/plugin already exists/i],
+          continueMessage: 'OpenClaw 插件已存在，跳过安装并继续后续流程。',
+        },
+        {
+          label: '重启 OpenClaw Gateway',
+          command: OPENCLAW_COMMAND,
+          args: ['gateway', 'restart'],
+        },
+        {
+          label: '等待 OpenClaw Gateway 就绪',
+          type: 'delay',
+          silent: true,
+          durationMs: OPENCLAW_GATEWAY_WAIT_MS,
+          message: `等待 ${OPENCLAW_GATEWAY_WAIT_MS / 1000} 秒，确保 OpenClaw Gateway 完成重启`,
+        },
+        {
+          label: '触发 VeriAgent 安装流程',
+          command: OPENCLAW_COMMAND,
+          args: ['veriagent', 'init'],
+        },
+      ],
+    },
+    {
+      id: 'hermes',
+      label: 'Hermes',
+      description: '安装 Hermes VeriAgent 插件并初始化',
+      steps: [
+        {
+          label: '检查 Hermes 版本',
+          type: 'hermes-version-check',
+          minimumVersion: MIN_HERMES_VERSION,
+        },
+        {
+          label: '安装 Hermes VeriAgent 插件',
+          command: HERMES_COMMAND,
+          args: ['plugins', 'install', buildHermesPackageSpecifier(requestedVersion)],
+          continueOnOutput: [/Plugin 'hermes-veriagent' already exists/i],
+          continueMessage: 'Hermes VeriAgent 插件已存在，跳过安装并继续后续流程。',
+        },
+        {
+          label: '启用 Hermes VeriAgent 插件',
+          command: HERMES_COMMAND,
+          args: ['plugins', 'enable', 'hermes-veriagent'],
+        },
+        {
+          label: '触发 VeriAgent 安装流程',
+          command: HERMES_COMMAND,
+          args: ['veriagent', 'init'],
+        },
+      ],
+    },
+  ]
+}
+
+function buildOpenClawPackageSpecifier(version) {
+  const specifier = version ? `${OPENCLAW_PACKAGE_NAME}@${version}` : OPENCLAW_PACKAGE_NAME
+  return `clawhub:${specifier}`
+}
+
+function buildHermesPackageSpecifier(version) {
+  return HERMES_PLUGIN_SOURCE
+}
+
+function normalizeVersionArg(value) {
+  return String(value || '').trim()
+}
+
+async function checkHermesVersion(minimumVersion) {
+  const commandAvailable = await isCommandAvailable(HERMES_COMMAND)
+  if (!commandAvailable) {
+    throw new Error('找不到命令 `hermes`，请先安装 Hermes，并确认当前终端可直接执行。')
+  }
+
+  const output = await captureCommand(HERMES_COMMAND, ['--version'])
+  const currentVersion = extractSemver(output)
+  if (!currentVersion) {
+    throw new Error(`无法识别 Hermes 版本输出：${output || '(empty)'}`)
+  }
+
+  if (compareSemver(currentVersion, minimumVersion) < 0) {
+    throw new Error(
+      `当前 Hermes 版本为 ${currentVersion}，VeriAgent 需要 Hermes >= ${minimumVersion}。` +
+      '请先执行 `hermes update`，再重新运行本命令。'
+    )
+  }
+
+  console.log(formatPrefixedMessage(`Hermes 版本检查通过：${currentVersion}`))
+}
+
+function captureCommand(command, args) {
+  return new Promise((resolve, reject) => {
+    const spawnConfig = createSpawnConfig(command, args)
+    const child = spawn(spawnConfig.command, spawnConfig.args, {
+      ...spawnConfig.options,
+      stdio: ['ignore', 'pipe', 'pipe'],
+    })
+    let stdout = ''
+    let stderr = ''
+
+    child.stdout.on('data', chunk => {
+      stdout += String(chunk)
+    })
+    child.stderr.on('data', chunk => {
+      stderr += String(chunk)
+    })
+    child.on('error', reject)
+    child.on('exit', code => {
+      const output = `${stdout}\n${stderr}`.trim()
+      if (code === 0) {
+        resolve(output)
+        return
+      }
+      reject(new Error(`命令执行失败：${formatCommand(command, args)}，退出码：${code}，输出：${output || '(empty)'}`))
+    })
+  })
+}
+
+function extractSemver(output) {
+  const match = String(output || '').match(/v?(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)/)
+  return match ? match[1] : ''
+}
+
+function compareSemver(left, right) {
+  const leftParts = parseSemverParts(left)
+  const rightParts = parseSemverParts(right)
+  for (let index = 0; index < 3; index += 1) {
+    if (leftParts[index] > rightParts[index]) {
+      return 1
+    }
+    if (leftParts[index] < rightParts[index]) {
+      return -1
+    }
+  }
+  return 0
+}
+
+function parseSemverParts(version) {
+  const parts = String(version || '')
+    .trim()
+    .replace(/^v/, '')
+    .split(/[.-]/)
+    .slice(0, 3)
+    .map(part => Number.parseInt(part, 10))
+
+  while (parts.length < 3) {
+    parts.push(0)
+  }
+
+  return parts.map(part => Number.isFinite(part) ? part : 0)
+}
+
+async function isCommandAvailable(command) {
+  if (isFileCommand(command)) {
+    return fs.existsSync(command)
+  }
+
+  return new Promise(resolve => {
+    const probe = process.platform === 'win32'
+      ? spawn(process.env.ComSpec || 'cmd.exe', ['/d', '/s', '/c', `where ${command}`], { stdio: 'ignore' })
+      : spawn(resolveShell(), ['-lc', `command -v ${quoteShellArg(command)} >/dev/null 2>&1`], { stdio: 'ignore' })
+
+    probe.on('error', () => resolve(false))
+    probe.on('exit', code => resolve(code === 0))
+  })
+}
+
+function isFileCommand(command) {
+  const normalized = String(command || '').trim()
+  return path.isAbsolute(normalized) || normalized.includes('/') || normalized.includes('\\')
+}
+
+function resolveOpenClawStateDir() {
+  const explicitStateDir = String(process.env.OPENCLAW_STATE_DIR || '').trim()
+  if (explicitStateDir) {
+    return explicitStateDir
+  }
+
+  return path.join(os.homedir(), '.openclaw')
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@esign-ai/veriagent-cli",
+  "version": "1.0.0",
+  "main": "index.js",
+  "bin": {
+    "veriagent-cli": "index.js"
+  },
+  "scripts": {
+    "build": "node scripts/build-package.js",
+    "package:cli": "npm run build && npm pack ./dist",
+    "publish:cli": "npm run build && npm publish ./dist"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  }
+}