Improve Makefile and add pre-commit hooks

[rezkam]

Summary

• Consolidate all Makefile documentation commands into main Makefile
• Remove docs/sphinx/Makefile (all functionality moved to main Makefile)
• Add automated pre-commit hooks for code quality enforcement

Changes

Makefile Improvements

• Move Sphinx build commands from docs/sphinx/Makefile to main Makefile
• Add Sphinx variables (SPHINXBUILD, SOURCEDIR, BUILDDIR) to main Makefile
• Update docs target to call sphinx-build directly
• Remove docs-clean target (clean command now handles everything)
• Enhance clean target to remove all build and documentation artifacts
• Delete docs/sphinx/Makefile completely

Pre-commit Hook

• Add pre-commit hook in .githooks/ directory that automatically runs:
  • Auto-formatting with black and isort
  • Linting with flake8
  • Type checking with mypy
  • Full test suite with pytest
• Add make setup-hooks command to configure git hooks path
• Use core.hooksPath approach for version-controlled hooks

Setup

Developers need to run make setup-hooks once after cloning to enable the pre-commit hook.

Test plan

• Makefile commands work correctly
• Pre-commit hook runs successfully on commit
• All quality checks pass (formatting, linting, type checking, tests)