vibefast-cli 0.2.3 → 0.3.0

package/src/core/recipes.ts

@@ -0,0 +1,152 @@
+/**
+ * Recipe categories and metadata
+ */
+
+export type RecipeCategory = 'feature' | 'advanced-ui' | 'integration';
+
+export interface RecipeInfo {
+  name: string;
+  category: RecipeCategory;
+  description: string;
+  icon: string;
+}
+
+/**
+ * All available recipes organized by category
+ */
+export const RECIPES: RecipeInfo[] = [
+  // Features
+  {
+    name: 'audio-recorder',
+    category: 'feature',
+    description: 'Record and manage voice notes',
+    icon: '🎤',
+  },
+  {
+    name: 'charts',
+    category: 'feature',
+    description: 'Beautiful data visualization with charts',
+    icon: '📊',
+  },
+  {
+    name: 'chatbot',
+    category: 'feature',
+    description: 'AI-powered chat assistant',
+    icon: '💬',
+  },
+  {
+    name: 'image-analysis',
+    category: 'feature',
+    description: 'AI-powered image analysis with trait detection',
+    icon: '🔍',
+  },
+  {
+    name: 'image-generator',
+    category: 'feature',
+    description: 'AI-powered image generation',
+    icon: '🎨',
+  },
+  {
+    name: 'quiz',
+    category: 'feature',
+    description: 'Interactive quiz feature',
+    icon: '📱',
+  },
+  {
+    name: 'tracker-app',
+    category: 'feature',
+    description: 'Track habits and activities',
+    icon: '🍎',
+  },
+  {
+    name: 'voice-bot',
+    category: 'feature',
+    description: 'Real-time voice conversations with AI',
+    icon: '🗣️',
+  },
+  {
+    name: 'wake-word',
+    category: 'feature',
+    description: 'Wake word detection with Vosk',
+    icon: '🎙️',
+  },
+  
+  // Advanced UI Components
+  {
+    name: 'glowing-button',
+    category: 'advanced-ui',
+    description: 'Animated glowing button with shimmer effect',
+    icon: '✨',
+  },
+  {
+    name: 'animated-switch',
+    category: 'advanced-ui',
+    description: 'Smooth animated toggle switch',
+    icon: '🎚️',
+  },
+  {
+    name: 'animated-chip',
+    category: 'advanced-ui',
+    description: 'Animated chip/tag component with press effects',
+    icon: '🏷️',
+  },
+  {
+    name: 'number-stepper',
+    category: 'advanced-ui',
+    description: 'Number input with +/- buttons',
+    icon: '🔢',
+  },
+  {
+    name: 'progress-circle',
+    category: 'advanced-ui',
+    description: 'Circular progress indicator with animation',
+    icon: '⭕',
+  },
+  {
+    name: 'swipe-slider',
+    category: 'advanced-ui',
+    description: 'Interactive swipe-to-confirm slider',
+    icon: '👆',
+  },
+  {
+    name: 'timeline',
+    category: 'advanced-ui',
+    description: 'Activity timeline view for feeds',
+    icon: '📅',
+  },
+];
+
+/**
+ * Get recipes by category
+ */
+export function getRecipesByCategory(category: RecipeCategory): RecipeInfo[] {
+  return RECIPES.filter((r) => r.category === category);
+}
+
+/**
+ * Get all categories
+ */
+export function getCategories(): RecipeCategory[] {
+  return ['feature', 'advanced-ui'];
+}
+
+/**
+ * Get recipe info by name
+ */
+export function getRecipeInfo(name: string): RecipeInfo | undefined {
+  return RECIPES.find((r) => r.name === name);
+}
+
+/**
+ * Format category name for display
+ */
+export function formatCategory(category: RecipeCategory): string {
+  switch (category) {
+    case 'feature':
+      return 'Features';
+    case 'advanced-ui':
+      return 'Advanced UI';
+    case 'integration':
+      return 'Integrations';
+  }
+}

package/src/core/spinner.ts

