pgpm 4.26.4 → 4.28.0

package/README.md

@@ -455,6 +455,20 @@ Most commands support these global options:
 - `--version, -v` - Show version information
 - `--cwd <dir>` - Set working directory
 
+## AI Agent Skills
+
+Install the pgpm skill for AI coding agents (Devin, Claude Code, Cursor, Copilot):
+
+```bash
+npx skills add https://github.com/constructive-io/constructive --skill pgpm
+```
+
+For the full Constructive platform skills (security, blueprints, codegen, billing, etc.):
+
+```bash
+npx skills add constructive-io/constructive-skills
+```
+
 ---
 
 ## Education and Tutorials
@@ -507,6 +521,17 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
 
 * [constructive-skills](https://github.com/constructive-io/constructive-skills): **📖 Platform documentation and AI agent skills** — feature catalog, blueprint reference, SDK guides (i18n, billing, limits, events, uploads, security, entities, search, AI), and deployment guides.
 
+Install skills for AI coding agents:
+
+```bash
+# All platform skills (security, blueprints, codegen, billing, etc.)
+npx skills add constructive-io/constructive-skills
+
+# Individual repo skills (pgpm, testing, CLI, search, etc.)
+npx skills add https://github.com/constructive-io/constructive --skill pgpm
+npx skills add https://github.com/constructive-io/constructive --skill constructive-testing
+```
+
 ## Credits
 
 **🛠 Built by the [Constructive](https://constructive.io) team — creators of modular Postgres tooling for secure, composable backends. If you like our work, contribute on [GitHub](https://github.com/constructive-io).**

package/commands/init/index.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createInitUsageText = void 0;
+const child_process_1 = require("child_process");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const core_1 = require("@pgpmjs/core");
@@ -35,6 +36,7 @@ Options:
   --template, -t <path>   Full template path (e.g., pnpm/module) - combines dir and fromPath
   --boilerplate           Prompt to select from available boilerplates
   --create-workspace, -w  Create a workspace first, then create the module inside it
+  --use-skills            Use npx skills CLI for skill installation (slower, writes skills-lock.json)
 
 Examples:
   ${binaryName} init                                   Initialize new module (default)
@@ -64,6 +66,7 @@ async function handleInit(argv, prompter) {
     const noTty = Boolean(argv.noTty || argv['no-tty'] || argv.tty === false || process.env.CI === 'true');
     const useBoilerplatePrompt = Boolean(argv.boilerplate);
     const createWorkspace = Boolean(argv.createWorkspace || argv['create-workspace'] || argv.w);
+    const useNpxSkills = Boolean(argv.useSkills || argv['use-skills']);
     // Get fromPath from first positional arg
     const positionalFromPath = argv._?.[0];
     // Handle --template flag: parses "dir/fromPath" format and extracts both components
@@ -92,6 +95,7 @@ async function handleInit(argv, prompter) {
             dir,
             noTty,
             cwd,
+            useNpxSkills,
         });
     }
     // Regular init path: --template takes precedence, then positional arg, then default to 'module'
@@ -117,6 +121,7 @@ async function handleInit(argv, prompter) {
             dir,
             noTty,
             cwd,
+            useNpxSkills,
         });
     }
     // Default to module init (for 'module' type, 'generic' type, or unknown types)
@@ -129,6 +134,7 @@ async function handleInit(argv, prompter) {
         cwd,
         requiresWorkspace: inspection.config?.requiresWorkspace,
         createWorkspace,
+        useNpxSkills,
     }, wasExplicitModuleRequest);
 }
 async function handleBoilerplateInit(argv, prompter, ctx) {
@@ -194,6 +200,7 @@ async function handleBoilerplateInit(argv, prompter, ctx) {
             dir: ctx.dir,
             noTty: ctx.noTty,
             cwd: ctx.cwd,
+            useNpxSkills: ctx.useNpxSkills,
         });
     }
     // Default to module init (for 'module' type, 'generic' type, or unknown types)
@@ -206,8 +213,68 @@ async function handleBoilerplateInit(argv, prompter, ctx) {
         noTty: ctx.noTty,
         cwd: ctx.cwd,
         requiresWorkspace: inspection.config?.requiresWorkspace,
+        useNpxSkills: ctx.useNpxSkills,
     }, true);
 }
