pgpm 4.26.4 → 4.27.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");
@@ -208,6 +209,35 @@ async function handleBoilerplateInit(argv, prompter, ctx) {
         requiresWorkspace: inspection.config?.requiresWorkspace,
     }, true);
 }
+function installSkills(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 +284,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);
+    }
     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 +544,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);
+    }
     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,3 +1,4 @@
+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';
@@ -201,6 +202,35 @@ async function handleBoilerplateInit(argv, prompter, ctx) {
         requiresWorkspace: inspection.config?.requiresWorkspace,
     }, true);
 }
+function installSkills(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 +277,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);
+    }
     const relPath = path.relative(process.cwd(), targetPath);
     process.stdout.write(`\n✨ Enjoy!\n\ncd ./${relPath}\n`);
     return { ...argv, ...answers, cwd: targetPath };
@@ -495,6 +537,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);
+    }
     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.27.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.23.0",
     "@pgpmjs/env": "^2.25.0",
-    "@pgpmjs/export": "^0.21.1",
+    "@pgpmjs/export": "^0.21.2",
     "@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.5.0",
     "inquirerer": "^4.8.1",
     "js-yaml": "^4.1.0",
     "pg-cache": "^3.12.0",
@@ -76,5 +76,5 @@
     "pg",
     "pgsql"
   ],
-  "gitHead": "d6a34a51d5e889443c2345c80ccfcea050875bda"
+  "gitHead": "30fdaaacfc61f86b3e466f0c4c3768550fd77a55"
 }