@codebakers/cli 2.7.0 → 2.9.0

package/dist/commands/push-patterns.d.ts

@@ -0,0 +1,15 @@
+interface PushOptions {
+    version: string;
+    changelog?: string;
+    autoPublish?: boolean;
+    sourcePath?: string;
+}
+/**
+ * Push patterns to the server via admin API
+ */
+export declare function pushPatterns(options: PushOptions): Promise<void>;
+/**
+ * Interactive push command
+ */
+export declare function pushPatternsInteractive(): Promise<void>;
+export {};

package/dist/commands/push-patterns.js

@@ -0,0 +1,186 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pushPatterns = pushPatterns;
+exports.pushPatternsInteractive = pushPatternsInteractive;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const readline_1 = require("readline");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_js_1 = require("../config.js");
+function prompt(question) {
+    const rl = (0, readline_1.createInterface)({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Read all module files from a directory
+ */
+function readModulesFromDir(dirPath) {
+    const modules = {};
+    if (!(0, fs_1.existsSync)(dirPath)) {
+        return modules;
+    }
+    const files = (0, fs_1.readdirSync)(dirPath).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+        const filePath = (0, path_1.join)(dirPath, file);
+        const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+        const moduleName = (0, path_1.basename)(file, '.md');
+        modules[moduleName] = content;
+    }
+    return modules;
+}
+/**
+ * Push patterns to the server via admin API
+ */
+async function pushPatterns(options) {
+    console.log(chalk_1.default.blue('\n  CodeBakers Push Patterns\n'));
+    const sourcePath = options.sourcePath || process.cwd();
+    // Check for API key - first from config, then from environment
+    const apiKey = (0, config_js_1.getApiKey)() || process.env.CODEBAKERS_ADMIN_KEY;
+    if (!apiKey) {
+        console.log(chalk_1.default.red('  ✗ No API key found\n'));
+        console.log(chalk_1.default.gray('  Either:'));
+        console.log(chalk_1.default.cyan('    1. Run `codebakers setup` to configure your API key'));
+        console.log(chalk_1.default.cyan('    2. Set CODEBAKERS_ADMIN_KEY environment variable\n'));
+        process.exit(1);
+    }
+    // Read main files
+    const claudeMdPath = (0, path_1.join)(sourcePath, 'CLAUDE.md');
+    const cursorRulesPath = (0, path_1.join)(sourcePath, '.cursorrules');
+    let claudeMdContent = null;
+    let cursorRulesContent = null;
+    if ((0, fs_1.existsSync)(claudeMdPath)) {
+        claudeMdContent = (0, fs_1.readFileSync)(claudeMdPath, 'utf-8');
+        console.log(chalk_1.default.green(`  ✓ Found CLAUDE.md (${(claudeMdContent.length / 1024).toFixed(1)} KB)`));
+    }
+    else {
+        console.log(chalk_1.default.yellow(`  ⚠ CLAUDE.md not found at ${claudeMdPath}`));
+    }
+    if ((0, fs_1.existsSync)(cursorRulesPath)) {
+        cursorRulesContent = (0, fs_1.readFileSync)(cursorRulesPath, 'utf-8');
+        console.log(chalk_1.default.green(`  ✓ Found .cursorrules (${(cursorRulesContent.length / 1024).toFixed(1)} KB)`));
+    }
+    else {
+        console.log(chalk_1.default.yellow(`  ⚠ .cursorrules not found at ${cursorRulesPath}`));
+    }
+    if (!claudeMdContent && !cursorRulesContent) {
+        console.log(chalk_1.default.red('\n  ✗ No pattern files found. Nothing to push.\n'));
+        process.exit(1);
+    }
+    // Read module directories
+    const claudeModulesPath = (0, path_1.join)(sourcePath, '.claude');
+    const cursorModulesPath = (0, path_1.join)(sourcePath, '.cursorrules-modules');
+    const modulesContent = readModulesFromDir(claudeModulesPath);
+    const cursorModulesContent = readModulesFromDir(cursorModulesPath);
+    const claudeModuleCount = Object.keys(modulesContent).length;
+    const cursorModuleCount = Object.keys(cursorModulesContent).length;
+    if (claudeModuleCount > 0) {
+        console.log(chalk_1.default.green(`  ✓ Found ${claudeModuleCount} Claude modules in .claude/`));
+    }
+    if (cursorModuleCount > 0) {
+        console.log(chalk_1.default.green(`  ✓ Found ${cursorModuleCount} Cursor modules in .cursorrules-modules/`));
+    }
+    console.log('');
+    // Show summary
+    console.log(chalk_1.default.white('  Push Summary:\n'));
+    console.log(chalk_1.default.gray(`    Version:      ${chalk_1.default.cyan(options.version)}`));
+    console.log(chalk_1.default.gray(`    Auto-publish: ${options.autoPublish ? chalk_1.default.green('Yes') : chalk_1.default.yellow('No')}`));
+    if (options.changelog) {
+        console.log(chalk_1.default.gray(`    Changelog:    ${chalk_1.default.dim(options.changelog.slice(0, 60))}...`));
+    }
+    console.log('');
+    // Files to upload
+    console.log(chalk_1.default.white('  Files to upload:\n'));
+    if (claudeMdContent)
+        console.log(chalk_1.default.cyan('    • CLAUDE.md'));
+    if (cursorRulesContent)
+        console.log(chalk_1.default.cyan('    • .cursorrules'));
+    for (const mod of Object.keys(modulesContent)) {
+        console.log(chalk_1.default.dim(`    • .claude/${mod}.md`));
+    }
+    for (const mod of Object.keys(cursorModulesContent)) {
+        console.log(chalk_1.default.dim(`    • .cursorrules-modules/${mod}.md`));
+    }
+    console.log('');
+    // Confirm
+    const confirm = await prompt(chalk_1.default.gray('  Push these patterns? (y/N): '));
+    if (confirm.toLowerCase() !== 'y') {
+        console.log(chalk_1.default.gray('\n  Cancelled.\n'));
+        process.exit(0);
+    }
+    // Push to server
+    const spinner = (0, ora_1.default)('Pushing patterns to server...').start();
+    try {
+        const apiUrl = (0, config_js_1.getApiUrl)();
+        const response = await fetch(`${apiUrl}/api/admin/content/push`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                version: options.version,
+                claudeMdContent,
+                cursorRulesContent,
+                modulesContent: claudeModuleCount > 0 ? modulesContent : undefined,
+                cursorModulesContent: cursorModuleCount > 0 ? cursorModulesContent : undefined,
+                changelog: options.changelog,
+                autoPublish: options.autoPublish,
+            }),
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            spinner.fail(chalk_1.default.red(`Push failed: ${data.error || 'Unknown error'}`));
+            process.exit(1);
+        }
+        spinner.succeed(chalk_1.default.green('Patterns pushed successfully!'));
+        console.log(chalk_1.default.white('\n  Result:\n'));
+        console.log(chalk_1.default.gray(`    Version ID:  ${chalk_1.default.cyan(data.version?.id || 'N/A')}`));
+        console.log(chalk_1.default.gray(`    Version:     ${chalk_1.default.cyan(data.version?.version || options.version)}`));
+        console.log(chalk_1.default.gray(`    Published:   ${data.published ? chalk_1.default.green('Yes') : chalk_1.default.yellow('No - run publish manually')}`));
+        console.log('');
+        console.log(chalk_1.default.green(`  ${data.message}\n`));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red('Failed to connect to server'));
+        console.log(chalk_1.default.gray(`\n  Error: ${error instanceof Error ? error.message : 'Unknown error'}\n`));
+        process.exit(1);
+    }
+}
+/**
+ * Interactive push command
+ */
+async function pushPatternsInteractive() {
+    console.log(chalk_1.default.blue('\n  CodeBakers Push Patterns\n'));
+    // Get version
+    const version = await prompt(chalk_1.default.cyan('  Version (e.g., 4.5): '));
+    if (!version) {
+        console.log(chalk_1.default.red('\n  Version is required.\n'));
+        process.exit(1);
+    }
+    // Get changelog
+    const changelog = await prompt(chalk_1.default.cyan('  Changelog (optional): '));
+    // Ask about auto-publish
+    const autoPublishAnswer = await prompt(chalk_1.default.cyan('  Auto-publish? (y/N): '));
+    const autoPublish = autoPublishAnswer.toLowerCase() === 'y';
+    // Get source path
+    const sourcePathAnswer = await prompt(chalk_1.default.cyan('  Source path (Enter for current directory): '));
+    const sourcePath = sourcePathAnswer || process.cwd();
+    await pushPatterns({
+        version,
+        changelog: changelog || undefined,
+        autoPublish,
+        sourcePath,
+    });
+}

