tegami 1.2.2 → 1.2.4

package/dist/{types-C_vz41r2.d.ts → types-BMYzG4dR.d.ts}

@@ -1,5 +1,3 @@
-import { Agent, AgentName } from "package-manager-detector";
-
 //#region src/utils/semver.d.ts
 type BumpType = "major" | "minor" | "patch";
 //#endregion
@@ -183,7 +181,7 @@ interface PackageDraft {
     /** npm dist-tag used when publishing. */distTag?: string;
   };
   /** get the bumped version of a package, return `undefined` if the package doesn't have a `version` field */
-  bumpVersion: (pkg: WorkspacePackage) => string | undefined;
+  bumpVersion: (pkg: WorkspacePackage$1) => string | undefined;
 }
 /** a draft describes all operations to perform before the actual publishing, such as version bumps. */
 declare class Draft {
@@ -197,15 +195,15 @@ declare class Draft {
   constructor(context: TegamiContext);
   getPackageDrafts(): Map<string, PackageDraft>;
   getPackageDraft(id: string): PackageDraft | undefined;
-  bumpPackage(pkg: WorkspacePackage, {
+  bumpPackage(pkg: WorkspacePackage$1, {
     type,
     reason
   }: {
     type: BumpType;
     reason?: string;
   }): PackageDraft;
-  dispatchPackage(pkg: WorkspacePackage, dispatch: (draft: PackageDraft) => void, onUpdate?: (draft: PackageDraft) => void): PackageDraft;
-  getOrInitPackage(pkg: WorkspacePackage): PackageDraft;
+  dispatchPackage(pkg: WorkspacePackage$1, dispatch: (draft: PackageDraft) => void, onUpdate?: (draft: PackageDraft) => void): PackageDraft;
+  getOrInitPackage(pkg: WorkspacePackage$1): PackageDraft;
   hasPending(): boolean;
   /** get all changelogs, note that this includes replay-only changelogs, as long as they are in the `.tegami` folder. */
   getChangelogs(): ChangelogEntry[];
@@ -229,13 +227,13 @@ interface DraftPolicy {
   id: string;
   onUpdate?: (this: Draft, opts: {
     packageDraft: PackageDraft;
-    pkg: WorkspacePackage;
+    pkg: WorkspacePackage$1;
   }) => void;
 }
 //#endregion
 //#region src/graph.d.ts
 /** Package discovered in the workspace. */
-declare abstract class WorkspacePackage {
+declare abstract class WorkspacePackage$1 {
   abstract readonly name: string;
   /** absolute path */
   abstract readonly path: string;
@@ -258,7 +256,7 @@ declare abstract class WorkspacePackage {
 interface PackageGroup {
   name: string;
   options: GroupOptions;
-  packages: WorkspacePackage[];
+  packages: WorkspacePackage$1[];
 }
 /**
  * Unified graph for discovered workspace packages.
@@ -269,14 +267,14 @@ interface PackageGroup {
 declare class PackageGraph {
   private readonly packages;
   private readonly groups;
-  constructor(packages?: WorkspacePackage[]);
-  getPackages(): WorkspacePackage[];
+  constructor(packages?: WorkspacePackage$1[]);
+  getPackages(): WorkspacePackage$1[];
   /** Get a package by exact id. */
-  get(id: string): WorkspacePackage | undefined;
+  get(id: string): WorkspacePackage$1 | undefined;
   /** Get packages by id, `group:name`, or every package matching a name. */
-  getByName(nameOrId: string): WorkspacePackage[];
+  getByName(nameOrId: string): WorkspacePackage$1[];
   /** scan package into graph, if the package id already exists, replace the existing one in graph */
-  add(pkg: WorkspacePackage): void;
+  add(pkg: WorkspacePackage$1): void;
   delete(id: string): void;
   getPackageGroup(pkgId: string): PackageGroup | undefined;
   getGroups(): PackageGroup[];
@@ -287,6 +285,10 @@ declare class PackageGraph {
   unregisterGroup(name: string): void;
 }
 //#endregion
+//#region ../../node_modules/.pnpm/package-manager-detector@1.7.0/node_modules/package-manager-detector/dist/shared/package-manager-detector.CqsrLAro.d.mts
+type Agent = 'npm' | 'yarn' | 'yarn@berry' | 'pnpm' | 'pnpm@6' | 'bun' | 'deno' | 'nub' | 'aube';
+type AgentName = 'npm' | 'yarn' | 'pnpm' | 'bun' | 'deno' | 'nub' | 'aube';
+//#endregion
 //#region src/plugins/gitlab/api.d.ts
 interface GitLabToken {
   value: string;
@@ -360,9 +362,11 @@ declare class CargoToml<Data extends CargoManifest = CargoManifest> {
   data: Data;
   private dependencies;
   workspace?: CargoToml<RequireFields<CargoManifest, "workspace">>;
+  private readonly originalContent;
   constructor(path: string, content: string, data: Data);
   listDependencies(graph: CargoGraph): ResolvedDependency[];
   patch(path: string, value: unknown): void;
+  write(): Promise<void>;
 }
 interface ResolvedDependency {
   path: [...string[], kind: DepKind, key: string];
@@ -371,7 +375,7 @@ interface ResolvedDependency {
   range?: string;
   setRange?: (v: string) => void;
 }
-declare class CargoPackage extends WorkspacePackage {
+declare class CargoPackage extends WorkspacePackage$1 {
   readonly path: string;
   /** a crate must have `package` field defined, otherwise it is merely a virutal workspace file, and Tegami should not include it. */
   readonly file: CargoToml<RequireFields<CargoManifest, "package">>;
@@ -415,7 +419,7 @@ interface CargoGraph {
 }
 //#endregion
 //#region src/providers/npm/graph.d.ts
-declare class NpmPackage extends WorkspacePackage {
+declare class NpmPackage extends WorkspacePackage$1 {
   readonly path: string;
   readonly manifest: PackageManifest;
   readonly manager = "npm";
@@ -634,6 +638,7 @@ interface GenerateChangelogOptions extends GenerateFromCommitsOptions {
    */
   write?: boolean;
 }
+declare const WorkspacePackage: typeof WorkspacePackage$1;
 interface Tegami {
   /** Create pending changelog files from git commit history. */
   generateChangelog(options?: GenerateChangelogOptions): Promise<CommitChangelog[]>;
@@ -642,11 +647,22 @@ interface Tegami {
   /** Publish packages from the publish lock. */
   publish(options?: PublishOptions): Promise<PublishPlan | "skipped">;
   /**
-   * Check publish status.
-   *
-   * Prefer `publish()` over this if you are publishing packages, it will also check the publish status.
+   * @deprecated use `getPublishStatus()` instead
    */
   publishStatus(options?: PublishOptions): Promise<"pending" | "success" | "idle">;
+  /**
+   * Check publish plan status.
+   *
+   * Prefer `publish()` over this if you are publishing packages, this is check-only and can lead to TOCTOU race.
+   */
+  getPublishStatus(options?: PublishOptions): Promise<{
+    /**
+     * - `pending`: has pending tasks.
+     * - `success`: all tasks finished.
+     * - `none`: there is no existing publish plans. */
+    status: "pending" | "success" | "none";
+    reason?: string;
+  }>;
   /** Remove the publish lock file after publishing has finished successfully. */
   cleanup(options?: PublishOptions): Promise<{
     state: "removed";
@@ -747,7 +763,7 @@ declare function npm({
 /** Generates changelog content for a package release. */
 interface LogGenerator {
   generate(this: TegamiContext, opts: {
-    pkg: WorkspacePackage;
+    pkg: WorkspacePackage$1;
     packageDraft: PackageDraft;
     draft: Draft;
   }): string | Promise<string>;
@@ -762,7 +778,7 @@ interface TegamiOptions<Groups extends string = string> {
   /** Changelog generator used when applying a draft. */
   generator?: LogGenerator;
   /** Per-package options keyed by package name or a function. */
-  packages?: Record<string, PackageOptions<NoInfer<Groups>>> | ((pkg: WorkspacePackage) => PackageOptions<NoInfer<Groups>> | undefined);
+  packages?: Record<string, PackageOptions<NoInfer<Groups>>> | ((pkg: WorkspacePackage$1) => PackageOptions<NoInfer<Groups>> | undefined);
   plugins?: TegamiPluginOption[];
   groups?: Record<Groups, GroupOptions>;
   /** Package names, ids, or regex patterns to exclude from the dependency graph. */
@@ -841,7 +857,7 @@ interface TegamiPlugin {
    * If multiple plugins return preflight data for the same package, only the first plugin will be considered.
    */
   publishPreflight?(this: TegamiContext, opts: {
-    pkg: WorkspacePackage;
+    pkg: WorkspacePackage$1;
     plan: PublishPlan;
   }): Awaitable<PublishPreflight | void | undefined>;
   /** Called when all preflights finished */
@@ -850,7 +866,7 @@ interface TegamiPlugin {
   }): Awaitable<void>;
   /** Publish package, return a result object indicating if the package is published, skipped, or failed. Return `undefined` if the package is not handled by this plugin. */
   publish?(this: TegamiContext, opts: {
-    pkg: WorkspacePackage;
+    pkg: WorkspacePackage$1;
     plan: PublishPlan;
   }): Promise<PackagePublishResult | undefined | void>;
   /**
@@ -867,11 +883,11 @@ interface TegamiPlugin {
   }): Awaitable<void>;
   /** Called before a package will be published, return `false` to prevent from publishing. */
   willPublish?(this: TegamiContext, opts: {
-    pkg: WorkspacePackage;
+    pkg: WorkspacePackage$1;
   }): Awaitable<false | void | undefined>;
   /** Called after a package is published successfully, or failed. */
   afterPublish?(this: TegamiContext, opts: {
-    pkg: WorkspacePackage;
+    pkg: WorkspacePackage$1;
     plan: PublishPlan;
   }): Awaitable<void>;
   /** Called after all publishing finishes. */
@@ -906,4 +922,4 @@ interface PublishPreflight {
   optionalWait?: string[];
 }
 //#endregion
-export { WorkspacePackage as A, NpmPackage as C, cargo as D, CargoPluginOptions as E, DraftPolicy as M, PackageDraft as N, PackageGraph as O, BumpType as P, NpmGraph as S, CargoPackage as T, PublishOptions as _, PublishPreflight as a, TegamiContext as b, TegamiPluginOption as c, GenerateChangelogOptions as d, Tegami as f, PackagePublishResult as g, PackagePublishPlan as h, PackageOptions as i, Draft as j, PackageGroup as k, NpmPluginOptions as l, PublishLock as m, GroupOptions as n, TegamiOptions as o, tegami as p, LogGenerator as r, TegamiPlugin as s, Awaitable as t, npm as u, PublishPlan as v, CargoGraph as w, DependencySpec as x, CommitChangelog as y };
+export { type PackageGroup as A, type NpmGraph as C, type CargoPluginOptions as D, CargoPackage as E, BumpType as F, Draft as M, DraftPolicy as N, cargo as O, PackageDraft as P, DependencySpec as S, CargoGraph as T, PackagePublishResult as _, type PublishPreflight as a, type CommitChangelog as b, type TegamiPluginOption as c, type GenerateChangelogOptions as d, Tegami as f, PackagePublishPlan as g, PublishLock as h, PackageOptions as i, WorkspacePackage$1 as j, PackageGraph as k, NpmPluginOptions as l, tegami as m, GroupOptions as n, TegamiOptions as o, WorkspacePackage as p, LogGenerator as r, TegamiPlugin as s, Awaitable as t, npm as u, PublishOptions as v, NpmPackage as w, TegamiContext as x, PublishPlan as y };

package/dist/{version-request-DXk_B7O_.d.ts → version-request-BorZZ98V.d.ts}

@@ -1,4 +1,4 @@
-import { b as TegamiContext, j as Draft, m as PublishLock, t as Awaitable, v as PublishPlan } from "./types-C_vz41r2.js";
+import { M as Draft, h as PublishLock, t as Awaitable, x as TegamiContext, y as PublishPlan } from "./types-BMYzG4dR.js";
 
 //#region src/utils/version-request.d.ts
 interface VersionRequestOptions {

package/dist/{version-request-DvWVAYj2.js → version-request-CQ4cJHtP.js}

@@ -1,8 +1,9 @@
-import { r as formatNpmDistTag } from "./semver-EKJ8yK5U.js";
-import { n as execFailure, s as isCI } from "./error-CAsrGb6e.js";
-import { t as _accessExpressionAsString } from "./_accessExpressionAsString-QhbUZzwv.js";
-import { n as _validateReport, t as _createStandardSchema } from "./_createStandardSchema-BGQyz-uA.js";
-import { o as PublishLock, r as runPreflights, s as parsePublishLock, t as initPublishPlan } from "./publish-Bt3e1RPs.js";
+import { a as formatPackageVersion, i as formatNpmDistTag, r as diffWeight } from "./semver-DrtaCCZK.js";
+import { l as somePromise, n as execFailure, s as isCI } from "./error-CAsrGb6e.js";
+import { t as _accessExpressionAsString } from "./_accessExpressionAsString-DW_6Xqcp.js";
+import { n as _validateReport, t as _createStandardSchema } from "./_createStandardSchema-CrRqJgaE.js";
+import { t as getPackageBumps } from "./shared-pTOZU5UZ.js";
+import { o as PublishLock, r as runPreflights, s as parsePublishLock, t as initPublishPlan } from "./publish-DAMkayLs.js";
 import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import { join, relative } from "node:path";
 import { x } from "tinyexec";
@@ -65,8 +66,8 @@ const validatePublishGroupStore = (() => {
 		};
 	});
 })();
-function onVersionRequest(provider) {
-	const namespace = `${provider.name}:publish-group`;
+function versionRequestPlugin(provider) {
+	const NamespacePublishGroup = `${provider.name}:publish-group`;
 	/** package id -> version before applying the CLI draft */
 	const snapshots = /* @__PURE__ */ new Map();
 	function resolveConfig(graph) {
@@ -93,6 +94,19 @@ function onVersionRequest(provider) {
 			...rest
 		};
 	}
+	/** commit the working tree changes onto a detached HEAD */
+	async function createVersionCommit(ctx, config) {
+		const { title = "Version Packages", body } = await config.commit?.call(ctx, { type: "version-packages" }) ?? {};
+		await run(ctx.cwd, ["checkout", "--detach"], "Failed to detach HEAD for version branches.");
+		await run(ctx.cwd, ["add", "-A"], "Failed to stage version changes.");
+		const args = [
+			"commit",
+			"-m",
+			title
+		];
+		if (body) args.push("-m", body);
+		await run(ctx.cwd, args, "Failed to commit version changes.");
+	}
 	/**
 	* Commit the group's lock state on top of `parent` and force-push its branch.
 	*
@@ -100,8 +114,8 @@ function onVersionRequest(provider) {
 	*/
 	async function syncGroupBranch(context, opts) {
 		const lock = new PublishLock(opts.baseLock);
-		while (lock.read(namespace));
-		lock.write(namespace, opts.store);
+		while (lock.read(NamespacePublishGroup));
+		lock.write(NamespacePublishGroup, opts.store);
 		const commit = await createLockCommit(context, opts.parent, lock.serialize(), await opts.config.commit?.call(context, {
 			type: "update-lock",
 			store: opts.store,
@@ -117,15 +131,16 @@ function onVersionRequest(provider) {
 		return false;
 	}
 	return {
-		/** snapshot package versions, hook into `initCliDraft` */
+		name: `${provider.name}:version-request`,
+		/** snapshot package versions */
 		initCliDraft() {
 			for (const pkg of this.graph.getPackages()) snapshots.set(pkg.id, pkg.version);
 		},
-		/** commit & push version branches, then upsert their requests, hook into `applyCliDraft` */
+		/** commit & push version branches, then upsert their requests */
 		async applyCliDraft(draft) {
+			if (!provider.canCreate(this)) return;
 			const config = resolveConfig(this.graph);
-			if (!config || !provider.canCreate(this)) return;
-			if (!(config.forceCreate || isCI()) || !await hasGitChanges(this.cwd)) return;
+			if (!config || !(config.forceCreate || isCI()) || !await hasGitChanges(this.cwd)) return;
 			const requests = [];
 			const updatedPackages = /* @__PURE__ */ new Map();
 			for (const id of draft.getPackageDrafts().keys()) {
@@ -151,7 +166,7 @@ function onVersionRequest(provider) {
 				packages: Array.from(updatedPackages.values())
 			});
 			if (requests.length === 0) return;
-			await createVersionCommit(this.cwd, await config.commit?.call(this, { type: "version-packages" }));
+			await createVersionCommit(this, config);
 			let baseLock;
 			let parent;
 			const tasks = [];
@@ -164,10 +179,15 @@ function onVersionRequest(provider) {
 					getPreviousVersion: (id) => snapshots.get(id)
 				};
 				const custom = await config.create?.call(this, ctx);
-				const title = custom?.title ?? (publishGroup ? `Release ${packages.map((pkg) => `${pkg.name} (${pkg.manager})`).join(", ")}` : "Version Packages");
+				const resolved = {
+					title: custom?.title ?? (publishGroup ? `Release ${packages.map((pkg) => `${pkg.name} (${pkg.manager})`).join(", ")}` : "Version Packages"),
+					body: custom?.body ?? renderRequestBody(this, ctx),
+					head: branch,
+					base: config.base
+				};
 				if (publishGroup) {
 					parent ??= await resolveHead(this.cwd);
-					baseLock ??= await parsePublishLock(await readFile(this.lockPath, "utf8"));
+					baseLock ??= parsePublishLock(await readFile(this.lockPath, "utf8"));
 					const newGroups = {};
 					for (const req of requests) {
 						if (!req.publishGroup) continue;
@@ -180,32 +200,33 @@ function onVersionRequest(provider) {
 						parent,
 						store: { groups: newGroups }
 					});
-					tasks.push(provider.upsert(this, {
-						title,
-						body: custom?.body ?? renderRequestBody(this, ctx),
-						head: branch,
-						base: config.base
-					}, !inSync));
+					tasks.push(provider.upsert(this, resolved, !inSync));
 					continue;
 				}
-				await pushBranch(this.cwd, branch);
-				await provider.upsert(this, {
-					title,
-					body: custom?.body ?? renderRequestBody(this, ctx),
-					head: branch,
-					base: config.base
-				}, true);
+				await run(this.cwd, [
+					"checkout",
+					"-B",
+					branch
+				], "Failed to create the version branch.");
+				await run(this.cwd, [
+					"push",
+					"--force",
+					"-u",
+					"origin",
+					branch
+				], "Failed to push the version branch to origin. Ensure `origin` is configured and you have push access.");
+				await provider.upsert(this, resolved, true);
 			}
 			await Promise.all(tasks);
 		},
-		/** restore publish groups from the lock into the plan, hook into `initPublishPlan` */
+		/** restore publish groups from the lock into the plan */
 		initPublishPlan({ lock, plan }) {
 			const config = resolveConfig(this.graph);
 			if (!config) return;
 			let data;
 			const publishGroups = /* @__PURE__ */ new Map();
 			plan.$versionRequest = { publishGroups };
-			while (data = lock.read(namespace)) {
+			while (data = lock.read(NamespacePublishGroup)) {
 				const validated = validatePublishGroupStore(data);
 				if (!validated.success) continue;
 				const store = validated.data;
@@ -232,7 +253,7 @@ function onVersionRequest(provider) {
 			if (!publishGroups) return;
 			for (const s of publishGroups.values()) if (s === "pending") return "pending";
 		},
-		/** re-sync the version requests of pending publish groups, hook into `beforePublishAll` */
+		/** re-sync the version requests of pending publish groups */
 		async beforePublishAll({ plan }) {
 			if (plan.options.dryRun || !provider.canCreate(this)) return;
 			const config = resolveConfig(this.graph);
@@ -261,7 +282,7 @@ function onVersionRequest(provider) {
 	};
 }
 function renderRequestBody(ctx, { draft, getPreviousVersion, plan }) {
-	const packageLines = [];
+	const bumpedPackages = [];
 	const changelogLines = [];
 	const publishLines = [];
 	const changesets = /* @__PURE__ */ new Map();
@@ -274,19 +295,31 @@ function renderRequestBody(ctx, { draft, getPreviousVersion, plan }) {
 			else changesets.set(changelog, [pkg]);
 		}
 		const from = getPreviousVersion(id);
-		if (!from || from === pkg.version) continue;
-		packageLines.push(`| \`${pkg.name}\` | \`${from}\` | \`${pkg.version}\`${formatNpmDistTag(packageDraft.npm?.distTag)} |`);
+		if (!from || !pkg.version || from === pkg.version) continue;
+		bumpedPackages.push({
+			name: pkg.name,
+			from,
+			to: pkg.version,
+			diff: diffWeight(from, pkg.version)
+		});
 	}
+	const packageLines = bumpedPackages.sort((a, b) => b.diff - a.diff).map(({ name, from, to }) => `| \`${name}\` | \`${from}\` | \`${to}\` |`);
 	for (const [entry, linkedPackages] of changesets) {
-		changelogLines.push(`### ${entry.subject ?? `\`${entry.filename}\``}`, "");
-		changelogLines.push("<details>", `<summary>Show Bumped Packages (${linkedPackages.length})</summary>`, "", ...linkedPackages.map((pkg) => `- \`${pkg.id}\``), "", "</details>", "");
+		const bumps = getPackageBumps(ctx.graph, entry);
+		changelogLines.push(`### ${entry.subject ?? `\`${entry.filename}\``}`, "", "<details>", `<summary>Show Bumped Packages (${linkedPackages.length})</summary>`, "", "| Package | Bump |", "| --- | --- |");
+		for (const pkg of linkedPackages) changelogLines.push(`| \`${pkg.id}\` | ${bumps.get(pkg) ?? ""} |`);
+		changelogLines.push("", "</details>", "");
 		for (const section of entry.sections) {
 			changelogLines.push(`#### ${section.title}`, "");
 			if (section.content) changelogLines.push(section.content);
 		}
 	}
-	if (plan) {
-		for (const [id, { preflight }] of plan.packages) if (preflight.shouldPublish) publishLines.push(`- ${id}`);
+	if (plan) for (const [id, { preflight, npm }] of plan.packages) {
+		if (!preflight.shouldPublish) continue;
+		const pkg = ctx.graph.get(id);
+		let pm = "";
+		if (npm?.distTag) pm += ` (dist-tag: ${npm.distTag})`;
+		publishLines.push(`| \`${pkg.name}\` | \`${pkg.version}\`${pm} | \`${pkg.manager}\` |`);
 	}
 	const sections = [
 		"## Summary",
@@ -296,7 +329,7 @@ function renderRequestBody(ctx, { draft, getPreviousVersion, plan }) {
 	];
 	if (packageLines.length > 0) sections.push("| Package | From | To |", "| --- | --- | --- |", ...packageLines);
 	if (changelogLines.length > 0) sections.push("", "## Changelogs", ...changelogLines);
-	if (publishLines.length > 0) sections.push("", "## Publish", "", "The following packages will be published if merged:", ...publishLines);
+	if (publishLines.length > 0) sections.push("", "## Publish", "", "The following packages will be published if merged:", "", "| Package | Version | Registry |", "| --- | --- | --- |", ...publishLines);
 	sections.push("");
 	return sections.join("\n");
 }
@@ -380,32 +413,6 @@ async function resolveRemoteBranches(cwd, branches) {
 async function hasGitChanges(cwd) {
 	return (await run(cwd, ["status", "--porcelain"], "Failed to check git status.")).length > 0;
 }
-/** commit the working tree changes onto a detached HEAD */
-async function createVersionCommit(cwd, { title = "Version Packages", body } = {}) {
-	await run(cwd, ["checkout", "--detach"], "Failed to detach HEAD for version branches.");
-	await run(cwd, ["add", "-A"], "Failed to stage version changes.");
-	const args = [
-		"commit",
-		"-m",
-		title
-	];
-	if (body) args.push("-m", body);
-	await run(cwd, args, "Failed to commit version changes.");
-}
-async function pushBranch(cwd, branch) {
-	await run(cwd, [
-		"checkout",
-		"-B",
-		branch
-	], "Failed to create the version branch.");
-	await run(cwd, [
-		"push",
-		"--force",
-		"-u",
-		"origin",
-		branch
-	], "Failed to push the version branch to origin. Ensure `origin` is configured and you have push access.");
-}
 async function run(cwd, args, message, env) {
 	const result = await x("git", args, { nodeOptions: {
 		cwd,
@@ -423,5 +430,134 @@ function publishGroupId(members) {
 	if (slugs.length === 0) slugs.push("group");
 	return slugs.join("-");
 }
+function formatPreview({ graph, npm }, draft, newChangelogNames, labels) {
+	const pendingPackages = [];
+	const lines = [
+		"### Tegami",
+		"",
+		`This repository uses [Tegami](https://tegami.fuma-nama.dev) to manage releases. When your changes affect published packages, add a changelog file under \`.tegami/\` before merging.`,
+		"",
+		`[**Create a changelog →**](${labels["create-a-changelog-href"]}) · [Changelog format](https://tegami.fuma-nama.dev/changelog)`,
+		""
+	];
+	for (const pkg of graph.getPackages()) {
+		const plan = draft.getPackageDraft(pkg.id);
+		if (!plan) continue;
+		const bumped = plan.bumpVersion(pkg);
+		if (!bumped || !pkg.version || bumped === pkg.version) continue;
+		pendingPackages.push({
+			name: pkg.name,
+			type: plan.type ?? "—",
+			from: pkg.version,
+			to: bumped,
+			distTag: plan.npm?.distTag
+		});
+	}
+	if (pendingPackages.length > 0) {
+		lines.push("#### Release preview", "", "| Package | Bump | Version |", "| --- | --- | --- |");
+		for (const { name, type, from, to, distTag } of pendingPackages.sort((a, b) => diffWeight(b.from, b.to) - diffWeight(a.from, a.to))) lines.push(`| \`${name}\` | ${type} | \`${from}\` → \`${to}\`${formatNpmDistTag(distTag)} |`);
+		lines.push("");
+	}
+	const newChangelogs = draft.getChangelogs().filter((entry) => newChangelogNames.has(entry.filename));
+	if (newChangelogs.length > 0) {
+		lines.push(`#### Changelogs in this ${labels.pr}`, "", "| Changelog | Title |", "| --- | --- |");
+		for (const entry of newChangelogs) for (const section of entry.sections) lines.push(`| \`${entry.filename}\` | ${section.title} |`);
+		lines.push("");
+	} else if (pendingPackages.length === 0) lines.push("#### No changelogs yet", "", `This ${labels.pr} has no pending changelog files. If your changes require a release, add a changelog before merging.`, "");
+	else if (newChangelogNames.size === 0) lines.push(`This ${labels.pr} does not add changelog files. Pending changelogs from other branches are included in the preview above.`, "");
+	lines.push(`Run \`${npm?.client ?? "npm"} run tegami\` locally to create a changelog interactively.`, "", `<sub>Managed by [Tegami](https://tegami.fuma-nama.dev).</sub>`, "");
+	return lines.join("\n");
+}
+async function resolveFileCommit(ctx, filename) {
+	const result = await x("git", [
+		"log",
+		"--diff-filter=A",
+		"-1",
+		"--format=%H",
+		"--",
+		relative(ctx.cwd, join(ctx.changelogDir, filename))
+	], { nodeOptions: { cwd: ctx.cwd } });
+	if (result.exitCode !== 0) return;
+	return result.stdout.trim() || void 0;
+}
+function createAutoRelease({ eager, create, override, overrideGroup, releaseExistsByTag, formatChangelog }) {
+	async function defaultNotes(ctx, pkg, packagePlan) {
+		if (packagePlan && packagePlan.changelogs.length > 0) return (await Promise.all(packagePlan.changelogs.map(formatChangelog.bind(ctx)))).join("\n\n");
+		return `Published ${formatPackageVersion(pkg.name, pkg.version, packagePlan?.npm?.distTag)}.`;
+	}
+	async function defaultGroupedNotes(ctx, plan, packages) {
+		const changelogs = /* @__PURE__ */ new Map();
+		for (const pkg of packages) {
+			const packagePlan = plan.packages.get(pkg.id);
+			if (!packagePlan) continue;
+			for (const entry of packagePlan.changelogs) changelogs.set(entry.id, entry);
+		}
+		const sections = [packages.map((pkg) => {
+			const packagePlan = plan.packages.get(pkg.id);
+			return `- ${formatPackageVersion(pkg.name, pkg.version, packagePlan?.npm?.distTag)}`;
+		}).join("\n")];
+		if (changelogs.size > 0) {
+			const notes = await Promise.all(Array.from(changelogs.values(), formatChangelog.bind(ctx)));
+			sections.push("", notes.join("\n\n"));
+		}
+		return sections.join("\n");
+	}
+	return {
+		async hasPending(plan) {
+			const requiredTags = /* @__PURE__ */ new Set();
+			for (const pkg of plan.packages.values()) if (pkg.preflight.shouldPublish && pkg.git?.tag) requiredTags.add(pkg.git.tag);
+			return somePromise(Array.from(requiredTags, (tag) => releaseExistsByTag.call(this, tag)), (exists) => !exists);
+		},
+		async create(plan) {
+			const groups = /* @__PURE__ */ new Map();
+			for (const [id, { preflight, publishResult, git }] of plan.packages) {
+				if (!eager && publishResult.type === "failed") return;
+				const tag = git?.tag;
+				if (!tag || !preflight.shouldPublish) continue;
+				const pkg = this.graph.get(id);
+				const group = groups.get(tag);
+				if (group) group.push(pkg);
+				else groups.set(tag, [pkg]);
+			}
+			await Promise.all(Array.from(groups, async ([tag, packages]) => {
+				for (const member of packages) if (plan.packages.get(member.id).publishResult.type === "failed") return;
+				if (await releaseExistsByTag.call(this, tag)) return;
+				if (packages.length > 1) {
+					const { title = tag, notes = await defaultGroupedNotes(this, plan, packages), ...rest } = await overrideGroup?.call(this, {
+						tag,
+						packages,
+						plan
+					}) ?? {};
+					await create({
+						input: {
+							title,
+							notes,
+							...rest
+						},
+						tag,
+						packages
+					});
+					return;
+				}
+				const pkg = packages[0];
+				const packagePlan = plan.packages.get(pkg.id);
+				const { title = formatPackageVersion(pkg.name, pkg.version, packagePlan?.npm?.distTag), notes = await defaultNotes(this, pkg, packagePlan), ...rest } = await override?.call(this, {
+					tag,
+					pkg,
+					plan
+				}) ?? {};
+				await create({
+					input: {
+						title,
+						notes,
+						...rest
+					},
+					tag,
+					packages
+				});
+			}));
+		}
+	};
+}
 //#endregion
-export { onVersionRequest as t };
+export { versionRequestPlugin as i, formatPreview as n, resolveFileCommit as r, createAutoRelease as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tegami",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "A tool to manage changelogs, versioning, and publishing in monorepo",
   "license": "MIT",
   "author": "Fuma Nama",
@@ -29,17 +29,17 @@
     "access": "public"
   },
   "dependencies": {
-    "@clack/prompts": "^1.6.0",
+    "@clack/prompts": "^1.7.0",
     "@rainbowatcher/toml-edit-js": "^0.6.5",
-    "package-manager-detector": "^1.6.0",
     "semver": "^7.8.5",
     "tinyexec": "^1.2.4",
     "tinyglobby": "^0.2.17",
     "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "@types/node": "^26.0.1",
+    "@types/node": "^26.1.0",
     "@types/semver": "^7.7.1",
+    "package-manager-detector": "^1.7.0",
     "tsdown": "^0.22.3",
     "typescript": "6.0.3",
     "typia": "^12.1.1",
@@ -47,6 +47,7 @@
   },
   "inlinedDependencies": {
     "@typia/interface": "12.1.1",
+    "package-manager-detector": "1.7.0",
     "typia": "12.1.1"
   },
   "scripts": {