@tedbrain/vlink 0.1.62 → 0.1.63

package/README.md

@@ -9,7 +9,14 @@ npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest install
 ```
 
 该命令会识别平台和架构，始终安装与当前 npm 包版本一致的 vlink，配置用户
-PATH，并启动 `vlink setup tedbrain`。安装完成后可直接运行：
+PATH，并启动 `vlink setup tedbrain`。如果 PATH 中已有原生 vlink，会优先更新该位置；
+旧文件或目录不可写时，自动回退到用户安装目录（Unix 为 `~/.local/bin`，Windows 为
+`%LOCALAPPDATA%\TedBrain\bin`），保留原来的共享安装。显式设置 `VLINK_INSTALL_DIR`
+时始终使用该目录，写入失败会报错，不会再改装到其他位置。
+
+安装目录会优先加入当前安装进程的 PATH，补全和 setup 均使用新二进制的绝对路径。
+默认目录还会写入 shell 配置或 Windows 用户 PATH；自定义 Unix 目录需要自行配置
+永久 PATH。完成后请打开新终端，让 PATH 和 shell 命令缓存更新，再运行：
 
 ```bash
 vlink --version
@@ -28,6 +35,8 @@ Windows 会在 `vlink.exe` 旁同时生成 `vlink.cmd`。安装目录加入用
 npx --registry=https://registry.npmmirror.com -y @tedbrain/vlink@latest --version
 ```
 
+安装命令会输出安装目标、权限回退原因及 setup 状态；失败时输出错误并返回非零退出码。
+
 手动配置 Agent 时可以只安装或更新 vlink，并跳过 TedBrain 配置向导：
 
 ```bash

package/binaries.json

@@ -1,12 +1,12 @@
 {
-  "version": "0.1.62",
+  "version": "0.1.63",
   "binaries": {
-    "linux-x86_64": "367f723806e56bf5e5b882093aa3963045f743038e94a03163a1472912e24f63",
-    "linux-x86_64-glibc2.17": "6e72ba9f87e7f28d8ff7316be91b611ab3b9213503626623aaaa67458b6b5804",
-    "linux-aarch64": "a949d6df1361d2387a86cdf9849552020a3a2158e9a010da244cf4344fb86141",
-    "macos-x86_64": "e26767ec171771221b8421a02e1c349dc3633bfc8ae1fc7b921e0f502d4fab0a",
-    "macos-aarch64": "d59088bfd940376fa7fcea054e31ccf632ea2553a043da5d417d463deaf6429c",
-    "windows-x86_64.exe": "01482e74fa89c6536ab75278636d2dfab861c69f4e8e2060dc5a3977a2f9b8b6",
-    "windows-aarch64.exe": "572b403ac1ee1dcfd6dbcf8135c28f23fa7dfeca92fe1e958f7560ebc661cad0"
+    "linux-x86_64": "dffb9115be72e1b1546e5d5adc9a208de7ac869f89cfc1692edb8ef60a05e8d1",
+    "linux-x86_64-glibc2.17": "0acfdaec9e600817d55a389b9889c476dbfa9842768c9e431ef3c44df7e0fa5a",
+    "linux-aarch64": "f8a3a086cf963db72d380e410c5264dc25659c44f3770597bc36d3021bf2376c",
+    "macos-x86_64": "bc917cf21d802dc804acdcbd06eb769cd520a12475b25db9e8238036db7383ed",
+    "macos-aarch64": "14b831e1f7ff7b09def2efc34e74d0a05d437cd1650c1c6f3c254cd08fc48b64",
+    "windows-x86_64.exe": "c9ca055f7791b095f8cc958ffa0fab4d01eb0fa9b36801e25a51982ceeaf30fd",
+    "windows-aarch64.exe": "717d470b48a10b1a16d897e56738447b3b7d6128cf02ea8f428e481117e80cd4"
   }
 }

package/installer.js

@@ -8,6 +8,8 @@ const { spawnSync } = require('child_process');
 
 const installModule = require('./install');
 
+const PERMISSION_ERRORS = new Set(['EACCES', 'EPERM', 'EROFS']);
+
 const CURRENT_WRAPPER = path.resolve(__dirname, 'bin', 'vlink.js');
 
 class VlinkSetupError extends Error {}