@@ -0,0 +1,87 @@
+import ora, { Ora } from 'ora';
+import * as p from '@clack/prompts';
+
+/**
+ * Create a spinner with consistent styling
+ */
+export function createSpinner(text: string): Ora {
+  return ora({
+    text,
+    color: 'cyan',
+    spinner: 'dots',
+  });
+}
+
+/**
+ * Run an async operation with a spinner using @clack/prompts
+ */
+export async function withSpinner<T>(
+  text: string,
+  fn: () => Promise<T>,
+  options?: {
+    successText?: string;
+    failText?: string;
+  }
+): Promise<T> {
+  // Don't show spinner in non-TTY environments
+  if (!process.stdout.isTTY) {
+    return fn();
+  }
+  
+  const spinner = p.spinner();
+  spinner.start(text);
+  
+  try {
+    const result = await fn();
+    if (options?.successText) {
+      spinner.stop(options.successText);
+    } else {
+      spinner.stop();
+    }
+    return result;
+  } catch (error) {
+    if (options?.failText) {
+      spinner.stop(options.failText, 1); // 1 = error code
+    } else {
+      spinner.stop('Failed', 1);
+    }
+    throw error;
+  }
+}
+
+/**
+ * Legacy ora-based spinner (for backward compatibility)
+ */
+export async function withOraSpinner<T>(
+  text: string,
+  fn: () => Promise<T>,
+  options?: {
+    successText?: string;
+    failText?: string;
+  }
+): Promise<T> {
+  const spinner = createSpinner(text);
+  
+  if (!process.stdout.isTTY) {
+    return fn();
+  }
+  
+  spinner.start();
+  
+  try {
+    const result = await fn();
+    if (options?.successText) {
+      spinner.succeed(options.successText);
+    } else {
+      spinner.stop();
+    }
+    return result;
+  } catch (error) {
+    if (options?.failText) {
+      spinner.fail(options.failText);
+    } else {
+      spinner.fail();
+    }
+    throw error;
+  }
+}

package/src/core/vosk.ts

@@ -0,0 +1,111 @@
+import { createWriteStream, existsSync, mkdirSync, readdirSync, renameSync, unlinkSync } from 'fs';
+import https from 'https';
+import { join, resolve } from 'path';
+import { log } from './log.js';
+import { extractZipSafe } from './archive.js';
+
+const MODEL_URL = 'https://alphacephei.com/vosk/models/vosk-model-small-en-us-0.15.zip';
+const MODEL_NAME = 'model-en-us';
+
+/**
+ * Download and setup Vosk model for wake-word detection
+ */
+export async function setupVoskModel(projectRoot: string, options?: { dryRun?: boolean }): Promise<boolean> {
+  const ASSETS_DIR = resolve(projectRoot, 'apps/native/assets/vosk-model');
+  const MODEL_PATH = join(ASSETS_DIR, MODEL_NAME);
+  const ZIP_PATH = join(ASSETS_DIR, 'model.zip');
+
+  try {
+    // Check if model already exists
+    if (existsSync(MODEL_PATH)) {
+      log.info('✓ Vosk model already exists');
+      return true;
+    }
+
+    if (options?.dryRun) {
+      log.info('[DRY RUN] Would download Vosk model (~40MB)');
+      return true;
+    }
+
+    // Create assets directory if it doesn't exist
+    if (!existsSync(ASSETS_DIR)) {
+      mkdirSync(ASSETS_DIR, { recursive: true });
+    }
+
+    // Download the model
+    log.info('📥 Downloading Vosk model (~40MB)...');
+    await downloadFile(MODEL_URL, ZIP_PATH);
+
+    // Extract the model
+    log.info('📦 Extracting model...');
+    await extractZipSafe(ZIP_PATH, ASSETS_DIR);
+
+    // Rename extracted folder to expected name
+    const extractedFolder = readdirSync(ASSETS_DIR).find((f) => f.startsWith('vosk-model-small-en-us'));
+
+    if (extractedFolder) {
+      const extractedPath = join(ASSETS_DIR, extractedFolder);
+      renameSync(extractedPath, MODEL_PATH);
+      log.success(`✓ Model ready at ${MODEL_NAME}`);
+    } else {
+      throw new Error('Extracted folder not found. The zip structure may have changed.');
+    }
+
+    // Clean up zip file
+    unlinkSync(ZIP_PATH);
+
+    return true;
+  } catch (error: any) {
+    log.error(`Failed to setup Vosk model: ${error.message}`);
+    log.plain('');
+    log.info('Manual setup:');
+    log.plain('  1. Download: https://alphacephei.com/vosk/models/vosk-model-small-en-us-0.15.zip');
+    log.plain('  2. Extract to: apps/native/assets/vosk-model/');
+    log.plain('  3. Rename folder to: model-en-us');
+    return false;
+  }
+}
+
+/**
+ * Download file from URL with progress
+ */
+function downloadFile(url: string, dest: string): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const file = createWriteStream(dest);
+    https
+      .get(url, (response) => {
+        // Handle redirects
+        if (response.statusCode === 302 || response.statusCode === 301) {
+          return downloadFile(response.headers.location as string, dest)
+            .then(resolve)
+            .catch(reject);
+        }
+
+        const totalSize = parseInt(response.headers['content-length'] || '0', 10);
+        let downloaded = 0;
+
+        response.on('data', (chunk) => {
+          downloaded += chunk.length;
+          const percent = ((downloaded / totalSize) * 100).toFixed(1);
+          process.stdout.write(
+            `\r  ${percent}% (${(downloaded / 1024 / 1024).toFixed(1)}MB / ${(totalSize / 1024 / 1024).toFixed(1)}MB)`
+          );
+        });
+
+        response.pipe(file);
+
+        file.on('finish', () => {
+          file.close(() => {
+            process.stdout.write('\r');
+            resolve();
+          });
+        });
+      })
+      .on('error', (err) => {
+        unlinkSync(dest);
+        reject(err);
+      });
+  });
+}
+
+

