Feature/hallmark

.cursor/hooks.json

@@ -0,0 +1,24 @@
+{
+  "version": 1,
+  "hooks": {
+    "afterFileEdit": [
+      {
+        "command": ".cursor/hooks/after-file-edit.sh",
+        "timeout": 180
+      }
+    ],
+    "afterTabFileEdit": [
+      {
+        "command": ".cursor/hooks/after-file-edit.sh",
+        "timeout": 180
+      }
+    ],
+    "stop": [
+      {
+        "command": ".cursor/hooks/stop-quality-check.sh",
+        "timeout": 600,
+        "loop_limit": 0
+      }
+    ]
+  }
+}

.cursor/hooks/after-file-edit.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# Formats the edited file and runs vitest related tests.
+# Full format:check, lint, and test suite run on agent stop (stop-quality-check.sh).
+
+set -euo pipefail
+
+input=$(cat)
+file_path=$(
+  printf '%s' "$input" | python3 -c "import sys, json; print(json.load(sys.stdin).get('file_path', ''))"
+)
+
+if [[ -z "$file_path" || ! -f "$file_path" ]]; then
+  exit 0
+fi
+
+case "$file_path" in
+  *node_modules/* | */.next/* | */dist/* | */test-results/* | */playwright-report/*)
+    exit 0
+    ;;
+esac
+
+project_root="${CURSOR_PROJECT_DIR:-$(cd "$(dirname "$0")/../.." && pwd)}"
+cd "$project_root"
+
+log() {
+  echo "[cursor-hook:afterFileEdit] $*" >&2
+}
+
+format_file() {
+  case "$file_path" in
+    *.ts | *.tsx | *.js | *.jsx | *.json | *.css | *.md | *.mjs | *.cjs | *.yml | *.yaml)
+      log "Formatting $file_path"
+      bunx prettier --write "$file_path"
+      ;;
+  esac
+}
+
+run_related_tests() {
+  case "$file_path" in
+    *.ts | *.tsx | *.js | *.jsx)
+      log "Running related tests for $file_path"
+      if ! bun run test -- related "$file_path" --run; then
+        log "Related tests failed for $file_path (see output above)"
+      fi
+      ;;
+  esac
+}
+
+format_file
+run_related_tests
+
+exit 0

.cursor/hooks/stop-quality-check.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Full quality gate when the agent finishes a turn: format check, lint, unit tests.
+
+set -euo pipefail
+
+cat >/dev/null
+
+project_root="${CURSOR_PROJECT_DIR:-$(cd "$(dirname "$0")/../.." && pwd)}"
+cd "$project_root"
+
+log() {
+  echo "[cursor-hook:stop] $*" >&2
+}
+
+failures=()
+
+log "Running format:check..."
+if ! bun run format:check; then
+  failures+=("format:check")
+fi
+
+log "Running lint..."
+if ! bun run lint; then
+  failures+=("lint")
+fi
+
+log "Running unit tests..."
+if ! bun run test -- --run; then
+  failures+=("test")
+fi
+
+if ((${#failures[@]} > 0)); then
+  log "Quality gate failed: ${failures[*]}"
+  # Stop hooks are observational; exit 0 so the session is not blocked.
+  exit 0
+fi
+
+log "Quality gate passed."
+exit 0

.eslintrc.json

@@ -1,6 +1,14 @@
 {
   "extends": ["next/core-web-vitals", "next/typescript"],
   "rules": {
-    "@typescript-eslint/no-explicit-any": "warn"
+    "@typescript-eslint/no-explicit-any": "warn",
+    "@typescript-eslint/no-unused-vars": [
+      "warn",
+      {
+        "argsIgnorePattern": "^_",
+        "varsIgnorePattern": "^_",
+        "caughtErrorsIgnorePattern": "^_"
+      }
+    ]
   }
 }

.github/workflows/deploy.yml

@@ -147,7 +147,8 @@ jobs:
   #
   # Environment secrets (GitHub "Production" vs "Preview"): only Appwrite targets differ per env:
   #   APPWRITE_DATABASE_ID, APPWRITE_COLLECTION_ID_TRIAL_SESSIONS, APPWRITE_COLLECTION_ID_AI_KEYS, APPWRITE_COLLECTION_ID_SUBSCRIPTIONS
-  # All other deploy secrets stay repository-wide: VERCEL_*, NEXT_PUBLIC_APPWRITE_*, APPWRITE_API_KEY.
+  # All other deploy secrets stay repository-wide: VERCEL_*, NEXT_PUBLIC_APPWRITE_*, APPWRITE_API_KEY,
+  # AI_PROVIDER, AI_API_KEY (Hosted AI / Ditectrev AI on server — synced to Vercel below).
   # Set GitHub variable NEXT_PUBLIC_SITE_URL (e.g. https://theopenstock.com) for canonical URLs, sitemap, and OG.
   # With `environment:` set, GitHub still exposes repository secrets to the job; environment adds/overrides
   # only the names defined on that environment (here: Appwrite DB + collection ids).
@@ -188,6 +189,11 @@ jobs:
             vercel env add FINNHUB_BASE_URL $ENV_TYPE "" --value "${{ vars.FINNHUB_BASE_URL }}" --yes --force --token=${{ secrets.VERCEL_TOKEN }}
           fi
           vercel env add FINNHUB_API_KEY $ENV_TYPE "" --value "${{ secrets.FINNHUB_API_KEY }}" --yes --force --sensitive --token=${{ secrets.VERCEL_TOKEN }}
+          vercel env add AI_PROVIDER $ENV_TYPE "" --value "${{ secrets.AI_PROVIDER }}" --yes --force --token=${{ secrets.VERCEL_TOKEN }}
+          vercel env add AI_API_KEY $ENV_TYPE "" --value "${{ secrets.AI_API_KEY }}" --yes --force --sensitive --token=${{ secrets.VERCEL_TOKEN }}
+          if [ -n "${{ vars.AI_MODEL }}" ]; then
+            vercel env add AI_MODEL $ENV_TYPE "" --value "${{ vars.AI_MODEL }}" --yes --force --token=${{ secrets.VERCEL_TOKEN }}
+          fi
           if [ -n "${{ vars.YAHOO_FINANCE_API_URL }}" ]; then
             vercel env add YAHOO_FINANCE_API_URL $ENV_TYPE "" --value "${{ vars.YAHOO_FINANCE_API_URL }}" --yes --force --token=${{ secrets.VERCEL_TOKEN }}
           fi

.gitignore

@@ -119,6 +119,9 @@ pnpm-lock.yaml
 # Testing
 /coverage
 *.lcov
+/playwright-report/
+/test-results/
+/playwright/.cache/
 
 # Vercel
 .vercel

.prettierignore

@@ -0,0 +1,16 @@
+# Build & dependencies
+.next/
+out/
+node_modules/
+.vercel/
+
+# Test & Playwright artifacts (generated locally / in CI)
+coverage/
+playwright-report/
+test-results/
+.lighthouseci/
+e2e/**/*.png
+**/*-snapshots/**
+
+# Lockfiles Prettier doesn't need to touch
+bun.lockb

README.md

@@ -137,6 +137,16 @@ If `ollama serve` shows `127.0.0.1:11434: bind: address already in use`, Ollama
 
 Also required for trial features: `APPWRITE_COLLECTION_ID_TRIAL_SESSIONS`.
 
+### Hosted AI (Ditectrev AI tier on production)
+
+Required on Vercel when subscribers use the **Hosted AI** plan. Synced from GitHub Actions on deploy (see `.github/workflows/deploy.yml`).
+
+| Variable      | Description                                                                           | Example    |
+| ------------- | ------------------------------------------------------------------------------------- | ---------- |
+| `AI_PROVIDER` | Server LLM vendor for Hosted AI (`MISTRAL`, `OPENAI`, `GEMINI`, `DEEPSEEK`, `OLLAMA`) | `MISTRAL`  |
+| `AI_API_KEY`  | API key for that provider                                                             | _(secret)_ |
+| `AI_MODEL`    | Optional model override; defaults are used per provider if unset                      | unset      |
+
 ### SEO & analytics (recommended for production)
 
 | Variable               | Description                                                                               |

__tests__/performance.test.ts

@@ -147,7 +147,9 @@ describe("Lazy loading behavior (Req 15.2)", () => {
       "AdBanner",
       "LazySection",
       "AIPredictionPanel",
+      "HomeHub",
       "StockOfTheDayPanel",
+      "ProductShell",
     ];
 
     for (const imp of staticImports!) {