@vzn/vx 0.0.156 → 0.0.159

package/package.json

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

package/src/workspace/config-schema.ts

@@ -113,7 +113,14 @@ export function validateWorkspace(config: WorkspaceConfig, configPath: string):
     const fileClaimants = new Map<string, string>()
     for (const [i, p] of config.plugins.entries()) {
       if (p === null || typeof p !== 'object') {
-        throw new UserError(`${configPath}: \`plugins[${i}]\` must be an object`)
+        // Nx's nx.json lists plugins by module name (`'@nx/vite/plugin'`);
+        // a vx plugin is the value its package's function returns.
+        throw new UserError(
+          `${configPath}: \`plugins[${i}]\` must be an object` +
+            (typeof p === 'string'
+              ? ` — a plugin is what its package's function returns (\`nx()\` from \`@vzn/vx-migrate\`), not a module name`
+              : ''),
+        )
       }
       // The loose schema's shape (unknown-typed hooks) plus the one retired
       // key this loader still refuses by name.
@@ -524,6 +531,7 @@ export function validateProjectConfig(config: ProjectConfig, configPath: string)
               `let cleanOutputs delete files outside it)`,
           )
         }
+        assertNoForeignToken(g, `${where}.cache.outputs.files`)
         if (namesDirItself(g)) {
           throw new UserError(
             `${where}.cache.outputs.files: "${g}" names the project directory itself and selects nothing — ` +
@@ -561,6 +569,7 @@ export function validateProjectConfig(config: ProjectConfig, configPath: string)
               `use cache.inputs.workspaceFiles for workspace-root-relative inputs)`,
           )
         }
+        assertNoForeignToken(g, `${where}.cache.inputs.files`)
         if (namesDirItself(g)) {
           throw new UserError(
             `${where}.cache.inputs.files: "${g}" names the project directory itself and selects nothing — use "**" for everything under it`,
@@ -716,6 +725,12 @@ const FOREIGN_FIELDS: ReadonlyMap<ReadonlySet<string>, Readonly<Record<string, s
       cmd: '`exec.command`',
       script: '`exec.command`',
       persistent: '`exec.persistent: {}`',
+      // Nx's target keys (project.json) and Turbo's `outputLogs`.
+      continuous: '`exec.persistent: {}`',
+      executor:
+        '`exec.command`: vx runs one shell command (`nx()` from `@vzn/vx-migrate` runs an Nx executor as one)',
+      options: '`exec.command` (a run-commands `options.command`) and `exec.env`',
+      outputLogs: 'the `--output-logs` flag of `vx run`',
     },
   ],
   [EXEC_FIELDS, { cmd: '`command`', script: '`command`' }],
@@ -737,6 +752,9 @@ const FOREIGN_FIELDS: ReadonlyMap<ReadonlySet<string>, Readonly<Record<string, s
         'a cache plugin in `plugins` (`turboCache()` or `nxCache()` from `@vzn/vx-migrate`)',
       parallel: '`concurrency`',
       cacheDirectory: '`cacheDir`',
+      defaultBase: 'the base in `--affected=<base>` (default `origin/HEAD`)',
+      tasksRunnerOptions: 'a cache plugin in `plugins` (`nxCache()` from `@vzn/vx-migrate`)',
+      globalPassThroughEnv: '`exec.env.passThrough` on the tasks it passes to',
     },
   ],
 ])
@@ -807,6 +825,36 @@ function ownFileCovered(glob: string, configPath: string): string | null {
   return ['package.json', path.basename(configPath)].find((f) => g.match(f)) ?? null
 }
 
+/**
+ * Turbo's and Nx's glob tokens, pasted from turbo.json or project.json
+ * (D-50). vx expands none of them, so each is a literal that matches no
+ * file: an input list of `$TURBO_DEFAULT$` keyed the task on nothing and
+ * replayed a stale output after its source changed.
+ */
+const FOREIGN_TOKENS: readonly (readonly [string, string])[] = [
+  [
+    '$TURBO_DEFAULT$',
+    'Turbo\'s default input set, which vx does not have — list the files, such as "**" for everything in the project',
+  ],
+  [
+    '$TURBO_ROOT$',
+    "Turbo's workspace root — name the path without it in `workspaceFiles`, which is workspace-root-relative",
+  ],
+  ['{projectRoot}', "Nx's project root — drop it: `files` globs are project-relative already"],
+  [
+    '{workspaceRoot}',
+    "Nx's workspace root — name the path without it in `workspaceFiles`, which is workspace-root-relative",
+  ],
+]
+
+function assertNoForeignToken(glob: string, where: string): void {
+  for (const [token, meaning] of FOREIGN_TOKENS) {
+    if (glob.includes(token)) {
+      throw new UserError(`${where}: "${glob}" holds ${token}, ${meaning}`)
+    }
+  }
+}
+
 /**
  * `.`, `./`, `././` (with or without a `!`) name the directory itself, which
  * no matcher expands: the entry selected nothing and said so nowhere.
@@ -1016,6 +1064,7 @@ function validateWorkspaceGlobs(v: unknown, where: string, negation: boolean): v
           `entries are workspace-root-relative and must stay within the workspace root`,
       )
     }
+    assertNoForeignToken(g, where)
     if (namesDirItself(g)) {
       throw new UserError(
         `${where}: "${g}" names the workspace root itself and selects nothing — use "**" for everything under it`,