feat: deploy Oppy with Google API integration

Full-stack AI assistant with Gemini, Google Calendar, Gmail, Docs
OAuth 2.0 integration, voice-first UX, and real-time SSE streaming.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.gitignore

@@ -0,0 +1,10 @@
+.env
+__pycache__/
+*.pyc
+node_modules/
+.venv/
+.claude/
+frontend/dist/
+backend/client_secret.json
+backend/token.json
+backend/static/

.replit

@@ -0,0 +1,10 @@
+run = "bash start.sh"
+
+[nix]
+channel = "stable-24_05"
+
+[env]
+PYTHONPATH = "backend"
+
+[deployment]
+run = "bash start.sh"

README.md

@@ -1,10 +1,122 @@
----
-title: Gemini3hackathon Oppy
-emoji: 😻
-colorFrom: indigo
-colorTo: green
-sdk: docker
-pinned: false
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Oppy — AI Voice Assistant for Multi-Project Management
+
+Oppy is a voice-first AI assistant built on Google's Gemini ecosystem. It helps students and professionals juggling multiple projects (school, work, startup) stay on top of everything through natural voice conversation.
+
+## What it does
+
+Oppy connects to your Gmail and Google Calendar, analyzes urgency across all your projects, and talks to you like a direct, caring mentor. Ask it about your schedule, your emails, or what to prioritize — it answers with actionable advice.
+
+**Key features:**
+- Voice conversation powered by Gemini 3 Flash (chat) and Gemini 2.5 Flash TTS (speech)
+- Wake word activation — say "Oppy" to start hands-free
+- Animated SVG avatar with eye tracking, blinking, and mouth animation
+- Real Gmail and Google Calendar integration
+- Expandable project cards with direct action links
+- Gemini-inspired UI (Google Sans, white theme, Google color palette)
+
+## Tech stack
+
+| Layer | Tech |
+|-------|------|
+| Backend | Python, FastAPI, SSE streaming |
+| AI | Gemini 3 Flash (chat + function calling), Gemini 2.5 Flash Preview TTS |
+| Frontend | React 18, Vite, Web Speech API |
+| APIs | Gmail API, Google Calendar API |
+
+## Quick start
+
+### Prerequisites
+- Python 3.11+
+- Node.js 18+
+- A [Google AI API key](https://aistudio.google.com/apikey)
+
+### Setup
+
+```bash
+# Clone
+git clone https://github.com/solanathouu/hack-google.git
+cd hack-google
+
+# Backend
+cd backend
+pip install -r requirements.txt
+echo "GOOGLE_API_KEY=your_key_here" > .env
+
+# Frontend
+cd ../frontend
+npm install
+```
+
+### Run (development)
+
+Terminal 1 — backend:
+```bash
+cd backend
+uvicorn main:app --host 0.0.0.0 --port 8000
+```
+
+Terminal 2 — frontend:
+```bash
+cd frontend
+npx vite --host 0.0.0.0 --port 5173
+```
+
+Open http://localhost:5173
+
+### Run (production / Replit)
+
+```bash
+bash start.sh
+```
+
+This builds the frontend and serves everything from FastAPI on port 8000.
+
+## How to use
+
+1. Open the app — Oppy's avatar appears
+2. Click the orb to authorize your microphone
+3. Once the green "Micro actif" dot appears, say **"Oppy"** or click again
+4. Ask anything: "What's my schedule today?", "Tell me about Sophie's email", "What should I prioritize?"
+5. Oppy answers vocally and listens for your next question
+6. Say "merci" or "au revoir" to end the conversation
+
+## Project structure
+
+```
+backend/
+  main.py          — FastAPI app, API endpoints, static file serving
+  agent.py         — Gemini agent loop, chat session, system prompts
+  tts.py           — Gemini TTS audio generation
+  mock_data.py     — Demo emails, events, web signals
+  urgency.py       — Keyword-based urgency scoring
+  initiative.py    — Project health evaluation
+  tools.py         — Tool functions (read_emails, get_events, search_web)
+  config.json      — Project definitions
+
+frontend/src/
+  App.jsx                    — Main orchestrator (phase state machine)
+  components/
+    JarvisOrb.jsx            — Animated orb with phase-based effects
+    OppyFace.jsx             — SVG face (sparkle eyes + mouth)
+    ConversationOverlay.jsx  — Chat transcript display
+    ProjectCard.jsx          — Expandable project card with sources
+    ProjectCardsDrawer.jsx   — Bottom drawer for project cards
+  hooks/
+    useOperatorSSE.js        — Chat API communication
+    useTTS.js                — Gemini TTS playback
+    useWakeWord.js           — Wake word detection
+    useSpeechRecognition.js  — Speech-to-text for conversation
+```
+
+## API endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| POST | `/api/chat` | Send a message, get SSE streamed response |
+| POST | `/api/tts` | Convert text to speech (WAV audio) |
+| GET | `/api/project/{id}/sources` | Get emails, events, signals for a project |
+| GET | `/api/health` | Health check |
+
+## License
+
+MIT

backend/agent.py

@@ -0,0 +1,388 @@
+import asyncio
+import json
+import os
+import time
+from typing import Callable
+
+from dotenv import load_dotenv
+from google import genai
+from google.genai import types
+
+from google_auth import is_authenticated
+from google_services import fetch_emails, fetch_events
+from initiative import evaluate_project
+from mock_data import MOCK_EMAILS, MOCK_EVENTS
+from tools import get_events, read_emails, search_web, read_doc, list_docs
+from urgency import score_emails, score_urgency
+
+load_dotenv()
+
+SYSTEM_PROMPT = """Tu es Oppy — l'assistant personnel d'un etudiant en alternance qui jongle entre ses cours, son entreprise et sa startup.
+
+Tu parles comme un vrai chef de projet bienveillant mais direct. Pas de blabla corporate. Tu connais la personne, tu sais qu'elle est debordee. Tu lui parles comme un mentor qui a regarde ses mails et son agenda a sa place.
+
+Ton role : scanner ses 3 projets, detecter les urgences, et lui faire un brief cash et actionnable. Tu parles en premier. Tu ne demandes rien. Tu annonces la situation.
+
+Style :
+- Parle en francais naturel, comme a l'oral. Tutoie la personne.
+- Sois direct et concret : pas de "il serait judicieux de", mais "fonce sur ca maintenant".
+- Nomme les personnes par leur prenom (Sophie, pas "sophie.renard@bnpparibas.com").
+- Donne des actions claires : "reponds a Sophie", "bloque 2h ce soir pour le TP".
+- Mets de l'emotion quand c'est urgent : "la ca craint", "t'es dans le rouge".
+
+Format OBLIGATOIRE :
+- Ecris en paragraphes fluides, comme si tu parlais a quelqu'un. PAS de listes a puces, PAS de tirets, PAS de bullet points.
+- Utilise des phrases completes et enchaine les idees naturellement.
+- Separe chaque projet par son nom en gras sur une ligne, puis un paragraphe de 3-5 phrases qui resume la situation et dit quoi faire.
+- Le ton doit etre celui d'un pote qui te brief en 2 minutes au telephone.
+
+Exemple de format attendu :
+
+**Alternance BNP — URGENT**
+
+La ca craint. Sophie t'a ecrit il y a 6 jours et tu n'as toujours pas repondu, elle va finir par escalader. En plus les KPIs sont casses en prod et le filtre date deconne, le PO attend que ce soit fixe avant lundi matin sinon la sprint review de mardi sera un desastre. Reponds-lui ce soir, meme un message court pour dire que tu es dessus, et bloque ton samedi pour debugger le dashboard.
+
+Commence par le projet le plus urgent. Termine par : "Par quoi tu veux commencer ?"
+
+Interdictions :
+- JAMAIS de tirets, puces, bullet points, listes numerotees. Uniquement des phrases et paragraphes.
+- Jamais de jargon IA ou technique inutile.
+- Jamais de "je vais analyser" ou "voici mon analyse" — tu fais, tu ne commentes pas.
+- Ne repete jamais le contenu brut des emails. Synthetise.
+- Ne dis jamais "N/A" ou "aucune donnee". Si tu n'as pas l'info, n'en parle pas.
+
+Outils supplementaires :
+- Tu peux lire un Google Doc avec read_doc(doc_id) si un lien ou ID de doc est mentionne.
+- Tu peux lister les Google Docs recents avec list_docs().
+"""
+
+TOOL_FUNCTIONS = {
+    "read_emails": read_emails,
+    "get_events": get_events,
+    "search_web": search_web,
+    "read_doc": read_doc,
+    "list_docs": list_docs,
+}
+
+TOOL_DECLARATIONS = [
+    types.Tool(function_declarations=[
+        types.FunctionDeclaration(
+            name="read_emails",
+            description="Lit les emails recents pour un projet. Retourne expediteur, sujet, corps, jours depuis derniere reponse.",
+            parameters=types.Schema(
+                type="OBJECT",
+                properties={"project_id": types.Schema(type="STRING", description="ID du projet: school, company, ou startup")},
+                required=["project_id"],
+            ),
+        ),
+        types.FunctionDeclaration(
+            name="get_events",
+            description="Recupere les evenements calendrier a venir pour un projet. Indique titre, heure, et si un bloc de preparation existe.",
+            parameters=types.Schema(
+                type="OBJECT",
+                properties={"project_id": types.Schema(type="STRING", description="ID du projet: school, company, ou startup")},
+                required=["project_id"],
+            ),
+        ),
+        types.FunctionDeclaration(
+            name="search_web",
+            description="Recherche des signaux externes pertinents pour un projet (news, funding, annonces).",
+            parameters=types.Schema(
+                type="OBJECT",
+                properties={"project_id": types.Schema(type="STRING", description="ID du projet: school, company, ou startup")},
+                required=["project_id"],
+            ),
+        ),
+        types.FunctionDeclaration(
+            name="read_doc",
+            description="Lit le contenu d'un Google Doc par son ID. Retourne le titre et le texte.",
+            parameters=types.Schema(
+                type="OBJECT",
+                properties={"doc_id": types.Schema(type="STRING", description="L'ID du document Google Docs (depuis l'URL)")},
+                required=["doc_id"],
+            ),
+        ),
+        types.FunctionDeclaration(
+            name="list_docs",
+            description="Liste les Google Docs recemment modifies. Retourne titre, ID et date de modification.",
+            parameters=types.Schema(
+                type="OBJECT",
+                properties={},
+            ),
+        ),
+    ])
+]
+
+MAX_ITERATIONS = 15
+TIMEOUT_SECONDS = 30
+
+
+def _get_emails_for_scoring(project_id: str, keywords: list[str] | None = None) -> list[dict]:
+    """Get emails for the deterministic scoring phase.
+
+    Uses real Gmail data if authenticated, mock data otherwise.
+    """
+    if is_authenticated():
+        return fetch_emails(project_id, keywords=keywords)
+    return [dict(e) for e in MOCK_EMAILS.get(project_id, [])]
+
+
+def _get_events_for_scoring(project_id: str, keywords: list[str] | None = None) -> list[dict]:
+    """Get events for the deterministic scoring phase.
+
+    Uses real Calendar data if authenticated, mock data otherwise.
+    """
+    if is_authenticated():
+        return fetch_events(project_id, keywords=keywords)
+    return MOCK_EVENTS.get(project_id, [])
+
+
+def build_operator_context(projects: list[dict]) -> str:
+    """Build a summary of projects for Gemini context."""
+    return json.dumps(
+        [{"id": p["id"], "name": p["name"], "contact": p["contact"], "deadline": p["deadline"]}
+         for p in projects],
+        ensure_ascii=False,
+    )
+
+
+def build_data_context(projects: list[dict]) -> str:
+    """Build a full data dump of emails, events and search results for chat context."""
+    lines = []
+    for p in projects:
+        pid = p["id"]
+        lines.append(f"\n=== {p['name']} (id: {pid}) ===")
+
+        if is_authenticated():
+            emails = fetch_emails(pid, keywords=p.get("keywords", []))
+        else:
+            emails = MOCK_EMAILS.get(pid, [])
+
+        if emails:
+            lines.append("Emails:")
+            for e in emails:
+                silence = f"{e['days_since_reply']}j sans reponse" if e.get("days_since_reply") is not None else "newsletter"
+                lines.append(f"  - De: {e['from']} | Sujet: {e['subject']} | {silence}")
+                lines.append(f"    {e.get('body', '')}")
+
+        if is_authenticated():
+            events = fetch_events(pid, keywords=p.get("keywords", []))
+        else:
+            events = MOCK_EVENTS.get(pid, [])
+
+        if events:
+            lines.append("Calendrier:")
+            for ev in events:
+                prep = "oui" if ev.get("prep_block") else "non"
+                lines.append(f"  - {ev['title']} a {ev['time']} (bloc prep: {prep})")
+    return "\n".join(lines)
+
+
+def create_chat_session(projects: list[dict]):
+    """Create a persistent Gemini chat session with full project context.
+
+    Returns (client, chat) — caller must keep client alive.
+    """
+    client = genai.Client(api_key=os.getenv("GOOGLE_API_KEY"))
+
+    data_context = build_data_context(projects)
+    project_summary = build_operator_context(projects)
+
+    chat_system = (
+        "Tu es Oppy, l'assistant personnel vocal d'un etudiant en alternance. "
+        "Tu es en mode CONVERSATION. L'utilisateur te parle et te pose des questions. "
+        "Tu REPONDS UNIQUEMENT a ce qu'il demande. Tu ne fais JAMAIS de brief complet sauf s'il le demande explicitement.\n\n"
+        "REGLE ABSOLUE : lis la question de l'utilisateur et reponds SEULEMENT a cette question. "
+        "Si il demande son programme du jour, donne JUSTE les events du jour. "
+        "Si il demande un mail precis, resume JUSTE ce mail. "
+        "Si il demande de l'aide sur un projet, parle JUSTE de ce projet. "
+        "Ne liste JAMAIS tous les projets sauf si on te le demande.\n\n"
+        "Style :\n"
+        "- Parle en francais naturel, tutoie, sois direct comme un pote.\n"
+        "- Reponds en 2-5 phrases max. Court et percutant.\n"
+        "- Nomme les gens par leur prenom (Sophie, pas sophie.renard@bnpparibas.com).\n"
+        "- Termine par une action concrete ou une question de suivi.\n"
+        "- Ne repete JAMAIS une reponse precedente.\n"
+        "- Pas de tirets, pas de listes a puces. Des phrases.\n\n"
+        f"Projets actifs :\n{project_summary}\n\n"
+        f"Donnees completes :\n{data_context}"
+    )
+
+    chat = client.chats.create(
+        model="gemini-3-flash-preview",
+        config=types.GenerateContentConfig(
+            system_instruction=chat_system,
+        ),
+    )
+    return client, chat
+
+
+async def chat_with_operator(message: str, chat_session, on_event: Callable) -> str:
+    """Answer a user question using a persistent chat session."""
+    response = chat_session.send_message(message)
+    reply = response.text
+
+    await on_event({
+        "type": "chat_reply",
+        "text": reply,
+    })
+
+    return reply
+
+
+async def run_operator(projects: list[dict], on_event: Callable) -> str:
+    """Run the Oppy agent loop.
+
+    Args:
+        projects: list of project dicts from config.json
+        on_event: async callback(event_dict) called for each step
+
+    Returns:
+        The final brief text.
+    """
+    client = genai.Client(api_key=os.getenv("GOOGLE_API_KEY"))
+
+    # Signal to frontend whether we're using live APIs
+    await on_event({
+        "type": "mode",
+        "live": is_authenticated(),
+    })
+
+    project_summary = build_operator_context(projects)
+
+    chat = client.chats.create(
+        model="gemini-2.5-flash",
+        config=types.GenerateContentConfig(
+            system_instruction=SYSTEM_PROMPT,
+            tools=TOOL_DECLARATIONS,
+        ),
+    )
+
+    user_msg = (
+        f"Voici tes 3 projets actifs :\n{project_summary}\n\n"
+        "Commence par scanner chaque projet (emails, calendrier, web), "
+        "puis delivre ton brief proactif."
+    )
+
+    response = chat.send_message(user_msg)
+    iterations = 0
+    start_time = time.time()
+    collected_data = {}
+
+    while iterations < MAX_ITERATIONS and (time.time() - start_time) < TIMEOUT_SECONDS:
+        # Check for function calls
+        function_calls = []
+        for part in response.candidates[0].content.parts:
+            if part.function_call:
+                function_calls.append(part.function_call)
+
+        if not function_calls:
+            break
+
+        # Execute each function call
+        function_responses = []
+        for fc in function_calls:
+            tool_name = fc.name
+            tool_args = dict(fc.args) if fc.args else {}
+
+            await on_event({
+                "type": "tool_call",
+                "tool": tool_name,
+                "project": tool_args.get("project_id", tool_args.get("doc_id", "")),
+                "status": "running",
+            })
+
+            tool_fn = TOOL_FUNCTIONS.get(tool_name)
+            if tool_fn:
+                try:
+                    result = tool_fn(**tool_args)
+                except Exception as e:
+                    result = f"Error: {str(e)}"
+            else:
+                result = f"Unknown tool: {tool_name}"
+
+            pid = tool_args.get("project_id", "")
+            if pid:
+                if pid not in collected_data:
+                    collected_data[pid] = {}
+                collected_data[pid][tool_name] = result
+
+            await on_event({
+                "type": "tool_result",
+                "tool": tool_name,
+                "project": pid or tool_args.get("doc_id", ""),
+                "result": result[:200],
+                "status": "done",
+            })
+
+            function_responses.append(
+                types.Part.from_function_response(
+                    name=tool_name,
+                    response={"result": result},
+                )
+            )
+
+            iterations += 1
+
+        # Send function results back to Gemini
+        response = chat.send_message(function_responses)
+
+    # --- Deterministic scoring phase ---
+    valid_pids = {p["id"] for p in projects}
+    evaluations = {}
+    for pid, data in collected_data.items():
+        if pid not in valid_pids:
+            continue
+
+        project = next(p for p in projects if p["id"] == pid)
+        keywords = project.get("keywords", [])
+
+        emails = _get_emails_for_scoring(pid, keywords=keywords)
+        scored_emails = score_emails(emails)
+
+        for e in scored_emails:
+            await on_event({
+                "type": "urgency",
+                "project": pid,
+                "email_subject": e["subject"],
+                "score": e["urgency_score"],
+            })
+
+        events = _get_events_for_scoring(pid, keywords=keywords)
+        search_score = score_urgency(data.get("search_web", ""))
+
+        evaluation = evaluate_project(project, scored_emails, events, search_score)
+        evaluations[pid] = {"evaluation": evaluation, "project": project}
+
+        await on_event({
+            "type": "initiative",
+            "project": pid,
+            "status": evaluation["status"],
+            "alerts": evaluation["alerts"],
+        })
+
+    # --- Final brief with initiative context ---
+    initiative_summary = ""
+    for pid, cached in evaluations.items():
+        evaluation = cached["evaluation"]
+        project = cached["project"]
+        initiative_summary += (
+            f"\n[{project.get('name', pid)}] Status: {evaluation['status']}\n"
+            f"Alertes: {'; '.join(evaluation['alerts']) if evaluation['alerts'] else 'aucune'}\n"
+        )
+
+    brief_prompt = (
+        f"Voici les evaluations d'urgence de tes 3 projets :\n{initiative_summary}\n\n"
+        "Genere maintenant ton brief proactif final. Commence par le plus urgent. "
+        "5 bullets max par projet. Sois brutalement concis. Parle en francais."
+    )
+
+    brief_response = chat.send_message(brief_prompt)
+    brief_text = brief_response.text
+
+    await on_event({
+        "type": "brief",
+        "text": brief_text,
+    })
+
+    return brief_text

backend/auth_cli.py

@@ -0,0 +1,60 @@
+"""CLI script to authenticate Google account (manual code paste)."""
+
+import json
+from pathlib import Path
+
+from google.oauth2.credentials import Credentials
+from google_auth_oauthlib.flow import Flow
+
+SCOPES = [
+    "https://www.googleapis.com/auth/gmail.readonly",
+    "https://www.googleapis.com/auth/calendar.readonly",
+    "https://www.googleapis.com/auth/documents.readonly",
+    "https://www.googleapis.com/auth/drive.metadata.readonly",
+]
+
+CLIENT_SECRET_PATH = Path(__file__).parent / "client_secret.json"
+TOKEN_PATH = Path(__file__).parent / "token.json"
+
+REDIRECT_URI = "urn:ietf:wg:oauth:2.0:oob"
+
+
+def main():
+    with open(CLIENT_SECRET_PATH) as f:
+        client_config = json.load(f)
+
+    if "web" in client_config:
+        web = client_config["web"]
+        config = {
+            "installed": {
+                "client_id": web["client_id"],
+                "client_secret": web["client_secret"],
+                "auth_uri": web["auth_uri"],
+                "token_uri": web["token_uri"],
+                "redirect_uris": ["urn:ietf:wg:oauth:2.0:oob", "http://localhost"],
+            }
+        }
+    else:
+        config = client_config
+
+    flow = Flow.from_client_config(config, scopes=SCOPES, redirect_uri="http://localhost:8091/")
+
+    auth_url, _ = flow.authorization_url(access_type="offline", prompt="consent")
+
+    print("\n=== Google OAuth ===")
+    print(f"\nOpen this URL in your browser:\n\n{auth_url}\n")
+    print("After granting permissions, you'll be redirected to localhost.")
+    print("Copy the FULL URL from your browser address bar and paste it here.\n")
+
+    redirect_url = input("Paste the redirect URL here: ").strip()
+
+    flow.fetch_token(authorization_response=redirect_url)
+    creds = flow.credentials
+
+    TOKEN_PATH.write_text(creds.to_json())
+    print(f"\nToken saved to {TOKEN_PATH}")
+    print("You're authenticated! All Google API tools are now live.")
+
+
+if __name__ == "__main__":
+    main()

backend/config.json

@@ -0,0 +1,29 @@
+{
+  "mode": "live",
+  "projects": [
+    {
+      "id": "school",
+      "name": "Master IA \u2014 Sorbonne",
+      "contact": "whung@albertschool.com",
+      "deadline": "2026-03-18T23:59:00",
+      "color": "#00FF88",
+      "keywords": ["cours", "rendu", "memoire", "soutenance", "TP", "Deep Learning"]
+    },
+    {
+      "id": "company",
+      "name": "Alternance \u2014 BNP Paribas",
+      "contact": "wei_ling.hung@edu.escp.eu",
+      "deadline": "2026-03-17T09:00:00",
+      "color": "#FF4444",
+      "keywords": ["sprint", "daily", "jira", "livrable", "prod", "dashboard", "bloquant"]
+    },
+    {
+      "id": "startup",
+      "name": "Side Project \u2014 NoctaAI",
+      "contact": "weilinghung99@gmail.com",
+      "deadline": "2026-04-05T00:00:00",
+      "color": "#FF8800",
+      "keywords": ["NoctaAI", "MVP", "landing", "beta", "funding"]
+    }
+  ]
+}

backend/google_auth.py

@@ -0,0 +1,104 @@
+"""Google OAuth 2.0 flow for Gmail, Calendar, and Docs APIs."""
+
+import os
+import json
+from pathlib import Path
+
+from google_auth_oauthlib.flow import Flow
+from google.oauth2.credentials import Credentials
+from google.auth.transport.requests import Request
+
+SCOPES = [
+    "https://www.googleapis.com/auth/gmail.readonly",
+    "https://www.googleapis.com/auth/calendar.readonly",
+    "https://www.googleapis.com/auth/documents.readonly",
+    "https://www.googleapis.com/auth/drive.metadata.readonly",
+]
+
+TOKEN_PATH = Path(__file__).parent / "token.json"
+CLIENT_SECRET_PATH = Path(__file__).parent / "client_secret.json"
+
+# In-memory credentials cache (single-user demo)
+_credentials: Credentials | None = None
+
+
+def _get_redirect_uri() -> str:
+    return os.getenv("GOOGLE_REDIRECT_URI", "http://localhost:8000/api/auth/callback")
+
+
+def has_client_secret() -> bool:
+    """Check if OAuth client_secret.json is configured."""
+    return CLIENT_SECRET_PATH.exists()
+
+
+def get_auth_url() -> str | None:
+    """Generate the Google OAuth consent URL."""
+    if not has_client_secret():
+        return None
+
+    flow = Flow.from_client_secrets_file(
+        str(CLIENT_SECRET_PATH),
+        scopes=SCOPES,
+        redirect_uri=_get_redirect_uri(),
+    )
+    auth_url, _ = flow.authorization_url(
+        access_type="offline",
+        include_granted_scopes="true",
+        prompt="consent",
+    )
+    return auth_url
+
+
+def handle_callback(authorization_code: str) -> Credentials:
+    """Exchange the authorization code for credentials."""
+    global _credentials
+
+    flow = Flow.from_client_secrets_file(
+        str(CLIENT_SECRET_PATH),
+        scopes=SCOPES,
+        redirect_uri=_get_redirect_uri(),
+    )
+    flow.fetch_token(code=authorization_code)
+    _credentials = flow.credentials
+
+    # Persist token for reuse across restarts
+    TOKEN_PATH.write_text(_credentials.to_json())
+    return _credentials
+
+
+def get_credentials() -> Credentials | None:
+    """Get valid credentials, refreshing if needed."""
+    global _credentials
+
+    if _credentials and _credentials.valid:
+        return _credentials
+
+    if _credentials and _credentials.expired and _credentials.refresh_token:
+        _credentials.refresh(Request())
+        TOKEN_PATH.write_text(_credentials.to_json())
+        return _credentials
+
+    # Try loading from persisted token
+    if TOKEN_PATH.exists():
+        _credentials = Credentials.from_authorized_user_file(str(TOKEN_PATH), SCOPES)
+        if _credentials.valid:
+            return _credentials
+        if _credentials.expired and _credentials.refresh_token:
+            _credentials.refresh(Request())
+            TOKEN_PATH.write_text(_credentials.to_json())
+            return _credentials
+
+    return None
+
+
+def is_authenticated() -> bool:
+    """Check if we have valid Google credentials."""
+    return get_credentials() is not None
+
+
+def logout():
+    """Clear stored credentials."""
+    global _credentials
+    _credentials = None
+    if TOKEN_PATH.exists():
+        TOKEN_PATH.unlink()

backend/google_services.py

@@ -0,0 +1,292 @@
+"""Real Google API wrappers for Gmail, Calendar, Docs, and Search."""
+
+import base64
+import os
+import re
+from datetime import datetime, timedelta, timezone
+
+from dotenv import load_dotenv
+from google import genai
+from google.genai import types
+from googleapiclient.discovery import build
+
+from google_auth import get_credentials
+
+load_dotenv()
+
+
+def _get_gmail_service():
+    creds = get_credentials()
+    if not creds:
+        return None
+    return build("gmail", "v1", credentials=creds)
+
+
+def _get_calendar_service():
+    creds = get_credentials()
+    if not creds:
+        return None
+    return build("calendar", "v3", credentials=creds)
+
+
+def _get_docs_service():
+    creds = get_credentials()
+    if not creds:
+        return None
+    return build("docs", "v1", credentials=creds)
+
+
+def _extract_body(payload: dict) -> str:
+    """Extract plain text body from Gmail message payload."""
+    if payload.get("body", {}).get("data"):
+        return base64.urlsafe_b64decode(payload["body"]["data"]).decode("utf-8", errors="replace")
+
+    parts = payload.get("parts", [])
+    for part in parts:
+        if part.get("mimeType") == "text/plain" and part.get("body", {}).get("data"):
+            return base64.urlsafe_b64decode(part["body"]["data"]).decode("utf-8", errors="replace")
+        # Recurse into multipart
+        if part.get("parts"):
+            result = _extract_body(part)
+            if result:
+                return result
+
+    return ""
+
+
+def _get_header(headers: list[dict], name: str) -> str:
+    """Get a header value by name from Gmail message headers."""
+    for h in headers:
+        if h["name"].lower() == name.lower():
+            return h["value"]
+    return ""
+
+
+def _days_since(date_str: str) -> int | None:
+    """Calculate days since an email date. Returns None if unparseable."""
+    try:
+        # Gmail dates are like "Fri, 14 Mar 2026 10:30:00 +0100"
+        # Try multiple formats
+        for fmt in ["%a, %d %b %Y %H:%M:%S %z", "%d %b %Y %H:%M:%S %z"]:
+            try:
+                dt = datetime.strptime(date_str, fmt)
+                return (datetime.now(timezone.utc) - dt).days
+            except ValueError:
+                continue
+        return None
+    except Exception:
+        return None
+
+
+def fetch_emails(project_id: str, keywords: list[str] | None = None, max_results: int = 10) -> list[dict]:
+    """Fetch recent emails from Gmail, optionally filtered by project keywords.
+
+    Returns list of dicts with: from, subject, body, date, days_since_reply
+    """
+    service = _get_gmail_service()
+    if not service:
+        return []
+
+    # Build search query from project keywords
+    query = ""
+    if keywords:
+        query = " OR ".join(keywords)
+        query = f"({query})"
+    query += " newer_than:14d"
+
+    try:
+        results = service.users().messages().list(
+            userId="me",
+            q=query.strip(),
+            maxResults=max_results,
+        ).execute()
+
+        messages = results.get("messages", [])
+        emails = []
+
+        for msg_meta in messages:
+            msg = service.users().messages().get(
+                userId="me",
+                id=msg_meta["id"],
+                format="full",
+            ).execute()
+
+            headers = msg.get("payload", {}).get("headers", [])
+            from_addr = _get_header(headers, "From")
+            subject = _get_header(headers, "Subject")
+            date_str = _get_header(headers, "Date")
+            body = _extract_body(msg.get("payload", {}))
+
+            # Truncate body for context window efficiency
+            if len(body) > 500:
+                body = body[:500] + "..."
+
+            days = _days_since(date_str)
+
+            emails.append({
+                "from": from_addr,
+                "subject": subject,
+                "body": body,
+                "date": date_str,
+                "days_since_reply": days,
+            })
+
+        return emails
+
+    except Exception as e:
+        print(f"Gmail API error: {e}")
+        return []
+
+
+def fetch_events(project_id: str, keywords: list[str] | None = None, days_ahead: int = 7) -> list[dict]:
+    """Fetch upcoming calendar events, optionally filtered by keywords.
+
+    Returns list of dicts with: title, time, prep_block
+    """
+    service = _get_calendar_service()
+    if not service:
+        return []
+
+    now = datetime.now(timezone.utc)
+    time_min = now.isoformat()
+    time_max = (now + timedelta(days=days_ahead)).isoformat()
+
+    try:
+        # Fetch all events, filter locally by keywords for better matching
+        results = service.events().list(
+            calendarId="primary",
+            timeMin=time_min,
+            timeMax=time_max,
+            maxResults=30,
+            singleEvents=True,
+            orderBy="startTime",
+        ).execute()
+
+        items = results.get("items", [])
+        events = []
+
+        for item in items:
+            start = item["start"].get("dateTime", item["start"].get("date", ""))
+            title = item.get("summary", "Sans titre")
+
+            # Filter by keywords if provided (case-insensitive, any keyword matches)
+            if keywords:
+                title_lower = title.lower()
+                if not any(k.lower() in title_lower for k in keywords):
+                    continue
+
+            # Detect prep blocks
+            is_prep = bool(re.search(r"prep|preparation|revision", title, re.IGNORECASE))
+
+            events.append({
+                "title": title,
+                "time": start,
+                "prep_block": is_prep,
+            })
+
+        return events
+
+    except Exception as e:
+        print(f"Calendar API error: {e}")
+        return []
+
+
+def fetch_doc_content(doc_id: str) -> dict:
+    """Fetch a Google Doc's title and text content.
+
+    Args:
+        doc_id: The Google Docs document ID (from the URL).
+
+    Returns dict with: title, content (plain text excerpt)
+    """
+    service = _get_docs_service()
+    if not service:
+        return {"title": "", "content": "Not authenticated with Google."}
+
+    try:
+        doc = service.documents().get(documentId=doc_id).execute()
+        title = doc.get("title", "Untitled")
+
+        # Extract plain text from document body
+        body = doc.get("body", {})
+        content_parts = []
+
+        for element in body.get("content", []):
+            paragraph = element.get("paragraph")
+            if paragraph:
+                for elem in paragraph.get("elements", []):
+                    text_run = elem.get("textRun")
+                    if text_run:
+                        content_parts.append(text_run.get("content", ""))
+
+        full_text = "".join(content_parts).strip()
+
+        # Truncate for context efficiency
+        if len(full_text) > 2000:
+            full_text = full_text[:2000] + "..."
+
+        return {"title": title, "content": full_text}
+
+    except Exception as e:
+        print(f"Docs API error: {e}")
+        return {"title": "", "content": f"Error reading document: {e}"}
+
+
+def list_recent_docs(max_results: int = 5) -> list[dict]:
+    """List recently modified Google Docs using the Drive API.
+
+    Returns list of dicts with: id, title, modified_time
+    """
+    creds = get_credentials()
+    if not creds:
+        return []
+
+    try:
+        drive = build("drive", "v3", credentials=creds)
+        results = drive.files().list(
+            q="mimeType='application/vnd.google-apps.document'",
+            orderBy="modifiedTime desc",
+            pageSize=max_results,
+            fields="files(id, name, modifiedTime)",
+        ).execute()
+
+        files = results.get("files", [])
+        return [
+            {"id": f["id"], "title": f["name"], "modified_time": f["modifiedTime"]}
+            for f in files
+        ]
+
+    except Exception as e:
+        print(f"Drive API error: {e}")
+        return []
+
+
+def search_project_signals(project_name: str, keywords: list[str] | None = None) -> str:
+    """Search the web for recent signals relevant to a project using Gemini + Google Search grounding.
+
+    Returns a concise summary of external signals (news, funding, announcements).
+    """
+    api_key = os.getenv("GOOGLE_API_KEY")
+    if not api_key:
+        return ""
+
+    search_terms = project_name
+    if keywords:
+        search_terms += " " + " ".join(keywords[:3])
+
+    try:
+        client = genai.Client(api_key=api_key)
+        response = client.models.generate_content(
+            model="gemini-2.5-flash",
+            contents=(
+                f"Recherche les actualites recentes et signaux externes pertinents pour : {search_terms}. "
+                "Donne 2-3 bullet points courts en francais. Seulement les infos factuelles et recentes."
+            ),
+            config=types.GenerateContentConfig(
+                tools=[types.Tool(google_search=types.GoogleSearch())],
+            ),
+        )
+        return response.text.strip() if response.text else ""
+    except Exception as e:
+        print(f"Google Search grounding error: {e}")
+        return ""

backend/initiative.py

@@ -0,0 +1,50 @@
+from datetime import datetime
+
+
+def evaluate_project(project: dict, emails: list[dict], events: list[dict], search_score: float) -> dict:
+    """Evaluate a project's status based on deterministic rules.
+
+    Returns:
+        {"status": "READY"|"URGENT"|"SIGNAL", "alerts": [str]}
+    """
+    alerts = []
+    status = "READY"
+
+    # Rule 1: Silence detected
+    reply_days = [
+        e["days_since_reply"]
+        for e in emails
+        if e.get("days_since_reply") is not None
+    ]
+    if reply_days:
+        max_silence = max(reply_days)
+        if max_silence >= 5:
+            contact = emails[0]["from"]
+            alerts.append(f"Silence depuis {max_silence} jours de {contact}")
+            status = "URGENT"
+
+    # Rule 2: Deadline < 48h without prep block
+    deadline_str = project.get("deadline")
+    if not deadline_str:
+        return {"status": status, "alerts": alerts}
+    deadline = datetime.fromisoformat(deadline_str)
+    now = datetime.now()
+    hours_to_deadline = (deadline - now).total_seconds() / 3600
+    has_prep = any(e.get("prep_block", False) for e in events)
+    if hours_to_deadline < 48 and not has_prep:
+        alerts.append(f"Deadline dans {int(hours_to_deadline)}h - aucun bloc de prep")
+        status = "URGENT"
+
+    # Rule 3: External signal relevant
+    if search_score > 0.6:
+        alerts.append("Signal externe pertinent detecte")
+        if status != "URGENT":
+            status = "SIGNAL"
+
+    # Rule 4: High urgency email
+    urgency_scores = [e.get("urgency_score", 0) for e in emails]
+    if any(s > 0.8 for s in urgency_scores):
+        alerts.append("Email a haute urgence detecte")
+        status = "URGENT"
+
+    return {"status": status, "alerts": alerts}

backend/main.py

@@ -0,0 +1,212 @@
+import asyncio
+import json
+import os
+from contextlib import asynccontextmanager
+
+from dotenv import load_dotenv
+from pathlib import Path
+
+from fastapi import FastAPI, Query
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import FileResponse, Response, RedirectResponse
+from fastapi.staticfiles import StaticFiles
+from pydantic import BaseModel
+from sse_starlette.sse import EventSourceResponse
+
+from agent import chat_with_operator, create_chat_session, run_operator
+from google_auth import get_auth_url, handle_callback, has_client_secret, is_authenticated, logout
+from mock_data import MOCK_EMAILS, MOCK_EVENTS, MOCK_SEARCH
+from tts import generate_speech
+from urgency import load_model
+
+load_dotenv()
+
+# Fail fast if Gemini API key is missing
+api_key = os.getenv("GOOGLE_API_KEY")
+if not api_key or api_key == "your_key_here":
+    raise RuntimeError("GOOGLE_API_KEY not set. Check backend/.env")
+
+FRONTEND_URL = os.getenv("FRONTEND_URL", "http://localhost:5173")
+
+
+# Persistent chat session (created on first /api/chat call)
+_chat_client = None
+_chat_session = None
+
+
+def get_chat_session():
+    global _chat_client, _chat_session
+    if _chat_session is None:
+        config = load_config()
+        _chat_client, _chat_session = create_chat_session(config["projects"])
+    return _chat_session
+
+
+@asynccontextmanager
+async def lifespan(app):
+    load_model()
+    print("HuggingFace model loaded.")
+    if has_client_secret():
+        print("OAuth client_secret.json found. Google API integration enabled.")
+    else:
+        print("No client_secret.json found. Running in mock/demo mode.")
+    yield
+
+
+app = FastAPI(title="Oppy", lifespan=lifespan)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+def load_config():
+    from pathlib import Path
+    config_path = Path(__file__).parent / "config.json"
+    with open(config_path) as f:
+        return json.load(f)
+
+
+# ---- OAuth Endpoints ----
+
+@app.get("/api/auth/status")
+async def auth_status():
+    """Check if user is authenticated with Google APIs."""
+    return {
+        "authenticated": is_authenticated(),
+        "oauth_available": has_client_secret(),
+    }
+
+
+@app.get("/api/auth/login")
+async def auth_login():
+    """Redirect to Google OAuth consent screen."""
+    url = get_auth_url()
+    if not url:
+        return {"error": "OAuth not configured. Place client_secret.json in backend/."}
+    return RedirectResponse(url)
+
+
+@app.get("/api/auth/callback")
+async def auth_callback(code: str = Query(...)):
+    """Handle Google OAuth callback."""
+    handle_callback(code)
+    return RedirectResponse(f"{FRONTEND_URL}?auth=success")
+
+
+@app.get("/api/auth/logout")
+async def auth_logout():
+    """Clear Google credentials."""
+    logout()
+    return {"status": "logged_out"}
+
+
+# ---- Core Endpoints ----
+
+@app.get("/api/run")
+async def run():
+    config = load_config()
+    queue = asyncio.Queue()
+
+    async def on_event(event: dict):
+        await queue.put(event)
+
+    async def generator():
+        task = asyncio.create_task(run_operator(config["projects"], on_event))
+
+        while True:
+            try:
+                event = await asyncio.wait_for(queue.get(), timeout=1.0)
+                yield {"event": event["type"], "data": json.dumps(event, ensure_ascii=False)}
+                if event["type"] == "brief":
+                    break
+            except asyncio.TimeoutError:
+                if task.done():
+                    break
+                continue
+
+        await task
+
+    return EventSourceResponse(generator())
+
+
+class TTSRequest(BaseModel):
+    text: str
+
+
+class ChatRequest(BaseModel):
+    message: str
+
+
+@app.post("/api/tts")
+async def tts(req: TTSRequest):
+    audio_bytes = generate_speech(req.text)
+    return Response(content=audio_bytes, media_type="audio/wav")
+
+
+@app.post("/api/chat")
+async def chat(req: ChatRequest):
+    session = get_chat_session()
+    queue = asyncio.Queue()
+
+    async def on_event(event: dict):
+        await queue.put(event)
+
+    async def generator():
+        task = asyncio.create_task(
+            chat_with_operator(req.message, session, on_event)
+        )
+
+        while True:
+            try:
+                event = await asyncio.wait_for(queue.get(), timeout=1.0)
+                yield {"event": event["type"], "data": json.dumps(event, ensure_ascii=False)}
+                if event["type"] == "chat_reply":
+                    break
+            except asyncio.TimeoutError:
+                if task.done():
+                    break
+                continue
+
+        await task
+
+    return EventSourceResponse(generator())
+
+
+@app.get("/api/project/{project_id}/sources")
+async def project_sources(project_id: str):
+    emails = MOCK_EMAILS.get(project_id, [])
+    events = MOCK_EVENTS.get(project_id, [])
+    search = MOCK_SEARCH.get(project_id, "")
+    return {
+        "emails": emails,
+        "events": events,
+        "search": search,
+    }
+
+
+@app.get("/api/health")
+async def health():
+    return {
+        "status": "ok",
+        "google_authenticated": is_authenticated(),
+        "oauth_available": has_client_secret(),
+    }
+
+
+# --- Serve frontend static files (for Replit / production) ---
+_static_dir = Path(__file__).parent / "static"
+if _static_dir.exists():
+    app.mount("/assets", StaticFiles(directory=_static_dir / "assets"), name="assets")
+
+    @app.get("/{full_path:path}")
+    async def serve_spa(full_path: str):
+        """Serve the React SPA for any non-API route."""
+        file_path = _static_dir / full_path
+        if file_path.is_file():
+            return FileResponse(file_path)
+        return FileResponse(_static_dir / "index.html")

backend/mock_data.py

@@ -0,0 +1,120 @@
+MOCK_EMAILS = {
+    "school": [
+        {
+            "from": "prof.martinez@sorbonne.fr",
+            "subject": "Rendu TP Deep Learning",
+            "body": "Le rendu du TP sur les transformers est pour mercredi 18 mars 23h59. Format notebook + rapport PDF. Pas d'extension possible.",
+            "date": "2026-03-12",
+            "days_since_reply": 0,
+        },
+        {
+            "from": "admin-master@sorbonne.fr",
+            "subject": "Soutenance memoire - date fixee",
+            "body": "Votre soutenance est fixee au 15 avril. Merci de confirmer votre sujet avant le 25 mars.",
+            "date": "2026-03-13",
+            "days_since_reply": 1,
+        },
+        {
+            "from": "prof.dubois@sorbonne.fr",
+            "subject": "Projet NLP - constitution des groupes",
+            "body": "Les groupes pour le projet NLP doivent etre constitues avant vendredi. 3 personnes max. Envoyez-moi vos groupes par mail.",
+            "date": "2026-03-14",
+            "days_since_reply": 0,
+        },
+        {
+            "from": "bde-ia@sorbonne.fr",
+            "subject": "Hackathon IA Sorbonne - 22 mars",
+            "body": "Le hackathon annuel du Master IA aura lieu le 22 mars. Inscriptions ouvertes, equipes de 4. Theme : IA generative appliquee a la sante.",
+            "date": "2026-03-14",
+            "days_since_reply": None,
+        },
+    ],
+    "company": [
+        {
+            "from": "sophie.renard@bnpparibas.com",
+            "subject": "Re: Dashboard analytics - feedback",
+            "body": "Le product owner attend les corrections sur le dashboard avant lundi matin. Les KPIs ne remontent pas correctement en prod. C'est bloquant pour la review sprint.",
+            "date": "2026-03-08",
+            "days_since_reply": 6,
+        },
+        {
+            "from": "tech-lead@bnpparibas.com",
+            "subject": "Daily standup notes",
+            "body": "Action item pour toi : fixer le bug sur le filtre date du dashboard. Sprint review mardi.",
+            "date": "2026-03-13",
+            "days_since_reply": 1,
+        },
+        {
+            "from": "rh@bnpparibas.com",
+            "subject": "Convention alternance - signature requise",
+            "body": "Merci de signer et retourner votre convention d'alternance avant le 20 mars. Document en piece jointe.",
+            "date": "2026-03-12",
+            "days_since_reply": 2,
+        },
+        {
+            "from": "sophie.renard@bnpparibas.com",
+            "subject": "Formation Power BI - jeudi 14h",
+            "body": "N'oublie pas la formation Power BI jeudi a 14h en salle 3B. C'est obligatoire pour tous les alternants data.",
+            "date": "2026-03-13",
+            "days_since_reply": 0,
+        },
+    ],
+    "startup": [
+        {
+            "from": "yassine@noctaai.com",
+            "subject": "Re: Landing page v2",
+            "body": "La landing est live mais le taux de conversion est a 0.8%. On doit refaire le hero. Tu peux t'en occuper ce weekend ?",
+            "date": "2026-03-11",
+            "days_since_reply": 3,
+        },
+        {
+            "from": "newsletter@techcrunch.com",
+            "subject": "Y Combinator ouvre les candidatures W26",
+            "body": "YC Winter 2026 applications are now open. Deadline: April 10. Focus on AI-native startups.",
+            "date": "2026-03-14",
+            "days_since_reply": None,
+        },
+        {
+            "from": "investisseur@station-f.co",
+            "subject": "Suite a notre echange - NoctaAI",
+            "body": "Merci pour le pitch de mardi. On aimerait voir une demo live de votre produit. Dispo semaine prochaine ?",
+            "date": "2026-03-13",
+            "days_since_reply": 1,
+        },
+        {
+            "from": "yassine@noctaai.com",
+            "subject": "Roadmap produit Q2",
+            "body": "J'ai mis a jour la roadmap sur Notion. On doit prioriser : auth Google, integration Slack, et le mode offline. On en parle dimanche ?",
+            "date": "2026-03-14",
+            "days_since_reply": 0,
+        },
+    ],
+}
+
+MOCK_EVENTS = {
+    "school": [
+        {"title": "TP Deep Learning - rendu", "time": "2026-03-18T23:59", "prep_block": False},
+        {"title": "Cours NLP avance", "time": "2026-03-15T09:00", "prep_block": True},
+        {"title": "TD Maths pour le ML", "time": "2026-03-14T14:00", "prep_block": False},
+        {"title": "Reunion groupe projet NLP", "time": "2026-03-16T11:00", "prep_block": False},
+        {"title": "Hackathon IA Sorbonne", "time": "2026-03-22T09:00", "prep_block": False},
+    ],
+    "company": [
+        {"title": "Sprint Review", "time": "2026-03-17T10:00", "prep_block": False},
+        {"title": "Daily Standup", "time": "2026-03-14T09:30", "prep_block": True},
+        {"title": "Formation Power BI", "time": "2026-03-14T14:00", "prep_block": False},
+        {"title": "1:1 avec Sophie", "time": "2026-03-15T11:00", "prep_block": False},
+        {"title": "Demo client interne", "time": "2026-03-19T15:00", "prep_block": False},
+    ],
+    "startup": [
+        {"title": "Call investisseur Station F", "time": "2026-03-17T18:00", "prep_block": False},
+        {"title": "Sync produit avec Yassine", "time": "2026-03-16T20:00", "prep_block": False},
+        {"title": "Deadline YC W26", "time": "2026-04-10T23:59", "prep_block": False},
+    ],
+}
+
+MOCK_SEARCH = {
+    "school": "Sorbonne Universite - les inscriptions au Master IA 2026 battent des records, +40% de candidatures.",
+    "company": "BNP Paribas lance un nouveau programme d'acceleration data & IA pour ses alternants.",
+    "startup": "Y Combinator ouvre les candidatures Winter 2026. Deadline 10 avril. Focus AI-native startups.",
+}

backend/requirements.txt

@@ -0,0 +1,9 @@
+google-genai>=1.0.0
+sentence-transformers>=3.0.0
+fastapi>=0.115.0
+uvicorn>=0.30.0
+sse-starlette>=2.0.0
+python-dotenv>=1.0.0
+google-auth>=2.0.0
+google-auth-oauthlib>=1.0.0
+google-api-python-client>=2.0.0

backend/test_smoke.py

@@ -0,0 +1,55 @@
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+
+def test_gemini_connection():
+    from google import genai
+
+    api_key = os.getenv("GOOGLE_API_KEY")
+    assert api_key and api_key != "your_key_here", "GOOGLE_API_KEY not set in .env"
+
+    client = genai.Client(api_key=api_key)
+
+    MODEL_NAME = "gemini-2.5-flash"
+
+    response = client.models.generate_content(
+        model=MODEL_NAME,
+        contents="Reply with exactly: OK",
+    )
+    assert "OK" in response.text
+    print(f"Gemini OK (model={MODEL_NAME}): {response.text.strip()}")
+
+
+def test_gemini_function_calling_api():
+    """Verify the SDK supports the function calling API we need."""
+    from google.genai import types
+
+    assert hasattr(types.Part, "from_function_response"), (
+        "types.Part.from_function_response not found — SDK version may be incompatible. "
+        "Try: pip install --upgrade google-genai"
+    )
+    print("Gemini SDK function calling API: OK")
+
+
+def test_huggingface_model():
+    import torch
+    from sentence_transformers import CrossEncoder
+
+    model = CrossEncoder(
+        "cross-encoder/ms-marco-MiniLM-L6-v2",
+        default_activation_function=torch.nn.Sigmoid(),
+    )
+    pairs = [("urgent action required deadline missed", "Le product owner attend les corrections avant lundi. C'est bloquant.")]
+    scores = model.predict(pairs)
+    score = float(scores[0])
+    assert 0.0 <= score <= 1.0
+    print(f"HuggingFace OK: score={score:.3f}")
+
+
+if __name__ == "__main__":
+    test_gemini_connection()
+    test_gemini_function_calling_api()
+    test_huggingface_model()
+    print("\nAll smoke tests passed.")

backend/tools.py

@@ -0,0 +1,126 @@
+"""Tool functions exposed to Gemini. Uses real Google APIs when authenticated, mock data otherwise."""
+
+import json
+from pathlib import Path
+
+from google_auth import is_authenticated
+from google_services import fetch_emails, fetch_events, fetch_doc_content, list_recent_docs, search_project_signals
+from mock_data import MOCK_EMAILS, MOCK_EVENTS, MOCK_SEARCH
+
+
+def _load_project_keywords(project_id: str) -> list[str]:
+    """Load keywords for a project from config.json."""
+    config_path = Path(__file__).parent / "config.json"
+    with open(config_path) as f:
+        config = json.load(f)
+    for p in config.get("projects", []):
+        if p["id"] == project_id:
+            return p.get("keywords", [])
+    return []
+
+
+def read_emails(project_id: str) -> str:
+    """Read recent emails for a project. Uses Gmail API if authenticated, mock data otherwise."""
+    if is_authenticated():
+        keywords = _load_project_keywords(project_id)
+        emails = fetch_emails(project_id, keywords=keywords)
+        if not emails:
+            return f"No emails found for project {project_id}."
+        lines = []
+        for e in emails:
+            days = e.get("days_since_reply")
+            silence = f"{days} days ago" if days is not None else "unknown"
+            lines.append(
+                f"From: {e['from']}\n"
+                f"Subject: {e['subject']}\n"
+                f"Body: {e['body']}\n"
+                f"Last reply: {silence}"
+            )
+        return "\n---\n".join(lines)
+
+    # Fallback to mock data
+    emails = MOCK_EMAILS.get(project_id, [])
+    if not emails:
+        return f"No emails found for project {project_id}."
+    lines = []
+    for e in emails:
+        silence = f"{e['days_since_reply']} days ago" if e["days_since_reply"] is not None else "N/A (newsletter)"
+        lines.append(
+            f"From: {e['from']}\n"
+            f"Subject: {e['subject']}\n"
+            f"Body: {e['body']}\n"
+            f"Last reply: {silence}"
+        )
+    return "\n---\n".join(lines)
+
+
+def get_events(project_id: str) -> str:
+    """Get upcoming calendar events for a project. Uses Calendar API if authenticated, mock data otherwise."""
+    if is_authenticated():
+        keywords = _load_project_keywords(project_id)
+        events = fetch_events(project_id, keywords=keywords)
+        if not events:
+            return f"No upcoming events for project {project_id}."
+        lines = []
+        for ev in events:
+            prep = "YES" if ev["prep_block"] else "NO"
+            lines.append(f"{ev['title']} at {ev['time']} (prep block: {prep})")
+        return "\n".join(lines)
+
+    # Fallback to mock data
+    events = MOCK_EVENTS.get(project_id, [])
+    if not events:
+        return f"No upcoming events for project {project_id}."
+    lines = []
+    for ev in events:
+        prep = "YES" if ev["prep_block"] else "NO"
+        lines.append(f"{ev['title']} at {ev['time']} (prep block: {prep})")
+    return "\n".join(lines)
+
+
+def search_web(project_id: str) -> str:
+    """Search for recent external signals relevant to a project. Uses Gemini + Google Search grounding when possible."""
+    keywords = _load_project_keywords(project_id)
+    # Load project name from config
+    config_path = Path(__file__).parent / "config.json"
+    with open(config_path) as f:
+        config = json.load(f)
+    project_name = project_id
+    for p in config.get("projects", []):
+        if p["id"] == project_id:
+            project_name = p.get("name", project_id)
+            break
+
+    result = search_project_signals(project_name, keywords=keywords)
+    if result:
+        return result
+
+    # Fallback to mock data
+    return MOCK_SEARCH.get(project_id, "No relevant external signals found.")
+
+
+def read_doc(doc_id: str) -> str:
+    """Read a Google Doc by its document ID. Returns title and content."""
+    if not is_authenticated():
+        return "Not connected to Google. Please authenticate first."
+
+    result = fetch_doc_content(doc_id)
+    if not result["content"]:
+        return f"Could not read document {doc_id}."
+
+    return f"Title: {result['title']}\n\nContent:\n{result['content']}"
+
+
+def list_docs() -> str:
+    """List recently modified Google Docs."""
+    if not is_authenticated():
+        return "Not connected to Google. Please authenticate first."
+
+    docs = list_recent_docs(max_results=10)
+    if not docs:
+        return "No recent Google Docs found."
+
+    lines = []
+    for d in docs:
+        lines.append(f"- {d['title']} (ID: {d['id']}, modified: {d['modified_time']})")
+    return "\n".join(lines)

backend/tts.py

@@ -0,0 +1,63 @@
+import io
+import os
+import struct
+
+from google import genai
+from google.genai import types
+
+
+def _make_wav(pcm_data: bytes, sample_rate: int = 24000, channels: int = 1, bits_per_sample: int = 16) -> bytes:
+    """Wrap raw PCM bytes in a WAV container."""
+    data_size = len(pcm_data)
+    byte_rate = sample_rate * channels * bits_per_sample // 8
+    block_align = channels * bits_per_sample // 8
+
+    buf = io.BytesIO()
+    # RIFF header
+    buf.write(b"RIFF")
+    buf.write(struct.pack("<I", 36 + data_size))
+    buf.write(b"WAVE")
+    # fmt chunk
+    buf.write(b"fmt ")
+    buf.write(struct.pack("<I", 16))  # chunk size
+    buf.write(struct.pack("<H", 1))   # PCM format
+    buf.write(struct.pack("<H", channels))
+    buf.write(struct.pack("<I", sample_rate))
+    buf.write(struct.pack("<I", byte_rate))
+    buf.write(struct.pack("<H", block_align))
+    buf.write(struct.pack("<H", bits_per_sample))
+    # data chunk
+    buf.write(b"data")
+    buf.write(struct.pack("<I", data_size))
+    buf.write(pcm_data)
+    return buf.getvalue()
+
+
+def generate_speech(text: str) -> bytes:
+    """Generate speech audio from text using Gemini TTS.
+
+    Args:
+        text: The text to convert to speech.
+
+    Returns:
+        WAV audio bytes ready to play in a browser.
+    """
+    client = genai.Client(api_key=os.getenv("GOOGLE_API_KEY"))
+
+    response = client.models.generate_content(
+        model="gemini-2.5-flash-preview-tts",
+        contents=text,
+        config=types.GenerateContentConfig(
+            response_modalities=["AUDIO"],
+            speech_config=types.SpeechConfig(
+                voice_config=types.VoiceConfig(
+                    prebuilt_voice_config=types.PrebuiltVoiceConfig(
+                        voice_name="Kore",
+                    )
+                ),
+            ),
+        ),
+    )
+
+    audio_data = response.candidates[0].content.parts[0].inline_data.data
+    return _make_wav(audio_data)

backend/urgency.py

@@ -0,0 +1,25 @@
+_URGENCY_KEYWORDS = [
+    "urgent", "bloquant", "blocking", "deadline", "critique", "critical",
+    "avant lundi", "avant mardi", "avant mercredi", "asap", "immediatement",
+    "pas de reponse", "no reply", "en attente", "waiting", "overdue",
+    "sprint review", "livrable", "retard", "action item",
+]
+
+
+def load_model():
+    """No-op — kept for API compatibility."""
+    pass
+
+
+def score_urgency(email_text: str) -> float:
+    """Score how urgent an email is (0-1) using keyword matching."""
+    text_lower = email_text.lower()
+    keyword_hits = sum(1 for kw in _URGENCY_KEYWORDS if kw in text_lower)
+    return round(min(keyword_hits / 3.0, 1.0), 3)
+
+
+def score_emails(emails: list[dict]) -> list[dict]:
+    """Score a list of email dicts. Adds 'urgency_score' key to each."""
+    for email in emails:
+        email["urgency_score"] = score_urgency(email["body"])
+    return emails

docs/superpowers/plans/2026-03-14-operator-plan.md

@@ -0,0 +1,1522 @@
+# Operator Implementation Plan
+
+> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Build an autonomous AI agent that monitors 3 projects for a work-study student and delivers proactive briefs — unprompted.
+
+**Architecture:** FastAPI backend with Gemini 3 Flash function calling loop, HuggingFace urgency scoring, deterministic initiative engine, SSE streaming to a React frontend with dark terminal aesthetic and TTS voice output.
+
+**Tech Stack:** Python (FastAPI, google-genai, sentence-transformers), React (Vite on Replit), SSE, Web Speech API
+
+**Spec:** `docs/superpowers/specs/2026-03-14-operator-design.md`
+
+---
+
+## File Structure
+
+```
+backend/
+├── config.json          # 3 projects (school, company, startup)
+├── mock_data.py         # hardcoded emails, events, search results
+├── tools.py             # 3 Gemini-callable functions
+├── urgency.py           # HuggingFace cross-encoder scorer
+├── initiative.py        # 4 deterministic alert rules
+├── agent.py             # Gemini function calling loop + on_event callback
+├── main.py              # FastAPI + SSE endpoint
+├── requirements.txt     # Python deps
+├── .env                 # API keys (not committed)
+└── test_smoke.py        # Smoke tests for critical paths
+
+frontend/  (React on Replit)
+├── src/
+│   ├── App.jsx
+│   ├── components/
+│   │   ├── Header.jsx
+│   │   ├── ProjectCard.jsx
+│   │   ├── ToolFeed.jsx
+│   │   └── BriefPanel.jsx
+│   ├── hooks/
+│   │   └── useOperatorSSE.js
+│   └── index.css
+├── index.html
+└── package.json
+```
+
+---
+
+## Chunk 1: Phase 1 — Fondations
+
+### Task 1: Init backend project
+
+**Files:**
+- Create: `backend/requirements.txt`
+- Create: `backend/.env`
+- Create: `backend/config.json`
+
+- [ ] **Step 1: Create `backend/requirements.txt`**
+
+```
+google-genai>=1.0.0
+sentence-transformers>=3.0.0
+fastapi>=0.115.0
+uvicorn>=0.30.0
+sse-starlette>=2.0.0
+python-dotenv>=1.0.0
+```
+
+- [ ] **Step 2: Create `backend/.env`**
+
+```
+GOOGLE_API_KEY=your_key_here
+```
+
+- [ ] **Step 3: Create `backend/config.json`**
+
+```json
+{
+  "mode": "demo",
+  "projects": [
+    {
+      "id": "school",
+      "name": "Master IA \u2014 Sorbonne",
+      "contact": "prof.martinez@sorbonne.fr",
+      "deadline": "2026-03-18T23:59:00",
+      "color": "#00FF88",
+      "keywords": ["cours", "rendu", "memoire", "soutenance", "TP"]
+    },
+    {
+      "id": "company",
+      "name": "Alternance \u2014 BNP Paribas",
+      "contact": "sophie.renard@bnpparibas.com",
+      "deadline": "2026-03-17T09:00:00",
+      "color": "#FF4444",
+      "keywords": ["sprint", "daily", "jira", "livrable", "prod"]
+    },
+    {
+      "id": "startup",
+      "name": "Side Project \u2014 NoctaAI",
+      "contact": "yassine@noctaai.com",
+      "deadline": "2026-04-05T00:00:00",
+      "color": "#FF8800",
+      "keywords": ["NoctaAI", "MVP", "landing", "beta", "funding"]
+    }
+  ]
+}
+```
+
+- [ ] **Step 4: Install dependencies**
+
+Run: `cd backend && pip install -r requirements.txt`
+Expected: All packages install. `torch` CPU-only pulled by sentence-transformers (~2min).
+
+- [ ] **Step 5: Commit**
+
+```bash
+git init
+echo ".env" > .gitignore
+echo "__pycache__/" >> .gitignore
+echo "*.pyc" >> .gitignore
+git add backend/requirements.txt backend/config.json .gitignore
+git commit -m "init: backend project with deps and config"
+```
+
+---
+
+### Task 2: Mock data
+
+**Files:**
+- Create: `backend/mock_data.py`
+
+- [ ] **Step 1: Create `backend/mock_data.py`**
+
+```python
+MOCK_EMAILS = {
+    "school": [
+        {
+            "from": "prof.martinez@sorbonne.fr",
+            "subject": "Rendu TP Deep Learning",
+            "body": "Le rendu du TP sur les transformers est pour mercredi 18 mars 23h59. Format notebook + rapport PDF. Pas d'extension possible.",
+            "date": "2026-03-12",
+            "days_since_reply": 0,
+        },
+        {
+            "from": "admin-master@sorbonne.fr",
+            "subject": "Soutenance memoire - date fixee",
+            "body": "Votre soutenance est fixee au 15 avril. Merci de confirmer votre sujet avant le 25 mars.",
+            "date": "2026-03-13",
+            "days_since_reply": 1,
+        },
+    ],
+    "company": [
+        {
+            "from": "sophie.renard@bnpparibas.com",
+            "subject": "Re: Dashboard analytics - feedback",
+            "body": "Le product owner attend les corrections sur le dashboard avant lundi matin. Les KPIs ne remontent pas correctement en prod. C'est bloquant pour la review sprint.",
+            "date": "2026-03-08",
+            "days_since_reply": 6,
+        },
+        {
+            "from": "tech-lead@bnpparibas.com",
+            "subject": "Daily standup notes",
+            "body": "Action item pour toi : fixer le bug sur le filtre date du dashboard. Sprint review mardi.",
+            "date": "2026-03-13",
+            "days_since_reply": 1,
+        },
+    ],
+    "startup": [
+        {
+            "from": "yassine@noctaai.com",
+            "subject": "Re: Landing page v2",
+            "body": "La landing est live mais le taux de conversion est a 0.8%. On doit refaire le hero. Tu peux t'en occuper ce weekend ?",
+            "date": "2026-03-11",
+            "days_since_reply": 3,
+        },
+        {
+            "from": "newsletter@techcrunch.com",
+            "subject": "Y Combinator ouvre les candidatures W26",
+            "body": "YC Winter 2026 applications are now open. Deadline: April 10. Focus on AI-native startups.",
+            "date": "2026-03-14",
+            "days_since_reply": None,
+        },
+    ],
+}
+
+MOCK_EVENTS = {
+    "school": [
+        {"title": "TP Deep Learning - rendu", "time": "2026-03-18T23:59", "prep_block": False},
+        {"title": "Cours NLP avance", "time": "2026-03-15T09:00", "prep_block": True},
+    ],
+    "company": [
+        {"title": "Sprint Review", "time": "2026-03-17T10:00", "prep_block": False},
+        {"title": "Daily Standup", "time": "2026-03-14T09:30", "prep_block": True},
+    ],
+    "startup": [],
+}
+
+MOCK_SEARCH = {
+    "school": "Sorbonne Universite - les inscriptions au Master IA 2026 battent des records, +40% de candidatures.",
+    "company": "BNP Paribas lance un nouveau programme d'acceleration data & IA pour ses alternants.",
+    "startup": "Y Combinator ouvre les candidatures Winter 2026. Deadline 10 avril. Focus AI-native startups.",
+}
+```
+
+- [ ] **Step 2: Verify import works**
+
+Run: `cd backend && python -c "from mock_data import MOCK_EMAILS; print(len(MOCK_EMAILS['company']))"`
+Expected: `2`
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add backend/mock_data.py
+git commit -m "feat: add mock data for 3 demo projects"
+```
+
+---
+
+### Task 3: Smoke test Gemini API
+
+**Files:**
+- Create: `backend/test_smoke.py`
+
+- [ ] **Step 1: Create smoke test file**
+
+```python
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+
+def test_gemini_connection():
+    from google import genai
+
+    api_key = os.getenv("GOOGLE_API_KEY")
+    assert api_key and api_key != "your_key_here", "GOOGLE_API_KEY not set in .env"
+
+    client = genai.Client(api_key=api_key)
+
+    # Verify available models — use gemini-2.0-flash (Gemini 3 Flash may have a different ID)
+    # If the hackathon provides a different model name, update MODEL_NAME here
+    MODEL_NAME = "gemini-2.0-flash"
+
+    response = client.models.generate_content(
+        model=MODEL_NAME,
+        contents="Reply with exactly: OK",
+    )
+    assert "OK" in response.text
+    print(f"Gemini OK (model={MODEL_NAME}): {response.text.strip()}")
+
+
+def test_gemini_function_calling_api():
+    """Verify the SDK supports the function calling API we need."""
+    from google.genai import types
+
+    # Verify Part.from_function_response exists
+    assert hasattr(types.Part, "from_function_response"), (
+        "types.Part.from_function_response not found — SDK version may be incompatible. "
+        "Try: pip install --upgrade google-genai"
+    )
+    print("Gemini SDK function calling API: OK")
+
+
+def test_huggingface_model():
+    import torch
+    from sentence_transformers import CrossEncoder
+
+    model = CrossEncoder(
+        "cross-encoder/ms-marco-MiniLM-L6-v2",
+        default_activation_function=torch.nn.Sigmoid(),
+    )
+    pairs = [("urgent action required deadline missed", "Le product owner attend les corrections avant lundi. C'est bloquant.")]
+    scores = model.predict(pairs)
+    score = float(scores[0])
+    assert 0.0 <= score <= 1.0
+    print(f"HuggingFace OK: score={score:.3f}")
+
+
+if __name__ == "__main__":
+    test_gemini_connection()
+    test_gemini_function_calling_api()
+    test_huggingface_model()
+    print("All smoke tests passed.")
+```
+
+- [ ] **Step 2: Run smoke tests**
+
+Run: `cd backend && python test_smoke.py`
+Expected: Both tests pass, prints scores. First HuggingFace run downloads model (~80MB).
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add backend/test_smoke.py
+git commit -m "test: smoke tests for Gemini and HuggingFace"
+```
+
+---
+
+## Chunk 2: Phase 2 — Backend
+
+### Task 4: Tools (Gemini-callable functions)
+
+**Files:**
+- Create: `backend/tools.py`
+
+- [ ] **Step 1: Create `backend/tools.py`**
+
+```python
+import json
+from mock_data import MOCK_EMAILS, MOCK_EVENTS, MOCK_SEARCH
+
+
+def read_emails(project_id: str) -> str:
+    """Read recent emails for a project. Returns sender, subject, body, and days since last reply."""
+    emails = MOCK_EMAILS.get(project_id, [])
+    if not emails:
+        return f"No emails found for project {project_id}."
+    lines = []
+    for e in emails:
+        silence = f"{e['days_since_reply']} days ago" if e["days_since_reply"] is not None else "N/A (newsletter)"
+        lines.append(
+            f"From: {e['from']}\n"
+            f"Subject: {e['subject']}\n"
+            f"Body: {e['body']}\n"
+            f"Last reply: {silence}\n"
+        )
+    return "\n---\n".join(lines)
+
+
+def get_events(project_id: str) -> str:
+    """Get upcoming calendar events for a project. Shows title, time, and whether a prep block exists."""
+    events = MOCK_EVENTS.get(project_id, [])
+    if not events:
+        return f"No upcoming events for project {project_id}."
+    lines = []
+    for ev in events:
+        prep = "YES" if ev["prep_block"] else "NO"
+        lines.append(f"{ev['title']} at {ev['time']} (prep block: {prep})")
+    return "\n".join(lines)
+
+
+def search_web(project_id: str) -> str:
+    """Search for recent external signals relevant to a project (news, funding, announcements)."""
+    result = MOCK_SEARCH.get(project_id, "No relevant external signals found.")
+    return result
+```
+
+- [ ] **Step 2: Test tools manually**
+
+Run: `cd backend && python -c "from tools import read_emails; print(read_emails('company'))"`
+Expected: Prints BNP Paribas emails formatted.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add backend/tools.py
+git commit -m "feat: 3 Gemini-callable tool functions with mock data"
+```
+
+---
+
+### Task 5: Urgency scorer
+
+**Files:**
+- Create: `backend/urgency.py`
+
+- [ ] **Step 1: Create `backend/urgency.py`**
+
+```python
+import torch
+from sentence_transformers import CrossEncoder
+
+_URGENCY_QUERY = "urgent action required deadline missed no reply blocked critical"
+
+_model = None
+
+
+def _get_model():
+    global _model
+    if _model is None:
+        _model = CrossEncoder(
+            "cross-encoder/ms-marco-MiniLM-L6-v2",
+            default_activation_function=torch.nn.Sigmoid(),
+        )
+    return _model
+
+
+def load_model():
+    """Call at startup to pre-load the model."""
+    _get_model()
+
+
+def score_urgency(email_text: str) -> float:
+    """Score how urgent an email is (0-1). Higher = more urgent."""
+    model = _get_model()
+    pairs = [(_URGENCY_QUERY, email_text)]
+    scores = model.predict(pairs)
+    return round(float(scores[0]), 3)
+
+
+def score_emails(emails: list[dict]) -> list[dict]:
+    """Score a list of email dicts. Adds 'urgency_score' key to each."""
+    for email in emails:
+        email["urgency_score"] = score_urgency(email["body"])
+    return emails
+```
+
+- [ ] **Step 2: Test urgency scoring**
+
+Run: `cd backend && python -c "from urgency import score_urgency; print(score_urgency('Le product owner attend les corrections. C est bloquant pour la sprint review.'))" `
+Expected: A float between 0 and 1 (likely > 0.5 for this urgent text).
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add backend/urgency.py
+git commit -m "feat: HuggingFace urgency scorer with sigmoid activation"
+```
+
+---
+
+### Task 6: Initiative engine
+
+**Files:**
+- Create: `backend/initiative.py`
+
+- [ ] **Step 1: Create `backend/initiative.py`**
+
+```python
+from datetime import datetime, timezone
+
+
+def evaluate_project(project: dict, emails: list[dict], events: list[dict], search_score: float) -> dict:
+    """Evaluate a project's status based on deterministic rules.
+
+    Returns:
+        {"status": "READY"|"URGENT"|"SIGNAL", "alerts": [str]}
+    """
+    alerts = []
+    status = "READY"
+
+    # Rule 1: Silence detected
+    reply_days = [
+        e["days_since_reply"]
+        for e in emails
+        if e.get("days_since_reply") is not None
+    ]
+    if reply_days:
+        max_silence = max(reply_days)
+        if max_silence >= 5:
+            contact = emails[0]["from"]
+            alerts.append(f"Silence depuis {max_silence} jours de {contact}")
+            status = "URGENT"
+
+    # Rule 2: Deadline < 48h without prep block
+    deadline = datetime.fromisoformat(project["deadline"])
+    now = datetime.now()
+    hours_to_deadline = (deadline - now).total_seconds() / 3600
+    has_prep = any(e.get("prep_block", False) for e in events)
+    if hours_to_deadline < 48 and not has_prep:
+        alerts.append(f"Deadline dans {int(hours_to_deadline)}h - aucun bloc de prep")
+        status = "URGENT"
+
+    # Rule 3: External signal relevant
+    if search_score > 0.6:
+        alerts.append("Signal externe pertinent detecte")
+        if status != "URGENT":
+            status = "SIGNAL"
+
+    # Rule 4: High urgency email
+    urgency_scores = [e.get("urgency_score", 0) for e in emails]
+    if any(s > 0.8 for s in urgency_scores):
+        alerts.append("Email a haute urgence detecte")
+        status = "URGENT"
+
+    return {"status": status, "alerts": alerts}
+```
+
+- [ ] **Step 2: Test initiative engine**
+
+Run: `cd backend && python -c "
+from initiative import evaluate_project
+result = evaluate_project(
+    {'deadline': '2026-03-17T09:00:00'},
+    [{'from': 'sophie@bnp.com', 'days_since_reply': 6, 'urgency_score': 0.85, 'body': 'test'}],
+    [{'prep_block': False}],
+    0.3
+)
+print(result)
+"`
+Expected: `{'status': 'URGENT', 'alerts': ['Silence depuis 6 jours de sophie@bnp.com', ...]}`
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add backend/initiative.py
+git commit -m "feat: deterministic initiative engine with 4 alert rules"
+```
+
+---
+
+### Task 7: Agent loop (Gemini function calling)
+
+**Files:**
+- Create: `backend/agent.py`
+
+- [ ] **Step 1: Create `backend/agent.py`**
+
+```python
+import asyncio
+import json
+import os
+import time
+from typing import AsyncGenerator, Callable
+
+from dotenv import load_dotenv
+from google import genai
+from google.genai import types
+
+from initiative import evaluate_project
+from mock_data import MOCK_EMAILS, MOCK_EVENTS
+from tools import get_events, read_emails, search_web
+from urgency import score_emails, score_urgency
+
+load_dotenv()
+
+SYSTEM_PROMPT = """Tu es Operator - un agent autonome de classe Jarvis pour les professionnels occupes.
+Tu monitores plusieurs projets actifs simultanement.
+Tu parles en premier. Tu n'attends pas qu'on te demande.
+
+Au demarrage :
+1. Charge tous les projets actifs du contexte
+2. Scanne les emails, le calendrier et le web pour chaque projet
+3. Evalue l'urgence avec les signaux fournis
+4. Delivre un brief proactif multi-projet - sans qu'on te le demande
+
+Regles :
+- Ne demande jamais de clarification. Fais des hypotheses raisonnables.
+- N'explique jamais ce que tu fais. Fais-le.
+- 5 bullets maximum par projet. Brutalement concis.
+- Si un outil echoue, saute-le et note le manque.
+- Chaque projet a son propre bloc. Ne melange jamais les contextes.
+- Commence par le projet le plus urgent.
+- L'humain est occupe. Chaque mot doit meriter sa place.
+- Parle en francais.
+"""
+
+TOOL_FUNCTIONS = {
+    "read_emails": read_emails,
+    "get_events": get_events,
+    "search_web": search_web,
+}
+
+TOOL_DECLARATIONS = [
+    types.Tool(function_declarations=[
+        types.FunctionDeclaration(
+            name="read_emails",
+            description="Lit les emails recents pour un projet. Retourne expediteur, sujet, corps, jours depuis derniere reponse.",
+            parameters=types.Schema(
+                type="OBJECT",
+                properties={"project_id": types.Schema(type="STRING", description="ID du projet: school, company, ou startup")},
+                required=["project_id"],
+            ),
+        ),
+        types.FunctionDeclaration(
+            name="get_events",
+            description="Recupere les evenements calendrier a venir pour un projet. Indique titre, heure, et si un bloc de preparation existe.",
+            parameters=types.Schema(
+                type="OBJECT",
+                properties={"project_id": types.Schema(type="STRING", description="ID du projet: school, company, ou startup")},
+                required=["project_id"],
+            ),
+        ),
+        types.FunctionDeclaration(
+            name="search_web",
+            description="Recherche des signaux externes pertinents pour un projet (news, funding, annonces).",
+            parameters=types.Schema(
+                type="OBJECT",
+                properties={"project_id": types.Schema(type="STRING", description="ID du projet: school, company, ou startup")},
+                required=["project_id"],
+            ),
+        ),
+    ])
+]
+
+MAX_ITERATIONS = 15
+TIMEOUT_SECONDS = 30
+
+
+async def run_operator(projects: list[dict], on_event: Callable) -> str:
+    """Run the Operator agent loop.
+
+    Args:
+        projects: list of project dicts from config.json
+        on_event: callback(event_dict) called for each step
+
+    Returns:
+        The final brief text.
+    """
+    client = genai.Client(api_key=os.getenv("GOOGLE_API_KEY"))
+
+    project_summary = json.dumps(
+        [{"id": p["id"], "name": p["name"], "contact": p["contact"], "deadline": p["deadline"]}
+         for p in projects],
+        ensure_ascii=False,
+    )
+
+    chat = client.chats.create(
+        model="gemini-2.0-flash",
+        config=types.GenerateContentConfig(
+            system_instruction=SYSTEM_PROMPT,
+            tools=TOOL_DECLARATIONS,
+        ),
+    )
+
+    user_msg = (
+        f"Voici tes 3 projets actifs :\n{project_summary}\n\n"
+        "Commence par scanner chaque projet (emails, calendrier, web), "
+        "puis delivre ton brief proactif."
+    )
+
+    response = chat.send_message(user_msg)
+    iterations = 0
+    start_time = time.time()
+    collected_data = {}  # project_id -> {emails, events, search}
+
+    while iterations < MAX_ITERATIONS and (time.time() - start_time) < TIMEOUT_SECONDS:
+        # Check if there are function calls
+        function_calls = []
+        for part in response.candidates[0].content.parts:
+            if part.function_call:
+                function_calls.append(part.function_call)
+
+        if not function_calls:
+            break  # No more tool calls, Gemini is done
+
+        # Execute each function call
+        function_responses = []
+        for fc in function_calls:
+            tool_name = fc.name
+            tool_args = dict(fc.args) if fc.args else {}
+
+            await on_event({
+                "type": "tool_call",
+                "tool": tool_name,
+                "project": tool_args.get("project_id", ""),
+                "status": "running",
+            })
+
+            # Execute the tool
+            tool_fn = TOOL_FUNCTIONS.get(tool_name)
+            if tool_fn:
+                try:
+                    result = tool_fn(**tool_args)
+                except Exception as e:
+                    result = f"Error: {str(e)}"
+            else:
+                result = f"Unknown tool: {tool_name}"
+
+            # Track collected data
+            pid = tool_args.get("project_id", "")
+            if pid not in collected_data:
+                collected_data[pid] = {}
+            collected_data[pid][tool_name] = result
+
+            await on_event({
+                "type": "tool_result",
+                "tool": tool_name,
+                "project": pid,
+                "result": result[:200],
+                "status": "done",
+            })
+
+            function_responses.append(
+                types.Part.from_function_response(
+                    name=tool_name,
+                    response={"result": result},
+                )
+            )
+
+            iterations += 1
+
+        # Send function results back to Gemini
+        response = chat.send_message(function_responses)
+
+    # --- Deterministic scoring phase (single pass, cached) ---
+    evaluations = {}
+    for pid, data in collected_data.items():
+        emails = MOCK_EMAILS.get(pid, [])
+        scored_emails = score_emails([dict(e) for e in emails])
+
+        for e in scored_emails:
+            await on_event({
+                "type": "urgency",
+                "project": pid,
+                "email_subject": e["subject"],
+                "score": e["urgency_score"],
+            })
+
+        project = next((p for p in projects if p["id"] == pid), {})
+        events = MOCK_EVENTS.get(pid, [])
+        search_score = score_urgency(data.get("search_web", ""))
+
+        evaluation = evaluate_project(project, scored_emails, events, search_score)
+        evaluations[pid] = {"evaluation": evaluation, "project": project}
+
+        await on_event({
+            "type": "initiative",
+            "project": pid,
+            "status": evaluation["status"],
+            "alerts": evaluation["alerts"],
+        })
+
+    # --- Final brief with initiative context (reuse cached evaluations) ---
+    initiative_summary = ""
+    for pid, cached in evaluations.items():
+        evaluation = cached["evaluation"]
+        project = cached["project"]
+        initiative_summary += (
+            f"\n[{project.get('name', pid)}] Status: {evaluation['status']}\n"
+            f"Alertes: {'; '.join(evaluation['alerts']) if evaluation['alerts'] else 'aucune'}\n"
+        )
+
+    brief_prompt = (
+        f"Voici les evaluations d'urgence de tes 3 projets :\n{initiative_summary}\n\n"
+        "Genere maintenant ton brief proactif final. Commence par le plus urgent. "
+        "5 bullets max par projet. Sois brutalement concis. Parle en francais."
+    )
+
+    brief_response = chat.send_message(brief_prompt)
+    brief_text = brief_response.text
+
+    await on_event({
+        "type": "brief",
+        "text": brief_text,
+    })
+
+    return brief_text
+```
+
+- [ ] **Step 2: Test agent loop standalone**
+
+Run: `cd backend && python -c "
+import asyncio
+from agent import run_operator
+import json
+
+with open('config.json') as f:
+    config = json.load(f)
+
+async def print_event(e):
+    print(f'  [{e[\"type\"]}] {e.get(\"tool\", e.get(\"project\", \"\"))} {e.get(\"status\", \"\")}')
+
+async def main():
+    brief = await run_operator(config['projects'], print_event)
+    print('---BRIEF---')
+    print(brief)
+
+asyncio.run(main())
+"`
+Expected: Tool calls printed step by step, then a French brief covering 3 projects. BNP Paribas should be first (most urgent).
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add backend/agent.py
+git commit -m "feat: Gemini function calling agent loop with initiative engine"
+```
+
+---
+
+### Task 8: FastAPI + SSE endpoint
+
+**Files:**
+- Create: `backend/main.py`
+
+- [ ] **Step 1: Create `backend/main.py`**
+
+```python
+import asyncio
+import json
+import os
+from contextlib import asynccontextmanager
+
+from dotenv import load_dotenv
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from sse_starlette.sse import EventSourceResponse
+
+from agent import run_operator
+from urgency import load_model
+
+load_dotenv()
+
+# Fail fast if API key is missing
+api_key = os.getenv("GOOGLE_API_KEY")
+if not api_key or api_key == "your_key_here":
+    raise RuntimeError("GOOGLE_API_KEY not set. Check backend/.env")
+
+
+@asynccontextmanager
+async def lifespan(app):
+    load_model()
+    print("HuggingFace model loaded.")
+    yield
+
+
+app = FastAPI(title="Operator", lifespan=lifespan)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+def load_config():
+    with open("config.json") as f:
+        return json.load(f)
+
+
+@app.get("/api/run")
+async def run():
+    config = load_config()
+    queue = asyncio.Queue()
+
+    async def on_event(event: dict):
+        await queue.put(event)
+
+    async def generator():
+        task = asyncio.create_task(run_operator(config["projects"], on_event))
+
+        while True:
+            try:
+                event = await asyncio.wait_for(queue.get(), timeout=1.0)
+                yield {"event": event["type"], "data": json.dumps(event, ensure_ascii=False)}
+                if event["type"] == "brief":
+                    break
+            except asyncio.TimeoutError:
+                if task.done():
+                    break
+                continue
+
+        await task
+
+    return EventSourceResponse(generator())
+
+
+@app.get("/api/health")
+async def health():
+    return {"status": "ok"}
+```
+
+- [ ] **Step 2: Run the server**
+
+Run: `cd backend && uvicorn main:app --host 0.0.0.0 --port 8000 --reload`
+Expected: Server starts, prints "HuggingFace model loaded."
+
+- [ ] **Step 3: Test SSE endpoint**
+
+Run (in another terminal): `curl -N http://localhost:8000/api/run`
+Expected: Stream of SSE events (tool_call, tool_result, urgency, initiative, brief).
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add backend/main.py
+git commit -m "feat: FastAPI server with SSE streaming endpoint"
+```
+
+---
+
+## Chunk 3: Phase 2 — Frontend (parallel with Chunk 2)
+
+### Task 9: React project setup on Replit
+
+- [ ] **Step 1: Create React project on Replit**
+
+Use the "React (Vite)" template on Replit. This gives you `react`, `react-dom`, `vite` pre-configured.
+
+- [ ] **Step 2: Set up `index.css` — dark theme base**
+
+Replace `src/index.css` with:
+
+```css
+@import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&display=swap');
+
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  background: #0a0a0a;
+  color: #e0e0e0;
+  font-family: 'JetBrains Mono', monospace;
+  min-height: 100vh;
+}
+
+:root {
+  --green: #00FF88;
+  --red: #FF4444;
+  --orange: #FF8800;
+  --bg: #0a0a0a;
+  --card-bg: #111111;
+  --border: #222222;
+  --text-dim: #666666;
+}
+```
+
+- [ ] **Step 3: Commit**
+
+---
+
+### Task 10: Header component
+
+**Files:**
+- Create: `src/components/Header.jsx`
+
+- [ ] **Step 1: Create `src/components/Header.jsx`**
+
+```jsx
+import { useState } from 'react';
+
+export default function Header({ onScan, isScanning }) {
+  return (
+    <header style={{
+      display: 'flex',
+      justifyContent: 'space-between',
+      alignItems: 'center',
+      padding: '24px 32px',
+      borderBottom: '1px solid var(--border)',
+    }}>
+      <div>
+        <h1 style={{
+          fontSize: '28px',
+          fontWeight: 700,
+          color: 'var(--green)',
+          letterSpacing: '4px',
+        }}>
+          &#9632; OPERATOR
+        </h1>
+        <p style={{
+          fontSize: '12px',
+          color: 'var(--text-dim)',
+          marginTop: '4px',
+          fontStyle: 'italic',
+        }}>
+          The AI Agent That Works While You Talk.
+        </p>
+      </div>
+      <button
+        onClick={onScan}
+        disabled={isScanning}
+        style={{
+          background: isScanning ? 'var(--border)' : 'var(--green)',
+          color: '#0a0a0a',
+          border: 'none',
+          padding: '12px 24px',
+          fontFamily: 'inherit',
+          fontSize: '14px',
+          fontWeight: 700,
+          cursor: isScanning ? 'not-allowed' : 'pointer',
+          letterSpacing: '2px',
+        }}
+      >
+        {isScanning ? 'SCANNING...' : 'LANCER LE SCAN'}
+      </button>
+    </header>
+  );
+}
+```
+
+- [ ] **Step 2: Commit**
+
+---
+
+### Task 11: ProjectCard component
+
+**Files:**
+- Create: `src/components/ProjectCard.jsx`
+
+- [ ] **Step 1: Create `src/components/ProjectCard.jsx`**
+
+```jsx
+const STATUS_CONFIG = {
+  STANDBY: { label: 'STANDBY', bg: '#222', color: '#666' },
+  READY: { label: 'READY', bg: '#00FF8833', color: '#00FF88' },
+  URGENT: { label: 'URGENT', bg: '#FF444433', color: '#FF4444' },
+  SIGNAL: { label: 'SIGNAL', bg: '#FF880033', color: '#FF8800' },
+};
+
+export default function ProjectCard({ project, status, alerts }) {
+  const st = STATUS_CONFIG[status] || STATUS_CONFIG.STANDBY;
+
+  return (
+    <div style={{
+      background: 'var(--card-bg)',
+      borderLeft: `4px solid ${project.color}`,
+      padding: '20px',
+      flex: 1,
+      minWidth: '250px',
+    }}>
+      <div style={{
+        display: 'flex',
+        justifyContent: 'space-between',
+        alignItems: 'center',
+        marginBottom: '12px',
+      }}>
+        <span style={{ fontSize: '11px', color: 'var(--text-dim)', letterSpacing: '2px' }}>
+          PROJECT
+        </span>
+        <span style={{
+          fontSize: '11px',
+          fontWeight: 700,
+          padding: '4px 10px',
+          background: st.bg,
+          color: st.color,
+          letterSpacing: '1px',
+          animation: status === 'URGENT' ? 'pulse 1.5s infinite' : 'none',
+        }}>
+          {st.label}
+        </span>
+      </div>
+
+      <h3 style={{ fontSize: '16px', color: '#fff', marginBottom: '8px' }}>
+        {project.name}
+      </h3>
+
+      {project.contact && (
+        <p style={{ fontSize: '12px', color: 'var(--text-dim)', marginBottom: '12px' }}>
+          {project.contact}
+        </p>
+      )}
+
+      {alerts && alerts.length > 0 && (
+        <ul style={{ listStyle: 'none', padding: 0 }}>
+          {alerts.map((alert, i) => (
+            <li key={i} style={{
+              fontSize: '12px',
+              color: st.color,
+              padding: '4px 0',
+              borderTop: '1px solid var(--border)',
+            }}>
+              {alert}
+            </li>
+          ))}
+        </ul>
+      )}
+    </div>
+  );
+}
+```
+
+- [ ] **Step 2: Add pulse animation to `index.css`**
+
+Append to `src/index.css`:
+
+```css
+@keyframes pulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.5; }
+}
+
+@keyframes slideIn {
+  from { transform: translateX(-20px); opacity: 0; }
+  to { transform: translateX(0); opacity: 1; }
+}
+```
+
+- [ ] **Step 3: Commit**
+
+---
+
+### Task 12: ToolFeed component
+
+**Files:**
+- Create: `src/components/ToolFeed.jsx`
+
+- [ ] **Step 1: Create `src/components/ToolFeed.jsx`**
+
+```jsx
+const STATUS_ICONS = {
+  running: '\u25CF',  // filled circle
+  done: '\u2713',     // checkmark
+  waiting: '\u25CB',  // empty circle
+};
+
+const PROJECT_COLORS = {
+  school: '#00FF88',
+  company: '#FF4444',
+  startup: '#FF8800',
+};
+
+export default function ToolFeed({ toolCalls }) {
+  if (!toolCalls || toolCalls.length === 0) {
+    return (
+      <div style={{
+        background: 'var(--card-bg)',
+        padding: '20px',
+        borderTop: '1px solid var(--border)',
+      }}>
+        <h4 style={{ fontSize: '11px', color: 'var(--text-dim)', letterSpacing: '2px', marginBottom: '8px' }}>
+          TOOL FEED
+        </h4>
+        <p style={{ fontSize: '12px', color: 'var(--text-dim)' }}>
+          En attente du scan...
+        </p>
+      </div>
+    );
+  }
+
+  return (
+    <div style={{
+      background: 'var(--card-bg)',
+      padding: '20px',
+      borderTop: '1px solid var(--border)',
+      maxHeight: '200px',
+      overflowY: 'auto',
+    }}>
+      <h4 style={{ fontSize: '11px', color: 'var(--text-dim)', letterSpacing: '2px', marginBottom: '12px' }}>
+        TOOL FEED
+      </h4>
+      {toolCalls.map((tc, i) => (
+        <div
+          key={i}
+          style={{
+            display: 'flex',
+            alignItems: 'center',
+            gap: '12px',
+            padding: '6px 0',
+            fontSize: '13px',
+            animation: 'slideIn 0.3s ease-out',
+            animationDelay: `${i * 0.1}s`,
+            animationFillMode: 'both',
+          }}
+        >
+          <span style={{ color: tc.status === 'done' ? '#00FF88' : tc.status === 'running' ? '#FF8800' : '#666' }}>
+            {STATUS_ICONS[tc.status] || STATUS_ICONS.waiting}
+          </span>
+          <span style={{ color: '#fff', minWidth: '140px' }}>{tc.tool}({tc.project})</span>
+          <div style={{
+            flex: 1,
+            height: '4px',
+            background: '#222',
+            borderRadius: '2px',
+            overflow: 'hidden',
+          }}>
+            <div style={{
+              width: tc.status === 'done' ? '100%' : tc.status === 'running' ? '60%' : '0%',
+              height: '100%',
+              background: PROJECT_COLORS[tc.project] || 'var(--green)',
+              transition: 'width 0.5s ease',
+            }} />
+          </div>
+          <span style={{ fontSize: '11px', color: 'var(--text-dim)', minWidth: '40px', textAlign: 'right' }}>
+            {tc.status === 'done' ? 'done' : tc.status === 'running' ? '...' : 'wait'}
+          </span>
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+- [ ] **Step 2: Commit**
+
+---
+
+### Task 13: BriefPanel component
+
+**Files:**
+- Create: `src/components/BriefPanel.jsx`
+
+- [ ] **Step 1: Create `src/components/BriefPanel.jsx`**
+
+```jsx
+import { useState, useEffect } from 'react';
+
+export default function BriefPanel({ briefText }) {
+  const [displayedText, setDisplayedText] = useState('');
+  const [isPlaying, setIsPlaying] = useState(false);
+
+  // Typewriter effect
+  useEffect(() => {
+    if (!briefText) {
+      setDisplayedText('');
+      return;
+    }
+    setDisplayedText('');
+    let i = 0;
+    const interval = setInterval(() => {
+      if (i < briefText.length) {
+        setDisplayedText(briefText.slice(0, i + 1));
+        i++;
+      } else {
+        clearInterval(interval);
+      }
+    }, 15);
+    return () => clearInterval(interval);
+  }, [briefText]);
+
+  const handleSpeak = () => {
+    if (isPlaying) {
+      speechSynthesis.cancel();
+      setIsPlaying(false);
+      return;
+    }
+    const utterance = new SpeechSynthesisUtterance(briefText);
+    utterance.lang = 'fr-FR';
+    utterance.rate = 1.1;
+    utterance.pitch = 0.9;
+    utterance.onend = () => setIsPlaying(false);
+    speechSynthesis.speak(utterance);
+    setIsPlaying(true);
+  };
+
+  if (!briefText) {
+    return null;
+  }
+
+  return (
+    <div style={{
+      background: 'var(--card-bg)',
+      padding: '24px',
+      borderTop: '1px solid var(--border)',
+    }}>
+      <div style={{
+        display: 'flex',
+        justifyContent: 'space-between',
+        alignItems: 'center',
+        marginBottom: '16px',
+      }}>
+        <h4 style={{ fontSize: '11px', color: 'var(--text-dim)', letterSpacing: '2px' }}>
+          BRIEF
+        </h4>
+        <button
+          onClick={handleSpeak}
+          style={{
+            background: 'none',
+            border: '1px solid var(--green)',
+            color: 'var(--green)',
+            padding: '6px 16px',
+            fontFamily: 'inherit',
+            fontSize: '12px',
+            cursor: 'pointer',
+          }}
+        >
+          {isPlaying ? '\u23F9 Stop' : '\uD83D\uDD0A Play'}
+        </button>
+      </div>
+      <div style={{
+        fontSize: '14px',
+        lineHeight: '1.6',
+        whiteSpace: 'pre-wrap',
+        color: '#e0e0e0',
+      }}>
+        {displayedText}
+        {displayedText.length < (briefText?.length || 0) && (
+          <span style={{ animation: 'pulse 0.8s infinite', color: 'var(--green)' }}>|</span>
+        )}
+      </div>
+    </div>
+  );
+}
+```
+
+- [ ] **Step 2: Commit**
+
+---
+
+## Chunk 4: Phase 3 — Integration
+
+### Task 14: SSE hook
+
+**Files:**
+- Create: `src/hooks/useOperatorSSE.js`
+
+- [ ] **Step 1: Create `src/hooks/useOperatorSSE.js`**
+
+```jsx
+import { useState, useCallback } from 'react';
+
+const BACKEND_URL = import.meta.env.VITE_BACKEND_URL || 'http://localhost:8000';
+
+export default function useOperatorSSE() {
+  const [toolCalls, setToolCalls] = useState([]);
+  const [projectStatuses, setProjectStatuses] = useState({});
+  const [briefText, setBriefText] = useState(null);
+  const [isScanning, setIsScanning] = useState(false);
+
+  const startScan = useCallback(() => {
+    setToolCalls([]);
+    setProjectStatuses({});
+    setBriefText(null);
+    setIsScanning(true);
+
+    const source = new EventSource(`${BACKEND_URL}/api/run`);
+
+    source.addEventListener('tool_call', (e) => {
+      const data = JSON.parse(e.data);
+      setToolCalls(prev => [...prev, { tool: data.tool, project: data.project, status: 'running' }]);
+    });
+
+    source.addEventListener('tool_result', (e) => {
+      const data = JSON.parse(e.data);
+      setToolCalls(prev =>
+        prev.map(tc =>
+          tc.tool === data.tool && tc.project === data.project && tc.status === 'running'
+            ? { ...tc, status: 'done' }
+            : tc
+        )
+      );
+    });
+
+    source.addEventListener('urgency', (e) => {
+      const data = JSON.parse(e.data);
+      // Urgency events update project info but don't set status yet
+    });
+
+    source.addEventListener('initiative', (e) => {
+      const data = JSON.parse(e.data);
+      setProjectStatuses(prev => ({
+        ...prev,
+        [data.project]: { status: data.status, alerts: data.alerts },
+      }));
+    });
+
+    source.addEventListener('brief', (e) => {
+      const data = JSON.parse(e.data);
+      setBriefText(data.text);
+      setIsScanning(false);
+      source.close();
+    });
+
+    source.onerror = () => {
+      setIsScanning(false);
+      source.close();
+    };
+  }, []);
+
+  return { toolCalls, projectStatuses, briefText, isScanning, startScan };
+}
+```
+
+- [ ] **Step 2: Commit**
+
+---
+
+### Task 15: App.jsx — assemble everything
+
+**Files:**
+- Modify: `src/App.jsx`
+
+- [ ] **Step 1: Replace `src/App.jsx`**
+
+```jsx
+import Header from './components/Header';
+import ProjectCard from './components/ProjectCard';
+import ToolFeed from './components/ToolFeed';
+import BriefPanel from './components/BriefPanel';
+import useOperatorSSE from './hooks/useOperatorSSE';
+
+const PROJECTS = [
+  { id: 'school', name: 'Master IA \u2014 Sorbonne', contact: 'prof.martinez@sorbonne.fr', color: '#00FF88' },
+  { id: 'company', name: 'Alternance \u2014 BNP Paribas', contact: 'sophie.renard@bnpparibas.com', color: '#FF4444' },
+  { id: 'startup', name: 'Side Project \u2014 NoctaAI', contact: 'yassine@noctaai.com', color: '#FF8800' },
+];
+
+export default function App() {
+  const { toolCalls, projectStatuses, briefText, isScanning, startScan } = useOperatorSSE();
+
+  return (
+    <div style={{ maxWidth: '1200px', margin: '0 auto' }}>
+      <Header onScan={startScan} isScanning={isScanning} />
+
+      <div style={{
+        display: 'flex',
+        gap: '16px',
+        padding: '24px 32px',
+      }}>
+        {PROJECTS.map(project => {
+          const ps = projectStatuses[project.id];
+          return (
+            <ProjectCard
+              key={project.id}
+              project={project}
+              status={ps?.status || 'STANDBY'}
+              alerts={ps?.alerts || []}
+            />
+          );
+        })}
+      </div>
+
+      <div style={{ padding: '0 32px' }}>
+        <ToolFeed toolCalls={toolCalls} />
+        <BriefPanel briefText={briefText} />
+      </div>
+    </div>
+  );
+}
+```
+
+- [ ] **Step 2: Set env variable on Replit**
+
+Add to Replit Secrets or `.env`: `VITE_BACKEND_URL=http://localhost:8000` (or your backend URL).
+
+- [ ] **Step 3: Run frontend + backend together**
+
+Backend: `cd backend && uvicorn main:app --host 0.0.0.0 --port 8000`
+Frontend: Replit auto-runs on `npm run dev`
+
+- [ ] **Step 4: Click "LANCER LE SCAN" and verify full flow**
+
+Expected:
+1. Cards start as STANDBY (grey)
+2. Tool feed animates step by step
+3. Cards update to READY/URGENT/SIGNAL with alerts
+4. Brief appears with typewriter effect
+5. Play button reads brief aloud in French
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/
+git commit -m "feat: full integration — SSE hook + App assembly"
+```
+
+---
+
+## Chunk 5: Phase 4 — Polish & Demo
+
+### Task 16: Auto-run mode for demo
+
+**Files:**
+- Modify: `src/App.jsx`
+
+- [ ] **Step 1: Add auto-scan on load**
+
+In `App.jsx`, add a `useEffect` to auto-trigger the scan after a 2-second delay:
+
+```jsx
+import { useEffect } from 'react';
+
+// Inside App component, add:
+useEffect(() => {
+  const params = new URLSearchParams(window.location.search);
+  if (params.get('demo') === 'true') {
+    const timer = setTimeout(() => startScan(), 2000);
+    return () => clearTimeout(timer);
+  }
+}, [startScan]);
+```
+
+Access with `?demo=true` in the URL to auto-start. Without the param, manual button works normally.
+
+- [ ] **Step 2: Commit**
+
+```bash
+git commit -am "feat: auto-scan demo mode via ?demo=true URL param"
+```
+
+---
+
+### Task 17: System prompt tuning
+
+- [ ] **Step 1: Test 3 variations of the system prompt**
+
+In `backend/agent.py`, try these variations and pick the one that produces the best 90-second brief:
+
+**Variation A (current):** General Operator persona in French.
+
+**Variation B:** Add explicit structure format:
+```
+Format de sortie obligatoire :
+## [NOM DU PROJET] — [STATUS]
+- bullet 1
+- bullet 2
+(max 5 bullets)
+Termine par une question : "Quel projet veux-tu traiter en premier ?"
+```
+
+**Variation C:** Add the demo story context explicitly:
+```
+Context: tu monitores un etudiant en alternance. Il a 3 projets :
+un master IA, une alternance en entreprise, et une startup qu'il monte.
+Tu dois l'alerter sur ce qui est urgent MAINTENANT.
+```
+
+- [ ] **Step 2: Pick the best variation and update `agent.py`**
+
+- [ ] **Step 3: Commit**
+
+```bash
+git commit -am "tune: system prompt optimized for demo"
+```
+
+---
+
+### Task 18: Demo rehearsal checklist
+
+- [ ] **Step 1: Run 5 full end-to-end demos**
+
+For each run, check:
+- [ ] Operator speaks first (brief appears without user prompt)
+- [ ] BNP Paribas is first (most urgent)
+- [ ] All 3 projects covered
+- [ ] Tool feed animates correctly
+- [ ] TTS voice works in French
+- [ ] Total time < 90 seconds
+- [ ] No errors in console
+
+- [ ] **Step 2: Fix any issues found**
+
+- [ ] **Step 3: Final commit**
+
+```bash
+git commit -am "polish: demo ready"
+```

docs/superpowers/specs/2026-03-14-operator-design.md

@@ -0,0 +1,255 @@
+# Operator — Design Spec
+
+**Date:** 2026-03-14
+**Context:** Gemini 3 Paris Hackathon — 7 hours — 2 people
+**Stack:** Gemini 3 Flash + FastAPI + React (Replit) + HuggingFace
+
+## 1. Problem
+
+Professionals (here: a student in work-study) juggle 3+ active projects across email, calendar, and the web. No tool monitors all projects simultaneously and speaks first.
+
+## 2. Solution
+
+Operator is an autonomous agent that:
+- Loads 3 projects from config
+- Scans emails, calendar, and web per project (mocked for demo)
+- Scores urgency via HuggingFace cross-encoder
+- Applies deterministic initiative rules (silence, deadline, external signal)
+- Delivers a proactive multi-project brief — unprompted — via text + voice
+
+## 3. Demo Persona
+
+An alternance student with 3 active projects:
+
+| Project | Context | Expected Status |
+|---------|---------|-----------------|
+| Master IA — Sorbonne | TP deadline in 4 days, soutenance to confirm | GREEN / READY |
+| Alternance — BNP Paribas | Manager silent 6 days, blocking bug, sprint review Monday, no prep block | RED / URGENT |
+| Side Project — NoctaAI | YC W26 applications opened this morning | ORANGE / SIGNAL |
+
+## 4. Architecture
+
+```
+Frontend (React / Replit)
+    │
+    │ SSE (Server-Sent Events)
+    │
+Backend (FastAPI / local or Replit)
+    ├── config.json          → 3 projects
+    ├── mock_data.py         → simulated emails, events, search
+    ├── tools.py             → 3 functions declared to Gemini
+    ├── agent.py             → Gemini function calling loop
+    ├── urgency.py           → HuggingFace cross-encoder
+    ├── initiative.py        → deterministic alert rules
+    ├── tts.py               → TTS fallback (Google Cloud)
+    └── main.py              → FastAPI endpoints
+```
+
+### Data flow
+
+1. Frontend calls `POST /api/run`
+2. Backend loads `config.json` → 3 projects
+3. For each project, Gemini calls tools via function calling
+4. Each tool call is streamed to frontend via SSE (animated feed)
+5. HuggingFace scores email urgency
+6. Initiative engine evaluates: silence, deadline, external signal
+7. All results + alerts injected into Gemini context
+8. Gemini generates the proactive brief
+9. Brief streamed to frontend + read aloud via TTS
+
+## 5. Data Model
+
+### config.json
+
+```json
+{
+  "mode": "demo",
+  "projects": [
+    {
+      "id": "school",
+      "name": "Master IA — Sorbonne",
+      "contact": "prof.martinez@sorbonne.fr",
+      "deadline": "2026-03-18T23:59:00",
+      "color": "#00FF88",
+      "keywords": ["cours", "rendu", "memoire", "soutenance", "TP"]
+    },
+    {
+      "id": "company",
+      "name": "Alternance — BNP Paribas",
+      "contact": "sophie.renard@bnpparibas.com",
+      "deadline": "2026-03-17T09:00:00",
+      "color": "#FF4444",
+      "keywords": ["sprint", "daily", "jira", "livrable", "prod"]
+    },
+    {
+      "id": "startup",
+      "name": "Side Project — NoctaAI",
+      "contact": "yassine@noctaai.com",
+      "deadline": "2026-04-05T00:00:00",
+      "color": "#FF8800",
+      "keywords": ["NoctaAI", "MVP", "landing", "beta", "funding"]
+    }
+  ]
+}
+```
+
+### Mock data
+
+Emails, events, and search results are hardcoded in `mock_data.py` to tell a coherent story:
+- **School:** TP deadline in 4 days, soutenance date confirmation needed
+- **Company:** Manager silent 6 days, blocking dashboard bug, sprint review Monday with no prep block
+- **Startup:** YC W26 opened this morning, landing page conversion low
+
+## 6. Backend Components
+
+### tools.py — 3 functions declared to Gemini
+
+- `read_emails(project_id: str) -> str` — returns mock emails for a project
+- `get_events(project_id: str) -> str` — returns mock calendar events
+- `search_web(project_id: str) -> str` — returns mock search results for project keywords
+
+Note: `score_urgency` is NOT a Gemini tool. It is called deterministically by the backend on all emails returned by `read_emails`. Gemini only generates the final brief text.
+
+### urgency.py — HuggingFace scoring
+
+- Model: `cross-encoder/ms-marco-MiniLM-L6-v2` (no hyphen between L and 6)
+- Initialized with `CrossEncoder('cross-encoder/ms-marco-MiniLM-L6-v2', default_activation_function=torch.nn.Sigmoid())` to ensure output is normalized 0-1 (raw logits are unbounded without this)
+- Loaded once at startup
+- Scores relevance between query "urgent action required deadline missed no reply blocked" and email text
+- Returns float 0-1 (after sigmoid activation)
+
+### initiative.py — Deterministic alert rules
+
+4 rules evaluated per project:
+1. **Silence:** `days_since_reply >= 5` → URGENT
+2. **Deadline:** `hours_to_deadline < 48` AND no prep block → URGENT
+3. **External signal:** search urgency score > 0.6 → SIGNAL
+4. **Email urgency:** any email score > 0.8 → URGENT
+
+Output: `{status: "READY"|"URGENT"|"SIGNAL", alerts: [str]}`
+
+### agent.py — Gemini function calling loop
+
+1. Build system prompt (Operator persona)
+2. Inject project list + 3 tools (read_emails, get_events, search_web)
+3. Use the SDK's built-in `ChatSession` to handle thought signatures automatically (Gemini 3 mandates thought signatures during function calling — manual history manipulation will cause 400 errors)
+4. Gemini calls tools autonomously
+5. Each call emitted via `on_event()` callback
+6. Tool results returned to Gemini via ChatSession
+7. Backend runs `score_urgency()` + `evaluate_project()` deterministically on collected data
+8. Initiative results injected into final Gemini prompt
+9. Gemini generates final brief
+10. **Max 15 tool call iterations, 30s total timeout.** If exceeded, force brief generation with data collected so far.
+
+### main.py — FastAPI
+
+- `GET /api/run` → starts the agent loop AND returns an SSE stream directly (no separate POST + GET — avoids race condition where events are lost between POST response and SSE connect)
+- SSE event types:
+  - `tool_call` — tool name, project, status "running"
+  - `tool_result` — tool name, project, result, status "done"
+  - `urgency` — project, score
+  - `brief` — final brief text (no audio_b64 — TTS is browser-side via Web Speech API)
+
+CORS enabled for Replit frontend domain.
+
+## 7. Frontend Components (React)
+
+### Layout
+
+```
+Header        — "OPERATOR" logo + "Lancer le scan" button
+ProjectCards  — 3 cards side by side, color-coded border-left
+ToolFeed      — animated log of tool calls (slide-in, progress bars)
+BriefPanel    — typewriter text + Play audio button
+```
+
+### Components
+
+- `App.jsx` — layout, manages SSE connection
+- `ProjectCard.jsx` — name, status badge (READY/URGENT/SIGNAL), alerts list, color
+- `ToolFeed.jsx` — scrolling feed, each line: tool name + project + duration + progress bar
+- `BriefPanel.jsx` — typewriter text effect + TTS play button
+- `Header.jsx` — logo + trigger button
+
+### Hook: useOperatorSSE(runId)
+
+Consumes SSE stream, returns `{ toolCalls, projects, brief }`.
+
+### Aesthetic
+
+- Background: `#0a0a0a`
+- Text: `#00FF88` (green terminal)
+- Font: `JetBrains Mono` or `Fira Code`
+- Cards: `border-left: 4px solid {project.color}`
+- Tool feed: slide-in animation per line
+- Brief: typewriter CSS effect
+- Badges: pulsing red for URGENT
+
+## 8. TTS
+
+Primary: **Web Speech API** (browser-side, zero setup, no backend involvement)
+- `lang: 'fr-FR'`, `rate: 1.1`, `pitch: 0.9`
+- Frontend calls `speechSynthesis.speak()` directly with the brief text received via SSE
+
+Fallback: **Google Cloud Text-to-Speech** via backend `tts.py` endpoint — only if Web Speech API sounds too robotic during rehearsal. In that case, add `audio_b64` to the `brief` SSE event.
+
+## 9. System Prompt
+
+```
+You are Operator — a Jarvis-class autonomous agent for busy professionals.
+You monitor multiple active projects simultaneously.
+You speak first. You do not wait to be asked.
+
+On startup:
+1. Load all active projects from context
+2. Scan Gmail, Calendar, and Search for each project
+3. Score urgency using provided signals
+4. Deliver a proactive multi-project status brief — unprompted
+
+Rules:
+- Never ask for clarification. Make reasonable assumptions.
+- Never explain what you are doing. Just do it.
+- Output must be 5 bullets max per project. Ruthlessly concise.
+- If a tool fails, skip it and note the gap.
+- Each project gets its own brief block. Never mix project contexts.
+- Start with the most urgent project.
+- The human is busy. Every word must earn its place.
+- Speak in French.
+```
+
+## 10. Out of Scope (do NOT build)
+
+- Mode prod (Gmail clustering via sentence-transformers)
+- Real Gmail/Calendar API OAuth
+- Continuous monitoring loop
+- User authentication
+- Database / persistence
+- Deployment beyond Replit
+
+## 11. Risks
+
+| Risk | Mitigation |
+|------|-----------|
+| Gemini function calling unpredictable | Deterministic initiative engine as backbone; Gemini only generates text |
+| HuggingFace model slow to load | Load once at startup, not per request |
+| SSE connection drops | Frontend auto-reconnect + fallback polling |
+| Demo breaks on stage | "Lancer le scan" button for manual trigger, rehearse 5x |
+| Web Speech API sounds bad | Google Cloud TTS fallback ready |
+| Gemini tool loop hangs | Max 15 iterations + 30s timeout, force brief with partial data |
+
+## 12. Dependencies
+
+### Python (backend)
+- `google-genai` — Gemini 3 Flash SDK
+- `sentence-transformers` — HuggingFace cross-encoder (installs `torch` CPU-only)
+- `fastapi` — API framework
+- `uvicorn` — ASGI server
+- `sse-starlette` — Server-Sent Events for FastAPI
+
+### Frontend (React on Replit)
+- React template on Replit (includes react, react-dom, vite)
+- No additional packages needed
+
+### Environment variables
+- `GOOGLE_API_KEY` — Gemini API key (from Google AI Studio)
+- `HF_TOKEN` — HuggingFace token (optional, model is public)

frontend/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="fr">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>OPERATOR</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>

frontend/package-lock.json

@@ -0,0 +1,1677 @@
+{
+  "name": "operator-frontend",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "operator-frontend",
+      "version": "1.0.0",
+      "dependencies": {
+        "react": "^18.3.0",
+        "react-dom": "^18.3.0"
+      },
+      "devDependencies": {
+        "@vitejs/plugin-react": "^4.3.0",
+        "vite": "^5.4.0"
+      }
+    },
+    "node_modules/@babel/code-frame": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz",
+      "integrity": "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-validator-identifier": "^7.28.5",
+        "js-tokens": "^4.0.0",
+        "picocolors": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/compat-data": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.0.tgz",
+      "integrity": "sha512-T1NCJqT/j9+cn8fvkt7jtwbLBfLC/1y1c7NtCeXFRgzGTsafi68MRv8yzkYSapBnFA6L3U2VSc02ciDzoAJhJg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/core": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.0.tgz",
+      "integrity": "sha512-CGOfOJqWjg2qW/Mb6zNsDm+u5vFQ8DxXfbM09z69p5Z6+mE1ikP2jUXw+j42Pf1XTYED2Rni5f95npYeuwMDQA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.29.0",
+        "@babel/generator": "^7.29.0",
+        "@babel/helper-compilation-targets": "^7.28.6",
+        "@babel/helper-module-transforms": "^7.28.6",
+        "@babel/helpers": "^7.28.6",
+        "@babel/parser": "^7.29.0",
+        "@babel/template": "^7.28.6",
+        "@babel/traverse": "^7.29.0",
+        "@babel/types": "^7.29.0",
+        "@jridgewell/remapping": "^2.3.5",
+        "convert-source-map": "^2.0.0",
+        "debug": "^4.1.0",
+        "gensync": "^1.0.0-beta.2",
+        "json5": "^2.2.3",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/babel"
+      }
+    },
+    "node_modules/@babel/generator": {
+      "version": "7.29.1",
+      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.1.tgz",
+      "integrity": "sha512-qsaF+9Qcm2Qv8SRIMMscAvG4O3lJ0F1GuMo5HR/Bp02LopNgnZBC/EkbevHFeGs4ls/oPz9v+Bsmzbkbe+0dUw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.29.0",
+        "@babel/types": "^7.29.0",
+        "@jridgewell/gen-mapping": "^0.3.12",
+        "@jridgewell/trace-mapping": "^0.3.28",
+        "jsesc": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-compilation-targets": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.28.6.tgz",
+      "integrity": "sha512-JYtls3hqi15fcx5GaSNL7SCTJ2MNmjrkHXg4FSpOA/grxK8KwyZ5bubHsCq8FXCkua6xhuaaBit+3b7+VZRfcA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/compat-data": "^7.28.6",
+        "@babel/helper-validator-option": "^7.27.1",
+        "browserslist": "^4.24.0",
+        "lru-cache": "^5.1.1",
+        "semver": "^6.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-globals": {
+      "version": "7.28.0",
+      "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz",
+      "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-imports": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.28.6.tgz",
+      "integrity": "sha512-l5XkZK7r7wa9LucGw9LwZyyCUscb4x37JWTPz7swwFE/0FMQAGpiWUZn8u9DzkSBWEcK25jmvubfpw2dnAMdbw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/traverse": "^7.28.6",
+        "@babel/types": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-module-transforms": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.6.tgz",
+      "integrity": "sha512-67oXFAYr2cDLDVGLXTEABjdBJZ6drElUSI7WKp70NrpyISso3plG9SAGEF6y7zbha/wOzUByWWTJvEDVNIUGcA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-module-imports": "^7.28.6",
+        "@babel/helper-validator-identifier": "^7.28.5",
+        "@babel/traverse": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0"
+      }
+    },
+    "node_modules/@babel/helper-plugin-utils": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.28.6.tgz",
+      "integrity": "sha512-S9gzZ/bz83GRysI7gAD4wPT/AI3uCnY+9xn+Mx/KPs2JwHJIz1W8PZkg2cqyt3RNOBM8ejcXhV6y8Og7ly/Dug==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-string-parser": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
+      "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-identifier": {
+      "version": "7.28.5",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz",
+      "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helper-validator-option": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz",
+      "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/helpers": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.6.tgz",
+      "integrity": "sha512-xOBvwq86HHdB7WUDTfKfT/Vuxh7gElQ+Sfti2Cy6yIWNW05P8iUslOVcZ4/sKbE+/jQaukQAdz/gf3724kYdqw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/template": "^7.28.6",
+        "@babel/types": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/parser": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.0.tgz",
+      "integrity": "sha512-IyDgFV5GeDUVX4YdF/3CPULtVGSXXMLh1xVIgdCgxApktqnQV0r7/8Nqthg+8YLGaAtdyIlo2qIdZrbCv4+7ww==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.29.0"
+      },
+      "bin": {
+        "parser": "bin/babel-parser.js"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-react-jsx-self": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-self/-/plugin-transform-react-jsx-self-7.27.1.tgz",
+      "integrity": "sha512-6UzkCs+ejGdZ5mFFC/OCUrv028ab2fp1znZmCZjAOBKiBK2jXD1O+BPSfX8X2qjJ75fZBMSnQn3Rq2mrBJK2mw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/plugin-transform-react-jsx-source": {
+      "version": "7.27.1",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-source/-/plugin-transform-react-jsx-source-7.27.1.tgz",
+      "integrity": "sha512-zbwoTsBruTeKB9hSq73ha66iFeJHuaFkUbwvqElnygoNbj/jHRsSeokowZFN3CZ64IvEqcmmkVe89OPXc7ldAw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.27.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
+    "node_modules/@babel/template": {
+      "version": "7.28.6",
+      "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.28.6.tgz",
+      "integrity": "sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.28.6",
+        "@babel/parser": "^7.28.6",
+        "@babel/types": "^7.28.6"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/traverse": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.0.tgz",
+      "integrity": "sha512-4HPiQr0X7+waHfyXPZpWPfWL/J7dcN1mx9gL6WdQVMbPnF3+ZhSMs8tCxN7oHddJE9fhNE7+lxdnlyemKfJRuA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.29.0",
+        "@babel/generator": "^7.29.0",
+        "@babel/helper-globals": "^7.28.0",
+        "@babel/parser": "^7.29.0",
+        "@babel/template": "^7.28.6",
+        "@babel/types": "^7.29.0",
+        "debug": "^4.3.1"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@babel/types": {
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.0.tgz",
+      "integrity": "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-string-parser": "^7.27.1",
+        "@babel/helper-validator-identifier": "^7.28.5"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "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==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "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==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@jridgewell/gen-mapping": {
+      "version": "0.3.13",
+      "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
+      "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.0",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/remapping": {
+      "version": "2.3.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
+      "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/gen-mapping": "^0.3.5",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/resolve-uri": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+      "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "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==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@rollup/rollup-android-arm-eabi": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.59.0.tgz",
+      "integrity": "sha512-upnNBkA6ZH2VKGcBj9Fyl9IGNPULcjXRlg0LLeaioQWueH30p6IXtJEbKAgvyv+mJaMxSm1l6xwDXYjpEMiLMg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-android-arm64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.59.0.tgz",
+      "integrity": "sha512-hZ+Zxj3SySm4A/DylsDKZAeVg0mvi++0PYVceVyX7hemkw7OreKdCvW2oQ3T1FMZvCaQXqOTHb8qmBShoqk69Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-arm64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.59.0.tgz",
+      "integrity": "sha512-W2Psnbh1J8ZJw0xKAd8zdNgF9HRLkdWwwdWqubSVk0pUuQkoHnv7rx4GiF9rT4t5DIZGAsConRE3AxCdJ4m8rg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-x64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.59.0.tgz",
+      "integrity": "sha512-ZW2KkwlS4lwTv7ZVsYDiARfFCnSGhzYPdiOU4IM2fDbL+QGlyAbjgSFuqNRbSthybLbIJ915UtZBtmuLrQAT/w==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-arm64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.59.0.tgz",
+      "integrity": "sha512-EsKaJ5ytAu9jI3lonzn3BgG8iRBjV4LxZexygcQbpiU0wU0ATxhNVEpXKfUa0pS05gTcSDMKpn3Sx+QB9RlTTA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-x64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.59.0.tgz",
+      "integrity": "sha512-d3DuZi2KzTMjImrxoHIAODUZYoUUMsuUiY4SRRcJy6NJoZ6iIqWnJu9IScV9jXysyGMVuW+KNzZvBLOcpdl3Vg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.59.0.tgz",
+      "integrity": "sha512-t4ONHboXi/3E0rT6OZl1pKbl2Vgxf9vJfWgmUoCEVQVxhW6Cw/c8I6hbbu7DAvgp82RKiH7TpLwxnJeKv2pbsw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.59.0.tgz",
+      "integrity": "sha512-CikFT7aYPA2ufMD086cVORBYGHffBo4K8MQ4uPS/ZnY54GKj36i196u8U+aDVT2LX4eSMbyHtyOh7D7Zvk2VvA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.59.0.tgz",
+      "integrity": "sha512-jYgUGk5aLd1nUb1CtQ8E+t5JhLc9x5WdBKew9ZgAXg7DBk0ZHErLHdXM24rfX+bKrFe+Xp5YuJo54I5HFjGDAA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-musl": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.59.0.tgz",
+      "integrity": "sha512-peZRVEdnFWZ5Bh2KeumKG9ty7aCXzzEsHShOZEFiCQlDEepP1dpUl/SrUNXNg13UmZl+gzVDPsiCwnV1uI0RUA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.59.0.tgz",
+      "integrity": "sha512-gbUSW/97f7+r4gHy3Jlup8zDG190AuodsWnNiXErp9mT90iCy9NKKU0Xwx5k8VlRAIV2uU9CsMnEFg/xXaOfXg==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-musl": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.59.0.tgz",
+      "integrity": "sha512-yTRONe79E+o0FWFijasoTjtzG9EBedFXJMl888NBEDCDV9I2wGbFFfJQQe63OijbFCUZqxpHz1GzpbtSFikJ4Q==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.59.0.tgz",
+      "integrity": "sha512-sw1o3tfyk12k3OEpRddF68a1unZ5VCN7zoTNtSn2KndUE+ea3m3ROOKRCZxEpmT9nsGnogpFP9x6mnLTCaoLkA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-musl": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.59.0.tgz",
+      "integrity": "sha512-+2kLtQ4xT3AiIxkzFVFXfsmlZiG5FXYW7ZyIIvGA7Bdeuh9Z0aN4hVyXS/G1E9bTP/vqszNIN/pUKCk/BTHsKA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.59.0.tgz",
+      "integrity": "sha512-NDYMpsXYJJaj+I7UdwIuHHNxXZ/b/N2hR15NyH3m2qAtb/hHPA4g4SuuvrdxetTdndfj9b1WOmy73kcPRoERUg==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-musl": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.59.0.tgz",
+      "integrity": "sha512-nLckB8WOqHIf1bhymk+oHxvM9D3tyPndZH8i8+35p/1YiVoVswPid2yLzgX7ZJP0KQvnkhM4H6QZ5m0LzbyIAg==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-s390x-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.59.0.tgz",
+      "integrity": "sha512-oF87Ie3uAIvORFBpwnCvUzdeYUqi2wY6jRFWJAy1qus/udHFYIkplYRW+wo+GRUP4sKzYdmE1Y3+rY5Gc4ZO+w==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.59.0.tgz",
+      "integrity": "sha512-3AHmtQq/ppNuUspKAlvA8HtLybkDflkMuLK4DPo77DfthRb71V84/c4MlWJXixZz4uruIH4uaa07IqoAkG64fg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-musl": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.59.0.tgz",
+      "integrity": "sha512-2UdiwS/9cTAx7qIUZB/fWtToJwvt0Vbo0zmnYt7ED35KPg13Q0ym1g442THLC7VyI6JfYTP4PiSOWyoMdV2/xg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-openbsd-x64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.59.0.tgz",
+      "integrity": "sha512-M3bLRAVk6GOwFlPTIxVBSYKUaqfLrn8l0psKinkCFxl4lQvOSz8ZrKDz2gxcBwHFpci0B6rttydI4IpS4IS/jQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-openharmony-arm64": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.59.0.tgz",
+      "integrity": "sha512-tt9KBJqaqp5i5HUZzoafHZX8b5Q2Fe7UjYERADll83O4fGqJ49O1FsL6LpdzVFQcpwvnyd0i+K/VSwu/o/nWlA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-arm64-msvc": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.59.0.tgz",
+      "integrity": "sha512-V5B6mG7OrGTwnxaNUzZTDTjDS7F75PO1ae6MJYdiMu60sq0CqN5CVeVsbhPxalupvTX8gXVSU9gq+Rx1/hvu6A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-ia32-msvc": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.59.0.tgz",
+      "integrity": "sha512-UKFMHPuM9R0iBegwzKF4y0C4J9u8C6MEJgFuXTBerMk7EJ92GFVFYBfOZaSGLu6COf7FxpQNqhNS4c4icUPqxA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-gnu": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.59.0.tgz",
+      "integrity": "sha512-laBkYlSS1n2L8fSo1thDNGrCTQMmxjYY5G0WFWjFFYZkKPjsMBsgJfGf4TLxXrF6RyhI60L8TMOjBMvXiTcxeA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-msvc": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.59.0.tgz",
+      "integrity": "sha512-2HRCml6OztYXyJXAvdDXPKcawukWY2GpR5/nxKp4iBgiO3wcoEGkAaqctIbZcNB6KlUQBIqt8VYkNSj2397EfA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@types/babel__core": {
+      "version": "7.20.5",
+      "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz",
+      "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.20.7",
+        "@babel/types": "^7.20.7",
+        "@types/babel__generator": "*",
+        "@types/babel__template": "*",
+        "@types/babel__traverse": "*"
+      }
+    },
+    "node_modules/@types/babel__generator": {
+      "version": "7.27.0",
+      "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz",
+      "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.0.0"
+      }
+    },
+    "node_modules/@types/babel__template": {
+      "version": "7.4.4",
+      "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz",
+      "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/parser": "^7.1.0",
+        "@babel/types": "^7.0.0"
+      }
+    },
+    "node_modules/@types/babel__traverse": {
+      "version": "7.28.0",
+      "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.28.0.tgz",
+      "integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/types": "^7.28.2"
+      }
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
+      "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "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==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/core": "^7.28.0",
+        "@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",
+        "@types/babel__core": "^7.20.5",
+        "react-refresh": "^0.17.0"
+      },
+      "engines": {
+        "node": "^14.18.0 || >=16.0.0"
+      },
+      "peerDependencies": {
+        "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0"
+      }
+    },
+    "node_modules/baseline-browser-mapping": {
+      "version": "2.10.7",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.7.tgz",
+      "integrity": "sha512-1ghYO3HnxGec0TCGBXiDLVns4eCSx4zJpxnHrlqFQajmhfKMQBzUGDdkMK7fUW7PTHTeLf+j87aTuKuuwWzMGw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "baseline-browser-mapping": "dist/cli.cjs"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/browserslist": {
+      "version": "4.28.1",
+      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.1.tgz",
+      "integrity": "sha512-ZC5Bd0LgJXgwGqUknZY/vkUQ04r8NXnJZ3yYi4vDmSiZmC/pdSN0NbNRPxZpbtO4uAfDUAFffO8IZoM3Gj8IkA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "baseline-browser-mapping": "^2.9.0",
+        "caniuse-lite": "^1.0.30001759",
+        "electron-to-chromium": "^1.5.263",
+        "node-releases": "^2.0.27",
+        "update-browserslist-db": "^1.2.0"
+      },
+      "bin": {
+        "browserslist": "cli.js"
+      },
+      "engines": {
+        "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
+      }
+    },
+    "node_modules/caniuse-lite": {
+      "version": "1.0.30001778",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001778.tgz",
+      "integrity": "sha512-PN7uxFL+ExFJO61aVmP1aIEG4i9whQd4eoSCebav62UwDyp5OHh06zN4jqKSMePVgxHifCw1QJxdRkA1Pisekg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "CC-BY-4.0"
+    },
+    "node_modules/convert-source-map": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
+      "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/electron-to-chromium": {
+      "version": "1.5.313",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.313.tgz",
+      "integrity": "sha512-QBMrTWEf00GXZmJyx2lbYD45jpI3TUFnNIzJ5BBc8piGUDwMPa1GV6HJWTZVvY/eiN3fSopl7NRbgGp9sZ9LTA==",
+      "dev": true,
+      "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==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "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"
+      }
+    },
+    "node_modules/escalade": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/gensync": {
+      "version": "1.0.0-beta.2",
+      "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
+      "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/js-tokens": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+      "license": "MIT"
+    },
+    "node_modules/jsesc": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz",
+      "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "jsesc": "bin/jsesc"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/json5": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
+      "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "json5": "lib/cli.js"
+      },
+      "engines": {
+        "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",
+      "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "yallist": "^3.0.2"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.11",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/node-releases": {
+      "version": "2.0.36",
+      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.36.tgz",
+      "integrity": "sha512-TdC8FSgHz8Mwtw9g5L4gR/Sh9XhSP/0DEkQxfEFXOpiul5IiHgHan2VhYYb6agDSfp4KuvltmGApc8HMgUrIkA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/postcss": {
+      "version": "8.5.8",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.8.tgz",
+      "integrity": "sha512-OW/rX8O/jXnm82Ey1k44pObPtdblfiuWnrd8X7GJ7emImCOstunGbXUpp7HdBrFQX6rJzn3sPT397Wp5aCwCHg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "nanoid": "^3.3.11",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "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==",
+      "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==",
+      "license": "MIT",
+      "dependencies": {
+        "loose-envify": "^1.1.0",
+        "scheduler": "^0.23.2"
+      },
+      "peerDependencies": {
+        "react": "^18.3.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==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "4.59.0",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.59.0.tgz",
+      "integrity": "sha512-2oMpl67a3zCH9H79LeMcbDhXW/UmWG/y2zuqnF2jQq5uq9TbM9TVyXvA4+t+ne2IIkBdrLpAaRQAvo7YI/Yyeg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "1.0.8"
+      },
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@rollup/rollup-android-arm-eabi": "4.59.0",
+        "@rollup/rollup-android-arm64": "4.59.0",
+        "@rollup/rollup-darwin-arm64": "4.59.0",
+        "@rollup/rollup-darwin-x64": "4.59.0",
+        "@rollup/rollup-freebsd-arm64": "4.59.0",
+        "@rollup/rollup-freebsd-x64": "4.59.0",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.59.0",
+        "@rollup/rollup-linux-arm-musleabihf": "4.59.0",
+        "@rollup/rollup-linux-arm64-gnu": "4.59.0",
+        "@rollup/rollup-linux-arm64-musl": "4.59.0",
+        "@rollup/rollup-linux-loong64-gnu": "4.59.0",
+        "@rollup/rollup-linux-loong64-musl": "4.59.0",
+        "@rollup/rollup-linux-ppc64-gnu": "4.59.0",
+        "@rollup/rollup-linux-ppc64-musl": "4.59.0",
+        "@rollup/rollup-linux-riscv64-gnu": "4.59.0",
+        "@rollup/rollup-linux-riscv64-musl": "4.59.0",
+        "@rollup/rollup-linux-s390x-gnu": "4.59.0",
+        "@rollup/rollup-linux-x64-gnu": "4.59.0",
+        "@rollup/rollup-linux-x64-musl": "4.59.0",
+        "@rollup/rollup-openbsd-x64": "4.59.0",
+        "@rollup/rollup-openharmony-arm64": "4.59.0",
+        "@rollup/rollup-win32-arm64-msvc": "4.59.0",
+        "@rollup/rollup-win32-ia32-msvc": "4.59.0",
+        "@rollup/rollup-win32-x64-gnu": "4.59.0",
+        "@rollup/rollup-win32-x64-msvc": "4.59.0",
+        "fsevents": "~2.3.2"
+      }
+    },
+    "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"
+      }
+    },
+    "node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/update-browserslist-db": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.3.tgz",
+      "integrity": "sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/browserslist"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/browserslist"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "escalade": "^3.2.0",
+        "picocolors": "^1.1.1"
+      },
+      "bin": {
+        "update-browserslist-db": "cli.js"
+      },
+      "peerDependencies": {
+        "browserslist": ">= 4.21.0"
+      }
+    },
+    "node_modules/vite": {
+      "version": "5.4.21",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.21.tgz",
+      "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "^0.21.3",
+        "postcss": "^8.4.43",
+        "rollup": "^4.20.0"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^18.0.0 || >=20.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^18.0.0 || >=20.0.0",
+        "less": "*",
+        "lightningcss": "^1.21.0",
+        "sass": "*",
+        "sass-embedded": "*",
+        "stylus": "*",
+        "sugarss": "*",
+        "terser": "^5.4.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/yallist": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
+      "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==",
+      "dev": true,
+      "license": "ISC"
+    }
+  }
+}

