@ucdjs/release-scripts 0.1.0-beta.15 → 0.1.0-beta.17

package/dist/{eta-Boh7yPZi.mjs → eta-j5TFRbI4.mjs}

@@ -1,5 +1,5 @@
-import * as fs from "node:fs";
 import * as path from "node:path";
+import * as fs from "node:fs";
 
 //#region node_modules/.pnpm/eta@4.0.1/node_modules/eta/dist/index.js
 var EtaError = class extends Error {
@@ -90,8 +90,8 @@ function resolvePath(templatePath, options) {
 	} else throw new EtaFileResolutionError(`Template '${templatePath}' is not in the views directory`);
 }
 function dirIsChild(parent, dir) {
-	const relative = path.relative(parent, dir);
-	return relative && !relative.startsWith("..") && !path.isAbsolute(relative);
+	const relative$1 = path.relative(parent, dir);
+	return relative$1 && !relative$1.startsWith("..") && !path.isAbsolute(relative$1);
 }
 const absolutePathRegExp = /^\\|^\//;
 /* istanbul ignore next */

package/dist/index.d.mts

@@ -11,11 +11,25 @@ interface WorkspacePackage {
 //#region src/shared/types.d.ts
 type BumpKind = "none" | "patch" | "minor" | "major";
 type GlobalCommitMode = false | "dependencies" | "all";
+interface CommitGroup {
+  /**
+   * Unique identifier for the group
+   */
+  name: string;
+  /**
+   * Display title (e.g., "Features", "Bug Fixes")
+   */
+  title: string;
+  /**
+   * Conventional commit types to include in this group
+   */
+  types: string[];
+}
 interface SharedOptions {
   /**
    * Repository identifier (e.g., "owner/repo")
    */
-  repo: string;
+  repo: `${string}/${string}`;
   /**
    * Root directory of the workspace (defaults to process.cwd())
    */
@@ -44,6 +58,12 @@ interface SharedOptions {
      */
     versions?: boolean;
   };
+  /**
+   * Commit grouping configuration
+   * Used for changelog generation and commit display
+   * @default DEFAULT_COMMIT_GROUPS
+   */
+  groups?: CommitGroup[];
 }
 interface PackageJson {
   name: string;
@@ -136,6 +156,10 @@ interface ReleaseOptions extends SharedOptions {
      * @default true
      */
     enabled?: boolean;
+    /**
+     * Custom changelog entry template (ETA format)
+     */
+    template?: string;
   };
   globalCommitMode?: GlobalCommitMode;
 }
@@ -155,4 +179,8 @@ interface ReleaseResult {
 }
 declare function release(options: ReleaseOptions): Promise<ReleaseResult | null>;
 //#endregion
-export { type PublishOptions, type ReleaseOptions, type ReleaseResult, publish, release };
+//#region src/verify.d.ts
+interface VerifyOptions extends SharedOptions {}
+declare function verify(_options: VerifyOptions): void;
+//#endregion
+export { type PublishOptions, type ReleaseOptions, type ReleaseResult, type VerifyOptions, publish, release, verify };

package/dist/index.mjs

@@ -1,12 +1,12 @@
-import { t as Eta } from "./eta-Boh7yPZi.mjs";
+import { t as Eta } from "./eta-j5TFRbI4.mjs";
+import { readFile, writeFile } from "node:fs/promises";
+import { join, relative } from "node:path";
 import process from "node:process";
 import farver from "farver";
 import mri from "mri";
 import { exec } from "tinyexec";
 import { dedent } from "@luxass/utils";
-import { join } from "node:path";
-import { readFile, writeFile } from "node:fs/promises";
-import { getCommits } from "commit-parser";
+import { getCommits, groupByType } from "commit-parser";
 import prompts from "prompts";
 
 //#region src/publish.ts
@@ -49,8 +49,8 @@ const logger = {
 	emptyLine: () => {
 		console.log();
 	},
-	item: (message) => {
-		console.log(`  ${message}`);
+	item: (message, ...args$1) => {
+		console.log(`  ${message}`, ...args$1);
 	},
 	step: (message) => {
 		console.log(`  ${farver.blue("→")} ${message}`);
@@ -78,28 +78,6 @@ function exitWithError(message, hint) {
 	if (hint) console.error(farver.gray(`  ${hint}`));
 	process.exit(1);
 }
-function normalizeSharedOptions(options) {
-	const { workspaceRoot = process.cwd(), githubToken = "", repo: fullRepo, packages = true, prompts: prompts$1 = {
-		packages: true,
-		versions: true
-	},...rest } = options;
-	if (!githubToken.trim()) exitWithError("GitHub token is required", "Set GITHUB_TOKEN environment variable or pass it in options");
-	if (!fullRepo || !fullRepo.trim() || !fullRepo.includes("/")) exitWithError("Repository (repo) is required", "Specify the repository in 'owner/repo' format (e.g., 'octocat/hello-world')");
-	const [owner, repo] = fullRepo.split("/");
-	if (!owner || !repo) exitWithError(`Invalid repo format: "${fullRepo}"`, "Expected format: \"owner/repo\" (e.g., \"octocat/hello-world\")");
-	return {
-		...rest,
-		packages,
-		prompts: {
-			packages: prompts$1?.packages ?? true,
-			versions: prompts$1?.versions ?? true
-		},
-		workspaceRoot,
-		githubToken,
-		owner,
-		repo
-	};
-}
 if (isDryRun || isVerbose || isForce) {
 	logger.verbose(farver.inverse(farver.yellow(" Running with special flags ")));
 	logger.verbose({
@@ -328,19 +306,314 @@ async function pushBranch(branch, workspaceRoot, options) {
 		exitWithError(`Failed to push branch: ${branch}`, `Make sure you have permission to push to the remote repository`);
 	}
 }
+async function readFileFromGit(workspaceRoot, ref, filePath) {
+	try {
+		return (await run("git", ["show", `${ref}:${filePath}`], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} })).stdout;
+	} catch {
+		return null;
+	}
+}
+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;
+		return tags.reverse()[0];
+	} catch (err) {
+		logger.warn(`Failed to get tags for package ${packageName}: ${err.message}`);
+		return;
+	}
+}
+/**
+* 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 commitsMap;
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+//#region src/core/changelog.ts
+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 %>
+  <% }); %>
+
+  <% } %>
+  <% }); %>
+`;
+async function generateChangelogEntry(options) {
+	const { packageName, version, previousVersion, date, commits, owner, repo, groups, template, githubClient } = options;
+	const compareUrl = previousVersion ? `https://github.com/${owner}/${repo}/compare/${packageName}@${previousVersion}...${packageName}@${version}` : void 0;
+	const grouped = groupByType(commits, {
+		includeNonConventional: false,
+		mergeKeys: Object.fromEntries(groups.map((g) => [g.name, g.types]))
+	});
+	const commitAuthors = await resolveCommitAuthors(commits, githubClient);
+	const templateData = {
+		packageName,
+		version,
+		previousVersion,
+		date,
+		compareUrl,
+		owner,
+		repo,
+		groups: groups.map((group) => {
+			const commitsInGroup = grouped.get(group.name) ?? [];
+			if (commitsInGroup.length > 0) logger.verbose(`Found ${commitsInGroup.length} commits for group "${group.name}".`);
+			const formattedCommits = commitsInGroup.map((commit) => ({ line: formatCommitLine({
+				commit,
+				owner,
+				repo,
+				authors: commitAuthors.get(commit.hash) ?? []
+			}) }));
+			return {
+				name: group.name,
+				title: group.title,
+				commits: formattedCommits
+			};
+		})
+	};
+	const eta = new Eta();
+	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: ", Boolean(existingContent));
+	const newEntry = await generateChangelogEntry({
+		packageName: workspacePackage.name,
+		version,
+		previousVersion,
+		date,
+		commits,
+		owner: normalizedOptions.owner,
+		repo: normalizedOptions.repo,
+		groups: normalizedOptions.groups,
+		template: normalizedOptions.changelog?.template,
+		githubClient
+	});
+	let updatedContent;
+	if (!existingContent) {
+		updatedContent = `# ${workspacePackage.name}\n\n${newEntry}\n`;
+		await writeFile(changelogPath, updatedContent, "utf-8");
+		return;
+	}
+	const parsed = parseChangelog(existingContent);
+	const lines = existingContent.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 authorsByEmail = /* @__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 (!authorsByEmail.has(author.email)) authorsByEmail.set(author.email, {
+				commits: [],
+				name: author.name,
+				email: author.email
+			});
+			const info = authorsByEmail.get(author.email);
+			if (idx === 0) info.commits.push(commit.shortHash);
+			authorsForCommit.push(info);
+		});
+		commitAuthors.set(commit.hash, authorsForCommit);
+	}
+	await Promise.all(Array.from(authorsByEmail.values()).map((info) => githubClient.resolveAuthorInfo(info)));
+	return commitAuthors;
+}
+function formatCommitLine({ commit, owner, repo, authors }) {
+	const commitUrl = `https://github.com/${owner}/${repo}/commit/${commit.hash}`;
+	let line = `${commit.description}`;
+	const references = commit.references ?? [];
+	if (references.length > 0) logger.verbose("Located references in commit", references.length);
+	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) => {
+			if (author.login) return `[@${author.login}](https://github.com/${author.login})`;
+			return author.name;
+		}).join(", ");
+		line += ` (by ${authorList})`;
+	}
+	return line;
+}
+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/core/github.ts
-async function getExistingPullRequest({ owner, repo, branch, githubToken }) {
-	try {
-		logger.verbose(`Requesting pull request for branch: ${branch} (url: https://api.github.com/repos/${owner}/${repo}/pulls?state=open&head=${branch})`);
-		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}`
-		} });
-		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;
+var GitHubClient = class {
+	owner;
+	repo;
+	githubToken;
+	apiBase = "https://api.github.com";
+	constructor({ owner, repo, githubToken }) {
+		this.owner = owner;
+		this.repo = repo;
+		this.githubToken = githubToken;
+	}
+	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}`
+			}
+		});
+		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 = {
@@ -348,20 +621,15 @@ async function getExistingPullRequest({ owner, repo, branch, githubToken }) {
 			title: firstPullRequest.title,
 			body: firstPullRequest.body,
 			draft: firstPullRequest.draft,
-			html_url: firstPullRequest.html_url
+			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;
-	} catch (err) {
-		logger.error("Error fetching pull request:", err);
-		return null;
 	}
-}
-async function upsertPullRequest({ owner, repo, title, body, head, base, pullNumber, githubToken }) {
-	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";
+	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
@@ -372,17 +640,11 @@ async function upsertPullRequest({ owner, repo, title, body, head, base, pullNum
 			base,
 			draft: true
 		};
-		logger.verbose(`${isUpdate ? "Updating" : "Creating"} pull request (url: ${url})`);
-		const res = await fetch(url, {
-			method,
-			headers: {
-				Accept: "application/vnd.github.v3+json",
-				Authorization: `token ${githubToken}`
-			},
+		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 (!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";
 		logger.info(`${action} pull request: ${farver.yellow(`#${pr.number}`)}`);
@@ -393,12 +655,45 @@ async function upsertPullRequest({ owner, repo, title, body, head, base, pullNum
 			draft: pr.draft,
 			html_url: pr.html_url
 		};
-	} catch (err) {
-		logger.error(`Error upserting pull request:`, err);
-		throw err;
 	}
+	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);
 }
-const defaultTemplate = dedent`
+const DEFAULT_PR_BODY_TEMPLATE = dedent`
   This PR was automatically generated by the release script.
 
   The following packages have been prepared for release:
@@ -421,7 +716,7 @@ function dedentString(str) {
 }
 function generatePullRequestBody(updates, body) {
 	const eta = new Eta();
-	const bodyTemplate = body ? dedentString(body) : defaultTemplate;
+	const bodyTemplate = body ? dedentString(body) : DEFAULT_PR_BODY_TEMPLATE;
 	return eta.renderString(bodyTemplate, { packages: updates.map((u) => ({
 		name: u.package.name,
 		currentVersion: u.currentVersion,
@@ -433,24 +728,6 @@ function generatePullRequestBody(updates, body) {
 
 //#endregion
 //#region src/versioning/commits.ts
-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;
-		return tags.reverse()[0];
-	} catch (err) {
-		logger.warn(`Failed to get tags for package ${packageName}: ${err.message}`);
-		return;
-	}
-}
 function determineHighestBump(commits) {
 	if (commits.length === 0) return "none";
 	let highestBump = "none";
@@ -490,33 +767,6 @@ async function getWorkspacePackageGroupedCommits(workspaceRoot, packages) {
 	for (const { pkgName, commits } of results) changedPackages.set(pkgName, commits);
 	return changedPackages;
 }
-async function getCommitFileList(workspaceRoot, from, to) {
-	const commits = /* @__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;
-				commits.set(currentSha, []);
-			} else if (currentSha !== null) commits.get(currentSha)?.push(trimmedLine);
-		}
-		return commits;
-	} catch {
-		return null;
-	}
-}
 /**
 * Check if a file path touches any package folder.
 * @param file - The file path to check
@@ -599,7 +849,7 @@ async function getGlobalCommitsPerPackage(workspaceRoot, packageCommits, allPack
 		return result;
 	}
 	logger.verbose("Fetching files for commits range", `${farver.cyan(commitRange.oldest)}..${farver.cyan(commitRange.newest)}`);
-	const commitFilesMap = await getCommitFileList(workspaceRoot, commitRange.oldest, commitRange.newest);
+	const commitFilesMap = await getGroupedFilesByCommitSha(workspaceRoot, commitRange.oldest, commitRange.newest);
 	if (!commitFilesMap) {
 		logger.warn("Failed to get commit file list, returning empty global commits");
 		return result;
@@ -814,7 +1064,7 @@ function formatCommitsForDisplay(commits) {
 	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, 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);
@@ -1108,6 +1358,87 @@ function shouldIncludePackage(pkg, options) {
 	return true;
 }
 
+//#endregion
+//#region src/shared/options.ts
+const DEFAULT_COMMIT_GROUPS = [
+	{
+		name: "features",
+		title: "Features",
+		types: ["feat"]
+	},
+	{
+		name: "fixes",
+		title: "Bug Fixes",
+		types: ["fix", "perf"]
+	},
+	{
+		name: "refactor",
+		title: "Refactoring",
+		types: ["refactor"]
+	},
+	{
+		name: "docs",
+		title: "Documentation",
+		types: ["docs"]
+	}
+];
+function normalizeSharedOptions(options) {
+	const { workspaceRoot = process.cwd(), githubToken = "", repo: fullRepo, packages = true, prompts: prompts$1 = {
+		packages: true,
+		versions: true
+	}, groups = DEFAULT_COMMIT_GROUPS } = options;
+	if (!githubToken.trim()) exitWithError("GitHub token is required", "Set GITHUB_TOKEN environment variable or pass it in options");
+	if (!fullRepo || !fullRepo.trim() || !fullRepo.includes("/")) exitWithError("Repository (repo) is required", "Specify the repository in 'owner/repo' format (e.g., 'octocat/hello-world')");
+	const [owner, repo] = fullRepo.split("/");
+	if (!owner || !repo) exitWithError(`Invalid repo format: "${fullRepo}"`, "Expected format: \"owner/repo\" (e.g., \"octocat/hello-world\")");
+	return {
+		packages: typeof packages === "object" && !Array.isArray(packages) ? {
+			exclude: packages.exclude ?? [],
+			include: packages.include ?? [],
+			excludePrivate: packages.excludePrivate ?? false
+		} : packages,
+		prompts: {
+			packages: prompts$1?.packages ?? true,
+			versions: prompts$1?.versions ?? true
+		},
+		workspaceRoot,
+		githubToken,
+		owner,
+		repo,
+		groups
+	};
+}
+async function normalizeReleaseOptions(options) {
+	const normalized = normalizeSharedOptions(options);
+	let defaultBranch = options.branch?.default?.trim();
+	const releaseBranch = options.branch?.release?.trim() ?? "release/next";
+	if (defaultBranch == null || defaultBranch === "") {
+		defaultBranch = await getDefaultBranch(normalized.workspaceRoot);
+		if (!defaultBranch) exitWithError("Could not determine default branch", "Please specify the default branch in options");
+	}
+	if (defaultBranch === releaseBranch) exitWithError(`Default branch and release branch cannot be the same: "${defaultBranch}"`, "Specify different branches for default and release");
+	const availableBranches = await getAvailableBranches(normalized.workspaceRoot);
+	if (!availableBranches.includes(defaultBranch)) exitWithError(`Default branch "${defaultBranch}" does not exist in the repository`, `Available branches: ${availableBranches.join(", ")}`);
+	logger.verbose(`Using default branch: ${farver.green(defaultBranch)}`);
+	return {
+		...normalized,
+		branch: {
+			release: releaseBranch,
+			default: defaultBranch
+		},
+		safeguards: options.safeguards ?? true,
+		globalCommitMode: options.globalCommitMode ?? "dependencies",
+		pullRequest: {
+			title: options.pullRequest?.title ?? "chore: release new version",
+			body: options.pullRequest?.body ?? DEFAULT_PR_BODY_TEMPLATE
+		},
+		changelog: {
+			enabled: options.changelog?.enabled ?? true,
+			template: options.changelog?.template ?? DEFAULT_CHANGELOG_TEMPLATE
+		}
+	};
+}
+
 //#endregion
 //#region src/release.ts
 async function release(options) {
@@ -1138,11 +1469,14 @@ async function release(options) {
 	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}`);
-	const prOps = await orchestrateReleasePullRequest({
-		workspaceRoot,
+	const githubClient = createGitHubClient({
 		owner: normalizedOptions.owner,
 		repo: normalizedOptions.repo,
-		githubToken: normalizedOptions.githubToken,
+		githubToken: normalizedOptions.githubToken
+	});
+	const prOps = await orchestrateReleasePullRequest({
+		workspaceRoot,
+		githubClient,
 		releaseBranch: normalizedOptions.branch.release,
 		defaultBranch: normalizedOptions.branch.default,
 		pullRequestTitle: options.pullRequest?.title,
@@ -1150,6 +1484,33 @@ async function release(options) {
 	});
 	await prOps.prepareBranch();
 	await applyUpdates();
+	if (normalizedOptions.changelog.enabled) {
+		logger.step("Updating changelogs");
+		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: {
+					...normalizedOptions,
+					workspaceRoot
+				},
+				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)`);
+	}
 	if (!await prOps.syncChanges(true)) if (prOps.doesReleasePRExist && prOps.existingPullRequest) {
 		logger.item("No updates needed, PR is already up to date");
 		const { pullRequest: pullRequest$1, created: created$1 } = await prOps.syncPullRequest(allUpdates);
@@ -1175,39 +1536,10 @@ async function release(options) {
 		created
 	};
 }
-async function normalizeReleaseOptions(options) {
-	const normalized = normalizeSharedOptions(options);
-	let defaultBranch = options.branch?.default?.trim();
-	const releaseBranch = options.branch?.release?.trim() ?? "release/next";
-	if (defaultBranch == null || defaultBranch === "") {
-		defaultBranch = await getDefaultBranch(normalized.workspaceRoot);
-		if (!defaultBranch) exitWithError("Could not determine default branch", "Please specify the default branch in options");
-	}
-	if (defaultBranch === releaseBranch) exitWithError(`Default branch and release branch cannot be the same: "${defaultBranch}"`, "Specify different branches for default and release");
-	const availableBranches = await getAvailableBranches(normalized.workspaceRoot);
-	if (!availableBranches.includes(defaultBranch)) exitWithError(`Default branch "${defaultBranch}" does not exist in the repository`, `Available branches: ${availableBranches.join(", ")}`);
-	logger.verbose(`Using default branch: ${farver.green(defaultBranch)}`);
-	return {
-		...normalized,
-		branch: {
-			release: releaseBranch,
-			default: defaultBranch
-		},
-		safeguards: options.safeguards ?? true,
-		globalCommitMode: options.globalCommitMode ?? "dependencies",
-		pullRequest: options.pullRequest,
-		changelog: { enabled: options.changelog?.enabled ?? true }
-	};
-}
-async function orchestrateReleasePullRequest({ workspaceRoot, owner, repo, githubToken, releaseBranch, defaultBranch, pullRequestTitle, pullRequestBody }) {
+async function orchestrateReleasePullRequest({ workspaceRoot, githubClient, releaseBranch, defaultBranch, pullRequestTitle, pullRequestBody }) {
 	const currentBranch = await getCurrentBranch(workspaceRoot);
 	if (currentBranch !== defaultBranch) exitWithError(`Current branch is '${currentBranch}'. Please switch to the default branch '${defaultBranch}' before proceeding.`, `git checkout ${defaultBranch}`);
-	const existingPullRequest = await getExistingPullRequest({
-		owner,
-		repo,
-		branch: releaseBranch,
-		githubToken
-	});
+	const existingPullRequest = await githubClient.getExistingPullRequest(releaseBranch);
 	const doesReleasePRExist = !!existingPullRequest;
 	if (doesReleasePRExist) logger.item("Found existing release pull request");
 	else logger.item("Will create new pull request");
@@ -1240,15 +1572,12 @@ async function orchestrateReleasePullRequest({ workspaceRoot, owner, repo, githu
 		async syncPullRequest(updates) {
 			const prTitle = existingPullRequest?.title || pullRequestTitle || "chore: update package versions";
 			const prBody = generatePullRequestBody(updates, pullRequestBody);
-			const pullRequest = await upsertPullRequest({
-				owner,
-				repo,
+			const pullRequest = await githubClient.upsertPullRequest({
 				pullNumber: existingPullRequest?.number,
 				title: prTitle,
 				body: prBody,
 				head: releaseBranch,
-				base: defaultBranch,
-				githubToken
+				base: defaultBranch
 			});
 			logger.success(`${doesReleasePRExist ? "Updated" : "Created"} pull request: ${pullRequest?.html_url}`);
 			return {
@@ -1263,4 +1592,8 @@ async function orchestrateReleasePullRequest({ workspaceRoot, owner, repo, githu
 }
 
 //#endregion
-export { publish, release };
+//#region src/verify.ts
+function verify(_options) {}
+
+//#endregion
+export { publish, release, verify };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ucdjs/release-scripts",
-  "version": "0.1.0-beta.15",
+  "version": "0.1.0-beta.17",
   "description": "@ucdjs release scripts",
   "type": "module",
   "license": "MIT",
@@ -13,7 +13,8 @@
     "#versioning/*": "./src/versioning/*.ts",
     "#shared/*": "./src/shared/*.ts",
     "#release": "./src/release.ts",
-    "#publish": "./src/publish.ts"
+    "#publish": "./src/publish.ts",
+    "#verify": "./src/verify.ts"
   },
   "exports": {
     ".": "./dist/index.mjs",
@@ -27,7 +28,7 @@
   ],
   "dependencies": {
     "@luxass/utils": "2.7.2",
-    "commit-parser": "1.0.0",
+    "commit-parser": "1.3.0",
     "farver": "1.0.0-beta.1",
     "mri": "1.2.0",
     "prompts": "2.4.2",
@@ -41,7 +42,8 @@
     "eta": "4.0.1",
     "tsdown": "0.16.0",
     "typescript": "5.9.3",
-    "vitest": "4.0.4"
+    "vitest": "4.0.4",
+    "vitest-testdirs": "4.3.0"
   },
   "scripts": {
     "build": "tsdown",