@vzn/vx 0.0.650 → 0.0.652

package/README.md

@@ -47,9 +47,8 @@ export default defineProject({
       exec: { command: 'tsc -b' },
       dependsOn: ['^build'], // dependencies build first
       inputs: { files: ['src/**', 'tsconfig.json'] },
-      cache: {
-        outputs: { files: ['dist/**'] },
-      },
+      outputs: { files: ['dist/**'] },
+      cache: true,
     },
   },
 })
@@ -142,9 +141,8 @@ not a way to run the repo. The benchmark below uses native vx config.
 | Plugin API         | **Yes**: every pipeline stage             | No                             | Yes (TS-tied)    |
 | Install            | **Single binary**; no Bun, Node optional  | npm + Node                     | npm + Node       |
 
-Every gap, and when another tool is the better pick:
-[comparison](packages/vx/docs/comparison.md) ·
-[vx, Turborepo, Nx, Bazel](https://vznjs.github.io/vx/compare/).
+Every gap: [comparison](packages/vx/docs/comparison.md) ·
+every tool on one suite of cases: [conformance](https://vznjs.github.io/vx/conformance/).
 
 ## Fast, without trading correctness
 
@@ -152,23 +150,9 @@ Every gap, and when another tool is the better pick:
 - **No source-file reads to hash:** on a clean tree, keys come from git's index; each project's `package.json` and the lockfile are still read.
 - **One pass:** one git walk per run; each stat and lookup happens once.
 
-<!-- bench:start — generated by private/vx-bench/update-site.ts from results.json; do not hand-edit -->
-
-| Time added over the ideal run, 1,601 projects, 9,603 tasks | vx         | Turborepo  | Nx         | Vite Task |
-| ---------------------------------------------------------- | ---------- | ---------- | ---------- | --------- |
-| Nothing changed                                            | **799 ms** | 927 ms     | 24.15 s    | 12.07 s   |
-| Nothing changed, outputs restored                          | **1.28 s** | 2.01 s     | 24.45 s    | 11.86 s   |
-| Cold build                                                 | **7.57 s** | 9.63 s     | 3 min 6 s  | 9.01 s    |
-| Cold build: CPU the runner burns                           | 36.64 s    | 1 min 12 s | 5 min 34 s | 25.32 s   |
-
-Time each tool adds over the ideal run; lower is better.
-
-Benchmark workload: a synthetic monorepo of 1,601 projects and 9,603 tasks in 30 dependency levels, five core libraries a quarter of the projects use; build 300 ms, test and typecheck 150 ms, lint 75 ms, publish 30 ms; real repos with uneven task times will differ.
-Run 2026-10-25 on linux x64, 4 cores: vx at commit 9abdfb52c, Turborepo 2.11.10, Nx 24.0.1, Vite Task (vite-plus) 1.4.0.
-
-Same graph, commands and concurrency: [how it is measured](https://vznjs.github.io/vx/benchmarks/).
-
-<!-- bench:end -->
+The head-to-head against Turborepo, Nx and Vite Task, each in its own
+native config, is re-measured on every change to vx and published on the
+site: [benchmarks](https://vznjs.github.io/vx/benchmarks/).
 
 ## Status
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.650",
+  "version": "0.0.652",
   "description": "Task orchestration you own: correct, sandboxed, extensible, with a content-addressed build cache.",
   "type": "module",
   "exports": {
@@ -21,10 +21,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@vzn/vx-linux-x64": "0.0.650",
-    "@vzn/vx-linux-arm64": "0.0.650",
-    "@vzn/vx-darwin-x64": "0.0.650",
-    "@vzn/vx-darwin-arm64": "0.0.650"
+    "@vzn/vx-linux-x64": "0.0.652",
+    "@vzn/vx-linux-arm64": "0.0.652",
+    "@vzn/vx-darwin-x64": "0.0.652",
+    "@vzn/vx-darwin-arm64": "0.0.652"
   },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.76"

package/schemas/last.json

@@ -242,7 +242,10 @@
         "peakRssBytes",
         "peakCores",
         "avgRssBytes",
+        "queuedMs",
         "placement",
+        "outputBytes",
+        "blocks",
         "wallclockStartNs",
         "wallclockEndNs",
         "blockedBy",
@@ -288,10 +291,22 @@
           "type": ["integer", "null"],
           "description": "mean resident memory over the samples; null when nothing sampled"
         },
+        "queuedMs": {
+          "type": ["integer", "null"],
+          "description": "milliseconds it waited, ready, for a slot; null when it never queued"
+        },
         "placement": {
           "type": ["string", "null"],
           "description": "where an executor ran it (small#1); null when here"
         },
+        "outputBytes": {
+          "type": ["integer", "null"],
+          "description": "bytes of its outputs: what its save stored, or its hit restored"
+        },
+        "blocks": {
+          "type": ["integer", "null"],
+          "description": "how many tasks were downstream of it"
+        },
         "wallclockStartNs": {
           "type": ["string", "null"],
           "description": "decimal nanoseconds from the run's start"

package/schemas/show.json

@@ -109,25 +109,8 @@
             "env": { "$ref": "#/$defs/stringList" },
             "tasks": { "$ref": "#/$defs/stringList" },
             "runtime": { "$ref": "#/$defs/stringList" },
-            "workspaceRuntime": { "$ref": "#/$defs/stringList" }
-          }
-        },
-        "cache": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["outputs"],
-          "properties": {
-            "outputs": {
-              "type": "object",
-              "additionalProperties": false,
-              "required": ["files"],
-              "properties": {
-                "files": { "$ref": "#/$defs/stringList" },
-                "workspaceFiles": { "$ref": "#/$defs/stringList" },
-                "clean": { "type": "boolean" }
-              }
-            },
-            "inputStability": {
+            "workspaceRuntime": { "$ref": "#/$defs/stringList" },
+            "stability": {
               "type": "object",
               "additionalProperties": false,
               "properties": {
@@ -136,7 +119,18 @@
               }
             }
           }
-        }
+        },
+        "outputs": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["files"],
+          "properties": {
+            "files": { "$ref": "#/$defs/stringList" },
+            "workspaceFiles": { "$ref": "#/$defs/stringList" },
+            "clean": { "type": "boolean" }
+          }
+        },
+        "cache": { "type": "boolean" }
       }
     }
   }

