General guidelines

Coding Style

• Always write clean, readable, well separated, well organized, Pythonic code.
• Don't run linters or formatters, they will run automatically after every edit by the harness.
• When using datetime, import it like this: import datetime as dt
• CRITICAL: ALWAYS put ALL imports at the top of the file, NEVER inside functions, methods, or any other block. No exceptions. Use TYPE_CHECKING guard for type-only imports to avoid circular dependencies.

Type hints