@williamthorsen/release-kit 10.3.2 → 10.4.0

package/.readyup/kits/default.js

@@ -1,6 +1,6 @@
 /** @noformat — @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.27.0";
+export const __readyupVersion = "0.28.0";
 
 
 // .readyup/kits/default.ts
@@ -52,7 +52,7 @@ function detectRepoType() {
 
 // .readyup/kits/default.ts
 function getMinVersion() {
-  const picked = { "version": "10.3.2" };
+  const picked = { "version": "10.4.0" };
   if (typeof picked["version"] !== "string") {
     throw new TypeError("release-kit/package.json: 'version' must be a string");
   }

package/.readyup/kits/npm-auto-publish.js

@@ -1,6 +1,6 @@
 /** @noformat — @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.27.0";
+export const __readyupVersion = "0.28.0";
 
 
 // .readyup/kits/npm-auto-publish.ts

package/.readyup/manifest.json

@@ -5,24 +5,63 @@
       "checklists": [
         "release-kit"
       ],
+      "esbuildVersion": "0.28.1",
+      "inputs": [
+        {
+          "hash": "fe239d01",
+          "kind": "module",
+          "path": "kits/default.ts"
+        },
+        {
+          "hash": "07509c48",
+          "kind": "inline",
+          "path": "../package.json",
+          "paths": [
+            "version"
+          ]
+        },
+        {
+          "hash": "850b703f",
+          "kind": "module",
+          "path": "../src/init/detectRepoType.ts"
+        },
+        {
+          "hash": "b6873aba",
+          "kind": "module",
+          "path": "../src/init/parseJsonRecord.ts"
+        },
+        {
+          "hash": "646fe51b",
+          "kind": "module",
+          "path": "../src/typeGuards.ts"
+        }
+      ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.27.0",
+      "readyupVersion": "0.28.0",
       "source": "kits/default.ts",
       "sourceHash": "fe239d01",
-      "targetHash": "6b363809"
+      "targetHash": "5413984b"
     },
     {
       "checklists": [
         "repo",
         "packages"
       ],
+      "esbuildVersion": "0.28.1",
+      "inputs": [
+        {
+          "hash": "ac484613",
+          "kind": "module",
+          "path": "kits/npm-auto-publish.ts"
+        }
+      ],
       "name": "npm-auto-publish",
       "path": "kits/npm-auto-publish.js",
-      "readyupVersion": "0.27.0",
+      "readyupVersion": "0.28.0",
       "source": "kits/npm-auto-publish.ts",
       "sourceHash": "ac484613",
-      "targetHash": "2e324215"
+      "targetHash": "0636c995"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 All notable changes to this project will be documented in this file.
 
+## 10.4.0 — 2026-08-17
+
+### 🎉 Features
+
+- Let a project release cover repo-root paths (#685)
+
+  Extends `release-kit`'s project release to a repo whose content lives at the root. Such a repo declares `project: { paths: ['**'] }` and gets the root `CHANGELOG.md`, the root `.meta/changelog.json`, the `--with-release-notes` previews under root `docs/`, the root `package.json` bump, and the project tag that the stage produces.
+
+  `paths` scopes any project release's window, not only the whole-tree case, and the project tier of `release-kit validate-overrides` with it. A declared value replaces the workspace union rather than extending it; omitting `paths` resolves to that union, so existing consumers see no change.
+
+### ♻️ Refactoring
+
+- Adopt silenceConsole across the test suites (#677)
+
+  Adopts `silenceConsole` from `@williamthorsen/toolbelt.vitest` to replace all hand-rolled `vi.spyOn(console, …)` spies and reduce boilerplate across the repo's test suites. The function returns a disposable, allowing the caller to use `using` to enable restoration of the console method at the end of the test scope.
+
+- Adopt `isError` and consolidate errno narrowing on a shared helper (#697)
+
+  Replaces every hand-rolled `instanceof Error` narrowing with `hasErrnoCode`, a new predicate exported from `@williamthorsen/nmr-core`, or with `isError` from `@williamthorsen/toolbelt.errors`. Previously the errno question was answered by inline copies alongside two private helpers of differing shape; both helpers are removed.
+
+  Separately, `eslint.config.ts` now bans `instanceof Error` in every position rather than in a ternary alone.
+
+### 🧪 Tests
+
+- Replace the stdio spies with captureStdio (#678)
+
+  Replaces every `process.stdout` and `process.stderr` spy in the test suites with `captureStdio` from `@williamthorsen/toolbelt.testing` and deletes the obviated local capture helpers. `captureStdio` buffers writes rather than recording calls, so assertions that previously used `toHaveBeenCalledWith` instead check `stderr`/`stdout` strings and their chunk arrays.
+
+  Separately, `unicorn/no-nonstandard-builtin-properties` is off for test files. Its hand-maintained symbol table omits `Symbol.dispose`, which a suite-scoped capture calls to restore the streams, and `schema: []` offers no way to extend the table.
+
+- Adopt throwOnProcessExit and captureError across the test suites (#690)
+
+  Adopts `throwOnProcessExit` from `@williamthorsen/toolbelt.vitest`, replacing every hand-rolled `process.exit` mock in the `release-kit` and `nmr-core` test suites, and `captureError` from `@williamthorsen/toolbelt.testing`, replacing inline try/catch/`instanceof` blocks.
+
+  Separately, `@williamthorsen/toolbelt.vitest` is now listed in the ReadyUp config, so that its kit is run by `rdy run --packages`.
+
 ## 10.3.2 — 2026-08-13
 
 ### ♻️ Refactoring

package/README.md

@@ -4,7 +4,17 @@ Version-bumping and changelog-generation toolkit for release workflows.
 
 Provides a self-contained CLI that auto-discovers workspaces from `pnpm-workspace.yaml`, parses conventional commits, determines version bumps, updates `package.json` files, and generates changelogs from `git-cliff --context` output rendered in-process (with optional [editorial overrides](#editorial-overrides)).
 
-<!-- section:release-notes --><!-- /section:release-notes -->
+<!-- section:release-notes -->
+## Release notes — v10.4.0 (2026-08-17)
+
+### 🎉 Features
+
+- Let a project release cover repo-root paths (#685)
+
+  Extends `release-kit`'s project release to a repo whose content lives at the root. Such a repo declares `project: { paths: ['**'] }` and gets the root `CHANGELOG.md`, the root `.meta/changelog.json`, the `--with-release-notes` previews under root `docs/`, the root `package.json` bump, and the project tag that the stage produces.
+
+  `paths` scopes any project release's window, not only the whole-tree case, and the project tier of `release-kit validate-overrides` with it. A declared value replaces the workspace union rather than extending it; omitting `paths` resolves to that union, so existing consumers see no change.
+<!-- /section:release-notes -->
 
 ## Installation
 
@@ -201,33 +211,50 @@ export default config;
 
 When configured, each `release-kit prepare` run additionally:
 
-- Computes commits since the last project tag (`<tagPrefix><version>`), filtered to the union of every contributing workspace's paths.
+- Computes commits since the last project tag (`<tagPrefix><version>`), filtered to `paths` (by default, the union of every contributing workspace's paths).
 - Bumps the root `package.json`'s `version` field using the same bump-derivation rules as workspaces (or the `--bump=...` override).
-- Regenerates the root `./CHANGELOG.md` from the structured `ChangelogEntry[]` produced by `git-cliff --context` (scoped to the project's `tagPrefix` and contributing paths) and any matching editorial overrides.
+- Regenerates the root `./CHANGELOG.md` from the structured `ChangelogEntry[]` produced by `git-cliff --context` (scoped to the project's `tagPrefix` and the same `paths`) and any matching editorial overrides.
 - Emits `./.meta/changelog.json` (when `changelogJson.enabled`).
 - With `--with-release-notes`, additionally emits `./docs/RELEASE_NOTES.v<version>.md`.
 - Appends the project tag to `tmp/.release-tags` so `release-kit commit` and `release-kit tag` pick it up alongside per-workspace tags.
 
-If no contributing workspace has commits since the last project tag, the project release is silently skipped — same behavior as a per-workspace skip.
+If no commit under `paths` has landed since the last project tag, the project release is silently skipped — same behavior as a per-workspace skip.
 
 #### `ProjectConfig`
 
 ```typescript
 interface ProjectConfig {
+  paths?: string[]; // Defaults to the union of every contributing workspace's paths
   tagPrefix?: string; // Defaults to 'v'
 }
 ```
 
-| Field       | Default | Description                                                          |
-| ----------- | ------- | -------------------------------------------------------------------- |
-| `tagPrefix` | `'v'`   | Prefix for project tags. The full tag is `${tagPrefix}${newVersion}` |
+| Field       | Default                 | Description                                                          |
+| ----------- | ----------------------- | -------------------------------------------------------------------- |
+| `paths`     | Contributing-path union | Patterns selecting the commits the project release considers         |
+| `tagPrefix` | `'v'`                   | Prefix for project tags. The full tag is `${tagPrefix}${newVersion}` |
+
+By default the contributing workspaces are implicit: every non-excluded discovered workspace contributes its `<dir>/**` glob, and the project release considers commits under their union.
+
+Declare `paths` to choose the window yourself. Each entry reaches two matchers: `git log` as a pathspec, and `git-cliff --include-path` as a glob. A declared value **replaces** the workspace union rather than extending it: `paths: ['docs/**']` drops every workspace commit from the project release.
+
+A repo whose content lives at the root — where no commit matches any `<dir>/**` glob, so the project release would skip every run — declares the whole tree:
+
+```typescript
+const config: ReleaseKitConfig = {
+  project: { paths: ['**'] },
+};
+```
+
+`'**'` is the whole-tree pattern, matching root-level files, dotfiles, and nested paths alike.
 
-Contributing workspaces are implicit: every non-excluded discovered workspace contributes. There is no field to override the contributing set in this initial release; if a future consumer needs to release a workspace as a component but exclude it from the project release, that override can be added then.
+Terminate a directory scope with `/**`. The two matchers agree on `'aws/**'` but diverge on a bare `'aws'`, which git reads as the whole subtree and git-cliff matches against nothing; `'.'` is the same trap for the repo root. A release under such an entry finds commits, bumps the version, and writes the tag, while its changelog gains no entry for them — and nothing reports an error.
 
 Validation rules:
 
 - The root `package.json` must exist and declare a `version` field. release-kit reports an error at config-load time if either is missing.
-- The `project` block is rejected in single-package mode (the implicit "all non-excluded workspaces contribute" rule is meaningless in a single-package repo).
+- The `project` block is rejected in single-package mode (the package's own release already covers the whole repo, so a project tier would only duplicate it).
+- `paths`, when declared, must hold at least one non-empty string. An empty array is rejected: it reaches git and git-cliff as no filter at all, which is the inverse of how it reads.
 - Unknown fields inside `project` are rejected.
 
 CLI flag interactions:

package/dist/esm/commitCommand.js

@@ -1,6 +1,6 @@
 import { execFileSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
-import { GIT_OUTPUT_LIMIT, parseArgsOrExit } from '@williamthorsen/nmr-core';
+import { GIT_OUTPUT_LIMIT, hasErrnoCode, parseArgsOrExit } from '@williamthorsen/nmr-core';
 import { readReleaseTags, RELEASE_SUMMARY_FILE, resolveReleaseTagsPath } from "./releaseFiles.js";
 const commitFlagSchema = {
     dryRun: { long: '--dry-run', type: 'boolean' },
@@ -16,7 +16,7 @@ export function commitCommand(argv) {
         summary = readFileSync(RELEASE_SUMMARY_FILE, 'utf8').trim();
     }
     catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+        if (hasErrnoCode(error, 'ENOENT')) {
         }
         else {
             throw error;

package/dist/esm/createTags.js

@@ -1,5 +1,5 @@
 import { execFileSync } from 'node:child_process';
-import { GIT_OUTPUT_LIMIT } from '@williamthorsen/nmr-core';
+import { GIT_OUTPUT_LIMIT, hasErrnoCode } from '@williamthorsen/nmr-core';
 import { deleteFileIfExists } from "./deleteFileIfExists.js";
 import { readReleaseTags, RELEASE_SUMMARY_FILE, RELEASE_TAGS_FILE } from "./releaseFiles.js";
 export function createTags(options) {
@@ -48,7 +48,7 @@ function assertCleanWorkingTree() {
         execFileSync('git', ['diff', '--quiet', '--cached'], { maxBuffer: GIT_OUTPUT_LIMIT });
     }
     catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+        if (hasErrnoCode(error, 'ENOENT')) {
             throw error;
         }
         throw new Error('Working tree is dirty. Commit or stash changes before tagging, or use `--no-git-checks` to skip this check.', { cause: error });

package/dist/esm/deleteFileIfExists.js

@@ -1,10 +1,11 @@
 import { unlinkSync } from 'node:fs';
+import { hasErrnoCode } from '@williamthorsen/nmr-core';
 export function deleteFileIfExists(filePath) {
     try {
         unlinkSync(filePath);
     }
     catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+        if (hasErrnoCode(error, 'ENOENT')) {
             return;
         }
         throw error;

package/dist/esm/loadConfig.js

@@ -73,7 +73,7 @@ export function mergeMonorepoConfig(discoveredPaths, userConfig, rootPackage) {
     if (userConfig?.retiredPackages !== undefined) {
         assertRetiredPackagesDoNotCollideWithActive(workspaces, userConfig.retiredPackages);
     }
-    const project = resolveProjectConfig(userConfig?.project, rootPackage);
+    const project = resolveProjectConfig(userConfig?.project, rootPackage, workspaces);
     const workTypes = resolveWorkTypes(userConfig?.workTypes);
     const versionPatterns = userConfig?.versionPatterns === undefined ? { ...DEFAULT_VERSION_PATTERNS } : { ...userConfig.versionPatterns };
     const changelogJson = mergeChangelogJsonConfig(userConfig?.changelogJson);
@@ -161,7 +161,7 @@ function assertRetiredPackagesDoNotCollideWithActive(workspaces, retiredPackages
         }
     }
 }
-function resolveProjectConfig(userProject, rootPackage) {
+function resolveProjectConfig(userProject, rootPackage, workspaces) {
     if (userProject === undefined) {
         return undefined;
     }
@@ -171,7 +171,10 @@ function resolveProjectConfig(userProject, rootPackage) {
     if (rootPackage.version === undefined) {
         throw new Error(`project block requires root ${ROOT_PACKAGE_JSON_PATH} to have a 'version' field; add a 'version' field to your root package.json`);
     }
-    return { tagPrefix: userProject.tagPrefix ?? DEFAULT_PROJECT_TAG_PREFIX };
+    return {
+        paths: userProject.paths ?? workspaces.flatMap((workspace) => workspace.paths),
+        tagPrefix: userProject.tagPrefix ?? DEFAULT_PROJECT_TAG_PREFIX,
+    };
 }
 function assertNoTagPrefixCollisions(workspaces, retiredPackages, project) {
     const sources = [];

package/dist/esm/releaseFiles.js

@@ -1,5 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
+import { hasErrnoCode } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 export const RELEASE_TAGS_FILE = 'tmp/.release-tags';
 export const RELEASE_SUMMARY_FILE = 'tmp/.release-summary';
@@ -21,15 +22,9 @@ export function readReleaseTags() {
 }
 function describeTagsReadFailure(error) {
     const tagsPath = resolveReleaseTagsPath();
-    if (getErrnoCode(error) === 'ENOENT') {
+    if (hasErrnoCode(error, 'ENOENT')) {
         return `No tags file found at ${tagsPath}. Run \`release-kit prepare\` first.`;
     }
     const detail = describeError(error);
     return `Cannot read the tags file at ${tagsPath}: ${detail}`;
 }
-function getErrnoCode(error) {
-    if (error instanceof Error && 'code' in error && typeof error.code === 'string') {
-        return error.code;
-    }
-    return undefined;
-}

package/dist/esm/releasePrepareProject.js

@@ -25,7 +25,7 @@ export function releasePrepareProject(args) {
     const workTypes = config.workTypes ?? { ...DEFAULT_WORK_TYPES };
     const versionPatterns = config.versionPatterns ?? { ...DEFAULT_VERSION_PATTERNS };
     const breakingPolicies = config.breakingPolicies ?? DEFAULT_BREAKING_POLICIES;
-    const contributingPaths = config.workspaces.flatMap((workspace) => workspace.paths);
+    const contributingPaths = project.paths;
     const { tag, commits } = getCommitsSinceTarget([project.tagPrefix], contributingPaths);
     const since = tag === undefined ? '(no previous release found)' : `since ${tag}`;
     const collector = createPolicyViolationCollector();

package/dist/esm/types.d.ts

@@ -33,6 +33,7 @@ export interface ReleaseNotesConfig {
     shouldInjectIntoReadme: boolean;
 }
 export interface ResolvedProjectConfig {
+    paths: string[];
     tagPrefix: string;
 }
 export interface PropagationSource {
@@ -142,6 +143,7 @@ export declare const workspaceOverrideSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type WorkspaceOverride = z.infer<typeof workspaceOverrideSchema>;
 export declare const projectConfigSchema: z.ZodObject<{
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
     tagPrefix: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type ProjectConfig = z.infer<typeof projectConfigSchema>;
@@ -193,6 +195,7 @@ export declare const releaseKitConfigSchema: z.ZodObject<{
     cliffConfigPath: z.ZodOptional<z.ZodString>;
     formatCommand: z.ZodOptional<z.ZodString>;
     project: z.ZodOptional<z.ZodObject<{
+        paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
         tagPrefix: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     releaseNotes: z.ZodOptional<z.ZodObject<{

package/dist/esm/types.js

@@ -21,6 +21,7 @@ export const workspaceOverrideSchema = z
     .strict();
 export const projectConfigSchema = z
     .object({
+    paths: z.array(z.string().min(1)).min(1).optional(),
     tagPrefix: z.string().min(1).optional(),
 })
     .strict();

package/dist/esm/validateOverridesCommand.js

@@ -126,9 +126,8 @@ function buildMonorepoInputs(discoveredPaths, userConfig, buildEntries) {
         filePath: resolveOverridePath('.'),
     };
     if (project !== undefined) {
-        const contributingPaths = config.workspaces.flatMap((workspace) => workspace.paths);
         const projectTagPattern = buildTagPattern([project.tagPrefix]);
-        projectScope.hashes = flattenEntriesToHashes(buildEntries(config, projectTagPattern, contributingPaths));
+        projectScope.hashes = flattenEntriesToHashes(buildEntries(config, projectTagPattern, project.paths));
     }
     return { project: projectScope, workspaces };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "10.3.2",
+  "version": "10.4.0",
   "description": "Version-bumping and changelog-generation toolkit for release workflows",
   "keywords": [
     "changelog",
@@ -48,17 +48,19 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@williamthorsen/toolbelt.errors": "0.4.0",
+    "@williamthorsen/toolbelt.errors": "0.5.0",
     "glob": "13.0.6",
     "json-stringify-pretty-compact": "4.0.0",
     "semver": "7.8.5",
     "yaml": "2.9.0",
     "zod": "4.4.3",
-    "@williamthorsen/nmr-core": "0.10.0"
+    "@williamthorsen/nmr-core": "0.10.1"
   },
   "devDependencies": {
     "@types/semver": "7.8.0",
-    "readyup": "0.27.0",
+    "@williamthorsen/toolbelt.testing": "0.3.0",
+    "@williamthorsen/toolbelt.vitest": "0.4.0",
+    "readyup": "0.28.0",
     "smol-toml": "1.7.1"
   },
   "engines": {