@cbnventures/nova 0.13.1 → 0.15.0

package/build/src/cli/index.js

@@ -2,43 +2,78 @@
 import chalk from 'chalk';
 import { Command } from 'commander';
 import packageJson from '../../package.json' with { type: 'json' };
-import { CLIRecipePinVersions } from '../cli/recipe/pin-versions.js';
-import { CLIRecipeSyncLtsEngines } from '../cli/recipe/sync-lts-engines.js';
-import { CLIRecipeSyncPackages } from '../cli/recipe/sync-packages.js';
-import { CLIUtilityChangelog } from '../cli/utility/changelog.js';
-import { CLIUtilityInitialize } from '../cli/utility/initialize.js';
-import { CLIUtilityTypeCheck } from '../cli/utility/type-check.js';
-import { CLIUtilityVersion } from '../cli/utility/version.js';
-import { PATTERN_ANSI, PATTERN_ERROR_PREFIX, PATTERN_NOVA_PREFIX, PATTERN_WHITESPACE, } from '../lib/regex.js';
-import { CLIHeader, Logger } from '../toolkit/index.js';
+import { LIB_REGEX_PATTERN_ANSI, LIB_REGEX_PATTERN_ERROR_PREFIX, LIB_REGEX_PATTERN_NOVA_PREFIX, LIB_REGEX_PATTERN_WHITESPACE, } from '../lib/regex.js';
+import { Bootstrap, CLIHeader, Logger } from '../toolkit/index.js';
+import { CliGenerateGithubFunding } from './generate/github/funding.js';
+import { CliGenerateGithubIssueTemplate } from './generate/github/issue-template.js';
+import { CliGenerateGithubWorkflows } from './generate/github/workflows.js';
+import { CliGenerateMustHavesAgentConventions } from './generate/must-haves/agent-conventions.js';
+import { CliGenerateMustHavesDotenv } from './generate/must-haves/dotenv.js';
+import { CliGenerateMustHavesEditorconfig } from './generate/must-haves/editorconfig.js';
+import { CliGenerateMustHavesGitignore } from './generate/must-haves/gitignore.js';
+import { CliGenerateMustHavesLicense } from './generate/must-haves/license.js';
+import { CliGenerateMustHavesReadMe } from './generate/must-haves/read-me.js';
+import { CliRecipePackageJsonCleanup } from './recipe/package-json/cleanup.js';
+import { CliRecipePackageJsonNormalizeArtifacts } from './recipe/package-json/normalize-artifacts.js';
+import { CliRecipePackageJsonNormalizeBundler } from './recipe/package-json/normalize-bundler.js';
+import { CliRecipePackageJsonNormalizeDependencies } from './recipe/package-json/normalize-dependencies.js';
+import { CliRecipePackageJsonNormalizeModules } from './recipe/package-json/normalize-modules.js';
+import { CliRecipePackageJsonNormalizeTooling } from './recipe/package-json/normalize-tooling.js';
+import { CliRecipePackageJsonSyncEnvironment } from './recipe/package-json/sync-environment.js';
+import { CliRecipePackageJsonSyncIdentity } from './recipe/package-json/sync-identity.js';
+import { CliRecipePackageJsonSyncOwnership } from './recipe/package-json/sync-ownership.js';
+import { CliScaffoldAppExpressjs } from './scaffold/app/expressjs.js';
+import { CliScaffoldAppNextjs } from './scaffold/app/nextjs.js';
+import { CliScaffoldAppVite } from './scaffold/app/vite.js';
+import { CliScaffoldAppWorkers } from './scaffold/app/workers.js';
+import { CliScaffoldDocsDocusaurus } from './scaffold/docs/docusaurus.js';
+import { CliScaffoldStarterBase } from './scaffold/starter/base.js';
+import { CliUtilityChangelog } from './utility/changelog.js';
+import { CliUtilityInitialize } from './utility/initialize.js';
+import { CliUtilityRunRecipes } from './utility/run-recipes.js';
+import { CliUtilityRunScripts } from './utility/run-scripts.js';
+import { CliUtilityTranspile } from './utility/transpile.js';
+import { CliUtilityTypeCheck } from './utility/type-check.js';
+import { CliUtilityVersion } from './utility/version.js';
+const envDir = Bootstrap.resolveFileDir('nova', '.env', [
+    'cwd',
+    'project-root',
+    'config-dir',
+]);
+if (envDir !== undefined) {
+    Bootstrap.loadEnv(envDir);
+}
 class CLI {
     #program = new Command();
     constructor() {
         (async () => {
+            const headerText = this.getHeader();
             this.#program
                 .name('nova')
                 .usage('<command> <subcommand> [options]')
                 .description('CLI for the Common Developer')
                 .commandsGroup('Commands:')
                 .configureOutput({
-                writeErr: (string) => process.stdout.write(string),
-                outputError: (string) => this.handleCliError(string),
+                writeErr: (text) => process.stdout.write(text),
+                outputError: (text) => this.handleCliError(text),
             })
                 .configureHelp({
                 commandDescription: () => '',
                 commandUsage: (command) => this.getCommandUsage(command),
-                styleDescriptionText: (string) => this.styleText('description', string),
-                styleTitle: (string) => this.styleText('title', string),
+                styleDescriptionText: (text) => this.styleText('description', text),
+                styleTitle: (text) => this.styleText('title', text),
                 subcommandTerm: (command) => this.getSubcommandTerm(command),
             })
-                .addHelpText('beforeAll', this.getHeader())
+                .addHelpText('beforeAll', headerText)
                 .helpCommand(false)
                 .helpOption('-h, --help', 'Display the help menu')
                 .allowExcessArguments(false)
                 .showHelpAfterError();
             this.registerCommands();
             await this.#program.parseAsync(process.argv);
+            return;
         })();
+        return;
     }
     registerCommands() {
         const generate = this.#program
@@ -48,54 +83,115 @@ class CLI {
             .description('Generate vendor or must-have files for projects')
             .commandsGroup('Subcommands:')
             .helpCommand(false);
-        generate
-            .command('aws-amplify')
-            .description('Create a amplify.yml file for AWS Amplify deployments');
-        generate
-            .command('cloudflare-workers')
-            .description('Create a wrangler.toml file for Cloudflare Workers deployments');
-        generate
-            .command('docker-compose')
-            .description('Create a docker-compose.yml file for Docker builds');
-        generate
-            .command('docker-file')
-            .description('Create a Dockerfile for Docker builds');
-        generate
-            .command('docusaurus-config')
-            .description('Create a docusaurus.config.ts file for Docusaurus configuration');
-        generate
-            .command('github-funding')
-            .description('Create a ./github/FUNDING.yml file for GitHub to enable sponsor links');
-        generate
-            .command('github-issue-template')
-            .description('Create a ./github/ISSUE_TEMPLATE directory for GitHub to create issue templates');
-        generate
-            .command('github-workflows')
-            .description('Create a ./github/workflows directory for GitHub to enable CI/CD automation');
-        generate
-            .command('must-haves-dotenv')
-            .description('Create a .env file for managing local environment secrets across your project');
-        generate
-            .command('must-haves-editorconfig')
-            .description('Create a .editorconfig file for managing consistent coding styles');
-        generate
-            .command('must-haves-gitignore')
-            .description('Create a .gitignore file for managing files that should be excluded from Git commits');
-        generate
-            .command('must-haves-license')
-            .description('Create a LICENSE file for managing project license agreements');
-        generate
-            .command('must-haves-post-install')
-            .description('Create a post-install.ts file for expanding on post-install controls');
-        generate
-            .command('must-haves-read-me')
-            .description('Create a baseline README.md file for for your project');
-        generate
-            .command('nextjs-config')
-            .description('Create a next.config.mjs file for Next.js configuration');
-        generate
-            .command('vite-config')
-            .description('Create a vite.config.mjs file for Vite configuration');
+        const generateGitHub = generate
+            .command('github')
+            .alias('gh')
+            .usage('<subcommand> [options]')
+            .description('Generate GitHub configuration files')
+            .commandsGroup('Subcommands:')
+            .helpCommand(false);
+        generateGitHub
+            .command('funding')
+            .usage('[options]')
+            .description('Create a .github/FUNDING.yml file for sponsor links')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliGenerateGithubFunding['run']);
+            return;
+        });
+        generateGitHub
+            .command('issue-template')
+            .alias('issue')
+            .usage('[options]')
+            .description('Create .github/ISSUE_TEMPLATE files for issue forms')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliGenerateGithubIssueTemplate['run']);
+            return;
+        });
+        generateGitHub
+            .command('workflows')
+            .usage('[options]')
+            .description('Create .github/workflows files for CI/CD automation')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliGenerateGithubWorkflows['run']);
+            return;
+        });
+        const generateMustHaves = generate
+            .command('must-haves')
+            .alias('must')
+            .usage('<subcommand> [options]')
+            .description('Generate essential project files')
+            .commandsGroup('Subcommands:')
+            .helpCommand(false);
+        generateMustHaves
+            .command('agent-conventions')
+            .alias('agent')
+            .usage('[options]')
+            .description('Create agent convention files for coding assistants')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliGenerateMustHavesAgentConventions['run']);
+            return;
+        });
+        generateMustHaves
+            .command('dotenv')
+            .alias('env')
+            .usage('[options]')
+            .description('Create a .env file for managing local environment secrets')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliGenerateMustHavesDotenv['run']);
+            return;
+        });
+        generateMustHaves
+            .command('editorconfig')
+            .usage('[options]')
+            .description('Create a .editorconfig file for consistent coding styles')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliGenerateMustHavesEditorconfig['run']);
+            return;
+        });
+        generateMustHaves
+            .command('gitignore')
+            .usage('[options]')
+            .description('Create a .gitignore file for excluding files from Git commits')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliGenerateMustHavesGitignore['run']);
+            return;
+        });
+        generateMustHaves
+            .command('license')
+            .alias('lic')
+            .usage('[options]')
+            .description('Create a LICENSE file for project license agreements')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliGenerateMustHavesLicense['run']);
+            return;
+        });
+        generateMustHaves
+            .command('read-me')
+            .alias('read')
+            .usage('[options]')
+            .description('Create a baseline README.md file for your project')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliGenerateMustHavesReadMe['run']);
+            return;
+        });
         const recipe = this.#program
             .command('recipe')
             .alias('rcp')
