@ucdjs/release-scripts 0.1.0-beta.4 → 0.1.0-beta.41

package/dist/index.mjs

@@ -1,16 +1,114 @@
+import { t as Eta } from "./eta-DAZlmVBQ.mjs";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { getCommits, groupByType } from "commit-parser";
 import process from "node:process";
-import { getCommits } from "commit-parser";
+import readline from "node:readline";
 import farver from "farver";
+import mri from "mri";
 import { exec } from "tinyexec";
 import { dedent } from "@luxass/utils";
-import { Eta } from "eta";
-import { readFile, writeFile } from "node:fs/promises";
-import { join } from "node:path";
 import prompts from "prompts";
+import { compare, gt } from "semver";
 
-//#region src/utils.ts
-const globalOptions = { dryRun: false };
+//#region src/operations/changelog-format.ts
+function formatCommitLine({ commit, owner, repo, authors }) {
+	const commitUrl = `https://github.com/${owner}/${repo}/commit/${commit.hash}`;
+	let line = `${commit.description}`;
+	const references = commit.references ?? [];
+	for (const ref of references) {
+		if (!ref.value) continue;
+		const number = Number.parseInt(ref.value.replace(/^#/, ""), 10);
+		if (Number.isNaN(number)) continue;
+		if (ref.type === "issue") {
+			line += ` ([Issue ${ref.value}](https://github.com/${owner}/${repo}/issues/${number}))`;
+			continue;
+		}
+		line += ` ([PR ${ref.value}](https://github.com/${owner}/${repo}/pull/${number}))`;
+	}
+	line += ` ([${commit.shortHash}](${commitUrl}))`;
+	if (authors.length > 0) {
+		const authorList = authors.map((author) => author.login ? `[@${author.login}](https://github.com/${author.login})` : author.name).join(", ");
+		line += ` (by ${authorList})`;
+	}
+	return line;
+}
+function buildTemplateGroups(options) {
+	const { commits, owner, repo, types, commitAuthors } = options;
+	const grouped = groupByType(commits, {
+		includeNonConventional: false,
+		mergeKeys: Object.fromEntries(Object.entries(types).map(([key, value]) => [key, value.types ?? [key]]))
+	});
+	return Object.entries(types).map(([key, value]) => {
+		const formattedCommits = (grouped.get(key) ?? []).map((commit) => ({ line: formatCommitLine({
+			commit,
+			owner,
+			repo,
+			authors: commitAuthors.get(commit.hash) ?? []
+		}) }));
+		return {
+			name: key,
+			title: value.title,
+			commits: formattedCommits
+		};
+	});
+}
+
+//#endregion
+//#region src/shared/utils.ts
+const args = mri(process.argv.slice(2));
+const isDryRun = !!args.dry;
+const isVerbose = !!args.verbose;
+const isForce = !!args.force;
+const ucdjsReleaseOverridesPath = ".github/ucdjs-release.overrides.json";
 const isCI = typeof process.env.CI === "string" && process.env.CI !== "" && process.env.CI.toLowerCase() !== "false";
+const logger = {
+	info: (...args) => {
+		console.info(...args);
+	},
+	warn: (...args) => {
+		console.warn(`  ${farver.yellow("⚠")}`, ...args);
+	},
+	error: (...args) => {
+		console.error(`  ${farver.red("✖")}`, ...args);
+	},
+	verbose: (...args) => {
+		if (!isVerbose) return;
+		if (args.length === 0) {
+			console.log();
+			return;
+		}
+		if (args.length > 1 && typeof args[0] === "string") {
+			console.log(farver.dim(args[0]), ...args.slice(1));
+			return;
+		}
+		console.log(...args);
+	},
+	section: (title) => {
+		console.log();
+		console.log(`  ${farver.bold(title)}`);
+		console.log(`  ${farver.gray("─".repeat(title.length + 2))}`);
+	},
+	emptyLine: () => {
+		console.log();
+	},
+	item: (message, ...args) => {
+		console.log(`  ${message}`, ...args);
+	},
+	step: (message) => {
+		console.log(`  ${farver.blue("→")} ${message}`);
+	},
+	success: (message) => {
+		console.log(`  ${farver.green("✓")} ${message}`);
+	},
+	clearScreen: () => {
+		const repeatCount = process.stdout.rows - 2;
+		const blank = repeatCount > 0 ? "\n".repeat(repeatCount) : "";
+		console.log(blank);
+		readline.cursorTo(process.stdout, 0, 0);
+		readline.clearScreenDown(process.stdout);
+	}
+};
 async function run(bin, args, opts = {}) {
 	return exec(bin, args, {
 		throwOnError: true,
@@ -22,115 +120,292 @@ async function run(bin, args, opts = {}) {
 	});
 }
 async function dryRun(bin, args, opts) {
-	return console.log(farver.blue(`[dryrun] ${bin} ${args.join(" ")}`), opts || "");
+	return logger.verbose(farver.blue(`[dryrun] ${bin} ${args.join(" ")}`), opts || "");
+}
+const runIfNotDry = isDryRun ? dryRun : run;
+function exitWithError(message, hint) {
+	logger.error(farver.bold(message));
+	if (hint) console.error(farver.gray(`  ${hint}`));
+	process.exit(1);
+}
+if (isDryRun || isVerbose || isForce) {
+	logger.verbose(farver.inverse(farver.yellow(" Running with special flags ")));
+	logger.verbose({
+		isDryRun,
+		isVerbose,
+		isForce
+	});
+	logger.verbose();
 }
-const runIfNotDry = globalOptions.dryRun ? dryRun : run;
 
 //#endregion
-//#region src/commits.ts
-async function getLastPackageTag(packageName, workspaceRoot) {
-	const { stdout } = await run("git", ["tag", "--list"], { nodeOptions: {
-		cwd: workspaceRoot,
-		stdio: "pipe"
-	} });
-	return stdout.split("\n").map((tag) => tag.trim()).filter(Boolean).reverse().find((tag) => tag.startsWith(`${packageName}@`));
-}
-function determineHighestBump(commits) {
-	if (commits.length === 0) return "none";
-	let highestBump = "none";
-	for (const commit of commits) {
-		const bump = determineBumpType(commit);
-		if (bump === "major") return "major";
-		if (bump === "minor") highestBump = "minor";
-		else if (bump === "patch" && highestBump === "none") highestBump = "patch";
+//#region src/core/github.ts
+var GitHubClient = class {
+	owner;
+	repo;
+	githubToken;
+	apiBase = "https://api.github.com";
+	constructor({ owner, repo, githubToken }) {
+		this.owner = owner;
+		this.repo = repo;
+		this.githubToken = githubToken;
 	}
-	return highestBump;
+	async request(path, init = {}) {
+		const url = path.startsWith("http") ? path : `${this.apiBase}${path}`;
+		const res = await fetch(url, {
+			...init,
+			headers: {
+				...init.headers,
+				"Accept": "application/vnd.github.v3+json",
+				"Authorization": `token ${this.githubToken}`,
+				"User-Agent": "ucdjs-release-scripts (+https://github.com/ucdjs/ucdjs-release-scripts)"
+			}
+		});
+		if (!res.ok) {
+			const errorText = await res.text();
+			throw new Error(`GitHub API request failed with status ${res.status}: ${errorText || "No response body"}`);
+		}
+		if (res.status === 204) return;
+		return res.json();
+	}
+	async getExistingPullRequest(branch) {
+		const head = branch.includes(":") ? branch : `${this.owner}:${branch}`;
+		const endpoint = `/repos/${this.owner}/${this.repo}/pulls?state=open&head=${encodeURIComponent(head)}`;
+		logger.verbose(`Requesting pull request for branch: ${branch} (url: ${this.apiBase}${endpoint})`);
+		const pulls = await this.request(endpoint);
+		if (!Array.isArray(pulls) || pulls.length === 0) return null;
+		const firstPullRequest = pulls[0];
+		if (typeof firstPullRequest !== "object" || firstPullRequest === null || !("number" in firstPullRequest) || typeof firstPullRequest.number !== "number" || !("title" in firstPullRequest) || typeof firstPullRequest.title !== "string" || !("body" in firstPullRequest) || typeof firstPullRequest.body !== "string" || !("draft" in firstPullRequest) || typeof firstPullRequest.draft !== "boolean" || !("html_url" in firstPullRequest) || typeof firstPullRequest.html_url !== "string") throw new TypeError("Pull request data validation failed");
+		const pullRequest = {
+			number: firstPullRequest.number,
+			title: firstPullRequest.title,
+			body: firstPullRequest.body,
+			draft: firstPullRequest.draft,
+			html_url: firstPullRequest.html_url,
+			head: "head" in firstPullRequest && typeof firstPullRequest.head === "object" && firstPullRequest.head !== null && "sha" in firstPullRequest.head && typeof firstPullRequest.head.sha === "string" ? { sha: firstPullRequest.head.sha } : void 0
+		};
+		logger.info(`Found existing pull request: ${farver.yellow(`#${pullRequest.number}`)}`);
+		return pullRequest;
+	}
+	async upsertPullRequest({ title, body, head, base, pullNumber }) {
+		const isUpdate = typeof pullNumber === "number";
+		const endpoint = isUpdate ? `/repos/${this.owner}/${this.repo}/pulls/${pullNumber}` : `/repos/${this.owner}/${this.repo}/pulls`;
+		const requestBody = isUpdate ? {
+			title,
+			body
+		} : {
+			title,
+			body,
+			head,
+			base,
+			draft: true
+		};
+		logger.verbose(`${isUpdate ? "Updating" : "Creating"} pull request (url: ${this.apiBase}${endpoint})`);
+		const pr = await this.request(endpoint, {
+			method: isUpdate ? "PATCH" : "POST",
+			body: JSON.stringify(requestBody)
+		});
+		if (typeof pr !== "object" || pr === null || !("number" in pr) || typeof pr.number !== "number" || !("title" in pr) || typeof pr.title !== "string" || !("body" in pr) || typeof pr.body !== "string" || !("draft" in pr) || typeof pr.draft !== "boolean" || !("html_url" in pr) || typeof pr.html_url !== "string") throw new TypeError("Pull request data validation failed");
+		const action = isUpdate ? "Updated" : "Created";
+		logger.info(`${action} pull request: ${farver.yellow(`#${pr.number}`)}`);
+		return {
+			number: pr.number,
+			title: pr.title,
+			body: pr.body,
+			draft: pr.draft,
+			html_url: pr.html_url
+		};
+	}
+	async setCommitStatus({ sha, state, targetUrl, description, context }) {
+		const endpoint = `/repos/${this.owner}/${this.repo}/statuses/${sha}`;
+		logger.verbose(`Setting commit status on ${sha} to ${state} (url: ${this.apiBase}${endpoint})`);
+		await this.request(endpoint, {
+			method: "POST",
+			body: JSON.stringify({
+				state,
+				target_url: targetUrl,
+				description: description || "",
+				context
+			})
+		});
+		logger.info(`Commit status set to ${farver.cyan(state)} for ${farver.gray(sha.substring(0, 7))}`);
+	}
+	async resolveAuthorInfo(info) {
+		if (info.login) return info;
+		try {
+			const q = encodeURIComponent(`${info.email} type:user in:email`);
+			const data = await this.request(`/search/users?q=${q}`);
+			if (!data.items || data.items.length === 0) return info;
+			info.login = data.items[0].login;
+		} catch (err) {
+			logger.warn(`Failed to resolve author info for email ${info.email}: ${err.message}`);
+		}
+		if (info.login) return info;
+		if (info.commits.length > 0) try {
+			const data = await this.request(`/repos/${this.owner}/${this.repo}/commits/${info.commits[0]}`);
+			if (data.author && data.author.login) info.login = data.author.login;
+		} catch (err) {
+			logger.warn(`Failed to resolve author info from commits for email ${info.email}: ${err.message}`);
+		}
+		return info;
+	}
+};
+function createGitHubClient(options) {
+	return new GitHubClient(options);
 }
-async function getPackageCommits(pkg, workspaceRoot) {
-	const lastTag = await getLastPackageTag(pkg.name, workspaceRoot);
-	const allCommits = getCommits({
-		from: lastTag,
-		to: "HEAD"
-	});
-	console.log(`Found ${allCommits.length} commits for ${pkg.name} since ${lastTag || "beginning"}`);
-	const touchedCommitHashes = await getCommitsTouchingPackage(lastTag || "HEAD", "HEAD", pkg.path, workspaceRoot);
-	const touchedSet = new Set(touchedCommitHashes);
-	const packageCommits = allCommits.filter((commit) => touchedSet.has(commit.shortHash));
-	console.log(`${packageCommits.length} commits affect ${pkg.name}`);
-	return packageCommits;
+function dedentString(str) {
+	const lines = str.split("\n");
+	const minIndent = lines.filter((line) => line.trim().length > 0).reduce((min, line) => Math.min(min, line.search(/\S/)), Infinity);
+	return lines.map((line) => minIndent === Infinity ? line : line.slice(minIndent)).join("\n").trim();
 }
-async function analyzePackageCommits(pkg, workspaceRoot) {
-	return determineHighestBump(await getPackageCommits(pkg, workspaceRoot));
+function generatePullRequestBody(updates, body) {
+	const eta = new Eta();
+	const bodyTemplate = body ? dedentString(body) : DEFAULT_PR_BODY_TEMPLATE;
+	return eta.renderString(bodyTemplate, { packages: updates.map((u) => ({
+		name: u.package.name,
+		currentVersion: u.currentVersion,
+		newVersion: u.newVersion,
+		bumpType: u.bumpType,
+		hasDirectChanges: u.hasDirectChanges
+	})) });
 }
-/**
-* Analyze commits for multiple packages to determine version bumps
-*
-* @param packages - Packages to analyze
-* @param workspaceRoot - Root directory of the workspace
-* @returns Map of package names to their bump types
-*/
-async function analyzeCommits(packages, workspaceRoot) {
-	const changedPackages = /* @__PURE__ */ new Map();
-	for (const pkg of packages) {
-		const bump = await analyzePackageCommits(pkg, workspaceRoot);
-		if (bump !== "none") changedPackages.set(pkg.name, bump);
-	}
-	return changedPackages;
+
+//#endregion
+//#region src/options.ts
+const DEFAULT_PR_BODY_TEMPLATE = dedent`
+  This PR was automatically generated by the UCD release scripts.
+
+  The following packages have been prepared for release:
+
+  <% if (it.packages.length > 0) { %>
+  <% it.packages.forEach((pkg) => { %>
+  - **<%= pkg.name %>**: <%= pkg.currentVersion %> → <%= pkg.newVersion %> (<%= pkg.bumpType %>)
+  <% }) %>
+  <% } else { %>
+  There are no packages to release.
+  <% } %>
+
+  Please review the changes and merge when ready.
+
+  > [!NOTE]
+  > When this PR is merged, the release process will be triggered automatically, publishing the new package versions to the registry.
+`;
+const DEFAULT_CHANGELOG_TEMPLATE = dedent`
+  <% if (it.previousVersion) { -%>
+  ## [<%= it.version %>](<%= it.compareUrl %>) (<%= it.date %>)
+  <% } else { -%>
+  ## <%= it.version %> (<%= it.date %>)
+  <% } %>
+
+  <% it.groups.forEach((group) => { %>
+  <% if (group.commits.length > 0) { %>
+
+  ### <%= group.title %>
+  <% group.commits.forEach((commit) => { %>
+
+  * <%= commit.line %>
+  <% }); %>
+
+  <% } %>
+  <% }); %>
+`;
+const DEFAULT_TYPES = {
+	feat: { title: "🚀 Features" },
+	fix: { title: "🐞 Bug Fixes" },
+	perf: { title: "🏎 Performance" },
+	docs: { title: "📚 Documentation" },
+	style: { title: "🎨 Styles" }
+};
+function normalizeReleaseScriptsOptions(options) {
+	const { workspaceRoot = process.cwd(), githubToken = "", repo: fullRepo, packages = true, branch = {}, globalCommitMode = "dependencies", pullRequest = {}, changelog = {}, types, safeguards = true, dryRun = false, npm = {}, prompts = {} } = options;
+	const token = githubToken.trim();
+	if (!token) throw new Error("GitHub token is required. Pass it in via options.");
+	if (!fullRepo || !fullRepo.trim() || !fullRepo.includes("/")) throw new Error("Repository (repo) is required. Specify in 'owner/repo' format (e.g., 'octocat/hello-world').");
+	const [owner, repo] = fullRepo.split("/");
+	if (!owner || !repo) throw new Error(`Invalid repo format: "${fullRepo}". Expected format: "owner/repo" (e.g., "octocat/hello-world").`);
+	const normalizedPackages = typeof packages === "object" && !Array.isArray(packages) ? {
+		exclude: packages.exclude ?? [],
+		include: packages.include ?? [],
+		excludePrivate: packages.excludePrivate ?? false
+	} : packages;
+	const isCI = process.env.CI === "true" || process.env.GITHUB_ACTIONS === "true";
+	return {
+		dryRun,
+		workspaceRoot,
+		githubToken: token,
+		owner,
+		repo,
+		githubClient: createGitHubClient({
+			owner,
+			repo,
+			githubToken: token
+		}),
+		packages: normalizedPackages,
+		branch: {
+			release: branch.release ?? "release/next",
+			default: branch.default ?? "main"
+		},
+		globalCommitMode,
+		safeguards,
+		pullRequest: {
+			title: pullRequest.title ?? "chore: release new version",
+			body: pullRequest.body ?? DEFAULT_PR_BODY_TEMPLATE
+		},
+		changelog: {
+			enabled: changelog.enabled ?? true,
+			template: changelog.template ?? DEFAULT_CHANGELOG_TEMPLATE,
+			emojis: changelog.emojis ?? true
+		},
+		types: types ? {
+			...DEFAULT_TYPES,
+			...types
+		} : DEFAULT_TYPES,
+		npm: {
+			otp: npm.otp,
+			provenance: npm.provenance ?? true,
+			access: npm.access ?? "public",
+			runBuild: npm.runBuild ?? true
+		},
+		prompts: {
+			versions: prompts.versions ?? !isCI,
+			packages: prompts.packages ?? !isCI
+		}
+	};
 }
-function determineBumpType(commit) {
-	if (commit.isBreaking) return "major";
-	if (!commit.isConventional || !commit.type) return "none";
-	switch (commit.type) {
-		case "feat": return "minor";
-		case "fix":
-		case "perf": return "patch";
-		case "docs":
-		case "style":
-		case "refactor":
-		case "test":
-		case "build":
-		case "ci":
-		case "chore":
-		case "revert": return "none";
-		default: return "none";
-	}
-}
-async function getCommitsTouchingPackage(from, to, packagePath, workspaceRoot) {
-	try {
-		const { stdout } = await run("git", [
-			"log",
-			"--pretty=format:%h",
-			from === "HEAD" ? "HEAD" : `${from}...${to}`,
-			"--",
-			packagePath
-		], { nodeOptions: {
-			cwd: workspaceRoot,
-			stdio: "pipe"
-		} });
-		return stdout.split("\n").map((line) => line.trim()).filter(Boolean);
-	} catch (error) {
-		console.error(`Error getting commits touching package: ${error}`);
-		return [];
-	}
+
+//#endregion
+//#region src/types.ts
+function ok(value) {
+	return {
+		ok: true,
+		value
+	};
+}
+function err(error) {
+	return {
+		ok: false,
+		error
+	};
 }
 
 //#endregion
-//#region src/git.ts
-/**
-* Check if the working directory is clean (no uncommitted changes)
-* @param {string} workspaceRoot - The root directory of the workspace
-* @returns {Promise<boolean>} A Promise resolving to true if clean, false otherwise
-*/
+//#region src/core/git.ts
+function toGitError(operation, error) {
+	return {
+		type: "git",
+		operation,
+		message: error instanceof Error ? error.message : String(error),
+		stderr: (typeof error === "object" && error && "stderr" in error ? String(error.stderr ?? "") : void 0)?.trim() || void 0
+	};
+}
 async function isWorkingDirectoryClean(workspaceRoot) {
 	try {
-		if ((await run("git", ["status", "--porcelain"], { nodeOptions: {
+		return ok((await run("git", ["status", "--porcelain"], { nodeOptions: {
 			cwd: workspaceRoot,
 			stdio: "pipe"
-		} })).stdout.trim() !== "") return false;
-		return true;
-	} catch (err) {
-		console.error("Error checking git status:", err);
-		return false;
+		} })).stdout.trim() === "");
+	} catch (error) {
+		return err(toGitError("isWorkingDirectoryClean", error));
 	}
 }
 /**
@@ -149,89 +424,110 @@ async function doesBranchExist(branch, workspaceRoot) {
 			cwd: workspaceRoot,
 			stdio: "pipe"
 		} });
-		return true;
+		return ok(true);
 	} catch {
-		return false;
+		return ok(false);
 	}
 }
 /**
-* Pull latest changes from remote branch
-* @param branch - The branch name to pull from
-* @param workspaceRoot - The root directory of the workspace
-* @returns Promise resolving to true if pull succeeded, false otherwise
+* Retrieves the name of the current branch in the repository.
+* @param {string} workspaceRoot - The root directory of the workspace
+* @returns {Promise<string>} A Promise resolving to the current branch name as a string
 */
-async function pullLatestChanges(branch, workspaceRoot) {
+async function getCurrentBranch(workspaceRoot) {
 	try {
-		await run("git", [
-			"pull",
-			"origin",
-			branch
+		return ok((await run("git", [
+			"rev-parse",
+			"--abbrev-ref",
+			"HEAD"
 		], { nodeOptions: {
 			cwd: workspaceRoot,
 			stdio: "pipe"
-		} });
-		return true;
-	} catch {
-		return false;
+		} })).stdout.trim());
+	} catch (error) {
+		return err(toGitError("getCurrentBranch", error));
 	}
 }
 /**
-* Create a new git branch
-* @param branch - The new branch name
-* @param base - The base branch to create from
-* @param workspaceRoot - The root directory of the workspace
+* Creates a new branch from the specified base branch.
+* @param {string} branch - The name of the new branch to create
+* @param {string} base - The base branch to create the new branch from
+* @param {string} workspaceRoot - The root directory of the workspace
+* @returns {Promise<void>} A Promise that resolves when the branch is created
 */
 async function createBranch(branch, base, workspaceRoot) {
-	await runIfNotDry("git", [
-		"checkout",
-		"-b",
-		branch,
-		base
-	], { nodeOptions: { cwd: workspaceRoot } });
+	try {
+		logger.info(`Creating branch: ${farver.green(branch)} from ${farver.cyan(base)}`);
+		await runIfNotDry("git", [
+			"branch",
+			branch,
+			base
+		], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} });
+		return ok(void 0);
+	} catch (error) {
+		return err(toGitError("createBranch", error));
+	}
 }
-/**
-* Checkout a git branch
-* @param branch - The branch name to checkout
-* @param workspaceRoot - The root directory of the workspace
-* @returns Promise resolving to true if checkout succeeded, false otherwise
-*/
 async function checkoutBranch(branch, workspaceRoot) {
 	try {
-		await run("git", ["checkout", branch], { nodeOptions: { cwd: workspaceRoot } });
-		return true;
-	} catch {
-		return false;
+		logger.info(`Switching to branch: ${farver.green(branch)}`);
+		const output = (await run("git", ["checkout", branch], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} })).stderr.trim();
+		const match = output.match(/Switched to (?:a new )?branch '(.+)'/);
+		if (match && match[1] === branch) {
+			logger.info(`Successfully switched to branch: ${farver.green(branch)}`);
+			return ok(true);
+		}
+		console.warn(`Unexpected git checkout output: ${output}`);
+		return ok(false);
+	} catch (error) {
+		const gitError = toGitError("checkoutBranch", error);
+		logger.error(`Git checkout failed: ${gitError.message}`);
+		if (gitError.stderr) logger.error(`Git stderr: ${gitError.stderr}`);
+		try {
+			const branchResult = await run("git", ["branch", "-a"], { nodeOptions: {
+				cwd: workspaceRoot,
+				stdio: "pipe"
+			} });
+			logger.verbose(`Available branches:\n${branchResult.stdout}`);
+		} catch {
+			logger.verbose("Could not list available branches");
+		}
+		return err(gitError);
 	}
 }
-/**
-* Get the current branch name
-* @param workspaceRoot - The root directory of the workspace
-* @returns Promise resolving to the current branch name
-*/
-async function getCurrentBranch(workspaceRoot) {
-	return (await run("git", [
-		"rev-parse",
-		"--abbrev-ref",
-		"HEAD"
-	], { nodeOptions: {
-		cwd: workspaceRoot,
-		stdio: "pipe"
-	} })).stdout.trim();
+async function pullLatestChanges(branch, workspaceRoot) {
+	try {
+		await run("git", [
+			"pull",
+			"origin",
+			branch
+		], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} });
+		return ok(true);
+	} catch (error) {
+		return err(toGitError("pullLatestChanges", error));
+	}
 }
-/**
-* Rebase current branch onto another branch
-* @param ontoBranch - The target branch to rebase onto
-* @param workspaceRoot - The root directory of the workspace
-*/
 async function rebaseBranch(ontoBranch, workspaceRoot) {
-	await run("git", ["rebase", ontoBranch], { nodeOptions: { cwd: workspaceRoot } });
+	try {
+		logger.info(`Rebasing onto: ${farver.cyan(ontoBranch)}`);
+		await runIfNotDry("git", ["rebase", ontoBranch], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} });
+		return ok(void 0);
+	} catch (error) {
+		return err(toGitError("rebaseBranch", error));
+	}
 }
-/**
-* Check if local branch is ahead of remote (has commits to push)
-* @param branch - The branch name to check
-* @param workspaceRoot - The root directory of the workspace
-* @returns Promise resolving to true if local is ahead, false otherwise
-*/
 async function isBranchAheadOfRemote(branch, workspaceRoot) {
 	try {
 		const result = await run("git", [
@@ -242,171 +538,350 @@ async function isBranchAheadOfRemote(branch, workspaceRoot) {
 			cwd: workspaceRoot,
 			stdio: "pipe"
 		} });
-		return Number.parseInt(result.stdout.trim(), 10) > 0;
+		return ok(Number.parseInt(result.stdout.trim(), 10) > 0);
 	} catch {
-		return true;
+		return ok(true);
 	}
 }
-/**
-* Check if there are any changes to commit (staged or unstaged)
-* @param workspaceRoot - The root directory of the workspace
-* @returns Promise resolving to true if there are changes, false otherwise
-*/
-async function hasChangesToCommit(workspaceRoot) {
-	return (await run("git", ["status", "--porcelain"], { nodeOptions: {
-		cwd: workspaceRoot,
-		stdio: "pipe"
-	} })).stdout.trim() !== "";
-}
-/**
-* Commit changes with a message
-* @param message - The commit message
-* @param workspaceRoot - The root directory of the workspace
-* @returns Promise resolving to true if commit was made, false if there were no changes
-*/
 async function commitChanges(message, workspaceRoot) {
-	await run("git", ["add", "."], { nodeOptions: { cwd: workspaceRoot } });
-	if (!await hasChangesToCommit(workspaceRoot)) return false;
-	await run("git", [
-		"commit",
-		"-m",
-		message
-	], { nodeOptions: { cwd: workspaceRoot } });
-	return true;
+	try {
+		await run("git", ["add", "."], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} });
+		const isClean = await isWorkingDirectoryClean(workspaceRoot);
+		if (!isClean.ok || isClean.value) return ok(false);
+		logger.info(`Committing changes: ${farver.dim(message)}`);
+		await runIfNotDry("git", [
+			"commit",
+			"-m",
+			message
+		], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} });
+		return ok(true);
+	} catch (error) {
+		const gitError = toGitError("commitChanges", error);
+		logger.error(`Git commit failed: ${gitError.message}`);
+		if (gitError.stderr) logger.error(`Git stderr: ${gitError.stderr}`);
+		return err(gitError);
+	}
 }
