llm-switcher 1.1.0 → 1.1.2

package/README.md

@@ -191,7 +191,15 @@ flowchart LR
 
 ---
 
-## Changes in this update
+## Changes in 1.1.2
+
+- **npm package.** Install with `npm install -g llm-switcher` and run `switch`. An npm install keeps its data in `~/.llm-switcher`, so an upgrade does not erase your configuration. A git checkout keeps its data next to the code, as before.
+- **Contract lab.** The gateway can send a small sample of complete exchanges to an [intact](https://github.com/louisphamdev/intact) server, which finds fields that the converter loses. It is off by default. See "Contract lab" below.
+- **macOS.** `blindfold/make-certs.sh` now runs with LibreSSL, the default `openssl` on macOS.
+- **Upgrade from 1.1.0 or older.** A running gateway older than 1.1.1 cannot prove its identity. `switch` now names it and does not stop it. Stop it by hand once, then run `switch on`.
+- **Tests.** `npm test` runs only `tests/**/*.test.mjs`, also on Node.js 18 and 20.
+
+### Earlier changes
 
 - The desktop dashboard now uses a compact developer-tool layout. It has clearer route controls, keyboard-accessible tabs, labeled model fields, and no decorative emoji.
 - Codex profiles now use three documented roles: `main`, `review`, and `subagent`.
@@ -222,6 +230,8 @@ cp "$(npm root -g)/llm-switcher/config.example.json" ~/.llm-switcher/config.json
 
 An npm install keeps `config.json`, `admin.token` and the launch files in `~/.llm-switcher`. An upgrade replaces the package folder only, so your configuration stays.
 
+If you upgrade from 1.1.0 or older, stop the running gateway before you run `switch`. An older gateway cannot prove its identity, so `switch` does not stop it for you.
+
 **Option B: git clone**
 ```bash
 git clone https://github.com/louisphamdev/llm-switcher.git
@@ -235,21 +245,18 @@ A checkout keeps its data next to the code, as before. To use another folder in
 
 Edit `config.json` with your provider base URLs and API keys.
 
-With the npm install, run `switch <command>`. With a checkout, run `node switch.mjs <command>` or put the checkout on `PATH`.
+The **data folder** is `~/.llm-switcher` for an npm install and the checkout folder for a git clone. The examples below use the npm install. For a checkout, run `node switch.mjs <command>` instead of `switch <command>`, or put the checkout folder on `PATH`.
 
 ### 3. Start the Gateway
 ```bash
-# Start in foreground or background
-node switch.mjs on
+# Start the gateway in the background:
+switch on
 
-# Or run directly:
-node proxy.mjs
+# Or run it in the foreground (npm install):
+node "$(npm root -g)/llm-switcher/proxy.mjs"
 ```
 
-The repository ships two launchers for the same script: `switch` for Linux and macOS,
-`switch.cmd` for Windows. Put the repository directory on PATH and `switch <command>`
-works the same on all three. Platform differences, and the two features that are not
-available everywhere, are in [📖 `docs/cross-platform.md`](docs/cross-platform.md).
+`switch <command>` works the same on Linux, macOS and Windows. A checkout has its own launchers: `switch` for Linux and macOS, `switch.cmd` for Windows. Platform differences, and the two features that are not available everywhere, are in [📖 `docs/cross-platform.md`](docs/cross-platform.md).
 
 Open the Web Dashboard at: **[http://127.0.0.1:3456/ui](http://127.0.0.1:3456/ui)**
 
@@ -259,22 +266,24 @@ Open the Web Dashboard at: **[http://127.0.0.1:3456/ui](http://127.0.0.1:3456/ui
 
 ### Universal Environment Loader (`env.cmd` / `env.sh`)
 
-Every time you switch profiles, LLM Switcher writes ready-to-use environment loaders:
+Every time you switch profiles, LLM Switcher writes ready-to-use environment loaders into the data folder:
 
 - **Windows (Command Prompt / PowerShell wrapper):**
   ```cmd
-  call "path\to\llm-switcher\env.cmd"
+  call "%USERPROFILE%\.llm-switcher\env.cmd"
   ```
 - **macOS / Linux (Bash / Zsh):**
   ```bash
-  source "path/to/llm-switcher/env.sh"
+  source ~/.llm-switcher/env.sh
   ```
 
+For a checkout, use the same files in the checkout folder.
+
 ---
 
 ### Claude Code Setup (Windows)
 
-1. Create a quick wrapper in your PATH (e.g. `cc-switch.cmd`):
+1. With the npm install, `switch` is already on `PATH`. With a checkout, create a wrapper on your `PATH` (for example `cc-switch.cmd`):
    ```cmd
    @echo off
    node "path\to\llm-switcher\switch.mjs" %*
@@ -283,18 +292,18 @@ Every time you switch profiles, LLM Switcher writes ready-to-use environment loa
 2. Patch your global Claude Code launcher (`claude.cmd` in your npm global directory):
    ```cmd
    SETLOCAL EnableDelayedExpansion
-   IF EXIST "path\to\llm-switcher\active.flag" (
+   IF EXIST "%USERPROFILE%\.llm-switcher\active.flag" (
      SET "ANTHROPIC_BASE_URL=http://127.0.0.1:3456"
      SET "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1"
    )
-   IF EXIST "path\to\llm-switcher\1m.flag" (
-     SET /P M1M=<"path\to\llm-switcher\1m.flag"
+   IF EXIST "%USERPROFILE%\.llm-switcher\1m.flag" (
+     SET /P M1M=<"%USERPROFILE%\.llm-switcher\1m.flag"
      IF "!M1M!"=="" SET "M1M=opus[1m]"
      SET "ANTHROPIC_MODEL=!M1M!"
      SET "CLAUDE_CODE_AUTO_COMPACT_WINDOW=900000"
    )
    ```
-   > `SETLOCAL EnableDelayedExpansion` is required for `!M1M!`. npm rewrites `claude.cmd` on every update, so prefer a separate wrapper that runs `call "path\to\llm-switcher\env.cmd"` and then `claude %*`. Only `env.cmd` / `env.sh` carry the per-tier `ANTHROPIC_DEFAULT_<TIER>_MODEL=<tier>[1m]` variables.
+   > `SETLOCAL EnableDelayedExpansion` is required for `!M1M!`. npm rewrites `claude.cmd` on every update, so prefer a separate wrapper that runs `call "%USERPROFILE%\.llm-switcher\env.cmd"` and then `claude %*`. For a checkout, replace `%USERPROFILE%\.llm-switcher` with the checkout folder. Only `env.cmd` / `env.sh` carry the per-tier `ANTHROPIC_DEFAULT_<TIER>_MODEL=<tier>[1m]` variables.
 
 ---
 
@@ -337,7 +346,7 @@ base URL is overridden to http://127.0.0.1:3456/v1. Selecting models may not be
 Blindfold mode removes that line. Codex keeps its official endpoint, and the switcher intercepts the network hop instead. It needs no administrator rights, no certificate in a system trust store, and no change to `~/.codex/config.toml`.
 
 ```bash
-bash blindfold/make-certs.sh chatgpt.com   # once
+bash "$(npm root -g)/llm-switcher/blindfold/make-certs.sh" chatgpt.com   # once; a checkout runs blindfold/make-certs.sh
 # then set "blindfold": true in the Codex profile
 switch codex <profile>                     # the gateway starts the interceptor
 ```
@@ -414,12 +423,12 @@ A zero-dependency Model Context Protocol (MCP) server communicating over `stdio`
 
 NOTE: `switcher_recent_logs` returns the first 150 characters of each recent prompt, from every client that used the gateway. The agent that calls the tool can read them.
 
-Add to your MCP configuration (e.g. `opencode.jsonc`, `claude_desktop_config.json`, or Cursor):
+Add the server to your MCP configuration (for example `opencode.jsonc`, `claude_desktop_config.json`, or Cursor). Run `npm root -g` to get the folder that holds `llm-switcher/mcp.mjs`. For a checkout, use the `mcp.mjs` in the checkout folder.
 ```json
 "mcp": {
   "llm-switcher": {
     "type": "local",
-    "command": ["node", "path/to/llm-switcher/mcp.mjs"],
+    "command": ["node", "/path/from/npm-root-g/llm-switcher/mcp.mjs"],
     "enabled": true
   }
 }
@@ -548,14 +557,15 @@ The contract lab finds fields that the converter loses. It is off by default.
 
 | Option | Description |
 |---|---|
-| `LLM_SWITCHER_CONFIG=/path/config.json` | Use a config file outside the repo (the proxy, `switch` and `mcp.mjs` all honour it). |
+| `LLM_SWITCHER_HOME=/path` | Use this folder as the data folder (config, admin token, launch files, logs) for an npm install or a checkout. |
+| `LLM_SWITCHER_CONFIG=/path/config.json` | Use a config file outside the data folder (the proxy, `switch` and `mcp.mjs` all honour it). |
 | `--port <n>` / `LLM_SWITCHER_PORT` | Override the listening port (priority: flag > env > `config.port`). |
 | `x-llm-profile: <key>` header (alias `x-profile`) or `?profile=<key>` | Route a single request through a specific profile. An unknown key returns HTTP 400 instead of silently falling back. |
 | `profile.thinkingMode` | `auto` (default, for gateways like 9Router): restore stripped thinking, inject a `<think>` guide for non-reasoning models, send `thinking` + `reasoning_effort`. `native` (strict OpenAI APIs): send only `reasoning_effort` when the client asks, never touch the prompt, use `max_completion_tokens`. `off`: never send reasoning parameters. |
 | `profile.endpoints.countTokens` | Override the Anthropic `count_tokens` URL. |
 | `profile.endpoints` | Override upstream URLs per format: `{ "openai-chat": "...", "anthropic": "...", "vertex": "https://.../models/{model}:{action}" }`. |
 | `CLAUDE_CONFIG_DIR` | Respected when locating Claude Code's `settings.json`. |
-| `LLM_SWITCHER_STATE_DIR` | Move the launch files and the logs out of the checkout. The tests use it; the shims read the directory that was set when they were installed. |
+| `LLM_SWITCHER_STATE_DIR` | Move the launch files and the logs out of the data folder. The tests use it; the shims read the directory that was set when they were installed. |
 
 ## Security Model
 

package/README.vi.md

@@ -191,7 +191,15 @@ flowchart LR
 
 ---
 
-## Thay đổi trong lần cập nhật này
+## Thay đổi trong bản 1.1.2
+
+- **Gói npm.** Cài bằng `npm install -g llm-switcher` rồi chạy `switch`. Bản cài bằng npm lưu dữ liệu trong `~/.llm-switcher`, nên nâng cấp không xoá cấu hình. Bản git checkout vẫn lưu dữ liệu cạnh mã nguồn như trước.
+- **Contract lab.** Gateway có thể gửi một phần nhỏ các lượt trao đổi hoàn chỉnh lên server [intact](https://github.com/louisphamdev/intact) để tìm field mà converter làm mất. Mặc định tính năng này tắt. Xem mục "Contract lab" bên dưới.
+- **macOS.** `blindfold/make-certs.sh` giờ chạy được với LibreSSL, là `openssl` mặc định trên macOS.
+- **Nâng cấp từ 1.1.0 trở xuống.** Gateway cũ hơn 1.1.1 không chứng minh được danh tính. `switch` giờ gọi đúng tên nó và không tự dừng nó. Dừng nó bằng tay một lần, rồi chạy `switch on`.
+- **Test.** `npm test` chỉ chạy `tests/**/*.test.mjs`, kể cả trên Node.js 18 và 20.
+
+### Các thay đổi trước đó
 
 - Dashboard cho máy tính nay có bố cục gọn như một công cụ dành cho lập trình viên. Các điều khiển route rõ hơn, tab dùng được bằng bàn phím, trường model có nhãn đầy đủ và không còn emoji trang trí.
 - Profile Codex dùng ba vai trò theo tài liệu chính thức: `main`, `review` và `subagent`.
@@ -222,6 +230,8 @@ cp "$(npm root -g)/llm-switcher/config.example.json" ~/.llm-switcher/config.json
 
 Bản cài bằng npm lưu `config.json`, `admin.token` và các file khởi chạy trong `~/.llm-switcher`. Khi nâng cấp, npm chỉ thay thư mục package, nên cấu hình của bạn vẫn còn.
 
+Nếu bạn nâng cấp từ 1.1.0 trở xuống, hãy dừng gateway đang chạy trước khi chạy `switch`. Gateway cũ không chứng minh được danh tính, nên `switch` không tự dừng nó.
+
 **Cách B: git clone**
 ```bash
 git clone https://github.com/louisphamdev/llm-switcher.git
@@ -235,19 +245,18 @@ Bản checkout lưu dữ liệu cạnh mã nguồn như trước. Muốn dùng t
 
 Điền URL và API key của các nhà cung cấp vào `config.json`.
 
-Bản cài bằng npm chạy lệnh `switch <lệnh>`. Bản checkout chạy `node switch.mjs <lệnh>` hoặc thêm thư mục checkout vào `PATH`.
+**Thư mục dữ liệu** là `~/.llm-switcher` với bản cài bằng npm, và là thư mục checkout với bản git clone. Các ví dụ bên dưới dùng bản cài bằng npm. Với bản checkout, chạy `node switch.mjs <lệnh>` thay cho `switch <lệnh>`, hoặc thêm thư mục checkout vào `PATH`.
 
 ### 3. Khởi động Gateway
 ```bash
 # Bật gateway chạy ngầm:
-node switch.mjs on
+switch on
 
-# Hoặc chạy trực tiếp trên terminal:
-node proxy.mjs
+# Hoặc chạy trực tiếp trên terminal (bản cài bằng npm):
+node "$(npm root -g)/llm-switcher/proxy.mjs"
 ```
 
-Repo có sẵn hai launcher cho cùng một script: `switch` cho Linux và macOS, `switch.cmd`
-cho Windows. Thêm thư mục repo vào PATH là `switch <lệnh>` chạy giống nhau trên cả ba.
+`switch <lệnh>` chạy giống nhau trên Linux, macOS và Windows. Bản checkout có sẵn hai launcher: `switch` cho Linux và macOS, `switch.cmd` cho Windows.
 Khác biệt giữa các nền tảng, và hai tính năng không chạy ở mọi nơi, nằm trong
 [📖 `docs/cross-platform.md`](docs/cross-platform.md).
 
@@ -259,22 +268,24 @@ Mở Bảng điều khiển Web Dashboard tại: **[http://127.0.0.1:3456/ui](ht
 
 ### Bộ nạp Biến Môi trường Toàn năng (`env.cmd` / `env.sh`)
 
-Mỗi khi bạn chuyển đổi profile, LLM Switcher sẽ tự động sinh file nạp môi trường tương ứng:
+Mỗi khi bạn chuyển đổi profile, LLM Switcher sinh file nạp môi trường trong thư mục dữ liệu:
 
 - **Trên Windows (CMD / PowerShell wrapper):**
   ```cmd
-  call "path\to\llm-switcher\env.cmd"
+  call "%USERPROFILE%\.llm-switcher\env.cmd"
   ```
 - **Trên macOS / Linux (Bash / Zsh):**
   ```bash
-  source "path/to/llm-switcher/env.sh"
+  source ~/.llm-switcher/env.sh
   ```
 
+Với bản checkout, dùng các file này trong thư mục checkout.
+
 ---
 
 ### Cấu hình cho Claude Code (Windows)
 
-1. Tạo file wrapper trong thư mục PATH (ví dụ `cc-switch.cmd`):
+1. Với bản cài bằng npm, `switch` đã có sẵn trong `PATH`. Với bản checkout, tạo file wrapper trong `PATH` (ví dụ `cc-switch.cmd`):
    ```cmd
    @echo off
    node "path\to\llm-switcher\switch.mjs" %*
@@ -283,18 +294,18 @@ Mỗi khi bạn chuyển đổi profile, LLM Switcher sẽ tự động sinh fil
 2. Thêm đoạn mã sau vào wrapper chính của Claude Code (`claude.cmd` trong thư mục global npm):
    ```cmd
    SETLOCAL EnableDelayedExpansion
-   IF EXIST "path\to\llm-switcher\active.flag" (
+   IF EXIST "%USERPROFILE%\.llm-switcher\active.flag" (
      SET "ANTHROPIC_BASE_URL=http://127.0.0.1:3456"
      SET "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1"
    )
-   IF EXIST "path\to\llm-switcher\1m.flag" (
-     SET /P M1M=<"path\to\llm-switcher\1m.flag"
+   IF EXIST "%USERPROFILE%\.llm-switcher\1m.flag" (
+     SET /P M1M=<"%USERPROFILE%\.llm-switcher\1m.flag"
      IF "!M1M!"=="" SET "M1M=opus[1m]"
      SET "ANTHROPIC_MODEL=!M1M!"
      SET "CLAUDE_CODE_AUTO_COMPACT_WINDOW=900000"
    )
    ```
-   > Cần `SETLOCAL EnableDelayedExpansion` để `!M1M!` hoạt động. npm ghi đè `claude.cmd` mỗi lần update, nên tốt hơn là tạo wrapper riêng chạy `call "path\to\llm-switcher\env.cmd"` rồi `claude %*`. Chỉ `env.cmd` / `env.sh` mới có các biến `ANTHROPIC_DEFAULT_<TIER>_MODEL=<tier>[1m]` theo từng tier.
+   > Cần `SETLOCAL EnableDelayedExpansion` để `!M1M!` hoạt động. npm ghi đè `claude.cmd` mỗi lần update, nên tốt hơn là tạo wrapper riêng chạy `call "%USERPROFILE%\.llm-switcher\env.cmd"` rồi `claude %*`. Với bản checkout, thay `%USERPROFILE%\.llm-switcher` bằng thư mục checkout. Chỉ `env.cmd` / `env.sh` mới có các biến `ANTHROPIC_DEFAULT_<TIER>_MODEL=<tier>[1m]` theo từng tier.
 
 ---
 
@@ -337,7 +348,7 @@ base URL is overridden to http://127.0.0.1:3456/v1. Selecting models may not be
 Blindfold xóa dòng đó. Codex giữ nguyên endpoint chính thức, switcher chặn ở tầng mạng. Không cần quyền admin, không cài chứng chỉ vào system trust store, không sửa `~/.codex/config.toml`.
 
 ```bash
-bash blindfold/make-certs.sh chatgpt.com   # chạy một lần
+bash "$(npm root -g)/llm-switcher/blindfold/make-certs.sh" chatgpt.com   # chạy một lần; bản checkout chạy blindfold/make-certs.sh
 # rồi đặt "blindfold": true trong profile Codex
 switch codex <profile>                     # gateway khởi động interceptor
 ```
@@ -414,12 +425,12 @@ Một server Model Context Protocol (MCP) chạy qua `stdio` cực nhẹ (Zero-d
 
 LƯU Ý: `switcher_recent_logs` trả 150 ký tự đầu của mỗi prompt gần đây, từ mọi client đã dùng gateway. Agent gọi tool này đọc được chúng.
 
-Thêm vào cấu hình MCP (ví dụ `opencode.jsonc`, `claude_desktop_config.json`, hoặc Cursor):
+Thêm server vào cấu hình MCP (ví dụ `opencode.jsonc`, `claude_desktop_config.json`, hoặc Cursor). Chạy `npm root -g` để biết thư mục chứa `llm-switcher/mcp.mjs`. Với bản checkout, dùng `mcp.mjs` trong thư mục checkout.
 ```json
 "mcp": {
   "llm-switcher": {
     "type": "local",
-    "command": ["node", "path/to/llm-switcher/mcp.mjs"],
+    "command": ["node", "/path/from/npm-root-g/llm-switcher/mcp.mjs"],
     "enabled": true
   }
 }
@@ -546,13 +557,14 @@ Contract lab tìm các field mà converter làm mất. Mặc định tính năng
 
 | Tuỳ chọn | Mô tả |
 |---|---|
-| `LLM_SWITCHER_CONFIG=/path/config.json` | Dùng file cấu hình nằm ngoài repo (proxy, `switch` và `mcp.mjs` đều hỗ trợ). |
+| `LLM_SWITCHER_HOME=/path` | Dùng thư mục này làm thư mục dữ liệu (config, admin token, file launcher, log) cho cả bản npm lẫn bản checkout. |
+| `LLM_SWITCHER_CONFIG=/path/config.json` | Dùng file cấu hình nằm ngoài thư mục dữ liệu (proxy, `switch` và `mcp.mjs` đều hỗ trợ). |
 | `--port <n>` / `LLM_SWITCHER_PORT` | Ghi đè cổng lắng nghe (ưu tiên: flag > env > `config.port`). |
 | Header `x-llm-profile: <key>` (tên khác `x-profile`) hoặc `?profile=<key>` | Định tuyến riêng 1 request qua profile chỉ định. Key không tồn tại trả HTTP 400 thay vì âm thầm dùng profile khác. |
 | `profile.thinkingMode` | `auto` (mặc định, cho gateway như 9Router): phục hồi thinking bị xoá, chèn hướng dẫn `<think>` cho model không có reasoning, gửi `thinking` + `reasoning_effort`. `native` (API OpenAI nghiêm ngặt): chỉ gửi `reasoning_effort` khi client yêu cầu, không sửa prompt, dùng `max_completion_tokens`. `off`: không bao giờ gửi tham số reasoning. |
 | `profile.endpoints.countTokens` | Ghi đè URL `count_tokens` của Anthropic. |
 | `profile.endpoints` | Ghi đè URL upstream theo từng format: `{ "openai-chat": "...", "anthropic": "...", "vertex": "https://.../models/{model}:{action}" }`. |
-| `LLM_SWITCHER_STATE_DIR` | Chuyển file launcher và log ra khỏi thư mục checkout. Test dùng biến này; shim đọc thư mục đã đặt lúc cài shim. |
+| `LLM_SWITCHER_STATE_DIR` | Chuyển file launcher và log ra khỏi thư mục dữ liệu. Test dùng biến này; shim đọc thư mục đã đặt lúc cài shim. |
 | `CLAUDE_CONFIG_DIR` | Được tôn trọng khi tìm `settings.json` của Claude Code. |
 
 ## Mô hình Bảo mật

package/blindfold/make-certs.sh

@@ -2,6 +2,7 @@
 # Build the private CA and the leaf certificate that blindfold.mjs presents.
 #
 # Windows: run this from Git Bash. The openssl that ships with Git for Windows works.
+# macOS: /usr/bin/openssl is LibreSSL. Use only options that LibreSSL also has (it has no `x509 -ext`).
 # The earlier attempt used PowerShell New-SelfSignedCertificate, whose leaf was refused
 # with "unsuitable certificate purpose" because it carried no serverAuth extended key
 # usage. The extension files below are what fix that, so do not drop them.
@@ -14,7 +15,14 @@
 set -euo pipefail
 
 HOST="${1:-chatgpt.com}"
-OUT_DIR="${2:-$(cd "$(dirname "$0")" && pwd)/certs}"
+# The default must match the folder the gateway reads (state.mjs paths.blindfoldCA): an npm
+# install keeps its data in ~/.llm-switcher, a git checkout next to the code.
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+if [ -n "${LLM_SWITCHER_BLINDFOLD_CERTS:-}" ]; then DEFAULT_OUT="$LLM_SWITCHER_BLINDFOLD_CERTS"
+elif [ -n "${LLM_SWITCHER_HOME:-}" ]; then DEFAULT_OUT="$LLM_SWITCHER_HOME/blindfold/certs"
+elif [ -d "$ROOT/.git" ]; then DEFAULT_OUT="$ROOT/blindfold/certs"
+else DEFAULT_OUT="$HOME/.llm-switcher/blindfold/certs"; fi
+OUT_DIR="${2:-$DEFAULT_OUT}"
 CA_DAYS=3650
 LEAF_DAYS=825
 
@@ -85,4 +93,4 @@ mv -f "$WORK/ca.key" "$WORK/ca.pem" "$WORK/leaf.key" "$WORK/leaf.pem" "$OUT_DIR/
 
 echo "[blindfold] CA     : $OUT_DIR/ca.pem"
 echo "[blindfold] leaf   : $OUT_DIR/leaf.pem"
-openssl x509 -in "$OUT_DIR/leaf.pem" -noout -ext extendedKeyUsage,subjectAltName
+openssl x509 -in "$OUT_DIR/leaf.pem" -noout -text | grep -A1 -E "Extended Key Usage|Subject Alternative Name"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-switcher",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Zero-dependency multi-protocol edge gateway & provider switcher for Claude Code, Codex, OpenAI and Gemini clients",
   "keywords": [
     "llm",
@@ -30,7 +30,7 @@
   },
   "scripts": {
     "start": "node proxy.mjs",
-    "test": "node --test",
+    "test": "node scripts/run-tests.mjs",
     "test:live": "node tests/live-optimizer-interop.mjs"
   }
 }

package/scripts/run-tests.mjs

@@ -0,0 +1,19 @@
+// Runs only tests/**/*.test.mjs. A bare `node --test` also collects test files from git-ignored
+// folders (an old copy in temp/), and Node 18 and 20 do not expand a glob argument.
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const root = path.join(path.dirname(fileURLToPath(import.meta.url)), '..');
+const files = [];
+(function walk(dir) {
+  for (const e of fs.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+    const p = path.join(dir, e.name);
+    if (e.isDirectory()) walk(p);
+    else if (e.name.endsWith('.test.mjs')) files.push(path.relative(root, p));
+  }
+})(path.join(root, 'tests'));
+
+const r = spawnSync(process.execPath, ['--test', ...process.argv.slice(2), ...files], { cwd: root, stdio: 'inherit' });
+process.exit(r.status ?? 1);

package/state.mjs

@@ -792,13 +792,15 @@ function getJson(port, pathname, timeoutMs = 3000) {
 
 const newNonce = () => crypto.randomBytes(16).toString('hex');
 
-/** 'ours' | 'foreign' | 'silent' | 'free'. Treat 'silent' like 'foreign' in every decision. */
+/** 'ours' | 'legacy' | 'foreign' | 'silent' | 'free'. Treat 'legacy' and 'silent' like 'foreign' in every decision. */
 export async function probeGateway(port) {
   const nonce = newNonce();
   const r = await getJson(port, `/health?challenge=${nonce}`);
   if (r.state !== 'answered') return r.state;
   const b = r.body;
   if (b?.proxy !== 'llm-switcher' || b.port !== port) return 'foreign';
+  // Gateways before 1.1.1 answer without a proof: name them, but never trust them enough to stop them.
+  if (!('proof' in b)) return 'legacy';
   const proof = identityProof(nonce, { role: 'gateway', port, pid: b.pid });
   return proof && b.proof === proof ? 'ours' : 'foreign';
 }

package/switch.mjs

@@ -82,9 +82,14 @@ function startProxyBackground(port) {
 }
 
 // 'silent' is a listener that never answered: a hung gateway of ours, or another program.
-const isHeld = (state) => state === 'foreign' || state === 'silent';
+const isHeld = (state) => state === 'foreign' || state === 'silent' || state === 'legacy';
 
 function refuseForeignPort(port, owner, state = 'foreign') {
+  if (state === 'legacy') {
+    console.error(`[Error] An llm-switcher gateway older than 1.1.1 runs on port ${port}. Stop it, then run \`switch on\` again.`);
+    console.error('        It cannot prove its identity, so this switcher does not stop it. Nothing was changed.');
+    process.exit(1);
+  }
   console.error(state === 'silent'
     ? `[Error] Port ${port} accepts connections but does not answer. A hung ${owner} or another program holds it.`
     : `[Error] Port ${port} is held by another process, not by ${owner}.`);
@@ -204,7 +209,7 @@ function listeningPids(port) {
   return [...pids];
 }
 
-// Returns 'stopped', 'not-running', 'not-ours', 'silent' or 'still-running'. The kill targets the process that
+// Returns 'stopped', 'not-running', 'not-ours', 'legacy', 'silent' or 'still-running'. The kill targets the process that
 // listens on the port, right after the identity probe confirmed that listener is this switcher.
 async function stopProxy(port) {
   const state = await probeGateway(port);
@@ -226,6 +231,7 @@ async function stopProxy(port) {
     return 'stopped';
   }
   if (state === 'foreign') return 'not-ours';
+  if (state === 'legacy') return 'legacy';
   if (state === 'silent') {
     if (ownUnit) {
       serviceStop(svc);
@@ -465,6 +471,10 @@ async function turnOff(targetArg) {
     console.error(`[Error] The gateway on port ${port} is still running. Stop it by hand; the launcher files are already cleared.`);
     process.exit(1);
   }
+  if (result === 'legacy') {
+    console.error(`[Error] An llm-switcher gateway older than 1.1.1 runs on port ${port}. Stop it, then run \`switch on\` again.`);
+    process.exit(1);
+  }
   if (result === 'not-ours' || result === 'silent') {
     console.error(result === 'silent'
       ? `[Error] Port ${port} accepts connections but does not answer, so it is not proven to be this switcher. It was not stopped.`
@@ -502,7 +512,7 @@ async function showStatus() {
   const flagged = fs.existsSync(paths.activeFlag);
 
   console.log('=== LLM Switcher Status ===');
-  const held = { foreign: `PORT ${port} HELD BY ANOTHER PROCESS`, silent: `PORT ${port} DOES NOT ANSWER (hung gateway or another program)` };
+  const held = { legacy: `OLD GATEWAY (< 1.1.1) ON PORT ${port}: stop it, then run \`switch on\``, foreign: `PORT ${port} HELD BY ANOTHER PROCESS`, silent: `PORT ${port} DOES NOT ANSWER (hung gateway or another program)` };
   console.log(`Proxy Service:  ${isRunning ? `RUNNING (port ${port})` : held[gateway] || 'STOPPED'}`);
   console.log(`Web UI:         http://127.0.0.1:${port}/ui`);
   console.log(`Launcher Flag:  ${flagged ? 'active.flag present' : 'absent (launchers use official endpoints)'}`);

package/tests/datadir.test.mjs

@@ -3,6 +3,7 @@ import assert from 'node:assert/strict';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { execFileSync } from 'node:child_process';
 import { resolveDataDir } from '../state.mjs';
 
 const tmp = () => fs.mkdtempSync(path.join(os.tmpdir(), 'llm-sw-datadir-'));
@@ -35,3 +36,16 @@ test('package.json is publishable and exposes the switch command', () => {
   assert.equal(pkg.bin?.switch, 'switch.mjs');
   assert.ok(fs.existsSync(new URL('../LICENSE', import.meta.url)), 'LICENSE file exists');
 });
+
+// macOS ships LibreSSL as /usr/bin/openssl. It has no `x509 -ext`; the script must not depend on it.
+test('make-certs.sh runs with an openssl that lacks LibreSSL-missing options', { skip: process.platform === 'win32' }, () => {
+  const dir = tmp();
+  const real = execFileSync('sh', ['-c', 'command -v openssl'], { encoding: 'utf8' }).trim();
+  const bin = path.join(dir, 'bin');
+  fs.mkdirSync(bin);
+  fs.writeFileSync(path.join(bin, 'openssl'), `#!/bin/sh\nfor a in "$@"; do [ "$a" = "-ext" ] && { echo "unknown option -ext" >&2; exit 1; }; done\nexec "${real}" "$@"\n`, { mode: 0o755 });
+  const out = path.join(dir, 'certs');
+  const script = new URL('../blindfold/make-certs.sh', import.meta.url).pathname;
+  execFileSync('bash', [script, 'chatgpt.com', out], { env: { ...process.env, PATH: `${bin}:${process.env.PATH}` }, stdio: 'pipe' });
+  for (const f of ['ca.pem', 'leaf.pem', 'leaf.key']) assert.ok(fs.existsSync(path.join(out, f)), f);
+});

package/tests/state.test.mjs

@@ -514,7 +514,9 @@ test('make-certs.sh builds a CA that can sign only for its host', (t) => {
   fs.writeFileSync(path.join(dir, 'evil.ext'), 'subjectAltName = DNS:evil.test\n');
   ossl('x509', '-req', '-in', 'evil.csr', '-CA', path.join(certs, 'ca.pem'), '-CAkey', path.join(certs, 'ca.key'),
     '-CAcreateserial', '-days', '1', '-extfile', 'evil.ext', '-out', 'evil.pem');
-  assert.throws(() => ossl('verify', '-CAfile', path.join(certs, 'ca.pem'), 'evil.pem'), /permitted subtree violation/);
+  // LibreSSL prints the verify error on stdout, OpenSSL 3 on stderr.
+  assert.throws(() => ossl('verify', '-CAfile', path.join(certs, 'ca.pem'), 'evil.pem'),
+    (e) => /permitted subtree violation/.test(`${e.stdout}${e.stderr}`));
 });
 
 // ---- Launch state, config cache, logs, probes (audit F28, F31, F42, M5, racer "blocked gateway") ----
@@ -595,6 +597,30 @@ test('a port that accepts but never answers probes as silent, not as foreign', a
   assert.equal(await probeGateway(server.address().port), 'silent');
 });
 
+// A gateway from before 1.1.1 answers /health without an identity proof. It is ours in spirit but
+// cannot be proven, so it is never stopped; the CLI names it instead of calling it a foreign process.
+test('a pre-1.1.1 gateway answers without a proof and probes as legacy, not as foreign', async (t) => {
+  const http = await import('node:http');
+  const server = http.createServer((req, res) => {
+    res.writeHead(200, { 'content-type': 'application/json' });
+    res.end(JSON.stringify({ status: 'ok', proxy: 'llm-switcher', port: server.address().port, configLoaded: true }));
+  });
+  await new Promise(r => server.listen(0, '127.0.0.1', r));
+  t.after(() => server.close());
+  assert.equal(await probeGateway(server.address().port), 'legacy');
+});
+
+test('an llm-switcher answer with a wrong proof is still foreign', async (t) => {
+  const http = await import('node:http');
+  const server = http.createServer((req, res) => {
+    res.writeHead(200, { 'content-type': 'application/json' });
+    res.end(JSON.stringify({ status: 'ok', proxy: 'llm-switcher', port: server.address().port, pid: 1, proof: 'forged' }));
+  });
+  await new Promise(r => server.listen(0, '127.0.0.1', r));
+  t.after(() => server.close());
+  assert.equal(await probeGateway(server.address().port), 'foreign');
+});
+
 // Codex parses an unquoted --config value as TOML first. The Windows shim passes names unquoted, so a
 // name that TOML reads as a number, a boolean or a date would change type (audit N-3 residual).
 test('isSafeModelName refuses names that TOML reads as something other than a string', () => {