@@ -103,36 +199,111 @@ class CLI {
             .description('Automate routine maintenance with configured defaults')
             .commandsGroup('Subcommands:')
             .helpCommand(false);
-        recipe
-            .command('pin-versions')
-            .alias('pv')
+        const recipePackageJson = recipe
+            .command('package-json')
+            .alias('pkg')
+            .usage('<subcommand> [options]')
+            .description('Recipes for "package.json" file synchronization')
+            .commandsGroup('Subcommands:')
+            .helpCommand(false);
+        recipePackageJson
+            .command('cleanup')
+            .alias('clean')
+            .usage('[options]')
+            .description('Remove unsupported keys and reorder remaining keys')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliRecipePackageJsonCleanup['run']);
+            return;
+        });
+        recipePackageJson
+            .command('normalize-artifacts')
+            .alias('norm-art')
             .usage('[options]')
-            .description('Pin all workspace dependency versions by stripping range prefixes')
+            .description('Normalize files, bin, man, directories, private, and publishConfig fields')
             .option('-d, --dry-run', 'Preview changes without writing files')
             .option('-r, --replace-file', 'Replace the original file without creating a backup')
             .action(async (options) => {
-            await this.executeCommand(options, CLIRecipePinVersions.run);
+            await this.executeCommand(options, CliRecipePackageJsonNormalizeArtifacts['run']);
+            return;
         });