frontend/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "operator-frontend",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.3.0",
+    "vite": "^5.4.0"
+  }
+}

frontend/src/App.jsx

@@ -0,0 +1,334 @@
+import { useState, useCallback, useRef } from 'react';
+import JarvisOrb from './components/JarvisOrb';
+import ConversationOverlay from './components/ConversationOverlay';
+import ProjectCardsDrawer from './components/ProjectCardsDrawer';
+import useOperatorSSE from './hooks/useOperatorSSE';
+import useWakeWord from './hooks/useWakeWord';
+import useSpeechRecognition from './hooks/useSpeechRecognition';
+import useTTS from './hooks/useTTS';
+import useGoogleAuth from './hooks/useGoogleAuth';
+
+const PROJECTS = [
+  { id: 'school', name: 'Master IA \u2014 Sorbonne', contact: 'prof.martinez@sorbonne.fr', color: '#4285f4' },
+  { id: 'company', name: 'Alternance \u2014 BNP Paribas', contact: 'sophie.renard@bnpparibas.com', color: '#ea4335' },
+  { id: 'startup', name: 'Side Project \u2014 NoctaAI', contact: 'yassine@noctaai.com', color: '#fbbc04' },
+];
+
+export default function App() {
+  const { sendChat } = useOperatorSSE();
+  const { speak } = useTTS();
+  const { authenticated, oauthAvailable, login, logout } = useGoogleAuth();
+
+  // Start directly in IDLE — no scan needed
+  const [phase, setPhase] = useState('IDLE');
+  const [messages, setMessages] = useState([]);
+  const phaseRef = useRef(phase);
+  phaseRef.current = phase;
+
+  const [inputText, setInputText] = useState('');
+  const [showTranscript, setShowTranscript] = useState(false);
+
+  const handleWakeWord = useCallback(() => {
+    if (phaseRef.current === 'IDLE') setPhase('LISTENING');
+  }, []);
+
+  const { micActive, micError, requestMic } = useWakeWord({
+    enabled: phase === 'IDLE',
+    onDetected: handleWakeWord,
+  });
+
+  const handleOrbClick = useCallback(() => {
+    if (phase === 'IDLE') {
+      if (micError || !micActive) {
+        // First click: authorize mic — wake word listener starts
+        requestMic();
+      } else {
+        // Mic already active — go to listening
+        setPhase('LISTENING');
+      }
+    }
+  }, [phase, micError, micActive, requestMic]);
+
+  const handleUserSaid = useCallback(async (text) => {
+    if (!text.trim()) return;
+
+    const bye = text.toLowerCase();
+    if (bye.includes('merci') || bye.includes("c'est bon") || bye.includes('a plus') || bye.includes('au revoir')) {
+      setMessages(prev => [...prev, { role: 'user', text }]);
+      const farewell = "Ok, je reste la si tu as besoin. Dis 'Oppy' quand tu veux.";
+      setMessages(prev => [...prev, { role: 'assistant', text: farewell }]);
+      setPhase('SPEAKING');
+      await speak(farewell);
+      setPhase('IDLE');
+      return;
+    }
+
+    setMessages(prev => [...prev, { role: 'user', text }]);
+    setPhase('SPEAKING');
+    const acks = [
+      "D'accord, donne-moi un petit instant.",
+      "Je regarde ca tout de suite.",
+      "Laisse-moi verifier.",
+      "Une seconde, je cherche.",
+    ];
+    const ack = acks[Math.floor(Math.random() * acks.length)];
+    const ackDone = speak(ack);
+    const replyPromise = sendChat(text);
+    await ackDone;
+    setPhase('THINKING');
+
+    try {
+      const reply = await replyPromise;
+      if (reply) {
+        setMessages(prev => [...prev, { role: 'assistant', text: reply }]);
+        setPhase('SPEAKING');
+        await speak(reply);
+        if (phaseRef.current === 'SPEAKING') setPhase('LISTENING');
+      } else {
+        setPhase('LISTENING');
+      }
+    } catch (err) {
+      console.error('Chat error:', err);
+      setPhase('LISTENING');
+    }
+  }, [sendChat, speak]);
+
+  const handleTimeout = useCallback(() => {
+    if (phaseRef.current === 'LISTENING') setPhase('IDLE');
+  }, []);
+
+  const { transcript } = useSpeechRecognition({
+    enabled: phase === 'LISTENING',
+    onResult: handleUserSaid,
+    onTimeout: handleTimeout,
+    timeoutMs: 20000,
+  });
+
+  const handleSubmit = (e) => {
+    e.preventDefault();
+    const text = inputText.trim();
+    if (!text || phase === 'THINKING' || phase === 'SPEAKING') return;
+    setInputText('');
+    handleUserSaid(text);
+  };
+
+  let label = '';
+  if (phase === 'IDLE') {
+    if (micError) label = "Clique sur l'orbe pour autoriser le micro";
+    else if (!micActive) label = "Clique sur l'orbe pour activer le micro";
+    else label = "Micro actif — dis 'Oppy' pour commencer";
+  }
+  else if (phase === 'LISTENING') label = transcript || "Je t'ecoute...";
+  else if (phase === 'THINKING') label = 'Oppy reflechit...';
+  else if (phase === 'SPEAKING') label = '';
+
+  const micDotColor = phase === 'IDLE' && micActive ? '#34a853' : phase === 'IDLE' && micError ? '#ea4335' : null;
+
+  return (
+    <div style={{
+      minHeight: '100vh',
+      display: 'flex',
+      flexDirection: 'column',
+      alignItems: 'center',
+      justifyContent: 'center',
+      padding: '40px 20px 100px',
+      position: 'relative',
+    }}>
+      {/* Logo */}
+      <div style={{
+        position: 'fixed',
+        top: 0,
+        left: 0,
+        padding: '20px 24px',
+        zIndex: 10,
+        display: 'flex',
+        alignItems: 'center',
+        gap: '10px',
+      }}>
+        <span style={{
+          fontSize: '20px',
+          background: 'linear-gradient(135deg, #4285f4, #a142f4, #f439a0)',
+          WebkitBackgroundClip: 'text',
+          WebkitTextFillColor: 'transparent',
+        }}>
+          &#10022;
+        </span>
+        <h1 style={{
+          fontSize: '16px',
+          fontWeight: 500,
+          color: '#1f1f1f',
+          margin: 0,
+          letterSpacing: '0.5px',
+        }}>
+          Oppy
+        </h1>
+      </div>
+
+      {/* Google Auth status */}
+      {oauthAvailable && (
+        <div style={{
+          position: 'fixed',
+          top: 0,
+          right: 0,
+          padding: '20px 24px',
+          zIndex: 10,
+          display: 'flex',
+          alignItems: 'center',
+          gap: '10px',
+        }}>
+          <span style={{
+            fontSize: '11px',
+            color: authenticated ? '#34a853' : '#9aa0a6',
+            display: 'flex',
+            alignItems: 'center',
+            gap: '6px',
+          }}>
+            <span style={{
+              width: '8px',
+              height: '8px',
+              borderRadius: '50%',
+              background: authenticated ? '#34a853' : '#9aa0a6',
+              display: 'inline-block',
+            }} />
+            {authenticated ? 'Google connecte' : 'Mode demo'}
+          </span>
+          <button
+            onClick={authenticated ? logout : login}
+            style={{
+              background: 'transparent',
+              color: authenticated ? '#9aa0a6' : '#4285f4',
+              border: `1px solid ${authenticated ? '#e0e0e0' : '#4285f4'}`,
+              padding: '6px 12px',
+              borderRadius: '16px',
+              fontFamily: 'inherit',
+              fontSize: '11px',
+              fontWeight: 500,
+              cursor: 'pointer',
+              transition: 'all 0.2s',
+            }}
+          >
+            {authenticated ? 'Deconnecter' : 'Connecter Google'}
+          </button>
+        </div>
+      )}
+
+      {/* Orb */}
+      <JarvisOrb phase={phase} onClick={handleOrbClick} isLoading={false} />
+
+      {/* Mic status dot */}
+      {micDotColor && (
+        <div style={{
+          marginTop: '12px',
+          display: 'flex',
+          alignItems: 'center',
+          gap: '6px',
+        }}>
+          <div style={{
+            width: '8px', height: '8px', borderRadius: '50%',
+            background: micDotColor,
+            animation: micActive ? 'pulse 2s infinite' : 'none',
+          }} />
+          <span style={{ fontSize: '11px', color: micDotColor, letterSpacing: '0.5px' }}>
+            {micActive ? 'Micro actif' : 'Micro bloque'}
+          </span>
+        </div>
+      )}
+
+      {/* Phase label */}
+      <div style={{
+        marginTop: micDotColor ? '8px' : '24px',
+        fontSize: '14px',
+        color: phase === 'LISTENING' && transcript ? '#4285f4' : '#5f6368',
+        textAlign: 'center',
+        minHeight: '20px',
+        animation: phase === 'THINKING' ? 'pulse 1.5s infinite' : 'none',
+        fontWeight: phase === 'LISTENING' && transcript ? 500 : 400,
+      }}>
+        {label}
+      </div>
+
+      {/* Transcript toggle */}
+      {messages.length > 0 && (
+        <div style={{ marginTop: '16px', textAlign: 'center' }}>
+          <button
+            onClick={() => setShowTranscript(!showTranscript)}
+            style={{
+              background: showTranscript ? '#f1f3f4' : 'transparent',
+              border: '1px solid #e0e0e0',
+              color: '#5f6368',
+              padding: '6px 16px',
+              borderRadius: '16px',
+              fontFamily: 'inherit',
+              fontSize: '12px',
+              cursor: 'pointer',
+              transition: 'all 0.2s',
+            }}
+          >
+            {showTranscript ? 'Masquer la transcription' : 'Afficher la transcription'}
+          </button>
+        </div>
+      )}
+      {showTranscript && (
+        <div style={{ marginTop: '12px', width: '100%', maxWidth: '600px' }}>
+          <ConversationOverlay messages={messages} isThinking={phase === 'THINKING'} />
+        </div>
+      )}
+
+      {/* Text input */}
+      <form
+        onSubmit={handleSubmit}
+        style={{
+          position: 'fixed',
+          bottom: '50px',
+          left: '50%',
+          transform: 'translateX(-50%)',
+          width: '100%',
+          maxWidth: '500px',
+          display: 'flex',
+          gap: '8px',
+          padding: '0 20px',
+          zIndex: 15,
+        }}
+      >
+        <input
+          type="text"
+          value={inputText}
+          onChange={(e) => setInputText(e.target.value)}
+          placeholder="Ecris ta question ici..."
+          style={{
+            flex: 1,
+            background: '#f8f9fa',
+            border: '1px solid #e0e0e0',
+            borderRadius: '24px',
+            padding: '12px 20px',
+            color: '#1f1f1f',
+            fontFamily: 'inherit',
+            fontSize: '14px',
+            outline: 'none',
+          }}
+        />
+        <button
+          type="submit"
+          disabled={!inputText.trim() || phase === 'THINKING'}
+          style={{
+            background: inputText.trim() ? '#4285f4' : '#f1f3f4',
+            color: inputText.trim() ? '#fff' : '#9aa0a6',
+            border: 'none',
+            borderRadius: '24px',
+            padding: '12px 20px',
+            fontFamily: 'inherit',
+            fontSize: '13px',
+            fontWeight: 500,
+            cursor: !inputText.trim() ? 'not-allowed' : 'pointer',
+            transition: 'all 0.2s',
+          }}
+        >
+          Envoyer
+        </button>
+      </form>
+
+      {/* Project cards drawer */}
+      <ProjectCardsDrawer projects={PROJECTS} statuses={{}} />
+    </div>
+  );
+}

