pgpm 5.7.0 → 5.8.1

package/commands/init/index.js

@@ -11,6 +11,7 @@ const core_1 = require("@pgpmjs/core");
 const env_1 = require("@pgpmjs/env");
 const types_1 = require("@pgpmjs/types");
 const inquirerer_1 = require("inquirerer");
+const utils_1 = require("../../utils");
 const boilerplate_1 = require("./boilerplate");
 const DEFAULT_MOTD = `
                  |              _   _
@@ -80,7 +81,7 @@ async function handleInit(argv, prompter) {
         pglite: Boolean(argv.pglite),
     });
     const branch = argv.fromBranch;
-    const noTty = Boolean(argv.noTty || argv['no-tty'] || argv.tty === false || process.env.CI === 'true');
+    const noTty = (0, utils_1.isNoTtyRequested)(argv);
     const useBoilerplatePrompt = Boolean(argv.boilerplate);
     const createWorkspace = Boolean(argv.createWorkspace || argv['create-workspace'] || argv.w);
     const useNpxSkills = Boolean(argv.useSkills || argv['use-skills']);
@@ -437,7 +438,7 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
             workspaceTypeName = workspaceType.toUpperCase();
         }
         if (!resolvedWorkspacePath) {
-            const noTty = Boolean(argv.noTty || argv['no-tty'] || argv.tty === false || process.env.CI === 'true');
+            const noTty = (0, utils_1.isNoTtyRequested)(argv);
             // Handle --create-workspace flag: create workspace first, then module
             if (ctx.createWorkspace && (workspaceType === 'pgpm' || workspaceType === 'pnpm')) {
                 // Resolve workspace template repo with fallback to default

package/commands/init/workspace.js

@@ -8,6 +8,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const core_1 = require("@pgpmjs/core");
 const inquirerer_1 = require("inquirerer");
+const utils_1 = require("../../utils");
 const DEFAULT_MOTD = `
                  |              _   _
      ===         |.===.        '\\-//\`
@@ -48,7 +49,7 @@ async function runWorkspaceSetup(argv, prompter) {
             workspaceName: answers.name
         },
         toolName: core_1.DEFAULT_TEMPLATE_TOOL_NAME,
-        noTty: Boolean(argv.noTty || argv['no-tty'] || argv.tty === false || process.env.CI === 'true'),
+        noTty: (0, utils_1.isNoTtyRequested)(argv),
         cwd,
         prompter
     });

package/commands/sync-versions.d.ts

@@ -0,0 +1,3 @@
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, any>>, _prompter: Inquirerer, _options: CLIOptions) => Promise<Partial<Record<string, any>>>;
+export default _default;

package/commands/sync-versions.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@pgpmjs/core");
+const syncVersionsUsageText = `
+Sync Versions Command:
+
+  pgpm sync-versions [OPTIONS]
+
+  Sync extension metadata (.control default_version, Makefile sql filename,
+  and the sql/<name>--<version>.sql bundle) to each module's package.json
+  version. Inside a module, syncs just that module; at a workspace root,
+  syncs every workspace module.
+
+Options:
+  --help, -h                      Show this help message
+  --check                         Report version skew without writing; exits non-zero if skewed
+  --cwd <directory>               Working directory (default: current directory)
+
+Examples:
+  pgpm sync-versions               Sync all out-of-sync modules
+  pgpm sync-versions --check       Fail if any module's metadata is out of sync (for CI)
+`;
+exports.default = async (argv, _prompter, _options) => {
+    // Show usage if explicitly requested
+    if (argv.help || argv.h) {
+        console.log(syncVersionsUsageText);
+        process.exit(0);
+    }
+    const cwd = argv.cwd ?? process.cwd();
+    const check = Boolean(argv.check);
+    const project = new core_1.PgpmPackage(cwd);
+    const result = await project.syncVersions({ check });
+    if (check) {
+        if (result.skewed.length > 0) {
+            console.log(`${result.skewed.length} module(s) out of sync:`);
+            for (const status of result.skewed) {
+                console.log(`  ${status.name}: package.json ${status.packageVersion} != control ${status.controlVersion}` +
+                    (status.sqlFileExists ? '' : ` (missing sql/${status.name}--${status.packageVersion}.sql)`));
+            }
+            process.exit(1);
+        }
+        console.log(`All ${result.ok.length} module(s) in sync.`);
+        return argv;
+    }
+    if (result.synced.length === 0) {
+        console.log(`All ${result.ok.length} module(s) already in sync.`);
+    }
+    else {
+        console.log(`Synced ${result.synced.length} module(s); ${result.ok.length} already in sync.`);
+    }
+    return argv;
+};

