📖 Description

We need to enhance the platform's logging system to support file-based logging, allow filtering logs by level, and report any failures during log setup. This will improve debugging, monitoring, and maintainability.

✅ Objectives

• Implement file-based logging
• Logs should be written to a configurable file path
• Support rotation or size limits (stretch goal for now)
• Add log level filtering
• Support standard levels: DEBUG, INFO, WARNING, ERROR, CRITICAL
• Allow configuration via environment variable or config file
• Handle log setup failures
• Detect errors during initialization (e.g., file write permissions)
• Report failures clearly to the user or system
• Ensure all core modules use the new logging mechanism
• Write tests
  • Unit tests for file logging and log level filtering
  • Integration tests to validate log output and setup failure reporting

🎯 Acceptance Criteria

• File-based logging is functional and configurable
• Log filtering by level works as expected
• Errors during log setup are reported clearly
• Unit and integration tests are provided and passing
• Documentation updated for configuration and usage