@codebakers/cli 1.5.0 → 2.0.0

package/src/config.ts

@@ -1,34 +1,144 @@
 import Conf from 'conf';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
 
 export type ExperienceLevel = 'beginner' | 'intermediate' | 'advanced';
 
-interface ServiceKeys {
-  github: string | null;
-  supabase: string | null;
-  vercel: string | null;
-}
+/**
+ * Canonical list of ALL supported service keys
+ * This must match the server contract at src/lib/contracts/service-keys.ts
+ */
+export const SERVICE_KEYS = [
+  // Infrastructure (provisioning-capable)
+  'github',
+  'supabase',
+  'vercel',
+  // AI
+  'openai',
+  'anthropic',
+  // Payments
+  'stripe',
+  // Communication
+  'twilio_sid',
+  'twilio_auth',
+  'resend',
+  'vapi',
+  // Monitoring
+  'sentry',
+  // Media
+  'cloudinary',
+  'pexels',
+  'midjourney',
+] as const;
+
+export type ServiceName = typeof SERVICE_KEYS[number];
+
+/**
+ * Map service key names to environment variable names
+ */
+export const ENV_VAR_NAMES: Record<ServiceName, string> = {
+  github: 'GITHUB_TOKEN',
+  supabase: 'SUPABASE_ACCESS_TOKEN',
+  vercel: 'VERCEL_TOKEN',
+  openai: 'OPENAI_API_KEY',
+  anthropic: 'ANTHROPIC_API_KEY',
+  stripe: 'STRIPE_SECRET_KEY',
+  twilio_sid: 'TWILIO_ACCOUNT_SID',
+  twilio_auth: 'TWILIO_AUTH_TOKEN',
+  resend: 'RESEND_API_KEY',
+  vapi: 'VAPI_API_KEY',
+  sentry: 'SENTRY_DSN',
+  cloudinary: 'CLOUDINARY_API_SECRET',
+  pexels: 'PEXELS_API_KEY',
+  midjourney: 'MIDJOURNEY_API_KEY',
+};
+
+/**
+ * Service key categories for display grouping
+ */
+export const SERVICE_KEY_CATEGORIES: Record<string, ServiceName[]> = {
+  infrastructure: ['github', 'supabase', 'vercel'],
+  ai: ['openai', 'anthropic'],
+  payments: ['stripe'],
+  communication: ['twilio_sid', 'twilio_auth', 'resend', 'vapi'],
+  monitoring: ['sentry'],
+  media: ['cloudinary', 'pexels', 'midjourney'],
+};
+
+/**
+ * Service key labels for display
+ */
+export const SERVICE_KEY_LABELS: Record<ServiceName, string> = {
+  github: 'GitHub',
+  supabase: 'Supabase',
+  vercel: 'Vercel',
+  openai: 'OpenAI',
+  anthropic: 'Anthropic',
+  stripe: 'Stripe',
+  twilio_sid: 'Twilio SID',
+  twilio_auth: 'Twilio Auth',
+  resend: 'Resend',
+  vapi: 'VAPI',
+  sentry: 'Sentry',
+  cloudinary: 'Cloudinary',
+  pexels: 'Pexels',
+  midjourney: 'Midjourney',
+};
+
+/**
+ * Keys that can be used for auto-provisioning
+ */
+export const PROVISIONABLE_KEYS: ServiceName[] = ['github', 'supabase', 'vercel'];
+
+type ServiceKeys = {
+  [K in ServiceName]: string | null;
+};
 
 interface ConfigSchema {
   apiKey: string | null;
   apiUrl: string;
   experienceLevel: ExperienceLevel;
   serviceKeys: ServiceKeys;
+  lastKeySync: string | null;  // ISO date of last sync with server
 }
 
