feat: enforce conventional commits

[AnnoDomine]

Description

Configures and enforces pre-commit hooks for code quality and Conventional Commits 1.0.0 validation. Developers can now initialize the entire dev environment and hook setup in a single command using uv run pre-commit install.

Additional it includes the CI action for semantic pull request title, to enforce the PR titel follows the conventional commits for more easy merge of PRs.

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update

Key Changes

• Pre-commit Setup: Expand .pre-commit-config.yaml with default_install_hook_types configured for pre-commit and commit-msg.
• Commit Validation: Integrated hook to enforce Conventional Commits 1.0.0 on all commit messages.
• Dependency Management: Added pre-commit to dev dependencies in pyproject.toml managed by uv.
• Documentation: Updated contributing guidelines with Commit Message Guidelines (format reference, types, body rules, examples) and onboarding instructions (uv run pre-commit install).

Validation

1. Hook Installation:
   • Ran uv run pre-commit install in a clean environment.
   • Verified that .git/hooks/pre-commit and .git/hooks/commit-msg were successfully created.
2. Commit Message Validation:
   • Tested invalid commit message: git commit -m "bad commit message" $\rightarrow$ Rejected as expected.
   • Tested valid Conventional Commit: git commit -m "docs: update contributing guide" $\rightarrow$ Passed successfully.
3. Pre-commit Checks:
   • Executed uv run pre-commit run --all-files $\rightarrow$ All hooks passed.

git commit -S -m "bla bla "
[WARNING] Unstaged files detected.
[INFO] Stashing unstaged files to XXXXXXXXXXXXXXXXXXXXXX.
ty.......................................................................Passed
pytest...................................................................Passed
ruff.....................................................................Passed
ruff-format..............................................................Passed
[INFO] Restored changes from XXXXXXXXXXXXXXXXXXXXXX.
[WARNING] Unstaged files detected.
[INFO] Stashing unstaged files to XXXXXXXXXXXXXXXXXXXXXX.
Conventional Commit......................................................Failed
- hook id: conventional-pre-commit
- exit code: 1

[Bad commit message] >> bla bla
Your commit message does not follow Conventional Commits formatting
https://www.conventionalcommits.org/

git commit -S -m "docs(guideline): added setup command and adjust branch policy in guidelines"
uv-lock..............................................(no files to check)Skipped
ty.......................................................................Passed
pytest...................................................................Passed
ruff.....................................................................Passed
ruff-format..............................................................Passed
uv-lock..............................................(no files to check)Skipped
Conventional Commit......................................................Passed

Checklist

• I reviewed the diff and kept it focused on the described change.
• Python changes pass uv run ruff check . and uv run ruff format --check ., or this PR does not change Python.
• Changed behavior is covered by appropriate tests, including a regression test for bug fixes; any limitations are explained under Validation.
• Validation lists the checks or manual flows I ran and their results.
• Relevant documentation is updated, or no documentation change is needed.

Closes: #236

[Airbag65]

Great addition @AnnoDomine!

[mattsva]

Thats greate. I love it