frontend/src/components/BriefPanel.jsx

@@ -0,0 +1,147 @@
+import { useState, useEffect, useRef } from 'react';
+
+const BACKEND_URL = import.meta.env.VITE_BACKEND_URL || (import.meta.env.DEV ? 'http://localhost:8000' : '');
+
+export default function BriefPanel({ briefText }) {
+  const [displayedText, setDisplayedText] = useState('');
+  const [isPlaying, setIsPlaying] = useState(false);
+  const [isLoading, setIsLoading] = useState(false);
+  const audioRef = useRef(null);
+
+  useEffect(() => {
+    if (!briefText) {
+      setDisplayedText('');
+      return;
+    }
+    // Typewriter effect
+    setDisplayedText('');
+    let i = 0;
+    const interval = setInterval(() => {
+      if (i < briefText.length) {
+        setDisplayedText(briefText.slice(0, i + 1));
+        i++;
+      } else {
+        clearInterval(interval);
+      }
+    }, 12);
+
+    // Auto-launch TTS in parallel
+    (async () => {
+      setIsLoading(true);
+      try {
+        const res = await fetch(`${BACKEND_URL}/api/tts`, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ text: briefText }),
+        });
+        if (!res.ok) throw new Error('TTS failed');
+        const blob = await res.blob();
+        const url = URL.createObjectURL(blob);
+        const audio = new Audio(url);
+        audioRef.current = audio;
+        audio.onended = () => {
+          setIsPlaying(false);
+          URL.revokeObjectURL(url);
+        };
+        setIsPlaying(true);
+        await audio.play();
+      } catch (err) {
+        console.error('TTS auto-play error:', err);
+      } finally {
+        setIsLoading(false);
+      }
+    })();
+
+    return () => clearInterval(interval);
+  }, [briefText]);
+
+  const handleSpeak = async () => {
+    if (isPlaying) {
+      if (audioRef.current) {
+        audioRef.current.pause();
+        audioRef.current.currentTime = 0;
+      }
+      setIsPlaying(false);
+      return;
+    }
+
+    setIsLoading(true);
+    try {
+      const res = await fetch(`${BACKEND_URL}/api/tts`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ text: briefText }),
+      });
+      if (!res.ok) throw new Error('TTS failed');
+
+      const blob = await res.blob();
+      const url = URL.createObjectURL(blob);
+      const audio = new Audio(url);
+      audioRef.current = audio;
+
+      audio.onended = () => {
+        setIsPlaying(false);
+        URL.revokeObjectURL(url);
+      };
+
+      setIsPlaying(true);
+      await audio.play();
+    } catch (err) {
+      console.error('TTS error:', err);
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  if (!briefText) {
+    return null;
+  }
+
+  return (
+    <div style={{
+      background: 'var(--card-bg)',
+      padding: '24px',
+      borderTop: '1px solid var(--border)',
+      animation: 'fadeIn 0.5s ease-out',
+    }}>
+      <div style={{
+        display: 'flex',
+        justifyContent: 'space-between',
+        alignItems: 'center',
+        marginBottom: '16px',
+      }}>
+        <h4 style={{ fontSize: '11px', color: 'var(--text-dim)', letterSpacing: '2px' }}>
+          BRIEF PROACTIF
+        </h4>
+        <button
+          onClick={handleSpeak}
+          disabled={isLoading}
+          style={{
+            background: 'none',
+            border: '1px solid var(--green)',
+            color: 'var(--green)',
+            padding: '6px 16px',
+            fontFamily: 'inherit',
+            fontSize: '12px',
+            cursor: isLoading ? 'wait' : 'pointer',
+            transition: 'all 0.2s',
+            opacity: isLoading ? 0.6 : 1,
+          }}
+        >
+          {isLoading ? '\u23F3 Chargement...' : isPlaying ? '\u23F9 Stop' : '\uD83D\uDD0A Play'}
+        </button>
+      </div>
+      <div style={{
+        fontSize: '14px',
+        lineHeight: '1.7',
+        whiteSpace: 'pre-wrap',
+        color: '#e0e0e0',
+      }}>
+        {displayedText}
+        {displayedText.length < (briefText?.length || 0) && (
+          <span style={{ animation: 'pulse 0.8s infinite', color: 'var(--green)' }}>|</span>
+        )}
+      </div>
+    </div>
+  );
+}

