@vzn/vx 0.0.543 → 0.0.545

package/package.json

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

package/src/orchestrator/plugin.ts

@@ -445,7 +445,17 @@ function pluginPackageName(dir: string): string {
       /* not here; look one level up */
     }
     if (text !== undefined) {
-      const name = (JSON.parse(text) as { name?: unknown }).name
+      // A bare JSON.parse reached the user as a SyntaxError and a stack,
+      // naming no file (X-20).
+      let pkg: { name?: unknown } | null
+      try {
+        pkg = JSON.parse(text) as { name?: unknown } | null
+      } catch (err) {
+        throw new UserError(
+          `definePlugin: failed to parse ${path.join(d, 'package.json')}: ${(err as Error).message}`,
+        )
+      }
+      const name = pkg?.name
       if (typeof name !== 'string' || name.length === 0) {
         throw new UserError(
           `definePlugin: ${path.join(d, 'package.json')} has no name — a plugin is a package, and its name is the package's`,

package/src/workspace/config-schema.ts

@@ -180,6 +180,17 @@ export function validateWorkspace(config: WorkspaceConfig, configPath: string):
             `task's command runs (see docs/architecture.md § plugin capabilities).`,
         )
       }
+      // A misspelled hook (`excutor`, `setUp`) was never called and never
+      // said: tasks ran here with the plugin's executor unheard (X-19).
+      for (const key of Object.keys(plug)) {
+        if (key === 'name' || (PLUGIN_HOOKS as readonly string[]).includes(key)) continue
+        const near = nearest(key, PLUGIN_HOOKS)
+        const hint =
+          near === undefined ? ` (hooks: ${PLUGIN_HOOKS.join(', ')})` : ` — did you mean '${near}'?`
+        throw new UserError(
+          `${configPath}: plugin '${pkg}' declares '${key}', which is no plugin hook${hint}`,
+        )
+      }
       for (const cap of PLUGIN_FUNCTION_HOOKS) {
         if (plug[cap] !== undefined && typeof plug[cap] !== 'function') {
           throw new UserError(`${configPath}: \`plugins[${i}].${cap}\` must be a function`)