@vzn/vx 0.0.251 → 0.0.253

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.251",
+  "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.251",
-    "@vzn/vx-linux-arm64": "0.0.251",
-    "@vzn/vx-darwin-x64": "0.0.251",
-    "@vzn/vx-darwin-arm64": "0.0.251"
+    "@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

@@ -48,7 +48,7 @@ export function helpText(pluginCommands: readonly string[] = []): string {
     '  vx upgrade [tag]',
     '  vx show [PROJECT[#TASK] | TASK] [--format pretty|json]',
     '  vx info [--format pretty|json] [--cache-dir <path>]',
-    '  vx why [TASK | PKG#TASK] [--run <runId>] [--format pretty|json] [--cache-dir <path>]',
+    '  vx why (TASK | PKG#TASK) [--run <runId>] [--format pretty|json] [--cache-dir <path>]',
     '  vx last [RUNID] [--list[=N]] [--failed] [--format pretty|json] [--cache-dir <path>]',
     '  vx completions bash|zsh|fish',
     '  vx help [VERB]',
@@ -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/init.ts

@@ -1,7 +1,8 @@
 // `vx init [--dry] [--force] [--mjs]` — a workspace from nowhere: one vx.config.ts
 // per package from its package.json scripts, and the workspace file every
-// run needs. Turbo and Nx are not read here; a runner's own config beside
-// the scripts is the richer source, and `@vzn/vx-migrate` maps it.
+// run needs. In a Turbo or Nx repo it writes only the workspace file,
+// declaring `turbo()` or `nx()` from `@vzn/vx-migrate`, which read the
+// runner's own config live (`adopt`).
 // `vx init --plugin <seam>` writes a runnable plugin for one seam and its
 // test instead (plugin-templates.ts, the examples the gate runs).
 

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