Upgrade gemini model to 2.5-flash

docs/z3ed/TESTING-GEMINI.md

@@ -0,0 +1,113 @@
+# Testing Gemini Integration
+
+You mentioned you've set up `GEMINI_API_KEY` in your environment with billing enabled. Here's how to test it:
+
+## Quick Test
+
+Open your terminal and run:
+
+```bash
+# Make sure the API key is exported
+export GEMINI_API_KEY='your-api-key-here'
+
+# Run the manual test script
+./scripts/manual_gemini_test.sh
+```
+
+Or run it in one line:
+
+```bash
+GEMINI_API_KEY='your-api-key' ./scripts/manual_gemini_test.sh
+```
+
+## Individual Command Tests
+
+Test individual commands:
+
+```bash
+# Export the key first
+export GEMINI_API_KEY='your-api-key-here'
+
+# Test 1: Simple palette change
+./build/bin/z3ed agent plan --prompt "Change palette 0 color 5 to red"
+
+# Test 2: Overworld modification
+./build/bin/z3ed agent plan --prompt "Place a tree at position (10, 20) on map 0"
+
+# Test 3: Multi-step task
+./build/bin/z3ed agent plan --prompt "Export palette 0, change color 3 to blue, and import it back"
+
+# Test 4: Create a proposal
+./build/bin/z3ed agent run --prompt "Validate the ROM"
+```
+
+## What to Look For
+
+1. **Service Selection**: Should say "🤖 Using Gemini AI with model: gemini-2.5-flash"
+2. **Command Generation**: Should output a list of z3ed commands like:
+   ```
+   AI Agent Plan:
+     - palette export --group overworld --id 0 --to palette.json
+     - palette set-color --file palette.json --index 5 --color 0xFF0000
+   ```
+3. **No "z3ed" Prefix**: Commands should NOT start with "z3ed" (our parser strips it)
+4. **Valid Syntax**: Commands should match the z3ed command syntax
+
+## Expected Output Example
+
+```
+🤖 Using Gemini AI with model: gemini-2.5-flash
+AI Agent Plan:
+  - palette export --group overworld --id 0 --to palette.json
+  - palette set-color --file palette.json --index 5 --color 0xFF0000
+  - palette import --group overworld --id 0 --from palette.json
+```
+
+## Troubleshooting
+
+**Issue**: "Using MockAIService (no LLM configured)"
+- **Solution**: Make sure `GEMINI_API_KEY` is exported: `export GEMINI_API_KEY='your-key'`
+
+**Issue**: "Invalid Gemini API key"
+- **Solution**: Verify your key at https://makersuite.google.com/app/apikey
+
+**Issue**: "Cannot reach Gemini API"
+- **Solution**: Check your internet connection
+
+**Issue**: Commands have "z3ed" prefix
+- **Solution**: This is normal - our parser automatically strips it
+
+## Running the Full Test Suite
+
+Once your key is exported, run:
+
+```bash
+./scripts/test_gemini_integration.sh
+```
+
+This runs 10 comprehensive tests including:
+- API connectivity
+- Model availability
+- Command generation
+- Error handling
+- Environment variable support
+
+## What We're Testing
+
+This validates Phase 2 implementation:
+- ✅ Gemini v1beta API integration
+- ✅ JSON response parsing
+- ✅ Markdown stripping (if model wraps in ```json)
+- ✅ Health check system
+- ✅ Error handling
+- ✅ Service factory selection
+
+## After Testing
+
+Please share:
+1. Did all tests pass? ✅
+2. Quality of generated commands (accurate/reasonable)?
+3. Response time (fast/slow)?
+4. Any errors or issues?
+
+This will help us document Phase 2 completion and decide next steps!