@boopkit/cli 0.3.1 → 0.3.2

package/dist/capability-versions.json

@@ -1,18 +1,18 @@
 {
-  "@boopkit/cap-api": "0.3.0",
-  "@boopkit/cap-background-jobs": "0.3.0",
-  "@boopkit/cap-cloud-storage": "0.3.0",
-  "@boopkit/cap-coding": "0.3.0",
-  "@boopkit/cap-database": "0.3.0",
-  "@boopkit/cap-email": "0.3.0",
-  "@boopkit/cap-hello": "0.3.0",
-  "@boopkit/cap-noticeboard": "0.3.0",
-  "@boopkit/cap-product-design": "0.3.0",
-  "@boopkit/cap-project-mgmt": "0.3.0",
-  "@boopkit/cap-services": "0.3.0",
-  "@boopkit/cap-skills": "0.3.0",
-  "@boopkit/cap-testing": "0.3.0",
-  "@boopkit/cap-users": "0.3.0",
-  "@boopkit/cap-web": "0.3.0",
-  "@boopkit/logger": "0.3.0"
+  "@boopkit/cap-api": "0.3.1",
+  "@boopkit/cap-background-jobs": "0.3.1",
+  "@boopkit/cap-cloud-storage": "0.3.1",
+  "@boopkit/cap-coding": "0.3.1",
+  "@boopkit/cap-database": "0.3.1",
+  "@boopkit/cap-email": "0.3.1",
+  "@boopkit/cap-hello": "0.3.1",
+  "@boopkit/cap-noticeboard": "0.3.1",
+  "@boopkit/cap-product-design": "0.3.1",
+  "@boopkit/cap-project-mgmt": "0.3.1",
+  "@boopkit/cap-services": "0.3.1",
+  "@boopkit/cap-skills": "0.3.1",
+  "@boopkit/cap-testing": "0.3.1",
+  "@boopkit/cap-users": "0.3.1",
+  "@boopkit/cap-web": "0.3.1",
+  "@boopkit/logger": "0.3.1"
 }

package/dist/commands/status.js

@@ -181,7 +181,9 @@ async function enrichWithSetupChecks(data, envValues, projectDir, projectName) {
             label: (0, interpolate_1.interpolate)(c.label, vars),
             hint: c.hint ? (0, interpolate_1.interpolate)(c.hint, vars) : undefined,
         }));
