@vzn/vx 0.0.536 → 0.0.538

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.536",
+  "version": "0.0.538",
   "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.536",
-    "@vzn/vx-linux-arm64": "0.0.536",
-    "@vzn/vx-darwin-x64": "0.0.536",
-    "@vzn/vx-darwin-arm64": "0.0.536"
+    "@vzn/vx-linux-x64": "0.0.538",
+    "@vzn/vx-linux-arm64": "0.0.538",
+    "@vzn/vx-darwin-x64": "0.0.538",
+    "@vzn/vx-darwin-arm64": "0.0.538"
   },
   "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/exec/runner.ts

@@ -155,6 +155,22 @@ function trailingCommentStart(command: string): number {
   return comment
 }
 
+/** Per line: is it a heredoc's body or terminator (`<<X` / `<<-'X'` … `X`)? */
+function heredocLines(lines: readonly string[]): boolean[] {
+  const pending: Array<{ delim: string; tabs: boolean }> = []
+  return lines.map((line) => {
+    const open = pending[0]
+    if (open !== undefined) {
+      if ((open.tabs ? line.replace(/^\t+/, '') : line) === open.delim) pending.shift()
+      return true
+    }
+    for (const m of line.matchAll(/(?<!<)<<(?!<)(-?)\s*(['"]?)([A-Za-z_]\w*)\2/g)) {
+      pending.push({ delim: m[3]!, tabs: m[1] === '-' })
+    }
+    return false
+  })
+}
+
 /**
  * The command a task runs with the args after `--` appended, shell-quoted.
  * They go before a trailing comment: appended after it, `echo args: # show`
@@ -162,6 +178,17 @@ function trailingCommentStart(command: string): number {
  */
 export function withForwardArgs(command: string, args: readonly string[] | undefined): string {
   if (!args || args.length === 0) return command
+  // A command that ends in a heredoc's body: appended to its terminator,
+  // `X FWD` closed nothing and the args never reached the command (X-12).
+  // They go on the last line that is a command, where `cat <<X FWD` is
+  // still `cat FWD` reading the heredoc.
+  const lines = command.trimEnd().split('\n')
+  const body = heredocLines(lines)
+  if (body[lines.length - 1] === true) {
+    const last = body.lastIndexOf(false)
+    const tail = lines.slice(last + 1).join('\n')
+    return `${withForwardArgs(lines.slice(0, last + 1).join('\n'), args)}\n${tail}`
+  }
   const quoted = args.map(shellQuote).join(' ')
   let comment = trailingCommentStart(command)
   if (comment < 0) {

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}`)