tegami 0.1.0-beta.1 → 0.1.0-beta.3

package/dist/{checks-CKBRRjgQ.js → checks-BQISvt_o.js}

@@ -1,14 +1,16 @@
 import { n as handlePluginError } from "./error-DBK-9uBa.js";
-import { n as jsonCodec } from "./schemas-Cc4h6bq5.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: z$1.enum([
-		"major",
-		"minor",
-		"patch"
-	]).optional(),
+	type: bumpTypeSchema.optional(),
 	changelogIds: z$1.array(z$1.string()).optional(),
 	bumpReasons: z$1.array(z$1.string()).optional(),
 	npm: z$1.object({ distTag: z$1.string().optional() }).optional(),
@@ -23,14 +25,12 @@ const planStoreSchema = jsonCodec(z$1.object({
 	changelogs: z$1.record(z$1.string(), z$1.object({
 		filename: z$1.string(),
 		subject: z$1.string().optional(),
-		packages: z$1.array(z$1.string()),
-		type: z$1.enum([
-			"major",
-			"minor",
-			"patch"
-		]),
-		title: z$1.string(),
-		content: z$1.string()
+		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()
+		}))
 	})),
 	/** package id -> package info */
 	packages: z$1.record(z$1.string(), packagePlanStoreSchema)
@@ -46,10 +46,8 @@ function createPlanStore(draft, context) {
 	for (const entry of draft.getChangelogs()) store.changelogs[entry.id] = {
 		filename: entry.filename,
 		subject: entry.subject,
-		packages: Array.from(entry.packages),
-		type: entry.type,
-		title: entry.title,
-		content: entry.content
+		packages: Object.fromEntries(entry.packages.entries()),
+		sections: entry.sections
 	};
 	for (const pkg of context.graph.getPackages()) {
 		const plan = draft.getPackagePlan(pkg.id);
@@ -97,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, a as Awaitable, t as Tegami, w as DraftPlan } from "../index-Da6P6gSc.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,10 +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 assertPublishPlanFinished } from "../checks-CKBRRjgQ.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 { confirm, intro, isCancel, multiselect, note, outro, select, spinner, text } from "@clack/prompts";
+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() {
@@ -27,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,
@@ -34,24 +249,47 @@ 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) {
 	const context = await tegami._internal.context();
 	await assertPublishPlanFinished(context);
 	intro("Create changelogs");
-	const packages = context.graph.getPackages();
 	let selectedPackages = [];
-	if (isCI()) selectedPackages = [];
-	else {
-		const selected = await multiselect({
+	if (!isCI()) {
+		const useShortname = /* @__PURE__ */ new Map();
+		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 = [];
+		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,
+			hint: changedPackages.has(pkg) ? "changed" : void 0
+		});
+		const selected = await autocompleteMultiselect({
 			message: "Select packages (leave empty to auto-generate from commits)",
 			required: false,
-			options: packages.map((pkg) => ({
-				value: pkg.id,
-				label: pkg.id,
-				hint: pkg.version
-			}))
+			options: selectOptions
 		});
 		if (isCancel(selected)) throw new CancelledError();
 		selectedPackages = selected;
@@ -95,9 +333,10 @@ async function createChangelogs(tegami, _options) {
 		]
 	});
 	if (isCancel(type)) throw new CancelledError();
-	const message = await text({
-		message: "Change message",
-		placeholder: "Add a concise release note",
+	const message = await multiline({
+		message: "Describe change (Markdown supported, press tab then enter to exit)",
+		placeholder: "The first line is heading\n\nAdditional description.",
+		showSubmit: true,
 		validate(value) {
 			if (!value?.trim()) return "Enter a message.";
 		}
@@ -172,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();
@@ -190,20 +449,18 @@ async function runCleanup(tegami) {
 	outro(`Publish plan at ${planPath} is still pending. Publish it before cleanup.`);
 }
 function renderManualChangelog(packages, type, message) {
-	const heading = "#".repeat(type === "major" ? 1 : type === "minor" ? 2 : 3);
+	const prefix = "#".repeat(bumpDepth(type));
+	const packageMap = {};
+	for (const name of packages) packageMap[name] = type;
 	return [
 		"---",
-		`packages: ${JSON.stringify(packages)}`,
+		dump({ packages: packageMap }).trim(),
 		"---",
 		"",
-		`${heading} ${message}`,
+		`${prefix} ${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 { s as LogGenerator } from "../index-Da6P6gSc.js";
+import { r as LogGenerator } from "../types-CrA7ZKxb.js";
 
 //#region src/generators/simple.d.ts
 declare function simpleGenerator(): LogGenerator;

package/dist/generators/simple.js

@@ -1,17 +1,18 @@
-import { r as formatPackageVersion } from "../semver-mWK2Khi2.js";
+import { i as formatPackageVersion } from "../semver-CPtl0XNq.js";
 //#region src/generators/simple.ts
 function simpleGenerator() {
 	return { generate({ changelogs, version, packageName, plan }) {
-		return [
-			`## ${formatPackageVersion(packageName, version, plan.npm?.distTag)}`,
-			"",
-			...changelogs.flatMap((entry) => [
-				`### ${entry.title}`,
-				"",
-				entry.content,
-				""
-			])
-		].join("\n").trim();
+		const lines = [`## ${formatPackageVersion(packageName, version, plan.npm?.distTag)}`, ""];
+		for (const entry of changelogs) {
+			let sectionDepth = 4;
+			if (entry.subject) lines.push(`### ${entry.subject}`, "");
+			else sectionDepth--;
+			for (const section of entry.sections) {
+				const prefix = "#".repeat(sectionDepth);
+				lines.push(`${prefix} ${section.title}`, "", section.content, "");
+			}
+		}
+		return lines.join("\n").trim();
 	} };
 }
 //#endregion

package/dist/{graph-CUgwuRW5.js → graph-B22NBRUG.js}

@@ -1,4 +1,4 @@
-import { t as bumpVersion } from "./semver-mWK2Khi2.js";
+import { n as bumpVersion } from "./semver-CPtl0XNq.js";
 //#region src/graph.ts
 /** Package discovered in the workspace. */
 var WorkspacePackage = class {

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { C as PublishResult, D as PackageGroup, E as PackageGraph, O as WorkspacePackage, S as PublishOptions, T as PackagePlan, c as PackageOptions, d as TegamiPlugin, f as TegamiPluginOption, i as CreatedChangelog, l as RegistryClient, n as tegami, o as GroupOptions, r as CreateChangelogOptions, s as LogGenerator, t as Tegami, u as TegamiOptions, w as DraftPlan, x as PackagePublishResult } from "./index-Da6P6gSc.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 };