@vzn/vx 0.0.92 → 0.0.94

package/package.json

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

package/src/cli/run.ts

@@ -156,7 +156,11 @@ export function parseRunArgs(args: readonly string[]): RunArgs {
       const v = a === '--concurrency' ? before[++i] : a.slice('--concurrency='.length)
       if (v === undefined) return { ...out, error: `--concurrency requires a value` }
       const n = parseConcurrency(v)
-      if (n === null) return { ...out, error: `invalid concurrency: ${v}` }
+      if (n === null)
+        return {
+          ...out,
+          error: `invalid concurrency: ${v} (a positive integer, or a share of the cores such as 50%)`,
+        }
       out.concurrency = n
     } else if (a === '--all') {
       out.all = true
@@ -281,14 +285,14 @@ export function parseRunArgs(args: readonly string[]): RunArgs {
       const v = a === '--verbosity' ? before[++i] : a.slice('--verbosity='.length)
       if (v === undefined) return { ...out, error: `--verbosity requires a value` }
       const n = parseDecimalInt(v)
-      if (n === null) return { ...out, error: `invalid verbosity: ${v}` }
+      if (n === null) return { ...out, error: `invalid verbosity: ${v} (a non-negative integer)` }
       out.verbosity = n
     } else if (a === '--dry') {
       out.dry = 'text'
     } else if (a?.startsWith('--dry=')) {
       const fmt = a.slice('--dry='.length)
       if (fmt !== 'text' && fmt !== 'json') {
-        return { ...out, error: `invalid --dry value: ${fmt}` }
+        return { ...out, error: `invalid --dry value: ${fmt} (text or json)` }
       }
       out.dry = fmt
     } else if (a === '--graph') {

package/src/cli/show.ts

@@ -36,6 +36,9 @@ export function parseShowArgs(args: readonly string[]): ShowArgs {
     else if (a.startsWith('-'))
       return { ...out, error: `unknown flag: ${a}${flagHint('show', a)}${seeHelp('show')}` }
     else if (out.target !== undefined) return { ...out, error: `unexpected argument: ${a}` }
+    // An empty name is a part of every name: its "did you mean" listed the
+    // whole workspace.
+    else if (a === '') return { ...out, error: 'empty target (omit it to list every project)' }
     else out.target = a
 
     if (format !== undefined) {

package/src/cli/why.ts

@@ -86,7 +86,8 @@ export function parseWhyArgs(args: readonly string[]): WhyArgs {
     if (a.startsWith('-'))
       return { ...out, error: `unknown flag: ${a}${flagHint('why', a)}${seeHelp('why')}` }
     if (out.target !== undefined) return { ...out, error: `unexpected argument: ${a}` }
-    out.target = a
+    // Empty is no task: read as a query it matched every recorded one.
+    if (a !== '') out.target = a
   }
   return out
 }
@@ -108,7 +109,11 @@ function suggest(query: string, ids: readonly string[]): string {
     }
     hits = nearMatches(query, byTask.keys()).flatMap((t) => byTask.get(t) ?? [])
   }
-  return hits.length > 0 ? ` — did you mean ${hits.slice(0, 3).join(', ')}?` : ''
+  if (hits.length > 0) return ` — did you mean ${hits.slice(0, 3).join(', ')}?`
+  // No near name: say where to look, or that there is nothing yet.
+  return ids.length === 0
+    ? `; nothing has run here yet (vx run ${query}, then vx why)`
+    : '; `vx last --list` shows what has run'
 }
 
 /**