-/**
-* Push branch to remote
-* @param branch - The branch name to push
-* @param workspaceRoot - The root directory of the workspace
-* @param options - Push options
-* @param options.force - Force push (overwrite remote)
-* @param options.forceWithLease - Force push with safety check (won't overwrite unexpected changes)
-*/
 async function pushBranch(branch, workspaceRoot, options) {
-	const args = [
-		"push",
-		"origin",
-		branch
-	];
-	if (options?.forceWithLease) args.push("--force-with-lease");
-	else if (options?.force) args.push("--force");
-	await run("git", args, { nodeOptions: { cwd: workspaceRoot } });
-}
-
-//#endregion
-//#region src/github.ts
-async function getExistingPullRequest({ owner, repo, branch, githubToken }) {
 	try {
-		const res = await fetch(`https://api.github.com/repos/${owner}/${repo}/pulls?state=open&head=${branch}`, { headers: {
-			Accept: "application/vnd.github.v3+json",
-			Authorization: `token ${githubToken}`
+		const args = [
+			"push",
+			"origin",
+			branch
+		];
+		if (options?.forceWithLease) {
+			await run("git", [
+				"fetch",
+				"origin",
+				branch
+			], { nodeOptions: {
+				cwd: workspaceRoot,
+				stdio: "pipe"
+			} });
+			args.push("--force-with-lease");
+			logger.info(`Pushing branch: ${farver.green(branch)} ${farver.dim("(with lease)")}`);
+		} else if (options?.force) {
+			args.push("--force");
+			logger.info(`Force pushing branch: ${farver.green(branch)}`);
+		} else logger.info(`Pushing branch: ${farver.green(branch)}`);
+		await runIfNotDry("git", args, { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
 		} });
-		if (!res.ok) throw new Error(`GitHub API request failed with status ${res.status}`);
-		const pulls = await res.json();
-		if (pulls == null || !Array.isArray(pulls) || pulls.length === 0) return null;
-		const firstPullRequest = pulls[0];
-		if (typeof firstPullRequest !== "object" || firstPullRequest === null || !("number" in firstPullRequest) || typeof firstPullRequest.number !== "number" || !("title" in firstPullRequest) || typeof firstPullRequest.title !== "string" || !("body" in firstPullRequest) || typeof firstPullRequest.body !== "string" || !("draft" in firstPullRequest) || typeof firstPullRequest.draft !== "boolean" || !("html_url" in firstPullRequest) || typeof firstPullRequest.html_url !== "string") throw new TypeError("Pull request data validation failed");
-		const pullRequest = {
-			number: firstPullRequest.number,
-			title: firstPullRequest.title,
-			body: firstPullRequest.body,
-			draft: firstPullRequest.draft,
-			html_url: firstPullRequest.html_url
-		};
-		console.info(`Found existing pull request: ${farver.yellow(`#${pullRequest.number}`)}`);
-		return pullRequest;
-	} catch (err) {
-		console.error("Error fetching pull request:", err);
-		return null;
+		return ok(true);
+	} catch (error) {
+		return err(toGitError("pushBranch", error));
 	}
 }
-async function upsertPullRequest({ owner, repo, title, body, head, base, pullNumber, githubToken }) {
+async function readFileFromGit(workspaceRoot, ref, filePath) {
 	try {
-		const isUpdate = pullNumber != null;
-		const url = isUpdate ? `https://api.github.com/repos/${owner}/${repo}/pulls/${pullNumber}` : `https://api.github.com/repos/${owner}/${repo}/pulls`;
-		const method = isUpdate ? "PATCH" : "POST";
-		const requestBody = isUpdate ? {
-			title,
-			body
-		} : {
-			title,
-			body,
-			head,
-			base
-		};
-		const res = await fetch(url, {
-			method,
-			headers: {
-				Accept: "application/vnd.github.v3+json",
-				Authorization: `token ${githubToken}`
-			},
-			body: JSON.stringify(requestBody)
-		});
-		if (!res.ok) throw new Error(`GitHub API request failed with status ${res.status}`);
-		const pr = await res.json();
-		if (typeof pr !== "object" || pr === null || !("number" in pr) || typeof pr.number !== "number" || !("title" in pr) || typeof pr.title !== "string" || !("body" in pr) || typeof pr.body !== "string" || !("draft" in pr) || typeof pr.draft !== "boolean" || !("html_url" in pr) || typeof pr.html_url !== "string") throw new TypeError("Pull request data validation failed");
-		const action = isUpdate ? "Updated" : "Created";
-		console.info(`${action} pull request: ${farver.yellow(`#${pr.number}`)}`);
-		return {
-			number: pr.number,
-			title: pr.title,
-			body: pr.body,
-			draft: pr.draft,
-			html_url: pr.html_url
-		};
-	} catch (err) {
-		console.error(`Error upserting pull request:`, err);
-		throw err;
+		return ok((await run("git", ["show", `${ref}:${filePath}`], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} })).stdout);
+	} catch {
+		return ok(null);
 	}
 }
-const defaultTemplate = dedent`
-  This PR was automatically generated by the release script.
-
-  The following packages have been prepared for release:
-
-  <% it.packages.forEach((pkg) => { %>
-  - **<%= pkg.name %>**: <%= pkg.currentVersion %> → <%= pkg.newVersion %> (<%= pkg.bumpType %>)
-  <% }) %>
-
-  Please review the changes and merge when ready.
-
-  For a more in-depth look at the changes, please refer to the individual package changelogs.
-
-  > [!NOTE]
-  > When this PR is merged, the release process will be triggered automatically, publishing the new package versions to the registry.
-`;
-function dedentString(str) {
-	const lines = str.split("\n");
-	const minIndent = lines.filter((line) => line.trim().length > 0).reduce((min, line) => Math.min(min, line.search(/\S/)), Infinity);
-	return lines.map((line) => minIndent === Infinity ? line : line.slice(minIndent)).join("\n").trim();
+async function getMostRecentPackageTag(workspaceRoot, packageName) {
+	try {
+		const { stdout } = await run("git", [
+			"tag",
+			"--list",
+			`${packageName}@*`
+		], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} });
+		const tags = stdout.split("\n").map((tag) => tag.trim()).filter(Boolean);
+		if (tags.length === 0) return ok(void 0);
+		return ok(tags.reverse()[0]);
+	} catch (error) {
+		return err(toGitError("getMostRecentPackageTag", error));
+	}
 }
-function generatePullRequestBody(updates, body) {
+/**
+* Builds a mapping of commit SHAs to the list of files changed in each commit
+* within a given inclusive range.
+*
+* Internally runs:
+*   git log --name-only --format=%H <from>^..<to>
+*
+* Notes
+* - This includes the commit identified by `from` (via `from^..to`).
+* - Order of commits in the resulting Map follows `git log` output
+*   (reverse chronological, newest first).
+* - On failure (e.g., invalid refs), the function returns null.
+*
+* @param {string} workspaceRoot Absolute path to the git repository root used as cwd.
+* @param {string} from          Starting commit/ref (inclusive).
+* @param {string} to            Ending commit/ref (inclusive).
+* @returns {Promise<Map<string, string[]> | null>} Promise resolving to a Map where keys are commit SHAs and values are
+*          arrays of file paths changed by that commit, or null on error.
+*/
+async function getGroupedFilesByCommitSha(workspaceRoot, from, to) {
+	const commitsMap = /* @__PURE__ */ new Map();
+	try {
+		const { stdout } = await run("git", [
+			"log",
+			"--name-only",
+			"--format=%H",
+			`${from}^..${to}`
+		], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} });
+		const lines = stdout.trim().split("\n").filter((line) => line.trim() !== "");
+		let currentSha = null;
+		const HASH_REGEX = /^[0-9a-f]{40}$/i;
+		for (const line of lines) {
+			const trimmedLine = line.trim();
+			if (HASH_REGEX.test(trimmedLine)) {
+				currentSha = trimmedLine;
+				commitsMap.set(currentSha, []);
+				continue;
+			}
+			if (currentSha === null) continue;
+			commitsMap.get(currentSha).push(trimmedLine);
+		}
+		return ok(commitsMap);
+	} catch (error) {
+		return err(toGitError("getGroupedFilesByCommitSha", error));
+	}
+}
+/**
+* Create a git tag for a package release
+* @param packageName - The package name (e.g., "@scope/name")
+* @param version - The version to tag (e.g., "1.2.3")
+* @param workspaceRoot - The root directory of the workspace
+* @returns Result indicating success or failure
+*/
+async function createPackageTag(packageName, version, workspaceRoot) {
+	const tagName = `${packageName}@${version}`;
+	try {
+		logger.info(`Creating tag: ${farver.green(tagName)}`);
+		await runIfNotDry("git", ["tag", tagName], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} });
+		return ok(void 0);
+	} catch (error) {
+		return err(toGitError("createPackageTag", error));
+	}
+}
+/**
+* Push a specific tag to the remote repository
+* @param tagName - The tag name to push
+* @param workspaceRoot - The root directory of the workspace
+* @returns Result indicating success or failure
+*/
+async function pushTag(tagName, workspaceRoot) {
+	try {
+		logger.info(`Pushing tag: ${farver.green(tagName)}`);
+		await runIfNotDry("git", [
+			"push",
+			"origin",
+			tagName
+		], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} });
+		return ok(void 0);
+	} catch (error) {
+		return err(toGitError("pushTag", error));
+	}
+}
+/**
+* Create and push a package tag in one operation
+* @param packageName - The package name
+* @param version - The version to tag
+* @param workspaceRoot - The root directory of the workspace
+* @returns Result indicating success or failure
+*/
+async function createAndPushPackageTag(packageName, version, workspaceRoot) {
+	const createResult = await createPackageTag(packageName, version, workspaceRoot);
+	if (!createResult.ok) return createResult;
+	return pushTag(`${packageName}@${version}`, workspaceRoot);
+}
+
+//#endregion
+//#region src/core/changelog.ts
+const excludeAuthors = [
+	/\[bot\]/i,
+	/dependabot/i,
+	/\(bot\)/i
+];
+async function generateChangelogEntry(options) {
+	const { packageName, version, previousVersion, date, commits, owner, repo, types, template, githubClient } = options;
+	const templateData = {
+		packageName,
+		version,
+		previousVersion,
+		date,
+		compareUrl: previousVersion ? `https://github.com/${owner}/${repo}/compare/${packageName}@${previousVersion}...${packageName}@${version}` : void 0,
+		owner,
+		repo,
+		groups: buildTemplateGroups({
+			commits,
+			owner,
+			repo,
+			types,
+			commitAuthors: await resolveCommitAuthors(commits, githubClient)
+		})
+	};
 	const eta = new Eta();
-	const bodyTemplate = body ? dedentString(body) : defaultTemplate;
-	return eta.renderString(bodyTemplate, { packages: updates.map((u) => ({
-		name: u.package.name,
-		currentVersion: u.currentVersion,
-		newVersion: u.newVersion,
-		bumpType: u.bumpType,
-		hasDirectChanges: u.hasDirectChanges
-	})) });
+	const templateToUse = template || DEFAULT_CHANGELOG_TEMPLATE;
+	return eta.renderString(templateToUse, templateData).trim();
+}
+async function updateChangelog(options) {
+	const { version, previousVersion, commits, date, normalizedOptions, workspacePackage, githubClient } = options;
+	const changelogPath = join(workspacePackage.path, "CHANGELOG.md");
+	const changelogRelativePath = relative(normalizedOptions.workspaceRoot, join(workspacePackage.path, "CHANGELOG.md"));
+	const existingContent = await readFileFromGit(normalizedOptions.workspaceRoot, normalizedOptions.branch.default, changelogRelativePath);
+	logger.verbose("Existing content found: ", existingContent.ok && Boolean(existingContent.value));
+	const newEntry = await generateChangelogEntry({
+		packageName: workspacePackage.name,
+		version,
+		previousVersion,
+		date,
+		commits,
+		owner: normalizedOptions.owner,
+		repo: normalizedOptions.repo,
+		types: normalizedOptions.types,
+		template: normalizedOptions.changelog?.template,
+		githubClient
+	});
+	let updatedContent;
+	if (!existingContent.ok || !existingContent.value) {
+		updatedContent = `# ${workspacePackage.name}\n\n${newEntry}\n`;
+		await writeFile(changelogPath, updatedContent, "utf-8");
+		return;
+	}
+	const parsed = parseChangelog(existingContent.value);
+	const lines = existingContent.value.split("\n");
+	const existingVersionIndex = parsed.versions.findIndex((v) => v.version === version);
+	if (existingVersionIndex !== -1) {
+		const existingVersion = parsed.versions[existingVersionIndex];
+		const before = lines.slice(0, existingVersion.lineStart);
+		const after = lines.slice(existingVersion.lineEnd + 1);
+		updatedContent = [
+			...before,
+			newEntry,
+			...after
+		].join("\n");
+	} else {
+		const insertAt = parsed.headerLineEnd + 1;
+		const before = lines.slice(0, insertAt);
+		const after = lines.slice(insertAt);
+		if (before.length > 0 && before[before.length - 1] !== "") before.push("");
+		updatedContent = [
+			...before,
+			newEntry,
+			"",
+			...after
+		].join("\n");
+	}
+	await writeFile(changelogPath, updatedContent, "utf-8");
+}
+async function resolveCommitAuthors(commits, githubClient) {
+	const authorMap = /* @__PURE__ */ new Map();
+	const commitAuthors = /* @__PURE__ */ new Map();
+	for (const commit of commits) {
+		const authorsForCommit = [];
+		commit.authors.forEach((author, idx) => {
+			if (!author.email || !author.name) return;
+			if (excludeAuthors.some((re) => re.test(author.name))) return;
+			if (!authorMap.has(author.email)) authorMap.set(author.email, {
+				commits: [],
+				name: author.name,
+				email: author.email
+			});
+			const info = authorMap.get(author.email);
+			if (idx === 0) info.commits.push(commit.shortHash);
+			authorsForCommit.push(info);
+		});
+		commitAuthors.set(commit.hash, authorsForCommit);
+	}
+	const authors = Array.from(authorMap.values());
+	await Promise.all(authors.map((info) => githubClient.resolveAuthorInfo(info)));
+	return commitAuthors;
+}
+function parseChangelog(content) {
+	const lines = content.split("\n");
+	let packageName = null;
+	let headerLineEnd = -1;
+	const versions = [];
+	for (let i = 0; i < lines.length; i++) {
+		const line = lines[i].trim();
+		if (line.startsWith("# ")) {
+			packageName = line.slice(2).trim();
+			headerLineEnd = i;
+			break;
+		}
+	}
+	for (let i = headerLineEnd + 1; i < lines.length; i++) {
+		const line = lines[i].trim();
+		if (line.startsWith("## ")) {
+			const versionMatch = line.match(/##\s+(?:<small>)?\[?([^\](\s<]+)/);
+			if (versionMatch) {
+				const version = versionMatch[1];
+				const lineStart = i;
+				let lineEnd = lines.length - 1;
+				for (let j = i + 1; j < lines.length; j++) if (lines[j].trim().startsWith("## ")) {
+					lineEnd = j - 1;
+					break;
+				}
+				const versionContent = lines.slice(lineStart, lineEnd + 1).join("\n");
+				versions.push({
+					version,
+					lineStart,
+					lineEnd,
+					content: versionContent
+				});
+			}
+		}
+	}
+	return {
+		packageName,
+		versions,
+		headerLineEnd
+	};
 }
 
 //#endregion
-//#region src/version.ts
+//#region src/operations/semver.ts
 function isValidSemver(version) {
 	return /^\d+\.\d+\.\d+(?:[-+].+)?$/.test(version);
 }
-function validateSemver(version) {
-	if (!isValidSemver(version)) throw new Error(`Invalid semver version: ${version}`);
-}
-/**
-* Calculate the new version based on current version and bump type
-* Pure function - no side effects, easily testable
-*/
-function calculateNewVersion(currentVersion, bump) {
+function getNextVersion(currentVersion, bump) {
 	if (bump === "none") return currentVersion;
-	validateSemver(currentVersion);
+	if (!isValidSemver(currentVersion)) throw new Error(`Cannot bump version for invalid semver: ${currentVersion}`);
 	const match = currentVersion.match(/^(\d+)\.(\d+)\.(\d+)(.*)$/);
 	if (!match) throw new Error(`Invalid semver version: ${currentVersion}`);
 	const [, major, minor, patch] = match;
@@ -429,58 +904,404 @@ function calculateNewVersion(currentVersion, bump) {
 	}
 	return `${newMajor}.${newMinor}.${newPatch}`;
 }
+function calculateBumpType(oldVersion, newVersion) {
+	if (!isValidSemver(oldVersion) || !isValidSemver(newVersion)) throw new Error(`Cannot calculate bump type for invalid semver: ${oldVersion} or ${newVersion}`);
+	const oldParts = oldVersion.split(".").map(Number);
+	const newParts = newVersion.split(".").map(Number);
+	if (newParts[0] > oldParts[0]) return "major";
+	if (newParts[1] > oldParts[1]) return "minor";
+	if (newParts[2] > oldParts[2]) return "patch";
+	return "none";
+}
+
+//#endregion
+//#region src/core/prompts.ts
+async function selectPackagePrompt(packages) {
+	const response = await prompts({
+		type: "multiselect",
+		name: "selectedPackages",
+		message: "Select packages to release",
+		choices: packages.map((pkg) => ({
+			title: `${pkg.name} (${farver.bold(pkg.version)})`,
+			value: pkg.name,
+			selected: true
+		})),
+		min: 1,
+		hint: "Space to select/deselect. Return to submit.",
+		instructions: false
+	});
+	if (!response.selectedPackages || response.selectedPackages.length === 0) return [];
+	return response.selectedPackages;
+}
+async function selectVersionPrompt(workspaceRoot, pkg, currentVersion, suggestedVersion) {
+	const answers = await prompts([{
+		type: "autocomplete",
+		name: "version",
+		message: `${pkg.name}: ${farver.green(pkg.version)}`,
+		choices: [
+			{
+				value: "skip",
+				title: `skip ${farver.dim("(no change)")}`
+			},
+			{
+				value: "major",
+				title: `major ${farver.bold(getNextVersion(pkg.version, "major"))}`
+			},
+			{
+				value: "minor",
+				title: `minor ${farver.bold(getNextVersion(pkg.version, "minor"))}`
+			},
+			{
+				value: "patch",
+				title: `patch ${farver.bold(getNextVersion(pkg.version, "patch"))}`
+			},
+			{
+				value: "suggested",
+				title: `suggested ${farver.bold(suggestedVersion)}`
+			},
+			{
+				value: "as-is",
+				title: `as-is ${farver.dim("(keep current version)")}`
+			},
+			{
+				value: "custom",
+				title: "custom"
+			}
+		],
+		initial: suggestedVersion === currentVersion ? 0 : 4
+	}, {
+		type: (prev) => prev === "custom" ? "text" : null,
+		name: "custom",
+		message: "Enter the new version number:",
+		initial: suggestedVersion,
+		validate: (custom) => {
+			if (isValidSemver(custom)) return true;
+			return "That's not a valid version number";
+		}
+	}]);
+	if (!answers.version) return null;
+	if (answers.version === "skip") return null;
+	else if (answers.version === "suggested") return suggestedVersion;
+	else if (answers.version === "custom") {
+		if (!answers.custom) return null;
+		return answers.custom;
+	} else if (answers.version === "as-is") return currentVersion;
+	else return getNextVersion(pkg.version, answers.version);
+}
+
+//#endregion
+//#region src/core/workspace.ts
+function toWorkspaceError(operation, error) {
+	return {
+		type: "workspace",
+		operation,
+		message: error instanceof Error ? error.message : String(error)
+	};
+}
+async function discoverWorkspacePackages(workspaceRoot, options) {
+	let workspaceOptions;
+	let explicitPackages;
+	if (options.packages == null || options.packages === true) workspaceOptions = { excludePrivate: false };
+	else if (Array.isArray(options.packages)) {
+		workspaceOptions = {
+			excludePrivate: false,
+			include: options.packages
+		};
+		explicitPackages = options.packages;
+	} else {
+		workspaceOptions = options.packages;
+		if (options.packages.include) explicitPackages = options.packages.include;
+	}
+	let workspacePackages;
+	try {
+		workspacePackages = await findWorkspacePackages(workspaceRoot, workspaceOptions);
+	} catch (error) {
+		return err(toWorkspaceError("discoverWorkspacePackages", error));
+	}
+	if (explicitPackages) {
+		const foundNames = new Set(workspacePackages.map((p) => p.name));
+		const missing = explicitPackages.filter((p) => !foundNames.has(p));
+		if (missing.length > 0) exitWithError(`Package${missing.length > 1 ? "s" : ""} not found in workspace: ${missing.join(", ")}`, "Check your package names or run 'pnpm ls' to see available packages");
+	}
+	const isPackagePromptEnabled = options.prompts?.packages !== false;
+	if (!isCI && isPackagePromptEnabled && !explicitPackages) {
+		const selectedNames = await selectPackagePrompt(workspacePackages);
+		workspacePackages = workspacePackages.filter((pkg) => selectedNames.includes(pkg.name));
+	}
+	return ok(workspacePackages);
+}
+async function findWorkspacePackages(workspaceRoot, options) {
+	try {
+		const result = await run("pnpm", [
+			"-r",
+			"ls",
+			"--json"
+		], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} });
+		const rawProjects = JSON.parse(result.stdout);
+		const allPackageNames = new Set(rawProjects.map((p) => p.name));
+		const excludedPackages = /* @__PURE__ */ new Set();
+		const promises = rawProjects.map(async (rawProject) => {
+			const content = await readFile(join(rawProject.path, "package.json"), "utf-8");
+			const packageJson = JSON.parse(content);
+			if (!shouldIncludePackage(packageJson, options)) {
+				excludedPackages.add(rawProject.name);
+				return null;
+			}
+			return {
+				name: rawProject.name,
+				version: rawProject.version,
+				path: rawProject.path,
+				packageJson,
+				workspaceDependencies: Object.keys(rawProject.dependencies || []).filter((dep) => {
+					return allPackageNames.has(dep);
+				}),
+				workspaceDevDependencies: Object.keys(rawProject.devDependencies || []).filter((dep) => {
+					return allPackageNames.has(dep);
+				})
+			};
+		});
+		const packages = await Promise.all(promises);
+		if (excludedPackages.size > 0) logger.info(`Excluded packages: ${farver.green(Array.from(excludedPackages).join(", "))}`);
+		return packages.filter((pkg) => pkg !== null);
+	} catch (err) {
+		logger.error("Error discovering workspace packages:", err);
+		throw err;
+	}
+}
+function shouldIncludePackage(pkg, options) {
+	if (!options) return true;
+	if (options.excludePrivate && pkg.private) return false;
+	if (options.include && options.include.length > 0) {
+		if (!options.include.includes(pkg.name)) return false;
+	}
+	if (options.exclude?.includes(pkg.name)) return false;
+	return true;
+}
+
+//#endregion
+//#region src/operations/branch.ts
+async function prepareReleaseBranch(options) {
+	const { workspaceRoot, releaseBranch, defaultBranch } = options;
+	const currentBranch = await getCurrentBranch(workspaceRoot);
+	if (!currentBranch.ok) return currentBranch;
+	if (currentBranch.value !== defaultBranch) return err({
+		type: "git",
+		operation: "validateBranch",
+		message: `Current branch is '${currentBranch.value}'. Please switch to '${defaultBranch}'.`
+	});
+	const branchExists = await doesBranchExist(releaseBranch, workspaceRoot);
+	if (!branchExists.ok) return branchExists;
+	if (!branchExists.value) {
+		const created = await createBranch(releaseBranch, defaultBranch, workspaceRoot);
+		if (!created.ok) return created;
+	}
+	const checkedOut = await checkoutBranch(releaseBranch, workspaceRoot);
+	if (!checkedOut.ok) return checkedOut;
+	if (branchExists.value) {
+		const pulled = await pullLatestChanges(releaseBranch, workspaceRoot);
+		if (!pulled.ok) return pulled;
+		if (!pulled.value) logger.warn("Failed to pull latest changes, continuing anyway.");
+	}
+	const rebased = await rebaseBranch(defaultBranch, workspaceRoot);
+	if (!rebased.ok) return rebased;
+	return ok(void 0);
+}
+async function syncReleaseChanges(options) {
+	const { workspaceRoot, releaseBranch, commitMessage, hasChanges } = options;
+	const committed = hasChanges ? await commitChanges(commitMessage, workspaceRoot) : ok(false);
+	if (!committed.ok) return committed;
+	const isAhead = await isBranchAheadOfRemote(releaseBranch, workspaceRoot);
+	if (!isAhead.ok) return isAhead;
+	if (!committed.value && !isAhead.value) return ok(false);
+	const pushed = await pushBranch(releaseBranch, workspaceRoot, { forceWithLease: true });
+	if (!pushed.ok) return pushed;
+	return ok(true);
+}
+
+//#endregion
+//#region src/versioning/commits.ts
 /**
-* Create a version update object
+* Get commits grouped by workspace package.
+* For each package, retrieves all commits since its last release tag that affect that package.
+*
+* @param {string} workspaceRoot - The root directory of the workspace
+* @param {WorkspacePackage[]} packages - Array of workspace packages to analyze
+* @returns {Promise<Map<string, GitCommit[]>>} A map of package names to their commits since their last release
 */
