Python Engineering
- Use the project’s existing environment and packaging system; do not introduce a second one.
- Add type hints at public boundaries and structured validation for external data.
- Use pathlib, context managers, explicit timeouts, and subprocess argument arrays where possible.
- Preserve exception context and return actionable errors.
- Cover platform-specific behavior and clean shutdown for long-running processes.
- Run formatter/linter/type checker/tests configured by the repository.