voidzero-dev / voidzero-dev/vite-plus

Vite Plus PATH shim can shadow external CLI upgrades (OpenCode example)

オープン
#2,181 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
主要言語
Rust
スター
5.8k
フォーク
262
平均マージ
1日 34分
マージ済み PR(30日)
135

説明

## Summary

On Windows, a Vite Plus-owned executable in `~\.vite-plus\bin` can remain ahead of a newer version installed by that CLI's own updater. The shell command then continues to run the stale Vite Plus executable.

OpenCode is the confirmed example below. This may affect any externally updatable CLI for which Vite Plus installs an executable with the same command name, but this report does **not** claim other packages are currently affected.

## Environment

- Windows
- Vite Plus: `0.2.4`
- OpenCode before upgrade: `1.17.18`

## Reproduction

```powershell
opencode --version
# 1.17.18

opencode upgrade --print-logs
```

The updater reported:

```text
Using method: npm
From 1.17.18 → 1.18.1
Upgrade complete
```

But immediately afterwards:

```powershell
opencode --version
# 1.17.18
```

## Investigation

The command resolved to the Vite Plus-owned path:

```text
C:\Users\\.vite-plus\bin\opencode.exe
```

The updater had installed OpenCode `1.18.1` at:

```text
C:\Users\\.vite-plus\js_runtime\node\22.19.0\node_modules\opencode-ai\bin\opencode.exe
```

Running that executable directly returned `1.18.1`; the PATH executable remained at `1.17.18`.

## Scope checked

- **Confirmed:** `opencode` was shadowed by the stale Vite Plus executable.
- **Not implicated in this installation:** `npm`, `npx`, and `corepack` resolve to NVM rather than `~\.vite-plus\bin`.
- **Potentially affected pattern:** any CLI that manages its own upgrades while Vite Plus also places a same-named executable earlier on PATH.

## Expected behavior

After a CLI reports a successful self-upgrade, its normal shell command should run the upgraded version.

## Workaround

Replacing the stale Vite Plus executable with the newly installed OpenCode executable made `opencode --version` report `1.18.1`.

## Suggested direction

Vite Plus could avoid installing static, same-named binaries for externally self-updating CLIs, make them forwarding shims, or provide a way to refresh the Vite Plus bin entry after an external upgrade.

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

Start by reproducing the Windows PowerShell case with `opencode --version` and `opencode upgrade --print-logs`, then inspect how Vite Plus places executables in `~/.vite-plus/bin` and how PATH resolves them. Done means a successful external upgrade causes the normal `opencode` command to run the newly installed version without manual replacement; preserve the stated scope around OpenCode unless other cases are confirmed.

索引モデルが issue の本文から書いたものです。

評価

技術スタック
node.js, rust
領域
cli, operating-systems, tooling
issue の種類
バグ
難易度
4/5
見積もり時間
3〜5日
活発さ
静か
明瞭さ
おおむね明確
初心者へのやさしさ
50/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。