@gaiaworks/gaia-cli 0.3.8 → 0.3.10

package/README.md

@@ -1,32 +1,32 @@
-# @gaiaworks/gaia-cli
-
-这是 `gaia-cli` 的 npm 分发壳包，用于通过 `npx` 下载并运行对应版本的 Go 二进制。
-
-## 使用方式
-
-临时执行：
-
-```bash
-npx @gaiaworks/gaia-cli version
-```
-
-全局安装：
-
-```bash
-npx @gaiaworks/gaia-cli@latest install
-gaia version
-```
-
-安装模式：
-
-```bash
-npx @gaiaworks/gaia-cli@latest install
-npx @gaiaworks/gaia-cli@latest install --mode external
-npx @gaiaworks/gaia-cli@latest install --mode internal
-```
-
-未指定 `--mode` 时默认写入 `external`。安装脚本会执行 `gaia setup --mode <external|internal>`，用于初始化本地 `install_mode` 和 Agent Skills。
-
+# @gaiaworks/gaia-cli
+
+这是 `gaia-cli` 的 npm 分发壳包，用于通过 `npx` 下载并运行对应版本的 Go 二进制。
+
+## 使用方式
+
+临时执行：
+
+```bash
+npx @gaiaworks/gaia-cli version
+```
+
+全局安装：
+
+```bash
+npx @gaiaworks/gaia-cli@latest install
+gaia version
+```
+
+安装模式：
+
+```bash
+npx @gaiaworks/gaia-cli@latest install
+npx @gaiaworks/gaia-cli@latest install --mode external
+npx @gaiaworks/gaia-cli@latest install --mode internal
+```
+
+未指定 `--mode` 时默认写入 `external`。安装脚本会执行 `gaia setup --mode <external|internal>`，用于初始化本地 `install_mode` 和 Agent Skills。
+
 安装时会根据 npm 包版本，从 OSS 的同版本目录下载当前平台对应的 `gaia-cli` 二进制。
 
 升级到 npm `latest` 并保留当前安装模式：

package/package.json

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

package/scripts/install-wizard.js

@@ -1,13 +1,13 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-const { binaryName, install } = require('./install');
-
-const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
-const packageSpec = `${packageJson.name}@${packageJson.version}`;
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const { binaryName, install } = require('./install');
+
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
+const packageSpec = `${packageJson.name}@${packageJson.version}`;
 const binaryPath = path.join(__dirname, '..', 'bin', binaryName());
 const shellPathMarker = '# Added by gaia-cli installer';
 
@@ -24,146 +24,146 @@ function npmInvocation(args) {
   }
   return { command: 'npm', args };
 }