frontend/src/components/ConversationOverlay.jsx

@@ -0,0 +1,65 @@
+import { useEffect, useRef } from 'react';
+
+export default function ConversationOverlay({ messages, isThinking }) {
+  const endRef = useRef(null);
+
+  useEffect(() => {
+    endRef.current?.scrollIntoView({ behavior: 'smooth' });
+  }, [messages, isThinking]);
+
+  if ((!messages || messages.length === 0) && !isThinking) return null;
+
+  return (
+    <div style={{
+      width: '100%',
+      maxWidth: '600px',
+      maxHeight: '40vh',
+      overflowY: 'auto',
+      display: 'flex',
+      flexDirection: 'column',
+      gap: '10px',
+      padding: '10px 0',
+    }}>
+      {messages.map((msg, i) => (
+        <div key={i} style={{
+          padding: '12px 16px',
+          borderRadius: '12px',
+          fontSize: '14px',
+          lineHeight: '1.6',
+          whiteSpace: 'pre-wrap',
+          background: msg.role === 'user' ? '#e8f0fe' : '#f8f9fa',
+          borderLeft: `3px solid ${msg.role === 'user' ? '#4285f4' : '#a142f4'}`,
+          color: '#1f1f1f',
+          animation: 'fadeInUp 0.3s ease-out',
+          alignSelf: msg.role === 'user' ? 'flex-end' : 'flex-start',
+          maxWidth: '85%',
+        }}>
+          <span style={{
+            fontSize: '11px',
+            color: msg.role === 'user' ? '#4285f4' : '#a142f4',
+            fontWeight: 500,
+            display: 'block',
+            marginBottom: '4px',
+          }}>
+            {msg.role === 'user' ? 'Toi' : 'Oppy'}
+          </span>
+          {msg.text}
+        </div>
+      ))}
+
+      {isThinking && (
+        <div style={{
+          padding: '12px 16px',
+          fontSize: '14px',
+          color: '#a142f4',
+          fontStyle: 'italic',
+          animation: 'pulse 1.5s infinite',
+        }}>
+          Oppy reflechit...
+        </div>
+      )}
+
+      <div ref={endRef} />
+    </div>
+  );
+}

