feat: AI-first scraping with MCP integration and modern development environment

.dockerignore

@@ -7,4 +7,22 @@
 
 # Docker files
 .dockerignore
-Dockerfile
+Dockerfile
+
+# Development files
+.git
+.github
+*.md
+.env*
+.cache
+coverage
+.turbo
+**/*.test.*
+**/*.spec.*
+.editorconfig
+.nvmrc
+.prettierrc.js
+eslint.config.js
+vitest.config.ts
+.husky
+**/*.map

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.{js,jsx,ts,tsx,json,yaml,yml}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Dockerfile]
+indent_style = tab

.github/CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing to Devolunch
+
+We appreciate any kind of contributions to Devolunch 🤗
+
+## Code / Development
+
+- TypeScript-first codebase (client/server/functions)
+- Conventional Commits enforced via a commit-msg hook
+- See development details in [docs/development.md](../docs/development.md)
+
+## Forking/Cloning
+
+- Outside contributors: fork the repo and open PRs from your fork
+- Org members: branch in-repo and open PRs from branches
+
+## Local Setup
+
+1. Install dependencies
+   ```sh
+   pnpm install
+   ```
+2. Run dev
+   ```sh
+   pnpm dev
+   ```
+3. Optional Docker
+   ```sh
+   docker-compose up
+   ```
+
+## Functions (Scraper & Slack Notifier)
+
+See their readmes:
+- Scraper: apps/functions/scraper/README.md
+- Notify Slack: apps/functions/notify-slack/README.md
+
+## Adding restaurants
+
+Add entries to apps/functions/scraper/src/restaurants.ts. See the Scraper README for examples.

.github/workflows/dependency-review.yml

@@ -0,0 +1,79 @@
+name: 'Dependency Review'
+
+on:
+  pull_request:
+    branches: [main]
+    paths:
+      - 'package.json'
+      - 'pnpm-lock.yaml'
+      - '**/package.json'
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  dependency-review:
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.user.login == 'renovate[bot]'
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Dependency Review
+        uses: actions/dependency-review-action@v4
+        with:
+          fail-on-severity: critical
+          deny-licenses: GPL-2.0, GPL-3.0
+          comment-summary-in-pr: always
+
+  auto-approve-renovate:
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.user.login == 'renovate[bot]'
+    needs: dependency-review
+
+    steps:
+      - name: Auto-approve Renovate PRs
+        uses: hmarr/auto-approve-action@v4
+        with:
+          github-token: "${{ secrets.GITHUB_TOKEN }}"
+
+  security-audit:
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.user.login == 'renovate[bot]'
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - uses: pnpm/action-setup@v4
+        name: Install pnpm
+        with:
+          version: 10
+          run_install: false
+
+      - name: Get pnpm store directory
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - uses: actions/cache@v4
+        name: Setup pnpm cache
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Security audit
+        run: pnpm audit
+        continue-on-error: false

.github/workflows/install-and-test.yaml

@@ -9,18 +9,18 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Install Node.js
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 22
 
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
         name: Install pnpm
         id: pnpm-install
         with:
-          version: 8
+          version: 10
           run_install: false
 
       - name: Get pnpm store directory
@@ -29,7 +29,7 @@ jobs:
         run: |
           echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT
 
-      - uses: actions/cache@v3
+      - uses: actions/cache@v4
         name: Setup pnpm cache
         with:
           path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
@@ -49,5 +49,11 @@ jobs:
       - name: Run typecheck
         run: pnpm typecheck
 
-      - name: Run tests
+      - name: Run tests with coverage
         run: pnpm test
+
+      - name: Run coverage report
+        run: pnpm --filter @devolunch/client exec vitest run --coverage
+
+      - name: Security audit
+        run: pnpm audit

.gitignore

@@ -33,3 +33,6 @@ lerna-debug.log*
 
 # Zip files created to deploy to Cloud Functions
 **/*.zip
+
+# Local scrape output (not for version control)
+apps/functions/scraper/scrape.json

.husky/commit-msg

@@ -0,0 +1,21 @@
+msgFile="$1"
+subject="$(head -n1 "$msgFile" | tr -d '\r')"
+
+# Allow merge commits and reverts
+case "$subject" in
+  Merge\ *) exit 0 ;;
+  Revert\ *) exit 0 ;;
+esac
+
+pattern='^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\([a-z0-9\-\/]+\))?(!)?: .+'
+
+if echo "$subject" | grep -Eq "$pattern"; then
+  exit 0
+fi
+
+echo "\n⛔ Invalid commit message."
+echo "Follow Conventional Commits, e.g.:"
+echo "  feat(server): add health endpoint"
+echo "  fix(scraper): handle empty PDF"
+echo "Got: $subject\n"
+exit 1

.husky/pre-commit

@@ -1,7 +1,3 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
-pnpm --filter shared build
+# Fast, reliable checks before commit
 pnpm lint
 pnpm typecheck
-pnpm test

.husky/pre-push

@@ -0,0 +1,9 @@
+set -e
+
+echo "husky pre-push: running tests"
+pnpm test
+
+echo "husky pre-push: running build"
+pnpm build
+
+echo "husky pre-push: OK"

.npmrc

@@ -0,0 +1 @@
+inject-workspace-packages=true

.nvmrc

@@ -0,0 +1 @@
+22.14.0

.prettierrc.js

@@ -0,0 +1,8 @@
+module.exports = {
+  semi: true,
+  trailingComma: 'es5',
+  singleQuote: true,
+  printWidth: 80,
+  tabWidth: 2,
+  useTabs: false,
+};