@williamthorsen/nmr 0.24.0 → 0.25.0

package/.readyup/kits/default.js

@@ -0,0 +1,479 @@
+/** @noformat — @generated. Do not edit. Compiled by rdy. */
+/* eslint-disable */
+export const __readyupVersion = "0.23.0";
+
+
+// .readyup/kits/default.ts
+import { existsSync, globSync, readdirSync as readdirSync2, readFileSync } from "node:fs";
+import { basename, join, sep } from "node:path";
+import { defineRdyKit } from "readyup";
+import {
+  fileContains,
+  fileExists,
+  hasDevDependency,
+  hasMinDevDependencyVersion,
+  hasPackageJsonField,
+  isRecord,
+  readFile,
+  readPackageJson
+} from "readyup/check-utils";
+
+// src/default-scripts.ts
+var GATE_PROJECTS = "--project unit --project tool";
+var workspaceScripts = {
+  build: ["compile"],
+  check: ["typecheck", "fmt:check", "lint:check", "test"],
+  "check:strict": ["typecheck", "fmt:check", "lint:strict", "test:coverage"],
+  clean: "nmr-clean",
+  compile: "nmr-compile",
+  fix: ["lint", "fmt"],
+  "fix:check": ["fmt:check", "lint:check"],
+  fmt: "nmr-fmt --write",
+  "fmt:check": "nmr-fmt --check",
+  lint: "eslint --fix .",
+  "lint:check": "eslint .",
+  "lint:strict": "strict-lint",
+  test: `pnpm exec vitest ${GATE_PROJECTS}`,
+  "test:all": "pnpm exec vitest",
+  "test:coverage": `pnpm exec vitest ${GATE_PROJECTS} --coverage`,
+  "test:tool": "pnpm exec vitest --project tool",
+  "test:unit": "pnpm exec vitest --project unit",
+  "test:watch": `pnpm exec vitest ${GATE_PROJECTS} --watch`,
+  typecheck: "tsgo --noEmit",
+  // `--include-locked` is required rather than stylistic: a repo that pins exactly (pnpm's
+  // `savePrefix: ''`) has no dependency taze considers unlocked, so without it nothing is reported.
+  upgrade: "nmr-taze --include-locked",
+  "view-coverage": "open coverage/index.html"
+};
+var rootScripts = {
+  audit: ["audit:prod", "audit:dev"],
+  "audit:dev": "pnpm exec v11y --dev",
+  "audit:prod": "pnpm exec v11y --prod",
+  build: "pnpm --recursive exec nmr build",
+  check: ["typecheck", "fmt:check", "lint:check", "test"],
+  "check:agent-files": "nmr-sync-agent-files --check",
+  "check:strict": ["typecheck", "fmt:check", "lint:strict", "test:coverage", "check:agent-files"],
+  // Excludes the audit, which has a workflow of its own.
+  ci: ["build", "check:strict"],
+  clean: "nmr-clean",
+  fix: ["lint", "fmt"],
+  "fix:check": ["fmt:check", "lint:check"],
+  // Identical to the workspace entries: the bin scopes its own selection to the working directory, so
+  // neither registry needs the `sh -c '… "${@:-.}"' --` wrapper that gave the root form a default path.
+  fmt: "nmr-fmt --write",
+  "fmt:check": "nmr-fmt --check",
+  lint: "nmr root:lint && pnpm --recursive exec nmr lint",
+  "lint:check": "nmr root:lint:check && pnpm --recursive exec nmr lint:check",
+  "lint:strict": "nmr root:lint:strict && pnpm --recursive exec nmr lint:strict",
+  // Everything the remote runs: the code-quality gate plus the audit workflow.
+  prepush: ["ci", "audit"],
+  "report-overrides": "nmr-report-overrides",
+  "root:check": ["root:typecheck", "fmt:check", "root:lint:check", "root:test"],
+  "root:lint": "eslint --fix --ignore-pattern 'packages/**' .",
+  "root:lint:check": "eslint --ignore-pattern 'packages/**' .",
+  "root:lint:strict": "strict-lint --ignore-pattern 'packages/**' .",
+  "root:test": `vitest --config ./vitest.root.config.ts ${GATE_PROJECTS}`,
+  "root:test:all": "vitest --config ./vitest.root.config.ts",
+  "root:test:tool": "vitest --config ./vitest.root.config.ts --project tool",
+  "root:test:unit": "vitest --config ./vitest.root.config.ts --project unit",
+  "root:typecheck": "tsgo --noEmit",
+  "root:upgrade": "nmr-taze --include-locked",
+  "sync-agent-files": "nmr-sync-agent-files",
+  test: "nmr root:test && pnpm --recursive exec nmr test",
+  "test:all": "nmr root:test:all && pnpm --recursive exec nmr test:all",
+  // Chains `root:test`, not a `root:test:coverage`: the root config reports no coverage of its own.
+  "test:coverage": "nmr root:test && pnpm --recursive exec nmr test:coverage",
+  "test:tool": "nmr root:test:tool && pnpm --recursive exec nmr test:tool",
+  "test:unit": "nmr root:test:unit && pnpm --recursive exec nmr test:unit",
+  // Omitting `--config` is deliberate: bare `vitest` at the monorepo root resolves the root `vitest.config.ts`,
+  // covering the whole tree in one process. A chain like the others would never advance past its first watcher.
+  "test:watch": `vitest ${GATE_PROJECTS} --watch`,
+  typecheck: "nmr root:typecheck && pnpm --recursive exec nmr typecheck",
+  // A string rather than a composite because passthrough args attach to the chain's last command — as a
+  // composite, `nmr upgrade major` would hand `major` to the override report instead of the upgrade tool.
+  //
+  // Overrides print first, as context for the report that follows: a pinned transitive dependency is why
+  // an expected upgrade may be missing from it. taze handles pnpm workspaces natively, so this needs no
+  // `pnpm --recursive` fan-out: one process covers the root and every package.
+  upgrade: "nmr-report-overrides && nmr-taze --include-locked --recursive"
+};
+
+// src/resolve-scripts.ts
+function getDefaultRootScripts() {
+  return { ...rootScripts };
+}
+
+// src/tiers.ts
+import { readdirSync } from "node:fs";
+import path from "node:path";
+var TEST_DIR = "__tests__";
+var TEST_EXTENSIONS = "{ts,tsx}";
+var TEST_GLOB_PREFIX = `**/${TEST_DIR}/**`;
+var TEST_FILE_PATTERN = /\.test\.tsx?$/;
+var ALL_TEST_PATTERNS = [`${TEST_GLOB_PREFIX}/*.test.${TEST_EXTENSIONS}`];
+function findTestFiles(rootDir) {
+  const found = [];
+  collectTestFiles(rootDir, "", false, found);
+  return found.toSorted();
+}
+function hasTierInfix(filePath) {
+  const tiers = TIER_NAMES;
+  return tiers.includes(path.basename(filePath).split(".").at(-3) ?? "");
+}
+var TEST_COLLECTION_EXCLUDE = [".git", "coverage", "dist", "node_modules"];
+var TIER_NAMES = ["unit", "tool", "localhost", "remote"];
+function collectTestFiles(dir, relativeDir, inTestDir, found) {
+  const entries = readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const relativePath = relativeDir === "" ? entry.name : `${relativeDir}/${entry.name}`;
+    if (entry.isDirectory()) {
+      if (TEST_COLLECTION_EXCLUDE.includes(entry.name)) continue;
+      collectTestFiles(path.join(dir, entry.name), relativePath, inTestDir || entry.name === TEST_DIR, found);
+    } else if (inTestDir && TEST_FILE_PATTERN.test(entry.name)) {
+      found.push(relativePath);
+    }
+  }
+}
+
+// .readyup/kits/default.ts
+var default_default = defineRdyKit({
+  checklists: [
+    {
+      name: "nmr",
+      checks: [
+        // -- Setup ---------------------------------------------------------------
+        {
+          name: "@williamthorsen/nmr in devDependencies",
+          severity: "error",
+          check: () => hasDevDependency("@williamthorsen/nmr"),
+          fix: "pnpm add --save-dev @williamthorsen/nmr",
+          checks: [
+            {
+              get name() {
+                return `@williamthorsen/nmr >= ${getMinVersion()}`;
+              },
+              severity: "error",
+              check: () => hasMinDevDependencyVersion("@williamthorsen/nmr", getMinVersion(), {
+                exempt: (range) => range.startsWith("workspace:")
+              }),
+              get fix() {
+                return `pnpm add --save-dev @williamthorsen/nmr@^${getMinVersion()}`;
+              }
+            }
+          ]
+        },
+        {
+          name: "pnpm-workspace.yaml exists",
+          severity: "error",
+          check: () => fileExists("pnpm-workspace.yaml"),
+          fix: "Create pnpm-workspace.yaml with workspace package globs"
+        },
+        {
+          name: "package.json has packageManager field",
+          severity: "warn",
+          check: () => hasPackageJsonField("packageManager"),
+          fix: 'Add "packageManager" field to package.json (e.g., "pnpm@10.33.0")'
+        },
+        {
+          name: ".tool-versions does not list pnpm",
+          severity: "warn",
+          check: toolVersionsHasNoPnpm,
+          fix: "Remove pnpm from .tool-versions \u2014 manage via packageManager field and corepack"
+        },
+        {
+          name: ".config/nmr.config.ts uses defineConfig",
+          severity: "recommend",
+          skip: () => !fileExists(".config/nmr.config.ts") ? "no nmr config file" : false,
+          check: () => fileContains(".config/nmr.config.ts", /defineConfig/),
+          fix: "Wrap your config export with defineConfig() from @williamthorsen/nmr/config for type safety"
+        },
+        // -- Root script cleanup -------------------------------------------------
+        {
+          name: "root package.json has no nmr-provided scripts",
+          severity: "warn",
+          check: noRedundantRootScripts,
+          fix: "Remove scripts from root package.json that nmr provides as built-in root scripts \u2014 invoke via nmr directly"
+        },
+        {
+          name: "root:lint:strict does not use echo fallback",
+          severity: "warn",
+          skip: () => !scriptExists("root:lint:strict") ? "no root:lint:strict script" : false,
+          check: () => !scriptMatches("root:lint:strict", /\becho\b/),
+          fix: "Replace the echo fallback in root:lint:strict \u2014 strict-lint now supports path arguments"
+        },
+        // -- Workspace build readiness -------------------------------------------
+        {
+          name: "all workspace packages can build",
+          severity: "warn",
+          check: allWorkspacePackagesCanBuild,
+          fix: `Add "build": ":" to packages that don't need a build, or ensure packages that use the default nmr build have a tsconfig.json and a src/ directory`
+        },
+        // -- Vitest projects -----------------------------------------------------
+        {
+          name: "no retired Vitest config variants",
+          severity: "error",
+          check: () => noRetiredVitestConfigs(),
+          fix: "Delete every vitest.standalone.config.* and vitest.integration.config.*. nmr's test scripts select Vitest projects instead of naming config files"
+        },
+        {
+          name: "vitest.config.ts builds on @williamthorsen/nmr/vitest",
+          severity: "error",
+          check: () => vitestConfigBuildsOnSharedConfig(),
+          fix: "Replace vitest.config.ts with: import { defineVitestConfig } from '@williamthorsen/nmr/vitest'; export default defineVitestConfig();"
+        },
+        {
+          name: "vitest.root.config.ts builds on @williamthorsen/nmr/vitest",
+          severity: "error",
+          check: () => vitestRootConfigBuildsOnSharedConfig(),
+          fix: "Replace vitest.root.config.ts with: import { defineRootVitestConfig } from '@williamthorsen/nmr/vitest'; export default defineRootVitestConfig({ monorepoRoot: import.meta.dirname });"
+        },
+        {
+          name: "every test file names its isolation tier",
+          severity: "error",
+          check: () => everyTestFileNamesItsTier(),
+          fix: `Rename each to <subject>[.<aspect>].<tier>.test.ts, naming one of ${TIER_NAMES.join(", ")}. Use tool for a test that reaches a program the environment supplies, which is where a retired .int. or .integration. file belongs. Only the segment before .test. selects a project, so an untiered file runs under the residual unit project and reports success`
+        },
+        {
+          name: "no package re-exports the ancestor Vitest config",
+          severity: "recommend",
+          check: () => noReExportOnlyVitestConfigs(),
+          fix: "Delete these files. Vitest resolves config by walking up from the run root, so a per-package re-export is redundant"
+        },
+        // -- Shared Prettier config ----------------------------------------------
+        {
+          name: "Prettier config builds on @williamthorsen/nmr/prettier",
+          severity: "error",
+          check: () => prettierConfigBuildsOnSharedConfig(),
+          fix: "Replace the Prettier config with: import { definePrettierConfig } from '@williamthorsen/nmr/prettier'; export default definePrettierConfig();"
+        },
+        // -- Audit dependency --------------------------------------------------------
+        {
+          name: "v11y-check in devDependencies",
+          severity: "warn",
+          check: () => hasDevDependency("v11y-check"),
+          fix: "pnpm add --save-dev v11y-check"
+        },
+        {
+          name: "code-quality workflow does not use nmr prepush",
+          severity: "warn",
+          skip: () => !fileExists(".github/workflows/code-quality.yaml") ? "no code-quality workflow" : false,
+          check: codeQualityWorkflowDoesNotUseNmrPrepush,
+          fix: 'Change the check-command in .github/workflows/code-quality.yaml from "pnpm exec nmr prepush" to "pnpm exec nmr ci", which runs the same checks without the audit that audit.yaml already runs'
+        },
+        // -- Legacy script runner ------------------------------------------------
+        {
+          name: "scripts/run-workspace-script.ts does not exist",
+          severity: "error",
+          check: () => !fileExists("scripts/run-workspace-script.ts"),
+          fix: "Delete scripts/run-workspace-script.ts \u2014 nmr replaces this custom script runner"
+        },
+        {
+          name: 'no workspace packages reference run-workspace-script or "pnpm run ws"',
+          severity: "error",
+          check: noWorkspaceRunScriptReferences,
+          fix: 'Remove "ws" script entries and replace any "pnpm run ws" invocations with nmr in each packages/*/package.json'
+        }
+      ]
+    }
+  ]
+});
+var SCAN_EXCLUDE_DIRS = /* @__PURE__ */ new Set([".git", "coverage", "dist", "node_modules"]);
+var CONFIG_EXTENSIONS = "{ts,mts,cts,js,mjs,cjs}";
+var SHARED_VITEST_MODULE = "@williamthorsen/nmr/vitest";
+var SHARED_PRETTIER_MODULE = "@williamthorsen/nmr/prettier";
+var INERT_PRETTIER_CONFIGS = [".prettierrc", ".prettierrc.{json,json5,yaml,yml,toml}"];
+var RE_EXPORT_LINE_PATTERN = /^export\s*(?:\{\s*default\s*\}|\*)\s*from\s*['"]\.\.\/[^'"]*['"];?$/;
+function allWorkspacePackagesCanBuild() {
+  const packagesDir = join(process.cwd(), "packages");
+  if (!existsSync(packagesDir)) return true;
+  const entries = readdirSync2(packagesDir, { withFileTypes: true });
+  const failing = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const pkgPath = `packages/${entry.name}/package.json`;
+    const content = readFile(pkgPath);
+    if (!content) continue;
+    const hasBuildOverride = /"build"\s*:/.test(content);
+    const hasDefaultBuildInputs = fileExists(`packages/${entry.name}/tsconfig.json`) && existsSync(join(packagesDir, entry.name, "src"));
+    if (!hasBuildOverride && !hasDefaultBuildInputs) {
+      failing.push(entry.name);
+    }
+  }
+  if (failing.length === 0) return true;
+  return {
+    ok: false,
+    detail: `missing build override or tsconfig.json + src/: ${failing.join(", ")}`
+  };
+}
+function checkNoMatchingFiles(patterns, cwd) {
+  const found = findFiles(patterns, cwd);
+  if (found.length === 0) return true;
+  return { ok: false, detail: formatPaths(found) };
+}
+function checkRootVitestConfig(baseName, exportName, cwd) {
+  const matches = findFiles([`${baseName}.${CONFIG_EXTENSIONS}`], cwd);
+  if (matches.length === 0) {
+    return { ok: false, detail: `${baseName}.ts is missing` };
+  }
+  const stale = matches.filter(
+    (relativePath) => !importsSharedExport(readFileIn(cwd, relativePath), exportName, SHARED_VITEST_MODULE)
+  );
+  if (stale.length === 0) return true;
+  return { ok: false, detail: `does not import ${exportName} from ${SHARED_VITEST_MODULE}: ${stale.join(", ")}` };
+}
+function prettierConfigBuildsOnSharedConfig(cwd = process.cwd()) {
+  const configs = findFiles(
+    [`.prettierrc.${CONFIG_EXTENSIONS}`, `prettier.config.${CONFIG_EXTENSIONS}`],
+    //
+    cwd
+  );
+  if (configs.length === 0) {
+    return { ok: false, detail: describeMissingPrettierConfig(cwd) };
+  }
+  const stale = configs.filter(
+    (relativePath) => !importsSharedExport(readFileIn(cwd, relativePath), "definePrettierConfig", SHARED_PRETTIER_MODULE)
+  );
+  if (stale.length === 0) return true;
+  return {
+    ok: false,
+    detail: `does not import definePrettierConfig from ${SHARED_PRETTIER_MODULE}: ${stale.join(", ")}`
+  };
+}
+function describeMissingPrettierConfig(cwd) {
+  const inert = findFiles(INERT_PRETTIER_CONFIGS, cwd);
+  if (inert.length > 0) return `holds no code to call the factory: ${inert.join(", ")}`;
+  if (hasPrettierConfigKey(cwd)) {
+    return 'holds no code to call the factory: the "prettier" key in package.json';
+  }
+  return ".prettierrc.js is missing";
+}
+function hasPrettierConfigKey(cwd) {
+  const manifest = readFileIn(cwd, "package.json");
+  if (manifest === void 0) return false;
+  try {
+    const parsed = JSON.parse(manifest);
+    return isRecord(parsed) && parsed.prettier !== void 0;
+  } catch {
+    return false;
+  }
+}
+function codeQualityWorkflowDoesNotUseNmrPrepush() {
+  const content = readFile(".github/workflows/code-quality.yaml");
+  if (content === void 0) return true;
+  return !/check-command:\s*pnpm exec nmr prepush(\s|$)/.test(content);
+}
+function everyTestFileNamesItsTier(cwd = process.cwd()) {
+  const untiered = findTestFiles(cwd).filter((path2) => !hasTierInfix(path2));
+  if (untiered.length === 0) return true;
+  return { ok: false, detail: formatPaths(untiered) };
+}
+function findFiles(patterns, cwd) {
+  return globSync(patterns, { cwd, exclude: (path2) => SCAN_EXCLUDE_DIRS.has(basename(path2)) }).map((path2) => path2.split(sep).join("/")).toSorted();
+}
+function formatPaths(paths) {
+  return `${paths.length} found:
+${paths.map((path2) => `      ${path2}`).join("\n")}`;
+}
+function getMinVersion() {
+  const picked = { "version": "0.25.0" };
+  if (typeof picked.version !== "string") {
+    throw new TypeError("nmr/package.json: 'version' must be a string");
+  }
+  return picked.version;
+}
+function importsSharedExport(content, exportName, moduleSpecifier) {
+  if (content === void 0) return false;
+  const pattern = new RegExp(String.raw`import\s*\{[^}]*\b${exportName}\b[^}]*\}\s*from\s*['"]${moduleSpecifier}['"]`);
+  return pattern.test(content);
+}
+function isReExportOnly(content) {
+  if (content === void 0) return false;
+  const statements = content.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "").split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
+  return statements.length > 0 && statements.every((line) => RE_EXPORT_LINE_PATTERN.test(line));
+}
+function noReExportOnlyVitestConfigs(cwd = process.cwd()) {
+  const nonRootConfigs = findFiles([`**/vitest.config.${CONFIG_EXTENSIONS}`], cwd).filter((path2) => path2.includes("/"));
+  const reExports = nonRootConfigs.filter((path2) => isReExportOnly(readFileIn(cwd, path2)));
+  if (reExports.length === 0) return true;
+  return { ok: false, detail: formatPaths(reExports) };
+}
+function noRedundantRootScripts() {
+  const pkg = readPackageJson();
+  if (!pkg) return true;
+  const scripts = pkg.scripts;
+  if (!isRecord(scripts)) return true;
+  const builtInNames = Object.keys(getDefaultRootScripts());
+  const redundant = Object.keys(scripts).filter((name) => builtInNames.includes(name));
+  if (redundant.length === 0) return true;
+  return {
+    ok: false,
+    detail: `redundant: ${redundant.join(", ")}`
+  };
+}
+function noRetiredVitestConfigs(cwd = process.cwd()) {
+  return checkNoMatchingFiles(
+    [`**/vitest.standalone.config.${CONFIG_EXTENSIONS}`, `**/vitest.integration.config.${CONFIG_EXTENSIONS}`],
+    cwd
+  );
+}
+function noWorkspaceRunScriptReferences() {
+  const packagesDir = join(process.cwd(), "packages");
+  if (!existsSync(packagesDir)) return true;
+  const legacyPattern = /run-workspace-script|"pnpm\s+run\s+ws\b/;
+  const entries = readdirSync2(packagesDir, { withFileTypes: true });
+  const matches = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const content = readFile(`packages/${entry.name}/package.json`);
+    if (content && legacyPattern.test(content)) {
+      matches.push(entry.name);
+    }
+  }
+  if (matches.length === 0) return true;
+  return {
+    ok: false,
+    detail: `found in: ${matches.join(", ")}`
+  };
+}
+function readFileIn(cwd, relativePath) {
+  try {
+    return readFileSync(join(cwd, relativePath), "utf8");
+  } catch {
+    return void 0;
+  }
+}
+function scriptExists(name) {
+  const pkg = readPackageJson();
+  if (!pkg) return false;
+  const scripts = pkg.scripts;
+  return isRecord(scripts) && name in scripts;
+}
+function scriptMatches(name, pattern) {
+  const pkg = readPackageJson();
+  if (!pkg) return false;
+  const scripts = pkg.scripts;
+  if (!isRecord(scripts)) return false;
+  const value = scripts[name];
+  return typeof value === "string" && pattern.test(value);
+}
+function toolVersionsHasNoPnpm() {
+  const content = readFile(".tool-versions");
+  if (content === void 0) return true;
+  return !/^pnpm\s/m.test(content);
+}
+function vitestConfigBuildsOnSharedConfig(cwd = process.cwd()) {
+  return checkRootVitestConfig("vitest.config", "defineVitestConfig", cwd);
+}
+function vitestRootConfigBuildsOnSharedConfig(cwd = process.cwd()) {
+  return checkRootVitestConfig("vitest.root.config", "defineRootVitestConfig", cwd);
+}
+export {
+  codeQualityWorkflowDoesNotUseNmrPrepush,
+  default_default as default,
+  everyTestFileNamesItsTier,
+  noReExportOnlyVitestConfigs,
+  noRetiredVitestConfigs,
+  prettierConfigBuildsOnSharedConfig,
+  vitestConfigBuildsOnSharedConfig,
+  vitestRootConfigBuildsOnSharedConfig
+};

