@vzn/vx 0.0.156 → 0.0.158

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.156",
+  "version": "0.0.158",
   "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.158",
+    "@vzn/vx-linux-arm64": "0.0.158",
+    "@vzn/vx-darwin-x64": "0.0.158",
+    "@vzn/vx-darwin-arm64": "0.0.158"
   },
   "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.
@@ -716,6 +723,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 +750,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',
     },
   ],
 ])