@vzn/vx 0.0.252 → 0.0.254

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.252",
+  "version": "0.0.254",
   "description": "A fast, correct task runner and build cache for JavaScript monorepos.",
   "type": "module",
   "exports": {
@@ -17,10 +17,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@vzn/vx-linux-x64": "0.0.252",
-    "@vzn/vx-linux-arm64": "0.0.252",
-    "@vzn/vx-darwin-x64": "0.0.252",
-    "@vzn/vx-darwin-arm64": "0.0.252"
+    "@vzn/vx-linux-x64": "0.0.254",
+    "@vzn/vx-linux-arm64": "0.0.254",
+    "@vzn/vx-darwin-x64": "0.0.254",
+    "@vzn/vx-darwin-arm64": "0.0.254"
   },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.76"

package/src/cache/inputs.ts

@@ -22,6 +22,7 @@ import { rm, rmdir } from 'node:fs/promises'
 import type { CacheInputs } from '../config.js'
 import {
   asTrees,
+  executablePath,
   isExecutableMissing,
   isLiteralPattern,
   normalizeGlob,
@@ -389,7 +390,11 @@ async function runRuntimeCommand(
   const prefix = binDirs.join(path.delimiter)
   let proc
   try {
-    const argv = process.platform === 'win32' ? shellArgv(command) : ['sh', '-c', command]
+    // vx's own `sh`, resolved on its PATH before the probe's: Bun.spawn looks
+    // a bare name up on the child's PATH, which leads with the project's
+    // `node_modules/.bin`, so a dependency's `sh` bin ran every probe (J-69).
+    const argv =
+      process.platform === 'win32' ? shellArgv(command) : [executablePath('sh'), '-c', command]
     proc = Bun.spawn(argv, {
       cwd,
       env: { ...process.env, PATH: ambient ? `${prefix}${path.delimiter}${ambient}` : prefix },

package/src/cli/cache.ts

@@ -1,6 +1,6 @@
 import { existsSync } from 'node:fs'
 import { Cache, noteSchemaReset } from '../cache/index.js'
-import { flagHint, seeHelp } from './help.js'
+import { flagHint, refusedWord, seeHelp } from './help.js'
 import { nearest, parseDuration, parseSize } from '../util/index.js'
 import { acquireRunLock } from '../orchestrator/index.js'
 import { findWorkspaceRoot } from '../workspace/index.js'
@@ -121,7 +121,7 @@ export function parsePruneArgs(args: readonly string[]): PruneArgs {
       const cd = parseCacheDirFlag(args, i)
       if (cd === null)
         return {
-          error: `unknown argument: ${a}${flagHint('cache prune', a ?? '')}${seeHelp('cache')}`,
+          error: `${refusedWord(a ?? '')}: ${a}${flagHint('cache prune', a ?? '')}${seeHelp('cache')}`,
         }
       if ('error' in cd) return { error: cd.error }
       out.cacheDir = cd.cacheDir

package/src/cli/help.ts

@@ -201,6 +201,11 @@ export function seeHelp(verb: string): string {
   return ` (see \`vx ${verb} --help\`)`
 }
 
+/** How a verb names a word it refuses: a flag, or a positional it takes no more of. */
+export function refusedWord(arg: string): string {
+  return arg.startsWith('-') ? 'unknown flag' : 'unexpected argument'
+}
+
 /**
  * `(did you mean --concurrency?)` for a flag within two edits of one `verb`
  * accepts; empty for anything else (a positional included). A third edit

package/src/cli/info.ts

@@ -5,7 +5,7 @@
 // too; this file parses the flags and renders the rows.
 
 import { collectInfo, type FlakyTask, type InfoFacts } from '../orchestrator/index.js'
-import { flagHint, seeHelp } from './help.js'
+import { flagHint, refusedWord, seeHelp } from './help.js'
 import { namedCacheDir, parseCacheDirFlag, warnToStderr } from './workspace-config.js'
 import { formatBytes } from './format.js'
 import { MIN_BUN } from '../util/index.js'
@@ -36,7 +36,10 @@ export function parseInfoArgs(args: readonly string[]): InfoArgs {
       i = cd.next
       continue
     }
-    return { ...out, error: `unknown argument: ${a}${flagHint('info', a ?? '')}${seeHelp('info')}` }
+    return {
+      ...out,
+      error: `${refusedWord(a ?? '')}: ${a}${flagHint('info', a ?? '')}${seeHelp('info')}`,
+    }
   }
   return out
 }

package/src/cli/lock.ts

@@ -3,7 +3,7 @@
 // current environment. Design: docs/design/config-lock-2026-06.md.
 
 import type { ProjectConfig } from '../config.js'
-import { flagHint, seeHelp } from './help.js'
+import { flagHint, refusedWord, seeHelp } from './help.js'
 import { relPosix, xxh3hex } from '../util/index.js'
 import {
   findWorkspaceRoot,
@@ -32,7 +32,7 @@ export function parseLockArgs(args: readonly string[]): LockArgs {
     else
       return {
         check: false,
-        error: `unknown argument: ${a}${flagHint('lock', a)}${seeHelp('lock')}`,
+        error: `${refusedWord(a)}: ${a}${flagHint('lock', a)}${seeHelp('lock')}`,
       }
   }
   return out