-        recipe
-            .command('sync-lts-engines')
-            .alias('sle')
+        recipePackageJson
+            .command('normalize-bundler')
+            .alias('norm-bun')
             .usage('[options]')
-            .description('Sync Node.js engine constraints to current LTS versions across workspaces')
+            .description('Normalize types, module, sideEffects, and esnext fields')
             .option('-d, --dry-run', 'Preview changes without writing files')
             .option('-r, --replace-file', 'Replace the original file without creating a backup')
             .action(async (options) => {
-            await this.executeCommand(options, CLIRecipeSyncLtsEngines.run);
+            await this.executeCommand(options, CliRecipePackageJsonNormalizeBundler['run']);
+            return;
         });
-        recipe
-            .command('sync-packages')
-            .alias('sp')
+        recipePackageJson
+            .command('normalize-dependencies')
+            .alias('norm-dep')
             .usage('[options]')
-            .description('Ensures every workspace "package.json" file matches defined conventions drawn from "nova.config.json"')
+            .description('Normalize dependency fields with optional version pinning')
             .option('-d, --dry-run', 'Preview changes without writing files')
-            .option('-i, --ignore-unknown', 'Ignore unknown keys found in workspace manifest files')
             .option('-r, --replace-file', 'Replace the original file without creating a backup')
             .action(async (options) => {
-            await this.executeCommand(options, CLIRecipeSyncPackages.run);
+            await this.executeCommand(options, CliRecipePackageJsonNormalizeDependencies['run']);
+            return;
+        });
+        recipePackageJson
+            .command('normalize-modules')
+            .alias('norm-mod')
+            .usage('[options]')
+            .description('Normalize exports, main, type, browser, and imports fields')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliRecipePackageJsonNormalizeModules['run']);
+            return;
+        });
+        recipePackageJson
+            .command('normalize-tooling')
+            .alias('norm-tool')
+            .usage('[options]')
+            .description('Normalize scripts, gypfile, config, and workspaces fields')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliRecipePackageJsonNormalizeTooling['run']);
+            return;
+        });
+        recipePackageJson
+            .command('sync-environment')
+            .alias('sync-env')
+            .usage('[options]')
+            .description('Sync engines, os, cpu, libc, devEngines, and packageManager fields')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliRecipePackageJsonSyncEnvironment['run']);
+            return;
+        });
+        recipePackageJson
+            .command('sync-identity')
+            .alias('sync-id')
+            .usage('[options]')
+            .description('Sync name, version, description, keywords, and license fields')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliRecipePackageJsonSyncIdentity['run']);
+            return;
+        });
+        recipePackageJson
+            .command('sync-ownership')
+            .alias('sync-own')
+            .usage('[options]')
+            .description('Sync homepage, bugs, author, contributors, funding, and repository fields')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliRecipePackageJsonSyncOwnership['run']);
+            return;
         });
         const scaffold = this.#program
             .command('scaffold')
