docs: AI Dev Control Loop - Task Completion Updates

.env.example

@@ -1,188 +1,60 @@
-# AgentFactory Environment Variables
-# Copy this file to .env and fill in your API keys
+OPENAI_API_KEY=YOUR_OPENAI_API_KEY
+ANTHROPIC_API_KEY=YOUR_ANTHROPIC_API_KEY
+GOOGLE_API_KEY=YOUR_GOOGLE_API_KEY
+
+FIRECRAWL_API_KEY=YOUR_FIRECRAWL_API_KEY
+TAVILY_API_KEY=YOUR_TAVILY_API_KEY
+
+TELEGRAM_BOT_TOKEN=YOUR_TELEGRAM_BOT_TOKEN
+TELEGRAM_ADMIN_CHAT_ID=YOUR_TELEGRAM_CHAT_ID
+AUTHORIZED_TELEGRAM_USERS=YOUR_TELEGRAM_CHAT_ID
+
+DATABASE_PROVIDER=neon
+DATABASE_FAILOVER_ENABLED=true
+DATABASE_FAILOVER_ORDER=neon,supabase,railway
+
+SUPABASE_URL=YOUR_SUPABASE_URL
+SUPABASE_SERVICE_ROLE_KEY=YOUR_SUPABASE_SERVICE_ROLE_KEY
+SUPABASE_DB_PASSWORD=YOUR_SUPABASE_DB_PASSWORD
+SUPABASE_DB_HOST=YOUR_SUPABASE_DB_HOST
+SUPABASE_DB_PORT=5432
+SUPABASE_DB_NAME=postgres
+SUPABASE_DB_USER=postgres
+
+RAILWAY_API_KEY=YOUR_RAILWAY_API_KEY
+RAILWAY_DB_HOST=YOUR_RAILWAY_DB_HOST
+RAILWAY_DB_PORT=5432
+RAILWAY_DB_NAME=railway
+RAILWAY_DB_USER=postgres
+RAILWAY_DB_PASSWORD=YOUR_RAILWAY_DB_PASSWORD
+RAILWAY_DB_URL=YOUR_RAILWAY_DB_URL
+
+NEON_DB_URL=YOUR_NEON_DB_URL
+
+VPS_KB_HOST=72.60.175.144
+VPS_KB_PORT=5432
+VPS_KB_USER=rivet
+VPS_KB_PASSWORD=YOUR_VPS_KB_PASSWORD
+VPS_KB_DATABASE=rivet
+
+VPS_OLLAMA_URL=http://72.60.175.144:11434
 
-# =============================================================================
-# LLM Provider API Keys
-# =============================================================================
-
-# OpenAI (required for default configuration)
-OPENAI_API_KEY=your_openai_api_key_here
-
-# Anthropic (optional - for Claude models)
-# ANTHROPIC_API_KEY=your_anthropic_api_key_here
-
-# Google (optional - for Gemini models)
-# GOOGLE_API_KEY=your_google_api_key_here
-
-# =============================================================================
-# Research Tools API Keys
-# =============================================================================
-
-# Tavily Search (optional - AI-optimized search)
-# Get your API key at: https://tavily.com
-# TAVILY_API_KEY=your_tavily_api_key_here
-
-# =============================================================================
-# Configuration Options
-# =============================================================================
-
-# Default LLM Provider (openai, anthropic, google)
 DEFAULT_LLM_PROVIDER=openai
-
-# Default Model
 DEFAULT_MODEL=gpt-4o
-
-# Default Temperature (0.0 - 1.0)
 DEFAULT_TEMPERATURE=0.0
 
-# Verbose Mode (true/false)
-VERBOSE=true
-
-# =============================================================================
-# API Authentication (Phase 7)
-# =============================================================================
-
-# Agent Factory API Key (required for REST API endpoints)
-# Generate with: poetry run python -c "import secrets; print(f'ak_dev_{secrets.token_hex(16)}')"
-API_KEY=ak_dev_your_generated_key_here
-
-# =============================================================================
-# Voice Production Configuration (PLC Tutor / RIVET)
-# =============================================================================
-
-# Voice Mode: edge (FREE), openai (PAID), elevenlabs (PAID + custom)
-# Use 'edge' until Saturday for FREE Microsoft neural voices
 VOICE_MODE=edge
-
-# Edge-TTS Voice (FREE, 50+ voices available)
-# Options: en-US-GuyNeural (male), en-US-JennyNeural (female), en-GB-RyanNeural, etc.
-# Full list: poetry run edge-tts --list-voices
 EDGE_VOICE=en-US-GuyNeural
-
-# OpenAI TTS Voice (PAID, $15/1M characters)
-# Options: alloy, echo, fable, onyx, nova, shimmer
 OPENAI_VOICE=alloy
 
