alex-c-line 2.0.0 → 2.0.2

package/dist/index.js

@@ -20,7 +20,6 @@ import { parseFilePath } from "@alextheman/utility/node";
 import supportsColor from "supports-color";
 import { randomUUID } from "node:crypto";
 import { minVersion, prerelease } from "semver";
-
 //#region src/utility/miscellaneous/centerLine.ts
 function centerLine(text, width) {
 	const padding = Math.max(0, width - text.length);
@@ -28,7 +27,6 @@ function centerLine(text, width) {
 	const right = padding - left;
 	return " ".repeat(left) + text + " ".repeat(right);
 }
-
 //#endregion
 //#region src/utility/miscellaneous/createAlexCLineArtwork.ts
 async function createAlexCLineArtwork(options) {
@@ -49,7 +47,6 @@ async function createAlexCLineArtwork(options) {
 		borderColor: "cyanBright"
 	}) : output;
 }
-
 //#endregion
 //#region src/cli/commands/artwork/log.ts
 function artworkLog(program) {
@@ -67,7 +64,6 @@ function artworkLog(program) {
 		}));
 	});
 }
-
 //#endregion
 //#region src/utility/miscellaneous/asciiToPng.ts
 async function asciiToPng(ascii, options) {
@@ -100,7 +96,6 @@ async function asciiToPng(ascii, options) {
 	await mkdir(path.dirname(outputPath), { recursive: true });
 	await writeFile(outputPath, canvas.toBuffer("image/png"));
 }
-
 //#endregion
 //#region src/cli/commands/artwork/save.ts
 function artworkSave(program) {
@@ -119,13 +114,11 @@ function artworkSave(program) {
 		console.info(`Artwork saved successfully to ${path.resolve(filePath.endsWith(".png") ? filePath : `${filePath}.png`)}`);
 	});
 }
-
 //#endregion
 //#region src/utility/miscellaneous/loadCommands.ts
 function loadCommands(program, commandMap) {
 	for (const loader of Object.values(commandMap)) loader(program);
 }
-
 //#endregion
 //#region src/cli/commands/artwork/index.ts
 function artwork(program) {
@@ -134,13 +127,8 @@ function artwork(program) {
 		artworkSave
 	});
 }
-
-//#endregion
-//#region src/cache/global/envPaths.ts
-const alexCLineEnvPaths = envPaths("alex-c-line");
-const { cache: ALEX_C_LINE_GLOBAL_CACHE_DIRECTORY } = alexCLineEnvPaths;
+const { cache: ALEX_C_LINE_GLOBAL_CACHE_DIRECTORY } = envPaths("alex-c-line");
 const ALEX_C_LINE_GLOBAL_CACHE_PATH = path.join(ALEX_C_LINE_GLOBAL_CACHE_DIRECTORY, "cache.json");
-
 //#endregion
 //#region src/cli/commands/cache/path.ts
 function cachePath(program) {
@@ -148,36 +136,32 @@ function cachePath(program) {
 		console.info(ALEX_C_LINE_GLOBAL_CACHE_PATH);
 	});
 }
-
 //#endregion
 //#region src/cli/commands/cache/index.ts
 function cache(program) {
 	loadCommands(program.command("cache").description("Commands related to the alex-c-line cache"), { cachePath });
 }
-
 //#endregion
 //#region src/utility/constants/errorPrefix.ts
-const errorPrefix = "❌ ERROR";
-
+const errorPrefix = "❌ ERROR:";
 //#endregion
 //#region src/utility/envFile/upsertDotenvFile.ts
 async function upsertDotenvFile(contents, envFilePath) {
 	await writeFile(path.join(process.cwd(), envFilePath), stringifyDotenv(contents));
 }
