@codebakers/cli 2.9.0 → 3.0.1

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',
+    };
+  }
+}