@codebakers/cli 2.8.0 → 3.0.0

package/src/commands/billing.ts

@@ -0,0 +1,99 @@
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+import { getApiUrl, getApiKey, getTrialState, isTrialExpired, getTrialDaysRemaining } from '../config.js';
+
+/**
+ * Open a URL in the default browser
+ */
+function openBrowser(url: string): void {
+  const platform = process.platform;
+
+  try {
+    if (platform === 'win32') {
+      execSync(`start "" "${url}"`, { stdio: 'ignore', shell: 'cmd.exe' });
+    } else if (platform === 'darwin') {
+      execSync(`open "${url}"`, { stdio: 'ignore' });
+    } else {
+      execSync(`xdg-open "${url}" || sensible-browser "${url}" || x-www-browser "${url}"`, {
+        stdio: 'ignore',
+        shell: '/bin/sh',
+      });
+    }
+  } catch {
+    console.log(chalk.yellow(`\n  Could not open browser automatically.`));
+    console.log(chalk.gray(`  Please open this URL manually:\n`));
+    console.log(chalk.cyan(`  ${url}\n`));
+  }
+}
+
+/**
+ * Open billing page for subscription management
+ */
+export async function billing(): Promise<void> {
+  console.log(chalk.blue(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║                                                           ║
+  ║   ${chalk.bold.white('CodeBakers Billing & Subscription')}                   ║
+  ║                                                           ║
+  ╚═══════════════════════════════════════════════════════════╝
+  `));
+
+  // Check current status
+  const apiKey = getApiKey();
+  const trial = getTrialState();
+
+  if (apiKey) {
+    console.log(chalk.green('  ✓ You have an active subscription\n'));
+    console.log(chalk.gray('  Opening settings page to manage your subscription...\n'));
+
+    const apiUrl = getApiUrl();
+    const settingsUrl = `${apiUrl}/settings`;
+
+    openBrowser(settingsUrl);
+    console.log(chalk.gray(`  ${settingsUrl}\n`));
+    return;
+  }
+
+  if (trial) {
+    if (isTrialExpired()) {
+      console.log(chalk.yellow('  ⚠️  Your trial has expired\n'));
+    } else {
+      const daysRemaining = getTrialDaysRemaining();
+      console.log(chalk.gray(`  Trial: ${daysRemaining} day${daysRemaining !== 1 ? 's' : ''} remaining\n`));
+    }
+  }
+
+  // Show pricing
+  console.log(chalk.white('  Choose your plan:\n'));
+
+  console.log(chalk.cyan('  Pro     ') + chalk.white('- $49/month  ') + chalk.gray('(1 seat)'));
+  console.log(chalk.gray('           All 40 pattern modules'));
+  console.log(chalk.gray('           Unlimited projects'));
+  console.log(chalk.gray('           Priority support\n'));
+
+  console.log(chalk.cyan('  Team    ') + chalk.white('- $149/month ') + chalk.gray('(5 seats)'));
+  console.log(chalk.gray('           Everything in Pro'));
+  console.log(chalk.gray('           Team collaboration'));
+  console.log(chalk.gray('           Shared API keys\n'));
+
+  console.log(chalk.cyan('  Agency  ') + chalk.white('- $349/month ') + chalk.gray('(unlimited seats)'));
+  console.log(chalk.gray('           Everything in Team'));
+  console.log(chalk.gray('           White-label option'));
+  console.log(chalk.gray('           Dedicated support\n'));
+
+  console.log(chalk.gray('  Enterprise pricing available for large teams.\n'));
+
+  // Open billing page
+  const apiUrl = getApiUrl();
+  const billingUrl = `${apiUrl}/billing`;
+
+  console.log(chalk.white('  Opening billing page...\n'));
+
+  openBrowser(billingUrl);
+
+  console.log(chalk.gray(`  ${billingUrl}\n`));
+
+  console.log(chalk.gray('  After subscribing, run:'));
+  console.log(chalk.cyan('    codebakers setup\n'));
+  console.log(chalk.gray('  to configure your API key.\n'));
+}

package/src/commands/extend.ts

@@ -0,0 +1,157 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { execSync } from 'child_process';
+import {
+  getTrialState,
+  setTrialState,
+  getApiUrl,
+  getApiKey,
+  isTrialExpired,
+  type TrialState,
+} from '../config.js';
+
+/**
+ * Open a URL in the default browser
+ */
+function openBrowser(url: string): void {
+  const platform = process.platform;
+
+  try {
+    if (platform === 'win32') {
+      execSync(`start "" "${url}"`, { stdio: 'ignore', shell: 'cmd.exe' });
+    } else if (platform === 'darwin') {
+      execSync(`open "${url}"`, { stdio: 'ignore' });
+    } else {
+      // Linux - try common browsers
+      execSync(`xdg-open "${url}" || sensible-browser "${url}" || x-www-browser "${url}"`, {
+        stdio: 'ignore',
+        shell: '/bin/sh',
+      });
+    }
+  } catch {
+    console.log(chalk.yellow(`\n  Could not open browser automatically.`));
+    console.log(chalk.gray(`  Please open this URL manually:\n`));
+    console.log(chalk.cyan(`  ${url}\n`));
+  }
+}
+
+/**
+ * Sleep for a specified number of milliseconds
+ */
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+/**
+ * Extend trial by connecting GitHub account
+ */
+export async function extend(): Promise<void> {
+  console.log(chalk.blue(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║                                                           ║
+  ║   ${chalk.bold.white('Extend Your Trial with GitHub')}                       ║
+  ║                                                           ║
+  ╚═══════════════════════════════════════════════════════════╝
+  `));
+
+  // Check if user already has an API key (paid user)
+  const apiKey = getApiKey();
+  if (apiKey) {
+    console.log(chalk.green('  ✓ You\'re already logged in with an API key!\n'));
+    console.log(chalk.gray('  You have unlimited access. No extension needed.\n'));
+    return;
+  }
+
+  // Check for existing trial
+  const trial = getTrialState();
+
+  if (!trial) {
+    console.log(chalk.yellow('  No trial found.\n'));
+    console.log(chalk.white('  Start your free trial first:\n'));
+    console.log(chalk.cyan('    codebakers go\n'));
+    return;
+  }
+
+  // Check if already extended
+  if (trial.stage === 'extended') {
+    console.log(chalk.yellow('  Your trial has already been extended.\n'));
+
+    if (isTrialExpired()) {
+      console.log(chalk.white('  Ready to upgrade? $49/month for unlimited access:\n'));
+      console.log(chalk.cyan('    codebakers upgrade\n'));
+    } else {
+      const expiresAt = new Date(trial.expiresAt);
+      const daysRemaining = Math.max(0, Math.ceil((expiresAt.getTime() - Date.now()) / (1000 * 60 * 60 * 24)));
+      console.log(chalk.gray(`  ${daysRemaining} day${daysRemaining !== 1 ? 's' : ''} remaining.\n`));
+    }
+    return;
+  }
+
+  // Check if converted
+  if (trial.stage === 'converted') {
+    console.log(chalk.green('  ✓ You\'ve upgraded to a paid plan!\n'));
+    console.log(chalk.gray('  Run ') + chalk.cyan('codebakers setup') + chalk.gray(' to configure your API key.\n'));
+    return;
+  }
+
+  // Open browser for GitHub OAuth
+  const apiUrl = getApiUrl();
+  const authUrl = `${apiUrl}/api/auth/github?trial_id=${trial.trialId}`;
+
+  console.log(chalk.white('  Opening browser for GitHub authorization...\n'));
+
+  openBrowser(authUrl);
+
+  console.log(chalk.gray('  Waiting for authorization...'));
+  console.log(chalk.gray('  (This may take a moment)\n'));
+
+  // Poll for completion
+  const spinner = ora('Checking authorization status...').start();
+  let extended = false;
+  let pollCount = 0;
+  const maxPolls = 60; // 2 minutes max
+
+  while (pollCount < maxPolls && !extended) {
+    await sleep(2000);
+    pollCount++;
+
+    try {
+      const response = await fetch(`${apiUrl}/api/trial/status?trialId=${trial.trialId}`);
+      const data = await response.json();
+
+      if (data.stage === 'extended') {
+        extended = true;
+
+        // Update local trial state
+        const updatedTrial: TrialState = {
+          ...trial,
+          stage: 'extended',
+          expiresAt: data.expiresAt,
+          extendedAt: new Date().toISOString(),
+          ...(data.githubUsername && { githubUsername: data.githubUsername }),
+        };
+
+        setTrialState(updatedTrial);
+        spinner.succeed('Trial extended!');
+      }
+    } catch {
+      // Ignore polling errors
+    }
+  }
+
+  if (extended) {
+    console.log(chalk.green(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║  ✅ Trial Extended!                                       ║
+  ║                                                           ║
+  ║  ${chalk.white('You have 7 more days to build with CodeBakers.')}         ║
+  ║                                                           ║
+  ║  ${chalk.gray('Keep building - your project is waiting!')}                ║
+  ╚═══════════════════════════════════════════════════════════╝
+    `));
+  } else {
+    spinner.warn('Authorization timed out');
+    console.log(chalk.yellow('\n  Please try again or authorize manually:\n'));
+    console.log(chalk.cyan(`  ${authUrl}\n`));
+  }
+}

package/src/commands/go.ts

@@ -0,0 +1,197 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { execSync } from 'child_process';
+import {
+  getTrialState,
+  setTrialState,
+  getApiUrl,
+  getApiKey,
+  isTrialExpired,
+  getTrialDaysRemaining,
+  type TrialState,
+} from '../config.js';
+import { getDeviceFingerprint } from '../lib/fingerprint.js';
+
+/**
+ * Zero-friction entry point - start using CodeBakers instantly
+ */
+export async function go(): Promise<void> {
+  console.log(chalk.blue(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║                                                           ║
+  ║   ${chalk.bold.white('CodeBakers - Zero Setup Required')}                    ║
+  ║                                                           ║
+  ╚═══════════════════════════════════════════════════════════╝
+  `));
+
+  // Check if user already has an API key (paid user)
+  const apiKey = getApiKey();
+  if (apiKey) {
+    console.log(chalk.green('  ✓ You\'re already logged in with an API key!\n'));
+    console.log(chalk.gray('  Run ') + chalk.cyan('codebakers status') + chalk.gray(' to check your setup.\n'));
+    return;
+  }
+
+  // Check existing trial
+  const existingTrial = getTrialState();
+
+  if (existingTrial && !isTrialExpired()) {
+    const daysRemaining = getTrialDaysRemaining();
+    console.log(chalk.green(`  ✓ Trial active (${daysRemaining} day${daysRemaining !== 1 ? 's' : ''} remaining)\n`));
+
+    if (existingTrial.stage === 'anonymous' && daysRemaining <= 2) {
+      console.log(chalk.yellow('  ⚠️  Trial expiring soon! Extend with GitHub:\n'));
+      console.log(chalk.cyan('    codebakers extend\n'));
+    }
+
+    await configureMCP();
+    return;
+  }
+
+  // Check if trial expired
+  if (existingTrial && isTrialExpired()) {
+    console.log(chalk.yellow('  ⚠️  Your trial has expired.\n'));
+
+    if (existingTrial.stage === 'anonymous') {
+      console.log(chalk.white('  Extend your trial for 7 more days with GitHub:\n'));
+      console.log(chalk.cyan('    codebakers extend\n'));
+      console.log(chalk.gray('  Or upgrade to Pro ($49/month):\n'));
+      console.log(chalk.cyan('    codebakers upgrade\n'));
+    } else {
+      console.log(chalk.white('  Ready to upgrade? $49/month for unlimited access:\n'));
+      console.log(chalk.cyan('    codebakers upgrade\n'));
+    }
+    return;
+  }
+
+  // Start new trial
+  const spinner = ora('Starting your free trial...').start();
+
+  try {
+    const fingerprint = getDeviceFingerprint();
+    const apiUrl = getApiUrl();
+
+    const response = await fetch(`${apiUrl}/api/trial/start`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        deviceHash: fingerprint.deviceHash,
+        machineId: fingerprint.machineId,
+        platform: fingerprint.platform,
+        hostname: fingerprint.hostname,
+      }),
+    });
+
+    const data = await response.json();
+
+    if (data.error === 'trial_not_available') {
+      spinner.fail('Trial not available');
+      console.log(chalk.yellow(`
+  It looks like you've already used a CodeBakers trial.
+
+  Ready to upgrade? $49/month for unlimited access.
+
+  ${chalk.cyan('codebakers upgrade')} or visit ${chalk.underline('https://codebakers.ai/pricing')}
+      `));
+      return;
+    }
+
+    if (!response.ok) {
+      throw new Error(data.error || 'Failed to start trial');
+    }
+
+    // Check if returning existing trial
+    if (data.stage === 'expired') {
+      spinner.warn('Your previous trial has expired');
+      console.log('');
+
+      if (data.canExtend) {
+        console.log(chalk.white('  Extend your trial for 7 more days with GitHub:\n'));
+        console.log(chalk.cyan('    codebakers extend\n'));
+      } else {
+        console.log(chalk.white('  Ready to upgrade? $49/month for unlimited access:\n'));
+        console.log(chalk.cyan('    codebakers upgrade\n'));
+      }
+      return;
+    }
+
+    // Save trial state
+    const trialState: TrialState = {
+      trialId: data.trialId,
+      stage: data.stage,
+      deviceHash: fingerprint.deviceHash,
+      expiresAt: data.expiresAt,
+      startedAt: data.startedAt,
+      ...(data.githubUsername && { githubUsername: data.githubUsername }),
+      ...(data.projectId && { projectId: data.projectId }),
+      ...(data.projectName && { projectName: data.projectName }),
+    };
+
+    setTrialState(trialState);
+
+    spinner.succeed(`Trial started (${data.daysRemaining} days free)`);
+    console.log('');
+
+    // Configure MCP
+    await configureMCP();
+
+    // Show success message
+    console.log(chalk.green(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║  ✅ CodeBakers is ready!                                  ║
+  ║                                                           ║
+  ║  ${chalk.white('Your 7-day free trial has started.')}                    ║
+  ║                                                           ║
+  ║  ${chalk.gray('Try: "Build me a todo app with authentication"')}        ║
+  ╚═══════════════════════════════════════════════════════════╝
+    `));
+
+    // Attempt auto-restart Claude Code
+    await attemptAutoRestart();
+
+  } catch (error) {
+    spinner.fail('Failed to start trial');
+
+    if (error instanceof Error) {
+      if (error.message.includes('fetch') || error.message.includes('network')) {
+        console.log(chalk.red('\n  Could not connect to CodeBakers server.'));
+        console.log(chalk.gray('  Check your internet connection and try again.\n'));
+      } else {
+        console.log(chalk.red(`\n  ${error.message}\n`));
+      }
+    } else {
+      console.log(chalk.red('\n  An unexpected error occurred.\n'));
+    }
+  }
+}
+
+async function configureMCP(): Promise<void> {
+  const spinner = ora('Configuring Claude Code integration...').start();
+  const isWindows = process.platform === 'win32';
+
+  const mcpCmd = isWindows
+    ? 'claude mcp add --transport stdio codebakers -- cmd /c npx -y @codebakers/cli serve'
+    : 'claude mcp add --transport stdio codebakers -- npx -y @codebakers/cli serve';
+
+  try {
+    execSync(mcpCmd, { stdio: 'pipe' });
+    spinner.succeed('CodeBakers connected to Claude Code');
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    if (errorMessage.includes('already exists') || errorMessage.includes('already registered')) {
+      spinner.succeed('CodeBakers already connected to Claude Code');
+    } else {
+      spinner.warn('Could not auto-configure Claude Code');
+      console.log(chalk.gray('\n  Run this command manually:\n'));
+      console.log(chalk.cyan(`  ${mcpCmd}\n`));
+    }
+  }
+}
+
+async function attemptAutoRestart(): Promise<void> {
+  console.log(chalk.yellow('\n  ⚠️  RESTART REQUIRED\n'));
+  console.log(chalk.gray('  Close this terminal and open a new one to activate CodeBakers.\n'));
+
+  // Note: Auto-restart is risky and could lose user work
+  // We show instructions instead of forcibly restarting
+}

package/src/config.ts

@@ -94,12 +94,28 @@ type ServiceKeys = {
   [K in ServiceName]: string | null;
 };
 
+export type TrialStage = 'anonymous' | 'extended' | 'expired' | 'converted';
+
+export interface TrialState {
+  trialId: string;
+  stage: TrialStage;
+  deviceHash: string;
+  expiresAt: string;  // ISO date
+  startedAt: string;  // ISO date
+  extendedAt?: string;  // ISO date
+  githubUsername?: string;
+  projectId?: string;
+  projectName?: string;
+}
+
 interface ConfigSchema {
   apiKey: string | null;
   apiUrl: string;
   experienceLevel: ExperienceLevel;
   serviceKeys: ServiceKeys;
   lastKeySync: string | null;  // ISO date of last sync with server
+  // Trial state (for zero-friction onboarding)
+  trial: TrialState | null;
 }
 
 // Create default service keys object with all keys set to null
@@ -109,13 +125,14 @@ const defaultServiceKeys: ServiceKeys = Object.fromEntries(
 
 const config = new Conf<ConfigSchema>({
   projectName: 'codebakers',
-  projectVersion: '1.7.0',
+  projectVersion: '1.8.0',
   defaults: {
     apiKey: null,
     apiUrl: 'https://codebakers.ai',
     experienceLevel: 'intermediate',
     serviceKeys: defaultServiceKeys,
     lastKeySync: null,
+    trial: null,
   },
   // Migration to add new keys when upgrading from old version
   migrations: {
@@ -132,6 +149,12 @@ const config = new Conf<ConfigSchema>({
 
       store.set('serviceKeys', newKeys);
     },
+    '1.8.0': (store) => {
+      // Add trial field if not present
+      if (!store.has('trial')) {
+        store.set('trial', null);
+      }
+    },
   },
 });
 
@@ -389,3 +412,80 @@ export function getConfigPath(): string {
 export function getConfigStore(): ConfigSchema {
   return config.store;
 }
+
+// ============================================================
+// Trial State Management (Zero-Friction Onboarding)
+// ============================================================
+
+export function getTrialState(): TrialState | null {
+  return config.get('trial');
+}
+
+export function setTrialState(trial: TrialState): void {
+  config.set('trial', trial);
+}
+
+export function clearTrialState(): void {
+  config.set('trial', null);
+}
+
+export function updateTrialState(updates: Partial<TrialState>): void {
+  const current = config.get('trial');
+  if (current) {
+    config.set('trial', { ...current, ...updates });
+  }
+}
+
+/**
+ * Check if the current trial has expired
+ */
+export function isTrialExpired(): boolean {
+  const trial = config.get('trial');
+  if (!trial) return true;
+
+  const expiresAt = new Date(trial.expiresAt);
+  return new Date() > expiresAt;
+}
+
+/**
+ * Get the number of days remaining in the trial
+ */
+export function getTrialDaysRemaining(): number {
+  const trial = config.get('trial');
+  if (!trial) return 0;
+
+  const expiresAt = new Date(trial.expiresAt);
+  const now = new Date();
+  const diffMs = expiresAt.getTime() - now.getTime();
+  const diffDays = Math.ceil(diffMs / (1000 * 60 * 60 * 24));
+
+  return Math.max(0, diffDays);
+}
+
+/**
+ * Check if user has any valid access (API key OR active trial)
+ */
+export function hasValidAccess(): boolean {
+  // Paid users always have access
+  const apiKey = config.get('apiKey');
+  if (apiKey) return true;
+
+  // Check trial
+  const trial = config.get('trial');
+  if (!trial) return false;
+
+  return !isTrialExpired();
+}
+
+/**
+ * Get authentication mode: 'apiKey', 'trial', or 'none'
+ */
+export function getAuthMode(): 'apiKey' | 'trial' | 'none' {
+  const apiKey = config.get('apiKey');
+  if (apiKey) return 'apiKey';
+
+  const trial = config.get('trial');
+  if (trial && !isTrialExpired()) return 'trial';
+
+  return 'none';
+}

package/src/index.ts

@@ -19,6 +19,9 @@ import { config } from './commands/config.js';
 import { audit } from './commands/audit.js';
 import { heal, healWatch } from './commands/heal.js';
 import { pushPatterns, pushPatternsInteractive } from './commands/push-patterns.js';
+import { go } from './commands/go.js';
+import { extend } from './commands/extend.js';
+import { billing } from './commands/billing.js';
 
 // Show welcome message when no command is provided
 function showWelcome(): void {
@@ -33,7 +36,7 @@ function showWelcome(): void {
   `));
 
   console.log(chalk.white('  Getting Started:\n'));
