@codebakers/cli 2.9.0 → 3.0.0

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'));
 }
@@ -71,7 +74,25 @@ program
   .description('CodeBakers CLI - Production patterns for AI-assisted development')
   .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)')

package/src/lib/fingerprint.ts

@@ -0,0 +1,122 @@
+import * as os from 'os';
+import * as crypto from 'crypto';
+import { execSync } from 'child_process';
+
+/**
+ * Device fingerprinting for zero-friction trial system
+ * Creates a stable, unique identifier for each device to prevent trial abuse
+ */
+
+export interface DeviceFingerprint {
+  machineId: string;
+  deviceHash: string;
+  platform: string;
+  hostname: string;
+}
+
+/**
+ * Get a stable machine identifier based on OS
+ * - Windows: MachineGuid from registry
+ * - macOS: IOPlatformUUID from system
+ * - Linux: /etc/machine-id
+ */
+function getMachineId(): string {
+  try {
+    const platform = os.platform();
+
+    if (platform === 'win32') {
+      // Windows: Use MachineGuid from registry
+      const output = execSync(
+        'reg query "HKLM\\SOFTWARE\\Microsoft\\Cryptography" /v MachineGuid',
+        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+      );
+      const match = output.match(/MachineGuid\s+REG_SZ\s+(.+)/);
+      if (match && match[1]) {
+        return match[1].trim();
+      }
+    } else if (platform === 'darwin') {
+      // macOS: Use hardware UUID
+      const output = execSync(
+        'ioreg -rd1 -c IOPlatformExpertDevice | grep IOPlatformUUID',
+        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+      );
+      const match = output.match(/"IOPlatformUUID"\s*=\s*"(.+)"/);
+      if (match && match[1]) {
+        return match[1];
+      }
+    } else {
+      // Linux: Use machine-id
+      const output = execSync('cat /etc/machine-id', {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+      return output.trim();
+    }
+  } catch {
+    // Fallback handled below
+  }
+
+  // Fallback: Create a stable hash from hostname + username + home directory
+  // This is less reliable but works when we can't access system IDs
+  const fallbackData = [
+    os.hostname(),
+    os.userInfo().username,
+    os.homedir(),
+    os.platform(),
+    os.arch(),
+  ].join('|');
+
+  return crypto.createHash('sha256').update(fallbackData).digest('hex').slice(0, 36);
+}
+
+/**
+ * Get a complete device fingerprint
+ * The deviceHash is the primary identifier used for trial tracking
+ */
+export function getDeviceFingerprint(): DeviceFingerprint {
+  const machineId = getMachineId();
+
+  // Collect stable machine characteristics
+  const fingerprintData = {
+    machineId,
+    hostname: os.hostname(),
+    username: os.userInfo().username,
+    platform: os.platform(),
+    arch: os.arch(),
+    cpuModel: os.cpus()[0]?.model || 'unknown',
+    totalMemory: Math.floor(os.totalmem() / (1024 * 1024 * 1024)), // GB rounded
+    homeDir: os.homedir(),
+  };
+
+  // Create a stable hash from all characteristics
+  const deviceHash = crypto
+    .createHash('sha256')
+    .update(JSON.stringify(fingerprintData))
+    .digest('hex');
+
+  return {
+    machineId,
+    deviceHash,
+    platform: os.platform(),
+    hostname: os.hostname(),
+  };
+}
+
+/**
+ * Validate that we can create a fingerprint
+ * Used for diagnostics
+ */
+export function canCreateFingerprint(): { success: boolean; error?: string } {
+  try {
+    const fp = getDeviceFingerprint();
+    if (fp.deviceHash && fp.deviceHash.length === 64) {
+      return { success: true };
+    }
+    return { success: false, error: 'Invalid fingerprint generated' };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Unknown error',
+    };
+  }
+}