Prepare for deployment: Update dependencies and add all new components

.gitignore

@@ -1,12 +1,12 @@
-node_modules
-dist
-build
-*.log
-__pycache__
+.venv/
+__pycache__/
 *.pyc
 .env
+.env.local
+knowledge_files/
+backend/knowledge_files/
+frontend/node_modules/
+frontend/dist/
+metrics_logs/
+.vscode/
 .DS_Store
-venv
-env
-.vscode
-.idea

AGENTS.md

@@ -0,0 +1,25 @@
+# Codex Guidance
+
+## Conventions
+- Keep existing FastAPI endpoints and React flows stable; add new functionality behind flags/config toggles.
+- Prefer small, composable helpers in `backend/app/services/` for pipeline changes.
+- Do not commit secrets (`.env`), caches (`knowledge_files/`), build artifacts (`frontend/dist/`), or logs (`metrics_logs/`).
+
+## Metrics
+- New chatbot metrics live in `backend/app/services/scrape_pipeline.py`.
+- Add supporting helpers in `backend/app/services/metrics_logger.py`.
+- Guard all metrics code with the `ENABLE_METRICS_LOGGING` environment variable (default `false`).
+- Surface new metrics via API stats objects without breaking existing fields.
+
+## Commands to run after changes
+- Backend: `pip install -r requirements.txt` (if deps change), then `pytest`.
+- Frontend: `cd frontend && npm install` (if deps change), then `npm run build`.
+
+## Feature flags
+- All new features/metrics must be optional and off by default:
+  - `ENABLE_METRICS_LOGGING` controls metrics/telemetry.
+  - Wrap new logic in `if os.getenv("ENABLE_METRICS_LOGGING", "false").lower() == "true": ...`.
+
+## Testing expectations
+- Add/maintain unit tests for new logic; prefer fast, isolated tests with mocks over network calls.
+- If modifying the pipeline, ensure cache behavior and new stats remain backward compatible.

README.md

