fix: restore player search functionality and add HF frontmatter

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

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