chore: adding git hooks

Author: orest-tokovenko-block

.githooks/commit-msg

@@ -0,0 +1,18 @@
+#!/bin/sh
+
+commit_msg=$(head -1 "$1")
+
+if ! echo "$commit_msg" | grep -qE '^(feat|fix|chore|docs|ci|test|refactor|perf|build|style|revert)(\(.+\))?(!)?: .+'; then
+  echo "ERROR: Commit message must follow Conventional Commits format"
+  echo ""
+  echo "  <type>[optional scope][!]: <description>"
+  echo ""
+  echo "  Types: feat, fix, chore, docs, ci, test, refactor, perf, build, style, revert"
+  echo ""
+  echo "  Examples:"
+  echo "    feat: add dashboard endpoints"
+  echo "    fix(models): handle null chart_settings"
+  echo "    feat!: rename VantageSDK to VantageClient"
+  echo ""
+  exit 1
+fi

CONTRIBUTORS.md

@@ -2,7 +2,13 @@
 
 ## Development Setup
 
-Install the sdk locally and run tests when you finish making changes:
+```bash
+just setup
+```
+
+This configures git hooks that enforce [Conventional Commits](https://www.conventionalcommits.org/) on commit messages (see [Releases](#releases)).
+
+To run all checks (format, lint, typecheck, test):
 
 ```bash
 uv run nox

justfile

@@ -37,6 +37,11 @@ typecheck-tests:
 
 check: format lint typecheck test
 
+# --- Setup ---
+
+setup:
+  git config core.hooksPath .githooks
+
 # --- Code Generation ---
 
 generate-models: