chore: add husky pre-commit and pre-push hooks

.husky/pre-commit

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+
+composer pint:check && composer phpstan

.husky/pre-push

@@ -0,0 +1,33 @@
+#!/usr/bin/env sh
+
+# Abort push when the test database is unreachable, so broken code never
+# reaches CI. Test DB settings come from phpunit.xml.
+php -r '
+$xml = @simplexml_load_file("phpunit.xml");
+if ($xml === false) {
+    fwrite(STDERR, "phpunit.xml not found — aborting pre-push.\n");
+    exit(1);
+}
+
+$defaults = ["DB_HOST" => "127.0.0.1", "DB_PORT" => "5432", "DB_DATABASE" => "amare_test", "DB_USERNAME" => "amare", "DB_PASSWORD" => "secret"];
+$env = [];
+foreach ($xml->php->env as $node) {
+    $name = (string) $node["name"];
+    if (isset($defaults[$name])) {
+        $env[$name] = (string) $node["value"];
+    }
+}
+$config = array_merge($defaults, $env);
+
+$dsn = sprintf("pgsql:host=%s;port=%s;dbname=%s", $config["DB_HOST"], $config["DB_PORT"], $config["DB_DATABASE"]);
+try {
+    new PDO($dsn, $config["DB_USERNAME"], $config["DB_PASSWORD"], [PDO::ATTR_TIMEOUT => 3]);
+} catch (PDOException $e) {
+    fwrite(STDERR, "\033[31mPostgreSQL is unreachable on {$config["DB_HOST"]}:{$config["DB_PORT"]} (db: {$config["DB_DATABASE"]}).\033[0m\n");
+    fwrite(STDERR, "Start it with: docker compose up -d\n");
+    fwrite(STDERR, "Then retry the push.\n");
+    exit(1);
+}
+' || exit 1
+
+composer test:unit && composer test:feature

AGENTS.md

@@ -15,6 +15,13 @@ This is a Laravel 13 application for an event-planning consultancy. Application
 
 Feature and browser tests require the `amare_test` PostgreSQL database configured in `phpunit.xml`.
 
+## Git Hooks (husky)
+
+Hooks live in `.husky/` and auto-install on any plain `npm install` via the `prepare` script. Note `composer setup` runs `npm install --ignore-scripts`, which skips hook installation — after setup, run `npm install` once (or `npx husky`) to activate hooks.
+
+- `pre-commit`: runs `composer pint:check` and `composer phpstan`.
+- `pre-push`: gates on the `amare_test` database (settings parsed from `phpunit.xml`), blocks the push with a `docker compose up -d` hint when Postgres is unreachable, then runs `composer test:unit` and `composer test:feature`. Browser tests are CI-only (FrankenPHP container).
+
 ## Coding Style & Naming Conventions
 
 Follow PSR-4 and Laravel conventions: PascalCase classes, camelCase methods, and snake_case database columns. Use four spaces (two in YAML, except four in Compose files), LF endings, and UTF-8 as defined by `.editorconfig`. Every project-owned PHP file must place `declare(strict_types=1);` immediately after `<?php`. Keep domain code independent of Filament and Livewire. Run `composer pint` to format and `composer phpstan` before review.

package-lock.json

@@ -7,6 +7,7 @@
             "devDependencies": {
                 "@tailwindcss/vite": "^4.0.0",
                 "concurrently": "^9.0.1",
+                "husky": "^9.1.7",
                 "laravel-vite-plugin": "^3.1",
                 "playwright": "^1.62.0",
                 "tailwindcss": "^4.0.0",
@@ -890,6 +891,22 @@
                 "node": ">=8"
             }
         },
+        "node_modules/husky": {
+            "version": "9.1.7",
+            "resolved": "https://registry.npmjs.org/husky/-/husky-9.1.7.tgz",
+            "integrity": "sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA==",
+            "dev": true,
+            "license": "MIT",
+            "bin": {
+                "husky": "bin.js"
+            },
+            "engines": {
+                "node": ">=18"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/typicode"
+            }
+        },
         "node_modules/is-fullwidth-code-point": {
             "version": "3.0.0",
             "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",

package.json

@@ -4,11 +4,13 @@
     "type": "module",
     "scripts": {
         "build": "vite build",
-        "dev": "vite"
+        "dev": "vite",
+        "prepare": "husky"
     },
     "devDependencies": {
         "@tailwindcss/vite": "^4.0.0",
         "concurrently": "^9.0.1",
+        "husky": "^9.1.7",
         "laravel-vite-plugin": "^3.1",
         "playwright": "^1.62.0",
         "tailwindcss": "^4.0.0",

tasks.md

@@ -0,0 +1,8 @@
+# Tasks: Git hooks (pre-commit + pre-push)
+
+- [x] Install husky + add prepare script
+- [x] Create .husky/pre-commit (pint + phpstan)
+- [x] Create .husky/pre-push (DB gate + tests)
+- [x] Install hooks into repo, chmod +x
+- [x] Verify hooks (DB up/down, pre-commit)
+- [x] Document hooks in AGENTS.md