.env.example missing required configuration options

[MasuRii]

The .env.example file does not include all existing .env configurations that users need to set, making it difficult for new users to know what values must be configured.

Target branch: dev

[mirrobot-agent]

@MasuRii Thank you for submitting this issue. I am now beginning my analysis and will report back shortly.

[mirrobot-agent]

Initial Analysis Report

Summary: The .env.example file is missing several documented and undocumented environment variables used throughout the codebase, including timeout configurations, provider-specific OAuth settings, Antigravity/Gemini CLI advanced settings, and special processing flags.

Issue Validation: Confirmed

Reproducibility Assessment: Reproducible - By comparing the environment variables defined in .env.example with those used in the source code (src/), the missing variables are easily identifiable.

Root Cause Analysis:
The .env.example file (253 lines) has not been updated to include several environment variables that have been added over time. After analyzing the codebase, the following categories of environment variables are missing:

1. Timeout Configuration (src/rotator_library/timeout_config.py:6-10):

• TIMEOUT_CONNECT - Connection establishment timeout (default: 30s)
• TIMEOUT_WRITE - Request body send timeout (default: 30s)
• TIMEOUT_POOL - Connection pool acquisition timeout (default: 60s)
• TIMEOUT_READ_STREAMING - Read timeout for streaming (default: 180s)
• TIMEOUT_READ_NON_STREAMING - Read timeout for non-streaming (default: 600s)

2. Antigravity Provider Settings (src/proxy_app/settings_tool.py:432-493):

• ANTIGRAVITY_SIGNATURE_CACHE_TTL - Memory cache TTL for thought signatures
• ANTIGRAVITY_SIGNATURE_DISK_TTL - Disk cache TTL for thought signatures
• ANTIGRAVITY_PRESERVE_THOUGHT_SIGNATURES - Preserve thought signatures
• ANTIGRAVITY_ENABLE_SIGNATURE_CACHE - Enable signature caching
• ANTIGRAVITY_ENABLE_DYNAMIC_MODELS - Enable dynamic model discovery
• ANTIGRAVITY_GEMINI3_TOOL_FIX - Enable Gemini 3 tool hallucination prevention
• ANTIGRAVITY_CLAUDE_TOOL_FIX - Enable Claude tool hallucination prevention
• ANTIGRAVITY_CLAUDE_THINKING_SANITIZATION - Sanitize thinking blocks
• ANTIGRAVITY_GEMINI3_TOOL_PREFIX - Prefix for Gemini 3 tool names
• ANTIGRAVITY_GEMINI3_DESCRIPTION_PROMPT - Template for strict parameter hints
• ANTIGRAVITY_CLAUDE_DESCRIPTION_PROMPT - Template for Claude parameter hints
• ANTIGRAVITY_GEMINI3_STRICT_SCHEMA - Enable strict schema mode
• ANTIGRAVITY_OAUTH_PORT - Local port for OAuth callback
• ANTIGRAVITY_PROJECT_ID - GCP Project ID for Antigravity paid tiers

3. Gemini CLI Provider Settings (src/proxy_app/settings_tool.py:496-542):

• GEMINI_CLI_SIGNATURE_CACHE_TTL - Memory cache TTL for signatures
• GEMINI_CLI_SIGNATURE_DISK_TTL - Disk cache TTL for signatures
• GEMINI_CLI_PRESERVE_THOUGHT_SIGNATURES - Preserve thought signatures
• GEMINI_CLI_ENABLE_SIGNATURE_CACHE - Enable signature caching
• GEMINI_CLI_GEMINI3_TOOL_FIX - Enable Gemini 3 tool fix
• GEMINI_CLI_GEMINI3_TOOL_PREFIX - Prefix for Gemini 3 tool names
• GEMINI_CLI_GEMINI3_DESCRIPTION_PROMPT - Template for parameter hints
• GEMINI_CLI_GEMINI3_STRICT_SCHEMA - Enable strict schema mode
• GEMINI_CLI_OAUTH_PORT - Local port for OAuth callback

4. Other Missing Variables:

• MODEL_INFO_REFRESH_INTERVAL - Refresh interval for model info (src/rotator_library/model_info_service.py:911)
• OVERRIDE_TEMPERATURE_ZERO - Handle temperature=0 in requests (src/proxy_app/main.py:862)
• PROVIDER_API_BASE - Custom API base URLs for providers (dynamic: {PROVIDER}_API_BASE)

Suggested Labels:

• documentation - This is a documentation gap in the example configuration file
• good first issue - The fix involves adding well-defined environment variables to an existing file
• enhancement - Improves the developer experience for new users

Proposed Next Steps:

1. Add all missing environment variables to .env.example with appropriate comments and default values
2. Group the new variables into logical sections (e.g., "Timeout Configuration", "Antigravity Provider Settings")
3. Consider using the definitions from src/proxy_app/settings_tool.py as the source of truth for descriptions
4. Update any corresponding documentation (README.md, DOCUMENTATION.md) if needed
5. Target the dev branch as specified by the issue author

Missing Information (if any):
None - The issue is clear and actionable. The scope is well-defined.

---

This analysis was generated by an AI assistant.