tegami 0.1.1 → 0.1.3

package/dist/cli/index.js

@@ -1,15 +1,206 @@
-import { a as changelogFilename, t as assertPublishPlanFinished } from "../checks-Bz3Rf2OX.js";
-import { n as handlePluginError, t as execFailure } from "../error-BaOQJtvf.js";
-import { n as formatNpmDistTag } from "../semver-mWK2Khi2.js";
+import { r as formatNpmDistTag } from "../semver-cnZp9koa.js";
+import { c as renderChangelog, l as changelogFilename, o as generateReplays, t as assertPublishPlanFinished } from "../checks-Smwtq_Li.js";
+import { n as execFailure, r as handlePluginError, t as CancelledError } from "../error-qpTCB2ld.js";
 import { t as isCI } from "../constants-B9qjNfvr.js";
 import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
-import path, { basename, isAbsolute, join, normalize, relative, resolve } from "node:path";
+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, InvalidArgumentError } from "commander";
 import { tmpdir } from "node:os";
+//#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/changelog.ts
+async function runChangelogTui(tegami) {
+	const context = await tegami._internal.context();
+	await assertPublishPlanFinished(context);
+	intro("Create changelogs");
+	let selectedPackages = [];
+	if (!isCI()) selectedPackages = await promptPackageSelection(context.graph, context.cwd);
+	if (selectedPackages.length === 0) {
+		if (!isCI()) {
+			const confirmed = await confirm({
+				message: "Auto-generate changelog files from commits?",
+				initialValue: true
+			});
+			if (isCancel(confirmed)) throw new CancelledError();
+			if (!confirmed) {
+				outro("No changelogs created.");
+				return;
+			}
+		}
+		await persistChangelogs(context, (await tegami.generateChangelog({ write: false })).map(({ filename, content, packages }) => ({
+			filename,
+			content,
+			packages
+		})), "No matching conventional commits were found.");
+		return;
+	}
+	const packageBumpMap = await promptPackageBumpTypes(selectedPackages);
+	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.";
+		}
+	});
+	if (isCancel(message)) throw new CancelledError();
+	const packages = generateReplays(context.graph, packageBumpMap);
+	await persistChangelogs(context, [{
+		filename: changelogFilename(),
+		content: renderChangelog({ packages }, `## ${message.trim()}`),
+		packages
+	}]);
+}
+async function persistChangelogs(context, entries, emptyMessage = "No changelogs created.") {
+	const s = spinner();
+	s.start("Creating changelog");
+	await mkdir(context.changelogDir, { recursive: true });
+	await Promise.all(entries.map(({ filename, content }) => writeFile(join(context.changelogDir, filename), content)));
+	s.stop(entries.length === 1 ? "Created 1 changelog file" : entries.length > 0 ? `Created ${entries.length} changelog files` : "No changelogs created");
+	if (entries.length === 0) note(emptyMessage, "No changelogs created");
+	else {
+		const lines = [];
+		for (const { filename, packages } of entries) {
+			lines.push(filename);
+			for (const [name, config] of Object.entries(packages)) {
+				if (typeof config === "string") {
+					lines.push(`${name}: ${config}`);
+					continue;
+				}
+				if (config.replay?.length) {
+					lines.push(`${name}: ${config.type} (replay on ${config.replay.join(" or ")})`);
+					continue;
+				}
+				lines.push(`${name}: ${config.type}`);
+			}
+		}
+		note(lines.join("\n"), "Created changelogs");
+	}
+	outro(entries.length === 1 ? "Changelog ready." : "Changelogs ready.");
+}
+async function promptPackageSelection(graph, cwd) {
+	const useShortname = /* @__PURE__ */ new Map();
+	for (const pkg of 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(graph, cwd));
+	const selectOptions = [];
+	const groups = [];
+	for (const group of 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 = 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: selectOptions
+	});
+	if (isCancel(selected)) throw new CancelledError();
+	return selected;
+}
+async function promptPackageBumpTypes(selectedPackages) {
+	const packageBumpMap = {};
+	const bumpType = await select({
+		message: "Select release type",
+		options: [
+			{
+				value: "patch",
+				label: "patch"
+			},
+			{
+				value: "minor",
+				label: "minor"
+			},
+			{
+				value: "major",
+				label: "major"
+			},
+			{
+				value: "per-package",
+				label: "choose per-package"
+			}
+		]
+	});
+	if (isCancel(bumpType)) throw new CancelledError();
+	if (bumpType === "per-package") for (const pkg of selectedPackages) {
+		const selectedBump = await select({
+			message: `Select release type for "${pkg}"`,
+			options: [
+				{
+					value: "patch",
+					label: "patch"
+				},
+				{
+					value: "minor",
+					label: "minor"
+				},
+				{
+					value: "major",
+					label: "major"
+				}
+			]
+		});
+		if (isCancel(selectedBump)) throw new CancelledError();
+		packageBumpMap[pkg] = selectedBump;
+	}
+	else for (const pkg of selectedPackages) packageBumpMap[pkg] = bumpType;
+	return packageBumpMap;
+}
+//#endregion
 //#region src/cli/init-agent.ts
 const CHANGELOG_DOCS_URL$1 = "https://tegami.fuma-nama.dev/changelog";
 async function initAgent(context, options = {}) {
@@ -101,10 +292,10 @@ async function buildPrPreview(context, draft, options = {}) {
 	const pendingPackages = [];
 	for (const pkg of context.graph.getPackages()) {
 		const plan = draft.getPackagePlan(pkg.id);
-		if (!plan?.type) continue;
+		if (!plan || plan.bumpVersion(pkg) === pkg.version) continue;
 		pendingPackages.push({
 			name: pkg.name,
-			type: plan.type,
+			type: plan.type ?? "—",
 			from: pkg.version,
 			to: plan.bumpVersion(pkg),
 			distTag: plan.npm?.distTag,
@@ -271,59 +462,12 @@ function createChangelogUrl(context, repo, branch, filename) {
 	return `https://github.com/${repo}/new/${branch.split("/").map(encodeURIComponent).join("/")}?${new URLSearchParams({ filename: filePath })}`;
 }
 //#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() {
-		super("Cancelled.");
-	}
-};
 function createCli(tegami, options = {}) {
 	const program = new Command();
-	program.name("tegami").description("create changelogs").action((commandOptions) => runAction(tegami, () => createChangelogs(tegami, {
-		...commandOptions,
-		cli: options
-	})));
-	program.command("version").description("draft and apply a publish plan").action((commandOptions) => runAction(tegami, async () => {
-		await versionPackages(tegami, {
-			...commandOptions,
-			cli: options
-		});
+	program.name("tegami").description("create changelogs").action(() => runAction(tegami, () => runChangelogTui(tegami)));
+	program.command("version").description("draft and apply a publish plan").action(() => runAction(tegami, async () => {
+		await versionPackages(tegami, { cli: options });
 	}));
 	program.command("ci").description("version and publish packages").action(() => runAction(tegami, async () => {
 		if (await versionPackages(tegami, { cli: options })) return;
@@ -338,10 +482,10 @@ function createCli(tegami, options = {}) {
 		const context = await tegami._internal.context();
 		const body = await buildPrPreview(context, await tegami.draft(), commandOptions);
 		if (commandOptions.artifact) {
-			const artifactPath = resolve(context.cwd, commandOptions.artifact);
+			const artifactPath = path.resolve(context.cwd, commandOptions.artifact);
 			await writeFile(artifactPath, body);
 			if (!isCI()) {
-				note(relative(context.cwd, artifactPath) || commandOptions.artifact, "Release preview");
+				note(path.relative(context.cwd, artifactPath) || commandOptions.artifact, "Release preview");
 				outro("Release preview ready.");
 			}
 			return;
@@ -373,134 +517,6 @@ function createCli(tegami, options = {}) {
 	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");
-	let selectedPackages = [];
-	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: selectOptions
-		});
-		if (isCancel(selected)) throw new CancelledError();
-		selectedPackages = selected;
-	}
-	if (selectedPackages.length === 0) {
-		if (!isCI()) {
-			const confirmed = await confirm({
-				message: "Auto-generate changelog files from commits?",
-				initialValue: true
-			});
-			if (isCancel(confirmed)) throw new CancelledError();
-			if (!confirmed) {
-				outro("No changelogs created.");
-				return;
-			}
-		}
-		const s = spinner();
-		s.start("Reading commits and creating changelogs");
-		const created = await tegami.generateChangelog();
-		s.stop(created.length === 1 ? "Created 1 changelog file" : `Created ${created.length} changelog files`);
-		if (created.length === 0) note("No matching conventional commits were found.", "No changelogs created");
-		else note(created.map((entry) => `${entry.filename} (${entry.changes} changes)`).join("\n"), "Created changelogs");
-		outro("Changelogs ready.");
-		return;
-	}
-	const packageBumpMap = {};
-	const bumpType = await select({
-		message: "Select release type",
-		options: [
-			{
-				value: "patch",
-				label: "patch"
-			},
-			{
-				value: "minor",
-				label: "minor"
-			},
-			{
-				value: "major",
-				label: "major"
-			},
-			{
-				value: "per-package",
-				label: "choose per-package"
-			}
-		]
-	});
-	if (isCancel(bumpType)) throw new CancelledError();
-	if (bumpType === "per-package") for (const pkg of selectedPackages) {
-		const bumpType = await select({
-			message: `Select release type for "${pkg}"`,
-			options: [
-				{
-					value: "patch",
-					label: "patch"
-				},
-				{
-					value: "minor",
-					label: "minor"
-				},
-				{
-					value: "major",
-					label: "major"
-				}
-			]
-		});
-		if (isCancel(bumpType)) throw new CancelledError();
-		packageBumpMap[pkg] = bumpType;
-	}
-	else for (const pkg of selectedPackages) packageBumpMap[pkg] = bumpType;
-	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.";
-		}
-	});
-	if (isCancel(message)) throw new CancelledError();
-	const filename = changelogFilename();
-	const s = spinner();
-	s.start("Creating changelog");
-	await mkdir(context.changelogDir, { recursive: true });
-	await writeFile(join(context.changelogDir, filename), renderManualChangelog(packageBumpMap, message.trim()));
-	s.stop("Created changelog file");
-	const notes = [filename];
-	for (const pkg of selectedPackages) notes.push(`${pkg}: ${packageBumpMap[pkg]}`);
-	note(notes.join("\n"), "Created changelog");
-	outro("Changelog ready.");
-}
 async function versionPackages(tegami, options) {
 	intro("Version Packages");
 	const { version: customVersion } = options.cli;
@@ -509,15 +525,15 @@ async function versionPackages(tegami, options) {
 	if (!draft.canApply()) throw new Error(`The draft plan from custom "version" hook must not be applied`);
 	for (const plugin of context.plugins) await handlePluginError(plugin, "cli.publishPlanCreated", () => plugin.cli?.publishPlanCreated?.call(context, draft));
 	if (!draft.hasPending()) {
-		note("No pending changelog entries matched workspace packages.", "Nothing to version");
+		note("No pending version changes matched workspace packages.", "Nothing to version");
 		outro("No versions changed.");
 		return false;
 	}
 	const planEntries = [];
 	for (const pkg of context.graph.getPackages()) {
 		const plan = draft.getPackagePlan(pkg.id);
-		if (!plan?.type) continue;
-		planEntries.push(`${pkg.id}: ${plan.type} (${plan.changelogs?.length ?? 0} changelogs)`);
+		if (!plan || plan.bumpVersion(pkg) === pkg.version) continue;
+		planEntries.push(`${pkg.id}: ${pkg.version} → ${plan.bumpVersion(pkg)} (${plan.changelogs?.length ?? 0} changelogs)`);
 		if (plan.bumpReasons) for (const reason of plan.bumpReasons) planEntries.push(`  - ${reason}`);
 	}
 	note(planEntries.join("\n"), "Release plan");
@@ -568,7 +584,7 @@ async function runInitAgent(tegami, options) {
 	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");
+	note(path.relative(context.cwd, result.path) || "AGENTS.md", "Agent instructions");
 	outro("Agents can follow AGENTS.md to write changelogs.");
 }
 async function runCleanup(tegami) {
@@ -588,16 +604,6 @@ async function runCleanup(tegami) {
 	}
 	outro(`Publish plan at ${planPath} is still pending. Publish it before cleanup.`);
 }
-function renderManualChangelog(packageBumpMap, message) {
-	return [
-		"---",
-		dump({ packages: packageBumpMap }).trim(),
-		"---",
-		"",
-		`## ${message}`,
-		""
-	].join("\n");
-}
 async function runAction(tegami, action) {
 	try {
 		const context = await tegami._internal.context();

package/dist/{error-BaOQJtvf.js → error-qpTCB2ld.js}

@@ -1,4 +1,9 @@
 //#region src/utils/error.ts
+var CancelledError = class extends Error {
+	constructor() {
+		super("Cancelled.");
+	}
+};
 function execFailure(context, result) {
 	const lines = [context, `(exit ${result.exitCode})`];
 	const out = result.stdout.trim();
@@ -19,4 +24,4 @@ async function handlePluginError(plugin, hookName, callback) {
 	}
 }
 //#endregion
-export { handlePluginError as n, isNodeError as r, execFailure as t };
+export { isNodeError as i, execFailure as n, handlePluginError as r, CancelledError as t };

package/dist/generators/simple.d.ts

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

package/dist/generators/simple.js

@@ -1,4 +1,4 @@
-import { r as formatPackageVersion } from "../semver-mWK2Khi2.js";
+import { i as formatPackageVersion } from "../semver-cnZp9koa.js";
 //#region src/generators/simple.ts
 function simpleGenerator() {
 	return { generate({ changelogs, version, packageName, plan }) {

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

@@ -1,4 +1,4 @@
-import { t as bumpVersion } from "./semver-mWK2Khi2.js";
+import { n as bumpVersion } from "./semver-cnZp9koa.js";
 //#region src/graph.ts
 /** Package discovered in the workspace. */
 var WorkspacePackage = class {
@@ -13,17 +13,21 @@ var WorkspacePackage = class {
 	setPackageOptions(options) {
 		this.opts = options;
 	}
-	/** create an empty draft plan. */
-	onPlan(_context) {
+	/** create the initial draft plan. */
+	initPlan() {
+		return { bumpVersion(pkg) {
+			return bumpVersion(pkg.version, this.type, this.prerelease);
+		} };
+	}
+	/** configure an initial draft plan to match script-level configs. */
+	configurePlan(plan) {
 		const { publish, prerelease, npm } = this.opts;
-		return {
-			publish,
-			prerelease,
-			npm: npm ? { distTag: npm.distTag } : void 0,
-			bumpVersion(pkg) {
-				return bumpVersion(pkg.version, this.type, this.prerelease);
-			}
-		};
+		if (publish !== void 0) plan.publish = publish;
+		if (prerelease !== void 0) plan.prerelease = prerelease;
+		if (npm?.distTag) {
+			plan.npm ??= {};
+			plan.npm.distTag = npm.distTag;
+		}
 	}
 };
 /** Dependency graph for discovered workspace packages. */

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { A as PackagePlan, C as PublishOptions, D as PackageGroup, E as PackageGraph, O as WorkspacePackage, S as PackagePublishResult, a as PublishPreflight, b as CreateChangelogOptions, c as TegamiPlugin, i as PackageOptions, k as DraftPlan, l as TegamiPluginOption, n as GroupOptions, o as RegistryClient, r as LogGenerator, s as TegamiOptions, v as Tegami, w as PublishResult, x as CreatedChangelog, y as tegami } from "./types-Diwnh8Tn.js";
+import { A as PackagePlan, C as PublishOptions, D as PackageGroup, E as PackageGraph, O as WorkspacePackage, S as PackagePublishResult, a as PublishPreflight, b as CreateChangelogOptions, c as TegamiPlugin, i as PackageOptions, k as DraftPlan, l as TegamiPluginOption, n as GroupOptions, o as RegistryClient, r as LogGenerator, s as TegamiOptions, v as Tegami, w as PublishResult, x as CreatedChangelog, y as tegami } from "./types-Di--A9X1.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 PublishPreflight, type PublishResult, type RegistryClient, Tegami, type TegamiOptions, type TegamiPlugin, type TegamiPluginOption, type WorkspacePackage, tegami };