@vzn/vx 0.0.631 → 0.0.633

package/README.md

@@ -18,16 +18,20 @@
 
 <!-- bench:start — generated by packages/vx-bench/update-site.ts from results.json; do not hand-edit -->
 
-| 1,090 packages, 3,270 tasks      | vx         | Turborepo                  | Nx                      | Vite Task                  |
-| -------------------------------- | ---------- | -------------------------- | ----------------------- | -------------------------- |
-| Cold build: time the runner adds | **2 s**    | 1 min 21 s (vx 34× faster) | 11 s (vx 4.7× faster)   | 1 min 11 s (vx 30× faster) |
-| Cold build: CPU burned           | **17 s**   | 21 s (vx 1.2× faster)      | 52 s (vx 3× faster)     | 12 s (vx 1.4× slower)      |
-| Fully cached run (restored)      | **650 ms** | 997 ms (vx 1.5× faster)    | 6.25 s (vx 9.6× faster) | 2.64 s (vx 4× faster)      |
-| Fully cached run (up-to-date)    | **393 ms** | 463 ms (vx 1.1× faster)    | 6.45 s (vx 16× faster)  | 2.49 s (vx 6.3× faster)    |
+| 1,090 packages, 3,270 tasks                     | vx             | Turborepo                  | Nx                        | Vite Task                  |
+| ----------------------------------------------- | -------------- | -------------------------- | ------------------------- | -------------------------- |
+| Cold build: total time                          | **3 min 40 s** | 4 min 59 s (vx 36% faster) | 3 min 49 s (vx 4% faster) | 4 min 49 s (vx 31% faster) |
+| Cold build: CPU burned                          | **17 s**       | 21 s (vx 22% faster)       | 52 s (vx 3× faster)       | 12 s (vx 39% slower)       |
+| Fully cached run (restored)                     | **650 ms**     | 997 ms (vx 53% faster)     | 6.25 s (vx 9.6× faster)   | 2.64 s (vx 4.1× faster)    |
+| Fully cached run (up-to-date)                   | **393 ms**     | 463 ms (vx 18% faster)     | 6.45 s (vx 16× faster)    | 2.49 s (vx 6.3× faster)    |
+| Secondary: time the runner adds to a cold build | **2 s**        | 1 min 21 s                 | 11 s                      | 1 min 11 s                 |
 
-vx N× faster: that tool takes N times as long as vx (theirs ÷ vx); N× slower: vx takes N times as long (vx ÷ theirs).
+vx N% or N× faster: that tool takes N% longer or N times as long as vx.
 
-Time added is the wall time over the tasks' own ideal schedule (3 min 38 s).
+Benchmark workload: a synthetic monorepo of 1,090 packages and 3,270 tasks in 100 dependency layers, every build and test taking 1 s; real repos with uneven task times will differ.
+Run 2026-10-04 on linux x64, 4 cores: vx from source, Turborepo 2.11.7, Nx 23.2.1, Vite Task (vite-plus) 1.0.0.
+
+The secondary row is the wall time over the tasks' own ideal schedule (3 min 38 s).
 Same graph, commands and concurrency: [how it is measured](https://vznjs.github.io/vx/benchmarks/).
 
 <!-- bench:end -->
@@ -46,7 +50,7 @@ npm install -D @vzn/vx     # or: pnpm add -D -w · yarn add -D (-W on Yarn 1) ·
 
 A prebuilt binary for Linux (glibc, not Alpine's musl) and macOS, x64 and arm64; no Bun needed. The
 [release](https://github.com/vznjs/vx/releases) binary needs no Node either.
-Windows: use WSL.
+Windows: run vx inside WSL2.
 
 ## Quick start
 
@@ -93,12 +97,11 @@ More: [Quickstart](https://vznjs.github.io/vx/quickstart/) ·
 
 ## Coming from Turbo or Nx
 
-`bunx @vzn/vx-migrate` writes a `vx.config.ts` per package from
-`turbo.json` or the Nx graph; you keep those and delete the old config.
-Beside `turbo.json` or `nx.json`, `vx init` writes only a
-`vx.workspace.ts` that maps the old config until then: a temporary
-start, not a way to run the repo. The numbers above are native vx
-config.
+Beside `turbo.json` or `nx.json`, `npx vx init` runs `@vzn/vx-migrate`:
+it writes a `vx.config.ts` per package from `turbo.json` or the Nx graph,
+and you keep those and delete the old config. `vx init --keep` writes only
+a `vx.workspace.ts` that maps the old config instead: a temporary start,
+not a way to run the repo. The numbers above are native vx config.
 [Migration guide](https://vznjs.github.io/vx/guides/migrate/).
 
 ## Why it is faster
@@ -127,7 +130,7 @@ config.
 | Output ownership   | **Strict**: wiped before exec and restore | Additive (stale files survive) | Additive         |
 | Clean-tree hashing | **No source reads** (git index OIDs)      | git OIDs                       | re-hash / daemon |
 | Daemon             | **None**                                  | None for `turbo run`           | On by default    |
-| Per-task sandbox   | **Yes**: kernel-level, opt-in             | No                             | No               |
+| Per-task sandbox   | **Yes**: kernel-level, opt-in, local      | No                             | On Nx Cloud only |
 | Plugin API         | **Yes**: every pipeline stage             | No                             | Yes (TS-tied)    |
 | Install            | **Single binary**; no Bun, Node optional  | npm + Node                     | npm + Node       |
 
@@ -146,7 +149,7 @@ Declared in `vx.workspace.ts`; without any, vx runs and caches locally.
 | [`@vzn/vx-lockfile`](packages/vx-lockfile)                 | Key each project on its own lockfile slice: pnpm, bun, npm, yarn              |
 | [`@vzn/vx-otel`](packages/vx-otel)                         | OpenTelemetry traces, metrics and logs, no SDK                                |
 | [`@vzn/vx-ci`](packages/vx-ci)                             | GitHub Actions job summary and Checks API                                     |
-| [`@vzn/vx-mcp`](packages/vx-mcp)                           | `vx mcp`: a read-only MCP server for AI coding agents                         |
+| [`@vzn/vx-mcp`](packages/vx-mcp)                           | `vx mcp`: an MCP server for AI coding agents that also runs tasks             |
 | [`@vzn/vx-schedule-history`](packages/vx-schedule-history) | Schedule by the critical path learned from past runs                          |
 
 Write your own: [plugin guide](https://vznjs.github.io/vx/guides/plugins/) ·
@@ -172,4 +175,4 @@ scripts. Start with [CONTRIBUTING.md](CONTRIBUTING.md) and
 
 ## License
 
-[MIT](LICENSE)
+vx is [MIT](LICENSE) licensed. The prebuilt binaries embed Bun and a few npm packages under permissive licenses; their notices ship as [THIRD_PARTY_NOTICES.txt](packages/vx/THIRD_PARTY_NOTICES.txt) in each platform package and GitHub release.