Python Type-Safety Review

Use these rules only after reading the changed code. Prefer findings that would be caught by a type checker or prevent a realistic runtime bug.

Review Rules

Rule: type-public-signatures

Impact: MEDIUM-HIGH Applies when: Public functions, methods, classes, or exported helpers are added or changed. Skip when: The code is private test scaffolding or a throwaway script with no typed boundary. Python: any Tools: mypy | pyright | project-configured Review signal: Public parameters or return values are unannotated, especially at package/API boundaries.