docs: add WHY explanations and improve code documentation

- Add WHY comment for team info enrichment in label multi-team display (label.py)
- Add WHY comment explaining local imports to avoid circular dependencies (project.py)
- Add WHY comment explaining dual-approach project lookup strategy (client.py)
- Add WHY comment for efficiency reasoning in two-query approach (client.py)
- Add documentation for FIND_PROJECT_BY_NAME_QUERY purpose (queries.py)
- Apply ruff formatting for consistent code style
- Add type safety improvements with proper dict conversions

This addresses all documentation requirements from code quality review,
providing clear context for design decisions and implementation choices.

Author: AdiKsOnDev