Merge branch 'claude/cli-repl'

# Conflicts:
#	src/runtime/cli/install_completions_command.rs

Author: liooil

.buildkite/Dockerfile

@@ -1,16 +1,12 @@
-ARG LLVM_VERSION="21"
-ARG REPORTED_LLVM_VERSION="21.1.8"
 ARG OLD_BUN_VERSION="1.3.13"
 ARG BUILDKITE_AGENT_TAGS="queue=linux,os=linux,arch=${TARGETARCH}"
 
 FROM --platform=$BUILDPLATFORM ubuntu:20.04 as base-arm64
 FROM --platform=$BUILDPLATFORM ubuntu:20.04 as base-amd64
 FROM base-$TARGETARCH as base
 
-ARG LLVM_VERSION
 ARG OLD_BUN_VERSION
 ARG TARGETARCH
-ARG REPORTED_LLVM_VERSION
 
 ENV DEBIAN_FRONTEND=noninteractive \
    CI=true \
@@ -35,7 +31,9 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
        libgfortran5 libc6-dev \
    && wget https://apt.llvm.org/llvm.sh \
    && chmod +x llvm.sh \
-   && ./llvm.sh ${LLVM_VERSION} all \
+   && ./llvm.sh all \
+   && llvm_root="$(ls -d /usr/lib/llvm-* | sort -V | tail -n 1)" \
+   && ln -sfn "$llvm_root" /usr/lib/llvm \
    && rm llvm.sh \
    && rm -rf /var/lib/apt/lists/*
 
@@ -75,22 +73,22 @@ RUN if [ "$TARGETARCH" = "arm64" ]; then \
    && echo "/usr/lib/${ARCH_PATH}" >> /etc/ld.so.conf.d/gcc-13.conf \
    && ldconfig
 
-RUN for f in /usr/lib/llvm-${LLVM_VERSION}/bin/*; do ln -sf "$f" /usr/bin; done \
-   && ln -sf /usr/bin/clang-${LLVM_VERSION} /usr/bin/clang \
-   && ln -sf /usr/bin/clang++-${LLVM_VERSION} /usr/bin/clang++ \
-   && ln -sf /usr/bin/lld-${LLVM_VERSION} /usr/bin/lld \
-   && ln -sf /usr/bin/lldb-${LLVM_VERSION} /usr/bin/lldb \
-   && ln -sf /usr/bin/clangd-${LLVM_VERSION} /usr/bin/clangd \
-   && ln -sf /usr/bin/llvm-ar-${LLVM_VERSION} /usr/bin/llvm-ar \
+RUN for f in /usr/lib/llvm/bin/*; do ln -sf "$f" /usr/bin; done \
+   && ln -sf /usr/lib/llvm/bin/clang /usr/bin/clang \
+   && ln -sf /usr/lib/llvm/bin/clang++ /usr/bin/clang++ \
+   && ln -sf /usr/lib/llvm/bin/lld /usr/bin/lld \
+   && ln -sf /usr/lib/llvm/bin/lldb /usr/bin/lldb \
+   && ln -sf /usr/lib/llvm/bin/clangd /usr/bin/clangd \
+   && ln -sf /usr/lib/llvm/bin/llvm-ar /usr/bin/llvm-ar \
    && ln -sf /usr/bin/ld.lld /usr/bin/ld \
    && ln -sf /usr/bin/clang /usr/bin/cc \
    && ln -sf /usr/bin/clang++ /usr/bin/c++
 
 ENV CC="clang" \
    CXX="clang++" \
-   AR="llvm-ar-${LLVM_VERSION}" \
-   RANLIB="llvm-ranlib-${LLVM_VERSION}" \
-   LD="lld-${LLVM_VERSION}"
+   AR="llvm-ar" \
+   RANLIB="llvm-ranlib" \
+   LD="ld.lld"
 
 RUN --mount=type=tmpfs,target=/tmp \
    bash -c '\
@@ -112,8 +110,6 @@ RUN ARCH=$(if [ "$TARGETARCH" = "arm64" ]; then echo "arm64"; else echo "x64"; f
       | tar -xz -C /usr/local --strip-components=1 && \
     node --version
 
-ENV LLVM_VERSION=${REPORTED_LLVM_VERSION}
-
 WORKDIR /workspace
 
 
@@ -251,7 +247,6 @@ CMD ["bun", "/var/bun/scripts/agent.mjs", "start"]
 
 FROM --platform=$BUILDPLATFORM base as bun-build-linux-local
 
-ARG LLVM_VERSION
 WORKDIR /workspace/bun
 
 COPY . /workspace/bun
@@ -268,9 +263,6 @@ RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y \
 
 ENV PATH=/root/.cargo/bin:$PATH
 
-ENV LLVM_VERSION=${REPORTED_LLVM_VERSION}
-
-
 RUN --mount=type=tmpfs,target=/workspace/bun/build \
     ls -la \
     && bun run build:release \

.github/workflows/bun-integration.yml

@@ -25,7 +25,6 @@ concurrency:
 env:
   BUN_VERSION: "1.3.2"
   CARGO_INCREMENTAL: "0"
-  LLVM_VERSION_MAJOR: "21"
   RUSTUP_TOOLCHAIN: nightly-2026-07-20
 
 jobs:
@@ -60,30 +59,27 @@ jobs:
         if: runner.os == 'Linux'
         shell: bash
         run: |
-          wget -qO- https://apt.llvm.org/llvm-snapshot.gpg.key |
-            sudo tee /etc/apt/trusted.gpg.d/apt.llvm.org.asc >/dev/null
-          codename="$(lsb_release -cs)"
-          echo \
-            "deb http://apt.llvm.org/${codename}/ llvm-toolchain-${codename}-${LLVM_VERSION_MAJOR} main" |
-            sudo tee /etc/apt/sources.list.d/llvm.list >/dev/null
           sudo apt-get update -qq
           sudo apt-get install -y -qq --no-install-recommends \
-            clang-${LLVM_VERSION_MAJOR} \
             cmake \
             curl \
             golang \
+            gnupg \
             libffi-dev \
             liblzma-dev \
             libtool \
-            lld-${LLVM_VERSION_MAJOR} \
-            llvm-${LLVM_VERSION_MAJOR} \
+            lsb-release \
             ninja-build \
             pkg-config \
             ruby-full \
             software-properties-common \
             unzip \
             wget \
             xz-utils
+          curl -fsSL https://apt.llvm.org/llvm.sh -o "$RUNNER_TEMP/llvm.sh"
+          sudo bash "$RUNNER_TEMP/llvm.sh" all
+          llvm_bin="$(ls -d /usr/lib/llvm-*/bin | sort -V | tail -n 1)"
+          echo "$llvm_bin" >> "$GITHUB_PATH"
 
       - name: Install Windows build dependencies
         if: runner.os == 'Windows'

