@visa/cli 5.0.0-rc.409 → 5.0.0-rc.412

package/dist/skills/pair-visa-agent/scripts/setup.mjs

@@ -1,328 +0,0 @@
-#!/usr/bin/env node
-// Portable provisioner for the pair-visa-agent skill.
-//
-// Ensures the `visa` CLI is installed and serves the MCP tools the pairing skill
-// calls (`get_status` and `agent_enroll`, both in the CLI's six served tools) so
-// ANY Agent Skills runtime can pair — not just OpenClaw (whose
-// `metadata.openclaw.install` auto-runs). Hermes, Claude Code, and any other agentskills.io-compatible
-// runtime run this bundled script per the standard's `scripts/` execution stage.
-//
-// Safe to run repeatedly:
-// - Idempotent no-op when a compatible version with required tools is installed.
-// - Upgrades when a stale or incomplete binary (one without the six served tools) is found.
-// - Installs `@visa/cli@rc` when no binary exists.
-
-import { execFileSync } from 'node:child_process'
-import { existsSync, readFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { createRequire } from 'node:module'
-import { pathToFileURL } from 'node:url'
-
-export const DEFAULT_RELEASE_CHANNEL = 'rc'
-// 5.0.0-rc.335 is the first release serving the six tools (`SIX_TOOL_NAMES` in
-// packages/cli/src/mcp-server/six-tools.ts). The tools this list named before,
-// `agent_handoff_claim`, `agent_connect` and `agent_connect_poll`, were retired
-// with it, so a current CLI could never pass this check.
-export const MIN_COMPATIBLE_VERSION = '5.0.0-rc.335'
-export const REQUIRED_MCP_TOOLS = Object.freeze(['get_status', 'agent_enroll'])
-
-const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/
-
-export function parseSemver(v) {
-  if (typeof v !== 'string') return null
-  const cleaned = v.trim().replace(/^v/, '')
-  const m = cleaned.match(SEMVER_RE)
-  if (!m) return null
-  return {
-    major: Number(m[1]),
-    minor: Number(m[2]),
-    patch: Number(m[3]),
-    pre: m[4] ?? null,
-  }
-}
-
-/**
- * Returns true if `version` satisfies >= `minVersion`.
- * Rules (semver 2.0.0):
- * - Release (no prerelease) outranks any prerelease of the same major.minor.patch.
- * - For identical major.minor.patch with prerelease `rc.N`, compares N numerically.
- */
-export function isSemverCompatible(version, minVersion = MIN_COMPATIBLE_VERSION) {
-  const cur = parseSemver(version)
-  const min = parseSemver(minVersion)
-  if (!cur || !min) return false
-
-  if (cur.major !== min.major) return cur.major > min.major
-  if (cur.minor !== min.minor) return cur.minor > min.minor
-  if (cur.patch !== min.patch) return cur.patch > min.patch
-
-  // Both main versions are equal.
-  // A release version (no prerelease) outranks any prerelease of the same main version.
-  if (!cur.pre && min.pre) return true
-  if (cur.pre && !min.pre) return false
-  if (!cur.pre && !min.pre) return true
-
-  // Both have prereleases. Compare prerelease identifiers.
-  const curParts = cur.pre.split('.')
-  const minParts = min.pre.split('.')
-  const len = Math.max(curParts.length, minParts.length)
-
-  for (let i = 0; i < len; i++) {
-    if (i >= curParts.length) return false
-    if (i >= minParts.length) return true
-    const a = curParts[i]
-    const b = minParts[i]
-    const aNum = /^\d+$/.test(a)
-    const bNum = /^\d+$/.test(b)
-    if (aNum && bNum) {
-      const numA = Number(a)
-      const numB = Number(b)
-      if (numA !== numB) return numA > numB
-    } else if (aNum && !bNum) {
-      return false
-    } else if (!aNum && bNum) {
-      return true
-    } else if (a !== b) {
-      return a > b
-    }
-  }
-  return true
-}
-
-export function findCliBinary(execFn = execFileSync) {
-  for (const bin of ['visa', 'visa-cli']) {
-    try {
-      execFn(bin, ['--version'], { stdio: 'ignore', timeout: 5000 })
-      return bin
-    } catch {
-      // not resolvable or failed
-    }
-  }
-  return null
-}
-
-export function detectCliVersion(bin, execFn = execFileSync) {
-  if (!bin) return null
-
-  try {
-    const rawCap = execFn(bin, ['capabilities', '--format', 'json'], {
-      encoding: 'utf-8',
-      timeout: 5000,
-    })
-    const cap = JSON.parse(rawCap)
-    const version = cap?.data?.build?.version ?? cap?.build?.version
-    if (typeof version === 'string' && version.trim()) {
-      return version.trim()
-    }
-  } catch {
-    // fallback to --version
-  }
-
-  try {
-    const raw = execFn(bin, ['--version'], {
-      encoding: 'utf-8',
-      timeout: 5000,
-    })
-    const cleaned = raw.trim().replace(/^v/, '')
-    if (cleaned) return cleaned
-  } catch {
-    // unable to detect version
-  }
-
-  return null
-}
-
-function defaultLocalMcpBundlePath() {
-  try {
-    const req = createRequire(import.meta.url)
-    const pkgJson = req.resolve('@visa/cli/package.json')
-    return join(dirname(pkgJson), 'dist', 'mcp-server', 'index.js')
-  } catch {
-    return null
-  }
-}
-
-export function resolveMcpBundlePath(
-  npmRootFn = () => execFileSync('npm', ['root', '-g'], { encoding: 'utf-8' }),
-  localBundleFn = defaultLocalMcpBundlePath
-) {
-  const candidates = []
-
-  try {
-    const globalRoot = npmRootFn().trim()
-    if (globalRoot) {
-      candidates.push(join(globalRoot, '@visa', 'cli', 'dist', 'mcp-server', 'index.js'))
-    }
-  } catch {
-    // npm root -g failed
-  }
-
-  const local = localBundleFn()
-  if (local) candidates.push(local)
-
-  for (const candidate of candidates) {
-    if (existsSync(candidate)) return candidate
-  }
-  return null
-}
-
-export function probeMcpTools(mcpPath, requiredTools = REQUIRED_MCP_TOOLS) {
-  if (!mcpPath || !existsSync(mcpPath)) {
-    return { ok: false, missingTools: [...requiredTools] }
-  }
-
-  try {
-    const content = readFileSync(mcpPath, 'utf-8')
-    const missing = requiredTools.filter((tool) => {
-      const exact = new RegExp(`(?:^|[^A-Za-z0-9_])${tool}(?:[^A-Za-z0-9_]|$)`)
-      return !exact.test(content)
-    })
-    return {
-      ok: missing.length === 0,
-      missingTools: missing,
-    }
-  } catch {
-    return { ok: false, missingTools: [...requiredTools] }
-  }
-}
-
-export function verifyCliReadiness(
-  execFn = execFileSync,
-  npmRootFn = () => execFileSync('npm', ['root', '-g'], { encoding: 'utf-8' }),
-  localBundleFn
-) {
-  const bin = findCliBinary(execFn)
-  if (!bin) {
-    return {
-      ready: false,
-      reason: 'not_installed',
-      bin: null,
-      version: null,
-      missingTools: [...REQUIRED_MCP_TOOLS],
-    }
-  }
-
-  const version = detectCliVersion(bin, execFn)
-  const isVersionOk = Boolean(version && isSemverCompatible(version, MIN_COMPATIBLE_VERSION))
-
-  const mcpPath =
-    localBundleFn === undefined
-      ? resolveMcpBundlePath(npmRootFn)
-      : resolveMcpBundlePath(npmRootFn, localBundleFn)
-  const toolProbe = mcpPath
-    ? probeMcpTools(mcpPath, REQUIRED_MCP_TOOLS)
-    : { ok: false, missingTools: [...REQUIRED_MCP_TOOLS] }
-
-  if (isVersionOk && toolProbe.ok) {
-    return {
-      ready: true,
-      bin,
-      version: version || 'unknown',
-      missingTools: [],
-    }
-  }
-
-  return {
-    ready: false,
-    reason: 'stale_or_incomplete',
-    bin,
-    version,
-    missingTools:
-      toolProbe.missingTools.length > 0
-        ? toolProbe.missingTools
-        : isVersionOk
-          ? []
-          : [...REQUIRED_MCP_TOOLS],
-  }
-}
-
-export function performInstallOrUpgrade(pkgName, execFn = execFileSync) {
-  execFn('npm', ['install', '-g', pkgName], {
-    stdio: 'inherit',
-    timeout: 120_000,
-  })
-}
-
-export async function runSetup(env = process.env, execs = {}) {
-  const execFn = execs.execFileSync ?? execFileSync
-  const npmRootFn = execs.npmRootFn ?? (() => execFn('npm', ['root', '-g'], { encoding: 'utf-8' }))
-
-  const channel = env.VISA_RELEASE_CHANNEL || DEFAULT_RELEASE_CHANNEL
-  const pkgName = `@visa/cli@${channel}`
-
-  const initial = verifyCliReadiness(execFn, npmRootFn)
-
-  if (initial.ready) {
-    console.log(
-      `✓ visa CLI v${initial.version} already installed and verified (${REQUIRED_MCP_TOOLS.join(', ')} present) — nothing to do. Run the pairing flow in SKILL.md.`
-    )
-    return {
-      status: 'already_ready',
-      version: initial.version,
-      bin: initial.bin,
-    }
-  }
-
-  if (initial.reason === 'stale_or_incomplete') {
-    const missingStr =
-      initial.missingTools.length > 0 ? initial.missingTools.join(', ') : 'v4 tool generation'
-    console.log(
-      `Detected stale or incomplete CLI (v${initial.version || 'unknown'} lacks required tools: ${missingStr}). Upgrading to ${pkgName}…`
-    )
-  } else {
-    console.log(`Installing ${pkgName} (the v4 agent surface is prerelease)…`)
-  }
-
-  try {
-    performInstallOrUpgrade(pkgName, execFn)
-  } catch (err) {
-    console.error(
-      `Global install failed. Try \`npm install -g ${pkgName}\` manually (may need sudo, or set a\n` +
-        'user-writable npm prefix: `npm config set prefix ~/.npm-global` and add its `bin` to PATH).'
-    )
-    process.exit(1)
-  }
-
-  const post = verifyCliReadiness(execFn, npmRootFn)
-
-  if (!post.bin) {
-    console.error(
-      'Installed, but `visa` is not on PATH. Ensure your npm global bin dir is on PATH\n' +
-        '(`npm bin -g` shows it), then re-run this script.'
-    )
-    process.exit(1)
-  }
-
-  if (!post.ready) {
-    const missingStr =
-      post.missingTools.length > 0 ? post.missingTools.join(', ') : 'v4 tool generation'
-    console.error(
-      `Readiness check failed: installed CLI v${post.version || 'unknown'} is missing required tools (${missingStr}).\n` +
-        `Explicit upgrade action:\n` +
-        `  npm install -g ${pkgName}`
-    )
-    process.exit(1)
-  }
-
-  const status = initial.reason === 'not_installed' ? 'installed' : 'upgraded'
-  console.log(
-    `✓ visa CLI ready (v${post.version}, ${REQUIRED_MCP_TOOLS.join(', ')} present). Now run the pairing flow in SKILL.md.`
-  )
-  return {
-    status,
-    version: post.version,
-    bin: post.bin,
-  }
-}
-
-const isMain =
-  typeof process !== 'undefined' &&
-  process.argv[1] &&
-  (import.meta.url === pathToFileURL(process.argv[1]).href || process.argv[1].endsWith('setup.mjs'))
-
-if (isMain) {
-  runSetup().catch((err) => {
-    console.error(`Provisioning error: ${err && err.message ? err.message : String(err)}`)
-    process.exit(1)
-  })
-}