bvm-core 1.1.3

package/README.md

@@ -0,0 +1,153 @@
+# BVM — Bun Version Manager
+
+BVM is a high-performance environment orchestrator designed for the Bun ecosystem. It leverages an **ArchSense (Self-Bootstrapping)** architecture, delivered via a **Global CDN (jsDelivr)** for instant availability. While providing a near-zero latency terminal experience, it maintains strict physical isolation between environments.
+
+[![Version](https://img.shields.io/github/v/release/EricLLLLLL/bvm?color=f472b6&label=latest)](https://github.com/EricLLLLLL/bvm/releases)
+[![License](https://img.shields.io/github/license/EricLLLLLL/bvm?color=orange)](#)
+[![Platform](https://img.shields.io/badge/platform-win%20%7C%20mac%20%7C%20linux-blue)](#)
+
+<a href="./README.zh-CN.md">🇨🇳 中文文档</a>
+
+---
+
+## Table of Contents
+
+- [About](#about)
+- [Installation](#installation)
+  - [Install Script](#install-script)
+  - [Verify Installation](#verify-installation)
+  - [Manual Update](#manual-update)
+- [Usage](#usage)
+  - [Basic Commands](#basic-commands)
+  - [Running Commands](#running-commands)
+  - [Aliases](#aliases)
+- [Configuration](#configuration)
+  - [.bvmrc](#bvmrc)
+- [Design Philosophy](#design-philosophy)
+  - [ArchSense (Self-Bootstrapping)](#archsense-self-bootstrapping)
+  - [Smart Registry Racing](#smart-registry-racing)
+  - [Atomic Isolation](#atomic-isolation)
+- [Technical Audit](#technical-audit)
+- [Environment Variables](#environment-variables)
+- [License](#license)
+
+---
+
+## About
+
+BVM was engineered to solve the common pitfalls of traditional version managers: shell startup lag and environment leakage. By utilizing **NTFS Junctions/Unix Symlinks** and dynamic path injection, BVM ensures that your global packages and Bun runtimes remain perfectly isolated and instantly available.
+
+---
+
+## Installation
+
+### Install Script
+
+To install or update BVM, you should run the install script.
+
+**macOS / Linux / WSL:**
+```bash
+curl -fsSL https://cdn.jsdelivr.net/gh/EricLLLLLL/bvm@main/install.sh | bash
+```
+
+**Windows (Native PowerShell):**
+```powershell
+irm https://cdn.jsdelivr.net/gh/EricLLLLLL/bvm@main/install.ps1 | iex
+```
+
+### Verify Installation
+
+To verify that BVM has been installed correctly, open a new terminal and run:
+```bash
+bvm --version
+```
+
+### Manual Update
+
+If you already have BVM installed, you can upgrade to the latest version using the built-in command:
+```bash
+bvm upgrade
+```
+
+---
+
+## Usage
+
+### Basic Commands
+
+*   `bvm install latest`: Install the latest stable version of Bun.
+*   `bvm install 1.1.0`: Install a specific version.
+*   `bvm use 1.1.0`: Switch the active Bun version immediately.
+*   `bvm default 1.1.0`: Set a global default version for new shell sessions.
+*   `bvm ls`: List all locally installed versions.
+*   `bvm ls-remote`: List all available versions from the registry.
+*   `bvm uninstall 1.1.0`: Remove a specific version.
+
+### Running Commands
+
+You can run a command with a specific Bun version without switching your global environment:
+```bash
+bvm run 1.0.30 index.ts
+```
+
+### Aliases
+
+Create custom names for specific versions:
+```bash
+bvm alias prod 1.1.0
+bvm use prod
+```
+
+---
+
+## Configuration
+
+### .bvmrc
+
+BVM supports automatic version switching via `.bvmrc` files. Create a file named `.bvmrc` in your project root containing the version number:
+
+```bash
+echo "1.1.0" > .bvmrc
+```
+
+Once configured, any `bun` command executed within that directory (or its subdirectories) will automatically use the specified version.
+
+---
+
+## Design Philosophy
+
+### ArchSense (Self-Bootstrapping)
+BVM does not ship with heavy pre-compiled binaries. Instead, it uses **Bun to manage Bun**. The installer downloads a minimal Bun runtime to serve as BVM's execution engine, ensuring the manager itself is always running on the most optimized environment.
+
+### Smart Registry Racing
+BVM eliminates the need for manual mirror configuration. It identifies your location via Cloudflare Trace and concurrently "races" multiple registries (Official NPM, Taobao, Tencent) to pick the lowest-latency endpoint for your current network.
+
+### Atomic Isolation
+Unlike managers that only switch the `PATH`, BVM performs **Filesystem-level Locking**. It dynamically injects a unique `BUN_INSTALL` path for every version, ensuring that global packages installed in one version never conflict with another.
+
+---
+
+## Technical Audit
+
+| Metric | **BVM** | **bum** | **nvm** |
+| :--- | :--- | :--- | :--- |
+| **Shell Init Overhead** | **~9ms (Near-Zero)** | < 5ms | ~500ms (Blocking) |
+| **Shim Latency** | **~8ms (Pure Bash/JS)** | ~20ms | ~100ms (Func Trap) |
+| **Core Footprint** | **~50 KB (JS)** | ~5 MB (Binary) | ~100 KB (Scripts) |
+| **Windows Support** | **Native Junctions** | Partial | No (WSL Only) |
+
+---
+
+## Environment Variables
+
+BVM respects the following environment variables:
+
+*   `BVM_DIR`: The directory where BVM stores its data (Default: `~/.bvm`).
+*   `BVM_REGISTRY`: Force a specific NPM registry for downloads.
+*   `BVM_MIRROR`: (Legacy) Fallback mirror URL.
+
+---
+
+## License
+
+MIT © [EricLLLLLL](https://github.com/EricLLLLLL)

package/README.zh-CN.md

@@ -0,0 +1,153 @@
+# BVM — Bun 版本管理器
+
+BVM 是为 Bun 生态量身定制的高性能环境编排工具。它采用 **ArchSense (架构自举)** 设计哲学，利用 Bun 驱动自身，并通过 **全球 CDN (jsDelivr)** 极速分发。在提供近乎零延迟的终端启动体验的同时，实现了物理级的环境原子隔离。
+
+[![Version](https://img.shields.io/github/v/release/EricLLLLLL/bvm?color=f472b6&label=latest)](https://github.com/EricLLLLLL/bvm/releases)
+[![License](https://img.shields.io/github/license/EricLLLLLL/bvm?color=orange)](#)
+[![Platform](https://img.shields.io/badge/platform-win%20%7C%20mac%20%7C%20linux-blue)](#)
+
+<a href="./README.md">🇺🇸 English Docs</a>
+
+---
+
+## 目录 (Table of Contents)
+
+- [关于项目](#关于项目)
+- [安装指南](#安装指南)
+  - [安装脚本](#安装脚本)
+  - [验证安装](#验证安装)
+  - [手动更新](#手动更新)
+- [基本用法](#基本用法)
+  - [常用命令](#常用命令)
+  - [执行命令](#执行命令)
+  - [别名管理](#别名管理)
+- [项目配置](#项目配置)
+  - [.bvmrc](#bvmrc)
+- [设计哲学](#设计哲学)
+  - [ArchSense (架构自举)](#archsense-架构自举)
+  - [智能镜像竞速](#智能镜像竞速)
+  - [原子化隔离](#原子化隔离)
+- [技术审计 (竞品对比)](#技术审计-架构级优势)
+- [环境变量](#环境变量)
+- [开源协议](#开源协议)
+
+---
+
+## 关于项目
+
+BVM 旨在解决传统版本管理器常见的两大痛点：终端启动延迟和环境泄漏。通过利用 **NTFS 联接点 (Junctions) / Unix 软链接** 以及动态路径注入技术，BVM 确保了全球包和 Bun 运行时在物理上的完全隔离，并实现了无感的启动速度。
+
+---
+
+## 安装指南
+
+### 安装脚本
+
+运行以下命令即可完成安装或更新。
+
+**macOS / Linux / WSL:**
+```bash
+curl -fsSL https://cdn.jsdelivr.net/gh/EricLLLLLL/bvm@main/install.sh | bash
+```
+
+**Windows (原生 PowerShell):**
+```powershell
+irm https://cdn.jsdelivr.net/gh/EricLLLLLL/bvm@main/install.ps1 | iex
+```
+
+### 验证安装
+
+要验证 BVM 是否安装成功，请打开新终端并运行：
+```bash
+bvm --version
+```
+
+### 手动更新
+
+如果您已经安装了 BVM，可以使用内置命令一键升级到最新版：
+```bash
+bvm upgrade
+```
+
+---
+
+## 基本用法
+
+### 常用命令
+
+*   `bvm install latest`: 安装最新的稳定版 Bun。
+*   `bvm install 1.1.0`: 安装指定版本。
+*   `bvm use 1.1.0`: 立即切换活跃的 Bun 版本。
+*   `bvm default 1.1.0`: 设置全局默认版本（新窗口生效）。
+*   `bvm ls`: 列出本地已安装的所有版本。
+*   `bvm ls-remote`: 列出注册表上可用的所有版本。
+*   `bvm uninstall 1.1.0`: 卸载指定版本。
+
+### 执行命令
+
+您可以在不切换全局环境的情况下，使用特定版本运行命令：
+```bash
+bvm run 1.0.30 index.ts
+```
+
+### 别名管理
+
+为特定版本创建自定义名称：
+```bash
+bvm alias prod 1.1.0
+bvm use prod
+```
+
+---
+
+## 项目配置
+
+### .bvmrc
+
+BVM 支持通过 `.bvmrc` 文件自动切换版本。在项目根目录下创建一个包含版本号的文件：
+
+```bash
+echo "1.1.0" > .bvmrc
+```
+
+配置完成后，在该目录（及其子目录）下执行任何 `bun` 命令，系统都将自动识别并应用指定版本。
+
+---
+
+## 设计哲学
+
+### ArchSense (架构自举)
+BVM 不分发沉重的预编译二进制文件。相反，它利用 **Bun 管理 Bun**。安装程序会首先下载一个极简的 Bun 运行时作为 BVM 的执行引擎，确保管理器自身始终运行在最优化的环境中。
+
+### 智能镜像竞速
+BVM 彻底消除了手动配置镜像的烦恼。它通过 Cloudflare Trace 识别地理位置，并同时对多个注册表（官方 NPM、淘宝、腾讯）发起“竞速”，自动为您选择当前网络下延迟最低的节点。
+
+### 原子化隔离
+不同于仅切换 `PATH` 的管理器，BVM 实现了 **文件系统级锁定**。它在执行命令前动态注入唯一的 `BUN_INSTALL` 路径，确保不同版本间安装的全局包永不冲突。
+
+---
+
+## 技术审计 (架构级优势)
+
+| 审计维度 | **BVM** (本项目) | **bum** (Rust版) | **nvm** (Shell版) |
+| :--- | :--- | :--- | :--- |
+| **终端初始化开销** | **~9ms (极低损耗)** | < 5ms | ~500ms (明显卡顿) |
+| **转发器运行时损耗** | **~8ms (内核转发)** | ~20ms | ~100ms (Shell函数) |
+| **核心逻辑体积** | **~50 KB (JS)** | ~5 MB | ~100 KB |
+| **Windows 适配** | **原生 Junctions** | 部分支持 | 不原生支持 |
+
+---
+
+## 环境变量
+
+BVM 支持以下环境变量配置：
+
+*   `BVM_DIR`: BVM 数据存储目录（默认：`~/.bvm`）。
+*   `BVM_REGISTRY`: 强制指定用于下载的 NPM 注册表。
+*   `BVM_MIRROR`: (旧版兼容) 镜像源地址。
+
+---
+
+## 开源协议
+
+MIT © [EricLLLLLL](https://github.com/EricLLLLLL)

package/dist/bvm-shim.js

@@ -0,0 +1,77 @@
+const path = require('path');
+const { spawn } = require('child_process');
+const os = require('os');
+const fs = require('fs');
+
+/**
+ * BVM Shim for Windows (JavaScript version)
+ */
+
+const BVM_DIR = process.env.BVM_DIR || path.join(os.homedir(), '.bvm');
+const CMD = process.argv[2] ? process.argv[2].replace(/\.exe$/i, '').replace(/\.cmd$/i, '') : 'bun';
+const ARGS = process.argv.slice(3);
+
+function resolveVersion() {
+  if (process.env.BVM_ACTIVE_VERSION) {
+    const v = process.env.BVM_ACTIVE_VERSION.trim();
+    return v.startsWith('v') ? v : 'v' + v;
+  }
+
+  let dir = process.cwd();
+  try {
+    const { root } = path.parse(dir);
+    while (true) {
+        const rc = path.join(dir, '.bvmrc');
+        if (fs.existsSync(rc)) {
+            const v = fs.readFileSync(rc, 'utf8').trim().replace(/^v/, '');
+            if (v) return 'v' + v;
+        }
+        if (dir === root) break;
+        dir = path.dirname(dir);
+    }
+  } catch(e) {}
+
+  const current = path.join(BVM_DIR, 'current');
+  if (fs.existsSync(current)) {
+    try {
+        const target = fs.realpathSync(current); 
+        const v = path.basename(target); 
+        if (v && v.startsWith('v')) return v;
+    } catch(e) {}
+  }
+  
+  const def = path.join(BVM_DIR, 'aliases', 'default');
+  if (fs.existsSync(def)) {
+      try {
+          const v = fs.readFileSync(def, 'utf8').trim().replace(/^v/, '');
+          if (v) return 'v' + v;
+      } catch(e) {}
+  }
+  return '';
+}
+
+// Simple synchronous execution for performance
+const version = resolveVersion();
+if (!version) {
+    console.error("BVM Error: No Bun version is active or default is set.");
+    process.exit(1);
+}
+
+const versionDir = path.join(BVM_DIR, 'versions', version);
+const binDir = path.join(versionDir, 'bin');
+const realExecutable = path.join(binDir, CMD + '.exe');
+
+if (!fs.existsSync(realExecutable)) {
+    console.error("BVM Error: Command '" + CMD + "' not found in Bun " + version + " at " + realExecutable);
+    process.exit(127);
+}
+
+process.env.BUN_INSTALL = versionDir;
+process.env.PATH = binDir + path.delimiter + process.env.PATH;
+
+const child = spawn(realExecutable, ARGS, { stdio: 'inherit', shell: false });
+child.on('exit', (code) => process.exit(code ?? 0));
+child.on('error', (err) => {
+    console.error("BVM Error: Failed to start child process: " + err.message);
+    process.exit(1);
+});

package/dist/bvm-shim.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# Shim managed by BVM (Bun Version Manager)
+# Optimized for performance via Bash-native syntax.
+
+BVM_DIR="${BVM_DIR:-$HOME/.bvm}"
+CMD_NAME="$1"
+shift
+
+if [ -z "$CMD_NAME" ]; then
+    echo "BVM Error: No command specified." >&2
+    exit 1
+fi
+
+# --- 1. Fast Path: Active Version or Local .bvmrc ---
+if [ -n "$BVM_ACTIVE_VERSION" ]; then
+    VERSION="$BVM_ACTIVE_VERSION"
+elif [ -f ".bvmrc" ]; then
+    # Read first line, strip whitespace and 'v' prefix using pure Bash
+    read -r raw_ver < .bvmrc
+    VERSION="v${raw_ver//[v[:space:]]/}"
+fi
+
+# --- 2. Slow Path: Recursive .bvmrc Search or Default ---
+if [ -z "$VERSION" ]; then
+    CUR_DIR="$PWD"
+    while [ "$CUR_DIR" != "/" ] && [ -n "$CUR_DIR" ]; do
+        if [ -f "$CUR_DIR/.bvmrc" ]; then
+            read -r raw_ver < "$CUR_DIR/.bvmrc"
+            VERSION="v${raw_ver//[v[:space:]]/}"
+            break
+        fi
+        CUR_DIR=$(dirname "$CUR_DIR")
+    done
+
+    # Fallback to current symlink (most common production case)
+    if [ -z "$VERSION" ] && [ -L "$BVM_DIR/current" ]; then
+        VERSION_PATH=$(readlink "$BVM_DIR/current")
+        VERSION="${VERSION_PATH##*/}"
+    fi
+
+    # Fallback to default alias
+    if [ -z "$VERSION" ] && [ -f "$BVM_DIR/aliases/default" ]; then
+        read -r raw_ver < "$BVM_DIR/aliases/default"
+        VERSION="${raw_ver//[[:space:]]/}"
+    fi
+fi
+
+if [ -z "$VERSION" ]; then
+    echo "BVM Error: No Bun version active." >&2
+    exit 1
+fi
+
+# Ensure 'v' prefix
+[[ "$VERSION" != v* ]] && VERSION="v$VERSION"
+VERSION_DIR="$BVM_DIR/versions/$VERSION"
+REAL_EXECUTABLE="$VERSION_DIR/bin/$CMD_NAME"
+
+if [ -x "$REAL_EXECUTABLE" ]; then
+    export BUN_INSTALL="$VERSION_DIR"
+    export PATH="$VERSION_DIR/bin:$PATH"
+    exec "$REAL_EXECUTABLE" "$@"
+else
+    echo "BVM Error: Command '$CMD_NAME' not found in Bun $VERSION." >&2
+    exit 127
+fi