pgpm 2.5.0 → 2.6.0

package/README.md

@@ -1,5 +1,17 @@
 # **pgpm — a Postgres Package Manager**
 
+<p align="center" width="100%">
+  <img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
+</p>
+
+<p align="center" width="100%">
+  <a href="https://github.com/constructive-io/constructive/actions/workflows/run-tests.yaml">
+    <img height="20" src="https://github.com/constructive-io/constructive/actions/workflows/run-tests.yaml/badge.svg" />
+  </a>
+   <a href="https://github.com/constructive-io/constructive/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
+   <a href="https://www.npmjs.com/package/pgpm"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/constructive?filename=pgpm%2Fcli%2Fpackage.json"/></a>
+</p>
+
 **A modern CLI for modular PostgreSQL development.**
 
 `pgpm` is a focused command-line tool for PostgreSQL database migrations and package management. It provides the core functionality for managing database schemas, migrations, and module dependencies.
@@ -446,9 +458,14 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
 
 ## Related Constructive Tooling
 
+### 📦 Package Management
+
+* [pgpm](https://github.com/constructive-io/constructive/tree/main/pgpm/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
+
 ### 🧪 Testing
 
 * [pgsql-test](https://github.com/constructive-io/constructive/tree/main/postgres/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
+* [pgsql-seed](https://github.com/constructive-io/constructive/tree/main/postgres/pgsql-seed): **🌱 PostgreSQL seeding utilities** for CSV, JSON, SQL data loading, and pgpm deployment.
 * [supabase-test](https://github.com/constructive-io/constructive/tree/main/postgres/supabase-test): **🧪 Supabase-native test harness** preconfigured for the local Supabase stack—per-test rollbacks, JWT/role context helpers, and CI/GitHub Actions ready.
 * [graphile-test](https://github.com/constructive-io/constructive/tree/main/graphile/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts.
 * [pg-query-context](https://github.com/constructive-io/constructive/tree/main/postgres/pg-query-context): **🔒 Session context injection** to add session-local context (e.g., `SET LOCAL`) into queries—ideal for setting `role`, `jwt.claims`, and other session settings.
@@ -462,28 +479,6 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
 * [@pgsql/types](https://www.npmjs.com/package/@pgsql/types): **📝 Type definitions** for PostgreSQL AST nodes in TypeScript.
 * [@pgsql/utils](https://www.npmjs.com/package/@pgsql/utils): **🛠️ AST utilities** for constructing and transforming PostgreSQL syntax trees.
 
-### 🚀 API & Dev Tools
-
-* [@constructive-io/graphql-server](https://github.com/constructive-io/constructive/tree/main/graphql/server): **⚡ Express-based API server** powered by PostGraphile to expose a secure, scalable GraphQL API over your Postgres database.
-* [@constructive-io/graphql-explorer](https://github.com/constructive-io/constructive/tree/main/graphql/explorer): **🔎 Visual API explorer** with GraphiQL for browsing across all databases and schemas—useful for debugging, documentation, and API prototyping.
-
-### 🔁 Streaming & Uploads
-
-* [etag-hash](https://github.com/constructive-io/constructive/tree/main/streaming/etag-hash): **🏷️ S3-compatible ETags** created by streaming and hashing file uploads in chunks.
-* [etag-stream](https://github.com/constructive-io/constructive/tree/main/streaming/etag-stream): **🔄 ETag computation** via Node stream transformer during upload or transfer.
-* [uuid-hash](https://github.com/constructive-io/constructive/tree/main/streaming/uuid-hash): **🆔 Deterministic UUIDs** generated from hashed content, great for deduplication and asset referencing.
-* [uuid-stream](https://github.com/constructive-io/constructive/tree/main/streaming/uuid-stream): **🌊 Streaming UUID generation** based on piped file content—ideal for upload pipelines.
-* [@constructive-io/s3-streamer](https://github.com/constructive-io/constructive/tree/main/streaming/s3-streamer): **📤 Direct S3 streaming** for large files with support for metadata injection and content validation.
-* [@constructive-io/upload-names](https://github.com/constructive-io/constructive/tree/main/streaming/upload-names): **📂 Collision-resistant filenames** utility for structured and unique file names for uploads.
-
-### 🧰 CLI & Codegen
-
-* [pgpm](https://github.com/constructive-io/constructive/tree/main/pgpm/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
-* [@constructive-io/cli](https://github.com/constructive-io/constructive/tree/main/packages/cli): **🖥️ Command-line toolkit** for managing Constructive projects—supports database scaffolding, migrations, seeding, code generation, and automation.
-* [@constructive-io/graphql-codegen](https://github.com/constructive-io/constructive/tree/main/graphql/codegen): **✨ GraphQL code generation** (types, operations, SDK) from schema/endpoint introspection.
-* [@constructive-io/query-builder](https://github.com/constructive-io/constructive/tree/main/packages/query-builder): **🏗️ SQL constructor** providing a robust TypeScript-based query builder for dynamic generation of `SELECT`, `INSERT`, `UPDATE`, `DELETE`, and stored procedure calls—supports advanced SQL features like `JOIN`, `GROUP BY`, and schema-qualified queries.
-* [@constructive-io/graphql-query](https://github.com/constructive-io/constructive/tree/main/graphql/query): **🧩 Fluent GraphQL builder** for PostGraphile schemas. ⚡ Schema-aware via introspection, 🧩 composable and ergonomic for building deeply nested queries.
-
 ## Credits
 
 **🛠 Built by the [Constructive](https://constructive.io) team — creators of modular Postgres tooling for secure, composable backends. If you like our work, contribute on [GitHub](https://github.com/constructive-io).**

package/commands/install.js

@@ -1,23 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@pgpmjs/core");
+const logger_1 = require("@pgpmjs/logger");
+const logger = new logger_1.Logger('pgpm');
 const installUsageText = `
 Install Command:
 
-  pgpm install <package>...
+  pgpm install [package]...
 
   Install pgpm modules into current module.
 
+  When called without arguments, installs any missing modules that are
+  listed in the module's .control file but not yet installed in the workspace.
+
 Arguments:
-  package                 One or more package names to install
+  package                 One or more package names to install (optional)
 
 Options:
   --help, -h              Show this help message
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
+  pgpm install                                 Install missing modules from .control file
   pgpm install @pgpm/base32                    Install single package
-  pgpm install @pgpm/base32 @pgpm/utils   Install multiple packages
+  pgpm install @pgpm/base32 @pgpm/utils        Install multiple packages
 `;
 exports.default = async (argv, prompter, _options) => {
     // Show usage if explicitly requested
@@ -30,8 +36,19 @@ exports.default = async (argv, prompter, _options) => {
     if (!project.isInModule()) {
         throw new Error('You must run this command inside a PGPM module.');
     }
+    // If no packages specified, install missing modules from .control file
     if (argv._.length === 0) {
-        throw new Error('You must provide a package name to install, e.g. `@pgpm/base32`');
+        const requiredExtensions = project.getRequiredModules();
+        const installedModules = project.getWorkspaceInstalledModules();
+        const missingModules = (0, core_1.getMissingInstallableModules)(requiredExtensions, installedModules);
+        if (missingModules.length === 0) {
+            logger.success('All modules are already installed.');
+            return;
+        }
+        const missingNames = missingModules.map(m => m.npmName);
+        logger.info(`Installing missing modules: ${missingNames.join(', ')}`);
+        await project.installModules(...missingNames);
+        return;
     }
     await project.installModules(...argv._);
 };

package/commands/{upgrade-modules.js → upgrade.js}

@@ -2,29 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@pgpmjs/core");
 const logger_1 = require("@pgpmjs/logger");
+const inquirerer_1 = require("inquirerer");
 const npm_version_1 = require("../utils/npm-version");
-const log = new logger_1.Logger('upgrade-modules');
-const upgradeModulesUsageText = `
-Upgrade Modules Command:
+const log = new logger_1.Logger('upgrade');
+const upgradeUsageText = `
+Upgrade Command:
 
-  pgpm upgrade-modules [OPTIONS]
+  pgpm upgrade [PACKAGE...] [OPTIONS]
 
   Upgrade installed pgpm modules to their latest versions from npm.
+  When used without arguments, upgrades all modules.
 
 Options:
   --help, -h              Show this help message
   --cwd <directory>       Working directory (default: current directory)
-  --all                   Upgrade all modules without prompting
+  -i, --interactive       Show outdated modules and select which ones to upgrade
   --dry-run               Show what would be upgraded without making changes
-  --modules <names>       Comma-separated list of specific modules to upgrade
   --workspace             Upgrade modules across all packages in the workspace
 
 Examples:
-  pgpm upgrade-modules                     Interactive selection of modules to upgrade
-  pgpm upgrade-modules --all               Upgrade all installed modules
-  pgpm upgrade-modules --dry-run           Preview available upgrades
-  pgpm upgrade-modules --modules @pgpm/base32,@pgpm/faker   Upgrade specific modules
-  pgpm upgrade-modules --workspace --all   Upgrade all modules across the entire workspace
+  pgpm upgrade                          Upgrade all installed modules
+  pgpm upgrade -i                       Interactive selection of modules to upgrade
+  pgpm upgrade @pgpm/base32             Upgrade specific module
+  pgpm upgrade @pgpm/base32 @pgpm/uuid  Upgrade multiple specific modules
+  pgpm upgrade --dry-run                Preview available upgrades
+  pgpm upgrade --workspace              Upgrade all modules across the entire workspace
+  pgpm up                               Alias for upgrade
 `;
 async function fetchModuleVersions(installedVersions) {
     const moduleNames = Object.keys(installedVersions);
@@ -41,7 +44,7 @@ async function fetchModuleVersions(installedVersions) {
     }
     return results;
 }
-async function upgradeModulesForProject(project, argv, prompter, dryRun, upgradeAll, specificModules, moduleName) {
+async function upgradeModulesForProject(project, argv, prompter, dryRun, interactive, specificModules, moduleName) {
     const { installed, installedVersions } = project.getInstalledModules();
     if (installed.length === 0) {
         if (moduleName) {
@@ -53,9 +56,12 @@ async function upgradeModulesForProject(project, argv, prompter, dryRun, upgrade
         return false;
     }
     const prefix = moduleName ? `[${moduleName}] ` : '';
-    log.info(`${prefix}Found ${installed.length} installed module(s). Checking for updates...`);
+    // Use spinner while checking for updates
+    const spinner = (0, inquirerer_1.createSpinner)(`${prefix}Checking ${installed.length} installed module(s) for updates...`);
+    spinner.start();
     const moduleVersions = await fetchModuleVersions(installedVersions);
     const modulesWithUpdates = moduleVersions.filter(m => m.hasUpdate);
+    spinner.succeed(`${prefix}Found ${modulesWithUpdates.length} module(s) with updates available`);
     if (modulesWithUpdates.length === 0) {
         log.success(`${prefix}All modules are already up to date.`);
         return false;
@@ -70,10 +76,8 @@ async function upgradeModulesForProject(project, argv, prompter, dryRun, upgrade
         return true;
     }
     let modulesToUpgrade;
-    if (upgradeAll) {
-        modulesToUpgrade = modulesWithUpdates.map(m => m.name);
-    }
-    else if (specificModules) {
+    if (specificModules && specificModules.length > 0) {
+        // Specific modules provided as positional arguments
         modulesToUpgrade = modulesWithUpdates
             .filter(m => specificModules.includes(m.name))
             .map(m => m.name);
@@ -82,32 +86,24 @@ async function upgradeModulesForProject(project, argv, prompter, dryRun, upgrade
             return false;
         }
     }
-    else {
-        const options = modulesWithUpdates.map(mod => ({
+    else if (interactive) {
+        // Interactive mode: use pnpm-style upgrade UI
+        const packages = modulesWithUpdates.map(mod => ({
             name: mod.name,
-            value: mod.name,
-            message: `${mod.name} (${mod.currentVersion} -> ${mod.latestVersion})`
+            current: mod.currentVersion,
+            latest: mod.latestVersion,
+            type: 'dependencies'
         }));
-        const questions = [
-            {
-                name: 'selectedModules',
-                message: `${prefix}Select modules to upgrade:`,
-                type: 'checkbox',
-                options: options.map(o => o.message),
-                default: options.map(o => o.message)
-            }
-        ];
-        const answers = await prompter.prompt(argv, questions);
-        const selectedOptions = answers.selectedModules
-            .filter(opt => opt.selected)
-            .map(opt => opt.name);
-        modulesToUpgrade = modulesWithUpdates
-            .filter(mod => selectedOptions.includes(`${mod.name} (${mod.currentVersion} -> ${mod.latestVersion})`))
-            .map(m => m.name);
-        if (modulesToUpgrade.length === 0) {
+        const result = await (0, inquirerer_1.upgradePrompt)(packages, 10);
+        if (result.updates.length === 0) {
             log.info(`${prefix}No modules selected for upgrade.`);
             return false;
         }
+        modulesToUpgrade = result.updates.map(u => u.name);
+    }
+    else {
+        // Default behavior: upgrade all modules with updates (like pnpm upgrade)
+        modulesToUpgrade = modulesWithUpdates.map(m => m.name);
     }
     log.info(`\n${prefix}Upgrading ${modulesToUpgrade.length} module(s)...`);
     await project.upgradeModules({ modules: modulesToUpgrade });
@@ -116,15 +112,16 @@ async function upgradeModulesForProject(project, argv, prompter, dryRun, upgrade
 }
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
-        console.log(upgradeModulesUsageText);
+        console.log(upgradeUsageText);
         process.exit(0);
     }
     const { cwd = process.cwd() } = argv;
     const dryRun = Boolean(argv['dry-run']);
-    const upgradeAll = Boolean(argv.all);
+    const interactive = Boolean(argv.i || argv.interactive);
     const workspaceMode = Boolean(argv.workspace);
-    const specificModules = argv.modules
-        ? String(argv.modules).split(',').map(m => m.trim())
+    // Get specific modules from positional arguments (argv._)
+    const specificModules = argv._ && argv._.length > 0
+        ? argv._.map((m) => String(m).trim())
         : undefined;
     const project = new core_1.PgpmPackage(cwd);
     if (workspaceMode) {
@@ -140,7 +137,7 @@ exports.default = async (argv, prompter, _options) => {
         let anyUpgraded = false;
         for (const moduleProject of modules) {
             const moduleName = moduleProject.getModuleName();
-            const upgraded = await upgradeModulesForProject(moduleProject, argv, prompter, dryRun, upgradeAll, specificModules, moduleName);
+            const upgraded = await upgradeModulesForProject(moduleProject, argv, prompter, dryRun, interactive, specificModules, moduleName);
             if (upgraded) {
                 anyUpgraded = true;
             }
@@ -154,6 +151,6 @@ exports.default = async (argv, prompter, _options) => {
         if (!project.isInModule()) {
             throw new Error('You must run this command inside a PGPM module. Use --workspace to upgrade all modules in the workspace.');
         }
-        await upgradeModulesForProject(project, argv, prompter, dryRun, upgradeAll, specificModules);
+        await upgradeModulesForProject(project, argv, prompter, dryRun, interactive, specificModules);
     }
 };

package/commands.js

@@ -24,7 +24,7 @@ const migrate_1 = __importDefault(require("./commands/migrate"));
 const package_1 = __importDefault(require("./commands/package"));
 const plan_1 = __importDefault(require("./commands/plan"));
 const update_1 = __importDefault(require("./commands/update"));
-const upgrade_modules_1 = __importDefault(require("./commands/upgrade-modules"));
+const upgrade_1 = __importDefault(require("./commands/upgrade"));
 const remove_1 = __importDefault(require("./commands/remove"));
 const rename_1 = __importDefault(require("./commands/rename"));
 const revert_1 = __importDefault(require("./commands/revert"));
@@ -66,7 +66,8 @@ const createPgpmCommandMap = (skipPgTeardown = false) => {
         analyze: pgt(analyze_1.default),
         rename: pgt(rename_1.default),
         'test-packages': pgt(test_packages_1.default),
-        'upgrade-modules': pgt(upgrade_modules_1.default),
+        upgrade: pgt(upgrade_1.default),
+        up: pgt(upgrade_1.default),
         cache: cache_1.default,
         update: update_1.default
     };

package/esm/commands/install.js

@@ -1,21 +1,27 @@
-import { PgpmPackage } from '@pgpmjs/core';
+import { getMissingInstallableModules, PgpmPackage } from '@pgpmjs/core';
+import { Logger } from '@pgpmjs/logger';
+const logger = new Logger('pgpm');
 const installUsageText = `
 Install Command:
 
-  pgpm install <package>...
+  pgpm install [package]...
 
   Install pgpm modules into current module.
 
+  When called without arguments, installs any missing modules that are
+  listed in the module's .control file but not yet installed in the workspace.
+
 Arguments:
-  package                 One or more package names to install
+  package                 One or more package names to install (optional)
 
 Options:
   --help, -h              Show this help message
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
+  pgpm install                                 Install missing modules from .control file
   pgpm install @pgpm/base32                    Install single package
-  pgpm install @pgpm/base32 @pgpm/utils   Install multiple packages
+  pgpm install @pgpm/base32 @pgpm/utils        Install multiple packages
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested
@@ -28,8 +34,19 @@ export default async (argv, prompter, _options) => {
     if (!project.isInModule()) {
         throw new Error('You must run this command inside a PGPM module.');
     }
+    // If no packages specified, install missing modules from .control file
     if (argv._.length === 0) {
-        throw new Error('You must provide a package name to install, e.g. `@pgpm/base32`');
+        const requiredExtensions = project.getRequiredModules();
+        const installedModules = project.getWorkspaceInstalledModules();
+        const missingModules = getMissingInstallableModules(requiredExtensions, installedModules);
+        if (missingModules.length === 0) {
+            logger.success('All modules are already installed.');
+            return;
+        }
+        const missingNames = missingModules.map(m => m.npmName);
+        logger.info(`Installing missing modules: ${missingNames.join(', ')}`);
+        await project.installModules(...missingNames);
+        return;
     }
     await project.installModules(...argv._);
 };

package/esm/commands/{upgrade-modules.js → upgrade.js}

@@ -1,28 +1,31 @@
 import { PgpmPackage } from '@pgpmjs/core';
 import { Logger } from '@pgpmjs/logger';
+import { upgradePrompt, createSpinner } from 'inquirerer';
 import { fetchLatestVersion } from '../utils/npm-version';
-const log = new Logger('upgrade-modules');
-const upgradeModulesUsageText = `
-Upgrade Modules Command:
+const log = new Logger('upgrade');
+const upgradeUsageText = `
+Upgrade Command:
 
-  pgpm upgrade-modules [OPTIONS]
+  pgpm upgrade [PACKAGE...] [OPTIONS]
 
   Upgrade installed pgpm modules to their latest versions from npm.
+  When used without arguments, upgrades all modules.
 
 Options:
   --help, -h              Show this help message
   --cwd <directory>       Working directory (default: current directory)
-  --all                   Upgrade all modules without prompting
+  -i, --interactive       Show outdated modules and select which ones to upgrade
   --dry-run               Show what would be upgraded without making changes
-  --modules <names>       Comma-separated list of specific modules to upgrade
   --workspace             Upgrade modules across all packages in the workspace
 
 Examples:
-  pgpm upgrade-modules                     Interactive selection of modules to upgrade
-  pgpm upgrade-modules --all               Upgrade all installed modules
-  pgpm upgrade-modules --dry-run           Preview available upgrades
-  pgpm upgrade-modules --modules @pgpm/base32,@pgpm/faker   Upgrade specific modules
-  pgpm upgrade-modules --workspace --all   Upgrade all modules across the entire workspace
+  pgpm upgrade                          Upgrade all installed modules
+  pgpm upgrade -i                       Interactive selection of modules to upgrade
+  pgpm upgrade @pgpm/base32             Upgrade specific module
+  pgpm upgrade @pgpm/base32 @pgpm/uuid  Upgrade multiple specific modules
+  pgpm upgrade --dry-run                Preview available upgrades
+  pgpm upgrade --workspace              Upgrade all modules across the entire workspace
+  pgpm up                               Alias for upgrade
 `;
 async function fetchModuleVersions(installedVersions) {
     const moduleNames = Object.keys(installedVersions);
@@ -39,7 +42,7 @@ async function fetchModuleVersions(installedVersions) {
     }
     return results;
 }
-async function upgradeModulesForProject(project, argv, prompter, dryRun, upgradeAll, specificModules, moduleName) {
+async function upgradeModulesForProject(project, argv, prompter, dryRun, interactive, specificModules, moduleName) {
     const { installed, installedVersions } = project.getInstalledModules();
     if (installed.length === 0) {
         if (moduleName) {
@@ -51,9 +54,12 @@ async function upgradeModulesForProject(project, argv, prompter, dryRun, upgrade
         return false;
     }
     const prefix = moduleName ? `[${moduleName}] ` : '';
-    log.info(`${prefix}Found ${installed.length} installed module(s). Checking for updates...`);
+    // Use spinner while checking for updates
+    const spinner = createSpinner(`${prefix}Checking ${installed.length} installed module(s) for updates...`);
+    spinner.start();
     const moduleVersions = await fetchModuleVersions(installedVersions);
     const modulesWithUpdates = moduleVersions.filter(m => m.hasUpdate);
+    spinner.succeed(`${prefix}Found ${modulesWithUpdates.length} module(s) with updates available`);
     if (modulesWithUpdates.length === 0) {
         log.success(`${prefix}All modules are already up to date.`);
         return false;
@@ -68,10 +74,8 @@ async function upgradeModulesForProject(project, argv, prompter, dryRun, upgrade
         return true;
     }
     let modulesToUpgrade;
-    if (upgradeAll) {
-        modulesToUpgrade = modulesWithUpdates.map(m => m.name);
-    }
-    else if (specificModules) {
+    if (specificModules && specificModules.length > 0) {
+        // Specific modules provided as positional arguments
         modulesToUpgrade = modulesWithUpdates
             .filter(m => specificModules.includes(m.name))
             .map(m => m.name);
@@ -80,32 +84,24 @@ async function upgradeModulesForProject(project, argv, prompter, dryRun, upgrade
             return false;
         }
     }
-    else {
-        const options = modulesWithUpdates.map(mod => ({
+    else if (interactive) {
+        // Interactive mode: use pnpm-style upgrade UI
+        const packages = modulesWithUpdates.map(mod => ({
             name: mod.name,
-            value: mod.name,
-            message: `${mod.name} (${mod.currentVersion} -> ${mod.latestVersion})`
+            current: mod.currentVersion,
+            latest: mod.latestVersion,
+            type: 'dependencies'
         }));
-        const questions = [
-            {
-                name: 'selectedModules',
-                message: `${prefix}Select modules to upgrade:`,
-                type: 'checkbox',
-                options: options.map(o => o.message),
-                default: options.map(o => o.message)
-            }
-        ];
-        const answers = await prompter.prompt(argv, questions);
-        const selectedOptions = answers.selectedModules
-            .filter(opt => opt.selected)
-            .map(opt => opt.name);
-        modulesToUpgrade = modulesWithUpdates
-            .filter(mod => selectedOptions.includes(`${mod.name} (${mod.currentVersion} -> ${mod.latestVersion})`))
-            .map(m => m.name);
-        if (modulesToUpgrade.length === 0) {
+        const result = await upgradePrompt(packages, 10);
+        if (result.updates.length === 0) {
             log.info(`${prefix}No modules selected for upgrade.`);
             return false;
         }
+        modulesToUpgrade = result.updates.map(u => u.name);
+    }
+    else {
+        // Default behavior: upgrade all modules with updates (like pnpm upgrade)
+        modulesToUpgrade = modulesWithUpdates.map(m => m.name);
     }
     log.info(`\n${prefix}Upgrading ${modulesToUpgrade.length} module(s)...`);
     await project.upgradeModules({ modules: modulesToUpgrade });
@@ -114,15 +110,16 @@ async function upgradeModulesForProject(project, argv, prompter, dryRun, upgrade
 }
 export default async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
-        console.log(upgradeModulesUsageText);
+        console.log(upgradeUsageText);
         process.exit(0);
     }
     const { cwd = process.cwd() } = argv;
     const dryRun = Boolean(argv['dry-run']);
-    const upgradeAll = Boolean(argv.all);
+    const interactive = Boolean(argv.i || argv.interactive);
     const workspaceMode = Boolean(argv.workspace);
-    const specificModules = argv.modules
-        ? String(argv.modules).split(',').map(m => m.trim())
+    // Get specific modules from positional arguments (argv._)
+    const specificModules = argv._ && argv._.length > 0
+        ? argv._.map((m) => String(m).trim())
         : undefined;
     const project = new PgpmPackage(cwd);
     if (workspaceMode) {
@@ -138,7 +135,7 @@ export default async (argv, prompter, _options) => {
         let anyUpgraded = false;
         for (const moduleProject of modules) {
             const moduleName = moduleProject.getModuleName();
-            const upgraded = await upgradeModulesForProject(moduleProject, argv, prompter, dryRun, upgradeAll, specificModules, moduleName);
+            const upgraded = await upgradeModulesForProject(moduleProject, argv, prompter, dryRun, interactive, specificModules, moduleName);
             if (upgraded) {
                 anyUpgraded = true;
             }
@@ -152,6 +149,6 @@ export default async (argv, prompter, _options) => {
         if (!project.isInModule()) {
             throw new Error('You must run this command inside a PGPM module. Use --workspace to upgrade all modules in the workspace.');
         }
-        await upgradeModulesForProject(project, argv, prompter, dryRun, upgradeAll, specificModules);
+        await upgradeModulesForProject(project, argv, prompter, dryRun, interactive, specificModules);
     }
 };

package/esm/commands.js

@@ -18,7 +18,7 @@ import migrate from './commands/migrate';
 import _package from './commands/package';
 import plan from './commands/plan';
 import updateCmd from './commands/update';
-import upgradeModules from './commands/upgrade-modules';
+import upgrade from './commands/upgrade';
 import remove from './commands/remove';
 import renameCmd from './commands/rename';
 import revert from './commands/revert';
@@ -60,7 +60,8 @@ export const createPgpmCommandMap = (skipPgTeardown = false) => {
         analyze: pgt(analyze),
         rename: pgt(renameCmd),
         'test-packages': pgt(testPackages),
-        'upgrade-modules': pgt(upgradeModules),
+        upgrade: pgt(upgrade),
+        up: pgt(upgrade),
         cache,
         update: updateCmd
     };

package/esm/utils/display.js

@@ -15,7 +15,7 @@ export const usageText = `
     export             Export database migrations from existing databases
     update             Update pgpm to the latest version
     cache              Manage cached templates (clean)
-    upgrade-modules    Upgrade installed pgpm modules to latest versions
+    upgrade            Upgrade installed pgpm modules to latest versions (alias: up)
 
   Database Administration:
     kill               Terminate database connections and optionally drop databases

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgpm",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "PostgreSQL Package Manager - Database migration and package management CLI",
   "main": "index.js",
@@ -33,13 +33,13 @@
     "test:watch": "jest --watch"
   },
   "devDependencies": {
+    "@inquirerer/test": "^1.2.0",
     "@types/js-yaml": "^4.0.9",
     "@types/minimist": "^1.2.5",
     "@types/node": "^20.12.7",
     "@types/pg": "^8.16.0",
     "@types/semver": "^7.5.8",
     "@types/shelljs": "^0.8.16",
-    "clean-ansi": "0.1.5",
     "glob": "^13.0.0",
     "makage": "^0.1.9",
     "pg": "^8.16.3",
@@ -47,14 +47,14 @@
   },
   "dependencies": {
     "@inquirerer/utils": "^3.1.1",
-    "@pgpmjs/core": "^4.3.0",
+    "@pgpmjs/core": "^4.5.0",
     "@pgpmjs/env": "^2.8.11",
     "@pgpmjs/logger": "^1.3.5",
     "@pgpmjs/types": "^2.12.8",
     "appstash": "^0.2.6",
     "find-and-require-package-json": "^0.8.2",
-    "genomic": "^5.0.2",
-    "inquirerer": "^4.1.1",
+    "genomic": "^5.2.0",
+    "inquirerer": "^4.2.0",
     "js-yaml": "^4.1.0",
     "minimist": "^1.2.8",
     "pg-cache": "^1.6.11",
@@ -75,5 +75,5 @@
     "pg",
     "pgsql"
   ],
-  "gitHead": "7ac931c063d48e281349b748ba2eb9c9f47ffb06"
+  "gitHead": "09721f934b339bd8c55d2e633abaded6d20b0f65"
 }

package/utils/display.d.ts

@@ -1 +1 @@
-export declare const usageText = "\n  Usage: pgpm <command> [options]\n\n  Core Database Operations:\n    add                Add database changes to plans and create SQL files\n    deploy             Deploy database changes and migrations\n    verify             Verify database state and migrations\n    revert             Revert database changes and migrations\n\n  Project Management:\n    init               Initialize workspace or module\n    extension          Manage module dependencies\n    plan               Generate module deployment plans\n    package            Package module for distribution\n    export             Export database migrations from existing databases\n    update             Update pgpm to the latest version\n    cache              Manage cached templates (clean)\n    upgrade-modules    Upgrade installed pgpm modules to latest versions\n\n  Database Administration:\n    kill               Terminate database connections and optionally drop databases\n    install            Install database modules\n    tag                Add tags to changes for versioning\n    clear              Clear database state\n    remove             Remove database changes\n    analyze            Analyze database structure\n    rename             Rename database changes\n    admin-users        Manage admin users\n\n  Testing:\n    test-packages      Run integration tests on all workspace packages\n\n  Migration Tools:\n    migrate            Migration management subcommands\n      init             Initialize migration tracking\n      status           Show migration status\n      list             List all changes\n      deps             Show change dependencies\n  \n  Development Tools:\n    docker             Manage PostgreSQL Docker containers (start/stop)\n    env                Manage PostgreSQL environment variables\n    test-packages      Run integration tests on workspace packages\n  \n  Global Options:\n    -h, --help         Display this help information\n    -v, --version      Display version information\n    --cwd <directory>  Working directory (default: current directory)\n\n  Individual Command Help:\n    pgpm <command> --help    Display detailed help for specific command\n    pgpm <command> -h        Display detailed help for specific command\n\n  Examples:\n    pgpm deploy --help       Show deploy command options\n    pgpm init workspace      Initialize new workspace\n    pgpm install @pgpm/base32  Install a database module\n  ";
+export declare const usageText = "\n  Usage: pgpm <command> [options]\n\n  Core Database Operations:\n    add                Add database changes to plans and create SQL files\n    deploy             Deploy database changes and migrations\n    verify             Verify database state and migrations\n    revert             Revert database changes and migrations\n\n  Project Management:\n    init               Initialize workspace or module\n    extension          Manage module dependencies\n    plan               Generate module deployment plans\n    package            Package module for distribution\n    export             Export database migrations from existing databases\n    update             Update pgpm to the latest version\n    cache              Manage cached templates (clean)\n    upgrade            Upgrade installed pgpm modules to latest versions (alias: up)\n\n  Database Administration:\n    kill               Terminate database connections and optionally drop databases\n    install            Install database modules\n    tag                Add tags to changes for versioning\n    clear              Clear database state\n    remove             Remove database changes\n    analyze            Analyze database structure\n    rename             Rename database changes\n    admin-users        Manage admin users\n\n  Testing:\n    test-packages      Run integration tests on all workspace packages\n\n  Migration Tools:\n    migrate            Migration management subcommands\n      init             Initialize migration tracking\n      status           Show migration status\n      list             List all changes\n      deps             Show change dependencies\n  \n  Development Tools:\n    docker             Manage PostgreSQL Docker containers (start/stop)\n    env                Manage PostgreSQL environment variables\n    test-packages      Run integration tests on workspace packages\n  \n  Global Options:\n    -h, --help         Display this help information\n    -v, --version      Display version information\n    --cwd <directory>  Working directory (default: current directory)\n\n  Individual Command Help:\n    pgpm <command> --help    Display detailed help for specific command\n    pgpm <command> -h        Display detailed help for specific command\n\n  Examples:\n    pgpm deploy --help       Show deploy command options\n    pgpm init workspace      Initialize new workspace\n    pgpm install @pgpm/base32  Install a database module\n  ";

package/utils/display.js

@@ -18,7 +18,7 @@ exports.usageText = `
     export             Export database migrations from existing databases
     update             Update pgpm to the latest version
     cache              Manage cached templates (clean)
-    upgrade-modules    Upgrade installed pgpm modules to latest versions
+    upgrade            Upgrade installed pgpm modules to latest versions (alias: up)
 
   Database Administration:
     kill               Terminate database connections and optionally drop databases