-# ElevenLabs Configuration (PAID, custom voice clone - add Saturday after training)
-# Get API key at: https://elevenlabs.io
-# ELEVENLABS_API_KEY=your_elevenlabs_api_key_here
-# ELEVENLABS_VOICE_ID=your_voice_clone_id_here
-
-# =============================================================================
-# Telegram Bot Configuration
-# =============================================================================
-
-# Telegram Bot Token (required for Telegram bot)
-# Get from @BotFather on Telegram: /newbot
-TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here
-
-# Rate Limiting (optional)
-TELEGRAM_RATE_LIMIT=10  # Messages per minute per user
-
-# User Whitelist (optional - comma-separated chat IDs)
-# Leave empty to allow all users
-# TELEGRAM_ALLOWED_USERS=12345,67890
+API_KEY=YOUR_INTERNAL_API_KEY
 
-# Logging (optional)
-# TELEGRAM_LOG_CONVERSATIONS=false  # GDPR: keep false in production
+RENDER_API_KEY=YOUR_RENDER_API_KEY
+HOSTINGER_API_TOKEN=YOUR_HOSTINGER_API_TOKEN
 
-# =============================================================================
-# Memory Storage (Supabase)
-# =============================================================================
-
-# Supabase PostgreSQL database (required for cloud memory storage)
-# Get from: https://supabase.com/dashboard/project/_/settings/api
-SUPABASE_URL=your_supabase_project_url_here
-SUPABASE_KEY=your_supabase_anon_key_here
-
-# Alternative: Use service_role key for admin operations (keep secret!)
-# SUPABASE_KEY=your_supabase_service_role_key_here
-
-# Database password for automated migrations (optional but recommended)
-# Get from: https://supabase.com/dashboard/project/_/settings/database
-# Under "Connection string" → Click "eye" icon to reveal password
-# SUPABASE_DB_PASSWORD=your_database_password_here
-
-# Supabase Management API token for automated migrations (optional)
-# Get from: https://supabase.com/dashboard/account/tokens
-# SUPABASE_ACCESS_TOKEN=your_access_token_here
-
-# =============================================================================
-# Ollama (FREE Local LLMs) - RECOMMENDED
-# =============================================================================
-
-# Enable FREE local LLMs instead of paid APIs (set to true)
-USE_OLLAMA=true
-
-# Ollama API endpoint (default: http://localhost:11434)
+PYTHONUNBUFFERED=1
+LOG_LEVEL=INFO
+VERBOSE=true
+USE_OLLAMA=false
 OLLAMA_BASE_URL=http://localhost:11434
-
-# Default Ollama model for coding tasks
-# Options:
-#   - deepseek-coder:6.7b (RECOMMENDED - fast, high quality, 8GB RAM)
-#   - codellama:7b (good, 8GB RAM)
-#   - llama3.1:8b (better reasoning, 12GB RAM)
-#   - deepseek-coder:33b (GPT-4 level, 32GB RAM + GPU)
 OLLAMA_MODEL=deepseek-coder:6.7b
-
-# Setup Instructions:
-#   1. Install Ollama: winget install Ollama.Ollama
-#   2. Pull model: ollama pull deepseek-coder:6.7b
-#   3. Set USE_OLLAMA=true above
-#   4. Run tasks for FREE! (no API costs)
-#
-# See: docs/OPENHANDS_FREE_LLM_GUIDE.md for complete setup guide
-
-# =============================================================================
-# GitHub Issue Automation (Optional)
-# =============================================================================
-
-# Automatically solve GitHub issues with FREE Ollama
-# See: docs/GITHUB_ISSUE_AUTOMATION.md for complete guide
-
-# Labels to auto-solve (comma-separated)
-# Example: GITHUB_AUTO_SOLVE_LABELS=agent-task,good first issue,documentation
-# GITHUB_AUTO_SOLVE_LABELS=
-
-# Auto-approve solutions (DANGEROUS - use with caution!)
-# Set to 'true' only for trusted, simple issues
-# Default: false (requires manual approval)
-GITHUB_AUTO_APPROVE=false
-
-# Auto-push after commit
-# Set to 'true' to automatically push to GitHub
-# Default: false (asks before pushing)
-GITHUB_AUTO_PUSH=false
-
-# Default timeout for issue solving (seconds)
-# Increase for complex issues or slower models
-# Default: 300 (5 minutes)
-GITHUB_SOLVE_TIMEOUT=300
-
-# =============================================================================
-# Advanced Options
-# =============================================================================
-
-# LangSmith (optional - for debugging and monitoring)
-# Get your API key at: https://smith.langchain.com
-# LANGCHAIN_TRACING_V2=true
-# LANGCHAIN_API_KEY=your_langsmith_api_key_here
-# LANGCHAIN_PROJECT=agent-factory
-
-# =============================================================================
-# Notes
-# =============================================================================
-#
-# Free Tools (no API key required):
-# - Wikipedia Search
-# - DuckDuckGo Search
-# - File operations (read, write, list, search)
-# - Git operations
-# - Current time
-#
-# Paid/API Key Required:
-# - OpenAI (ChatGPT) - https://platform.openai.com/api-keys
-# - Anthropic (Claude) - https://console.anthropic.com/
-# - Google (Gemini) - https://makersuite.google.com/app/apikey
-# - Tavily Search - https://tavily.com
-#

