refactor(cinema_planner): fix all ruff violations, add type hints, docstrings, logging

- Replace print() with logging module
- Add type annotations to all functions
- Add Google-style docstrings to all public functions/classes
- Extract magic numbers into named constants
- Break complex functions into smaller helpers
- Use Path.open() instead of open()
- Use contextlib.suppress where appropriate

python_pkg/cinema_planner/__init__.py

@@ -1 +1 @@
-# Cinema Planner package initialization
+"""Cinema Planner - maximize movies watched in a day."""