+function installSkills(skills, cwd, useNpxSkills) {
+    if (process.env.PGPM_SKIP_SKILL_INSTALL)
+        return;
+    if (useNpxSkills) {
+        installSkillsViaNpx(skills, cwd);
+    }
+    else {
+        installSkillsBuiltin(skills, cwd);
+    }
+}
+function installSkillsBuiltin(skills, cwd) {
+    const installer = new core_1.SkillInstaller({ toolName: core_1.DEFAULT_TEMPLATE_TOOL_NAME });
+    const result = installer.install(skills, cwd);
+    if (result.installed.length > 0) {
+        for (const name of result.installed) {
+            process.stdout.write(`  installed ${name}\n`);
+        }
+    }
+    if (result.failed.length > 0) {
+        process.stdout.write('\n⚠️  Some skills could not be installed automatically.\n');
+        process.stdout.write('Run the following commands manually:\n\n');
+        for (const f of result.failed) {
+            const source = f.source.includes('://')
+                ? f.source
+                : `https://github.com/${f.source}`;
+            process.stdout.write(`  npx skills add ${source} --skill ${f.skill}\n`);
+        }
+        process.stdout.write('\n');
+    }
+}
+function installSkillsViaNpx(skills, cwd) {
+    const failed = [];
+    for (const entry of skills) {
+        const source = entry.source.includes('://')
+            ? entry.source
+            : `https://github.com/${entry.source}`;
+        for (const skill of entry.skills) {
+            const cmd = `npx --yes skills add ${source} --skill ${skill} --yes`;
+            try {
+                (0, child_process_1.execSync)(cmd, {
+                    cwd,
+                    stdio: ['pipe', 'inherit', 'inherit'],
+                    timeout: 120_000,
+                });
+            }
+            catch {
+                failed.push(`  npx skills add ${source} --skill ${skill}`);
+            }
+        }
+    }
+    if (failed.length > 0) {
+        process.stdout.write('\n⚠️  Some skills could not be installed automatically.\n');
+        process.stdout.write('Run the following commands manually:\n\n');
+        for (const cmd of failed) {
+            process.stdout.write(`${cmd}\n`);
+        }
+        process.stdout.write('\n');
+    }
+}
 async function handleWorkspaceInit(argv, prompter, ctx) {
     const workspaceQuestions = [
         {
@@ -254,6 +321,18 @@ async function handleWorkspaceInit(argv, prompter, ctx) {
     if (!motd.endsWith('\n')) {
         process.stdout.write('\n');
     }
+    // Install skills declared in .boilerplate.json
+    const templateInfo = (0, core_1.inspectTemplate)({
+        fromPath: ctx.fromPath,
+        templateRepo: ctx.templateRepo,
+        branch: ctx.branch,
+        dir: ctx.dir,
+        cwd: ctx.cwd,
+    });
+    if (templateInfo.config?.skills?.length) {
+        process.stdout.write('\n📦 Installing skills...\n\n');
+        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`);
     return { ...argv, ...answers, cwd: targetPath };
@@ -502,6 +581,19 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
     if (!motd.endsWith('\n')) {
         process.stdout.write('\n');
     }
+    // Install skills declared in .boilerplate.json
+    const moduleTemplateInfo = (0, core_1.inspectTemplate)({
+        fromPath: ctx.fromPath,
+        templateRepo: ctx.templateRepo,
+        branch: ctx.branch,
+        dir: ctx.dir,
+        cwd: ctx.cwd,
+    });
+    if (moduleTemplateInfo.config?.skills?.length) {
+        const skillsCwd = project.workspacePath || modulePath;
+        process.stdout.write('\n📦 Installing skills...\n\n');
+        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`);
     return { ...argv, ...answers };

package/esm/commands/init/index.js

@@ -1,6 +1,7 @@
+import { execSync } from 'child_process';
 import fs from 'fs';
 import path from 'path';
-import { DEFAULT_TEMPLATE_REPO, DEFAULT_TEMPLATE_TOOL_NAME, inspectTemplate, PgpmPackage, resolveBoilerplateBaseDir, scaffoldTemplate, scanBoilerplates, sluggify, } from '@pgpmjs/core';
+import { DEFAULT_TEMPLATE_REPO, DEFAULT_TEMPLATE_TOOL_NAME, inspectTemplate, PgpmPackage, resolveBoilerplateBaseDir, scaffoldTemplate, scanBoilerplates, SkillInstaller, sluggify, } from '@pgpmjs/core';
 import { resolveWorkspaceByType } from '@pgpmjs/env';
 import { errors } from '@pgpmjs/types';
 import { registerDefaultResolver } from 'inquirerer';
@@ -29,6 +30,7 @@ Options:
   --template, -t <path>   Full template path (e.g., pnpm/module) - combines dir and fromPath
   --boilerplate           Prompt to select from available boilerplates
   --create-workspace, -w  Create a workspace first, then create the module inside it
+  --use-skills            Use npx skills CLI for skill installation (slower, writes skills-lock.json)
 
 Examples:
   ${binaryName} init                                   Initialize new module (default)
@@ -57,6 +59,7 @@ async function handleInit(argv, prompter) {
     const noTty = Boolean(argv.noTty || argv['no-tty'] || argv.tty === false || process.env.CI === 'true');
     const useBoilerplatePrompt = Boolean(argv.boilerplate);
     const createWorkspace = Boolean(argv.createWorkspace || argv['create-workspace'] || argv.w);
+    const useNpxSkills = Boolean(argv.useSkills || argv['use-skills']);
     // Get fromPath from first positional arg
     const positionalFromPath = argv._?.[0];
     // Handle --template flag: parses "dir/fromPath" format and extracts both components
@@ -85,6 +88,7 @@ async function handleInit(argv, prompter) {
             dir,
             noTty,
             cwd,
+            useNpxSkills,
         });
     }
     // Regular init path: --template takes precedence, then positional arg, then default to 'module'
@@ -110,6 +114,7 @@ async function handleInit(argv, prompter) {
             dir,
             noTty,
             cwd,
+            useNpxSkills,
         });
     }
     // Default to module init (for 'module' type, 'generic' type, or unknown types)
@@ -122,6 +127,7 @@ async function handleInit(argv, prompter) {
         cwd,
         requiresWorkspace: inspection.config?.requiresWorkspace,
         createWorkspace,
+        useNpxSkills,
     }, wasExplicitModuleRequest);
 }
 async function handleBoilerplateInit(argv, prompter, ctx) {
@@ -187,6 +193,7 @@ async function handleBoilerplateInit(argv, prompter, ctx) {
             dir: ctx.dir,
             noTty: ctx.noTty,
             cwd: ctx.cwd,
+            useNpxSkills: ctx.useNpxSkills,
         });
     }
     // Default to module init (for 'module' type, 'generic' type, or unknown types)