frontend/src/components/Header.jsx

@@ -0,0 +1,125 @@
+export default function Header({ scanProgress, scanPhase, authenticated, oauthAvailable, onLogin, onLogout }) {
+  return (
+    <header style={{
+      padding: '24px 32px',
+      borderBottom: '1px solid var(--border)',
+    }}>
+      <div style={{
+        display: 'flex',
+        justifyContent: 'space-between',
+        alignItems: 'center',
+      }}>
+        <div>
+          <h1 style={{
+            fontSize: '28px',
+            fontWeight: 700,
+            color: 'var(--green)',
+            letterSpacing: '4px',
+          }}>
+            &#9632; OPERATOR
+          </h1>
+          <p style={{
+            fontSize: '12px',
+            color: 'var(--text-dim)',
+            marginTop: '4px',
+            fontStyle: 'italic',
+          }}>
+            The AI Agent That Works While You Talk.
+          </p>
+        </div>
+        <div style={{ display: 'flex', gap: '12px', alignItems: 'center' }}>
+          {oauthAvailable && (
+            <>
+              <span style={{
+                fontSize: '11px',
+                color: authenticated ? 'var(--green)' : 'var(--text-dim)',
+                display: 'flex',
+                alignItems: 'center',
+                gap: '6px',
+              }}>
+                <span style={{
+                  width: '8px',
+                  height: '8px',
+                  borderRadius: '50%',
+                  background: authenticated ? 'var(--green)' : 'var(--text-dim)',
+                  display: 'inline-block',
+                }} />
+                {authenticated ? 'GOOGLE CONNECTED' : 'DEMO MODE'}
+              </span>
+              <button
+                onClick={authenticated ? onLogout : onLogin}
+                style={{
+                  background: 'transparent',
+                  color: authenticated ? 'var(--text-dim)' : '#4285F4',
+                  border: `1px solid ${authenticated ? 'var(--border)' : '#4285F4'}`,
+                  padding: '8px 16px',
+                  fontFamily: 'inherit',
+                  fontSize: '11px',
+                  fontWeight: 700,
+                  cursor: 'pointer',
+                  letterSpacing: '1px',
+                  transition: 'all 0.2s',
+                }}
+              >
+                {authenticated ? 'DISCONNECT' : 'CONNECT GOOGLE'}
+              </button>
+            </>
+          )}
+          {scanProgress > 0 && scanProgress < 100 && (
+            <span style={{
+              fontSize: '12px',
+              color: 'var(--green)',
+              letterSpacing: '2px',
+              fontWeight: 700,
+              animation: 'pulse 1.5s infinite',
+            }}>
+              SCANNING...
+            </span>
+          )}
+        </div>
+      </div>
+
+      {/* Progress bar */}
+      {scanProgress > 0 && scanProgress < 100 && (
+        <div style={{ marginTop: '16px' }}>
+          <div style={{
+            display: 'flex',
+            justifyContent: 'space-between',
+            alignItems: 'center',
+            marginBottom: '6px',
+          }}>
+            <span style={{
+              fontSize: '11px',
+              color: 'var(--text-dim)',
+              letterSpacing: '1px',
+            }}>
+              {scanPhase}
+            </span>
+            <span style={{
+              fontSize: '11px',
+              color: 'var(--text-dim)',
+              fontVariantNumeric: 'tabular-nums',
+            }}>
+              {scanProgress}%
+            </span>
+          </div>
+          <div style={{
+            width: '100%',
+            height: '6px',
+            background: '#1a1a1a',
+            borderRadius: '3px',
+            overflow: 'hidden',
+          }}>
+            <div style={{
+              width: `${scanProgress}%`,
+              height: '100%',
+              background: 'linear-gradient(90deg, var(--green), #00cc6a)',
+              borderRadius: '3px',
+              boxShadow: '0 0 8px rgba(0, 255, 136, 0.4)',
+            }} />
+          </div>
+        </div>
+      )}
+    </header>
+  );
+}

