@vzn/vx 0.0.155 → 0.0.158

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.155",
+  "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.155",
-    "@vzn/vx-linux-arm64": "0.0.155",
-    "@vzn/vx-darwin-x64": "0.0.155",
-    "@vzn/vx-darwin-arm64": "0.0.155"
+    "@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/cli/plan-format.ts

@@ -28,11 +28,14 @@ export function formatPlanText(plan: RunPlan): string {
   let remote = 0
   let miss = 0
   let nocache = 0
+  let noop = 0
   for (const t of real) {
-    const sym = symbolFor(t.cacheStatus)
-    const desc = describe(t.cacheStatus)
+    // `@noop`: the run succeeds it without running, whatever its key says.
+    const skipped = t.executor === 'noop'
+    const sym = skipped ? '∅' : symbolFor(t.cacheStatus)
+    const desc = skipped ? 'noop — would not run' : describe(t.cacheStatus)
     const shortHash = t.hash ? t.hash.slice(0, 8) : ''
-    const executes = t.cacheStatus === 'miss' || t.cacheStatus === 'no-cache'
+    const executes = !skipped && (t.cacheStatus === 'miss' || t.cacheStatus === 'no-cache')
     const eta = executes && t.p50Ms !== undefined ? `  ~${formatDuration(t.p50Ms)}` : ''
     // Placement, by EXECUTOR NAME rather than a local/remote word: the
     // summary line below already spends "local" and "remote" on the cache
@@ -48,7 +51,8 @@ export function formatPlanText(plan: RunPlan): string {
     if (taskDesc) {
       lines.push(`     ${' '.repeat(idWidth)}  ${taskDesc}`)
     }
-    if (t.cacheStatus === 'hit-local') local++
+    if (skipped) noop++
+    else if (t.cacheStatus === 'hit-local') local++
     else if (t.cacheStatus === 'hit-remote') remote++
     else if (t.cacheStatus === 'miss') miss++
     else if (t.cacheStatus === 'no-cache') nocache++
@@ -62,6 +66,7 @@ export function formatPlanText(plan: RunPlan): string {
   if (hits > 0) summary.push(`${hits} cache hit${hits === 1 ? '' : 's'} (${hitParts.join(', ')})`)
   if (miss > 0) summary.push(`${miss} would run`)
   if (nocache > 0) summary.push(`${nocache} no-cache`)
+  if (noop > 0) summary.push(`${noop} noop`)
   lines.push('')
   lines.push(summary.join(', ') + '.')
 

package/src/orchestrator/run-records.ts

@@ -1,9 +1,10 @@
 // What a finished run leaves behind: the `runs` rows, the `invocations`
 // header row, and — only when a telemetry sink is active — the per-task
 // telemetry mirror. One pass over the outcome list builds all three, so
-// `invocations.task_count`, the terminal's "N total" and the number of
-// telemetry tasks are the same count by construction (`tallyOutcomes`
-// applies the same group/aborted filter).
+// `invocations.task_count` and the number of telemetry tasks agree by
+// construction; the terminal's "N total" agrees because `tallyOutcomes`
+// applies the same group/aborted filter, a second copy of the rule that
+// tests/run-records.test.ts holds to this one.
 
 import type { InvocationRecord, RunRecord } from '../cache/index.js'
 import { isGroupTask, type TaskOutcome } from '../graph/index.js'

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',
     },
   ],
 ])