CONTRIBUTING.md

@@ -35,7 +35,7 @@ $ sudo pacman -S base-devel cmake git go libiconv libtool make ninja pkg-config
 ```
 
 ```bash#Fedora
-$ sudo dnf install clang21 llvm21 lld21 cmake git golang libtool ninja-build pkg-config ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
+$ sudo dnf install clang llvm lld cmake git golang libtool ninja-build pkg-config ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
 ```
 
 ```bash#openSUSE Tumbleweed
@@ -94,17 +94,17 @@ Our build scripts will automatically detect and use `ccache` if available. You c
 
 ## Install LLVM
 
-Bun requires LLVM 21.1.8 (`clang` is part of LLVM). This version is enforced by the build system — mismatching versions will cause memory allocation failures at runtime. In most cases, you can install LLVM through your system package manager:
+Bun follows the current stable LLVM toolchain provided by your package source. The build only discovers the unversioned tools (`clang`, `clang++`, `ld.lld`, and the other `llvm-*` commands); it does not maintain fallbacks for older versioned release lines. In most cases, install LLVM through your system package manager:
 
 {% codetabs group="os" %}
 
 ```bash#macOS (Homebrew)
-$ brew install llvm@21
+$ brew install llvm
 ```
 
 ```bash#Ubuntu/Debian
 $ # LLVM has an automatic installation script that is compatible with all versions of Ubuntu
-$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 21 all
+$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- all
 ```
 
 ```bash#Arch
@@ -116,17 +116,18 @@ $ sudo dnf install llvm clang lld-devel
 ```
 
 ```bash#openSUSE Tumbleweed
-$ sudo zypper install clang21 lld21 llvm21
+$ sudo zypper install clang lld llvm
 ```
 
 {% /codetabs %}
 
