feat: Add hooks to project (pre-commit / Lefthook / etc)

[kzndotsh]

🚀 Feature Request

It would be beneficial to add automated git hooks to this project. This would help enforce code quality, formatting, linting, and other checks before changes are committed or pushed.

Recommended Tools:

• pre-commit
• Lefthook

Potential Steps:

1. Decide between pre-commit, Lefthook, or another tool.
2. Configure common hooks:
   • Lint checks
   • Code formatting (e.g., ruff, markdownlint, etc)
   • Type checking (if applicable, e.g., pyright/mypy)
   • Test runner (optional)
3. Add setup instructions to the README.
4. Ensure hooks are easy to install (document or automate).

Benefits:

• Improved code quality and consistency.
• Reduced review overhead.
• Early detection of issues.

---

Tasks:

• Research and select a hook management tool
• Configure basic hooks
• Update documentation
• Add installation/setup instructions

Reference:

• https://git-scm.com/book/ms/v2/Customizing-Git-Git-Hooks

[kzndotsh]

Lately I started testing out lefthook because of it's customization level, see: https://github.com/allthingslinux/infra/blob/main/.lefthook.yml

However, tux uses pre-commit and that is pretty standard/easy with a wide range of already existing hooks: https://github.com/allthingslinux/tux/blob/main/.pre-commit-config.yaml

The benefit of pre-commit is also that they provide a CI version that can run in the CI as a extra step that can automate formatting/linting and hook version updates if desired: https://pre-commit.ci/