@@ -141,9 +312,98 @@ class CLI {
             .description('Bootstrap templated monorepo-style projects')
             .commandsGroup('Subcommands:')
             .helpCommand(false);
-        scaffold
+        const scaffoldApp = scaffold
+            .command('app')
+            .usage('<subcommand> [options]')
+            .description('Scaffold workspaces')
+            .commandsGroup('Subcommands:')
+            .helpCommand(false);
+        scaffoldApp
+            .command('expressjs')
+            .alias('express')
+            .usage('[options]')
+            .description('Scaffold an Express.js workspace')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('--name <name>', 'Project or workspace name')
+            .option('--workspace-name <name>', 'Workspace directory name')
+            .option('--output <dir>', 'Output directory')
+            .action(async (options) => {
+            await this.executeCommand(options, CliScaffoldAppExpressjs['run']);
+            return;
+        });
+        scaffoldApp
             .command('nextjs')
-            .description('Next.js');
+            .alias('next')
+            .usage('[options]')
+            .description('Scaffold a Next.js workspace')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('--name <name>', 'Project or workspace name')
+            .option('--workspace-name <name>', 'Workspace directory name')
+            .option('--output <dir>', 'Output directory')
+            .action(async (options) => {
+            await this.executeCommand(options, CliScaffoldAppNextjs['run']);
+            return;
+        });
+        scaffoldApp
+            .command('vite')
+            .usage('[options]')
+            .description('Scaffold a Vite workspace')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('--name <name>', 'Project or workspace name')
+            .option('--workspace-name <name>', 'Workspace directory name')
+            .option('--output <dir>', 'Output directory')
+            .action(async (options) => {
+            await this.executeCommand(options, CliScaffoldAppVite['run']);
+            return;
+        });
+        scaffoldApp
+            .command('workers')
+            .usage('[options]')
+            .description('Scaffold a Cloudflare Workers workspace')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('--name <name>', 'Project or workspace name')
+            .option('--workspace-name <name>', 'Workspace directory name')
+            .option('--output <dir>', 'Output directory')
+            .action(async (options) => {
+            await this.executeCommand(options, CliScaffoldAppWorkers['run']);
+            return;
+        });
+        const scaffoldDocs = scaffold
+            .command('docs')
+            .usage('<subcommand> [options]')
+            .description('Scaffold documentation workspaces')
+            .commandsGroup('Subcommands:')
+            .helpCommand(false);
+        scaffoldDocs
+            .command('docusaurus')
+            .usage('[options]')
+            .description('Scaffold a Docusaurus documentation workspace')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('--name <name>', 'Project or workspace name')
+            .option('--workspace-name <name>', 'Workspace directory name')
+            .option('--output <dir>', 'Output directory')
+            .action(async (options) => {
+            await this.executeCommand(options, CliScaffoldDocsDocusaurus['run']);
+            return;
+        });
+        const scaffoldStarter = scaffold
+            .command('starter')
+            .alias('start')
+            .usage('<subcommand> [options]')
+            .description('Scaffold starter monorepo projects')
+            .commandsGroup('Subcommands:')
+            .helpCommand(false);
+        scaffoldStarter
+            .command('base')
+            .usage('[options]')
+            .description('Scaffold a base monorepo project without a framework workspace')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('--name <name>', 'Project name')
+            .option('--output <dir>', 'Output directory')
+            .action(async (options) => {
+            await this.executeCommand(options, CliScaffoldStarterBase['run']);
+            return;
+        });
         const utility = this.#program
             .command('utility')
             .alias('util')
@@ -153,7 +413,7 @@ class CLI {
             .helpCommand(false);
         utility
             .command('changelog')
-            .alias('cl')
+            .alias('log')
             .usage('[options]')
             .description('Record changes and release versioned changelogs')
             .option('--record', 'Record a change')
@@ -164,7 +424,8 @@ class CLI {
             .option('-m, --message <message>', 'Change description')
             .option('-d, --dry-run', 'Preview changes without writing files')
             .action(async (options) => {
-            await this.executeCommand(options, CLIUtilityChangelog.run);
+            await this.executeCommand(options, CliUtilityChangelog['run']);
+            return;
         });
         utility
             .command('initialize')
@@ -174,16 +435,56 @@ class CLI {
             .option('-d, --dry-run', 'Preview changes without writing files')
             .option('-r, --replace-file', 'Replace the original file without creating a backup')
             .action(async (options) => {
-            await this.executeCommand(options, CLIUtilityInitialize.run);
+            await this.executeCommand(options, CliUtilityInitialize['run']);
+            return;
+        });
+        utility
+            .command('run-recipes')
+            .alias('run-rcp')
+            .usage('[options]')
+            .description('Run all configured recipes')
+            .option('-d, --dry-run', 'Preview changes without writing files')
+            .option('-r, --replace-file', 'Replace the original file without creating a backup')
+            .action(async (options) => {
+            await this.executeCommand(options, CliUtilityRunRecipes['run']);
+            return;
+        });
+        utility
+            .command('run-scripts')
+            .alias('run-scr')
+            .usage('<pattern> [options]')
+            .description('Run package.json scripts by pattern in sequential or parallel mode')
+            .argument('<pattern>', 'Script name pattern (e.g., "build:*")')
+            .option('-s, --sequential', 'Run matched scripts one at a time, stopping on failure')
+            .option('-p, --parallel', 'Run matched scripts concurrently')
+            .option('-b, --buffer <ms>', 'Flush interval in ms for parallel log grouping (default: 500)')
+            .action(async (pattern, options) => {
+            const runScriptsOptions = {
+                ...options,
+                pattern,
+            };
+            await this.executeCommand(runScriptsOptions, CliUtilityRunScripts['run']);
+            return;
+        });
+        utility
+            .command('transpile')
+            .alias('xpile')
+            .usage('[options]')
+            .description('Transpile TypeScript with filtered diagnostics')
+            .option('-p, --project <path>', 'Path to tsconfig.json')
+            .action(async (options) => {
+            await this.executeCommand(options, CliUtilityTranspile['run']);
+            return;
         });
         utility
             .command('type-check')
-            .alias('tc')
+            .alias('type-chk')
             .usage('[options]')
             .description('Run type checks scoped to project-owned files')
             .option('-p, --project <path>', 'Path to tsconfig.json')
             .action(async (options) => {
-            await this.executeCommand(options, CLIUtilityTypeCheck.run);
+            await this.executeCommand(options, CliUtilityTypeCheck['run']);
+            return;
         });
         utility
             .command('version')
@@ -197,19 +498,22 @@ class CLI {
             .option('-n, --node', 'Show Node.js and related package manager versions')
             .option('-o, --os', 'Show operating system details')
             .action(async (options) => {
-            await this.executeCommand(options, CLIUtilityVersion.run);
+            await this.executeCommand(options, CliUtilityVersion['run']);
+            return;
         });
+        return;
     }
     async executeCommand(options, target) {
-        const command = process.argv.join(' ').match(PATTERN_NOVA_PREFIX);
+        const command = process.argv.join(' ').match(LIB_REGEX_PATTERN_NOVA_PREFIX);
         process.stdout.write(`${this.getHeader()}\n`);
         const commandLabel = (command !== null) ? command[0] : 'N/A';
         process.stdout.write(`${chalk.bold.bgBlue('CURRENTLY RUNNING:')} ${commandLabel}\n\n`);
         await target(options);
+        return;
     }
     getHeader() {
         return CLIHeader.render([
-            chalk.yellowBright.bold(`Nova v${packageJson.version}`),
+            chalk.yellowBright.bold(`Nova v${packageJson['version']}`),
             chalk.redBright.italic('CLI for the Common Developer'),
         ], {
             align: 'center',
@@ -229,13 +533,10 @@ class CLI {
             this.styleText('usage', commandUsage),
             commandName,
         ];
+        const usagePipeSeparator = this.styleText('usage', '|');
         const aliasCommand = [
             this.styleText('usage', commandUsage),
-            ...(commandAliases.length > 0) ? [
-                commandAliases.join(this.styleText('usage', '|')),
-            ] : [
-                commandName,
-            ],
+            ...(commandAliases.length > 0) ? [commandAliases.join(usagePipeSeparator)] : [commandName],
         ];
         let parentCommand = command.parent;
         while (parentCommand !== null) {
@@ -243,21 +544,33 @@ class CLI {
             const parentCommandAliases = parentCommand.aliases();
             fullCommand.push(parentCommandName);
             if (parentCommandAliases.length > 0) {
-                aliasCommand.push(parentCommandAliases.join(this.styleText('usage', '|')));
+                const parentAliasSeparated = parentCommandAliases.join(usagePipeSeparator);
+                aliasCommand.push(parentAliasSeparated);
             }
             else {
                 aliasCommand.push(parentCommandName);
             }
             parentCommand = parentCommand.parent;
         }
+        const fullLine = fullCommand.reverse().join(' ');
+        const aliasLine = aliasCommand.reverse().join(' ');
+        const fullLineStripped = fullLine.replace(new RegExp(LIB_REGEX_PATTERN_ANSI, 'g'), '');
+        const aliasLineStripped = aliasLine.replace(new RegExp(LIB_REGEX_PATTERN_ANSI, 'g'), '');
+        if (fullLineStripped === aliasLineStripped) {
+            return fullLine;
+        }
         return [
-            fullCommand.reverse().join(' '),
-            aliasCommand.reverse().join(' '),
+            fullLine,
+            aliasLine,
         ].join('\n       ');
     }
     getSubcommandTerm(command) {
         const category = (command.parent !== null && command.parent.parent === null) ? 'commands' : 'subcommands';
-        const names = [command.name(), ...command.aliases()].join(this.styleText(category, '|'));
+        const categoryPipeSeparator = this.styleText(category, '|');
+        const names = [
+            command.name(),
+            ...command.aliases(),
+        ].join(categoryPipeSeparator);
         const usage = command.usage();
         return (usage !== '') ? `${names} ${this.styleText(category, usage)}` : names;
     }
@@ -275,26 +588,27 @@ class CLI {
             'Subcommands:': [chalk.magenta],
             'Usage:': [chalk.green],
         };
-        const categoryFunctions = categoryStyles[type] ?? [];
-        const titleFunctions = titleStyles[text] ?? [];
+        const categoryFunctions = Reflect.get(categoryStyles, type) ?? [];
+        const titleFunctions = Reflect.get(titleStyles, text) ?? [];
         let coloredText = text;
-        categoryFunctions.forEach((categoryFunction) => {
+        for (const categoryFunction of categoryFunctions) {
             coloredText = categoryFunction(coloredText);
-        });
+        }
         if (type === 'title') {
-            titleFunctions.forEach((titleFunction) => {
+            for (const titleFunction of titleFunctions) {
                 coloredText = titleFunction(coloredText);
-            });
+            }
         }
         return coloredText;
     }
     handleCliError(text) {
-        let processedText = text.replace(new RegExp(PATTERN_ERROR_PREFIX, 'i'), '');
-        processedText = processedText.replace(PATTERN_ANSI, '');
-        processedText = processedText.replace(new RegExp(PATTERN_WHITESPACE, 'g'), ' ').trim();
+        let processedText = text.replace(new RegExp(LIB_REGEX_PATTERN_ERROR_PREFIX.source, 'i'), '');
+        processedText = processedText.replace(LIB_REGEX_PATTERN_ANSI, '');
+        processedText = processedText.replace(new RegExp(LIB_REGEX_PATTERN_WHITESPACE.source, 'g'), ' ').trim();
         processedText = `${processedText.charAt(0).toUpperCase()}${processedText.slice(1)}`;
         Logger.error(processedText);
+        return;
     }
 }
-new CLI();
+void new CLI();
 //# sourceMappingURL=index.js.map