@gaiaworks/gaia-cli 0.0.6 → 0.0.8

package/README.md

@@ -27,4 +27,44 @@ npx @gaiaworks/gaia-cli@latest install --mode internal
 
 未指定 `--mode` 时默认写入 `external`。安装脚本会执行 `gaia setup --mode <external|internal>`，用于初始化本地 `install_mode` 和 Agent Skills。
 
-安装时会根据 npm 包版本，从 OSS 的同版本目录下载当前平台对应的 `gaia-cli` 二进制。
+安装时会根据 npm 包版本，从 OSS 的同版本目录下载当前平台对应的 `gaia-cli` 二进制。
+
+升级到 npm `latest` 并保留当前安装模式：
+
+```bash
+gaia update
+```
+
+仅检查或安装指定版本：
+
+```bash
+gaia update --check
+gaia update --version 0.0.7
+```
+
+更新命令拒绝降级。首个包含该命令的版本仍需通过 `npx ... install` 手工升级一次。
+
+查看脱敏后的当前有效配置，并诊断配置、端点、登录凭据及 Internal 远程授权服务：
+
+```bash
+gaia config show
+gaia doctor
+gaia doctor --json
+```
+
+`config show` 不输出 Token 或 Client Secret 明文。未登录属于警告；配置非法、必填端点缺失或远程授权服务健康检查失败时，`doctor` 返回非零退出码。
+
+卸载全局命令和 Gaia 管理的 Agent Skills，默认保留本地配置、凭据和目标信息：
+
+```bash
+gaia uninstall
+```
+
+需要同时删除全部本地 Gaia 数据时使用：
+
+```bash
+gaia uninstall --purge
+gaia uninstall --purge --yes
+```
+
+`--purge` 删除 `GAIA_CONFIG_DIR` 指向的目录；未设置该环境变量时删除 `~/.gaia`。默认会要求确认，自动化场景可显式添加 `--yes`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaiaworks/gaia-cli",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "JavaScript launcher for gaia-cli.",
   "license": "UNLICENSED",
   "private": false,

package/scripts/run.js

@@ -10,12 +10,26 @@ const { binaryName } = require('./install');
 const PACKAGE_ROOT = path.resolve(__dirname, '..');
 const BINARY_PATH = path.join(PACKAGE_ROOT, 'bin', binaryName());
 