-If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-21.1.8).
+If none of the above solutions apply, install the [latest stable LLVM release](https://github.com/llvm/llvm-project/releases/latest) manually.
 
-Make sure Clang/LLVM 21 is in your path:
+Make sure the unversioned Clang command resolves to that toolchain:
 
 ```bash
-$ which clang-21
+$ command -v clang
+$ clang --version
 ```
 
 If not, run this to manually add it:
@@ -135,13 +136,13 @@ If not, run this to manually add it:
 
 ```bash#macOS (Homebrew)
 # use fish_add_path if you're using fish
-# use path+="$(brew --prefix llvm@21)/bin" if you are using zsh
-$ export PATH="$(brew --prefix llvm@21)/bin:$PATH"
+# use path+="$(brew --prefix llvm)/bin" if you are using zsh
+$ export PATH="$(brew --prefix llvm)/bin:$PATH"
 ```
 
-```bash#Arch
-# use fish_add_path if you're using fish
-$ export PATH="$PATH:/usr/lib/llvm21/bin"
+```bash#Ubuntu/Debian (apt.llvm.org)
+$ LLVM_BIN="$(ls -d /usr/lib/llvm-*/bin | sort -V | tail -n 1)"
+$ export PATH="$LLVM_BIN:$PATH"
 ```
 
 {% /codetabs %}
@@ -318,7 +319,7 @@ The issue may manifest when initially running `bun setup` as Clang being unable
 ```
 The C++ compiler
 
-  "/usr/bin/clang++-21"
+  "/usr/bin/clang++"
 
 is not able to compile a simple test program.
 ```

README.md

@@ -58,12 +58,22 @@ The common project lifecycle should use one CLI:
 ```text
 poly run app.ts        # run a TypeScript entry point
 poly run tool.py       # run a Python entry point
+poly repl python       # start directly in Python REPL mode
 poly sync              # resolve both ecosystems
 poly build app.ts      # produce a standalone application
 ```
 
-`poly run` entry-point routing is part of the current prototype. Static
-cross-language imports, `poly sync`, and `poly build` are not implemented yet.
+`poly run` entry-point routing and the multi-language REPL are part of the
+current prototype. Static cross-language imports, `poly sync`, and `poly build`
+are not implemented yet.
+
+REPL history is shared across languages. Recalling an entry from another mode
+shows it as an inline command such as `.py value = 42`, so it runs in the
+language where it was originally entered.
+
+Interactive input uses language-specific syntax highlighting in JavaScript,
+Python, Shell, SQL, and C modes, including each language's strings, comments,
+numeric literals, keywords, and constructs such as expansions or preprocessors.
 
 ## One project, two ecosystems
 

README.zh-CN.md

@@ -53,12 +53,19 @@ import { python } from "poly";
 ```text
 poly run app.ts        # 运行 TypeScript 入口
 poly run tool.py       # 运行 Python 入口
+poly repl python       # 直接进入 Python REPL 模式
 poly sync              # 解析两个生态的依赖
 poly build app.ts      # 生成独立应用
 ```
 
-`poly run` 的入口分派属于当前原型。静态跨语言 import、`poly sync` 和
-`poly build` 尚未实现。
+`poly run` 的入口分派和多语言 REPL 属于当前原型。静态跨语言 import、
+`poly sync` 和 `poly build` 尚未实现。
+
+REPL history 由所有语言共享。回看其他模式的记录时会显示为 `.py value = 42`
+这样的 inline 命令，从而仍在最初录入它的语言中执行。
+
+JavaScript、Python、Shell、SQL 和 C 模式均提供各自的交互式语法高亮，包括该
+语言的字符串、注释、数值、关键字，以及变量展开或预处理指令等专有结构。
 
 ## 一个项目，两个生态
 

docs/project/building-windows.mdx

@@ -33,7 +33,7 @@ winget install "Visual Studio Community 2022" --override "--add Microsoft.Visual
 
 After Visual Studio, you need the following:
 
-- LLVM 21.1.8
+- The current stable LLVM release
 - Go
 - Rust (via rustup)
 - NASM
@@ -49,15 +49,13 @@ Use [Scoop](https://scoop.sh) to install these remaining tools.
 irm https://get.scoop.sh | iex
 scoop install nodejs-lts go rustup nasm ruby perl ccache
 # scoop seems to be buggy if you install llvm and the rest at the same time
-scoop install llvm@21.1.8
+scoop install llvm
 ```
 
-For Windows ARM64, download LLVM 21.1.8 directly from GitHub releases (first version with ARM64 Windows builds):
+For Windows ARM64, use Scoop's separate ARM64 LLVM manifest:
 
 ```ps1 ARM64
-# Download and install LLVM for ARM64
-Invoke-WebRequest -Uri "https://github.com/llvm/llvm-project/releases/download/llvmorg-21.1.8/LLVM-21.1.8-woa64.exe" -OutFile "$env:TEMP\LLVM-21.1.8-woa64.exe"
-Start-Process -FilePath "$env:TEMP\LLVM-21.1.8-woa64.exe" -ArgumentList "/S" -Wait
+scoop install llvm-arm64
 ```
 
 <Note>
@@ -142,7 +140,7 @@ You can also build Windows binaries (both x64 and arm64) on a Linux host. The bu
 
 ### Prerequisites
 
-1. The same LLVM version a native build uses (see `scripts/bootstrap.sh` `llvm_version_exact`), installed so that `clang-cl`, `lld-link`, `llvm-lib` and `llvm-rc` are available. On Debian/Ubuntu, `apt.llvm.org` packages provide all of them.
+1. The current stable LLVM toolchain, installed so the unversioned `clang-cl`, `lld-link`, `llvm-lib` and `llvm-rc` commands are available. On Debian/Ubuntu, `apt.llvm.org` packages provide all of them.
 2. `nasm` (only needed for Windows x64; BoringSSL's x64 assembly is NASM syntax).
 3. Rust std for the Windows targets (`rust-toolchain.toml` lists them; `rustup target add x86_64-pc-windows-msvc aarch64-pc-windows-msvc` if missing).
 4. A Windows sysroot: an [xwin](https://github.com/Jake-Shadle/xwin) splat of the MSVC CRT, Windows SDK, and ATL laid out like a Visual Studio install. Downloading these components means accepting Microsoft's license terms for them.

docs/project/contributing.mdx

@@ -37,7 +37,7 @@ sudo pacman -S base-devel cmake git go libiconv libtool make ninja pkg-config py
 ```
 
 ```bash Fedora
-sudo dnf install clang21 llvm21 lld21 cmake git golang libtool ninja-build pkg-config ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
+sudo dnf install clang llvm lld cmake git golang libtool ninja-build pkg-config ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
 ```
 
 ```bash openSUSE Tumbleweed
@@ -96,17 +96,17 @@ The build scripts detect and use `ccache` automatically if it's available. Check
 
 ## Install LLVM
 
-Bun requires LLVM 21.1.8 (`clang` is part of LLVM). The build system enforces this version: a mismatched version causes memory allocation failures at runtime. In most cases, you can install LLVM through your system package manager:
+Bun follows the current stable LLVM toolchain provided by your package source. The build only discovers the unversioned tools (`clang`, `clang++`, `ld.lld`, and the other `llvm-*` commands); it does not maintain fallbacks for older versioned release lines. In most cases, install LLVM through your system package manager:
 
 <CodeGroup>
 
 ```bash macOS (Homebrew)
-brew install llvm@21
+brew install llvm
 ```
 
 ```bash Ubuntu/Debian
 # LLVM has an automatic installation script that is compatible with all versions of Ubuntu
-wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 21 all
+wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- all
 ```
 
 ```bash Arch
@@ -118,17 +118,18 @@ sudo dnf install llvm clang lld-devel
 ```
 
 ```bash openSUSE Tumbleweed
-sudo zypper install clang21 lld21 llvm21
+sudo zypper install clang lld llvm
 ```
 
 </CodeGroup>
 
-If none of these work, install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-21.1.8).
+If none of these work, install the [latest stable LLVM release](https://github.com/llvm/llvm-project/releases/latest) manually.
 
-Make sure Clang/LLVM 21 is in your path:
+Make sure the unversioned Clang command resolves to that toolchain:
 
 ```bash
-which clang-21
+command -v clang
+clang --version
 ```
 
 If not, add it manually:
@@ -137,13 +138,13 @@ If not, add it manually:
 
 ```bash macOS (Homebrew)
 # use fish_add_path if you're using fish
-# use path+="$(brew --prefix llvm@21)/bin" if you are using zsh
-export PATH="$(brew --prefix llvm@21)/bin:$PATH"
+# use path+="$(brew --prefix llvm)/bin" if you are using zsh
+export PATH="$(brew --prefix llvm)/bin:$PATH"
 ```
 
-```bash Arch
-# use fish_add_path if you're using fish
-export PATH="$PATH:/usr/lib/llvm21/bin"
+```bash Ubuntu/Debian (apt.llvm.org)
+LLVM_BIN="$(ls -d /usr/lib/llvm-*/bin | sort -V | tail -n 1)"
+export PATH="$LLVM_BIN:$PATH"
 ```
 
 </CodeGroup>
@@ -322,7 +323,7 @@ The issue may also surface when first running `bun run build`, with Clang unable
 ```txt
 The C++ compiler
 
-  "/usr/bin/clang++-21"
+  "/usr/bin/clang++"
 
 is not able to compile a simple test program.
 ```