-        const steps = await (0, db_status_1.runSetupChecks)(interpolatedChecks, envValues, projectDir, projectName);
+        // Extract this capability's .prisma files for scoped prisma-migrate checks
+        const prismaFiles = capDef?.files?.filter(f => f.endsWith('.prisma'));
+        const steps = await (0, db_status_1.runSetupChecks)(interpolatedChecks, envValues, projectDir, projectName, prismaFiles);
         const completedSteps = steps.filter(s => s.done).map(s => s.label);
         const nextSteps = steps.filter(s => !s.done).map(s => s.hint ? `${s.label}: ${s.hint}` : s.label);
         if (nextSteps.length === 0) {

package/dist/lib/db-status.d.ts

@@ -26,6 +26,16 @@ export declare function checkMigrationsTable(dbUrl: string): Promise<boolean | n
  * Returns true if prisma/migrations/ contains at least one migration subdirectory.
  */
 export declare function hasPrismaMigrations(projectDir: string): boolean;
+/**
+ * Parse a .prisma file and extract table names from model declarations.
+ * Returns the @@map() value if present, otherwise the model name.
+ */
+export declare function parsePrismaTableNames(filePath: string): string[];
+/**
+ * Check if specific tables exist in the database.
+ * Returns true if ALL tables exist, false if any are missing, null if psql unavailable.
+ */
+export declare function checkTablesExist(dbUrl: string, tableNames: string[]): Promise<boolean | null>;
 /**
  * Check if any .prisma files in the project define models.
  * Returns true if at least one file contains a `model` declaration.
@@ -52,6 +62,8 @@ export interface CheckContext {
     projectName: string;
     /** Accumulated results from earlier checks — keyed by check type. */
     results: Map<string, boolean>;
+    /** Capability's .prisma file paths relative to projectDir — enables scoped prisma-migrate checks. */
+    prismaFiles?: string[];
 }
 /**
  * Run all setup checks declared in a capability's setupChecks list.
@@ -61,4 +73,4 @@ export declare function runSetupChecks(checks: {
     type: string;
     label: string;
     hint?: string;
-}[], envValues: Map<string, string>, projectDir: string, projectName: string): Promise<SetupStep[]>;
+}[], envValues: Map<string, string>, projectDir: string, projectName: string, prismaFiles?: string[]): Promise<SetupStep[]>;

package/dist/lib/db-status.js

@@ -38,6 +38,8 @@ exports.checkTcpReachable = checkTcpReachable;
 exports.checkDatabaseConnectable = checkDatabaseConnectable;
 exports.checkMigrationsTable = checkMigrationsTable;
 exports.hasPrismaMigrations = hasPrismaMigrations;
+exports.parsePrismaTableNames = parsePrismaTableNames;
+exports.checkTablesExist = checkTablesExist;
 exports.hasPrismaModels = hasPrismaModels;
 exports.isPrismaClientGenerated = isPrismaClientGenerated;
 exports.checkPrismaMigrateStatus = checkPrismaMigrateStatus;
@@ -140,6 +142,77 @@ function hasPrismaMigrations(projectDir) {
     const entries = fs.readdirSync(migrationsDir, { withFileTypes: true });
     return entries.some(e => e.isDirectory());
 }
+/**
+ * Parse a .prisma file and extract table names from model declarations.
+ * Returns the @@map() value if present, otherwise the model name.
+ */
+function parsePrismaTableNames(filePath) {
+    if (!fs.existsSync(filePath))
+        return [];
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const tables = [];
+    const lines = content.split('\n');
+    let currentModel = null;
+    let braceDepth = 0;
+    let mapName = null;
+    for (const line of lines) {
+        const modelMatch = line.match(/^\s*model\s+(\w+)\s*\{/);
+        if (modelMatch && !currentModel) {
+            currentModel = modelMatch[1];
+            braceDepth = 1;
+            mapName = null;
+            continue;
+        }
+        if (currentModel) {
+            for (const ch of line) {
+                if (ch === '{')
+                    braceDepth++;
+                if (ch === '}')
+                    braceDepth--;
+            }
+            const mapMatch = line.match(/@@map\s*\(\s*"([^"]+)"\s*\)/);
+            if (mapMatch) {
+                mapName = mapMatch[1];
+            }
+            if (braceDepth === 0) {
+                tables.push(mapName || currentModel);
+                currentModel = null;
+                mapName = null;
+            }
+        }
+    }
+    return tables;
+}
+/**
+ * Check if specific tables exist in the database.
+ * Returns true if ALL tables exist, false if any are missing, null if psql unavailable.
+ */
+function checkTablesExist(dbUrl, tableNames) {
+    if (tableNames.length === 0)
+        return Promise.resolve(true);
+    // Validate table names — only allow alphanumeric and underscores
+    if (!tableNames.every(t => /^[a-zA-Z_]\w*$/.test(t))) {
+        return Promise.resolve(false);
+    }
+    const quotedNames = tableNames.map(t => `'${t}'`).join(',');
+    const query = `SELECT COUNT(*) FROM information_schema.tables WHERE table_schema = 'public' AND table_name IN (${quotedNames})`;
+    return new Promise((resolve) => {
+        (0, child_process_1.execFile)('psql', [dbUrl, '-tAc', query], { timeout: 3000 }, (error, stdout) => {
+            if (error) {
+                if ('code' in error && error.code === 'ENOENT') {
+                    resolve(null);
+                }
+                else {
+                    resolve(false);
+                }
+            }
+            else {
+                const count = parseInt(stdout.trim(), 10);
+                resolve(count === tableNames.length);
+            }
+        });
+    });
+}
 /**
  * Check if any .prisma files in the project define models.
  * Returns true if at least one file contains a `model` declaration.
@@ -216,7 +289,28 @@ async function runCheck(type, ctx) {
             // Skip only if a database check was explicitly run and failed
             if (ctx.results.has('database') && !ctx.results.get('database'))
                 return false;
-            // If schema has models but no migrations exist, migration hasn't been run
+            // Scoped check: when prismaFiles are provided, check this capability's tables instead of global status
+            if (ctx.prismaFiles?.length) {
+                const tableNames = [];
+                for (const file of ctx.prismaFiles) {
+                    const filePath = path.join(ctx.projectDir, file);
+                    tableNames.push(...parsePrismaTableNames(filePath));
+                }
+                if (tableNames.length > 0) {
+                    // Capability defines models — check if its tables exist in the DB
+                    const dbUrl = ctx.envValues.get('DATABASE_URL');
+                    if (!dbUrl)
+                        return false;
+                    return (await checkTablesExist(dbUrl, tableNames)) === true;
+                }
+                // Capability has prisma files but no models (e.g., base schema) —
+                // check if _prisma_migrations table exists (initial migration was run)
+                const dbUrl = ctx.envValues.get('DATABASE_URL');
+                if (!dbUrl)
+                    return false;
+                return (await checkMigrationsTable(dbUrl)) === true;
+            }
+            // Fallback: no capability context — use global check
             if (hasPrismaModels(ctx.projectDir) && !hasPrismaMigrations(ctx.projectDir))
                 return false;
             const result = await checkPrismaMigrateStatus(ctx.projectDir);
@@ -233,8 +327,8 @@ async function runCheck(type, ctx) {
  * Run all setup checks declared in a capability's setupChecks list.
  * Returns an ordered list of steps with live done/pending status.
  */
-async function runSetupChecks(checks, envValues, projectDir, projectName) {
-    const ctx = { envValues, projectDir, projectName, results: new Map() };
+async function runSetupChecks(checks, envValues, projectDir, projectName, prismaFiles) {
+    const ctx = { envValues, projectDir, projectName, results: new Map(), prismaFiles };
     const steps = [];
     for (const check of checks) {
         const done = await runCheck(check.type, ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boopkit/cli",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "boop: the opinionated bootstrap for founder friendly, AI-first web apps - code plus agent skills, composable from day one.",
   "main": "dist/cli.js",
   "workspaces": [

package/profiles/web-app/reference/message-queue-patterns.ref.md

@@ -24,7 +24,7 @@ await MessageQueueService.publish('batch-ready', [message1, message2]);
 - **Reuse**: The same connection and channel are reused for all subsequent publishes
 - **Auto-reconnect**: If the connection drops (`error` or `close` event), the cached reference is cleared and the next `publish()` call opens a fresh connection
 - **Error recovery**: If `publish()` catches an error (e.g., channel closed), it resets connection state and returns `false` — the next call will reconnect
-- **Shutdown**: The publish connection is tracked in `listenerConnections` and closed by the coordinated SIGINT handler alongside listener connections
+- **Shutdown**: The publish connection is tracked and closed by `close()` alongside the listener connection
 
 ### Why persistent (not per-call)
 
@@ -36,6 +36,21 @@ The original implementation opened a new AMQP connection for every `publish()` c
 |--------|-------|-----------|
 | Scheduler jobs | various | 1-2 per 10-min cycle |
 
+## Listening
+
+`MessageQueueService.listen()` uses a **shared AMQP connection** across all queue consumers. Each `listen()` call creates a separate **channel** on the shared connection. This keeps connection count at 2 (1 publish + 1 listen) regardless of how many queues are consumed.
+
+### Connection lifecycle
+
+- **Lazy init**: No connection is opened until the first `listen()` call
+- **Shared**: All listeners share the same connection; each gets its own channel with independent prefetch and consumer
+- **Auto-reconnect**: If the connection drops (`error` or `close` event), the cached reference is cleared and the next `listen()` call opens a fresh connection
+- **Shutdown**: The listener connection is closed by `close()` alongside the publish connection
+
+### Why shared (not per-queue)
+
+CloudAMQP's shared plan has a 20-connection limit. The previous implementation opened a new AMQP connection per `listen()` call. AMQP supports multiple channels on a single connection — each channel can have its own prefetch and consumer — so sharing one connection scales to any number of queue consumers without hitting connection limits.
+
 ## Consumer Modes
 
 The `MessageQueueService.listen()` function supports two modes controlled by `opts.manualAck`: