@varlock/bumpy 1.2.2 → 1.3.0

package/README.md

@@ -28,7 +28,7 @@ Bumpy uses **bump files** (you may know them as "changesets" if coming from [tha
   - Shows what packages will be released and their changelogs
     - Including packages bumped automatically due to dependency relationships
 - When release PR is merged, publishing is triggered
-  - Oending bump files are deleted and packages are published with updated versions and changelogs
+  - Pending bump files are deleted and packages are published with updated versions and changelogs
 
 All of this is automated via two simple GitHub Actions workflows (see [CI setup](#ci--github-actions) below). You can also run everything locally with `bumpy status`, `bumpy version`, and `bumpy publish`.
 
@@ -104,7 +104,6 @@ jobs:
       - run: bunx @varlock/bumpy ci check
         env:
           GH_TOKEN: ${{ github.token }}
-          BUMPY_GH_TOKEN: ${{ secrets.BUMPY_GH_TOKEN }} # additional PAT (optional)
 ```
 
 ### Release workflow
@@ -135,7 +134,7 @@ jobs:
       - run: bunx @varlock/bumpy ci release
         env:
           GH_TOKEN: ${{ github.token }}
-          BUMPY_GH_TOKEN: ${{ secrets.BUMPY_GH_TOKEN }} # additonal PAT, needed to trigger CI checks on release PR
+          BUMPY_GH_TOKEN: ${{ secrets.BUMPY_GH_TOKEN }} # PAT so that version PR triggers CI
 ```
 
 > **Trusted publishing setup:** Configure each package on [npmjs.com](https://docs.npmjs.com/trusted-publishers/) → Package Settings → Trusted Publishers → GitHub Actions. Specify your org/user, repo, and the workflow filename (`bumpy-release.yml`). No `NPM_TOKEN` secret needed. Requires npm >= 11.5.1 - bumpy will warn if your version is too old.
@@ -240,7 +239,7 @@ Bumpy is built as a successor to [@changesets/changesets](https://github.com/cha
 
 ```bash
 bun install        # install deps
-bun test           # run tests
+bun run test       # run tests
 bun run build      # build CLI
 bunx bumpy --help  # invoke built cli
 ```

package/dist/{add-DEqGa5gI.mjs → add-ET1tcdQm.mjs}

@@ -1,9 +1,9 @@
 import { n as log, o as __toESM, r as require_picocolors } from "./logger-C2dEe5Su.mjs";
 import { n as exists, t as ensureDir } from "./fs-DnDogVn-.mjs";
-import { a as loadConfig, o as loadPackageConfig, r as getBumpyDir, s as matchGlob } from "./config-CJIj8xG3.mjs";
-import { t as discoverPackages } from "./workspace-c9-TqXed.mjs";
+import { a as loadConfig, o as loadPackageConfig, r as getBumpyDir, s as matchGlob } from "./config-D13G4-R8.mjs";
+import { t as discoverPackages } from "./workspace-BKOAMeki.mjs";
 import { t as DependencyGraph } from "./dep-graph-E-9-eQ2J.mjs";
-import { i as writeBumpFile } from "./bump-file-BTsntOO-.mjs";
+import { i as writeBumpFile } from "./bump-file-CoaSxqne.mjs";
 import { r as getChangedFiles } from "./git-D0__HP86.mjs";
 import { c as ot, d as yt, i as _t, l as pt, o as gt, r as Ot, s as mt, t as unwrap, u as wt } from "./clack-CJT1JFFa.mjs";
 import { n as slugify, t as randomName } from "./names-CBy7d8K_.mjs";

package/dist/{apply-release-plan-Bi9OSWks.mjs → apply-release-plan-BvZ32LAm.mjs}

@@ -1,6 +1,6 @@
 import { a as readJson, c as removeFile, f as writeText, i as listFiles, l as updateJsonFields, n as exists, s as readText, u as updateJsonNestedField } from "./fs-DnDogVn-.mjs";
-import { r as getBumpyDir } from "./config-CJIj8xG3.mjs";
-import { a as prependToChangelog, i as loadFormatter, n as generateChangelogEntry } from "./changelog-xKuL0IKx.mjs";
+import { r as getBumpyDir } from "./config-D13G4-R8.mjs";
+import { a as prependToChangelog, i as loadFormatter, n as generateChangelogEntry } from "./changelog-BIkNBJ15.mjs";
 import { resolve } from "node:path";
 //#region src/core/apply-release-plan.ts
 /** Apply the release plan: bump versions, update changelogs, delete bump files */

package/dist/{bump-file-BTsntOO-.mjs → bump-file-CoaSxqne.mjs}

@@ -1,5 +1,5 @@
 import { f as writeText, i as listFiles, s as readText } from "./fs-DnDogVn-.mjs";
-import { r as getBumpyDir } from "./config-CJIj8xG3.mjs";
+import { r as getBumpyDir } from "./config-D13G4-R8.mjs";
 import { i as jsYaml } from "./package-manager-CClZtIHP.mjs";
 import { s as tryRunArgs } from "./shell-u3bYGxNy.mjs";
 import { resolve } from "node:path";

package/dist/{changelog-xKuL0IKx.mjs → changelog-BIkNBJ15.mjs}

@@ -1,5 +1,5 @@
 import { n as log } from "./logger-C2dEe5Su.mjs";
-import { t as BUMP_LEVELS } from "./types-CSM0c2-m.mjs";
+import { t as BUMP_LEVELS } from "./types-BX4pfmKh.mjs";
 import { relative, resolve } from "node:path";
 import { realpathSync } from "node:fs";
 //#region src/core/changelog.ts
@@ -43,7 +43,7 @@ const defaultFormatter = (ctx) => {
 const BUILTIN_FORMATTERS = {
 	default: defaultFormatter,
 	github: async () => {
-		const { createGithubFormatter } = await import("./changelog-github-CEaDCtTk.mjs");
+		const { createGithubFormatter } = await import("./changelog-github-BAtgxeXv.mjs");
 		return createGithubFormatter();
 	}
 };
@@ -54,7 +54,7 @@ const BUILTIN_FORMATTERS = {
 async function loadFormatter(changelog, rootDir) {
 	const [name, options] = Array.isArray(changelog) ? changelog : [changelog, {}];
 	if (name === "github") {
-		const { createGithubFormatter } = await import("./changelog-github-CEaDCtTk.mjs");
+		const { createGithubFormatter } = await import("./changelog-github-BAtgxeXv.mjs");
 		return createGithubFormatter(options);
 	}
 	if (typeof name === "string" && BUILTIN_FORMATTERS[name]) {
@@ -88,11 +88,12 @@ async function loadFormatter(changelog, rootDir) {
 	return defaultFormatter;
 }
 /** Generate a changelog entry using the configured formatter */
-async function generateChangelogEntry(release, bumpFiles, formatter = defaultFormatter, date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0]) {
+async function generateChangelogEntry(release, bumpFiles, formatter = defaultFormatter, date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0], target = "changelog") {
 	return formatter({
 		release,
 		bumpFiles,
-		date
+		date,
+		target
 	});
 }
 /** Prepend a new entry to an existing CHANGELOG.md content */

package/dist/{changelog-github-CEaDCtTk.mjs → changelog-github-BAtgxeXv.mjs}

@@ -1,5 +1,5 @@
 import { s as tryRunArgs } from "./shell-u3bYGxNy.mjs";
-import { o as sortBumpFilesByType, r as getBumpTypeForPackage } from "./changelog-xKuL0IKx.mjs";
+import { o as sortBumpFilesByType, r as getBumpTypeForPackage } from "./changelog-BIkNBJ15.mjs";
 //#region src/core/changelog-github.ts
 /** Authors filtered from "Thanks" attribution by default (e.g. bots) */
 /** Authors filtered from "Thanks" attribution by default (e.g. AI/automation bots) */

package/dist/{check-D3eXRyKJ.mjs → check-C80o_gJK.mjs}

@@ -1,7 +1,7 @@
 import { n as log, o as __toESM, t as colorize } from "./logger-C2dEe5Su.mjs";
-import { a as loadConfig, o as loadPackageConfig, r as getBumpyDir } from "./config-CJIj8xG3.mjs";
-import { n as discoverWorkspace } from "./workspace-c9-TqXed.mjs";
-import { r as readBumpFiles, t as filterBranchBumpFiles } from "./bump-file-BTsntOO-.mjs";
+import { a as loadConfig, o as loadPackageConfig, r as getBumpyDir } from "./config-D13G4-R8.mjs";
+import { n as discoverWorkspace } from "./workspace-BKOAMeki.mjs";
+import { r as readBumpFiles, t as filterBranchBumpFiles } from "./bump-file-CoaSxqne.mjs";
 import { r as getChangedFiles } from "./git-D0__HP86.mjs";
 import { t as require_picomatch } from "./picomatch-TGJi--_I.mjs";
 import { relative } from "node:path";

package/dist/{ci-BVTwTUUK.mjs → ci-WJ8kTjeN.mjs}

@@ -1,34 +1,28 @@
 import { n as log, t as colorize } from "./logger-C2dEe5Su.mjs";
-import { a as loadConfig } from "./config-CJIj8xG3.mjs";
+import { a as loadConfig } from "./config-D13G4-R8.mjs";
 import { t as detectPackageManager } from "./package-manager-CClZtIHP.mjs";
-import { n as discoverWorkspace } from "./workspace-c9-TqXed.mjs";
+import { n as discoverWorkspace } from "./workspace-BKOAMeki.mjs";
 import { t as DependencyGraph } from "./dep-graph-E-9-eQ2J.mjs";
 import { n as runArgs, r as runArgsAsync, s as tryRunArgs } from "./shell-u3bYGxNy.mjs";
-import { r as readBumpFiles, t as filterBranchBumpFiles } from "./bump-file-BTsntOO-.mjs";
-import { t as assembleReleasePlan } from "./release-plan-21H89Cx1.mjs";
+import { r as readBumpFiles, t as filterBranchBumpFiles } from "./bump-file-CoaSxqne.mjs";
+import { t as assembleReleasePlan } from "./release-plan-RBjKmavL.mjs";
 import { r as getChangedFiles } from "./git-D0__HP86.mjs";
 import { t as randomName } from "./names-CBy7d8K_.mjs";
-import { findChangedPackages } from "./check-D3eXRyKJ.mjs";
+import { findChangedPackages } from "./check-C80o_gJK.mjs";
 import { t as resolveCommitMessage } from "./commit-message-DOIfDxfj.mjs";
 import { createHash } from "node:crypto";
 //#region src/commands/ci.ts
 /**
 * Temporarily override GH_TOKEN with BUMPY_GH_TOKEN for a gh CLI call.
 *
-* Use `--pat-pr` / `--pat-comments` flags to opt in. This is useful when
-* BUMPY_GH_TOKEN belongs to a dedicated automation/bot account. If you're
-* using a developer's personal PAT, it's better to leave these flags off so
-* that PRs and comments appear from github-actions[bot] — allowing the
-* developer to still review and approve the PR.
+* When BUMPY_GH_TOKEN is set (e.g. a dedicated bot PAT or GitHub App token),
+* it is used so that PRs created by bumpy can trigger CI workflows (the
+* default GITHUB_TOKEN cannot do this). If BUMPY_GH_TOKEN is not available
+* (e.g. fork PRs where secrets are hidden), falls back to the default token.
 */
-function requirePatToken() {
+async function withPatToken(fn) {
 	const token = process.env.BUMPY_GH_TOKEN;
-	if (!token) throw new Error("BUMPY_GH_TOKEN must be set when using --pat-pr or --pat-comments");
-	return token;
-}
-async function withPatToken(usePat, fn) {
-	if (!usePat) return fn();
-	const token = requirePatToken();
+	if (!token) return fn();
 	const originalGhToken = process.env.GH_TOKEN;
 	process.env.GH_TOKEN = token;
 	try {
@@ -94,7 +88,7 @@ async function ciCheckCommand(rootDir, opts) {
 	if (prBumpFiles.length === 0) {
 		if (emptyBumpFileIds.length > 0 && parseErrors.length === 0) {
 			log.success("Empty bump file found — no releases needed.");
-			if (shouldComment && prNumber) await postOrUpdatePrComment(prNumber, formatEmptyBumpFileComment(emptyBumpFileIds, prNumber, detectPrBranch(rootDir)), rootDir, opts.patComments);
+			if (shouldComment && prNumber) await postOrUpdatePrComment(prNumber, formatEmptyBumpFileComment(emptyBumpFileIds, prNumber, detectPrBranch(rootDir)), rootDir);
 			return;
 		}
 		const willFail = !opts.noFail || parseErrors.length > 0;
@@ -103,7 +97,7 @@ async function ciCheckCommand(rootDir, opts) {
 		else log.warn(msg);
 		if (shouldComment && prNumber) {
 			const prBranch = detectPrBranch(rootDir);
-			await postOrUpdatePrComment(prNumber, parseErrors.length > 0 ? formatBumpFileErrorsComment(parseErrors, prBranch, pm) : formatNoBumpFilesComment(prBranch, pm), rootDir, opts.patComments);
+			await postOrUpdatePrComment(prNumber, parseErrors.length > 0 ? formatBumpFileErrorsComment(parseErrors, prBranch, pm) : formatNoBumpFilesComment(prBranch, pm), rootDir);
 		}
 		if (willFail) process.exit(1);
 		return;
@@ -115,7 +109,7 @@ async function ciCheckCommand(rootDir, opts) {
 		console.log(`  ${r.name}: ${r.oldVersion} → ${colorize(r.newVersion, "cyan")}${tag}`);
 	}
 	if (plan.warnings.length > 0) for (const w of plan.warnings) log.warn(w);
-	if (shouldComment && prNumber) await postOrUpdatePrComment(prNumber, formatReleasePlanComment(plan, prBumpFiles, prNumber, detectPrBranch(rootDir), pm, plan.warnings, parseErrors, emptyBumpFileIds), rootDir, opts.patComments);
+	if (shouldComment && prNumber) await postOrUpdatePrComment(prNumber, formatReleasePlanComment(plan, prBumpFiles, prNumber, detectPrBranch(rootDir), pm, plan.warnings, parseErrors, emptyBumpFileIds), rootDir);
 	if (parseErrors.length > 0 && !opts.noFail) process.exit(1);
 	const coveredPackages = new Set(plan.releases.map((r) => r.name));
 	const missing = (await findChangedPackages(changedFiles, packages, rootDir, config)).filter((name) => !coveredPackages.has(name));
@@ -141,7 +135,7 @@ async function ciReleaseCommand(rootDir, opts) {
 	}
 	if (bumpFiles.length === 0) {
 		log.info("No pending bump files — checking for unpublished packages...");
-		const { publishCommand } = await import("./publish-BwidFqbo.mjs");
+		const { publishCommand } = await import("./publish-CfZCAlPx.mjs");
 		await publishCommand(rootDir, { tag: opts.tag });
 		return;
 	}
@@ -151,11 +145,11 @@ async function ciReleaseCommand(rootDir, opts) {
 		return;
 	}
 	if (opts.mode === "auto-publish") await autoPublish(rootDir, config, plan, opts.tag);
-	else await createVersionPr(rootDir, plan, config, new Map([...packages.values()].map((p) => [p.name, p.relativeDir])), opts.branch, opts.patPr);
+	else await createVersionPr(rootDir, plan, config, new Map([...packages.values()].map((p) => [p.name, p.relativeDir])), opts.branch);
 }
 async function autoPublish(rootDir, config, plan, tag) {
 	log.step("Running bumpy version...");
-	const { versionCommand } = await import("./version-ClkaCNTE.mjs");
+	const { versionCommand } = await import("./version-DLU0h1cq.mjs");
 	await versionCommand(rootDir);
 	log.step("Committing version changes...");
 	runArgs([
@@ -184,7 +178,7 @@ async function autoPublish(rootDir, config, plan, tag) {
 		], { cwd: rootDir });
 	}
 	log.step("Running bumpy publish...");
-	const { publishCommand } = await import("./publish-BwidFqbo.mjs");
+	const { publishCommand } = await import("./publish-CfZCAlPx.mjs");
 	await publishCommand(rootDir, { tag });
 }
 /**
@@ -306,7 +300,7 @@ function pushWithToken(rootDir, branch, config) {
 		if (!token && repo) log.warn("BUMPY_GH_TOKEN is not set — PR checks will not trigger automatically.\n  Run `bumpy ci setup` for help.");
 	}
 }
-async function createVersionPr(rootDir, plan, config, packageDirs, branchName, patPr) {
+async function createVersionPr(rootDir, plan, config, packageDirs, branchName) {
 	const branch = validateBranchName(branchName || config.versionPr.branch);
 	const baseBranch = validateBranchName(tryRunArgs([
 		"git",
@@ -350,7 +344,7 @@ async function createVersionPr(rootDir, plan, config, packageDirs, branchName, p
 		branch
 	], { cwd: rootDir });
 	log.step("Running bumpy version...");
-	const { versionCommand } = await import("./version-ClkaCNTE.mjs");
+	const { versionCommand } = await import("./version-DLU0h1cq.mjs");
 	await versionCommand(rootDir);
 	runArgs([
 		"git",
@@ -381,11 +375,12 @@ async function createVersionPr(rootDir, plan, config, packageDirs, branchName, p
 	});
 	pushWithToken(rootDir, branch, config);
 	const repo = process.env.GITHUB_REPOSITORY;
+	const noPatWarning = !process.env.BUMPY_GH_TOKEN && !!repo;
 	if (existingPr) {
 		const validPr = validatePrNumber(existingPr);
-		const prBody = formatVersionPrBody(plan, config.versionPr.preamble, packageDirs, repo, validPr);
+		const prBody = formatVersionPrBody(plan, config.versionPr.preamble, packageDirs, repo, validPr, noPatWarning);
 		log.step(`Updating existing PR #${validPr}...`);
-		await withPatToken(!!patPr, () => runArgsAsync([
+		await withPatToken(() => runArgsAsync([
 			"gh",
 			"pr",
 			"edit",
@@ -402,8 +397,8 @@ async function createVersionPr(rootDir, plan, config, packageDirs, branchName, p
 	} else {
 		log.step("Creating version PR...");
 		const prTitle = config.versionPr.title;
-		const prBody = formatVersionPrBody(plan, config.versionPr.preamble, packageDirs, repo, null);
-		const result = await withPatToken(!!patPr, () => runArgsAsync([
+		const prBody = formatVersionPrBody(plan, config.versionPr.preamble, packageDirs, repo, null, noPatWarning);
+		const result = await withPatToken(() => runArgsAsync([
 			"gh",
 			"pr",
 			"create",
@@ -423,8 +418,8 @@ async function createVersionPr(rootDir, plan, config, packageDirs, branchName, p
 		if (repo) {
 			const newPrNumber = result?.match(/\/pull\/(\d+)/)?.[1];
 			if (newPrNumber) {
-				const updatedBody = formatVersionPrBody(plan, config.versionPr.preamble, packageDirs, repo, newPrNumber);
-				await withPatToken(!!patPr, () => runArgsAsync([
+				const updatedBody = formatVersionPrBody(plan, config.versionPr.preamble, packageDirs, repo, newPrNumber, noPatWarning);
+				await withPatToken(() => runArgsAsync([
 					"gh",
 					"pr",
 					"edit",
@@ -437,7 +432,7 @@ async function createVersionPr(rootDir, plan, config, packageDirs, branchName, p
 				}));
 			}
 		}
-		if (!patPr) pushWithToken(rootDir, branch, config);
+		if (!process.env.BUMPY_GH_TOKEN) pushWithToken(rootDir, branch, config);
 	}
 	runArgs([
 		"git",
@@ -619,7 +614,7 @@ function buildDiffLinks(pkgDir, changesBaseUrl) {
 function sha256Hex(input) {
 	return createHash("sha256").update(input).digest("hex");
 }
-function formatVersionPrBody(plan, preamble, packageDirs, repo, prNumber) {
+function formatVersionPrBody(plan, preamble, packageDirs, repo, prNumber, showNoPatWarning = false) {
 	const changesBaseUrl = repo && prNumber ? `https://github.com/${repo}/pull/${prNumber}/changes` : null;
 	const lines = [];
 	lines.push(preamble);
@@ -658,10 +653,14 @@ function formatVersionPrBody(plan, preamble, packageDirs, repo, prNumber) {
 			lines.push("");
 		}
 	}
+	if (showNoPatWarning) {
+		lines.push("> ⚠️ `BUMPY_GH_TOKEN` is not set — CI checks will not run automatically on this PR. Run `bumpy ci setup` for help.");
+		lines.push("");
+	}
 	return lines.join("\n");
 }
 const COMMENT_MARKER = "<!-- bumpy-release-plan -->";
-async function postOrUpdatePrComment(prNumber, body, rootDir, usePat = false) {
+async function postOrUpdatePrComment(prNumber, body, rootDir) {
 	const validPr = validatePrNumber(prNumber);
 	const markedBody = `${COMMENT_MARKER}\n${body}`;
 	try {
@@ -676,7 +675,7 @@ async function postOrUpdatePrComment(prNumber, body, rootDir, usePat = false) {
 			`.comments[] | select(.body | startswith("${COMMENT_MARKER}")) | .url | capture("issuecomment-(?<id>[0-9]+)$") | .id`
 		], { cwd: rootDir })?.split("\n")[0]?.trim();
 		if (commentId) {
-			await withPatToken(usePat, () => runArgsAsync([
+			await runArgsAsync([
 				"gh",
 				"api",
 				`repos/{owner}/{repo}/issues/comments/${commentId}`,
@@ -687,10 +686,10 @@ async function postOrUpdatePrComment(prNumber, body, rootDir, usePat = false) {
 			], {
 				cwd: rootDir,
 				input: markedBody
-			}));
+			});
 			log.dim("  Updated PR comment");
 		} else {
-			await withPatToken(usePat, () => runArgsAsync([
+			await runArgsAsync([
 				"gh",
 				"pr",
 				"comment",
@@ -700,7 +699,7 @@ async function postOrUpdatePrComment(prNumber, body, rootDir, usePat = false) {
 			], {
 				cwd: rootDir,
 				input: markedBody
-			}));
+			});
 			log.dim("  Posted PR comment");
 		}
 	} catch (err) {

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { n as log, t as colorize } from "./logger-C2dEe5Su.mjs";
-import { n as findRoot } from "./config-CJIj8xG3.mjs";
+import { n as findRoot } from "./config-D13G4-R8.mjs";
 //#region src/cli.ts
 const args = process.argv.slice(2);
 const command = args[0];
@@ -31,7 +31,7 @@ async function main() {
 			}
 			case "add": {
 				const rootDir = await findRoot();
-				const { addCommand } = await import("./add-DEqGa5gI.mjs");
+				const { addCommand } = await import("./add-ET1tcdQm.mjs");
 				await addCommand(rootDir, {
 					packages: flags.packages,
 					message: flags.message,
@@ -42,7 +42,7 @@ async function main() {
 			}
 			case "status": {
 				const rootDir = await findRoot();
-				const { statusCommand } = await import("./status-CDGxgXWd.mjs");
+				const { statusCommand } = await import("./status-pMfPtt1p.mjs");
 				await statusCommand(rootDir, {
 					json: flags.json === true,
 					packagesOnly: flags.packages === true,
@@ -54,13 +54,13 @@ async function main() {
 			}
 			case "version": {
 				const rootDir = await findRoot();
-				const { versionCommand } = await import("./version-ClkaCNTE.mjs");
+				const { versionCommand } = await import("./version-DLU0h1cq.mjs");
 				await versionCommand(rootDir, { commit: flags.commit === true });
 				break;
 			}
 			case "generate": {
 				const rootDir = await findRoot();
-				const { generateCommand } = await import("./generate-wHN6Ll6p.mjs");
+				const { generateCommand } = await import("./generate-BJq--oCu.mjs");
 				await generateCommand(rootDir, {
 					from: flags.from,
 					dryRun: flags["dry-run"] === true,
@@ -70,7 +70,7 @@ async function main() {
 			}
 			case "check": {
 				const rootDir = await findRoot();
-				const { checkCommand } = await import("./check-D3eXRyKJ.mjs");
+				const { checkCommand } = await import("./check-C80o_gJK.mjs");
 				await checkCommand(rootDir, {
 					strict: flags.strict === true,
 					noFail: flags["no-fail"] === true
@@ -82,20 +82,18 @@ async function main() {
 				const subcommand = args[1];
 				const ciFlags = parseFlags(args.slice(2));
 				if (subcommand === "check") {
-					const { ciCheckCommand } = await import("./ci-BVTwTUUK.mjs");
+					const { ciCheckCommand } = await import("./ci-WJ8kTjeN.mjs");
 					await ciCheckCommand(rootDir, {
 						comment: ciFlags.comment !== void 0 ? ciFlags.comment === true : void 0,
 						strict: ciFlags.strict === true,
-						noFail: ciFlags["no-fail"] === true,
-						patComments: ciFlags["pat-comments"] === true
+						noFail: ciFlags["no-fail"] === true
 					});
 				} else if (subcommand === "release") {
-					const { ciReleaseCommand } = await import("./ci-BVTwTUUK.mjs");
+					const { ciReleaseCommand } = await import("./ci-WJ8kTjeN.mjs");
 					await ciReleaseCommand(rootDir, {
 						mode: ciFlags["auto-publish"] === true ? "auto-publish" : "version-pr",
 						tag: ciFlags.tag,
-						branch: ciFlags.branch,
-						patPr: ciFlags["pat-pr"] === true
+						branch: ciFlags.branch
 					});
 				} else if (subcommand === "setup") {
 					const { ciSetupCommand } = await import("./ci-setup-D1NCzbNH.mjs");
@@ -108,7 +106,7 @@ async function main() {
 			}
 			case "publish": {
 				const rootDir = await findRoot();
-				const { publishCommand } = await import("./publish-BwidFqbo.mjs");
+				const { publishCommand } = await import("./publish-CfZCAlPx.mjs");
 				await publishCommand(rootDir, {
 					dryRun: flags["dry-run"] === true,
 					tag: flags.tag,
@@ -132,7 +130,7 @@ async function main() {
 			}
 			case "--version":
 			case "-v":
-				console.log(`bumpy 1.2.2`);
+				console.log(`bumpy 1.3.0`);
 				break;
 			case "help":
 			case "--help":
@@ -152,7 +150,7 @@ async function main() {
 }
 function printHelp() {
 	console.log(`
-  ${colorize(`🐸 bumpy v1.2.2`, "bold")} - Modern monorepo versioning
+  ${colorize(`🐸 bumpy v1.3.0`, "bold")} - Modern monorepo versioning
 
   Usage: bumpy <command> [options]
 
@@ -206,7 +204,7 @@ function printHelp() {
     --branch <name>         Branch name for version PR (default: bumpy/version-packages)
 
   AI setup options:
-    --target <tool>         Target AI tool: opencode, cursor, codex
+    --target <tool>         Target AI tool: claude, opencode, cursor, codex
 
   ${colorize("https://bumpy.varlock.dev", "dim")}
 `);

package/dist/{config-CJIj8xG3.mjs → config-D13G4-R8.mjs}

@@ -1,6 +1,6 @@
 import { a as __exportAll } from "./logger-C2dEe5Su.mjs";
 import { a as readJson, n as exists, o as readJsonc } from "./fs-DnDogVn-.mjs";
-import { r as DEFAULT_CONFIG } from "./types-CSM0c2-m.mjs";
+import { r as DEFAULT_CONFIG } from "./types-BX4pfmKh.mjs";
 import { resolve } from "node:path";
 //#region src/core/config.ts
 var config_exports = /* @__PURE__ */ __exportAll({

package/dist/{generate-wHN6Ll6p.mjs → generate-BJq--oCu.mjs}

@@ -1,9 +1,9 @@
 import { n as log, t as colorize } from "./logger-C2dEe5Su.mjs";
 import { t as ensureDir } from "./fs-DnDogVn-.mjs";
-import { a as loadConfig, r as getBumpyDir } from "./config-CJIj8xG3.mjs";
-import { t as discoverPackages } from "./workspace-c9-TqXed.mjs";
+import { a as loadConfig, r as getBumpyDir } from "./config-D13G4-R8.mjs";
+import { t as discoverPackages } from "./workspace-BKOAMeki.mjs";
 import { s as tryRunArgs } from "./shell-u3bYGxNy.mjs";
-import { i as writeBumpFile } from "./bump-file-BTsntOO-.mjs";
+import { i as writeBumpFile } from "./bump-file-CoaSxqne.mjs";
 import { a as getFilesChangedInCommit, n as getBranchCommits } from "./git-D0__HP86.mjs";
 import { n as slugify, t as randomName } from "./names-CBy7d8K_.mjs";
 import { relative } from "node:path";

package/dist/index.d.mts

@@ -231,6 +231,8 @@ interface ChangelogContext {
   bumpFiles: BumpFile[];
   /** ISO date string (YYYY-MM-DD) */
   date: string;
+  /** Where this entry will be used — formatters can customize output per target (default: 'changelog') */
+  target?: 'changelog' | 'github-release';
 }
 /**
  * A changelog formatter receives full context and returns the complete
@@ -245,7 +247,7 @@ declare const defaultFormatter: ChangelogFormatter;
  */
 declare function loadFormatter(changelog: BumpyConfig['changelog'], rootDir: string): Promise<ChangelogFormatter>;
 /** Generate a changelog entry using the configured formatter */
-declare function generateChangelogEntry(release: PlannedRelease, bumpFiles: BumpFile[], formatter?: ChangelogFormatter, date?: string): Promise<string>;
+declare function generateChangelogEntry(release: PlannedRelease, bumpFiles: BumpFile[], formatter?: ChangelogFormatter, date?: string, target?: ChangelogContext['target']): Promise<string>;
 /** Prepend a new entry to an existing CHANGELOG.md content */
 declare function prependToChangelog(existingContent: string, newEntry: string): string;
 //#endregion

package/dist/index.mjs

@@ -1,11 +1,11 @@
-import { a as DEP_TYPES, c as maxBump, i as DEFAULT_PUBLISH_CONFIG, n as DEFAULT_BUMP_RULES, o as bumpLevel, r as DEFAULT_CONFIG, s as hasCascade, t as BUMP_LEVELS } from "./types-CSM0c2-m.mjs";
-import { a as loadConfig, n as findRoot, r as getBumpyDir, s as matchGlob } from "./config-CJIj8xG3.mjs";
-import { t as discoverPackages } from "./workspace-c9-TqXed.mjs";
+import { a as DEP_TYPES, c as maxBump, i as DEFAULT_PUBLISH_CONFIG, n as DEFAULT_BUMP_RULES, o as bumpLevel, r as DEFAULT_CONFIG, s as hasCascade, t as BUMP_LEVELS } from "./types-BX4pfmKh.mjs";
+import { a as loadConfig, n as findRoot, r as getBumpyDir, s as matchGlob } from "./config-D13G4-R8.mjs";
+import { t as discoverPackages } from "./workspace-BKOAMeki.mjs";
 import { t as DependencyGraph } from "./dep-graph-E-9-eQ2J.mjs";
-import { i as writeBumpFile, n as parseBumpFile, r as readBumpFiles } from "./bump-file-BTsntOO-.mjs";
+import { i as writeBumpFile, n as parseBumpFile, r as readBumpFiles } from "./bump-file-CoaSxqne.mjs";
 import { n as satisfies, r as stripProtocol, t as bumpVersion } from "./semver-DfQyVLM_.mjs";
-import { t as assembleReleasePlan } from "./release-plan-21H89Cx1.mjs";
-import { a as prependToChangelog, i as loadFormatter, n as generateChangelogEntry, t as defaultFormatter } from "./changelog-xKuL0IKx.mjs";
-import { t as applyReleasePlan } from "./apply-release-plan-Bi9OSWks.mjs";
+import { t as assembleReleasePlan } from "./release-plan-RBjKmavL.mjs";
+import { a as prependToChangelog, i as loadFormatter, n as generateChangelogEntry, t as defaultFormatter } from "./changelog-BIkNBJ15.mjs";
+import { t as applyReleasePlan } from "./apply-release-plan-BvZ32LAm.mjs";
 import { t as publishPackages } from "./publish-pipeline-BvLIu7WF.mjs";
 export { BUMP_LEVELS, DEFAULT_BUMP_RULES, DEFAULT_CONFIG, DEFAULT_PUBLISH_CONFIG, DEP_TYPES, DependencyGraph, applyReleasePlan, assembleReleasePlan, bumpLevel, bumpVersion, defaultFormatter, discoverPackages, findRoot, generateChangelogEntry, getBumpyDir, hasCascade, loadConfig, loadFormatter, matchGlob, maxBump, parseBumpFile, prependToChangelog, publishPackages, readBumpFiles, satisfies, stripProtocol, writeBumpFile };

package/dist/{publish-BwidFqbo.mjs → publish-CfZCAlPx.mjs}

@@ -1,9 +1,10 @@
 import { n as log, t as colorize } from "./logger-C2dEe5Su.mjs";
-import { a as loadConfig } from "./config-CJIj8xG3.mjs";
+import { a as loadConfig } from "./config-D13G4-R8.mjs";
 import { n as detectWorkspaces } from "./package-manager-CClZtIHP.mjs";
-import { n as discoverWorkspace } from "./workspace-c9-TqXed.mjs";
+import { n as discoverWorkspace } from "./workspace-BKOAMeki.mjs";
 import { t as DependencyGraph } from "./dep-graph-E-9-eQ2J.mjs";
 import { r as runArgsAsync, s as tryRunArgs } from "./shell-u3bYGxNy.mjs";
+import { i as loadFormatter, n as generateChangelogEntry } from "./changelog-BIkNBJ15.mjs";
 import { c as pushWithTags, o as hasUncommittedChanges, s as listTags } from "./git-D0__HP86.mjs";
 import { t as publishPackages } from "./publish-pipeline-BvLIu7WF.mjs";
 //#region src/core/github-release.ts
@@ -24,7 +25,7 @@ async function createIndividualReleases(releases, bumpFiles, rootDir, opts = {})
 	const headSha = getHeadSha(rootDir);
 	for (const release of releases) {
 		const tag = `${release.name}@${release.newVersion}`;
-		const body = buildReleaseBody(release, bumpFiles);
+		const body = opts.formatter ? await generateReleaseBody(release, bumpFiles, opts.formatter) : buildReleaseBody(release, bumpFiles);
 		const title = `${release.name} v${release.newVersion}`;
 		if (opts.dryRun) {
 			log.dim(`  Would create GitHub release: ${title}`);
@@ -58,7 +59,7 @@ async function createAggregateRelease(releases, bumpFiles, rootDir, opts = {}) {
 	if (releases.length === 0) return;
 	const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
 	const { tag, title } = resolveAggregateTagAndTitle(date, listTags(`release-${date}*`, { cwd: rootDir }), opts.title);
-	const body = buildAggregateBody(releases, bumpFiles);
+	const body = opts.formatter ? await generateAggregateBody(releases, bumpFiles, opts.formatter) : buildAggregateBody(releases, bumpFiles);
 	if (opts.dryRun) {
 		log.dim(`  Would create aggregate GitHub release: ${title}`);
 		log.dim(`  Tag: ${tag}`);
@@ -88,6 +89,36 @@ async function createAggregateRelease(releases, bumpFiles, rootDir, opts = {}) {
 		log.warn(`Failed to create aggregate GitHub release: ${err instanceof Error ? err.message : err}`);
 	}
 }
+/** Generate a release body for a single package using the changelog formatter */
+async function generateReleaseBody(release, bumpFiles, formatter) {
+	return stripVersionHeading(await generateChangelogEntry(release, bumpFiles, formatter, void 0, "github-release")).trim() || "No changelog entries.";
+}
+/** Generate an aggregate release body using the changelog formatter */
+async function generateAggregateBody(releases, bumpFiles, formatter) {
+	const lines = [];
+	const groups = [
+		["Major Changes", releases.filter((r) => r.type === "major")],
+		["Minor Changes", releases.filter((r) => r.type === "minor")],
+		["Patch Changes", releases.filter((r) => r.type === "patch")]
+	];
+	for (const [heading, group] of groups) {
+		if (group.length === 0) continue;
+		lines.push(`## ${heading}\n`);
+		for (const release of group) {
+			lines.push(`### ${release.name} v${release.newVersion}\n`);
+			const body = stripVersionHeading(await generateChangelogEntry(release, bumpFiles, formatter, void 0, "github-release")).trim();
+			if (body) lines.push(body);
+			else if (release.isDependencyBump) lines.push("- Updated dependencies");
+			else if (release.isCascadeBump) lines.push("- Version bump via cascade rule");
+			lines.push("");
+		}
+	}
+	return lines.join("\n").trim() || "No changelog entries.";
+}
+/** Strip the leading ## version heading and date sub-heading from a changelog entry */
+function stripVersionHeading(entry) {
+	return entry.replace(/^## .+\n/, "").replace(/^<sub>.+<\/sub>\n/, "").replace(/^_.+_\n/, "");
+}
 function buildReleaseBody(release, bumpFiles) {
 	const lines = [];
 	const relevant = bumpFiles.filter((bf) => release.bumpFiles.includes(bf.id));
@@ -148,7 +179,7 @@ async function publishCommand(rootDir, opts) {
 	}
 	let toPublish = await findUnpublishedPackages(packages, config);
 	if (opts.filter) {
-		const { matchGlob } = await import("./config-CJIj8xG3.mjs").then((n) => n.t);
+		const { matchGlob } = await import("./config-D13G4-R8.mjs").then((n) => n.t);
 		const patterns = opts.filter.split(",").map((p) => p.trim());
 		toPublish = toPublish.filter((r) => patterns.some((p) => matchGlob(r.name, p)));
 	}
@@ -187,11 +218,16 @@ async function publishCommand(rootDir, opts) {
 		const aggConfig = config.aggregateRelease;
 		const isAggregate = aggConfig === true || typeof aggConfig === "object" && aggConfig.enabled;
 		const aggTitle = typeof aggConfig === "object" ? aggConfig.title : void 0;
+		const formatter = config.changelog !== false ? await loadFormatter(config.changelog, rootDir) : void 0;
 		if (isAggregate) await createAggregateRelease(publishedReleases, releasePlan.bumpFiles, rootDir, {
 			dryRun: opts.dryRun,
-			title: aggTitle
+			title: aggTitle,
+			formatter
+		});
+		else await createIndividualReleases(publishedReleases, releasePlan.bumpFiles, rootDir, {
+			dryRun: opts.dryRun,
+			formatter
 		});
-		else await createIndividualReleases(publishedReleases, releasePlan.bumpFiles, rootDir, { dryRun: opts.dryRun });
 	}
 }
 /**

package/dist/{release-plan-21H89Cx1.mjs → release-plan-RBjKmavL.mjs}

@@ -1,5 +1,5 @@
-import { c as maxBump, n as DEFAULT_BUMP_RULES, o as bumpLevel, s as hasCascade } from "./types-CSM0c2-m.mjs";
-import { s as matchGlob } from "./config-CJIj8xG3.mjs";
+import { c as maxBump, n as DEFAULT_BUMP_RULES, o as bumpLevel, s as hasCascade } from "./types-BX4pfmKh.mjs";
+import { s as matchGlob } from "./config-D13G4-R8.mjs";
 import { n as satisfies, t as bumpVersion } from "./semver-DfQyVLM_.mjs";
 //#region src/core/release-plan.ts
 /**

package/dist/{status-CDGxgXWd.mjs → status-pMfPtt1p.mjs}

@@ -1,9 +1,9 @@
 import { n as log, t as colorize } from "./logger-C2dEe5Su.mjs";
-import { a as loadConfig } from "./config-CJIj8xG3.mjs";
-import { t as discoverPackages } from "./workspace-c9-TqXed.mjs";
+import { a as loadConfig } from "./config-D13G4-R8.mjs";
+import { t as discoverPackages } from "./workspace-BKOAMeki.mjs";
 import { t as DependencyGraph } from "./dep-graph-E-9-eQ2J.mjs";
-import { r as readBumpFiles, t as filterBranchBumpFiles } from "./bump-file-BTsntOO-.mjs";
-import { t as assembleReleasePlan } from "./release-plan-21H89Cx1.mjs";
+import { r as readBumpFiles, t as filterBranchBumpFiles } from "./bump-file-CoaSxqne.mjs";
+import { t as assembleReleasePlan } from "./release-plan-RBjKmavL.mjs";
 import { i as getCurrentBranch, r as getChangedFiles } from "./git-D0__HP86.mjs";
 //#region src/commands/status.ts
 async function statusCommand(rootDir, opts) {
@@ -31,7 +31,7 @@ async function statusCommand(rootDir, opts) {
 		releases = releases.filter((r) => types.includes(r.type));
 	}
 	if (opts.filter) {
-		const { matchGlob } = await import("./config-CJIj8xG3.mjs").then((n) => n.t);
+		const { matchGlob } = await import("./config-D13G4-R8.mjs").then((n) => n.t);
 		const patterns = opts.filter.split(",").map((p) => p.trim());
 		releases = releases.filter((r) => patterns.some((p) => matchGlob(r.name, p)));
 	}

package/dist/{types-CSM0c2-m.mjs → types-BX4pfmKh.mjs}

@@ -66,7 +66,7 @@ const DEFAULT_CONFIG = {
 		title: "🐸 Versioned release",
 		branch: "bumpy/version-packages",
 		preamble: [
-			`<a href="https://bumpy.varlock.dev"><img src="https://raw.githubusercontent.com/dmno-dev/bumpy/main/images/frog-party.png" alt="bumpy-frog" width="60" align="left" style="image-rendering: pixelated;" title="Hi! I'm bumpy!" /></a>`,
+			`<a href="https://bumpy.varlock.dev"><img src="https://raw.githubusercontent.com/dmno-dev/bumpy/main/images/frog-clipboard.png" alt="bumpy-frog" width="60" align="left" style="image-rendering: pixelated;" title="Hi! I'm bumpy!" /></a>`,
 			"",
 			`This PR was created and will be kept in sync by [bumpy](https://bumpy.varlock.dev) based on your bump files (in \`.bumpy/\`). Merge it when you are ready to release the packages listed below:`,
 			"<br clear=\"left\" />"

package/dist/{version-ClkaCNTE.mjs → version-DLU0h1cq.mjs}

@@ -1,12 +1,12 @@
 import { n as log, t as colorize } from "./logger-C2dEe5Su.mjs";
-import { a as loadConfig } from "./config-CJIj8xG3.mjs";
+import { a as loadConfig } from "./config-D13G4-R8.mjs";
 import { n as detectWorkspaces } from "./package-manager-CClZtIHP.mjs";
-import { t as discoverPackages } from "./workspace-c9-TqXed.mjs";
+import { t as discoverPackages } from "./workspace-BKOAMeki.mjs";
 import { t as DependencyGraph } from "./dep-graph-E-9-eQ2J.mjs";
 import { n as runArgs, s as tryRunArgs } from "./shell-u3bYGxNy.mjs";
-import { r as readBumpFiles } from "./bump-file-BTsntOO-.mjs";
-import { t as assembleReleasePlan } from "./release-plan-21H89Cx1.mjs";
-import { t as applyReleasePlan } from "./apply-release-plan-Bi9OSWks.mjs";
+import { r as readBumpFiles } from "./bump-file-CoaSxqne.mjs";
+import { t as assembleReleasePlan } from "./release-plan-RBjKmavL.mjs";
+import { t as applyReleasePlan } from "./apply-release-plan-BvZ32LAm.mjs";
 import { t as resolveCommitMessage } from "./commit-message-DOIfDxfj.mjs";
 //#region src/commands/version.ts
 async function versionCommand(rootDir, opts = {}) {

package/dist/{workspace-c9-TqXed.mjs → workspace-BKOAMeki.mjs}

@@ -1,5 +1,5 @@
 import { a as readJson, n as exists } from "./fs-DnDogVn-.mjs";
-import { i as isPackageManaged, o as loadPackageConfig } from "./config-CJIj8xG3.mjs";
+import { i as isPackageManaged, o as loadPackageConfig } from "./config-D13G4-R8.mjs";
 import { n as detectWorkspaces } from "./package-manager-CClZtIHP.mjs";
 import { relative, resolve } from "node:path";
 import { readdir, stat } from "node:fs/promises";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@varlock/bumpy",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "Modern monorepo versioning and changelog tool",
   "keywords": [
     "bump",