@@ -199,8 +206,68 @@ async function handleBoilerplateInit(argv, prompter, ctx) {
         noTty: ctx.noTty,
         cwd: ctx.cwd,
         requiresWorkspace: inspection.config?.requiresWorkspace,
+        useNpxSkills: ctx.useNpxSkills,
     }, true);
 }
+function installSkills(skills, cwd, useNpxSkills) {
+    if (process.env.PGPM_SKIP_SKILL_INSTALL)
+        return;
+    if (useNpxSkills) {
+        installSkillsViaNpx(skills, cwd);
+    }
+    else {
+        installSkillsBuiltin(skills, cwd);
+    }
+}
+function installSkillsBuiltin(skills, cwd) {
+    const installer = new SkillInstaller({ toolName: DEFAULT_TEMPLATE_TOOL_NAME });
+    const result = installer.install(skills, cwd);
+    if (result.installed.length > 0) {
+        for (const name of result.installed) {
+            process.stdout.write(`  installed ${name}\n`);
+        }
+    }
+    if (result.failed.length > 0) {
+        process.stdout.write('\n⚠️  Some skills could not be installed automatically.\n');
+        process.stdout.write('Run the following commands manually:\n\n');
+        for (const f of result.failed) {
+            const source = f.source.includes('://')
+                ? f.source
+                : `https://github.com/${f.source}`;
+            process.stdout.write(`  npx skills add ${source} --skill ${f.skill}\n`);
+        }
+        process.stdout.write('\n');
+    }
+}
+function installSkillsViaNpx(skills, cwd) {
+    const failed = [];
+    for (const entry of skills) {
+        const source = entry.source.includes('://')
+            ? entry.source
+            : `https://github.com/${entry.source}`;
+        for (const skill of entry.skills) {
+            const cmd = `npx --yes skills add ${source} --skill ${skill} --yes`;
+            try {
+                execSync(cmd, {
+                    cwd,
+                    stdio: ['pipe', 'inherit', 'inherit'],
+                    timeout: 120_000,
+                });
+            }
+            catch {
+                failed.push(`  npx skills add ${source} --skill ${skill}`);
+            }
+        }
+    }
+    if (failed.length > 0) {
+        process.stdout.write('\n⚠️  Some skills could not be installed automatically.\n');
+        process.stdout.write('Run the following commands manually:\n\n');
+        for (const cmd of failed) {
+            process.stdout.write(`${cmd}\n`);
+        }
+        process.stdout.write('\n');
+    }
+}
 async function handleWorkspaceInit(argv, prompter, ctx) {
     const workspaceQuestions = [
         {
@@ -247,6 +314,18 @@ async function handleWorkspaceInit(argv, prompter, ctx) {
     if (!motd.endsWith('\n')) {
         process.stdout.write('\n');
     }
+    // Install skills declared in .boilerplate.json
+    const templateInfo = inspectTemplate({
+        fromPath: ctx.fromPath,
+        templateRepo: ctx.templateRepo,
+        branch: ctx.branch,
+        dir: ctx.dir,
+        cwd: ctx.cwd,
+    });
+    if (templateInfo.config?.skills?.length) {
+        process.stdout.write('\n📦 Installing skills...\n\n');
+        installSkills(templateInfo.config.skills, targetPath, Boolean(ctx.useNpxSkills));
+    }
     const relPath = path.relative(process.cwd(), targetPath);
     process.stdout.write(`\n✨ Enjoy!\n\ncd ./${relPath}\n`);
     return { ...argv, ...answers, cwd: targetPath };
@@ -495,6 +574,19 @@ async function handleModuleInit(argv, prompter, ctx, wasExplicitModuleRequest =
     if (!motd.endsWith('\n')) {
         process.stdout.write('\n');
     }
+    // Install skills declared in .boilerplate.json
+    const moduleTemplateInfo = inspectTemplate({
+        fromPath: ctx.fromPath,
+        templateRepo: ctx.templateRepo,
+        branch: ctx.branch,
+        dir: ctx.dir,
+        cwd: ctx.cwd,
+    });
+    if (moduleTemplateInfo.config?.skills?.length) {
+        const skillsCwd = project.workspacePath || modulePath;
+        process.stdout.write('\n📦 Installing skills...\n\n');
+        installSkills(moduleTemplateInfo.config.skills, skillsCwd, Boolean(ctx.useNpxSkills));
+    }
     const relPath = path.relative(process.cwd(), modulePath);
     process.stdout.write(`\n✨ Enjoy!\n\ncd ./${relPath}\n`);
     return { ...argv, ...answers };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgpm",
-  "version": "4.26.4",
+  "version": "4.28.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "PostgreSQL Package Manager - Database migration and package management CLI",
   "main": "index.js",
@@ -46,15 +46,15 @@
   },
   "dependencies": {
     "@inquirerer/utils": "^3.3.7",
-    "@pgpmjs/core": "^6.22.1",
+    "@pgpmjs/core": "^6.24.0",
     "@pgpmjs/env": "^2.25.0",
-    "@pgpmjs/export": "^0.21.1",
+    "@pgpmjs/export": "^0.21.3",
     "@pgpmjs/logger": "^2.12.0",
     "@pgpmjs/types": "^2.29.0",
     "@pgsql/quotes": "^17.1.0",
     "appstash": "^0.7.0",
     "find-and-require-package-json": "^0.9.1",
-    "genomic": "^5.4.0",
+    "genomic": "^5.6.0",
     "inquirerer": "^4.8.1",
     "js-yaml": "^4.1.0",
     "pg-cache": "^3.12.0",
@@ -76,5 +76,5 @@
     "pg",
     "pgsql"
   ],
-  "gitHead": "d6a34a51d5e889443c2345c80ccfcea050875bda"
+  "gitHead": "659c7776183c8dc497e640c384e8d1af45965065"
 }