chore(dev): add .pre-commit-config with black, ruff, shellcheck; Makefile hook target; docs

Author: haasonsaas

.pre-commit-config.yaml

@@ -0,0 +1,25 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-merge-conflict
+      - id: check-yaml
+
+  - repo: https://github.com/psf/black
+    rev: 24.8.0
+    hooks:
+      - id: black
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.3
+    hooks:
+      - id: ruff
+        args: ["--fix"]
+
+  - repo: https://github.com/shellcheck-py/shellcheck-py
+    rev: v0.10.0.1
+    hooks:
+      - id: shellcheck
+        files: "^scripts/.*\\.sh$"

Makefile

@@ -1,7 +1,7 @@
 PY?=python3
 VENV?=venv
 
-.PHONY: bootstrap bootstrap-prod test lint fmt ci chat config clean
+.PHONY: bootstrap bootstrap-prod test lint fmt ci chat config hooks clean
 
 bootstrap:
 	@bash scripts/bootstrap_venv.sh dev $(PY)
@@ -26,6 +26,9 @@ chat:
 config:
 	@$(VENV)/bin/python -m orbit_agent.cli config-info
 
+hooks:
+	@$(VENV)/bin/pre-commit install && echo "pre-commit hooks installed"
+
 clean:
 	rm -rf $(VENV) __pycache__ .pytest_cache
 	find . -name "*.pyc" -delete

README.md

@@ -127,7 +127,7 @@ docker run -p 5000:5000 --env-file .env orbit-agent
 ## Contributing
 
 ```bash
-# Install development dependencies
+# Install development dependencies  
 pip install -r requirements-dev.txt
 
 # Run tests
@@ -137,4 +137,12 @@ pytest -q
 black .
 ruff check .
 mypy .
+
+# Optional: set up git hooks (pre-commit)
+pre-commit install
+# or via Makefile (after bootstrapping venv):
+make hooks
+
+# Run all hooks against the repo
+pre-commit run -a
 ```