-
 //#endregion
 //#region src/cli/commands/env-file/edit/addVariable.ts
 async function addVariable(program, envFileContents, file) {
 	const newVariableName = await input({ message: "Please enter the name of the environment variable you would like to add." });
 	if (newVariableName in envFileContents) program.error(`
-            ${errorPrefix}: Error with chosen environment variable name ${newVariableName}.
+            ${errorPrefix} Error with chosen environment variable name ${newVariableName}.
             Variable name already exists. If you wish to edit this variable, please select it from the initial menu instead.
             `, {
 		exitCode: 2,
 		code: "DUPLICATE_ENVIRONMENT_VARIABLE_NAME"
 	});
 	if (/[ \t\r\n]/.test(newVariableName)) program.error(normaliseIndents`
-            ${errorPrefix}: Error with chosen environment variable name ${newVariableName}.
+            ${errorPrefix} Error with chosen environment variable name ${newVariableName}.
             Environment variables are not allowed to have whitespace.
             `, {
 		exitCode: 2,
@@ -190,7 +174,6 @@ async function addVariable(program, envFileContents, file) {
 	}, file);
 	console.info(`${newVariableName} successfully added.`);
 }
-
 //#endregion
 //#region src/cli/commands/env-file/edit/deleteVariable.ts
 async function deleteVariable(envFileContents, variableToEdit, file) {
@@ -201,7 +184,6 @@ async function deleteVariable(envFileContents, variableToEdit, file) {
 	await upsertDotenvFile(omitProperties(envFileContents, variableToEdit), file);
 	console.info(`${String(variableToEdit)} successfully deleted.`);
 }
-
 //#endregion
 //#region src/cli/commands/env-file/edit/editVariable.ts
 async function editVariable(envFileContents, variableToEdit, file) {
@@ -212,7 +194,6 @@ async function editVariable(envFileContents, variableToEdit, file) {
 	}, file);
 	console.info(`${String(variableToEdit)} successfully updated.`);
 }
-
 //#endregion
 //#region src/utility/envFile/redact.ts
 function redact(secretString) {
@@ -220,7 +201,6 @@ function redact(secretString) {
 		return "*";
 	}, secretString.length).join("")} (redacted for security)>`;
 }
-
 //#endregion
 //#region src/cli/commands/env-file/edit/changeExistingVariable.ts
 async function changeExistingVariable(envFileContents, variableToEdit, file) {
@@ -247,7 +227,6 @@ async function changeExistingVariable(envFileContents, variableToEdit, file) {
 		default: console.error("Unrecognised option");
 	}
 }
-
 //#endregion
 //#region src/utility/envFile/parseDotenvFile.ts
 async function parseDotenvFile(envFilePath) {
@@ -258,7 +237,6 @@ async function parseDotenvFile(envFilePath) {
 		throw error;
 	}
 }
-
 //#endregion
 //#region src/cli/commands/env-file/edit/index.ts
 function envFileEdit(program) {
@@ -305,13 +283,11 @@ function envFileEdit(program) {
 		}
 	});
 }
-
 //#endregion
 //#region src/cli/commands/env-file/index.ts
 function envFile(program) {
 	loadCommands(program.command("env-file").description("Interact with a .env file"), { envFileEdit });
 }
-
 //#endregion
 //#region src/cli/commands/internal/check-lockfile-version-discrepancy.ts
 function checkLockfileVersionDiscrepancy(program) {
@@ -320,21 +296,20 @@ function checkLockfileVersionDiscrepancy(program) {
 		const { version: packageVersion } = JSON.parse(await readFile(path.resolve(process.cwd(), "package.json"), "utf-8"));
 		const { version: packageLockVersion } = JSON.parse(await readFile(path.resolve(process.cwd(), "package-lock.json"), "utf-8"));
 		if (packageVersion !== packageLockVersion) {
-			console.error("❌ ERROR: package.json and package-lock.json out of sync. Please run `npm install` to fix this.");
+			console.error(`${errorPrefix} package.json and package-lock.json out of sync. Please run \`npm install\` to fix this.`);
 			process.exitCode = 1;
 			return;
 		}
 		console.info("package.json and package-lock.json versions in sync.");
 	});
 }
