chore(hooks): enforce Conventional Commits with pre-commit hook

Add conventional-pre-commit hook to validate commit messages against
the Conventional Commits spec already documented in CONTRIBUTING.md.

Closes: #974
Signed-off-by: Josef Skladanka <jskladan@redhat.com>
Co-Authored-By: Claude <claude@anthropic.com>

Author: jskladan

.pre-commit-config.yaml

@@ -1,3 +1,5 @@
+default_install_hook_types: [pre-commit, commit-msg]
+
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v6.0.0
@@ -46,6 +48,23 @@ repos:
       - id: ruff-format
         types_or: [python, pyi]
 
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v4.4.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+        args:
+          - feat
+          - fix
+          - docs
+          - test
+          - refactor
+          - perf
+          - chore
+          - ci
+          - build
+          - revert
+
   - repo: local
     hooks:
       - id: hatch-mypy

CONTRIBUTING.md

@@ -78,20 +78,21 @@ git push origin feat/<short-description>
 
 ### Pre-commit Hook (Recommended)
 
-To ensure quality checks run automatically before each commit, install the pre-commit hook that runs both linting and mypy type checking:
+To ensure quality checks run automatically before each commit, install the pre-commit hooks that run linting, mypy type checking, and commit message validation:
 
 ```bash
-# Install the pre-commit hook (run once after cloning)
+# Install pre-commit hooks (run once after cloning)
 hatch run lint:install-hooks
 
-# The hook automatically runs a selection of linters before each commit.
+# The hooks automatically run linters before each commit and validate
+# that commit messages follow Conventional Commits format.
 
-# If the hook fails, it will prevent the commit and show helpful messages
-# You can fix some issues automatically with:
+# If a hook fails, it will prevent the commit and show helpful messages.
+# You can fix formatting issues automatically with:
 hatch run lint:fix
 ```
 
-The pre-commit hook prevents commits that would fail some CI quality checks, saving time and ensuring consistent code quality.
+The pre-commit hooks prevent commits that would fail CI quality checks, and enforce that all commit messages follow the [Conventional Commits](https://www.conventionalcommits.org/) format documented in the [Commit Guidelines](#commit-guidelines) section.
 
 ---