feat: Add image generation capabilities with ImagineCommand and enhanced development environment

[robch]

Overview

This PR introduces comprehensive image generation functionality to cycod through the new imagine command, along with enhanced development environment setup scripts.

🎨 Image Generation Features

New cycod imagine Command

• AI-powered image generation using DALL-E models via Azure OpenAI or OpenAI API
• Flexible prompts: Support for single prompts, multiple prompts, and batch generation
• Customizable options: Size, style (vivid/natural), quality (standard/hd), count, format
• Smart file naming: Automatic timestamped filenames with descriptive prefixes
• Variable support: Works with cycod's --foreach loops for batch operations

Key Capabilities

• Generate 1-10 images per prompt with --count
• Support for multiple image sizes (256x256 to 1792x1024)
• Both vivid (dramatic) and natural (photorealistic) styles
• Standard and HD quality options
• PNG and JPG output formats
• Custom output directories

🔧 Enhanced Development Environment

Cross-Platform Setup Scripts

• here.sh, here.cmd, here.ps1: Environment activation for Bash, CMD, and PowerShell
• Auto-PATH management: Automatically adds cycod binaries to PATH when activated
• Clean implementation: Uses shared logic in scripts/here-impl.* files

Improved Developer Experience

• Simplified setup process across Windows, macOS, and Linux
• Better script organization with clear separation of concerns
• Enhanced scripts/README.md with usage instructions

📚 Documentation & Help

Comprehensive Help System

• imagine.txt: Complete command reference with all options
• imagine examples.txt: Real-world usage examples
• usage.txt: Updated to include imagine command

Example Use Cases

# Single image generation
cycod imagine "a beautiful sunset over mountains"

# Multiple variations
cycod imagine "weather app icon" --count 3 --style natural

# Batch generation with variables
cycod imagine "{{animal}} in a park" --foreach var animal in dog cat bird

# High-quality hero image
cycod imagine "minimalist logo design" --size 1792x1024 --quality hd

🏗️ Technical Implementation

Code Organization

• ImagineCommand.cs: Full command implementation with parameter parsing
• Provider integration: Works with existing Azure OpenAI and OpenAI configurations
• Error handling: Graceful failure with helpful error messages
• Async support: Proper async/await pattern throughout

Configuration Integration

• Uses existing provider configuration (Azure.OpenAI.* or OPENAI_API_KEY)
• Supports provider-specific settings and endpoints
• Automatic provider detection and fallback

🔄 Future Roadmap

Function Tool Integration (Planned)

This implementation sets the foundation for adding GenerateImages as an AI function tool, which would enable:

• Natural language image generation during chat sessions
• Iterative refinement through conversation
• AI-enhanced prompt engineering
• Automatic addition of generated images to conversation context

See todo/image-generation-function-tool.md for detailed planning.

🧪 Testing

The command has been tested with:

• ✅ Azure OpenAI DALL-E deployments
• ✅ Multiple image sizes and quality settings
• ✅ Batch generation scenarios
• ✅ Variable substitution and loops
• ✅ Error handling for invalid configurations

📋 Commits

• feat: Add GenerateImages function tool for natural language image generation
• feat: Enhance ImagineCommand to support custom image generation options
• first draft of imagine command
• feat: Add wrapper scripts for environment activation in multiple shells
• Enhance PATH setup scripts for complete cycod ecosystem

Breaking Changes

None - this is purely additive functionality.

Dependencies

• Requires Microsoft.Extensions.AI (already in use)
• Requires Azure.AI.OpenAI or OpenAI provider configuration
• Compatible with existing cycod configuration system

---

This PR significantly expands cycod's capabilities by adding creative AI functionality while maintaining the CLI-first philosophy and cross-platform compatibility.