pgpm 5.32.0 → 5.33.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/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.33.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "PostgreSQL Package Manager - Database migration and package management CLI",
   "main": "index.js",
@@ -47,10 +47,10 @@
   },
   "dependencies": {
     "@inquirerer/utils": "^3.3.13",
-    "@pgpmjs/core": "^7.29.0",
+    "@pgpmjs/core": "^7.30.0",
     "@pgpmjs/diff": "^0.7.0",
     "@pgpmjs/env": "^2.45.0",
-    "@pgpmjs/export": "^1.22.0",
+    "@pgpmjs/export": "^1.22.1",
     "@pgpmjs/import": "^0.7.0",
     "@pgpmjs/logger": "^2.26.0",
     "@pgpmjs/slice": "^0.18.0",
@@ -82,5 +82,5 @@
     "pg",
     "pgsql"
   ],
-  "gitHead": "baa84094b8541eb5000701b0060aa5b298032dc7"
+  "gitHead": "79b4264038d5c4da44ac1ed461195a4853f3953c"
 }

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;