@williamthorsen/nmr 0.46.0 → 0.46.1

package/.meta/changelog.json

@@ -1,4 +1,21 @@
 [
+  {
+    "version": "0.46.1",
+    "date": "2026-10-13",
+    "sections": [
+      {
+        "title": "🐛 Bug fixes",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Fixes the issue that a script run by bare `nmr` inside a package failed with `command not found` on a binary installed only in that package, and found the root's binaries, such as `eslint` and `tsgo`, only when the shell's `PATH` already contained the root's `node_modules/.bin`. (#1039)",
+            "hash": "64cde10b969329630577e2f9011d0a6cd480e009",
+            "entry": 1
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "0.46.0",
     "date": "2026-10-13",

package/.readyup/kits/default.js

@@ -8939,7 +8939,7 @@ function formatPaths(paths) {
 ${paths.map((path7) => `      ${path7}`).join("\n")}`;
 }
 function getMinVersion() {
-  const pickedFields = { "version": "0.46.0" };
+  const pickedFields = { "version": "0.46.1" };
   if (typeof pickedFields["version"] !== "string") {
     throw new TypeError("nmr/package.json: 'version' must be a string");
   }

package/.readyup/manifest.json

@@ -86,7 +86,7 @@
           "path": "kits/default.ts"
         },
         {
-          "hash": "106526b9",
+          "hash": "e03b7529",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -189,7 +189,7 @@
       "readyupVersion": "0.40.0",
       "source": "kits/default.ts",
       "sourceHash": "aaeb1a84",
-      "targetHash": "92d23b08"
+      "targetHash": "dbfec446"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.46.1 — 2026-10-13
+
+### 🐛 Bug fixes
+
+- Fixes the issue that a script run by bare `nmr` inside a package failed with `command not found` on a binary installed only in that package, and found the root's binaries, such as `eslint` and `tsgo`, only when the shell's `PATH` already contained the root's `node_modules/.bin`. (#1039)
+
 ## 0.46.0 — 2026-10-13
 
 ### 🎉 Features

package/README.md

@@ -5,13 +5,11 @@
 Context-aware script runner for pnpm monorepos. Includes an `nmr` (node-monorepo run) binary that provides centralized, consistent script execution across workspace packages and the monorepo root.
 
 <!-- section:release-notes -->
-## Release notes — v0.46.0 (2026-10-13)
+## Release notes — v0.46.1 (2026-10-13)
 
-### 🎉 Features
+### 🐛 Bug fixes
 
-- Adds a `packageMaturityPeriod` option to the config built with `defineConfig` from `@williamthorsen/nmr/taze`, which sets, for packages whose names match a `*` pattern, how many days after a release `nmr upgrade` waits before proposing it, in place of the shared `maturityPeriod`. (#1036)
-- Defines an embedded test, which runs an engine installed by the package, such as PGlite (Postgres compiled to WebAssembly), inside the test process, and places it in the `tool` tier rather than `unit` in `docs/vitest.md` and the `nmr` rulebook. (#1037)
-- Redefines a package's `peerDependencies` in `docs/vitest.md` as candidate tools rather than as the `tool` boundary, so a test is `tool` only when it makes a peer do work, and a test that imports a peer only for its constants, such as `AST_NODE_TYPES`, stays `unit`. (#1037)
+- Fixes the issue that a script run by bare `nmr` inside a package failed with `command not found` on a binary installed only in that package, and found the root's binaries, such as `eslint` and `tsgo`, only when the shell's `PATH` already contained the root's `node_modules/.bin`. (#1039)
 <!-- /section:release-notes -->
 
 ## Installation

package/dist/esm/bin-path.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns the environment in which a scope's commands run: Its `PATH` leads with the anchor's `node_modules/.bin`
+ * and then the monorepo root's, as under `pnpm run`, followed by the inherited `PATH`.
+ *
+ * A directory that the inherited `PATH` already contains is left where it is, so that an nmr run nested in another
+ * does not lengthen `PATH`.
+ */
+export declare function prependBinDirs(options: {
+    anchorDir: string;
+    env: NodeJS.ProcessEnv;
+    monorepoRoot: string;
+}): NodeJS.ProcessEnv;

package/dist/esm/bin-path.js

@@ -0,0 +1,21 @@
+import path from 'node:path';
+export function prependBinDirs(options) {
+    const { anchorDir, env, monorepoRoot } = options;
+    const inherited = env['PATH'] ?? '';
+    const seen = new Set(inherited
+        .split(path.delimiter)
+        .filter((entry) => entry !== '')
+        .map((entry) => path.resolve(entry)));
+    const additions = [];
+    for (const dir of [anchorDir, monorepoRoot]) {
+        const binDir = path.resolve(dir, 'node_modules', '.bin');
+        if (!seen.has(binDir)) {
+            seen.add(binDir);
+            additions.push(binDir);
+        }
+    }
+    if (additions.length === 0) {
+        return env;
+    }
+    return { ...env, PATH: [...additions, ...(inherited === '' ? [] : [inherited])].join(path.delimiter) };
+}

package/dist/esm/runCli.js

@@ -1,6 +1,7 @@
 import path from 'node:path';
 import { describeInvalidOutputStyle, formatGlyphLine, reportError, resolveSelfVersion, STATUS_GLYPHS, } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
+import { prependBinDirs } from "./bin-path.js";
 import { certifyRetention, computeCacheKey, computeRetentionKey, CURRENT_RUNTIME, encodeTreeSnapshot, findStaleBuildOutput, formatMisplacedNoCacheWarning, isCacheableCommand, NO_CACHE_ENV_VAR, readBuildOutputState, readCheckCacheEntry, recordTranscript, resolveRunId, resolveTreeSnapshot, RUN_ID_ENV_VAR, TREE_SNAPSHOT_ENV_VAR, writeCheckCacheEntry, writeDebugNote, } from "./check-cache.js";
 import { resolveContext } from "./context.js";
 import { enterChain } from "./entry-chain.js";
@@ -163,7 +164,12 @@ async function planRun(invocation) {
         ? runOptions
         : {
             ...runOptions,
-            env: enterChain({ anchorDir, command, env: childEnv, monorepoRoot: context.monorepoRoot }),
+            env: enterChain({
+                anchorDir,
+                command,
+                env: prependBinDirs({ anchorDir, env: childEnv, monorepoRoot: context.monorepoRoot }),
+                monorepoRoot: context.monorepoRoot,
+            }),
         };
     const chain = assembleChain({ invocation, registry, resolvedScript, snapshot });
     if (chain.settled) {

package/docs/scripts.md

@@ -1,6 +1,6 @@
 # Scripts and configuration
 
-How nmr resolves a command through its three tiers, how script values compose, how hooks wrap a command, how to configure scripts and builds, and what the default commands do beyond what `nmr --help` prints.
+How nmr resolves a command through its three tiers, how script values compose, which binaries a command finds on `PATH`, how hooks wrap a command, how to configure scripts and builds, and what the default commands do beyond what `nmr --help` prints.
 
 ## Three-tier override system
 
@@ -83,6 +83,10 @@ nmr recognizes `nmr` in command position: at the start of a step, after an unquo
 
 A [self-referential entry](#three-tier-override-system), in `package.json` or in `.config/nmr.config.ts`, is the shape that nmr cannot run as written, and it is rejected rather than reported. The same recognition finds it, so the same residuals apply: What goes unrecognized there re-enters nmr once, and the run then fails with an error naming the command and the directory that it re-entered.
 
+### Binaries on `PATH`
+
+Every command that nmr runs, whatever its tier, finds the binaries that `pnpm run` would find. Inside a package, its `PATH` leads with the package's `node_modules/.bin` and then the root's, followed by the `PATH` from which nmr was started; at the root, it leads with the root's `node_modules/.bin`. A script can therefore invoke a binary installed only in its own package by bare name, however nmr was started: bare `nmr` through direnv, `pnpm exec nmr`, or `nmr -F <pkg>` from the root. A directory that `PATH` already contains is not added again, so a nested nmr run does not lengthen it.
+
 ## Pre and post hooks
 
 The wrap rule and a repo-wide example are in the [README](../README.md#pre-and-post-hooks).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/nmr",
-  "version": "0.46.0",
+  "version": "0.46.1",
   "private": false,
   "description": "Context-aware script runner for pnpm monorepos",
   "keywords": [