-function createVersionUpdate(pkg, bump, hasDirectChanges) {
-	const newVersion = calculateNewVersion(pkg.version, bump);
+async function getWorkspacePackageGroupedCommits(workspaceRoot, packages) {
+	const changedPackages = /* @__PURE__ */ new Map();
+	const promises = packages.map(async (pkg) => {
+		const lastTagResult = await getMostRecentPackageTag(workspaceRoot, pkg.name);
+		const lastTag = lastTagResult.ok ? lastTagResult.value : void 0;
+		const allCommits = await getCommits({
+			from: lastTag,
+			to: "HEAD",
+			cwd: workspaceRoot,
+			folder: pkg.path
+		});
+		logger.verbose(`Found ${farver.cyan(allCommits.length)} commits for package ${farver.bold(pkg.name)} since tag ${farver.cyan(lastTag ?? "N/A")}`);
+		return {
+			pkgName: pkg.name,
+			commits: allCommits
+		};
+	});
+	const results = await Promise.all(promises);
+	for (const { pkgName, commits } of results) changedPackages.set(pkgName, commits);
+	return changedPackages;
+}
+/**
+* Check if a file path touches any package folder.
+* @param file - The file path to check
+* @param packagePaths - Set of normalized package paths
+* @param workspaceRoot - The workspace root for path normalization
+* @returns true if the file is inside a package folder
+*/
+function fileMatchesPackageFolder(file, packagePaths, workspaceRoot) {
+	const normalizedFile = file.startsWith("./") ? file.slice(2) : file;
+	for (const pkgPath of packagePaths) {
+		const normalizedPkgPath = pkgPath.startsWith(workspaceRoot) ? pkgPath.slice(workspaceRoot.length + 1) : pkgPath;
+		if (normalizedFile.startsWith(`${normalizedPkgPath}/`) || normalizedFile === normalizedPkgPath) return true;
+	}
+	return false;
+}
+/**
+* Check if a commit is a "global" commit (doesn't touch any package folder).
+* @param workspaceRoot - The workspace root
+* @param files - Array of files changed in the commit
+* @param packagePaths - Set of normalized package paths
+* @returns true if this is a global commit
+*/
+function isGlobalCommit(workspaceRoot, files, packagePaths) {
+	if (!files || files.length === 0) return false;
+	return !files.some((file) => fileMatchesPackageFolder(file, packagePaths, workspaceRoot));
+}
+const DEPENDENCY_FILES = [
+	"package.json",
+	"pnpm-lock.yaml",
+	"pnpm-workspace.yaml",
+	"yarn.lock",
+	"package-lock.json"
+];
+/**
+* Find the oldest and newest commits across all packages.
+* @param packageCommits - Map of package commits
+* @returns Object with oldest and newest commit SHAs, or null if no commits
+*/
+function findCommitRange(packageCommits) {
+	let oldestCommit = null;
+	let newestCommit = null;
+	for (const commits of packageCommits.values()) {
+		if (commits.length === 0) continue;
+		const firstCommit = commits[0].shortHash;
+		const lastCommit = commits[commits.length - 1].shortHash;
+		if (!newestCommit) newestCommit = firstCommit;
+		oldestCommit = lastCommit;
+	}
+	if (!oldestCommit || !newestCommit) return null;
 	return {
-		package: pkg,
-		currentVersion: pkg.version,
-		newVersion,
-		bumpType: bump,
-		hasDirectChanges
+		oldest: oldestCommit,
+		newest: newestCommit
 	};
 }
 /**
-* Update a package.json file with new version and dependency versions
+* Get global commits for each package based on their individual commit timelines.
+* This solves the problem where packages with different release histories need different global commits.
+*
+* A "global commit" is a commit that doesn't touch any package folder but may affect all packages
+* (e.g., root package.json, CI config, README).
+*
+* Performance: Makes ONE batched git call to get files for all commits across all packages.
+*
+* @param workspaceRoot - The root directory of the workspace
+* @param packageCommits - Map of package name to their commits (from getWorkspacePackageCommits)
+* @param allPackages - All workspace packages (used to identify package folders)
+* @param mode - Filter mode: false (disabled), "all" (all global commits), or "dependencies" (only dependency-related)
+* @returns Map of package name to their global commits
 */
-async function updatePackageJson(pkg, newVersion, dependencyUpdates) {
-	const packageJsonPath = join(pkg.path, "package.json");
-	const content = await readFile(packageJsonPath, "utf-8");
-	const packageJson = JSON.parse(content);
-	packageJson.version = newVersion;
-	for (const [depName, depVersion] of dependencyUpdates) {
-		if (packageJson.dependencies?.[depName]) {
-			if (packageJson.dependencies[depName] === "workspace:*") continue;
-			packageJson.dependencies[depName] = `^${depVersion}`;
+async function getGlobalCommitsPerPackage(workspaceRoot, packageCommits, allPackages, mode) {
+	const result = /* @__PURE__ */ new Map();
+	if (!mode) {
+		logger.verbose("Global commits mode disabled");
+		return result;
+	}
+	logger.verbose(`Computing global commits per-package (mode: ${farver.cyan(mode)})`);
+	const commitRange = findCommitRange(packageCommits);
+	if (!commitRange) {
+		logger.verbose("No commits found across packages");
+		return result;
+	}
+	logger.verbose("Fetching files for commits range", `${farver.cyan(commitRange.oldest)}..${farver.cyan(commitRange.newest)}`);
+	const commitFilesMap = await getGroupedFilesByCommitSha(workspaceRoot, commitRange.oldest, commitRange.newest);
+	if (!commitFilesMap.ok) {
+		logger.warn("Failed to get commit file list, returning empty global commits");
+		return result;
+	}
+	logger.verbose("Got file lists for commits", `${farver.cyan(commitFilesMap.value.size)} commits in ONE git call`);
+	const packagePaths = new Set(allPackages.map((p) => p.path));
+	for (const [pkgName, commits] of packageCommits) {
+		const globalCommitsAffectingPackage = [];
+		logger.verbose("Filtering global commits for package", `${farver.bold(pkgName)} from ${farver.cyan(commits.length)} commits`);
+		for (const commit of commits) {
+			const files = commitFilesMap.value.get(commit.shortHash);
+			if (!files) continue;
+			if (isGlobalCommit(workspaceRoot, files, packagePaths)) globalCommitsAffectingPackage.push(commit);
 		}
-		if (packageJson.devDependencies?.[depName]) {
-			if (packageJson.devDependencies[depName] === "workspace:*") continue;
-			packageJson.devDependencies[depName] = `^${depVersion}`;
+		logger.verbose("Package global commits found", `${farver.bold(pkgName)}: ${farver.cyan(globalCommitsAffectingPackage.length)} global commits`);
+		if (mode === "all") {
+			result.set(pkgName, globalCommitsAffectingPackage);
+			continue;
 		}
-		if (packageJson.peerDependencies?.[depName]) {
-			if (packageJson.peerDependencies[depName] === "workspace:*") continue;
-			packageJson.peerDependencies[depName] = `^${depVersion}`;
+		const dependencyCommits = [];
+		for (const commit of globalCommitsAffectingPackage) {
+			const files = commitFilesMap.value.get(commit.shortHash);
+			if (!files) continue;
+			if (files.some((file) => DEPENDENCY_FILES.includes(file.startsWith("./") ? file.slice(2) : file))) {
+				logger.verbose("Global commit affects dependencies", `${farver.bold(pkgName)}: commit ${farver.cyan(commit.shortHash)} affects dependencies`);
+				dependencyCommits.push(commit);
+			}
 		}
+		logger.verbose("Global commits affect dependencies", `${farver.bold(pkgName)}: ${farver.cyan(dependencyCommits.length)} global commits affect dependencies`);
+		result.set(pkgName, dependencyCommits);
 	}
-	await writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, "utf-8");
+	return result;
 }
-/**
-* Get all dependency updates needed for a package
-*/
-function getDependencyUpdates(pkg, allUpdates) {
-	const updates = /* @__PURE__ */ new Map();
-	const allDeps = [...pkg.workspaceDependencies, ...pkg.workspaceDevDependencies];
-	for (const dep of allDeps) {
-		const update = allUpdates.find((u) => u.package.name === dep);
-		if (update) updates.set(dep, update.newVersion);
+
+//#endregion
+//#region src/operations/version.ts
+function determineHighestBump(commits) {
+	if (commits.length === 0) return "none";
+	let highestBump = "none";
+	for (const commit of commits) {
+		const bump = determineBumpType(commit);
+		if (bump === "major") return "major";
+		if (bump === "minor") highestBump = "minor";
+		else if (bump === "patch" && highestBump === "none") highestBump = "patch";
 	}
-	return updates;
+	return highestBump;
+}
+function createVersionUpdate(pkg, bump, hasDirectChanges) {
+	const newVersion = getNextVersion(pkg.version, bump);
+	return {
+		package: pkg,
+		currentVersion: pkg.version,
+		newVersion,
+		bumpType: bump,
+		hasDirectChanges
+	};
+}
+function determineBumpType(commit) {
+	if (!commit.isConventional) return "none";
+	if (commit.isBreaking) return "major";
+	if (commit.type === "feat") return "minor";
+	if (commit.type === "fix" || commit.type === "perf") return "patch";
+	return "none";
 }
 
 //#endregion
-//#region src/package.ts
+//#region src/versioning/package.ts
 /**
 * Build a dependency graph from workspace packages
 *
@@ -533,6 +1354,51 @@ function getAllAffectedPackages(graph, changedPackages) {
 	return affected;
 }
 /**
+* Calculate the order in which packages should be published
+*
+* Performs topological sorting to ensure dependencies are published before dependents.
+* Assigns a "level" to each package based on its depth in the dependency tree.
+*
+* This is used by the publish command to publish packages in the correct order.
+*
+* @param graph - Dependency graph
+* @param packagesToPublish - Set of package names to publish
+* @returns Array of packages in publish order with their dependency level
+*/
+function getPackagePublishOrder(graph, packagesToPublish) {
+	const result = [];
+	const visited = /* @__PURE__ */ new Set();
+	const toUpdate = new Set(packagesToPublish);
+	const packagesToProcess = new Set(packagesToPublish);
+	for (const pkg of packagesToPublish) {
+		const deps = graph.dependents.get(pkg);
+		if (deps) for (const dep of deps) {
+			packagesToProcess.add(dep);
+			toUpdate.add(dep);
+		}
+	}
+	function visit(pkgName, level) {
+		if (visited.has(pkgName)) return;
+		visited.add(pkgName);
+		const pkg = graph.packages.get(pkgName);
+		if (!pkg) return;
+		const allDeps = [...pkg.workspaceDependencies, ...pkg.workspaceDevDependencies];
+		let maxDepLevel = level;
+		for (const dep of allDeps) if (toUpdate.has(dep)) {
+			visit(dep, level);
+			const depResult = result.find((r) => r.package.name === dep);
+			if (depResult && depResult.level >= maxDepLevel) maxDepLevel = depResult.level + 1;
+		}
+		result.push({
+			package: pkg,
+			level: maxDepLevel
+		});
+	}
+	for (const pkg of toUpdate) visit(pkg, 0);
+	result.sort((a, b) => a.level - b.level);
+	return result;
+}
+/**
 * Create version updates for all packages affected by dependency changes
 *
 * When a package is updated, all packages that depend on it should also be updated.
@@ -548,359 +1414,760 @@ function createDependentUpdates(graph, workspacePackages, directUpdates) {
 	const directUpdateMap = new Map(directUpdates.map((u) => [u.package.name, u]));
 	const affectedPackages = getAllAffectedPackages(graph, new Set(directUpdates.map((u) => u.package.name)));
 	for (const pkgName of affectedPackages) {
-		if (directUpdateMap.has(pkgName)) continue;
+		logger.verbose(`Processing affected package: ${pkgName}`);
+		if (directUpdateMap.has(pkgName)) {
+			logger.verbose(`Skipping ${pkgName}, already has a direct update`);
+			continue;
+		}
 		const pkg = workspacePackages.find((p) => p.name === pkgName);
 		if (!pkg) continue;
 		allUpdates.push(createVersionUpdate(pkg, "patch", false));
 	}
 	return allUpdates;
 }
-/**
-* Update all package.json files with new versions and dependency updates
-*
-* Updates are performed in parallel for better performance.
-*
-* @param updates - Version updates to apply
-*/
-async function updateAllPackageJsonFiles(updates) {
-	await Promise.all(updates.map(async (update) => {
-		const depUpdates = getDependencyUpdates(update.package, updates);
-		await updatePackageJson(update.package, update.newVersion, depUpdates);
-	}));
-}
 
 //#endregion
-//#region src/prompts.ts
-/**
-* Get commits for a package grouped by conventional commit type
-*
-* @param pkg - The workspace package
-* @param workspaceRoot - Root directory of the workspace
-* @param limit - Maximum number of commits to return (default: 10)
-* @returns Commits grouped by type
-*/
-async function getCommitsForPackage(pkg, workspaceRoot, limit = 10) {
-	const limitedCommits = (await getPackageCommits(pkg, workspaceRoot)).slice(0, limit);
-	const grouped = {
-		feat: [],
-		fix: [],
-		perf: [],
-		chore: [],
-		docs: [],
-		style: [],
-		refactor: [],
-		test: [],
-		build: [],
-		ci: [],
-		revert: [],
-		other: []
+//#region src/versioning/version.ts
+const messageColorMap = {
+	feat: farver.green,
+	feature: farver.green,
+	refactor: farver.cyan,
+	style: farver.cyan,
+	docs: farver.blue,
+	doc: farver.blue,
+	types: farver.blue,
+	type: farver.blue,
+	chore: farver.gray,
+	ci: farver.gray,
+	build: farver.gray,
+	deps: farver.gray,
+	dev: farver.gray,
+	fix: farver.yellow,
+	test: farver.yellow,
+	perf: farver.magenta,
+	revert: farver.red,
+	breaking: farver.red
+};
+function formatCommitsForDisplay(commits) {
+	if (commits.length === 0) return farver.dim("No commits found");
+	const maxCommitsToShow = 10;
+	const commitsToShow = commits.slice(0, maxCommitsToShow);
+	const hasMore = commits.length > maxCommitsToShow;
+	const typeLength = commits.map(({ type }) => type.length).reduce((a, b) => Math.max(a, b), 0);
+	const scopeLength = commits.map(({ scope }) => scope?.length).reduce((a, b) => Math.max(a || 0, b || 0), 0) || 0;
+	const formattedCommits = commitsToShow.map((commit) => {
+		let color = messageColorMap[commit.type] || ((c) => c);
+		if (commit.isBreaking) color = (s) => farver.inverse.red(s);
+		const paddedType = commit.type.padStart(typeLength + 1, " ");
+		const paddedScope = !commit.scope ? " ".repeat(scopeLength ? scopeLength + 2 : 0) : farver.dim("(") + commit.scope + farver.dim(")") + " ".repeat(scopeLength - commit.scope.length);
+		return [
+			farver.dim(commit.shortHash),
+			" ",
+			color === farver.gray ? color(paddedType) : farver.bold(color(paddedType)),
+			" ",
+			paddedScope,
+			farver.dim(":"),
+			" ",
+			color === farver.gray ? color(commit.description) : commit.description
+		].join("");
+	}).join("\n");
+	if (hasMore) return `${formattedCommits}\n  ${farver.dim(`... and ${commits.length - maxCommitsToShow} more commits`)}`;
+	return formattedCommits;
+}
+async function calculateVersionUpdates({ workspacePackages, packageCommits, workspaceRoot, showPrompt, globalCommitsPerPackage, overrides: initialOverrides = {} }) {
+	const versionUpdates = [];
+	const processedPackages = /* @__PURE__ */ new Set();
+	const newOverrides = { ...initialOverrides };
+	const bumpRanks = {
+		major: 3,
+		minor: 2,
+		patch: 1,
+		none: 0
+	};
+	logger.verbose(`Starting version inference for ${packageCommits.size} packages with commits`);
+	for (const [pkgName, pkgCommits] of packageCommits) {
+		const pkg = workspacePackages.find((p) => p.name === pkgName);
+		if (!pkg) {
+			logger.error(`Package ${pkgName} not found in workspace packages, skipping`);
+			continue;
+		}
+		processedPackages.add(pkgName);
+		const globalCommits = globalCommitsPerPackage.get(pkgName) || [];
+		const allCommitsForPackage = [...pkgCommits, ...globalCommits];
+		const determinedBump = determineHighestBump(allCommitsForPackage);
+		const override = newOverrides[pkgName];
+		const effectiveBump = override?.type || determinedBump;
+		if (effectiveBump === "none") continue;
+		let newVersion = override?.version || getNextVersion(pkg.version, effectiveBump);
+		let finalBumpType = effectiveBump;
+		if (!isCI && showPrompt) {
+			logger.clearScreen();
+			logger.section(`📝 Commits for ${farver.cyan(pkg.name)}`);
+			formatCommitsForDisplay(allCommitsForPackage).split("\n").forEach((line) => logger.item(line));
+			logger.emptyLine();
+			const selectedVersion = await selectVersionPrompt(workspaceRoot, pkg, pkg.version, newVersion);
+			if (selectedVersion === null) continue;
+			const userBump = calculateBumpType(pkg.version, selectedVersion);
+			finalBumpType = userBump;
+			if (bumpRanks[userBump] < bumpRanks[determinedBump]) {
+				newOverrides[pkgName] = {
+					type: userBump,
+					version: selectedVersion
+				};
+				logger.info(`Version override recorded for ${pkgName}: ${determinedBump} → ${userBump}`);
+			} else if (newOverrides[pkgName] && bumpRanks[userBump] >= bumpRanks[determinedBump]) {
+				delete newOverrides[pkgName];
+				logger.info(`Version override removed for ${pkgName}.`);
+			}
+			newVersion = selectedVersion;
+		}
+		versionUpdates.push({
+			package: pkg,
+			currentVersion: pkg.version,
+			newVersion,
+			bumpType: finalBumpType,
+			hasDirectChanges: allCommitsForPackage.length > 0
+		});
+	}
+	if (!isCI && showPrompt) for (const pkg of workspacePackages) {
+		if (processedPackages.has(pkg.name)) continue;
+		logger.clearScreen();
+		logger.section(`📦 Package: ${pkg.name}`);
+		logger.item("No direct commits found");
+		const newVersion = await selectVersionPrompt(workspaceRoot, pkg, pkg.version, pkg.version);
+		if (newVersion === null) break;
+		if (newVersion !== pkg.version) {
+			const bumpType = calculateBumpType(pkg.version, newVersion);
+			versionUpdates.push({
+				package: pkg,
+				currentVersion: pkg.version,
+				newVersion,
+				bumpType,
+				hasDirectChanges: false
+			});
+		}
+	}
+	return {
+		updates: versionUpdates,
+		overrides: newOverrides
 	};
-	for (const commit of limitedCommits) if (commit.type && commit.type in grouped) grouped[commit.type].push(commit);
-	else grouped.other.push(commit);
-	return grouped;
 }
 /**
-* Format grouped commits into a readable string
+* Calculate version updates and prepare dependent updates
+* Returns both the updates and a function to apply them
 */
-function formatCommitGroups(grouped) {
-	const lines = [];
-	const typeLabels = {
-		feat: "Features",
-		fix: "Bug Fixes",
-		perf: "Performance",
-		chore: "Chores",
-		docs: "Documentation",
-		style: "Styling",
-		refactor: "Refactoring",
-		test: "Tests",
-		build: "Build",
-		ci: "CI",
-		revert: "Reverts",
-		other: "Other"
+async function calculateAndPrepareVersionUpdates({ workspacePackages, packageCommits, workspaceRoot, showPrompt, globalCommitsPerPackage, overrides }) {
+	const { updates: directUpdates, overrides: newOverrides } = await calculateVersionUpdates({
+		workspacePackages,
+		packageCommits,
+		workspaceRoot,
+		showPrompt,
+		globalCommitsPerPackage,
+		overrides
+	});
+	const allUpdates = createDependentUpdates(buildPackageDependencyGraph(workspacePackages), workspacePackages, directUpdates);
+	const applyUpdates = async () => {
+		await Promise.all(allUpdates.map(async (update) => {
+			const depUpdates = getDependencyUpdates(update.package, allUpdates);
+			await updatePackageJson(update.package, update.newVersion, depUpdates);
+		}));
 	};
-	for (const type of [
-		"feat",
-		"fix",
-		"perf",
-		"refactor",
-		"test",
-		"docs",
-		"style",
-		"build",
-		"ci",
-		"chore",
-		"revert",
-		"other"
-	]) {
-		const commits = grouped[type];
-		if (commits.length > 0) {
-			lines.push(`\n${typeLabels[type]}:`);
-			for (const commit of commits) {
-				const scope = commit.scope ? `(${commit.scope})` : "";
-				const breaking = commit.isBreaking ? " ⚠️  BREAKING" : "";
-				lines.push(`  • ${commit.type}${scope}: ${commit.message}${breaking}`);
-			}
+	return {
+		allUpdates,
+		applyUpdates,
+		overrides: newOverrides
+	};
+}
+async function updatePackageJson(pkg, newVersion, dependencyUpdates) {
+	const packageJsonPath = join(pkg.path, "package.json");
+	const content = await readFile(packageJsonPath, "utf-8");
+	const packageJson = JSON.parse(content);
+	packageJson.version = newVersion;
+	function updateDependency(deps, depName, depVersion, isPeerDependency = false) {
+		if (!deps) return;
+		const oldVersion = deps[depName];
+		if (!oldVersion) return;
+		if (oldVersion === "workspace:*") {
+			logger.verbose(`  - Skipping workspace:* dependency: ${depName}`);
+			return;
 		}
+		if (isPeerDependency) {
+			const majorVersion = depVersion.split(".")[0];
+			deps[depName] = `>=${depVersion} <${Number(majorVersion) + 1}.0.0`;
+		} else deps[depName] = `^${depVersion}`;
+		logger.verbose(`  - Updated dependency ${depName}: ${oldVersion} → ${deps[depName]}`);
+	}
+	for (const [depName, depVersion] of dependencyUpdates) {
+		updateDependency(packageJson.dependencies, depName, depVersion);
+		updateDependency(packageJson.devDependencies, depName, depVersion);
+		updateDependency(packageJson.peerDependencies, depName, depVersion, true);
 	}
-	return lines.join("\n");
+	await writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, "utf-8");
+	logger.verbose(`  - Successfully wrote updated package.json`);
 }
-async function selectPackagePrompt(packages) {
-	const response = await prompts({
-		type: "multiselect",
-		name: "selectedPackages",
-		message: "Select packages to release",
-		choices: packages.map((pkg) => ({
-			title: `${pkg.name} (${farver.bold(pkg.version)})`,
-			value: pkg.name,
-			selected: true
-		})),
-		min: 1,
-		hint: "Space to select/deselect. Return to submit.",
-		instructions: false
-	});
-	if (!response.selectedPackages || response.selectedPackages.length === 0) return [];
-	return response.selectedPackages;
+/**
+* Get all dependency updates needed for a package
+*/
+function getDependencyUpdates(pkg, allUpdates) {
+	const updates = /* @__PURE__ */ new Map();
+	const allDeps = [...pkg.workspaceDependencies, ...pkg.workspaceDevDependencies];
+	for (const dep of allDeps) {
+		const update = allUpdates.find((u) => u.package.name === dep);
+		if (update) {
+			logger.verbose(`  - Dependency ${dep} will be updated: ${update.currentVersion} → ${update.newVersion} (${update.bumpType})`);
+			updates.set(dep, update.newVersion);
+		}
+	}
+	if (updates.size === 0) logger.verbose(`  - No dependency updates needed`);
+	return updates;
 }
-async function promptVersionOverride(pkg, workspaceRoot, currentVersion, suggestedVersion, suggestedBumpType) {
-	const commitSummary = formatCommitGroups(await getCommitsForPackage(pkg, workspaceRoot));
-	if (commitSummary.trim()) console.log(`\nRecent changes in ${pkg.name}:${commitSummary}\n`);
-	const choices = [{
-		title: `Use suggested: ${suggestedVersion} (${suggestedBumpType})`,
-		value: "suggested"
-	}];
-	for (const bumpType of [
-		"patch",
-		"minor",
-		"major"
-	]) if (bumpType !== suggestedBumpType) {
-		const version = calculateNewVersion(currentVersion, bumpType);
-		choices.push({
-			title: `${bumpType}: ${version}`,
-			value: bumpType
+
+//#endregion
+//#region src/operations/calculate.ts
+async function calculateUpdates(options) {
+	const { workspacePackages, workspaceRoot, showPrompt, overrides, globalCommitMode } = options;
+	try {
+		const grouped = await getWorkspacePackageGroupedCommits(workspaceRoot, workspacePackages);
+		return ok(await calculateAndPrepareVersionUpdates({
+			workspacePackages,
+			packageCommits: grouped,
+			workspaceRoot,
+			showPrompt,
+			globalCommitsPerPackage: await getGlobalCommitsPerPackage(workspaceRoot, grouped, workspacePackages, globalCommitMode),
+			overrides
+		}));
+	} catch (error) {
+		return err({
+			type: "git",
+			operation: "calculateUpdates",
+			message: error instanceof Error ? error.message : String(error)
 		});
 	}
-	choices.push({
-		title: "Custom version",
-		value: "custom"
+}
+function ensureHasPackages(packages) {
+	if (packages.length === 0) return err({
+		type: "git",
+		operation: "discoverWorkspacePackages",
+		message: "No packages found to release"
 	});
-	const response = await prompts([{
-		type: "select",
-		name: "choice",
-		message: `${pkg.name} (${currentVersion}):`,
-		choices,
-		initial: 0
-	}, {
-		type: (prev) => prev === "custom" ? "text" : null,
-		name: "customVersion",
-		message: "Enter custom version:",
-		initial: suggestedVersion,
-		validate: (value) => {
-			return /^\d+\.\d+\.\d+(?:[-+].+)?$/.test(value) || "Invalid semver version (e.g., 1.0.0)";
-		}
-	}]);
-	if (response.choice === "suggested") return suggestedVersion;
-	else if (response.choice === "custom") return response.customVersion;
-	else return calculateNewVersion(currentVersion, response.choice);
+	return ok(packages);
 }
-async function promptVersionOverrides(packages, workspaceRoot) {
-	const overrides = /* @__PURE__ */ new Map();
-	for (const item of packages) {
-		const newVersion = await promptVersionOverride(item.package, workspaceRoot, item.currentVersion, item.suggestedVersion, item.bumpType);
-		overrides.set(item.package.name, newVersion);
+
+//#endregion
+//#region src/operations/pr.ts
+async function syncPullRequest(options) {
+	const { github, releaseBranch, defaultBranch, pullRequestTitle, pullRequestBody, updates } = options;
+	let existing = null;
+	try {
+		existing = await github.getExistingPullRequest(releaseBranch);
+	} catch (error) {
+		return {
+			ok: false,
+			error: {
+				type: "github",
+				operation: "getExistingPullRequest",
+				message: error instanceof Error ? error.message : String(error)
+			}
+		};
+	}
+	const doesExist = !!existing;
+	const title = existing?.title || pullRequestTitle || "chore: update package versions";
+	const body = generatePullRequestBody(updates, pullRequestBody);
+	let pr = null;
+	try {
+		pr = await github.upsertPullRequest({
+			pullNumber: existing?.number,
+			title,
+			body,
+			head: releaseBranch,
+			base: defaultBranch
+		});
+	} catch (error) {
+		return {
+			ok: false,
+			error: {
+				type: "github",
+				operation: "upsertPullRequest",
+				message: error instanceof Error ? error.message : String(error)
+			}
+		};
 	}
-	return overrides;
+	return ok({
+		pullRequest: pr,
+		created: !doesExist
+	});
 }
 
 //#endregion
-//#region src/workspace.ts
-async function discoverWorkspacePackages(workspaceRoot, options) {
-	let workspaceOptions;
-	let explicitPackages;
-	if (options.packages == null || options.packages === true) workspaceOptions = { excludePrivate: false };
-	else if (Array.isArray(options.packages)) {
-		workspaceOptions = {
-			excludePrivate: false,
-			included: options.packages
-		};
-		explicitPackages = options.packages;
-	} else {
-		workspaceOptions = options.packages;
-		if (options.packages.included) explicitPackages = options.packages.included;
+//#region src/workflows/prepare.ts
+async function prepareWorkflow(options) {
+	if (options.safeguards) {
+		const clean = await isWorkingDirectoryClean(options.workspaceRoot);
+		if (!clean.ok || !clean.value) exitWithError("Working directory is not clean. Please commit or stash your changes before proceeding.");
 	}
-	const workspacePackages = await findWorkspacePackages(workspaceRoot, workspaceOptions);
-	if (explicitPackages) {
-		const foundNames = new Set(workspacePackages.map((p) => p.name));
-		const missing = explicitPackages.filter((p) => !foundNames.has(p));
-		if (missing.length > 0) throw new Error(`Packages not found in workspace: ${missing.join(", ")}`);
+	const discovered = await discoverWorkspacePackages(options.workspaceRoot, options);
+	if (!discovered.ok) exitWithError(`Failed to discover packages: ${discovered.error.message}`);
+	const ensured = ensureHasPackages(discovered.value);
+	if (!ensured.ok) {
+		logger.warn(ensured.error.message);
+		return null;
 	}
-	let packagesToAnalyze = workspacePackages;
-	const isPackagePromptEnabled = options.prompts?.packages !== false;
-	if (!isCI && isPackagePromptEnabled && !explicitPackages) {
-		const selectedNames = await selectPackagePrompt(workspacePackages);
-		packagesToAnalyze = workspacePackages.filter((pkg) => selectedNames.includes(pkg.name));
+	const workspacePackages = ensured.value;
+	logger.section("📦 Workspace Packages");
+	logger.item(`Found ${workspacePackages.length} packages`);
+	for (const pkg of workspacePackages) {
+		logger.item(`${farver.cyan(pkg.name)} (${farver.bold(pkg.version)})`);
+		logger.item(`  ${farver.gray("→")} ${farver.gray(pkg.path)}`);
 	}
-	return {
+	logger.emptyLine();
+	const prepareBranchResult = await prepareReleaseBranch({
+		workspaceRoot: options.workspaceRoot,
+		releaseBranch: options.branch.release,
+		defaultBranch: options.branch.default
+	});
+	if (!prepareBranchResult.ok) exitWithError(prepareBranchResult.error.message);
+	const overridesPath = join(options.workspaceRoot, ucdjsReleaseOverridesPath);
+	let existingOverrides = {};
+	try {
+		const overridesContent = await readFile(overridesPath, "utf-8");
+		existingOverrides = JSON.parse(overridesContent);
+		logger.info("Found existing version overrides file.");
+	} catch {
+		logger.info("No existing version overrides file found. Continuing...");
+	}
+	const updatesResult = await calculateUpdates({
 		workspacePackages,
-		packagesToAnalyze
+		workspaceRoot: options.workspaceRoot,
+		showPrompt: options.prompts?.versions !== false,
+		globalCommitMode: options.globalCommitMode === "none" ? false : options.globalCommitMode,
+		overrides: existingOverrides
+	});
+	if (!updatesResult.ok) exitWithError(updatesResult.error.message);
+	const { allUpdates, applyUpdates, overrides: newOverrides } = updatesResult.value;
+	if (Object.keys(newOverrides).length > 0) {
+		logger.info("Writing version overrides file...");
+		try {
+			await mkdir(join(options.workspaceRoot, ".github"), { recursive: true });
+			await writeFile(overridesPath, JSON.stringify(newOverrides, null, 2), "utf-8");
+			logger.success("Successfully wrote version overrides file.");
+		} catch (e) {
+			logger.error("Failed to write version overrides file:", e);
+		}
+	}
+	if (Object.keys(newOverrides).length === 0 && Object.keys(existingOverrides).length > 0) {
+		let shouldRemoveOverrides = false;
+		for (const update of allUpdates) {
+			const overriddenVersion = existingOverrides[update.package.name];
+			if (overriddenVersion) {
+				if (compare(update.newVersion, overriddenVersion.version) > 0) {
+					shouldRemoveOverrides = true;
+					break;
+				}
+			}
+		}
+		if (shouldRemoveOverrides) {
+			logger.info("Removing obsolete version overrides file...");
+			try {
+				await rm(overridesPath);
+				logger.success("Successfully removed obsolete version overrides file.");
+			} catch (e) {
+				logger.error("Failed to remove obsolete version overrides file:", e);
+			}
+		}
+	}
+	if (allUpdates.filter((u) => u.hasDirectChanges).length === 0) logger.warn("No packages have changes requiring a release");
+	logger.section("🔄 Version Updates");
+	logger.item(`Updating ${allUpdates.length} packages (including dependents)`);
+	for (const update of allUpdates) logger.item(`${update.package.name}: ${update.currentVersion} → ${update.newVersion}`);
+	await applyUpdates();
+	if (options.changelog?.enabled) {
+		logger.step("Updating changelogs");
+		const groupedPackageCommits = await getWorkspacePackageGroupedCommits(options.workspaceRoot, workspacePackages);
+		const globalCommitsPerPackage = await getGlobalCommitsPerPackage(options.workspaceRoot, groupedPackageCommits, workspacePackages, options.globalCommitMode === "none" ? false : options.globalCommitMode);
+		const changelogPromises = allUpdates.map((update) => {
+			const pkgCommits = groupedPackageCommits.get(update.package.name) || [];
+			const globalCommits = globalCommitsPerPackage.get(update.package.name) || [];
+			const allCommits = [...pkgCommits, ...globalCommits];
+			if (allCommits.length === 0) {
+				logger.verbose(`No commits for ${update.package.name}, skipping changelog`);
+				return Promise.resolve();
+			}
+			logger.verbose(`Updating changelog for ${farver.cyan(update.package.name)}`);
+			return updateChangelog({
+				normalizedOptions: {
+					...options,
+					workspaceRoot: options.workspaceRoot
+				},
+				githubClient: options.githubClient,
+				workspacePackage: update.package,
+				version: update.newVersion,
+				previousVersion: update.currentVersion !== "0.0.0" ? update.currentVersion : void 0,
+				commits: allCommits,
+				date: (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
+			});
+		}).filter((p) => p != null);
+		const updates = await Promise.all(changelogPromises);
+		logger.success(`Updated ${updates.length} changelog(s)`);
+	}
+	const hasChangesToPush = await syncReleaseChanges({
+		workspaceRoot: options.workspaceRoot,
+		releaseBranch: options.branch.release,
+		commitMessage: "chore: update release versions",
+		hasChanges: true
+	});
+	if (!hasChangesToPush.ok) exitWithError(hasChangesToPush.error.message);
+	if (!hasChangesToPush.value) {
+		const prResult = await syncPullRequest({
+			github: options.githubClient,
+			releaseBranch: options.branch.release,
+			defaultBranch: options.branch.default,
+			pullRequestTitle: options.pullRequest?.title,
+			pullRequestBody: options.pullRequest?.body,
+			updates: allUpdates
+		});
+		if (!prResult.ok) exitWithError(prResult.error.message);
+		if (prResult.value.pullRequest) {
+			logger.item("No updates needed, PR is already up to date");
+			return {
+				updates: allUpdates,
+				prUrl: prResult.value.pullRequest.html_url,
+				created: prResult.value.created
+			};
+		}
+		logger.error("No changes to commit, and no existing PR. Nothing to do.");
+		return null;
+	}
+	const prResult = await syncPullRequest({
+		github: options.githubClient,
+		releaseBranch: options.branch.release,
+		defaultBranch: options.branch.default,
+		pullRequestTitle: options.pullRequest?.title,
+		pullRequestBody: options.pullRequest?.body,
+		updates: allUpdates
+	});
+	if (!prResult.ok) exitWithError(prResult.error.message);
+	if (prResult.value.pullRequest?.html_url) {
+		logger.section("🚀 Pull Request");
+		logger.success(`Pull request ${prResult.value.created ? "created" : "updated"}: ${prResult.value.pullRequest.html_url}`);
+	}
+	const returnToDefault = await checkoutBranch(options.branch.default, options.workspaceRoot);
+	if (!returnToDefault.ok || !returnToDefault.value) exitWithError(`Failed to checkout branch: ${options.branch.default}`);
+	return {
+		updates: allUpdates,
+		prUrl: prResult.value.pullRequest?.html_url,
+		created: prResult.value.created
 	};
 }
-async function findWorkspacePackages(workspaceRoot, options) {
+
+//#endregion
+//#region src/core/npm.ts
+function toNPMError(operation, error, code) {
+	return {
+		type: "npm",
+		operation,
+		message: error instanceof Error ? error.message : String(error),
+		code
+	};
+}
+/**
+* Get the NPM registry URL
+* Respects NPM_CONFIG_REGISTRY environment variable, defaults to npmjs.org
+*/
+function getRegistryURL() {
+	return process.env.NPM_CONFIG_REGISTRY || "https://registry.npmjs.org";
+}
+/**
+* Fetch package metadata from NPM registry
+* @param packageName - The package name (e.g., "lodash" or "@scope/name")
+* @returns Result with package metadata or error
+*/
+async function getPackageMetadata(packageName) {
 	try {
-		const result = await run("pnpm", [
-			"-r",
-			"ls",
-			"--json"
+		const registry = getRegistryURL();
+		const encodedName = packageName.startsWith("@") ? `@${encodeURIComponent(packageName.slice(1))}` : encodeURIComponent(packageName);
+		const response = await fetch(`${registry}/${encodedName}`, { headers: { Accept: "application/json" } });
+		if (!response.ok) {
+			if (response.status === 404) return err(toNPMError("getPackageMetadata", `Package not found: ${packageName}`, "E404"));
+			return err(toNPMError("getPackageMetadata", `HTTP ${response.status}: ${response.statusText}`));
+		}
+		return ok(await response.json());
+	} catch (error) {
+		return err(toNPMError("getPackageMetadata", error, "ENETWORK"));
+	}
+}
+/**
+* Check if a specific package version exists on NPM
+* @param packageName - The package name
+* @param version - The version to check (e.g., "1.2.3")
+* @returns Result with boolean (true if version exists) or error
+*/
+async function checkVersionExists(packageName, version) {
+	const metadataResult = await getPackageMetadata(packageName);
+	if (!metadataResult.ok) {
+		if (metadataResult.error.code === "E404") return ok(false);
+		return err(metadataResult.error);
+	}
+	return ok(version in metadataResult.value.versions);
+}
+/**
+* Build a package before publishing
+* @param packageName - The package name to build
+* @param workspaceRoot - Path to the workspace root
+* @param options - Normalized release scripts options
+* @returns Result indicating success or failure
+*/
+async function buildPackage(packageName, workspaceRoot, options) {
+	if (!options.npm.runBuild) return ok(void 0);
+	try {
+		await runIfNotDry("pnpm", [
+			"--filter",
+			packageName,
+			"build"
 		], { nodeOptions: {
 			cwd: workspaceRoot,
-			stdio: "pipe"
+			stdio: "inherit"
 		} });
-		const rawProjects = JSON.parse(result.stdout);
-		const allPackageNames = new Set(rawProjects.map((p) => p.name));
-		const excludedPackages = /* @__PURE__ */ new Set();
-		const promises = rawProjects.map(async (rawProject) => {
-			const content = await readFile(join(rawProject.path, "package.json"), "utf-8");
-			const packageJson = JSON.parse(content);
-			if (!shouldIncludePackage(packageJson, options)) {
-				excludedPackages.add(rawProject.name);
-				return null;
-			}
-			return {
-				name: rawProject.name,
-				version: rawProject.version,
-				path: rawProject.path,
-				packageJson,
-				workspaceDependencies: extractWorkspaceDependencies(rawProject.dependencies, allPackageNames),
-				workspaceDevDependencies: extractWorkspaceDependencies(rawProject.devDependencies, allPackageNames)
-			};
-		});
-		const packages = await Promise.all(promises);
-		if (excludedPackages.size > 0) console.info(`${farver.cyan("[info]:")} Excluded packages: ${farver.green(Array.from(excludedPackages).join(", "))}`);
-		return packages.filter((pkg) => pkg !== null);
-	} catch (err) {
-		console.error("Error discovering workspace packages:", err);
-		throw err;
+		return ok(void 0);
+	} catch (error) {
+		return err(toNPMError("buildPackage", error));
 	}
 }
-function shouldIncludePackage(pkg, options) {
-	if (!options) return true;
-	if (options.excludePrivate && pkg.private) return false;
-	if (options.included && options.included.length > 0) {
-		if (!options.included.includes(pkg.name)) return false;
+/**
+* Publish a package to NPM
+* Uses pnpm to handle workspace protocol and catalog: resolution automatically
+* @param packageName - The package name to publish
+* @param workspaceRoot - Path to the workspace root
+* @param options - Normalized release scripts options
+* @returns Result indicating success or failure
+*/
+async function publishPackage(packageName, workspaceRoot, options) {
+	const args = [
+		"--filter",
+		packageName,
+		"publish",
+		"--access",
+		options.npm.access,
+		"--no-git-checks"
+	];
+	if (options.npm.otp) args.push("--otp", options.npm.otp);
+	if (process.env.NPM_CONFIG_TAG) args.push("--tag", process.env.NPM_CONFIG_TAG);
+	const env = { ...process.env };
+	if (options.npm.provenance) env.NPM_CONFIG_PROVENANCE = "true";
+	try {
+		await runIfNotDry("pnpm", args, { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "inherit",
+			env
+		} });
+		return ok(void 0);
+	} catch (error) {
+		const errorMessage = error instanceof Error ? error.message : String(error);
+		return err(toNPMError("publishPackage", error, errorMessage.includes("E403") ? "E403" : errorMessage.includes("EPUBLISHCONFLICT") ? "EPUBLISHCONFLICT" : errorMessage.includes("EOTP") ? "EOTP" : void 0));
 	}
-	if (options.excluded?.includes(pkg.name)) return false;
-	return true;
 }
-function extractWorkspaceDependencies(dependencies, workspacePackages) {
-	if (!dependencies) return [];
-	return Object.keys(dependencies).filter((dep) => {
-		return workspacePackages.has(dep);
-	});
+
+//#endregion
+//#region src/workflows/publish.ts
+async function publishWorkflow(options) {
+	logger.section("📦 Publishing Packages");
+	const discovered = await discoverWorkspacePackages(options.workspaceRoot, options);
+	if (!discovered.ok) exitWithError(`Failed to discover packages: ${discovered.error.message}`);
+	const workspacePackages = discovered.value;
+	logger.item(`Found ${workspacePackages.length} packages in workspace`);
+	const graph = buildPackageDependencyGraph(workspacePackages);
+	const publicPackages = workspacePackages.filter((pkg) => !pkg.packageJson.private);
+	logger.item(`Publishing ${publicPackages.length} public packages (private packages excluded)`);
+	if (publicPackages.length === 0) {
+		logger.warn("No public packages to publish");
+		return;
+	}
+	const publishOrder = getPackagePublishOrder(graph, new Set(publicPackages.map((p) => p.name)));
+	const status = {
+		published: [],
+		skipped: [],
+		failed: []
+	};
+	for (const order of publishOrder) {
+		const pkg = order.package;
+		const version = pkg.version;
+		const packageName = pkg.name;
+		logger.section(`📦 ${farver.cyan(packageName)} ${farver.gray(`(level ${order.level})`)}`);
+		logger.step(`Checking if ${farver.cyan(`${packageName}@${version}`)} exists on NPM...`);
+		const existsResult = await checkVersionExists(packageName, version);
+		if (!existsResult.ok) {
+			logger.error(`Failed to check version: ${existsResult.error.message}`);
+			status.failed.push(packageName);
+			exitWithError(`Publishing failed for ${packageName}: ${existsResult.error.message}`, "Check your network connection and NPM registry access");
+		}
+		if (existsResult.value) {
+			logger.info(`Version ${farver.cyan(version)} already exists on NPM, skipping`);
+			status.skipped.push(packageName);
+			continue;
+		}
+		if (options.npm.runBuild) {
+			logger.step(`Building ${farver.cyan(packageName)}...`);
+			const buildResult = await buildPackage(packageName, options.workspaceRoot, options);
+			if (!buildResult.ok) {
+				logger.error(`Failed to build package: ${buildResult.error.message}`);
+				status.failed.push(packageName);
+				exitWithError(`Publishing failed for ${packageName}: build failed`, "Check your build scripts and dependencies");
+			}
+		}
+		logger.step(`Publishing ${farver.cyan(`${packageName}@${version}`)} to NPM...`);
+		const publishResult = await publishPackage(packageName, options.workspaceRoot, options);
+		if (!publishResult.ok) {
+			logger.error(`Failed to publish: ${publishResult.error.message}`);
+			status.failed.push(packageName);
+			let hint;
+			if (publishResult.error.code === "E403") hint = "Authentication failed. Ensure your NPM token or OIDC configuration is correct";
+			else if (publishResult.error.code === "EPUBLISHCONFLICT") hint = "Version conflict. The version may have been published recently";
+			else if (publishResult.error.code === "EOTP") hint = "2FA/OTP required. Provide the otp option or use OIDC authentication";
+			exitWithError(`Publishing failed for ${packageName}`, hint);
+		}
+		logger.success(`Published ${farver.cyan(`${packageName}@${version}`)}`);
+		status.published.push(packageName);
+		logger.step(`Creating git tag ${farver.cyan(`${packageName}@${version}`)}...`);
+		const tagResult = await createAndPushPackageTag(packageName, version, options.workspaceRoot);
+		if (!tagResult.ok) {
+			logger.error(`Failed to create/push tag: ${tagResult.error.message}`);
+			logger.warn(`Package was published but tag was not created. You may need to create it manually.`);
+		} else logger.success(`Created and pushed tag ${farver.cyan(`${packageName}@${version}`)}`);
+	}
+	logger.section("📊 Publishing Summary");
+	logger.item(`${farver.green("✓")} Published: ${status.published.length} package(s)`);
+	if (status.published.length > 0) for (const pkg of status.published) logger.item(`  ${farver.green("•")} ${pkg}`);
+	if (status.skipped.length > 0) {
+		logger.item(`${farver.yellow("⚠")} Skipped (already exists): ${status.skipped.length} package(s)`);
+		for (const pkg of status.skipped) logger.item(`  ${farver.yellow("•")} ${pkg}`);
+	}
+	if (status.failed.length > 0) {
+		logger.item(`${farver.red("✖")} Failed: ${status.failed.length} package(s)`);
+		for (const pkg of status.failed) logger.item(`  ${farver.red("•")} ${pkg}`);
+	}
+	if (status.failed.length > 0) exitWithError(`Publishing completed with ${status.failed.length} failure(s)`);
+	logger.success("All packages published successfully!");
 }
 
 //#endregion
-//#region src/release.ts
-async function release(options) {
-	const { dryRun: dryRun$1 = false, safeguards = true, workspaceRoot = process.cwd(), releaseBranch = "release/next", githubToken } = options;
-	globalOptions.dryRun = dryRun$1;
-	if (githubToken.trim() === "" || githubToken == null) throw new Error("GitHub token is required");
-	const [owner, repo] = options.repo.split("/");
-	if (!owner || !repo) throw new Error(`Invalid repo format: ${options.repo}. Expected "owner/repo".`);
-	if (safeguards && !await isWorkingDirectoryClean(workspaceRoot)) {
-		console.error("Working directory is not clean. Please commit or stash your changes before proceeding.");
-		return null;
+//#region src/workflows/verify.ts
+async function verifyWorkflow(options) {
+	if (options.safeguards) {
+		const clean = await isWorkingDirectoryClean(options.workspaceRoot);
+		if (!clean.ok || !clean.value) exitWithError("Working directory is not clean. Please commit or stash your changes before proceeding.");
 	}
-	const { workspacePackages, packagesToAnalyze } = await discoverWorkspacePackages(workspaceRoot, options);
-	if (packagesToAnalyze.length === 0) {
-		console.log("No packages found to analyze for release.");
-		return null;
+	const releaseBranch = options.branch.release;
+	const defaultBranch = options.branch.default;
+	const releasePr = await options.githubClient.getExistingPullRequest(releaseBranch);
+	if (!releasePr || !releasePr.head) {
+		logger.warn(`No open release pull request found for branch "${releaseBranch}". Nothing to verify.`);
+		return;
 	}
-	const changedPackages = await analyzeCommits(packagesToAnalyze, workspaceRoot);
-	if (changedPackages.size === 0) throw new Error("No packages have changes requiring a release");
-	let versionUpdates = [];
-	for (const [pkgName, bump] of changedPackages) {
-		const pkg = workspacePackages.find((p) => p.name === pkgName);
-		if (pkg) versionUpdates.push(createVersionUpdate(pkg, bump, true));
-	}
-	const isVersionPromptEnabled = options.prompts?.versions !== false;
-	if (!isCI && isVersionPromptEnabled) {
-		const versionOverrides = await promptVersionOverrides(versionUpdates.map((u) => ({
-			package: u.package,
-			currentVersion: u.currentVersion,
-			suggestedVersion: u.newVersion,
-			bumpType: u.bumpType
-		})), workspaceRoot);
-		versionUpdates = versionUpdates.map((update) => {
-			const overriddenVersion = versionOverrides.get(update.package.name);
-			if (overriddenVersion && overriddenVersion !== update.newVersion) return {
-				...update,
-				newVersion: overriddenVersion
-			};
-			return update;
-		});
+	logger.info(`Found release PR #${releasePr.number}. Verifying against default branch "${defaultBranch}"...`);
+	const originalBranch = await getCurrentBranch(options.workspaceRoot);
+	if (!originalBranch.ok) exitWithError(originalBranch.error.message);
+	if (originalBranch.value !== defaultBranch) {
+		const checkout = await checkoutBranch(defaultBranch, options.workspaceRoot);
+		if (!checkout.ok || !checkout.value) exitWithError(`Failed to checkout branch: ${defaultBranch}`);
 	}
-	const allUpdates = createDependentUpdates(buildPackageDependencyGraph(workspacePackages), workspacePackages, versionUpdates);
-	const currentBranch = await getCurrentBranch(workspaceRoot);
-	const existingPullRequest = await getExistingPullRequest({
-		owner,
-		repo,
-		branch: releaseBranch,
-		githubToken
-	});
-	const prExists = !!existingPullRequest;
-	if (prExists) console.log("Existing pull request found:", existingPullRequest.html_url);
-	else console.log("No existing pull request found, will create new one");
-	const branchExists = await doesBranchExist(releaseBranch, workspaceRoot);
-	if (!branchExists) {
-		console.log("Creating release branch:", releaseBranch);
-		await createBranch(releaseBranch, currentBranch, workspaceRoot);
-	}
-	if (!await checkoutBranch(releaseBranch, workspaceRoot)) throw new Error(`Failed to checkout branch: ${releaseBranch}`);
-	if (branchExists) {
-		console.log("Pulling latest changes from remote");
-		if (!await pullLatestChanges(releaseBranch, workspaceRoot)) console.log("Warning: Failed to pull latest changes, continuing anyway");
-	}
-	console.log("Rebasing release branch onto", currentBranch);
-	await rebaseBranch(currentBranch, workspaceRoot);
-	await updateAllPackageJsonFiles(allUpdates);
-	const hasCommitted = await commitChanges("chore: update release versions", workspaceRoot);
-	const isBranchAhead = await isBranchAheadOfRemote(releaseBranch, workspaceRoot);
-	if (!hasCommitted && !isBranchAhead) {
-		console.log("No changes to commit and branch is in sync with remote");
-		await checkoutBranch(currentBranch, workspaceRoot);
-		if (prExists) {
-			console.log("No updates needed, PR is already up to date");
-			return {
-				updates: allUpdates,
-				prUrl: existingPullRequest.html_url,
-				created: false
-			};
-		} else {
-			console.error("No changes to commit, and no existing PR. Nothing to do.");
-			return null;
+	let existingOverrides = {};
+	try {
+		const overridesContent = await readFileFromGit(options.workspaceRoot, releasePr.head.sha, ucdjsReleaseOverridesPath);
+		if (overridesContent.ok && overridesContent.value) {
+			existingOverrides = JSON.parse(overridesContent.value);
+			logger.info("Found existing version overrides file on release branch.");
 		}
+	} catch {
+		logger.info("No version overrides file found on release branch. Continuing...");
 	}
-	console.log("Pushing changes to remote");
-	await pushBranch(releaseBranch, workspaceRoot, { forceWithLease: true });
-	const prTitle = existingPullRequest?.title || options.pullRequest?.title || "chore: update package versions";
-	const prBody = generatePullRequestBody(allUpdates, options.pullRequest?.body);
-	const pullRequest = await upsertPullRequest({
-		owner,
-		repo,
-		pullNumber: existingPullRequest?.number,
-		title: prTitle,
-		body: prBody,
-		head: releaseBranch,
-		base: currentBranch,
-		githubToken
+	const discovered = await discoverWorkspacePackages(options.workspaceRoot, options);
+	if (!discovered.ok) exitWithError(`Failed to discover packages: ${discovered.error.message}`);
+	const ensured = ensureHasPackages(discovered.value);
+	if (!ensured.ok) {
+		logger.warn(ensured.error.message);
+		return;
+	}
+	const mainPackages = ensured.value;
+	const updatesResult = await calculateUpdates({
+		workspacePackages: mainPackages,
+		workspaceRoot: options.workspaceRoot,
+		showPrompt: false,
+		globalCommitMode: options.globalCommitMode === "none" ? false : options.globalCommitMode,
+		overrides: existingOverrides
 	});
-	console.log(prExists ? "Updated pull request:" : "Created pull request:", pullRequest?.html_url);
-	await checkoutBranch(currentBranch, workspaceRoot);
+	if (!updatesResult.ok) exitWithError(updatesResult.error.message);
+	const expectedUpdates = updatesResult.value.allUpdates;
+	const expectedVersionMap = new Map(expectedUpdates.map((u) => [u.package.name, u.newVersion]));
+	const prVersionMap = /* @__PURE__ */ new Map();
+	for (const pkg of mainPackages) {
+		const pkgJsonPath = relative(options.workspaceRoot, join(pkg.path, "package.json"));
+		const pkgJsonContent = await readFileFromGit(options.workspaceRoot, releasePr.head.sha, pkgJsonPath);
+		if (pkgJsonContent.ok && pkgJsonContent.value) {
+			const pkgJson = JSON.parse(pkgJsonContent.value);
+			prVersionMap.set(pkg.name, pkgJson.version);
+		}
+	}
+	if (originalBranch.value !== defaultBranch) await checkoutBranch(originalBranch.value, options.workspaceRoot);
+	let isOutOfSync = false;
+	for (const [pkgName, expectedVersion] of expectedVersionMap.entries()) {
+		const prVersion = prVersionMap.get(pkgName);
+		if (!prVersion) {
+			logger.warn(`Package "${pkgName}" found in default branch but not in release branch. Skipping.`);
+			continue;
+		}
+		if (gt(expectedVersion, prVersion)) {
+			logger.error(`Package "${pkgName}" is out of sync. Expected version >= ${expectedVersion}, but PR has ${prVersion}.`);
+			isOutOfSync = true;
+		} else logger.success(`Package "${pkgName}" is up to date (PR version: ${prVersion}, Expected: ${expectedVersion})`);
+	}
+	const statusContext = "ucdjs/release-verify";
+	if (isOutOfSync) {
+		await options.githubClient.setCommitStatus({
+			sha: releasePr.head.sha,
+			state: "failure",
+			context: statusContext,
+			description: "Release PR is out of sync with the default branch. Please re-run the release process."
+		});
+		logger.error("Verification failed. Commit status set to 'failure'.");
+	} else {
+		await options.githubClient.setCommitStatus({
+			sha: releasePr.head.sha,
+			state: "success",
+			context: statusContext,
+			description: "Release PR is up to date.",
+			targetUrl: `https://github.com/${options.owner}/${options.repo}/pull/${releasePr.number}`
+		});
+		logger.success("Verification successful. Commit status set to 'success'.");
+	}
+}
+
+//#endregion
+//#region src/index.ts
+async function createReleaseScripts(options) {
+	const normalizedOptions = normalizeReleaseScriptsOptions(options);
 	return {
-		updates: allUpdates,
-		prUrl: pullRequest?.html_url,
-		created: !prExists
+		async verify() {
+			return verifyWorkflow(normalizedOptions);
+		},
+		async prepare() {
+			return prepareWorkflow(normalizedOptions);
+		},
+		async publish() {
+			return publishWorkflow(normalizedOptions);
+		},
+		packages: {
+			async list() {
+				const result = await discoverWorkspacePackages(normalizedOptions.workspaceRoot, normalizedOptions);
+				if (!result.ok) throw new Error(result.error.message);
+				return result.value;
+			},
+			async get(packageName) {
+				const result = await discoverWorkspacePackages(normalizedOptions.workspaceRoot, normalizedOptions);
+				if (!result.ok) throw new Error(result.error.message);
+				return result.value.find((p) => p.name === packageName);
+			}
+		}
 	};
 }
 
 //#endregion
-export { release };
+export { createReleaseScripts };