tegami 0.1.0-beta.2 → 0.1.0-beta.3

package/dist/{checks-Fz8-N09y.js → checks-BQISvt_o.js}

@@ -2,6 +2,12 @@ import { n as handlePluginError } from "./error-DBK-9uBa.js";
 import { n as jsonCodec, t as bumpTypeSchema } from "./schemas-CurBAaW5.js";
 import z$1 from "zod";
 import { readFile } from "fs/promises";
+//#region src/utils/changelog.ts
+function changelogFilename(disambiguator = 0) {
+	const date = /* @__PURE__ */ new Date();
+	return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}-${(Date.now() + disambiguator).toString(36)}.md`;
+}
+//#endregion
 //#region src/plans/store.ts
 const packagePlanStoreSchema = z$1.object({
 	type: bumpTypeSchema.optional(),
@@ -21,6 +27,7 @@ const planStoreSchema = jsonCodec(z$1.object({
 		subject: z$1.string().optional(),
 		packages: z$1.record(z$1.string(), bumpTypeSchema),
 		sections: z$1.array(z$1.object({
+			depth: z$1.number(),
 			title: z$1.string(),
 			content: z$1.string()
 		}))
@@ -88,4 +95,4 @@ async function assertPublishPlanFinished(context) {
 	if ((await publishPlanStatus(store, context)).state === "pending") throw new Error(`Publish plan already exists at ${context.planPath} and is pending. Publish it before applying a new plan.`);
 }
 //#endregion
-export { readPlanStore as i, publishPlanStatus as n, createPlanStore as r, assertPublishPlanFinished as t };
+export { changelogFilename as a, readPlanStore as i, publishPlanStatus as n, createPlanStore as r, assertPublishPlanFinished as t };

package/dist/cli/index.d.ts

@@ -1,4 +1,4 @@
-import { C as PublishResult, O as DraftPlan, _ as Tegami, t as Awaitable } from "../types-BNhcu4-X.js";
+import { C as PublishResult, O as DraftPlan, _ as Tegami, t as Awaitable } from "../types-CrA7ZKxb.js";
 import { Command } from "commander";
 
 //#region src/cli/index.d.ts

package/dist/cli/index.js

@@ -1,12 +1,224 @@
+import { a as changelogFilename, t as assertPublishPlanFinished } from "../checks-BQISvt_o.js";
 import { n as handlePluginError } from "../error-DBK-9uBa.js";
-import { t as bumpDepth } from "../semver-CPtl0XNq.js";
-import { t as assertPublishPlanFinished } from "../checks-Fz8-N09y.js";
+import { r as formatNpmDistTag, t as bumpDepth } from "../semver-CPtl0XNq.js";
 import { t as isCI } from "../constants-B9qjNfvr.js";
-import { mkdir, writeFile } from "node:fs/promises";
-import { join } from "node:path";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path, { basename, isAbsolute, join, normalize, relative } from "node:path";
+import { x } from "tinyexec";
 import { dump } from "js-yaml";
+import { detect, resolveCommand } from "package-manager-detector";
 import { autocompleteMultiselect, confirm, intro, isCancel, multiline, note, outro, select, spinner } from "@clack/prompts";
 import { Command } from "commander";
+//#region src/cli/init-agent.ts
+const CHANGELOG_DOCS_URL$1 = "https://tegami.fuma-nama.dev/changelog";
+async function initAgent(context, options = {}) {
+	const output = path.resolve(context.cwd, options.output ?? "AGENTS.md");
+	const content = renderAgentsMd(context);
+	try {
+		await writeFile(output, (await readFile(output, "utf8")).trimEnd() + "\n\n" + content);
+		return {
+			path: output,
+			created: false
+		};
+	} catch {
+		await writeFile(output, content);
+		return {
+			path: output,
+			created: true
+		};
+	}
+}
+function renderAgentsMd(context) {
+	const changelogDir = path.relative(context.cwd, context.changelogDir) || "project root";
+	const planPath = path.relative(context.cwd, context.planPath) || "project root";
+	return [
+		"# Release workflow",
+		"",
+		"This repository uses [Tegami](https://tegami.fuma-nama.dev) for versioning and publishing.",
+		"",
+		"## Write changelog files",
+		"",
+		`Create pending changelog files under \`${changelogDir}/\` as \`YYYY-MM-DD-{hash}.md\`.`,
+		"",
+		`See the [changelog format docs](${CHANGELOG_DOCS_URL$1}) for details.`,
+		"",
+		"### Example",
+		"",
+		"```md",
+		"---",
+		"packages:",
+		`  "npm:@acme/ui": patch`,
+		"---",
+		"",
+		"### Fix button hover state",
+		"",
+		"The hover color now matches the design system.",
+		"```",
+		"",
+		"### Package references",
+		"",
+		"Use package names, ids, or groups in frontmatter. For example:",
+		"",
+		"- `\"@acme/ui\"` — package name",
+		"- `\"npm:@acme/ui\"` — package id",
+		"- `\"group:acme\"` — every package in a group",
+		"",
+		"Rules:",
+		"",
+		"- Include YAML frontmatter with `packages`",
+		"- Include at least one `#`, `##`, or `###` heading in the body",
+		"- Write user-facing release notes under each heading",
+		`- Do not edit \`${planPath}\` or package \`CHANGELOG.md\` files directly`,
+		""
+	].join("\n");
+}
+//#endregion
+//#region src/utils/package-manager.ts
+async function formatRunScriptCommand(cwd, script, agent) {
+	const resolved = resolveCommand(agent ?? (await detect({ cwd }))?.agent ?? "npm", "run", [script]);
+	if (!resolved) return `npm run ${script}`;
+	return [resolved.command, ...resolved.args].join(" ");
+}
+//#endregion
+//#region src/cli/ci-pr.ts
+const TEGAMI_DOCS_URL = "https://tegami.fuma-nama.dev";
+const CHANGELOG_DOCS_URL = `${TEGAMI_DOCS_URL}/changelog`;
+async function runCiPr(context, draft, options = {}) {
+	const event = await resolvePullRequestEvent();
+	return renderCiPrPreview(context, draft, {
+		repo: options.repo ?? context.github?.repo ?? process.env.GITHUB_REPOSITORY,
+		branch: options.branch ?? event?.headRef,
+		prChangelogFiles: event && !options.branch ? await getPullRequestChangelogFiles(context, event.baseSha, event.headSha) : [],
+		tegamiCommand: await formatRunScriptCommand(context.cwd, "tegami", context.options.npm?.client)
+	});
+}
+function renderCiPrPreview(context, draft, options = {}) {
+	const changelogDir = relative(context.cwd, context.changelogDir) || ".tegami";
+	const tegamiCommand = options.tegamiCommand ?? "npm run tegami";
+	const createLink = options.repo && options.branch ? createChangelogUrl(options.repo, options.branch, changelogDir, changelogFilename()) : void 0;
+	const lines = [
+		"### Tegami",
+		"",
+		`This repository uses [Tegami](${TEGAMI_DOCS_URL}) to manage releases. When your changes affect published packages, add a changelog file under \`.tegami/\` before merging.`,
+		""
+	];
+	if (createLink) lines.push(`[**Create a changelog →**](${createLink}) · [Changelog format](${CHANGELOG_DOCS_URL})`, "");
+	else lines.push(`Run \`${tegamiCommand}\` locally or see the [changelog format](${CHANGELOG_DOCS_URL}).`, "");
+	const pendingPackages = getPendingPackages(context, draft);
+	const prChangelogs = filterChangelogsInPullRequest(draft, options.prChangelogFiles);
+	if (pendingPackages.length > 0) {
+		lines.push("#### Release preview", "", "| Package | Bump | Version |", "| --- | --- | --- |");
+		for (const { name, type, from, to, distTag, publish } of pendingPackages) {
+			const publishNote = publish ? "" : " (no publish)";
+			lines.push(`| \`${name}\` | ${type} | \`${from}\` → \`${to}\`${formatNpmDistTag(distTag)}${publishNote} |`);
+		}
+		lines.push("");
+	}
+	if (prChangelogs.length > 0) {
+		lines.push("#### Changelogs in this PR", "");
+		for (const entry of prChangelogs) {
+			const title = entry.sections[0]?.title ?? entry.filename;
+			lines.push(`- \`${entry.filename}\` — ${title}`);
+		}
+		lines.push("");
+	} else if (pendingPackages.length === 0) lines.push("#### No changelogs yet", "", "This PR has no pending changelog files. If your changes require a release, add a changelog before merging.", "");
+	else if (options.prChangelogFiles?.length === 0) lines.push("This PR does not add changelog files. Pending changelogs from other branches are included in the preview above.", "");
+	lines.push(`Run \`${tegamiCommand}\` locally to create a changelog interactively.`, "", `<sub>Managed by [Tegami](${TEGAMI_DOCS_URL}).</sub>`, "");
+	return lines.join("\n");
+}
+async function resolvePullRequestEvent() {
+	const eventPath = process.env.GITHUB_EVENT_PATH;
+	if (!eventPath) return;
+	let event;
+	try {
+		event = JSON.parse(await readFile(eventPath, "utf8"));
+	} catch {
+		return;
+	}
+	const pullRequest = event.pull_request;
+	if (!pullRequest) return;
+	return {
+		number: pullRequest.number,
+		headRef: pullRequest.head.ref,
+		baseSha: pullRequest.base.sha,
+		headSha: pullRequest.head.sha
+	};
+}
+async function getPullRequestChangelogFiles(context, baseSha, headSha) {
+	const dir = relative(context.cwd, context.changelogDir);
+	const result = await x("git", [
+		"diff",
+		"--name-only",
+		"--diff-filter=AM",
+		`${baseSha}...${headSha}`,
+		"--",
+		`${dir}/`
+	], { nodeOptions: { cwd: context.cwd } });
+	if (result.exitCode !== 0) return [];
+	return result.stdout.split("\n").map((line) => line.trim()).filter((line) => line.endsWith(".md")).map((line) => basename(line));
+}
+function getPendingPackages(context, draft) {
+	const packages = [];
+	for (const pkg of context.graph.getPackages()) {
+		const plan = draft.getPackagePlan(pkg.id);
+		if (!plan?.type) continue;
+		packages.push({
+			name: pkg.name,
+			type: plan.type,
+			from: pkg.version,
+			to: plan.bumpVersion(pkg),
+			distTag: plan.npm?.distTag,
+			publish: plan.publish ?? false
+		});
+	}
+	return packages;
+}
+function filterChangelogsInPullRequest(draft, filenames) {
+	if (!filenames) return draft.getChangelogs();
+	const names = new Set(filenames);
+	return draft.getChangelogs().filter((entry) => names.has(entry.filename));
+}
+function createChangelogUrl(repo, branch, changelogDir, filename) {
+	const segments = [...changelogDir.split("/").filter(Boolean), filename].map((part) => encodeURIComponent(part));
+	return `https://github.com/${repo}/new/${branch.split("/").map(encodeURIComponent).join("/")}/${segments.join("/")}`;
+}
+//#endregion
+//#region src/utils/git-changes.ts
+async function getChangedPackages(graph, cwd) {
+	return resolveChangedPackages(graph, await getChangedFilePaths(cwd), cwd);
+}
+async function getChangedFilePaths(cwd) {
+	const files = /* @__PURE__ */ new Set();
+	for (const args of [["diff", "--name-only"], [
+		"diff",
+		"--cached",
+		"--name-only"
+	]]) await addGitOutput(files, cwd, args);
+	return Array.from(files);
+}
+function resolveChangedPackages(graph, files, cwd) {
+	const packages = [...graph.getPackages()].sort((a, b) => b.path.length - a.path.length);
+	const matched = /* @__PURE__ */ new Map();
+	for (const file of files) for (const pkg of packages) if (isUnderDir(file, pkg.path, cwd)) {
+		matched.set(pkg.id, pkg);
+		break;
+	}
+	return [...matched.values()];
+}
+function isUnderDir(file, dir, cwd) {
+	const absolute = join(cwd, file);
+	const rel = relative(normalize(dir), absolute);
+	return rel === "" || !rel.startsWith("..") && !isAbsolute(rel);
+}
+async function addGitOutput(files, cwd, args) {
+	const result = await x("git", args, { nodeOptions: { cwd } });
+	if (result.exitCode !== 0) return;
+	for (const line of result.stdout.split("\n")) {
+		const trimmed = line.trim();
+		if (trimmed) files.add(trimmed);
+	}
+}
+//#endregion
 //#region src/cli/index.ts
 var CancelledError = class extends Error {
 	constructor() {
@@ -29,6 +241,7 @@ function createCli(tegami, options = {}) {
 		if (await versionPackages(tegami, { cli: options })) return;
 		await publishPackages(tegami, { cli: options });
 	}));
