🔧 Configuration Management & Backend Selection Fixes
Critical Issues Resolved
- Fixed Cloudflare backend fallback issue: Service no longer falls back to SQLite-vec despite correct configuration
- Added automatic .env file loading: Configuration module now automatically loads environment variables
- Fixed CLI parameter precedence: Environment variables now properly respected over CLI defaults
- Enhanced content size management: Added guidance for Cloudflare's stricter content limits
Key Benefits for Users
- ✅ Seamless backend switching: Cloudflare configuration works reliably out of the box
- ✅ Fewer configuration errors: Automatic environment loading reduces setup friction
- ✅ Better error diagnosis: Clear guidance on content size limits and chunking strategies
- ✅ Improved reliability: Configuration precedence issues eliminated
Technical Improvements
- Automatic dotenv loading with graceful fallback if python-dotenv not available
- CLI defaults respect environment - changed
--storage-backenddefault to None - Enhanced context provider with Cloudflare-specific constraints and best practices
- Better error handling and configuration validation
Breaking Changes
None - all changes maintain backward compatibility.
Migration Notes
- No action required for existing installations
- New installations benefit from automatic .env loading
- CLI behavior improved but remains compatible
For full technical details, see CHANGELOG.md.