-
-function parseInstallArgs(args) {
-  let mode = 'external';
-  let explicitMode = false;
-  const npmArgs = [];
-
-  for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
-    if (arg === '--mode') {
-      const value = args[i + 1];
-      if (!value) {
-        throw new Error('--mode requires a value: external or internal');
-      }
-      mode = value;
-      explicitMode = true;
-      i += 1;
-      continue;
-    }
-    if (arg.startsWith('--mode=')) {
-      mode = arg.slice('--mode='.length);
-      explicitMode = true;
-      continue;
-    }
-    npmArgs.push(arg);
-  }
-
-  if (mode !== 'external' && mode !== 'internal') {
-    throw new Error(`Unsupported mode: ${mode}. Expected external or internal.`);
-  }
-
-  return { explicitMode, mode, npmArgs };
-}
-
-function run(command, args, options = {}) {
-  const result = spawnSync(command, args, {
-    stdio: options.stdio || 'inherit',
-    encoding: 'utf8',
-  });
-
-  if (result.error) {
-    console.error(`[gaia-cli] Failed to run ${command}: ${result.error.message}`);
-    process.exit(1);
-  }
-
-  if (result.status !== 0) {
-    process.exit(typeof result.status === 'number' ? result.status : 1);
-  }
-}
-
-function runCapture(command, args) {
-  return spawnSync(command, args, {
-    stdio: ['ignore', 'pipe', 'pipe'],
-    encoding: 'utf8',
-  });
-}
-
+
+function parseInstallArgs(args) {
+  let mode = 'external';
+  let explicitMode = false;
+  const npmArgs = [];
+
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === '--mode') {
+      const value = args[i + 1];
+      if (!value) {
+        throw new Error('--mode requires a value: external or internal');
+      }
+      mode = value;
+      explicitMode = true;
+      i += 1;
+      continue;
+    }
+    if (arg.startsWith('--mode=')) {
+      mode = arg.slice('--mode='.length);
+      explicitMode = true;
+      continue;
+    }
+    npmArgs.push(arg);
+  }
+
+  if (mode !== 'external' && mode !== 'internal') {
+    throw new Error(`Unsupported mode: ${mode}. Expected external or internal.`);
+  }
+
+  return { explicitMode, mode, npmArgs };
+}
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    stdio: options.stdio || 'inherit',
+    encoding: 'utf8',
+  });
+
+  if (result.error) {
+    console.error(`[gaia-cli] Failed to run ${command}: ${result.error.message}`);
+    process.exit(1);
+  }
+
+  if (result.status !== 0) {
+    process.exit(typeof result.status === 'number' ? result.status : 1);
+  }
+}
+
+function runCapture(command, args) {
+  return spawnSync(command, args, {
+    stdio: ['ignore', 'pipe', 'pipe'],
+    encoding: 'utf8',
+  });
+}
+
 function npmGlobalBinDir() {
   const npm = npmInvocation(['prefix', '-g']);
   const result = runCapture(npm.command, npm.args);
-  if (result.error || result.status !== 0) return null;
-  const prefix = result.stdout.trim();
-  if (!prefix) return null;
-  return process.platform === 'win32' ? prefix : path.join(prefix, 'bin');
-}
-
+  if (result.error || result.status !== 0) return null;
+  const prefix = result.stdout.trim();
+  if (!prefix) return null;
+  return process.platform === 'win32' ? prefix : path.join(prefix, 'bin');
+}
+
 function npmGlobalCommandPath(binDir, platform = process.platform) {
-  if (!binDir) return null;
-  if (platform === 'win32') return path.win32.join(binDir, 'gaia.cmd');
-  return path.posix.join(binDir, 'gaia');
+  if (!binDir) return null;
+  if (platform === 'win32') return path.win32.join(binDir, 'gaia.cmd');
+  return path.posix.join(binDir, 'gaia');
 }
 
 function setupCommandPath(packageBinary) {
   return packageBinary;
 }
