@boopkit/cli 0.1.13 → 0.1.15

package/dist/cli.js

@@ -89,6 +89,7 @@ program
     .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('--tag <tag>', 'Use a specific npm dist-tag instead of major-version pinning (e.g. beta)')
     .option('--json', 'Output structured JSON')
     .action(update_1.runUpdate);
 program

package/dist/commands/add.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runAdd = runAdd;
+const child_process_1 = require("child_process");
 const preflight_1 = require("../lib/preflight");
 const execute_1 = require("../lib/execute");
 const interpolate_1 = require("../lib/interpolate");
 const list_1 = require("./list");
+const capability_1 = require("../lib/capability");
 function runAdd(capabilityName, options) {
     // 0. Validate capability argument is provided
     if (!capabilityName) {
@@ -15,6 +17,25 @@ function runAdd(capabilityName, options) {
         return;
     }
     const targetDir = process.cwd();
+    // --- Phase 0: Ensure capability package is available locally ---
+    // When the CLI is installed globally, capability packages aren't in
+    // node_modules yet. Install the package so preflight can read its
+    // capability.json, scaffold files, etc.
+    if (!(0, capability_1.getPackageDir)(capabilityName, [targetDir])) {
+        const catalogEntry = (0, capability_1.getCatalogEntry)(capabilityName);
+        if (catalogEntry?.package) {
+            const spec = catalogEntry.package;
+            console.error(`Installing ${spec}...`);
+            try {
+                (0, child_process_1.execSync)(`npm install ${spec}`, { cwd: targetDir, stdio: 'pipe' });
+            }
+            catch (err) {
+                console.error(`\x1b[31mERR\x1b[0m Failed to install ${spec}: ${err.message}`);
+                process.exitCode = 1;
+                return;
+            }
+        }
+    }
     // --- Phase 1: Pre-flight (read-only) ---
     let plan;
     try {

package/dist/commands/status.js

@@ -117,11 +117,10 @@ function getStatusData(manifest, dir) {
             }
         }
         if (allRequiredSet) {
-            // Env vars are set — check if capability has setup checks or postInstall steps
+            // Env vars are set — check if capability has setup checks that enrichWithSetupChecks can resolve
             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) {
+            if (hasSetupChecks) {
                 // Mark as 'setup' — dynamic checks will populate steps during enrichment
                 capabilities[capName] = { status: 'setup', type: capType, env: envStatus, optionalSteps: optionalSteps.length > 0 ? optionalSteps : undefined };
             }

package/dist/commands/update.d.ts

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

package/dist/commands/update.js

@@ -61,7 +61,7 @@ function runUpdate(capabilityName, options) {
     }
     // 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);
+        const packageSpecs = resolveNpmPackageSpecs(capsToUpdate, targetDir, options.tag);
         if (packageSpecs.length > 0) {
             if (!options.json) {
                 console.log(`Updating npm packages: ${packageSpecs.join(', ')}`);
@@ -224,7 +224,7 @@ function diagnoseMissingPlans(capsToUpdate, requestedCap, targetDir) {
  * This allows minor+patch updates within the same major (including 0.x → 0.y)
  * without crossing a major version boundary.
  */
-function resolveNpmPackageSpecs(capabilities, targetDir) {
+function resolveNpmPackageSpecs(capabilities, targetDir, tag) {
     const specs = [];
     for (const cap of capabilities) {
         const pkgDir = (0, capability_1.getPackageDir)(cap, [targetDir]);
@@ -235,8 +235,13 @@ function resolveNpmPackageSpecs(capabilities, targetDir) {
             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}`);
+            if (tag) {
+                specs.push(`${pkgJson.name}@${tag}`);
+            }
+            else {
+                const major = pkgJson.version.split('.')[0];
+                specs.push(`${pkgJson.name}@${major}`);
+            }
         }
     }
     return specs;

package/dist/lib/capability.d.ts

@@ -5,6 +5,13 @@ import { CapabilityMetadata } from './config';
  * Returns null if not found.
  */
 export declare function getPackageDir(name: string, searchPaths?: string[]): string | null;
+/**
+ * Look up a capability in the baked-in catalog by name.
+ * Returns the catalog entry (with package field) or null if not found.
+ */
+export declare function getCatalogEntry(name: string): (CapabilityMetadata & {
+    package?: string;
+}) | null;
 /**
  * List all capabilities by scanning package directory and capabilities/ source tree (test fixtures only).
  * Package resolution takes priority. Returns metadata for each valid capability.

package/dist/lib/capability.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPackageDir = getPackageDir;
+exports.getCatalogEntry = getCatalogEntry;
 exports.listCapabilities = listCapabilities;
 exports.getCapability = getCapability;
 const fs = __importStar(require("fs"));
@@ -127,6 +128,14 @@ function loadCatalog() {
         return [];
     }
 }
+/**
+ * Look up a capability in the baked-in catalog by name.
+ * Returns the catalog entry (with package field) or null if not found.
+ */
+function getCatalogEntry(name) {
+    const catalog = loadCatalog();
+    return catalog.find(c => c.name === name) ?? null;
+}
 /**
  * List all capabilities by scanning package directory and capabilities/ source tree (test fixtures only).
  * Package resolution takes priority. Returns metadata for each valid capability.

package/package.json

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