frontend/src/components/JarvisOrb.jsx

@@ -0,0 +1,110 @@
+import OppyFace from './OppyFace';
+
+const phaseStyles = {
+  LOADING: {
+    background: 'radial-gradient(circle, rgba(66,133,244,0.2) 0%, transparent 70%)',
+    boxShadow: '0 0 40px rgba(66,133,244,0.1)',
+    animation: 'breathe 4s ease-in-out infinite',
+    opacity: 0.4,
+  },
+  IDLE: {
+    background: 'radial-gradient(circle, rgba(66,133,244,0.35) 0%, rgba(161,66,244,0.15) 50%, transparent 70%)',
+    boxShadow: '0 0 50px rgba(66,133,244,0.2), 0 0 100px rgba(161,66,244,0.08)',
+    animation: 'breathe 3s ease-in-out infinite',
+    opacity: 0.75,
+  },
+  LISTENING: {
+    background: 'radial-gradient(circle, rgba(66,133,244,0.5) 0%, rgba(161,66,244,0.25) 50%, transparent 70%)',
+    boxShadow: '0 0 60px rgba(66,133,244,0.35), 0 0 120px rgba(161,66,244,0.12)',
+    animation: 'listenPulse 1.5s ease-in-out infinite',
+    opacity: 1,
+  },
+  THINKING: {
+    background: 'radial-gradient(circle, rgba(161,66,244,0.5) 0%, rgba(244,57,160,0.25) 50%, transparent 70%)',
+    boxShadow: '0 0 60px rgba(161,66,244,0.35), 0 0 120px rgba(244,57,160,0.12)',
+    animation: 'thinkSpin 2s linear infinite',
+    opacity: 0.9,
+  },
+  SPEAKING: {
+    background: 'radial-gradient(circle, rgba(66,133,244,0.55) 0%, rgba(161,66,244,0.35) 40%, rgba(244,57,160,0.15) 70%, transparent 80%)',
+    boxShadow: '0 0 70px rgba(66,133,244,0.3), 0 0 130px rgba(161,66,244,0.15)',
+    animation: 'speakPulse 0.8s ease-in-out infinite',
+    opacity: 1,
+  },
+};
+
+export default function JarvisOrb({ phase, onClick, isLoading }) {
+  const style = phaseStyles[phase] || phaseStyles.LOADING;
+
+  return (
+    <div
+      onClick={onClick}
+      style={{
+        position: 'relative',
+        width: '180px',
+        height: '180px',
+        cursor: phase === 'IDLE' || phase === 'LOADING' ? 'pointer' : 'default',
+      }}
+    >
+      {/* Loading ring */}
+      {isLoading && (
+        <svg
+          viewBox="0 0 200 200"
+          style={{
+            position: 'absolute', inset: '-10px', width: '200px', height: '200px',
+            animation: 'orbSpin 1.8s linear infinite',
+          }}
+        >
+          <circle cx="100" cy="100" r="94" fill="none" stroke="rgba(66,133,244,0.1)" strokeWidth="2" />
+          <circle
+            cx="100" cy="100" r="94" fill="none" stroke="url(#geminiGrad)"
+            strokeWidth="2.5" strokeLinecap="round" strokeDasharray="140 460"
+          />
+          <defs>
+            <linearGradient id="geminiGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+              <stop offset="0%" stopColor="#4285f4" stopOpacity="0" />
+              <stop offset="40%" stopColor="#4285f4" stopOpacity="1" />
+              <stop offset="70%" stopColor="#a142f4" stopOpacity="1" />
+              <stop offset="100%" stopColor="#f439a0" stopOpacity="0.3" />
+            </linearGradient>
+          </defs>
+        </svg>
+      )}
+
+      {/* Ripple rings for LISTENING */}
+      {phase === 'LISTENING' && (
+        <>
+          <div style={{
+            position: 'absolute', inset: '-20px', borderRadius: '50%',
+            border: '1px solid rgba(66,133,244,0.3)',
+            animation: 'ripple 2s ease-out infinite',
+          }} />
+          <div style={{
+            position: 'absolute', inset: '-20px', borderRadius: '50%',
+            border: '1px solid rgba(161,66,244,0.2)',
+            animation: 'ripple 2s ease-out infinite 0.6s',
+          }} />
+        </>
+      )}
+
+      {/* Glow background */}
+      <div style={{
+        width: '100%', height: '100%', borderRadius: '50%',
+        transition: 'opacity 0.5s',
+        ...style,
+      }} />
+
+      {/* Oppy face SVG — centered, fills the orb */}
+      <div style={{
+        position: 'absolute',
+        top: '50%',
+        left: '50%',
+        transform: 'translate(-50%, -50%)',
+        width: '140px',
+        height: '140px',
+      }}>
+        <OppyFace phase={phase} size={140} />
+      </div>
+    </div>
+  );
+}