+// Create default service keys object with all keys set to null
+const defaultServiceKeys: ServiceKeys = Object.fromEntries(
+  SERVICE_KEYS.map(key => [key, null])
+) as ServiceKeys;
+
 const config = new Conf<ConfigSchema>({
   projectName: 'codebakers',
+  projectVersion: '1.7.0',
   defaults: {
     apiKey: null,
     apiUrl: 'https://codebakers.ai',
     experienceLevel: 'intermediate',
-    serviceKeys: {
-      github: null,
-      supabase: null,
-      vercel: null,
+    serviceKeys: defaultServiceKeys,
+    lastKeySync: null,
+  },
+  // Migration to add new keys when upgrading from old version
+  migrations: {
+    '1.7.0': (store) => {
+      const oldKeys = store.get('serviceKeys') as Partial<ServiceKeys>;
+      const newKeys: ServiceKeys = { ...defaultServiceKeys };
+
+      // Preserve existing keys
+      for (const key of SERVICE_KEYS) {
+        if (oldKeys && key in oldKeys && oldKeys[key]) {
+          newKeys[key] = oldKeys[key] as string;
+        }
+      }
+
+      store.set('serviceKeys', newKeys);
     },
   },
 });
 
+// ============================================================
+// API Key Management
+// ============================================================
+
 export function getApiKey(): string | null {
   return config.get('apiKey');
 }
@@ -49,6 +159,10 @@ export function setApiUrl(url: string): void {
   config.set('apiUrl', url);
 }
 
+// ============================================================
+// Experience Level
+// ============================================================
+
 export function getExperienceLevel(): ExperienceLevel {
   return config.get('experienceLevel');
 }
@@ -57,12 +171,13 @@ export function setExperienceLevel(level: ExperienceLevel): void {
   config.set('experienceLevel', level);
 }
 
+// ============================================================
 // Service API Keys
-export type ServiceName = 'github' | 'supabase' | 'vercel';
+// ============================================================
 
 export function getServiceKey(service: ServiceName): string | null {
   const keys = config.get('serviceKeys');
-  return keys[service];
+  return keys[service] ?? null;
 }
 
 export function setServiceKey(service: ServiceName, key: string): void {
@@ -77,6 +192,200 @@ export function clearServiceKey(service: ServiceName): void {
   config.set('serviceKeys', keys);
 }
 
+export function clearAllServiceKeys(): void {
+  config.set('serviceKeys', { ...defaultServiceKeys });
+  config.set('lastKeySync', null);
+}
+
 export function getAllServiceKeys(): ServiceKeys {
   return config.get('serviceKeys');
 }
+
+export function getConfiguredServiceKeys(): ServiceName[] {
+  const keys = config.get('serviceKeys');
+  return SERVICE_KEYS.filter(name => keys[name] !== null && keys[name] !== '');
+}
+
+export function getLastKeySync(): Date | null {
+  const lastSync = config.get('lastKeySync');
+  return lastSync ? new Date(lastSync) : null;
+}
+
+export function setLastKeySync(date: Date): void {
+  config.set('lastKeySync', date.toISOString());
+}
+
+// ============================================================
+// Bulk Key Operations
+// ============================================================
+
+export interface SyncResult {
+  added: ServiceName[];
+  updated: ServiceName[];
+  unchanged: ServiceName[];
+  total: number;
+}
+
+/**
+ * Sync keys from server response to local storage
+ */
+export function syncServiceKeys(serverKeys: Partial<ServiceKeys>): SyncResult {
+  const localKeys = config.get('serviceKeys');
+  const result: SyncResult = {
+    added: [],
+    updated: [],
+    unchanged: [],
+    total: 0,
+  };
+
+  for (const keyName of SERVICE_KEYS) {
+    const serverValue = serverKeys[keyName];
+    const localValue = localKeys[keyName];
+
+    if (serverValue) {
+      result.total++;
+
+      if (!localValue) {
+        result.added.push(keyName);
+        localKeys[keyName] = serverValue;
+      } else if (localValue !== serverValue) {
+        result.updated.push(keyName);
+        localKeys[keyName] = serverValue;
+      } else {
+        result.unchanged.push(keyName);
+      }
+    }
+  }
+
+  config.set('serviceKeys', localKeys);
+  config.set('lastKeySync', new Date().toISOString());
+
+  return result;
+}
+
+// ============================================================
+// Environment File Operations
+// ============================================================
+
+/**
+ * Write service keys to a .env.local file
+ */
+export function writeKeysToEnvFile(projectPath: string, options?: {
+  includeEmpty?: boolean;
+  additionalVars?: Record<string, string>;
+}): { written: number; path: string } {
+  const envPath = join(projectPath, '.env.local');
+  const keys = config.get('serviceKeys');
+  const lines: string[] = [];
+
+  // Header
+  lines.push('# Service Keys - Generated by CodeBakers CLI');
+  lines.push(`# Generated: ${new Date().toISOString()}`);
+  lines.push('');
+
+  // Add additional vars first (like Supabase URL, etc.)
+  if (options?.additionalVars) {
+    lines.push('# Project Configuration');
+    for (const [name, value] of Object.entries(options.additionalVars)) {
+      lines.push(`${name}=${value}`);
+    }
+    lines.push('');
+  }
+
+  // Group keys by category
+  for (const [category, keyNames] of Object.entries(SERVICE_KEY_CATEGORIES)) {
+    const categoryLines: string[] = [];
+
+    for (const keyName of keyNames) {
+      const value = keys[keyName];
+      const envVarName = ENV_VAR_NAMES[keyName];
+
+      if (value) {
+        categoryLines.push(`${envVarName}=${value}`);
+      } else if (options?.includeEmpty) {
+        categoryLines.push(`# ${envVarName}=`);
+      }
+    }
+
+    if (categoryLines.length > 0) {
+      lines.push(`# ${category.charAt(0).toUpperCase() + category.slice(1)}`);
+      lines.push(...categoryLines);
+      lines.push('');
+    }
+  }
+
+  // Read existing .env.local and preserve non-CodeBakers variables
+  let existingContent = '';
+  if (existsSync(envPath)) {
+    existingContent = readFileSync(envPath, 'utf-8');
+
+    // Extract lines that aren't CodeBakers-managed
+    const existingLines = existingContent.split('\n');
+    const preservedLines: string[] = [];
+    let inCodeBakersSection = false;
+
+    for (const line of existingLines) {
+      if (line.includes('Generated by CodeBakers CLI')) {
+        inCodeBakersSection = true;
+        continue;
+      }
+
+      // Check if line is a CodeBakers-managed env var
+      const isCodeBakersVar = Object.values(ENV_VAR_NAMES).some(
+        envName => line.startsWith(`${envName}=`) || line.startsWith(`# ${envName}=`)
+      );
+
+      if (!isCodeBakersVar && !inCodeBakersSection && line.trim()) {
+        preservedLines.push(line);
+      }
+    }
+
+    // Add preserved lines at the end
+    if (preservedLines.length > 0) {
+      lines.push('# Existing Configuration');
+      lines.push(...preservedLines);
+    }
+  }
+
+  const content = lines.join('\n');
+  writeFileSync(envPath, content);
+
+  const written = Object.values(keys).filter(v => v !== null).length;
+  return { written, path: envPath };
+}
+
+/**
+ * Check if a key value appears valid (basic format check)
+ */
+export function validateKeyFormat(name: ServiceName, value: string): boolean {
+  if (!value || value.length < 8) return false;
+
+  const prefixes: Partial<Record<ServiceName, string[]>> = {
+    github: ['ghp_', 'gho_', 'ghu_', 'ghs_', 'ghr_'],
+    openai: ['sk-'],
+    anthropic: ['sk-ant-'],
+    stripe: ['sk_live_', 'sk_test_', 'rk_live_', 'rk_test_'],
+    twilio_sid: ['AC'],
+    resend: ['re_'],
+    supabase: ['sbp_'],
+  };
+
+  const validPrefixes = prefixes[name];
+  if (validPrefixes) {
+    return validPrefixes.some(prefix => value.startsWith(prefix));
+  }
+
+  return true; // No specific format required
+}
+
+// ============================================================
+// Config Path (for debugging)
+// ============================================================
+
+export function getConfigPath(): string {
+  return config.path;
+}
+
+export function getConfigStore(): ConfigSchema {
+  return config.store;
+}

package/src/index.ts

@@ -14,6 +14,10 @@ import { mcpConfig, mcpUninstall } from './commands/mcp-config.js';
 import { setup } from './commands/setup.js';
 import { scaffold } from './commands/scaffold.js';
 import { generate } from './commands/generate.js';
+import { upgrade } from './commands/upgrade.js';
+import { config } from './commands/config.js';
+import { audit } from './commands/audit.js';
+import { heal, healWatch } from './commands/heal.js';
 
 // Show welcome message when no command is provided
 function showWelcome(): void {
@@ -34,7 +38,9 @@ function showWelcome(): void {
 
   console.log(chalk.white('  Development:\n'));
   console.log(chalk.cyan('    codebakers generate') + chalk.gray('   Generate components, APIs, services'));
-  console.log(chalk.cyan('    codebakers status') + chalk.gray('     Check what\'s installed\n'));
+  console.log(chalk.cyan('    codebakers upgrade') + chalk.gray('    Update patterns to latest version'));
+  console.log(chalk.cyan('    codebakers status') + chalk.gray('     Check what\'s installed'));
+  console.log(chalk.cyan('    codebakers config') + chalk.gray('     View or modify configuration\n'));
 
   console.log(chalk.white('  Examples:\n'));
   console.log(chalk.gray('    $ ') + chalk.cyan('codebakers scaffold'));
@@ -44,8 +50,13 @@ function showWelcome(): void {
   console.log(chalk.gray('    $ ') + chalk.cyan('codebakers g api users'));
   console.log(chalk.gray('      Generate a Next.js API route with validation\n'));
 
+  console.log(chalk.white('  Quality:\n'));
+  console.log(chalk.cyan('    codebakers audit') + chalk.gray('      Run automated code quality checks'));
+  console.log(chalk.cyan('    codebakers heal') + chalk.gray('       Auto-detect and fix common issues'));
+  console.log(chalk.cyan('    codebakers doctor') + chalk.gray('     Check CodeBakers setup\n'));
+
   console.log(chalk.white('  All Commands:\n'));
-  console.log(chalk.gray('    setup, scaffold, init, generate, status, doctor, login'));
+  console.log(chalk.gray('    setup, scaffold, init, generate, upgrade, status, audit, heal, doctor, config, login'));
   console.log(chalk.gray('    install, uninstall, install-hook, uninstall-hook'));
   console.log(chalk.gray('    serve, mcp-config, mcp-uninstall\n'));
 
@@ -57,7 +68,7 @@ const program = new Command();
 program
   .name('codebakers')
   .description('CodeBakers CLI - Production patterns for AI-assisted development')
-  .version('1.5.0');
+  .version('1.7.0');
 
 // Primary command - one-time setup
 program
@@ -82,6 +93,16 @@ program
   .description('Generate code from templates (component, api, service, hook, page, schema, form)')
   .action((type, name) => generate({ type, name }));
 
+program
+  .command('upgrade')
+  .description('Update patterns to the latest version')
+  .action(upgrade);
+
+program
+  .command('config [action]')
+  .description('View or modify CLI configuration (show, path, keys, clear-keys, set-url, reset)')
+  .action((action) => config(action));
+
 program
   .command('login')
   .description('Login with your API key')
@@ -117,6 +138,30 @@ program
   .description('Check if CodeBakers is set up correctly')
   .action(doctor);
 
+program
+  .command('audit')
+  .description('Run automated code quality and security checks')
+  .action(async () => { await audit(); });
+
+program
+  .command('heal')
+  .description('Auto-detect and fix common issues (TypeScript, deps, security)')
+  .option('--auto', 'Automatically apply safe fixes')
+  .option('--watch', 'Watch mode - continuously monitor and fix')
+  .option('--dry-run', 'Show what would be fixed without applying')
+  .option('--severity <level>', 'Filter by severity (critical, high, medium, low)')
+  .action(async (options) => {
+    if (options.watch) {
+      await healWatch();
+    } else {
+      await heal({
+        auto: options.auto,
+        dryRun: options.dryRun,
+        severity: options.severity
+      });
+    }
+  });
+
 // MCP Server commands
 program
   .command('serve')

package/src/lib/api.ts

@@ -0,0 +1,183 @@
+import { getApiUrl } from '../config.js';
+
+/**
+ * API client utilities for CodeBakers CLI
+ * This is the single source of truth for API validation and error handling
+ */
+
+export interface ApiError {
+  error: string;
+  code?: string;
+  recoverySteps?: string[];
+}
+
+/**
+ * Validate an API key format
+ */
+export function isValidApiKeyFormat(apiKey: string): boolean {
+  if (!apiKey || typeof apiKey !== 'string') return false;
+  // Keys should start with cb_ and be at least 20 characters
+  return apiKey.startsWith('cb_') && apiKey.length >= 20;
+}
+
+/**
+ * Validate an API key against the server
+ * Returns true if valid, throws an ApiError if not
+ */
+export async function validateApiKey(apiKey: string): Promise<boolean> {
+  // First check format
+  if (!isValidApiKeyFormat(apiKey)) {
+    throw createApiError('Invalid API key format. Keys start with "cb_"', 'INVALID_FORMAT', [
+      'Check that you copied the full API key',
+      'Get your API key from: https://codebakers.ai/dashboard',
+    ]);
+  }
+
+  try {
+    const apiUrl = getApiUrl();
+    const response = await fetch(`${apiUrl}/api/content`, {
+      method: 'GET',
+      headers: {
+        'Authorization': `Bearer ${apiKey}`,
+      },
+    });
+
+    if (response.ok) {
+      return true;
+    }
+
+    // Parse error response
+    const errorBody = await response.json().catch(() => ({}));
+    const errorMessage = errorBody.error || errorBody.message || 'API key validation failed';
+
+    if (response.status === 401) {
+      throw createApiError(errorMessage, 'UNAUTHORIZED', [
+        'Your API key may have been revoked or expired',
+        'Generate a new key at: https://codebakers.ai/dashboard',
+      ]);
+    }
+
+    if (response.status === 403) {
+      throw createApiError(errorMessage, 'FORBIDDEN', [
+        'Your subscription may have expired',
+        'Check your account status at: https://codebakers.ai/settings',
+      ]);
+    }
+
+    throw createApiError(errorMessage, 'UNKNOWN', [
+      'Try again in a few moments',
+      'If the problem persists, contact support',
+    ]);
+  } catch (error) {
+    // If it's already an ApiError, rethrow it
+    if (error && typeof error === 'object' && 'recoverySteps' in error) {
+      throw error;
+    }
+
+    // Network error
+    throw createApiError('Could not connect to CodeBakers server', 'NETWORK_ERROR', [
+      'Check your internet connection',
+      'Try again in a few moments',
+      'If using a VPN or proxy, try disabling it',
+    ]);
+  }
+}
+
+/**
+ * Create a structured API error
+ */
+export function createApiError(message: string, code: string, recoverySteps: string[]): ApiError {
+  return {
+    error: message,
+    code,
+    recoverySteps,
+  };
+}
+
+/**
+ * Format an API error for display
+ */
+export function formatApiError(error: ApiError): string {
+  let output = error.error;
+
+  if (error.recoverySteps && error.recoverySteps.length > 0) {
+    output += '\n\n  Try:';
+    for (const step of error.recoverySteps) {
+      output += `\n    • ${step}`;
+    }
+  }
+
+  return output;
+}
+
+/**
+ * Check if the current API key is valid (for doctor command)
+ */
+export async function checkApiKeyValidity(): Promise<{
+  valid: boolean;
+  error?: ApiError;
+}> {
+  const { getApiKey } = await import('../config.js');
+  const apiKey = getApiKey();
+
+  if (!apiKey) {
+    return {
+      valid: false,
+      error: createApiError('No API key configured', 'NOT_CONFIGURED', [
+        'Run: codebakers setup',
+      ]),
+    };
+  }
+
+  try {
+    await validateApiKey(apiKey);
+    return { valid: true };
+  } catch (error) {
+    return {
+      valid: false,
+      error: error as ApiError,
+    };
+  }
+}
+
+/**
+ * Get the current CLI version
+ */
+export function getCliVersion(): string {
+  try {
+    // Try to read from package.json
+    const packageJson = require('../../package.json');
+    return packageJson.version || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+
+/**
+ * Check if there's a newer version of the CLI available
+ */
+export async function checkForUpdates(): Promise<{
+  currentVersion: string;
+  latestVersion: string;
+  updateAvailable: boolean;
+} | null> {
+  try {
+    const currentVersion = getCliVersion();
+    const response = await fetch('https://registry.npmjs.org/@codebakers/cli/latest', {
+      headers: { 'Accept': 'application/json' },
+    });
+
+    if (!response.ok) return null;
+
+    const data = await response.json();
+    const latestVersion = data.version;
+
+    return {
+      currentVersion,
+      latestVersion,
+      updateAvailable: currentVersion !== latestVersion,
+    };
+  } catch {
+    return null;
+  }
+}