package/commands.js

@@ -29,6 +29,7 @@ const remove_1 = __importDefault(require("./commands/remove"));
 const rename_1 = __importDefault(require("./commands/rename"));
 const revert_1 = __importDefault(require("./commands/revert"));
 const slice_1 = __importDefault(require("./commands/slice"));
+const sync_versions_1 = __importDefault(require("./commands/sync-versions"));
 const tag_1 = __importDefault(require("./commands/tag"));
 const test_packages_1 = __importDefault(require("./commands/test-packages"));
 const tune_1 = __importDefault(require("./commands/tune"));
@@ -72,6 +73,7 @@ const createPgpmCommandMap = (skipPgTeardown = false) => {
         analyze: pgt(analyze_1.default),
         rename: pgt(rename_1.default),
         slice: slice_1.default,
+        'sync-versions': sync_versions_1.default,
         'test-packages': pgt(test_packages_1.default),
         tune: pgt(tune_1.default),
         upgrade: pgt(upgrade_1.default),

package/esm/commands/init/index.js

@@ -5,6 +5,7 @@ import { DEFAULT_TEMPLATE_REPO, DEFAULT_TEMPLATE_TOOL_NAME, inspectTemplate, Pgp
 import { resolveWorkspaceByType } from '@pgpmjs/env';
 import { errors } from '@pgpmjs/types';
 import { registerDefaultResolver } from 'inquirerer';
+import { isNoTtyRequested } from '../../utils';
 import { persistBoilerplateSource, readBoilerplateSource, resolveInitTemplateRepo, } from './boilerplate';
 const DEFAULT_MOTD = `
                  |              _   _
@@ -73,7 +74,7 @@ async function handleInit(argv, prompter) {
         pglite: Boolean(argv.pglite),
     });
     const branch = argv.fromBranch;
-    const noTty = Boolean(argv.noTty || argv['no-tty'] || argv.tty === false || process.env.CI === 'true');
+    const noTty = isNoTtyRequested(argv);
     const useBoilerplatePrompt = Boolean(argv.boilerplate);
     const createWorkspace = Boolean(argv.createWorkspace || argv['create-workspace'] || argv.w);
     const useNpxSkills = Boolean(argv.useSkills || argv['use-skills']);
@@ -430,7 +431,7 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
             workspaceTypeName = workspaceType.toUpperCase();
         }
         if (!resolvedWorkspacePath) {
-            const noTty = Boolean(argv.noTty || argv['no-tty'] || argv.tty === false || process.env.CI === 'true');
+            const noTty = isNoTtyRequested(argv);
             // Handle --create-workspace flag: create workspace first, then module
             if (ctx.createWorkspace && (workspaceType === 'pgpm' || workspaceType === 'pnpm')) {
                 // Resolve workspace template repo with fallback to default

package/esm/commands/init/workspace.js

@@ -2,6 +2,7 @@ import fs from 'fs';
 import path from 'path';
 import { DEFAULT_TEMPLATE_REPO, DEFAULT_TEMPLATE_TOOL_NAME, scaffoldTemplate, sluggify } from '@pgpmjs/core';
 import { registerDefaultResolver } from 'inquirerer';
+import { isNoTtyRequested } from '../../utils';
 const DEFAULT_MOTD = `
                  |              _   _
      ===         |.===.        '\\-//\`
@@ -42,7 +43,7 @@ export default async function runWorkspaceSetup(argv, prompter) {
             workspaceName: answers.name
         },
         toolName: DEFAULT_TEMPLATE_TOOL_NAME,
-        noTty: Boolean(argv.noTty || argv['no-tty'] || argv.tty === false || process.env.CI === 'true'),
+        noTty: isNoTtyRequested(argv),
         cwd,
         prompter
     });

package/esm/commands/sync-versions.js