frontend/src/components/OppyFace.jsx

@@ -0,0 +1,162 @@
+import { useState, useEffect, useRef, useCallback } from 'react';
+
+// 4-pointed star path centered at (0,0), size ~1 unit
+const STAR_PATH = 'M 0 -1 C 0.12 -0.12, 0.12 -0.12, 1 0 C 0.12 0.12, 0.12 0.12, 0 1 C -0.12 0.12, -0.12 0.12, -1 0 C -0.12 -0.12, -0.12 -0.12, 0 -1 Z';
+
+// Smile mouth: a crescent arc
+const SMILE_PATH = 'M -12 0 C -8 10, 8 10, 12 0 C 8 4, -8 4, -12 0 Z';
+
+// Open mouth: rounder, taller
+const OPEN_PATH = 'M -10 -4 C -8 12, 8 12, 10 -4 C 6 6, -6 6, -10 -4 Z';
+
+export default function OppyFace({ phase, size = 180 }) {
+  const svgRef = useRef(null);
+
+  // --- Eye tracking ---
+  const [eyeOffset, setEyeOffset] = useState({ x: 0, y: 0 });
+
+  const handleMouseMove = useCallback((e) => {
+    if (!svgRef.current) return;
+    const rect = svgRef.current.getBoundingClientRect();
+    const cx = rect.left + rect.width / 2;
+    const cy = rect.top + rect.height / 2;
+    const dx = e.clientX - cx;
+    const dy = e.clientY - cy;
+    const dist = Math.sqrt(dx * dx + dy * dy);
+    const max = 5;
+    const factor = Math.min(dist / 300, 1);
+    setEyeOffset({
+      x: (dx / (dist || 1)) * max * factor,
+      y: (dy / (dist || 1)) * max * factor,
+    });
+  }, []);
+
+  useEffect(() => {
+    document.addEventListener('mousemove', handleMouseMove);
+    return () => document.removeEventListener('mousemove', handleMouseMove);
+  }, [handleMouseMove]);
+
+  // --- Blink ---
+  const [blinkScale, setBlinkScale] = useState(1);
+
+  useEffect(() => {
+    if (phase !== 'IDLE' && phase !== 'LISTENING') return;
+    let timer;
+    const doBlink = () => {
+      setBlinkScale(0.05);
+      setTimeout(() => setBlinkScale(1), 120);
+      timer = setTimeout(doBlink, 2500 + Math.random() * 4000);
+    };
+    timer = setTimeout(doBlink, 2000 + Math.random() * 3000);
+    return () => clearTimeout(timer);
+  }, [phase]);
+
+  // --- Speaking mouth toggle ---
+  const [mouthOpen, setMouthOpen] = useState(false);
+
+  useEffect(() => {
+    if (phase !== 'SPEAKING') {
+      setMouthOpen(false);
+      return;
+    }
+    const interval = setInterval(() => {
+      setMouthOpen(prev => !prev);
+    }, 200 + Math.random() * 150);
+    return () => clearInterval(interval);
+  }, [phase]);
+
+  // --- Thinking: eyes spin ---
+  const thinkRotate = phase === 'THINKING';
+
+  const mouthPath = mouthOpen ? OPEN_PATH : SMILE_PATH;
+
+  return (
+    <svg
+      ref={svgRef}
+      viewBox="0 0 100 100"
+      width={size}
+      height={size}
+      style={{ overflow: 'visible' }}
+    >
+      <defs>
+        {/* Gemini star gradient */}
+        <radialGradient id="starGrad" cx="50%" cy="50%" r="60%" fx="35%" fy="30%">
+          <stop offset="0%" stopColor="#4285f4" />
+          <stop offset="30%" stopColor="#4285f4" />
+          <stop offset="50%" stopColor="#34a853" />
+          <stop offset="70%" stopColor="#fbbc04" />
+          <stop offset="90%" stopColor="#ea4335" />
+        </radialGradient>
+
+        {/* Mouth gradient */}
+        <linearGradient id="mouthGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+          <stop offset="0%" stopColor="#fbbc04" />
+          <stop offset="50%" stopColor="#34a853" />
+          <stop offset="100%" stopColor="#4285f4" />
+        </linearGradient>
+      </defs>
+
+      {/* Left eye (star) */}
+      <g
+        transform={`translate(${34 + eyeOffset.x}, ${38 + eyeOffset.y})`}
+        style={{
+          transition: 'transform 0.12s ease-out',
+        }}
+      >
+        <g
+          transform={`scale(14, ${14 * blinkScale})`}
+          style={{
+            transition: 'transform 0.08s ease-in-out',
+            transformOrigin: '0 0',
+          }}
+        >
+          <g style={{
+            animation: thinkRotate ? 'eyeSpin 1.5s linear infinite' : 'none',
+            transformOrigin: '0 0',
+          }}>
+            <path d={STAR_PATH} fill="url(#starGrad)" />
+          </g>
+        </g>
+      </g>
+
+      {/* Right eye (star) */}
+      <g
+        transform={`translate(${66 + eyeOffset.x}, ${38 + eyeOffset.y})`}
+        style={{
+          transition: 'transform 0.12s ease-out',
+        }}
+      >
+        <g
+          transform={`scale(14, ${14 * blinkScale})`}
+          style={{
+            transition: 'transform 0.08s ease-in-out',
+            transformOrigin: '0 0',
+          }}
+        >
+          <g style={{
+            animation: thinkRotate ? 'eyeSpin 1.5s linear infinite reverse' : 'none',
+            transformOrigin: '0 0',
+          }}>
+            <path d={STAR_PATH} fill="url(#starGrad)" />
+          </g>
+        </g>
+      </g>
+
+      {/* Mouth */}
+      <g
+        transform="translate(50, 65)"
+        style={{
+          transition: 'transform 0.15s ease-in-out',
+        }}
+      >
+        <path
+          d={mouthPath}
+          fill="url(#mouthGrad)"
+          style={{
+            transition: 'd 0.12s ease-in-out',
+          }}
+        />
+      </g>
+    </svg>
+  );
+}

frontend/src/components/ProjectCard.jsx

@@ -0,0 +1,229 @@
+import { useState } from 'react';
+
+const BACKEND_URL = import.meta.env.VITE_BACKEND_URL || (import.meta.env.DEV ? 'http://localhost:8000' : '');
+
+const STATUS_CONFIG = {
+  STANDBY: { label: 'STANDBY', bg: '#f1f3f4', color: '#5f6368' },
+  READY: { label: 'READY', bg: 'rgba(52,168,83,0.1)', color: '#1e8e3e' },
+  URGENT: { label: 'URGENT', bg: 'rgba(234,67,53,0.1)', color: '#d93025' },
+  SIGNAL: { label: 'SIGNAL', bg: 'rgba(251,188,4,0.1)', color: '#e37400' },
+};
+
+function formatDate(dateStr) {
+  if (!dateStr) return '';
+  const d = new Date(dateStr);
+  return d.toLocaleDateString('fr-FR', { day: 'numeric', month: 'short' });
+}
+
+function formatTime(timeStr) {
+  if (!timeStr) return '';
+  const d = new Date(timeStr);
+  return d.toLocaleString('fr-FR', { day: 'numeric', month: 'short', hour: '2-digit', minute: '2-digit' });
+}
+
+export default function ProjectCard({ project, status, alerts }) {
+  const st = STATUS_CONFIG[status] || STATUS_CONFIG.STANDBY;
+  const [expanded, setExpanded] = useState(false);
+  const [sources, setSources] = useState(null);
+  const [loading, setLoading] = useState(false);
+
+  const handleClick = async () => {
+    if (expanded) { setExpanded(false); return; }
+    if (!sources) {
+      setLoading(true);
+      try {
+        const res = await fetch(`${BACKEND_URL}/api/project/${project.id}/sources`);
+        setSources(await res.json());
+      } catch (err) { console.error(err); }
+      finally { setLoading(false); }
+    }
+    setExpanded(true);
+  };
+
+  return (
+    <div
+      onClick={handleClick}
+      style={{
+        background: '#ffffff',
+        border: '1px solid #e0e0e0',
+        borderLeft: `4px solid ${project.color}`,
+        borderRadius: '12px',
+        padding: '16px 20px',
+        flex: '1 1 280px',
+        minWidth: '0',
+        maxWidth: '100%',
+        cursor: 'pointer',
+        transition: 'box-shadow 0.2s',
+        overflow: 'hidden',
+        wordBreak: 'break-word',
+      }}
+      onMouseEnter={(e) => e.currentTarget.style.boxShadow = '0 2px 8px rgba(0,0,0,0.08)'}
+      onMouseLeave={(e) => e.currentTarget.style.boxShadow = 'none'}
+    >
+      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: '10px' }}>
+        <span style={{ fontSize: '11px', color: '#5f6368', letterSpacing: '1px', fontWeight: 500 }}>
+          PROJET
+        </span>
+        <span style={{
+          fontSize: '11px', fontWeight: 600, padding: '3px 10px',
+          background: st.bg, color: st.color, borderRadius: '10px',
+          animation: status === 'URGENT' ? 'pulse 1.5s infinite' : 'none',
+        }}>
+          {st.label}
+        </span>
+      </div>
+
+      <h3 style={{ fontSize: '15px', color: '#1f1f1f', marginBottom: '6px', fontWeight: 600 }}>
+        {project.name}
+      </h3>
+
+      {project.contact && (
+        <p style={{ fontSize: '12px', color: '#5f6368', marginBottom: '10px' }}>{project.contact}</p>
+      )}
+
+      {alerts && alerts.length > 0 && (
+        <ul style={{ listStyle: 'none', padding: 0 }}>
+          {alerts.map((alert, i) => (
+            <li key={i} style={{
+              fontSize: '12px', color: st.color, padding: '5px 0',
+              borderTop: '1px solid #f1f3f4',
+            }}>
+              {alert}
+            </li>
+          ))}
+        </ul>
+      )}
+
+      {!expanded && (
+        <div style={{ fontSize: '11px', color: '#9aa0a6', marginTop: '8px', textAlign: 'center' }}>
+          Cliquer pour voir les sources
+        </div>
+      )}
+
+      {loading && (
+        <div style={{ fontSize: '12px', color: '#5f6368', marginTop: '10px', fontStyle: 'italic' }}>
+          Chargement...
+        </div>
+      )}
+
+      {expanded && sources && (
+        <div onClick={(e) => e.stopPropagation()} style={{
+          marginTop: '14px', borderTop: '1px solid #e0e0e0', paddingTop: '14px',
+          animation: 'fadeIn 0.3s ease-out',
+        }}>
+          {/* Emails */}
+          {sources.emails && sources.emails.length > 0 && (
+            <div style={{ marginBottom: '16px' }}>
+              <div style={{ fontSize: '11px', color: project.color, letterSpacing: '1px', marginBottom: '8px', fontWeight: 600 }}>
+                EMAILS
+              </div>
+              {sources.emails.map((email, i) => (
+                <div key={i} style={{
+                  padding: '10px 12px', background: '#f8f9fa', borderRadius: '8px',
+                  marginBottom: '6px', fontSize: '13px',
+                }}>
+                  <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: '4px' }}>
+                    <span style={{ color: '#1f1f1f', fontWeight: 600, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', flex: 1, minWidth: 0 }}>{email.subject}</span>
+                    <span style={{
+                      fontSize: '11px',
+                      color: email.days_since_reply >= 5 ? '#d93025' : '#5f6368',
+                      fontWeight: email.days_since_reply >= 5 ? 600 : 400,
+                    }}>
+                      {email.days_since_reply != null ? `${email.days_since_reply}j` : ''}
+                    </span>
+                  </div>
+                  <div style={{ color: '#5f6368', fontSize: '12px', marginBottom: '6px' }}>
+                    De : {email.from} &middot; {formatDate(email.date)}
+                  </div>
+                  <div style={{ color: '#3c4043', fontSize: '12px', lineHeight: '1.5', marginBottom: '8px' }}>
+                    {email.body}
+                  </div>
+                  <div style={{ display: 'flex', gap: '8px' }}>
+                    <a
+                      href={`mailto:${email.from}?subject=Re: ${email.subject}`}
+                      style={{
+                        fontSize: '11px', color: '#4285f4', textDecoration: 'none',
+                        padding: '4px 10px', border: '1px solid #4285f4',
+                        borderRadius: '14px', fontWeight: 500,
+                      }}
+                    >
+                      Repondre
+                    </a>
+                    <a
+                      href={`https://mail.google.com/mail/u/0/#search/from:${email.from}+subject:${encodeURIComponent(email.subject)}`}
+                      target="_blank" rel="noopener noreferrer"
+                      style={{
+                        fontSize: '11px', color: '#5f6368', textDecoration: 'none',
+                        padding: '4px 10px', border: '1px solid #e0e0e0',
+                        borderRadius: '14px',
+                      }}
+                    >
+                      Ouvrir dans Gmail
+                    </a>
+                  </div>
+                </div>
+              ))}
+            </div>
+          )}
+
+          {/* Events */}
+          {sources.events && sources.events.length > 0 && (
+            <div style={{ marginBottom: '16px' }}>
+              <div style={{ fontSize: '11px', color: project.color, letterSpacing: '1px', marginBottom: '8px', fontWeight: 600 }}>
+                CALENDRIER
+              </div>
+              {sources.events.map((event, i) => (
+                <div key={i} style={{
+                  padding: '10px 12px', background: '#f8f9fa', borderRadius: '8px',
+                  marginBottom: '6px', fontSize: '13px',
+                  display: 'flex', justifyContent: 'space-between', alignItems: 'center',
+                }}>
+                  <div>
+                    <div style={{ color: '#1f1f1f', fontWeight: 600 }}>{event.title}</div>
+                    <div style={{ color: '#5f6368', fontSize: '12px', marginTop: '2px' }}>
+                      {formatTime(event.time)}
+                      {event.prep_block
+                        ? <span style={{ color: '#1e8e3e', marginLeft: '8px', fontWeight: 500 }}>Prep OK</span>
+                        : <span style={{ color: '#d93025', marginLeft: '8px', fontWeight: 500 }}>Pas de prep</span>
+                      }
+                    </div>
+                  </div>
+                  <a
+                    href={`https://calendar.google.com/calendar/r/search?q=${encodeURIComponent(event.title)}`}
+                    target="_blank" rel="noopener noreferrer"
+                    style={{
+                      fontSize: '11px', color: '#4285f4', textDecoration: 'none',
+                      padding: '4px 10px', border: '1px solid #4285f4',
+                      borderRadius: '14px', fontWeight: 500, flexShrink: 0,
+                    }}
+                  >
+                    Ouvrir l'agenda
+                  </a>
+                </div>
+              ))}
+            </div>
+          )}
+
+          {/* Web signal */}
+          {sources.search && (
+            <div>
+              <div style={{ fontSize: '11px', color: project.color, letterSpacing: '1px', marginBottom: '8px', fontWeight: 600 }}>
+                SIGNAL EXTERNE
+              </div>
+              <div style={{
+                padding: '10px 12px', background: '#f8f9fa', borderRadius: '8px',
+                fontSize: '12px', color: '#3c4043', lineHeight: '1.5',
+              }}>
+                {sources.search}
+              </div>
+            </div>
+          )}
+
+          <div style={{ fontSize: '11px', color: '#9aa0a6', marginTop: '12px', textAlign: 'center' }}>
+            Cliquer pour fermer
+          </div>
+        </div>
+      )}
+    </div>
+  );
+}

frontend/src/components/ProjectCardsDrawer.jsx

