@prave/cli 1.6.0 → 1.6.1

package/dist/commands/advisor.js

@@ -0,0 +1,68 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { track } from '../lib/analytics.js';
+import { api, ApiError } from '../lib/api.js';
+import { requireAuth } from '../lib/credentials.js';
+import { log } from '../utils/logger.js';
+const RULE = '─────────────────────────────────────────';
+export async function advisorCommand(task, opts = {}) {
+    const mode = opts.auto ? 'auto' : 'manual';
+    track('cli_advisor', { auto_mode: opts.auto === true, task_length: task?.length ?? 0 });
+    if (mode === 'manual') {
+        if (!task || task.trim().length < 8) {
+            log.error('Pass a task description of at least 8 characters, or use --auto.');
+            process.exitCode = 1;
+            return;
+        }
+    }
+    await requireAuth('advisor');
+    const spinner = ora(mode === 'auto' ? 'Thinking…' : `Thinking about "${truncate(task, 60)}"…`).start();
+    try {
+        const { data } = await api.post('/api/v1/advisor', { mode, task: mode === 'manual' ? task : undefined }, true);
+        spinner.stop();
+        console.log(chalk.dim(RULE));
+        console.log(chalk.bold('Recommended for you'));
+        console.log(chalk.dim(RULE));
+        console.log(wrap(data.prose, 78));
+        console.log();
+        if (data.recommendations.length === 0) {
+            log.dim('No specific Skills to recommend yet.');
+        }
+        else {
+            for (const rec of data.recommendations) {
+                console.log(`  ${chalk.cyan('▸')} ${chalk.bold(rec.slug)}`);
+                console.log(`    ${chalk.dim('Why:')} ${wrap(rec.reason, 70).split('\n').join('\n    ')}`);
+                console.log(`    ${chalk.dim(`prave install ${rec.slug}`)}`);
+                console.log();
+            }
+        }
+        console.log(chalk.dim(`Quota: ${data.quota.used} / ${data.quota.limit} today on the ${data.quota.plan} plan.`));
+    }
+    catch (err) {
+        spinner.stop();
+        log.error(err instanceof ApiError ? err.message : err.message);
+        process.exitCode = 1;
+    }
+}
+function truncate(s, n) {
+    return s.length <= n ? s : `${s.slice(0, n - 1)}…`;
+}
+function wrap(text, width) {
+    const out = [];
+    for (const para of text.split('\n')) {
+        const words = para.trim().split(/\s+/);
+        let line = '';
+        for (const w of words) {
+            if ((line + ' ' + w).trim().length > width) {
+                out.push(line.trim());
+                line = w;
+            }
+            else {
+                line = `${line} ${w}`;
+            }
+        }
+        if (line.trim())
+            out.push(line.trim());
+    }
+    return out.join('\n');
+}

package/dist/commands/mcp-server.js

@@ -62,6 +62,23 @@ const TOOLS = [
             required: ['slug'],
         },
     },
+    {
+        name: 'prave_advisor',
+        description: "Contextual Skill advisor. Given a user task (e.g. 'I'm building a Next.js app with Stripe and auth'), returns a prose recommendation explaining which Skills genuinely fit and why. Tiered freemium quota — Free 3/day, Pro 10/day, Max 30/day — enforced server-side. Use this when the user asks 'what Skills should I install for X?' or 'help me pick Skills for my project'.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task: {
+                    type: 'string',
+                    description: "The user's task / context. Min 8 chars. Omit to run in auto mode.",
+                },
+                auto: {
+                    type: 'boolean',
+                    description: "When true, ignore `task` and synthesise context from the user's installed Skills + recent usage.",
+                },
+            },
+        },
+    },
 ];
 export async function mcpServerCommand() {
     // Auth check up-front. If the user runs `prave mcp-server` without
@@ -96,6 +113,8 @@ export async function mcpServerCommand() {
                     return await handleAuditLibrary();
                 case 'prave_install_skill':
                     return await handleInstallSkill(args);
+                case 'prave_advisor':
+                    return await handleAdvisor(args);
                 default:
                     return mcpError(`Unknown tool: ${name}`);
             }
@@ -202,6 +221,27 @@ async function handleInstallSkill(args) {
         });
     });
 }
+async function handleAdvisor(args) {
+    const mode = args.auto ? 'auto' : 'manual';
+    if (mode === 'manual' && (!args.task || args.task.trim().length < 8)) {
+        return mcpError("Pass a `task` of at least 8 characters describing what the user is building, or set `auto: true` to use their installed Skills as context.");
+    }
+    const { data } = await api.post('/api/v1/advisor', { mode, task: mode === 'manual' ? args.task : undefined }, true);
+    const lines = [data.prose, ''];
+    if (data.recommendations.length === 0) {
+        lines.push('(No specific Skills recommended for this context.)');
+    }
+    else {
+        for (const rec of data.recommendations) {
+            lines.push(`• ${rec.slug}`);
+            lines.push(`  Why: ${rec.reason}`);
+            lines.push(`  Install: prave install ${rec.slug}`);
+        }
+    }
+    lines.push('');
+    lines.push(`Advisor quota: ${data.quota.used} / ${data.quota.limit} today on the ${data.quota.plan} plan.`);
+    return mcpText(lines.join('\n'));
+}
 /* ─── helpers ──────────────────────────────────────────────────── */
 function mcpText(text) {
     return { content: [{ type: 'text', text }] };

package/dist/index.js

@@ -5,6 +5,7 @@ import { fileURLToPath } from 'node:url';
 import { Command } from 'commander';
 import { conflictsCommand } from './commands/conflicts.js';
 import { diffCommand } from './commands/diff.js';
+import { advisorCommand } from './commands/advisor.js';
 import { docsCommand } from './commands/docs.js';
 import { hooksAuditCommand, hooksInstallCommand, hooksListCommand, hooksRemoveCommand, hooksSyncCommand, hooksUpdateCommand, } from './commands/hooks.js';
 import { importCommand } from './commands/import.js';
@@ -110,6 +111,11 @@ program
     .command('whatdoes <skillname>')
     .description("Inspect a skill's triggers, tokens, conflicts")
     .action(whatdoesCommand);
+program
+    .command('advisor [task...]')
+    .description('Prose recommendation from the contextual Skill advisor — pass a task description, or use --auto to base it on your installed Skills.')
+    .option('--auto', 'use your installed Skills + recent usage as context (no task argument)')
+    .action((taskWords, opts) => advisorCommand(taskWords.length ? taskWords.join(' ') : undefined, opts));
 program
     .command('overview')
     .description('Summary of your skill set, conflicts, and token cost')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prave/cli",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Prave CLI — discover, install, version, test, and ship Claude Skills. The developer platform for the complete Skill lifecycle.",
   "type": "module",
   "keywords": [
@@ -54,7 +54,7 @@
     "ora": "^8.0.1",
     "tar": "^7.4.3",
     "undici": "^6.18.0",
-    "@prave/shared": "1.5.0"
+    "@prave/shared": "1.5.1"
   },
   "devDependencies": {
     "@types/node": "^20.12.7",