@vzn/vx 0.0.512 → 0.0.513

package/package.json

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

package/src/exec/env.ts

@@ -1,3 +1,4 @@
+import { existsSync, readFileSync } from 'node:fs'
 import path from 'node:path'
 
 // Build the environment exposed to a task.
@@ -91,3 +92,55 @@ export function buildIsolatedEnv(opts: BuildEnvOptions): NodeJS.ProcessEnv {
 
   return out
 }
+
+/**
+ * `npm_execpath`, as the workspace's package manager sets it for a script.
+ * A tool that runs other scripts reads it to call the same manager back
+ * (npm-run-all's `run-s`, `run-p`) and falls back to `npm` without it:
+ * solidjs/solid's `npm-run-all -nl build:*` needed a global npm under vx,
+ * where `pnpm run build` passed (owner, 2026-10-06). It names a binary on
+ * this machine, so it is not in the key, as PATH is not.
+ */
+export const PM_EXEC_ENV = 'npm_execpath'
+
+const MANAGERS = ['pnpm', 'yarn', 'bun', 'npm'] as const
+const LOCKFILES: ReadonlyArray<readonly [string, (typeof MANAGERS)[number]]> = [
+  ['pnpm-lock.yaml', 'pnpm'],
+  ['yarn.lock', 'yarn'],
+  ['bun.lock', 'bun'],
+  ['bun.lockb', 'bun'],
+  ['package-lock.json', 'npm'],
+]
+
+const managerPaths = new Map<string, string | null>()
+
+/**
+ * The executable of the workspace's package manager: the root
+ * package.json's `packageManager`, else its lockfile, found on the root's
+ * `node_modules/.bin` and PATH. Learned once per root; null when the root
+ * names none or this machine has none.
+ */
+export function packageManagerPath(root: string): string | null {
+  const known = managerPaths.get(root)
+  if (known !== undefined) return known
+  let name: string | undefined
+  try {
+    const field = (
+      JSON.parse(readFileSync(path.join(root, 'package.json'), 'utf8')) as {
+        packageManager?: unknown
+      }
+    ).packageManager
+    if (typeof field === 'string') name = MANAGERS.find((m) => field.startsWith(`${m}@`))
+  } catch {}
+  name ??= LOCKFILES.find(([f]) => existsSync(path.join(root, f)))?.[1]
+  const found =
+    name === undefined
+      ? null
+      : Bun.which(name, {
+          PATH: [path.join(root, 'node_modules', '.bin'), process.env['PATH'] ?? ''].join(
+            path.delimiter,
+          ),
+        })
+  managerPaths.set(root, found)
+  return found
+}

package/src/exec/index.ts

@@ -1,7 +1,13 @@
 // Module contract. Cross-module imports must come through here; see
 // docs/design/module-isolation-2026-06.md and tests/module-boundaries.test.ts.
 
-export { buildIsolatedEnv, VX_RUN_TASK_ENV, VX_RUN_WORKSPACE_ENV } from './env.js'
+export {
+  buildIsolatedEnv,
+  packageManagerPath,
+  PM_EXEC_ENV,
+  VX_RUN_TASK_ENV,
+  VX_RUN_WORKSPACE_ENV,
+} from './env.js'
 export {
   runCommand,
   runPersistent,

package/src/orchestrator/execute-task.ts

@@ -17,6 +17,8 @@ import {
 } from '../cache/index.js'
 import {
   buildIsolatedEnv,
+  packageManagerPath,
+  PM_EXEC_ENV,
   VX_RUN_TASK_ENV,
   VX_RUN_WORKSPACE_ENV,
   runPersistent,
@@ -1411,6 +1413,11 @@ function taskEnv(node: TaskNode, step: ExecConfig, workspaceRoot: string): NodeJ
   })
   env[VX_RUN_WORKSPACE_ENV] = workspaceRoot
   env[VX_RUN_TASK_ENV] = node.id
+  // A task's own passThrough or define wins.
+  if (env[PM_EXEC_ENV] === undefined) {
+    const manager = packageManagerPath(workspaceRoot)
+    if (manager !== null) env[PM_EXEC_ENV] = manager
+  }
   return env
 }