@@ -0,0 +1,66 @@
+import { useState } from 'react';
+import ProjectCard from './ProjectCard';
+
+export default function ProjectCardsDrawer({ projects, statuses }) {
+  const [open, setOpen] = useState(false);
+
+  return (
+    <div style={{
+      position: 'fixed',
+      bottom: 0,
+      left: 0,
+      right: 0,
+      zIndex: 20,
+    }}>
+      {/* Handle bar */}
+      <div
+        onClick={() => setOpen(!open)}
+        style={{
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          gap: '10px',
+          padding: '10px',
+          background: '#ffffff',
+          borderTop: '1px solid #e0e0e0',
+          cursor: 'pointer',
+        }}
+      >
+        <span style={{
+          fontSize: '13px',
+          color: '#1f1f1f',
+          fontWeight: 500,
+        }}>
+          {open ? 'Fermer les projets' : `${projects.length} projets`}
+        </span>
+        <span style={{ fontSize: '10px', color: '#5f6368' }}>
+          {open ? '\u25BC' : '\u25B2'}
+        </span>
+      </div>
+
+      {/* Drawer content */}
+      {open && (
+        <div style={{
+          background: '#f8f9fa',
+          borderTop: '1px solid #e0e0e0',
+          padding: '16px 24px',
+          display: 'flex',
+          flexWrap: 'wrap',
+          gap: '12px',
+          maxHeight: '55vh',
+          overflowY: 'auto',
+          animation: 'fadeIn 0.2s ease-out',
+        }}>
+          {projects.map(project => (
+            <ProjectCard
+              key={project.id}
+              project={project}
+              status={statuses[project.id]?.status || 'STANDBY'}
+              alerts={statuses[project.id]?.alerts || []}
+            />
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}

frontend/src/components/ToolFeed.jsx

@@ -0,0 +1,86 @@
+const STATUS_ICONS = {
+  running: '\u25CF',
+  done: '\u2713',
+  waiting: '\u25CB',
+};
+
+const PROJECT_COLORS = {
+  school: '#00FF88',
+  company: '#FF4444',
+  startup: '#FF8800',
+};
+
+export default function ToolFeed({ toolCalls }) {
+  if (!toolCalls || toolCalls.length === 0) {
+    return (
+      <div style={{
+        background: 'var(--card-bg)',
+        padding: '20px',
+        borderTop: '1px solid var(--border)',
+      }}>
+        <h4 style={{ fontSize: '11px', color: 'var(--text-dim)', letterSpacing: '2px', marginBottom: '8px' }}>
+          TOOL FEED
+        </h4>
+        <p style={{ fontSize: '12px', color: 'var(--text-dim)' }}>
+          En attente du scan...
+        </p>
+      </div>
+    );
+  }
+
+  return (
+    <div style={{
+      background: 'var(--card-bg)',
+      padding: '20px',
+      borderTop: '1px solid var(--border)',
+      maxHeight: '220px',
+      overflowY: 'auto',
+    }}>
+      <h4 style={{ fontSize: '11px', color: 'var(--text-dim)', letterSpacing: '2px', marginBottom: '12px' }}>
+        TOOL FEED
+      </h4>
+      {toolCalls.map((tc, i) => (
+        <div
+          key={i}
+          style={{
+            display: 'flex',
+            alignItems: 'center',
+            gap: '12px',
+            padding: '6px 0',
+            fontSize: '13px',
+            animation: 'slideIn 0.3s ease-out',
+            animationDelay: `${i * 0.1}s`,
+            animationFillMode: 'both',
+          }}
+        >
+          <span style={{
+            color: tc.status === 'done' ? '#00FF88' : tc.status === 'running' ? '#FF8800' : '#666',
+            minWidth: '14px',
+          }}>
+            {STATUS_ICONS[tc.status] || STATUS_ICONS.waiting}
+          </span>
+          <span style={{ color: '#fff', minWidth: '180px', fontSize: '12px' }}>
+            {tc.tool}(<span style={{ color: PROJECT_COLORS[tc.project] || '#888' }}>{tc.project}</span>)
+          </span>
+          <div style={{
+            flex: 1,
+            height: '4px',
+            background: '#222',
+            borderRadius: '2px',
+            overflow: 'hidden',
+          }}>
+            <div style={{
+              width: tc.status === 'done' ? '100%' : tc.status === 'running' ? '60%' : '0%',
+              height: '100%',
+              background: PROJECT_COLORS[tc.project] || 'var(--green)',
+              transition: 'width 0.5s ease',
+            }} />
+          </div>
+          <span style={{ fontSize: '11px', color: 'var(--text-dim)', minWidth: '40px', textAlign: 'right' }}>
+            {tc.status === 'done' ? 'done' : tc.status === 'running' ? '...' : 'wait'}
+          </span>
+        </div>
+      ))}
+    </div>
+  );
+}

frontend/src/components/VoiceControl.jsx

@@ -0,0 +1,350 @@
+import { useState, useRef, useEffect } from 'react';
+
+const BACKEND_URL = import.meta.env.VITE_BACKEND_URL || (import.meta.env.DEV ? 'http://localhost:8000' : '');
+
+export default function VoiceControl({ onReply, chatMessages, visible }) {
+  const [isListening, setIsListening] = useState(false);
+  const [transcript, setTranscript] = useState('');
+  const [inputText, setInputText] = useState('');
+  const [isThinking, setIsThinking] = useState(false);
+  const [isSpeaking, setIsSpeaking] = useState(false);
+  const recognitionRef = useRef(null);
+  const audioRef = useRef(null);
+  const chatEndRef = useRef(null);
+  const inputRef = useRef(null);
+  const hasSpeechAPI = !!(window.SpeechRecognition || window.webkitSpeechRecognition);
+
+  // Scroll to bottom when new messages arrive
+  useEffect(() => {
+    chatEndRef.current?.scrollIntoView({ behavior: 'smooth' });
+  }, [chatMessages, isThinking]);
+
+  // Focus input when panel becomes visible
+  useEffect(() => {
+    if (visible) {
+      setTimeout(() => inputRef.current?.focus(), 300);
+    }
+  }, [visible]);
+
+  // Setup speech recognition
+  useEffect(() => {
+    const SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
+    if (!SpeechRecognition) return;
+
+    const recognition = new SpeechRecognition();
+    recognition.lang = 'fr-FR';
+    recognition.continuous = false;
+    recognition.interimResults = true;
+
+    recognition.onresult = (event) => {
+      let interim = '';
+      let final = '';
+      for (let i = 0; i < event.results.length; i++) {
+        if (event.results[i].isFinal) {
+          final += event.results[i][0].transcript;
+        } else {
+          interim += event.results[i][0].transcript;
+        }
+      }
+      const text = final || interim;
+      setTranscript(text);
+      setInputText(text);
+    };
+
+    recognition.onend = () => {
+      setIsListening(false);
+    };
+
+    recognition.onerror = (event) => {
+      console.error('STT error:', event.error);
+      setIsListening(false);
+    };
+
+    recognitionRef.current = recognition;
+  }, []);
+
+  // Auto-send when recognition ends with a final transcript
+  const pendingSendRef = useRef(false);
+  useEffect(() => {
+    if (!isListening && pendingSendRef.current && transcript.trim() && !isThinking) {
+      pendingSendRef.current = false;
+      sendMessage(transcript.trim());
+    }
+  }, [isListening]);
+
+  const toggleMic = () => {
+    if (isListening) {
+      pendingSendRef.current = true;
+      recognitionRef.current?.stop();
+      return;
+    }
+    setTranscript('');
+    setInputText('');
+    pendingSendRef.current = true;
+    recognitionRef.current?.start();
+    setIsListening(true);
+  };
+
+  const handleSubmit = (e) => {
+    e.preventDefault();
+    const text = inputText.trim();
+    if (!text || isThinking) return;
+    sendMessage(text);
+  };
+
+  const sendMessage = async (text) => {
+    setIsThinking(true);
+    setInputText('');
+    setTranscript('');
+    onReply?.({ role: 'user', text });
+
+    try {
+      const res = await fetch(`${BACKEND_URL}/api/chat`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ message: text }),
+      });
+
+      // Read SSE stream for chat reply
+      const reader = res.body.getReader();
+      const decoder = new TextDecoder();
+      let replyText = '';
+      let buffer = '';
+
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || '';
+
+        for (const line of lines) {
+          if (line.startsWith('data:') || line.startsWith('data: ')) {
+            try {
+              const jsonStr = line.replace(/^data:\s*/, '');
+              const data = JSON.parse(jsonStr);
+              if (data.type === 'chat_reply') {
+                replyText = data.text;
+              }
+            } catch { /* skip non-JSON lines */ }
+          }
+        }
+      }
+
+      if (replyText) {
+        onReply?.({ role: 'assistant', text: replyText });
+        await speakReply(replyText);
+      }
+    } catch (err) {
+      console.error('Chat error:', err);
+      onReply?.({ role: 'assistant', text: 'Erreur de connexion. Reessaie.' });
+    } finally {
+      setIsThinking(false);
+    }
+  };
+
+  const speakReply = async (text) => {
+    try {
+      setIsSpeaking(true);
+      const res = await fetch(`${BACKEND_URL}/api/tts`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ text }),
+      });
+      if (!res.ok) { setIsSpeaking(false); return; }
+
+      const blob = await res.blob();
+      const url = URL.createObjectURL(blob);
+      const audio = new Audio(url);
+      audioRef.current = audio;
+
+      audio.onended = () => {
+        setIsSpeaking(false);
+        URL.revokeObjectURL(url);
+      };
+      await audio.play();
+    } catch (err) {
+      console.error('TTS error:', err);
+      setIsSpeaking(false);
+    }
+  };
+
+  if (!visible) return null;
+
+  return (
+    <div style={{
+      background: 'var(--card-bg)',
+      borderTop: '2px solid var(--green)',
+      marginTop: '8px',
+      animation: 'fadeIn 0.4s ease-out',
+    }}>
+      {/* Header */}
+      <div style={{
+        padding: '16px 24px 0',
+        display: 'flex',
+        alignItems: 'center',
+        gap: '8px',
+      }}>
+        <span style={{ color: 'var(--green)', fontSize: '14px' }}>&#9654;</span>
+        <h4 style={{
+          fontSize: '11px',
+          color: 'var(--green)',
+          letterSpacing: '2px',
+          margin: 0,
+        }}>
+          CONVERSATION AVEC OPERATOR
+        </h4>
+        {isSpeaking && (
+          <span style={{
+            fontSize: '10px',
+            color: '#6666ff',
+            letterSpacing: '1px',
+            marginLeft: 'auto',
+            animation: 'pulse 1s infinite',
+          }}>
+            PARLE...
+          </span>
+        )}
+      </div>
+
+      {/* Chat messages */}
+      <div style={{
+        maxHeight: '300px',
+        overflowY: 'auto',
+        padding: '12px 24px',
+        display: 'flex',
+        flexDirection: 'column',
+        gap: '10px',
+      }}>
+        {(!chatMessages || chatMessages.length === 0) && !isThinking && (
+          <p style={{
+            fontSize: '13px',
+            color: 'var(--text-dim)',
+            fontStyle: 'italic',
+            margin: '8px 0',
+          }}>
+            Dis-moi par quoi tu veux commencer, ou pose-moi une question sur tes projets.
+          </p>
+        )}
+
+        {chatMessages && chatMessages.map((msg, i) => (
+          <div key={i} style={{
+            padding: '10px 14px',
+            borderRadius: '4px',
+            fontSize: '13px',
+            lineHeight: '1.6',
+            whiteSpace: 'pre-wrap',
+            background: msg.role === 'user' ? '#1a2a1a' : '#1a1a2a',
+            borderLeft: `3px solid ${msg.role === 'user' ? 'var(--green)' : '#6666ff'}`,
+            color: '#e0e0e0',
+            animation: 'slideIn 0.3s ease-out',
+          }}>
+            <span style={{
+              fontSize: '10px',
+              color: msg.role === 'user' ? 'var(--green)' : '#6666ff',
+              letterSpacing: '1px',
+              fontWeight: 700,
+              display: 'block',
+              marginBottom: '4px',
+            }}>
+              {msg.role === 'user' ? 'TOI' : 'OPERATOR'}
+            </span>
+            {msg.text}
+          </div>
+        ))}
+
+        {isThinking && (
+          <div style={{
+            padding: '10px 14px',
+            fontSize: '13px',
+            color: '#6666ff',
+            fontStyle: 'italic',
+            animation: 'pulse 1.5s infinite',
+          }}>
+            Operator reflechit...
+          </div>
+        )}
+
+        <div ref={chatEndRef} />
+      </div>
+
+      {/* Input bar */}
+      <form
+        onSubmit={handleSubmit}
+        style={{
+          display: 'flex',
+          alignItems: 'center',
+          gap: '10px',
+          padding: '12px 24px 16px',
+          borderTop: '1px solid var(--border)',
+        }}
+      >
+        {hasSpeechAPI && (
+          <button
+            type="button"
+            onClick={toggleMic}
+            disabled={isThinking || isSpeaking}
+            style={{
+              width: '40px',
+              height: '40px',
+              borderRadius: '50%',
+              border: `2px solid ${isListening ? 'var(--red)' : '#444'}`,
+              background: isListening ? 'rgba(255, 68, 68, 0.15)' : 'transparent',
+              color: isListening ? 'var(--red)' : '#888',
+              fontSize: '16px',
+              cursor: isThinking || isSpeaking ? 'not-allowed' : 'pointer',
+              transition: 'all 0.2s',
+              opacity: isThinking || isSpeaking ? 0.4 : 1,
+              animation: isListening ? 'pulse 1s infinite' : 'none',
+              flexShrink: 0,
+            }}
+          >
+            {'\uD83C\uDF99'}
+          </button>
+        )}
+
+        <input
+          ref={inputRef}
+          type="text"
+          value={inputText}
+          onChange={(e) => setInputText(e.target.value)}
+          disabled={isThinking || isSpeaking}
+          placeholder={isListening ? 'Ecoute en cours...' : 'Ecris ta question ou parle...'}
+          style={{
+            flex: 1,
+            background: '#1a1a1a',
+            border: '1px solid #333',
+            borderRadius: '4px',
+            padding: '10px 14px',
+            color: '#e0e0e0',
+            fontFamily: 'inherit',
+            fontSize: '13px',
+            outline: 'none',
+          }}
+        />
+
+        <button
+          type="submit"
+          disabled={!inputText.trim() || isThinking || isSpeaking}
+          style={{
+            background: inputText.trim() && !isThinking ? 'var(--green)' : '#333',
+            color: '#0a0a0a',
+            border: 'none',
+            borderRadius: '4px',
+            padding: '10px 18px',
+            fontFamily: 'inherit',
+            fontSize: '12px',
+            fontWeight: 700,
+            letterSpacing: '1px',
+            cursor: !inputText.trim() || isThinking ? 'not-allowed' : 'pointer',
+            transition: 'all 0.2s',
+            flexShrink: 0,
+          }}
+        >
+          ENVOYER
+        </button>
+      </form>
+    </div>
+  );
+}

frontend/src/hooks/useGoogleAuth.js

@@ -0,0 +1,46 @@
+import { useState, useEffect, useCallback } from 'react';
+
+const BACKEND_URL = import.meta.env.VITE_BACKEND_URL || 'http://localhost:8000';
+
+export default function useGoogleAuth() {
+  const [authenticated, setAuthenticated] = useState(false);
+  const [oauthAvailable, setOauthAvailable] = useState(false);
+  const [loading, setLoading] = useState(true);
+
+  const checkStatus = useCallback(async () => {
+    try {
+      const res = await fetch(`${BACKEND_URL}/api/auth/status`);
+      const data = await res.json();
+      setAuthenticated(data.authenticated);
+      setOauthAvailable(data.oauth_available);
+    } catch {
+      setAuthenticated(false);
+      setOauthAvailable(false);
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    checkStatus();
+
+    // Check if we just came back from OAuth callback
+    const params = new URLSearchParams(window.location.search);
+    if (params.get('auth') === 'success') {
+      // Clean URL and recheck
+      window.history.replaceState({}, '', window.location.pathname);
+      checkStatus();
+    }
+  }, [checkStatus]);
+
+  const login = useCallback(() => {
+    window.location.href = `${BACKEND_URL}/api/auth/login`;
+  }, []);
+
+  const logout = useCallback(async () => {
+    await fetch(`${BACKEND_URL}/api/auth/logout`);
+    setAuthenticated(false);
+  }, []);
+
+  return { authenticated, oauthAvailable, loading, login, logout };
+}

frontend/src/hooks/useOperatorSSE.js

@@ -0,0 +1,95 @@
+import { useState, useCallback } from 'react';
+
+const BACKEND_URL = import.meta.env.VITE_BACKEND_URL || (import.meta.env.DEV ? 'http://localhost:8000' : '');
+
+export default function useOperatorSSE() {
+  const [toolCalls, setToolCalls] = useState([]);
+  const [projectStatuses, setProjectStatuses] = useState({});
+  const [briefText, setBriefText] = useState(null);
+  const [isScanning, setIsScanning] = useState(false);
+  const [isLive, setIsLive] = useState(false);
+
+  const startScan = useCallback(() => {
+    setToolCalls([]);
+    setProjectStatuses({});
+    setBriefText(null);
+    setIsScanning(true);
+    setIsLive(false);
+
+    const source = new EventSource(`${BACKEND_URL}/api/run`);
+
+    source.addEventListener('mode', (e) => {
+      const data = JSON.parse(e.data);
+      setIsLive(data.live);
+    });
+
+    source.addEventListener('tool_call', (e) => {
+      const data = JSON.parse(e.data);
+      setToolCalls(prev => [...prev, { tool: data.tool, project: data.project, status: 'running' }]);
+    });
+
+    source.addEventListener('tool_result', (e) => {
+      const data = JSON.parse(e.data);
+      setToolCalls(prev => {
+        const updated = [...prev];
+        const idx = updated.findLastIndex(t => t.tool === data.tool && t.project === data.project);
+        if (idx >= 0) updated[idx] = { ...updated[idx], status: 'done' };
+        return updated;
+      });
+    });
+
+    source.addEventListener('initiative', (e) => {
+      const data = JSON.parse(e.data);
+      setProjectStatuses(prev => ({ ...prev, [data.project]: data }));
+    });
+
+    source.addEventListener('brief', (e) => {
+      const data = JSON.parse(e.data);
+      setBriefText(data.text);
+      setIsScanning(false);
+      source.close();
+    });
+
+    source.onerror = () => {
+      setIsScanning(false);
+      source.close();
+    };
+  }, []);
+
+  const sendChat = useCallback(async (message) => {
+    const res = await fetch(`${BACKEND_URL}/api/chat`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ message }),
+    });
+
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let replyText = '';
+    let buffer = '';
+
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+
+      const lines = buffer.split('\n');
+      buffer = lines.pop() || '';
+
+      for (const line of lines) {
+        if (line.startsWith('data:') || line.startsWith('data: ')) {
+          try {
+            const data = JSON.parse(line.replace(/^data:\s*/, ''));
+            if (data.type === 'chat_reply') {
+              replyText = data.text;
+            }
+          } catch { /* skip */ }
+        }
+      }
+    }
+
+    return replyText;
+  }, []);
+
+  return { toolCalls, projectStatuses, briefText, isScanning, isLive, startScan, sendChat };
+}

frontend/src/hooks/useSpeechRecognition.js

@@ -0,0 +1,121 @@
+import { useState, useRef, useEffect, useCallback } from 'react';
+
+export default function useSpeechRecognition({ enabled, onResult, onTimeout, timeoutMs = 15000 }) {
+  const [transcript, setTranscript] = useState('');
+  const recognitionRef = useRef(null);
+  const timeoutRef = useRef(null);
+  const enabledRef = useRef(enabled);
+  const busyRef = useRef(false); // prevent double-fire of onResult
+  enabledRef.current = enabled;
+
+  const cleanup = useCallback(() => {
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = null;
+    }
+    if (recognitionRef.current) {
+      try { recognitionRef.current.abort(); } catch {}
+      try { recognitionRef.current.stop(); } catch {}
+      recognitionRef.current = null;
+    }
+  }, []);
+
+  const start = useCallback(() => {
+    const SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
+    if (!SpeechRecognition || !enabledRef.current) return;
+
+    // Full cleanup before starting fresh
+    cleanup();
+    busyRef.current = false;
+    setTranscript('');
+
+    const recognition = new SpeechRecognition();
+    recognition.lang = 'fr-FR';
+    recognition.continuous = false;
+    recognition.interimResults = true;
+
+    let finalText = '';
+
+    recognition.onresult = (event) => {
+      // Reset timeout on every result
+      if (timeoutRef.current) {
+        clearTimeout(timeoutRef.current);
+        timeoutRef.current = null;
+      }
+
+      let interim = '';
+      finalText = '';
+      for (let i = 0; i < event.results.length; i++) {
+        if (event.results[i].isFinal) {
+          finalText += event.results[i][0].transcript;
+        } else {
+          interim += event.results[i][0].transcript;
+        }
+      }
+      setTranscript(finalText || interim);
+    };
+
+    recognition.onend = () => {
+      recognitionRef.current = null;
+      if (timeoutRef.current) {
+        clearTimeout(timeoutRef.current);
+        timeoutRef.current = null;
+      }
+
+      const text = finalText.trim();
+      if (text && !busyRef.current) {
+        busyRef.current = true;
+        onResult(text);
+        // Don't restart — the phase will change and re-enable us later
+      } else if (enabledRef.current && !busyRef.current) {
+        // No speech — restart after a pause
+        setTimeout(() => {
+          if (enabledRef.current) start();
+        }, 500);
+      }
+    };
+
+    recognition.onerror = (event) => {
+      recognitionRef.current = null;
+      if (event.error === 'no-speech' || event.error === 'aborted') {
+        if (enabledRef.current && !busyRef.current) {
+          setTimeout(() => {
+            if (enabledRef.current) start();
+          }, 500);
+        }
+      }
+    };
+
+    recognitionRef.current = recognition;
+
+    // Silence timeout
+    timeoutRef.current = setTimeout(() => {
+      cleanup();
+      onTimeout?.();
+    }, timeoutMs);
+
+    try {
+      recognition.start();
+    } catch {
+      recognitionRef.current = null;
+    }
+  }, [cleanup, onResult, onTimeout, timeoutMs]);
+
+  useEffect(() => {
+    if (enabled) {
+      // Delay start to let browser release previous mic session
+      const timer = setTimeout(() => start(), 300);
+      return () => {
+        clearTimeout(timer);
+        cleanup();
+        busyRef.current = false;
+      };
+    } else {
+      cleanup();
+      busyRef.current = false;
+      setTranscript('');
+    }
+  }, [enabled, start, cleanup]);
+
+  return { transcript };
+}

frontend/src/hooks/useTTS.js

@@ -0,0 +1,56 @@
+import { useState, useRef, useCallback } from 'react';
+
+const BACKEND_URL = import.meta.env.VITE_BACKEND_URL || (import.meta.env.DEV ? 'http://localhost:8000' : '');
+
+export default function useTTS() {
+  const [isSpeaking, setIsSpeaking] = useState(false);
+  const audioRef = useRef(null);
+
+  const speak = useCallback(async (text) => {
+    if (!text) return;
+    setIsSpeaking(true);
+    try {
+      const res = await fetch(`${BACKEND_URL}/api/tts`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ text }),
+      });
+      if (!res.ok) throw new Error('TTS failed');
+
+      const blob = await res.blob();
+      const url = URL.createObjectURL(blob);
+      const audio = new Audio(url);
+      audioRef.current = audio;
+
+      return new Promise((resolve) => {
+        audio.onended = () => {
+          setIsSpeaking(false);
+          URL.revokeObjectURL(url);
+          resolve();
+        };
+        audio.onerror = () => {
+          setIsSpeaking(false);
+          URL.revokeObjectURL(url);
+          resolve();
+        };
+        audio.play().catch(() => {
+          setIsSpeaking(false);
+          resolve();
+        });
+      });
+    } catch (err) {
+      console.error('TTS error:', err);
+      setIsSpeaking(false);
+    }
+  }, []);
+
+  const stop = useCallback(() => {
+    if (audioRef.current) {
+      audioRef.current.pause();
+      audioRef.current.currentTime = 0;
+    }
+    setIsSpeaking(false);
+  }, []);
+
+  return { speak, stop, isSpeaking };
+}

frontend/src/hooks/useWakeWord.js

@@ -0,0 +1,109 @@
+import { useEffect, useRef, useState, useCallback } from 'react';
+
+// Very broad matching — French STT transcribes "Oppy" in many unexpected ways
+function matchesWakeWord(transcript) {
+  const t = transcript.toLowerCase().replace(/[.,!?'"\-]/g, ' ').trim();
+  return /opp?[iey]|au?pp?[iey]|oh? p[iey]|au pi|o[bp]+ ?[iey]|hop[iey]|op[iey]|hey op|ok op|aux? pi/.test(t);
+}
+
+export default function useWakeWord({ enabled, onDetected }) {
+  const recognitionRef = useRef(null);
+  const isRunningRef = useRef(false);
+  const enabledRef = useRef(enabled);
+  const [micActive, setMicActive] = useState(false);
+  const [micError, setMicError] = useState(false);
+  enabledRef.current = enabled;
+
+  const startListening = useCallback(() => {
+    const SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
+    if (!SpeechRecognition || !enabledRef.current || isRunningRef.current) return;
+
+    const recognition = new SpeechRecognition();
+    recognition.lang = 'fr-FR';
+    recognition.continuous = true;
+    recognition.interimResults = true;
+
+    recognition.onstart = () => {
+      setMicActive(true);
+      setMicError(false);
+    };
+
+    recognition.onresult = (event) => {
+      for (let i = event.resultIndex; i < event.results.length; i++) {
+        const transcript = event.results[i][0].transcript;
+        if (matchesWakeWord(transcript)) {
+          recognition.stop();
+          isRunningRef.current = false;
+          setMicActive(false);
+          onDetected();
+          return;
+        }
+      }
+    };
+
+    recognition.onend = () => {
+      isRunningRef.current = false;
+      setMicActive(false);
+      // Only restart if still enabled AND this recognition instance is still current
+      if (enabledRef.current && recognitionRef.current === recognition) {
+        setTimeout(() => {
+          if (enabledRef.current) startListening();
+        }, 300);
+      }
+    };
+
+    recognition.onerror = (event) => {
+      isRunningRef.current = false;
+      setMicActive(false);
+      if (event.error === 'not-allowed') {
+        setMicError(true);
+        return;
+      }
+      if (enabledRef.current) {
+        setTimeout(() => startListening(), 500);
+      }
+    };
+
+    recognitionRef.current = recognition;
+    isRunningRef.current = true;
+    try {
+      recognition.start();
+    } catch {
+      isRunningRef.current = false;
+      setMicActive(false);
+    }
+  }, [onDetected]);
+
+  // Manual trigger — needed because browsers block auto-start without user gesture
+  const requestMic = useCallback(() => {
+    if (!isRunningRef.current) {
+      setMicError(false);
+      startListening();
+    }
+  }, [startListening]);
+
+  useEffect(() => {
+    if (enabled) {
+      // Try auto-start (works if mic was already granted)
+      startListening();
+    } else {
+      if (recognitionRef.current) {
+        try { recognitionRef.current.abort(); } catch {}
+        try { recognitionRef.current.stop(); } catch {}
+        recognitionRef.current = null;
+        isRunningRef.current = false;
+      }
+      setMicActive(false);
+    }
+    return () => {
+      if (recognitionRef.current) {
+        try { recognitionRef.current.abort(); } catch {}
+        try { recognitionRef.current.stop(); } catch {}
+        recognitionRef.current = null;
+        isRunningRef.current = false;
+      }
+    };
+  }, [enabled, startListening]);
+
+  return { micActive, micError, requestMic };
+}

frontend/src/index.css

@@ -0,0 +1,128 @@
+@import url('https://fonts.googleapis.com/css2?family=Google+Sans:wght@400;500;700&family=Google+Sans+Text:wght@400;500&display=swap');
+
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  background: #ffffff;
+  color: #1f1f1f;
+  font-family: 'Google Sans', 'Segoe UI', Roboto, sans-serif;
+  min-height: 100vh;
+}
+
+:root {
+  /* Gemini palette */
+  --gemini-blue: #4285f4;
+  --gemini-purple: #a142f4;
+  --gemini-pink: #f439a0;
+  --gemini-cyan: #24c1e0;
+  --gemini-red: #ea4335;
+  --gemini-yellow: #fbbc04;
+  --gemini-green: #34a853;
+
+  /* UI tokens — light theme */
+  --bg: #ffffff;
+  --card-bg: #f8f9fa;
+  --surface: #f1f3f4;
+  --border: #e0e0e0;
+  --text: #1f1f1f;
+  --text-dim: #5f6368;
+  --text-faint: #9aa0a6;
+
+  /* Legacy aliases */
+  --green: var(--gemini-green);
+  --red: var(--gemini-red);
+  --orange: var(--gemini-yellow);
+}
+
+@keyframes pulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.5; }
+}
+
+@keyframes slideIn {
+  from { transform: translateX(-20px); opacity: 0; }
+  to { transform: translateX(0); opacity: 1; }
+}
+
+@keyframes fadeIn {
+  from { opacity: 0; }
+  to { opacity: 1; }
+}
+
+@keyframes fadeInUp {
+  from { opacity: 0; transform: translateY(10px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+/* Orb animations */
+@keyframes breathe {
+  0%, 100% { transform: scale(1); }
+  50% { transform: scale(1.06); }
+}
+
+@keyframes listenPulse {
+  0%, 100% { transform: scale(1); }
+  50% { transform: scale(1.08); }
+}
+
+@keyframes ripple {
+  0% { transform: scale(1); opacity: 0.5; }
+  100% { transform: scale(2.2); opacity: 0; }
+}
+
+@keyframes thinkSpin {
+  0% { filter: hue-rotate(0deg); transform: scale(1); }
+  50% { filter: hue-rotate(60deg); transform: scale(1.04); }
+  100% { filter: hue-rotate(0deg); transform: scale(1); }
+}
+
+@keyframes orbSpin {
+  0% { transform: rotate(0deg); }
+  100% { transform: rotate(360deg); }
+}
+
+@keyframes speakPulse {
+  0%, 100% { transform: scaleY(1) scaleX(1); }
+  30% { transform: scaleY(1.08) scaleX(0.97); }
+  70% { transform: scaleY(0.95) scaleX(1.04); }
+}
+
+@keyframes geminiGradient {
+  0% { background-position: 0% 50%; }
+  50% { background-position: 100% 50%; }
+  100% { background-position: 0% 50%; }
+}
+
+/* Avatar animations */
+@keyframes blink {
+  0% { transform: scaleY(0); }
+  50% { transform: scaleY(1); }
+  100% { transform: scaleY(0); }
+}
+
+@keyframes eyeSpin {
+  0% { transform: rotate(0deg); }
+  100% { transform: rotate(360deg); }
+}
+
+@keyframes mouthBar {
+  0% { height: 20%; }
+  100% { height: 90%; }
+}
+
+::-webkit-scrollbar {
+  width: 6px;
+}
+
+::-webkit-scrollbar-track {
+  background: #ffffff;
+}
+
+::-webkit-scrollbar-thumb {
+  background: #dadce0;
+  border-radius: 3px;
+}

frontend/src/main.jsx

@@ -0,0 +1,10 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+import './index.css';
+
+ReactDOM.createRoot(document.getElementById('root')).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);

frontend/vite.config.js

@@ -0,0 +1,10 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    host: '0.0.0.0',
+    port: 5173,
+  },
+});

replit.nix

@@ -0,0 +1,7 @@
+{ pkgs }: {
+  deps = [
+    pkgs.python313
+    pkgs.nodejs_20
+    pkgs.bashInteractive
+  ];
+}

start.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+set -e
+
+# Install Python deps
+cd backend
+pip install -q -r requirements.txt 2>/dev/null
+
+# Build frontend
+cd ../frontend
+npm install --silent 2>/dev/null
+npx vite build --outDir ../backend/static 2>/dev/null
+echo "Frontend built."
+
+# Start backend (serves API + static frontend)
+cd ../backend
+exec uvicorn main:app --host 0.0.0.0 --port 8000