@@ -0,0 +1,50 @@
+import { PgpmPackage } from '@pgpmjs/core';
+const syncVersionsUsageText = `
+Sync Versions Command:
+
+  pgpm sync-versions [OPTIONS]
+
+  Sync extension metadata (.control default_version, Makefile sql filename,
+  and the sql/<name>--<version>.sql bundle) to each module's package.json
+  version. Inside a module, syncs just that module; at a workspace root,
+  syncs every workspace module.
+
+Options:
+  --help, -h                      Show this help message
+  --check                         Report version skew without writing; exits non-zero if skewed
+  --cwd <directory>               Working directory (default: current directory)
+
+Examples:
+  pgpm sync-versions               Sync all out-of-sync modules
+  pgpm sync-versions --check       Fail if any module's metadata is out of sync (for CI)
+`;
+export default async (argv, _prompter, _options) => {
+    // Show usage if explicitly requested
+    if (argv.help || argv.h) {
+        console.log(syncVersionsUsageText);
+        process.exit(0);
+    }
+    const cwd = argv.cwd ?? process.cwd();
+    const check = Boolean(argv.check);
+    const project = new PgpmPackage(cwd);
+    const result = await project.syncVersions({ check });
+    if (check) {
+        if (result.skewed.length > 0) {
+            console.log(`${result.skewed.length} module(s) out of sync:`);
+            for (const status of result.skewed) {
+                console.log(`  ${status.name}: package.json ${status.packageVersion} != control ${status.controlVersion}` +
+                    (status.sqlFileExists ? '' : ` (missing sql/${status.name}--${status.packageVersion}.sql)`));
+            }
+            process.exit(1);
+        }
+        console.log(`All ${result.ok.length} module(s) in sync.`);
+        return argv;
+    }
+    if (result.synced.length === 0) {
+        console.log(`All ${result.ok.length} module(s) already in sync.`);
+    }
+    else {
+        console.log(`Synced ${result.synced.length} module(s); ${result.ok.length} already in sync.`);
+    }
+    return argv;
+};

package/esm/commands.js

@@ -23,6 +23,7 @@ import remove from './commands/remove';
 import renameCmd from './commands/rename';
 import revert from './commands/revert';
 import slice from './commands/slice';
+import syncVersions from './commands/sync-versions';
 import tag from './commands/tag';
 import testPackages from './commands/test-packages';
 import tune from './commands/tune';
