feat: add integration tests to pre-commit hook

Runs pnpm run test:integration when TypeScript files are staged.
Skips gracefully with a warning if PostgreSQL is not running on
port 5432, so developers without Docker running can still commit.

Author: chrisdburr

.pre-commit-config.yaml

@@ -59,6 +59,17 @@ repos:
         exclude: '\.next/'
         pass_filenames: false
 
+  # Integration tests (requires Docker PostgreSQL on port 5432)
+  - repo: local
+    hooks:
+      - id: integration-tests
+        name: integration tests (requires Docker PostgreSQL)
+        entry: ./scripts/run-integration-tests.sh
+        language: script
+        files: '\.(ts|tsx)$'
+        exclude: '(node_modules|\.next|e2e)/'
+        pass_filenames: false
+
   # File cleanup (last, so it doesn't interfere with other tools)
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: 'v5.0.0'

lib/element-compatibility.ts

@@ -1,7 +1,7 @@
 /**
  * Element parent-child compatibility rules.
  *
- * Pure function module — no Prisma, importable by both client and server.
+ * Pure function module — no Prisma dependency, importable by both client and server.
  *
  * Hierarchy:
  *   goal          → strategy, property_claim

scripts/run-integration-tests.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# Pre-commit hook: run integration tests if PostgreSQL is available.
+# Skips gracefully when Docker PostgreSQL is not running.
+
+if ! pg_isready -h localhost -p 5432 -q 2>/dev/null; then
+  echo "⚠ Skipping integration tests — PostgreSQL not running on port 5432"
+  echo "  Start it with: docker-compose -f docker-compose.local.yml up -d tea_postgres"
+  exit 0
+fi
+
+pnpm run test:integration