@vzn/vx 0.0.148 → 0.0.150

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.148",
+  "version": "0.0.150",
   "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.148",
-    "@vzn/vx-linux-arm64": "0.0.148",
-    "@vzn/vx-darwin-x64": "0.0.148",
-    "@vzn/vx-darwin-arm64": "0.0.148"
+    "@vzn/vx-linux-x64": "0.0.150",
+    "@vzn/vx-linux-arm64": "0.0.150",
+    "@vzn/vx-darwin-x64": "0.0.150",
+    "@vzn/vx-darwin-arm64": "0.0.150"
   },
   "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/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)