pgpm 0.5.0 → 0.6.0

package/commands/deploy.js

@@ -135,10 +135,11 @@ exports.default = async (argv, prompter, _options) => {
         target = packageName;
     }
     else if (argv.package && argv.to) {
-        target = `${argv.package}:${argv.to}`;
+        const resolvedPackage = (0, utils_1.resolvePackageAlias)(argv.package, cwd);
+        target = `${resolvedPackage}:${argv.to}`;
     }
     else if (argv.package) {
-        target = argv.package;
+        target = (0, utils_1.resolvePackageAlias)(argv.package, cwd);
     }
     await project.deploy(opts, target, recursive);
     log.success('Deployment complete.');

package/commands/revert.js

@@ -70,7 +70,7 @@ exports.default = async (argv, prompter, _options) => {
     log.debug(`Using current directory: ${cwd}`);
     let packageName;
     if (recursive && argv.to !== true) {
-        packageName = await (0, deployed_changes_1.selectDeployedPackage)(database, argv, prompter, log, 'revert');
+        packageName = await (0, deployed_changes_1.selectDeployedPackage)(database, argv, prompter, log, 'revert', cwd);
         if (!packageName) {
             await (0, cli_error_1.cliExitWithError)('No package found to revert');
         }
@@ -84,7 +84,7 @@ exports.default = async (argv, prompter, _options) => {
     });
     let target;
     if (argv.to === true) {
-        target = await (0, deployed_changes_1.selectDeployedChange)(database, argv, prompter, log, 'revert');
+        target = await (0, deployed_changes_1.selectDeployedChange)(database, argv, prompter, log, 'revert', cwd);
         if (!target) {
             await (0, cli_error_1.cliExitWithError)('No target selected, operation cancelled');
         }
@@ -96,10 +96,11 @@ exports.default = async (argv, prompter, _options) => {
         target = packageName;
     }
     else if (argv.package && argv.to) {
-        target = `${argv.package}:${argv.to}`;
+        const resolvedPackage = (0, utils_1.resolvePackageAlias)(argv.package, cwd);
+        target = `${resolvedPackage}:${argv.to}`;
     }
     else if (argv.package) {
-        target = argv.package;
+        target = (0, utils_1.resolvePackageAlias)(argv.package, cwd);
     }
     await pkg.revert(opts, target, recursive);
     log.success('Revert complete.');

package/commands/tag.js

@@ -39,6 +39,7 @@ const types_1 = require("@pgpmjs/types");
 const path = __importStar(require("path"));
 const argv_1 = require("../utils/argv");
 const module_utils_1 = require("../utils/module-utils");
+const package_alias_1 = require("../utils/package-alias");
 const log = new logger_1.Logger('tag');
 const tagUsageText = `
 Tag Command:
@@ -83,7 +84,7 @@ exports.default = async (argv, prompter, _options) => {
     const pkg = new core_1.PgpmPackage(cwd);
     let packageName;
     if (argv.package) {
-        packageName = argv.package;
+        packageName = (0, package_alias_1.resolvePackageAlias)(argv.package, cwd);
         log.info(`Using specified package: ${packageName}`);
     }
     else if (pkg.isInModule()) {

package/commands/verify.js

@@ -51,7 +51,7 @@ exports.default = async (argv, prompter, _options) => {
     log.debug(`Using current directory: ${cwd}`);
     let packageName;
     if (recursive && argv.to !== true) {
-        packageName = await (0, deployed_changes_1.selectDeployedPackage)(database, argv, prompter, log, 'verify');
+        packageName = await (0, deployed_changes_1.selectDeployedPackage)(database, argv, prompter, log, 'verify', cwd);
         if (!packageName) {
             await (0, cli_error_1.cliExitWithError)('No package found to verify');
         }
@@ -62,7 +62,7 @@ exports.default = async (argv, prompter, _options) => {
     });
     let target;
     if (argv.to === true) {
-        target = await (0, deployed_changes_1.selectDeployedChange)(database, argv, prompter, log, 'verify');
+        target = await (0, deployed_changes_1.selectDeployedChange)(database, argv, prompter, log, 'verify', cwd);
         if (!target) {
             await (0, cli_error_1.cliExitWithError)('No target selected, operation cancelled');
         }
@@ -74,10 +74,11 @@ exports.default = async (argv, prompter, _options) => {
         target = packageName;
     }
     else if (argv.package && argv.to) {
-        target = `${argv.package}:${argv.to}`;
+        const resolvedPackage = (0, utils_1.resolvePackageAlias)(argv.package, cwd);
+        target = `${resolvedPackage}:${argv.to}`;
     }
     else if (argv.package) {
-        target = argv.package;
+        target = (0, utils_1.resolvePackageAlias)(argv.package, cwd);
     }
     await project.verify(opts, target, recursive);
     log.success('Verify complete.');

package/esm/commands/deploy.js

@@ -3,7 +3,7 @@ import { getEnvOptions } from '@pgpmjs/env';
 import { Logger } from '@pgpmjs/logger';
 import { execSync } from 'child_process';
 import { getPgEnvOptions, getSpawnEnvWithPg, } from 'pg-env';
-import { getTargetDatabase } from '../utils';
+import { getTargetDatabase, resolvePackageAlias } from '../utils';
 import { selectPackage } from '../utils/module-utils';
 const deployUsageText = `
 Deploy Command:
@@ -133,10 +133,11 @@ export default async (argv, prompter, _options) => {
         target = packageName;
     }
     else if (argv.package && argv.to) {
-        target = `${argv.package}:${argv.to}`;
+        const resolvedPackage = resolvePackageAlias(argv.package, cwd);
+        target = `${resolvedPackage}:${argv.to}`;
     }
     else if (argv.package) {
-        target = argv.package;
+        target = resolvePackageAlias(argv.package, cwd);
     }
     await project.deploy(opts, target, recursive);
     log.success('Deployment complete.');

package/esm/commands/revert.js

@@ -2,7 +2,7 @@ import { PgpmPackage } from '@pgpmjs/core';
 import { getEnvOptions } from '@pgpmjs/env';
 import { Logger } from '@pgpmjs/logger';
 import { getPgEnvOptions } from 'pg-env';
-import { getTargetDatabase } from '../utils';
+import { getTargetDatabase, resolvePackageAlias } from '../utils';
 import { cliExitWithError } from '../utils/cli-error';
 import { selectDeployedChange, selectDeployedPackage } from '../utils/deployed-changes';
 const log = new Logger('revert');
@@ -68,7 +68,7 @@ export default async (argv, prompter, _options) => {
     log.debug(`Using current directory: ${cwd}`);
     let packageName;
     if (recursive && argv.to !== true) {
-        packageName = await selectDeployedPackage(database, argv, prompter, log, 'revert');
+        packageName = await selectDeployedPackage(database, argv, prompter, log, 'revert', cwd);
         if (!packageName) {
             await cliExitWithError('No package found to revert');
         }
@@ -82,7 +82,7 @@ export default async (argv, prompter, _options) => {
     });
     let target;
     if (argv.to === true) {
-        target = await selectDeployedChange(database, argv, prompter, log, 'revert');
+        target = await selectDeployedChange(database, argv, prompter, log, 'revert', cwd);
         if (!target) {
             await cliExitWithError('No target selected, operation cancelled');
         }
@@ -94,10 +94,11 @@ export default async (argv, prompter, _options) => {
         target = packageName;
     }
     else if (argv.package && argv.to) {
-        target = `${argv.package}:${argv.to}`;
+        const resolvedPackage = resolvePackageAlias(argv.package, cwd);
+        target = `${resolvedPackage}:${argv.to}`;
     }
     else if (argv.package) {
-        target = argv.package;
+        target = resolvePackageAlias(argv.package, cwd);
     }
     await pkg.revert(opts, target, recursive);
     log.success('Revert complete.');

package/esm/commands/tag.js

@@ -4,6 +4,7 @@ import { errors } from '@pgpmjs/types';
 import * as path from 'path';
 import { extractFirst } from '../utils/argv';
 import { selectPackage } from '../utils/module-utils';
+import { resolvePackageAlias } from '../utils/package-alias';
 const log = new Logger('tag');
 const tagUsageText = `
 Tag Command:
@@ -48,7 +49,7 @@ export default async (argv, prompter, _options) => {
     const pkg = new PgpmPackage(cwd);
     let packageName;
     if (argv.package) {
-        packageName = argv.package;
+        packageName = resolvePackageAlias(argv.package, cwd);
         log.info(`Using specified package: ${packageName}`);
     }
     else if (pkg.isInModule()) {

package/esm/commands/verify.js

@@ -2,7 +2,7 @@ import { PgpmPackage } from '@pgpmjs/core';
 import { getEnvOptions } from '@pgpmjs/env';
 import { Logger } from '@pgpmjs/logger';
 import { getPgEnvOptions } from 'pg-env';
-import { getTargetDatabase } from '../utils';
+import { getTargetDatabase, resolvePackageAlias } from '../utils';
 import { cliExitWithError } from '../utils/cli-error';
 import { selectDeployedChange, selectDeployedPackage } from '../utils/deployed-changes';
 const log = new Logger('verify');
@@ -49,7 +49,7 @@ export default async (argv, prompter, _options) => {
     log.debug(`Using current directory: ${cwd}`);
     let packageName;
     if (recursive && argv.to !== true) {
-        packageName = await selectDeployedPackage(database, argv, prompter, log, 'verify');
+        packageName = await selectDeployedPackage(database, argv, prompter, log, 'verify', cwd);
         if (!packageName) {
             await cliExitWithError('No package found to verify');
         }
@@ -60,7 +60,7 @@ export default async (argv, prompter, _options) => {
     });
     let target;
     if (argv.to === true) {
-        target = await selectDeployedChange(database, argv, prompter, log, 'verify');
+        target = await selectDeployedChange(database, argv, prompter, log, 'verify', cwd);
         if (!target) {
             await cliExitWithError('No target selected, operation cancelled');
         }
@@ -72,10 +72,11 @@ export default async (argv, prompter, _options) => {
         target = packageName;
     }
     else if (argv.package && argv.to) {
-        target = `${argv.package}:${argv.to}`;
+        const resolvedPackage = resolvePackageAlias(argv.package, cwd);
+        target = `${resolvedPackage}:${argv.to}`;
     }
     else if (argv.package) {
-        target = argv.package;
+        target = resolvePackageAlias(argv.package, cwd);
     }
     await project.verify(opts, target, recursive);
     log.success('Verify complete.');

package/esm/utils/deployed-changes.js

@@ -1,11 +1,12 @@
 import { PgpmMigrate } from '@pgpmjs/core';
 import { getPgEnvOptions } from 'pg-env';
-export async function selectDeployedChange(database, argv, prompter, log, action = 'revert') {
+import { resolvePackageAlias } from './package-alias';
+export async function selectDeployedChange(database, argv, prompter, log, action = 'revert', cwd = process.cwd()) {
     const pgEnv = getPgEnvOptions({ database });
     const client = new PgpmMigrate(pgEnv);
     let selectedPackage;
     if (argv.package) {
-        selectedPackage = argv.package;
+        selectedPackage = resolvePackageAlias(argv.package, cwd);
     }
     else {
         const packageStatuses = await client.status();
@@ -43,9 +44,9 @@ export async function selectDeployedChange(database, argv, prompter, log, action
     const selectedChange = changeAnswer.change;
     return `${selectedPackage}:${selectedChange}`;
 }
-export async function selectDeployedPackage(database, argv, prompter, log, action = 'revert') {
+export async function selectDeployedPackage(database, argv, prompter, log, action = 'revert', cwd = process.cwd()) {
     if (argv.package) {
-        return argv.package;
+        return resolvePackageAlias(argv.package, cwd);
     }
     const pgEnv = getPgEnvOptions({ database });
     const client = new PgpmMigrate(pgEnv);

package/esm/utils/index.js

@@ -5,5 +5,6 @@ export * from './cli-error';
 export * from './deployed-changes';
 export * from './module-utils';
 export * from './npm-version';
+export * from './package-alias';
 export * from './update-check';
 export * from './update-config';

package/esm/utils/module-utils.js

@@ -1,5 +1,6 @@
 import { PgpmPackage } from '@pgpmjs/core';
 import { errors } from '@pgpmjs/types';
+import { resolvePackageAlias } from './package-alias';
 /**
  * Handle package selection for operations that need a specific package
  * Returns the selected package name, or undefined if validation fails or no packages exist
@@ -22,7 +23,8 @@ export async function selectPackage(argv, prompter, cwd, operationName, log) {
     }
     // If a specific package was provided, validate it
     if (argv.package) {
-        const packageName = argv.package;
+        const inputPackage = argv.package;
+        const packageName = resolvePackageAlias(inputPackage, cwd);
         if (log)
             log.info(`Using specified package: ${packageName}`);
         if (!moduleNames.includes(packageName)) {

package/esm/utils/package-alias.js

@@ -0,0 +1,86 @@
+import { PgpmPackage } from '@pgpmjs/core';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+/**
+ * Build a map of npm package names to control file names (extension names).
+ * This allows users to reference packages by their npm name (e.g., @scope/my-module)
+ * instead of the control file name (e.g., my-module).
+ */
+export function buildPackageAliasMap(cwd) {
+    const aliasMap = {};
+    try {
+        const pkg = new PgpmPackage(cwd);
+        const workspacePath = pkg.getWorkspacePath();
+        if (!workspacePath) {
+            return aliasMap;
+        }
+        const modules = pkg.getModuleMap();
+        for (const [controlName, moduleInfo] of Object.entries(modules)) {
+            const modulePath = join(workspacePath, moduleInfo.path);
+            const packageJsonPath = join(modulePath, 'package.json');
+            if (existsSync(packageJsonPath)) {
+                try {
+                    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+                    const npmName = packageJson.name;
+                    if (npmName && npmName !== controlName) {
+                        aliasMap[npmName] = controlName;
+                    }
+                }
+                catch {
+                    // Skip modules with invalid package.json
+                }
+            }
+        }
+    }
+    catch {
+        // Return empty map if we can't access workspace
+    }
+    return aliasMap;
+}
+/**
+ * Resolve a package name that might be an npm alias to its control file name.
+ * If the input is already a control file name or not found in aliases, returns as-is.
+ *
+ * @param input - The package name (could be npm name like @scope/pkg or control name)
+ * @param cwd - The current working directory
+ * @returns The resolved control file name
+ */
+export function resolvePackageAlias(input, cwd) {
+    if (!input) {
+        return input;
+    }
+    const aliasMap = buildPackageAliasMap(cwd);
+    return aliasMap[input] ?? input;
+}
+/**
+ * Get the npm package name for a given control file name, if available.
+ * Returns undefined if no npm alias exists.
+ *
+ * @param controlName - The control file name (extension name)
+ * @param cwd - The current working directory
+ * @returns The npm package name or undefined
+ */
+export function getNpmNameForControl(controlName, cwd) {
+    const aliasMap = buildPackageAliasMap(cwd);
+    for (const [npmName, ctrlName] of Object.entries(aliasMap)) {
+        if (ctrlName === controlName) {
+            return npmName;
+        }
+    }
+    return undefined;
+}
+/**
+ * Format a module name for display, showing both control name and npm alias if available.
+ * Example: "my-module (@scope/my-module)" or just "my-module" if no alias
+ *
+ * @param controlName - The control file name
+ * @param cwd - The current working directory
+ * @returns Formatted display string
+ */
+export function formatModuleNameWithAlias(controlName, cwd) {
+    const npmName = getNpmNameForControl(controlName, cwd);
+    if (npmName) {
+        return `${controlName} (${npmName})`;
+    }
+    return controlName;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgpm",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "PostgreSQL Package Manager - Database migration and package management CLI",
   "main": "index.js",
@@ -45,17 +45,17 @@
     "ts-node": "^10.9.2"
   },
   "dependencies": {
-    "@pgpmjs/core": "^3.0.0",
-    "@pgpmjs/env": "^2.7.0",
+    "@pgpmjs/core": "^3.0.1",
+    "@pgpmjs/env": "^2.8.0",
     "@pgpmjs/logger": "^1.3.0",
-    "@pgpmjs/types": "^2.11.0",
+    "@pgpmjs/types": "^2.12.0",
     "appstash": "^0.2.4",
     "create-gen-app": "^0.3.3",
     "find-and-require-package-json": "^0.8.0",
     "inquirerer": "^2.1.11",
     "js-yaml": "^4.1.0",
     "minimist": "^1.2.8",
-    "pg-cache": "^1.6.0",
+    "pg-cache": "^1.6.1",
     "pg-env": "^1.2.1",
     "semver": "^7.6.2",
     "shelljs": "^0.10.0",
@@ -73,5 +73,5 @@
     "pg",
     "pgsql"
   ],
-  "gitHead": "e4d5396a5d9154f4886176bb00c2b460b0f320e5"
+  "gitHead": "b2f5da76158dcd3629c7e7db9c984ccf1d9eff1b"
 }

package/utils/deployed-changes.d.ts

@@ -1,4 +1,4 @@
 import { Logger } from '@pgpmjs/logger';
 import { Inquirerer } from 'inquirerer';
-export declare function selectDeployedChange(database: string, argv: Partial<Record<string, any>>, prompter: Inquirerer, log: Logger, action?: 'revert' | 'verify'): Promise<string | undefined>;
-export declare function selectDeployedPackage(database: string, argv: Partial<Record<string, any>>, prompter: Inquirerer, log: Logger, action?: 'revert' | 'verify'): Promise<string | undefined>;
+export declare function selectDeployedChange(database: string, argv: Partial<Record<string, any>>, prompter: Inquirerer, log: Logger, action?: 'revert' | 'verify', cwd?: string): Promise<string | undefined>;
+export declare function selectDeployedPackage(database: string, argv: Partial<Record<string, any>>, prompter: Inquirerer, log: Logger, action?: 'revert' | 'verify', cwd?: string): Promise<string | undefined>;

package/utils/deployed-changes.js

@@ -4,12 +4,13 @@ exports.selectDeployedChange = selectDeployedChange;
 exports.selectDeployedPackage = selectDeployedPackage;
 const core_1 = require("@pgpmjs/core");
 const pg_env_1 = require("pg-env");
-async function selectDeployedChange(database, argv, prompter, log, action = 'revert') {
+const package_alias_1 = require("./package-alias");
+async function selectDeployedChange(database, argv, prompter, log, action = 'revert', cwd = process.cwd()) {
     const pgEnv = (0, pg_env_1.getPgEnvOptions)({ database });
     const client = new core_1.PgpmMigrate(pgEnv);
     let selectedPackage;
     if (argv.package) {
-        selectedPackage = argv.package;
+        selectedPackage = (0, package_alias_1.resolvePackageAlias)(argv.package, cwd);
     }
     else {
         const packageStatuses = await client.status();
@@ -47,9 +48,9 @@ async function selectDeployedChange(database, argv, prompter, log, action = 'rev
     const selectedChange = changeAnswer.change;
     return `${selectedPackage}:${selectedChange}`;
 }
-async function selectDeployedPackage(database, argv, prompter, log, action = 'revert') {
+async function selectDeployedPackage(database, argv, prompter, log, action = 'revert', cwd = process.cwd()) {
     if (argv.package) {
-        return argv.package;
+        return (0, package_alias_1.resolvePackageAlias)(argv.package, cwd);
     }
     const pgEnv = (0, pg_env_1.getPgEnvOptions)({ database });
     const client = new core_1.PgpmMigrate(pgEnv);

package/utils/index.d.ts

@@ -5,5 +5,6 @@ export * from './cli-error';
 export * from './deployed-changes';
 export * from './module-utils';
 export * from './npm-version';
+export * from './package-alias';
 export * from './update-check';
 export * from './update-config';

package/utils/index.js

@@ -21,5 +21,6 @@ __exportStar(require("./cli-error"), exports);
 __exportStar(require("./deployed-changes"), exports);
 __exportStar(require("./module-utils"), exports);
 __exportStar(require("./npm-version"), exports);
+__exportStar(require("./package-alias"), exports);
 __exportStar(require("./update-check"), exports);
 __exportStar(require("./update-config"), exports);

package/utils/module-utils.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.selectPackage = selectPackage;
 const core_1 = require("@pgpmjs/core");
 const types_1 = require("@pgpmjs/types");
+const package_alias_1 = require("./package-alias");
 /**
  * Handle package selection for operations that need a specific package
  * Returns the selected package name, or undefined if validation fails or no packages exist
@@ -25,7 +26,8 @@ async function selectPackage(argv, prompter, cwd, operationName, log) {
     }
     // If a specific package was provided, validate it
     if (argv.package) {
-        const packageName = argv.package;
+        const inputPackage = argv.package;
+        const packageName = (0, package_alias_1.resolvePackageAlias)(inputPackage, cwd);
         if (log)
             log.info(`Using specified package: ${packageName}`);
         if (!moduleNames.includes(packageName)) {

package/utils/package-alias.d.ts

@@ -0,0 +1,36 @@
+export interface PackageAliasMap {
+    [npmName: string]: string;
+}
+/**
+ * Build a map of npm package names to control file names (extension names).
+ * This allows users to reference packages by their npm name (e.g., @scope/my-module)
+ * instead of the control file name (e.g., my-module).
+ */
+export declare function buildPackageAliasMap(cwd: string): PackageAliasMap;
+/**
+ * Resolve a package name that might be an npm alias to its control file name.
+ * If the input is already a control file name or not found in aliases, returns as-is.
+ *
+ * @param input - The package name (could be npm name like @scope/pkg or control name)
+ * @param cwd - The current working directory
+ * @returns The resolved control file name
+ */
+export declare function resolvePackageAlias(input: string, cwd: string): string;
+/**
+ * Get the npm package name for a given control file name, if available.
+ * Returns undefined if no npm alias exists.
+ *
+ * @param controlName - The control file name (extension name)
+ * @param cwd - The current working directory
+ * @returns The npm package name or undefined
+ */
+export declare function getNpmNameForControl(controlName: string, cwd: string): string | undefined;
+/**
+ * Format a module name for display, showing both control name and npm alias if available.
+ * Example: "my-module (@scope/my-module)" or just "my-module" if no alias
+ *
+ * @param controlName - The control file name
+ * @param cwd - The current working directory
+ * @returns Formatted display string
+ */
+export declare function formatModuleNameWithAlias(controlName: string, cwd: string): string;

package/utils/package-alias.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPackageAliasMap = buildPackageAliasMap;
+exports.resolvePackageAlias = resolvePackageAlias;
+exports.getNpmNameForControl = getNpmNameForControl;
+exports.formatModuleNameWithAlias = formatModuleNameWithAlias;
+const core_1 = require("@pgpmjs/core");
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Build a map of npm package names to control file names (extension names).
+ * This allows users to reference packages by their npm name (e.g., @scope/my-module)
+ * instead of the control file name (e.g., my-module).
+ */
+function buildPackageAliasMap(cwd) {
+    const aliasMap = {};
+    try {
+        const pkg = new core_1.PgpmPackage(cwd);
+        const workspacePath = pkg.getWorkspacePath();
+        if (!workspacePath) {
+            return aliasMap;
+        }
+        const modules = pkg.getModuleMap();
+        for (const [controlName, moduleInfo] of Object.entries(modules)) {
+            const modulePath = (0, path_1.join)(workspacePath, moduleInfo.path);
+            const packageJsonPath = (0, path_1.join)(modulePath, 'package.json');
+            if ((0, fs_1.existsSync)(packageJsonPath)) {
+                try {
+                    const packageJson = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, 'utf-8'));
+                    const npmName = packageJson.name;
+                    if (npmName && npmName !== controlName) {
+                        aliasMap[npmName] = controlName;
+                    }
+                }
+                catch {
+                    // Skip modules with invalid package.json
+                }
+            }
+        }
+    }
+    catch {
+        // Return empty map if we can't access workspace
+    }
+    return aliasMap;
+}
+/**
+ * Resolve a package name that might be an npm alias to its control file name.
+ * If the input is already a control file name or not found in aliases, returns as-is.
+ *
+ * @param input - The package name (could be npm name like @scope/pkg or control name)
+ * @param cwd - The current working directory
+ * @returns The resolved control file name
+ */
+function resolvePackageAlias(input, cwd) {
+    if (!input) {
+        return input;
+    }
+    const aliasMap = buildPackageAliasMap(cwd);
+    return aliasMap[input] ?? input;
+}
+/**
+ * Get the npm package name for a given control file name, if available.
+ * Returns undefined if no npm alias exists.
+ *
+ * @param controlName - The control file name (extension name)
+ * @param cwd - The current working directory
+ * @returns The npm package name or undefined
+ */
+function getNpmNameForControl(controlName, cwd) {
+    const aliasMap = buildPackageAliasMap(cwd);
+    for (const [npmName, ctrlName] of Object.entries(aliasMap)) {
+        if (ctrlName === controlName) {
+            return npmName;
+        }
+    }
+    return undefined;
+}
+/**
+ * Format a module name for display, showing both control name and npm alias if available.
+ * Example: "my-module (@scope/my-module)" or just "my-module" if no alias
+ *
+ * @param controlName - The control file name
+ * @param cwd - The current working directory
+ * @returns Formatted display string
+ */
+function formatModuleNameWithAlias(controlName, cwd) {
+    const npmName = getNpmNameForControl(controlName, cwd);
+    if (npmName) {
+        return `${controlName} (${npmName})`;
+    }
+    return controlName;
+}