-
 //#endregion
 //#region src/cli/commands/internal/git-post-merge-cleanup.ts
 function gitPostMergeCleanup(program) {
 	program.command("git-post-merge-cleanup").alias("git-cleanup").description("Run after merging into a given branch to quickly clean up").argument("[branch]", "The branch you want to merge into", "main").option("--rebase", "Enable if your repository mainly rebases into main", true).action(async (branch, { rebase }) => {
 		console.info(`Running git-post-merge-cleanup in ${rebase ? "rebase" : "merge"} mode...`);
 		const { stdout: currentBranch } = await execa`git branch --show-current`;
-		if (currentBranch === branch) program.error(`❌ ERROR: Cannot run cleanup on ${branch} branch!`, {
+		if (currentBranch === branch) program.error(`${errorPrefix} Cannot run cleanup on ${branch} branch!`, {
 			exitCode: 1,
 			code: "INVALID_BRANCH"
 		});
@@ -350,7 +325,7 @@ function gitPostMergeCleanup(program) {
 			const { stdout: changes } = await execa`git diff ${branch}..${currentBranch}`;
 			if (changes) {
 				await execa`git checkout ${currentBranch}`;
-				program.error("❌ ERROR: Changes on branch not fully merged!", {
+				program.error(`${errorPrefix} Changes on branch not fully merged!`, {
 					exitCode: 1,
 					code: "CHANGES_NOT_MERGED"
 				});
@@ -360,7 +335,7 @@ function gitPostMergeCleanup(program) {
 			const { stdout: branchDeletedMessage, exitCode } = await execa({ reject: false })`git branch --delete ${currentBranch}`;
 			if (exitCode !== 0) {
 				await execa`git checkout ${currentBranch}`;
-				program.error("❌ ERROR: Changes on branch not fully merged!", {
+				program.error(`${errorPrefix} Changes on branch not fully merged!`, {
 					exitCode: 1,
 					code: "CHANGES_NOT_MERGED"
 				});
@@ -369,7 +344,6 @@ function gitPostMergeCleanup(program) {
 		}
 	});
 }
-
 //#endregion
 //#region src/utility/fileSystem/findPackageRoot.ts
 async function findPackageRoot(startDirectory, packageName) {
@@ -385,12 +359,10 @@ async function findPackageRoot(startDirectory, packageName) {
 	}
 	throw new DataError({ packageName }, "PACKAGE_ROOT_NOT_FOUND", `Could not find package root for ${packageName}`);
 }
-
 //#endregion
 //#region src/utility/constants/alexCLinePackageRoot.ts
 const __filename$2 = fileURLToPath(import.meta.url);
 const ALEX_C_LINE_PACKAGE_ROOT = findPackageRoot(path.dirname(__filename$2), "alex-c-line");
-
 //#endregion
 //#region src/cli/commands/internal/outdated-dependencies.ts
 function outdatedDependencies(program) {
@@ -413,7 +385,6 @@ function outdatedDependencies(program) {
 		}).join("\n")));
 	});
 }
-
 //#endregion
 //#region src/cli/commands/internal/index.ts
 function internal(program) {
@@ -423,7 +394,6 @@ function internal(program) {
 		outdatedDependencies
 	});
 }
-
 //#endregion
 //#region src/cache/project/createAlexCLineProjectCache.ts
 async function createAlexCLineProjectCache(cacheContents) {
@@ -431,7 +401,6 @@ async function createAlexCLineProjectCache(cacheContents) {
 	await mkdir(path.dirname(cacheFilePath), { recursive: true });
 	await writeFile(cacheFilePath, JSON.stringify(cacheContents, void 0, 2));
 }
-
 //#endregion
 //#region src/configs/helpers/preCommit/definePreCommitConfig.ts
 const preCommitStepOptionsSchema = z.strictObject({ arguments: z.array(z.string()).optional() });
@@ -448,7 +417,6 @@ const preCommitConfigSchema = z.strictObject({
 	])),
 	updateIndex: z.boolean().optional()
 });
-
 //#endregion
 //#region src/configs/helpers/template/pullRequest/defineTemplatePullRequestSchema.ts
 const templatePullRequestBaseSchema = z.strictObject({ projectName: z.string().optional() });
@@ -463,7 +431,6 @@ const templatePullRequestSchema = z.discriminatedUnion("category", [templatePull
 function parseTemplatePullRequestConfig(input) {
 	return parseZodSchema(templatePullRequestSchema, input);
 }
-
 //#endregion
 //#region src/configs/helpers/defineAlexCLineConfig.ts
 const alexCLineConfigSchema = z.strictObject({
@@ -473,7 +440,6 @@ const alexCLineConfigSchema = z.strictObject({
 async function parseAlexCLineConfig(input) {
 	return await parseZodSchemaAsync(alexCLineConfigSchema, input);
 }
-
 //#endregion
 //#region src/configs/types/ConfigFileName.ts
 const ConfigFileName = {
@@ -486,14 +452,12 @@ const PrivateConfigFileName = {
 	ES_MODULES_JAVASCRIPT: ".alex-c-line.private.config.mjs",
 	COMMON_JS_JAVASCRIPT: ".alex-c-line.private.config.cjs"
 };
-
 //#endregion
 //#region src/configs/types/template/pullRequest/PullRequestTemplateCategory.ts
 const PullRequestTemplateCategory = {
 	GENERAL: "general",
 	INFRASTRUCTURE: "infrastructure"
 };
-
 //#endregion
 //#region src/configs/helpers/defineAlexCLinePrivateConfig.ts
 const alexCLinePrivateConfigSchema = z.object({ localPackage: z.strictObject({
@@ -509,7 +473,6 @@ const alexCLinePrivateConfigSchema = z.object({ localPackage: z.strictObject({
 function parseAlexCLinePrivateConfig(data) {
 	return parseZodSchema(alexCLinePrivateConfigSchema, data);
 }
-
 //#endregion
 //#region src/cache/project/types/AlexCLineProjectCache.ts
 const alexCLineProjectCacheSchema = z.object({ useLocalPackage: z.object({ dependencies: z.record(z.string(), z.object({
@@ -519,13 +482,11 @@ const alexCLineProjectCacheSchema = z.object({ useLocalPackage: z.object({ depen
 	}),
 	dependencyGroup: z.enum(DependencyGroup)
 })) }).partial() }).partial();
-
 //#endregion
 //#region src/cache/project/parseAlexCLineProjectCache.ts
 function parseAlexCLineProjectCache(data) {
 	return parseZodSchema(alexCLineProjectCacheSchema, data);
 }
-
 //#endregion
 //#region src/cache/project/loadAlexCLineProjectCache.ts
 async function loadAlexCLineProjectCache(cachePath = path.join(".alex-c-line", "cache.json")) {
@@ -537,7 +498,6 @@ async function loadAlexCLineProjectCache(cachePath = path.join(".alex-c-line", "
 		throw error;
 	}
 }
-
 //#endregion
 //#region src/utility/fileSystem/doesFileExist.ts
 async function doesFileExist(filePath) {
@@ -549,7 +509,6 @@ async function doesFileExist(filePath) {
 		throw error;
 	}
 }
-
 //#endregion
 //#region src/utility/configs/findAlexCLineConfig.ts
 async function findAlexCLineConfig(cwd, validConfigFileNames = [
@@ -562,7 +521,6 @@ async function findAlexCLineConfig(cwd, validConfigFileNames = [
 		if (await doesFileExist(fullPath)) return fullPath;
 	}
 }
-
 //#endregion
 //#region src/utility/configs/loadAlexCLinePrivateConfig.ts
 const require$1 = createRequire(import.meta.url);
@@ -574,7 +532,6 @@ async function loadAlexCLinePrivateConfig(filePath) {
 	const module = await import(pathToFileURL(filePath).href);
 	return parseAlexCLinePrivateConfig(module.default ?? module);
 }
-
 //#endregion
 //#region src/utility/fileSystem/findTgzFile.ts
 async function findTgzFile(packagePath, packageManager) {
@@ -596,7 +553,6 @@ async function findTgzFile(packagePath, packageManager) {
 	}, "AMBIGUOUS_RESOLUTION", "There are too many .tgz files with the expected file name.");
 	return expectedTgzFileName;
 }
-
 //#endregion
 //#region src/utility/miscellaneous/removeAllTarballs.ts
 async function removeAllTarballs(packagePath, packageName) {
@@ -608,7 +564,6 @@ async function removeAllTarballs(packagePath, packageName) {
 		return rm(path.join(packagePath, file), { force: true });
 	}));
 }
-
 //#endregion
 //#region src/cli/commands/local-package/use.ts
 function localPackageUse(program) {
@@ -618,10 +573,7 @@ function localPackageUse(program) {
 			PrivateConfigFileName.ES_MODULES_JAVASCRIPT,
 			PrivateConfigFileName.STANDARD_JAVASCRIPT
 		]);
-		if (!configPath) program.error("Could not find the path to the alex-c-line private config file (should be `.alex-c-line.private.config.js`). Does it exist?", {
-			exitCode: 1,
-			code: "ALEX_C_LINE_PRIVATE_CONFIG_NOT_FOUND"
-		});
+		if (!configPath) throw new DataError({ configPath }, "ALEX_C_LINE_PRIVATE_CONFIG_NOT_FOUND", "Could not find the path to the alex-c-line private config file (should be `.alex-c-line.private.config.js`). Does it exist?");
 		const { localPackage: { enableCache, localPackages } } = await loadAlexCLinePrivateConfig(configPath);
 		const localPackage = localPackages[packageName];
 		if (!localPackage) throw new DataError({
@@ -658,8 +610,8 @@ function localPackageUse(program) {
 				stdio: "inherit",
 				reject: false
 			});
-			if (exitCode !== 0 && args.length !== 0) program.error("❌ ERROR: An error occurred during the local `alex-c-line` run.", {
-				exitCode: 1,
+			if (exitCode !== 0) program.error(`${errorPrefix} An error occurred during the local \`alex-c-line\` run.`, {
+				exitCode,
 				code: "LOCAL_ALEX_C_LINE_ERROR"
 			});
 		} else {
@@ -715,13 +667,11 @@ function localPackageUse(program) {
 		}
 	});
 }
-
 //#endregion
 //#region src/cli/commands/local-package/index.ts
 function localPackage(program) {
 	loadCommands(program.command("local-package").description("Manage the use of local packages in your JavaScript project."), { localPackageUse });
 }
-
 //#endregion
 //#region src/cli/commands/root/encrypt-with-key.ts
 function encryptWithKey$1(program) {
@@ -729,23 +679,22 @@ function encryptWithKey$1(program) {
 		try {
 			console.info(await encryptWithKey(publicKey, plaintextValue));
 		} catch {
-			program.error("Encryption failed. Please double-check that the given key is a valid base 64 string.", {
+			program.error(`${errorPrefix} Encryption failed. Please double-check that the given key is a valid base 64 string.`, {
 				exitCode: 1,
 				code: "ENCRYPTION_FAILED"
 			});
 		}
 	});
 }
-
 //#endregion
 //#region src/cli/commands/root/pre-commit/createStepRunner.ts
 const runCommandAndLogToConsole = execa({
 	stdio: "inherit",
 	reject: false
 });
-async function evaluateResult(program, promisedResult, failedCommand) {
+async function evaluateResult(program, promisedResult, failedCommand, boundOptions) {
 	const result = await promisedResult;
-	if (result.exitCode !== 0) program.error(`Command failed: ${failedCommand}`, {
+	if (result.exitCode !== 0 && (boundOptions.reject ?? true)) program.error(`Command failed: ${failedCommand}`, {
 		exitCode: result.exitCode ?? 1,
 		code: "PRE_COMMIT_FAILED"
 	});
@@ -756,11 +705,11 @@ function bindStepRunner(program, boundOptions) {
 		if (typeof first === "string") {
 			const command = first;
 			const args = second[0] ?? [];
-			return evaluateResult(program, runCommandAndLogToConsole(boundOptions)(command, args), `${command}${args.length ? ` ${args.join(" ")}` : ""}`);
+			return evaluateResult(program, runCommandAndLogToConsole(boundOptions)(command, args), `${command}${args.length ? ` ${args.join(" ")}` : ""}`, boundOptions);
 		}
 		if (isTemplateStringsArray(first)) {
 			const args = getStringsAndInterpolations(first, ...second);
-			return evaluateResult(program, runCommandAndLogToConsole(boundOptions)(...args), interpolate(...args));
+			return evaluateResult(program, runCommandAndLogToConsole(boundOptions)(...args), interpolate(...args), boundOptions);
 		}
 		return bindStepRunner(program, {
 			...boundOptions,
@@ -772,11 +721,10 @@ function bindStepRunner(program, boundOptions) {
 function createStepRunner(program) {
 	return bindStepRunner(program, {});
 }
-
 //#endregion
 //#region src/cli/commands/root/pre-commit/getCommandArguments.ts
 function getCommandArguments(program, script, scripts, args) {
-	if (!(script in (scripts ?? {}))) program.error(`Could not find script \`${script}\` in package.json.`, {
+	if (!(script in (scripts ?? {}))) program.error(`${errorPrefix} Could not find script \`${script}\` in package.json.`, {
 		exitCode: 1,
 		code: "SCRIPT_NOT_FOUND"
 	});
@@ -784,7 +732,6 @@ function getCommandArguments(program, script, scripts, args) {
 	if (args) result.push(...args);
 	return result;
 }
-
 //#endregion
 //#region src/utility/configs/loadAlexCLineConfig.ts
 const require = createRequire(import.meta.url);
@@ -796,25 +743,21 @@ async function loadAlexCLineConfig(filePath) {
 	const module = await import(pathToFileURL(filePath).href);
 	return await parseAlexCLineConfig(module.default ?? module);
 }
-
 //#endregion
 //#region src/cli/commands/root/pre-commit/pre-commit.ts
 function preCommit(program) {
 	program.command("pre-commit").description("Run the pre-commit scripts specified in the alex-c-line config (v2 experiment).").option("--allow-no-staged-changes", "Run even if nothing is staged").option("--no-update-index").option("--update-index", "Update the git index after the run").action(async (options) => {
 		const configPath = await findAlexCLineConfig(process.cwd());
-		if (!configPath) program.error("Could not find the path to the alex-c-line config file. Does it exist?", {
-			exitCode: 1,
-			code: "ALEX_C_LINE_CONFIG_NOT_FOUND"
-		});
+		if (!configPath) throw new DataError({ configPath }, "ALEX_C_LINE_CONFIG_NOT_FOUND", "Could not find the path to the alex-c-line config file. Does it exist?");
 		const { preCommit: preCommitConfig } = await loadAlexCLineConfig(configPath);
-		if (!preCommitConfig) program.error("Could not find the pre-commit config in alex-c-line config.", {
-			exitCode: 1,
-			code: "PRE_COMMIT_CONFIG_NOT_FOUND"
-		});
+		if (!preCommitConfig) throw new DataError({
+			configPath,
+			preCommitConfig
+		}, "PRE_COMMIT_CONFIG_NOT_FOUND", "Could not find the pre-commit config in alex-c-line config.");
 		const { allowNoStagedChanges = options?.allowNoStagedChanges, updateIndex = options?.updateIndex } = preCommitConfig;
 		const { exitCode: diffExitCode } = await execa({ reject: false })`git diff --cached --quiet`;
 		switch (diffExitCode) {
-			case 128: program.error("Not currently in a Git repository", {
+			case 128: program.error(`${errorPrefix} Not currently in a Git repository`, {
 				exitCode: 1,
 				code: "GIT_DIFF_FAILED"
 			});
@@ -836,7 +779,6 @@ function preCommit(program) {
 		if (updateIndex) await stepRunner`git update-index --again`;
 	});
 }
-
 //#endregion
 //#region src/cli/commands/root/say-hello.ts
 function sayHello(program) {
@@ -844,7 +786,6 @@ function sayHello(program) {
 		console.info("Hello!");
 	});
 }
-
 //#endregion
 //#region src/cli/commands/root/index.ts
 function root(program) {
@@ -854,7 +795,6 @@ function root(program) {
 		sayHello
 	});
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/pullRequest/getPullRequestTemplatesFromMarkdown.ts
 const __filename$1 = fileURLToPath(import.meta.url);
@@ -892,7 +832,6 @@ async function getPullRequestTemplatesFromMarkdown(config) {
 	}
 	return allTemplates;
 }
-
 //#endregion
 //#region src/cli/commands/template/pullRequest/create.ts
 function templatePullRequestCreate(program) {
@@ -904,12 +843,7 @@ function templatePullRequestCreate(program) {
 		const configPath = await findAlexCLineConfig(process.cwd());
 		const { template: { pullRequest: config } = {} } = configPath ? await loadAlexCLineConfig(configPath) : {};
 		const packageInfo = await getPackageJsonContents(process.cwd());
-		const { name: projectName } = commandLineOptions.projectName || config?.projectName ? { name: commandLineOptions.projectName ?? config?.projectName } : parseZodSchema(z.object({ name: z.string() }), packageInfo, () => {
-			program.error("Invalid package.json - expected package.json to contain a `name` property.", {
-				exitCode: 1,
-				code: "INVALID_PACKAGE_JSON"
-			});
-		});
+		const { name: projectName } = commandLineOptions.projectName || config?.projectName ? { name: commandLineOptions.projectName ?? config?.projectName } : parseZodSchema(z.object({ name: z.string() }), packageInfo);
 		if (!projectName) throw new DataError({ projectName }, "PROJECT_NAME_NOT_FOUND", "Could not resolve project name.");
 		const parsedOptions = parseTemplatePullRequestConfig(removeUndefinedFromObject({
 			category: commandLineOptions.category ?? config?.category ?? "general",
@@ -930,24 +864,28 @@ function templatePullRequestCreate(program) {
 		console.info("Pull request templates created.");
 	});
 }
-
 //#endregion
 //#region src/cli/commands/template/pullRequest/index.ts
 function templatePullRequest(program) {
 	loadCommands(program.command("pull-request").description("Manage the pull request templates."), { templatePullRequestCreate });
 }
-
 //#endregion
 //#region src/utility/constants/successPrefix.ts
 const successPrefix = chalk.green("✓");
-
+//#endregion
+//#region src/utility/errors/convertDataErrorToProgramError.ts
+function convertDataErrorToProgramError(dataError, program, options) {
+	program.error(`${errorPrefix} ${dataError.message}`, {
+		exitCode: options?.exitCode ?? 1,
+		code: dataError.code
+	});
+}
 //#endregion
 //#region src/utility/markdownTemplates/releaseNote/types/ReleaseStatus.ts
 const ReleaseStatus = {
 	IN_PROGRESS: "In progress",
 	RELEASED: "Released"
 };
-
 //#endregion
 //#region src/utility/markdownTemplates/releaseNote/parseReleaseStatus.ts
 function parseReleaseStatus(data) {
@@ -955,20 +893,17 @@ function parseReleaseStatus(data) {
 	if (!Object.keys(ReleaseStatus).includes(normalisedStringifiedData)) new DataError({ data }, "INVALID_RELEASE_STATUS", "Invalid release status. The release status must be one of \"In progress\" or \"Released\"");
 	return ReleaseStatus[normalisedStringifiedData];
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/createMarkdownComment.ts
 function createMarkdownComment(comment) {
 	if (comment.startsWith("<!--") && comment.endsWith("-->")) return comment;
 	return `<!-- ${comment} -->`;
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/createMarkdownCommentPair.ts
 function createMarkdownCommentPair(comment) {
 	return [createMarkdownComment(`${comment}-start`), createMarkdownComment(`${comment}-end`)];
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/getMarkdownBlock.ts
 function getMarkdownBlock(content, startMarker, endMarker) {
@@ -977,7 +912,6 @@ function getMarkdownBlock(content, startMarker, endMarker) {
 	if (startIndex === -1 || endIndex === -1 || endIndex < startIndex) return null;
 	return content.slice(startIndex + startMarker.length, endIndex).trim();
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/normaliseMarkdown.ts
 function normaliseMarkdown(markdownString) {
@@ -985,7 +919,6 @@ function normaliseMarkdown(markdownString) {
 		return line.trim();
 	}).filter(Boolean).join(" ").trim();
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/releaseNote/getReleaseStatus.ts
 function getReleaseStatus(content) {
@@ -993,7 +926,6 @@ function getReleaseStatus(content) {
 	if (releaseStatus === null) throw new DataError({ releaseStatus }, "RELEASE_STATUS_NOT_FOUND", "Could not find release status in document.");
 	return parseZodSchema(z.enum(ReleaseStatus), normaliseMarkdown(releaseStatus.split(":")[1]));
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/releaseNote/validateReleaseDocument.ts
 const __filename = fileURLToPath(import.meta.url);
@@ -1031,7 +963,6 @@ async function validateReleaseDocument(projectName, version, content, allowedRel
 	if (!content.includes("## Description of Changes")) throw new DataError({ content }, "DESCRIPTION_NOT_FOUND", "Expected to find a description of changes but it was not found.");
 	if (version.type === "major" && !content.includes("## Migration Notes")) throw new DataError({ content }, "MIGRATION_NOTES_NOT_FOUND", "Major version notes must have migration notes as major versions are expected to be breaking changes that require users to migrate and refactor their code.");
 }
-
 //#endregion
 //#region src/cli/commands/template/releaseNote/check.ts
 function templateReleaseNoteCheck(program) {
@@ -1047,34 +978,27 @@ function templateReleaseNoteCheck(program) {
 			await validateReleaseDocument(name, documentVersion, fileContents, expectedReleaseStatus);
 			console.info(`${successPrefix} Release document is valid!`);
 		} catch (error) {
-			if (DataError.check(error)) program.error(`${errorPrefix}: ${error.message}`, {
-				exitCode: 1,
-				code: error.code
-			});
+			if (DataError.check(error)) convertDataErrorToProgramError(error, program, { exitCode: 2 });
 			else throw error;
 		}
 	});
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/releaseNote/getReleaseNotePath.ts
 function getReleaseNotePath(versionNumber) {
 	return path.join("docs", "releases", versionNumber.format({ omitMinor: true }), versionNumber.format({ omitPatch: true }), `${versionNumber}.md`);
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/getReleaseNoteTemplatesPath.ts
 async function getReleaseNoteTemplatesPath() {
 	return path.join(await ALEX_C_LINE_PACKAGE_ROOT, "templates", "releases");
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/getEditableSectionFromTemplate.ts
 async function getEditableSectionFromTemplate(version) {
 	const templatesPath = await getReleaseNoteTemplatesPath();
 	return await readFile(path.join(templatesPath, version.type === "major" ? "editableSectionMajor.md" : "editableSection.md"), "utf-8");
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/replaceMarkdownPlaceholders.ts
 function replaceMarkdownPlaceholders(rawContent, templateVariables) {
@@ -1087,7 +1011,6 @@ function replaceMarkdownPlaceholders(rawContent, templateVariables) {
 	}
 	return finalContent;
 }
-
 //#endregion
 //#region src/utility/markdownTemplates/releaseNote/getReleaseNoteTemplateFromMarkdown.ts
 async function getTemplateVariables(projectName, version, templateVariables) {
@@ -1118,7 +1041,6 @@ async function getReleaseNoteTemplateFromMarkdown(projectName, version, metadata
 	const templatesPath = path.join(await ALEX_C_LINE_PACKAGE_ROOT, "templates", "releases");
 	return replaceMarkdownPlaceholders(await readFile(path.join(templatesPath, `${version.type}.md`), "utf-8"), templateVariables);
 }
-
 //#endregion
 //#region src/cli/commands/template/releaseNote/create.ts
 function templateReleaseNoteCreate(program) {
@@ -1138,12 +1060,7 @@ function templateReleaseNoteCreate(program) {
 		const { name, version: packageVersion } = parseZodSchema(z.object({
 			name: z.string(),
 			version: z.string()
-		}), packageInfo, () => {
-			program.error("Invalid package.json - expected package.json to contain a `name` and `version` property.", {
-				exitCode: 1,
-				code: "INVALID_PACKAGE_JSON"
-			});
-		});
+		}), packageInfo);
 		const versionNumber = target instanceof VersionNumber ? target : target ? new VersionNumber(packageVersion).increment(target) : new VersionNumber(packageVersion);
 		const releaseNotePath = getReleaseNotePath(versionNumber);
 		const releaseNoteTemplate = await getReleaseNoteTemplateFromMarkdown(name, versionNumber, { status: "In progress" });
@@ -1151,7 +1068,7 @@ function templateReleaseNoteCreate(program) {
 			await mkdir(path.dirname(releaseNotePath), { recursive: true });
 			await writeFile(releaseNotePath, releaseNoteTemplate, { flag: "wx" });
 		} catch (error) {
-			if (error instanceof Error && "code" in error && error.code === "EEXIST") program.error("❌ ERROR: Release notes already exist.", {
+			if (error instanceof Error && "code" in error && error.code === "EEXIST") program.error(`${errorPrefix} Release notes already exist.`, {
 				exitCode: 1,
 				code: "RELEASE_NOTE_EXISTS"
 			});
@@ -1160,7 +1077,6 @@ function templateReleaseNoteCreate(program) {
 		console.info(`Release notes for ${versionNumber} have been created in ${path.relative(process.cwd(), releaseNotePath)}`);
 	});
 }
-
 //#endregion
 //#region src/cli/commands/template/releaseNote/migrate.ts
 function templateReleaseNoteMigrate(program) {
@@ -1216,7 +1132,6 @@ function templateReleaseNoteMigrate(program) {
 		console.info(dryRun ? `Dry run complete! ${filesMovedCount} files would be moved.` : `Migration complete! ${filesMovedCount} files moved.`);
 	});
 }
-
 //#endregion
 //#region src/cli/commands/template/releaseNote/path.ts
 function templateReleaseNotePath(program) {
@@ -1231,17 +1146,13 @@ function templateReleaseNotePath(program) {
 		console.info(getReleaseNotePath(version));
 	});
 }
-
 //#endregion
 //#region src/cli/commands/template/releaseNote/set-status.ts
 function templateReleaseNoteSetStatus(program) {
 	program.command("set-status").description("Change the release status on a given release document initially generated from the `create-release-note` command.").argument("<documentPath>", "The path to the document").argument("[status]", "The status to set the document to", parseReleaseStatus, ReleaseStatus.RELEASED).action(async (documentPath, status) => {
 		const packageInfo = await getPackageJsonContents(process.cwd());
 		const { name } = parseZodSchema(z.object({ name: z.string() }), packageInfo, new DataError({ name: packageInfo?.name }, "INVALID_PACKAGE_JSON", "Invalid package.json - expected package.json to contain a `name` property."));
-		if (!documentPath.endsWith("md")) program.error("❌ ERROR: Invalid file path. Path must lead to a .md file.", {
-			exitCode: 1,
-			code: "INVALID_FILE_PATH"
-		});
+		if (!documentPath.endsWith("md")) throw new DataError({ documentPath }, "INVALID_FILE_PATH", "Invalid file path. Path must lead to a .md file.");
 		const versionNumber = new VersionNumber(path.basename(documentPath).split(".").filter((part) => {
 			return part !== "md";
 		}).join("."));
@@ -1261,7 +1172,6 @@ function templateReleaseNoteSetStatus(program) {
 		console.info(`Setting the status of ${documentPath} to "${status}"`);
 	});
 }
-
 //#endregion
 //#region src/cli/commands/template/releaseNote/index.ts
 function templateReleaseNote(program) {
@@ -1273,7 +1183,6 @@ function templateReleaseNote(program) {
 		templateReleaseNoteSetStatus
 	});
 }
-
 //#endregion
 //#region src/cli/commands/template/index.ts
 function template(program) {
@@ -1282,13 +1191,11 @@ function template(program) {
 		templateReleaseNote
 	});
 }
-
 //#endregion
 //#region package.json
 var name = "alex-c-line";
-var version$1 = "2.0.0";
+var version$1 = "2.0.2";
 var description = "Command-line tool with commands to streamline the developer workflow.";
-
 //#endregion
 //#region src/utility/updates/checkUpdate.ts
 async function checkUpdate(options) {
@@ -1320,7 +1227,6 @@ async function checkUpdate(options) {
 		} else console.info(messageWithArtwork);
 	} else if (options?.logNoUpdates) console.info(`alex-c-line is up to date (${currentVersion}).`);
 }
-
 //#endregion
 //#region src/cli/commands/update/check.ts
 function checkUpdateCommand(program) {
@@ -1331,13 +1237,11 @@ function checkUpdateCommand(program) {
 		});
 	});
 }
-
 //#endregion
 //#region src/cli/commands/update/index.ts
 function update(program) {
 	loadCommands(program.command("update").description("Handle updates of the currently installed alex-c-line"), { checkUpdateCommand });
 }
-
 //#endregion
 //#region src/cli/commands/uuid/generate.ts
 function generateUUID(program) {
@@ -1345,22 +1249,11 @@ function generateUUID(program) {
 		console.info(randomUUID());
 	});
 }
-
 //#endregion
 //#region src/cli/commands/uuid/index.ts
 function uuid(program) {
 	loadCommands(program.command("uuid").description("Commands to help manage UUIDs"), { generateUUID });
 }
-
-//#endregion
-//#region src/utility/errors/convertDataErrorToProgramError.ts
-function convertDataErrorToProgramError(dataError, program, options) {
-	program.error(dataError.message, {
-		exitCode: options?.exitCode ?? 1,
-		code: dataError.code
-	});
-}
-
 //#endregion
 //#region src/utility/miscellaneous/parseZodSchemaForProgram.ts
 function parseZodSchemaForProgram(program, schema, data) {
@@ -1371,7 +1264,6 @@ function parseZodSchemaForProgram(program, schema, data) {
 		throw error;
 	}
 }
-
 //#endregion
 //#region src/cli/commands/version/format.ts
 const versionFormatOptionsBaseSchema = z.object({ prefix: z.boolean().optional() });
@@ -1396,7 +1288,6 @@ function versionFormat(program) {
 		}));
 	});
 }
-
 //#endregion
 //#region src/cli/commands/version/increment.ts
 function versionIncrement(program) {
@@ -1412,7 +1303,6 @@ function versionIncrement(program) {
 		console.info(version.increment(incrementType).format({ omitPrefix: !prefix }));
 	});
 }
-
 //#endregion
 //#region src/cli/commands/version/type.ts
 function versionType(program) {
@@ -1422,7 +1312,6 @@ function versionType(program) {
 		console.info(version.type);
 	});
 }
-
 //#endregion
 //#region src/cli/commands/version/index.ts
 function version(program) {
@@ -1432,7 +1321,6 @@ function version(program) {
 		versionType
 	});
 }
-
 //#endregion
 //#region src/cli/commands/package-json/check/noFileDependencies.ts
 function findFileDependencies(dependencies) {
@@ -1452,14 +1340,13 @@ async function noFileDependencies(program) {
 	};
 	if (Object.keys(allFileDependencies.dependencies ?? {}).length === 0) delete allFileDependencies.dependencies;
 	if (Object.keys(allFileDependencies.devDependencies ?? {}).length === 0) delete allFileDependencies.devDependencies;
-	if (Object.keys(allFileDependencies).length !== 0) program.error(`${errorPrefix}: File dependencies found:\n\n${JSON.stringify(allFileDependencies, void 0, 2)}
+	if (Object.keys(allFileDependencies).length !== 0) program.error(`${errorPrefix} File dependencies found:\n\n${JSON.stringify(allFileDependencies, void 0, 2)}
           `, {
 		exitCode: 2,
 		code: "FILE_DEPENDENCIES_FOUND"
 	});
 	console.info(`${successPrefix} No file dependencies found!`);
 }
-
 //#endregion
 //#region src/cli/commands/package-json/check/noPreReleaseDependencies.ts
 function isPreRelease(dependencyVersionRange) {
@@ -1476,7 +1363,7 @@ async function noPreReleaseDependencies(program) {
 	for (const [dependencyName, dependencyVersionRange] of Object.entries(dependencies)) if (isPreRelease(dependencyVersionRange)) preReleaseDependencies[dependencyName] = dependencyVersionRange;
 	for (const [dependencyName, dependencyVersionRange] of Object.entries(devDependencies)) if (isPreRelease(dependencyVersionRange)) preReleaseDevDependencies[dependencyName] = dependencyVersionRange;
 	if (Object.keys(preReleaseDependencies).length !== 0 || Object.keys(preReleaseDevDependencies).length !== 0) program.error(normaliseIndents`
-            ${errorPrefix}: Pre-release version pinning is not allowed. Found the following violations:
+            ${errorPrefix} Pre-release version pinning is not allowed. Found the following violations:
 
         ` + JSON.stringify({
 		dependencies: preReleaseDependencies,
@@ -1487,7 +1374,6 @@ async function noPreReleaseDependencies(program) {
 	});
 	console.info(`${successPrefix} No pre-release versions found!`);
 }
-
 //#endregion
 //#region src/cli/commands/package-json/check/index.ts
 const RuleName = {
@@ -1504,13 +1390,11 @@ function packageJsonCheck(program) {
 		console.info(`${successPrefix} Success! All checks passed!`);
 	});
 }
-
 //#endregion
 //#region src/cli/commands/package-json/index.ts
 function packageJson(program) {
 	loadCommands(program.command("package-json").description("Manage the package.json file"), { packageJsonCheck });
 }
-
 //#endregion
 //#region src/cli/commands/index.ts
 function createCommands(program) {
@@ -1528,7 +1412,6 @@ function createCommands(program) {
 		version
 	});
 }
-
 //#endregion
 //#region src/utility/errors/formatError.ts
 function formatError(error) {
@@ -1551,24 +1434,20 @@ function formatError(error) {
 	}
 	throw error;
 }
-
 //#endregion
 //#region src/cache/global/createAlexCLineGlobalCache.ts
 async function createAlexCLineGlobalCache(cacheData) {
 	await mkdir(ALEX_C_LINE_GLOBAL_CACHE_DIRECTORY, { recursive: true });
 	await writeFile(ALEX_C_LINE_GLOBAL_CACHE_PATH, `${JSON.stringify(cacheData, null, 2)}\n`);
 }
-
 //#endregion
 //#region src/cache/global/types/AlexCLineGlobalCache.ts
 const alexCLineGlobalCacheSchema = z.looseObject({ updateChecks: z.record(z.string(), z.string()).optional() });
-
 //#endregion
 //#region src/cache/global/parseAlexCLineGlobalCache.ts
 function parseAlexCLineGlobalCache(input) {
 	return parseZodSchema(alexCLineGlobalCacheSchema, input);
 }
-
 //#endregion
 //#region src/cache/global/loadAlexCLineGlobalCache.ts
 async function loadAlexCLineGlobalCache() {
@@ -1579,7 +1458,6 @@ async function loadAlexCLineGlobalCache() {
 		throw error;
 	}
 }
-
 //#endregion
 //#region src/utility/updates/runAutomatedUpdateCheck.ts
 async function runAutomatedUpdateCheck() {
@@ -1599,7 +1477,6 @@ async function runAutomatedUpdateCheck() {
 		}
 	} catch {}
 }
-
 //#endregion
 //#region src/cli/index.ts
 (async () => {
@@ -1613,6 +1490,5 @@ async function runAutomatedUpdateCheck() {
 		formatError(error);
 	}
 })();
-
 //#endregion
-export {  };
+export {};