package/src/index.ts

@@ -2,6 +2,7 @@
 
 import { Command } from 'commander';
 import pkg from '../package.json' with { type: 'json' };
+import { initCommand } from './commands/init.js';
 import { addCommand } from './commands/add.js';
 import { removeCommand } from './commands/remove.js';
 import { listCommand } from './commands/list.js';
@@ -11,6 +12,10 @@ import { devicesCommand } from './commands/devices.js';
 import { logoutCommand } from './commands/logout.js';
 import { statusCommand } from './commands/status.js';
 import { checklistCommand } from './commands/checklist.js';
+import { envCommand } from './commands/env.js';
+import { healthCommand } from './commands/health.js';
+import { log } from './core/log.js';
+import { showCommandHint } from './core/errors.js';
 
 const program = new Command();
 
@@ -19,6 +24,7 @@ program
   .description('VibeFast CLI - Install features into your monorepo')
   .version(pkg.version || '0.0.0');
 
+program.addCommand(initCommand);
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
 program.addCommand(devicesCommand);
@@ -28,5 +34,49 @@ program.addCommand(addCommand);
 program.addCommand(removeCommand);
 program.addCommand(statusCommand);
 program.addCommand(checklistCommand);
+program.addCommand(envCommand);
+program.addCommand(healthCommand);
+
+// Intercept stderr to add helpful hints
+const originalStderr = process.stderr.write.bind(process.stderr);
+let errorMessage = '';
+
+(process.stderr as any).write = function(chunk: any, ...args: any[]) {
+  const str = chunk.toString();
+  errorMessage += str;
+  
+  const cmdArgs = process.argv.slice(2);
+  const command = cmdArgs[0];
+  
+  // If it's a missing argument error, show hint
+  if (str.includes('missing required argument')) {
+    // Write the original error
+    originalStderr(chunk, ...args);
+    
+    // Add hint
+    log.plain('');
+    showCommandHint(command);
+    
+    // Prevent further writes
+    (process.stderr as any).write = originalStderr;
+    return true;
+  }
+  
+  // If it's a missing option error, show hint
+  if (str.includes('required option') || str.includes('not specified')) {
+    // Write the original error
+    originalStderr(chunk, ...args);
+    
+    // Add hint
+    log.plain('');
+    showCommandHint(command);
+    
+    // Prevent further writes
+    (process.stderr as any).write = originalStderr;
+    return true;
+  }
+  
+  return originalStderr(chunk, ...args);
+};
 
 program.parse();