+	program.command("ci-pr").description("show a pull request release preview and changelog guidance").option("--repo <repo>", "GitHub repository (owner/name)").option("--branch <branch>", "PR head branch for the create-changelog link").option("--print", "print the preview markdown to stdout").action((commandOptions) => runAction(tegami, () => runCiPrCommand(tegami, commandOptions)));
 	program.command("publish").description("publish packages from the applied publish plan").option("--dry-run", "validate the publish plan without publishing packages").action((commandOptions) => runAction(tegami, async () => {
 		await publishPackages(tegami, {
 			...commandOptions,
@@ -36,6 +249,7 @@ function createCli(tegami, options = {}) {
 		});
 	}));
 	program.command("cleanup").description("remove the publish plan after all packages have been published").action(() => runAction(tegami, () => runCleanup(tegami)));
+	program.command("init-agent").description("write AGENTS.md with changelog instructions for AI agents").option("-o, --output <path>", "output path", "AGENTS.md").action((commandOptions) => runAction(tegami, () => runInitAgent(tegami, commandOptions)));
 	return program;
 }
 async function createChangelogs(tegami, _options) {
@@ -44,22 +258,33 @@ async function createChangelogs(tegami, _options) {
 	intro("Create changelogs");
 	let selectedPackages = [];
 	if (!isCI()) {
-		const packages = context.graph.getPackages();
 		const useShortname = /* @__PURE__ */ new Map();
-		for (const pkg of packages) if (useShortname.has(pkg.name)) useShortname.set(pkg.name, false);
+		for (const pkg of context.graph.getPackages()) if (useShortname.has(pkg.name)) useShortname.set(pkg.name, false);
 		else useShortname.set(pkg.name, true);
 		const getPackageLabel = (pkg) => {
 			return useShortname.get(pkg.name) ? pkg.name : pkg.id;
 		};
+		const changedPackages = new Set(await getChangedPackages(context.graph, context.cwd));
 		const selectOptions = [];
-		for (const group of context.graph.getGroups()) selectOptions.push({
-			label: `Group ${group.name}`,
-			value: `group:${group.name}`,
-			hint: group.packages.map(getPackageLabel).join(", ")
-		});
+		const groups = [];
+		for (const group of context.graph.getGroups()) {
+			const changed = group.packages.some((pkg) => changedPackages.has(pkg));
+			groups.push([group, changed]);
+		}
+		groups.sort((a, b) => (a[1] ? 0 : 1) - (b[1] ? 0 : 1));
+		for (const [group, changed] of groups) {
+			const members = group.packages.map(getPackageLabel).join(", ");
+			selectOptions.push({
+				label: `Group ${group.name}`,
+				value: `group:${group.name}`,
+				hint: changed ? `changed · ${members}` : members
+			});
+		}
+		const packages = context.graph.getPackages().toSorted((a, b) => (changedPackages.has(a) ? 0 : 1) - (changedPackages.has(b) ? 0 : 1));
 		for (const pkg of packages) selectOptions.push({
 			label: getPackageLabel(pkg),
-			value: pkg.id
+			value: pkg.id,
+			hint: changedPackages.has(pkg) ? "changed" : void 0
 		});
 		const selected = await autocompleteMultiselect({
 			message: "Select packages (leave empty to auto-generate from commits)",
@@ -186,6 +411,26 @@ async function publishPackages(tegami, options) {
 	outro(dryRun ? "Publish plan is valid." : "Packages published.");
 	return true;
 }
+async function runCiPrCommand(tegami, options) {
+	const body = await runCiPr(await tegami._internal.context(), await tegami.draft(), options);
+	if (options.print) {
+		process.stdout.write(`${body}\n`);
+		if (!isCI()) outro("Release preview ready.");
+		return;
+	}
+	note(body, "Release preview");
+	outro("Release preview ready.");
+}
+async function runInitAgent(tegami, options) {
+	intro("Init agent instructions");
+	const context = await tegami._internal.context();
+	const s = spinner();
+	s.start("Writing AGENTS.md");
+	const result = await initAgent(context, options);
+	s.stop(result.created ? "Created AGENTS.md" : "Appended to AGENTS.md");
+	note(relative(context.cwd, result.path) || "AGENTS.md", "Agent instructions");
+	outro("Agents can follow AGENTS.md to write changelogs.");
+}
 async function runCleanup(tegami) {
 	intro("Cleanup publish plan");
 	const s = spinner();
@@ -216,10 +461,6 @@ function renderManualChangelog(packages, type, message) {
 		""
 	].join("\n");
 }
-function changelogFilename() {
-	const date = /* @__PURE__ */ new Date();
-	return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}-${Date.now().toString(36)}.md`;
-}
 async function runAction(tegami, action) {
 	try {
 		const context = await tegami._internal.context();

package/dist/generators/simple.d.ts

@@ -1,4 +1,4 @@
-import { r as LogGenerator } from "../types-BNhcu4-X.js";
+import { r as LogGenerator } from "../types-CrA7ZKxb.js";
 
 //#region src/generators/simple.d.ts
 declare function simpleGenerator(): LogGenerator;

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { C as PublishResult, D as WorkspacePackage, E as PackageGroup, O as DraftPlan, S as PublishOptions, T as PackageGraph, _ as Tegami, a as RegistryClient, b as CreatedChangelog, c as TegamiPluginOption, i as PackageOptions, k as PackagePlan, n as GroupOptions, o as TegamiOptions, r as LogGenerator, s as TegamiPlugin, v as tegami, x as PackagePublishResult, y as CreateChangelogOptions } from "./types-BNhcu4-X.js";
+import { C as PublishResult, D as WorkspacePackage, E as PackageGroup, O as DraftPlan, S as PublishOptions, T as PackageGraph, _ as Tegami, a as RegistryClient, b as CreatedChangelog, c as TegamiPluginOption, i as PackageOptions, k as PackagePlan, n as GroupOptions, o as TegamiOptions, r as LogGenerator, s as TegamiPlugin, v as tegami, x as PackagePublishResult, y as CreateChangelogOptions } from "./types-CrA7ZKxb.js";
 export { type CreateChangelogOptions, type CreatedChangelog, type DraftPlan, type GroupOptions, type LogGenerator, type PackageGraph, type PackageGroup, type PackageOptions, type PackagePlan, type PackagePublishResult, type PublishOptions, type PublishResult, type RegistryClient, Tegami, type TegamiOptions, type TegamiPlugin, type TegamiPluginOption, type WorkspacePackage, tegami };

package/dist/index.js

@@ -1,11 +1,11 @@
-import { n as handlePluginError } from "./error-DBK-9uBa.js";
+import { a as changelogFilename, i as readPlanStore, n as publishPlanStatus, r as createPlanStore, t as assertPublishPlanFinished } from "./checks-BQISvt_o.js";
+import { n as handlePluginError, t as execFailure } from "./error-DBK-9uBa.js";
 import { a as maxBump } from "./semver-CPtl0XNq.js";
 import { t as PackageGraph } from "./graph-B22NBRUG.js";
 import { cargo } from "./providers/cargo.js";
 import { t as bumpTypeSchema } from "./schemas-CurBAaW5.js";
 import { npm } from "./providers/npm.js";
 import { simpleGenerator } from "./generators/simple.js";
-import { i as readPlanStore, n as publishPlanStatus, r as createPlanStore, t as assertPublishPlanFinished } from "./checks-Fz8-N09y.js";
 import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import path, { basename, dirname, join } from "node:path";
 import { x } from "tinyexec";
@@ -13,8 +13,73 @@ import { load } from "js-yaml";
 import z$1 from "zod";
 import { fromMarkdown } from "mdast-util-from-markdown";
 import { toMarkdown } from "mdast-util-to-markdown";
-//#region src/changelog/create.ts
-async function createChangelog(context, options = {}) {
+//#region src/utils/conventional-commit.ts
+/**
+* Conventional commit header per conventionalcommits.org and semantic-release defaults.
+* @see https://www.conventionalcommits.org/en/v1.0.0/
+*/
+const CONVENTIONAL_COMMIT_HEADER = /^(?<type>\w+)(?:\((?<scope>[^)]*)\))?(?<breaking>!)?: (?<title>.+)$/;
+const BREAKING_CHANGE_FOOTER = /^BREAKING[ -]CHANGE:/m;
+/** Parse conventional commits and resolve scopes against the workspace graph. */
+function createConventionalCommitParser(graph) {
+	const byShortName = /* @__PURE__ */ new Map();
+	for (const pkg of graph.getPackages()) {
+		const slash = pkg.name.lastIndexOf("/");
+		const short = slash >= 0 ? pkg.name.slice(slash + 1) : pkg.name;
+		const names = byShortName.get(short);
+		if (names) names.push(pkg.name);
+		else byShortName.set(short, [pkg.name]);
+	}
+	function resolvePackages(scope) {
+		if (!scope) return [];
+		const packages = /* @__PURE__ */ new Set();
+		for (const item of scope.split(",")) {
+			const name = item.trim();
+			if (!name) continue;
+			const direct = graph.getByName(name);
+			if (direct.length > 0) {
+				for (const pkg of direct) packages.add(pkg.name);
+				continue;
+			}
+			const byShort = byShortName.get(name);
+			if (byShort) {
+				for (const pkgName of byShort) packages.add(pkgName);
+				continue;
+			}
+			packages.add(name);
+		}
+		return Array.from(packages);
+	}
+	return function parseConventionalCommit(subject, body = "") {
+		const match = CONVENTIONAL_COMMIT_HEADER.exec(subject.trim());
+		if (!match?.groups) return;
+		const { type, scope, breaking, title } = match.groups;
+		if (!type || !title) return;
+		const trimmedTitle = title.trim();
+		if (!trimmedTitle) return;
+		const trimmedScope = scope?.trim();
+		return {
+			type: type.toLowerCase(),
+			packages: resolvePackages(trimmedScope || void 0),
+			breaking: Boolean(breaking) || BREAKING_CHANGE_FOOTER.test(body),
+			title: trimmedTitle
+		};
+	};
+}
+/** Map releasable conventional commit types to semver bumps (semantic-release defaults). */
+function conventionalCommitToBump(type, breaking) {
+	if (breaking) return "major";
+	switch (type) {
+		case "feat": return "minor";
+		case "fix":
+		case "perf":
+		case "revert": return "patch";
+		default: return;
+	}
+}
+//#endregion
+//#region src/changelog/generate.ts
+async function generateChangelog(context, options = {}) {
 	const commits = await readConventionalCommits(context, options);
 	const groups = /* @__PURE__ */ new Map();
 	for (const commit of commits) {
@@ -23,23 +88,19 @@ async function createChangelog(context, options = {}) {
 		if (group) group.push(commit);
 		else groups.set(key, [commit]);
 	}
-	const directory = context.changelogDir;
-	await mkdir(directory, { recursive: true });
-	const created = [];
-	const stamp = Date.now().toString(36);
-	for (const [key, changes] of groups) {
+	await mkdir(context.changelogDir, { recursive: true });
+	return Promise.all(Array.from(groups, async ([key, changes], index) => {
 		const packages = key ? key.split("\0") : [];
-		const filename = `changes-${stamp}-${slugify(packages.join("-") || "workspace")}.md`;
-		const path = join(directory, filename);
+		const filename = changelogFilename(index);
+		const path = join(context.changelogDir, filename);
 		await writeFile(path, renderChangelog(packages, changes));
-		created.push({
+		return {
 			filename,
 			path,
 			packages,
 			changes: changes.length
-		});
-	}
-	return created;
+		};
+	}));
 }
 async function readConventionalCommits(context, options) {
 	const to = options.to ?? "HEAD";
@@ -52,13 +113,24 @@ async function readConventionalCommits(context, options) {
 	if (from) args.push(`${from}..${to}`);
 	else if (to !== "HEAD") args.push(to);
 	const result = await x("git", args, { nodeOptions: { cwd: context.cwd } });
-	if (result.exitCode !== 0) throw new Error(`Unable to read git commits: ${commandOutput(result).trim()}`);
+	if (result.exitCode !== 0) throw execFailure(`Unable to read git commits from ${from ?? "start"} to ${to}`, result);
+	const parseCommit = createConventionalCommitParser(context.graph);
 	const changes = [];
 	for (const record of result.stdout.split("")) {
 		const [hash, subject, body = ""] = record.replace(/^\n+|\n+$/g, "").split("");
 		if (!hash || !subject) continue;
-		const change = parseConventionalCommit(context, hash, subject, body);
-		if (change) changes.push(change);
+		const parsed = parseCommit(subject, body);
+		if (!parsed) continue;
+		const bump = conventionalCommitToBump(parsed.type, parsed.breaking);
+		if (!bump) continue;
+		changes.push({
+			hash,
+			subject,
+			body: body.trim(),
+			packages: parsed.packages,
+			type: bump,
+			title: titleCase(parsed.title)
+		});
 	}
 	return changes;
 }
@@ -68,47 +140,9 @@ async function latestTag(cwd) {
 		"--tags",
 		"--abbrev=0"
 	], { nodeOptions: { cwd } });
-	if (result.exitCode !== 0) return void 0;
+	if (result.exitCode !== 0) return;
 	return result.stdout.trim() || void 0;
 }
-function parseConventionalCommit(context, hash, subject, body) {
-	const match = /^(?<type>[a-zA-Z]+)(?:\((?<scope>[^)]+)\))?(?<breaking>!)?:\s*(?<title>.+)$/.exec(subject);
-	if (!match?.groups) return void 0;
-	const bump = commitTypeToBump(match.groups.type.toLowerCase(), Boolean(match.groups.breaking) || /^BREAKING(?:-| )CHANGE:/m.test(body));
-	if (!bump) return void 0;
-	return {
-		hash,
-		subject,
-		body: body.trim(),
-		packages: resolvePackages(context, match.groups.scope),
-		type: bump,
-		title: titleCase(match.groups.title)
-	};
-}
-function commitTypeToBump(type, breaking) {
-	if (breaking) return "major";
-	if (type === "feat") return "minor";
-	if (type === "fix" || type === "perf") return "patch";
-}
-function resolvePackages(context, scope) {
-	if (!scope) return [];
-	const packages = /* @__PURE__ */ new Set();
-	for (const item of scope.split(",")) {
-		const name = item.trim();
-		if (!name) continue;
-		if (context.graph.getByName(name).length > 0) {
-			packages.add(name);
-			continue;
-		}
-		const byShortName = context.graph.getPackages().filter((pkg) => pkg.name.split("/").at(-1) === name);
-		if (byShortName.length > 0) {
-			for (const pkg of byShortName) packages.add(pkg.name);
-			continue;
-		}
-		packages.add(name);
-	}
-	return Array.from(packages).sort();
-}
 function renderChangelog(packages, changes) {
 	return [
 		"---",
@@ -127,12 +161,6 @@ function renderChange(change) {
 function titleCase(value) {
 	return value.charAt(0).toUpperCase() + value.slice(1);
 }
-function slugify(value) {
-	return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-}
-function commandOutput(result) {
-	return [result.stdout, result.stderr].filter(Boolean).join("\n");
-}
 //#endregion
 //#region src/context.ts
 async function createTegamiContext(options = {}) {
@@ -543,7 +571,7 @@ function tegami(options = {}) {
 	}
 	return {
 		async generateChangelog(createOptions = {}) {
-			return createChangelog(await $context, createOptions);
+			return generateChangelog(await $context, createOptions);
 		},
 		_internal: {
 			options,

package/dist/plugins/git.d.ts

@@ -1,4 +1,4 @@
-import { s as TegamiPlugin } from "../types-BNhcu4-X.js";
+import { s as TegamiPlugin } from "../types-CrA7ZKxb.js";
 
 //#region src/plugins/git.d.ts
 interface GitPluginOptions {

package/dist/plugins/github.d.ts

@@ -1,4 +1,4 @@
-import { O as DraftPlan, s as TegamiPlugin, t as Awaitable, w as TegamiContext, x as PackagePublishResult } from "../types-BNhcu4-X.js";
+import { O as DraftPlan, s as TegamiPlugin, t as Awaitable, w as TegamiContext, x as PackagePublishResult } from "../types-CrA7ZKxb.js";
 import { GitPluginOptions } from "./git.js";
 
 //#region src/plugins/github.d.ts
@@ -17,6 +17,12 @@ interface VersionPullRequest {
   body?: string;
 }
 interface VersionPullRequestOptions {
+  /**
+   * Create the PR even outside of CI.
+   *
+   * @default false
+   */
+  forceCreate?: boolean;
   /**
    * Pull request branch.
    *

package/dist/plugins/github.js

@@ -39,23 +39,27 @@ function github(options = {}) {
 	function resolvePROptions() {
 		const setting = options.cli?.versionPr ?? isCI();
 		if (setting === false) return [false];
-		return [true, typeof setting === "object" ? setting : {}];
+		if (setting === true) return [true, {}];
+		if (setting.forceCreate || isCI()) return [true, setting];
+		return [false];
 	}
 	function defaultVersionPRBody(draft, context) {
 		const packageLines = [];
 		for (const pkg of context.graph.getPackages()) {
 			const packagePlan = draft.getPackagePlan(pkg.id);
-			if (!packagePlan?.type) continue;
+			if (!packagePlan) continue;
+			const originalVersion = cliOriginalPackageVersions.get(pkg.id) ?? pkg.version;
+			if (originalVersion === pkg.version) continue;
 			const publishTxt = packagePlan.publish ? "" : " (no publish)";
 			const distTagTxt = formatNpmDistTag(packagePlan.npm?.distTag);
-			packageLines.push(`- ${pkg.name}@${cliOriginalPackageVersions.get(pkg.id) ?? pkg.version} → ${pkg.name}@${pkg.version}${distTagTxt}${publishTxt}`);
+			packageLines.push(`- ${pkg.name}@${originalVersion} → ${pkg.name}@${pkg.version}${distTagTxt}${publishTxt}`);
 		}
 		const changelogLines = [];
 		for (const entry of draft.getChangelogs()) {
 			changelogLines.push(`### ${entry.subject ?? `\`${entry.filename}\``}`, "");
 			for (const section of entry.sections) {
 				changelogLines.push(`#### ${section.title}`, "");
-				changelogLines.push(section.content);
+				if (section.content) changelogLines.push(section.content);
 			}
 		}
 		const sections = [

package/dist/providers/cargo.d.ts

@@ -1,2 +1,2 @@
-import { d as CargoRegistryClient, f as cargo, l as CargoPackage, u as CargoPluginOptions } from "../types-BNhcu4-X.js";
+import { d as CargoRegistryClient, f as cargo, l as CargoPackage, u as CargoPluginOptions } from "../types-CrA7ZKxb.js";
 export { CargoPackage, CargoPluginOptions, CargoRegistryClient, cargo };

package/dist/providers/npm.d.ts

@@ -1,2 +1,2 @@
-import { g as npm, h as NpmRegistryClient, m as NpmPluginOptions, p as NpmPackage } from "../types-BNhcu4-X.js";
+import { g as npm, h as NpmRegistryClient, m as NpmPluginOptions, p as NpmPackage } from "../types-CrA7ZKxb.js";
 export { NpmPackage, NpmPluginOptions, NpmRegistryClient, npm };

package/dist/providers/npm.js

@@ -2,7 +2,7 @@ import { r as isNodeError, t as execFailure } from "../error-DBK-9uBa.js";
 import { n as WorkspacePackage } from "../graph-B22NBRUG.js";
 import { i as pnpmWorkspaceSchema, r as packageManifestSchema } from "../schemas-CurBAaW5.js";
 import { readFile, writeFile } from "node:fs/promises";
-import { join } from "node:path";
+import path from "node:path";
 import { x } from "tinyexec";
 import * as semver from "semver";
 import { glob } from "tinyglobby";
@@ -31,7 +31,7 @@ var NpmPackage = class extends WorkspacePackage {
 		return this.manifest.version ?? "0.0.0";
 	}
 	async write() {
-		await writeFile(join(this.path, "package.json"), `${JSON.stringify(this.manifest, null, 2)}\n`);
+		await writeFile(path.join(this.path, "package.json"), `${JSON.stringify(this.manifest, null, 2)}\n`);
 	}
 	onPlan(context) {
 		const defaults = super.onPlan(context);
@@ -96,13 +96,22 @@ function isMissingRegistryEntry(output) {
 	const normalized = output.toLowerCase();
 	return normalized.includes("e404") || normalized.includes("404") || normalized.includes("no match") || normalized.includes("no matching version") || normalized.includes("not found");
 }
-function parseDependencySpec(context, name, range) {
+function parseDependencySpec(context, dependent, name, range) {
 	const { graph } = context;
 	if (range.startsWith("workspace:")) return {
 		range: range.slice(10),
 		linked: graph.get(`npm:${name}`),
 		protocol: "workspace"
 	};
+	if (range.startsWith("file:")) {
+		let target = path.resolve(dependent.path, range.slice(5));
+		if (path.basename(target) === "package.json") target = path.dirname(target);
+		return {
+			protocol: "file",
+			raw: range,
+			linked: graph.getPackages().find((pkg) => pkg instanceof NpmPackage && pkg.path === target)
+		};
+	}
 	if (range.startsWith("npm:")) {
 		const spec = range.slice(4);
 		const separator = spec.lastIndexOf("@");
@@ -122,6 +131,7 @@ function parseDependencySpec(context, name, range) {
 }
 function formatDependencySpec(spec) {
 	if (spec.protocol === "workspace") return `workspace:${spec.range}`;
+	if (spec.protocol === "file") return spec.raw;
 	if (spec.protocol === "npm") return `npm:${spec.alias}@${spec.range}`;
 	return spec.range;
 }
@@ -148,8 +158,9 @@ function npm({ client: defaultClient, onBreakPeerDep = "set", updateLockFile = f
 					case "^":
 					case "~": return !semver.satisfies(target, `${spec.range}${spec.linked.version}`);
 				}
+				if (spec.protocol === "file") return true;
 			}
-			if (!semver.validRange(spec.range)) return false;
+			if (spec.protocol === "file" || !semver.validRange(spec.range)) return false;
 			return !semver.satisfies(target, spec.range);
 		}
 		return {
@@ -162,7 +173,7 @@ function npm({ client: defaultClient, onBreakPeerDep = "set", updateLockFile = f
 						const dependencies = dependent.manifest[field];
 						if (!dependencies) continue;
 						for (const [k, v] of Object.entries(dependencies)) {
-							const spec = parseDependencySpec(context, k, v);
+							const spec = parseDependencySpec(context, dependent, k, v);
 							if (!spec || spec.linked !== pkg) continue;
 							if (!needsUpdate(dependent, spec, plan.bumpVersion(pkg))) continue;
 							const bumpType = getBumpDepType({
@@ -215,9 +226,9 @@ function npm({ client: defaultClient, onBreakPeerDep = "set", updateLockFile = f
 					const dependencies = pkg.manifest[field];
 					if (!dependencies) continue;
 					for (const [k, v] of Object.entries(dependencies)) {
-						const spec = parseDependencySpec(this, k, v);
-						if (!spec || !spec.linked) continue;
-						if (!semver.validRange(spec.range) || spec.protocol === "workspace") continue;
+						const spec = parseDependencySpec(this, pkg, k, v);
+						if (!spec?.linked || spec.protocol === "workspace" || spec.protocol === "file") continue;
+						if (!semver.validRange(spec.range)) continue;
 						if (semver.satisfies(spec.linked.version, spec.range)) continue;
 						let updatedRange;
 						const isPeer = field === "peerDependencies";
@@ -251,7 +262,7 @@ function npm({ client: defaultClient, onBreakPeerDep = "set", updateLockFile = f
 async function discoverNpmPackages(cwd, add) {
 	let patterns;
 	const rootManifest = await readManifest(cwd).catch(() => void 0);
-	const pnpmPatterns = await readFile(join(cwd, "pnpm-workspace.yaml"), "utf8").then((content) => pnpmWorkspaceSchema.parse(load(content) ?? {})).catch((error) => {
+	const pnpmPatterns = await readFile(path.join(cwd, "pnpm-workspace.yaml"), "utf8").then((content) => pnpmWorkspaceSchema.parse(load(content) ?? {})).catch((error) => {
 		if (isNodeError(error) && error.code === "ENOENT") return void 0;
 		throw error;
 	});
@@ -270,16 +281,18 @@ async function discoverNpmPackages(cwd, add) {
 }
 async function expandWorkspacePatterns(cwd, patterns) {
 	if (patterns.length === 0) return [];
-	return glob(patterns, {
+	return (await glob(patterns, {
 		absolute: true,
 		cwd,
 		ignore: ["**/node_modules/**", "**/dist/**"],
 		onlyDirectories: true,
 		onlyFiles: false
+	})).map((item) => {
+		return item.endsWith(path.sep) ? item.slice(0, -1) : item;
 	});
 }
 async function readManifest(packagePath) {
-	const content = await readFile(join(packagePath, "package.json"), "utf8");
+	const content = await readFile(path.join(packagePath, "package.json"), "utf8");
 	const parsed = JSON.parse(content);
 	packageManifestSchema.parse(parsed);
 	return parsed;

package/dist/{types-BNhcu4-X.d.ts → types-CrA7ZKxb.d.ts}

@@ -168,6 +168,7 @@ declare const planStoreSchema: z$1.ZodCodec<z$1.ZodString, z$1.ZodObject<{
       patch: "patch";
     }>>;
     sections: z$1.ZodArray<z$1.ZodObject<{
+      depth: z$1.ZodNumber;
       title: z$1.ZodString;
       content: z$1.ZodString;
     }, z$1.core.$strip>>;
@@ -222,7 +223,7 @@ type PackagePublishResult = ({
   changelogs: ChangelogEntry[];
 };
 //#endregion
-//#region src/changelog/create.d.ts
+//#region src/changelog/generate.d.ts
 interface CreateChangelogOptions {
   /** Start revision. Defaults to the latest reachable git tag, or all history if none exists. */
   from?: string;
@@ -310,9 +311,17 @@ type DependencySpec = {
   range: string;
   linked?: WorkspacePackage;
 } | {
-  protocol?: "workspace";
+  protocol: "workspace";
   range: string;
   linked?: WorkspacePackage;
+} | {
+  protocol: "file";
+  raw: string;
+  linked?: WorkspacePackage;
+} | {
+  range: string;
+  linked?: WorkspacePackage;
+  protocol?: undefined;
 };
 interface NpmPluginOptions {
   /** Package manager command used for npm registry operations. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tegami",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.3",
   "description": "Utility for package versioning & publish",
   "license": "MIT",
   "author": "Fuma Nama",