feat: add husky to the project

Author: albegosu

.husky/pre-commit

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+set -e
+
+pnpm lint-staged
+pnpm typecheck

.husky/pre-push

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+set -e
+
+pnpm ci:check

.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+# Optional Python runner: pip install pre-commit && pre-commit install && pre-commit install --hook-type pre-push
+# Default: Husky hooks installed via `pnpm install` (see .husky/)
+repos:
+  - repo: local
+    hooks:
+      - id: lint-staged
+        name: lint-staged
+        entry: pnpm exec lint-staged
+        language: system
+        pass_filenames: false
+      - id: typecheck
+        name: typecheck
+        entry: pnpm typecheck
+        language: system
+        pass_filenames: false
+      - id: ci-check
+        name: ci:check (mirror GitHub Actions)
+        entry: pnpm ci:check
+        language: system
+        pass_filenames: false
+        stages: [pre-push]

CONTRIBUTING.md

@@ -59,15 +59,23 @@ from-zero-rag/
 1. **Fork** the repository
 2. **Create a branch** from `main`: `git checkout -b feat/your-feature`
 3. **Make your changes**
-4. **Verify** before pushing:
+4. **Verify** before pushing (same checks as [CI](.github/workflows/ci.yml)):
 
 ```bash
-# Production build (includes type checking via Nuxt build)
-pnpm build
+# Full pipeline (lint, typecheck, tests, eval, build)
+pnpm ci:check
+```
+
+Git hooks run automatically after `pnpm install` (via [Husky](https://typicode.github.io/husky/)):
 
-# Unit tests (chunking, text utils, agent commands)
-pnpm test
+| Hook | Command |
+|------|---------|
+| `pre-commit` | `lint-staged` + `typecheck` |
+| `pre-push` | `pnpm ci:check` |
 
+Optional [pre-commit](https://pre-commit.com/) (Python): `pip install pre-commit && pre-commit install && pre-commit install --hook-type pre-push` — uses `.pre-commit-config.yaml` with the same commands.
+
+```bash
 # Docs site (if you change docs/**)
 pnpm docs:build
 

composables/useSearchParams.ts

@@ -4,6 +4,7 @@ export interface SearchParamsConfig {
   hybridAlpha: number
   mmrLambda: number
   embeddingDims: number
+  embeddingProvider: string
   hybridEnabled: boolean
   rerankEnabled: boolean
   overFetch: number

package.json

@@ -9,7 +9,9 @@
     "build": "nuxt build",
     "start": "node .output/server/index.mjs",
     "generate": "nuxt generate",
+    "prepare": "husky",
     "postinstall": "nuxt prepare && prisma generate",
+    "ci:check": "pnpm lint && pnpm typecheck && pnpm test && pnpm eval && SKIP_ENV_VALIDATION=true pnpm build",
     "db:migrate": "prisma migrate dev",
     "db:deploy": "prisma migrate deploy",
     "db:generate": "prisma generate",
@@ -56,22 +58,24 @@
   "devDependencies": {
     "@eslint/js": "^9.22.0",
     "@nuxt/devtools": "latest",
-    "@vitest/coverage-v8": "^2.1.0",
-    "eslint": "^9.22.0",
-    "globals": "^16.0.0",
-    "redis": "^4.7.0",
-    "typescript-eslint": "^8.26.0",
     "@tailwindcss/vite": "^4.2.4",
     "@types/node": "^20.10.0",
     "@types/pdf-parse": "^1.1.4",
     "@types/uuid": "^9.0.7",
+    "@vitest/coverage-v8": "^2.1.0",
     "dotenv": "^17.4.2",
+    "eslint": "^9.22.0",
+    "globals": "^16.0.0",
     "gsap": "^3.15.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.5",
     "nuxt": "^3.15.3",
     "prisma": "^7.8.0",
+    "redis": "^4.7.0",
     "tailwindcss": "^4.2.4",
     "tsx": "^4.19.0",
     "typescript": "^5.3.3",
+    "typescript-eslint": "^8.26.0",
     "vitepress": "^1.6.3",
     "vitest": "^2.1.0",
     "vue-tsc": "^3.2.7"
@@ -90,5 +94,10 @@
   "engines": {
     "node": ">=20.0.0",
     "pnpm": ">=10.0.0"
+  },
+  "lint-staged": {
+    "server/**/*.ts": "eslint --fix",
+    "tests/**/*.ts": "eslint --fix",
+    "scripts/**/*.ts": "eslint --fix"
   }
 }