package/src/bin.ts

@@ -21,32 +21,14 @@ async function main(): Promise<void> {
     // `vx --version` needs one leaf module; the dispatcher and the util
     // barrel it pulled in were 20 ms of its 28 (2026-10-01).
     if (argv.length === 1 && (argv[0] === '--version' || argv[0] === 'version')) {
-      // `Bun.stdout`, not `process.stdout`: the Node stream's first touch is
-      // ~7 ms, half of this verb (2026-10-02). A reader gone (EPIPE) is no
-      // failure of the line.
       // Handed off, it says which vx ran and which one handed it the call.
       const from = process.env['VX_HANDED_OFF'] || undefined
       const where = from === undefined ? '' : ` (${vxPath()}, handed off from ${from})`
-      // Painted as every other line; piped, the same words a script reads.
-      // Decided here, not by util's `detectColors`: the util barrel was the
-      // 20 ms above, and `node:tty` 17 ms; fd 1 as a character device is the
-      // TTY answer. A CI's log is not painted for this one line.
-      const [{ VERSION }, { fstatSync }] = await Promise.all([
+      const [{ VERSION }, { printVersion }] = await Promise.all([
         import('./version.js'),
-        import('node:fs'),
+        import('./ui/version-line.js'),
       ])
-      const env = process.env
-      const on = env['NO_COLOR']
-        ? false
-        : env['FORCE_COLOR'] !== undefined
-          ? env['FORCE_COLOR'] !== '0' && env['FORCE_COLOR'] !== 'false'
-          : env['TERM'] !== 'dumb' && fstatSync(1).isCharacterDevice()
-      const sgr = (code: string, text: string): string =>
-        on ? `\x1b[${code}m${text}\x1b[0m` : text
-      await Bun.write(
-        Bun.stdout,
-        `${sgr('1', 'vx')} ${sgr('38;2;6;182;212', VERSION)}${where === '' ? '' : sgr('2', where)}\n`,
-      ).catch(() => {})
+      await printVersion(VERSION, where)
       settled = true
       return
     }
@@ -64,8 +46,9 @@ async function main(): Promise<void> {
     // is set, and `exitOnceFlushed` exits after both streams have ended.
     process.exitCode = code
   } catch (err) {
+    const ui = await import('./ui/index.js')
+    const { refusalNotice } = ui
     const {
-      detectColors,
       errorCode,
       errorDocument,
       fsRefusalHint,
@@ -74,17 +57,12 @@ async function main(): Promise<void> {
       isUserError,
       maskedLine,
       OUT_OF_FDS_HINT,
-      refusalNotice,
-      ui,
       wantsJson,
     } = await import('./util/index.js')
     // A plugin's failure quotes what it was told (a remote's reply, a
     // header), and a config's own throw is its author's text: a secret in
     // either reached stderr whole (L-11).
-    const say = (line: string): void =>
-      void process.stderr.write(
-        `${ui.tagged('error', maskedLine(line), detectColors(process.stderr))}\n`,
-      )
+    const say = (line: string): void => ui.say('error', maskedLine(line))
     // UserError (workspace not found, cycle, config invalid, ...) —
     // print the message only; the stack is noise the user can't act
     // on. Everything else gets the full stack so internal bugs are
@@ -100,7 +78,11 @@ async function main(): Promise<void> {
         named === null ? err.message : err.message.slice(named[0].length),
         err.parts,
       )
-      process.stderr.write(maskedLine(ui.render([block], detectColors(process.stderr))))
+      ui.data('err', maskedLine(ui.render([block], ui.colorsOf('err'))))
+    } else if (cwdGone(err)) {
+      // Removed under the shell (a checkout of another branch, `rm -rf` in
+      // another): every verb starts from the cwd.
+      say('vx: the current directory no longer exists — cd into the workspace again and re-run\n')
     } else if (isOutOfFds(err)) {
       say(`vx: ${err.message} — ${OUT_OF_FDS_HINT}\n`)
     } else if (isFsRefusal(err)) {
@@ -114,7 +96,7 @@ async function main(): Promise<void> {
     // stdout got nothing to parse, and only prose on stderr to branch on.
     if (wantsJson(argv)) {
       const message = err instanceof Error ? err.message : String(err)
-      process.stdout.write(errorDocument(errorCode(err), maskedLine(message)))
+      ui.data('out', errorDocument(errorCode(err), maskedLine(message)))
     }
     // Same reason as the success path above: a large stderr is truncated by
     // `process.exit` too, and an error message cut in half is the one a
@@ -174,13 +156,21 @@ function withCauses(err: unknown): string {
 process.on('beforeExit', () => {
   if (settled) return
   settled = true
-  ;(require('./util/index.js') as typeof import('./util/index.js')).ui.say(
+  ;(require('./ui/index.js') as typeof import('./ui/index.js')).say(
     'error',
     'vx: the run stopped before it finished: something it awaited can never settle (a plugin hook?)',
   )
   process.exitCode = 1
 })
 
+/** `process.cwd()`'s refusal of a directory removed under the process. */
+function cwdGone(err: unknown): boolean {
+  return (
+    (err as NodeJS.ErrnoException | null)?.code === 'ENOENT' &&
+    /\buv_cwd\b/.test((err as Error).message)
+  )
+}
+
 // A reader that leaves is not the run's failure. `vx run build | head -1`
 // closes the pipe after one line; every later write gets EPIPE, which Bun
 // raises as an `error` event on the stream, and an `error` nobody listens

package/src/cache/archive.ts

@@ -350,7 +350,7 @@ export async function planArtifact(args: PackArgs): Promise<ArtifactPlan> {
       }
       if (!st.isFile()) {
         throw new UserError(
-          `${shown} is not a regular file: vx stores regular files and symlinks only — emit a file there, or narrow cache.outputs.files to the files the task produces, or take it back with a '!' entry`,
+          `${shown} is not a regular file: vx stores regular files and symlinks only — emit a file there, or narrow outputs.files to the files the task produces, or take it back with a '!' entry`,
         )
       }
       const mode = st.mode & 0o777