fix: restore player search functionality and add HF frontmatter

fix: resolve linting errors and update ruff config

Optimize away team generation and persist in session state to prevent loops

Prepare for Hugging Face Spaces deployment: add metadata and fix model path

Address reviewer feedback: fix grammar, path resolution, and sampling logic

Transition data layer to local CSV using pandas

Fix CI failures: type annotations, linting, and coverage threshold

test fixes

Refactor app with security fixes, error handling, and type safety