@boopkit/cli 0.1.7 → 0.1.9

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,8 +1,9 @@
 {
   "@boopkit/cap-api": "0.1.0",
+  "@boopkit/cap-background-jobs": "0.2.0",
   "@boopkit/cap-cloud-storage": "0.1.0",
   "@boopkit/cap-coding": "0.1.0",
-  "@boopkit/cap-database": "0.1.2",
+  "@boopkit/cap-database": "0.1.3",
   "@boopkit/cap-email": "0.1.0",
   "@boopkit/cap-hello": "0.1.0",
   "@boopkit/cap-noticeboard": "0.1.1",

package/dist/cli.js

@@ -52,6 +52,7 @@ program
     .option('--force', 'Overwrite locally modified files (creates .bak backup)')
     .option('--restore', 'Restore locally deleted scaffold files')
     .option('--prune', 'Remove deprecated scaffold files from disk (creates .bak backup)')
+    .option('--skip-npm', 'Skip npm update (only re-scaffold from installed versions)')
     .option('--json', 'Output structured JSON')
     .action(update_1.runUpdate);
 program

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.d.ts

@@ -4,5 +4,6 @@ export interface UpdateOptions {
     restore?: boolean;
     prune?: boolean;
     json?: boolean;
+    skipNpm?: boolean;
 }
 export declare function runUpdate(capabilityName: string | undefined, options: UpdateOptions): void;

package/dist/commands/update.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runUpdate = runUpdate;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
 const project_1 = require("../lib/project");
 const capability_1 = require("../lib/capability");
 const update_1 = require("../lib/update");
@@ -58,6 +59,21 @@ function runUpdate(capabilityName, options) {
         process.exitCode = 1;
         return;
     }
+    // Step 1: npm install capability packages at latest within current major (unless --skip-npm or --dry-run)
+    if (!options.skipNpm && !options.dryRun) {
+        const packageSpecs = resolveNpmPackageSpecs(capsToUpdate, targetDir);
+        if (packageSpecs.length > 0) {
+            if (!options.json) {
+                console.log(`Updating npm packages: ${packageSpecs.join(', ')}`);
+            }
+            try {
+                (0, child_process_1.execSync)(`npm install ${packageSpecs.join(' ')}`, { cwd: targetDir, stdio: options.json ? 'pipe' : 'inherit' });
+            }
+            catch (err) {
+                console.error(`\x1b[33mWARN\x1b[0m npm install failed — continuing with scaffold update using installed versions`);
+            }
+        }
+    }
     // Plan all updates
     const plans = [];
     for (const cap of capsToUpdate) {
@@ -67,7 +83,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 +176,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 +184,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;
@@ -202,3 +218,26 @@ function diagnoseMissingPlans(capsToUpdate, requestedCap) {
     }
     return 'No capabilities to update.';
 }
+/**
+ * Resolve capability names to npm install specs pinned to the current major version.
+ * E.g. @boopkit/cap-background-jobs@0.2.0 → "@boopkit/cap-background-jobs@0"
+ * This allows minor+patch updates within the same major (including 0.x → 0.y)
+ * without crossing a major version boundary.
+ */
+function resolveNpmPackageSpecs(capabilities, targetDir) {
+    const specs = [];
+    for (const cap of capabilities) {
+        const pkgDir = (0, capability_1.getPackageDir)(cap, [targetDir]);
+        if (!pkgDir)
+            continue;
+        const pkgJsonPath = path.join(pkgDir, 'package.json');
+        if (!fs.existsSync(pkgJsonPath))
+            continue;
+        const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
+        if (pkgJson.name && pkgJson.boopkit?.capability && pkgJson.version) {
+            const major = pkgJson.version.split('.')[0];
+            specs.push(`${pkgJson.name}@${major}`);
+        }
+    }
+    return specs;
+}

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.7",
+  "version": "0.1.9",
   "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