myaidev-method 0.2.11 → 0.2.15

package/src/scripts/configure-visual-apis.js

@@ -0,0 +1,413 @@
+#!/usr/bin/env node
+
+/**
+ * Visual Content Generation API Configuration Script
+ *
+ * Interactive configuration wizard for setting up Google AI and OpenAI API keys
+ * for image and video generation.
+ *
+ * Usage:
+ *   node configure-visual-apis.js
+ *   OR
+ *   /myai-configure visual (from Claude Code)
+ *
+ * Platform support: Claude Code, Gemini CLI, Codex CLI
+ */
+
+import inquirer from 'inquirer';
+import fs from 'fs-extra';
+import path from 'path';
+import dotenv from 'dotenv';
+import chalk from 'chalk';
+import ora from 'ora';
+import { fileURLToPath } from 'url';
+
+// Load existing environment variables
+dotenv.config();
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * Main configuration function
+ */
+export async function configureVisualAPIs() {
+  console.log(chalk.blue('\n🎨 Visual Content Generation Configuration'));
+  console.log(chalk.gray('Configure Google AI and OpenAI APIs for image/video generation\n'));
+
+  console.log(chalk.cyan('Supported Platforms:'));
+  console.log(chalk.gray('✅ Claude Code'));
+  console.log(chalk.gray('✅ Gemini CLI'));
+  console.log(chalk.gray('✅ Codex CLI\n'));
+
+  try {
+    // Step 1: Which services to configure
+    const { services } = await inquirer.prompt([{
+      type: 'checkbox',
+      name: 'services',
+      message: 'Which services do you want to configure?',
+      choices: [
+        {
+          name: 'Google AI (Gemini Flash, Imagen 3, Veo 2)',
+          value: 'google',
+          checked: true
+        },
+        {
+          name: 'OpenAI (DALL-E 3)',
+          value: 'openai',
+          checked: true
+        }
+      ],
+      validate: (answer) => {
+        if (answer.length < 1) {
+          return 'You must choose at least one service.';
+        }
+        return true;
+      }
+    }]);
+
+    const config = {};
+
+    // Step 2: Configure Google AI
+    if (services.includes('google')) {
+      console.log(chalk.yellow('\n📋 Google AI API Setup:'));
+      console.log(chalk.gray('1. Visit: https://ai.google.dev/'));
+      console.log(chalk.gray('2. Sign in with your Google account'));
+      console.log(chalk.gray('3. Click "Get API key" in Google AI Studio'));
+      console.log(chalk.gray('4. Create or select a project'));
+      console.log(chalk.gray('5. Click "Create API key"'));
+      console.log(chalk.gray('6. Copy the API key\n'));
+
+      const currentGoogleKey = process.env.GOOGLE_API_KEY;
+      if (currentGoogleKey) {
+        console.log(chalk.gray(`Current key: ${maskKey(currentGoogleKey)}\n`));
+      }
+
+      const { googleKey, confirmGoogle } = await inquirer.prompt([
+        {
+          type: 'password',
+          name: 'googleKey',
+          message: 'Enter your Google API Key:',
+          mask: '*',
+          validate: (input) => {
+            if (!input) return 'API key is required';
+            if (input.length < 20) return 'API key appears to be too short';
+            return true;
+          }
+        },
+        {
+          type: 'confirm',
+          name: 'confirmGoogle',
+          message: 'Test API key connectivity?',
+          default: true
+        }
+      ]);
+
+      config.GOOGLE_API_KEY = googleKey;
+
+      // Test Google API
+      if (confirmGoogle) {
+        const spinner = ora('Testing Google API connection...').start();
+        try {
+          const testResult = await testGoogleAPI(googleKey);
+          if (testResult.success) {
+            spinner.succeed(chalk.green('Google API connection successful!'));
+          } else {
+            spinner.fail(chalk.red(`Google API test failed: ${testResult.error}`));
+            const { continueAnyway } = await inquirer.prompt([{
+              type: 'confirm',
+              name: 'continueAnyway',
+              message: 'Continue with this API key anyway?',
+              default: false
+            }]);
+            if (!continueAnyway) {
+              delete config.GOOGLE_API_KEY;
+            }
+          }
+        } catch (error) {
+          spinner.fail(chalk.red(`Google API test error: ${error.message}`));
+        }
+      }
+    }
+
+    // Step 3: Configure OpenAI
+    if (services.includes('openai')) {
+      console.log(chalk.yellow('\n📋 OpenAI API Setup:'));
+      console.log(chalk.gray('1. Visit: https://platform.openai.com/api-keys'));
+      console.log(chalk.gray('2. Sign in to your OpenAI account'));
+      console.log(chalk.gray('3. Click "Create new secret key"'));
+      console.log(chalk.gray('4. Name your key (e.g., "MyAIDev Visual Generation")'));
+      console.log(chalk.gray('5. Copy the API key (you won\'t see it again!)\n'));
+
+      const currentOpenAIKey = process.env.OPENAI_API_KEY;
+      if (currentOpenAIKey) {
+        console.log(chalk.gray(`Current key: ${maskKey(currentOpenAIKey)}\n`));
+      }
+
+      const { openaiKey, confirmOpenAI } = await inquirer.prompt([
+        {
+          type: 'password',
+          name: 'openaiKey',
+          message: 'Enter your OpenAI API Key:',
+          mask: '*',
+          validate: (input) => {
+            if (!input) return 'API key is required';
+            if (input.length < 20) return 'API key appears to be too short';
+            if (!input.startsWith('sk-')) return 'OpenAI API keys typically start with "sk-"';
+            return true;
+          }
+        },
+        {
+          type: 'confirm',
+          name: 'confirmOpenAI',
+          message: 'Test API key connectivity?',
+          default: true
+        }
+      ]);
+
+      config.OPENAI_API_KEY = openaiKey;
+
+      // Test OpenAI API
+      if (confirmOpenAI) {
+        const spinner = ora('Testing OpenAI API connection...').start();
+        try {
+          const testResult = await testOpenAIAPI(openaiKey);
+          if (testResult.success) {
+            spinner.succeed(chalk.green('OpenAI API connection successful!'));
+          } else {
+            spinner.fail(chalk.red(`OpenAI API test failed: ${testResult.error}`));
+            const { continueAnyway } = await inquirer.prompt([{
+              type: 'confirm',
+              name: 'continueAnyway',
+              message: 'Continue with this API key anyway?',
+              default: false
+            }]);
+            if (!continueAnyway) {
+              delete config.OPENAI_API_KEY;
+            }
+          }
+        } catch (error) {
+          spinner.fail(chalk.red(`OpenAI API test error: ${error.message}`));
+        }
+      }
+    }
+
+    // Step 4: Preferences
+    if (Object.keys(config).length > 0) {
+      console.log(chalk.yellow('\n⚙️  Preferences:\n'));
+
+      const serviceChoices = [];
+      if (config.GOOGLE_API_KEY) {
+        serviceChoices.push(
+          { name: 'Gemini Flash (Fast & Cheap, $0.02)', value: 'gemini' },
+          { name: 'Imagen 3 (Premium Quality, $0.03)', value: 'imagen' }
+        );
+      }
+      if (config.OPENAI_API_KEY) {
+        serviceChoices.push(
+          { name: 'DALL-E 3 (Creative, $0.04-0.12)', value: 'dalle' }
+        );
+      }
+
+      const preferences = await inquirer.prompt([
+        {
+          type: 'list',
+          name: 'defaultService',
+          message: 'Default image generation service?',
+          choices: serviceChoices,
+          default: 'gemini'
+        },
+        {
+          type: 'list',
+          name: 'defaultQuality',
+          message: 'Default quality level?',
+          choices: [
+            { name: 'Standard (faster, cheaper)', value: 'standard' },
+            { name: 'HD (higher quality, more expensive)', value: 'hd' }
+          ],
+          default: 'standard'
+        },
+        {
+          type: 'number',
+          name: 'dailyBudget',
+          message: 'Daily budget limit (USD)?',
+          default: 5.00,
+          validate: (input) => {
+            if (input <= 0) return 'Budget must be greater than 0';
+            if (input > 1000) return 'Budget seems unusually high (max: $1000)';
+            return true;
+          }
+        },
+        {
+          type: 'number',
+          name: 'monthlyBudget',
+          message: 'Monthly budget limit (USD)?',
+          default: 50.00,
+          validate: (input) => {
+            if (input <= 0) return 'Budget must be greater than 0';
+            if (input > 10000) return 'Budget seems unusually high (max: $10,000)';
+            return true;
+          }
+        }
+      ]);
+
+      config.VISUAL_DEFAULT_SERVICE = preferences.defaultService;
+      config.VISUAL_DEFAULT_QUALITY = preferences.defaultQuality;
+      config.VISUAL_DAILY_BUDGET = preferences.dailyBudget;
+      config.VISUAL_MONTHLY_BUDGET = preferences.monthlyBudget;
+      config.VISUAL_WARN_THRESHOLD = 0.80;
+      config.VISUAL_ASSETS_PATH = './content-assets';
+
+      // Step 5: Update .env file
+      console.log('');
+      const spinner = ora('Updating .env file...').start();
+
+      try {
+        await updateEnvFile(config);
+        spinner.succeed(chalk.green('.env file updated successfully!'));
+      } catch (error) {
+        spinner.fail(chalk.red(`Failed to update .env: ${error.message}`));
+        throw error;
+      }
+
+      // Step 6: Summary
+      console.log(chalk.green('\n✅ Configuration Complete!\n'));
+
+      console.log(chalk.cyan('📋 Summary:'));
+      if (config.GOOGLE_API_KEY) {
+        console.log(chalk.gray(`   ✅ Google AI configured (Gemini, Imagen, Veo)`));
+      }
+      if (config.OPENAI_API_KEY) {
+        console.log(chalk.gray(`   ✅ OpenAI configured (DALL-E 3)`));
+      }
+      console.log(chalk.gray(`   Default service: ${config.VISUAL_DEFAULT_SERVICE}`));
+      console.log(chalk.gray(`   Default quality: ${config.VISUAL_DEFAULT_QUALITY}`));
+      console.log(chalk.gray(`   Daily budget: $${config.VISUAL_DAILY_BUDGET.toFixed(2)}`));
+      console.log(chalk.gray(`   Monthly budget: $${config.VISUAL_MONTHLY_BUDGET.toFixed(2)}`));
+
+      console.log(chalk.yellow('\n💡 Quick Start:\n'));
+      console.log(chalk.cyan('  # Generate hero image'));
+      console.log(chalk.gray('  /myai-generate-visual "Modern developer workspace"\n'));
+
+      console.log(chalk.cyan('  # Generate with specific service'));
+      console.log(chalk.gray('  /myai-generate-visual "AI concept" --type=illustration --service=dalle\n'));
+
+      console.log(chalk.cyan('  # Generate article with images'));
+      console.log(chalk.gray('  /myai-content-writer "Article Title" --with-images\n'));
+
+      console.log(chalk.white('📚 Documentation:'));
+      console.log(chalk.gray('   VISUAL_CONTENT_GENERATION_GUIDE.md - Complete guide'));
+      console.log(chalk.gray('   CONTENT_CREATION_GUIDE.md - Content workflow\n'));
+
+    } else {
+      console.log(chalk.yellow('\n⚠️  No configuration saved (no valid API keys)\n'));
+    }
+
+  } catch (error) {
+    if (error.isTtyError) {
+      console.error(chalk.red('\n❌ Prompt couldn\'t be rendered in the current environment'));
+    } else {
+      console.error(chalk.red(`\n❌ Configuration error: ${error.message}`));
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Update .env file with configuration
+ */
+async function updateEnvFile(config) {
+  const envPath = path.join(process.cwd(), '.env');
+  let envContent = '';
+
+  // Read existing .env if it exists
+  if (await fs.pathExists(envPath)) {
+    envContent = await fs.readFile(envPath, 'utf-8');
+  }
+
+  // Update or add each config value
+  for (const [key, value] of Object.entries(config)) {
+    const regex = new RegExp(`^${key}=.*$`, 'm');
+    const line = `${key}=${value}`;
+
+    if (regex.test(envContent)) {
+      // Update existing key
+      envContent = envContent.replace(regex, line);
+    } else {
+      // Add new key
+      if (!envContent.endsWith('\n') && envContent.length > 0) {
+        envContent += '\n';
+      }
+      envContent += `${line}\n`;
+    }
+  }
+
+  // Write back to file
+  await fs.writeFile(envPath, envContent);
+
+  // Reload environment variables
+  dotenv.config({ override: true });
+}
+
+/**
+ * Test Google API connectivity
+ */
+async function testGoogleAPI(apiKey) {
+  try {
+    const response = await fetch(
+      `https://generativelanguage.googleapis.com/v1beta/models?key=${apiKey}`,
+      { method: 'GET' }
+    );
+
+    if (response.ok) {
+      return { success: true };
+    } else {
+      const errorText = await response.text();
+      return { success: false, error: `HTTP ${response.status}: ${errorText}` };
+    }
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
+
+/**
+ * Test OpenAI API connectivity
+ */
+async function testOpenAIAPI(apiKey) {
+  try {
+    const response = await fetch(
+      'https://api.openai.com/v1/models',
+      {
+        method: 'GET',
+        headers: {
+          'Authorization': `Bearer ${apiKey}`
+        }
+      }
+    );
+
+    if (response.ok) {
+      return { success: true };
+    } else {
+      const errorData = await response.json();
+      return { success: false, error: errorData.error?.message || `HTTP ${response.status}` };
+    }
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
+
+/**
+ * Mask API key for display
+ */
+function maskKey(key) {
+  if (!key || key.length < 16) return '****';
+  return `${key.substring(0, 8)}${'*'.repeat(Math.max(4, key.length - 12))}${key.substring(key.length - 4)}`;
+}
+
+// Run if executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  configureVisualAPIs().catch(error => {
+    console.error(chalk.red(`\nFatal error: ${error.message}`));
+    process.exit(1);
+  });
+}

package/src/scripts/generate-visual-cli.js

@@ -0,0 +1,279 @@
+#!/usr/bin/env node
+
+/**
+ * Visual Content Generation CLI Script
+ *
+ * Standalone CLI script for generating images and videos.
+ * Used by Gemini CLI and Codex CLI platforms.
+ *
+ * Usage:
+ *   node generate-visual-cli.js "prompt" --type=hero --service=gemini
+ *
+ * Platform support: Claude Code, Gemini CLI, Codex CLI
+ */
+
+import { generateImage, generateVideoVeo, estimateCost, validateAPIKeys } from '../lib/visual-generation-utils.js';
+import { saveImage, saveVideo, generateMarkdownReference, checkBudgetLimit, getTodaysCost, getMonthCost } from '../lib/asset-management.js';
+import { hasAnyAPIKeys, getConfigStatusMessage, getServiceDisplayInfo } from '../lib/visual-config-utils.js';
+import chalk from 'chalk';
+import ora from 'ora';
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+
+if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+  showHelp();
+  process.exit(0);
+}
+
+// Extract prompt (first non-option argument)
+const prompt = args.find(arg => !arg.startsWith('--'));
+
+if (!prompt) {
+  console.error(chalk.red('❌ Error: Prompt is required'));
+  console.log('\nUsage: node generate-visual-cli.js "your prompt" --type=hero --service=gemini');
+  process.exit(1);
+}
+
+// Parse options
+const options = {
+  type: getOption('type', 'hero'),
+  service: getOption('service', null),
+  size: getOption('size', '1024x1024'),
+  quality: getOption('quality', 'standard'),
+  description: getOption('description', null)
+};
+
+// Main execution
+(async () => {
+  try {
+    // Check configuration
+    if (!hasAnyAPIKeys()) {
+      console.log(chalk.yellow(getConfigStatusMessage()));
+      process.exit(1);
+    }
+
+    // Validate type
+    const validTypes = ['hero', 'illustration', 'diagram', 'screenshot', 'video'];
+    if (!validTypes.includes(options.type)) {
+      console.error(chalk.red(`❌ Invalid type: ${options.type}`));
+      console.log(chalk.gray(`Valid types: ${validTypes.join(', ')}`));
+      process.exit(1);
+    }
+
+    // Display configuration
+    console.log(chalk.blue('\n🎨 Visual Content Generation\n'));
+    console.log(chalk.gray(`Type: ${options.type}`));
+    console.log(chalk.gray(`Prompt: "${prompt}"`));
+    if (options.service) {
+      console.log(chalk.gray(`Service: ${options.service}`));
+    }
+    console.log('');
+
+    // Estimate cost
+    let service = options.service;
+    if (!service) {
+      // Auto-select based on available services
+      const validation = validateAPIKeys();
+      service = validation.availableServices[0];
+      console.log(chalk.gray(`Auto-selected service: ${service}`));
+    }
+
+    const cost = estimateCost(service, { quality: options.quality, size: options.size });
+
+    // Check budget
+    const budget = await checkBudgetLimit(cost);
+    const todayCost = await getTodaysCost();
+    const monthCost = await getMonthCost();
+
+    console.log(chalk.cyan('💰 Cost Estimate:'));
+    console.log(chalk.gray(`   This generation: $${cost.toFixed(2)}`));
+    console.log(chalk.gray(`   Today: $${todayCost.toFixed(2)} / $${budget.dailyBudget.toFixed(2)} (${Math.round((todayCost/budget.dailyBudget)*100)}%)`));
+    console.log(chalk.gray(`   Month: $${monthCost.toFixed(2)} / $${budget.monthlyBudget.toFixed(2)} (${Math.round((monthCost/budget.monthlyBudget)*100)}%)`));
+    console.log('');
+
+    // Check if budget exceeded
+    if (budget.exceedsDailyBudget) {
+      console.error(chalk.red('❌ Daily budget limit exceeded!'));
+      console.log(chalk.yellow(`\nCurrent usage: $${budget.todaysCost.toFixed(2)}`));
+      console.log(chalk.yellow(`Daily limit: $${budget.dailyBudget.toFixed(2)}`));
+      console.log(chalk.gray('\nOptions:'));
+      console.log(chalk.gray('1. Increase VISUAL_DAILY_BUDGET in .env'));
+      console.log(chalk.gray('2. Wait until tomorrow (resets at midnight)'));
+      process.exit(1);
+    }
+
+    if (budget.exceedsMonthlyBudget) {
+      console.error(chalk.red('❌ Monthly budget limit exceeded!'));
+      console.log(chalk.yellow(`\nCurrent usage: $${budget.monthCost.toFixed(2)}`));
+      console.log(chalk.yellow(`Monthly limit: $${budget.monthlyBudget.toFixed(2)}`));
+      console.log(chalk.gray('\nOptions:'));
+      console.log(chalk.gray('1. Increase VISUAL_MONTHLY_BUDGET in .env'));
+      console.log(chalk.gray('2. Wait until next month'));
+      process.exit(1);
+    }
+
+    // Warnings
+    if (budget.dailyWarning) {
+      console.log(chalk.yellow(`⚠️  Warning: Approaching daily budget limit (${Math.round((budget.newDailyCost/budget.dailyBudget)*100)}%)`));
+      console.log('');
+    }
+
+    // Generate content
+    const spinner = ora(`Generating ${options.type} using ${service}...`).start();
+
+    let result;
+    let saved;
+
+    if (options.type === 'video') {
+      // Generate video
+      spinner.text = `Generating video using ${service}...`;
+      result = await generateVideoVeo(prompt, {
+        duration: 5,
+        aspectRatio: '16:9'
+      });
+
+      spinner.text = 'Saving video...';
+      saved = await saveVideo(result.buffer || Buffer.from(result.data, 'base64'), {
+        description: options.description || prompt,
+        service: result.service,
+        cost: result.cost,
+        prompt: prompt,
+        duration: result.duration || 5
+      });
+
+    } else {
+      // Generate image
+      spinner.text = `Generating ${options.type} using ${service}...`;
+      result = await generateImage(prompt, {
+        preferredService: service,
+        type: options.type,
+        quality: options.quality,
+        size: options.size
+      });
+
+      spinner.text = 'Saving image...';
+      saved = await saveImage(result.buffer, {
+        type: options.type,
+        description: options.description || prompt,
+        service: result.service,
+        cost: result.cost,
+        prompt: result.prompt
+      });
+    }
+
+    spinner.succeed(chalk.green(`${options.type === 'video' ? 'Video' : 'Image'} generated successfully!`));
+
+    // Display results
+    console.log('');
+    console.log(chalk.cyan(`📸 Details:`));
+
+    const serviceInfo = getServiceDisplayInfo(result.service);
+    if (serviceInfo) {
+      console.log(chalk.gray(`   Service: ${serviceInfo.name}`));
+    }
+
+    console.log(chalk.gray(`   Type: ${options.type.charAt(0).toUpperCase() + options.type.slice(1)}`));
+    console.log(chalk.gray(`   Cost: $${result.cost.toFixed(2)}`));
+    console.log(chalk.gray(`   File: ${saved.relativePath}`));
+    console.log(chalk.gray(`   Size: ${(saved.size / 1024).toFixed(1)} KB`));
+    if (options.type === 'video' && result.duration) {
+      console.log(chalk.gray(`   Duration: ${result.duration}s`));
+    }
+
+    // Display updated budget
+    const newTodayCost = await getTodaysCost();
+    const newMonthCost = await getMonthCost();
+
+    console.log('');
+    console.log(chalk.cyan('💰 Updated Budget:'));
+    console.log(chalk.gray(`   Today: $${newTodayCost.toFixed(2)} / $${budget.dailyBudget.toFixed(2)} (${Math.round((newTodayCost/budget.dailyBudget)*100)}%)`));
+    console.log(chalk.gray(`   Month: $${newMonthCost.toFixed(2)} / $${budget.monthlyBudget.toFixed(2)} (${Math.round((newMonthCost/budget.monthlyBudget)*100)}%)`));
+
+    // Generate markdown
+    const altText = `${options.type} ${options.type === 'video' ? 'video' : 'image'}: ${prompt}`;
+    const markdown = generateMarkdownReference(saved.relativePath, altText);
+
+    console.log('');
+    console.log(chalk.cyan('📋 Markdown Reference:'));
+    console.log(chalk.white(markdown));
+    console.log('');
+    console.log(chalk.gray('Copy and paste into your content ↑'));
+    console.log('');
+
+  } catch (error) {
+    console.error(chalk.red(`\n❌ Error: ${error.message}`));
+
+    // Provide helpful error messages
+    if (error.message.includes('rate_limit') || error.message.includes('rate limit')) {
+      console.log(chalk.yellow('\n⚠️  Rate limited by API'));
+      console.log(chalk.gray('Options:'));
+      console.log(chalk.gray('1. Wait 60 seconds and try again'));
+      console.log(chalk.gray('2. Switch to different service: --service=dalle'));
+      console.log(chalk.gray('3. Check your API quota limits'));
+    } else if (error.message.includes('API key') || error.message.includes('unauthorized')) {
+      console.log(chalk.yellow('\n⚠️  API key issue'));
+      console.log(chalk.gray('Run configuration: node src/scripts/configure-visual-apis.js'));
+    }
+
+    process.exit(1);
+  }
+})();
+
+/**
+ * Get option value from command line arguments
+ */
+function getOption(name, defaultValue) {
+  const arg = args.find(a => a.startsWith(`--${name}=`));
+  if (arg) {
+    return arg.split('=')[1];
+  }
+  return defaultValue;
+}
+
+/**
+ * Show help message
+ */
+function showHelp() {
+  console.log(chalk.blue('\n🎨 Visual Content Generation CLI\n'));
+
+  console.log(chalk.white('Usage:'));
+  console.log(chalk.gray('  node generate-visual-cli.js "prompt" [options]\n'));
+
+  console.log(chalk.white('Options:'));
+  console.log(chalk.gray('  --type=<type>         Content type (default: hero)'));
+  console.log(chalk.gray('                        Values: hero, illustration, diagram, screenshot, video'));
+  console.log(chalk.gray('  --service=<service>   AI service (default: auto-select)'));
+  console.log(chalk.gray('                        Values: gemini, imagen, dalle, veo'));
+  console.log(chalk.gray('  --size=<size>         Image size (default: 1024x1024)'));
+  console.log(chalk.gray('                        Values: 1024x1024, 1792x1024, 1024x1792'));
+  console.log(chalk.gray('  --quality=<quality>   Quality level (default: standard)'));
+  console.log(chalk.gray('                        Values: standard, hd'));
+  console.log(chalk.gray('  --description=<desc>  Filename description (default: from prompt)\n'));
+
+  console.log(chalk.white('Examples:'));
+  console.log(chalk.gray('  # Generate hero image (auto-select service)'));
+  console.log(chalk.cyan('  node generate-visual-cli.js "Modern developer workspace"\n'));
+
+  console.log(chalk.gray('  # Generate diagram with Gemini'));
+  console.log(chalk.cyan('  node generate-visual-cli.js "System architecture" --type=diagram --service=gemini\n'));
+
+  console.log(chalk.gray('  # Generate HD illustration with DALL-E'));
+  console.log(chalk.cyan('  node generate-visual-cli.js "AI brain network" --type=illustration --service=dalle --quality=hd\n'));
+
+  console.log(chalk.gray('  # Generate video'));
+  console.log(chalk.cyan('  node generate-visual-cli.js "Product demo" --type=video --service=veo\n'));
+
+  console.log(chalk.white('Services:'));
+  console.log(chalk.gray('  gemini     Gemini 2.5 Flash - Fast, $0.02/image'));
+  console.log(chalk.gray('  imagen     Imagen 3 - Premium quality, $0.03/image'));
+  console.log(chalk.gray('  dalle      DALL-E 3 - Creative, $0.04-0.12/image'));
+  console.log(chalk.gray('  veo        Veo 2 - Video generation, $0.10/video\n'));
+
+  console.log(chalk.white('Prerequisites:'));
+  console.log(chalk.gray('  1. Configure API keys: node src/scripts/configure-visual-apis.js'));
+  console.log(chalk.gray('  2. Or add to .env: GOOGLE_API_KEY=xxx and/or OPENAI_API_KEY=xxx\n'));
+
+  console.log(chalk.white('Documentation:'));
+  console.log(chalk.gray('  See VISUAL_CONTENT_GENERATION_GUIDE.md for complete guide\n'));
+}