tegami 1.2.3 → 1.2.5

package/dist/{types-Kj7Nxbjz.d.ts → types-Cn0Au3Kk.d.ts}

@@ -44,7 +44,7 @@ declare namespace TagBase {
    * @template Exclusive Whether this tag conflicts with others
    * @template Schema Additional JSON Schema properties to output
    */
-  interface IProps<Target extends "boolean" | "bigint" | "number" | "string" | "array" | "object", Kind extends string, Value extends boolean | bigint | number | string | undefined, Validate extends string | { [key in Target]?: string }, Exclusive extends boolean | string[], Schema extends object | undefined> {
+  interface IProps<Target extends "boolean" | "bigint" | "number" | "string" | "array" | "object", Kind extends string, Value extends boolean | bigint | number | string | undefined, Validate extends string | { [key in Target]?: string; }, Exclusive extends boolean | string[], Schema extends object | undefined> {
     /**
      * Target primitive type(s) this tag applies to.
      *
@@ -170,6 +170,17 @@ interface ChangelogEntry {
   virtual?: boolean;
   getRawContent: () => string;
 }
+type ReplayCondition = {
+  on: "version";
+  name: string;
+  version: string;
+} | {
+  on: "exit-prerelease";
+  name: string;
+} | {
+  on: "enter-prerelease";
+  name: string;
+};
 //#endregion
 //#region src/plans/draft.d.ts
 interface PackageDraft {
@@ -178,10 +189,11 @@ interface PackageDraft {
   bumpReasons?: Set<string>;
   changelogs?: ChangelogEntry[];
   npm?: {
-    /** npm dist-tag used when publishing. */distTag?: string;
+    /** 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$1) => string | undefined;
+  bumpVersion: (pkg: WorkspacePackage) => string | undefined;
 }
 /** a draft describes all operations to perform before the actual publishing, such as version bumps. */
 declare class Draft {
@@ -195,15 +207,12 @@ declare class Draft {
   constructor(context: TegamiContext);
   getPackageDrafts(): Map<string, PackageDraft>;
   getPackageDraft(id: string): PackageDraft | undefined;
-  bumpPackage(pkg: WorkspacePackage$1, {
-    type,
-    reason
-  }: {
+  bumpPackage(pkg: WorkspacePackage, { type, reason }: {
     type: BumpType;
     reason?: string;
   }): PackageDraft;
-  dispatchPackage(pkg: WorkspacePackage$1, dispatch: (draft: PackageDraft) => void, onUpdate?: (draft: PackageDraft) => void): PackageDraft;
-  getOrInitPackage(pkg: WorkspacePackage$1): PackageDraft;
+  dispatchPackage(pkg: WorkspacePackage, dispatch: (draft: PackageDraft) => void, onUpdate?: (draft: PackageDraft) => void): PackageDraft;
+  getOrInitPackage(pkg: WorkspacePackage): PackageDraft;
   hasPending(): boolean;
   /** get all changelogs, note that this includes replay-only changelogs, as long as they are in the `.tegami` folder. */
   getChangelogs(): ChangelogEntry[];
@@ -227,13 +236,13 @@ interface DraftPolicy {
   id: string;
   onUpdate?: (this: Draft, opts: {
     packageDraft: PackageDraft;
-    pkg: WorkspacePackage$1;
+    pkg: WorkspacePackage;
   }) => void;
 }
 //#endregion
 //#region src/graph.d.ts
 /** Package discovered in the workspace. */
-declare abstract class WorkspacePackage$1 {
+declare abstract class WorkspacePackage {
   abstract readonly name: string;
   /** absolute path */
   abstract readonly path: string;
@@ -247,16 +256,14 @@ declare abstract class WorkspacePackage$1 {
   /** create the initial draft. */
   initDraft(): PackageDraft;
   /** configure an initial draft to match script-level configs. */
-  configureDraft({
-    draft
-  }: {
+  configureDraft({ draft }: {
     draft: PackageDraft;
   }): void;
 }
 interface PackageGroup {
   name: string;
   options: GroupOptions;
-  packages: WorkspacePackage$1[];
+  packages: WorkspacePackage[];
 }
 /**
  * Unified graph for discovered workspace packages.
@@ -267,14 +274,14 @@ interface PackageGroup {
 declare class PackageGraph {
   private readonly packages;
   private readonly groups;
-  constructor(packages?: WorkspacePackage$1[]);
-  getPackages(): WorkspacePackage$1[];
+  constructor(packages?: WorkspacePackage[]);
+  getPackages(): WorkspacePackage[];
   /** Get a package by exact id. */
-  get(id: string): WorkspacePackage$1 | undefined;
+  get(id: string): WorkspacePackage | undefined;
   /** Get packages by id, `group:name`, or every package matching a name. */
-  getByName(nameOrId: string): WorkspacePackage$1[];
+  getByName(nameOrId: string): WorkspacePackage[];
   /** scan package into graph, if the package id already exists, replace the existing one in graph */
-  add(pkg: WorkspacePackage$1): void;
+  add(pkg: WorkspacePackage): void;
   delete(id: string): void;
   getPackageGroup(pkgId: string): PackageGroup | undefined;
   getGroups(): PackageGroup[];
@@ -362,9 +369,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];
@@ -373,14 +382,14 @@ interface ResolvedDependency {
   range?: string;
   setRange?: (v: string) => void;
 }
-declare class CargoPackage extends WorkspacePackage$1 {
+declare class CargoPackage extends WorkspacePackage {
   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">>;
   readonly manager = "cargo";
   readonly manifest: RequireFields<CargoManifest, "package">;
-  constructor(path: string, /** a crate must have `package` field defined, otherwise it is merely a virutal workspace file, and Tegami should not include it. */
-
+  constructor(path: string,
+  /** a crate must have `package` field defined, otherwise it is merely a virutal workspace file, and Tegami should not include it. */
   file: CargoToml<RequireFields<CargoManifest, "package">>);
   get name(): string;
   get version(): string;
@@ -405,10 +414,7 @@ interface CargoPluginOptions {
    */
   bumpDep?: (opts: DependentRef$1) => BumpType | false;
 }
-declare function cargo({
-  updateLockFile,
-  bumpDep: getBumpDepType
-}?: CargoPluginOptions): TegamiPlugin;
+declare function cargo({ updateLockFile, bumpDep: getBumpDepType }?: CargoPluginOptions): TegamiPlugin;
 interface CargoGraph {
   /** path -> Cargo.toml */
   files: Map<string, CargoToml>;
@@ -417,7 +423,7 @@ interface CargoGraph {
 }
 //#endregion
 //#region src/providers/npm/graph.d.ts
-declare class NpmPackage extends WorkspacePackage$1 {
+declare class NpmPackage extends WorkspacePackage {
   readonly path: string;
   readonly manifest: PackageManifest;
   readonly manager = "npm";
@@ -428,9 +434,7 @@ declare class NpmPackage extends WorkspacePackage$1 {
   write(): Promise<void>;
   initDraft(): PackageDraft;
   getRegistry(): string;
-  configureDraft({
-    draft
-  }: {
+  configureDraft({ draft }: {
     draft: PackageDraft;
   }): void;
   listDependencies(graph: NpmGraph): ResolvedNpmDependency[];
@@ -526,7 +530,8 @@ interface TegamiContext {
   /** additional context when npm plugin is configured */
   npm?: {
     agent: Agent;
-    client: AgentName; /** available after resolve */
+    client: AgentName;
+    /** available after resolve */
     graph?: NpmGraph;
   };
   cargo?: {
@@ -574,11 +579,14 @@ interface PackagePublishPlan {
   updated: boolean;
   /** generated by Git plugin */
   git?: {
-    /** the associated Git tag of package */tag?: string;
+    /** the associated Git tag of package */
+    tag?: string;
   };
   /** generated by npm plugin */
   npm?: {
-    /** dist tag to use if published */distTag?: string; /** point latest tag to it if published */
+    /** dist tag to use if published */
+    distTag?: string;
+    /** point latest tag to it if published */
     markLatest?: boolean;
   };
   /** publish result, generated for all packages in publish plan after publishing */
@@ -636,7 +644,6 @@ 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[]>;
@@ -645,11 +652,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";
@@ -659,7 +677,8 @@ interface Tegami {
   }>;
   /** Internal APIs, do not use it unless you know what you are doing */
   _internal: {
-    context(): Promise<TegamiContext>; /** access context without requiring graph resolution */
+    context(): Promise<TegamiContext>;
+    /** access context without requiring graph resolution */
     contextUnresolved(): Promise<TegamiContext>;
     options: TegamiOptions;
   };
@@ -676,9 +695,9 @@ interface TegamiCliCommand<Values extends Record<string, ArgValue | undefined>,
     short?: string;
     description?: string;
     multiple?: Multiple;
-  }): TegamiCliCommand<Values & { [k in Name]?: Multiple extends true ? T extends "string" ? string[] : boolean[] : T extends "string" ? string : boolean }, Positionals>;
-  positional<const Name extends string, const Required extends boolean = true>(name: Name, required?: Required): TegamiCliCommand<Values, Positionals & { [K in Name]: Required extends true ? string : string | undefined }>;
-  positionals<const Name extends string>(name: Name): TegamiCliCommand<Values, Positionals & { [K in Name]: string[] }>;
+  }): TegamiCliCommand<Values & { [k in Name]?: Multiple extends true ? T extends "string" ? string[] : boolean[] : T extends "string" ? string : boolean; }, Positionals>;
+  positional<const Name extends string, const Required extends boolean = true>(name: Name, required?: Required): TegamiCliCommand<Values, Positionals & { [K in Name]: Required extends true ? string : string | undefined; }>;
+  positionals<const Name extends string>(name: Name): TegamiCliCommand<Values, Positionals & { [K in Name]: string[]; }>;
   action(fn: (options: {
     context: TegamiContext;
     values: Values;
@@ -701,10 +720,12 @@ interface TegamiCliRegistry {
 //#endregion
 //#region src/providers/npm/cli.d.ts
 type TrustedPublishOptions = {
-  provider: "github"; /** CI workflow filename for publishing. */
+  provider: "github";
+  /** CI workflow filename for publishing. */
   workflow: string;
 } | {
-  provider: "gitlab"; /** CI pipeline filename for publishing. */
+  provider: "gitlab";
+  /** CI pipeline filename for publishing. */
   workflow: string;
 };
 //#endregion
@@ -738,19 +759,13 @@ interface NpmPluginOptions {
   /** Configure `tegami npm pretrust`, disabled by default. */
   trustedPublish?: TrustedPublishOptions;
 }
-declare function npm({
-  client: defaultClient,
-  onBreakPeerDep,
-  updateLockFile,
-  trustedPublish,
-  bumpDep: getBumpDepType
-}?: NpmPluginOptions): TegamiPlugin;
+declare function npm({ client: defaultClient, onBreakPeerDep, updateLockFile, trustedPublish, bumpDep: getBumpDepType }?: NpmPluginOptions): TegamiPlugin;
 //#endregion
 //#region src/types.d.ts
 /** Generates changelog content for a package release. */
 interface LogGenerator {
   generate(this: TegamiContext, opts: {
-    pkg: WorkspacePackage$1;
+    pkg: WorkspacePackage;
     packageDraft: PackageDraft;
     draft: Draft;
   }): string | Promise<string>;
@@ -765,7 +780,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$1) => PackageOptions<NoInfer<Groups>> | undefined);
+  packages?: Record<string, PackageOptions<NoInfer<Groups>>> | ((pkg: WorkspacePackage) => PackageOptions<NoInfer<Groups>> | undefined);
   plugins?: TegamiPluginOption[];
   groups?: Record<Groups, GroupOptions>;
   /** Package names, ids, or regex patterns to exclude from the dependency graph. */
@@ -844,7 +859,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$1;
+    pkg: WorkspacePackage;
     plan: PublishPlan;
   }): Awaitable<PublishPreflight | void | undefined>;
   /** Called when all preflights finished */
@@ -853,7 +868,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$1;
+    pkg: WorkspacePackage;
     plan: PublishPlan;
   }): Promise<PackagePublishResult | undefined | void>;
   /**
@@ -870,11 +885,11 @@ interface TegamiPlugin {
   }): Awaitable<void>;
   /** Called before a package will be published, return `false` to prevent from publishing. */
   willPublish?(this: TegamiContext, opts: {
-    pkg: WorkspacePackage$1;
+    pkg: WorkspacePackage;
   }): Awaitable<false | void | undefined>;
   /** Called after a package is published successfully, or failed. */
   afterPublish?(this: TegamiContext, opts: {
-    pkg: WorkspacePackage$1;
+    pkg: WorkspacePackage;
     plan: PublishPlan;
   }): Awaitable<void>;
   /** Called after all publishing finishes. */
@@ -887,7 +902,7 @@ interface TegamiPlugin {
   applyCliDraft?(this: TegamiContext, draft: Draft): Awaitable<void>;
 }
 type Awaitable<T> = T | Promise<T>;
-type RequireFields<Obj, K extends keyof Obj> = Obj & { [R in K]-?: NonNullable<Obj[R]> };
+type RequireFields<Obj, K extends keyof Obj> = Obj & { [R in K]-?: NonNullable<Obj[R]>; };
 interface PublishPreflight {
   /**
    * Whether the package should be published, the state **must only depend on local inputs** (e.g. local `package.json` or `publish-lock.yaml`).
@@ -909,4 +924,4 @@ interface PublishPreflight {
   optionalWait?: string[];
 }
 //#endregion
-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 };
+export { type PackageGroup as A, type NpmGraph as C, type CargoPluginOptions as D, CargoPackage as E, ChangelogEntry as F, ReplayCondition as I, BumpType as L, Draft as M, DraftPolicy as N, cargo as O, PackageDraft as P, DependencySpec as S, CargoGraph as T, PublishOptions as _, type PublishPreflight as a, type GenerateFromCommitsOptions as b, type TegamiPluginOption as c, type GenerateChangelogOptions as d, Tegami as f, PackagePublishResult as g, PackagePublishPlan as h, PackageOptions as i, WorkspacePackage as j, PackageGraph 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, NpmPackage as w, TegamiContext as x, CommitChangelog as y };

package/dist/utils/index.d.ts

@@ -1,5 +1,4 @@
 import { Result } from "tinyexec";
-
 //#region src/utils/error.d.ts
 declare function execFailure(context: string, result: Awaited<Result>): Error;
 declare function fetchFailure(context: string, response: Response): Promise<Error>;

package/dist/{version-request-C89RO85i.js → version-request-CLEmlVnL.js}

@@ -1,9 +1,9 @@
-import { i as formatNpmDistTag, r as diffWeight } from "./semver-DrtaCCZK.js";
-import { 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-BEYIILK5.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-DAz6bHI_.js";
+import { n as _validateReport, t as _createStandardSchema } from "./_createStandardSchema-DFfVlh8x.js";
+import { t as getPackageBumps } from "./shared-BraxbVVG.js";
+import { o as PublishLock, r as runPreflights, s as parsePublishLock, t as initPublishPlan } from "./publish-CQifflae.js";
 import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import { join, relative } from "node:path";
 import { x } from "tinyexec";
@@ -66,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) {
@@ -94,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.
 	*
@@ -101,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,
@@ -118,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()) {
@@ -152,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 = [];
@@ -189,19 +203,30 @@ function onVersionRequest(provider) {
 					tasks.push(provider.upsert(this, resolved, !inSync));
 					continue;
 				}
-				await pushBranch(this.cwd, branch);
+				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;
@@ -228,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);
@@ -388,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,
@@ -469,5 +468,96 @@ function formatPreview({ graph, npm }, draft, newChangelogNames, labels) {
 	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 n, formatPreview as t };
+export { versionRequestPlugin as i, formatPreview as n, resolveFileCommit as r, createAutoRelease as t };

package/dist/{version-request-C5vtakPE.d.ts → version-request-DHxFYvna.d.ts}

@@ -1,5 +1,4 @@
-import { M as Draft, h as PublishLock, t as Awaitable, x as TegamiContext, y as PublishPlan } from "./types-Kj7Nxbjz.js";
-
+import { M as Draft, m as PublishLock, t as Awaitable, v as PublishPlan, x as TegamiContext } from "./types-Cn0Au3Kk.js";
 //#region src/utils/version-request.d.ts
 interface VersionRequestOptions {
   /**
@@ -45,7 +44,6 @@ interface VersionRequestContext {
   plan: PublishPlan | undefined;
   getPreviousVersion(packageId: string): string | undefined;
 }
-/** adapter over the version request API of a git provider */
 interface PublishGroupStore {
   /**
    * - active: groups whose version request was merged, they stay listed until the lock is removed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tegami",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "description": "A tool to manage changelogs, versioning, and publishing in monorepo",
   "license": "MIT",
   "author": "Fuma Nama",
@@ -37,10 +37,10 @@
     "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "@types/node": "^26.1.0",
+    "@types/node": "^26.1.1",
     "@types/semver": "^7.7.1",
     "package-manager-detector": "^1.7.0",
-    "tsdown": "^0.22.3",
+    "tsdown": "^0.22.4",
     "typescript": "6.0.3",
     "typia": "^12.1.1",
     "@repo/typescript-config": "0.0.0"