@vzn/vx 0.0.149 → 0.0.151

package/package.json

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

package/src/cli/help.ts

@@ -108,6 +108,12 @@ export function helpText(pluginCommands: readonly string[] = []): string {
     '  depends on none of them; a plain `vx run` never requires a plugin.',
     '  See the plugin guide: https://vznjs.github.io/vx/guides/plugins/',
     '',
+    'Turbo and Nx spellings (for run):',
+    '  What turbo run / nx run-many / nx affected take works here, or is refused',
+    '  naming the vx spelling: -t build,test, -p app, --exclude docs, --parallel 4,',
+    '  and --base main, --dry-run, --skip-nx-cache. `vx build` names `vx run build`.',
+    '  Every flag: https://vznjs.github.io/vx/cli/#turbo-and-nx-flags',
+    '',
     'Argument forwarding (for run):',
     "  Anything after `--` is forwarded (shell-quoted) to the task's exec",
     '  command. The forwarded args are folded into the cache key.',

package/src/orchestrator/placement.ts

@@ -144,8 +144,11 @@ export function placeTasks(
 }
 
 /**
- * `executorOf` for `planRun`, or nothing. Declining plugins, a single
- * executor, or a resolution error all yield nothing: `--dry` is an
+ * `executorOf` for `planRun`, or nothing. A remote-only task no remote
+ * executor takes is labelled `noop` whatever the executor count: the run
+ * does nothing for it, and a plan line without the label promises an
+ * execution. Otherwise declining plugins, a single executor, or a
+ * resolution error all yield nothing: `--dry` is an
  * inspection command and must not fail over a label. The error is still
  * said, on the status line, in the plugin's name: the run this plan
  * previews would refuse on it, and a plan that hid that would read as
@@ -188,11 +191,15 @@ export async function planExecutorOf(
           remoteOnly: placements.remoteOnly,
         })
   return {
-    ...(executors.length < 2
+    ...(executors.length < 2 && placements.remoteOnlyNoop.size === 0
       ? {}
       : {
           executorOf: (id: string) =>
-            placements.remoteOnlyNoop.has(id) ? 'noop' : placements.executors.get(id)?.name,
+            placements.remoteOnlyNoop.has(id)
+              ? 'noop'
+              : executors.length < 2
+                ? undefined
+                : placements.executors.get(id)?.name,
         }),
     ...(download === undefined
       ? {}

package/src/orchestrator/plan.ts

@@ -40,7 +40,8 @@ export interface PlannedTask {
   /**
    * Name of the executor this task would be PLACED on. Attached only when
    * the workspace declares more than one executor — with a single one every
-   * line would carry the same label and say nothing. Absent for group tasks
+   * line would carry the same label and say nothing — except `'noop'`: a
+   * remote-only task no remote executor takes, which the run skips. Absent for group tasks
    * and persistent tasks, which never reach an executor.
    */
   executor?: string
@@ -105,7 +106,7 @@ export interface PlanArgs {
   /** When provided, per-task p50s are attached and `RunPlan.predicted` is
    *  computed. Failing open: a history error yields a plan without them. */
   history?: HistoryProvider
-  /** Placement lookup (`run.ts`), passed only when >1 executor is declared. */
+  /** Placement lookup (`placement.ts`): >1 executor declared, or a `noop` task. */
   executorOf?: (id: string) => string | undefined
 }
 
@@ -212,6 +213,8 @@ function downgradeField(args: PlanArgs): {
 
 /** A task the plan expects to EXECUTE (a no-cache task executes every run). */
 function wouldRun(t: PlannedTask): boolean {
+  // A `noop` task succeeds without running (execute-task.ts), whatever its key.
+  if (t.executor === 'noop') return false
   return t.cacheStatus === 'miss' || t.cacheStatus === 'no-cache'
 }
 

package/src/workspace/filter.ts

@@ -3,6 +3,7 @@
 //   <pattern>        name glob, `*` = any characters (e.g. foo, @scope/*)
 //   ./<dir>          the package at <dir>, else the packages under it (relative to workspace root)
 //   {<dir>}          same as ./<dir>
+//   //               the workspace-root project only (Turbo's name for the root)
 //   <pattern>...     pattern + its transitive workspace dependencies
 //   ...<pattern>     pattern + its transitive workspace dependents
 //   <pattern>^...    only the transitive deps of pattern (excluding the matched package)
@@ -44,6 +45,8 @@ export interface ParsedFilter {
   pathGlob?: Bun.Glob
   /** The workspace root `pathGlob` is relative to. */
   pathRoot?: string
+  /** `//`: the project at `matcher` itself, never the ones under it. */
+  exactDir?: true
 }
 
 export function parseFilter(raw: string, workspaceRoot: string): ParsedFilter {
@@ -102,6 +105,26 @@ export function parseFilter(raw: string, workspaceRoot: string): ParsedFilter {
   // with one warning line (item 1030).
   if (s === '') throw new UserError(`filter "${raw}" names no project`)
 
+  // `//` is Turbo's name for the root package (`--filter=//`, `//...`,
+  // `!//`, probed on 2.8.17). vx names the root project by its
+  // package.json name, so `//` is its directory, and only a project
+  // there: read as `.`, it would select every project when the root is
+  // none.
+  if (s === '//') {
+    return {
+      raw,
+      negate,
+      withDeps,
+      withDependents,
+      onlyDeps,
+      onlyDependents,
+      isPath: true,
+      matcher: path.resolve(workspaceRoot),
+      exactDir: true,
+      ...(gitSince !== undefined ? { gitSince } : {}),
+    }
+  }
+
   let isPath = false
   let matcher = s
   let pathGlob: Bun.Glob | undefined
@@ -164,6 +187,7 @@ function matchSelector(filter: ParsedFilter, projects: ProjectMeta[]): string[]
     // A directory that is no project keeps the "at or under" reading.
     const exact = projects.find((p) => p.dir === filter.matcher)
     if (exact !== undefined) return [exact.name]
+    if (filter.exactDir === true) return out
     const prefix = filter.matcher + path.sep
     for (const p of projects) {
       if (p.dir.startsWith(prefix)) out.push(p.name)