Python Tooling

Priority: P1 (HIGH)

Rules

• Keep one authoritative dependency surface per environment and audit every tracked requirements file.
• Prefer ruff for lint plus import hygiene; use pyright or basedpyright for type feedback.
• Run pytest plus python -m compileall for runtime Python changes.
• Add smoke or security gates when the change touches workflow/runtime behavior.

Verification Workflow

1. Lint with ruff check.
2. Type-check with pyright or basedpyright where configured.
3. Run focused pytest scope for changed behavior.
4. Run python -m compileall -q ... for changed runtime trees.
5. Run security or smoke gates when auth, workflow runtime, or dependency surfaces change.