pnpm-settings-migrator 0.9.0 → 0.10.0

package/dist/cli.mjs

@@ -1,14 +1,13 @@
 import process from "node:process";
-import consola$1, { consola } from "consola";
 import { cac } from "cac";
-import { basename, dirname, join, relative, resolve } from "pathe";
-import camelcaseKeys from "camelcase-keys";
 import { randomUUID } from "node:crypto";
 import { access, chmod, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
+import { basename, dirname, join, relative, resolve } from "pathe";
 import { getColor } from "consola/utils";
 import { isPlainObject, isUndefined } from "@ntnyq/utils";
 import { defu } from "defu";
+import camelcaseKeys from "camelcase-keys";
 import { readIniFile } from "read-ini-file";
 import { kebabCase } from "uncase";
 import { glob } from "tinyglobby";
@@ -17,7 +16,7 @@ import { Document, isMap, isNode, isScalar, isSeq, parseDocument, stringify } fr
 import { isDeepStrictEqual } from "node:util";
 //#region package.json
 var name = "pnpm-settings-migrator";
-var version = "0.9.0";
+var version = "0.10.0";
 //#endregion
 //#region src/cli-options.ts
 /**
@@ -26,7 +25,7 @@ var version = "0.9.0";
 * @returns Configured command-line parser
 */
 function createCli() {
-	const cli = cac(name).version(version).option("--cwd <cwd>", "Current working directory").option("--sort-keys", "Sort keys when write pnpm-workspace.yaml").option("--compatibility <compatibility>", "Compatibility target (auto, v10, v11, v12)").option("--replace-deprecated", "Replace deprecated pnpm settings with new ones and remove old keys").option("--strategy <strategy>", "Strategy to handle conflicts (discard, merge, overwrite)").option("--no-yarn-resolutions", "Disable migrating resolutions field in package.json").option("--no-newline-between", "Disable adding newlines between each root keys").option("--no-show-changes", "Disable showing settings changes").option("--no-clean-npmrc", "Disable removing pnpm settings in .npmrc file").option("--no-clean-package-json", "Disable removing pnpm fields in package.json");
+	const cli = cac(name).version(version).option("--cwd <cwd>", "Current working directory").option("--sort-keys", "Sort keys when write pnpm-workspace.yaml").option("--compatibility <compatibility>", "Compatibility target (auto, v10, v11, v12)").option("--replace-deprecated", "Replace deprecated pnpm settings with new ones and remove old keys").option("--strategy <strategy>", "Strategy to handle conflicts (discard, merge, overwrite)").option("--no-yarn-resolutions", "Disable migrating resolutions field in package.json").option("--no-newline-between", "Disable adding newlines between each root keys").option("--no-show-changes", "Hide settings diff (keep summary and warnings)").option("--no-clean-npmrc", "Disable removing pnpm settings in .npmrc file").option("--no-clean-package-json", "Disable removing pnpm fields in package.json");
 	cli.help((sections) => {
 		if (!(cli.commands.length > 0 && cli.commands.every((command) => command.isDefaultCommand))) return sections;
 		return sections.filter((section) => section.title !== "Commands" && !section.title?.startsWith("For more info"));
@@ -34,6 +33,139 @@ function createCli() {
 	return cli;
 }
 //#endregion
+//#region src/utils/fs.ts
+/**
+* Modulus that isolates Unix permission bits from a stat mode.
+*/
+const FILE_PERMISSION_MODULUS = 512;
+/**
+* Resolve a filesystem path to a string suitable for a sibling temp file.
+*
+* @param path - Filesystem path to normalize
+*
+* @returns String path suitable for path manipulation
+*/
+function resolvePathString(path) {
+	if (path instanceof URL) return fileURLToPath(path);
+	return typeof path === "string" ? path : path.toString();
+}
+/**
+* Read an existing file's permission bits, if the file exists.
+*
+* @param path - Filesystem path to inspect
+*
+* @returns Unix permission bits, or `undefined` when the file does not exist
+*/
+async function resolveExistingMode(path) {
+	try {
+		return (await stat(path)).mode % FILE_PERMISSION_MODULUS;
+	} catch (error) {
+		if (error.code === "ENOENT") return;
+		throw error;
+	}
+}
+/**
+* Check whether a filesystem path exists.
+*
+* @param path - Filesystem path to check
+*
+* @returns `true` when the path is accessible, otherwise `false`
+*/
+async function fsExists(path) {
+	return access(path).then(() => true).catch(() => false);
+}
+/**
+* Read a UTF-8 text file.
+*
+* @param path - Filesystem path to read
+*
+* @returns Text content of the file
+*/
+async function fsReadFile(path) {
+	return await readFile(path, "utf-8");
+}
+/**
+* Remove a file if it exists.
+*
+* @param path - Filesystem path to remove
+*
+* @returns A promise that resolves after the file is removed
+*/
+async function fsRemoveFile(path) {
+	await rm(path, { force: true });
+}
+/**
+* Write a normalized UTF-8 text file with one trailing newline.
+*
+* @param path - Filesystem path to write
+* @param content - Text content to write
+*
+* @returns A promise that resolves after the file is written
+*/
+async function fsWriteFile(path, content) {
+	const pathString = resolvePathString(path);
+	const temporaryPath = join(dirname(pathString), `.${basename(pathString)}.${process.pid}.${randomUUID()}.tmp`);
+	const mode = await resolveExistingMode(path);
+	try {
+		await writeFile(temporaryPath, `${content.trimEnd()}\n`, {
+			encoding: "utf-8",
+			mode
+		});
+		if (mode !== void 0) await chmod(temporaryPath, mode);
+		await rename(temporaryPath, pathString);
+	} finally {
+		await rm(temporaryPath, { force: true });
+	}
+}
+/**
+* Write a normalized text file only when its contents differ or it is missing.
+*
+* @param path - Destination file path
+* @param content - Text content to normalize and write
+*
+* @returns Whether the destination file was created or changed
+*/
+async function fsWriteFileIfChanged(path, content) {
+	if (await fsExists(path) && await fsReadFile(path) === `${content.trimEnd()}\n`) return false;
+	await fsWriteFile(path, content);
+	return true;
+}
+//#endregion
+//#region src/utils/color.ts
+/**
+* Apply dim terminal styling to a value.
+*
+* @param text - Text or number to style
+*
+* @returns ANSI-styled string
+*/
+const dim = getColor("dim");
+/**
+* Apply green terminal styling to a value.
+*
+* @param text - Text or number to style
+*
+* @returns ANSI-styled string
+*/
+const green = getColor("green");
+/**
+* Apply red terminal styling to a value.
+*
+* @param text - Text or number to style
+*
+* @returns ANSI-styled string
+*/
+const red = getColor("red");
+/**
+* Apply bold terminal styling to a value.
+*
+* @param text - Text or number to style
+*
+* @returns ANSI-styled string
+*/
+const bold = getColor("bold");
+getColor("magenta");
+//#endregion
 //#region src/constants.ts
 const NPMRC = ".npmrc";
 const PACKAGE_JSON = "package.json";
@@ -205,133 +337,6 @@ const PNPM_V11_REMOVED_SETTINGS = [
 	"useNodeVersion"
 ];
 //#endregion
-//#region src/utils/fs.ts
-/**
-* Modulus that isolates Unix permission bits from a stat mode.
-*/
-const FILE_PERMISSION_MODULUS = 512;
-/**
-* Resolve a filesystem path to a string suitable for a sibling temp file.
-*
-* @param path - Filesystem path to normalize
-*
-* @returns String path suitable for path manipulation
-*/
-function resolvePathString(path) {
-	if (path instanceof URL) return fileURLToPath(path);
-	return typeof path === "string" ? path : path.toString();
-}
-/**
-* Read an existing file's permission bits, if the file exists.
-*
-* @param path - Filesystem path to inspect
-*
-* @returns Unix permission bits, or `undefined` when the file does not exist
-*/
-async function resolveExistingMode(path) {
-	try {
-		return (await stat(path)).mode % FILE_PERMISSION_MODULUS;
-	} catch (error) {
-		if (error.code === "ENOENT") return;
-		throw error;
-	}
-}
-/**
-* Check whether a filesystem path exists.
-*
-* @param path - Filesystem path to check
-*
-* @returns `true` when the path is accessible, otherwise `false`
-*/
-async function fsExists(path) {
-	return access(path).then(() => true).catch(() => false);
-}
-/**
-* Read a UTF-8 text file.
-*
-* @param path - Filesystem path to read
-*
-* @returns Text content of the file
-*/
-async function fsReadFile(path) {
-	return await readFile(path, "utf-8");
-}
-/**
-* Remove a file if it exists.
-*
-* @param path - Filesystem path to remove
-*
-* @returns A promise that resolves after the file is removed
-*/
-async function fsRemoveFile(path) {
-	await rm(path, { force: true });
-}
-/**
-* Write a normalized UTF-8 text file with one trailing newline.
-*
-* @param path - Filesystem path to write
-* @param content - Text content to write
-*
-* @returns A promise that resolves after the file is written
-*/
-async function fsWriteFile(path, content) {
-	const pathString = resolvePathString(path);
-	const temporaryPath = join(dirname(pathString), `.${basename(pathString)}.${process.pid}.${randomUUID()}.tmp`);
-	const mode = await resolveExistingMode(path);
-	try {
-		await writeFile(temporaryPath, `${content.trimEnd()}\n`, {
-			encoding: "utf-8",
-			mode
-		});
-		if (mode !== void 0) await chmod(temporaryPath, mode);
-		await rename(temporaryPath, pathString);
-	} finally {
-		await rm(temporaryPath, { force: true });
-	}
-}
-//#endregion
-//#region src/utils/color.ts
-/**
-* Apply dim terminal styling to a value.
-*
-* @param text - Text or number to style
-*
-* @returns ANSI-styled string
-*/
-const dim = getColor("dim");
-/**
-* Apply green terminal styling to a value.
-*
-* @param text - Text or number to style
-*
-* @returns ANSI-styled string
-*/
-const green = getColor("green");
-/**
-* Apply red terminal styling to a value.
-*
-* @param text - Text or number to style
-*
-* @returns ANSI-styled string
-*/
-const red = getColor("red");
-/**
-* Apply bold terminal styling to a value.
-*
-* @param text - Text or number to style
-*
-* @returns ANSI-styled string
-*/
-const bold = getColor("bold");
-/**
-* Apply magenta terminal styling to a value.
-*
-* @param text - Text or number to style
-*
-* @returns ANSI-styled string
-*/
-const magenta = getColor("magenta");
-//#endregion
 //#region src/utils/deprecated-settings.ts
 /**
 * Replace deprecated audit fields with the structured `audit` setting.
@@ -1408,6 +1413,29 @@ function resolvePackageJsonSettings(packageJson, yarnResolutions, compatibility)
 		yarnResolutions: migrateYarnResolutions
 	};
 }
+/**
+* Remove only legacy package settings already applied to their destination.
+*
+* @param options - Parsed manifest, applied source keys, and resolutions status
+*
+* @returns Whether legacy settings were removed from the manifest
+*/
+function cleanPackageJsonSettings(options) {
+	const { migratedKeys, packageJson, settings, yarnResolutionsApplied } = options;
+	let changed = false;
+	if (packageJson.value.pnpm) {
+		for (const key of migratedKeys) {
+			Reflect.deleteProperty(packageJson.value.pnpm, key);
+			changed = true;
+		}
+		if (!Object.keys(packageJson.value.pnpm).length) delete packageJson.value.pnpm;
+	}
+	if (settings.yarnResolutions && yarnResolutionsApplied) {
+		changed = true;
+		delete packageJson.value.resolutions;
+	}
+	return changed;
+}
 //#endregion
 //#region src/utils/project-npmrc.ts
 function resolvePackageJsonPatterns(patterns) {
@@ -1668,20 +1696,18 @@ function createSettingsDiffLines(change) {
 	}));
 }
 /**
-* Print a summary and GitHub-style YAML diff for every changed setting.
+* Format a colored YAML diff, with one blank line between changed settings.
 *
-* @param changes - Root setting changes to report
+* @param changes - Root setting changes to format
 *
-* @returns Nothing; output is written through consola
+* @returns Diff text without leading or trailing blank lines
 */
-function reportSettingsChanges(changes) {
-	consola$1.info(`${changes.length} ${changes.length === 1 ? "setting" : "settings"} changed`);
-	for (const [index, change] of changes.entries()) {
-		if (index > 0) consola$1.log("");
-		for (const line of createSettingsDiffLines(change)) if (line.kind === "added") consola$1.log(green(`+ ${line.value}`));
-		else if (line.kind === "removed") consola$1.log(red(`- ${line.value}`));
-		else consola$1.log(dim(`  ${line.value}`));
-	}
+function formatSettingsChanges(changes) {
+	return changes.map((change) => createSettingsDiffLines(change).map((line) => {
+		if (line.kind === "added") return green(`+ ${line.value}`);
+		if (line.kind === "removed") return red(`- ${line.value}`);
+		return dim(`  ${line.value}`);
+	}).join("\n")).join("\n\n");
 }
 //#endregion
 //#region src/utils/settings-issue-report.ts
@@ -1689,23 +1715,25 @@ function formatIssueKeys(keys) {
 	return keys.map((key) => JSON.stringify(key)).join(", ");
 }
 /**
-* Report settings that were intentionally left in their source.
+* Format warnings for settings that were intentionally left in their source.
 *
 * @param options - Retained settings and destination context
 *
-* @returns Nothing; warnings are written through consola
+* @returns Warning messages in issue-category order
 */
-function reportSettingsIssues(options) {
+function formatSettingsIssues(options) {
 	const { compatibility, issues, projectConfig = false, source } = options;
-	if (issues.refused.length) consola$1.warn(`Kept project-refused settings in ${source}: ${formatIssueKeys(issues.refused)}. Configure machine settings globally and current-run paths on the command line.`);
-	if (issues.incompatible.length) consola$1.warn(`Kept settings in ${source} that are incompatible with pnpm ${compatibility.slice(1)}: ${formatIssueKeys(issues.incompatible)}.`);
-	if (issues.nonCamelCase.length) consola$1.warn(`Kept non-camelCase settings in ${source}: ${formatIssueKeys(issues.nonCamelCase)}. Workspace manifest keys must use camelCase.`);
-	if (issues.unknown.length) consola$1.warn(`Kept settings in ${source} that pnpm ${compatibility.slice(1)} does not recognize: ${formatIssueKeys(issues.unknown)}.`);
+	const warnings = [];
+	if (issues.refused.length) warnings.push(`Kept project-refused settings in ${source}: ${formatIssueKeys(issues.refused)}. Configure machine settings globally and current-run paths on the command line.`);
+	if (issues.incompatible.length) warnings.push(`Kept settings in ${source} that are incompatible with pnpm ${compatibility.slice(1)}: ${formatIssueKeys(issues.incompatible)}.`);
+	if (issues.nonCamelCase.length) warnings.push(`Kept non-camelCase settings in ${source}: ${formatIssueKeys(issues.nonCamelCase)}. Workspace manifest keys must use camelCase.`);
+	if (issues.unknown.length) warnings.push(`Kept settings in ${source} that pnpm ${compatibility.slice(1)} does not recognize: ${formatIssueKeys(issues.unknown)}.`);
 	if (issues.unsupported.length) {
 		const destination = projectConfig && compatibility === "v12" ? "pnpm v12 does not support packageConfigs" : "packageConfigs only accepts hoist, modulesDir, overrides, saveExact, and savePrefix";
-		consola$1.warn(`Kept subproject settings in ${source}: ${formatIssueKeys(issues.unsupported)}; ${destination}.`);
+		warnings.push(`Kept subproject settings in ${source}: ${formatIssueKeys(issues.unsupported)}; ${destination}.`);
 	}
-	if (issues.unsafe.length) consola$1.warn(`Kept unsafe registry settings in ${source}: ${formatIssueKeys(issues.unsafe)}. Remove credentials and dynamic URL interpolation before migrating them.`);
+	if (issues.unsafe.length) warnings.push(`Kept unsafe registry settings in ${source}: ${formatIssueKeys(issues.unsafe)}. Remove credentials and dynamic URL interpolation before migrating them.`);
+	return warnings;
 }
 //#endregion
 //#region src/utils/yaml-document.ts
@@ -1753,6 +1781,32 @@ function formatRootSpacing(content, newlineBetween) {
 	return content.replace(/\n+(?=[^\s#][^:\n]*:)/gu, newlineBetween ? "\n\n" : "\n");
 }
 //#endregion
+//#region src/cli-output.ts
+function formatMigrationSummary(result) {
+	if (!result.hasConfigurationFiles) return "ℹ No configuration files found.";
+	const count = result.settingsChanges.length;
+	if (count) return `${green("✔")} ${count} ${count === 1 ? "setting" : "settings"} changed`;
+	if (result.packageJsonRuntimeChanged) return `${green("✔")} Migration completed. Node.js runtime updated in package.json.`;
+	if (result.sourceSettingsCleaned) return `${green("✔")} Migration completed. Source settings cleaned up.`;
+	if (result.changedFiles.length) return `${green("✔")} Migration completed. Configuration files updated.`;
+	return "ℹ No changes needed.";
+}
+/**
+* Format warnings, one outcome summary, and optional settings details.
+*
+* @param result - Completed migration outcome
+* @param showChanges - Whether to include the settings diff
+*
+* @returns Terminal output with one blank line between blocks and none at its edges
+*/
+function formatMigrationOutput(result, showChanges = true) {
+	const blocks = [];
+	if (result.warnings.length) blocks.push(result.warnings.map((warning) => `${bold("WARN")} ${warning}`).join("\n"));
+	blocks.push(formatMigrationSummary(result));
+	if (showChanges && result.settingsChanges.length) blocks.push(formatSettingsChanges(result.settingsChanges));
+	return blocks.join("\n\n");
+}
+//#endregion
 //#region src/migration-persistence.ts
 const SETTINGS_WITHOUT_REPLACEMENT = /* @__PURE__ */ new Set(["ignoreDepScripts", "ignorePatchFailures"]);
 const REPLACEMENT_SETTING_KEYS = {
@@ -1773,21 +1827,6 @@ const REPLACEMENT_SETTING_KEYS = {
 	sideEffectsCacheReadonly: "sideEffectsCache",
 	updateConfig: "update"
 };
-function cleanPackageJsonSettings({ migratedKeys, packageJson, settings, yarnResolutionsApplied }) {
-	let changed = false;
-	if (packageJson.value.pnpm) {
-		for (const key of migratedKeys) {
-			Reflect.deleteProperty(packageJson.value.pnpm, key);
-			changed = true;
-		}
-		if (!Object.keys(packageJson.value.pnpm).length) delete packageJson.value.pnpm;
-	}
-	if (settings.yarnResolutions && yarnResolutionsApplied) {
-		changed = true;
-		delete packageJson.value.resolutions;
-	}
-	return changed;
-}
 function containsMigratedValue(actual, expected) {
 	if (Array.isArray(actual) && Array.isArray(expected)) return expected.every((expectedItem) => actual.some((actualItem) => containsMigratedValue(actualItem, expectedItem)));
 	if (actual && expected && typeof actual === "object" && typeof expected === "object") return Object.entries(expected).every(([key, expectedValue]) => containsMigratedValue(actual[key], expectedValue));
@@ -1838,7 +1877,7 @@ function selectAppliedProjectKeys(project, finalSettings) {
 *
 * @param options - Destination files, selected sources, and cleanup policy
 *
-* @returns A promise that resolves after destinations and sources are persisted
+* @returns Changed file paths and applied cleanup/runtime changes
 */
 async function persistMigration(options) {
 	const { cleanNpmrc, cleanPackageJson, compatibility, finalSettings, incomingSettings, npmrc, npmrcExists, npmrcPath, packageJson, packageJsonExists, packageJsonPath, packageJsonRuntimeChanged, packageJsonSettings, pnpmWorkspaceContent, pnpmWorkspacePath, projectNpmrcs, runtimeVersion } = options;
@@ -1866,20 +1905,31 @@ async function persistMigration(options) {
 		settings: packageJsonSettings,
 		yarnResolutionsApplied
 	}) : false;
-	await fsWriteFile(pnpmWorkspacePath, pnpmWorkspaceContent);
-	if (packageJsonExists && (packageJsonRuntimeChanged || packageJsonSettingsChanged)) await fsWriteFile(packageJsonPath, JSON.stringify(packageJson.value, null, packageJson.indent));
-	if (!cleanNpmrc) return;
+	const result = {
+		changedFiles: [],
+		sourceSettingsCleaned: packageJsonSettingsChanged,
+		packageJsonRuntimeChanged
+	};
+	if (await fsWriteFileIfChanged(pnpmWorkspacePath, pnpmWorkspaceContent)) result.changedFiles.push(pnpmWorkspacePath);
+	if (packageJsonExists && (packageJsonRuntimeChanged || packageJsonSettingsChanged)) {
+		await fsWriteFileIfChanged(packageJsonPath, JSON.stringify(packageJson.value, null, packageJson.indent));
+		result.changedFiles.push(packageJsonPath);
+	}
+	if (!cleanNpmrc) return result;
 	const pruneTasks = projectNpmrcs.projects.flatMap((project) => {
 		const appliedKeys = selectAppliedProjectKeys(project, finalSettings);
-		return appliedKeys.length ? [pruneNpmrc(project.npmrcPath, compatibility, appliedKeys)] : [];
+		return appliedKeys.length ? [pruneNpmrc(project.npmrcPath, compatibility, appliedKeys).then(() => project.npmrcPath)] : [];
 	});
-	if (npmrcExists && appliedNpmrcKeys.length) pruneTasks.push(pruneNpmrc(npmrcPath, compatibility, appliedNpmrcKeys));
-	await Promise.all(pruneTasks);
+	if (npmrcExists && appliedNpmrcKeys.length) pruneTasks.push(pruneNpmrc(npmrcPath, compatibility, appliedNpmrcKeys).then(() => npmrcPath));
+	const cleanedNpmrcPaths = await Promise.all(pruneTasks);
+	result.changedFiles.push(...cleanedNpmrcPaths);
+	result.sourceSettingsCleaned ||= cleanedNpmrcPaths.length > 0;
+	return result;
 }
 //#endregion
 //#region src/migration-sources.ts
 /**
-* Read, schema-filter, report, and merge all legacy settings sources.
+* Read, schema-filter, and merge legacy settings while collecting warnings.
 *
 * @param options - Migration target and source configuration
 *
@@ -1887,32 +1937,34 @@ async function persistMigration(options) {
 */
 async function resolveMigrationSources(options) {
 	const { compatibility, cwd, npmrcExists, npmrcPath, packageJson, pnpmWorkspace, strategy, yarnResolutions } = options;
+	const warnings = [];
 	const npmrc = npmrcExists ? await readMigratableNpmrc(npmrcPath, compatibility) : {
 		issues: createSettingsIssues(),
 		keys: [],
 		settings: {}
 	};
-	reportSettingsIssues({
+	warnings.push(...formatSettingsIssues({
 		compatibility,
 		issues: npmrc.issues,
 		source: NPMRC
-	});
+	}));
 	const packageJsonSettings = resolvePackageJsonSettings(packageJson, yarnResolutions, compatibility);
-	reportSettingsIssues({
+	warnings.push(...formatSettingsIssues({
 		compatibility,
 		issues: packageJsonSettings.issues,
 		source: `${PACKAGE_JSON}#pnpm`
-	});
+	}));
 	const projectNpmrcs = await readProjectNpmrcMigrations(cwd, collectWorkspacePackagePatterns(mergeByStrategy(pnpmWorkspace, mergeByStrategy(packageJsonSettings.settings, npmrc.settings, "merge"), strategy)), compatibility);
-	for (const warning of projectNpmrcs.warnings) consola$1.warn(warning);
-	for (const project of projectNpmrcs.projects) reportSettingsIssues({
+	warnings.push(...projectNpmrcs.warnings);
+	for (const project of projectNpmrcs.projects) warnings.push(...formatSettingsIssues({
 		compatibility,
 		issues: project.migratable.issues,
 		projectConfig: true,
 		source: relative(cwd, project.npmrcPath)
-	});
+	}));
 	const npmrcSettings = mergeByStrategy(npmrc.settings, Object.keys(projectNpmrcs.packageConfigs).length ? { packageConfigs: projectNpmrcs.packageConfigs } : {}, "merge");
 	return {
+		warnings,
 		incomingSettings: mergeByStrategy(packageJsonSettings.settings, npmrcSettings, "merge"),
 		npmrc,
 		packageJson: packageJsonSettings,
@@ -1993,13 +2045,6 @@ function resolveOptions(options = {}) {
 }
 //#endregion
 //#region src/core.ts
-function hasSettingsSources(npmrcExists, packageJsonExists, pnpmWorkspaceExists) {
-	if (!npmrcExists) consola$1.info(`${dim(NPMRC)} not found`);
-	if (!packageJsonExists) consola$1.info(`${dim(PACKAGE_JSON)} not found`);
-	if (npmrcExists || packageJsonExists || pnpmWorkspaceExists) return true;
-	consola$1.warn("No pnpm settings files to migrate");
-	return false;
-}
 function hasMigratableSettings(sources) {
 	const { existingSettingsChanged, npmrcKeys, packageJsonKeys, projectNpmrcKeys, yarnResolutions } = sources;
 	return Boolean(existingSettingsChanged || npmrcKeys.length || packageJsonKeys.length || projectNpmrcKeys.length || yarnResolutions);
@@ -2007,10 +2052,6 @@ function hasMigratableSettings(sources) {
 function assertCanMigrateRuntime(runtimeVersion, packageJsonExists) {
 	if (runtimeVersion && !packageJsonExists) throw new Error("Cannot migrate the removed Node.js runtime setting without a package.json file.");
 }
-function reportMigrationChanges(showChanges, before = {}, after = {}) {
-	if (!showChanges) return;
-	reportSettingsChanges(collectSettingsChanges(before, after));
-}
 /**
 * Migrate pnpm settings from legacy locations to `pnpm-workspace.yaml`.
 *
@@ -2030,10 +2071,10 @@ function reportMigrationChanges(showChanges, before = {}, after = {}) {
 * @param rawOptions.sortKeys - Whether to sort keys in output YAML (default: false)
 * @param rawOptions.newlineBetween - Add newlines between root keys (default: true)
 * @param rawOptions.replaceDeprecated - Whether to replace deprecated settings (default: false)
-* @param rawOptions.showChanges - Show settings changes after migration (default: true)
+* @param rawOptions.showChanges - CLI display preference; does not affect the result
 * @param rawOptions.strategy - Conflict handling strategy (default: merge)
 *
-* @returns A promise that resolves when migration is complete
+* @returns Settings changes, changed files, cleanup status, and warnings; no logs are emitted
 *
 * @throws {Error} When file operations fail or JSON/YAML parsing errors occur
 *
@@ -2051,107 +2092,106 @@ function reportMigrationChanges(showChanges, before = {}, after = {}) {
 * ```
 */
 async function migratePnpmSettings(rawOptions = {}) {
-	try {
-		const options = resolveOptions(rawOptions);
-		const npmrcPath = resolve(options.cwd, NPMRC);
-		const packageJsonPath = resolve(options.cwd, PACKAGE_JSON);
-		const pnpmWorkspaceYamlPath = resolve(options.cwd, PNPM_WORKSPACE_YAML);
-		const [npmrcExists, packageJsonExists, pnpmWorkspaceExists] = await Promise.all([
-			fsExists(npmrcPath),
-			fsExists(packageJsonPath),
-			fsExists(pnpmWorkspaceYamlPath)
-		]);
-		if (!hasSettingsSources(npmrcExists, packageJsonExists, pnpmWorkspaceExists)) {
-			reportMigrationChanges(options.showChanges);
-			return;
-		}
-		const [packageJson, pnpmWorkspace] = await Promise.all([readPackageJson(packageJsonPath, packageJsonExists), readPnpmWorkspace(pnpmWorkspaceYamlPath, pnpmWorkspaceExists)]);
-		const pnpmWorkspaceBefore = structuredClone(pnpmWorkspace.value);
-		const compatibility = resolveCompatibilityTarget(options.compatibility, packageJson.value.packageManager, packageJson.value.devEngines?.packageManager);
-		assertCompatibleWorkspaceSettings(pnpmWorkspace.value, compatibility);
-		const sources = await resolveMigrationSources({
-			compatibility,
-			cwd: options.cwd,
-			npmrcExists,
-			npmrcPath,
-			packageJson: packageJson.value,
-			pnpmWorkspace: pnpmWorkspace.value,
-			strategy: options.strategy,
-			yarnResolutions: options.yarnResolutions
-		});
-		const { incomingSettings } = sources;
-		const [existingNormalization, incomingNormalization] = await Promise.all([normalizeIncomingSettings(pnpmWorkspace.value, {
-			compatibility,
-			cwd: options.cwd,
-			replaceDeprecated: options.replaceDeprecated
-		}), normalizeIncomingSettings(incomingSettings, {
-			compatibility,
-			cwd: options.cwd,
-			replaceDeprecated: options.replaceDeprecated
-		})]);
-		for (const warning of [...existingNormalization.warnings, ...incomingNormalization.warnings]) consola$1.warn(warning);
-		const runtimeVersion = resolveRuntimeVersionByStrategy(existingNormalization.runtimeVersion, incomingNormalization.runtimeVersion, options.strategy);
-		assertCanMigrateRuntime(runtimeVersion, packageJsonExists);
-		const runtimeMigration = migrateRuntimeToPackageJson(packageJson.value, runtimeVersion);
-		if (runtimeMigration.warning) consola$1.warn(runtimeMigration.warning);
-		if (!hasMigratableSettings({
-			existingSettingsChanged: existingNormalization.changed,
-			npmrcKeys: sources.npmrc.keys,
-			packageJsonKeys: sources.packageJson.keys,
-			projectNpmrcKeys: sources.projectNpmrcs.projects.flatMap((project) => project.migratable.keys),
-			yarnResolutions: sources.packageJson.yarnResolutions
-		})) {
-			consola$1.warn("No pnpm settings fields to migrate");
-			reportMigrationChanges(options.showChanges);
-			return;
-		}
-		const pnpmWorkspaceResult = mergeByStrategy(pnpmWorkspace.value, incomingSettings, options.strategy);
-		updateYamlDocument(pnpmWorkspace.document, {
-			after: pnpmWorkspaceResult,
-			before: pnpmWorkspaceBefore,
-			sortKeys: options.sortKeys
-		});
-		const finalYamlContent = formatRootSpacing(pnpmWorkspace.document.toString({ indent: pnpmWorkspace.indent }), options.newlineBetween);
-		await persistMigration({
-			cleanNpmrc: options.cleanNpmrc,
-			cleanPackageJson: options.cleanPackageJson,
-			compatibility,
-			finalSettings: pnpmWorkspaceResult,
-			incomingSettings,
-			npmrc: sources.npmrc,
-			npmrcExists,
-			npmrcPath,
-			packageJson,
-			packageJsonExists,
-			packageJsonPath,
-			packageJsonRuntimeChanged: runtimeMigration.changed,
-			packageJsonSettings: sources.packageJson,
-			pnpmWorkspaceContent: finalYamlContent,
-			pnpmWorkspacePath: pnpmWorkspaceYamlPath,
-			projectNpmrcs: sources.projectNpmrcs,
-			runtimeVersion
-		});
-		reportMigrationChanges(options.showChanges, pnpmWorkspaceBefore, pnpmWorkspaceResult);
-	} catch (err) {
-		consola$1.error("Failed to migrate pnpm settings:", err);
-		throw err;
-	}
+	const options = resolveOptions(rawOptions);
+	const npmrcPath = resolve(options.cwd, NPMRC);
+	const packageJsonPath = resolve(options.cwd, PACKAGE_JSON);
+	const pnpmWorkspaceYamlPath = resolve(options.cwd, PNPM_WORKSPACE_YAML);
+	const [npmrcExists, packageJsonExists, pnpmWorkspaceExists] = await Promise.all([
+		fsExists(npmrcPath),
+		fsExists(packageJsonPath),
+		fsExists(pnpmWorkspaceYamlPath)
+	]);
+	const result = {
+		hasConfigurationFiles: npmrcExists || packageJsonExists || pnpmWorkspaceExists,
+		settingsChanges: [],
+		changedFiles: [],
+		sourceSettingsCleaned: false,
+		packageJsonRuntimeChanged: false,
+		warnings: []
+	};
+	if (!result.hasConfigurationFiles) return result;
+	const [packageJson, pnpmWorkspace] = await Promise.all([readPackageJson(packageJsonPath, packageJsonExists), readPnpmWorkspace(pnpmWorkspaceYamlPath, pnpmWorkspaceExists)]);
+	const pnpmWorkspaceBefore = structuredClone(pnpmWorkspace.value);
+	const compatibility = resolveCompatibilityTarget(options.compatibility, packageJson.value.packageManager, packageJson.value.devEngines?.packageManager);
+	assertCompatibleWorkspaceSettings(pnpmWorkspace.value, compatibility);
+	const sources = await resolveMigrationSources({
+		compatibility,
+		cwd: options.cwd,
+		npmrcExists,
+		npmrcPath,
+		packageJson: packageJson.value,
+		pnpmWorkspace: pnpmWorkspace.value,
+		strategy: options.strategy,
+		yarnResolutions: options.yarnResolutions
+	});
+	const { incomingSettings } = sources;
+	const [existingNormalization, incomingNormalization] = await Promise.all([normalizeIncomingSettings(pnpmWorkspace.value, {
+		compatibility,
+		cwd: options.cwd,
+		replaceDeprecated: options.replaceDeprecated
+	}), normalizeIncomingSettings(incomingSettings, {
+		compatibility,
+		cwd: options.cwd,
+		replaceDeprecated: options.replaceDeprecated
+	})]);
+	result.warnings.push(...sources.warnings, ...existingNormalization.warnings, ...incomingNormalization.warnings);
+	const runtimeVersion = resolveRuntimeVersionByStrategy(existingNormalization.runtimeVersion, incomingNormalization.runtimeVersion, options.strategy);
+	assertCanMigrateRuntime(runtimeVersion, packageJsonExists);
+	const runtimeMigration = migrateRuntimeToPackageJson(packageJson.value, runtimeVersion);
+	if (runtimeMigration.warning) result.warnings.push(runtimeMigration.warning);
+	if (!hasMigratableSettings({
+		existingSettingsChanged: existingNormalization.changed,
+		npmrcKeys: sources.npmrc.keys,
+		packageJsonKeys: sources.packageJson.keys,
+		projectNpmrcKeys: sources.projectNpmrcs.projects.flatMap((project) => project.migratable.keys),
+		yarnResolutions: sources.packageJson.yarnResolutions
+	})) return result;
+	const pnpmWorkspaceResult = mergeByStrategy(pnpmWorkspace.value, incomingSettings, options.strategy);
+	updateYamlDocument(pnpmWorkspace.document, {
+		after: pnpmWorkspaceResult,
+		before: pnpmWorkspaceBefore,
+		sortKeys: options.sortKeys
+	});
+	const finalYamlContent = formatRootSpacing(pnpmWorkspace.document.toString({ indent: pnpmWorkspace.indent }), options.newlineBetween);
+	const persistence = await persistMigration({
+		cleanNpmrc: options.cleanNpmrc,
+		cleanPackageJson: options.cleanPackageJson,
+		compatibility,
+		finalSettings: pnpmWorkspaceResult,
+		incomingSettings,
+		npmrc: sources.npmrc,
+		npmrcExists,
+		npmrcPath,
+		packageJson,
+		packageJsonExists,
+		packageJsonPath,
+		packageJsonRuntimeChanged: runtimeMigration.changed,
+		packageJsonSettings: sources.packageJson,
+		pnpmWorkspaceContent: finalYamlContent,
+		pnpmWorkspacePath: pnpmWorkspaceYamlPath,
+		projectNpmrcs: sources.projectNpmrcs,
+		runtimeVersion
+	});
+	return {
+		...result,
+		...persistence,
+		settingsChanges: collectSettingsChanges(pnpmWorkspaceBefore, pnpmWorkspaceResult)
+	};
 }
 //#endregion
 //#region src/cli.ts
 const cli = createCli();
 cli.command("").usage("[options]").action(async (options) => {
-	try {
-		consola.log(`\n${bold(magenta(name))} ${dim(`v${version}`)}`);
-		consola.log(dim("\n--------------\n"));
-		await migratePnpmSettings(options);
-		consola.success(green("pnpm settings migrate has finished"));
-	} catch (err) {
-		consola.fail(red(String(err)));
-		if (err instanceof Error && err.stack) consola.fail(dim(err.stack?.split("\n").slice(1).join("\n")));
-		process.exit(1);
-	}
+	const result = await migratePnpmSettings(options);
+	process.stdout.write(`${formatMigrationOutput(result, options.showChanges)}\n`);
 });
-cli.parse();
+try {
+	cli.parse(process.argv, { run: false });
+	await cli.runMatchedCommand();
+} catch (error) {
+	const message = error instanceof Error ? error.message : String(error);
+	process.stderr.write(`${red("✖")} ${message.trim()}\n`);
+	process.exitCode = 1;
+}
 //#endregion
 export {};