-function runInstallWizard(args) {
+function runInstallWizard(args) {
   const result = spawnSync(process.execPath, [path.join(__dirname, 'install-wizard.js'), ...args], {
     stdio: 'inherit',
   });
   process.exit(typeof result.status === 'number' ? result.status : 1);
-}
+}
+
+function runUpdater(args) {
+  const result = spawnSync(process.execPath, [path.join(__dirname, 'update.js'), ...args], {
+    stdio: 'inherit',
+  });
+  process.exit(typeof result.status === 'number' ? result.status : 1);
+}
+
+function runUninstaller(args) {
+  const result = spawnSync(process.execPath, [path.join(__dirname, 'uninstall.js'), ...args], {
+    stdio: 'inherit',
+  });
+  process.exit(typeof result.status === 'number' ? result.status : 1);
+}
 
 function ensureBinary() {
   if (fs.existsSync(BINARY_PATH)) return;
@@ -40,8 +54,14 @@ function runBinary(args) {
 }
 
 const args = process.argv.slice(2);
-if (args[0] === 'install') {
-  runInstallWizard(args.slice(1));
-}
-
-runBinary(args);
+if (args[0] === 'install') {
+  runInstallWizard(args.slice(1));
+}
+if (args[0] === 'update') {
+  runUpdater(args.slice(1));
+}
+if (args[0] === 'uninstall') {
+  runUninstaller(args.slice(1));
+}
+
+runBinary(args);

package/scripts/uninstall.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const readline = require('node:readline/promises');
+
+function defaultExecute(command, args) {
+  return spawnSync(command, args, {
+    stdio: ['ignore', 'pipe', 'pipe'],
+    encoding: 'utf8',
+  });
+}
+
+function npmInvocation(args, platform, env) {
+  if (platform === 'win32') {
+    const npmCli = env.npm_execpath || path.join(
+      path.dirname(process.execPath),
+      'node_modules',
+      'npm',
+      'bin',
+      'npm-cli.js'
+    );
+    return { command: process.execPath, args: [npmCli, ...args] };
+  }
+  return { command: 'npm', args };
+}
+
+function executeChecked(execute, command, args, action) {
+  const result = execute(command, args);
+  if (result.error || result.status !== 0) {
+    const detail = result.error
+      ? result.error.message
+      : `${result.stdout || ''}${result.stderr || ''}`.trim();
+    throw new Error(`${action} failed${detail ? `: ${detail}` : ''}`);
+  }
+}
+
+async function defaultConfirm(message) {
+  const prompt = readline.createInterface({ input: process.stdin, output: process.stderr });
+  try {
+    const answer = await prompt.question(`${message} [y/N] `);
+    return /^(y|yes)$/i.test(answer.trim());
+  } finally {
+    prompt.close();
+  }
+}
+
+async function uninstallCli(args, options = {}) {
+  const purge = args.includes('--purge');
+  const yes = args.includes('--yes');
+  const invalidArgs = args.filter((arg) => arg !== '--purge' && arg !== '--yes');
+  if (invalidArgs.length > 0 || yes && !purge || new Set(args).size !== args.length) {
+    throw new Error(`unsupported uninstall arguments: ${args.join(' ')}`);
+  }
+
+  const env = options.env || process.env;
+  const platform = options.platform || process.platform;
+  const packageInfo = options.packageInfo || JSON.parse(
+    fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8')
+  );
+  const execute = options.execute || defaultExecute;
+  const write = options.write || ((message) => console.error(message));
+  const confirm = options.confirm || defaultConfirm;
+  const runScript = options.runScript || path.join(__dirname, 'run.js');
+  const configDir = path.resolve(env.GAIA_CONFIG_DIR || path.join(os.homedir(), '.gaia'));
+
+  if (purge) {
+    const root = path.parse(configDir).root;
+    const protectedPaths = [root, path.resolve(os.homedir()), path.resolve(process.cwd())];
+    const normalizedConfigDir = platform === 'win32' ? configDir.toLowerCase() : configDir;
+    if (protectedPaths.some((protectedPath) => (
+      platform === 'win32' ? protectedPath.toLowerCase() : protectedPath
+    ) === normalizedConfigDir)) {
+      throw new Error(`refusing to purge unsafe Gaia configuration directory: ${configDir}`);
+    }
+    if (!yes && !await confirm(`Remove all Gaia CLI configuration and credentials at ${configDir}?`)) {
+      write('Uninstall cancelled.');
+      return { purged: false, cancelled: true, configDir };
+    }
+  }
+
+  write('Removing Gaia-managed Agent Skills...');
+  executeChecked(
+    execute,
+    process.execPath,
+    [runScript, 'skills', 'remove'],
+    'remove Gaia-managed Agent Skills'
+  );
+
+  write(`Uninstalling ${packageInfo.name}...`);
+  const uninstall = npmInvocation(['uninstall', '-g', packageInfo.name], platform, env);
+  executeChecked(execute, uninstall.command, uninstall.args, 'uninstall Gaia CLI package');
+
+  if (purge) {
+    fs.rmSync(configDir, { recursive: true, force: true });
+    write(`Gaia CLI uninstalled. Configuration removed from ${configDir}`);
+    return { purged: true, configDir };
+  }
+
+  write(`Gaia CLI uninstalled. Configuration retained at ${configDir}`);
+
+  return { purged: false, configDir };
+}
+
+if (require.main === module) {
+  uninstallCli(process.argv.slice(2)).catch((error) => {
+    console.error(`[gaia-cli] Uninstall failed: ${error.message}`);
+    process.exitCode = 1;
+  });
+}
+
+module.exports = { uninstallCli };

package/scripts/update.js

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+const registry = 'https://registry.npmjs.org';
+
+function parseVersion(version) {
+  const match = String(version).match(
+    /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/
+  );
+  if (!match) throw new Error(`invalid Gaia CLI version: ${version}`);
+  return {
+    core: match.slice(1, 4).map(Number),
+    prerelease: match[4] ? match[4].split('.') : [],
+  };
+}
+
+function compareVersions(left, right) {
+  const a = parseVersion(left);
+  const b = parseVersion(right);
+  for (let index = 0; index < a.core.length; index += 1) {
+    if (a.core[index] !== b.core[index]) return a.core[index] - b.core[index];
+  }
+  if (a.prerelease.length === 0) return b.prerelease.length === 0 ? 0 : 1;
+  if (b.prerelease.length === 0) return -1;
+  const length = Math.max(a.prerelease.length, b.prerelease.length);
+  for (let index = 0; index < length; index += 1) {
+    const aPart = a.prerelease[index];
+    const bPart = b.prerelease[index];
+    if (aPart === undefined) return -1;
+    if (bPart === undefined) return 1;
+    if (aPart === bPart) continue;
+    const aNumber = /^\d+$/.test(aPart);
+    const bNumber = /^\d+$/.test(bPart);
+    if (aNumber && bNumber) return Number(aPart) - Number(bPart);
+    if (aNumber) return -1;
+    if (bNumber) return 1;
+    return aPart.localeCompare(bPart);
+  }
+  return 0;
+}
+
+function defaultExecute(command, args) {
+  return spawnSync(command, args, {
+    stdio: ['ignore', 'pipe', 'pipe'],
+    encoding: 'utf8',
+  });
+}
+
+function npmInvocation(args, platform, env) {
+  if (platform === 'win32') {
+    const npmCli = env.npm_execpath || path.join(
+      path.dirname(process.execPath),
+      'node_modules',
+      'npm',
+      'bin',
+      'npm-cli.js'
+    );
+    return { command: process.execPath, args: [npmCli, ...args] };
+  }
+  return { command: 'npm', args };
+}
+
+function executeChecked(execute, command, args, action) {
+  const result = execute(command, args);
+  if (result.error || result.status !== 0) {
+    const detail = result.error
+      ? result.error.message
+      : `${result.stdout || ''}${result.stderr || ''}`.trim();
+    throw new Error(`${action} failed${detail ? `: ${detail}` : ''}`);
+  }
+  return result;
+}
+
+function readInstallMode(env) {
+  const configDir = env.GAIA_CONFIG_DIR || path.join(os.homedir(), '.gaia');
+  const configPath = path.join(configDir, 'config.json');
+  let config;
+  try {
+    config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+  } catch (error) {
+    throw new Error(`cannot read Gaia CLI configuration at ${configPath}: ${error.message}`);
+  }
+  if (config.install_mode !== 'internal' && config.install_mode !== 'external') {
+    throw new Error(`invalid install_mode in ${configPath}`);
+  }
+  return config.install_mode;
+}
+
+function updateCli(args, options = {}) {
+  const checkOnly = args.length === 1 && args[0] === '--check';
+  const requestedVersion = args.length === 2 && args[0] === '--version' ? args[1] : '';
+  if (args.length > 0 && !checkOnly && !requestedVersion) {
+    throw new Error(`unsupported update arguments: ${args.join(' ')}`);
+  }
+  if (requestedVersion) {
+    try {
+      parseVersion(requestedVersion);
+    } catch {
+      throw new Error(`explicit version must be a semantic version: ${requestedVersion}`);
+    }
+  }
+
+  const env = options.env || process.env;
+  const platform = options.platform || process.platform;
+  const packageInfo = options.packageInfo || JSON.parse(
+    fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8')
+  );
+  const execute = options.execute || defaultExecute;
+  const write = options.write || ((message) => console.error(message));
+  const mode = readInstallMode(env);
+
+  const requestedSpec = requestedVersion || 'latest';
+  const view = npmInvocation([
+    'view', `${packageInfo.name}@${requestedSpec}`, 'version', '--registry', registry,
+  ], platform, env);
+  const viewResult = executeChecked(execute, view.command, view.args, 'check latest version');
+  const targetVersion = viewResult.stdout.trim();
+  if (!targetVersion) throw new Error('npm returned an empty latest version');
+  if (compareVersions(targetVersion, packageInfo.version) < 0) {
+    throw new Error(`refusing to downgrade Gaia CLI from v${packageInfo.version} to v${targetVersion}`);
+  }
+
+  if (checkOnly) {
+    const updateAvailable = targetVersion !== packageInfo.version;
+    write(updateAvailable
+      ? `Update available: v${packageInfo.version} -> v${targetVersion}`
+      : `Gaia CLI is already up to date: v${packageInfo.version}`);
+    return {
+      currentVersion: packageInfo.version,
+      targetVersion,
+      updated: false,
+      updateAvailable,
+    };
+  }
+
+  if (targetVersion === packageInfo.version) {
+    write(`Gaia CLI is already up to date: v${packageInfo.version}`);
+    return { currentVersion: packageInfo.version, targetVersion, updated: false };
+  }
+
+  write(`Updating Gaia CLI from v${packageInfo.version} to v${targetVersion}...`);
+  const prefix = npmInvocation(['prefix', '-g'], platform, env);
+  const prefixResult = executeChecked(execute, prefix.command, prefix.args, 'resolve npm global prefix');
+  const globalPrefix = prefixResult.stdout.trim();
+  if (!globalPrefix) throw new Error('npm returned an empty global prefix');
+
+  const install = npmInvocation([
+    'install', '-g', `${packageInfo.name}@${targetVersion}`, '--registry', registry,
+  ], platform, env);
+  executeChecked(execute, install.command, install.args, 'install Gaia CLI update');
+
+  let setupCommand;
+  let setupArgs;
+  if (platform === 'win32') {
+    setupCommand = process.execPath;
+    setupArgs = [
+      path.win32.join(globalPrefix, 'node_modules', ...packageInfo.name.split('/'), 'scripts', 'run.js'),
+      'setup',
+      '--mode',
+      mode,
+    ];
+  } else {
+    setupCommand = path.posix.join(globalPrefix, 'bin', 'gaia');
+    setupArgs = ['setup', '--mode', mode];
+  }
+  executeChecked(execute, setupCommand, setupArgs, 'restore Gaia CLI mode');
+
+  write(`Update completed: v${targetVersion}`);
+  write(`Install mode retained: ${mode}`);
+  return { currentVersion: packageInfo.version, targetVersion, updated: true };
+}
+
+if (require.main === module) {
+  try {
+    updateCli(process.argv.slice(2));
+  } catch (error) {
+    console.error(`[gaia-cli] Update failed: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+module.exports = { updateCli };