@@ -110,8 +112,8 @@ function prependEnvironmentPath(directory, env, platform) {
   const entries = String(current)
     .split(delimiter)
     .filter(Boolean);
-  const alreadyPresent = entries.some((entry) => entry === directory);
-  const next = alreadyPresent ? entries.join(delimiter) : [directory, ...entries].join(delimiter);
+  const next = [directory, ...entries.filter((entry) => !samePath(entry, directory, platform))]
+    .join(delimiter);
 
   for (const key of Object.keys(env)) {
     if (key.toLowerCase() === 'path') delete env[key];
@@ -137,8 +139,9 @@ function updateWindowsUserPath(directory, options) {
     "$entry = $env:TEDBRAIN_INSTALL_DIR.TrimEnd('\\')",
     "$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')",
     "$entries = @($userPath -split ';' | Where-Object { $_ })",
-    "if (-not ($entries | Where-Object { $_.TrimEnd('\\') -ieq $entry })) {",
-    "  $newPath = (@($env:TEDBRAIN_INSTALL_DIR) + $entries) -join ';'",
+    "$remaining = @($entries | Where-Object { $_.TrimEnd('\\') -ine $entry })",
+    "$newPath = (@($env:TEDBRAIN_INSTALL_DIR) + $remaining) -join ';'",
+    "if ($newPath -cne $userPath) {",
     "  [Environment]::SetEnvironmentVariable('Path', $newPath, 'User')",
     "  Write-Output 'changed'",
     "}"
@@ -293,7 +296,7 @@ function installBinary(sourcePath, targetPath, options = {}) {
 
   if (options.stopDaemon) {
     log('stopping the existing vlink daemon before replacement', output);
-    const stop = spawnSyncImpl(sourcePath, ['daemon', 'stop'], { stdio: 'inherit' });
+    const stop = spawnSyncImpl(sourcePath, ['daemon', 'stop'], { stdio: 'inherit', env: options.env });
     const failure = commandFailure(stop, 'vlink daemon stop');
     if (failure) throw new VlinkSetupError(failure);
   }
@@ -311,7 +314,9 @@ function installBinary(sourcePath, targetPath, options = {}) {
     fsImpl.renameSync(temporary, targetPath);
   } catch (error) {
     fsImpl.rmSync(temporary, { force: true });
-    throw new VlinkSetupError(`failed to install vlink at ${targetPath}: ${error.message}`);
+    const failure = new VlinkSetupError(`failed to install vlink at ${targetPath}: ${error.message}`);
+    failure.code = error.code;
+    throw failure;
   }
   fsImpl.rmSync(temporary, { force: true });
   log(`installed vlink at ${targetPath}`, output);
@@ -364,6 +369,7 @@ function installShellCompletion(vlinkPath, options = {}) {
     vlinkPath,
     ['completion', '--install', '--quiet'],
     {
+      env: options.env,
       encoding: 'utf8',
       stdio: ['ignore', 'pipe', 'pipe']
     }
@@ -423,7 +429,7 @@ async function runInstaller(options = {}) {
         : env.VLINK_GLIBC_VERSION,
     spawnSync: spawnSyncImpl
   });
-  const installDir = defaultInstallDir(spec, env, home);
+  const installDir = path.resolve(defaultInstallDir(spec, env, home));
   const targetPath = installPathFor(spec, installDir);
   const sharedOptions = {
     env,
@@ -447,7 +453,6 @@ async function runInstaller(options = {}) {
     );
   } else if (isExecutableFile(targetPath, platform, fsImpl)) {
     vlinkPath = targetPath;
-    ensureUserPath(installDir, sharedOptions);
     log(
       `found vlink at ${vlinkPath}; installing vlink ${installModule.VERSION}`,
       output
@@ -457,16 +462,35 @@ async function runInstaller(options = {}) {
   }
 
   const replacingExisting = Boolean(vlinkPath);
-  const installTarget = vlinkPath || targetPath;
+  let installTarget = env.VLINK_INSTALL_DIR ? targetPath : (vlinkPath || targetPath);
+  // Avoid trying to replace a shared installation, even if its parent is writable.
+  if (vlinkPath && !env.VLINK_INSTALL_DIR && !samePath(vlinkPath, targetPath, platform)) {
+    try {
+      fsImpl.accessSync(vlinkPath, fs.constants.W_OK);
+      fsImpl.accessSync(path.dirname(vlinkPath), fs.constants.W_OK);
+    } catch (error) {
+      if (!PERMISSION_ERRORS.has(error.code)) throw error;
+      log(`cannot replace ${vlinkPath} (${error.code}); falling back to ${targetPath}`, output);
+      installTarget = targetPath;
+    }
+  }
+  installTarget = path.resolve(installTarget);
+  log(`installation target: ${installTarget}`, output);
   const sourcePath = await ensureBinary({});
-  installBinary(sourcePath, installTarget, {
-    ...sharedOptions,
-    stopDaemon: replacingExisting
-  });
-  if (
-    !replacingExisting ||
-    samePath(path.dirname(installTarget), installDir, platform)
-  ) {
+  try {
+    installBinary(sourcePath, installTarget, {
+      ...sharedOptions,
+      stopDaemon: replacingExisting
+    });
+  } catch (error) {
+    // Permissions may change after the access check, or an ACL can deny rename.
+    if (env.VLINK_INSTALL_DIR || samePath(installTarget, targetPath, platform) ||
+        !PERMISSION_ERRORS.has(error.code)) throw error;
+    log(`cannot replace ${installTarget} (${error.code}); falling back to ${targetPath}`, output);
+    installTarget = targetPath;
+    installBinary(sourcePath, installTarget, sharedOptions);
+  }
+  if (samePath(path.dirname(installTarget), installDir, platform)) {
     ensureUserPath(installDir, sharedOptions);
   }
   vlinkPath = installTarget;
@@ -483,12 +507,15 @@ async function runInstaller(options = {}) {
   } else {
     log('starting TedBrain Agent setup', output);
     const setup = spawnSyncImpl(vlinkPath, ['setup', 'tedbrain'], {
+      env,
       stdio: 'inherit'
     });
     const failure = commandFailure(setup, 'vlink setup tedbrain');
     if (failure) throw new VlinkSetupError(failure);
   }
 
+  log(`installation complete: ${vlinkPath}`, output);
+  log('open a new terminal to use the updated PATH', output);
   return { installDir, vlinkPath, commandShimPath, setupSkipped: skipSetup };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tedbrain/vlink",
-  "version": "0.1.62",
+  "version": "0.1.63",
   "description": "vlink Virtuoso bridge CLI installer. Installs the matching platform binary at npm install time, like Claude Code / Codex.",
   "license": "UNLICENSED",
   "bin": {