@vzn/vx 0.0.640 → 0.0.642

package/launcher.sh

@@ -35,8 +35,15 @@ scope=${scope##*/}
 # directory up to the git top-level (handoff.ts workspaceFile, the same
 # rule). One hop (VX_HANDED_OFF, which also names this launcher), never to
 # this package itself (`-ef`: same inode, so a pnpm symlink counts as
-# itself). Shell tests and builtins only, no fork per level.
-if [ -z "${VX_HANDED_OFF-}" ]; then
+# itself). Shell tests and builtins only, no fork per level. `vx upgrade -g`
+# moves only this global vx, so it never hands off (owner, 2026-10-16).
+stay=
+if [ "${1-}" = upgrade ]; then
+  for a in "$@"; do
+    case $a in -g | --global) stay=1 ;; esac
+  done
+fi
+if [ -z "${VX_HANDED_OFF-}" ] && [ -z "$stay" ]; then
   d=$PWD
   while :; do
     root=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.640",
+  "version": "0.0.642",
   "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.640",
-    "@vzn/vx-linux-arm64": "0.0.640",
-    "@vzn/vx-darwin-x64": "0.0.640",
-    "@vzn/vx-darwin-arm64": "0.0.640"
+    "@vzn/vx-linux-x64": "0.0.642",
+    "@vzn/vx-linux-arm64": "0.0.642",
+    "@vzn/vx-darwin-x64": "0.0.642",
+    "@vzn/vx-darwin-arm64": "0.0.642"
   },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.76"
@@ -35,13 +35,6 @@
     "config",
     "schemas",
     "skills",
-    "docs/cli.md",
-    "docs/schema.md",
-    "docs/caching.md",
-    "docs/execution.md",
-    "docs/patterns.md",
-    "docs/security.md",
-    "docs/features.md",
     "launcher.sh",
     "launcher.cjs",
     "README.md",

package/skills/vx/SKILL.md

@@ -23,7 +23,7 @@ task failed or was skipped, or the command was refused. `vx last --format
 json` prints the run as JSON afterwards, a row per task. A refusal under
 `--format json` (or `--dry=json`) is one line on stdout,
 `{"ok":false,"error":{"code","message","docs"}}`: branch on `code`;
-`docs` (or `vx docs <code>` offline) says what to do.
+`docs` (or `vx docs <code>`) says what to do.
 Without a TTY a missing task name never prompts: vx exits 1 and lists the
 tasks it found.
 
@@ -95,9 +95,9 @@ vx info --format json   # vx and Bun versions, projects, config errors, plugins,
   the config, do not force. A task with no `inputs` has no key, so every
   cached task behind it misses: give it `inputs`.
 - Every JSON shape is a JSON Schema in `node_modules/@vzn/vx/schemas/`.
-- Offline reference: `vx docs <words> --format json` searches the CLI, config
-  and cache pages that ship with vx; the sections holding every word print
-  whole.
+- Reference: `vx docs <words> --format json` searches the reference pages at
+  this vx's release tag on GitHub (online); the sections holding every word
+  print whole.
 - Docs as markdown: https://vznjs.github.io/vx/llms.txt (its index).
   When that host is unreachable, the same pages are
   `https://raw.githubusercontent.com/vznjs/vx/main/packages/vx-docs/src/content/docs/<page>.md`:

package/src/bin.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env -S bun --no-env-file --no-install
 // Wrapped in an explicit async main so `bun build --compile` accepts
 // the file. The compile target doesn't allow top-level await.
-import { handOff, localVx, vxPath } from './handoff.js'
+import { handOff, localVx, upgradesOnlyItself, vxPath } from './handoff.js'
 
 let settled = false
 
@@ -10,11 +10,13 @@ async function main(): Promise<void> {
   try {
     // Inside the try: `process.cwd()` throws EMFILE when out of descriptors,
     // and that is a one-line UserError below, not a stack.
-    const local = await localVx(
-      process.cwd(),
-      process.execPath,
-      Bun.main.startsWith('/$bunfs') || (process.argv[1] ?? '').startsWith('/$bunfs'),
-    )
+    const local = upgradesOnlyItself(argv)
+      ? null
+      : await localVx(
+          process.cwd(),
+          process.execPath,
+          Bun.main.startsWith('/$bunfs') || (process.argv[1] ?? '').startsWith('/$bunfs'),
+        )
     if (local !== null) await handOff(local, argv)
     // `vx --version` needs one leaf module; the dispatcher and the util
     // barrel it pulled in were 20 ms of its 28 (2026-10-01).