@vzn/vx 0.0.252 → 0.0.253

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.252",
+  "version": "0.0.253",
   "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.253",
+    "@vzn/vx-linux-arm64": "0.0.253",
+    "@vzn/vx-darwin-x64": "0.0.253",
+    "@vzn/vx-darwin-arm64": "0.0.253"
   },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.76"

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