@vzn/vx 0.0.539 → 0.0.540

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.539",
+  "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.539",
-    "@vzn/vx-linux-arm64": "0.0.539",
-    "@vzn/vx-darwin-x64": "0.0.539",
-    "@vzn/vx-darwin-arm64": "0.0.539"
+    "@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