@vzn/vx 0.0.537 → 0.0.539

package/package.json

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

package/src/cli/run.ts

@@ -160,7 +160,8 @@ export function parseRunArgs(rawArgs: readonly string[], verb: 'run' | 'watch' =
     const a = before[i]
     if (a === '--filter' || a?.startsWith('--filter=')) {
       const v = a === '--filter' ? before[++i] : a.slice('--filter='.length)
-      if (v === undefined || v === '')
+      // `--filter --dry` took `--dry` as the pattern (X-13); no filter opens with `--`.
+      if (v === undefined || v === '' || (a === '--filter' && v.startsWith('--')))
         return {
           ...out,
           error: `--filter requires a value (a project name, glob or path, e.g. --filter app)`,

package/src/cli/select.ts

@@ -524,6 +524,10 @@ function didYouMeanProject(
   }
   for (const pattern of unmatched) {
     const typed = pattern.replace(/^!|\.\.\.$|^\.\.\.|\^/g, '')
+    // Two edits from any two-letter name: `--filter //` hinted `ui` (X-13).
+    if (typed === '//') {
+      return ". `//` is Turbo's root package, but the workspace root is no project here: give it a package.json name and a vx.config"
+    }
     const best = nearest(typed, names)
     if (best !== undefined) return `. Did you mean ${best}?`
     const bare = byBare.has(typed) ? typed : nearest(typed, byBare.keys())

package/src/orchestrator/prepare.ts

@@ -45,6 +45,7 @@ import {
   buildTaskGraph,
   excludeDependencies,
   expandRequested,
+  isGroupTask,
   type TaskNode,
   undeclaredDepsError,
   unresolvedRequests,
@@ -627,6 +628,18 @@ export async function prepareRun(options: RunOptions, log: Logger): Promise<Prep
         },
       )
     }
+    // Args after `--` go to requested commands only; with none among them
+    // they reached nothing and the run passed, the `--watch` unheard.
+    if ((options.forwardArgs?.length ?? 0) > 0) {
+      const requestedNodes = [...nodes.values()].filter((n) => n.requested)
+      if (requestedNodes.length > 0 && requestedNodes.every(isGroupTask)) {
+        const ids = requestedNodes.map((n) => n.id)
+        const named = ids.length > 3 ? `${ids.slice(0, 3).join(', ')}, …` : ids.join(', ')
+        throw new UserError(
+          `args after \`--\` reach no task: ${named} ${ids.length === 1 ? 'has' : 'have'} no command (a group); name the task that runs one`,
+        )
+      }
+    }
     if (hasHook(plugins, 'key')) {
       await applyKeyHooks(plugins, nodes, { workspaceRoot, cacheDir, warn: (m) => log.status(m) })
     }

package/src/orchestrator/run.ts

@@ -33,6 +33,7 @@ import {
   parseSize,
   printTimings,
   ulid,
+  isLiteralPattern,
   listed,
   nearest,
   UserError,
@@ -1577,6 +1578,21 @@ function didYouMean(
       continue
     }
     const [proj, task] = [spec.slice(0, at), spec.slice(at + 1)]
+    // `//` is two edits from any two-letter name: it hinted `ui#build` (X-13).
+    if (proj === '//') {
+      lists.add(
+        "`//` is Turbo's root package, but the workspace root is no project here: give it a package.json name and a vx.config with that task.",
+      )
+      continue
+    }
+    // `*` is one edit from any one-letter name and two from `ui`: `*#lint`
+    // hinted `ui#lint`, though the user meant every project.
+    if (!isLiteralPattern(proj) && !projects.has(proj)) {
+      lists.add(
+        `\`${spec}\` names one project, not a pattern: run \`${task}\` with --filter '${proj}' instead.`,
+      )
+      continue
+    }
     if (!projects.has(proj)) {
       const p = projectNamed(proj, projects) ?? nearest(proj, projects.keys())
       if (p !== undefined && tasksOf(projects.get(p)).includes(task)) hints.add(`${p}#${task}`)