@williamthorsen/release-kit 15.0.3 → 16.1.0

package/.meta/changelog.json

@@ -1,4 +1,97 @@
 [
+  {
+    "version": "16.1.0",
+    "date": "2026-11-03",
+    "sections": [
+      {
+        "title": "🎉 Features",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Makes `prepare` and `publish` refuse a release, dry runs included, when a tarball packed from a clean checkout of HEAD lacks a file named by the package's `main`, `types`, `bin`, or `exports`, which keeps a package with missing build output from reaching the registry. (#1147)",
+            "hash": "c730654140e89d52ac7430987497d8b954fa7f00",
+            "entry": 1
+          },
+          {
+            "description": "Adds the `devExportConditions` config key, which lists the export conditions that resolve only inside the repo and whose targets the tarball check does not require, in addition to `source`. (#1147)",
+            "hash": "c730654140e89d52ac7430987497d8b954fa7f00",
+            "entry": 2
+          },
+          {
+            "description": "Adds a `content` label to the `common` label preset, for consumer-facing material such as copy, images, or displayed data rather than functionality. (#1150)",
+            "hash": "8c7b990041e5744c26547fe0ce8c9305f0f7c6f4",
+            "entry": 1
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "version": "16.0.0",
+    "date": "2026-10-28",
+    "sections": [
+      {
+        "title": "🎉 Features",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Renames the `changelogMarkdown.keepVersions` config key to `changelogMarkdown.keptVersionCount` and makes config validation reject the old key with an error that names the replacement. (#1134)",
+            "breaking": true,
+            "migration": "Rename `changelogMarkdown.keepVersions` to `changelogMarkdown.keptVersionCount` in `.config/release-kit.config.ts`, keeping the same value.",
+            "hash": "3d44603845a461295a5a62eee60cf151b5291f1a",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "♻️ Refactoring",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Renames the boolean options, fields, and parameters in `release-kit` to take an `is`, `has`, `does`, or `should` prefix, such as `dryRun` to `isDryRun` and `exists` to `doesExist`, and leaves every CLI flag spelling unchanged. (#1132)",
+            "hash": "dcb78f0657c580eb7c7be94859e4185ae9f3d3be",
+            "entry": 1
+          },
+          {
+            "description": "Renames the values and type fields declared in `release-kit`'s source files from the first alphabetically through `prepareTarget.ts` so that each name ends with its kind, such as `parsedJson` for `parsed` and `unreleasedReading` for the history field `unreleased`, without changing behavior. (#1133)",
+            "hash": "eae8b6458dca1927393d64626d4731fc7c9f9df1",
+            "entry": 1
+          },
+          {
+            "description": "Renames values and type fields across release-kit's source so that each name ends with its kind, such as `applied` to `appliedWrites` and `TargetPrepareOptions.only` to `onlyTargetIds`. (#1134)",
+            "hash": "3d44603845a461295a5a62eee60cf151b5291f1a",
+            "entry": 2
+          },
+          {
+            "description": "Renames `release-kit`'s source functions and test helpers so that each name starts with a transitive verb that states its action, for example `releasePrepareTargets` to `prepareReleaseTargets` (with its module and test files), `publishWorkflow` to `renderPublishWorkflow`, and `toChangelogEntries` to `convertToChangelogEntries`, without changing the exports of `.` or `./config`. (#1137)",
+            "hash": "a84d9ce0652754a417b85c3f9cd14a6e400c7b51",
+            "entry": 1
+          },
+          {
+            "description": "Renames identifiers in `release-kit` so that each measurement ends with its unit, such as `timestamp` becoming `timestampSec` on `ReleaseWindow` and `SUBJECT_COLUMN_BUDGET` becoming `SUBJECT_BUDGET_COLUMNS`, and so that obscure abbreviations are spelled out, such as `pkg` becoming `packageJson` and `dep` becoming `dependency`. (#1138)",
+            "hash": "f75938c0bfe9365a76b15aa6b4b9d195046c8c78",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "🧪 Tests",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Renames the values declared in release-kit's `src/__tests__` files, from the first one alphabetically through `prepareCommand.unit.test.ts`, so that each name ends with its kind, such as `underlying` to `underlyingError` and `unreleased` to `unreleasedReading`. (#1135)",
+            "hash": "b98d26e24e86835ce6edc78f53a964bcc84472fb",
+            "entry": 1
+          },
+          {
+            "description": "Suffixes the values declared in release-kit's remaining tests with their kind, such as `known` to `knownFlags`, `silent` to `silencedConsole`, and `actual` to `actualModule`, in the `src/__tests__` files after `prepareCommand.unit.test.ts` and the tests under `src/init/__tests__` and `src/sync-labels/__tests__`. (#1136)",
+            "hash": "1e947eb5c2d168ffd3d1cf9cf8b0b4e720eaf991",
+            "entry": 1
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "15.0.3",
     "date": "2026-10-27",

package/.readyup/kits/default.js

@@ -24,14 +24,14 @@ function isRecord(value) {
 }
 
 // src/init/parseJsonRecord.ts
-function parseJsonRecord(raw) {
-  let parsed;
+function parseJsonRecord(jsonText) {
+  let parsedJson;
   try {
-    parsed = JSON.parse(raw);
+    parsedJson = JSON.parse(jsonText);
   } catch {
     return void 0;
   }
-  return isRecord(parsed) ? parsed : void 0;
+  return isRecord(parsedJson) ? parsedJson : void 0;
 }
 
 // src/init/detectRepoType.ts
@@ -40,9 +40,9 @@ function detectRepoType() {
     return "monorepo";
   }
   if (existsSync("package.json")) {
-    const raw = readFileSync("package.json", "utf8");
-    const pkg = parseJsonRecord(raw);
-    if (pkg !== void 0 && Array.isArray(pkg["workspaces"])) {
+    const manifestJson = readFileSync("package.json", "utf8");
+    const packageJson = parseJsonRecord(manifestJson);
+    if (packageJson !== void 0 && Array.isArray(packageJson["workspaces"])) {
       return "monorepo";
     }
   }
@@ -67,9 +67,9 @@ function packsPath(filesField, path) {
 var GLOB_TOKEN_PATTERN = /\*\*\/|\*\*|\*|\?|[^*?]+/g;
 function compileEntry(entry) {
   if (entry.startsWith("!")) return void 0;
-  const normalized = entry.replace(/^\.?\//, "").replace(/\/+$/, "");
-  if (normalized === "") return void 0;
-  return new RegExp(`^${translateGlob(normalized)}$`);
+  const normalizedEntry = entry.replace(/^\.?\//, "").replace(/\/+$/, "");
+  if (normalizedEntry === "") return void 0;
+  return new RegExp(`^${translateGlob(normalizedEntry)}$`);
 }
 function isStringArray(value) {
   return Array.isArray(value) && value.every((entry) => typeof entry === "string");
@@ -105,7 +105,7 @@ function translateGlob(pattern) {
 function changelogArchivesAreEnabled() {
   const content = readFile(".config/release-kit.config.ts");
   if (content === void 0) return false;
-  return /changelogMarkdown\s*:\s*\{[^}]*keepVersions\s*:/.test(content);
+  return /changelogMarkdown\s*:\s*\{[^}]*keptVersionCount\s*:/.test(content);
 }
 function changelogJsonIsEnabled() {
   const content = readFile(".config/release-kit.config.ts");
@@ -223,7 +223,7 @@ function stripYamlQuotes(value) {
 }
 
 // .readyup/lib/workflow-hashes.ts
-var COMMON_PRESET_HASH = "1d3e2df1ccd7deea4707fa07a4ae171d761344b65c1a311467fc0f66b70ee646";
+var COMMON_PRESET_HASH = "5c6d7efcc8744d9d30720d24e345b04e03f2b28677ad0c6782020d91731b8aa4";
 var SYNC_LABELS_WORKFLOW_HASH = "0a88829d154c0de7cdd4246fede99e9311a89ab4199034dbe601663d641ab1e4";
 var RELEASE_WORKFLOW_HASH_MONOREPO = "f63f4cabb57f94ee6550f17a9874c7a346d46554595ddbcd46fdd3208d613437";
 var RELEASE_WORKFLOW_HASH_SINGLE = "d26dd4ca186632b388ea46bd885721124c03d19918e511baa40821d2d760da69";
@@ -234,7 +234,7 @@ var CREATE_GITHUB_RELEASE_WORKFLOW_HASH_SINGLE = "d6de961de913c67b08dfa7e07f7349
 
 // .readyup/kits/default.ts
 function getMinVersion() {
-  const picked = { "version": "15.0.3" };
+  const picked = { "version": "16.1.0" };
   if (typeof picked["version"] !== "string") {
     throw new TypeError("release-kit/package.json: 'version' must be a string");
   }
@@ -405,7 +405,7 @@ var default_default = defineRdyKit({
           severity: "warn",
           skip: () => {
             if (!hasPublishablePackages()) return "no publishable packages";
-            return !changelogArchivesAreEnabled() && "changelogMarkdown.keepVersions is not set";
+            return !changelogArchivesAreEnabled() && "changelogMarkdown.keptVersionCount is not set";
           },
           check: () => packagesShipChangelogArchives(),
           fix: 'Add "changelogs/" to the files field of each affected package.json, so that the links from CHANGELOG.md to its archive files resolve in the published package'

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

@@ -60,16 +60,16 @@ function lookUpNpmPackage(packageName, registry) {
   return classifyNpmPackageLookup(runNpmJson(args));
 }
 function readNpmError(stdout) {
-  let parsed;
+  let parsedJson;
   try {
-    parsed = JSON.parse(stdout);
+    parsedJson = JSON.parse(stdout);
   } catch {
     return void 0;
   }
-  if (!isRecord(parsed) || !isRecord(parsed["error"]) || typeof parsed["error"]["code"] !== "string") {
+  if (!isRecord(parsedJson) || !isRecord(parsedJson["error"]) || typeof parsedJson["error"]["code"] !== "string") {
     return void 0;
   }
-  const { code, summary } = parsed["error"];
+  const { code, summary } = parsedJson["error"];
   return { code, summary: typeof summary === "string" ? summary : "" };
 }
 function runNpmJson(args) {

package/.readyup/manifest.json

@@ -7,7 +7,7 @@
           "checklist": "release-kit",
           "checks": [
             "@williamthorsen/release-kit in devDependencies",
-            "@williamthorsen/release-kit >= 15.0.3",
+            "@williamthorsen/release-kit >= 16.1.0",
             "release.yaml workflow exists",
             "release.yaml matches template",
             "release.yaml does not reference deprecated tag ref",
@@ -43,12 +43,12 @@
       "esbuildVersion": "0.28.2",
       "inputs": [
         {
-          "hash": "ad3666b8",
+          "hash": "56566d0b",
           "kind": "module",
           "path": "kits/default.ts"
         },
         {
-          "hash": "45fc235f",
+          "hash": "dafe3ffb",
           "kind": "module",
           "path": "lib/changelog-checks.ts"
         },
@@ -58,12 +58,12 @@
           "path": "lib/config-checks.ts"
         },
         {
-          "hash": "13f15dfe",
+          "hash": "f652dae3",
           "kind": "module",
           "path": "lib/workflow-hashes.ts"
         },
         {
-          "hash": "5c98064e",
+          "hash": "b44f7148",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -71,22 +71,22 @@
           ]
         },
         {
-          "hash": "40404aa0",
+          "hash": "694186f4",
           "kind": "module",
           "path": "../src/changelogArchive.ts"
         },
         {
-          "hash": "43bb0452",
+          "hash": "65fa2f33",
           "kind": "module",
           "path": "../src/init/detectRepoType.ts"
         },
         {
-          "hash": "68354f97",
+          "hash": "9ca0f6bf",
           "kind": "module",
           "path": "../src/init/parseJsonRecord.ts"
         },
         {
-          "hash": "1c9cbce9",
+          "hash": "2210df36",
           "kind": "module",
           "path": "../src/packsPath.ts"
         },
@@ -100,8 +100,8 @@
       "path": "kits/default.js",
       "readyupVersion": "0.44.0",
       "source": "kits/default.ts",
-      "sourceHash": "ad3666b8",
-      "targetHash": "35d9bb56"
+      "sourceHash": "56566d0b",
+      "targetHash": "5f810bb7"
     },
     {
       "checklistChecks": [
@@ -145,7 +145,7 @@
           "path": "../src/init/hasProvenance.ts"
         },
         {
-          "hash": "3e39b9be",
+          "hash": "bb8746b3",
           "kind": "module",
           "path": "../src/npmRegistry.ts"
         },
@@ -160,7 +160,7 @@
       "readyupVersion": "0.44.0",
       "source": "kits/npm-auto-publish.ts",
       "sourceHash": "682fdd4a",
-      "targetHash": "fac6bc8b"
+      "targetHash": "84f31b6d"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 All notable changes to this project will be documented in this file.
 
+## 16.1.0 — 2026-11-03
+
+### 🎉 Features
+
+- Makes `prepare` and `publish` refuse a release, dry runs included, when a tarball packed from a clean checkout of HEAD lacks a file named by the package's `main`, `types`, `bin`, or `exports`, which keeps a package with missing build output from reaching the registry. (#1147)
+- Adds the `devExportConditions` config key, which lists the export conditions that resolve only inside the repo and whose targets the tarball check does not require, in addition to `source`. (#1147)
+- Adds a `content` label to the `common` label preset, for consumer-facing material such as copy, images, or displayed data rather than functionality. (#1150)
+
+## 16.0.0 — 2026-10-28
+
+### 🎉 Features
+
+- 🚨 **Breaking:** Renames the `changelogMarkdown.keepVersions` config key to `changelogMarkdown.keptVersionCount` and makes config validation reject the old key with an error that names the replacement. (#1134)
+
+### ♻️ Refactoring
+
+- Renames the boolean options, fields, and parameters in `release-kit` to take an `is`, `has`, `does`, or `should` prefix, such as `dryRun` to `isDryRun` and `exists` to `doesExist`, and leaves every CLI flag spelling unchanged. (#1132)
+- Renames the values and type fields declared in `release-kit`'s source files from the first alphabetically through `prepareTarget.ts` so that each name ends with its kind, such as `parsedJson` for `parsed` and `unreleasedReading` for the history field `unreleased`, without changing behavior. (#1133)
+- Renames values and type fields across release-kit's source so that each name ends with its kind, such as `applied` to `appliedWrites` and `TargetPrepareOptions.only` to `onlyTargetIds`. (#1134)
+- Renames `release-kit`'s source functions and test helpers so that each name starts with a transitive verb that states its action, for example `releasePrepareTargets` to `prepareReleaseTargets` (with its module and test files), `publishWorkflow` to `renderPublishWorkflow`, and `toChangelogEntries` to `convertToChangelogEntries`, without changing the exports of `.` or `./config`. (#1137)
+- Renames identifiers in `release-kit` so that each measurement ends with its unit, such as `timestamp` becoming `timestampSec` on `ReleaseWindow` and `SUBJECT_COLUMN_BUDGET` becoming `SUBJECT_BUDGET_COLUMNS`, and so that obscure abbreviations are spelled out, such as `pkg` becoming `packageJson` and `dep` becoming `dependency`. (#1138)
+
+### 🧪 Tests
+
+- Renames the values declared in release-kit's `src/__tests__` files, from the first one alphabetically through `prepareCommand.unit.test.ts`, so that each name ends with its kind, such as `underlying` to `underlyingError` and `unreleased` to `unreleasedReading`. (#1135)
+- Suffixes the values declared in release-kit's remaining tests with their kind, such as `known` to `knownFlags`, `silent` to `silencedConsole`, and `actual` to `actualModule`, in the `src/__tests__` files after `prepareCommand.unit.test.ts` and the tests under `src/init/__tests__` and `src/sync-labels/__tests__`. (#1136)
+
 ## 15.0.3 — 2026-10-27
 
 ### ♻️ Refactoring

package/README.md

@@ -6,7 +6,15 @@ 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 the same commit history that decides each bump (with optional [editorial overrides](docs/editorial-overrides.md)).
 
-<!-- section:release-notes --><!-- /section:release-notes -->
+<!-- section:release-notes -->
+## Release notes — v16.1.0 (2026-11-03)
+
+### 🎉 Features
+
+- Makes `prepare` and `publish` refuse a release, dry runs included, when a tarball packed from a clean checkout of HEAD lacks a file named by the package's `main`, `types`, `bin`, or `exports`, which keeps a package with missing build output from reaching the registry. (#1147)
+- Adds the `devExportConditions` config key, which lists the export conditions that resolve only inside the repo and whose targets the tarball check does not require, in addition to `source`. (#1147)
+- Adds a `content` label to the `common` label preset, for consumer-facing material such as copy, images, or displayed data rather than functionality. (#1150)
+<!-- /section:release-notes -->
 
 ## Installation
 
@@ -65,8 +73,9 @@ Every command other than `--version` and `--help` first locates the repo root an
 1. **Workspace discovery**: Reads `pnpm-workspace.yaml` and resolves its `packages` patterns to find workspace directories, applying pnpm's semantics: A `!`-prefixed entry excludes what it matches, wherever it appears in the list. Each directory containing a `package.json` becomes a workspace. The repo is treated as a single-package project when it doesn't contain a workspace file, and when the workspace file doesn't declare a `packages` list: a file kept for `catalog:` or `overrides:` alone, which pnpm likewise resolves to the root package. A workspace file that declares patterns that don't resolve to any package is an error naming the condition that emptied it.
 2. **Config loading**: Loads `.config/release-kit.config.ts` (if present) from the repo root, or the file named by `--config` relative to the invocation directory, and merges it with discovered defaults.
 3. **Commit analysis**: For each workspace, reads the history once, builds the changelog items of the commits since the last version tag, and takes the bump as the highest level that those items call for.
-4. **Version bump + changelog**: Bumps `package.json` versions, builds structured `ChangelogEntry[]` from the commits between each pair of release tags, applies any [editorial overrides](docs/editorial-overrides.md) from per-scope `.meta/changelog-overrides.json` files, and renders both `CHANGELOG.md` and `.meta/changelog.json` from that single source, so the two always agree.
-5. **Release tags file**: Writes computed tags to `tmp/.release-tags` for the release workflow to read when tagging and pushing.
+4. **Tarball check**: Packs each publishable package that the release includes from a clean checkout of HEAD, and refuses the release when a tarball lacks a file that the package's manifest names; see [Packages whose tarball would lack a manifest file](docs/releasing.md#packages-whose-tarball-would-lack-a-manifest-file).
+5. **Version bump + changelog**: Bumps `package.json` versions, builds structured `ChangelogEntry[]` from the commits between each pair of release tags, applies any [editorial overrides](docs/editorial-overrides.md) from per-scope `.meta/changelog-overrides.json` files, and renders both `CHANGELOG.md` and `.meta/changelog.json` from that single source, so the two always agree.
+6. **Release tags file**: Writes computed tags to `tmp/.release-tags` for the release workflow to read when tagging and pushing.
 
 [Changelogs](docs/changelogs.md) covers what a published tarball includes, the `changelog.json` item schema, and which commits appear in a changelog.
 

package/dist/esm/applyChangelogOverrides.js

@@ -55,10 +55,10 @@ export function resolveOverrideKey(overrideKey, positionsByHash) {
     if (hashes.length > 1) {
         return { kind: 'ambiguous', hashes };
     }
-    const available = [...(positionsByHash.get(hash) ?? [])];
+    const availablePositions = [...(positionsByHash.get(hash) ?? [])];
     const positions = entry === undefined
-        ? available.toSorted((left, right) => (left ?? 0) - (right ?? 0))
-        : available.filter((position) => position === entry);
+        ? availablePositions.toSorted((left, right) => (left ?? 0) - (right ?? 0))
+        : availablePositions.filter((position) => position === entry);
     return positions.length === 0 ? { kind: 'none' } : { kind: 'items', hash, positions };
 }
 function applyOverridesToItems(items, itemIdToOverride) {
@@ -133,10 +133,10 @@ function resolveOverrideKeys(positionsByHash, overrides) {
         }
         const { hash, positions } = resolution;
         if (parseOverrideKey(overrideKey).entry === undefined && positions.length > 1) {
-            const fieldsSet = ['description', 'body'].filter((field) => override[field] !== undefined);
-            if (fieldsSet.length > 0) {
+            const setFields = ['description', 'body'].filter((field) => override[field] !== undefined);
+            if (setFields.length > 0) {
                 const ordinalKeys = positions.map((position) => `${overrideKey}:${position}`).join(', ');
-                errors.push(`Override key '${overrideKey}' sets ${fieldsSet.join(' and ')} on a commit with several items; use ${ordinalKeys}`);
+                errors.push(`Override key '${overrideKey}' sets ${setFields.join(' and ')} on a commit with several items; use ${ordinalKeys}`);
                 continue;
             }
         }

package/dist/esm/assertReleasesOnNpm.js

@@ -4,8 +4,8 @@ import { isPublishableManifest } from "./isPublishableManifest.js";
 import { lookUpNpmPackage } from "./npmRegistry.js";
 import { isRecord } from "./typeGuards.js";
 export function assertReleasesOnNpm(workspacePaths) {
-    const unpublished = [];
-    const unverifiable = [];
+    const unpublishedCandidates = [];
+    const unverifiableCandidates = [];
     for (const workspacePath of workspacePaths) {
         const candidate = buildNpmCandidate(workspacePath);
         if (candidate === undefined) {
@@ -13,16 +13,16 @@ export function assertReleasesOnNpm(workspacePaths) {
         }
         const lookup = lookUpNpmPackage(candidate.name, candidate.registry);
         if (lookup.status === 'unpublished') {
-            unpublished.push(candidate);
+            unpublishedCandidates.push(candidate);
         }
         else if (lookup.status === 'unverifiable') {
-            unverifiable.push({ candidate, detail: lookup.detail });
+            unverifiableCandidates.push({ candidate, detail: lookup.detail });
         }
     }
-    if (unpublished.length === 0 && unverifiable.length === 0) {
+    if (unpublishedCandidates.length === 0 && unverifiableCandidates.length === 0) {
         return;
     }
-    throw new Error(describeRefusal(unpublished, unverifiable));
+    throw new Error(describeRefusal(unpublishedCandidates, unverifiableCandidates));
 }
 function buildNpmCandidate(workspacePath) {
     const manifest = JSON.parse(readFileSync(join(workspacePath, 'package.json'), 'utf8'));
@@ -37,19 +37,19 @@ function buildNpmCandidate(workspacePath) {
         ...(typeof registry === 'string' && { registry }),
     };
 }
-function describeRefusal(unpublished, unverifiable) {
+function describeRefusal(unpublishedCandidates, unverifiableCandidates) {
     const sections = ['Cannot prepare the release: npm must already have every package that the release publishes.'];
-    if (unpublished.length > 0) {
+    if (unpublishedCandidates.length > 0) {
         sections.push([
             'Not on npm yet:',
-            ...unpublished.map(({ name, workspacePath }) => `  - ${name}: run "npm publish --access public" from ${workspacePath}`),
+            ...unpublishedCandidates.map(({ name, workspacePath }) => `  - ${name}: run "npm publish --access public" from ${workspacePath}`),
             'Then register each one as a trusted publisher; "rdy run --from npm:@williamthorsen/release-kit npm-auto-publish" prints the command.',
         ].join('\n'));
     }
-    if (unverifiable.length > 0) {
+    if (unverifiableCandidates.length > 0) {
         sections.push([
             'Could not confirm on npm:',
-            ...unverifiable.map(({ candidate, detail }) => `  - ${candidate.name}: ${detail}`),
+            ...unverifiableCandidates.map(({ candidate, detail }) => `  - ${candidate.name}: ${detail}`),
         ].join('\n'));
     }
     return sections.join('\n\n');

package/dist/esm/assertTaggedBaseline.js

@@ -4,10 +4,10 @@ import { readChangelogEntries } from "./changelogJsonUtils.js";
 import { readCurrentVersion } from "./planVersionBump.js";
 import { readChangelogSections } from "./readChangelogSections.js";
 export function assertTaggedBaseline(findings) {
-    const untagged = findings.filter((finding) => finding !== undefined);
-    if (untagged.length === 0)
+    const untaggedFindings = findings.filter((finding) => finding !== undefined);
+    if (untaggedFindings.length === 0)
         return;
-    const lines = untagged.map(({ label, version, tag }) => `  - ${label}: ${version} (create tag ${tag})`);
+    const lines = untaggedFindings.map(({ label, version, tag }) => `  - ${label}: ${version} (create tag ${tag})`);
     throw new Error([
         'The current version is recorded in the changelog, but its tag is not the previous tag reachable from HEAD:',
         ...lines,
@@ -31,9 +31,9 @@ export function findUntaggedBaseline(target, config) {
 function readRecordedVersions(changelogPaths, config) {
     const versions = new Set();
     for (const changelogPath of changelogPaths) {
-        const { versioned } = readChangelogSections(join(changelogPath, 'CHANGELOG.md'));
+        const { versionedSections } = readChangelogSections(join(changelogPath, 'CHANGELOG.md'));
         const entries = readChangelogEntries(resolveChangelogJsonPath(config, changelogPath)) ?? [];
-        for (const { version } of [...versioned, ...entries]) {
+        for (const { version } of [...versionedSections, ...entries]) {
             versions.add(version);
         }
     }

package/dist/esm/assertTarballsComplete.d.ts

@@ -0,0 +1,9 @@
+import { packFromCleanCheckout } from './packFromCleanCheckout.js';
+/**
+ * Throws when the tarball of a publishable package among the given workspaces would lack a file that its manifest
+ * names, or when the packages cannot be packed from a clean checkout of HEAD.
+ *
+ * Each workspace path is repo-relative and is read from the current directory. A private package is not packed, and
+ * an empty list doesn't clone anything.
+ */
+export declare function assertTarballsComplete(workspacePaths: readonly string[], devExportConditions: readonly string[], pack?: typeof packFromCleanCheckout): void;

package/dist/esm/assertTarballsComplete.js

@@ -0,0 +1,52 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { describeError } from '@williamthorsen/toolbelt.errors';
+import { detectPackageManager } from "./detectPackageManager.js";
+import { findMissingManifestPaths } from "./findMissingManifestPaths.js";
+import { isPublishableManifest } from "./isPublishableManifest.js";
+import { packFromCleanCheckout } from "./packFromCleanCheckout.js";
+import { isRecord } from "./typeGuards.js";
+export function assertTarballsComplete(workspacePaths, devExportConditions, pack = packFromCleanCheckout) {
+    const candidates = workspacePaths
+        .map((workspacePath) => ({ workspacePath, manifest: readManifest(workspacePath) }))
+        .filter(({ manifest }) => isPublishableManifest(manifest));
+    if (candidates.length === 0) {
+        return;
+    }
+    process.stderr.write(`Checking the tarballs of ${candidates.length} ${candidates.length === 1 ? 'package' : 'packages'} from a clean checkout of HEAD...\n`);
+    let filesByWorkspace;
+    try {
+        filesByWorkspace = pack(candidates.map(({ workspacePath }) => workspacePath), detectPackageManager());
+    }
+    catch (error) {
+        throw new Error(`Cannot release: The packages could not be packed from a clean checkout of HEAD.\n${describeError(error)}`, { cause: error });
+    }
+    const incompletePackages = candidates
+        .map(({ workspacePath, manifest }) => ({
+        workspacePath,
+        manifest,
+        missingPaths: findMissingManifestPaths(manifest, filesByWorkspace.get(workspacePath) ?? [], devExportConditions),
+    }))
+        .filter(({ missingPaths }) => missingPaths.length > 0);
+    if (incompletePackages.length === 0) {
+        return;
+    }
+    throw new Error(describeRefusal(incompletePackages));
+}
+function describeRefusal(incompletePackages) {
+    const sections = ['Cannot release: The tarball of every package must contain each file that its manifest names.'];
+    for (const { workspacePath, manifest, missingPaths } of incompletePackages) {
+        const name = typeof manifest['name'] === 'string' ? manifest['name'] : workspacePath;
+        sections.push([
+            `${name} (${workspacePath}) lacks:`,
+            ...missingPaths.map(({ location, path }) => `  - ${path} (${location})`),
+        ].join('\n'));
+    }
+    sections.push('Build these files in the package\'s publish lifecycle, such as in a "prepack" script. ' +
+        'If an export condition is for development only, list it in the "devExportConditions" config key.');
+    return sections.join('\n\n');
+}
+function readManifest(workspacePath) {
+    const manifest = JSON.parse(readFileSync(join(workspacePath, 'package.json'), 'utf8'));
+    return isRecord(manifest) ? manifest : {};
+}

package/dist/esm/bin/release-kit.js

@@ -127,12 +127,12 @@ if (command === 'init') {
     }
     enterRepoRootOrExit();
     const initFlagSchema = {
-        dryRun: { long: '--dry-run', type: 'boolean' },
-        force: { long: '--force', type: 'boolean' },
-        withConfig: { long: '--with-config', type: 'boolean' },
+        isDryRun: { long: '--dry-run', type: 'boolean' },
+        shouldForce: { long: '--force', type: 'boolean' },
+        shouldScaffoldConfig: { long: '--with-config', type: 'boolean' },
     };
-    const { dryRun, force, withConfig } = parseArgsOrExit(flags, initFlagSchema).flags;
-    const exitCode = initCommand({ dryRun, force, styles, withConfig });
+    const { isDryRun, shouldForce, shouldScaffoldConfig } = parseArgsOrExit(flags, initFlagSchema).flags;
+    const exitCode = initCommand({ isDryRun, shouldForce, styles, shouldScaffoldConfig });
     process.exit(exitCode);
 }
 if (command === 'update-templates') {
@@ -142,10 +142,10 @@ if (command === 'update-templates') {
     }
     enterRepoRootOrExit();
     const updateTemplatesFlagSchema = {
-        dryRun: { long: '--dry-run', type: 'boolean' },
+        isDryRun: { long: '--dry-run', type: 'boolean' },
     };
-    const { dryRun } = parseArgsOrExit(flags, updateTemplatesFlagSchema).flags;
-    const exitCode = updateTemplatesCommand({ dryRun, styles });
+    const { isDryRun } = parseArgsOrExit(flags, updateTemplatesFlagSchema).flags;
+    const exitCode = updateTemplatesCommand({ isDryRun, styles });
     process.exit(exitCode);
 }
 if (command === 'sync-labels') {
@@ -163,15 +163,15 @@ if (command === 'sync-labels') {
         const { invocationDir } = enterRepoRootOrExit();
         const syncLabelsInitFlagSchema = {
             ...configFlagSchema,
-            dryRun: { long: '--dry-run', type: 'boolean' },
-            force: { long: '--force', type: 'boolean' },
+            isDryRun: { long: '--dry-run', type: 'boolean' },
+            shouldForce: { long: '--force', type: 'boolean' },
         };
-        const { config, dryRun, force } = parseArgsOrExit(subflags, syncLabelsInitFlagSchema).flags;
+        const { config, isDryRun, shouldForce } = parseArgsOrExit(subflags, syncLabelsInitFlagSchema).flags;
         const configPath = resolveConfigFlag(config, invocationDir);
         const exitCode = await syncLabelsInitCommand({
             ...(configPath !== undefined && { configPath }),
-            dryRun,
-            force,
+            isDryRun,
+            shouldForce,
             styles,
         });
         process.exit(exitCode);
@@ -184,11 +184,11 @@ if (command === 'sync-labels') {
         const { invocationDir } = enterRepoRootOrExit();
         const generateFlagSchema = {
             ...configFlagSchema,
-            check: { long: '--check', type: 'boolean' },
+            shouldCheck: { long: '--check', type: 'boolean' },
         };
-        const { check, config } = parseArgsOrExit(subflags, generateFlagSchema).flags;
+        const { shouldCheck, config } = parseArgsOrExit(subflags, generateFlagSchema).flags;
         const configPath = resolveConfigFlag(config, invocationDir);
-        const exitCode = await generateCommand({ check, ...(configPath !== undefined && { configPath }), styles });
+        const exitCode = await generateCommand({ shouldCheck, ...(configPath !== undefined && { configPath }), styles });
         process.exit(exitCode);
     }
     if (subcommand === 'sync') {