chore: add commit-hooks and CI for generated docs

Author: alejandrodnm

.github/workflows/ci.yml

@@ -156,6 +156,15 @@ jobs:
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
 
+      - name: Check if docs are outdated
+        run: |
+          just pgai generate-docs
+          if git diff --name-only HEAD -- projects/pgai/docs/.generated-files.txt | grep -q . ; then
+            echo "::error:: Documentation is out of date. Please run 'just pgai generate-docs', or install the git hooks 'just install-git-hooks' and commit"
+            exit 1
+          fi
+          echo "Documentation is up to date!"
+
   build-and-test-pgai-db-module:
     needs: authorize
     runs-on: ubuntu-latest
@@ -222,4 +231,4 @@ jobs:
           source venv/bin/activate
           pip install --upgrade pip
           pip install -e .
-        working-directory: ./projects/pgai
+        working-directory: ./projects/pgai

.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+default_install_hook_types:
+  - pre-commit
+  - commit-msg
+
+repos:
+  - repo: local
+    hooks:
+      - id: update-docs
+        name: Update pydoc-markdown documentation
+        entry: bash -c 'uv tool run pydoc-markdown && git add docs/api.md'
+        language: system
+        files: ^projects/pgai/pgai/.*\.py$
+        pass_filenames: false
+        stages: [pre-commit]
+
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v4.2.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+        args: [--verbose]

justfile

@@ -19,6 +19,5 @@ ci:
 
 # Install semantic commit message hook
 @install-commit-hook:
-  curl --fail -s -o .git/hooks/commit-msg https://raw.githubusercontent.com/hazcod/semantic-commit-hook/master/commit-msg
-  chmod u+x .git/hooks/commit-msg
-  echo "commit-msg hook installed"
+  uv tool install pre-commit
+  uv tool run pre-commit install