package/test-locally.sh

@@ -0,0 +1,145 @@
+#!/bin/bash
+
+# Local Testing Script for VibeFast CLI v0.3.0
+# Run this before publishing!
+
+set -e  # Exit on error
+
+echo "🧪 VibeFast CLI Local Testing"
+echo "=============================="
+echo ""
+
+# Colors
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Test counter
+TESTS_PASSED=0
+TESTS_FAILED=0
+
+# Helper functions
+pass() {
+  echo -e "${GREEN}✓${NC} $1"
+  ((TESTS_PASSED++))
+}
+
+fail() {
+  echo -e "${RED}✗${NC} $1"
+  ((TESTS_FAILED++))
+}
+
+info() {
+  echo -e "${YELLOW}ℹ${NC} $1"
+}
+
+# 1. Build
+echo "1. Building CLI..."
+npm run build
+if [ $? -eq 0 ]; then
+  pass "Build successful"
+else
+  fail "Build failed"
+  exit 1
+fi
+echo ""
+
+# 2. Link
+echo "2. Linking CLI globally..."
+npm link
+if [ $? -eq 0 ]; then
+  pass "CLI linked successfully"
+else
+  fail "Failed to link CLI"
+  exit 1
+fi
+echo ""
+
+# 3. Test basic commands
+echo "3. Testing basic commands..."
+
+vf --version > /dev/null 2>&1
+if [ $? -eq 0 ]; then
+  pass "vf --version works"
+else
+  fail "vf --version failed"
+fi
+
+vf --help > /dev/null 2>&1
+if [ $? -eq 0 ]; then
+  pass "vf --help works"
+else
+  fail "vf --help failed"
+fi
+
+vf init --help > /dev/null 2>&1
+if [ $? -eq 0 ]; then
+  pass "vf init --help works"
+else
+  fail "vf init --help failed"
+fi
+
+echo ""
+
+# 4. Test vf init (dry run)
+echo "4. Testing vf init..."
+info "This will create a test project in /tmp"
+info "Press Ctrl+C to skip, or wait 5 seconds..."
+sleep 5
+
+TEST_DIR="/tmp/vibefast-test-$$"
+mkdir -p "$TEST_DIR"
+cd "$TEST_DIR"
+
+info "Running: vf init --yes --skip-install"
+vf init --yes --skip-install
+if [ $? -eq 0 ]; then
+  pass "vf init completed"
+  
+  # Check if directory was created
+  if [ -d "vibefast-app" ]; then
+    pass "Project directory created"
+    
+    # Check if .env exists
+    if [ -f "vibefast-app/.env" ]; then
+      pass ".env file created"
+    else
+      fail ".env file not created"
+    fi
+    
+    # Check if .vibefast-signature.json exists
+    if [ -f "vibefast-app/.vibefast-signature.json" ]; then
+      pass ".vibefast-signature.json exists"
+    else
+      fail ".vibefast-signature.json not found"
+    fi
+  else
+    fail "Project directory not created"
+  fi
+else
+  fail "vf init failed"
+fi
+
+echo ""
+
+# 5. Cleanup
+echo "5. Cleaning up..."
+cd /tmp
+rm -rf "$TEST_DIR"
+pass "Test directory cleaned up"
+
+echo ""
+echo "=============================="
+echo "Test Results:"
+echo -e "${GREEN}Passed: $TESTS_PASSED${NC}"
+echo -e "${RED}Failed: $TESTS_FAILED${NC}"
+echo ""
+
+if [ $TESTS_FAILED -eq 0 ]; then
+  echo -e "${GREEN}✓ All tests passed! Ready to publish.${NC}"
+  exit 0
+else
+  echo -e "${RED}✗ Some tests failed. Fix issues before publishing.${NC}"
+  exit 1
+fi