@vzn/vx 0.0.632 → 0.0.633
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -10
- package/docs/caching.md +2247 -0
- package/docs/cli.md +3214 -0
- package/docs/execution.md +708 -0
- package/docs/features.md +172 -0
- package/docs/patterns.md +219 -0
- package/docs/schema.md +2137 -0
- package/docs/security.md +209 -0
- package/package.json +12 -5
- package/schemas/docs.json +28 -0
- package/schemas/init.json +57 -0
- package/schemas/lock.json +21 -0
- package/skills/vx/SKILL.md +6 -2
- package/src/cache/cache.ts +500 -121
- package/src/cache/chained-cache.ts +9 -0
- package/src/cache/inputs.ts +5 -0
- package/src/cache/layer.ts +8 -4
- package/src/cache/layered-cache.ts +4 -0
- package/src/cache/schema.ts +42 -16
- package/src/cli/docs-corpus.ts +21 -0
- package/src/cli/docs-text.d.ts +5 -0
- package/src/cli/docs.ts +167 -0
- package/src/cli/help.ts +13 -3
- package/src/cli/index.ts +2 -0
- package/src/cli/init.ts +35 -6
- package/src/cli/lock.ts +43 -15
- package/src/cli/upgrade.ts +18 -6
- package/src/graph/task-graph.ts +3 -3
- package/src/orchestrator/metrics.ts +11 -4
- package/src/orchestrator/miss-reason.ts +3 -5
- package/src/orchestrator/miss-save.ts +6 -5
- package/src/orchestrator/projects.ts +2 -2
- package/src/orchestrator/task-hash.ts +4 -4
- package/src/util/verbs.ts +1 -0
- package/src/workspace/config-schema.ts +10 -8
- package/src/workspace/migration.ts +30 -3
package/README.md
CHANGED
|
@@ -18,16 +18,20 @@
|
|
|
18
18
|
|
|
19
19
|
<!-- bench:start — generated by packages/vx-bench/update-site.ts from results.json; do not hand-edit -->
|
|
20
20
|
|
|
21
|
-
| 1,090 packages, 3,270 tasks
|
|
22
|
-
|
|
|
23
|
-
| Cold build: time
|
|
24
|
-
| Cold build: CPU burned
|
|
25
|
-
| Fully cached run (restored)
|
|
26
|
-
| Fully cached run (up-to-date)
|
|
21
|
+
| 1,090 packages, 3,270 tasks | vx | Turborepo | Nx | Vite Task |
|
|
22
|
+
| ----------------------------------------------- | -------------- | -------------------------- | ------------------------- | -------------------------- |
|
|
23
|
+
| 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) |
|
|
24
|
+
| Cold build: CPU burned | **17 s** | 21 s (vx 22% faster) | 52 s (vx 3× faster) | 12 s (vx 39% slower) |
|
|
25
|
+
| 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) |
|
|
26
|
+
| 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) |
|
|
27
|
+
| Secondary: time the runner adds to a cold build | **2 s** | 1 min 21 s | 11 s | 1 min 11 s |
|
|
27
28
|
|
|
28
|
-
vx N× faster: that tool takes N
|
|
29
|
+
vx N% or N× faster: that tool takes N% longer or N times as long as vx.
|
|
29
30
|
|
|
30
|
-
|
|
31
|
+
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.
|
|
32
|
+
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.
|
|
33
|
+
|
|
34
|
+
The secondary row is the wall time over the tasks' own ideal schedule (3 min 38 s).
|
|
31
35
|
Same graph, commands and concurrency: [how it is measured](https://vznjs.github.io/vx/benchmarks/).
|
|
32
36
|
|
|
33
37
|
<!-- bench:end -->
|
|
@@ -46,7 +50,7 @@ npm install -D @vzn/vx # or: pnpm add -D -w · yarn add -D (-W on Yarn 1) ·
|
|
|
46
50
|
|
|
47
51
|
A prebuilt binary for Linux (glibc, not Alpine's musl) and macOS, x64 and arm64; no Bun needed. The
|
|
48
52
|
[release](https://github.com/vznjs/vx/releases) binary needs no Node either.
|
|
49
|
-
Windows:
|
|
53
|
+
Windows: run vx inside WSL2.
|
|
50
54
|
|
|
51
55
|
## Quick start
|
|
52
56
|
|
|
@@ -171,4 +175,4 @@ scripts. Start with [CONTRIBUTING.md](CONTRIBUTING.md) and
|
|
|
171
175
|
|
|
172
176
|
## License
|
|
173
177
|
|
|
174
|
-
[MIT](LICENSE)
|
|
178
|
+
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.
|