@boopkit/cli 0.1.6 → 0.1.8

package/README.md

@@ -17,9 +17,29 @@ npx @boopkit/cli@beta init myapp
 ## Quick Start
 
 ```bash
+# go to your projects directory
+cd ~/projects
+
+# install the boop CLI globally 
+npm install -g @boopkit/cli@beta
+
+# scaffold a new app from the default profile (web-app)
 boop init my-app
 cd my-app
-npm run dev
+boop status # have your agent follow instructions to finish setup
+
+# start your web server
+npm run dev 
+
+# stop the server...
+
+# see available capabilities to add new features
+npm caps 
+
+# add user authentication and account management features
+# have your agent follow instructions to finish setup
+boop add users-and-accounts 
+
 ```
 
 ## Commands

package/dist/capability-versions.json

@@ -1,11 +1,12 @@
 {
   "@boopkit/cap-api": "0.1.0",
+  "@boopkit/cap-background-jobs": "0.1.0",
   "@boopkit/cap-cloud-storage": "0.1.0",
   "@boopkit/cap-coding": "0.1.0",
-  "@boopkit/cap-database": "0.1.1",
+  "@boopkit/cap-database": "0.1.3",
   "@boopkit/cap-email": "0.1.0",
   "@boopkit/cap-hello": "0.1.0",
-  "@boopkit/cap-noticeboard": "0.1.0",
+  "@boopkit/cap-noticeboard": "0.1.1",
   "@boopkit/cap-product-design": "0.1.0",
   "@boopkit/cap-project-mgmt": "0.1.0",
   "@boopkit/cap-services": "0.1.0",

package/dist/commands/loop.d.ts

@@ -10,7 +10,7 @@ export interface LoopOptions {
     pollInterval?: string;
     model?: string;
     perIssueBranch?: boolean;
-    noBranch?: boolean;
+    branch?: boolean;
     features?: boolean;
     skipPerms?: boolean;
     bare?: boolean;

package/dist/commands/loop.js

@@ -577,7 +577,7 @@ async function runLoop(options) {
     const pollInterval = parseInt(options.pollInterval || '60', 10);
     const model = options.model || 'claude-opus-4-6';
     const perIssueBranch = options.perIssueBranch || false;
-    const noBranch = options.noBranch || false;
+    const noBranch = options.branch === false;
     let includeFeatures = options.features || false;
     const skipPerms = options.skipPerms !== false; // default true
     const bare = options.bare || false;

package/dist/commands/status.js

@@ -68,7 +68,7 @@ function getStatusData(manifest, dir) {
     const capabilities = {};
     for (const capName of manifest.capabilities) {
         const capConfig = manifest.capabilityConfig?.[capName];
-        const capMeta = (0, capability_1.getCapability)(capName);
+        const capMeta = (0, capability_1.getCapability)(capName, [dir]);
         const capType = capMeta?.type;
         // Resolve env declarations: prefer manifest capabilityConfig, fall back to capability definition
         let envEntries;
@@ -118,7 +118,7 @@ function getStatusData(manifest, dir) {
         }
         if (allRequiredSet) {
             // Env vars are set — check if capability has setup checks or postInstall steps
-            const capDef = (0, capability_1.getCapability)(capName);
+            const capDef = (0, capability_1.getCapability)(capName, [dir]);
             const hasSetupChecks = capDef?.postInstall?.setupChecks?.length;
             const hasPostInstall = capDef?.postInstall && (capDef.postInstall.steps?.length || capDef.postInstall.verify);
             if (hasSetupChecks || hasPostInstall) {
@@ -131,7 +131,7 @@ function getStatusData(manifest, dir) {
         }
         else {
             // Enrich next steps with postInstall guidance from capability definition
-            const capDef = (0, capability_1.getCapability)(capName);
+            const capDef = (0, capability_1.getCapability)(capName, [dir]);
             if (capDef?.postInstall) {
                 const vars = { projectName: manifest.name, capabilityName: capName };
                 const pi = capDef.postInstall;
@@ -171,7 +171,7 @@ async function enrichWithSetupChecks(data, envValues, projectDir, projectName) {
     for (const [capName, cap] of Object.entries(data.capabilities)) {
         if (cap.status !== 'setup')
             continue;
-        const capDef = (0, capability_1.getCapability)(capName);
+        const capDef = (0, capability_1.getCapability)(capName, [projectDir]);
         const checks = capDef?.postInstall?.setupChecks;
         if (!checks?.length)
             continue;

package/dist/commands/update.js

@@ -67,7 +67,7 @@ function runUpdate(capabilityName, options) {
         }
     }
     if (plans.length === 0) {
-        const diagnosticMessage = diagnoseMissingPlans(capsToUpdate, capabilityName);
+        const diagnosticMessage = diagnoseMissingPlans(capsToUpdate, capabilityName, targetDir);
         if (options.json) {
             console.log(JSON.stringify({ capabilities: [], message: diagnosticMessage }, null, 2));
         }
@@ -160,7 +160,7 @@ function runUpdate(capabilityName, options) {
 /**
  * Diagnose why no update plans were generated and return a specific message.
  */
-function diagnoseMissingPlans(capsToUpdate, requestedCap) {
+function diagnoseMissingPlans(capsToUpdate, requestedCap, targetDir) {
     if (capsToUpdate.length === 0) {
         return 'No capabilities installed. Run `boop add <capability>` to install one.';
     }
@@ -168,7 +168,7 @@ function diagnoseMissingPlans(capsToUpdate, requestedCap) {
     const noPackage = [];
     const noBoopkit = [];
     for (const cap of capsToUpdate) {
-        const pkgDir = (0, capability_1.getPackageDir)(cap);
+        const pkgDir = (0, capability_1.getPackageDir)(cap, [targetDir]);
         if (!pkgDir) {
             noPackage.push(cap);
             continue;

package/dist/lib/preflight.js

@@ -73,8 +73,8 @@ function planAdd(targetDir, capabilityName) {
         throw new PreflightError('Pre-flight failed', checks);
     }
     checks.push({ name: 'project-exists', passed: true });
-    // 2. Resolve capability
-    const cap = (0, capability_1.getCapability)(capabilityName);
+    // 2. Resolve capability (search project's node_modules first, then CLI root)
+    const cap = (0, capability_1.getCapability)(capabilityName, [targetDir]);
     if (!cap) {
         checks.push({ name: 'capability-exists', passed: false, message: `Capability "${capabilityName}" not found` });
         throw new PreflightError('Pre-flight failed', checks);
@@ -101,7 +101,7 @@ function planAdd(targetDir, capabilityName) {
     }
     // 5. Enumerate files that would be copied — check for conflicts
     // Resolve from package (scaffold/ and skills/) or source tree (files/ and skills/)
-    const pkgDir = (0, capability_1.getPackageDir)(capabilityName);
+    const pkgDir = (0, capability_1.getPackageDir)(capabilityName, [targetDir]);
     const pkgJsonPath = pkgDir ? path.join(pkgDir, 'package.json') : null;
     const pkgJson = pkgJsonPath && fs.existsSync(pkgJsonPath)
         ? JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'))

package/dist/lib/update.js

@@ -69,7 +69,7 @@ function planCapabilityUpdate(targetDir, capabilityName, projectManifest) {
         return null;
     }
     // Must have a package
-    const pkgDir = (0, capability_1.getPackageDir)(capabilityName);
+    const pkgDir = (0, capability_1.getPackageDir)(capabilityName, [targetDir]);
     if (!pkgDir)
         return null;
     const pkgJsonPath = path.join(pkgDir, 'package.json');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boopkit/cli",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "CLI tool to scaffold new projects from boop profiles and capabilities",
   "main": "dist/cli.js",
   "workspaces": [

package/profiles/web-app/reference/architecture.ref.md

@@ -26,8 +26,8 @@ As the application grows, the architecture supports additional Heroku process ty
 
 ## Data Layer
 ### **PostgreSQL** (Prisma ORM) - Primary data store
-  - Schema: `src/db/prisma/schema.prisma`
-  - Models in `src/db/models/`, Generated client at `@prisma/*`
+  - Schema directory: `prisma/schema/` (multi-file — Prisma auto-discovers all `.prisma` files)
+  - Generated client at `@prisma/client`
   
 > **Context:** This project uses a hybrid relational + document model: key entities are tables with FK relationships; most attributes live in an `info` JSON column with `info_schema` and `revision` for change tracking. 
 
@@ -60,6 +60,6 @@ Some services are low-level and more 'data' oriented or third-party API wrappers
 
 
 ### Data Access
-  - **Prisma ORM** (`src/db/prisma/`) — PostgreSQL models, migrations, and generated client
+  - **Prisma ORM** (`prisma/schema/`) — PostgreSQL models, migrations, and generated client
   - **ClickHouse** (`src/ch/`) — Analytics queries via `ClickHouseService`
   - **S3** — Object storage via `StorageService` with per-feature clients