pgpm 5.32.0 → 5.34.0

package/commands/init/boilerplate.d.ts

@@ -7,6 +7,7 @@ export interface BoilerplateSource {
     branch?: string;
     dir?: string;
 }
+export declare function isScaffoldableInPlace(dir: string): boolean;
 /**
  * Resolve the template repo for an `init` invocation from its flags.
  *

package/commands/init/boilerplate.js

@@ -3,12 +3,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isScaffoldableInPlace = isScaffoldableInPlace;
 exports.resolveInitTemplateRepo = resolveInitTemplateRepo;
 exports.persistBoilerplateSource = persistBoilerplateSource;
 exports.readBoilerplateSource = readBoilerplateSource;
 const core_1 = require("@pgpmjs/core");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+function isScaffoldableInPlace(dir) {
+    try {
+        return fs_1.default.statSync(dir).isDirectory() &&
+            fs_1.default.readdirSync(dir).filter((entry) => entry !== '.git').length === 0;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Resolve the template repo for an `init` invocation from its flags.
  *

package/commands/init/index.js

@@ -36,6 +36,7 @@ Options:
                           Sugar for --repo https://github.com/constructive-io/pglite-boilerplates.git.
                           Recorded on the workspace so later \`init\` calls inherit it automatically.
   --from-branch <branch>  Branch/tag to use when cloning repo
+  --refresh, --no-cache    Re-fetch the template repo instead of using the cached copy
   --dir <variant>         Template variant directory (e.g., supabase, drizzle)
   --template, -t <path>   Full template path (e.g., pnpm/module) - combines dir and fromPath
   --boilerplate           Prompt to select from available boilerplates
@@ -45,6 +46,8 @@ Options:
                           Add them later instead with \`${binaryName} extension\`.
   --with-extensions       Prompt interactively for extensions during module init
 
+Non-interactive runs must answer every question with flags; use --no-tty.
+
 Examples:
   ${binaryName} init                                   Initialize new module (default, no extensions)
   ${binaryName} init workspace                         Initialize new workspace
@@ -80,6 +83,10 @@ async function handleInit(argv, prompter) {
         pglite: Boolean(argv.pglite),
     });
     const branch = argv.fromBranch;
+    const forceRefresh = Boolean(argv.refresh ||
+        argv['no-cache'] ||
+        argv.noCache ||
+        argv.cache === false);
     const noTty = (0, utils_1.isNoTtyRequested)(argv);
     const useBoilerplatePrompt = Boolean(argv.boilerplate);
     const createWorkspace = Boolean(argv.createWorkspace || argv['create-workspace'] || argv.w);
@@ -105,6 +112,13 @@ async function handleInit(argv, prompter) {
     }
     // Handle --boilerplate flag: separate path from regular init
     if (useBoilerplatePrompt) {
+        const source = (0, core_1.refreshTemplateCache)({
+            templateRepo,
+            branch,
+            toolName: core_1.DEFAULT_TEMPLATE_TOOL_NAME,
+            cwd,
+            force: forceRefresh,
+        });
         return handleBoilerplateInit(argv, prompter, {
             positionalFromPath,
             templateRepo,
@@ -113,12 +127,21 @@ async function handleInit(argv, prompter) {
             noTty,
             cwd,
             useNpxSkills,
+            forceRefresh,
+            source,
         });
     }
     // Regular init path: --template takes precedence, then positional arg, then default to 'module'
     const fromPath = templateFromPath || positionalFromPath || 'module';
     // Track if user explicitly requested module (e.g., `pgpm init module` or `--template pnpm/module`)
     const wasExplicitModuleRequest = positionalFromPath === 'module' || templateFromPath === 'module';
+    const source = (0, core_1.refreshTemplateCache)({
+        templateRepo,
+        branch,
+        toolName: core_1.DEFAULT_TEMPLATE_TOOL_NAME,
+        cwd,
+        force: forceRefresh,
+    });
     // Inspect the template to get its type
     const inspection = (0, core_1.inspectTemplate)({
         fromPath,
@@ -140,6 +163,8 @@ async function handleInit(argv, prompter) {
             cwd,
             useNpxSkills,
             repoWasExplicit,
+            source,
+            forceRefresh,
         });
     }
     // Default to module init (for 'module' type, 'generic' type, or unknown types)
@@ -154,6 +179,8 @@ async function handleInit(argv, prompter) {
         createWorkspace,
         useNpxSkills,
         repoWasExplicit,
+        source,
+        forceRefresh,
     }, wasExplicitModuleRequest);
 }
 async function handleBoilerplateInit(argv, prompter, ctx) {
@@ -220,6 +247,7 @@ async function handleBoilerplateInit(argv, prompter, ctx) {
             noTty: ctx.noTty,
             cwd: ctx.cwd,
             useNpxSkills: ctx.useNpxSkills,
+            source: ctx.source,
         });
     }
     // Default to module init (for 'module' type, 'generic' type, or unknown types)
@@ -233,6 +261,8 @@ async function handleBoilerplateInit(argv, prompter, ctx) {
         cwd: ctx.cwd,
         requiresWorkspace: inspection.config?.requiresWorkspace,
         useNpxSkills: ctx.useNpxSkills,
+        forceRefresh: ctx.forceRefresh,
+        source: ctx.source,
     }, true);
 }
 function installSkills(skills, cwd, useNpxSkills) {
@@ -303,7 +333,20 @@ async function handleWorkspaceInit(argv, prompter, ctx) {
         }
     ];
     const answers = await prompter.prompt(argv, workspaceQuestions);
-    const targetPath = path_1.default.join(ctx.cwd, (0, core_1.sluggify)(answers.name));
+    let targetPath = path_1.default.join(ctx.cwd, (0, core_1.sluggify)(answers.name));
+    const slug = (0, core_1.sluggify)(answers.name);
+    const inPlace = path_1.default.basename(ctx.cwd) === slug && (0, boilerplate_1.isScaffoldableInPlace)(ctx.cwd);
+    if (inPlace) {
+        targetPath = ctx.cwd;
+        process.stdout.write(`Scaffolding into current directory ./ (it is empty and named "${answers.name}")\n`);
+    }
+    const source = ctx.source ?? (0, core_1.refreshTemplateCache)({
+        templateRepo: ctx.templateRepo,
+        branch: ctx.branch,
+        toolName: core_1.DEFAULT_TEMPLATE_TOOL_NAME,
+        cwd: ctx.cwd,
+    });
+    process.stdout.write(`${(0, core_1.describeTemplateSource)(source)}\n`);
     // Register workspace.dirname resolver so boilerplate templates can use it via defaultFrom/setFrom
     const dirName = path_1.default.basename(targetPath);
     (0, inquirerer_1.registerDefaultResolver)('workspace.dirname', () => dirName);
@@ -362,7 +405,9 @@ async function handleWorkspaceInit(argv, prompter, ctx) {
         installSkills(templateInfo.config.skills, targetPath, Boolean(ctx.useNpxSkills));
     }
     const relPath = path_1.default.relative(process.cwd(), targetPath);
-    process.stdout.write(`\n✨ Enjoy!\n\ncd ./${relPath}\n`);
+    process.stdout.write('\n✨ Enjoy!\n');
+    if (relPath)
+        process.stdout.write(`\ncd ./${relPath}\n`);
     return { ...argv, ...answers, cwd: targetPath };
 }
 function resolveWorkspaceTemplateRepo(options) {
@@ -415,8 +460,22 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
             ctx.templateRepo = inherited.repo;
             ctx.branch = inherited.branch;
             ctx.dir = inherited.dir;
+            ctx.source = (0, core_1.refreshTemplateCache)({
+                templateRepo: ctx.templateRepo,
+                branch: ctx.branch,
+                toolName: core_1.DEFAULT_TEMPLATE_TOOL_NAME,
+                cwd: ctx.cwd,
+                force: ctx.forceRefresh,
+            });
         }
     }
+    const source = ctx.source ?? (0, core_1.refreshTemplateCache)({
+        templateRepo: ctx.templateRepo,
+        branch: ctx.branch,
+        toolName: core_1.DEFAULT_TEMPLATE_TOOL_NAME,
+        cwd: ctx.cwd,
+        force: ctx.forceRefresh,
+    });
     // Determine workspace requirement (defaults to 'pgpm' for backward compatibility)
     const workspaceType = ctx.requiresWorkspace ?? 'pgpm';
     // Whether this is a pgpm-managed template (creates pgpm.plan, .control files)
@@ -456,6 +515,13 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
                     noTty: ctx.noTty,
                     cwd: ctx.cwd,
                     repoWasExplicit: ctx.repoWasExplicit,
+                    source: (0, core_1.refreshTemplateCache)({
+                        templateRepo: workspaceTemplateConfig.repo,
+                        branch: workspaceTemplateConfig.branch,
+                        toolName: core_1.DEFAULT_TEMPLATE_TOOL_NAME,
+                        cwd: ctx.cwd,
+                        force: ctx.forceRefresh,
+                    }),
                 });
                 // Update context to point to new workspace and continue with module creation
                 const newCwd = workspaceResult.cwd;
@@ -500,6 +566,13 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
                             noTty: ctx.noTty,
                             cwd: ctx.cwd,
                             repoWasExplicit: ctx.repoWasExplicit,
+                            source: (0, core_1.refreshTemplateCache)({
+                                templateRepo: ctx.templateRepo,
+                                branch: ctx.branch,
+                                toolName: core_1.DEFAULT_TEMPLATE_TOOL_NAME,
+                                cwd: ctx.cwd,
+                                force: ctx.forceRefresh,
+                            }),
                         });
                     }
                 }
@@ -568,6 +641,7 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
     };
     // Determine output path based on whether we're in a workspace
     let modulePath;
+    process.stdout.write(`${(0, core_1.describeTemplateSource)(source)}\n`);
     if (project.workspacePath) {
         // PGPM workspace - use workspace-aware initModule
         await project.initModule({
@@ -656,6 +730,8 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
         installSkills(moduleTemplateInfo.config.skills, skillsCwd, Boolean(ctx.useNpxSkills));
     }
     const relPath = path_1.default.relative(process.cwd(), modulePath);
-    process.stdout.write(`\n✨ Enjoy!\n\ncd ./${relPath}\n`);
+    process.stdout.write('\n✨ Enjoy!\n');
+    if (relPath)
+        process.stdout.write(`\ncd ./${relPath}\n`);
     return { ...argv, ...answers };
 }

package/commands/ls.d.ts

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

package/commands/ls.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@pgpmjs/core");
+const inquirerer_1 = require("inquirerer");
+const path_1 = __importDefault(require("path"));
+const lsUsageText = `
+List Command:
+
+  pgpm ls [OPTIONS]
+
+  List the pgpm modules in the current workspace.
+
+Options:
+  --help, -h       Show this help message
+  --json           Print JSON output
+  --names          Print module names only
+  --paths          Print workspace-relative module paths only
+  --cwd <dir>      Working directory (default: current directory)
+
+Examples:
+  pgpm ls
+  pgpm ls --names
+  pgpm ls --paths --json
+`;
+exports.default = async (argv, _prompter, _options) => {
+    if (argv.help || argv.h) {
+        console.log(lsUsageText);
+        process.exit(0);
+    }
+    const names = Boolean(argv.names);
+    const paths = Boolean(argv.paths);
+    const json = Boolean(argv.json);
+    if (names && paths) {
+        await (0, inquirerer_1.cliExitWithError)('--names and --paths cannot be used together.');
+    }
+    const cwd = path_1.default.resolve(argv.cwd || process.cwd());
+    const workspace = new core_1.PgpmPackage(cwd);
+    const workspacePath = workspace.getWorkspacePath();
+    if (!workspacePath) {
+        await (0, inquirerer_1.cliExitWithError)(`Not inside a pgpm workspace: ${cwd}. Pass --cwd <workspace-directory>.`);
+    }
+    const entries = Object.entries(workspace.getModuleMap())
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([name, module]) => ({
+        name,
+        version: module.version || 'unknown',
+        path: module.path,
+        requires: [...module.requires]
+    }));
+    if (json) {
+        if (names) {
+            process.stdout.write(JSON.stringify(entries.map(entry => entry.name)));
+            return;
+        }
+        if (paths) {
+            process.stdout.write(JSON.stringify(entries.map(entry => entry.path)));
+            return;
+        }
+        process.stdout.write(`${JSON.stringify(entries, null, 2)}\n`);
+        return;
+    }
+    if (names) {
+        process.stdout.write(entries.map(entry => entry.name).join('\n'));
+        if (entries.length > 0)
+            process.stdout.write('\n');
+        return;
+    }
+    if (paths) {
+        process.stdout.write(entries.map(entry => entry.path).join('\n'));
+        if (entries.length > 0)
+            process.stdout.write('\n');
+        return;
+    }
+    if (entries.length === 0) {
+        process.stdout.write('No modules found.\n');
+        return;
+    }
+    const nameWidth = Math.max(...entries.map(entry => entry.name.length));
+    const versionWidth = Math.max(...entries.map(entry => entry.version.length));
+    process.stdout.write(entries
+        .map(entry => `${entry.name.padEnd(nameWidth)}  ${entry.version.padEnd(versionWidth)}  ${entry.path}`)
+        .join('\n') + '\n');
+};

package/commands.js

@@ -24,6 +24,7 @@ const import_1 = __importDefault(require("./commands/import"));
 const init_1 = __importDefault(require("./commands/init"));
 const install_1 = __importDefault(require("./commands/install"));
 const kill_1 = __importDefault(require("./commands/kill"));
+const ls_1 = __importDefault(require("./commands/ls"));
 const materialize_1 = __importDefault(require("./commands/materialize"));
 const migrate_1 = __importDefault(require("./commands/migrate"));
 const package_1 = __importDefault(require("./commands/package"));
@@ -59,6 +60,8 @@ const ENGINE_EXEMPT_COMMANDS = new Set([
     'import',
     'init',
     'install',
+    'ls',
+    'list',
     'package',
     'materialize',
     'plan',
@@ -107,6 +110,8 @@ const createPgpmCommandMap = (skipPgTeardown = false) => {
         tag: pgt(tag_1.default),
         kill: pgt(kill_1.default),
         install: pgt(install_1.default),
+        ls: ls_1.default,
+        list: ls_1.default,
         migrate: pgt(migrate_1.default),
         materialize: materialize_1.default,
         analyze: pgt(analyze_1.default),

package/esm/commands/init/boilerplate.js

@@ -1,6 +1,15 @@
 import { DEFAULT_TEMPLATE_REPO, PgpmPackage, TEMPLATE_REPOS } from '@pgpmjs/core';
 import fs from 'fs';
 import path from 'path';
+export function isScaffoldableInPlace(dir) {
+    try {
+        return fs.statSync(dir).isDirectory() &&
+            fs.readdirSync(dir).filter((entry) => entry !== '.git').length === 0;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Resolve the template repo for an `init` invocation from its flags.
  *

package/esm/commands/init/index.js

@@ -1,11 +1,11 @@
-import { DEFAULT_TEMPLATE_REPO, DEFAULT_TEMPLATE_TOOL_NAME, inspectTemplate, PgpmPackage, resolveBoilerplateBaseDir, scaffoldTemplate, scanBoilerplates, SkillInstaller, sluggify, spawnSyncChecked, } from '@pgpmjs/core';
+import { DEFAULT_TEMPLATE_REPO, DEFAULT_TEMPLATE_TOOL_NAME, describeTemplateSource, inspectTemplate, PgpmPackage, refreshTemplateCache, resolveBoilerplateBaseDir, scaffoldTemplate, scanBoilerplates, SkillInstaller, sluggify, spawnSyncChecked, } from '@pgpmjs/core';
 import { resolveWorkspaceByType } from '@pgpmjs/env';
 import { errors } from '@pgpmjs/types';
 import fs from 'fs';
 import { registerDefaultResolver } from 'inquirerer';
 import path from 'path';
 import { isNoTtyRequested } from '../../utils';
-import { persistBoilerplateSource, readBoilerplateSource, resolveInitTemplateRepo, } from './boilerplate';
+import { isScaffoldableInPlace, persistBoilerplateSource, readBoilerplateSource, resolveInitTemplateRepo, } from './boilerplate';
 const DEFAULT_MOTD = `
                  |              _   _
      ===         |.===.        '\\-//\`
@@ -30,6 +30,7 @@ Options:
                           Sugar for --repo https://github.com/constructive-io/pglite-boilerplates.git.
                           Recorded on the workspace so later \`init\` calls inherit it automatically.
   --from-branch <branch>  Branch/tag to use when cloning repo
+  --refresh, --no-cache    Re-fetch the template repo instead of using the cached copy
   --dir <variant>         Template variant directory (e.g., supabase, drizzle)
   --template, -t <path>   Full template path (e.g., pnpm/module) - combines dir and fromPath
   --boilerplate           Prompt to select from available boilerplates
@@ -39,6 +40,8 @@ Options:
                           Add them later instead with \`${binaryName} extension\`.
   --with-extensions       Prompt interactively for extensions during module init
 
+Non-interactive runs must answer every question with flags; use --no-tty.
+
 Examples:
   ${binaryName} init                                   Initialize new module (default, no extensions)
   ${binaryName} init workspace                         Initialize new workspace
@@ -73,6 +76,10 @@ async function handleInit(argv, prompter) {
         pglite: Boolean(argv.pglite),
     });
     const branch = argv.fromBranch;
+    const forceRefresh = Boolean(argv.refresh ||
+        argv['no-cache'] ||
+        argv.noCache ||
+        argv.cache === false);
     const noTty = isNoTtyRequested(argv);
     const useBoilerplatePrompt = Boolean(argv.boilerplate);
     const createWorkspace = Boolean(argv.createWorkspace || argv['create-workspace'] || argv.w);
@@ -98,6 +105,13 @@ async function handleInit(argv, prompter) {
     }
     // Handle --boilerplate flag: separate path from regular init
     if (useBoilerplatePrompt) {
+        const source = refreshTemplateCache({
+            templateRepo,
+            branch,
+            toolName: DEFAULT_TEMPLATE_TOOL_NAME,
+            cwd,
+            force: forceRefresh,
+        });
         return handleBoilerplateInit(argv, prompter, {
             positionalFromPath,
             templateRepo,
@@ -106,12 +120,21 @@ async function handleInit(argv, prompter) {
             noTty,
             cwd,
             useNpxSkills,
+            forceRefresh,
+            source,
         });
     }
     // Regular init path: --template takes precedence, then positional arg, then default to 'module'
     const fromPath = templateFromPath || positionalFromPath || 'module';
     // Track if user explicitly requested module (e.g., `pgpm init module` or `--template pnpm/module`)
     const wasExplicitModuleRequest = positionalFromPath === 'module' || templateFromPath === 'module';
+    const source = refreshTemplateCache({
+        templateRepo,
+        branch,
+        toolName: DEFAULT_TEMPLATE_TOOL_NAME,
+        cwd,
+        force: forceRefresh,
+    });
     // Inspect the template to get its type
     const inspection = inspectTemplate({
         fromPath,
@@ -133,6 +156,8 @@ async function handleInit(argv, prompter) {
             cwd,
             useNpxSkills,
             repoWasExplicit,
+            source,
+            forceRefresh,
         });
     }
     // Default to module init (for 'module' type, 'generic' type, or unknown types)
@@ -147,6 +172,8 @@ async function handleInit(argv, prompter) {
         createWorkspace,
         useNpxSkills,
         repoWasExplicit,
+        source,
+        forceRefresh,
     }, wasExplicitModuleRequest);
 }
 async function handleBoilerplateInit(argv, prompter, ctx) {
@@ -213,6 +240,7 @@ async function handleBoilerplateInit(argv, prompter, ctx) {
             noTty: ctx.noTty,
             cwd: ctx.cwd,
             useNpxSkills: ctx.useNpxSkills,
+            source: ctx.source,
         });
     }
     // Default to module init (for 'module' type, 'generic' type, or unknown types)
@@ -226,6 +254,8 @@ async function handleBoilerplateInit(argv, prompter, ctx) {
         cwd: ctx.cwd,
         requiresWorkspace: inspection.config?.requiresWorkspace,
         useNpxSkills: ctx.useNpxSkills,
+        forceRefresh: ctx.forceRefresh,
+        source: ctx.source,
     }, true);
 }
 function installSkills(skills, cwd, useNpxSkills) {
@@ -296,7 +326,20 @@ async function handleWorkspaceInit(argv, prompter, ctx) {
         }
     ];
     const answers = await prompter.prompt(argv, workspaceQuestions);
-    const targetPath = path.join(ctx.cwd, sluggify(answers.name));
+    let targetPath = path.join(ctx.cwd, sluggify(answers.name));
+    const slug = sluggify(answers.name);
+    const inPlace = path.basename(ctx.cwd) === slug && isScaffoldableInPlace(ctx.cwd);
+    if (inPlace) {
+        targetPath = ctx.cwd;
+        process.stdout.write(`Scaffolding into current directory ./ (it is empty and named "${answers.name}")\n`);
+    }
+    const source = ctx.source ?? refreshTemplateCache({
+        templateRepo: ctx.templateRepo,
+        branch: ctx.branch,
+        toolName: DEFAULT_TEMPLATE_TOOL_NAME,
+        cwd: ctx.cwd,
+    });
+    process.stdout.write(`${describeTemplateSource(source)}\n`);
     // Register workspace.dirname resolver so boilerplate templates can use it via defaultFrom/setFrom
     const dirName = path.basename(targetPath);
     registerDefaultResolver('workspace.dirname', () => dirName);
@@ -355,7 +398,9 @@ async function handleWorkspaceInit(argv, prompter, ctx) {
         installSkills(templateInfo.config.skills, targetPath, Boolean(ctx.useNpxSkills));
     }
     const relPath = path.relative(process.cwd(), targetPath);
-    process.stdout.write(`\n✨ Enjoy!\n\ncd ./${relPath}\n`);
+    process.stdout.write('\n✨ Enjoy!\n');
+    if (relPath)
+        process.stdout.write(`\ncd ./${relPath}\n`);
     return { ...argv, ...answers, cwd: targetPath };
 }
 function resolveWorkspaceTemplateRepo(options) {
@@ -408,8 +453,22 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
             ctx.templateRepo = inherited.repo;
             ctx.branch = inherited.branch;
             ctx.dir = inherited.dir;
+            ctx.source = refreshTemplateCache({
+                templateRepo: ctx.templateRepo,
+                branch: ctx.branch,
+                toolName: DEFAULT_TEMPLATE_TOOL_NAME,
+                cwd: ctx.cwd,
+                force: ctx.forceRefresh,
+            });
         }
     }
+    const source = ctx.source ?? refreshTemplateCache({
+        templateRepo: ctx.templateRepo,
+        branch: ctx.branch,
+        toolName: DEFAULT_TEMPLATE_TOOL_NAME,
+        cwd: ctx.cwd,
+        force: ctx.forceRefresh,
+    });
     // Determine workspace requirement (defaults to 'pgpm' for backward compatibility)
     const workspaceType = ctx.requiresWorkspace ?? 'pgpm';
     // Whether this is a pgpm-managed template (creates pgpm.plan, .control files)
@@ -449,6 +508,13 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
                     noTty: ctx.noTty,
                     cwd: ctx.cwd,
                     repoWasExplicit: ctx.repoWasExplicit,
+                    source: refreshTemplateCache({
+                        templateRepo: workspaceTemplateConfig.repo,
+                        branch: workspaceTemplateConfig.branch,
+                        toolName: DEFAULT_TEMPLATE_TOOL_NAME,
+                        cwd: ctx.cwd,
+                        force: ctx.forceRefresh,
+                    }),
                 });
                 // Update context to point to new workspace and continue with module creation
                 const newCwd = workspaceResult.cwd;
@@ -493,6 +559,13 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
                             noTty: ctx.noTty,
                             cwd: ctx.cwd,
                             repoWasExplicit: ctx.repoWasExplicit,
+                            source: refreshTemplateCache({
+                                templateRepo: ctx.templateRepo,
+                                branch: ctx.branch,
+                                toolName: DEFAULT_TEMPLATE_TOOL_NAME,
+                                cwd: ctx.cwd,
+                                force: ctx.forceRefresh,
+                            }),
                         });
                     }
                 }
@@ -561,6 +634,7 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
     };
     // Determine output path based on whether we're in a workspace
     let modulePath;
+    process.stdout.write(`${describeTemplateSource(source)}\n`);
     if (project.workspacePath) {
         // PGPM workspace - use workspace-aware initModule
         await project.initModule({
@@ -649,6 +723,8 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
         installSkills(moduleTemplateInfo.config.skills, skillsCwd, Boolean(ctx.useNpxSkills));
     }
     const relPath = path.relative(process.cwd(), modulePath);
-    process.stdout.write(`\n✨ Enjoy!\n\ncd ./${relPath}\n`);
+    process.stdout.write('\n✨ Enjoy!\n');
+    if (relPath)
+        process.stdout.write(`\ncd ./${relPath}\n`);
     return { ...argv, ...answers };
 }

package/esm/commands/ls.js

@@ -0,0 +1,81 @@
+import { PgpmPackage } from '@pgpmjs/core';
+import { cliExitWithError } from 'inquirerer';
+import path from 'path';
+const lsUsageText = `
+List Command:
+
+  pgpm ls [OPTIONS]
+
+  List the pgpm modules in the current workspace.
+
+Options:
+  --help, -h       Show this help message
+  --json           Print JSON output
+  --names          Print module names only
+  --paths          Print workspace-relative module paths only
+  --cwd <dir>      Working directory (default: current directory)
+
+Examples:
+  pgpm ls
+  pgpm ls --names
+  pgpm ls --paths --json
+`;
+export default async (argv, _prompter, _options) => {
+    if (argv.help || argv.h) {
+        console.log(lsUsageText);
+        process.exit(0);
+    }
+    const names = Boolean(argv.names);
+    const paths = Boolean(argv.paths);
+    const json = Boolean(argv.json);
+    if (names && paths) {
+        await cliExitWithError('--names and --paths cannot be used together.');
+    }
+    const cwd = path.resolve(argv.cwd || process.cwd());
+    const workspace = new PgpmPackage(cwd);
+    const workspacePath = workspace.getWorkspacePath();
+    if (!workspacePath) {
+        await cliExitWithError(`Not inside a pgpm workspace: ${cwd}. Pass --cwd <workspace-directory>.`);
+    }
+    const entries = Object.entries(workspace.getModuleMap())
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([name, module]) => ({
+        name,
+        version: module.version || 'unknown',
+        path: module.path,
+        requires: [...module.requires]
+    }));
+    if (json) {
+        if (names) {
+            process.stdout.write(JSON.stringify(entries.map(entry => entry.name)));
+            return;
+        }
+        if (paths) {
+            process.stdout.write(JSON.stringify(entries.map(entry => entry.path)));
+            return;
+        }
+        process.stdout.write(`${JSON.stringify(entries, null, 2)}\n`);
+        return;
+    }
+    if (names) {
+        process.stdout.write(entries.map(entry => entry.name).join('\n'));
+        if (entries.length > 0)
+            process.stdout.write('\n');
+        return;
+    }
+    if (paths) {
+        process.stdout.write(entries.map(entry => entry.path).join('\n'));
+        if (entries.length > 0)
+            process.stdout.write('\n');
+        return;
+    }
+    if (entries.length === 0) {
+        process.stdout.write('No modules found.\n');
+        return;
+    }
+    const nameWidth = Math.max(...entries.map(entry => entry.name.length));
+    const versionWidth = Math.max(...entries.map(entry => entry.version.length));
+    process.stdout.write(entries
+        .map(entry => `${entry.name.padEnd(nameWidth)}  ${entry.version.padEnd(versionWidth)}  ${entry.path}`)
+        .join('\n') + '\n');
+};

package/esm/commands.js

@@ -18,6 +18,7 @@ import _import from './commands/import';
 import init from './commands/init';
 import install from './commands/install';
 import kill from './commands/kill';
+import ls from './commands/ls';
 import materialize from './commands/materialize';
 import migrate from './commands/migrate';
 import _package from './commands/package';
@@ -53,6 +54,8 @@ const ENGINE_EXEMPT_COMMANDS = new Set([
     'import',
     'init',
     'install',
+    'ls',
+    'list',
     'package',
     'materialize',
     'plan',
@@ -101,6 +104,8 @@ export const createPgpmCommandMap = (skipPgTeardown = false) => {
         tag: pgt(tag),
         kill: pgt(kill),
         install: pgt(install),
+        ls,
+        list: ls,
         migrate: pgt(migrate),
         materialize,
         analyze: pgt(analyze),

package/esm/index.js

@@ -16,6 +16,7 @@ export { default as _export } from './commands/export';
 export { default as extension } from './commands/extension';
 export { default as install } from './commands/install';
 export { default as kill } from './commands/kill';
+export { default as ls } from './commands/ls';
 export { default as migrate } from './commands/migrate';
 export { default as _package } from './commands/package';
 export { default as plan } from './commands/plan';

package/esm/utils/display.js

@@ -9,6 +9,7 @@ export const usageText = `
 
   Project Management:
     init               Initialize workspace or module
+    ls                 List the modules in the current workspace (alias: list)
     extension          Manage module dependencies
     plan               Generate module deployment plans
     regen              Generate revert/verify scripts from deploy scripts

package/esm/utils/tty.js

@@ -5,11 +5,13 @@
 export const isNoTtyRequested = (argv) => Boolean(argv.noTty ||
     argv['no-tty'] ||
     argv.tty === false ||
-    process.env.CI === 'true');
+    process.env.CI === 'true' ||
+    process.stdin.isTTY !== 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';
+    process.env.CI === 'true' ||
+    process.stdin.isTTY !== true;

package/index.d.ts

@@ -15,6 +15,7 @@ export { default as _export } from './commands/export';
 export { default as extension } from './commands/extension';
 export { default as install } from './commands/install';
 export { default as kill } from './commands/kill';
+export { default as ls } from './commands/ls';
 export { default as migrate } from './commands/migrate';
 export { default as _package } from './commands/package';
 export { default as plan } from './commands/plan';

package/index.js

@@ -18,7 +18,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.options = exports.verify = exports.testPackages = exports.tag = exports.slice = exports.revert = exports.renameCmd = exports.remove = exports.plan = exports._package = exports.migrate = exports.kill = exports.install = exports.extension = exports._export = exports.env = exports.dump = exports.docker = exports.deploy = exports.clear = exports.analyze = exports.adminUsers = exports.add = exports.createPgpmCommandMap = exports.createInitUsageText = void 0;
+exports.options = exports.verify = exports.testPackages = exports.tag = exports.slice = exports.revert = exports.renameCmd = exports.remove = exports.plan = exports._package = exports.migrate = exports.ls = exports.kill = exports.install = exports.extension = exports._export = exports.env = exports.dump = exports.docker = exports.deploy = exports.clear = exports.analyze = exports.adminUsers = exports.add = exports.createPgpmCommandMap = exports.createInitUsageText = void 0;
 const inquirerer_1 = require("inquirerer");
 const commands_1 = require("./commands");
 Object.defineProperty(exports, "createPgpmCommandMap", { enumerable: true, get: function () { return commands_1.createPgpmCommandMap; } });
@@ -49,6 +49,8 @@ var install_1 = require("./commands/install");
 Object.defineProperty(exports, "install", { enumerable: true, get: function () { return __importDefault(install_1).default; } });
 var kill_1 = require("./commands/kill");
 Object.defineProperty(exports, "kill", { enumerable: true, get: function () { return __importDefault(kill_1).default; } });
+var ls_1 = require("./commands/ls");
+Object.defineProperty(exports, "ls", { enumerable: true, get: function () { return __importDefault(ls_1).default; } });
 var migrate_1 = require("./commands/migrate");
 Object.defineProperty(exports, "migrate", { enumerable: true, get: function () { return __importDefault(migrate_1).default; } });
 var package_1 = require("./commands/package");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgpm",
-  "version": "5.32.0",
+  "version": "5.34.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "PostgreSQL Package Manager - Database migration and package management CLI",
   "main": "index.js",
@@ -47,14 +47,14 @@
   },
   "dependencies": {
     "@inquirerer/utils": "^3.3.13",
-    "@pgpmjs/core": "^7.29.0",
-    "@pgpmjs/diff": "^0.7.0",
+    "@pgpmjs/core": "^7.31.0",
+    "@pgpmjs/diff": "^0.8.0",
     "@pgpmjs/env": "^2.45.0",
-    "@pgpmjs/export": "^1.22.0",
-    "@pgpmjs/import": "^0.7.0",
+    "@pgpmjs/export": "^1.23.0",
+    "@pgpmjs/import": "^0.8.0",
     "@pgpmjs/logger": "^2.26.0",
-    "@pgpmjs/slice": "^0.18.0",
-    "@pgpmjs/transform": "^0.27.0",
+    "@pgpmjs/slice": "^0.19.0",
+    "@pgpmjs/transform": "^0.28.0",
     "@pgpmjs/types": "^2.55.0",
     "@pgsql/quotes": "^18.2.4",
     "appstash": "^0.8.0",
@@ -65,7 +65,7 @@
     "js-yaml": "^4.1.0",
     "pg-cache": "^3.29.0",
     "pg-env": "^1.32.0",
-    "pgsql-deparser": "^18.3.6",
+    "pgsql-deparser": "^18.3.7",
     "semver": "^7.8.5",
     "shelljs": "^0.10.0",
     "yanse": "^0.2.2"
@@ -82,5 +82,5 @@
     "pg",
     "pgsql"
   ],
-  "gitHead": "baa84094b8541eb5000701b0060aa5b298032dc7"
+  "gitHead": "75b888926505b473eeef7a76fea1554e5a1cf4cc"
 }

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    regen              Generate revert/verify scripts from deploy scripts\n    transform          Re-dial a module through the dials pipeline (granularity/naming/partition)\n    import             pgpm-itize an arbitrary SQL dump into a deployable module\n    diff               Identity-keyed semantic diff between two schema sources (+ migration generation)\n    package            Package module for distribution\n    materialize        Transpile an apply proxy into a plain, committed module\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, --rustfs)\n    doctor             Check local dependencies (node, docker, psql) with install guidance\n    env                Manage environment variables (--supabase, --rustfs)\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    --engine <name>    Migration backend: pg (default, Postgres server) or\n                       pglite (in-process WASM Postgres, no server). Also set by\n                       the \"engine\" key of pgpm.json or PGPM_ENGINE.\n    --driver <pkg>     Driver plugin package backing the engine (escape hatch)\n    --pglite[=dataDir] Sugar for --engine pglite, persisted to <dataDir> if given\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    ls                 List the modules in the current workspace (alias: list)\n    extension          Manage module dependencies\n    plan               Generate module deployment plans\n    regen              Generate revert/verify scripts from deploy scripts\n    transform          Re-dial a module through the dials pipeline (granularity/naming/partition)\n    import             pgpm-itize an arbitrary SQL dump into a deployable module\n    diff               Identity-keyed semantic diff between two schema sources (+ migration generation)\n    package            Package module for distribution\n    materialize        Transpile an apply proxy into a plain, committed module\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, --rustfs)\n    doctor             Check local dependencies (node, docker, psql) with install guidance\n    env                Manage environment variables (--supabase, --rustfs)\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    --engine <name>    Migration backend: pg (default, Postgres server) or\n                       pglite (in-process WASM Postgres, no server). Also set by\n                       the \"engine\" key of pgpm.json or PGPM_ENGINE.\n    --driver <pkg>     Driver plugin package backing the engine (escape hatch)\n    --pglite[=dataDir] Sugar for --engine pglite, persisted to <dataDir> if given\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

@@ -12,6 +12,7 @@ exports.usageText = `
 
   Project Management:
     init               Initialize workspace or module
+    ls                 List the modules in the current workspace (alias: list)
     extension          Manage module dependencies
     plan               Generate module deployment plans
     regen              Generate revert/verify scripts from deploy scripts

package/utils/tty.js

@@ -8,7 +8,8 @@ exports.detectNoTtyFromProcess = exports.isNoTtyRequested = void 0;
 const isNoTtyRequested = (argv) => Boolean(argv.noTty ||
     argv['no-tty'] ||
     argv.tty === false ||
-    process.env.CI === 'true');
+    process.env.CI === 'true' ||
+    process.stdin.isTTY !== true);
 exports.isNoTtyRequested = isNoTtyRequested;
 /**
  * Detect noTty mode from raw process argv, before minimist parsing. Used at
@@ -16,5 +17,6 @@ exports.isNoTtyRequested = isNoTtyRequested;
  */
 const detectNoTtyFromProcess = (argv = process.argv) => argv.includes('--no-tty') ||
     argv.includes('--noTty') ||
-    process.env.CI === 'true';
+    process.env.CI === 'true' ||
+    process.stdin.isTTY !== true;
 exports.detectNoTtyFromProcess = detectNoTtyFromProcess;