package/dist/commands/setup.js

@@ -10,6 +10,7 @@ const readline_1 = require("readline");
 const child_process_1 = require("child_process");
 const config_js_1 = require("../config.js");
 const api_js_1 = require("../lib/api.js");
+const progress_js_1 = require("../lib/progress.js");
 function prompt(question) {
     const rl = (0, readline_1.createInterface)({
         input: process.stdin,
@@ -62,8 +63,18 @@ async function setup() {
     }
     catch (error) {
         spinner.fail('Invalid API key');
-        if (error && typeof error === 'object' && 'recoverySteps' in error) {
-            console.log(chalk_1.default.red(`\n  ${(0, api_js_1.formatApiError)(error)}\n`));
+        // Use friendly error formatting
+        if (error && typeof error === 'object' && 'code' in error) {
+            const code = error.code;
+            if (code === 'NETWORK_ERROR') {
+                console.log((0, progress_js_1.formatFriendlyError)((0, progress_js_1.getNetworkError)()));
+            }
+            else if (code === 'UNAUTHORIZED' || code === 'INVALID_FORMAT') {
+                console.log((0, progress_js_1.formatFriendlyError)((0, progress_js_1.getAuthError)()));
+            }
+            else if ('recoverySteps' in error) {
+                console.log(chalk_1.default.red(`\n  ${(0, api_js_1.formatApiError)(error)}\n`));
+            }
         }
         else {
             const message = error instanceof Error ? error.message : 'API key validation failed';

package/dist/index.js

@@ -22,6 +22,7 @@ const upgrade_js_1 = require("./commands/upgrade.js");
 const config_js_1 = require("./commands/config.js");
 const audit_js_1 = require("./commands/audit.js");
 const heal_js_1 = require("./commands/heal.js");
+const push_patterns_js_1 = require("./commands/push-patterns.js");
 // Show welcome message when no command is provided
 function showWelcome() {
     console.log(chalk_1.default.blue(`
@@ -63,7 +64,7 @@ const program = new commander_1.Command();
 program
     .name('codebakers')
     .description('CodeBakers CLI - Production patterns for AI-assisted development')
-    .version('1.7.0');
+    .version('2.9.0');
 // Primary command - one-time setup
 program
     .command('setup')
@@ -142,6 +143,27 @@ program
         });
     }
 });
+// Admin commands
+program
+    .command('push-patterns')
+    .description('Push pattern files to the server (admin only)')
+    .option('-v, --version <version>', 'Version number (e.g., 4.5)')
+    .option('-c, --changelog <message>', 'Changelog message')
+    .option('-p, --publish', 'Auto-publish after push')
+    .option('-s, --source <path>', 'Source directory (default: current directory)')
+    .action(async (options) => {
+    if (options.version) {
+        await (0, push_patterns_js_1.pushPatterns)({
+            version: options.version,
+            changelog: options.changelog,
+            autoPublish: options.publish,
+            sourcePath: options.source,
+        });
+    }
+    else {
+        await (0, push_patterns_js_1.pushPatternsInteractive)();
+    }
+});
 // MCP Server commands
 program
     .command('serve')

package/dist/lib/progress.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Multi-step progress tracker for CLI operations
+ */
+export interface Step {
+    name: string;
+    action: () => Promise<void>;
+}
+export declare class ProgressTracker {
+    private currentStep;
+    private totalSteps;
+    private steps;
+    private spinner;
+    constructor(steps: Step[]);
+    run(): Promise<void>;
+    private formatPrefix;
+    private formatStepText;
+}
+/**
+ * Show a success box after completing a command
+ */
+export declare function showSuccessBox(title: string, lines: string[]): void;
+/**
+ * Display a quick start guide with examples
+ */
+export declare function showQuickStartGuide(): void;
+/**
+ * Format user-friendly error with context and recovery steps
+ */
+export interface FriendlyError {
+    title: string;
+    message: string;
+    cause?: string;
+    recovery: string[];
+    helpUrl?: string;
+}
+export declare function formatFriendlyError(error: FriendlyError): string;
+/**
+ * Common error handlers with friendly messages
+ */
+export declare function getNetworkError(): FriendlyError;
+export declare function getAuthError(): FriendlyError;
+export declare function getSubscriptionError(): FriendlyError;

package/dist/lib/progress.js

@@ -0,0 +1,160 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressTracker = void 0;
+exports.showSuccessBox = showSuccessBox;
+exports.showQuickStartGuide = showQuickStartGuide;
+exports.formatFriendlyError = formatFriendlyError;
+exports.getNetworkError = getNetworkError;
+exports.getAuthError = getAuthError;
+exports.getSubscriptionError = getSubscriptionError;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+class ProgressTracker {
+    currentStep = 0;
+    totalSteps;
+    steps;
+    spinner = null;
+    constructor(steps) {
+        this.steps = steps;
+        this.totalSteps = steps.length;
+    }
+    async run() {
+        for (let i = 0; i < this.steps.length; i++) {
+            this.currentStep = i + 1;
+            const step = this.steps[i];
+            this.spinner = (0, ora_1.default)({
+                text: this.formatStepText(step.name),
+                prefixText: this.formatPrefix(),
+            }).start();
+            try {
+                await step.action();
+                this.spinner.succeed(this.formatStepText(step.name));
+            }
+            catch (error) {
+                this.spinner.fail(this.formatStepText(step.name));
+                throw error;
+            }
+        }
+    }
+    formatPrefix() {
+        return chalk_1.default.gray(`  [${this.currentStep}/${this.totalSteps}]`);
+    }
+    formatStepText(text) {
+        return text;
+    }
+}
+exports.ProgressTracker = ProgressTracker;
+/**
+ * Show a success box after completing a command
+ */
+function showSuccessBox(title, lines) {
+    const maxLength = Math.max(title.length, ...lines.map(l => l.length)) + 4;
+    const border = '═'.repeat(maxLength);
+    console.log(chalk_1.default.green(`\n  ╔${border}╗`));
+    console.log(chalk_1.default.green(`  ║`) + chalk_1.default.bold.white(` ${title.padEnd(maxLength - 2)} `) + chalk_1.default.green(`║`));
+    console.log(chalk_1.default.green(`  ╠${border}╣`));
+    for (const line of lines) {
+        console.log(chalk_1.default.green(`  ║`) + chalk_1.default.white(` ${line.padEnd(maxLength - 2)} `) + chalk_1.default.green(`║`));
+    }
+    console.log(chalk_1.default.green(`  ╚${border}╝\n`));
+}
+/**
+ * Display a quick start guide with examples
+ */
+function showQuickStartGuide() {
+    console.log(chalk_1.default.blue('\n  ═══════════════════════════════════════════════════════════'));
+    console.log(chalk_1.default.bold.white('\n  📚 Quick Start Guide\n'));
+    console.log(chalk_1.default.blue('  ═══════════════════════════════════════════════════════════\n'));
+    console.log(chalk_1.default.white('  Just ask the AI in natural language:\n'));
+    const examples = [
+        {
+            prompt: '"Build me a user dashboard with stats cards"',
+            desc: 'AI will use CodeBakers patterns for layout, components, and data fetching',
+        },
+        {
+            prompt: '"Add Stripe subscription to my app"',
+            desc: 'AI loads payment patterns: checkout, webhooks, customer portal',
+        },
+        {
+            prompt: '"Create an API endpoint for user profiles"',
+            desc: 'AI generates: route handler, validation, error handling, types',
+        },
+        {
+            prompt: '"Set up auth with Google and email login"',
+            desc: 'AI implements OAuth + email auth following security patterns',
+        },
+    ];
+    for (const example of examples) {
+        console.log(chalk_1.default.cyan(`  → ${example.prompt}`));
+        console.log(chalk_1.default.gray(`    ${example.desc}\n`));
+    }
+    console.log(chalk_1.default.blue('  ───────────────────────────────────────────────────────────\n'));
+    console.log(chalk_1.default.white('  Pro Tips:\n'));
+    console.log(chalk_1.default.gray('  • Ask the AI ') + chalk_1.default.cyan('"What patterns do you have for payments?"'));
+    console.log(chalk_1.default.gray('  • Say ') + chalk_1.default.cyan('"/build a SaaS app"') + chalk_1.default.gray(' to start a full project'));
+    console.log(chalk_1.default.gray('  • Try ') + chalk_1.default.cyan('"/audit"') + chalk_1.default.gray(' to check code quality'));
+    console.log(chalk_1.default.gray('  • Use ') + chalk_1.default.cyan('"codebakers doctor"') + chalk_1.default.gray(' if something seems wrong\n'));
+    console.log(chalk_1.default.blue('  ═══════════════════════════════════════════════════════════\n'));
+}
+function formatFriendlyError(error) {
+    let output = '';
+    output += chalk_1.default.red(`\n  ❌ ${error.title}\n`);
+    output += chalk_1.default.white(`\n  ${error.message}\n`);
+    if (error.cause) {
+        output += chalk_1.default.gray(`\n  Why: ${error.cause}\n`);
+    }
+    if (error.recovery.length > 0) {
+        output += chalk_1.default.yellow(`\n  How to fix:\n`);
+        for (let i = 0; i < error.recovery.length; i++) {
+            output += chalk_1.default.white(`    ${i + 1}. ${error.recovery[i]}\n`);
+        }
+    }
+    if (error.helpUrl) {
+        output += chalk_1.default.gray(`\n  More help: ${error.helpUrl}\n`);
+    }
+    return output;
+}
+/**
+ * Common error handlers with friendly messages
+ */
+function getNetworkError() {
+    return {
+        title: 'Connection Failed',
+        message: 'Could not connect to CodeBakers servers.',
+        cause: 'This usually means a network issue or the server is temporarily unavailable.',
+        recovery: [
+            'Check your internet connection',
+            'Try again in a few seconds',
+            'If using a VPN, try disabling it temporarily',
+            'Check status.codebakers.ai for server status',
+        ],
+        helpUrl: 'https://codebakers.ai/docs/troubleshooting',
+    };
+}
+function getAuthError() {
+    return {
+        title: 'Authentication Failed',
+        message: 'Your API key is invalid or expired.',
+        recovery: [
+            'Go to codebakers.ai/dashboard',
+            'Copy your API key (starts with cb_)',
+            'Run: codebakers setup',
+        ],
+        helpUrl: 'https://codebakers.ai/docs/getting-started',
+    };
+}
+function getSubscriptionError() {
+    return {
+        title: 'Subscription Required',
+        message: 'This feature requires an active subscription.',
+        recovery: [
+            'Visit codebakers.ai/pricing to see plans',
+            'Start a free trial with: codebakers setup',
+            'Contact support if you believe this is an error',
+        ],
+        helpUrl: 'https://codebakers.ai/pricing',
+    };
+}