@@ -80,6 +80,9 @@ npm install
 npm run dev   # opens on http://localhost:5173
 ```
 
+### Optional metrics (feature-flagged)
+- Set `ENABLE_METRICS_LOGGING=true` in your environment to capture Time-to-Chatbot-Ready (TCR), cache hit flags, and chat Q/A JSONL logs (`metrics_logs/chat_answers.jsonl`). Disabled by default to avoid any impact on existing flows.
+
 ### Usage
 - Sign up (first/last/email/password) → OTP → auto-login.
 - Generate chatbot: paste URL, optional Force refresh → Run. A brief summary (pages scraped, web searches) shows, then the chatbot appears.

backend/app/api/chat.py

@@ -2,6 +2,11 @@ from fastapi import APIRouter, HTTPException
 from openai import OpenAI
 
 from ..models.chat import ChatRequest, ChatResponse, ChatMessage
+from ..services.metrics_logger import (
+    log_chat_answer,
+    save_chat_answer_to_supabase,
+    metrics_enabled,
+)
 
 router = APIRouter()
 
@@ -22,6 +27,28 @@ async def chat(req: ChatRequest):
             messages=messages,
         )
         answer = resp.choices[0].message.content or ""
+
+        if metrics_enabled():
+            provenance = "primary_plus_secondary" if "SECONDARY SOURCE" in req.system_prompt else "primary_only"
+            try:
+                # Best-effort file log
+                log_chat_answer(
+                    question=req.messages[-1].content if req.messages else "",
+                    answer=answer,
+                    provenance=provenance,
+                    user=None,
+                )
+                # Best-effort Supabase log
+                save_chat_answer_to_supabase(
+                    question=req.messages[-1].content if req.messages else "",
+                    answer=answer,
+                    system_prompt=req.system_prompt,
+                    user_id=None,
+                    url=None,
+                )
+            except Exception as log_exc:
+                print(f"⚠️ Metrics logging skipped: {log_exc}")
+
         return ChatResponse(message=ChatMessage(role="assistant", content=answer))
     except Exception as exc:
         raise HTTPException(status_code=500, detail=str(exc))

backend/app/api/jobs.py

@@ -4,6 +4,8 @@ import asyncio
 
 from ..models.jobs import JobCreate, JobStatus
 from ..services import scrape_pipeline
+from ..services.metrics_logger import save_job_metrics_to_supabase
+from ..services.scrape_pipeline import ENABLE_METRICS
 
 router = APIRouter()
 
@@ -26,7 +28,19 @@ async def run_job(body: JobCreate) -> JobStatus:
             "searches_run": stats.get("searches_run", 0),
             "pages_scraped": stats.get("pages_scraped", 0),
             "gaps_found": stats.get("gaps_found", 0),
+            "tcr_seconds": stats.get("tcr_seconds", 0.0),
+            "cache_hit": bool(stats.get("cache_hit", False)),
         }
+        if ENABLE_METRICS:
+            try:
+                save_job_metrics_to_supabase(
+                    url=str(body.url),
+                    stats=stats,
+                    user_id=None,  # user id not available in this dev endpoint
+                )
+            except Exception as exc:
+                print(f"⚠️ Metrics logging skipped: {exc}")
+
         return JobStatus(
             job_id="dev-inline",
             status="completed",

backend/app/main.py

@@ -3,11 +3,6 @@ from fastapi.middleware.cors import CORSMiddleware
 from .api.router import api_router
 
 
-from fastapi.staticfiles import StaticFiles
-from fastapi.responses import FileResponse
-import os
-
-
 def get_application() -> FastAPI:
     app = FastAPI(
         title="ChatSMITH Backend",
@@ -29,27 +24,6 @@ def get_application() -> FastAPI:
     )
 
     app.include_router(api_router, prefix="/api")
-
-    # Serve static files from the frontend build directory
-    # The Dockerfile copies frontend/dist to /app/frontend/dist
-    # In local dev, we might verify this path or stick to running frontend separately.
-    # We use a relative path assuming we run from /app root in Docker.
-    static_dir = os.path.join(os.path.dirname(__file__), "../../frontend/dist")
-
-    if os.path.isdir(static_dir):
-        app.mount("/assets", StaticFiles(directory=os.path.join(static_dir, "assets")), name="assets")
-
-        # Catch-all route for SPA client-side routing
-        @app.get("/{full_path:path}")
-        async def serve_app(full_path: str):
-            # Check if file exists in static dir (e.g. favicon.ico)
-            file_path = os.path.join(static_dir, full_path)
-            if os.path.isfile(file_path):
-                return FileResponse(file_path)
-            
-            # Otherwise return index.html
-            return FileResponse(os.path.join(static_dir, "index.html"))
-
     return app
 
 

backend/app/services/metrics_logger.py

@@ -0,0 +1,129 @@
+import json
+import os
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Optional
+
+from supabase import Client, create_client
+
+# Default path can be overridden via METRICS_LOG_PATH; caller should guard with ENABLE_METRICS_LOGGING
+LOG_PATH = Path(os.getenv("METRICS_LOG_PATH", "metrics_logs/chat_answers.jsonl"))
+
+# Read Supabase settings (support common alt casing to avoid env mismatches)
+SUPABASE_URL = (os.getenv("SUPABASE_URL") or os.getenv("supabase_url") or "").strip() or None
+# Prefer service role key; fall back to anon for dev. Accept lowercase variants too.
+SUPABASE_KEY = (
+    os.getenv("SUPABASE_SERVICE_ROLE_KEY")
+    or os.getenv("supabase_service_role_key")
+    or os.getenv("SUPABASE_ANON_KEY")
+    or os.getenv("supabase_anon_key")
+    or ""
+).strip() or None
+_supabase_client: Optional[Client] = None
+_warned_no_supabase = False
+
+
+def _metrics_enabled() -> bool:
+    return (os.getenv("ENABLE_METRICS_LOGGING", "false") or "").strip().lower() == "true"
+
+
+def metrics_enabled() -> bool:
+    """Public helper to check if metrics are enabled."""
+    return _metrics_enabled()
+
+
+def get_supabase_client() -> Optional[Client]:
+    """
+    Return a Supabase client or None if not configured/initialization fails.
+    """
+    global _supabase_client
+    global _warned_no_supabase
+    if _supabase_client:
+        return _supabase_client
+    if not SUPABASE_URL or not SUPABASE_KEY:
+        if _metrics_enabled() and not _warned_no_supabase:
+            print("⚠️ Metrics Supabase not configured: missing SUPABASE_URL or SUPABASE_SERVICE_ROLE_KEY/ANON.")
+            _warned_no_supabase = True
+        return None
+    try:
+        _supabase_client = create_client(SUPABASE_URL, SUPABASE_KEY)
+    except Exception as exc:
+        print(f"⚠️ Metrics Supabase init failed: {exc}")
+        _supabase_client = None
+    return _supabase_client
+
+
+def log_chat_answer(
+    question: str,
+    answer: str,
+    provenance: str,
+    user: Optional[str] = None,
+    log_path: Path = LOG_PATH,
+) -> None:
+    """
+    Append a single chat Q/A record as JSONL for downstream accuracy sampling.
+    """
+    try:
+        log_path = Path(log_path)
+        log_path.parent.mkdir(parents=True, exist_ok=True)
+        record = {
+            "timestamp": datetime.now(timezone.utc).isoformat(),
+            "question": question,
+            "answer": answer,
+            "provenance": provenance,
+            "user": user,
+        }
+        with log_path.open("a", encoding="utf-8") as f:
+            f.write(json.dumps(record, ensure_ascii=False) + "\n")
+    except Exception as exc:
+        # Best-effort logging; never break the request path
+        print(f"⚠️ Metrics logging failed: {exc}")
+
+
+def save_job_metrics_to_supabase(url: str, stats: dict, user_id: Optional[str] = None) -> None:
+    """
+    Insert a row into metrics_job_runs. Best-effort; quietly return on failure.
+    """
+    client = get_supabase_client()
+    if not client:
+        return
+    try:
+        payload = {
+            "url": url,
+            "cache_hit": bool(stats.get("cache_hit", False)),
+            "tcr_seconds": float(stats.get("tcr_seconds", 0.0) or 0.0),
+            "searches_run": int(stats.get("searches_run", 0) or 0),
+            "pages_scraped": int(stats.get("pages_scraped", 0) or 0),
+            "gaps_found": int(stats.get("gaps_found", 0) or 0),
+            "user_id": user_id,
+        }
+        client.table("metrics_job_runs").insert(payload).execute()
+    except Exception as exc:
+        print(f"⚠️ Supabase job metrics insert failed: {exc}")
+
+
+def save_chat_answer_to_supabase(
+    question: str,
+    answer: str,
+    system_prompt: str,
+    user_id: Optional[str] = None,
+    url: Optional[str] = None,
+) -> None:
+    """
+    Insert a chat answer row into metrics_chat_answers. Best-effort.
+    """
+    client = get_supabase_client()
+    if not client:
+        return
+    try:
+        provenance = "primary_plus_secondary" if "SECONDARY SOURCE" in (system_prompt or "") else "primary_only"
+        payload = {
+            "user_id": user_id,
+            "url": url,
+            "question": question,
+            "answer": answer,
+            "provenance": provenance,
+        }
+        client.table("metrics_chat_answers").insert(payload).execute()
+    except Exception as exc:
+        print(f"⚠️ Supabase chat metrics insert failed: {exc}")

backend/app/services/scrape_pipeline.py

@@ -4,6 +4,8 @@ import json
 import hashlib
 import re
 import ssl
+import time
+from pathlib import Path
 from datetime import datetime
 from typing import List, Dict, Tuple
 from urllib.parse import urljoin, urlparse
@@ -18,17 +20,24 @@ from pydantic import BaseModel, Field
 from supabase import Client, create_client
 from agents import Agent, WebSearchTool, Runner
 from agents.model_settings import ModelSettings
+from .metrics_logger import (
+    log_chat_answer,
+    save_chat_answer_to_supabase,
+)
 
 # Initialize
+# Knowledge base directory (consistent absolute path to avoid cwd issues)
+PROJECT_ROOT = Path(__file__).resolve().parents[2]
+KNOWLEDGE_DIR = PROJECT_ROOT / "knowledge_files"
+KNOWLEDGE_DIR.mkdir(parents=True, exist_ok=True)
+
 load_dotenv(override=True)
 client = OpenAI()
+ENABLE_METRICS = (os.getenv("ENABLE_METRICS_LOGGING", "false") or "").strip().lower() == "true"
 
 # Create SSL context with certifi certificates (matches notebook behavior)
 SSL_CONTEXT = ssl.create_default_context(cafile=certifi.where())
 
-# Create knowledge_files directory if it doesn't exist
-os.makedirs("knowledge_files", exist_ok=True)
-
 print("✅ Imports loaded")
 
 # Supabase auth setup
@@ -410,6 +419,15 @@ async def scrape_website(url: str) -> Dict:
         # Step 1: Fetch homepage with retry
         print("  📄 Fetching homepage...")
         _, homepage_html, homepage_error = await fetch_page_with_retry(session, url)
+
+        # Fallback: if HTTPS failed, try HTTP (some sites block/redirect HTTPS)
+        if not homepage_html and original_url.startswith("https://"):
+            fallback_url = "http://" + original_url[len("https://"):]
+            print(f"  🔁 HTTPS fetch failed, retrying with HTTP: {fallback_url}")
+            _, homepage_html, homepage_error = await fetch_page_with_retry(session, fallback_url)
+            if homepage_html:
+                url = fallback_url.rstrip('/')
+                results["source_url"] = url
         
         if not homepage_html:
             error_msg = f"Failed to fetch homepage: {homepage_error}"
@@ -719,27 +737,34 @@ def get_cache_path(url: str) -> str:
     """Get the cache file path for a given URL."""
     url_hash = hashlib.md5(url.encode()).hexdigest()[:12]
     domain = urlparse(url).netloc.replace("www.", "").replace(".", "_")
-    return f"knowledge_files/{domain}_{url_hash}.json"
+    return str(KNOWLEDGE_DIR / f"{domain}_{url_hash}.json")
 
 
 def is_cached(url: str) -> bool:
     """Check if knowledge for a URL is already cached."""
-    cache_path = get_cache_path(url)
-    return os.path.exists(cache_path)
+    cache_path = Path(get_cache_path(url))
+    if cache_path.exists():
+        return True
+    # Backward compatibility: check legacy relative path if different
+    legacy = Path("knowledge_files") / cache_path.name
+    return legacy.exists()
 
 
 def get_cached_knowledge(url: str) -> Dict | None:
     """Load cached knowledge if available. Returns None if not cached."""
-    cache_path = get_cache_path(url)
-    if os.path.exists(cache_path):
-        try:
-            with open(cache_path, 'r', encoding='utf-8') as f:
-                knowledge = json.load(f)
-            print(f"📂 Loaded from cache: {cache_path}")
-            return knowledge
-        except Exception as e:
-            print(f"⚠️ Cache read error: {e}")
-            return None
+    paths = [Path(get_cache_path(url))]
+    # Add legacy relative path as fallback
+    paths.append(Path("knowledge_files") / paths[0].name)
+    for cache_path in paths:
+        if cache_path.exists():
+            try:
+                with open(cache_path, 'r', encoding='utf-8') as f:
+                    knowledge = json.load(f)
+                print(f"📂 Loaded from cache: {cache_path}")
+                return knowledge
+            except Exception as e:
+                print(f"⚠️ Cache read error ({cache_path}): {e}")
+                continue
     return None
 
 
@@ -778,13 +803,14 @@ def create_knowledge_json(url: str, scraped_data: Dict, web_search_results: List
 
 def save_knowledge_json(knowledge: Dict, url: str) -> str:
     """Save knowledge JSON to file. Returns filepath."""
-    filepath = get_cache_path(url)
+    filepath = Path(get_cache_path(url))
+    filepath.parent.mkdir(parents=True, exist_ok=True)
     
     with open(filepath, 'w', encoding='utf-8') as f:
         json.dump(knowledge, f, indent=2, ensure_ascii=False)
     
     print(f"💾 Knowledge saved to: {filepath}")
-    return filepath
+    return str(filepath)
 
 
 def load_knowledge_json(filepath: str) -> Dict:
@@ -1275,7 +1301,8 @@ async def run_full_research_new(url: str, force_refresh: bool = False, progress=
     NEW workflow: Scrape first, then fill gaps with targeted searches.
     With caching support and improved error handling (Phase 3).
     """
-    stats = {"pages_scraped": 0, "searches_run": 0, "gaps_found": 0}
+    stats = {"pages_scraped": 0, "searches_run": 0, "gaps_found": 0, "cache_hit": False}
+    start_time = time.time() if ENABLE_METRICS else None
     errors = []  # Track errors for UI feedback
     
     # ===== Check Cache First =====
@@ -1284,6 +1311,7 @@ async def run_full_research_new(url: str, force_refresh: bool = False, progress=
         
         cached_knowledge = get_cached_knowledge(url)
         if cached_knowledge:
+            stats["cache_hit"] = True
             progress(0.9, desc="Preparing chatbot from cache...")
             
             # Extract name from cached data
@@ -1308,6 +1336,8 @@ RULES:
 
 === END ===
 """
+            if start_time is not None:
+                stats["tcr_seconds"] = time.time() - start_time
             progress(1.0, desc="Done (from cache)!")
             status_text = build_status_new(100, current_step=4, selected_name=raw_name, 
                                            finished=True, stats=stats, from_cache=True)
@@ -1315,7 +1345,7 @@ RULES:
             msg_update = gr.update(interactive=True, placeholder="Ask anything about the website...")
             send_btn_update = gr.update(interactive=True)
             
-            return status_text, system_prompt, raw_name, [], msg_update, send_btn_update
+            return status_text, system_prompt, raw_name, [], msg_update, send_btn_update, stats
     
     # ===== Step 1: Scrape Website (PRIMARY SOURCE) =====
     progress(0.05, desc="Scraping website...")
@@ -1454,6 +1484,8 @@ RULES:
 """
     
     progress(1.0, desc="Done!")
+    if start_time is not None:
+        stats["tcr_seconds"] = time.time() - start_time
     status_text = build_status_new(100, current_step=4, selected_name=raw_name, 
                                    finished=True, stats=stats, errors=errors)
     
@@ -1535,6 +1567,30 @@ def chat_fn(message, history, system_prompt, name, user=None):
         print(f"❌ Chat error: {e}")
         answer = f"⚠️ Sorry, there was an error generating a response. Please try again.\n\nError: {str(e)[:100]}"
 
+    if ENABLE_METRICS:
+        provenance = "primary_plus_secondary" if system_prompt and "SECONDARY SOURCE" in system_prompt else "primary_only"
+        user_email = None
+        if isinstance(user, dict):
+            user_email = user.get("email")
+        else:
+            user_email = getattr(user, "email", None)
+        log_chat_answer(
+            question=message,
+            answer=answer,
+            provenance=provenance,
+            user=user_email,
+        )
+        try:
+            save_chat_answer_to_supabase(
+                question=message,
+                answer=answer,
+                system_prompt=system_prompt,
+                user_id=user_email,
+                url=None,  # URL not available in this handler
+            )
+        except Exception as exc:
+            print(f"⚠️ Supabase chat metrics skipped: {exc}")
+
     # Return in Gradio 6.x format
     return "", history + [
         {"role": "user", "content": message},

deployment_guide.md

@@ -31,9 +31,12 @@ You can upload files via the web interface or use Git. Since you have the code l
 #### Option A: Drag and Drop (Easiest for one-off)
 1. Go to the **Files** tab of your Space.
 2. Click **Add file** -> **Upload files**.
-3. Drag and drop **ALL** files and folders from your `chatsmith-main` folder (backend, frontend, Dockerfile, requirements.txt, etc.).
-   - *Note: You can skip `node_modules`, `venv`, `.git` folders.*
-4. Commit the changes.
+3. Open your local `chatsmith-main` folder.
+4. Select **all files inside** (backend, frontend, Dockerfile, etc.).
+5. Drag and drop them into the web interface.
+   - **Important**: Do NOT drag the `chatsmith-main` folder itself. Drag the *contents*.
+   - *Tip: You can skip the `node_modules` folder if it exists, as it will be recreated by Docker.*
+6. Commit the changes.
 
 #### Option B: Git (Recommended)
 1. In your local terminal, initialize git if not already:
@@ -50,6 +53,12 @@ You can upload files via the web interface or use Git. Since you have the code l
    ```bash
    git push --force space master:main
    ```
+   *Note: If asked for a password, you must use a **Hugging Face Access Token** with `write` permissions (Settings -> Access Tokens), NOT your account password.*
+
+   **Authentication Helper (if needed):**
+   ```bash
+   git config --global credential.helper store
+   ```
 
 ### 4. Wait for Build
 - Once files are uploaded, Hugging Face will automatically detect the `Dockerfile` and start building.

frontend/package-lock.json

@@ -8,15 +8,15 @@
       "name": "chatsmith-frontend",
       "version": "0.1.0",
       "dependencies": {
-        "@supabase/supabase-js": "^2.45.3",
-        "react": "^18.3.1",
-        "react-dom": "^18.3.1"
+        "@supabase/supabase-js": "^2.86.2",
+        "react": "^19.2.1",
+        "react-dom": "^19.2.1"
       },
       "devDependencies": {
-        "@types/react": "^18.3.11",
-        "@types/react-dom": "^18.3.0",
-        "@vitejs/plugin-react": "^4.3.3",
-        "vite": "^5.4.8"
+        "@types/react": "^19.2.7",
+        "@types/react-dom": "^19.2.3",
+        "@vitejs/plugin-react": "^5.1.1",
+        "vite": "^7.2.6"
       }
     },
     "node_modules/@babel/code-frame": {
@@ -302,9 +302,9 @@
       }
     },
     "node_modules/@esbuild/aix-ppc64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
-      "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz",
+      "integrity": "sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==",
       "cpu": [
         "ppc64"
       ],
@@ -315,13 +315,13 @@
         "aix"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/android-arm": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz",
-      "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.12.tgz",
+      "integrity": "sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==",
       "cpu": [
         "arm"
       ],
@@ -332,13 +332,13 @@
         "android"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/android-arm64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz",
-      "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.12.tgz",
+      "integrity": "sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==",
       "cpu": [
         "arm64"
       ],
@@ -349,13 +349,13 @@
         "android"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/android-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz",
-      "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.12.tgz",
+      "integrity": "sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==",
       "cpu": [
         "x64"
       ],
@@ -366,13 +366,13 @@
         "android"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/darwin-arm64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz",
-      "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.12.tgz",
+      "integrity": "sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==",
       "cpu": [
         "arm64"
       ],
@@ -383,13 +383,13 @@
         "darwin"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/darwin-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz",
-      "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.12.tgz",
+      "integrity": "sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==",
       "cpu": [
         "x64"
       ],
@@ -400,13 +400,13 @@
         "darwin"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/freebsd-arm64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz",
-      "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==",
       "cpu": [
         "arm64"
       ],
@@ -417,13 +417,13 @@
         "freebsd"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/freebsd-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz",
-      "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.12.tgz",
+      "integrity": "sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==",
       "cpu": [
         "x64"
       ],
@@ -434,13 +434,13 @@
         "freebsd"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/linux-arm": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz",
-      "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.12.tgz",
+      "integrity": "sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==",
       "cpu": [
         "arm"
       ],
@@ -451,13 +451,13 @@
         "linux"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/linux-arm64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz",
-      "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.12.tgz",
+      "integrity": "sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==",
       "cpu": [
         "arm64"
       ],
@@ -468,13 +468,13 @@
         "linux"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/linux-ia32": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz",
-      "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.12.tgz",
+      "integrity": "sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==",
       "cpu": [
         "ia32"
       ],
@@ -485,13 +485,13 @@
         "linux"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/linux-loong64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz",
-      "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.12.tgz",
+      "integrity": "sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==",
       "cpu": [
         "loong64"
       ],
@@ -502,13 +502,13 @@
         "linux"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/linux-mips64el": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz",
-      "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.12.tgz",
+      "integrity": "sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==",
       "cpu": [
         "mips64el"
       ],
@@ -519,13 +519,13 @@
         "linux"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/linux-ppc64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz",
-      "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.12.tgz",
+      "integrity": "sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==",
       "cpu": [
         "ppc64"
       ],
@@ -536,13 +536,13 @@
         "linux"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/linux-riscv64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz",
-      "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.12.tgz",
+      "integrity": "sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==",
       "cpu": [
         "riscv64"
       ],
@@ -553,13 +553,13 @@
         "linux"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/linux-s390x": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz",
-      "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.12.tgz",
+      "integrity": "sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==",
       "cpu": [
         "s390x"
       ],
@@ -570,13 +570,13 @@
         "linux"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/linux-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz",
-      "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.12.tgz",
+      "integrity": "sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==",
       "cpu": [
         "x64"
       ],
@@ -587,13 +587,30 @@
         "linux"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/netbsd-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz",
-      "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.12.tgz",
+      "integrity": "sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==",
       "cpu": [
         "x64"
       ],
@@ -604,13 +621,30 @@
         "netbsd"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.12.tgz",
+      "integrity": "sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/openbsd-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz",
-      "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.12.tgz",
+      "integrity": "sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==",
       "cpu": [
         "x64"
       ],
@@ -621,13 +655,30 @@
         "openbsd"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.12.tgz",
+      "integrity": "sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/sunos-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz",
-      "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.12.tgz",
+      "integrity": "sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==",
       "cpu": [
         "x64"
       ],
@@ -638,13 +689,13 @@
         "sunos"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/win32-arm64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz",
-      "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.12.tgz",
+      "integrity": "sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==",
       "cpu": [
         "arm64"
       ],
@@ -655,13 +706,13 @@
         "win32"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/win32-ia32": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz",
-      "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.12.tgz",
+      "integrity": "sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==",
       "cpu": [
         "ia32"
       ],
@@ -672,13 +723,13 @@
         "win32"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@esbuild/win32-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz",
-      "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.12.tgz",
+      "integrity": "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==",
       "cpu": [
         "x64"
       ],
@@ -689,7 +740,7 @@
         "win32"
       ],
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       }
     },
     "node_modules/@jridgewell/gen-mapping": {
@@ -743,9 +794,9 @@
       }
     },
     "node_modules/@rolldown/pluginutils": {
-      "version": "1.0.0-beta.27",
-      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-beta.27.tgz",
-      "integrity": "sha512-+d0F4MKMCbeVUJwG96uQ4SgAznZNSq93I3V+9NHA4OpvqG8mRCpGdKmK8l/dl02h2CCDHwW2FqilnTyDcAnqjA==",
+      "version": "1.0.0-beta.47",
+      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-beta.47.tgz",
+      "integrity": "sha512-8QagwMH3kNCuzD8EWL8R2YPW5e4OrHNSAHRFDdmFqEwEaD/KcNKjVoumo+gP2vW5eKB2UPbM6vTYiGZX0ixLnw==",
       "dev": true,
       "license": "MIT"
     },
@@ -1204,32 +1255,24 @@
       "integrity": "sha512-PIzZZlEppgrpoT2QgbnDU+MMzuR6BbCjllj0bM70lWoejMeNJAxCchxnv7J3XFkI8MpygtRpzXrIlmWUBclP5A==",
       "license": "MIT"
     },
-    "node_modules/@types/prop-types": {
-      "version": "15.7.15",
-      "resolved": "https://registry.npmjs.org/@types/prop-types/-/prop-types-15.7.15.tgz",
-      "integrity": "sha512-F6bEyamV9jKGAFBEmlQnesRPGOQqS2+Uwi0Em15xenOxHaf2hv6L8YCVn3rPdPJOiJfPiCnLIRyvwVaqMY3MIw==",
-      "dev": true,
-      "license": "MIT"
-    },
     "node_modules/@types/react": {
-      "version": "18.3.27",
-      "resolved": "https://registry.npmjs.org/@types/react/-/react-18.3.27.tgz",
-      "integrity": "sha512-cisd7gxkzjBKU2GgdYrTdtQx1SORymWyaAFhaxQPK9bYO9ot3Y5OikQRvY0VYQtvwjeQnizCINJAenh/V7MK2w==",
+      "version": "19.2.7",
+      "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.7.tgz",
+      "integrity": "sha512-MWtvHrGZLFttgeEj28VXHxpmwYbor/ATPYbBfSFZEIRK0ecCFLl2Qo55z52Hss+UV9CRN7trSeq1zbgx7YDWWg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@types/prop-types": "*",
         "csstype": "^3.2.2"
       }
     },
     "node_modules/@types/react-dom": {
-      "version": "18.3.7",
-      "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-18.3.7.tgz",
-      "integrity": "sha512-MEe3UeoENYVFXzoXEWsvcpg6ZvlrFNlOQ7EOsvhI3CfAXwzPfO8Qwuxd40nepsYKqyyVQnTdEfv68q91yLcKrQ==",
+      "version": "19.2.3",
+      "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-19.2.3.tgz",
+      "integrity": "sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ==",
       "dev": true,
       "license": "MIT",
       "peerDependencies": {
-        "@types/react": "^18.0.0"
+        "@types/react": "^19.2.0"
       }
     },
     "node_modules/@types/ws": {
@@ -1242,21 +1285,21 @@
       }
     },
     "node_modules/@vitejs/plugin-react": {
-      "version": "4.7.0",
-      "resolved": "https://registry.npmjs.org/@vitejs/plugin-react/-/plugin-react-4.7.0.tgz",
-      "integrity": "sha512-gUu9hwfWvvEDBBmgtAowQCojwZmJ5mcLn3aufeCsitijs3+f2NsrPtlAWIR6OPiqljl96GVCUbLe0HyqIpVaoA==",
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/@vitejs/plugin-react/-/plugin-react-5.1.1.tgz",
+      "integrity": "sha512-WQfkSw0QbQ5aJ2CHYw23ZGkqnRwqKHD/KYsMeTkZzPT4Jcf0DcBxBtwMJxnu6E7oxw5+JC6ZAiePgh28uJ1HBA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@babel/core": "^7.28.0",
+        "@babel/core": "^7.28.5",
         "@babel/plugin-transform-react-jsx-self": "^7.27.1",
         "@babel/plugin-transform-react-jsx-source": "^7.27.1",
-        "@rolldown/pluginutils": "1.0.0-beta.27",
+        "@rolldown/pluginutils": "1.0.0-beta.47",
         "@types/babel__core": "^7.20.5",
-        "react-refresh": "^0.17.0"
+        "react-refresh": "^0.18.0"
       },
       "engines": {
-        "node": "^14.18.0 || >=16.0.0"
+        "node": "^20.19.0 || >=22.12.0"
       },
       "peerDependencies": {
         "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0"
@@ -1367,9 +1410,9 @@
       "license": "ISC"
     },
     "node_modules/esbuild": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
-      "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==",
+      "version": "0.25.12",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz",
+      "integrity": "sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==",
       "dev": true,
       "hasInstallScript": true,
       "license": "MIT",
@@ -1377,32 +1420,35 @@
         "esbuild": "bin/esbuild"
       },
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       },
       "optionalDependencies": {
-        "@esbuild/aix-ppc64": "0.21.5",
-        "@esbuild/android-arm": "0.21.5",
-        "@esbuild/android-arm64": "0.21.5",
-        "@esbuild/android-x64": "0.21.5",
-        "@esbuild/darwin-arm64": "0.21.5",
-        "@esbuild/darwin-x64": "0.21.5",
-        "@esbuild/freebsd-arm64": "0.21.5",
-        "@esbuild/freebsd-x64": "0.21.5",
-        "@esbuild/linux-arm": "0.21.5",
-        "@esbuild/linux-arm64": "0.21.5",
-        "@esbuild/linux-ia32": "0.21.5",
-        "@esbuild/linux-loong64": "0.21.5",
-        "@esbuild/linux-mips64el": "0.21.5",
-        "@esbuild/linux-ppc64": "0.21.5",
-        "@esbuild/linux-riscv64": "0.21.5",
-        "@esbuild/linux-s390x": "0.21.5",
-        "@esbuild/linux-x64": "0.21.5",
-        "@esbuild/netbsd-x64": "0.21.5",
-        "@esbuild/openbsd-x64": "0.21.5",
-        "@esbuild/sunos-x64": "0.21.5",
-        "@esbuild/win32-arm64": "0.21.5",
-        "@esbuild/win32-ia32": "0.21.5",
-        "@esbuild/win32-x64": "0.21.5"
+        "@esbuild/aix-ppc64": "0.25.12",
+        "@esbuild/android-arm": "0.25.12",
+        "@esbuild/android-arm64": "0.25.12",
+        "@esbuild/android-x64": "0.25.12",
+        "@esbuild/darwin-arm64": "0.25.12",
+        "@esbuild/darwin-x64": "0.25.12",
+        "@esbuild/freebsd-arm64": "0.25.12",
+        "@esbuild/freebsd-x64": "0.25.12",
+        "@esbuild/linux-arm": "0.25.12",
+        "@esbuild/linux-arm64": "0.25.12",
+        "@esbuild/linux-ia32": "0.25.12",
+        "@esbuild/linux-loong64": "0.25.12",
+        "@esbuild/linux-mips64el": "0.25.12",
+        "@esbuild/linux-ppc64": "0.25.12",
+        "@esbuild/linux-riscv64": "0.25.12",
+        "@esbuild/linux-s390x": "0.25.12",
+        "@esbuild/linux-x64": "0.25.12",
+        "@esbuild/netbsd-arm64": "0.25.12",
+        "@esbuild/netbsd-x64": "0.25.12",
+        "@esbuild/openbsd-arm64": "0.25.12",
+        "@esbuild/openbsd-x64": "0.25.12",
+        "@esbuild/openharmony-arm64": "0.25.12",
+        "@esbuild/sunos-x64": "0.25.12",
+        "@esbuild/win32-arm64": "0.25.12",
+        "@esbuild/win32-ia32": "0.25.12",
+        "@esbuild/win32-x64": "0.25.12"
       }
     },
     "node_modules/escalade": {
@@ -1415,6 +1461,24 @@
         "node": ">=6"
       }
     },
+    "node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/fsevents": {
       "version": "2.3.3",
       "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
@@ -1453,6 +1517,7 @@
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
       "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+      "dev": true,
       "license": "MIT"
     },
     "node_modules/jsesc": {
@@ -1481,18 +1546,6 @@
         "node": ">=6"
       }
     },
-    "node_modules/loose-envify": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",
-      "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==",
-      "license": "MIT",
-      "dependencies": {
-        "js-tokens": "^3.0.0 || ^4.0.0"
-      },
-      "bin": {
-        "loose-envify": "cli.js"
-      }
-    },
     "node_modules/lru-cache": {
       "version": "5.1.1",
       "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz",
@@ -1543,6 +1596,19 @@
       "dev": true,
       "license": "ISC"
     },
+    "node_modules/picomatch": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
+      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
     "node_modules/postcss": {
       "version": "8.5.6",
       "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz",
@@ -1573,34 +1639,30 @@
       }
     },
     "node_modules/react": {
-      "version": "18.3.1",
-      "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
-      "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==",
+      "version": "19.2.1",
+      "resolved": "https://registry.npmjs.org/react/-/react-19.2.1.tgz",
+      "integrity": "sha512-DGrYcCWK7tvYMnWh79yrPHt+vdx9tY+1gPZa7nJQtO/p8bLTDaHp4dzwEhQB7pZ4Xe3ok4XKuEPrVuc+wlpkmw==",
       "license": "MIT",
-      "dependencies": {
-        "loose-envify": "^1.1.0"
-      },
       "engines": {
         "node": ">=0.10.0"
       }
     },
     "node_modules/react-dom": {
-      "version": "18.3.1",
-      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz",
-      "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==",
+      "version": "19.2.1",
+      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.1.tgz",
+      "integrity": "sha512-ibrK8llX2a4eOskq1mXKu/TGZj9qzomO+sNfO98M6d9zIPOEhlBkMkBUBLd1vgS0gQsLDBzA+8jJBVXDnfHmJg==",
       "license": "MIT",
       "dependencies": {
-        "loose-envify": "^1.1.0",
-        "scheduler": "^0.23.2"
+        "scheduler": "^0.27.0"
       },
       "peerDependencies": {
-        "react": "^18.3.1"
+        "react": "^19.2.1"
       }
     },
     "node_modules/react-refresh": {
-      "version": "0.17.0",
-      "resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.17.0.tgz",
-      "integrity": "sha512-z6F7K9bV85EfseRCp2bzrpyQ0Gkw1uLoCel9XBVWPg/TjRj94SkJzUTGfOa4bs7iJvBWtQG0Wq7wnI0syw3EBQ==",
+      "version": "0.18.0",
+      "resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.18.0.tgz",
+      "integrity": "sha512-QgT5//D3jfjJb6Gsjxv0Slpj23ip+HtOpnNgnb2S5zU3CB26G/IDPGoy4RJB42wzFE46DRsstbW6tKHoKbhAxw==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -1650,13 +1712,10 @@
       }
     },
     "node_modules/scheduler": {
-      "version": "0.23.2",
-      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz",
-      "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==",
-      "license": "MIT",
-      "dependencies": {
-        "loose-envify": "^1.1.0"
-      }
+      "version": "0.27.0",
+      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.27.0.tgz",
+      "integrity": "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==",
+      "license": "MIT"
     },
     "node_modules/semver": {
       "version": "6.3.1",
@@ -1678,6 +1737,23 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/tinyglobby": {
+      "version": "0.2.15",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
+      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
     "node_modules/tslib": {
       "version": "2.8.1",
       "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
@@ -1722,21 +1798,24 @@
       }
     },
     "node_modules/vite": {
-      "version": "5.4.21",
-      "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.21.tgz",
-      "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==",
+      "version": "7.2.6",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-7.2.6.tgz",
+      "integrity": "sha512-tI2l/nFHC5rLh7+5+o7QjKjSR04ivXDF4jcgV0f/bTQ+OJiITy5S6gaynVsEM+7RqzufMnVbIon6Sr5x1SDYaQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "esbuild": "^0.21.3",
-        "postcss": "^8.4.43",
-        "rollup": "^4.20.0"
+        "esbuild": "^0.25.0",
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3",
+        "postcss": "^8.5.6",
+        "rollup": "^4.43.0",
+        "tinyglobby": "^0.2.15"
       },
       "bin": {
         "vite": "bin/vite.js"
       },
       "engines": {
-        "node": "^18.0.0 || >=20.0.0"
+        "node": "^20.19.0 || >=22.12.0"
       },
       "funding": {
         "url": "https://github.com/vitejs/vite?sponsor=1"
@@ -1745,19 +1824,25 @@
         "fsevents": "~2.3.3"
       },
       "peerDependencies": {
-        "@types/node": "^18.0.0 || >=20.0.0",
-        "less": "*",
+        "@types/node": "^20.19.0 || >=22.12.0",
+        "jiti": ">=1.21.0",
+        "less": "^4.0.0",
         "lightningcss": "^1.21.0",
-        "sass": "*",
-        "sass-embedded": "*",
-        "stylus": "*",
-        "sugarss": "*",
-        "terser": "^5.4.0"
+        "sass": "^1.70.0",
+        "sass-embedded": "^1.70.0",
+        "stylus": ">=0.54.8",
+        "sugarss": "^5.0.0",
+        "terser": "^5.16.0",
+        "tsx": "^4.8.1",
+        "yaml": "^2.4.2"
       },
       "peerDependenciesMeta": {
         "@types/node": {
           "optional": true
         },
+        "jiti": {
+          "optional": true
+        },
         "less": {
           "optional": true
         },
@@ -1778,6 +1863,12 @@
         },
         "terser": {
           "optional": true
+        },
+        "tsx": {
+          "optional": true
+        },
+        "yaml": {
+          "optional": true
         }
       }
     },

frontend/package.json

@@ -8,14 +8,14 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@supabase/supabase-js": "^2.45.3",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1"
+    "@supabase/supabase-js": "^2.86.2",
+    "react": "^19.2.1",
+    "react-dom": "^19.2.1"
   },
   "devDependencies": {
-    "@types/react": "^18.3.11",
-    "@types/react-dom": "^18.3.0",
-    "@vitejs/plugin-react": "^4.3.3",
-    "vite": "^5.4.8"
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "vite": "^7.2.6"
   }
 }

frontend/src/App.jsx

@@ -27,7 +27,7 @@ export default function App() {
   const [session, setSession] = useState(null);
   const [status, setStatus] = useState("");
   const [forceRefresh, setForceRefresh] = useState(false);
-  const [urlValue, setUrlValue] = useState("");
+  const [urlValue, setUrlValue] = useState("https://example.com");
   const [jobResult, setJobResult] = useState(null);
   const [systemPrompt, setSystemPrompt] = useState("");
   const [siteName, setSiteName] = useState("Bot");
@@ -41,6 +41,7 @@ export default function App() {
   const [resetOtpEntered, setResetOtpEntered] = useState(false);
   const [resetOtpValue, setResetOtpValue] = useState("");
   const [isRunning, setIsRunning] = useState(false);
+  const [isAuthLoading, setIsAuthLoading] = useState(false);
   const resetEmailRef = useRef(null);
   const resetOtpRef = useRef(null);
   const resetNewPassRef = useRef(null);
@@ -115,6 +116,8 @@ export default function App() {
   };
 
   const handleLogin = async () => {
+    if (isAuthLoading) return;
+    setIsAuthLoading(true);
     const email = loginEmailRef.current?.value?.trim() || "";
     const password = loginPassRef.current?.value || "";
     setStatus("Logging in...");
@@ -124,13 +127,15 @@ export default function App() {
     });
     if (error) {
       setStatus(`Login failed: ${error.message}`);
+      setIsAuthLoading(false);
     } else {
+      setView("app"); // jump to app immediately on success
       setSession(data.session);
       setEmailDisplay(data.session?.user?.email || email);
       const fn = data.session?.user?.user_metadata?.first_name;
       setFirstNameDisplay(fn || firstNameDisplay || (email ? email.split("@")[0] : ""));
       setStatus("Logged in.");
-      setView("app");
+      setIsAuthLoading(false);
     }
   };
 
@@ -229,7 +234,7 @@ export default function App() {
   };
 
   const runJob = async () => {
-    const targetUrl = urlInputRef.current?.value?.trim() || defaultUrl;
+    const targetUrl = (urlInputRef.current?.value || "").trim() || defaultUrl;
     setIsRunning(true);
     setStatus("Submitting job...");
     setJobResult(null);
@@ -305,7 +310,9 @@ export default function App() {
         ref={loginPassRef}
         defaultValue=""
       />
-      <button onClick={handleLogin}>Log In</button>
+      <button onClick={handleLogin} disabled={isAuthLoading} className={isAuthLoading ? "loading" : ""}>
+        {isAuthLoading ? "Logging in..." : "Log In"}
+      </button>
       <p className="link" onClick={() => setView("signup")}>
         Don’t have an account? Sign up
       </p>
@@ -396,8 +403,12 @@ export default function App() {
         <label className="label">Website URL</label>
         <input
           placeholder="https://example.com"
-          defaultValue={defaultUrl}
+          defaultValue={urlValue}
           ref={urlInputRef}
+          autoCorrect="off"
+          autoCapitalize="none"
+          spellCheck={false}
+          onChange={(e) => setUrlValue(e.target.value)}
         />
         <label className="checkbox">
           <input type="checkbox" checked={forceRefresh} onChange={(e) => setForceRefresh(e.target.checked)} />
@@ -440,10 +451,6 @@ export default function App() {
                 />
                 <button onClick={sendChat}>Send</button>
                 <div className="status">{chatStatus}</div>
-                <details style={{ marginTop: 8 }}>
-                  <summary className="muted small">View system prompt</summary>
-                  <pre className="result" style={{ maxHeight: 160 }}>{systemPrompt}</pre>
-                </details>
               </>
             )}
           </>

requirements.txt

@@ -1,64 +1,27 @@
-# ChatSMITH - Website to Chatbot Generator
-# Requirements file - Updated December 2025
+# ChatSMITH - backend requirements (FastAPI + scraper + Supabase auth)
+# Updated: 2025-12-06 (pinned for reproducibility with current stack)
 
-# ============================================================
-# CORE DEPENDENCIES
-# ============================================================
+fastapi==0.123.10
+uvicorn[standard]==0.38.0
+python-dotenv==1.2.1
+# gradio 6.0.2 caps pydantic at 2.12.4
+pydantic==2.12.4
 
-# OpenAI SDK and Agents
-openai>=1.0.0
-openai-agents  # OpenAI Agents SDK for multi-agent orchestration
-# Alternative: Install from GitHub if PyPI version has issues:
-# git+https://github.com/openai/openai-agents-python.git
+# OpenAI + agent stack
+openai==2.9.0
+openai-agents==0.6.2
 
-# Data Models
-pydantic>=2.0.0
+# Supabase auth
+supabase==2.25.0
 
-# Environment Variables
-python-dotenv>=1.0.0
+# Scraping & parsing
+aiohttp==3.13.2
+certifi==2025.11.12
+beautifulsoup4==4.14.3
+lxml==6.0.2
 
-# ============================================================
-# WEB SCRAPING (Smart Website Scraper - Phase 1)
-# ============================================================
+# UI helpers (gradio callbacks used in pipeline)
+gradio==6.0.2
 
-# Async HTTP client for fast parallel scraping
-aiohttp>=3.9.0
-
-# SSL certificates (REQUIRED for Windows!)
-certifi>=2024.0.0
-
-# HTML parsing and content extraction
-beautifulsoup4>=4.12.0
-lxml>=5.0.0
-
-# ============================================================
-# USER INTERFACE
-# ============================================================
-
-# Gradio for web UI (6.x recommended)
-gradio>=4.0.0
-# Supabase authentication
-supabase>=2.4.0
-# FastAPI backend
-fastapi>=0.115.0
-uvicorn[standard]>=0.29.0
-
-# ============================================================
-# OPTIONAL DEPENDENCIES
-# ============================================================
-
-# Export to Word (uncomment if needed)
-# python-docx
-
-# Email functionality (uncomment if needed)
-# sendgrid
-
-# JS rendering for heavy websites (uncomment if needed)
-# Install browsers with: playwright install
-# playwright>=1.48
-
-# ============================================================
-# DEVELOPMENT & TESTING
-# ============================================================
-
-pytest>=8.0.0
+# Dev / testing
+pytest==9.0.1

tests/test_metrics.py

@@ -0,0 +1,176 @@
+import json
+import os
+import sys
+from types import SimpleNamespace
+from pathlib import Path
+
+import pytest
+
+sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))
+
+from backend.app.services import metrics_logger as ml  # noqa: E402
+from backend.app.services import scrape_pipeline as sp  # noqa: E402
+
+
+class DummyProgress:
+    def __call__(self, *args, **kwargs):
+        return None
+
+
+@pytest.mark.asyncio
+async def test_cache_hit_metrics(monkeypatch):
+    monkeypatch.setattr(sp, "ENABLE_METRICS", True)
+    monkeypatch.setattr(sp.gr, "update", lambda **kwargs: {"update": kwargs})
+    monkeypatch.setattr(sp, "is_cached", lambda url: True)
+    monkeypatch.setattr(
+        sp,
+        "get_cached_knowledge",
+        lambda url: {"metadata": {"name": "CachedSite", "url": url, "pages_scraped": 2}},
+    )
+    monkeypatch.setattr(sp, "knowledge_to_chatbot_context", lambda knowledge: "ctx")
+    monkeypatch.setattr(sp, "build_status_new", lambda *args, **kwargs: "status")
+
+    result = await sp.run_full_research_new("https://example.com", progress=DummyProgress())
+    _, _, _, _, _, _, stats = result
+
+    assert stats["cache_hit"] is True
+    assert "tcr_seconds" in stats and stats["tcr_seconds"] >= 0
+
+
+@pytest.mark.asyncio
+async def test_tcr_metrics_non_cache(monkeypatch, tmp_path):
+    monkeypatch.setattr(sp, "ENABLE_METRICS", True)
+    monkeypatch.setattr(sp.gr, "update", lambda **kwargs: {"update": kwargs})
+    monkeypatch.setattr(sp, "is_cached", lambda url: False)
+    monkeypatch.setattr(
+        sp,
+        "scrape_website",
+        lambda url: {
+            "success": True,
+            "total_pages": 1,
+            "pages": [{"title": "Home", "description": "", "sections": [], "content": "", "url": url, "page_type": "homepage"}],
+            "errors": [],
+        },
+    )
+    monkeypatch.setattr(sp, "format_scraped_content_for_context", lambda scraped_data: "content")
+    monkeypatch.setattr(
+        sp,
+        "analyze_content_gaps",
+        lambda scraped_content, url: SimpleNamespace(has_gaps=False, gaps_found=[], confidence_score=10, recommended_searches=[]),
+    )
+    monkeypatch.setattr(sp, "knowledge_to_chatbot_context", lambda knowledge: "ctx")
+    monkeypatch.setattr(sp, "extract_name_from_text", lambda text, url: "Site")
+    monkeypatch.setattr(sp, "create_knowledge_json", lambda url, scraped_data, web_search_results, raw_name: {})
+    monkeypatch.setattr(sp, "save_knowledge_json", lambda knowledge, url: tmp_path / "stub.json")
+    monkeypatch.setattr(sp, "build_status_new", lambda *args, **kwargs: "status")
+
+    result = await sp.run_full_research_new("https://example.com", progress=DummyProgress())
+    _, _, _, _, _, _, stats = result
+
+    assert stats["cache_hit"] is False
+    assert "tcr_seconds" in stats and stats["tcr_seconds"] >= 0
+
+
+def test_log_chat_answer(tmp_path):
+    log_file = tmp_path / "chat.jsonl"
+    ml.log_chat_answer(
+        question="Q?",
+        answer="A!",
+        provenance="primary_only",
+        user="user@example.com",
+        log_path=log_file,
+    )
+
+    data = log_file.read_text(encoding="utf-8").strip().splitlines()
+    assert len(data) == 1
+    record = json.loads(data[0])
+    assert record["question"] == "Q?"
+    assert record["answer"] == "A!"
+    assert record["provenance"] == "primary_only"
+    assert record["user"] == "user@example.com"
+
+
+def test_save_job_metrics_no_supabase(monkeypatch):
+    monkeypatch.setattr(ml, "get_supabase_client", lambda: None)
+    ml.save_job_metrics_to_supabase("https://example.com", {"cache_hit": True})
+    # Should not raise
+
+
+def test_save_chat_answer_no_supabase(monkeypatch):
+    monkeypatch.setattr(ml, "get_supabase_client", lambda: None)
+    ml.save_chat_answer_to_supabase("q", "a", system_prompt="ctx")
+    # Should not raise
+
+
+def test_save_job_metrics_payload(monkeypatch):
+    captured = {}
+
+    class Table:
+        def __init__(self, name):
+            self.name = name
+
+        def insert(self, payload):
+            captured["table"] = self.name
+            captured["payload"] = payload
+            return self
+
+        def execute(self):
+            captured["executed"] = True
+            return True
+
+    class Client:
+        def table(self, name):
+            return Table(name)
+
+    monkeypatch.setattr(ml, "get_supabase_client", lambda: Client())
+    ml.save_job_metrics_to_supabase(
+        "https://example.com",
+        {"cache_hit": True, "tcr_seconds": 1.5, "searches_run": 2, "pages_scraped": 3, "gaps_found": 1},
+        user_id="user-1",
+    )
+    assert captured["table"] == "metrics_job_runs"
+    assert captured["payload"]["url"] == "https://example.com"
+    assert captured["payload"]["cache_hit"] is True
+    assert captured["payload"]["tcr_seconds"] == 1.5
+    assert captured["payload"]["searches_run"] == 2
+    assert captured["payload"]["pages_scraped"] == 3
+    assert captured["payload"]["gaps_found"] == 1
+    assert captured["payload"]["user_id"] == "user-1"
+    assert captured["executed"] is True
+
+
+def test_save_chat_answer_payload(monkeypatch):
+    captured = {}
+
+    class Table:
+        def __init__(self, name):
+            self.name = name
+
+        def insert(self, payload):
+            captured["table"] = self.name
+            captured["payload"] = payload
+            return self
+
+        def execute(self):
+            captured["executed"] = True
+            return True
+
+    class Client:
+        def table(self, name):
+            return Table(name)
+
+    monkeypatch.setattr(ml, "get_supabase_client", lambda: Client())
+    ml.save_chat_answer_to_supabase(
+        question="How?",
+        answer="Here",
+        system_prompt="Contains SECONDARY SOURCE",
+        user_id="user-2",
+        url="https://example.com",
+    )
+    assert captured["table"] == "metrics_chat_answers"
+    assert captured["payload"]["question"] == "How?"
+    assert captured["payload"]["answer"] == "Here"
+    assert captured["payload"]["provenance"] == "primary_plus_secondary"
+    assert captured["payload"]["url"] == "https://example.com"
+    assert captured["payload"]["user_id"] == "user-2"
+    assert captured["executed"] is True