Add setup scripts for Git hooks in package.json and update README with development instructions

- Added "prepare" and "setup:hooks" scripts to package.json for configuring Git hooks.
- Updated README to include instructions on running `pnpm install` for hook setup and details about the pre-commit hook functionality.

Author: phpnode

.githooks/pre-commit

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+repo_root="$(git rev-parse --show-toplevel)"
+cd "$repo_root"
+
+staged_files=()
+while IFS= read -r -d '' file; do
+  case "$file" in
+    *.cjs|*.css|*.cts|*.html|*.js|*.json|*.jsonc|*.jsx|*.md|*.mdx|*.mjs|*.mts|*.scss|*.ts|*.tsx|*.yaml|*.yml)
+      if [[ -f "$file" ]]; then
+        staged_files+=("$file")
+      fi
+      ;;
+  esac
+done < <(git diff --cached --name-only --diff-filter=ACMR -z)
+
+if (( ${#staged_files[@]} == 0 )); then
+  exit 0
+fi
+
+echo "Formatting staged files with oxfmt"
+pnpm exec oxfmt --write -- "${staged_files[@]}"
+git add -- "${staged_files[@]}"

README.md

@@ -38,6 +38,12 @@ A fully typed, in-memory graph database. Vertices and edges are strongly typed a
 pnpm add @codemix/graph
 ```
 
+### Development
+
+Running `pnpm install` in the monorepo configures Git to use the tracked hooks in `.githooks`.
+
+The pre-commit hook formats staged supported source files with `oxfmt` and restages them automatically. You can re-run the hook setup at any time with `pnpm run setup:hooks`.
+
 ### Quick Start
 
 ```typescript

package.json

@@ -11,8 +11,10 @@
   "scripts": {
     "build": "pnpm run -r build",
     "changeset": "changeset",
+    "prepare": "sh ./scripts/setup-git-hooks.sh",
     "version-packages": "changeset version",
     "release": "pnpm build && changeset publish",
+    "setup:hooks": "sh ./scripts/setup-git-hooks.sh",
     "typecheck": "pnpm run -r typecheck",
     "test": "vitest",
     "test:coverage": "vitest run --coverage",

scripts/setup-git-hooks.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env sh
+
+set -eu
+
+if ! command -v git >/dev/null 2>&1; then
+  exit 0
+fi
+
+if ! git rev-parse --show-toplevel >/dev/null 2>&1; then
+  exit 0
+fi
+
+repo_root="$(git rev-parse --show-toplevel)"
+cd "$repo_root"
+
+current_hooks_path="$(git config --get core.hooksPath || true)"
+if [ "$current_hooks_path" = ".githooks" ]; then
+  exit 0
+fi
+
+git config core.hooksPath .githooks
+echo "Configured Git hooks to use .githooks"