@vzn/vx 0.0.538 → 0.0.540

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.538",
+  "version": "0.0.540",
   "description": "The fastest task runner and build cache for JavaScript monorepos.",
   "type": "module",
   "exports": {
@@ -21,10 +21,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@vzn/vx-linux-x64": "0.0.538",
-    "@vzn/vx-linux-arm64": "0.0.538",
-    "@vzn/vx-darwin-x64": "0.0.538",
-    "@vzn/vx-darwin-arm64": "0.0.538"
+    "@vzn/vx-linux-x64": "0.0.540",
+    "@vzn/vx-linux-arm64": "0.0.540",
+    "@vzn/vx-darwin-x64": "0.0.540",
+    "@vzn/vx-darwin-arm64": "0.0.540"
   },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.76"

package/src/orchestrator/plugin-host.ts

@@ -183,6 +183,7 @@ export async function applyGraphHooks(
   for (const plugin of plugins) {
     if (plugin.graph === undefined) continue
     await safe(plugin, 'graph', () => plugin.graph!(nodes, ctx))
+    await safe(plugin, 'graph', () => checkNodeShapes(nodes))
     afterEach?.(plugin)
     last = plugin
   }
@@ -190,6 +191,24 @@ export async function applyGraphHooks(
   await safe(last, 'graph', () => checkGraph(nodes, ctx.workspaceRoot))
 }
 
+/**
+ * A hook writes the graph as plain JS: `deps = null` surfaced as "null is
+ * not an object", naming no task (X-15). Checked per plugin, before its
+ * edits are read, so the refusal names the plugin that wrote them.
+ */
+function checkNodeShapes(nodes: Map<string, TaskNode>): void {
+  const what = (v: unknown): string => (v === null ? 'null' : typeof v)
+  for (const [key, node] of nodes as Map<string, unknown>) {
+    if (typeof node !== 'object' || node === null) {
+      throw new Error(`'${key}' holds ${what(node)}, not a task`)
+    }
+    const deps = (node as { deps?: unknown }).deps
+    if (!Array.isArray(deps)) {
+      throw new Error(`${key}'s deps is ${what(deps)}, not an array of task ids`)
+    }
+  }
+}
+
 /**
  * `key` stage: every plugin may add `{ name: value }` material to every
  * task. Stored on the node as sorted `[plugin/name, value]` pairs so the

package/src/orchestrator/prepare.ts

@@ -45,6 +45,7 @@ import {
   buildTaskGraph,
   excludeDependencies,
   expandRequested,
+  isGroupTask,
   type TaskNode,
   undeclaredDepsError,
   unresolvedRequests,
@@ -627,6 +628,18 @@ export async function prepareRun(options: RunOptions, log: Logger): Promise<Prep
         },
       )
     }
+    // Args after `--` go to requested commands only; with none among them
+    // they reached nothing and the run passed, the `--watch` unheard.
+    if ((options.forwardArgs?.length ?? 0) > 0) {
+      const requestedNodes = [...nodes.values()].filter((n) => n.requested)
+      if (requestedNodes.length > 0 && requestedNodes.every(isGroupTask)) {
+        const ids = requestedNodes.map((n) => n.id)
+        const named = ids.length > 3 ? `${ids.slice(0, 3).join(', ')}, …` : ids.join(', ')
+        throw new UserError(
+          `args after \`--\` reach no task: ${named} ${ids.length === 1 ? 'has' : 'have'} no command (a group); name the task that runs one`,
+        )
+      }
+    }
     if (hasHook(plugins, 'key')) {
       await applyKeyHooks(plugins, nodes, { workspaceRoot, cacheDir, warn: (m) => log.status(m) })
     }