alex-c-line 1.17.2 → 1.17.3

package/dist/index.cjs

@@ -53,8 +53,8 @@ function findFileDependencies(dependencies$1) {
 	for (const dependency in dependencies$1) if (dependencies$1[dependency].includes("file:")) fileDependencies[dependency] = dependencies$1[dependency];
 	return fileDependencies;
 }
-function checkForFileDependencies(program$1) {
-	program$1.command("check-for-file-dependencies").description("Check for existence of file dependencies in package.json and give exit code 1 if such dependencies are found").action(async () => {
+function checkForFileDependencies(program) {
+	program.command("check-for-file-dependencies").description("Check for existence of file dependencies in package.json and give exit code 1 if such dependencies are found").action(async () => {
 		console.info("Checking for file dependencies...");
 		const { dependencies: dependencies$1, devDependencies: devDependencies$1, peerDependencies } = JSON.parse(await (0, node_fs_promises.readFile)(node_path.default.resolve(process.cwd(), "package.json"), "utf-8"));
 		const allFileDependencies = {
@@ -65,7 +65,7 @@ function checkForFileDependencies(program$1) {
 		if (Object.keys(allFileDependencies.dependencies ?? {}).length === 0) delete allFileDependencies.dependencies;
 		if (Object.keys(allFileDependencies.devDependencies ?? {}).length === 0) delete allFileDependencies.devDependencies;
 		if (Object.keys(allFileDependencies.peerDependencies ?? {}).length === 0) delete allFileDependencies.peerDependencies;
-		if (Object.keys(allFileDependencies).length !== 0) program$1.error(`ERROR: File dependencies found:\n\n${JSON.stringify(allFileDependencies, void 0, 2)}
+		if (Object.keys(allFileDependencies).length !== 0) program.error(`ERROR: File dependencies found:\n\n${JSON.stringify(allFileDependencies, void 0, 2)}
           `, {
 			exitCode: 1,
 			code: "FILE_DEPENDENCIES_FOUND"
@@ -77,8 +77,8 @@ var check_for_file_dependencies_default = checkForFileDependencies;
 
 //#endregion
 //#region src/commands/check-lockfile-version-discrepancy.ts
-function checkLockfileVersionDiscrepancy(program$1) {
-	program$1.command("check-lockfile-version-discrepancy").description("Check that version numbers in package.json and package-lock.json match").action(() => {
+function checkLockfileVersionDiscrepancy(program) {
+	program.command("check-lockfile-version-discrepancy").description("Check that version numbers in package.json and package-lock.json match").action(() => {
 		console.info("Checking for package.json and package-lock.json discrepancies...");
 		const { version: packageVersion } = JSON.parse((0, node_fs.readFileSync)(node_path.default.resolve(process.cwd(), "package.json"), "utf-8"));
 		const { version: packageLockVersion } = JSON.parse((0, node_fs.readFileSync)(node_path.default.resolve(process.cwd(), "package-lock.json"), "utf-8"));
@@ -113,8 +113,8 @@ async function execaNoFail(command, args, options) {
 
 //#endregion
 //#region src/commands/check-version-number-change.ts
-function checkVersionNumberChange(program$1) {
-	program$1.command("check-version-number-change").description("Check that version number on branch has changed if source code differs between main and current branch").action(async () => {
+function checkVersionNumberChange(program) {
+	program.command("check-version-number-change").description("Check that version number on branch has changed if source code differs between main and current branch").action(async () => {
 		console.info("Checking for version change...");
 		const { exitCode } = await execaNoFail("git", [
 			"diff",
@@ -133,7 +133,7 @@ function checkVersionNumberChange(program$1) {
 		const newMajorVersion = `${parseInt(currentBranchMajor) + 1}.0.0`;
 		const newMinorVersion = `${currentBranchMajor}.${parseInt(currentBranchMinor) + 1}.0`;
 		const newPatchVersion = `${currentBranchMajor}.${currentBranchMinor}.${parseInt(currentBranchPatch) + 1}`;
-		if (mainPackageVersion === currentBranchPackageVersion) program$1.error(_alextheman_utility.normaliseIndents`
+		if (mainPackageVersion === currentBranchPackageVersion) program.error(_alextheman_utility.normaliseIndents`
             ❌ Version needs updating. Please run one of the following:
             - npm version major -m "Change version number to v%s" (v${mainPackageVersion} -> v${newMajorVersion})
             - npm version minor -m "Change version number to v%s" (v${mainPackageVersion} -> v${newMinorVersion})
@@ -217,8 +217,8 @@ var getPullRequestTemplates_default = getPullRequestTemplates;
 
 //#endregion
 //#region src/commands/create-pull-request-templates.ts
-function createPullRequestTemplates(program$1) {
-	program$1.command("create-pull-request-templates").description("Create the standard pull request templates as found in my repositories").action(async () => {
+function createPullRequestTemplates(program) {
+	program.command("create-pull-request-templates").description("Create the standard pull request templates as found in my repositories").action(async () => {
 		const { name: name$1 } = JSON.parse(await (0, node_fs_promises.readFile)(node_path.default.join(process.cwd(), "package.json"), "utf-8"));
 		const gitHubPath = node_path.default.join(process.cwd(), ".github");
 		const pullRequestTemplatePath = node_path.default.join(gitHubPath, "PULL_REQUEST_TEMPLATE");
@@ -312,10 +312,10 @@ var getReleaseNoteTemplate_default = getReleaseNoteTemplate;
 
 //#endregion
 //#region src/commands/create-release-note.ts
-function createReleaseNote(program$1) {
-	program$1.command("create-release-note").argument("[versionType]", "The version type to increment by (`major|minor|patch`). Note that this performs the version calculation without changing package.json. If left blank it will use the version in package.json").description("Create release notes based on the current version in package.json.").action(async (versionType) => {
+function createReleaseNote(program) {
+	program.command("create-release-note").argument("[versionType]", "The version type to increment by (`major|minor|patch`). Note that this performs the version calculation without changing package.json. If left blank it will use the version in package.json", _alextheman_utility.parseVersionType).description("Create release notes based on the current version in package.json.").action(async (versionType) => {
 		const { name: name$1, version: version$1 } = JSON.parse(await (0, node_fs_promises.readFile)(node_path.default.join(process.cwd(), "package.json"), "utf-8"));
-		const versionNumber = versionType ? new _alextheman_utility.VersionNumber(version$1).increment((0, _alextheman_utility.parseVersionType)(versionType)) : new _alextheman_utility.VersionNumber(version$1);
+		const versionNumber = versionType ? new _alextheman_utility.VersionNumber(version$1).increment(versionType) : new _alextheman_utility.VersionNumber(version$1);
 		const releaseNotePath = `${`docs/releases/${versionNumber.type}`}/${versionNumber}.md`;
 		const fullReleaseNotePath = node_path.default.join(process.cwd(), releaseNotePath);
 		const releaseNoteTemplate = getReleaseNoteTemplate_default(name$1, versionNumber, "In progress");
@@ -323,7 +323,7 @@ function createReleaseNote(program$1) {
 			await (0, node_fs_promises.mkdir)(node_path.default.dirname(fullReleaseNotePath), { recursive: true });
 			await (0, node_fs_promises.writeFile)(fullReleaseNotePath, releaseNoteTemplate, { flag: "wx" });
 		} catch (error) {
-			if (error instanceof Error && "code" in error && error.code === "EEXIST") program$1.error("❌ ERROR: Release notes already exist.", {
+			if (error instanceof Error && "code" in error && error.code === "EEXIST") program.error("❌ ERROR: Release notes already exist.", {
 				exitCode: 1,
 				code: "RELEASE_NOTE_EXISTS"
 			});
@@ -336,8 +336,8 @@ var create_release_note_default = createReleaseNote;
 
 //#endregion
 //#region src/commands/edit-env.ts
-function editEnv(program$1) {
-	program$1.command("edit-env <key> [value]").description("Edit property in .env file (leave value blank to delete property)").option("--file <file>", "The file to edit", ".env").action(async (key, value, { file }) => {
+function editEnv(program) {
+	program.command("edit-env <key> [value]").description("Edit property in .env file (leave value blank to delete property)").option("--file <file>", "The file to edit", ".env").action(async (key, value, { file }) => {
 		let newValue = value;
 		if (typeof newValue === "string" && newValue.startsWith("--")) newValue = void 0;
 		let currentEnvFileContents;
@@ -356,12 +356,12 @@ var edit_env_default = editEnv;
 
 //#endregion
 //#region src/commands/encrypt-with-key.ts
-function encryptWithKey(program$1) {
-	program$1.command("encrypt-with-key").alias("encrypt").description("Encrypt a secret given the public base64 key and the thing you want to encrypt.").argument("<publicKey>", "The public base64 key to encrypt with").argument("<plaintextValue>", "The value to encrypt in plaintext").action(async (publicKey, plaintextValue) => {
+function encryptWithKey(program) {
+	program.command("encrypt-with-key").alias("encrypt").description("Encrypt a secret given the public base64 key and the thing you want to encrypt.").argument("<publicKey>", "The public base64 key to encrypt with").argument("<plaintextValue>", "The value to encrypt in plaintext").action(async (publicKey, plaintextValue) => {
 		try {
 			console.info(await (0, _alextheman_utility.encryptWithKey)(publicKey, plaintextValue));
 		} catch {
-			program$1.error("Encryption failed. Please double-check that the given key is a valid base 64 string.", {
+			program.error("Encryption failed. Please double-check that the given key is a valid base 64 string.", {
 				exitCode: 1,
 				code: "ENCRYPTION_FAILED"
 			});
@@ -372,17 +372,19 @@ var encrypt_with_key_default = encryptWithKey;
 
 //#endregion
 //#region src/commands/get-version-type.ts
-function getVersionType(program$1) {
-	program$1.command("get-version-type").description("Gets the version type of the given version number.").argument("<version>", "The version to get the version type from").action((version$1) => {
-		console.info(new _alextheman_utility.VersionNumber(version$1).type);
+function getVersionType(program) {
+	program.command("get-version-type").description("Gets the version type of the given version number.").argument("<version>", "The version to get the version type from", (rawVersion) => {
+		return new _alextheman_utility.VersionNumber(rawVersion);
+	}).action((version$1) => {
+		console.info(version$1.type);
 	});
 }
 var get_version_type_default = getVersionType;
 
 //#endregion
 //#region src/commands/git-post-merge-cleanup.ts
-function gitPostMergeCleanup(program$1) {
-	program$1.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").action(async (branch, { rebase: rebaseOption }) => {
+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").action(async (branch, { rebase: rebaseOption }) => {
 		let alexCLineConfigJSON;
 		try {
 			alexCLineConfigJSON = await (0, node_fs_promises.readFile)(node_path.default.join(process.env.HOME ?? node_os.default.homedir(), "alex-c-line-config.json"), "utf-8");
@@ -391,7 +393,7 @@ function gitPostMergeCleanup(program$1) {
 		const rebase = JSON.parse(alexCLineConfigJSON)["git-post-merge-cleanup"]?.rebase ?? rebaseOption;
 		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$1.error(`❌ ERROR: Cannot run cleanup on ${branch} branch!`, {
+		if (currentBranch === branch) program.error(`❌ ERROR: Cannot run cleanup on ${branch} branch!`, {
 			exitCode: 1,
 			code: "INVALID_BRANCH"
 		});
@@ -419,7 +421,7 @@ function gitPostMergeCleanup(program$1) {
 			const { stdout: changes } = await execa.execa`git diff ${branch}..${currentBranch}`;
 			if (changes) {
 				await execa.execa`git checkout ${currentBranch}`;
-				program$1.error("❌ ERROR: Changes on branch not fully merged!", {
+				program.error("❌ ERROR: Changes on branch not fully merged!", {
 					exitCode: 1,
 					code: "CHANGES_NOT_MERGED"
 				});
@@ -435,7 +437,7 @@ function gitPostMergeCleanup(program$1) {
 		} catch (error) {
 			if (error instanceof execa.ExecaError) {
 				await execa.execa`git checkout ${currentBranch}`;
-				program$1.error("❌ ERROR: Changes on branch not fully merged!", {
+				program.error("❌ ERROR: Changes on branch not fully merged!", {
 					exitCode: 1,
 					code: "CHANGES_NOT_MERGED"
 				});
@@ -447,15 +449,17 @@ var git_post_merge_cleanup_default = gitPostMergeCleanup;
 
 //#endregion
 //#region src/commands/increment-version.ts
-function incrementVersion(program$1) {
-	program$1.command("increment-version").description("Increments the given input version depending on the given increment type.").argument("<version>", "The version to increment").argument("<incrementType>", _alextheman_utility.normaliseIndents`
+function incrementVersion(program) {
+	program.command("increment-version").description("Increments the given input version depending on the given increment type.").argument("<version>", "The version to increment", (rawVersion) => {
+		return new _alextheman_utility.VersionNumber(rawVersion);
+	}).argument("<incrementType>", _alextheman_utility.normaliseIndents`
             The type of increment. Can be one of the following:
 
             - "major": Change the major version v1.2.3 → v2.0.0
             - "minor": Change the minor version v1.2.3 → v1.3.0
             - "patch": Change the patch version v1.2.3 → v1.2.4
-        `).option("--no-prefix").option("--prefix", "Whether to add the `v` prefix from the output version or not (defaults to true).").action((version$1, incrementType, { prefix }) => {
-		console.info(new _alextheman_utility.VersionNumber(version$1).increment((0, _alextheman_utility.parseVersionType)(incrementType)).toString({ omitPrefix: !prefix }));
+        `, _alextheman_utility.parseVersionType).option("--no-prefix").option("--prefix", "Whether to add the `v` prefix from the output version or not (defaults to true).").action((version$1, incrementType, { prefix }) => {
+		console.info(version$1.increment(incrementType).toString({ omitPrefix: !prefix }));
 	});
 }
 var increment_version_default = incrementVersion;
@@ -463,8 +467,8 @@ var increment_version_default = incrementVersion;
 //#endregion
 //#region src/commands/pre-commit.ts
 const deprecationMessage = "[DEPRECATED]: This command does not support the new alex-c-line config system. Please use `pre-commit-2` instead.";
-function preCommit(program$1) {
-	program$1.command("pre-commit").description(_alextheman_utility.normaliseIndents`
+function preCommit(program) {
+	program.command("pre-commit").description(_alextheman_utility.normaliseIndents`
         ${deprecationMessage}
         Run the standard pre-commits used across all my repositories.`).option("--no-build", "Skip the build").option("--no-tests", "Skip the tests").option("--allow-unstaged", "Run even if nothing is staged").option("--repository-manager <repositoryManager>", "The repository manager if it is a monorepo (Only Turborepo is supported as of now)").action(async ({ build: shouldIncludeBuild, tests: shouldIncludeTests, allowUnstaged, repositoryManager: rawRepositoryManager }) => {
 		console.warn(deprecationMessage);
@@ -475,7 +479,7 @@ function preCommit(program$1) {
 			"--quiet"
 		]);
 		switch (diffExitCode) {
-			case 128: program$1.error("Not currently in a Git repository", {
+			case 128: program.error("Not currently in a Git repository", {
 				exitCode: 1,
 				code: "GIT_DIFF_FAILED"
 			});
@@ -488,7 +492,7 @@ function preCommit(program$1) {
 			const newArguments = [...args ?? []];
 			if (repositoryManager === "turborepo") newArguments.push("--ui=stream");
 			const result = await execaNoFail(command, newArguments, { stdio: "inherit" });
-			if (result.exitCode !== 0) program$1.error(`Command failed: ${command}${newArguments.length ? ` ${newArguments.join(" ")}` : ""}`, {
+			if (result.exitCode !== 0) program.error(`Command failed: ${command}${newArguments.length ? ` ${newArguments.join(" ")}` : ""}`, {
 				exitCode: result.exitCode ?? 1,
 				code: "PRE_COMMIT_FAILED"
 			});
@@ -583,15 +587,15 @@ var findAlexCLineConfig_default = findAlexCLineConfig;
 
 //#endregion
 //#region src/commands/pre-commit-2.ts
-function preCommit2(program$1) {
-	program$1.command("pre-commit-2").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").action(async ({ allowNoStagedChanges }) => {
+function preCommit2(program) {
+	program.command("pre-commit-2").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").action(async ({ allowNoStagedChanges }) => {
 		const configPath = await findAlexCLineConfig_default(process.cwd());
-		if (!configPath) program$1.error("Could not find the path to the alex-c-line config file. Does it exist?", {
+		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"
 		});
 		const { preCommit: preCommitConfig } = await loadAlexCLineConfig_default(configPath);
-		if (!preCommitConfig) program$1.error("Could not find the pre-commit config in alex-c-line config.", {
+		if (!preCommitConfig) program.error("Could not find the pre-commit config in alex-c-line config.", {
 			exitCode: 1,
 			code: "PRE_COMMIT_CONFIG_NOT_FOUND"
 		});
@@ -601,7 +605,7 @@ function preCommit2(program$1) {
 			"--quiet"
 		]);
 		switch (diffExitCode) {
-			case 128: program$1.error("Not currently in a Git repository", {
+			case 128: program.error("Not currently in a Git repository", {
 				exitCode: 1,
 				code: "GIT_DIFF_FAILED"
 			});
@@ -612,7 +616,7 @@ function preCommit2(program$1) {
 		}
 		async function runCommandAndLogToConsole(command, args) {
 			const result = await execaNoFail(command, args, { stdio: "inherit" });
-			if (result.exitCode !== 0) program$1.error(`Command failed: ${command}${args?.length ? ` ${args.join(" ")}` : ""}`, {
+			if (result.exitCode !== 0) program.error(`Command failed: ${command}${args?.length ? ` ${args.join(" ")}` : ""}`, {
 				exitCode: result.exitCode ?? 1,
 				code: "PRE_COMMIT_FAILED"
 			});
@@ -622,7 +626,7 @@ function preCommit2(program$1) {
 		const rawPackageManager = preCommitConfig.packageManager ?? (typeof packagePackageManager === "string" ? packagePackageManager.split("@")[0] : void 0);
 		const packageManager$1 = (0, _alextheman_utility.parseZodSchema)(zod.default.enum(PackageManager), rawPackageManager, new _alextheman_utility.DataError(rawPackageManager, "UNSUPPORTED_PACKAGE_MANAGER", `This repository manager is not currently supported. Only the following are supported: ${Object.values(PackageManager).join(", ")}`));
 		function getCommandArguments(script, args) {
-			if (!(script in (scripts$1 ?? {}))) program$1.error(`Could not find script \`${script}\` in package.json.`, {
+			if (!(script in (scripts$1 ?? {}))) program.error(`Could not find script \`${script}\` in package.json.`, {
 				exitCode: 1,
 				code: "SCRIPT_NOT_FOUND"
 			});
@@ -642,8 +646,8 @@ var pre_commit_2_default = preCommit2;
 
 //#endregion
 //#region src/commands/say-hello.ts
-function sayHello(program$1) {
-	program$1.command("say-hello").description("Quick test command").action(() => {
+function sayHello(program) {
+	program.command("say-hello").description("Quick test command").action(() => {
 		console.info("Hello!");
 	});
 }
@@ -662,10 +666,10 @@ var isValidReleaseDocument_default = isValidReleaseDocument;
 
 //#endregion
 //#region src/commands/set-release-status.ts
-function setReleaseStatus(program$1) {
-	program$1.command("set-release-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").action(async (documentPath) => {
+function setReleaseStatus(program) {
+	program.command("set-release-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").action(async (documentPath) => {
 		const { name: packageName } = JSON.parse(await (0, node_fs_promises.readFile)(node_path.default.join(process.cwd(), "package.json"), "utf-8"));
-		if (!documentPath.endsWith("md")) program$1.error("❌ ERROR: Invalid file path. Path must lead to a .md file.", {
+		if (!documentPath.endsWith("md")) program.error("❌ ERROR: Invalid file path. Path must lead to a .md file.", {
 			exitCode: 1,
 			code: "INVALID_FILE_PATH"
 		});
@@ -675,7 +679,7 @@ function setReleaseStatus(program$1) {
 		}).join("."));
 		const fullDocumentPath = node_path.default.join(process.cwd(), documentPath);
 		const initialDocument = await (0, node_fs_promises.readFile)(fullDocumentPath, "utf-8");
-		if (!isValidReleaseDocument_default(packageName, versionNumber, initialDocument)) program$1.error("❌ ERROR: Document does not match a valid release note template.", {
+		if (!isValidReleaseDocument_default(packageName, versionNumber, initialDocument)) program.error("❌ ERROR: Document does not match a valid release note template.", {
 			exitCode: 1,
 			code: "INVALID_RELEASE_NOTE"
 		});
@@ -687,15 +691,15 @@ var set_release_status_default = setReleaseStatus;
 
 //#endregion
 //#region src/utility/loadCommands.ts
-function loadCommands(program$1, commandMap) {
-	for (const loader of Object.values(commandMap)) loader(program$1);
+function loadCommands(program, commandMap) {
+	for (const loader of Object.values(commandMap)) loader(program);
 }
 var loadCommands_default = loadCommands;
 
 //#endregion
 //#region src/commands/index.ts
-function createCommands(program$1) {
-	loadCommands_default(program$1, {
+function createCommands(program) {
+	loadCommands_default(program, {
 		checkForFileDependencies: check_for_file_dependencies_default,
 		checkLockfileVersionDiscrepancy: check_lockfile_version_discrepancy_default,
 		checkVersionNumberChange: check_version_number_change_default,
@@ -716,7 +720,7 @@ var commands_default = createCommands;
 
 //#endregion
 //#region package.json
-var version = "1.17.2";
+var version = "1.17.3";
 var package_default = {
 	name: "alex-c-line",
 	version,
@@ -792,6 +796,7 @@ var package_default = {
 	},
 	devDependencies: {
 		"@alextheman/eslint-plugin": "^5.4.2",
+		"@commander-js/extra-typings": "^14.0.0",
 		"@types/eslint": "^9.6.1",
 		"@types/libsodium-wrappers": "^0.7.14",
 		"@types/node": "^25.0.3",
@@ -817,10 +822,12 @@ var package_default = {
 
 //#endregion
 //#region src/index.ts
-const program = new commander.Command();
-program.name("alex-c-line").description("CLI tool built by Alex").version(version);
-(0, update_notifier.default)({ pkg: package_default }).notify();
-commands_default(program);
-program.parse(process.argv);
+(async () => {
+	const program = new commander.Command();
+	program.name("alex-c-line").description("CLI tool built by Alex").version(version);
+	(0, update_notifier.default)({ pkg: package_default }).notify();
+	commands_default(program);
+	await program.parseAsync(process.argv);
+})();
 
 //#endregion

package/dist/index.js

@@ -20,8 +20,8 @@ function findFileDependencies(dependencies$1) {
 	for (const dependency in dependencies$1) if (dependencies$1[dependency].includes("file:")) fileDependencies[dependency] = dependencies$1[dependency];
 	return fileDependencies;
 }
-function checkForFileDependencies(program$1) {
-	program$1.command("check-for-file-dependencies").description("Check for existence of file dependencies in package.json and give exit code 1 if such dependencies are found").action(async () => {
+function checkForFileDependencies(program) {
+	program.command("check-for-file-dependencies").description("Check for existence of file dependencies in package.json and give exit code 1 if such dependencies are found").action(async () => {
 		console.info("Checking for file dependencies...");
 		const { dependencies: dependencies$1, devDependencies: devDependencies$1, peerDependencies } = JSON.parse(await readFile(path.resolve(process.cwd(), "package.json"), "utf-8"));
 		const allFileDependencies = {
@@ -32,7 +32,7 @@ function checkForFileDependencies(program$1) {
 		if (Object.keys(allFileDependencies.dependencies ?? {}).length === 0) delete allFileDependencies.dependencies;
 		if (Object.keys(allFileDependencies.devDependencies ?? {}).length === 0) delete allFileDependencies.devDependencies;
 		if (Object.keys(allFileDependencies.peerDependencies ?? {}).length === 0) delete allFileDependencies.peerDependencies;
-		if (Object.keys(allFileDependencies).length !== 0) program$1.error(`ERROR: File dependencies found:\n\n${JSON.stringify(allFileDependencies, void 0, 2)}
+		if (Object.keys(allFileDependencies).length !== 0) program.error(`ERROR: File dependencies found:\n\n${JSON.stringify(allFileDependencies, void 0, 2)}
           `, {
 			exitCode: 1,
 			code: "FILE_DEPENDENCIES_FOUND"
@@ -44,8 +44,8 @@ var check_for_file_dependencies_default = checkForFileDependencies;
 
 //#endregion
 //#region src/commands/check-lockfile-version-discrepancy.ts
-function checkLockfileVersionDiscrepancy(program$1) {
-	program$1.command("check-lockfile-version-discrepancy").description("Check that version numbers in package.json and package-lock.json match").action(() => {
+function checkLockfileVersionDiscrepancy(program) {
+	program.command("check-lockfile-version-discrepancy").description("Check that version numbers in package.json and package-lock.json match").action(() => {
 		console.info("Checking for package.json and package-lock.json discrepancies...");
 		const { version: packageVersion } = JSON.parse(readFileSync(path.resolve(process.cwd(), "package.json"), "utf-8"));
 		const { version: packageLockVersion } = JSON.parse(readFileSync(path.resolve(process.cwd(), "package-lock.json"), "utf-8"));
@@ -80,8 +80,8 @@ async function execaNoFail(command, args, options) {
 
 //#endregion
 //#region src/commands/check-version-number-change.ts
-function checkVersionNumberChange(program$1) {
-	program$1.command("check-version-number-change").description("Check that version number on branch has changed if source code differs between main and current branch").action(async () => {
+function checkVersionNumberChange(program) {
+	program.command("check-version-number-change").description("Check that version number on branch has changed if source code differs between main and current branch").action(async () => {
 		console.info("Checking for version change...");
 		const { exitCode } = await execaNoFail("git", [
 			"diff",
@@ -100,7 +100,7 @@ function checkVersionNumberChange(program$1) {
 		const newMajorVersion = `${parseInt(currentBranchMajor) + 1}.0.0`;
 		const newMinorVersion = `${currentBranchMajor}.${parseInt(currentBranchMinor) + 1}.0`;
 		const newPatchVersion = `${currentBranchMajor}.${currentBranchMinor}.${parseInt(currentBranchPatch) + 1}`;
-		if (mainPackageVersion === currentBranchPackageVersion) program$1.error(normaliseIndents`
+		if (mainPackageVersion === currentBranchPackageVersion) program.error(normaliseIndents`
             ❌ Version needs updating. Please run one of the following:
             - npm version major -m "Change version number to v%s" (v${mainPackageVersion} -> v${newMajorVersion})
             - npm version minor -m "Change version number to v%s" (v${mainPackageVersion} -> v${newMinorVersion})
@@ -184,8 +184,8 @@ var getPullRequestTemplates_default = getPullRequestTemplates;
 
 //#endregion
 //#region src/commands/create-pull-request-templates.ts
-function createPullRequestTemplates(program$1) {
-	program$1.command("create-pull-request-templates").description("Create the standard pull request templates as found in my repositories").action(async () => {
+function createPullRequestTemplates(program) {
+	program.command("create-pull-request-templates").description("Create the standard pull request templates as found in my repositories").action(async () => {
 		const { name: name$1 } = JSON.parse(await readFile(path.join(process.cwd(), "package.json"), "utf-8"));
 		const gitHubPath = path.join(process.cwd(), ".github");
 		const pullRequestTemplatePath = path.join(gitHubPath, "PULL_REQUEST_TEMPLATE");
@@ -279,10 +279,10 @@ var getReleaseNoteTemplate_default = getReleaseNoteTemplate;
 
 //#endregion
 //#region src/commands/create-release-note.ts
-function createReleaseNote(program$1) {
-	program$1.command("create-release-note").argument("[versionType]", "The version type to increment by (`major|minor|patch`). Note that this performs the version calculation without changing package.json. If left blank it will use the version in package.json").description("Create release notes based on the current version in package.json.").action(async (versionType) => {
+function createReleaseNote(program) {
+	program.command("create-release-note").argument("[versionType]", "The version type to increment by (`major|minor|patch`). Note that this performs the version calculation without changing package.json. If left blank it will use the version in package.json", parseVersionType).description("Create release notes based on the current version in package.json.").action(async (versionType) => {
 		const { name: name$1, version: version$1 } = JSON.parse(await readFile(path.join(process.cwd(), "package.json"), "utf-8"));
-		const versionNumber = versionType ? new VersionNumber(version$1).increment(parseVersionType(versionType)) : new VersionNumber(version$1);
+		const versionNumber = versionType ? new VersionNumber(version$1).increment(versionType) : new VersionNumber(version$1);
 		const releaseNotePath = `${`docs/releases/${versionNumber.type}`}/${versionNumber}.md`;
 		const fullReleaseNotePath = path.join(process.cwd(), releaseNotePath);
 		const releaseNoteTemplate = getReleaseNoteTemplate_default(name$1, versionNumber, "In progress");
@@ -290,7 +290,7 @@ function createReleaseNote(program$1) {
 			await mkdir(path.dirname(fullReleaseNotePath), { recursive: true });
 			await writeFile(fullReleaseNotePath, releaseNoteTemplate, { flag: "wx" });
 		} catch (error) {
-			if (error instanceof Error && "code" in error && error.code === "EEXIST") program$1.error("❌ ERROR: Release notes already exist.", {
+			if (error instanceof Error && "code" in error && error.code === "EEXIST") program.error("❌ ERROR: Release notes already exist.", {
 				exitCode: 1,
 				code: "RELEASE_NOTE_EXISTS"
 			});
@@ -303,8 +303,8 @@ var create_release_note_default = createReleaseNote;
 
 //#endregion
 //#region src/commands/edit-env.ts
-function editEnv(program$1) {
-	program$1.command("edit-env <key> [value]").description("Edit property in .env file (leave value blank to delete property)").option("--file <file>", "The file to edit", ".env").action(async (key, value, { file }) => {
+function editEnv(program) {
+	program.command("edit-env <key> [value]").description("Edit property in .env file (leave value blank to delete property)").option("--file <file>", "The file to edit", ".env").action(async (key, value, { file }) => {
 		let newValue = value;
 		if (typeof newValue === "string" && newValue.startsWith("--")) newValue = void 0;
 		let currentEnvFileContents;
@@ -323,12 +323,12 @@ var edit_env_default = editEnv;
 
 //#endregion
 //#region src/commands/encrypt-with-key.ts
-function encryptWithKey$1(program$1) {
-	program$1.command("encrypt-with-key").alias("encrypt").description("Encrypt a secret given the public base64 key and the thing you want to encrypt.").argument("<publicKey>", "The public base64 key to encrypt with").argument("<plaintextValue>", "The value to encrypt in plaintext").action(async (publicKey, plaintextValue) => {
+function encryptWithKey$1(program) {
+	program.command("encrypt-with-key").alias("encrypt").description("Encrypt a secret given the public base64 key and the thing you want to encrypt.").argument("<publicKey>", "The public base64 key to encrypt with").argument("<plaintextValue>", "The value to encrypt in plaintext").action(async (publicKey, plaintextValue) => {
 		try {
 			console.info(await encryptWithKey(publicKey, plaintextValue));
 		} catch {
-			program$1.error("Encryption failed. Please double-check that the given key is a valid base 64 string.", {
+			program.error("Encryption failed. Please double-check that the given key is a valid base 64 string.", {
 				exitCode: 1,
 				code: "ENCRYPTION_FAILED"
 			});
@@ -339,17 +339,19 @@ var encrypt_with_key_default = encryptWithKey$1;
 
 //#endregion
 //#region src/commands/get-version-type.ts
-function getVersionType(program$1) {
-	program$1.command("get-version-type").description("Gets the version type of the given version number.").argument("<version>", "The version to get the version type from").action((version$1) => {
-		console.info(new VersionNumber(version$1).type);
+function getVersionType(program) {
+	program.command("get-version-type").description("Gets the version type of the given version number.").argument("<version>", "The version to get the version type from", (rawVersion) => {
+		return new VersionNumber(rawVersion);
+	}).action((version$1) => {
+		console.info(version$1.type);
 	});
 }
 var get_version_type_default = getVersionType;
 
 //#endregion
 //#region src/commands/git-post-merge-cleanup.ts
-function gitPostMergeCleanup(program$1) {
-	program$1.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").action(async (branch, { rebase: rebaseOption }) => {
+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").action(async (branch, { rebase: rebaseOption }) => {
 		let alexCLineConfigJSON;
 		try {
 			alexCLineConfigJSON = await readFile(path.join(process.env.HOME ?? os.homedir(), "alex-c-line-config.json"), "utf-8");
@@ -358,7 +360,7 @@ function gitPostMergeCleanup(program$1) {
 		const rebase = JSON.parse(alexCLineConfigJSON)["git-post-merge-cleanup"]?.rebase ?? rebaseOption;
 		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$1.error(`❌ ERROR: Cannot run cleanup on ${branch} branch!`, {
+		if (currentBranch === branch) program.error(`❌ ERROR: Cannot run cleanup on ${branch} branch!`, {
 			exitCode: 1,
 			code: "INVALID_BRANCH"
 		});
@@ -386,7 +388,7 @@ function gitPostMergeCleanup(program$1) {
 			const { stdout: changes } = await execa`git diff ${branch}..${currentBranch}`;
 			if (changes) {
 				await execa`git checkout ${currentBranch}`;
-				program$1.error("❌ ERROR: Changes on branch not fully merged!", {
+				program.error("❌ ERROR: Changes on branch not fully merged!", {
 					exitCode: 1,
 					code: "CHANGES_NOT_MERGED"
 				});
@@ -402,7 +404,7 @@ function gitPostMergeCleanup(program$1) {
 		} catch (error) {
 			if (error instanceof ExecaError) {
 				await execa`git checkout ${currentBranch}`;
-				program$1.error("❌ ERROR: Changes on branch not fully merged!", {
+				program.error("❌ ERROR: Changes on branch not fully merged!", {
 					exitCode: 1,
 					code: "CHANGES_NOT_MERGED"
 				});
@@ -414,15 +416,17 @@ var git_post_merge_cleanup_default = gitPostMergeCleanup;
 
 //#endregion
 //#region src/commands/increment-version.ts
-function incrementVersion(program$1) {
-	program$1.command("increment-version").description("Increments the given input version depending on the given increment type.").argument("<version>", "The version to increment").argument("<incrementType>", normaliseIndents`
+function incrementVersion(program) {
+	program.command("increment-version").description("Increments the given input version depending on the given increment type.").argument("<version>", "The version to increment", (rawVersion) => {
+		return new VersionNumber(rawVersion);
+	}).argument("<incrementType>", normaliseIndents`
             The type of increment. Can be one of the following:
 
             - "major": Change the major version v1.2.3 → v2.0.0
             - "minor": Change the minor version v1.2.3 → v1.3.0
             - "patch": Change the patch version v1.2.3 → v1.2.4
-        `).option("--no-prefix").option("--prefix", "Whether to add the `v` prefix from the output version or not (defaults to true).").action((version$1, incrementType, { prefix }) => {
-		console.info(new VersionNumber(version$1).increment(parseVersionType(incrementType)).toString({ omitPrefix: !prefix }));
+        `, parseVersionType).option("--no-prefix").option("--prefix", "Whether to add the `v` prefix from the output version or not (defaults to true).").action((version$1, incrementType, { prefix }) => {
+		console.info(version$1.increment(incrementType).toString({ omitPrefix: !prefix }));
 	});
 }
 var increment_version_default = incrementVersion;
@@ -430,8 +434,8 @@ var increment_version_default = incrementVersion;
 //#endregion
 //#region src/commands/pre-commit.ts
 const deprecationMessage = "[DEPRECATED]: This command does not support the new alex-c-line config system. Please use `pre-commit-2` instead.";
-function preCommit(program$1) {
-	program$1.command("pre-commit").description(normaliseIndents`
+function preCommit(program) {
+	program.command("pre-commit").description(normaliseIndents`
         ${deprecationMessage}
         Run the standard pre-commits used across all my repositories.`).option("--no-build", "Skip the build").option("--no-tests", "Skip the tests").option("--allow-unstaged", "Run even if nothing is staged").option("--repository-manager <repositoryManager>", "The repository manager if it is a monorepo (Only Turborepo is supported as of now)").action(async ({ build: shouldIncludeBuild, tests: shouldIncludeTests, allowUnstaged, repositoryManager: rawRepositoryManager }) => {
 		console.warn(deprecationMessage);
@@ -442,7 +446,7 @@ function preCommit(program$1) {
 			"--quiet"
 		]);
 		switch (diffExitCode) {
-			case 128: program$1.error("Not currently in a Git repository", {
+			case 128: program.error("Not currently in a Git repository", {
 				exitCode: 1,
 				code: "GIT_DIFF_FAILED"
 			});
@@ -455,7 +459,7 @@ function preCommit(program$1) {
 			const newArguments = [...args ?? []];
 			if (repositoryManager === "turborepo") newArguments.push("--ui=stream");
 			const result = await execaNoFail(command, newArguments, { stdio: "inherit" });
-			if (result.exitCode !== 0) program$1.error(`Command failed: ${command}${newArguments.length ? ` ${newArguments.join(" ")}` : ""}`, {
+			if (result.exitCode !== 0) program.error(`Command failed: ${command}${newArguments.length ? ` ${newArguments.join(" ")}` : ""}`, {
 				exitCode: result.exitCode ?? 1,
 				code: "PRE_COMMIT_FAILED"
 			});
@@ -550,15 +554,15 @@ var findAlexCLineConfig_default = findAlexCLineConfig;
 
 //#endregion
 //#region src/commands/pre-commit-2.ts
-function preCommit2(program$1) {
-	program$1.command("pre-commit-2").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").action(async ({ allowNoStagedChanges }) => {
+function preCommit2(program) {
+	program.command("pre-commit-2").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").action(async ({ allowNoStagedChanges }) => {
 		const configPath = await findAlexCLineConfig_default(process.cwd());
-		if (!configPath) program$1.error("Could not find the path to the alex-c-line config file. Does it exist?", {
+		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"
 		});
 		const { preCommit: preCommitConfig } = await loadAlexCLineConfig_default(configPath);
-		if (!preCommitConfig) program$1.error("Could not find the pre-commit config in alex-c-line config.", {
+		if (!preCommitConfig) program.error("Could not find the pre-commit config in alex-c-line config.", {
 			exitCode: 1,
 			code: "PRE_COMMIT_CONFIG_NOT_FOUND"
 		});
@@ -568,7 +572,7 @@ function preCommit2(program$1) {
 			"--quiet"
 		]);
 		switch (diffExitCode) {
-			case 128: program$1.error("Not currently in a Git repository", {
+			case 128: program.error("Not currently in a Git repository", {
 				exitCode: 1,
 				code: "GIT_DIFF_FAILED"
 			});
@@ -579,7 +583,7 @@ function preCommit2(program$1) {
 		}
 		async function runCommandAndLogToConsole(command, args) {
 			const result = await execaNoFail(command, args, { stdio: "inherit" });
-			if (result.exitCode !== 0) program$1.error(`Command failed: ${command}${args?.length ? ` ${args.join(" ")}` : ""}`, {
+			if (result.exitCode !== 0) program.error(`Command failed: ${command}${args?.length ? ` ${args.join(" ")}` : ""}`, {
 				exitCode: result.exitCode ?? 1,
 				code: "PRE_COMMIT_FAILED"
 			});
@@ -589,7 +593,7 @@ function preCommit2(program$1) {
 		const rawPackageManager = preCommitConfig.packageManager ?? (typeof packagePackageManager === "string" ? packagePackageManager.split("@")[0] : void 0);
 		const packageManager$1 = parseZodSchema(z.enum(PackageManager), rawPackageManager, new DataError(rawPackageManager, "UNSUPPORTED_PACKAGE_MANAGER", `This repository manager is not currently supported. Only the following are supported: ${Object.values(PackageManager).join(", ")}`));
 		function getCommandArguments(script, args) {
-			if (!(script in (scripts$1 ?? {}))) program$1.error(`Could not find script \`${script}\` in package.json.`, {
+			if (!(script in (scripts$1 ?? {}))) program.error(`Could not find script \`${script}\` in package.json.`, {
 				exitCode: 1,
 				code: "SCRIPT_NOT_FOUND"
 			});
@@ -609,8 +613,8 @@ var pre_commit_2_default = preCommit2;
 
 //#endregion
 //#region src/commands/say-hello.ts
-function sayHello(program$1) {
-	program$1.command("say-hello").description("Quick test command").action(() => {
+function sayHello(program) {
+	program.command("say-hello").description("Quick test command").action(() => {
 		console.info("Hello!");
 	});
 }
@@ -629,10 +633,10 @@ var isValidReleaseDocument_default = isValidReleaseDocument;
 
 //#endregion
 //#region src/commands/set-release-status.ts
-function setReleaseStatus(program$1) {
-	program$1.command("set-release-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").action(async (documentPath) => {
+function setReleaseStatus(program) {
+	program.command("set-release-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").action(async (documentPath) => {
 		const { name: packageName } = JSON.parse(await readFile(path.join(process.cwd(), "package.json"), "utf-8"));
-		if (!documentPath.endsWith("md")) program$1.error("❌ ERROR: Invalid file path. Path must lead to a .md file.", {
+		if (!documentPath.endsWith("md")) program.error("❌ ERROR: Invalid file path. Path must lead to a .md file.", {
 			exitCode: 1,
 			code: "INVALID_FILE_PATH"
 		});
@@ -642,7 +646,7 @@ function setReleaseStatus(program$1) {
 		}).join("."));
 		const fullDocumentPath = path.join(process.cwd(), documentPath);
 		const initialDocument = await readFile(fullDocumentPath, "utf-8");
-		if (!isValidReleaseDocument_default(packageName, versionNumber, initialDocument)) program$1.error("❌ ERROR: Document does not match a valid release note template.", {
+		if (!isValidReleaseDocument_default(packageName, versionNumber, initialDocument)) program.error("❌ ERROR: Document does not match a valid release note template.", {
 			exitCode: 1,
 			code: "INVALID_RELEASE_NOTE"
 		});
@@ -654,15 +658,15 @@ var set_release_status_default = setReleaseStatus;
 
 //#endregion
 //#region src/utility/loadCommands.ts
-function loadCommands(program$1, commandMap) {
-	for (const loader of Object.values(commandMap)) loader(program$1);
+function loadCommands(program, commandMap) {
+	for (const loader of Object.values(commandMap)) loader(program);
 }
 var loadCommands_default = loadCommands;
 
 //#endregion
 //#region src/commands/index.ts
-function createCommands(program$1) {
-	loadCommands_default(program$1, {
+function createCommands(program) {
+	loadCommands_default(program, {
 		checkForFileDependencies: check_for_file_dependencies_default,
 		checkLockfileVersionDiscrepancy: check_lockfile_version_discrepancy_default,
 		checkVersionNumberChange: check_version_number_change_default,
@@ -683,7 +687,7 @@ var commands_default = createCommands;
 
 //#endregion
 //#region package.json
-var version = "1.17.2";
+var version = "1.17.3";
 var package_default = {
 	name: "alex-c-line",
 	version,
@@ -759,6 +763,7 @@ var package_default = {
 	},
 	devDependencies: {
 		"@alextheman/eslint-plugin": "^5.4.2",
+		"@commander-js/extra-typings": "^14.0.0",
 		"@types/eslint": "^9.6.1",
 		"@types/libsodium-wrappers": "^0.7.14",
 		"@types/node": "^25.0.3",
@@ -784,11 +789,13 @@ var package_default = {
 
 //#endregion
 //#region src/index.ts
-const program = new Command();
-program.name("alex-c-line").description("CLI tool built by Alex").version(version);
-updateNotifier({ pkg: package_default }).notify();
-commands_default(program);
-program.parse(process.argv);
+(async () => {
+	const program = new Command();
+	program.name("alex-c-line").description("CLI tool built by Alex").version(version);
+	updateNotifier({ pkg: package_default }).notify();
+	commands_default(program);
+	await program.parseAsync(process.argv);
+})();
 
 //#endregion
 export {  };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alex-c-line",
-  "version": "1.17.2",
+  "version": "1.17.3",
   "description": "Command-line tool with commands to streamline the developer workflow.",
   "repository": {
     "type": "git",
@@ -44,6 +44,7 @@
   },
   "devDependencies": {
     "@alextheman/eslint-plugin": "^5.4.2",
+    "@commander-js/extra-typings": "^14.0.0",
     "@types/eslint": "^9.6.1",
     "@types/libsodium-wrappers": "^0.7.14",
     "@types/node": "^25.0.3",