alex-c-line 2.0.0 → 2.0.1

package/README.md

@@ -7,7 +7,7 @@
 [![CI](https://github.com/alextheman231/alex-c-line/actions/workflows/ci.yml/badge.svg)](https://github.com/alextheman231/alex-c-line/actions/workflows/ci.yml)
 [![Publish to NPM Registry and GitHub Releases](https://github.com/alextheman231/alex-c-line/actions/workflows/publish.yml/badge.svg)](https://github.com/alextheman231/alex-c-line/actions/workflows/publish.yml)
 
-<img src="./artwork/alex-c-line.png" alt="alex-c-line artwork" width=250 height=250>
+<img src="./media/alex-c-line.png" alt="alex-c-line artwork" width=250 height=250>
 
 This is my command-line tool, which serves as a developer toolkit that can be used in any repository to streamline the developer workflow. It provides a flexible configuration system so you can customise its behaviour to match your workflow.
 
@@ -40,24 +40,24 @@ alex-c-line say-hello
 Some commands may even take extra arguments. For example:
 
 ```bash
-alex-c-line increment-version v1.2.3 major
+alex-c-line version increment v1.2.3 major
 ```
 
 Flags may also be passed through in the following way.
 
 ```bash
-alex-c-line increment-version v1.2.3 major --no-prefix
+alex-c-line version increment v1.2.3 major --no-prefix
 ```
 
-Note that for `use-local-package` specifically, you will need to add `--` before the local `alex-c-line` arguments to ensure that all flags get passed through correctly. Example:
+Note that for `local-package use` specifically, you will need to add `--` before the local `alex-c-line` arguments to ensure that all flags get passed through correctly. Example:
 
 ```bash
-alex-c-line use-local-package alex-c-line -- increment-version v1.2.3 major --no-prefix
+alex-c-line local-package use alex-c-line -- version increment v1.2.3 major --no-prefix
 ```
 
 ## Configs
 
-Some commands also support usage of the config system. For example, `pre-commit-2` supports the `alex-c-line.config.js` file, and `use-local-package` supports the more user-specific `.alex-c-line.private.config.js` file. `alex-c-line.config.js` is intended for shared configurations per repository, whereas `.alex-c-line.private.config.js` are for configurations specific to the user's usage.
+Some commands also support usage of the config system. For example, `pre-commit` supports the `alex-c-line.config.js` file, and `local-package use` supports the more user-specific `.alex-c-line.private.config.js` file. `alex-c-line.config.js` is intended for shared configurations per repository, whereas `.alex-c-line.private.config.js` are for configurations specific to the user's usage.
 
 The `configs` subpath provides some helper functions and types that may be helpful when constructing these configs. Namely, `defineAlexCLineConfig` can be used as a type helper, so that you get better type hints in the editor.
 
@@ -65,9 +65,11 @@ The `configs` subpath provides some helper functions and types that may be helpf
 import { defineAlexCLineConfig } from "alex-c-line/configs";
 
 export default defineAlexCLineConfig({
-  createPullRequestTemplate: {
-    category: "general",
-    projectType: "package",
+  template: {
+    pullRequest: {
+      category: "general",
+      projectType: "package",
+    }
   },
   preCommit: {
     packageManager: "pnpm",
@@ -84,9 +86,11 @@ import type { AlexCLineConfig } from "alex-c-line/configs";
 import { scripts } from "./package.json" with { type: "json" };
 
 const alexCLineConfig: AlexCLineConfig<keyof typeof scripts> = {
-  createPullRequestTemplate: {
-    category: "general",
-    projectType: "package",
+  template: {
+    pullRequest: {
+      category: "general",
+      projectType: "package",
+    }
   },
   preCommit: {
     packageManager: "pnpm",

package/dist/configs/index.d.cts

@@ -9,14 +9,14 @@ interface BaseOptions {
 }
 interface StepRunner<ExecaOptions extends Options = BaseOptions> {
   <NewOpts extends Options>(options: NewOpts): StepRunner<ExecaOptions & NewOpts>;
-  (command: string, args?: readonly string[]): Promise<Result<ExecaOptions>>;
-  (strings: TemplateStringsArray, ...interpolations: TemplateExpression[]): Promise<Result<ExecaOptions>>;
+  (command: string, args?: ReadonlyArray<string>): Promise<Result<ExecaOptions>>;
+  (strings: TemplateStringsArray, ...interpolations: Array<TemplateExpression>): Promise<Result<ExecaOptions>>;
 }
 //#endregion
 //#region src/configs/types/preCommit/PreCommitConfig.d.ts
 interface PreCommitStepOptions {
   /** Arguments to pass to the given script */
-  arguments?: string[];
+  arguments?: Array<string>;
 }
 type StepFunction = (stepRunner: StepRunner) => void | Promise<void>;
 interface PreCommitConfig<ScriptName extends string = string> {
@@ -25,7 +25,7 @@ interface PreCommitConfig<ScriptName extends string = string> {
   /** Allow the hook to run even if there are no staged changes. */
   allowNoStagedChanges?: boolean;
   /** The steps to run in the pre-commit hook. */
-  steps: (StepFunction | ScriptName | [ScriptName, PreCommitStepOptions])[];
+  steps: Array<StepFunction | ScriptName | [ScriptName, PreCommitStepOptions]>;
   /** Update the git index after the run */
   updateIndex?: boolean;
 }
@@ -96,7 +96,7 @@ declare function definePreCommitConfig<ScriptName extends string = string>(confi
 //#region src/configs/types/preCommit/PreCommitPrivateConfig.d.ts
 interface PreCommitPrivateConfig<ScriptName extends string = string> {
   /** List of script names to skip */
-  disableSteps?: ScriptName[];
+  disableSteps?: Array<ScriptName>;
 }
 //#endregion
 //#region src/configs/helpers/preCommit/definePreCommitPrivateConfig.d.ts

package/dist/configs/index.d.ts

@@ -10,14 +10,14 @@ interface BaseOptions {
 }
 interface StepRunner<ExecaOptions extends Options = BaseOptions> {
   <NewOpts extends Options>(options: NewOpts): StepRunner<ExecaOptions & NewOpts>;
-  (command: string, args?: readonly string[]): Promise<Result<ExecaOptions>>;
-  (strings: TemplateStringsArray, ...interpolations: TemplateExpression[]): Promise<Result<ExecaOptions>>;
+  (command: string, args?: ReadonlyArray<string>): Promise<Result<ExecaOptions>>;
+  (strings: TemplateStringsArray, ...interpolations: Array<TemplateExpression>): Promise<Result<ExecaOptions>>;
 }
 //#endregion
 //#region src/configs/types/preCommit/PreCommitConfig.d.ts
 interface PreCommitStepOptions {
   /** Arguments to pass to the given script */
-  arguments?: string[];
+  arguments?: Array<string>;
 }
 type StepFunction = (stepRunner: StepRunner) => void | Promise<void>;
 interface PreCommitConfig<ScriptName extends string = string> {
@@ -26,7 +26,7 @@ interface PreCommitConfig<ScriptName extends string = string> {
   /** Allow the hook to run even if there are no staged changes. */
   allowNoStagedChanges?: boolean;
   /** The steps to run in the pre-commit hook. */
-  steps: (StepFunction | ScriptName | [ScriptName, PreCommitStepOptions])[];
+  steps: Array<StepFunction | ScriptName | [ScriptName, PreCommitStepOptions]>;
   /** Update the git index after the run */
   updateIndex?: boolean;
 }
@@ -97,7 +97,7 @@ declare function definePreCommitConfig<ScriptName extends string = string>(confi
 //#region src/configs/types/preCommit/PreCommitPrivateConfig.d.ts
 interface PreCommitPrivateConfig<ScriptName extends string = string> {
   /** List of script names to skip */
-  disableSteps?: ScriptName[];
+  disableSteps?: Array<ScriptName>;
 }
 //#endregion
 //#region src/configs/helpers/preCommit/definePreCommitPrivateConfig.d.ts

package/dist/configs/internal/index.d.cts

@@ -8,14 +8,14 @@ interface BaseOptions {
 }
 interface StepRunner<ExecaOptions extends Options = BaseOptions> {
   <NewOpts extends Options>(options: NewOpts): StepRunner<ExecaOptions & NewOpts>;
-  (command: string, args?: readonly string[]): Promise<Result<ExecaOptions>>;
-  (strings: TemplateStringsArray, ...interpolations: TemplateExpression[]): Promise<Result<ExecaOptions>>;
+  (command: string, args?: ReadonlyArray<string>): Promise<Result<ExecaOptions>>;
+  (strings: TemplateStringsArray, ...interpolations: Array<TemplateExpression>): Promise<Result<ExecaOptions>>;
 }
 //#endregion
 //#region src/configs/types/preCommit/PreCommitConfig.d.ts
 interface PreCommitStepOptions {
   /** Arguments to pass to the given script */
-  arguments?: string[];
+  arguments?: Array<string>;
 }
 type StepFunction = (stepRunner: StepRunner) => void | Promise<void>;
 interface PreCommitConfig<ScriptName extends string = string> {
@@ -24,7 +24,7 @@ interface PreCommitConfig<ScriptName extends string = string> {
   /** Allow the hook to run even if there are no staged changes. */
   allowNoStagedChanges?: boolean;
   /** The steps to run in the pre-commit hook. */
-  steps: (StepFunction | ScriptName | [ScriptName, PreCommitStepOptions])[];
+  steps: Array<StepFunction | ScriptName | [ScriptName, PreCommitStepOptions]>;
   /** Update the git index after the run */
   updateIndex?: boolean;
 }
@@ -114,7 +114,7 @@ declare const PreCommitStep: {
 type PreCommitStep = "build" | "format" | "lint" | "test";
 //#endregion
 //#region src/configs/internal/packageConfig.d.ts
-declare function packageConfig<ScriptName extends string = PreCommitStep>(steps?: (StepFunction | ScriptName | PreCommitStep | [ScriptName | PreCommitStep, PreCommitStepOptions])[]): AlexCLineConfig<PreCommitStep>;
+declare function packageConfig<ScriptName extends string = PreCommitStep>(steps?: Array<StepFunction | ScriptName | PreCommitStep | [ScriptName | PreCommitStep, PreCommitStepOptions]>): AlexCLineConfig<PreCommitStep>;
 //#endregion
 //#region src/configs/internal/testConfig.d.ts
 declare const testConfig: AlexCLineConfig<"artwork">;

package/dist/configs/internal/index.d.ts

@@ -1,6 +1,5 @@
 import { PackageManager } from "@alextheman/utility/internal";
 import { Options, Result, TemplateExpression } from "execa";
-import "@alextheman/utility";
 
 //#region src/cli/commands/root/pre-commit/createStepRunner.d.ts
 interface BaseOptions {
@@ -9,14 +8,14 @@ interface BaseOptions {
 }
 interface StepRunner<ExecaOptions extends Options = BaseOptions> {
   <NewOpts extends Options>(options: NewOpts): StepRunner<ExecaOptions & NewOpts>;
-  (command: string, args?: readonly string[]): Promise<Result<ExecaOptions>>;
-  (strings: TemplateStringsArray, ...interpolations: TemplateExpression[]): Promise<Result<ExecaOptions>>;
+  (command: string, args?: ReadonlyArray<string>): Promise<Result<ExecaOptions>>;
+  (strings: TemplateStringsArray, ...interpolations: Array<TemplateExpression>): Promise<Result<ExecaOptions>>;
 }
 //#endregion
 //#region src/configs/types/preCommit/PreCommitConfig.d.ts
 interface PreCommitStepOptions {
   /** Arguments to pass to the given script */
-  arguments?: string[];
+  arguments?: Array<string>;
 }
 type StepFunction = (stepRunner: StepRunner) => void | Promise<void>;
 interface PreCommitConfig<ScriptName extends string = string> {
@@ -25,7 +24,7 @@ interface PreCommitConfig<ScriptName extends string = string> {
   /** Allow the hook to run even if there are no staged changes. */
   allowNoStagedChanges?: boolean;
   /** The steps to run in the pre-commit hook. */
-  steps: (StepFunction | ScriptName | [ScriptName, PreCommitStepOptions])[];
+  steps: Array<StepFunction | ScriptName | [ScriptName, PreCommitStepOptions]>;
   /** Update the git index after the run */
   updateIndex?: boolean;
 }
@@ -115,7 +114,7 @@ declare const PreCommitStep: {
 type PreCommitStep = "build" | "format" | "lint" | "test";
 //#endregion
 //#region src/configs/internal/packageConfig.d.ts
-declare function packageConfig<ScriptName extends string = PreCommitStep>(steps?: (StepFunction | ScriptName | PreCommitStep | [ScriptName | PreCommitStep, PreCommitStepOptions])[]): AlexCLineConfig<PreCommitStep>;
+declare function packageConfig<ScriptName extends string = PreCommitStep>(steps?: Array<StepFunction | ScriptName | PreCommitStep | [ScriptName | PreCommitStep, PreCommitStepOptions]>): AlexCLineConfig<PreCommitStep>;
 //#endregion
 //#region src/configs/internal/testConfig.d.ts
 declare const testConfig: AlexCLineConfig<"artwork">;

package/dist/index.cjs

@@ -192,7 +192,7 @@ function cache(program) {
 
 //#endregion
 //#region src/utility/constants/errorPrefix.ts
-const errorPrefix = "❌ ERROR";
+const errorPrefix = "❌ ERROR:";
 
 //#endregion
 //#region src/utility/envFile/upsertDotenvFile.ts
@@ -205,14 +205,14 @@ async function upsertDotenvFile(contents, envFilePath) {
 async function addVariable(program, envFileContents, file) {
 	const newVariableName = await (0, _inquirer_prompts.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(_alextheman_utility.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,
@@ -355,7 +355,7 @@ function checkLockfileVersionDiscrepancy(program) {
 		const { version: packageVersion } = JSON.parse(await (0, node_fs_promises.readFile)(node_path.default.resolve(process.cwd(), "package.json"), "utf-8"));
 		const { version: packageLockVersion } = JSON.parse(await (0, node_fs_promises.readFile)(node_path.default.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;
 		}
@@ -369,7 +369,7 @@ 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.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"
 		});
@@ -385,7 +385,7 @@ function gitPostMergeCleanup(program) {
 			const { stdout: changes } = await execa.execa`git diff ${branch}..${currentBranch}`;
 			if (changes) {
 				await execa.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"
 				});
@@ -395,7 +395,7 @@ function gitPostMergeCleanup(program) {
 			const { stdout: branchDeletedMessage, exitCode } = await (0, execa.execa)({ reject: false })`git branch --delete ${currentBranch}`;
 			if (exitCode !== 0) {
 				await execa.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"
 				});
@@ -653,10 +653,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 _alextheman_utility.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 _alextheman_utility.DataError({
@@ -693,8 +690,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 {
@@ -764,7 +761,7 @@ function encryptWithKey(program) {
 		try {
 			console.info(await (0, _alextheman_utility.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"
 			});
@@ -811,7 +808,7 @@ function createStepRunner(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"
 	});
@@ -837,19 +834,16 @@ async function loadAlexCLineConfig(filePath) {
 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 _alextheman_utility.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 _alextheman_utility.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 (0, execa.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"
 			});
@@ -939,12 +933,7 @@ function templatePullRequestCreate(program) {
 		const configPath = await findAlexCLineConfig(process.cwd());
 		const { template: { pullRequest: config } = {} } = configPath ? await loadAlexCLineConfig(configPath) : {};
 		const packageInfo = await (0, _alextheman_utility_internal.getPackageJsonContents)(process.cwd());
-		const { name: projectName } = commandLineOptions.projectName || config?.projectName ? { name: commandLineOptions.projectName ?? config?.projectName } : (0, _alextheman_utility.parseZodSchema)(zod.default.object({ name: zod.default.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 } : (0, _alextheman_utility.parseZodSchema)(zod.default.object({ name: zod.default.string() }), packageInfo);
 		if (!projectName) throw new _alextheman_utility.DataError({ projectName }, "PROJECT_NAME_NOT_FOUND", "Could not resolve project name.");
 		const parsedOptions = parseTemplatePullRequestConfig((0, _alextheman_utility.removeUndefinedFromObject)({
 			category: commandLineOptions.category ?? config?.category ?? "general",
@@ -976,6 +965,15 @@ function templatePullRequest(program) {
 //#region src/utility/constants/successPrefix.ts
 const successPrefix = chalk.default.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 = {
@@ -1082,10 +1080,7 @@ function templateReleaseNoteCheck(program) {
 			await validateReleaseDocument(name, documentVersion, fileContents, expectedReleaseStatus);
 			console.info(`${successPrefix} Release document is valid!`);
 		} catch (error) {
-			if (_alextheman_utility.DataError.check(error)) program.error(`${errorPrefix}: ${error.message}`, {
-				exitCode: 1,
-				code: error.code
-			});
+			if (_alextheman_utility.DataError.check(error)) convertDataErrorToProgramError(error, program, { exitCode: 2 });
 			else throw error;
 		}
 	});
@@ -1173,12 +1168,7 @@ function templateReleaseNoteCreate(program) {
 		const { name, version: packageVersion } = (0, _alextheman_utility.parseZodSchema)(zod.default.object({
 			name: zod.default.string(),
 			version: zod.default.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 _alextheman_utility.VersionNumber ? target : target ? new _alextheman_utility.VersionNumber(packageVersion).increment(target) : new _alextheman_utility.VersionNumber(packageVersion);
 		const releaseNotePath = getReleaseNotePath(versionNumber);
 		const releaseNoteTemplate = await getReleaseNoteTemplateFromMarkdown(name, versionNumber, { status: "In progress" });
@@ -1186,7 +1176,7 @@ function templateReleaseNoteCreate(program) {
 			await (0, node_fs_promises.mkdir)(node_path.default.dirname(releaseNotePath), { recursive: true });
 			await (0, node_fs_promises.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"
 			});
@@ -1273,10 +1263,7 @@ 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 (0, _alextheman_utility_internal.getPackageJsonContents)(process.cwd());
 		const { name } = (0, _alextheman_utility.parseZodSchema)(zod.default.object({ name: zod.default.string() }), packageInfo, new _alextheman_utility.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 _alextheman_utility.DataError({ documentPath }, "INVALID_FILE_PATH", "Invalid file path. Path must lead to a .md file.");
 		const versionNumber = new _alextheman_utility.VersionNumber(node_path.default.basename(documentPath).split(".").filter((part) => {
 			return part !== "md";
 		}).join("."));
@@ -1321,7 +1308,7 @@ function template(program) {
 //#endregion
 //#region package.json
 var name = "alex-c-line";
-var version$1 = "2.0.0";
+var version$1 = "2.0.1";
 var description = "Command-line tool with commands to streamline the developer workflow.";
 
 //#endregion
@@ -1387,15 +1374,6 @@ 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) {
@@ -1487,7 +1465,7 @@ 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"
@@ -1511,7 +1489,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(_alextheman_utility.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,

package/dist/index.js

@@ -157,7 +157,7 @@ function cache(program) {
 
 //#endregion
 //#region src/utility/constants/errorPrefix.ts
-const errorPrefix = "❌ ERROR";
+const errorPrefix = "❌ ERROR:";
 
 //#endregion
 //#region src/utility/envFile/upsertDotenvFile.ts
@@ -170,14 +170,14 @@ async function upsertDotenvFile(contents, envFilePath) {
 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,
@@ -320,7 +320,7 @@ 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;
 		}
@@ -334,7 +334,7 @@ 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 +350,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 +360,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"
 				});
@@ -618,10 +618,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 +655,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 {
@@ -729,7 +726,7 @@ 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"
 			});
@@ -776,7 +773,7 @@ function createStepRunner(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"
 	});
@@ -802,19 +799,16 @@ async function loadAlexCLineConfig(filePath) {
 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"
 			});
@@ -904,12 +898,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",
@@ -941,6 +930,15 @@ function templatePullRequest(program) {
 //#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 = {
@@ -1047,10 +1045,7 @@ 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;
 		}
 	});
@@ -1138,12 +1133,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 +1141,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"
 			});
@@ -1238,10 +1228,7 @@ 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("."));
@@ -1286,7 +1273,7 @@ function template(program) {
 //#endregion
 //#region package.json
 var name = "alex-c-line";
-var version$1 = "2.0.0";
+var version$1 = "2.0.1";
 var description = "Command-line tool with commands to streamline the developer workflow.";
 
 //#endregion
@@ -1352,15 +1339,6 @@ 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) {
@@ -1452,7 +1430,7 @@ 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"
@@ -1476,7 +1454,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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alex-c-line",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Command-line tool with commands to streamline the developer workflow.",
   "repository": {
     "type": "git",
@@ -52,7 +52,7 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@alextheman/eslint-plugin": "^5.9.1",
+    "@alextheman/eslint-plugin": "^5.10.0",
     "@commander-js/extra-typings": "^14.0.0",
     "@types/eslint": "^9.6.1",
     "@types/node": "^25.3.2",