package/.readyup/manifest.json

@@ -0,0 +1,16 @@
+{
+  "version": 1,
+  "kits": [
+    {
+      "checklists": [
+        "nmr"
+      ],
+      "name": "default",
+      "path": "kits/default.js",
+      "readyupVersion": "0.23.0",
+      "source": "kits/default.ts",
+      "sourceHash": "f646e7fb",
+      "targetHash": "514c9b6f"
+    }
+  ]
+}

package/README.md

@@ -3,47 +3,20 @@
 Context-aware script runner for pnpm monorepos. Ships 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.24.0 (2026-08-03)
+## Release notes — v0.25.0 (2026-08-03)
 
 ### 🎉 Features
 
-- 🚨 **Breaking:** Retire integration label in favor of an isolation-tier test ladder (#552)
+- Mark a cache hit's time saving with a speed-boost icon (#579)
 
-  Test groups are now named for what a test reaches rather than for how much of the codebase it covers: `integration` and `app` are replaced by `unit`, `tool`, `localhost`, and `remote`.
+  Time saved due to `nmr`'s cache feature now earns a rocket emoji in the terminal output.
+  Savings less than 1 second are no longer reported.
 
-  `nmr test` now runs the `tool` group alongside `unit`, so the first run after upgrading may fail on tests that nothing was running before. Upgrading means renaming `*.int.test.ts` files onto the new groups and replacing `nmr test:integration` with `nmr test:tool`.
+- Publish nmr's readyup kit with a test-tier conformance check (#580)
 
-- Let Vitest config files compose shared options and target one tier (#556)
+  `@williamthorsen/nmr` is now bundled with ReadyUp kits that check a repo's alignment with `nmr` requirements and recommendations.
 
-  Vitest settings can now be shared across config files: A repo declares its common options once, and a workspace can use its own config file to supplement or override them. Shared setup files run first. An option can now target a single test tier instead of all tiers, allowing per-tier timeouts to be set.
-
-- 🚨 **Breaking:** Redefine ci as the code-quality gate and add prepush (#559)
-
-  Repurposes the `nmr ci` command to align with its name; it now runs the code-quality checks that run in CI: `nmr build && nmr check:strict`. A new `nmr prepush` command, combining code-quality checks and the security audit, takes the place of `nmr ci`. nmr's readyup kit is adjusted to account for the changes.
-
-- Exclude test scaffolding from builds and make the ignore set configurable (#564)
-
-  The `build` command now ignores the directories typically used for test scaffolding, such as fixtures and mocks. The exclusion includes `test-utils/`, which is treated as the conventional name for a directory containing test utilities. A package can declare additional ignore patterns in its config file.
-
-- Skip checks that already passed on the current working tree (#568)
-
-  `nmr` commands now skip any pure check (types, lint, tests) that has already passed on an unchanged working tree; instead, success is reported immediately. `nmr --no-cache` causes the cache check to be skipped, and `NMR_NO_CACHE=1` does the same for a whole shell. Cached results are cleared by `nmr clean`. Which commands can skip is configurable at the monorepo root, and `NMR_DEBUG=1` reports why a run didn't skip.
-
-### 🪦 Removed
-
-- 🚨 **Breaking:** Remove the package root entry in favor of /config (#569)
-
-  `defineConfig` is now imported from `@williamthorsen/nmr/config` instead of the bare package.
-
-### 🐛 Bug fixes
-
-- Stop excluding *.types.ts and mock* files from coverage
-
-  Coverage now measures modules matching `*.types.ts` and `mock*`, which the shared Vitest config previously excluded. A type module that grows a type guard, or a mock helper placed in `test-utils/` where helpers are meant to stay measured, was left out of the report with nothing saying so, and because exclusions concatenate, no consuming repo could add it back.
-
-  What remains excluded names something that cannot hold runtime code by construction: a directory of test scaffolding, a barrel, and a declaration file. A pattern resting on a filename alone suppresses nothing it could claim to, since a file with no executable statements is absent from the report either way.
-
-  A repo enforcing its own coverage thresholds may see a lower figure once these files enter the denominator.
+  `rdy run --from npm:@williamthorsen/nmr` checks the repo against the kits without prior configuration. Once the package is added to the ReadyUp config, `rdy run --packages` will run the `nmr` kits along with those of any other registered package. Requires `readyup` v0.23 or greater.
 <!-- /section:release-notes -->
 
 ## Installation
@@ -255,7 +228,7 @@ $ nmr ci
 # ... four minutes of build, typecheck, lint, and coverage ...
 
 $ nmr ci
-⏭️ ci: passed 2m ago on this tree (saved ~4m). Re-run with --no-cache.
+⏭️ ci: passed 2m ago on this tree (🚀 saved ~4m). Re-run with --no-cache.
 ```
 
 Composite commands expand into child `nmr` processes, so one green `nmr ci` records a pass for every cacheable command in the chain, at every scope it ran at. A later `nmr check`, `nmr typecheck`, or `nmr -F core test` on the same tree skips too. The skip line is suppressed by `-q`.
@@ -707,6 +680,29 @@ ensure-prepublish-hooks
 | `--dry-run`           | Preview what `--fix` would do | —                 |
 | `--command <command>` | Custom hook command           | `"npm run build"` |
 
+## Conformance checks
+
+nmr publishes a `readyup` kit that checks a consuming repo against the current release: the shared Vitest and Prettier configs, the workspace layout, the root script registry, and the [test-tier convention](#test-tiers). The kit ships inside the package, so it checks against the nmr version installed rather than whatever a repository ref happens to point at, and a tier added or renamed in nmr reaches the repo on upgrade.
+
+Add `readyup` as a devDependency, then name nmr in its config:
+
+```ts
+// .config/readyup.config.ts
+import { defineRdyConfig } from 'readyup';
+
+export default defineRdyConfig({
+  packages: ['@williamthorsen/nmr'],
+});
+```
+
+```bash
+rdy run --packages                       # every kit each listed package publishes
+rdy run --from npm:@williamthorsen/nmr   # nmr's kit alone, without the config entry
+rdy list --from npm:@williamthorsen/nmr  # what nmr publishes
+```
+
+`--packages` is the form that survives nmr publishing further kits. Both need `readyup` 0.23 or later, and `@williamthorsen/nmr` as a _direct_ devDependency: a strict pnpm layout links nothing else into the project, so a transitive copy is unreachable.
+
 ## Consumer migration
 
 After installing, a consuming repo's root `package.json` scripts shrink to lifecycle hooks:
@@ -833,7 +829,9 @@ vitest                               # every project
 
 **A tier is not a statement about preconditions.** A `unit` test may still need something set up before it runs: a build, a generated fixture, a seeded file. What makes it `unit` is that it reaches nothing beyond the test process _while running_. The filesystem sits in `unit` for the same reason the tiers exist: they gate on what must be available, and the filesystem always is.
 
-`unit` is defined by subtracting the tiers rather than by an allow-list of infixes, so a file such as `parser.smoke.test.ts` runs under `unit` instead of being silently dropped. That is also what makes an unrecognized infix safe to use as documentation: `resolveConfig.packaged.test.ts` runs under `unit` and reads as a companion to `resolveConfig.unit.test.ts`.
+**Every test file names its tier**, in the form `<subject>[.<aspect>].<tier>.test.ts`. Only the segment immediately before `.test.` selects a project, so an earlier one is free for documentation: `resolveConfig.packaged.unit.test.ts` reads as a companion to `resolveConfig.unit.test.ts` and still names `unit`.
+
+`unit` is defined by subtracting the tiers rather than by an allow-list of infixes, so a file such as `parser.smoke.test.ts` runs under `unit` instead of being silently dropped. That is a safety net, not a licence to omit the tier: a file whose tier segment is missing or misspelt runs under `unit` and reports success, so no test run distinguishes it from a conformant one. [nmr's readyup kit](#conformance-checks) reports those files, which is the only thing that does.
 
 `localhost` and `remote` have no test script of their own. They are declared anyway, so that a `*.remote.test.ts` file cannot fall into `unit` and run in the default gate unnoticed.
 
@@ -934,11 +932,11 @@ This variant reads `pnpm-workspace.yaml` and excludes every workspace package fr
 
 The projects were once named `unit`, `integration`, and `app`, for what a test _covered_ rather than what it _reached_. `integration` and `app` are gone.
 
-1. Rename every `*.int.test.ts`. A test that reaches a program the environment supplies becomes `*.tool.test.ts`; one that reaches nothing beyond the test process drops the infix. Re-read each file rather than renaming in bulk -- the axis changed, so the old bucket does not map onto one new tier.
-2. Leave `*.app.test.ts` alone, or rename at your leisure. `app` was never a tier, and its files now land in `unit`.
+1. Rename every `*.int.test.ts`. A test that reaches a program the environment supplies becomes `*.tool.test.ts`; one that reaches nothing beyond the test process becomes `*.unit.test.ts`. Re-read each file rather than renaming in bulk -- the axis changed, so the old bucket does not map onto one new tier.
+2. Rename every `*.app.test.ts` onto the convention. `app` was never a tier, so keep it as the aspect segment and add the tier after it: `scaffold.app.test.ts` becomes `scaffold.app.unit.test.ts`.
 3. Replace `nmr test:integration` with `nmr test:tool`, and `nmr root:test:integration` with `nmr root:test:tool`, wherever a script or workflow names them.
 
-**An unrenamed `*.int.test.ts` file is a silent failure.** `.int.` no longer matches a project, so the residual `unit` claims those files and they run in the default gate -- green, with nothing reporting that the separation was lost. `rdy run nmr` reports them; a passing test run does not. Run it before treating the migration as done.
+**A file left without a tier is a silent failure.** The residual `unit` claims it and it runs in the default gate -- green, with nothing reporting that the separation was lost. [nmr's readyup kit](#conformance-checks) reports every such file; a passing test run does not. Run it before treating the migration as done.
 
 `nmr test` also runs the `tool` tier, which the old `test` excluded. Those tests previously ran in no default selection at all: `check`, `check:strict`, and `ci` all inherited the exclusion, so a green pipeline said nothing about them. Expect `nmr test` to take longer and to surface failures that were never gated.
 

package/dist/esm/check-cache.js

@@ -5,6 +5,7 @@ import process from 'node:process';
 import { hashWorkingTree, readHeadSha, readJsonCacheEntry, removeCacheDir, resolveCacheEntryPath, writeCacheEntry, } from '@williamthorsen/nmr-core';
 import { hasBuildOutput, readBuildDigest } from "./commands/build-output.js";
 import { loadWorkspaceConfig } from "./config.js";
+import { formatDuration, formatSaving } from "./helpers/duration.js";
 import { isObject, isStringRecord } from "./helpers/type-guards.js";
 import { getDefaultWorkspaceScripts } from "./resolve-scripts.js";
 import { buildWorkspaceRegistry, resolveScript } from "./resolver.js";
@@ -91,8 +92,9 @@ export function formatMisplacedNoCacheWarning(command) {
 }
 export function formatSkipLine(command, entry, now) {
     const age = formatDuration(Math.max(0, now - Date.parse(entry.recordedAt)));
-    const saved = formatDuration(entry.durationMs);
-    return `⏭️ ${command}: passed ${age} ago on this tree (saved ~${saved}). Re-run with --no-cache.`;
+    const saving = formatSaving(entry.durationMs);
+    const savingClause = saving === undefined ? '' : ` (${saving})`;
+    return `⏭️ ${command}: passed ${age} ago on this tree${savingClause}. Re-run with --no-cache.`;
 }
 export async function readBuildOutputState(monorepoRoot, config) {
     const state = { missing: [], digests: {} };
@@ -165,9 +167,6 @@ export function writeDebugNote(message, env, stderr) {
         stderr.write(`nmr check-cache: ${message}\n`);
     }
 }
-const MILLISECONDS_PER_SECOND = 1000;
-const SECONDS_PER_MINUTE = 60;
-const MINUTES_PER_HOUR = 60;
 function decodeTreeSnapshot(encoded) {
     if (encoded === undefined) {
         return undefined;
@@ -178,17 +177,6 @@ function decodeTreeSnapshot(encoded) {
     }
     return { hash, headSha };
 }
-function formatDuration(milliseconds) {
-    const seconds = Math.round(milliseconds / MILLISECONDS_PER_SECOND);
-    if (seconds < SECONDS_PER_MINUTE) {
-        return `${seconds}s`;
-    }
-    const minutes = Math.round(seconds / SECONDS_PER_MINUTE);
-    if (minutes < MINUTES_PER_HOUR) {
-        return `${minutes}m`;
-    }
-    return `${Math.round(minutes / MINUTES_PER_HOUR)}h`;
-}
 function isCheckCacheEntry(value) {
     if (!isObject(value)) {
         return false;

package/dist/esm/helpers/duration.d.ts

@@ -0,0 +1,2 @@
+export declare function formatDuration(milliseconds: number): string;
+export declare function formatSaving(milliseconds: number): string | undefined;

package/dist/esm/helpers/duration.js

@@ -0,0 +1,21 @@
+export function formatDuration(milliseconds) {
+    const seconds = Math.round(milliseconds / MILLISECONDS_PER_SECOND);
+    if (seconds < SECONDS_PER_MINUTE) {
+        return `${seconds}s`;
+    }
+    const minutes = Math.round(seconds / SECONDS_PER_MINUTE);
+    if (minutes < MINUTES_PER_HOUR) {
+        return `${minutes}m`;
+    }
+    return `${Math.round(minutes / MINUTES_PER_HOUR)}h`;
+}
+export function formatSaving(milliseconds) {
+    if (!Number.isFinite(milliseconds) || milliseconds < MILLISECONDS_PER_SECOND) {
+        return undefined;
+    }
+    return `${SPEED_BOOST_ICON} saved ~${formatDuration(milliseconds)}`;
+}
+const MILLISECONDS_PER_SECOND = 1000;
+const MINUTES_PER_HOUR = 60;
+const SECONDS_PER_MINUTE = 60;
+const SPEED_BOOST_ICON = '🚀';

package/dist/esm/tiers.d.ts

@@ -0,0 +1,7 @@
+export declare const ALL_TEST_PATTERNS: string[];
+export declare function buildTierPatterns(tier: string): string[];
+export declare function findTestFiles(rootDir: string): string[];
+export declare function hasTierInfix(filePath: string): boolean;
+export declare const TEST_COLLECTION_EXCLUDE: string[];
+export declare const TIER_NAMES: readonly ["unit", "tool", "localhost", "remote"];
+export type TierName = (typeof TIER_NAMES)[number];

package/dist/esm/tiers.js

@@ -0,0 +1,35 @@
+import { readdirSync } from 'node:fs';
+import path from 'node:path';
+const TEST_DIR = '__tests__';
+const TEST_EXTENSIONS = '{ts,tsx}';
+const TEST_GLOB_PREFIX = `**/${TEST_DIR}/**`;
+const TEST_FILE_PATTERN = /\.test\.tsx?$/;
+export const ALL_TEST_PATTERNS = [`${TEST_GLOB_PREFIX}/*.test.${TEST_EXTENSIONS}`];
+export function buildTierPatterns(tier) {
+    return [`${TEST_GLOB_PREFIX}/*.${tier}.test.${TEST_EXTENSIONS}`];
+}
+export function findTestFiles(rootDir) {
+    const found = [];
+    collectTestFiles(rootDir, '', false, found);
+    return found.toSorted();
+}
+export function hasTierInfix(filePath) {
+    const tiers = TIER_NAMES;
+    return tiers.includes(path.basename(filePath).split('.').at(-3) ?? '');
+}
+export const TEST_COLLECTION_EXCLUDE = ['.git', 'coverage', 'dist', 'node_modules'];
+export const TIER_NAMES = ['unit', 'tool', 'localhost', 'remote'];
+function collectTestFiles(dir, relativeDir, inTestDir, found) {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const relativePath = relativeDir === '' ? entry.name : `${relativeDir}/${entry.name}`;
+        if (entry.isDirectory()) {
+            if (TEST_COLLECTION_EXCLUDE.includes(entry.name))
+                continue;
+            collectTestFiles(path.join(dir, entry.name), relativePath, inTestDir || entry.name === TEST_DIR, found);
+        }
+        else if (inTestDir && TEST_FILE_PATTERN.test(entry.name)) {
+            found.push(relativePath);
+        }
+    }
+}

package/dist/esm/vitest.d.ts

@@ -1,5 +1,7 @@
 import type { ViteUserConfig } from 'vitest/config';
 import type { InlineConfig, ProjectConfig } from 'vitest/node';
+import type { TierName } from './tiers.js';
+export type { TierName } from './tiers.js';
 export type RootTestOptions = Omit<InlineConfig, keyof ProjectConfig>;
 export type RootOverrides = Omit<ViteUserConfig, 'test'> & {
     test?: RootTestOptions;
@@ -13,8 +15,5 @@ export interface RootVitestConfigOptions extends VitestConfigOptions {
     monorepoRoot: string;
 }
 type RootConfigLayers = [...(VitestConfigOptions | undefined)[], RootVitestConfigOptions];
-declare const TIER_NAMES: readonly ["unit", "tool", "localhost", "remote"];
-export type TierName = (typeof TIER_NAMES)[number];
 export declare function defineVitestConfig(...layers: (VitestConfigOptions | undefined)[]): ViteUserConfig;
 export declare function defineRootVitestConfig(...layers: RootConfigLayers): ViteUserConfig;
-export {};

package/dist/esm/vitest.js

@@ -1,14 +1,13 @@
 import path from 'node:path';
 import { defaultExclude, mergeConfig } from 'vitest/config';
 import { isObject } from "./helpers/type-guards.js";
+import { ALL_TEST_PATTERNS, buildTierPatterns, TEST_COLLECTION_EXCLUDE, TIER_NAMES } from "./tiers.js";
 import { getWorkspacePackageDirs } from "./workspace.js";
-const TIER_NAMES = ['unit', 'tool', 'localhost', 'remote'];
 const [RESIDUAL_TIER, ...NAMED_TIERS] = TIER_NAMES;
 const TIERED_PATTERNS = NAMED_TIERS.flatMap(buildTierPatterns);
 const TIER_TIMEOUT = 30_000;
-const ALL_TEST_PATTERNS = ['**/__tests__/**/*.test.{ts,tsx}'];
 const COVERAGE_EXCLUDE = ['**/__{fixtures,mocks,tests}__/**', '**/index.ts', '**/*.d.ts'];
-const BUILD_OUTPUT_EXCLUDE = ['**/dist/**'];
+const COLLECTION_EXCLUDE = [...new Set([...defaultExclude, ...TEST_COLLECTION_EXCLUDE.map((dir) => `**/${dir}/**`)])];
 const PACKAGE_COVERAGE_INCLUDE = ['**/src/**/*.{ts,tsx}'];
 const MISSING_MONOREPO_ROOT = 'defineRootVitestConfig requires `monorepoRoot`, an absolute path to the directory holding pnpm-workspace.yaml. Pass `import.meta.dirname` in the last options layer, from the root config.';
 export function defineVitestConfig(...layers) {
@@ -60,7 +59,7 @@ function buildProjects(layers, extraExclude, projectRoot) {
             extends: true,
             ...(projectRoot !== undefined && { root: projectRoot }),
             test: {
-                exclude: [...defaultExclude, ...BUILD_OUTPUT_EXCLUDE, ...exclude, ...extraExclude],
+                exclude: [...COLLECTION_EXCLUDE, ...exclude, ...extraExclude],
                 include,
                 name,
                 ...(timeout !== undefined && { hookTimeout: timeout, testTimeout: timeout }),
@@ -84,9 +83,6 @@ function assertKnownTiers(layers) {
         }
     }
 }
-function buildTierPatterns(tier) {
-    return [`**/__tests__/**/*.${tier}.test.{ts,tsx}`];
-}
 function getWorkspaceExcludePatterns(monorepoRoot) {
     return getWorkspacePackageDirs(monorepoRoot)
         .map((dir) => `${path.relative(monorepoRoot, dir).split(path.sep).join('/')}/**`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/nmr",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "private": false,
   "description": "Context-aware script runner for pnpm monorepos",
   "keywords": [
@@ -58,6 +58,8 @@
     "nmr-taze": "bin/nmr-taze.js"
   },
   "files": [
+    ".readyup/kits/*.js",
+    ".readyup/manifest.json",
     "AGENTS.md",
     "bin",
     "dist"
@@ -67,10 +69,11 @@
     "prettier-plugin-sh": "0.19.0",
     "taze": "19.16.0",
     "yaml": "2.9.0",
-    "@williamthorsen/nmr-core": "0.8.0"
+    "@williamthorsen/nmr-core": "0.9.0"
   },
   "devDependencies": {
     "prettier": "3.9.6",
+    "readyup": "0.23.0",
     "tinyglobby": "0.2.17",
     "vitest": "4.1.10"
   },
@@ -94,6 +97,6 @@
     "access": "public"
   },
   "scripts": {
-    "build:post": "nmr-sync-agent-files"
+    "build:post": "nmr-sync-agent-files && rdy compile"
   }
 }