.env.production

@@ -0,0 +1,118 @@
+# =============================================================================
+# Agent Factory - Production Environment Variables (VPS/Hostinger)
+# =============================================================================
+#
+# Copy this to .env on your VPS and fill in YOUR actual values
+#
+# CRITICAL: This file contains secrets. Never commit to Git.
+# On VPS, set permissions: chmod 600 .env
+#
+# =============================================================================
+
+# =============================================================================
+# REQUIRED - Bot Will Not Start Without These
+# =============================================================================
+
+# Telegram Bot Token (from @BotFather)
+# Get it: Message @BotFather on Telegram, send /newbot
+TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN_HERE
+
+# Database Connection (Neon PostgreSQL)
+# Get it: https://console.neon.tech → Project → Connection Details → Pooled
+DATABASE_PROVIDER=neon
+NEON_DB_URL=YOUR_NEON_CONNECTION_STRING_HERE
+
+# LLM Provider (for AI agent responses)
+# Using gpt-4o-mini for cost efficiency (~$0.15 per 1M tokens)
+DEFAULT_LLM_PROVIDER=openai
+DEFAULT_MODEL=gpt-4o-mini
+OPENAI_API_KEY=YOUR_OPENAI_API_KEY_HERE
+
+# =============================================================================
+# SECURITY - Recommended for Production
+# =============================================================================
+
+# Limit bot access to specific Telegram user IDs (comma-separated)
+# Get your ID: Message @userinfobot on Telegram
+# Leave empty to allow ALL users (not recommended)
+TELEGRAM_ALLOWED_USERS=YOUR_TELEGRAM_USER_ID_HERE
+
+# Rate limiting (messages per minute per user)
+TELEGRAM_RATE_LIMIT=10
+
+# =============================================================================
+# PYTHON CONFIGURATION
+# =============================================================================
+
+PYTHONUNBUFFERED=1
+PYTHONDONTWRITEBYTECODE=1
+LOG_LEVEL=INFO
+
+# =============================================================================
+# VOICE PRODUCTION (Optional - for content generation features)
+# =============================================================================
+
+# Voice Mode: edge (FREE), openai (PAID ~$15/1M chars), elevenlabs (PAID + custom)
+# Use 'edge' for FREE Microsoft neural voices
+VOICE_MODE=edge
+
+# Edge-TTS Voice Selection (50+ voices available)
+# Popular options:
+#   en-US-GuyNeural (male, professional)
+#   en-US-JennyNeural (female, friendly)
+#   en-GB-RyanNeural (male, British)
+# List all: edge-tts --list-voices
+EDGE_VOICE=en-US-GuyNeural
+
+# =============================================================================
+# OPTIONAL - Additional LLM Providers
+# =============================================================================
+
+# Anthropic Claude (optional - for high-quality reasoning tasks)
+# ANTHROPIC_API_KEY=your_anthropic_key_here
+
+# Google Gemini (optional - for multimodal tasks)
+# GOOGLE_API_KEY=your_google_key_here
+
+# =============================================================================
+# OPTIONAL - Research Tools
+# =============================================================================
+
+# Tavily Search (optional - AI-optimized web search)
+# Get key: https://tavily.com
+# TAVILY_API_KEY=your_tavily_key_here
+
+# Firecrawl (optional - web scraping for knowledge ingestion)
+# FIRECRAWL_API_KEY=your_firecrawl_key_here
+
+# =============================================================================
+# DO NOT SET THESE (Auto-configured by Docker/VPS)
+# =============================================================================
+# PORT - Docker sets this automatically
+# SUPABASE_URL - Using Neon instead
+# SUPABASE_KEY - Using Neon instead
+
+# =============================================================================
+# NOTES
+# =============================================================================
+#
+# Minimal setup (3 variables):
+#   TELEGRAM_BOT_TOKEN=...
+#   NEON_DB_URL=...
+#   OPENAI_API_KEY=...
+#
+# Recommended setup (5 variables):
+#   Add TELEGRAM_ALLOWED_USERS and TELEGRAM_RATE_LIMIT
+#
+# Full setup (8+ variables):
+#   Add ANTHROPIC_API_KEY, GOOGLE_API_KEY, TAVILY_API_KEY for max capability
+#
+# Cost estimate (minimal setup):
+#   - Neon database: $0/mo (free tier, 3GB)
+#   - OpenAI gpt-4o-mini: $1-5/mo (depends on usage)
+#   - Total: ~$1-5/mo
+#
+# After filling in values, save and run:
+#   docker-compose up -d
+#
+# =============================================================================