-  console.log(chalk.cyan('    codebakers setup') + chalk.gray('      One-time setup (recommended first step)'));
+  console.log(chalk.cyan('    codebakers go') + chalk.gray('         Start free trial instantly (no signup!)'));
   console.log(chalk.cyan('    codebakers scaffold') + chalk.gray('   Create a new project from scratch'));
   console.log(chalk.cyan('    codebakers init') + chalk.gray('       Add patterns to existing project\n'));
 
@@ -57,9 +60,9 @@ function showWelcome(): void {
   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, 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'));
+  console.log(chalk.gray('    go, extend, billing, setup, scaffold, init, generate, upgrade, status'));
+  console.log(chalk.gray('    audit, heal, doctor, config, login, install, uninstall'));
+  console.log(chalk.gray('    install-hook, uninstall-hook, serve, mcp-config, mcp-uninstall\n'));
 
   console.log(chalk.gray('  Run ') + chalk.cyan('codebakers <command> --help') + chalk.gray(' for more info\n'));
 }
@@ -69,9 +72,27 @@ const program = new Command();
 program
   .name('codebakers')
   .description('CodeBakers CLI - Production patterns for AI-assisted development')
-  .version('2.8.0');
+  .version('2.9.0');
 
-// Primary command - one-time setup
+// Zero-friction trial entry (no signup required)
+program
+  .command('go')
+  .alias('start')
+  .description('Start using CodeBakers instantly (no signup required)')
+  .action(go);
+
+program
+  .command('extend')
+  .description('Extend your free trial with GitHub')
+  .action(extend);
+
+program
+  .command('billing')
+  .alias('subscribe')
+  .description('Manage subscription or upgrade to paid plan')
+  .action(billing);
+
+// Primary command - one-time setup (for paid users)
 program
   .command('setup')
   .description('One-time setup: login + configure Claude Code (recommended)')