@prave/cli 0.1.0 → 0.2.0

package/dist/commands/export.js

@@ -1,6 +1,7 @@
 import { writeFile } from 'node:fs/promises';
 import { api } from '../lib/api.js';
 import { loadCredentials } from '../lib/credentials.js';
+import { fetchMyPlan, formatUpgradeHint } from '../lib/plan.js';
 import { log } from '../utils/logger.js';
 /**
  * `prave export <slug>` — print or save a Skill's SKILL.md to disk
@@ -9,6 +10,16 @@ import { log } from '../utils/logger.js';
  */
 export async function exportCommand(slug, opts = {}) {
     const session = await loadCredentials();
+    // Plan gate: Free can't export. Explorer caps at 50/mo (server-enforced
+    // via per-user counter once that lands; CLI-side we only flag the gate).
+    if (session) {
+        const me = await fetchMyPlan();
+        if (me.limits.cli_exports_monthly === 0) {
+            log.warn('Export requires the Explorer plan or higher.');
+            log.dim(formatUpgradeHint('explorer'));
+            return;
+        }
+    }
     const { data: skill } = await api.get(`/api/v1/skills/${encodeURIComponent(slug)}`, Boolean(session));
     const content = skill.content ?? '';
     if (!content.trim()) {

package/dist/commands/import.js

@@ -4,6 +4,7 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { api } from '../lib/api.js';
 import { CONFIG } from '../lib/config.js';
+import { fetchMyPlan, formatUpgradeHint } from '../lib/plan.js';
 import { log } from '../utils/logger.js';
 /**
  * Scans CONFIG.skillsDir for SKILL.md files. Without --upload, only prints
@@ -42,10 +43,27 @@ export async function importCommand(opts) {
         log.dim('\nRe-run with --upload to push these to your Prave account.');
         return;
     }
+    // Plan gate: clamp the queue to the caller's import / private quota so
+    // we don't waste 70 round-trips against a Free account that maxes at 10.
+    const me = await fetchMyPlan();
     const visibility = opts.private ? 'private' : 'public';
-    const uploadSpinner = ora(`Uploading ${skills.length} skills as ${visibility}…`).start();
+    if (visibility === 'private' && !me.limits.can_private_skills) {
+        log.warn('Private imports require the Explorer plan.');
+        log.dim(formatUpgradeHint('explorer'));
+        return;
+    }
+    let queue = skills;
+    if (me.limits.cli_max_imports !== null && queue.length > me.limits.cli_max_imports) {
+        log.warn(`Your ${me.plan} plan caps imports at ${me.limits.cli_max_imports}. Trimming queue from ${queue.length} → ${me.limits.cli_max_imports}.`);
+        log.dim(formatUpgradeHint('explorer'));
+        queue = queue.slice(0, me.limits.cli_max_imports);
+    }
+    const uploadSpinner = ora(`Uploading ${queue.length} skills as ${visibility}…`).start();
     let ok = 0;
-    for (const s of skills) {
+    let skipped = 0;
+    let failed = 0;
+    let gated = 0;
+    for (const s of queue) {
         try {
             await api.post('/api/v1/skills', {
                 name: s.slug,
@@ -57,8 +75,34 @@ export async function importCommand(opts) {
             ok += 1;
         }
         catch (err) {
-            uploadSpinner.warn(`Failed: ${s.slug} — ${err.message}`);
+            const msg = err.message ?? 'unknown error';
+            // The API returns 409 when an identical-content public skill already
+            // exists. That isn't a real failure on import — flag it as skipped so
+            // the user can keep going.
+            if (/already exists/i.test(msg) || /409/.test(msg)) {
+                skipped += 1;
+                log.dim(`  ↷ skipped ${s.slug} — already on Prave`);
+            }
+            else if (/402/.test(msg) || /upgrade/i.test(msg) || /caps/i.test(msg)) {
+                // Plan limit hit on the server (e.g. max public skills reached).
+                gated += 1;
+                uploadSpinner.warn(`Quota: ${s.slug} — ${msg}`);
+            }
+            else {
+                failed += 1;
+                uploadSpinner.warn(`Failed: ${s.slug} — ${msg}`);
+            }
         }
     }
-    uploadSpinner.succeed(`Uploaded ${ok}/${skills.length} skills.`);
+    const tail = [
+        `Uploaded ${ok}/${queue.length}`,
+        skipped ? `${skipped} skipped (dupes)` : null,
+        gated ? `${gated} blocked by plan` : null,
+        failed ? `${failed} failed` : null,
+    ]
+        .filter(Boolean)
+        .join(' · ');
+    uploadSpinner.succeed(tail);
+    if (gated > 0)
+        log.dim(formatUpgradeHint('explorer'));
 }

package/dist/commands/sync.js

@@ -3,6 +3,8 @@ import { join } from 'node:path';
 import chalk from 'chalk';
 import ora from 'ora';
 import { CONFIG } from '../lib/config.js';
+import { loadCredentials } from '../lib/credentials.js';
+import { fetchMyPlan, formatUpgradeHint } from '../lib/plan.js';
 import { log } from '../utils/logger.js';
 import { installCommand } from './install.js';
 /**
@@ -12,6 +14,16 @@ import { installCommand } from './install.js';
  * resolved on the original install).
  */
 export async function syncCommand() {
+    // Plan gate: sync requires Explorer or higher.
+    const session = await loadCredentials();
+    if (session) {
+        const me = await fetchMyPlan();
+        if (!me.limits.can_cli_sync) {
+            log.warn('Sync requires the Explorer plan or higher.');
+            log.dim(formatUpgradeHint('explorer'));
+            return;
+        }
+    }
     const spinner = ora('Scanning local Skills…').start();
     let entries = [];
     try {

package/dist/lib/plan.js

@@ -0,0 +1,31 @@
+import { PLAN_LIMITS } from '@prave/shared';
+import { api } from './api.js';
+let cache = null;
+/**
+ * Resolve the caller's plan + limits via /me/plan. Cached for the
+ * lifetime of the CLI invocation since plan changes mid-command are not
+ * a real concern. On any error (auth missing, network) we fall back to
+ * 'free' so commands still gracefully gate.
+ */
+export const fetchMyPlan = async () => {
+    if (cache)
+        return cache;
+    try {
+        const { data } = await api.get('/api/v1/me/plan', true);
+        cache = data;
+        return data;
+    }
+    catch {
+        const fallback = {
+            plan: 'free',
+            limits: PLAN_LIMITS.free,
+            subscription_status: null,
+            current_period_end: null,
+        };
+        cache = fallback;
+        return fallback;
+    }
+};
+export const formatUpgradeHint = (required) => required === 'creator'
+    ? 'Upgrade to Creator at https://prave.app/dashboard/settings'
+    : 'Upgrade to Explorer (€4/mo) at https://prave.app/dashboard/settings';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prave/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Prave CLI — import, export, install, sync Claude Skills.",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
     "open": "^10.1.0",
     "ora": "^8.0.1",
     "undici": "^6.18.0",
-    "@prave/shared": "0.1.0"
+    "@prave/shared": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^20.12.7",