-
-function pathContains(dir) {
-  if (!dir) return false;
-  const entries = (process.env.PATH || '').split(path.delimiter).filter(Boolean);
-  return entries.some((entry) => path.resolve(entry) === path.resolve(dir));
-}
-
-function shellProfilePath(env = process.env) {
-  if (process.platform === 'win32') return null;
-  const home = env.HOME;
-  if (!home) return null;
-  const shell = path.basename(env.SHELL || '');
-  if (shell === 'zsh') return path.join(home, '.zshrc');
-  if (shell === 'bash') return path.join(home, '.bashrc');
-  return path.join(home, '.profile');
-}
-
-function ensureWindowsPathConfigured(binDir) {
-  if (!binDir || process.platform !== 'win32' || pathContains(binDir)) return null;
-  const command = [
-    "$dir = $args[0]",
-    "$current = [Environment]::GetEnvironmentVariable('Path', 'User')",
-    "if (-not $current) { $current = '' }",
-    "$parts = $current -split ';' | Where-Object { $_ }",
-    "if ($parts -notcontains $dir) {",
-    "  $next = (@($dir) + $parts) -join ';'",
-    "  [Environment]::SetEnvironmentVariable('Path', $next, 'User')",
-    "}",
-  ].join("; ");
-  const result = spawnSync("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", command, binDir], {
-    stdio: ["ignore", "pipe", "pipe"],
-    encoding: "utf8",
-  });
-  if (result.error || result.status !== 0) {
-    const detail = result.error ? result.error.message : `${result.stdout || ""}${result.stderr || ""}`.trim();
-    throw new Error(`Failed to update user PATH: ${detail}`);
-  }
-  return "Windows user PATH";
-}
-
-function pathExportBlock(binDir) {
-  return `${shellPathMarker}\nexport PATH="${binDir}:$PATH"\n`;
-}
-
+
+function pathContains(dir) {
+  if (!dir) return false;
+  const entries = (process.env.PATH || '').split(path.delimiter).filter(Boolean);
+  return entries.some((entry) => path.resolve(entry) === path.resolve(dir));
+}
+
+function shellProfilePath(env = process.env) {
+  if (process.platform === 'win32') return null;
+  const home = env.HOME;
+  if (!home) return null;
+  const shell = path.basename(env.SHELL || '');
+  if (shell === 'zsh') return path.join(home, '.zshrc');
+  if (shell === 'bash') return path.join(home, '.bashrc');
+  return path.join(home, '.profile');
+}
+
+function ensureWindowsPathConfigured(binDir) {
+  if (!binDir || process.platform !== 'win32' || pathContains(binDir)) return null;
+  const command = [
+    "$dir = $args[0]",
+    "$current = [Environment]::GetEnvironmentVariable('Path', 'User')",
+    "if (-not $current) { $current = '' }",
+    "$parts = $current -split ';' | Where-Object { $_ }",
+    "if ($parts -notcontains $dir) {",
+    "  $next = (@($dir) + $parts) -join ';'",
+    "  [Environment]::SetEnvironmentVariable('Path', $next, 'User')",
+    "}",
+  ].join("; ");
+  const result = spawnSync("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", command, binDir], {
+    stdio: ["ignore", "pipe", "pipe"],
+    encoding: "utf8",
+  });
+  if (result.error || result.status !== 0) {
+    const detail = result.error ? result.error.message : `${result.stdout || ""}${result.stderr || ""}`.trim();
+    throw new Error(`Failed to update user PATH: ${detail}`);
+  }
+  return "Windows user PATH";
+}
+
+function pathExportBlock(binDir) {
+  return `${shellPathMarker}\nexport PATH="${binDir}:$PATH"\n`;
+}
+
 function ensurePathConfigured(binDir, profilePath = shellProfilePath(), platform = process.platform) {
   if (!binDir) return null;
   if (platform === 'win32') {
     return ensureWindowsPathConfigured(binDir);
-  }
-  if (!profilePath || pathContains(binDir)) return null;
-  const existing = fs.existsSync(profilePath) ? fs.readFileSync(profilePath, 'utf8') : '';
-  if (existing.includes(binDir) || existing.includes(shellPathMarker)) return profilePath;
-  const prefix = existing && !existing.endsWith('\n') ? '\n' : '';
-  fs.appendFileSync(profilePath, `${prefix}${pathExportBlock(binDir)}`);
-  return profilePath;
-}
-
-function ensureLocalBinary() {
-  if (fs.existsSync(binaryPath)) return;
-  install();
-}
-
-function installWizard(args) {
-  const { explicitMode, mode, npmArgs } = parseInstallArgs(args);
-  if (npmArgs.length > 0) {
-    throw new Error(`Unsupported install arguments: ${npmArgs.join(' ')}`);
+  }
+  if (!profilePath || pathContains(binDir)) return null;
+  const existing = fs.existsSync(profilePath) ? fs.readFileSync(profilePath, 'utf8') : '';
+  if (existing.includes(binDir) || existing.includes(shellPathMarker)) return profilePath;
+  const prefix = existing && !existing.endsWith('\n') ? '\n' : '';
+  fs.appendFileSync(profilePath, `${prefix}${pathExportBlock(binDir)}`);
+  return profilePath;
+}
+
+function ensureLocalBinary() {
+  if (fs.existsSync(binaryPath)) return;
+  install();
+}
+
+function installWizard(args) {
+  const { explicitMode, mode, npmArgs } = parseInstallArgs(args);
+  if (npmArgs.length > 0) {
+    throw new Error(`Unsupported install arguments: ${npmArgs.join(' ')}`);
   }
 
   ensureLocalBinary();
@@ -171,40 +171,47 @@ function installWizard(args) {
   run(npm.command, npm.args);
   const globalBinDir = npmGlobalBinDir();
   const setupCommand = setupCommandPath(binaryPath);
-  run(setupCommand, ['setup', '--mode', mode], { stdio: 'ignore' });
-  const profilePath = ensurePathConfigured(globalBinDir);
-  const suffix = explicitMode ? `当前模式: ${mode}。` : '';
-  if (profilePath && globalBinDir && !pathContains(globalBinDir)) {
-    console.error(`[gaia-cli] 安装完成，${suffix}已更新 PATH 配置: ${profilePath}`);
-    console.error(`[gaia-cli] 重新打开终端后可以执行: gaia version`);
-    return;
-  }
-  if (explicitMode) {
-    console.error(`[gaia-cli] 安装完成，当前模式: ${mode}。可以执行: gaia version`);
-  } else {
-    console.error('[gaia-cli] 安装完成。可以执行: gaia version');
-  }
-}
-
-if (require.main === module) {
-  try {
-    installWizard(process.argv.slice(2));
-  } catch (error) {
-    console.error(`[gaia-cli] Install failed: ${error.message}`);
-    process.exit(1);
-  }
-}
-
-module.exports = {
-  ensurePathConfigured,
-  ensureWindowsPathConfigured,
+  console.error('[gaia-cli] 正在安装 Gaia Skill: gaia-shared...');
+  try {
+    run(setupCommand, ['setup', '--mode', mode], { stdio: 'ignore' });
+  } catch (error) {
+    console.error('[gaia-cli] gaia-shared 安装失败。');
+    throw error;
+  }
+  console.error('[gaia-cli] ✓ Gaia Skill gaia-shared 安装完成。');
+  const profilePath = ensurePathConfigured(globalBinDir);
+  const suffix = explicitMode ? `当前模式: ${mode}。` : '';
+  if (profilePath && globalBinDir && !pathContains(globalBinDir)) {
+    console.error(`[gaia-cli] 安装完成，${suffix}已更新 PATH 配置: ${profilePath}`);
+    console.error(`[gaia-cli] 重新打开终端后可以执行: gaia version`);
+    return;
+  }
+  if (explicitMode) {
+    console.error(`[gaia-cli] 安装完成，当前模式: ${mode}。可以执行: gaia version`);
+  } else {
+    console.error('[gaia-cli] 安装完成。可以执行: gaia version');
+  }
+}
+
+if (require.main === module) {
+  try {
+    installWizard(process.argv.slice(2));
+  } catch (error) {
+    console.error(`[gaia-cli] Install failed: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  ensurePathConfigured,
+  ensureWindowsPathConfigured,
   npmGlobalBinDir,
   npmGlobalCommandPath,
   npmInvocation,
-  pathContains,
-  pathExportBlock,
+  pathContains,
+  pathExportBlock,
   shellProfilePath,
   setupCommandPath,
-  installWizard,
-  parseInstallArgs,
-};
+  installWizard,
+  parseInstallArgs,
+};

package/scripts/install.js

@@ -1,25 +1,25 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-const PACKAGE_ROOT = path.resolve(__dirname, '..');
-const PACKAGE_JSON = path.join(PACKAGE_ROOT, 'package.json');
-const BIN_DIR = path.join(PACKAGE_ROOT, 'bin');
-const DOWNLOAD_BASE = process.env.GAIA_CLI_DOWNLOAD_BASE || 'https://assets.gaiaworkforce.com/gaia-cli/releases';
-const ALLOWED_DOWNLOAD_HOSTS = new Set([
-  'assets.gaiaworkforce.com',
-  'gaiafe.oss-cn-shanghai.aliyuncs.com',
-]);
-
-function readPackageVersion() {
-  const content = fs.readFileSync(PACKAGE_JSON, 'utf8');
-  return JSON.parse(content).version;
-}
-
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const PACKAGE_JSON = path.join(PACKAGE_ROOT, 'package.json');
+const BIN_DIR = path.join(PACKAGE_ROOT, 'bin');
+const DOWNLOAD_BASE = process.env.GAIA_CLI_DOWNLOAD_BASE || 'https://assets.gaiaworkforce.com/gaia-cli/releases';
+const ALLOWED_DOWNLOAD_HOSTS = new Set([
+  'assets.gaiaworkforce.com',
+  'gaiafe.oss-cn-shanghai.aliyuncs.com',
+]);
+
+function readPackageVersion() {
+  const content = fs.readFileSync(PACKAGE_JSON, 'utf8');
+  return JSON.parse(content).version;
+}
+
 function normalizeVersion(version) {
   return version.startsWith('v') ? version.slice(1) : version;
 }
@@ -29,157 +29,157 @@ function assertInstallableVersion(version) {
     throw new Error('Cannot install from a source checkout with placeholder version 0.0.0; use `go run .\\cmd\\gaia <command>` for local development');
   }
 }
-
-function platformName(platform = process.platform) {
-  if (platform === 'darwin') return 'darwin';
-  if (platform === 'linux') return 'linux';
-  if (platform === 'win32') return 'windows';
-  throw new Error(`Unsupported platform: ${platform}`);
-}
-
-function archName(arch = process.arch) {
-  if (arch === 'x64') return 'amd64';
-  if (arch === 'arm64') return 'arm64';
-  throw new Error(`Unsupported architecture: ${arch}`);
-}
-
-function binaryName(platform = process.platform) {
-  return platform === 'win32' ? 'gaia-cli.exe' : 'gaia-cli';
-}
-
-function archiveName(version, platform = process.platform, arch = process.arch) {
-  const cleanVersion = normalizeVersion(version);
-  return `gaia-cli-${cleanVersion}-${platformName(platform)}-${archName(arch)}.tar.gz`;
-}
-
-function releaseTag(version) {
-  const cleanVersion = normalizeVersion(version);
-  return `v${cleanVersion}`;
-}
-
-function downloadUrl(version, platform = process.platform, arch = process.arch) {
-  return `${DOWNLOAD_BASE}/${releaseTag(version)}/${archiveName(version, platform, arch)}`;
-}
-
-function assertAllowedUrl(rawUrl) {
-  const parsed = new URL(rawUrl);
-  if (parsed.protocol !== 'https:') {
-    throw new Error(`Refusing non-HTTPS download URL: ${rawUrl}`);
-  }
-  if (!ALLOWED_DOWNLOAD_HOSTS.has(parsed.hostname)) {
-    throw new Error(`Refusing download host: ${parsed.hostname}`);
-  }
-}
-
-function ensureDir(dir) {
-  fs.mkdirSync(dir, { recursive: true });
-}
-
-function run(command, args, options = {}) {
-  const result = spawnSync(command, args, {
-    stdio: options.stdio || 'inherit',
-    cwd: options.cwd || PACKAGE_ROOT,
-    encoding: 'utf8',
-  });
-  if (result.error) {
-    throw result.error;
-  }
-  if (result.status !== 0) {
-    throw new Error(`${command} ${args.join(' ')} exited with code ${result.status}`);
-  }
-  return result;
-}
-
-function downloadWithRedirects(url, destination) {
-  assertAllowedUrl(url);
-  const tmpPath = `${destination}.tmp`;
-  fs.rmSync(tmpPath, { force: true });
-
-  run('curl', [
-    '--fail',
-    '--location',
-    '--show-error',
-    '--silent',
-    '--output',
-    tmpPath,
-    url,
-  ]);
-
-  fs.renameSync(tmpPath, destination);
-}
-
-function extractArchive(archivePath, targetDir) {
-  fs.rmSync(targetDir, { recursive: true, force: true });
-  ensureDir(targetDir);
-  run('tar', ['-xzf', archivePath, '-C', targetDir]);
-}
-
-function findDownloadedBinary(targetDir, platform = process.platform) {
-  const expectedName = binaryName(platform);
-  const direct = path.join(targetDir, expectedName);
-  if (fs.existsSync(direct)) return direct;
-
-  const pending = [targetDir];
-  while (pending.length > 0) {
-    const currentDir = pending.pop();
-    const entries = fs.readdirSync(currentDir, { withFileTypes: true });
-    for (const entry of entries) {
-      const entryPath = path.join(currentDir, entry.name);
-      if (entry.isDirectory()) {
-        pending.push(entryPath);
-      } else if (entry.isFile() && entry.name === expectedName) {
-        return entryPath;
-      }
-    }
-  }
-  throw new Error(`Downloaded archive does not contain ${expectedName}`);
-}
-
+
+function platformName(platform = process.platform) {
+  if (platform === 'darwin') return 'darwin';
+  if (platform === 'linux') return 'linux';
+  if (platform === 'win32') return 'windows';
+  throw new Error(`Unsupported platform: ${platform}`);
+}
+
+function archName(arch = process.arch) {
+  if (arch === 'x64') return 'amd64';
+  if (arch === 'arm64') return 'arm64';
+  throw new Error(`Unsupported architecture: ${arch}`);
+}
+
+function binaryName(platform = process.platform) {
+  return platform === 'win32' ? 'gaia-cli.exe' : 'gaia-cli';
+}
+
+function archiveName(version, platform = process.platform, arch = process.arch) {
+  const cleanVersion = normalizeVersion(version);
+  return `gaia-cli-${cleanVersion}-${platformName(platform)}-${archName(arch)}.tar.gz`;
+}
+
+function releaseTag(version) {
+  const cleanVersion = normalizeVersion(version);
+  return `v${cleanVersion}`;
+}
+
+function downloadUrl(version, platform = process.platform, arch = process.arch) {
+  return `${DOWNLOAD_BASE}/${releaseTag(version)}/${archiveName(version, platform, arch)}`;
+}
+
+function assertAllowedUrl(rawUrl) {
+  const parsed = new URL(rawUrl);
+  if (parsed.protocol !== 'https:') {
+    throw new Error(`Refusing non-HTTPS download URL: ${rawUrl}`);
+  }
+  if (!ALLOWED_DOWNLOAD_HOSTS.has(parsed.hostname)) {
+    throw new Error(`Refusing download host: ${parsed.hostname}`);
+  }
+}
+
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    stdio: options.stdio || 'inherit',
+    cwd: options.cwd || PACKAGE_ROOT,
+    encoding: 'utf8',
+  });
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    throw new Error(`${command} ${args.join(' ')} exited with code ${result.status}`);
+  }
+  return result;
+}
+
+function downloadWithRedirects(url, destination) {
+  assertAllowedUrl(url);
+  const tmpPath = `${destination}.tmp`;
+  fs.rmSync(tmpPath, { force: true });
+
+  run('curl', [
+    '--fail',
+    '--location',
+    '--show-error',
+    '--silent',
+    '--output',
+    tmpPath,
+    url,
+  ]);
+
+  fs.renameSync(tmpPath, destination);
+}
+
+function extractArchive(archivePath, targetDir) {
+  fs.rmSync(targetDir, { recursive: true, force: true });
+  ensureDir(targetDir);
+  run('tar', ['-xzf', archivePath, '-C', targetDir]);
+}
+
+function findDownloadedBinary(targetDir, platform = process.platform) {
+  const expectedName = binaryName(platform);
+  const direct = path.join(targetDir, expectedName);
+  if (fs.existsSync(direct)) return direct;
+
+  const pending = [targetDir];
+  while (pending.length > 0) {
+    const currentDir = pending.pop();
+    const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+      const entryPath = path.join(currentDir, entry.name);
+      if (entry.isDirectory()) {
+        pending.push(entryPath);
+      } else if (entry.isFile() && entry.name === expectedName) {
+        return entryPath;
+      }
+    }
+  }
+  throw new Error(`Downloaded archive does not contain ${expectedName}`);
+}
+
 function install(options = {}) {
   const version = options.version || readPackageVersion();
   assertInstallableVersion(version);
-  const url = options.url || downloadUrl(version);
-  const archivePath = path.join(os.tmpdir(), archiveName(version));
-  const unpackDir = path.join(os.tmpdir(), `gaia-cli-${process.pid}-${Date.now()}`);
-  const finalBinary = path.join(BIN_DIR, binaryName());
-
-  console.error(`[gaia-cli] Downloading ${url}`);
-  ensureDir(BIN_DIR);
-  downloadWithRedirects(url, archivePath);
-  extractArchive(archivePath, unpackDir);
-
-  const downloadedBinary = findDownloadedBinary(unpackDir);
-  fs.copyFileSync(downloadedBinary, finalBinary);
-  if (process.platform !== 'win32') {
-    fs.chmodSync(finalBinary, 0o755);
-  }
-
-  fs.rmSync(archivePath, { force: true });
-  fs.rmSync(unpackDir, { recursive: true, force: true });
-  console.error(`[gaia-cli] Installed ${finalBinary}`);
-}
-
-if (require.main === module) {
-  try {
-    install();
-  } catch (error) {
-    console.error(`[gaia-cli] Failed to install binary: ${error.message}`);
-    console.error('[gaia-cli] Please check network access to OSS assets or contact the administrator.');
-    process.exit(1);
-  }
-}
-
-module.exports = {
-  ALLOWED_DOWNLOAD_HOSTS,
-  archName,
+  const url = options.url || downloadUrl(version);
+  const archivePath = path.join(os.tmpdir(), archiveName(version));
+  const unpackDir = path.join(os.tmpdir(), `gaia-cli-${process.pid}-${Date.now()}`);
+  const finalBinary = path.join(BIN_DIR, binaryName());
+
+  console.error(`[gaia-cli] Downloading ${url}`);
+  ensureDir(BIN_DIR);
+  downloadWithRedirects(url, archivePath);
+  extractArchive(archivePath, unpackDir);
+
+  const downloadedBinary = findDownloadedBinary(unpackDir);
+  fs.copyFileSync(downloadedBinary, finalBinary);
+  if (process.platform !== 'win32') {
+    fs.chmodSync(finalBinary, 0o755);
+  }
+
+  fs.rmSync(archivePath, { force: true });
+  fs.rmSync(unpackDir, { recursive: true, force: true });
+  console.error(`[gaia-cli] Installed ${finalBinary}`);
+}
+
+if (require.main === module) {
+  try {
+    install();
+  } catch (error) {
+    console.error(`[gaia-cli] Failed to install binary: ${error.message}`);
+    console.error('[gaia-cli] Please check network access to OSS assets or contact the administrator.');
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  ALLOWED_DOWNLOAD_HOSTS,
+  archName,
   archiveName,
   assertAllowedUrl,
   assertInstallableVersion,
-  binaryName,
-  downloadUrl,
-  findDownloadedBinary,
-  install,
-  normalizeVersion,
-  platformName,
-  releaseTag,
-};
+  binaryName,
+  downloadUrl,
+  findDownloadedBinary,
+  install,
+  normalizeVersion,
+  platformName,
+  releaseTag,
+};

package/scripts/run.js

@@ -1,20 +1,20 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-const { binaryName } = require('./install');
-
-const PACKAGE_ROOT = path.resolve(__dirname, '..');
-const BINARY_PATH = path.join(PACKAGE_ROOT, 'bin', binaryName());
-
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const { binaryName } = require('./install');
+
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const BINARY_PATH = path.join(PACKAGE_ROOT, 'bin', binaryName());
+
 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);
+  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) {
@@ -30,30 +30,30 @@ function runUninstaller(args) {
   });
   process.exit(typeof result.status === 'number' ? result.status : 1);
 }
-
-function ensureBinary() {
-  if (fs.existsSync(BINARY_PATH)) return;
-  const result = spawnSync(process.execPath, [path.join(__dirname, 'install.js')], {
-    stdio: 'inherit',
-  });
-  if (result.status !== 0) {
-    process.exit(typeof result.status === 'number' ? result.status : 1);
-  }
-}
-
-function runBinary(args) {
-  ensureBinary();
-  const result = spawnSync(BINARY_PATH, args, {
-    stdio: 'inherit',
-  });
-  if (result.error) {
-    console.error(`[gaia-cli] Failed to run ${BINARY_PATH}: ${result.error.message}`);
-    process.exit(1);
-  }
-  process.exit(typeof result.status === 'number' ? result.status : 1);
-}
-
-const args = process.argv.slice(2);
+
+function ensureBinary() {
+  if (fs.existsSync(BINARY_PATH)) return;
+  const result = spawnSync(process.execPath, [path.join(__dirname, 'install.js')], {
+    stdio: 'inherit',
+  });
+  if (result.status !== 0) {
+    process.exit(typeof result.status === 'number' ? result.status : 1);
+  }
+}
+
+function runBinary(args) {
+  ensureBinary();
+  const result = spawnSync(BINARY_PATH, args, {
+    stdio: 'inherit',
+  });
+  if (result.error) {
+    console.error(`[gaia-cli] Failed to run ${BINARY_PATH}: ${result.error.message}`);
+    process.exit(1);
+  }
+  process.exit(typeof result.status === 'number' ? result.status : 1);
+}
+
+const args = process.argv.slice(2);
 if (args[0] === 'install') {
   runInstallWizard(args.slice(1));
 }