@@ -66,6 +67,7 @@ export const createPgpmCommandMap = (skipPgTeardown = false) => {
         analyze: pgt(analyze),
         rename: pgt(renameCmd),
         slice,
+        'sync-versions': syncVersions,
         'test-packages': pgt(testPackages),
         tune: pgt(tune),
         upgrade: pgt(upgrade),

package/esm/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { CLI, getPackageJson } from 'inquirerer';
 import { commands, createPgpmCommandMap } from './commands';
+import { detectNoTtyFromProcess } from './utils';
 export { createInitUsageText } from './commands/init';
 export { createPgpmCommandMap };
 export { default as add } from './commands/add';
@@ -49,7 +50,7 @@ if (require.main === module) {
         console.log(pkg.version);
         process.exit(0);
     }
-    const app = new CLI(commands, options);
+    const app = new CLI(commands, { ...options, noTty: detectNoTtyFromProcess() });
     app.run().then(() => {
     }).catch(error => {
         console.error('Unexpected error:', error);

package/esm/utils/display.js

@@ -12,6 +12,7 @@ export const usageText = `
     extension          Manage module dependencies
     plan               Generate module deployment plans
     package            Package module for distribution
+    sync-versions      Sync .control/Makefile/sql metadata to package.json versions
     export             Export database migrations from existing databases
     update             Update pgpm to the latest version
     cache              Manage cached templates (clean)

package/esm/utils/index.js

@@ -6,3 +6,4 @@ export * from './driver';
 export * from './module-utils';
 export * from './npm-version';
 export * from './package-alias';
+export * from './tty';

package/esm/utils/tty.js

@@ -0,0 +1,15 @@
+/**
+ * Determine whether the CLI should run in non-interactive (noTty) mode from
+ * parsed argv and the environment. Minimist parses `--no-tty` as `tty: false`.
+ */
+export const isNoTtyRequested = (argv) => Boolean(argv.noTty ||
+    argv['no-tty'] ||
+    argv.tty === false ||
+    process.env.CI === 'true');
+/**
+ * Detect noTty mode from raw process argv, before minimist parsing. Used at
+ * CLI construction time so the shared prompter itself is non-interactive.
+ */
+export const detectNoTtyFromProcess = (argv = process.argv) => argv.includes('--no-tty') ||
+    argv.includes('--noTty') ||
+    process.env.CI === 'true';

package/index.js

@@ -22,6 +22,7 @@ exports.options = exports.verify = exports.testPackages = exports.tag = exports.
 const inquirerer_1 = require("inquirerer");
 const commands_1 = require("./commands");
 Object.defineProperty(exports, "createPgpmCommandMap", { enumerable: true, get: function () { return commands_1.createPgpmCommandMap; } });
+const utils_1 = require("./utils");
 var init_1 = require("./commands/init");
 Object.defineProperty(exports, "createInitUsageText", { enumerable: true, get: function () { return init_1.createInitUsageText; } });
 var add_1 = require("./commands/add");
@@ -92,7 +93,7 @@ if (require.main === module) {
         console.log(pkg.version);
         process.exit(0);
     }
-    const app = new inquirerer_1.CLI(commands_1.commands, exports.options);
+    const app = new inquirerer_1.CLI(commands_1.commands, { ...exports.options, noTty: (0, utils_1.detectNoTtyFromProcess)() });
     app.run().then(() => {
     }).catch(error => {
         console.error('Unexpected error:', error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgpm",
-  "version": "5.7.0",
+  "version": "5.8.1",
   "author": "Constructive <developers@constructive.io>",
   "description": "PostgreSQL Package Manager - Database migration and package management CLI",
   "main": "index.js",
@@ -46,9 +46,9 @@
   },
   "dependencies": {
     "@inquirerer/utils": "^3.3.9",
-    "@pgpmjs/core": "^7.8.0",
+    "@pgpmjs/core": "^7.9.1",
     "@pgpmjs/env": "^2.33.0",
-    "@pgpmjs/export": "^1.8.0",
+    "@pgpmjs/export": "^1.8.2",
     "@pgpmjs/logger": "^2.18.0",
     "@pgpmjs/slice": "^0.5.0",
     "@pgpmjs/types": "^2.40.0",
@@ -77,5 +77,5 @@
     "pg",
     "pgsql"
   ],
-  "gitHead": "73f55ad24d9a92e7ef1e268526b31bfb7bb12b28"
+  "gitHead": "dd16395013ff8c9d5e4cd2f5f5bec72c46f4099b"
 }

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            Upgrade installed pgpm modules to latest versions (alias: up)\n\n  Database Administration:\n    dump               Dump a database to a sql file\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    tune               Tune PostgreSQL for throwaway environments (CI/test)\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 Docker containers (start/stop/ls, --minio)\n    doctor             Check local dependencies (node, docker, psql) with install guidance\n    env                Manage environment variables (--supabase, --minio)\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    sync-versions      Sync .control/Makefile/sql metadata to package.json versions\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    dump               Dump a database to a sql file\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    tune               Tune PostgreSQL for throwaway environments (CI/test)\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 Docker containers (start/stop/ls, --minio)\n    doctor             Check local dependencies (node, docker, psql) with install guidance\n    env                Manage environment variables (--supabase, --minio)\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

@@ -15,6 +15,7 @@ exports.usageText = `
     extension          Manage module dependencies
     plan               Generate module deployment plans
     package            Package module for distribution
+    sync-versions      Sync .control/Makefile/sql metadata to package.json versions
     export             Export database migrations from existing databases
     update             Update pgpm to the latest version
     cache              Manage cached templates (clean)

package/utils/index.d.ts

@@ -6,3 +6,4 @@ export * from './driver';
 export * from './module-utils';
 export * from './npm-version';
 export * from './package-alias';
+export * from './tty';

package/utils/index.js

@@ -22,3 +22,4 @@ __exportStar(require("./driver"), exports);
 __exportStar(require("./module-utils"), exports);
 __exportStar(require("./npm-version"), exports);
 __exportStar(require("./package-alias"), exports);
+__exportStar(require("./tty"), exports);

package/utils/tty.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Determine whether the CLI should run in non-interactive (noTty) mode from
+ * parsed argv and the environment. Minimist parses `--no-tty` as `tty: false`.
+ */
+export declare const isNoTtyRequested: (argv: Partial<Record<string, any>>) => boolean;
+/**
+ * Detect noTty mode from raw process argv, before minimist parsing. Used at
+ * CLI construction time so the shared prompter itself is non-interactive.
+ */
+export declare const detectNoTtyFromProcess: (argv?: string[]) => boolean;

package/utils/tty.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectNoTtyFromProcess = exports.isNoTtyRequested = void 0;
+/**
+ * Determine whether the CLI should run in non-interactive (noTty) mode from
+ * parsed argv and the environment. Minimist parses `--no-tty` as `tty: false`.
+ */
+const isNoTtyRequested = (argv) => Boolean(argv.noTty ||
+    argv['no-tty'] ||
+    argv.tty === false ||
+    process.env.CI === 'true');
+exports.isNoTtyRequested = isNoTtyRequested;
+/**
+ * Detect noTty mode from raw process argv, before minimist parsing. Used at
+ * CLI construction time so the shared prompter itself is non-interactive.
+ */
+const detectNoTtyFromProcess = (argv = process.argv) => argv.includes('--no-tty') ||
+    argv.includes('--noTty') ||
+    process.env.CI === 'true';
+exports.detectNoTtyFromProcess = detectNoTtyFromProcess;