From db1b9c2dcc9763cd5bd54ad7891d811860c10762 Mon Sep 17 00:00:00 2001
From: "railway-app[bot]" <68434857+railway-app[bot]@users.noreply.github.com>
Date: Fri, 3 Apr 2026 17:10:42 +0000
Subject: [PATCH 01/12] fix: upgrade Levenshtein to >=0.26.0 for Python 3.13
 compatibility

---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 76214ed75..f17411596 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -14,7 +14,7 @@ langchain-ollama==0.1.3
 langchain-openai==0.1.17
 langchain-text-splitters==0.2.2
 langsmith==0.1.93
-Levenshtein==0.25.1
+Levenshtein>=0.26.0
 loguru==0.7.2
 openai==1.37.1
 pdfminer.six==20221105

From 8d781681f26df3fe0ad3b47b116adc4610bda6cf Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Apr 2026 17:51:19 +0000
Subject: [PATCH 02/12] feat: add web UI with FastAPI, async doc generation,
 WebSocket progress, and Railway deployment

Agent-Logs-Url: https://github.com/emirsaffar-collab/Jobs_Applier_AI_Agent_AIHawk/sessions/fb01ed93-4579-4ff1-9531-a9dc19bca942

Co-authored-by: emirsaffar-collab <79217569+emirsaffar-collab@users.noreply.github.com>
---
 Dockerfile          |   30 ++
 Procfile            |    1 +
 config.py           |   17 +-
 main.py             |   14 +-
 railway.json        |   14 +
 requirements.txt    |    6 +-
 src/web/__init__.py |    0
 src/web/app.py      |  497 +++++++++++++++++++++
 src/web/ui.py       | 1013 +++++++++++++++++++++++++++++++++++++++++++
 9 files changed, 1584 insertions(+), 8 deletions(-)
 create mode 100644 Dockerfile
 create mode 100644 Procfile
 create mode 100644 railway.json
 create mode 100644 src/web/__init__.py
 create mode 100644 src/web/app.py
 create mode 100644 src/web/ui.py

diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 000000000..a89f485e5
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,30 @@
+FROM python:3.11-slim
+
+# Install Chrome for PDF generation (optional, falls back to reportlab)
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    wget \
+    gnupg2 \
+    && wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | apt-key add - \
+    && echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google-chrome.list \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends google-chrome-stable \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Copy requirements first for caching
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY . .
+
+# Create data directories
+RUN mkdir -p data_folder/output log
+
+# Expose port (Railway sets PORT env var)
+EXPOSE 8080
+
+# Run the web server
+CMD ["python", "main.py", "web"]
diff --git a/Procfile b/Procfile
new file mode 100644
index 000000000..af0db04e5
--- /dev/null
+++ b/Procfile
@@ -0,0 +1 @@
+web: python main.py web
diff --git a/config.py b/config.py
index 78d53e0cd..12bf5a48f 100644
--- a/config.py
+++ b/config.py
@@ -1,12 +1,13 @@
 # In this file, you can set the configurations of the app.
 
+import os
 from src.utils.constants import DEBUG, ERROR, LLM_MODEL, OPENAI
 
 #config related to logging must have prefix LOG_
-LOG_LEVEL = 'ERROR'
+LOG_LEVEL = os.environ.get('LOG_LEVEL', 'ERROR')
 LOG_SELENIUM_LEVEL = ERROR
-LOG_TO_FILE = False
-LOG_TO_CONSOLE = False
+LOG_TO_FILE = os.environ.get('LOG_TO_FILE', 'false').lower() == 'true'
+LOG_TO_CONSOLE = os.environ.get('LOG_TO_CONSOLE', 'false').lower() == 'true'
 
 MINIMUM_WAIT_TIME_IN_SECONDS = 60
 
@@ -16,7 +17,11 @@
 JOB_MAX_APPLICATIONS = 5
 JOB_MIN_APPLICATIONS = 1
 
-LLM_MODEL_TYPE = 'openai'
-LLM_MODEL = 'gpt-4o-mini'
+LLM_MODEL_TYPE = os.environ.get('LLM_MODEL_TYPE', 'claude')
+LLM_MODEL = os.environ.get('LLM_MODEL', 'claude-sonnet-4-20250514')
 # Only required for OLLAMA models
-LLM_API_URL = ''
+LLM_API_URL = os.environ.get('LLM_API_URL', '')
+
+# Web server configuration
+WEB_HOST = os.environ.get('WEB_HOST', '0.0.0.0')
+WEB_PORT = int(os.environ.get('PORT', os.environ.get('WEB_PORT', '8080')))
diff --git a/main.py b/main.py
index cb89b6222..a2570fd8f 100644
--- a/main.py
+++ b/main.py
@@ -562,4 +562,16 @@ def main():
 
 
 if __name__ == "__main__":
-    main()
+    import sys
+
+    if len(sys.argv) > 1 and sys.argv[1] == "web":
+        # Web server mode
+        import uvicorn
+        import config as cfg
+        from src.web.app import app
+
+        print(f"Starting AIHawk web server on {cfg.WEB_HOST}:{cfg.WEB_PORT}")
+        uvicorn.run(app, host=cfg.WEB_HOST, port=cfg.WEB_PORT)
+    else:
+        # CLI mode (original behavior)
+        main()
diff --git a/railway.json b/railway.json
new file mode 100644
index 000000000..c582b9ffe
--- /dev/null
+++ b/railway.json
@@ -0,0 +1,14 @@
+{
+  "$schema": "https://railway.app/railway.schema.json",
+  "build": {
+    "builder": "DOCKERFILE",
+    "dockerfilePath": "Dockerfile"
+  },
+  "deploy": {
+    "startCommand": "python main.py web",
+    "healthcheckPath": "/api/health",
+    "healthcheckTimeout": 30,
+    "restartPolicyType": "ON_FAILURE",
+    "restartPolicyMaxRetries": 10
+  }
+}
diff --git a/requirements.txt b/requirements.txt
index f17411596..26c3d9ae5 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -28,4 +28,8 @@ webdriver-manager==4.0.2
 pytest
 pytest-mock
 pytest-cov
-undetected-chromedriver==3.5.5
\ No newline at end of file
+undetected-chromedriver==3.5.5
+fastapi>=0.110.0
+uvicorn[standard]>=0.24.0
+websockets>=12.0
+inquirer
\ No newline at end of file
diff --git a/src/web/__init__.py b/src/web/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/src/web/app.py b/src/web/app.py
new file mode 100644
index 000000000..b77275279
--- /dev/null
+++ b/src/web/app.py
@@ -0,0 +1,497 @@
+"""
+FastAPI web server for AIHawk Resume & Cover Letter Builder.
+Provides a web UI with async document generation and WebSocket progress updates.
+"""
+import asyncio
+import base64
+import hashlib
+import os
+import uuid
+from pathlib import Path
+from typing import Optional
+
+import yaml
+from fastapi import FastAPI, WebSocket, WebSocketDisconnect, HTTPException
+from fastapi.responses import HTMLResponse, Response
+from pydantic import BaseModel
+
+from src.logging import logger
+
+app = FastAPI(title="AIHawk Resume Builder", version="1.0.0")
+
+# In-memory job store for generated documents
+_jobs: dict = {}
+
+
+class GenerateRequest(BaseModel):
+    """Request model for document generation."""
+    action: str  # "resume", "resume_tailored", "cover_letter"
+    resume_yaml: str
+    job_url: Optional[str] = None
+    style: Optional[str] = None
+    llm_api_key: str
+    llm_model_type: str = "claude"
+    llm_model: str = "claude-sonnet-4-20250514"
+
+
+class JobStatus(BaseModel):
+    """Status of a generation job."""
+    job_id: str
+    status: str  # "pending", "running", "completed", "failed"
+    progress: int  # 0-100
+    message: str
+    download_url: Optional[str] = None
+    error: Optional[str] = None
+
+
+# WebSocket connection manager
+class ConnectionManager:
+    """Manages WebSocket connections for real-time progress updates."""
+
+    def __init__(self):
+        self.active_connections: dict[str, list[WebSocket]] = {}
+
+    async def connect(self, websocket: WebSocket, job_id: str):
+        await websocket.accept()
+        if job_id not in self.active_connections:
+            self.active_connections[job_id] = []
+        self.active_connections[job_id].append(websocket)
+
+    def disconnect(self, websocket: WebSocket, job_id: str):
+        if job_id in self.active_connections:
+            self.active_connections[job_id] = [
+                ws for ws in self.active_connections[job_id] if ws != websocket
+            ]
+            if not self.active_connections[job_id]:
+                del self.active_connections[job_id]
+
+    async def send_progress(self, job_id: str, data: dict):
+        if job_id in self.active_connections:
+            disconnected = []
+            for ws in self.active_connections[job_id]:
+                try:
+                    await ws.send_json(data)
+                except Exception:
+                    disconnected.append(ws)
+            for ws in disconnected:
+                self.disconnect(ws, job_id)
+
+
+manager = ConnectionManager()
+
+
+def _get_available_styles() -> dict:
+    """Get available resume styles from the styles directory."""
+    from src.libs.resume_and_cover_builder.style_manager import StyleManager
+    sm = StyleManager()
+    return sm.get_styles()
+
+
+def _validate_resume_yaml(yaml_str: str) -> bool:
+    """Validate that the YAML string is a valid resume."""
+    try:
+        data = yaml.safe_load(yaml_str)
+        if not isinstance(data, dict):
+            return False
+        if "personal_information" not in data:
+            return False
+        return True
+    except yaml.YAMLError:
+        return False
+
+
+async def _run_generation(job_id: str, request: GenerateRequest):
+    """Run document generation in a background thread with progress updates."""
+    import config as cfg
+
+    try:
+        # Update config with user-selected LLM
+        cfg.LLM_MODEL_TYPE = request.llm_model_type
+        cfg.LLM_MODEL = request.llm_model
+
+        _jobs[job_id]["status"] = "running"
+        await manager.send_progress(job_id, {
+            "status": "running", "progress": 5, "message": "Initializing..."
+        })
+
+        # Validate resume YAML
+        if not _validate_resume_yaml(request.resume_yaml):
+            raise ValueError("Invalid resume YAML. Must contain at least 'personal_information' section.")
+
+        await manager.send_progress(job_id, {
+            "status": "running", "progress": 10, "message": "Loading resume data..."
+        })
+
+        # Import here to avoid circular imports
+        from src.libs.resume_and_cover_builder import ResumeFacade, ResumeGenerator, StyleManager
+        from src.resume_schemas.resume import Resume
+
+        # Parse resume
+        resume_object = Resume(request.resume_yaml)
+
+        await manager.send_progress(job_id, {
+            "status": "running", "progress": 15, "message": "Setting up style..."
+        })
+
+        # Setup style
+        style_manager = StyleManager()
+        available_styles = style_manager.get_styles()
+        if request.style and request.style in available_styles:
+            style_manager.set_selected_style(request.style)
+        elif available_styles:
+            # Default to first available style
+            first_style = next(iter(available_styles))
+            style_manager.set_selected_style(first_style)
+        else:
+            raise ValueError("No resume styles available.")
+
+        await manager.send_progress(job_id, {
+            "status": "running", "progress": 20, "message": "Initializing resume generator..."
+        })
+
+        # Setup generator
+        resume_generator = ResumeGenerator()
+        resume_generator.set_resume_object(resume_object)
+
+        output_path = Path("data_folder/output")
+        output_path.mkdir(parents=True, exist_ok=True)
+
+        resume_facade = ResumeFacade(
+            api_key=request.llm_api_key,
+            style_manager=style_manager,
+            resume_generator=resume_generator,
+            resume_object=resume_object,
+            output_path=output_path,
+        )
+
+        if request.action in ("resume_tailored", "cover_letter"):
+            if not request.job_url:
+                raise ValueError("Job URL is required for tailored documents.")
+
+            await manager.send_progress(job_id, {
+                "status": "running", "progress": 25, "message": "Fetching job description..."
+            })
+
+            # Fetch job description using httpx instead of Selenium
+            result_base64 = await asyncio.to_thread(
+                _generate_with_job_url, resume_facade, request
+            )
+        else:
+            await manager.send_progress(job_id, {
+                "status": "running", "progress": 30, "message": "Generating resume with AI..."
+            })
+            result_base64 = await asyncio.to_thread(
+                _generate_base_resume, resume_facade
+            )
+
+        await manager.send_progress(job_id, {
+            "status": "running", "progress": 90, "message": "Finalizing PDF..."
+        })
+
+        # Store result
+        if isinstance(result_base64, tuple):
+            pdf_data = base64.b64decode(result_base64[0])
+        else:
+            pdf_data = base64.b64decode(result_base64)
+
+        _jobs[job_id]["pdf_data"] = pdf_data
+        _jobs[job_id]["status"] = "completed"
+        _jobs[job_id]["progress"] = 100
+
+        filename = _get_filename(request.action, request.job_url)
+        _jobs[job_id]["filename"] = filename
+
+        await manager.send_progress(job_id, {
+            "status": "completed",
+            "progress": 100,
+            "message": "Document generated successfully!",
+            "download_url": f"/api/download/{job_id}",
+        })
+
+    except Exception as e:
+        logger.error(f"Generation failed for job {job_id}: {e}")
+        _jobs[job_id]["status"] = "failed"
+        _jobs[job_id]["error"] = str(e)
+        await manager.send_progress(job_id, {
+            "status": "failed", "progress": 0, "message": f"Error: {e}",
+            "error": str(e),
+        })
+
+
+def _generate_with_job_url(resume_facade: "ResumeFacade", request: GenerateRequest):
+    """Generate a document that requires a job URL (runs in thread)."""
+    import httpx
+    from src.libs.resume_and_cover_builder.llm.llm_job_parser import LLMParser
+    from src.libs.resume_and_cover_builder.config import global_config
+    from src.job import Job
+
+    # Fetch job page HTML using httpx instead of Selenium
+    try:
+        with httpx.Client(follow_redirects=True, timeout=30.0) as client:
+            response = client.get(request.job_url, headers={
+                "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
+            })
+            response.raise_for_status()
+            body_html = response.text
+    except httpx.HTTPError as e:
+        raise RuntimeError(f"Failed to fetch job URL: {e}")
+
+    # Parse job description using LLM
+    llm_parser = LLMParser(openai_api_key=global_config.API_KEY)
+    llm_parser.set_body_html(body_html)
+
+    job = Job()
+    job.role = llm_parser.extract_role()
+    job.company = llm_parser.extract_company_name()
+    job.description = llm_parser.extract_job_description()
+    job.location = llm_parser.extract_location()
+    job.link = request.job_url
+
+    resume_facade.job = job
+    resume_facade.llm_job_parser = llm_parser
+
+    if request.action == "cover_letter":
+        # Generate cover letter HTML
+        style_path = resume_facade.style_manager.get_style_path()
+        if style_path is None:
+            raise ValueError("You must choose a style before generating the PDF.")
+        cover_letter_html = resume_facade.resume_generator.create_cover_letter_job_description(
+            style_path, job.description
+        )
+        return _html_to_pdf_without_selenium(cover_letter_html)
+    else:
+        # Generate tailored resume HTML
+        style_path = resume_facade.style_manager.get_style_path()
+        if style_path is None:
+            raise ValueError("You must choose a style before generating the PDF.")
+        html_resume = resume_facade.resume_generator.create_resume_job_description_text(
+            style_path, job.description
+        )
+        return _html_to_pdf_without_selenium(html_resume)
+
+
+def _generate_base_resume(resume_facade: "ResumeFacade"):
+    """Generate a base resume (runs in thread)."""
+    style_path = resume_facade.style_manager.get_style_path()
+    if style_path is None:
+        raise ValueError("You must choose a style before generating the PDF.")
+    html_resume = resume_facade.resume_generator.create_resume(style_path)
+    return _html_to_pdf_without_selenium(html_resume)
+
+
+def _html_to_pdf_without_selenium(html_content: str) -> str:
+    """
+    Convert HTML to PDF without requiring Selenium/Chrome.
+    Uses reportlab as a fallback, or returns base64-encoded HTML wrapped as PDF.
+    For Railway deployment, we generate a simple PDF from HTML content.
+    """
+    try:
+        # Try using Chrome headless if available (e.g., in Docker)
+        from src.utils.chrome_utils import init_browser, HTML_to_PDF
+        driver = init_browser()
+        try:
+            result = HTML_to_PDF(html_content, driver)
+            return result
+        finally:
+            try:
+                driver.quit()
+            except Exception:
+                pass
+    except Exception:
+        # Fallback: use reportlab to create a basic PDF
+        logger.warning("Chrome not available, using reportlab PDF fallback")
+        return _reportlab_pdf_from_html(html_content)
+
+
+def _reportlab_pdf_from_html(html_content: str) -> str:
+    """Create a PDF from HTML content using reportlab as fallback."""
+    import io
+    import re
+    from reportlab.lib.pagesizes import A4
+    from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
+    from reportlab.lib.units import inch
+    from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer
+
+    buffer = io.BytesIO()
+    doc = SimpleDocTemplate(buffer, pagesize=A4,
+                            topMargin=0.75 * inch, bottomMargin=0.75 * inch,
+                            leftMargin=0.75 * inch, rightMargin=0.75 * inch)
+
+    styles = getSampleStyleSheet()
+    title_style = ParagraphStyle('CustomTitle', parent=styles['Title'], fontSize=16, spaceAfter=12)
+    heading_style = ParagraphStyle('CustomHeading', parent=styles['Heading2'], fontSize=12, spaceAfter=6)
+    body_style = ParagraphStyle('CustomBody', parent=styles['Normal'], fontSize=10, spaceAfter=4)
+
+    story = []
+
+    # Strip HTML tags for simple text extraction
+    text = re.sub(r'<style[^>]*>.*?</style>', '', html_content, flags=re.DOTALL)
+    text = re.sub(r'<script[^>]*>.*?</script>', '', text, flags=re.DOTALL)
+
+    # Extract sections
+    sections = re.split(r'<(?:h[12]|section)[^>]*>', text)
+    for section in sections:
+        # Clean HTML tags
+        clean = re.sub(r'<[^>]+>', ' ', section)
+        clean = re.sub(r'\s+', ' ', clean).strip()
+        if clean:
+            # Check if it looks like a heading
+            if len(clean) < 50 and not clean.endswith('.'):
+                story.append(Paragraph(clean, heading_style))
+                story.append(Spacer(1, 4))
+            else:
+                # Split into paragraphs
+                for para in clean.split('  '):
+                    para = para.strip()
+                    if para:
+                        try:
+                            story.append(Paragraph(para, body_style))
+                        except Exception:
+                            # If reportlab can't parse it, add as plain text
+                            story.append(Paragraph(re.sub(r'[<>&]', '', para), body_style))
+                        story.append(Spacer(1, 2))
+
+    if not story:
+        story.append(Paragraph("Document generated by AIHawk", body_style))
+
+    doc.build(story)
+    pdf_bytes = buffer.getvalue()
+    return base64.b64encode(pdf_bytes).decode("utf-8")
+
+
+def _get_filename(action: str, job_url: Optional[str] = None) -> str:
+    """Generate a filename for the document."""
+    if action == "resume":
+        return "resume_base.pdf"
+    elif action == "resume_tailored":
+        suffix = hashlib.md5(job_url.encode()).hexdigest()[:8] if job_url else "tailored"
+        return f"resume_tailored_{suffix}.pdf"
+    else:
+        suffix = hashlib.md5(job_url.encode()).hexdigest()[:8] if job_url else "cover"
+        return f"cover_letter_{suffix}.pdf"
+
+
+# === API Routes ===
+
+@app.get("/", response_class=HTMLResponse)
+async def index():
+    """Serve the main web UI."""
+    from src.web.ui import get_html
+    return HTMLResponse(content=get_html())
+
+
+@app.get("/api/health")
+async def health():
+    """Health check endpoint."""
+    return {"status": "ok", "version": "1.0.0"}
+
+
+@app.get("/api/styles")
+async def get_styles():
+    """Get available resume styles."""
+    try:
+        styles = _get_available_styles()
+        return {
+            "styles": [
+                {"name": name, "file": file_name, "author": author}
+                for name, (file_name, author) in styles.items()
+            ]
+        }
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"Failed to load styles: {e}")
+
+
+@app.post("/api/generate")
+async def generate_document(request: GenerateRequest):
+    """Start async document generation. Returns a job ID for tracking progress."""
+    # Validate request
+    if request.action not in ("resume", "resume_tailored", "cover_letter"):
+        raise HTTPException(status_code=400, detail="Invalid action. Must be 'resume', 'resume_tailored', or 'cover_letter'.")
+
+    if not request.llm_api_key:
+        raise HTTPException(status_code=400, detail="LLM API key is required.")
+
+    if not request.resume_yaml.strip():
+        raise HTTPException(status_code=400, detail="Resume YAML is required.")
+
+    if request.action in ("resume_tailored", "cover_letter") and not request.job_url:
+        raise HTTPException(status_code=400, detail="Job URL is required for tailored documents.")
+
+    # Create job
+    job_id = str(uuid.uuid4())
+    _jobs[job_id] = {
+        "status": "pending",
+        "progress": 0,
+        "message": "Job queued",
+        "pdf_data": None,
+        "filename": None,
+        "error": None,
+    }
+
+    # Start async generation
+    asyncio.create_task(_run_generation(job_id, request))
+
+    return {"job_id": job_id, "status": "pending", "ws_url": f"/ws/{job_id}"}
+
+
+@app.get("/api/status/{job_id}")
+async def get_status(job_id: str):
+    """Get the status of a generation job."""
+    if job_id not in _jobs:
+        raise HTTPException(status_code=404, detail="Job not found.")
+    job = _jobs[job_id]
+    result = {
+        "job_id": job_id,
+        "status": job["status"],
+        "progress": job.get("progress", 0),
+        "message": job.get("message", ""),
+    }
+    if job["status"] == "completed":
+        result["download_url"] = f"/api/download/{job_id}"
+    if job["status"] == "failed":
+        result["error"] = job.get("error", "Unknown error")
+    return result
+
+
+@app.get("/api/download/{job_id}")
+async def download_document(job_id: str):
+    """Download a generated document."""
+    if job_id not in _jobs:
+        raise HTTPException(status_code=404, detail="Job not found.")
+    job = _jobs[job_id]
+    if job["status"] != "completed":
+        raise HTTPException(status_code=400, detail="Document not ready yet.")
+    if not job.get("pdf_data"):
+        raise HTTPException(status_code=500, detail="PDF data not available.")
+
+    return Response(
+        content=job["pdf_data"],
+        media_type="application/pdf",
+        headers={
+            "Content-Disposition": f'attachment; filename="{job.get("filename", "document.pdf")}"'
+        },
+    )
+
+
+@app.websocket("/ws/{job_id}")
+async def websocket_endpoint(websocket: WebSocket, job_id: str):
+    """WebSocket endpoint for real-time progress updates."""
+    await manager.connect(websocket, job_id)
+    try:
+        # Send current status immediately
+        if job_id in _jobs:
+            job = _jobs[job_id]
+            await websocket.send_json({
+                "status": job["status"],
+                "progress": job.get("progress", 0),
+                "message": job.get("message", ""),
+            })
+
+        # Keep connection alive
+        while True:
+            try:
+                await websocket.receive_text()
+            except WebSocketDisconnect:
+                break
+    finally:
+        manager.disconnect(websocket, job_id)
diff --git a/src/web/ui.py b/src/web/ui.py
new file mode 100644
index 000000000..2e5a526d7
--- /dev/null
+++ b/src/web/ui.py
@@ -0,0 +1,1013 @@
+"""
+Embedded single-page web UI for AIHawk Resume Builder.
+Returns a complete HTML page with inline CSS and JavaScript.
+"""
+
+
+def get_html() -> str:
+    """Return the complete HTML page for the web UI."""
+    return '''<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>AIHawk Resume Builder</title>
+    <style>
+        :root {
+            --primary: #2563eb;
+            --primary-dark: #1d4ed8;
+            --primary-light: #dbeafe;
+            --success: #16a34a;
+            --danger: #dc2626;
+            --warning: #d97706;
+            --gray-50: #f9fafb;
+            --gray-100: #f3f4f6;
+            --gray-200: #e5e7eb;
+            --gray-300: #d1d5db;
+            --gray-400: #9ca3af;
+            --gray-500: #6b7280;
+            --gray-600: #4b5563;
+            --gray-700: #374151;
+            --gray-800: #1f2937;
+            --gray-900: #111827;
+            --radius: 8px;
+            --shadow: 0 1px 3px rgba(0,0,0,0.1), 0 1px 2px rgba(0,0,0,0.06);
+            --shadow-lg: 0 10px 15px -3px rgba(0,0,0,0.1), 0 4px 6px -2px rgba(0,0,0,0.05);
+        }
+
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+            background: var(--gray-50);
+            color: var(--gray-800);
+            line-height: 1.6;
+        }
+
+        /* Header */
+        .header {
+            background: white;
+            border-bottom: 1px solid var(--gray-200);
+            padding: 16px 24px;
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+            box-shadow: var(--shadow);
+            position: sticky;
+            top: 0;
+            z-index: 100;
+        }
+
+        .header h1 {
+            font-size: 20px;
+            font-weight: 700;
+            color: var(--gray-900);
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+
+        .header h1 .icon { font-size: 24px; }
+
+        .header-actions {
+            display: flex;
+            gap: 12px;
+            align-items: center;
+        }
+
+        .badge {
+            padding: 4px 10px;
+            border-radius: 12px;
+            font-size: 12px;
+            font-weight: 600;
+        }
+
+        .badge-success { background: #dcfce7; color: var(--success); }
+        .badge-warning { background: #fef3c7; color: var(--warning); }
+        .badge-danger { background: #fee2e2; color: var(--danger); }
+
+        /* Layout */
+        .container {
+            max-width: 1200px;
+            margin: 0 auto;
+            padding: 24px;
+        }
+
+        .grid {
+            display: grid;
+            grid-template-columns: 1fr 1fr;
+            gap: 24px;
+        }
+
+        @media (max-width: 768px) {
+            .grid { grid-template-columns: 1fr; }
+        }
+
+        /* Cards */
+        .card {
+            background: white;
+            border-radius: var(--radius);
+            border: 1px solid var(--gray-200);
+            box-shadow: var(--shadow);
+            overflow: hidden;
+        }
+
+        .card-header {
+            padding: 16px 20px;
+            border-bottom: 1px solid var(--gray-200);
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+        }
+
+        .card-header h2 {
+            font-size: 16px;
+            font-weight: 600;
+            color: var(--gray-900);
+        }
+
+        .card-body { padding: 20px; }
+
+        /* Forms */
+        .form-group {
+            margin-bottom: 16px;
+        }
+
+        .form-group label {
+            display: block;
+            font-size: 13px;
+            font-weight: 600;
+            color: var(--gray-700);
+            margin-bottom: 6px;
+        }
+
+        .form-group input,
+        .form-group select,
+        .form-group textarea {
+            width: 100%;
+            padding: 10px 12px;
+            border: 1px solid var(--gray-300);
+            border-radius: var(--radius);
+            font-size: 14px;
+            color: var(--gray-800);
+            background: white;
+            transition: border-color 0.2s, box-shadow 0.2s;
+        }
+
+        .form-group input:focus,
+        .form-group select:focus,
+        .form-group textarea:focus {
+            outline: none;
+            border-color: var(--primary);
+            box-shadow: 0 0 0 3px var(--primary-light);
+        }
+
+        .form-group textarea {
+            font-family: 'SF Mono', 'Fira Code', 'Fira Mono', monospace;
+            font-size: 12px;
+            resize: vertical;
+            min-height: 200px;
+        }
+
+        .form-row {
+            display: grid;
+            grid-template-columns: 1fr 1fr;
+            gap: 12px;
+        }
+
+        .form-help {
+            font-size: 12px;
+            color: var(--gray-500);
+            margin-top: 4px;
+        }
+
+        /* Buttons */
+        .btn {
+            display: inline-flex;
+            align-items: center;
+            justify-content: center;
+            gap: 6px;
+            padding: 10px 20px;
+            border-radius: var(--radius);
+            font-size: 14px;
+            font-weight: 600;
+            cursor: pointer;
+            border: none;
+            transition: all 0.2s;
+        }
+
+        .btn:disabled {
+            opacity: 0.6;
+            cursor: not-allowed;
+        }
+
+        .btn-primary {
+            background: var(--primary);
+            color: white;
+        }
+
+        .btn-primary:hover:not(:disabled) {
+            background: var(--primary-dark);
+        }
+
+        .btn-success {
+            background: var(--success);
+            color: white;
+        }
+
+        .btn-outline {
+            background: white;
+            color: var(--gray-700);
+            border: 1px solid var(--gray-300);
+        }
+
+        .btn-outline:hover:not(:disabled) {
+            background: var(--gray-50);
+        }
+
+        .btn-block { width: 100%; }
+
+        .btn-group {
+            display: flex;
+            gap: 8px;
+        }
+
+        /* Tabs */
+        .tabs {
+            display: flex;
+            border-bottom: 2px solid var(--gray-200);
+            margin-bottom: 20px;
+        }
+
+        .tab {
+            padding: 10px 16px;
+            font-size: 14px;
+            font-weight: 500;
+            color: var(--gray-500);
+            cursor: pointer;
+            border-bottom: 2px solid transparent;
+            margin-bottom: -2px;
+            transition: all 0.2s;
+            background: none;
+            border-top: none;
+            border-left: none;
+            border-right: none;
+        }
+
+        .tab:hover { color: var(--gray-700); }
+
+        .tab.active {
+            color: var(--primary);
+            border-bottom-color: var(--primary);
+        }
+
+        /* Progress */
+        .progress-container {
+            padding: 20px;
+            display: none;
+        }
+
+        .progress-container.active { display: block; }
+
+        .progress-bar-track {
+            height: 8px;
+            background: var(--gray-200);
+            border-radius: 4px;
+            overflow: hidden;
+            margin: 12px 0;
+        }
+
+        .progress-bar-fill {
+            height: 100%;
+            background: var(--primary);
+            border-radius: 4px;
+            transition: width 0.5s ease;
+            width: 0%;
+        }
+
+        .progress-bar-fill.success { background: var(--success); }
+        .progress-bar-fill.error { background: var(--danger); }
+
+        .progress-text {
+            font-size: 14px;
+            color: var(--gray-600);
+            text-align: center;
+        }
+
+        .progress-percent {
+            font-size: 24px;
+            font-weight: 700;
+            color: var(--gray-800);
+            text-align: center;
+        }
+
+        /* Status log */
+        .status-log {
+            max-height: 200px;
+            overflow-y: auto;
+            font-size: 13px;
+            font-family: monospace;
+            background: var(--gray-50);
+            border: 1px solid var(--gray-200);
+            border-radius: var(--radius);
+            padding: 12px;
+            margin-top: 12px;
+        }
+
+        .status-entry {
+            padding: 4px 0;
+            border-bottom: 1px solid var(--gray-100);
+        }
+
+        .status-entry:last-child { border-bottom: none; }
+
+        .status-time {
+            color: var(--gray-400);
+            font-size: 11px;
+            margin-right: 8px;
+        }
+
+        /* Alerts */
+        .alert {
+            padding: 12px 16px;
+            border-radius: var(--radius);
+            margin-bottom: 16px;
+            font-size: 14px;
+            display: none;
+        }
+
+        .alert.show { display: block; }
+
+        .alert-error {
+            background: #fee2e2;
+            color: var(--danger);
+            border: 1px solid #fecaca;
+        }
+
+        .alert-success {
+            background: #dcfce7;
+            color: var(--success);
+            border: 1px solid #bbf7d0;
+        }
+
+        .alert-info {
+            background: var(--primary-light);
+            color: var(--primary-dark);
+            border: 1px solid #93c5fd;
+        }
+
+        /* Action cards */
+        .action-cards {
+            display: grid;
+            grid-template-columns: repeat(3, 1fr);
+            gap: 12px;
+            margin-bottom: 20px;
+        }
+
+        @media (max-width: 768px) {
+            .action-cards { grid-template-columns: 1fr; }
+        }
+
+        .action-card {
+            padding: 16px;
+            border: 2px solid var(--gray-200);
+            border-radius: var(--radius);
+            cursor: pointer;
+            transition: all 0.2s;
+            text-align: center;
+        }
+
+        .action-card:hover {
+            border-color: var(--primary);
+            background: var(--primary-light);
+        }
+
+        .action-card.selected {
+            border-color: var(--primary);
+            background: var(--primary-light);
+        }
+
+        .action-card .action-icon {
+            font-size: 28px;
+            margin-bottom: 8px;
+        }
+
+        .action-card .action-title {
+            font-weight: 600;
+            font-size: 14px;
+            color: var(--gray-800);
+        }
+
+        .action-card .action-desc {
+            font-size: 12px;
+            color: var(--gray-500);
+            margin-top: 4px;
+        }
+
+        /* History */
+        .history-item {
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+            padding: 12px 0;
+            border-bottom: 1px solid var(--gray-100);
+        }
+
+        .history-item:last-child { border-bottom: none; }
+
+        .history-info h4 {
+            font-size: 14px;
+            color: var(--gray-800);
+        }
+
+        .history-info p {
+            font-size: 12px;
+            color: var(--gray-500);
+        }
+
+        /* Spinner */
+        .spinner {
+            display: inline-block;
+            width: 16px;
+            height: 16px;
+            border: 2px solid var(--gray-300);
+            border-top-color: var(--primary);
+            border-radius: 50%;
+            animation: spin 0.8s linear infinite;
+        }
+
+        @keyframes spin {
+            to { transform: rotate(360deg); }
+        }
+
+        /* Tooltip */
+        .tooltip {
+            position: relative;
+        }
+
+        .tooltip::after {
+            content: attr(data-tip);
+            position: absolute;
+            bottom: 100%;
+            left: 50%;
+            transform: translateX(-50%);
+            background: var(--gray-800);
+            color: white;
+            padding: 4px 8px;
+            border-radius: 4px;
+            font-size: 12px;
+            white-space: nowrap;
+            opacity: 0;
+            pointer-events: none;
+            transition: opacity 0.2s;
+        }
+
+        .tooltip:hover::after { opacity: 1; }
+
+        /* Full-width section */
+        .full-width {
+            grid-column: 1 / -1;
+        }
+
+        /* Hidden */
+        .hidden { display: none !important; }
+
+        /* Job URL group */
+        #jobUrlGroup { display: none; }
+        #jobUrlGroup.show { display: block; }
+
+        /* Example YAML button */
+        .example-link {
+            font-size: 12px;
+            color: var(--primary);
+            cursor: pointer;
+            text-decoration: underline;
+        }
+
+        .example-link:hover {
+            color: var(--primary-dark);
+        }
+    </style>
+</head>
+<body>
+    <!-- Header -->
+    <div class="header">
+        <h1>
+            <span class="icon">&#128640;</span>
+            AIHawk Resume Builder
+        </h1>
+        <div class="header-actions">
+            <span id="healthBadge" class="badge badge-warning">Checking...</span>
+        </div>
+    </div>
+
+    <div class="container">
+        <!-- Alert area -->
+        <div id="alertArea">
+            <div id="alertBox" class="alert"></div>
+        </div>
+
+        <div class="grid">
+            <!-- Left Column: Configuration -->
+            <div>
+                <!-- API Configuration -->
+                <div class="card" style="margin-bottom: 24px;">
+                    <div class="card-header">
+                        <h2>&#128273; API Configuration</h2>
+                    </div>
+                    <div class="card-body">
+                        <div class="form-row">
+                            <div class="form-group">
+                                <label for="llmProvider">LLM Provider</label>
+                                <select id="llmProvider" onchange="onProviderChange()">
+                                    <option value="claude">Claude (Anthropic)</option>
+                                    <option value="openai">OpenAI</option>
+                                    <option value="gemini">Google Gemini</option>
+                                    <option value="ollama">Ollama (Local)</option>
+                                </select>
+                            </div>
+                            <div class="form-group">
+                                <label for="llmModel">Model</label>
+                                <select id="llmModel">
+                                    <option value="claude-sonnet-4-20250514">Claude Sonnet 4</option>
+                                    <option value="claude-3-5-sonnet-20241022">Claude 3.5 Sonnet</option>
+                                    <option value="claude-3-haiku-20240307">Claude 3 Haiku</option>
+                                </select>
+                            </div>
+                        </div>
+                        <div class="form-group">
+                            <label for="apiKey">API Key</label>
+                            <input type="password" id="apiKey" placeholder="Enter your API key...">
+                            <p class="form-help">Your API key is sent directly to the generation endpoint and is not stored.</p>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Action Selection -->
+                <div class="card" style="margin-bottom: 24px;">
+                    <div class="card-header">
+                        <h2>&#9889; Action</h2>
+                    </div>
+                    <div class="card-body">
+                        <div class="action-cards">
+                            <div class="action-card selected" onclick="selectAction(\'resume\')" id="action-resume">
+                                <div class="action-icon">&#128196;</div>
+                                <div class="action-title">Resume</div>
+                                <div class="action-desc">Generate base resume</div>
+                            </div>
+                            <div class="action-card" onclick="selectAction(\'resume_tailored\')" id="action-resume_tailored">
+                                <div class="action-icon">&#127919;</div>
+                                <div class="action-title">Tailored Resume</div>
+                                <div class="action-desc">Resume for a job</div>
+                            </div>
+                            <div class="action-card" onclick="selectAction(\'cover_letter\')" id="action-cover_letter">
+                                <div class="action-icon">&#9993;</div>
+                                <div class="action-title">Cover Letter</div>
+                                <div class="action-desc">Tailored cover letter</div>
+                            </div>
+                        </div>
+                        <div class="form-group" id="jobUrlGroup">
+                            <label for="jobUrl">Job Posting URL</label>
+                            <input type="url" id="jobUrl" placeholder="https://www.linkedin.com/jobs/view/...">
+                            <p class="form-help">URL of the job posting to tailor your document to.</p>
+                        </div>
+                        <div class="form-group">
+                            <label for="styleSelect">Resume Style</label>
+                            <select id="styleSelect">
+                                <option value="">Loading styles...</option>
+                            </select>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Right Column: Resume Data -->
+            <div>
+                <div class="card" style="margin-bottom: 24px;">
+                    <div class="card-header">
+                        <h2>&#128221; Resume Data (YAML)</h2>
+                        <span class="example-link" onclick="loadExample()">Load Example</span>
+                    </div>
+                    <div class="card-body">
+                        <div class="form-group">
+                            <textarea id="resumeYaml" rows="22" placeholder="Paste your resume YAML here..."></textarea>
+                            <p class="form-help">Paste your resume in YAML format. Click &quot;Load Example&quot; to see the expected structure.</p>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Full width: Generate button and progress -->
+            <div class="full-width">
+                <div class="card">
+                    <div class="card-body">
+                        <button id="generateBtn" class="btn btn-primary btn-block" onclick="startGeneration()">
+                            &#9889; Generate Document
+                        </button>
+
+                        <div id="progressContainer" class="progress-container">
+                            <div class="progress-percent" id="progressPercent">0%</div>
+                            <div class="progress-bar-track">
+                                <div class="progress-bar-fill" id="progressBar"></div>
+                            </div>
+                            <div class="progress-text" id="progressText">Waiting...</div>
+                            <div class="status-log" id="statusLog"></div>
+                        </div>
+
+                        <div id="downloadSection" class="hidden" style="text-align: center; margin-top: 16px;">
+                            <button id="downloadBtn" class="btn btn-success" onclick="downloadDocument()">
+                                &#11015; Download PDF
+                            </button>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <!-- History -->
+            <div class="full-width">
+                <div class="card">
+                    <div class="card-header">
+                        <h2>&#128203; Recent Generations</h2>
+                        <button class="btn btn-outline" onclick="clearHistory()" style="padding: 6px 12px; font-size: 12px;">Clear</button>
+                    </div>
+                    <div class="card-body" id="historyList">
+                        <p style="color: var(--gray-400); text-align: center; padding: 20px;">No documents generated yet.</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <script>
+        // State
+        let currentAction = 'resume';
+        let currentJobId = null;
+        let ws = null;
+        let downloadUrl = null;
+        let history = JSON.parse(localStorage.getItem('aihawk_history') || '[]');
+
+        // Model options per provider
+        const modelOptions = {
+            claude: [
+                { value: 'claude-sonnet-4-20250514', label: 'Claude Sonnet 4' },
+                { value: 'claude-3-5-sonnet-20241022', label: 'Claude 3.5 Sonnet' },
+                { value: 'claude-3-haiku-20240307', label: 'Claude 3 Haiku' },
+            ],
+            openai: [
+                { value: 'gpt-4o-mini', label: 'GPT-4o Mini' },
+                { value: 'gpt-4o', label: 'GPT-4o' },
+                { value: 'gpt-4-turbo', label: 'GPT-4 Turbo' },
+            ],
+            gemini: [
+                { value: 'gemini-pro', label: 'Gemini Pro' },
+                { value: 'gemini-1.5-pro', label: 'Gemini 1.5 Pro' },
+            ],
+            ollama: [
+                { value: 'llama3', label: 'Llama 3' },
+                { value: 'mixtral', label: 'Mixtral' },
+                { value: 'codellama', label: 'Code Llama' },
+            ],
+        };
+
+        // Example YAML
+        const exampleYaml = `personal_information:
+  name: "John"
+  surname: "Doe"
+  date_of_birth: "01/15/1990"
+  country: "United States"
+  city: "San Francisco"
+  address: "123 Tech Street"
+  zip_code: "94105"
+  phone_prefix: "+1"
+  phone: "5551234567"
+  email: "john.doe@email.com"
+  github: "https://github.com/johndoe"
+  linkedin: "https://www.linkedin.com/in/johndoe"
+
+education_details:
+  - education_level: "Master's Degree"
+    institution: "Stanford University"
+    field_of_study: "Computer Science"
+    final_evaluation_grade: "3.9"
+    start_date: "2018"
+    year_of_completion: 2020
+    additional_info:
+      exam:
+        "Machine Learning": "A+"
+        "Distributed Systems": "A"
+        "Algorithms": "A"
+
+experience_details:
+  - position: "Senior Software Engineer"
+    company: "TechCorp Inc."
+    employment_period: "06/2020 - Present"
+    location: "San Francisco, CA"
+    industry: "Technology"
+    key_responsibilities:
+      - responsibility: "Led backend architecture redesign reducing latency by 40%"
+      - responsibility: "Mentored team of 5 junior engineers"
+      - responsibility: "Implemented CI/CD pipeline with 99.9% uptime"
+    skills_acquired:
+      - "Python"
+      - "Kubernetes"
+      - "AWS"
+      - "System Design"
+
+projects:
+  - name: "AI Resume Builder"
+    description: "Open-source tool for generating tailored resumes using LLMs"
+    link: "https://github.com/johndoe/ai-resume"
+
+achievements:
+  - name: "Employee of the Year"
+    description: "Recognized for outstanding technical contributions"
+
+certifications:
+  - name: "AWS Solutions Architect"
+    description: "Professional certification for cloud architecture"
+
+languages:
+  - language: "English"
+    proficiency: "Native"
+  - language: "Spanish"
+    proficiency: "Intermediate"
+
+interests:
+  - "Machine Learning"
+  - "Open Source"
+  - "Cloud Architecture"`;
+
+        // Initialize
+        document.addEventListener('DOMContentLoaded', () => {
+            checkHealth();
+            loadStyles();
+            renderHistory();
+        });
+
+        // Health check
+        async function checkHealth() {
+            const badge = document.getElementById('healthBadge');
+            try {
+                const res = await fetch('/api/health');
+                if (res.ok) {
+                    badge.className = 'badge badge-success';
+                    badge.textContent = 'Connected';
+                } else {
+                    badge.className = 'badge badge-danger';
+                    badge.textContent = 'Error';
+                }
+            } catch {
+                badge.className = 'badge badge-danger';
+                badge.textContent = 'Offline';
+            }
+        }
+
+        // Load styles
+        async function loadStyles() {
+            const select = document.getElementById('styleSelect');
+            try {
+                const res = await fetch('/api/styles');
+                const data = await res.json();
+                select.innerHTML = '';
+                if (data.styles && data.styles.length > 0) {
+                    data.styles.forEach(s => {
+                        const opt = document.createElement('option');
+                        opt.value = s.name;
+                        opt.textContent = `${s.name} (by ${s.author})`;
+                        select.appendChild(opt);
+                    });
+                } else {
+                    select.innerHTML = '<option value="">No styles available</option>';
+                }
+            } catch {
+                select.innerHTML = '<option value="">Failed to load styles</option>';
+            }
+        }
+
+        // Provider change
+        function onProviderChange() {
+            const provider = document.getElementById('llmProvider').value;
+            const modelSelect = document.getElementById('llmModel');
+            const models = modelOptions[provider] || [];
+            modelSelect.innerHTML = '';
+            models.forEach(m => {
+                const opt = document.createElement('option');
+                opt.value = m.value;
+                opt.textContent = m.label;
+                modelSelect.appendChild(opt);
+            });
+        }
+
+        // Action selection
+        function selectAction(action) {
+            currentAction = action;
+            document.querySelectorAll('.action-card').forEach(c => c.classList.remove('selected'));
+            document.getElementById('action-' + action).classList.add('selected');
+            const jobUrlGroup = document.getElementById('jobUrlGroup');
+            if (action === 'resume_tailored' || action === 'cover_letter') {
+                jobUrlGroup.classList.add('show');
+            } else {
+                jobUrlGroup.classList.remove('show');
+            }
+        }
+
+        // Load example
+        function loadExample() {
+            document.getElementById('resumeYaml').value = exampleYaml;
+        }
+
+        // Show alert
+        function showAlert(type, message) {
+            const box = document.getElementById('alertBox');
+            box.className = `alert alert-${type} show`;
+            box.textContent = message;
+            setTimeout(() => { box.classList.remove('show'); }, 5000);
+        }
+
+        // Add status log entry
+        function addStatusLog(message) {
+            const log = document.getElementById('statusLog');
+            const time = new Date().toLocaleTimeString();
+            const entry = document.createElement('div');
+            entry.className = 'status-entry';
+            entry.innerHTML = `<span class="status-time">${time}</span>${message}`;
+            log.appendChild(entry);
+            log.scrollTop = log.scrollHeight;
+        }
+
+        // Start generation
+        async function startGeneration() {
+            const apiKey = document.getElementById('apiKey').value.trim();
+            const resumeYaml = document.getElementById('resumeYaml').value.trim();
+            const jobUrl = document.getElementById('jobUrl').value.trim();
+            const style = document.getElementById('styleSelect').value;
+            const provider = document.getElementById('llmProvider').value;
+            const model = document.getElementById('llmModel').value;
+
+            // Validation
+            if (!apiKey) { showAlert('error', 'Please enter your API key.'); return; }
+            if (!resumeYaml) { showAlert('error', 'Please paste your resume YAML.'); return; }
+            if ((currentAction === 'resume_tailored' || currentAction === 'cover_letter') && !jobUrl) {
+                showAlert('error', 'Please enter a job posting URL for tailored documents.');
+                return;
+            }
+
+            // Reset UI
+            const btn = document.getElementById('generateBtn');
+            btn.disabled = true;
+            btn.innerHTML = '<span class="spinner"></span> Generating...';
+            document.getElementById('downloadSection').classList.add('hidden');
+            document.getElementById('progressContainer').classList.add('active');
+            document.getElementById('progressBar').style.width = '0%';
+            document.getElementById('progressBar').className = 'progress-bar-fill';
+            document.getElementById('progressPercent').textContent = '0%';
+            document.getElementById('progressText').textContent = 'Starting...';
+            document.getElementById('statusLog').innerHTML = '';
+            addStatusLog('Submitting generation request...');
+
+            try {
+                const res = await fetch('/api/generate', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        action: currentAction,
+                        resume_yaml: resumeYaml,
+                        job_url: jobUrl || null,
+                        style: style || null,
+                        llm_api_key: apiKey,
+                        llm_model_type: provider,
+                        llm_model: model,
+                    }),
+                });
+
+                if (!res.ok) {
+                    const err = await res.json();
+                    throw new Error(err.detail || 'Request failed');
+                }
+
+                const data = await res.json();
+                currentJobId = data.job_id;
+                addStatusLog(`Job created: ${currentJobId.substring(0, 8)}...`);
+
+                // Connect WebSocket for progress
+                connectWebSocket(currentJobId);
+
+                // Also poll as fallback
+                pollStatus(currentJobId);
+
+            } catch (err) {
+                showAlert('error', `Failed to start generation: ${err.message}`);
+                btn.disabled = false;
+                btn.innerHTML = '&#9889; Generate Document';
+                document.getElementById('progressContainer').classList.remove('active');
+            }
+        }
+
+        // WebSocket connection
+        function connectWebSocket(jobId) {
+            const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
+            const wsUrl = `${protocol}//${window.location.host}/ws/${jobId}`;
+            try {
+                ws = new WebSocket(wsUrl);
+                ws.onmessage = (event) => {
+                    const data = JSON.parse(event.data);
+                    updateProgress(data);
+                };
+                ws.onerror = () => { /* Fallback to polling */ };
+                ws.onclose = () => { ws = null; };
+            } catch { /* Fallback to polling */ }
+        }
+
+        // Poll status fallback
+        async function pollStatus(jobId) {
+            const interval = setInterval(async () => {
+                try {
+                    const res = await fetch(`/api/status/${jobId}`);
+                    const data = await res.json();
+                    updateProgress(data);
+                    if (data.status === 'completed' || data.status === 'failed') {
+                        clearInterval(interval);
+                    }
+                } catch { /* continue polling */ }
+            }, 2000);
+        }
+
+        // Update progress UI
+        function updateProgress(data) {
+            const bar = document.getElementById('progressBar');
+            const percent = document.getElementById('progressPercent');
+            const text = document.getElementById('progressText');
+            const btn = document.getElementById('generateBtn');
+
+            bar.style.width = `${data.progress || 0}%`;
+            percent.textContent = `${data.progress || 0}%`;
+            text.textContent = data.message || '';
+            addStatusLog(data.message || data.status);
+
+            if (data.status === 'completed') {
+                bar.classList.add('success');
+                btn.disabled = false;
+                btn.innerHTML = '&#9889; Generate Document';
+                downloadUrl = data.download_url;
+                document.getElementById('downloadSection').classList.remove('hidden');
+                showAlert('success', 'Document generated successfully! Click Download to save.');
+                addToHistory(currentAction, downloadUrl);
+                if (ws) { ws.close(); ws = null; }
+            } else if (data.status === 'failed') {
+                bar.classList.add('error');
+                btn.disabled = false;
+                btn.innerHTML = '&#9889; Generate Document';
+                showAlert('error', `Generation failed: ${data.error || data.message}`);
+                if (ws) { ws.close(); ws = null; }
+            }
+        }
+
+        // Download
+        function downloadDocument() {
+            if (downloadUrl) {
+                window.location.href = downloadUrl;
+            }
+        }
+
+        // History
+        function addToHistory(action, url) {
+            const labels = {
+                resume: 'Base Resume',
+                resume_tailored: 'Tailored Resume',
+                cover_letter: 'Cover Letter',
+            };
+            history.unshift({
+                action: labels[action] || action,
+                time: new Date().toLocaleString(),
+                url: url,
+            });
+            if (history.length > 10) history = history.slice(0, 10);
+            localStorage.setItem('aihawk_history', JSON.stringify(history));
+            renderHistory();
+        }
+
+        function renderHistory() {
+            const list = document.getElementById('historyList');
+            if (history.length === 0) {
+                list.innerHTML = '<p style="color: var(--gray-400); text-align: center; padding: 20px;">No documents generated yet.</p>';
+                return;
+            }
+            list.innerHTML = history.map(h => `
+                <div class="history-item">
+                    <div class="history-info">
+                        <h4>${h.action}</h4>
+                        <p>${h.time}</p>
+                    </div>
+                    ${h.url ? `<a href="${h.url}" class="btn btn-outline" style="padding: 6px 12px; font-size: 12px; text-decoration: none;">Download</a>` : ''}
+                </div>
+            `).join('');
+        }
+
+        function clearHistory() {
+            history = [];
+            localStorage.removeItem('aihawk_history');
+            renderHistory();
+        }
+    </script>
+</body>
+</html>'''

From 2ca3b04c5015ba070ed8ef4f4dcabb5c252d1da4 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Apr 2026 17:54:07 +0000
Subject: [PATCH 03/12] fix: make web server work without selenium/openai, fix
 imports for lightweight startup

Agent-Logs-Url: https://github.com/emirsaffar-collab/Jobs_Applier_AI_Agent_AIHawk/sessions/fb01ed93-4579-4ff1-9531-a9dc19bca942

Co-authored-by: emirsaffar-collab <79217569+emirsaffar-collab@users.noreply.github.com>
---
 main.py        | 27 +++++++++++++--------------
 src/logging.py | 11 ++++++++++-
 src/web/app.py | 20 +++++++++++++++++---
 3 files changed, 40 insertions(+), 18 deletions(-)

diff --git a/main.py b/main.py
index a2570fd8f..63c150a13 100644
--- a/main.py
+++ b/main.py
@@ -1,5 +1,16 @@
-import base64
 import sys
+
+# Check for web mode early, before importing CLI-specific dependencies
+if __name__ == "__main__" and len(sys.argv) > 1 and sys.argv[1] == "web":
+    import uvicorn
+    import config as cfg
+    from src.web.app import app
+
+    print(f"Starting AIHawk web server on {cfg.WEB_HOST}:{cfg.WEB_PORT}")
+    uvicorn.run(app, host=cfg.WEB_HOST, port=cfg.WEB_PORT)
+    sys.exit(0)
+
+import base64
 from pathlib import Path
 import traceback
 from typing import List, Optional, Tuple, Dict
@@ -562,16 +573,4 @@ def main():
 
 
 if __name__ == "__main__":
-    import sys
-
-    if len(sys.argv) > 1 and sys.argv[1] == "web":
-        # Web server mode
-        import uvicorn
-        import config as cfg
-        from src.web.app import app
-
-        print(f"Starting AIHawk web server on {cfg.WEB_HOST}:{cfg.WEB_PORT}")
-        uvicorn.run(app, host=cfg.WEB_HOST, port=cfg.WEB_PORT)
-    else:
-        # CLI mode (original behavior)
-        main()
+    main()
diff --git a/src/logging.py b/src/logging.py
index 20b1448c0..d4b84551a 100644
--- a/src/logging.py
+++ b/src/logging.py
@@ -3,7 +3,13 @@
 import sys
 import logging
 from loguru import logger
-from selenium.webdriver.remote.remote_connection import LOGGER as selenium_logger
+
+try:
+    from selenium.webdriver.remote.remote_connection import LOGGER as selenium_logger
+    _has_selenium = True
+except ImportError:
+    selenium_logger = None
+    _has_selenium = False
 
 from config import LOG_LEVEL, LOG_SELENIUM_LEVEL, LOG_TO_CONSOLE, LOG_TO_FILE
 
@@ -54,6 +60,9 @@ def get_log_filename():
 
 def init_selenium_logger():
     """Initialize and configure selenium logger to write to selenium.log."""
+    if not _has_selenium or selenium_logger is None:
+        return
+
     log_file = "log/selenium.log"
     os.makedirs(os.path.dirname(log_file), exist_ok=True)
 
diff --git a/src/web/app.py b/src/web/app.py
index b77275279..a97ae1059 100644
--- a/src/web/app.py
+++ b/src/web/app.py
@@ -82,9 +82,23 @@ async def send_progress(self, job_id: str, data: dict):
 
 def _get_available_styles() -> dict:
     """Get available resume styles from the styles directory."""
-    from src.libs.resume_and_cover_builder.style_manager import StyleManager
-    sm = StyleManager()
-    return sm.get_styles()
+    styles_dir = Path(__file__).resolve().parent.parent / "libs" / "resume_and_cover_builder" / "resume_style"
+    styles = {}
+    if not styles_dir.is_dir():
+        return styles
+    for file_path in styles_dir.iterdir():
+        if file_path.is_file() and file_path.suffix == ".css":
+            try:
+                with file_path.open("r", encoding="utf-8") as f:
+                    first_line = f.readline().strip()
+                    if first_line.startswith("/*") and first_line.endswith("*/"):
+                        content = first_line[2:-2].strip()
+                        if "$" in content:
+                            style_name, author_link = content.split("$", 1)
+                            styles[style_name.strip()] = (file_path.name, author_link.strip())
+            except Exception:
+                continue
+    return styles
 
 
 def _validate_resume_yaml(yaml_str: str) -> bool:

From 8d05fa626d1649729637df2052053cb10a3a8045 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Apr 2026 17:55:34 +0000
Subject: [PATCH 04/12] fix: address CodeQL alert (case-insensitive regex) and
 review feedback

Agent-Logs-Url: https://github.com/emirsaffar-collab/Jobs_Applier_AI_Agent_AIHawk/sessions/fb01ed93-4579-4ff1-9531-a9dc19bca942

Co-authored-by: emirsaffar-collab <79217569+emirsaffar-collab@users.noreply.github.com>
---
 src/web/app.py | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/src/web/app.py b/src/web/app.py
index a97ae1059..1505d82f4 100644
--- a/src/web/app.py
+++ b/src/web/app.py
@@ -338,9 +338,9 @@ def _reportlab_pdf_from_html(html_content: str) -> str:
 
     story = []
 
-    # Strip HTML tags for simple text extraction
-    text = re.sub(r'<style[^>]*>.*?</style>', '', html_content, flags=re.DOTALL)
-    text = re.sub(r'<script[^>]*>.*?</script>', '', text, flags=re.DOTALL)
+    # Strip HTML tags for simple text extraction (case-insensitive for safety)
+    text = re.sub(r'<style[^>]*>.*?</style>', '', html_content, flags=re.DOTALL | re.IGNORECASE)
+    text = re.sub(r'<script[^>]*>.*?</script>', '', text, flags=re.DOTALL | re.IGNORECASE)
 
     # Extract sections
     sections = re.split(r'<(?:h[12]|section)[^>]*>', text)
@@ -360,8 +360,8 @@ def _reportlab_pdf_from_html(html_content: str) -> str:
                     if para:
                         try:
                             story.append(Paragraph(para, body_style))
-                        except Exception:
-                            # If reportlab can't parse it, add as plain text
+                        except (ValueError, AttributeError):
+                            # If reportlab can't parse the markup, sanitize and retry
                             story.append(Paragraph(re.sub(r'[<>&]', '', para), body_style))
                         story.append(Spacer(1, 2))
 
@@ -374,7 +374,10 @@ def _reportlab_pdf_from_html(html_content: str) -> str:
 
 
 def _get_filename(action: str, job_url: Optional[str] = None) -> str:
-    """Generate a filename for the document."""
+    """Generate a filename for the document.
+
+    Note: MD5 is used only for filename uniqueness, not for cryptographic security.
+    """
     if action == "resume":
         return "resume_base.pdf"
     elif action == "resume_tailored":

From c656dcec3b62daf9934c838aa4ddc05207eba7a3 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Apr 2026 17:56:30 +0000
Subject: [PATCH 05/12] fix: handle whitespace in closing script/style tags for
 robust HTML stripping

Agent-Logs-Url: https://github.com/emirsaffar-collab/Jobs_Applier_AI_Agent_AIHawk/sessions/fb01ed93-4579-4ff1-9531-a9dc19bca942

Co-authored-by: emirsaffar-collab <79217569+emirsaffar-collab@users.noreply.github.com>
---
 src/web/app.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/web/app.py b/src/web/app.py
index 1505d82f4..516e9c491 100644
--- a/src/web/app.py
+++ b/src/web/app.py
@@ -339,8 +339,8 @@ def _reportlab_pdf_from_html(html_content: str) -> str:
     story = []
 
     # Strip HTML tags for simple text extraction (case-insensitive for safety)
-    text = re.sub(r'<style[^>]*>.*?</style>', '', html_content, flags=re.DOTALL | re.IGNORECASE)
-    text = re.sub(r'<script[^>]*>.*?</script>', '', text, flags=re.DOTALL | re.IGNORECASE)
+    text = re.sub(r'<style[^>]*>.*?</style\s*>', '', html_content, flags=re.DOTALL | re.IGNORECASE)
+    text = re.sub(r'<script[^>]*>.*?</script\s*>', '', text, flags=re.DOTALL | re.IGNORECASE)
 
     # Extract sections
     sections = re.split(r'<(?:h[12]|section)[^>]*>', text)

From 3ae213aff485371ffee613d5e842de9be99bf5b1 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Apr 2026 18:03:06 +0000
Subject: [PATCH 06/12] fix: add git to Dockerfile for pip git+ dependency
 install

Agent-Logs-Url: https://github.com/emirsaffar-collab/Jobs_Applier_AI_Agent_AIHawk/sessions/b909bbed-135b-4bb6-bc76-150ca0817957

Co-authored-by: emirsaffar-collab <79217569+emirsaffar-collab@users.noreply.github.com>
---
 Dockerfile | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Dockerfile b/Dockerfile
index a89f485e5..7d10aa771 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -2,6 +2,7 @@ FROM python:3.11-slim
 
 # Install Chrome for PDF generation (optional, falls back to reportlab)
 RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
     wget \
     gnupg2 \
     && wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | apt-key add - \

From 8d0fe0a71219c6b357a667350afdf3f99773c04d Mon Sep 17 00:00:00 2001
From: "railway-app[bot]" <68434857+railway-app[bot]@users.noreply.github.com>
Date: Fri, 3 Apr 2026 18:05:54 +0000
Subject: [PATCH 07/12] fix: replace apt-key with gpg keyring for Google Chrome
 repo

---
 Dockerfile | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Dockerfile b/Dockerfile
index 7d10aa771..ffd9ecbbd 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -5,8 +5,8 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     git \
     wget \
     gnupg2 \
-    && wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | apt-key add - \
-    && echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google-chrome.list \
+    && wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | gpg --dearmor -o /usr/share/keyrings/google-chrome.gpg \
+    && echo "deb [arch=amd64 signed-by=/usr/share/keyrings/google-chrome.gpg] http://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google-chrome.list \
     && apt-get update \
     && apt-get install -y --no-install-recommends google-chrome-stable \
     && apt-get clean \

From ddabe9b19fa4363c45a9fb529708609433ced79a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Apr 2026 18:30:36 +0000
Subject: [PATCH 08/12] feat: add work preferences and resume config API
 endpoints to web UI

Add GET/PUT /api/preferences for managing work_preferences.yaml
Add GET/PUT /api/resume for managing plain_text_resume.yaml
Add WorkPreferences Pydantic models with YAML round-trip support
Add validation matching ConfigValidator rules from main.py
Ensure data_folder exists when generating documents

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: emirsaffar-collab <79217569+emirsaffar-collab@users.noreply.github.com>
---
 src/web/app.py | 238 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 238 insertions(+)

diff --git a/src/web/app.py b/src/web/app.py
index 516e9c491..d73d61a66 100644
--- a/src/web/app.py
+++ b/src/web/app.py
@@ -44,6 +44,169 @@ class JobStatus(BaseModel):
     error: Optional[str] = None
 
 
+class ExperienceLevelModel(BaseModel):
+    internship: bool = False
+    entry: bool = True
+    associate: bool = True
+    mid_senior_level: bool = True
+    director: bool = False
+    executive: bool = False
+
+
+class JobTypesModel(BaseModel):
+    full_time: bool = True
+    contract: bool = False
+    part_time: bool = False
+    temporary: bool = True
+    internship: bool = False
+    other: bool = False
+    volunteer: bool = True
+
+
+class DateFiltersModel(BaseModel):
+    all_time: bool = False
+    month: bool = False
+    week: bool = False
+    twenty_four_hours: bool = True
+
+    class Config:
+        populate_by_name = True
+
+    @classmethod
+    def from_yaml_dict(cls, data: dict) -> "DateFiltersModel":
+        return cls(
+            all_time=data.get("all_time", False),
+            month=data.get("month", False),
+            week=data.get("week", False),
+            twenty_four_hours=data.get("24_hours", True),
+        )
+
+    def to_yaml_dict(self) -> dict:
+        return {
+            "all_time": self.all_time,
+            "month": self.month,
+            "week": self.week,
+            "24_hours": self.twenty_four_hours,
+        }
+
+
+class WorkPreferences(BaseModel):
+    remote: bool = True
+    hybrid: bool = True
+    onsite: bool = True
+    experience_level: ExperienceLevelModel = ExperienceLevelModel()
+    job_types: JobTypesModel = JobTypesModel()
+    date: DateFiltersModel = DateFiltersModel()
+    positions: list[str] = ["Software engineer"]
+    locations: list[str] = ["Germany"]
+    apply_once_at_company: bool = True
+    distance: int = 100
+    company_blacklist: list[str] = ["wayfair", "Crossover"]
+    title_blacklist: list[str] = ["word1", "word2"]
+    location_blacklist: list[str] = ["Brazil"]
+
+    @classmethod
+    def from_yaml_dict(cls, data: dict) -> "WorkPreferences":
+        date_data = data.get("date", {})
+        date_model = DateFiltersModel.from_yaml_dict(date_data) if isinstance(date_data, dict) else DateFiltersModel()
+        return cls(
+            remote=data.get("remote", True),
+            hybrid=data.get("hybrid", True),
+            onsite=data.get("onsite", True),
+            experience_level=ExperienceLevelModel(**data["experience_level"]) if "experience_level" in data else ExperienceLevelModel(),
+            job_types=JobTypesModel(**data["job_types"]) if "job_types" in data else JobTypesModel(),
+            date=date_model,
+            positions=data.get("positions", ["Software engineer"]),
+            locations=data.get("locations", ["Germany"]),
+            apply_once_at_company=data.get("apply_once_at_company", True),
+            distance=data.get("distance", 100),
+            company_blacklist=data.get("company_blacklist") or [],
+            title_blacklist=data.get("title_blacklist") or [],
+            location_blacklist=data.get("location_blacklist") or [],
+        )
+
+    def to_yaml_dict(self) -> dict:
+        return {
+            "remote": self.remote,
+            "hybrid": self.hybrid,
+            "onsite": self.onsite,
+            "experience_level": self.experience_level.model_dump(),
+            "job_types": self.job_types.model_dump(),
+            "date": self.date.to_yaml_dict(),
+            "positions": self.positions,
+            "locations": self.locations,
+            "apply_once_at_company": self.apply_once_at_company,
+            "distance": self.distance,
+            "company_blacklist": self.company_blacklist,
+            "title_blacklist": self.title_blacklist,
+            "location_blacklist": self.location_blacklist,
+        }
+
+
+class ResumeUpdate(BaseModel):
+    resume_yaml: str
+
+
+DATA_FOLDER = Path("data_folder")
+WORK_PREFERENCES_PATH = DATA_FOLDER / "work_preferences.yaml"
+PLAIN_TEXT_RESUME_PATH = DATA_FOLDER / "plain_text_resume.yaml"
+
+APPROVED_DISTANCES = {0, 5, 10, 25, 50, 100}
+
+
+def _validate_work_preferences(data: dict) -> list[str]:
+    """Validate work preferences dict using the same rules as ConfigValidator."""
+    errors = []
+
+    # Validate experience levels are booleans
+    exp = data.get("experience_level", {})
+    if not isinstance(exp, dict):
+        errors.append("experience_level must be a dict")
+    else:
+        for level in ["internship", "entry", "associate", "mid_senior_level", "director", "executive"]:
+            if not isinstance(exp.get(level), bool):
+                errors.append(f"Experience level '{level}' must be a boolean")
+
+    # Validate job types are booleans
+    jt = data.get("job_types", {})
+    if not isinstance(jt, dict):
+        errors.append("job_types must be a dict")
+    else:
+        for job_type in ["full_time", "contract", "part_time", "temporary", "internship", "other", "volunteer"]:
+            if not isinstance(jt.get(job_type), bool):
+                errors.append(f"Job type '{job_type}' must be a boolean")
+
+    # Validate date filters are booleans
+    date = data.get("date", {})
+    if not isinstance(date, dict):
+        errors.append("date must be a dict")
+    else:
+        for df in ["all_time", "month", "week", "24_hours"]:
+            if not isinstance(date.get(df), bool):
+                errors.append(f"Date filter '{df}' must be a boolean")
+
+    # Validate positions and locations are lists of strings
+    for key in ["positions", "locations"]:
+        val = data.get(key, [])
+        if not isinstance(val, list) or not all(isinstance(item, str) for item in val):
+            errors.append(f"'{key}' must be a list of strings")
+
+    # Validate distance
+    dist = data.get("distance")
+    if dist not in APPROVED_DISTANCES:
+        errors.append(f"distance must be one of {sorted(APPROVED_DISTANCES)}")
+
+    # Validate blacklists are lists
+    for bl in ["company_blacklist", "title_blacklist", "location_blacklist"]:
+        val = data.get(bl)
+        if val is None:
+            continue
+        if not isinstance(val, list):
+            errors.append(f"'{bl}' must be a list")
+
+    return errors
+
+
 # WebSocket connection manager
 class ConnectionManager:
     """Manages WebSocket connections for real-time progress updates."""
@@ -434,6 +597,9 @@ async def generate_document(request: GenerateRequest):
     if request.action in ("resume_tailored", "cover_letter") and not request.job_url:
         raise HTTPException(status_code=400, detail="Job URL is required for tailored documents.")
 
+    # Ensure data_folder exists for generation artifacts
+    DATA_FOLDER.mkdir(parents=True, exist_ok=True)
+
     # Create job
     job_id = str(uuid.uuid4())
     _jobs[job_id] = {
@@ -490,6 +656,78 @@ async def download_document(job_id: str):
     )
 
 
+@app.get("/api/preferences")
+async def get_preferences():
+    """Load work preferences from data_folder/work_preferences.yaml."""
+    if WORK_PREFERENCES_PATH.exists():
+        try:
+            with open(WORK_PREFERENCES_PATH, "r") as f:
+                data = yaml.safe_load(f)
+            if not isinstance(data, dict):
+                raise HTTPException(status_code=500, detail="Invalid work_preferences.yaml format.")
+            prefs = WorkPreferences.from_yaml_dict(data)
+        except yaml.YAMLError as exc:
+            raise HTTPException(status_code=500, detail=f"Error parsing work_preferences.yaml: {exc}")
+    else:
+        prefs = WorkPreferences()
+    return prefs.to_yaml_dict()
+
+
+@app.put("/api/preferences")
+async def update_preferences(prefs: WorkPreferences):
+    """Save work preferences to data_folder/work_preferences.yaml."""
+    yaml_dict = prefs.to_yaml_dict()
+
+    errors = _validate_work_preferences(yaml_dict)
+    if errors:
+        raise HTTPException(status_code=422, detail=errors)
+
+    DATA_FOLDER.mkdir(parents=True, exist_ok=True)
+    try:
+        with open(WORK_PREFERENCES_PATH, "w") as f:
+            yaml.dump(yaml_dict, f, default_flow_style=False, sort_keys=False)
+    except OSError as exc:
+        raise HTTPException(status_code=500, detail=f"Failed to save preferences: {exc}")
+    return {"status": "ok", "message": "Work preferences saved."}
+
+
+@app.get("/api/resume")
+async def get_resume():
+    """Load plain text resume YAML from data_folder/plain_text_resume.yaml."""
+    if PLAIN_TEXT_RESUME_PATH.exists():
+        try:
+            content = PLAIN_TEXT_RESUME_PATH.read_text(encoding="utf-8")
+        except OSError as exc:
+            raise HTTPException(status_code=500, detail=f"Error reading resume file: {exc}")
+    else:
+        example_path = Path("data_folder_example") / "plain_text_resume.yaml"
+        if example_path.exists():
+            content = example_path.read_text(encoding="utf-8")
+        else:
+            content = "personal_information:\n  name: \"\"\n  surname: \"\"\n"
+    return {"resume_yaml": content}
+
+
+@app.put("/api/resume")
+async def update_resume(body: ResumeUpdate):
+    """Save plain text resume YAML to data_folder/plain_text_resume.yaml."""
+    if not body.resume_yaml.strip():
+        raise HTTPException(status_code=400, detail="Resume YAML content cannot be empty.")
+
+    if not _validate_resume_yaml(body.resume_yaml):
+        raise HTTPException(
+            status_code=422,
+            detail="Invalid resume YAML. Must be valid YAML with a 'personal_information' section.",
+        )
+
+    DATA_FOLDER.mkdir(parents=True, exist_ok=True)
+    try:
+        PLAIN_TEXT_RESUME_PATH.write_text(body.resume_yaml, encoding="utf-8")
+    except OSError as exc:
+        raise HTTPException(status_code=500, detail=f"Failed to save resume: {exc}")
+    return {"status": "ok", "message": "Resume saved."}
+
+
 @app.websocket("/ws/{job_id}")
 async def websocket_endpoint(websocket: WebSocket, job_id: str):
     """WebSocket endpoint for real-time progress updates."""

From 32c92f6b091e047c1a22469fac0a7b2d2a16a6c3 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Apr 2026 18:51:26 +0000
Subject: [PATCH 09/12] feat: add tabbed UI with Resume and Settings panels

Rewrite the web UI to use a 3-tab interface:
- Generate tab: existing LLM config, action selection, progress tracking
- Resume tab: YAML editor with load/save to server via /api/resume
- Settings tab: work preferences form with all fields from
  work_preferences.yaml, including checkboxes, radio buttons,
  tag-style list inputs, and load/save via /api/preferences

The resume textarea moves from the Generate tab to the Resume tab.
The Generate tab shows a preview snippet and a hint to edit in the
Resume tab.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: emirsaffar-collab <79217569+emirsaffar-collab@users.noreply.github.com>
---
 src/web/ui.py | 1164 +++++++++++++++++++++++++++++--------------------
 1 file changed, 696 insertions(+), 468 deletions(-)

diff --git a/src/web/ui.py b/src/web/ui.py
index 2e5a526d7..725ff37c6 100644
--- a/src/web/ui.py
+++ b/src/web/ui.py
@@ -6,7 +6,11 @@
 
 def get_html() -> str:
     """Return the complete HTML page for the web UI."""
-    return '''<!DOCTYPE html>
+    return _HTML
+
+
+_HTML = """\
+<!DOCTYPE html>
 <html lang="en">
 <head>
     <meta charset="UTF-8">
@@ -44,7 +48,6 @@ def get_html() -> str:
             line-height: 1.6;
         }
 
-        /* Header */
         .header {
             background: white;
             border-bottom: 1px solid var(--gray-200);
@@ -69,41 +72,18 @@ def get_html() -> str:
 
         .header h1 .icon { font-size: 24px; }
 
-        .header-actions {
-            display: flex;
-            gap: 12px;
-            align-items: center;
-        }
-
-        .badge {
-            padding: 4px 10px;
-            border-radius: 12px;
-            font-size: 12px;
-            font-weight: 600;
-        }
+        .header-actions { display: flex; gap: 12px; align-items: center; }
 
+        .badge { padding: 4px 10px; border-radius: 12px; font-size: 12px; font-weight: 600; }
         .badge-success { background: #dcfce7; color: var(--success); }
         .badge-warning { background: #fef3c7; color: var(--warning); }
         .badge-danger { background: #fee2e2; color: var(--danger); }
 
-        /* Layout */
-        .container {
-            max-width: 1200px;
-            margin: 0 auto;
-            padding: 24px;
-        }
-
-        .grid {
-            display: grid;
-            grid-template-columns: 1fr 1fr;
-            gap: 24px;
-        }
+        .container { max-width: 1200px; margin: 0 auto; padding: 24px; }
 
-        @media (max-width: 768px) {
-            .grid { grid-template-columns: 1fr; }
-        }
+        .grid { display: grid; grid-template-columns: 1fr 1fr; gap: 24px; }
+        @media (max-width: 768px) { .grid { grid-template-columns: 1fr; } }
 
-        /* Cards */
         .card {
             background: white;
             border-radius: var(--radius);
@@ -120,41 +100,31 @@ def get_html() -> str:
             justify-content: space-between;
         }
 
-        .card-header h2 {
-            font-size: 16px;
-            font-weight: 600;
-            color: var(--gray-900);
-        }
-
+        .card-header h2 { font-size: 16px; font-weight: 600; color: var(--gray-900); }
         .card-body { padding: 20px; }
 
-        /* Forms */
-        .form-group {
-            margin-bottom: 16px;
-        }
-
+        .form-group { margin-bottom: 16px; }
         .form-group label {
-            display: block;
-            font-size: 13px;
-            font-weight: 600;
-            color: var(--gray-700);
-            margin-bottom: 6px;
+            display: block; font-size: 13px; font-weight: 600;
+            color: var(--gray-700); margin-bottom: 6px;
         }
 
-        .form-group input,
+        .form-group input[type="text"],
+        .form-group input[type="password"],
+        .form-group input[type="url"],
         .form-group select,
         .form-group textarea {
-            width: 100%;
-            padding: 10px 12px;
+            width: 100%; padding: 10px 12px;
             border: 1px solid var(--gray-300);
             border-radius: var(--radius);
-            font-size: 14px;
-            color: var(--gray-800);
+            font-size: 14px; color: var(--gray-800);
             background: white;
             transition: border-color 0.2s, box-shadow 0.2s;
         }
 
-        .form-group input:focus,
+        .form-group input[type="text"]:focus,
+        .form-group input[type="password"]:focus,
+        .form-group input[type="url"]:focus,
         .form-group select:focus,
         .form-group textarea:focus {
             outline: none;
@@ -164,489 +134,499 @@ def get_html() -> str:
 
         .form-group textarea {
             font-family: 'SF Mono', 'Fira Code', 'Fira Mono', monospace;
-            font-size: 12px;
-            resize: vertical;
-            min-height: 200px;
+            font-size: 12px; resize: vertical; min-height: 200px;
         }
 
-        .form-row {
-            display: grid;
-            grid-template-columns: 1fr 1fr;
-            gap: 12px;
-        }
+        .form-row { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
+        .form-help { font-size: 12px; color: var(--gray-500); margin-top: 4px; }
 
-        .form-help {
-            font-size: 12px;
-            color: var(--gray-500);
-            margin-top: 4px;
-        }
-
-        /* Buttons */
         .btn {
-            display: inline-flex;
-            align-items: center;
-            justify-content: center;
-            gap: 6px;
-            padding: 10px 20px;
-            border-radius: var(--radius);
-            font-size: 14px;
-            font-weight: 600;
-            cursor: pointer;
-            border: none;
-            transition: all 0.2s;
-        }
-
-        .btn:disabled {
-            opacity: 0.6;
-            cursor: not-allowed;
-        }
-
-        .btn-primary {
-            background: var(--primary);
-            color: white;
-        }
-
-        .btn-primary:hover:not(:disabled) {
-            background: var(--primary-dark);
-        }
-
-        .btn-success {
-            background: var(--success);
-            color: white;
-        }
-
-        .btn-outline {
-            background: white;
-            color: var(--gray-700);
-            border: 1px solid var(--gray-300);
-        }
-
-        .btn-outline:hover:not(:disabled) {
-            background: var(--gray-50);
-        }
-
+            display: inline-flex; align-items: center; justify-content: center;
+            gap: 6px; padding: 10px 20px; border-radius: var(--radius);
+            font-size: 14px; font-weight: 600; cursor: pointer;
+            border: none; transition: all 0.2s;
+        }
+        .btn:disabled { opacity: 0.6; cursor: not-allowed; }
+        .btn-primary { background: var(--primary); color: white; }
+        .btn-primary:hover:not(:disabled) { background: var(--primary-dark); }
+        .btn-success { background: var(--success); color: white; }
+        .btn-outline { background: white; color: var(--gray-700); border: 1px solid var(--gray-300); }
+        .btn-outline:hover:not(:disabled) { background: var(--gray-50); }
+        .btn-sm { padding: 6px 12px; font-size: 12px; }
         .btn-block { width: 100%; }
+        .btn-group { display: flex; gap: 8px; flex-wrap: wrap; }
 
-        .btn-group {
-            display: flex;
-            gap: 8px;
+        .main-tabs {
+            display: flex; border-bottom: 2px solid var(--gray-200);
+            margin-bottom: 24px; gap: 4px;
         }
 
-        /* Tabs */
-        .tabs {
-            display: flex;
-            border-bottom: 2px solid var(--gray-200);
-            margin-bottom: 20px;
+        .main-tab {
+            padding: 12px 24px; font-size: 15px; font-weight: 600;
+            color: var(--gray-500); cursor: pointer;
+            border-bottom: 3px solid transparent; margin-bottom: -2px;
+            transition: all 0.2s; background: none;
+            border-top: none; border-left: none; border-right: none;
+            user-select: none;
         }
+        .main-tab:hover { color: var(--gray-700); background: var(--gray-50); }
+        .main-tab.active { color: var(--primary); border-bottom-color: var(--primary); }
 
-        .tab {
-            padding: 10px 16px;
-            font-size: 14px;
-            font-weight: 500;
-            color: var(--gray-500);
-            cursor: pointer;
-            border-bottom: 2px solid transparent;
-            margin-bottom: -2px;
-            transition: all 0.2s;
-            background: none;
-            border-top: none;
-            border-left: none;
-            border-right: none;
-        }
-
-        .tab:hover { color: var(--gray-700); }
-
-        .tab.active {
-            color: var(--primary);
-            border-bottom-color: var(--primary);
-        }
-
-        /* Progress */
-        .progress-container {
-            padding: 20px;
-            display: none;
-        }
+        .tab-panel { display: none; }
+        .tab-panel.active { display: block; }
 
+        .progress-container { padding: 20px; display: none; }
         .progress-container.active { display: block; }
 
         .progress-bar-track {
-            height: 8px;
-            background: var(--gray-200);
-            border-radius: 4px;
-            overflow: hidden;
-            margin: 12px 0;
+            height: 8px; background: var(--gray-200);
+            border-radius: 4px; overflow: hidden; margin: 12px 0;
         }
-
         .progress-bar-fill {
-            height: 100%;
-            background: var(--primary);
-            border-radius: 4px;
-            transition: width 0.5s ease;
-            width: 0%;
+            height: 100%; background: var(--primary);
+            border-radius: 4px; transition: width 0.5s ease; width: 0%;
         }
-
         .progress-bar-fill.success { background: var(--success); }
         .progress-bar-fill.error { background: var(--danger); }
+        .progress-text { font-size: 14px; color: var(--gray-600); text-align: center; }
+        .progress-percent { font-size: 24px; font-weight: 700; color: var(--gray-800); text-align: center; }
 
-        .progress-text {
-            font-size: 14px;
-            color: var(--gray-600);
-            text-align: center;
-        }
-
-        .progress-percent {
-            font-size: 24px;
-            font-weight: 700;
-            color: var(--gray-800);
-            text-align: center;
-        }
-
-        /* Status log */
         .status-log {
-            max-height: 200px;
-            overflow-y: auto;
-            font-size: 13px;
-            font-family: monospace;
-            background: var(--gray-50);
-            border: 1px solid var(--gray-200);
-            border-radius: var(--radius);
-            padding: 12px;
-            margin-top: 12px;
-        }
-
-        .status-entry {
-            padding: 4px 0;
-            border-bottom: 1px solid var(--gray-100);
+            max-height: 200px; overflow-y: auto; font-size: 13px;
+            font-family: monospace; background: var(--gray-50);
+            border: 1px solid var(--gray-200); border-radius: var(--radius);
+            padding: 12px; margin-top: 12px;
         }
-
+        .status-entry { padding: 4px 0; border-bottom: 1px solid var(--gray-100); }
         .status-entry:last-child { border-bottom: none; }
+        .status-time { color: var(--gray-400); font-size: 11px; margin-right: 8px; }
 
-        .status-time {
-            color: var(--gray-400);
-            font-size: 11px;
-            margin-right: 8px;
-        }
-
-        /* Alerts */
         .alert {
-            padding: 12px 16px;
-            border-radius: var(--radius);
-            margin-bottom: 16px;
-            font-size: 14px;
-            display: none;
+            padding: 12px 16px; border-radius: var(--radius);
+            margin-bottom: 16px; font-size: 14px; display: none;
         }
-
         .alert.show { display: block; }
+        .alert-error { background: #fee2e2; color: var(--danger); border: 1px solid #fecaca; }
+        .alert-success { background: #dcfce7; color: var(--success); border: 1px solid #bbf7d0; }
+        .alert-info { background: var(--primary-light); color: var(--primary-dark); border: 1px solid #93c5fd; }
 
-        .alert-error {
-            background: #fee2e2;
-            color: var(--danger);
-            border: 1px solid #fecaca;
-        }
-
-        .alert-success {
-            background: #dcfce7;
-            color: var(--success);
-            border: 1px solid #bbf7d0;
-        }
-
-        .alert-info {
-            background: var(--primary-light);
-            color: var(--primary-dark);
-            border: 1px solid #93c5fd;
-        }
-
-        /* Action cards */
-        .action-cards {
-            display: grid;
-            grid-template-columns: repeat(3, 1fr);
-            gap: 12px;
-            margin-bottom: 20px;
-        }
-
-        @media (max-width: 768px) {
-            .action-cards { grid-template-columns: 1fr; }
-        }
-
+        .action-cards { display: grid; grid-template-columns: repeat(3, 1fr); gap: 12px; margin-bottom: 20px; }
+        @media (max-width: 768px) { .action-cards { grid-template-columns: 1fr; } }
         .action-card {
-            padding: 16px;
-            border: 2px solid var(--gray-200);
-            border-radius: var(--radius);
-            cursor: pointer;
-            transition: all 0.2s;
-            text-align: center;
+            padding: 16px; border: 2px solid var(--gray-200);
+            border-radius: var(--radius); cursor: pointer;
+            transition: all 0.2s; text-align: center;
         }
+        .action-card:hover { border-color: var(--primary); background: var(--primary-light); }
+        .action-card.selected { border-color: var(--primary); background: var(--primary-light); }
+        .action-card .action-icon { font-size: 28px; margin-bottom: 8px; }
+        .action-card .action-title { font-weight: 600; font-size: 14px; color: var(--gray-800); }
+        .action-card .action-desc { font-size: 12px; color: var(--gray-500); margin-top: 4px; }
 
-        .action-card:hover {
-            border-color: var(--primary);
-            background: var(--primary-light);
+        .history-item {
+            display: flex; align-items: center; justify-content: space-between;
+            padding: 12px 0; border-bottom: 1px solid var(--gray-100);
         }
+        .history-item:last-child { border-bottom: none; }
+        .history-info h4 { font-size: 14px; color: var(--gray-800); }
+        .history-info p { font-size: 12px; color: var(--gray-500); }
 
-        .action-card.selected {
-            border-color: var(--primary);
-            background: var(--primary-light);
+        .spinner {
+            display: inline-block; width: 16px; height: 16px;
+            border: 2px solid var(--gray-300); border-top-color: var(--primary);
+            border-radius: 50%; animation: spin 0.8s linear infinite;
         }
+        @keyframes spin { to { transform: rotate(360deg); } }
 
-        .action-card .action-icon {
-            font-size: 28px;
-            margin-bottom: 8px;
+        .tooltip { position: relative; }
+        .tooltip::after {
+            content: attr(data-tip); position: absolute; bottom: 100%;
+            left: 50%; transform: translateX(-50%);
+            background: var(--gray-800); color: white;
+            padding: 4px 8px; border-radius: 4px; font-size: 12px;
+            white-space: nowrap; opacity: 0; pointer-events: none;
+            transition: opacity 0.2s;
         }
+        .tooltip:hover::after { opacity: 1; }
 
-        .action-card .action-title {
-            font-weight: 600;
-            font-size: 14px;
-            color: var(--gray-800);
-        }
+        .full-width { grid-column: 1 / -1; }
+        .hidden { display: none !important; }
+        #jobUrlGroup { display: none; }
+        #jobUrlGroup.show { display: block; }
 
-        .action-card .action-desc {
-            font-size: 12px;
-            color: var(--gray-500);
-            margin-top: 4px;
-        }
+        .example-link { font-size: 12px; color: var(--primary); cursor: pointer; text-decoration: underline; }
+        .example-link:hover { color: var(--primary-dark); }
 
-        /* History */
-        .history-item {
-            display: flex;
-            align-items: center;
-            justify-content: space-between;
-            padding: 12px 0;
-            border-bottom: 1px solid var(--gray-100);
+        .settings-section {
+            margin-bottom: 24px; padding-bottom: 20px;
+            border-bottom: 1px solid var(--gray-200);
         }
-
-        .history-item:last-child { border-bottom: none; }
-
-        .history-info h4 {
-            font-size: 14px;
-            color: var(--gray-800);
+        .settings-section:last-child { border-bottom: none; margin-bottom: 0; padding-bottom: 0; }
+        .settings-section h3 {
+            font-size: 15px; font-weight: 600; color: var(--gray-800);
+            margin-bottom: 12px; display: flex; align-items: center; gap: 8px;
         }
 
-        .history-info p {
-            font-size: 12px;
-            color: var(--gray-500);
+        .check-group { display: flex; flex-wrap: wrap; gap: 12px; }
+        .check-item {
+            display: flex; align-items: center; gap: 6px;
+            font-size: 14px; color: var(--gray-700); cursor: pointer;
         }
-
-        /* Spinner */
-        .spinner {
-            display: inline-block;
-            width: 16px;
-            height: 16px;
-            border: 2px solid var(--gray-300);
-            border-top-color: var(--primary);
-            border-radius: 50%;
-            animation: spin 0.8s linear infinite;
+        .check-item input[type="checkbox"],
+        .check-item input[type="radio"] {
+            width: 16px; height: 16px; accent-color: var(--primary); cursor: pointer;
         }
 
-        @keyframes spin {
-            to { transform: rotate(360deg); }
+        .tag-input-wrap { display: flex; gap: 8px; margin-bottom: 8px; }
+        .tag-input-wrap input {
+            flex: 1; padding: 8px 12px;
+            border: 1px solid var(--gray-300); border-radius: var(--radius);
+            font-size: 14px; color: var(--gray-800); background: white;
         }
-
-        /* Tooltip */
-        .tooltip {
-            position: relative;
+        .tag-input-wrap input:focus {
+            outline: none; border-color: var(--primary);
+            box-shadow: 0 0 0 3px var(--primary-light);
         }
 
-        .tooltip::after {
-            content: attr(data-tip);
-            position: absolute;
-            bottom: 100%;
-            left: 50%;
-            transform: translateX(-50%);
-            background: var(--gray-800);
-            color: white;
-            padding: 4px 8px;
-            border-radius: 4px;
-            font-size: 12px;
-            white-space: nowrap;
-            opacity: 0;
-            pointer-events: none;
-            transition: opacity 0.2s;
+        .tag-list { display: flex; flex-wrap: wrap; gap: 6px; min-height: 28px; }
+        .tag {
+            display: inline-flex; align-items: center; gap: 4px;
+            padding: 4px 10px; background: var(--primary-light);
+            color: var(--primary-dark); border-radius: 16px;
+            font-size: 13px; font-weight: 500;
         }
-
-        .tooltip:hover::after { opacity: 1; }
-
-        /* Full-width section */
-        .full-width {
-            grid-column: 1 / -1;
+        .tag-remove {
+            cursor: pointer; font-size: 14px; font-weight: 700;
+            line-height: 1; opacity: 0.7; border: none;
+            background: none; color: var(--primary-dark); padding: 0 2px;
         }
+        .tag-remove:hover { opacity: 1; }
 
-        /* Hidden */
-        .hidden { display: none !important; }
-
-        /* Job URL group */
-        #jobUrlGroup { display: none; }
-        #jobUrlGroup.show { display: block; }
-
-        /* Example YAML button */
-        .example-link {
-            font-size: 12px;
-            color: var(--primary);
-            cursor: pointer;
-            text-decoration: underline;
+        .status-msg {
+            padding: 10px 14px; border-radius: var(--radius);
+            font-size: 13px; margin-top: 12px; display: none;
         }
+        .status-msg.show { display: block; }
+        .status-msg.success { background: #dcfce7; color: var(--success); border: 1px solid #bbf7d0; }
+        .status-msg.error { background: #fee2e2; color: var(--danger); border: 1px solid #fecaca; }
+
+        .settings-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 24px; }
+        @media (max-width: 768px) { .settings-grid { grid-template-columns: 1fr; } }
 
-        .example-link:hover {
-            color: var(--primary-dark);
+        .resume-hint {
+            background: var(--primary-light); border: 1px solid #93c5fd;
+            border-radius: var(--radius); padding: 10px 14px;
+            font-size: 13px; color: var(--primary-dark); margin-bottom: 16px;
         }
     </style>
 </head>
 <body>
-    <!-- Header -->
     <div class="header">
-        <h1>
-            <span class="icon">&#128640;</span>
-            AIHawk Resume Builder
-        </h1>
+        <h1><span class="icon">&#128640;</span> AIHawk Resume Builder</h1>
         <div class="header-actions">
             <span id="healthBadge" class="badge badge-warning">Checking...</span>
         </div>
     </div>
 
     <div class="container">
-        <!-- Alert area -->
-        <div id="alertArea">
-            <div id="alertBox" class="alert"></div>
+        <div id="alertArea"><div id="alertBox" class="alert"></div></div>
+
+        <div class="main-tabs">
+            <button class="main-tab active" onclick="switchTab('generate')">&#9889; Generate</button>
+            <button class="main-tab" onclick="switchTab('resume')">&#128221; Resume</button>
+            <button class="main-tab" onclick="switchTab('settings')">&#9881; Settings</button>
         </div>
 
-        <div class="grid">
-            <!-- Left Column: Configuration -->
-            <div>
-                <!-- API Configuration -->
-                <div class="card" style="margin-bottom: 24px;">
-                    <div class="card-header">
-                        <h2>&#128273; API Configuration</h2>
-                    </div>
-                    <div class="card-body">
-                        <div class="form-row">
-                            <div class="form-group">
-                                <label for="llmProvider">LLM Provider</label>
-                                <select id="llmProvider" onchange="onProviderChange()">
-                                    <option value="claude">Claude (Anthropic)</option>
-                                    <option value="openai">OpenAI</option>
-                                    <option value="gemini">Google Gemini</option>
-                                    <option value="ollama">Ollama (Local)</option>
-                                </select>
+        <!-- TAB 1: GENERATE -->
+        <div id="tab-generate" class="tab-panel active">
+            <div class="grid">
+                <div>
+                    <div class="card" style="margin-bottom: 24px;">
+                        <div class="card-header"><h2>&#128273; API Configuration</h2></div>
+                        <div class="card-body">
+                            <div class="form-row">
+                                <div class="form-group">
+                                    <label for="llmProvider">LLM Provider</label>
+                                    <select id="llmProvider" onchange="onProviderChange()">
+                                        <option value="claude">Claude (Anthropic)</option>
+                                        <option value="openai">OpenAI</option>
+                                        <option value="gemini">Google Gemini</option>
+                                        <option value="ollama">Ollama (Local)</option>
+                                    </select>
+                                </div>
+                                <div class="form-group">
+                                    <label for="llmModel">Model</label>
+                                    <select id="llmModel">
+                                        <option value="claude-sonnet-4-20250514">Claude Sonnet 4</option>
+                                        <option value="claude-3-5-sonnet-20241022">Claude 3.5 Sonnet</option>
+                                        <option value="claude-3-haiku-20240307">Claude 3 Haiku</option>
+                                    </select>
+                                </div>
                             </div>
                             <div class="form-group">
-                                <label for="llmModel">Model</label>
-                                <select id="llmModel">
-                                    <option value="claude-sonnet-4-20250514">Claude Sonnet 4</option>
-                                    <option value="claude-3-5-sonnet-20241022">Claude 3.5 Sonnet</option>
-                                    <option value="claude-3-haiku-20240307">Claude 3 Haiku</option>
-                                </select>
+                                <label for="apiKey">API Key</label>
+                                <input type="password" id="apiKey" placeholder="Enter your API key...">
+                                <p class="form-help">Your API key is sent directly to the generation endpoint and is not stored.</p>
                             </div>
                         </div>
-                        <div class="form-group">
-                            <label for="apiKey">API Key</label>
-                            <input type="password" id="apiKey" placeholder="Enter your API key...">
-                            <p class="form-help">Your API key is sent directly to the generation endpoint and is not stored.</p>
+                    </div>
+
+                    <div class="card" style="margin-bottom: 24px;">
+                        <div class="card-header"><h2>&#9889; Action</h2></div>
+                        <div class="card-body">
+                            <div class="action-cards">
+                                <div class="action-card selected" onclick="selectAction('resume')" id="action-resume">
+                                    <div class="action-icon">&#128196;</div>
+                                    <div class="action-title">Resume</div>
+                                    <div class="action-desc">Generate base resume</div>
+                                </div>
+                                <div class="action-card" onclick="selectAction('resume_tailored')" id="action-resume_tailored">
+                                    <div class="action-icon">&#127919;</div>
+                                    <div class="action-title">Tailored Resume</div>
+                                    <div class="action-desc">Resume for a job</div>
+                                </div>
+                                <div class="action-card" onclick="selectAction('cover_letter')" id="action-cover_letter">
+                                    <div class="action-icon">&#9993;</div>
+                                    <div class="action-title">Cover Letter</div>
+                                    <div class="action-desc">Tailored cover letter</div>
+                                </div>
+                            </div>
+                            <div class="form-group" id="jobUrlGroup">
+                                <label for="jobUrl">Job Posting URL</label>
+                                <input type="url" id="jobUrl" placeholder="https://www.linkedin.com/jobs/view/...">
+                                <p class="form-help">URL of the job posting to tailor your document to.</p>
+                            </div>
+                            <div class="form-group">
+                                <label for="styleSelect">Resume Style</label>
+                                <select id="styleSelect"><option value="">Loading styles...</option></select>
+                            </div>
                         </div>
                     </div>
                 </div>
 
-                <!-- Action Selection -->
-                <div class="card" style="margin-bottom: 24px;">
-                    <div class="card-header">
-                        <h2>&#9889; Action</h2>
-                    </div>
-                    <div class="card-body">
-                        <div class="action-cards">
-                            <div class="action-card selected" onclick="selectAction(\'resume\')" id="action-resume">
-                                <div class="action-icon">&#128196;</div>
-                                <div class="action-title">Resume</div>
-                                <div class="action-desc">Generate base resume</div>
+                <div>
+                    <div class="card" style="margin-bottom: 24px;">
+                        <div class="card-header"><h2>&#128221; Resume Data</h2></div>
+                        <div class="card-body">
+                            <div class="resume-hint">
+                                &#128161; Edit your resume in the <strong>Resume</strong> tab. Your resume data will be loaded automatically when generating.
                             </div>
-                            <div class="action-card" onclick="selectAction(\'resume_tailored\')" id="action-resume_tailored">
-                                <div class="action-icon">&#127919;</div>
-                                <div class="action-title">Tailored Resume</div>
-                                <div class="action-desc">Resume for a job</div>
+                            <div id="resumePreview" style="font-size: 13px; color: var(--gray-600);">
+                                <p>No resume loaded yet. Go to the Resume tab to enter your data.</p>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <div class="full-width">
+                    <div class="card">
+                        <div class="card-body">
+                            <button id="generateBtn" class="btn btn-primary btn-block" onclick="startGeneration()">&#9889; Generate Document</button>
+                            <div id="progressContainer" class="progress-container">
+                                <div class="progress-percent" id="progressPercent">0%</div>
+                                <div class="progress-bar-track"><div class="progress-bar-fill" id="progressBar"></div></div>
+                                <div class="progress-text" id="progressText">Waiting...</div>
+                                <div class="status-log" id="statusLog"></div>
                             </div>
-                            <div class="action-card" onclick="selectAction(\'cover_letter\')" id="action-cover_letter">
-                                <div class="action-icon">&#9993;</div>
-                                <div class="action-title">Cover Letter</div>
-                                <div class="action-desc">Tailored cover letter</div>
+                            <div id="downloadSection" class="hidden" style="text-align: center; margin-top: 16px;">
+                                <button id="downloadBtn" class="btn btn-success" onclick="downloadDocument()">&#11015; Download PDF</button>
                             </div>
                         </div>
-                        <div class="form-group" id="jobUrlGroup">
-                            <label for="jobUrl">Job Posting URL</label>
-                            <input type="url" id="jobUrl" placeholder="https://www.linkedin.com/jobs/view/...">
-                            <p class="form-help">URL of the job posting to tailor your document to.</p>
+                    </div>
+                </div>
+
+                <div class="full-width">
+                    <div class="card">
+                        <div class="card-header">
+                            <h2>&#128203; Recent Generations</h2>
+                            <button class="btn btn-outline btn-sm" onclick="clearHistory()">Clear</button>
                         </div>
-                        <div class="form-group">
-                            <label for="styleSelect">Resume Style</label>
-                            <select id="styleSelect">
-                                <option value="">Loading styles...</option>
-                            </select>
+                        <div class="card-body" id="historyList">
+                            <p style="color: var(--gray-400); text-align: center; padding: 20px;">No documents generated yet.</p>
                         </div>
                     </div>
                 </div>
             </div>
+        </div>
 
-            <!-- Right Column: Resume Data -->
-            <div>
-                <div class="card" style="margin-bottom: 24px;">
-                    <div class="card-header">
-                        <h2>&#128221; Resume Data (YAML)</h2>
-                        <span class="example-link" onclick="loadExample()">Load Example</span>
+        <!-- TAB 2: RESUME -->
+        <div id="tab-resume" class="tab-panel">
+            <div class="card">
+                <div class="card-header">
+                    <h2>&#128221; Resume Data (YAML)</h2>
+                    <div class="btn-group">
+                        <button class="btn btn-outline btn-sm" onclick="loadResumeFromServer()">Load from Server</button>
+                        <button class="btn btn-outline btn-sm" onclick="loadExample()">Load Example</button>
                     </div>
-                    <div class="card-body">
-                        <div class="form-group">
-                            <textarea id="resumeYaml" rows="22" placeholder="Paste your resume YAML here..."></textarea>
-                            <p class="form-help">Paste your resume in YAML format. Click &quot;Load Example&quot; to see the expected structure.</p>
-                        </div>
+                </div>
+                <div class="card-body">
+                    <div class="form-group">
+                        <textarea id="resumeYaml" rows="30" placeholder="Paste your resume YAML here..."></textarea>
+                        <p class="form-help">Paste your resume in YAML format or load it from the server. Click &quot;Load Example&quot; to see the expected structure.</p>
+                    </div>
+                    <div class="btn-group">
+                        <button class="btn btn-primary" onclick="saveResumeToServer()">&#128190; Save to Server</button>
                     </div>
+                    <div id="resumeStatus" class="status-msg"></div>
                 </div>
             </div>
+        </div>
 
-            <!-- Full width: Generate button and progress -->
-            <div class="full-width">
-                <div class="card">
-                    <div class="card-body">
-                        <button id="generateBtn" class="btn btn-primary btn-block" onclick="startGeneration()">
-                            &#9889; Generate Document
-                        </button>
-
-                        <div id="progressContainer" class="progress-container">
-                            <div class="progress-percent" id="progressPercent">0%</div>
-                            <div class="progress-bar-track">
-                                <div class="progress-bar-fill" id="progressBar"></div>
+        <!-- TAB 3: SETTINGS -->
+        <div id="tab-settings" class="tab-panel">
+            <div class="card">
+                <div class="card-header">
+                    <h2>&#9881; Work Preferences</h2>
+                    <div class="btn-group">
+                        <button class="btn btn-outline btn-sm" onclick="loadPreferencesFromServer()">Load from Server</button>
+                    </div>
+                </div>
+                <div class="card-body">
+                    <div class="settings-grid">
+                        <div>
+                            <div class="settings-section">
+                                <h3>&#127968; Work Location</h3>
+                                <div class="check-group">
+                                    <label class="check-item"><input type="checkbox" id="pref_remote" checked> Remote</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_hybrid" checked> Hybrid</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_onsite" checked> On-site</label>
+                                </div>
+                            </div>
+                            <div class="settings-section">
+                                <h3>&#128188; Experience Level</h3>
+                                <div class="check-group">
+                                    <label class="check-item"><input type="checkbox" id="pref_exp_internship"> Internship</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_exp_entry" checked> Entry</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_exp_associate" checked> Associate</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_exp_mid_senior" checked> Mid-Senior Level</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_exp_director"> Director</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_exp_executive"> Executive</label>
+                                </div>
+                            </div>
+                            <div class="settings-section">
+                                <h3>&#128196; Job Types</h3>
+                                <div class="check-group">
+                                    <label class="check-item"><input type="checkbox" id="pref_jt_full_time" checked> Full-time</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_jt_contract"> Contract</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_jt_part_time"> Part-time</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_jt_temporary" checked> Temporary</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_jt_internship"> Internship</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_jt_other"> Other</label>
+                                    <label class="check-item"><input type="checkbox" id="pref_jt_volunteer" checked> Volunteer</label>
+                                </div>
+                            </div>
+                            <div class="settings-section">
+                                <h3>&#128197; Date Posted</h3>
+                                <div class="check-group">
+                                    <label class="check-item"><input type="radio" name="datePosted" value="all_time"> All Time</label>
+                                    <label class="check-item"><input type="radio" name="datePosted" value="month"> Month</label>
+                                    <label class="check-item"><input type="radio" name="datePosted" value="week"> Week</label>
+                                    <label class="check-item"><input type="radio" name="datePosted" value="24_hours" checked> 24 Hours</label>
+                                </div>
                             </div>
-                            <div class="progress-text" id="progressText">Waiting...</div>
-                            <div class="status-log" id="statusLog"></div>
                         </div>
-
-                        <div id="downloadSection" class="hidden" style="text-align: center; margin-top: 16px;">
-                            <button id="downloadBtn" class="btn btn-success" onclick="downloadDocument()">
-                                &#11015; Download PDF
-                            </button>
+                        <div>
+                            <div class="settings-section">
+                                <h3>&#128269; Search Criteria</h3>
+                                <div class="form-group">
+                                    <label>Positions</label>
+                                    <div class="tag-input-wrap">
+                                        <input type="text" id="positionInput" placeholder="Add a position...">
+                                        <button class="btn btn-outline btn-sm" onclick="addTag('positions')">Add</button>
+                                    </div>
+                                    <div class="tag-list" id="positions-tags"></div>
+                                </div>
+                                <div class="form-group">
+                                    <label>Locations</label>
+                                    <div class="tag-input-wrap">
+                                        <input type="text" id="locationInput" placeholder="Add a location...">
+                                        <button class="btn btn-outline btn-sm" onclick="addTag('locations')">Add</button>
+                                    </div>
+                                    <div class="tag-list" id="locations-tags"></div>
+                                </div>
+                                <div class="form-group">
+                                    <label for="pref_distance">Distance (miles)</label>
+                                    <select id="pref_distance">
+                                        <option value="0">0</option>
+                                        <option value="5">5</option>
+                                        <option value="10">10</option>
+                                        <option value="25">25</option>
+                                        <option value="50">50</option>
+                                        <option value="100" selected>100</option>
+                                    </select>
+                                </div>
+                            </div>
+                            <div class="settings-section">
+                                <h3>&#128683; Blacklists</h3>
+                                <div class="form-group">
+                                    <label>Company Blacklist</label>
+                                    <div class="tag-input-wrap">
+                                        <input type="text" id="companyBlInput" placeholder="Add a company...">
+                                        <button class="btn btn-outline btn-sm" onclick="addTag('company_blacklist')">Add</button>
+                                    </div>
+                                    <div class="tag-list" id="company_blacklist-tags"></div>
+                                </div>
+                                <div class="form-group">
+                                    <label>Title Blacklist</label>
+                                    <div class="tag-input-wrap">
+                                        <input type="text" id="titleBlInput" placeholder="Add a title keyword...">
+                                        <button class="btn btn-outline btn-sm" onclick="addTag('title_blacklist')">Add</button>
+                                    </div>
+                                    <div class="tag-list" id="title_blacklist-tags"></div>
+                                </div>
+                                <div class="form-group">
+                                    <label>Location Blacklist</label>
+                                    <div class="tag-input-wrap">
+                                        <input type="text" id="locationBlInput" placeholder="Add a location...">
+                                        <button class="btn btn-outline btn-sm" onclick="addTag('location_blacklist')">Add</button>
+                                    </div>
+                                    <div class="tag-list" id="location_blacklist-tags"></div>
+                                </div>
+                            </div>
+                            <div class="settings-section">
+                                <h3>&#9881; Other</h3>
+                                <div class="check-group">
+                                    <label class="check-item"><input type="checkbox" id="pref_apply_once" checked> Apply Once at Company</label>
+                                </div>
+                            </div>
                         </div>
                     </div>
-                </div>
-            </div>
 
-            <!-- History -->
-            <div class="full-width">
-                <div class="card">
-                    <div class="card-header">
-                        <h2>&#128203; Recent Generations</h2>
-                        <button class="btn btn-outline" onclick="clearHistory()" style="padding: 6px 12px; font-size: 12px;">Clear</button>
-                    </div>
-                    <div class="card-body" id="historyList">
-                        <p style="color: var(--gray-400); text-align: center; padding: 20px;">No documents generated yet.</p>
+                    <div style="border-top: 1px solid var(--gray-200); padding-top: 20px; margin-top: 8px;">
+                        <div class="btn-group">
+                            <button class="btn btn-primary" onclick="savePreferencesToServer()">&#128190; Save Preferences</button>
+                            <button class="btn btn-outline" onclick="loadPreferencesFromServer()">&#128259; Reload from Server</button>
+                        </div>
+                        <div id="settingsStatus" class="status-msg"></div>
                     </div>
                 </div>
             </div>
         </div>
     </div>
-
     <script>
-        // State
+        /* ========== STATE ========== */
         let currentAction = 'resume';
         let currentJobId = null;
         let ws = null;
         let downloadUrl = null;
-        let history = JSON.parse(localStorage.getItem('aihawk_history') || '[]');
+        let genHistory = JSON.parse(localStorage.getItem('aihawk_history') || '[]');
+
+        const tagData = {
+            positions: [],
+            locations: [],
+            company_blacklist: [],
+            title_blacklist: [],
+            location_blacklist: [],
+        };
+
+        const tagInputIds = {
+            positions: 'positionInput',
+            locations: 'locationInput',
+            company_blacklist: 'companyBlInput',
+            title_blacklist: 'titleBlInput',
+            location_blacklist: 'locationBlInput',
+        };
 
-        // Model options per provider
         const modelOptions = {
             claude: [
                 { value: 'claude-sonnet-4-20250514', label: 'Claude Sonnet 4' },
@@ -669,7 +649,6 @@ def get_html() -> str:
             ],
         };
 
-        // Example YAML
         const exampleYaml = `personal_information:
   name: "John"
   surname: "Doe"
@@ -737,14 +716,48 @@ def get_html() -> str:
   - "Open Source"
   - "Cloud Architecture"`;
 
-        // Initialize
+        /* ========== INITIALIZATION ========== */
         document.addEventListener('DOMContentLoaded', () => {
             checkHealth();
             loadStyles();
             renderHistory();
+            loadResumeFromServer();
+            loadPreferencesFromServer();
+            setupTagEnterKeys();
         });
 
-        // Health check
+        /* ========== TAB SWITCHING ========== */
+        function switchTab(tabName) {
+            document.querySelectorAll('.main-tab').forEach(t => t.classList.remove('active'));
+            document.querySelectorAll('.tab-panel').forEach(p => p.classList.remove('active'));
+            document.getElementById('tab-' + tabName).classList.add('active');
+            const tabs = document.querySelectorAll('.main-tab');
+            const tabMap = ['generate', 'resume', 'settings'];
+            const idx = tabMap.indexOf(tabName);
+            if (idx >= 0 && tabs[idx]) tabs[idx].classList.add('active');
+            if (tabName === 'generate') updateResumePreview();
+        }
+
+        function updateResumePreview() {
+            const yaml = document.getElementById('resumeYaml').value.trim();
+            const preview = document.getElementById('resumePreview');
+            if (yaml) {
+                const lines = yaml.split('\n');
+                const previewLines = lines.slice(0, 8).join('\n');
+                const more = lines.length > 8 ? `\n... (${lines.length - 8} more lines)` : '';
+                preview.innerHTML = `<pre style="font-size:12px;color:var(--gray-600);white-space:pre-wrap;margin:0;background:var(--gray-50);padding:12px;border-radius:var(--radius);border:1px solid var(--gray-200);max-height:200px;overflow-y:auto;">${escapeHtml(previewLines + more)}</pre>`;
+            } else {
+                preview.innerHTML = '<p>No resume loaded yet. Go to the Resume tab to enter your data.</p>';
+            }
+        }
+
+        function escapeHtml(text) {
+            const div = document.createElement('div');
+            div.textContent = text;
+            return div.innerHTML;
+        }
+
+        /* ========== HEALTH CHECK ========== */
         async function checkHealth() {
             const badge = document.getElementById('healthBadge');
             try {
@@ -756,13 +769,13 @@ def get_html() -> str:
                     badge.className = 'badge badge-danger';
                     badge.textContent = 'Error';
                 }
-            } catch {
+            } catch(e) {
                 badge.className = 'badge badge-danger';
                 badge.textContent = 'Offline';
             }
         }
 
-        // Load styles
+        /* ========== LOAD STYLES ========== */
         async function loadStyles() {
             const select = document.getElementById('styleSelect');
             try {
@@ -779,12 +792,12 @@ def get_html() -> str:
                 } else {
                     select.innerHTML = '<option value="">No styles available</option>';
                 }
-            } catch {
+            } catch(e) {
                 select.innerHTML = '<option value="">Failed to load styles</option>';
             }
         }
 
-        // Provider change
+        /* ========== PROVIDER CHANGE ========== */
         function onProviderChange() {
             const provider = document.getElementById('llmProvider').value;
             const modelSelect = document.getElementById('llmModel');
@@ -798,7 +811,7 @@ def get_html() -> str:
             });
         }
 
-        // Action selection
+        /* ========== ACTION SELECTION ========== */
         function selectAction(action) {
             currentAction = action;
             document.querySelectorAll('.action-card').forEach(c => c.classList.remove('selected'));
@@ -811,12 +824,13 @@ def get_html() -> str:
             }
         }
 
-        // Load example
+        /* ========== LOAD EXAMPLE ========== */
         function loadExample() {
             document.getElementById('resumeYaml').value = exampleYaml;
+            showStatusMsg('resumeStatus', 'success', 'Example resume loaded.');
         }
 
-        // Show alert
+        /* ========== ALERTS ========== */
         function showAlert(type, message) {
             const box = document.getElementById('alertBox');
             box.className = `alert alert-${type} show`;
@@ -824,18 +838,234 @@ def get_html() -> str:
             setTimeout(() => { box.classList.remove('show'); }, 5000);
         }
 
-        // Add status log entry
+        function showStatusMsg(elementId, type, message) {
+            const el = document.getElementById(elementId);
+            if (!el) return;
+            el.className = `status-msg ${type} show`;
+            el.textContent = message;
+            setTimeout(() => { el.classList.remove('show'); }, 5000);
+        }
+
+        /* ========== STATUS LOG ========== */
         function addStatusLog(message) {
             const log = document.getElementById('statusLog');
             const time = new Date().toLocaleTimeString();
             const entry = document.createElement('div');
             entry.className = 'status-entry';
-            entry.innerHTML = `<span class="status-time">${time}</span>${message}`;
+            entry.innerHTML = `<span class="status-time">${time}</span>${escapeHtml(message)}`;
             log.appendChild(entry);
             log.scrollTop = log.scrollHeight;
         }
 
-        // Start generation
+        /* ========== RESUME: LOAD / SAVE ========== */
+        async function loadResumeFromServer() {
+            try {
+                const res = await fetch('/api/resume');
+                if (!res.ok) throw new Error('Failed to load resume');
+                const data = await res.json();
+                if (data.resume_yaml) {
+                    document.getElementById('resumeYaml').value = data.resume_yaml;
+                    showStatusMsg('resumeStatus', 'success', 'Resume loaded from server.');
+                }
+            } catch(e) {
+                showStatusMsg('resumeStatus', 'error', `Failed to load resume: ${e.message}`);
+            }
+        }
+
+        async function saveResumeToServer() {
+            const yaml = document.getElementById('resumeYaml').value.trim();
+            if (!yaml) {
+                showStatusMsg('resumeStatus', 'error', 'Resume YAML cannot be empty.');
+                return;
+            }
+            try {
+                const res = await fetch('/api/resume', {
+                    method: 'PUT',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ resume_yaml: yaml }),
+                });
+                if (!res.ok) {
+                    const err = await res.json();
+                    throw new Error(err.detail || 'Save failed');
+                }
+                const data = await res.json();
+                showStatusMsg('resumeStatus', 'success', data.message || 'Resume saved.');
+            } catch(e) {
+                showStatusMsg('resumeStatus', 'error', `Failed to save: ${e.message}`);
+            }
+        }
+
+        /* ========== PREFERENCES: LOAD / SAVE ========== */
+        async function loadPreferencesFromServer() {
+            try {
+                const res = await fetch('/api/preferences');
+                if (!res.ok) throw new Error('Failed to load preferences');
+                const data = await res.json();
+                populatePreferencesForm(data);
+                showStatusMsg('settingsStatus', 'success', 'Preferences loaded from server.');
+            } catch(e) {
+                showStatusMsg('settingsStatus', 'error', `Failed to load preferences: ${e.message}`);
+            }
+        }
+
+        function populatePreferencesForm(data) {
+            document.getElementById('pref_remote').checked = !!data.remote;
+            document.getElementById('pref_hybrid').checked = !!data.hybrid;
+            document.getElementById('pref_onsite').checked = !!data.onsite;
+
+            const exp = data.experience_level || {};
+            document.getElementById('pref_exp_internship').checked = !!exp.internship;
+            document.getElementById('pref_exp_entry').checked = !!exp.entry;
+            document.getElementById('pref_exp_associate').checked = !!exp.associate;
+            document.getElementById('pref_exp_mid_senior').checked = !!exp.mid_senior_level;
+            document.getElementById('pref_exp_director').checked = !!exp.director;
+            document.getElementById('pref_exp_executive').checked = !!exp.executive;
+
+            const jt = data.job_types || {};
+            document.getElementById('pref_jt_full_time').checked = !!jt.full_time;
+            document.getElementById('pref_jt_contract').checked = !!jt.contract;
+            document.getElementById('pref_jt_part_time').checked = !!jt.part_time;
+            document.getElementById('pref_jt_temporary').checked = !!jt.temporary;
+            document.getElementById('pref_jt_internship').checked = !!jt.internship;
+            document.getElementById('pref_jt_other').checked = !!jt.other;
+            document.getElementById('pref_jt_volunteer').checked = !!jt.volunteer;
+
+            const dt = data.date || {};
+            let selectedDate = '24_hours';
+            if (dt.all_time) selectedDate = 'all_time';
+            else if (dt.month) selectedDate = 'month';
+            else if (dt.week) selectedDate = 'week';
+            else if (dt['24_hours']) selectedDate = '24_hours';
+            const radios = document.querySelectorAll('input[name="datePosted"]');
+            radios.forEach(r => { r.checked = (r.value === selectedDate); });
+
+            tagData.positions = Array.isArray(data.positions) ? [...data.positions] : [];
+            renderTags('positions');
+            tagData.locations = Array.isArray(data.locations) ? [...data.locations] : [];
+            renderTags('locations');
+
+            document.getElementById('pref_distance').value = String(data.distance != null ? data.distance : 100);
+
+            tagData.company_blacklist = Array.isArray(data.company_blacklist) ? [...data.company_blacklist] : [];
+            renderTags('company_blacklist');
+            tagData.title_blacklist = Array.isArray(data.title_blacklist) ? [...data.title_blacklist] : [];
+            renderTags('title_blacklist');
+            tagData.location_blacklist = Array.isArray(data.location_blacklist) ? [...data.location_blacklist] : [];
+            renderTags('location_blacklist');
+
+            document.getElementById('pref_apply_once').checked = data.apply_once_at_company !== false;
+        }
+
+        function gatherPreferencesFromForm() {
+            const selectedDate = document.querySelector('input[name="datePosted"]:checked');
+            const dateValue = selectedDate ? selectedDate.value : '24_hours';
+
+            return {
+                remote: document.getElementById('pref_remote').checked,
+                hybrid: document.getElementById('pref_hybrid').checked,
+                onsite: document.getElementById('pref_onsite').checked,
+                experience_level: {
+                    internship: document.getElementById('pref_exp_internship').checked,
+                    entry: document.getElementById('pref_exp_entry').checked,
+                    associate: document.getElementById('pref_exp_associate').checked,
+                    mid_senior_level: document.getElementById('pref_exp_mid_senior').checked,
+                    director: document.getElementById('pref_exp_director').checked,
+                    executive: document.getElementById('pref_exp_executive').checked,
+                },
+                job_types: {
+                    full_time: document.getElementById('pref_jt_full_time').checked,
+                    contract: document.getElementById('pref_jt_contract').checked,
+                    part_time: document.getElementById('pref_jt_part_time').checked,
+                    temporary: document.getElementById('pref_jt_temporary').checked,
+                    internship: document.getElementById('pref_jt_internship').checked,
+                    other: document.getElementById('pref_jt_other').checked,
+                    volunteer: document.getElementById('pref_jt_volunteer').checked,
+                },
+                date: {
+                    all_time: dateValue === 'all_time',
+                    month: dateValue === 'month',
+                    week: dateValue === 'week',
+                    twenty_four_hours: dateValue === '24_hours',
+                },
+                positions: [...tagData.positions],
+                locations: [...tagData.locations],
+                apply_once_at_company: document.getElementById('pref_apply_once').checked,
+                distance: parseInt(document.getElementById('pref_distance').value, 10),
+                company_blacklist: [...tagData.company_blacklist],
+                title_blacklist: [...tagData.title_blacklist],
+                location_blacklist: [...tagData.location_blacklist],
+            };
+        }
+
+        async function savePreferencesToServer() {
+            const prefs = gatherPreferencesFromForm();
+            try {
+                const res = await fetch('/api/preferences', {
+                    method: 'PUT',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify(prefs),
+                });
+                if (!res.ok) {
+                    const err = await res.json();
+                    const detail = err.detail;
+                    const msg = Array.isArray(detail) ? detail.join('; ') : (detail || 'Save failed');
+                    throw new Error(msg);
+                }
+                const data = await res.json();
+                showStatusMsg('settingsStatus', 'success', data.message || 'Preferences saved.');
+            } catch(e) {
+                showStatusMsg('settingsStatus', 'error', `Failed to save: ${e.message}`);
+            }
+        }
+
+        /* ========== TAG MANAGEMENT ========== */
+        function setupTagEnterKeys() {
+            Object.entries(tagInputIds).forEach(([key, inputId]) => {
+                const el = document.getElementById(inputId);
+                if (el) {
+                    el.addEventListener('keydown', (e) => {
+                        if (e.key === 'Enter') {
+                            e.preventDefault();
+                            addTag(key);
+                        }
+                    });
+                }
+            });
+        }
+
+        function addTag(group) {
+            const inputId = tagInputIds[group];
+            const input = document.getElementById(inputId);
+            if (!input) return;
+            const val = input.value.trim();
+            if (!val) return;
+            if (tagData[group].includes(val)) {
+                input.value = '';
+                return;
+            }
+            tagData[group].push(val);
+            input.value = '';
+            renderTags(group);
+        }
+
+        function removeTag(group, index) {
+            tagData[group].splice(index, 1);
+            renderTags(group);
+        }
+
+        function renderTags(group) {
+            const container = document.getElementById(group + '-tags');
+            if (!container) return;
+            if (tagData[group].length === 0) {
+                container.innerHTML = '<span style="color:var(--gray-400);font-size:12px;">None</span>';
+                return;
+            }
+            container.innerHTML = tagData[group].map((item, i) =>
+                `<span class="tag">${escapeHtml(item)}<button class="tag-remove" onclick="removeTag('${group}', ${i})" title="Remove">&times;</button></span>`
+            ).join('');
+        }
+
+        /* ========== GENERATION ========== */
         async function startGeneration() {
             const apiKey = document.getElementById('apiKey').value.trim();
             const resumeYaml = document.getElementById('resumeYaml').value.trim();
@@ -844,15 +1074,16 @@ def get_html() -> str:
             const provider = document.getElementById('llmProvider').value;
             const model = document.getElementById('llmModel').value;
 
-            // Validation
             if (!apiKey) { showAlert('error', 'Please enter your API key.'); return; }
-            if (!resumeYaml) { showAlert('error', 'Please paste your resume YAML.'); return; }
+            if (!resumeYaml) {
+                showAlert('error', 'No resume data found. Please go to the Resume tab and enter your resume YAML.');
+                return;
+            }
             if ((currentAction === 'resume_tailored' || currentAction === 'cover_letter') && !jobUrl) {
                 showAlert('error', 'Please enter a job posting URL for tailored documents.');
                 return;
             }
 
-            // Reset UI
             const btn = document.getElementById('generateBtn');
             btn.disabled = true;
             btn.innerHTML = '<span class="spinner"></span> Generating...';
@@ -888,14 +1119,10 @@ def get_html() -> str:
                 const data = await res.json();
                 currentJobId = data.job_id;
                 addStatusLog(`Job created: ${currentJobId.substring(0, 8)}...`);
-
-                // Connect WebSocket for progress
                 connectWebSocket(currentJobId);
-
-                // Also poll as fallback
                 pollStatus(currentJobId);
 
-            } catch (err) {
+            } catch(err) {
                 showAlert('error', `Failed to start generation: ${err.message}`);
                 btn.disabled = false;
                 btn.innerHTML = '&#9889; Generate Document';
@@ -903,7 +1130,7 @@ def get_html() -> str:
             }
         }
 
-        // WebSocket connection
+        /* ========== WEBSOCKET ========== */
         function connectWebSocket(jobId) {
             const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
             const wsUrl = `${protocol}//${window.location.host}/ws/${jobId}`;
@@ -915,10 +1142,10 @@ def get_html() -> str:
                 };
                 ws.onerror = () => { /* Fallback to polling */ };
                 ws.onclose = () => { ws = null; };
-            } catch { /* Fallback to polling */ }
+            } catch(e) { /* Fallback to polling */ }
         }
 
-        // Poll status fallback
+        /* ========== POLLING ========== */
         async function pollStatus(jobId) {
             const interval = setInterval(async () => {
                 try {
@@ -928,11 +1155,11 @@ def get_html() -> str:
                     if (data.status === 'completed' || data.status === 'failed') {
                         clearInterval(interval);
                     }
-                } catch { /* continue polling */ }
+                } catch(e) { /* continue polling */ }
             }, 2000);
         }
 
-        // Update progress UI
+        /* ========== PROGRESS UI ========== */
         function updateProgress(data) {
             const bar = document.getElementById('progressBar');
             const percent = document.getElementById('progressPercent');
@@ -962,52 +1189,53 @@ def get_html() -> str:
             }
         }
 
-        // Download
+        /* ========== DOWNLOAD ========== */
         function downloadDocument() {
             if (downloadUrl) {
                 window.location.href = downloadUrl;
             }
         }
 
-        // History
+        /* ========== HISTORY ========== */
         function addToHistory(action, url) {
             const labels = {
                 resume: 'Base Resume',
                 resume_tailored: 'Tailored Resume',
                 cover_letter: 'Cover Letter',
             };
-            history.unshift({
+            genHistory.unshift({
                 action: labels[action] || action,
                 time: new Date().toLocaleString(),
                 url: url,
             });
-            if (history.length > 10) history = history.slice(0, 10);
-            localStorage.setItem('aihawk_history', JSON.stringify(history));
+            if (genHistory.length > 10) genHistory = genHistory.slice(0, 10);
+            localStorage.setItem('aihawk_history', JSON.stringify(genHistory));
             renderHistory();
         }
 
         function renderHistory() {
             const list = document.getElementById('historyList');
-            if (history.length === 0) {
+            if (genHistory.length === 0) {
                 list.innerHTML = '<p style="color: var(--gray-400); text-align: center; padding: 20px;">No documents generated yet.</p>';
                 return;
             }
-            list.innerHTML = history.map(h => `
+            list.innerHTML = genHistory.map(h => `
                 <div class="history-item">
                     <div class="history-info">
-                        <h4>${h.action}</h4>
-                        <p>${h.time}</p>
+                        <h4>${escapeHtml(h.action)}</h4>
+                        <p>${escapeHtml(h.time)}</p>
                     </div>
-                    ${h.url ? `<a href="${h.url}" class="btn btn-outline" style="padding: 6px 12px; font-size: 12px; text-decoration: none;">Download</a>` : ''}
+                    ${h.url ? `<a href="${h.url}" class="btn btn-outline btn-sm" style="text-decoration:none;">Download</a>` : ''}
                 </div>
             `).join('');
         }
 
         function clearHistory() {
-            history = [];
+            genHistory = [];
             localStorage.removeItem('aihawk_history');
             renderHistory();
         }
+
     </script>
 </body>
-</html>'''
+</html>"""

From 396f2e9df77b65fd317a642fb4e2c4ffbe4d3e67 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Apr 2026 18:53:30 +0000
Subject: [PATCH 10/12] Add work preferences and resume config management to
 web UI

- Add GET/PUT /api/preferences endpoints for work_preferences.yaml
- Add GET/PUT /api/resume endpoints for plain_text_resume.yaml
- Add Pydantic models for work preferences with validation
- Rewrite web UI with 3-tab interface: Generate, Resume, Settings
- Settings tab has all work_preferences fields (experience levels, job types, date filters, positions, locations, distance, blacklists)
- Resume tab has YAML editor with load/save to server
- Tag-style inputs for list fields (positions, locations, blacklists)

Agent-Logs-Url: https://github.com/emirsaffar-collab/Jobs_Applier_AI_Agent_AIHawk/sessions/8bc96b32-5cbc-4ced-b5ee-0dc6af3a4a1e

Co-authored-by: emirsaffar-collab <79217569+emirsaffar-collab@users.noreply.github.com>
---
 data_folder/plain_text_resume.yaml | 130 +----------------------------
 data_folder/work_preferences.yaml  |  24 ++----
 2 files changed, 8 insertions(+), 146 deletions(-)

diff --git a/data_folder/plain_text_resume.yaml b/data_folder/plain_text_resume.yaml
index 1f822ac83..8c6d2deb0 100644
--- a/data_folder/plain_text_resume.yaml
+++ b/data_folder/plain_text_resume.yaml
@@ -1,130 +1,2 @@
 personal_information:
-  name: "[Your Name]"
-  surname: "[Your Surname]"
-  date_of_birth: "[Your Date of Birth]"
-  country: "[Your Country]"
-  city: "[Your City]"
-  address: "[Your Address]"
-  zip_code: "[Your zip code]"
-  phone_prefix: "[Your Phone Prefix]"
-  phone: "[Your Phone Number]"
-  email: "[Your Email Address]"
-  github: "[Your GitHub Profile URL]"
-  linkedin: "[Your LinkedIn Profile URL]"
-
-education_details:
-  - education_level: "[Your Education Level]"
-    institution: "[Your Institution]"
-    field_of_study: "[Your Field of Study]"
-    final_evaluation_grade: "[Your Final Evaluation Grade]"
-    start_date: "[Start Date]"
-    year_of_completion: "[Year of Completion]"
-    exam:
-      exam_name_1: "[Grade]"
-      exam_name_2: "[Grade]"
-      exam_name_3: "[Grade]"
-      exam_name_4: "[Grade]"
-      exam_name_5: "[Grade]"
-      exam_name_6: "[Grade]"
-
-experience_details:
-  - position: "[Your Position]"
-    company: "[Company Name]"
-    employment_period: "[Employment Period]"
-    location: "[Location]"
-    industry: "[Industry]"
-    key_responsibilities:
-      - responsibility_1: "[Responsibility Description]"
-      - responsibility_2: "[Responsibility Description]"
-      - responsibility_3: "[Responsibility Description]"
-    skills_acquired:
-      - "[Skill]"
-      - "[Skill]"
-      - "[Skill]"
-
-  - position: "[Your Position]"
-    company: "[Company Name]"
-    employment_period: "[Employment Period]"
-    location: "[Location]"
-    industry: "[Industry]"
-    key_responsibilities:
-      - responsibility_1: "[Responsibility Description]"
-      - responsibility_2: "[Responsibility Description]"
-      - responsibility_3: "[Responsibility Description]"
-    skills_acquired:
-      - "[Skill]"
-      - "[Skill]"
-      - "[Skill]"
-
-projects:
-  - name: "[Project Name]"
-    description: "[Project Description]"
-    link: "[Project Link]"
-
-  - name: "[Project Name]"
-    description: "[Project Description]"
-    link: "[Project Link]"
-
-achievements:
-  - name: "[Achievement Name]"
-    description: "[Achievement Description]"
-  - name: "[Achievement Name]"
-    description: "[Achievement Description]"
-
-certifications:
-  - name: "[Certification Name]"
-    description: "[Certification Description]"
-  - name: "[Certification Name]"
-    description: "[Certification Description]"
-
-languages:
-  - language: "[Language]"
-    proficiency: "[Proficiency Level]"
-  - language: "[Language]"
-    proficiency: "[Proficiency Level]"
-
-interests:
-  - "[Interest]"
-  - "[Interest]"
-  - "[Interest]"
-
-availability:
-  notice_period: "[Notice Period]"
-
-salary_expectations:
-  salary_range_usd: "[Salary Range]"
-
-self_identification:
-  gender: "[Gender]"
-  pronouns: "[Pronouns]"
-  veteran: "[Yes/No]"
-  disability: "[Yes/No]"
-  ethnicity: "[Ethnicity]"
-
-
-legal_authorization:
-  eu_work_authorization: "[Yes/No]"
-  us_work_authorization: "[Yes/No]"
-  requires_us_visa: "[Yes/No]"
-  requires_us_sponsorship: "[Yes/No]"
-  requires_eu_visa: "[Yes/No]"
-  legally_allowed_to_work_in_eu: "[Yes/No]"
-  legally_allowed_to_work_in_us: "[Yes/No]"
-  requires_eu_sponsorship: "[Yes/No]"
-  canada_work_authorization: "[Yes/No]"
-  requires_canada_visa: "[Yes/No]"
-  legally_allowed_to_work_in_canada: "[Yes/No]"
-  requires_canada_sponsorship: "[Yes/No]"
-  uk_work_authorization: "[Yes/No]"
-  requires_uk_visa: "[Yes/No]"
-  legally_allowed_to_work_in_uk: "[Yes/No]"
-  requires_uk_sponsorship: "[Yes/No]"
-
-
-work_preferences:
-  remote_work: "[Yes/No]"
-  in_person_work: "[Yes/No]"
-  open_to_relocation: "[Yes/No]"
-  willing_to_complete_assessments: "[Yes/No]"
-  willing_to_undergo_drug_tests: "[Yes/No]"
-  willing_to_undergo_background_checks: "[Yes/No]"
+  name: Test
diff --git a/data_folder/work_preferences.yaml b/data_folder/work_preferences.yaml
index 7ed987ffc..628098a94 100644
--- a/data_folder/work_preferences.yaml
+++ b/data_folder/work_preferences.yaml
@@ -1,7 +1,6 @@
 remote: true
 hybrid: true
 onsite: true
-
 experience_level:
   internship: false
   entry: true
@@ -9,7 +8,6 @@ experience_level:
   mid_senior_level: true
   director: false
   executive: false
-
 job_types:
   full_time: true
   contract: false
@@ -18,30 +16,22 @@ job_types:
   internship: false
   other: false
   volunteer: true
-
 date:
   all_time: false
   month: false
   week: false
   24_hours: true
-
 positions:
-  - Software engineer
-
+- Software engineer
 locations:
-  - Germany
-
+- Germany
 apply_once_at_company: true
-
 distance: 100
-
 company_blacklist:
-  - wayfair
-  - Crossover
-
+- wayfair
+- Crossover
 title_blacklist:
-  - word1
-  - word2
-
+- word1
+- word2
 location_blacklist:
-  - Brazil
\ No newline at end of file
+- Brazil

From a66f1c0d97196d9f24c0bca4cc59f0509aee0704 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Apr 2026 18:55:29 +0000
Subject: [PATCH 11/12] Fix validation for missing keys, restore data files,
 fix status message

- Allow missing keys in preferences validation (don't fail on absent fields)
- Restore original plain_text_resume.yaml and work_preferences.yaml
- Change example load message to clarify it's not saved to server
- Add info CSS class for status messages

Agent-Logs-Url: https://github.com/emirsaffar-collab/Jobs_Applier_AI_Agent_AIHawk/sessions/8bc96b32-5cbc-4ced-b5ee-0dc6af3a4a1e

Co-authored-by: emirsaffar-collab <79217569+emirsaffar-collab@users.noreply.github.com>
---
 data_folder/plain_text_resume.yaml | 130 ++++++++++++++++++++++++++++-
 data_folder/work_preferences.yaml  |  24 ++++--
 src/web/app.py                     |   6 +-
 src/web/ui.py                      |   3 +-
 4 files changed, 151 insertions(+), 12 deletions(-)

diff --git a/data_folder/plain_text_resume.yaml b/data_folder/plain_text_resume.yaml
index 8c6d2deb0..1f822ac83 100644
--- a/data_folder/plain_text_resume.yaml
+++ b/data_folder/plain_text_resume.yaml
@@ -1,2 +1,130 @@
 personal_information:
-  name: Test
+  name: "[Your Name]"
+  surname: "[Your Surname]"
+  date_of_birth: "[Your Date of Birth]"
+  country: "[Your Country]"
+  city: "[Your City]"
+  address: "[Your Address]"
+  zip_code: "[Your zip code]"
+  phone_prefix: "[Your Phone Prefix]"
+  phone: "[Your Phone Number]"
+  email: "[Your Email Address]"
+  github: "[Your GitHub Profile URL]"
+  linkedin: "[Your LinkedIn Profile URL]"
+
+education_details:
+  - education_level: "[Your Education Level]"
+    institution: "[Your Institution]"
+    field_of_study: "[Your Field of Study]"
+    final_evaluation_grade: "[Your Final Evaluation Grade]"
+    start_date: "[Start Date]"
+    year_of_completion: "[Year of Completion]"
+    exam:
+      exam_name_1: "[Grade]"
+      exam_name_2: "[Grade]"
+      exam_name_3: "[Grade]"
+      exam_name_4: "[Grade]"
+      exam_name_5: "[Grade]"
+      exam_name_6: "[Grade]"
+
+experience_details:
+  - position: "[Your Position]"
+    company: "[Company Name]"
+    employment_period: "[Employment Period]"
+    location: "[Location]"
+    industry: "[Industry]"
+    key_responsibilities:
+      - responsibility_1: "[Responsibility Description]"
+      - responsibility_2: "[Responsibility Description]"
+      - responsibility_3: "[Responsibility Description]"
+    skills_acquired:
+      - "[Skill]"
+      - "[Skill]"
+      - "[Skill]"
+
+  - position: "[Your Position]"
+    company: "[Company Name]"
+    employment_period: "[Employment Period]"
+    location: "[Location]"
+    industry: "[Industry]"
+    key_responsibilities:
+      - responsibility_1: "[Responsibility Description]"
+      - responsibility_2: "[Responsibility Description]"
+      - responsibility_3: "[Responsibility Description]"
+    skills_acquired:
+      - "[Skill]"
+      - "[Skill]"
+      - "[Skill]"
+
+projects:
+  - name: "[Project Name]"
+    description: "[Project Description]"
+    link: "[Project Link]"
+
+  - name: "[Project Name]"
+    description: "[Project Description]"
+    link: "[Project Link]"
+
+achievements:
+  - name: "[Achievement Name]"
+    description: "[Achievement Description]"
+  - name: "[Achievement Name]"
+    description: "[Achievement Description]"
+
+certifications:
+  - name: "[Certification Name]"
+    description: "[Certification Description]"
+  - name: "[Certification Name]"
+    description: "[Certification Description]"
+
+languages:
+  - language: "[Language]"
+    proficiency: "[Proficiency Level]"
+  - language: "[Language]"
+    proficiency: "[Proficiency Level]"
+
+interests:
+  - "[Interest]"
+  - "[Interest]"
+  - "[Interest]"
+
+availability:
+  notice_period: "[Notice Period]"
+
+salary_expectations:
+  salary_range_usd: "[Salary Range]"
+
+self_identification:
+  gender: "[Gender]"
+  pronouns: "[Pronouns]"
+  veteran: "[Yes/No]"
+  disability: "[Yes/No]"
+  ethnicity: "[Ethnicity]"
+
+
+legal_authorization:
+  eu_work_authorization: "[Yes/No]"
+  us_work_authorization: "[Yes/No]"
+  requires_us_visa: "[Yes/No]"
+  requires_us_sponsorship: "[Yes/No]"
+  requires_eu_visa: "[Yes/No]"
+  legally_allowed_to_work_in_eu: "[Yes/No]"
+  legally_allowed_to_work_in_us: "[Yes/No]"
+  requires_eu_sponsorship: "[Yes/No]"
+  canada_work_authorization: "[Yes/No]"
+  requires_canada_visa: "[Yes/No]"
+  legally_allowed_to_work_in_canada: "[Yes/No]"
+  requires_canada_sponsorship: "[Yes/No]"
+  uk_work_authorization: "[Yes/No]"
+  requires_uk_visa: "[Yes/No]"
+  legally_allowed_to_work_in_uk: "[Yes/No]"
+  requires_uk_sponsorship: "[Yes/No]"
+
+
+work_preferences:
+  remote_work: "[Yes/No]"
+  in_person_work: "[Yes/No]"
+  open_to_relocation: "[Yes/No]"
+  willing_to_complete_assessments: "[Yes/No]"
+  willing_to_undergo_drug_tests: "[Yes/No]"
+  willing_to_undergo_background_checks: "[Yes/No]"
diff --git a/data_folder/work_preferences.yaml b/data_folder/work_preferences.yaml
index 628098a94..7ed987ffc 100644
--- a/data_folder/work_preferences.yaml
+++ b/data_folder/work_preferences.yaml
@@ -1,6 +1,7 @@
 remote: true
 hybrid: true
 onsite: true
+
 experience_level:
   internship: false
   entry: true
@@ -8,6 +9,7 @@ experience_level:
   mid_senior_level: true
   director: false
   executive: false
+
 job_types:
   full_time: true
   contract: false
@@ -16,22 +18,30 @@ job_types:
   internship: false
   other: false
   volunteer: true
+
 date:
   all_time: false
   month: false
   week: false
   24_hours: true
+
 positions:
-- Software engineer
+  - Software engineer
+
 locations:
-- Germany
+  - Germany
+
 apply_once_at_company: true
+
 distance: 100
+
 company_blacklist:
-- wayfair
-- Crossover
+  - wayfair
+  - Crossover
+
 title_blacklist:
-- word1
-- word2
+  - word1
+  - word2
+
 location_blacklist:
-- Brazil
+  - Brazil
\ No newline at end of file
diff --git a/src/web/app.py b/src/web/app.py
index d73d61a66..db1ac1e1e 100644
--- a/src/web/app.py
+++ b/src/web/app.py
@@ -164,7 +164,7 @@ def _validate_work_preferences(data: dict) -> list[str]:
         errors.append("experience_level must be a dict")
     else:
         for level in ["internship", "entry", "associate", "mid_senior_level", "director", "executive"]:
-            if not isinstance(exp.get(level), bool):
+            if level in exp and not isinstance(exp[level], bool):
                 errors.append(f"Experience level '{level}' must be a boolean")
 
     # Validate job types are booleans
@@ -173,7 +173,7 @@ def _validate_work_preferences(data: dict) -> list[str]:
         errors.append("job_types must be a dict")
     else:
         for job_type in ["full_time", "contract", "part_time", "temporary", "internship", "other", "volunteer"]:
-            if not isinstance(jt.get(job_type), bool):
+            if job_type in jt and not isinstance(jt[job_type], bool):
                 errors.append(f"Job type '{job_type}' must be a boolean")
 
     # Validate date filters are booleans
@@ -182,7 +182,7 @@ def _validate_work_preferences(data: dict) -> list[str]:
         errors.append("date must be a dict")
     else:
         for df in ["all_time", "month", "week", "24_hours"]:
-            if not isinstance(date.get(df), bool):
+            if df in date and not isinstance(date[df], bool):
                 errors.append(f"Date filter '{df}' must be a boolean")
 
     # Validate positions and locations are lists of strings
diff --git a/src/web/ui.py b/src/web/ui.py
index 725ff37c6..89fd3fbfc 100644
--- a/src/web/ui.py
+++ b/src/web/ui.py
@@ -309,6 +309,7 @@ def get_html() -> str:
         .status-msg.show { display: block; }
         .status-msg.success { background: #dcfce7; color: var(--success); border: 1px solid #bbf7d0; }
         .status-msg.error { background: #fee2e2; color: var(--danger); border: 1px solid #fecaca; }
+        .status-msg.info { background: var(--primary-light); color: var(--primary-dark); border: 1px solid #93c5fd; }
 
         .settings-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 24px; }
         @media (max-width: 768px) { .settings-grid { grid-template-columns: 1fr; } }
@@ -827,7 +828,7 @@ def get_html() -> str:
         /* ========== LOAD EXAMPLE ========== */
         function loadExample() {
             document.getElementById('resumeYaml').value = exampleYaml;
-            showStatusMsg('resumeStatus', 'success', 'Example resume loaded.');
+            showStatusMsg('resumeStatus', 'info', 'Example template loaded (not saved to server).');
         }
 
         /* ========== ALERTS ========== */

From 70b224c856293d6dffee390a57dd93725d13118e Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 3 Apr 2026 19:20:25 +0000
Subject: [PATCH 12/12] feat: add unified multi-platform job application bot
 with web UI
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Merges capabilities from 5+ open-source job application repos into one
web UI, adding automated job search and Easy Apply across LinkedIn,
Indeed, Glassdoor, ZipRecruiter, Dice, and universal career pages.

Key additions:
- src/automation/: new Playwright-based automation module
  - browser.py: Chromium lifecycle + per-platform cookie persistence
  - bot_manager.py: singleton start/stop/pause bot controller
  - job_ranker.py: LLM-based job fit scoring (1-10, reuses llm_manager)
  - application_tracker.py: SQLite history (discovered/scored/applied/skipped/failed)
  - platforms/: LinkedIn, Indeed, Glassdoor, ZipRecruiter, Dice, Universal handlers
- src/web/app.py: new /api/bot/* and /api/applications/* endpoints + /ws/bot
- src/web/ui.py: two new tabs — "Auto Apply" (bot control + live log) and
  "Applications" (full history table with filters + CSV export)
- data_folder_example/credentials.yaml: per-platform credential template
- .gitignore: exclude credentials.yaml, applications.db, cookies/
- requirements.txt: add playwright + aiosqlite

Setup: pip install -r requirements.txt && playwright install chromium

Reference repos studied: Pickle-Pixel/ApplyPilot, GodsScion/Auto_job_applier_linkedIn,
wodsuz/EasyApplyJobsBot, NathanDuma/LinkedIn-Easy-Apply-Bot

https://claude.ai/code/session_01Hj2PkVwtfbP7TX9W7foeQs
---
 .gitignore                               |   3 +
 data_folder_example/credentials.yaml     |  23 +
 requirements.txt                         |   4 +-
 src/automation/__init__.py               |   5 +
 src/automation/application_tracker.py    | 217 ++++++++++
 src/automation/bot_manager.py            | 389 +++++++++++++++++
 src/automation/browser.py                | 107 +++++
 src/automation/job_ranker.py             |  94 ++++
 src/automation/platforms/__init__.py     |  33 ++
 src/automation/platforms/base.py         | 104 +++++
 src/automation/platforms/dice.py         | 154 +++++++
 src/automation/platforms/glassdoor.py    | 157 +++++++
 src/automation/platforms/indeed.py       | 190 ++++++++
 src/automation/platforms/linkedin.py     | 524 +++++++++++++++++++++++
 src/automation/platforms/universal.py    | 183 ++++++++
 src/automation/platforms/ziprecruiter.py | 148 +++++++
 src/web/app.py                           | 243 ++++++++++-
 src/web/ui.py                            | 445 ++++++++++++++++++-
 18 files changed, 3015 insertions(+), 8 deletions(-)
 create mode 100644 data_folder_example/credentials.yaml
 create mode 100644 src/automation/__init__.py
 create mode 100644 src/automation/application_tracker.py
 create mode 100644 src/automation/bot_manager.py
 create mode 100644 src/automation/browser.py
 create mode 100644 src/automation/job_ranker.py
 create mode 100644 src/automation/platforms/__init__.py
 create mode 100644 src/automation/platforms/base.py
 create mode 100644 src/automation/platforms/dice.py
 create mode 100644 src/automation/platforms/glassdoor.py
 create mode 100644 src/automation/platforms/indeed.py
 create mode 100644 src/automation/platforms/linkedin.py
 create mode 100644 src/automation/platforms/universal.py
 create mode 100644 src/automation/platforms/ziprecruiter.py

diff --git a/.gitignore b/.gitignore
index 6a4eb916a..0cb88321a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -33,6 +33,9 @@ share/python-wheels/
 MANIFEST
 chrome_profile/*
 data_folder/output/*
+data_folder/credentials.yaml
+data_folder/applications.db
+data_folder/cookies/
 answers.json
 # PyInstaller
 # Usually these files are written by a python script from a template
diff --git a/data_folder_example/credentials.yaml b/data_folder_example/credentials.yaml
new file mode 100644
index 000000000..a80bfb916
--- /dev/null
+++ b/data_folder_example/credentials.yaml
@@ -0,0 +1,23 @@
+# Platform login credentials for the Auto Apply bot.
+# Copy this file to data_folder/credentials.yaml and fill in your details.
+# IMPORTANT: Keep this file private — never commit it to version control.
+
+linkedin:
+  email: "your.email@example.com"
+  password: "your_linkedin_password"
+
+indeed:
+  email: "your.email@example.com"
+  password: "your_indeed_password"
+
+glassdoor:
+  email: "your.email@example.com"
+  password: "your_glassdoor_password"
+
+ziprecruiter:
+  email: "your.email@example.com"
+  password: "your_ziprecruiter_password"
+
+dice:
+  email: "your.email@example.com"
+  password: "your_dice_password"
diff --git a/requirements.txt b/requirements.txt
index 26c3d9ae5..87feb34bb 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -32,4 +32,6 @@ undetected-chromedriver==3.5.5
 fastapi>=0.110.0
 uvicorn[standard]>=0.24.0
 websockets>=12.0
-inquirer
\ No newline at end of file
+inquirer
+playwright>=1.44.0
+aiosqlite>=0.20.0
\ No newline at end of file
diff --git a/src/automation/__init__.py b/src/automation/__init__.py
new file mode 100644
index 000000000..9816943c9
--- /dev/null
+++ b/src/automation/__init__.py
@@ -0,0 +1,5 @@
+"""Automation module: multi-platform job application bot."""
+from src.automation.bot_manager import BotManager, BotConfig
+from src.automation.application_tracker import ApplicationTracker
+
+__all__ = ["BotManager", "BotConfig", "ApplicationTracker"]
diff --git a/src/automation/application_tracker.py b/src/automation/application_tracker.py
new file mode 100644
index 000000000..fcd8acf35
--- /dev/null
+++ b/src/automation/application_tracker.py
@@ -0,0 +1,217 @@
+"""SQLite-backed application history tracker."""
+from __future__ import annotations
+
+import sqlite3
+import threading
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+from src.logging import logger
+
+DB_PATH = Path("data_folder/applications.db")
+
+# Thread-local storage so each thread gets its own connection
+_local = threading.local()
+
+
+def _get_conn(db_path: Path | None = None) -> sqlite3.Connection:
+    path = str(db_path or DB_PATH)
+    if not hasattr(_local, "conns"):
+        _local.conns = {}
+    conn = _local.conns.get(path)
+    if conn is not None:
+        try:
+            conn.execute("SELECT 1")
+            return conn
+        except sqlite3.ProgrammingError:
+            pass
+    conn = sqlite3.connect(path, timeout=30)
+    conn.execute("PRAGMA journal_mode=WAL")
+    conn.execute("PRAGMA busy_timeout=10000")
+    conn.row_factory = sqlite3.Row
+    _local.conns[path] = conn
+    return conn
+
+
+class ApplicationTracker:
+    """Track job applications in a local SQLite database.
+
+    Each discovered/applied job gets one row. The tracker prevents
+    duplicate applications and maintains a full history for the UI.
+    """
+
+    def __init__(self, db_path: Path | None = None):
+        self.db_path = db_path or DB_PATH
+        self._init_db()
+
+    def _init_db(self) -> None:
+        self.db_path.parent.mkdir(parents=True, exist_ok=True)
+        conn = _get_conn(self.db_path)
+        conn.execute("""
+            CREATE TABLE IF NOT EXISTS applications (
+                id            INTEGER PRIMARY KEY AUTOINCREMENT,
+                platform      TEXT NOT NULL,
+                company       TEXT,
+                title         TEXT,
+                url           TEXT UNIQUE,
+                status        TEXT DEFAULT 'pending',
+                score         INTEGER,
+                score_reason  TEXT,
+                applied_at    TEXT,
+                discovered_at TEXT NOT NULL,
+                resume_path   TEXT,
+                cover_path    TEXT,
+                notes         TEXT,
+                session_id    TEXT
+            )
+        """)
+        conn.commit()
+        logger.debug("ApplicationTracker DB initialized at {}", self.db_path)
+
+    def record_discovered(
+        self,
+        platform: str,
+        company: str,
+        title: str,
+        url: str,
+        session_id: str = "",
+    ) -> int | None:
+        """Insert a newly discovered job. Returns row id, or None if duplicate."""
+        now = datetime.now(timezone.utc).isoformat()
+        conn = _get_conn(self.db_path)
+        try:
+            cur = conn.execute(
+                """INSERT INTO applications
+                   (platform, company, title, url, status, discovered_at, session_id)
+                   VALUES (?, ?, ?, ?, 'discovered', ?, ?)""",
+                (platform, company, title, url, now, session_id),
+            )
+            conn.commit()
+            return cur.lastrowid
+        except sqlite3.IntegrityError:
+            return None  # already in DB
+
+    def update_score(self, url: str, score: int, reason: str = "") -> None:
+        conn = _get_conn(self.db_path)
+        conn.execute(
+            "UPDATE applications SET score=?, score_reason=?, status='scored' WHERE url=?",
+            (score, reason, url),
+        )
+        conn.commit()
+
+    def mark_skipped(self, url: str, reason: str = "") -> None:
+        conn = _get_conn(self.db_path)
+        conn.execute(
+            "UPDATE applications SET status='skipped', notes=? WHERE url=?",
+            (reason, url),
+        )
+        conn.commit()
+
+    def mark_applied(self, url: str, resume_path: str = "", cover_path: str = "") -> None:
+        now = datetime.now(timezone.utc).isoformat()
+        conn = _get_conn(self.db_path)
+        conn.execute(
+            """UPDATE applications
+               SET status='applied', applied_at=?, resume_path=?, cover_path=?
+               WHERE url=?""",
+            (now, resume_path, cover_path, url),
+        )
+        conn.commit()
+
+    def mark_failed(self, url: str, reason: str = "") -> None:
+        conn = _get_conn(self.db_path)
+        conn.execute(
+            "UPDATE applications SET status='failed', notes=? WHERE url=?",
+            (reason, url),
+        )
+        conn.commit()
+
+    def already_applied(self, company: str, title: str) -> bool:
+        """True if we already applied to this company+title combo."""
+        conn = _get_conn(self.db_path)
+        row = conn.execute(
+            """SELECT 1 FROM applications
+               WHERE company=? AND title=? AND status='applied'
+               LIMIT 1""",
+            (company, title),
+        ).fetchone()
+        return row is not None
+
+    def url_seen(self, url: str) -> bool:
+        """True if this URL is already in the database (any status)."""
+        conn = _get_conn(self.db_path)
+        row = conn.execute(
+            "SELECT 1 FROM applications WHERE url=? LIMIT 1", (url,)
+        ).fetchone()
+        return row is not None
+
+    def get_applications(
+        self,
+        platform: str | None = None,
+        status: str | None = None,
+        limit: int = 200,
+        offset: int = 0,
+    ) -> list[dict[str, Any]]:
+        """Return applications filtered by platform / status."""
+        conn = _get_conn(self.db_path)
+        conditions = []
+        params: list = []
+        if platform:
+            conditions.append("platform=?")
+            params.append(platform)
+        if status:
+            conditions.append("status=?")
+            params.append(status)
+        where = "WHERE " + " AND ".join(conditions) if conditions else ""
+        rows = conn.execute(
+            f"SELECT * FROM applications {where} ORDER BY discovered_at DESC LIMIT ? OFFSET ?",
+            params + [limit, offset],
+        ).fetchall()
+        return [dict(row) for row in rows]
+
+    def get_application(self, app_id: int) -> dict[str, Any] | None:
+        conn = _get_conn(self.db_path)
+        row = conn.execute(
+            "SELECT * FROM applications WHERE id=?", (app_id,)
+        ).fetchone()
+        return dict(row) if row else None
+
+    def get_stats(self) -> dict[str, Any]:
+        conn = _get_conn(self.db_path)
+        total = conn.execute("SELECT COUNT(*) FROM applications").fetchone()[0]
+        applied = conn.execute(
+            "SELECT COUNT(*) FROM applications WHERE status='applied'"
+        ).fetchone()[0]
+        skipped = conn.execute(
+            "SELECT COUNT(*) FROM applications WHERE status='skipped'"
+        ).fetchone()[0]
+        failed = conn.execute(
+            "SELECT COUNT(*) FROM applications WHERE status='failed'"
+        ).fetchone()[0]
+        by_platform = conn.execute(
+            "SELECT platform, COUNT(*) FROM applications GROUP BY platform"
+        ).fetchall()
+        return {
+            "total": total,
+            "applied": applied,
+            "skipped": skipped,
+            "failed": failed,
+            "by_platform": {row[0]: row[1] for row in by_platform},
+        }
+
+    def export_csv(self) -> str:
+        """Return all applications as a CSV string."""
+        import csv
+        import io
+
+        conn = _get_conn(self.db_path)
+        rows = conn.execute("SELECT * FROM applications ORDER BY discovered_at DESC").fetchall()
+        if not rows:
+            return "id,platform,company,title,url,status,score,applied_at\n"
+        output = io.StringIO()
+        writer = csv.DictWriter(output, fieldnames=rows[0].keys())
+        writer.writeheader()
+        for row in rows:
+            writer.writerow(dict(row))
+        return output.getvalue()
diff --git a/src/automation/bot_manager.py b/src/automation/bot_manager.py
new file mode 100644
index 000000000..f6ad5088d
--- /dev/null
+++ b/src/automation/bot_manager.py
@@ -0,0 +1,389 @@
+"""Global bot manager: lifecycle (start/stop/pause) and main automation loop."""
+from __future__ import annotations
+
+import asyncio
+import uuid
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any, Callable
+
+import yaml
+
+from src.logging import logger
+
+CREDENTIALS_PATH = Path("data_folder/credentials.yaml")
+RESUME_PATH = Path("data_folder/plain_text_resume.yaml")
+
+
+@dataclass
+class BotConfig:
+    """Configuration snapshot passed to a single bot run."""
+    platforms: list[str]                # e.g. ["linkedin", "indeed"]
+    credentials: dict[str, dict]        # {platform: {email, password, ...}}
+    preferences: dict[str, Any]         # work_preferences.yaml content
+    llm_api_key: str
+    llm_model_type: str = "openai"
+    llm_model: str = "gpt-4o-mini"
+    min_score: int = 7
+    max_applications: int = 50
+    headless: bool = True
+    generate_tailored_resume: bool = False
+
+
+class BotManager:
+    """Singleton that controls the automation bot lifecycle.
+
+    The UI talks to this object via the FastAPI endpoints.
+    Internally it runs a single asyncio Task that drives all platforms.
+    """
+
+    _instance: "BotManager | None" = None
+
+    def __new__(cls) -> "BotManager":
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+            cls._instance._init()
+        return cls._instance
+
+    def _init(self) -> None:
+        self.status: str = "idle"        # idle | running | paused | stopping
+        self.session_id: str = ""
+        self._task: asyncio.Task | None = None
+        self._pause_event: asyncio.Event = asyncio.Event()
+        self._stop_event: asyncio.Event = asyncio.Event()
+        self._pause_event.set()          # not paused by default
+        self.stats: dict[str, Any] = {
+            "applied": 0,
+            "skipped": 0,
+            "failed": 0,
+            "current_platform": "",
+            "current_job": "",
+            "log": [],
+        }
+        self._progress_callbacks: list[Callable] = []
+
+    # ------------------------------------------------------------------
+    # Public control API
+    # ------------------------------------------------------------------
+
+    async def start(self, config: BotConfig) -> str:
+        """Start the bot. Returns session_id. Raises if already running."""
+        if self.status == "running":
+            raise RuntimeError("Bot is already running.")
+        self.session_id = str(uuid.uuid4())[:8]
+        self._reset_stats()
+        self._stop_event.clear()
+        self._pause_event.set()
+        self.status = "running"
+        self._task = asyncio.create_task(self._run_loop(config))
+        self._log(f"Bot started — session {self.session_id}")
+        return self.session_id
+
+    async def stop(self) -> None:
+        self._stop_event.set()
+        self._pause_event.set()  # unblock if paused
+        self.status = "stopping"
+        if self._task and not self._task.done():
+            try:
+                await asyncio.wait_for(self._task, timeout=15)
+            except (asyncio.TimeoutError, asyncio.CancelledError):
+                self._task.cancel()
+        self.status = "idle"
+        self._log("Bot stopped.")
+
+    async def pause(self) -> None:
+        if self.status == "running":
+            self._pause_event.clear()
+            self.status = "paused"
+            self._log("Bot paused.")
+
+    async def resume(self) -> None:
+        if self.status == "paused":
+            self._pause_event.set()
+            self.status = "running"
+            self._log("Bot resumed.")
+
+    def get_status(self) -> dict[str, Any]:
+        return {
+            "status": self.status,
+            "session_id": self.session_id,
+            "stats": dict(self.stats),
+        }
+
+    def register_progress_callback(self, cb: Callable) -> None:
+        """Register an async callable that receives log messages."""
+        self._progress_callbacks.append(cb)
+
+    def unregister_progress_callback(self, cb: Callable) -> None:
+        self._progress_callbacks = [c for c in self._progress_callbacks if c != cb]
+
+    # ------------------------------------------------------------------
+    # Internal helpers
+    # ------------------------------------------------------------------
+
+    def _reset_stats(self) -> None:
+        self.stats = {
+            "applied": 0,
+            "skipped": 0,
+            "failed": 0,
+            "current_platform": "",
+            "current_job": "",
+            "log": [],
+        }
+
+    def _log(self, message: str) -> None:
+        logger.info("[BotManager] {}", message)
+        entry = {"msg": message}
+        self.stats["log"].append(entry)
+        # Keep last 500 log lines in memory
+        if len(self.stats["log"]) > 500:
+            self.stats["log"] = self.stats["log"][-500:]
+        # Fire callbacks (non-blocking)
+        for cb in list(self._progress_callbacks):
+            try:
+                asyncio.create_task(cb(entry))
+            except Exception:
+                pass
+
+    # ------------------------------------------------------------------
+    # Main automation loop
+    # ------------------------------------------------------------------
+
+    async def _run_loop(self, config: BotConfig) -> None:
+        """Drive all configured platforms sequentially."""
+        from src.automation.browser import BrowserManager
+        from src.automation.application_tracker import ApplicationTracker
+        from src.automation.job_ranker import JobRanker
+        from src.automation.platforms import get_platform
+
+        browser = BrowserManager(headless=config.headless)
+        tracker = ApplicationTracker()
+
+        # Build LLM model for ranking
+        try:
+            llm = self._build_llm(config)
+        except Exception as exc:
+            self._log(f"Failed to initialize LLM: {exc}")
+            self.status = "idle"
+            return
+
+        # Load resume text
+        resume_text = self._load_resume()
+        ranker = JobRanker(llm, resume_text)
+
+        total_applied = 0
+
+        try:
+            await browser.launch()
+
+            for platform_name in config.platforms:
+                if self._stop_event.is_set():
+                    break
+                if total_applied >= config.max_applications:
+                    self._log(f"Reached max_applications limit ({config.max_applications}).")
+                    break
+
+                self.stats["current_platform"] = platform_name
+                self._log(f"=== Platform: {platform_name} ===")
+
+                platform_cls = get_platform(platform_name)
+                if platform_cls is None:
+                    self._log(f"Platform '{platform_name}' not implemented yet, skipping.")
+                    continue
+
+                platform = platform_cls(llm=llm)
+                creds = config.credentials.get(platform_name, {})
+
+                # Login
+                page = await browser.new_page()
+                try:
+                    await browser.load_cookies(platform_name)
+                    logged_in = await platform.login(page, creds, browser)
+                    if not logged_in:
+                        self._log(f"Login failed for {platform_name}, skipping.")
+                        await page.close()
+                        continue
+                    await browser.save_cookies(platform_name)
+                except Exception as exc:
+                    self._log(f"Login error on {platform_name}: {exc}")
+                    await page.close()
+                    continue
+
+                # Search jobs
+                try:
+                    jobs = await platform.search_jobs(page, config.preferences)
+                    self._log(f"Found {len(jobs)} jobs on {platform_name}.")
+                except Exception as exc:
+                    self._log(f"Job search error on {platform_name}: {exc}")
+                    await page.close()
+                    continue
+
+                # Process each job
+                for job in jobs:
+                    if self._stop_event.is_set():
+                        break
+                    if total_applied >= config.max_applications:
+                        break
+
+                    # Respect pause
+                    await self._pause_event.wait()
+
+                    company = job.get("company", "")
+                    title = job.get("title", "")
+                    url = job.get("url", "")
+                    description = job.get("description", "")
+                    self.stats["current_job"] = f"{title} @ {company}"
+
+                    # Skip already seen URLs
+                    if tracker.url_seen(url):
+                        continue
+
+                    # Record discovery
+                    tracker.record_discovered(
+                        platform=platform_name,
+                        company=company,
+                        title=title,
+                        url=url,
+                        session_id=self.session_id,
+                    )
+
+                    # Skip already applied company+title combos
+                    if tracker.already_applied(company, title):
+                        tracker.mark_skipped(url, "already applied")
+                        self.stats["skipped"] += 1
+                        self._log(f"Skip (already applied): {title} @ {company}")
+                        continue
+
+                    # Score the job
+                    if description:
+                        score_result = ranker.score(title, company, description)
+                        score = score_result["score"]
+                        tracker.update_score(url, score, score_result.get("reason", ""))
+                        if score < config.min_score:
+                            tracker.mark_skipped(url, f"score {score} < {config.min_score}")
+                            self.stats["skipped"] += 1
+                            self._log(f"Skip (score {score}): {title} @ {company}")
+                            continue
+                        self._log(f"Score {score}/10: {title} @ {company}")
+                    else:
+                        self._log(f"No description available, applying anyway: {title} @ {company}")
+
+                    # Optionally generate tailored resume
+                    resume_path = ""
+                    cover_path = ""
+                    if config.generate_tailored_resume and description:
+                        try:
+                            resume_path, cover_path = await asyncio.to_thread(
+                                self._generate_docs, config, job
+                            )
+                            self._log(f"Generated tailored resume: {resume_path}")
+                        except Exception as exc:
+                            self._log(f"Resume generation failed: {exc}")
+
+                    # Apply
+                    try:
+                        result = await platform.apply_to_job(
+                            page, job, resume_path=resume_path, cover_letter_path=cover_path
+                        )
+                        if result.get("success"):
+                            tracker.mark_applied(url, resume_path, cover_path)
+                            self.stats["applied"] += 1
+                            total_applied += 1
+                            self._log(f"Applied: {title} @ {company}")
+                        elif result.get("skipped"):
+                            tracker.mark_skipped(url, result.get("reason", "skipped"))
+                            self.stats["skipped"] += 1
+                            self._log(f"Skipped: {title} — {result.get('reason', '')}")
+                        else:
+                            tracker.mark_failed(url, result.get("reason", "unknown"))
+                            self.stats["failed"] += 1
+                            self._log(f"Failed: {title} — {result.get('reason', '')}")
+                    except Exception as exc:
+                        tracker.mark_failed(url, str(exc))
+                        self.stats["failed"] += 1
+                        self._log(f"Error applying to {title}: {exc}")
+
+                await page.close()
+
+        except Exception as exc:
+            self._log(f"Bot crashed: {exc}")
+            logger.exception("Bot loop crashed")
+        finally:
+            await browser.close()
+            self.status = "idle"
+            self.stats["current_platform"] = ""
+            self.stats["current_job"] = ""
+            self._log(
+                f"Bot finished. Applied: {self.stats['applied']}, "
+                f"Skipped: {self.stats['skipped']}, Failed: {self.stats['failed']}"
+            )
+
+    # ------------------------------------------------------------------
+    # Helpers for LLM and resume generation
+    # ------------------------------------------------------------------
+
+    @staticmethod
+    def _build_llm(config: BotConfig):
+        """Build an AIModel instance from the bot config."""
+        import config as cfg
+        cfg.LLM_MODEL_TYPE = config.llm_model_type
+        cfg.LLM_MODEL = config.llm_model
+
+        from src.libs.llm_manager import AIAdapter
+        return AIAdapter(
+            model_type=config.llm_model_type,
+            model=config.llm_model,
+            api_key=config.llm_api_key,
+        )
+
+    @staticmethod
+    def _load_resume() -> str:
+        if RESUME_PATH.exists():
+            return RESUME_PATH.read_text(encoding="utf-8")
+        return ""
+
+    @staticmethod
+    def _generate_docs(config: BotConfig, job: dict) -> tuple[str, str]:
+        """Generate tailored resume + cover letter for a job. Returns (resume_path, cover_path)."""
+        from src.libs.resume_and_cover_builder import ResumeFacade, ResumeGenerator, StyleManager
+        from src.resume_schemas.resume import Resume
+
+        resume_yaml = RESUME_PATH.read_text(encoding="utf-8")
+        resume_object = Resume(resume_yaml)
+        style_manager = StyleManager()
+        styles = style_manager.get_styles()
+        if styles:
+            style_manager.set_selected_style(next(iter(styles)))
+
+        output_path = Path("data_folder/output")
+        output_path.mkdir(parents=True, exist_ok=True)
+
+        resume_generator = ResumeGenerator()
+        resume_generator.set_resume_object(resume_object)
+
+        facade = ResumeFacade(
+            api_key=config.llm_api_key,
+            style_manager=style_manager,
+            resume_generator=resume_generator,
+            resume_object=resume_object,
+            output_path=output_path,
+        )
+        # Minimal job context
+        from src.job import Job
+        j = Job()
+        j.role = job.get("title", "")
+        j.company = job.get("company", "")
+        j.description = job.get("description", "")
+        j.link = job.get("url", "")
+        facade.job = j
+
+        style_path = style_manager.get_style_path()
+        html = resume_generator.create_resume_job_description_text(style_path, j.description)
+
+        # Save as HTML (PDF conversion optional)
+        safe_company = "".join(c for c in j.company if c.isalnum() or c in " _-")[:30]
+        safe_title = "".join(c for c in j.role if c.isalnum() or c in " _-")[:30]
+        fname = f"{safe_company}_{safe_title}_resume.html".replace(" ", "_")
+        resume_path = str(output_path / fname)
+        Path(resume_path).write_text(html, encoding="utf-8")
+        return resume_path, ""
diff --git a/src/automation/browser.py b/src/automation/browser.py
new file mode 100644
index 000000000..430f1591e
--- /dev/null
+++ b/src/automation/browser.py
@@ -0,0 +1,107 @@
+"""Playwright browser lifecycle manager with cookie persistence."""
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from playwright.async_api import async_playwright, Browser, BrowserContext, Page, Playwright
+
+from src.logging import logger
+
+COOKIES_DIR = Path("data_folder/cookies")
+
+
+class BrowserManager:
+    """Manages a single persistent Playwright Chromium browser instance.
+
+    Supports per-platform cookie persistence so users stay logged in
+    across bot runs without re-entering credentials each time.
+    """
+
+    def __init__(self, headless: bool = True):
+        self.headless = headless
+        self._playwright: Playwright | None = None
+        self._browser: Browser | None = None
+        self._context: BrowserContext | None = None
+
+    async def launch(self) -> BrowserContext:
+        """Start Playwright and launch a Chromium browser context."""
+        self._playwright = await async_playwright().start()
+        self._browser = await self._playwright.chromium.launch(
+            headless=self.headless,
+            args=[
+                "--no-sandbox",
+                "--disable-blink-features=AutomationControlled",
+                "--disable-dev-shm-usage",
+            ],
+        )
+        self._context = await self._browser.new_context(
+            viewport={"width": 1280, "height": 900},
+            user_agent=(
+                "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
+                "AppleWebKit/537.36 (KHTML, like Gecko) "
+                "Chrome/124.0.0.0 Safari/537.36"
+            ),
+            java_script_enabled=True,
+            locale="en-US",
+        )
+        # Hide automation fingerprint
+        await self._context.add_init_script(
+            "Object.defineProperty(navigator, 'webdriver', {get: () => undefined})"
+        )
+        logger.info("Playwright browser launched (headless={})", self.headless)
+        return self._context
+
+    async def new_page(self) -> Page:
+        """Open a new page in the current context."""
+        if self._context is None:
+            await self.launch()
+        return await self._context.new_page()
+
+    async def save_cookies(self, platform: str) -> None:
+        """Persist current browser cookies for a platform."""
+        if self._context is None:
+            return
+        COOKIES_DIR.mkdir(parents=True, exist_ok=True)
+        cookies = await self._context.cookies()
+        path = COOKIES_DIR / f"{platform}.json"
+        path.write_text(json.dumps(cookies, indent=2))
+        logger.info("Saved {} cookies for {}", len(cookies), platform)
+
+    async def load_cookies(self, platform: str) -> bool:
+        """Restore saved cookies for a platform. Returns True if found."""
+        path = COOKIES_DIR / f"{platform}.json"
+        if not path.exists():
+            return False
+        if self._context is None:
+            await self.launch()
+        try:
+            cookies = json.loads(path.read_text())
+            await self._context.add_cookies(cookies)
+            logger.info("Loaded {} saved cookies for {}", len(cookies), platform)
+            return True
+        except Exception as exc:
+            logger.warning("Could not load cookies for {}: {}", platform, exc)
+            return False
+
+    async def clear_cookies(self, platform: str) -> None:
+        """Delete saved cookie file for a platform."""
+        path = COOKIES_DIR / f"{platform}.json"
+        if path.exists():
+            path.unlink()
+
+    async def close(self) -> None:
+        """Shut down the browser and Playwright."""
+        try:
+            if self._context:
+                await self._context.close()
+            if self._browser:
+                await self._browser.close()
+            if self._playwright:
+                await self._playwright.stop()
+        except Exception as exc:
+            logger.warning("Error closing browser: {}", exc)
+        finally:
+            self._context = None
+            self._browser = None
+            self._playwright = None
diff --git a/src/automation/job_ranker.py b/src/automation/job_ranker.py
new file mode 100644
index 000000000..01057c54f
--- /dev/null
+++ b/src/automation/job_ranker.py
@@ -0,0 +1,94 @@
+"""LLM-based job fit scorer.
+
+Rates how well a candidate's resume matches a job description on a 1-10
+scale. Reuses the existing AIModel abstraction from llm_manager.py.
+"""
+from __future__ import annotations
+
+import json
+import re
+
+from src.logging import logger
+
+SCORE_PROMPT = """You are a job fit evaluator. Given a candidate resume and a job description, score the fit.
+
+SCORING SCALE:
+9-10: Perfect match — candidate has direct experience in nearly all required skills.
+7-8:  Strong match — candidate has most required skills, minor gaps.
+5-6:  Moderate match — some relevant skills but missing key requirements.
+3-4:  Weak match — significant skill gaps.
+1-2:  Poor match — completely different field or experience level.
+
+IMPORTANT FACTORS:
+- Weight technical skills heavily (languages, frameworks, tools)
+- Consider transferable experience
+- Factor in years of experience vs job requirements
+- Consider location/remote preferences
+
+Respond ONLY with valid JSON (no markdown, no extra text):
+{"score": <1-10 int>, "keywords": "<comma-separated ATS keywords>", "reason": "<2-3 sentences>"}"""
+
+
+class JobRanker:
+    """Score job listings against the candidate's resume using an LLM."""
+
+    def __init__(self, llm_model, resume_text: str):
+        """
+        Args:
+            llm_model: An instantiated AIModel from src/libs/llm_manager.py
+            resume_text: Full text of the candidate's resume
+        """
+        self._llm = llm_model
+        self._resume = resume_text[:8000]  # cap to avoid token overflow
+
+    def score(self, title: str, company: str, description: str) -> dict:
+        """Score a job. Returns {"score": int, "keywords": str, "reason": str}."""
+        job_text = (
+            f"TITLE: {title}\n"
+            f"COMPANY: {company}\n\n"
+            f"DESCRIPTION:\n{description[:5000]}"
+        )
+        prompt = (
+            f"{SCORE_PROMPT}\n\n"
+            f"RESUME:\n{self._resume}\n\n"
+            f"---\n\nJOB POSTING:\n{job_text}"
+        )
+        try:
+            response = self._llm.invoke(prompt)
+            return self._parse(response)
+        except Exception as exc:
+            logger.warning("LLM scoring failed for '{}': {}", title, exc)
+            return {"score": 0, "keywords": "", "reason": f"Error: {exc}"}
+
+    @staticmethod
+    def _parse(response: str) -> dict:
+        # Try JSON first
+        try:
+            # Strip markdown fences if present
+            clean = re.sub(r"```(?:json)?|```", "", response).strip()
+            data = json.loads(clean)
+            score = max(1, min(10, int(data.get("score", 0))))
+            return {
+                "score": score,
+                "keywords": str(data.get("keywords", "")),
+                "reason": str(data.get("reason", "")),
+            }
+        except (json.JSONDecodeError, ValueError, TypeError):
+            pass
+
+        # Fallback: regex
+        score = 0
+        keywords = ""
+        reason = response
+        for line in response.splitlines():
+            line = line.strip()
+            if m := re.search(r'"?score"?\s*[:\-]\s*(\d+)', line, re.I):
+                try:
+                    score = max(1, min(10, int(m.group(1))))
+                except ValueError:
+                    pass
+            if m := re.search(r'"?keywords"?\s*[:\-]\s*(.+)', line, re.I):
+                keywords = m.group(1).strip().strip('"')
+            if m := re.search(r'"?reason"?\s*[:\-]\s*(.+)', line, re.I):
+                reason = m.group(1).strip().strip('"')
+        return {"score": score, "keywords": keywords, "reason": reason}
diff --git a/src/automation/platforms/__init__.py b/src/automation/platforms/__init__.py
new file mode 100644
index 000000000..1b6fd8ed4
--- /dev/null
+++ b/src/automation/platforms/__init__.py
@@ -0,0 +1,33 @@
+"""Platform registry — maps platform name → handler class."""
+from __future__ import annotations
+
+from typing import Type
+
+from src.automation.platforms.base import BasePlatform
+
+_REGISTRY: dict[str, str] = {
+    "linkedin":     "src.automation.platforms.linkedin:LinkedInPlatform",
+    "indeed":       "src.automation.platforms.indeed:IndeedPlatform",
+    "glassdoor":    "src.automation.platforms.glassdoor:GlassdoorPlatform",
+    "ziprecruiter": "src.automation.platforms.ziprecruiter:ZipRecruiterPlatform",
+    "dice":         "src.automation.platforms.dice:DicePlatform",
+    "universal":    "src.automation.platforms.universal:UniversalPlatform",
+}
+
+AVAILABLE_PLATFORMS = list(_REGISTRY.keys())
+
+
+def get_platform(name: str) -> Type[BasePlatform] | None:
+    """Import and return the platform class for `name`, or None if not found."""
+    spec = _REGISTRY.get(name.lower())
+    if spec is None:
+        return None
+    module_path, class_name = spec.rsplit(":", 1)
+    try:
+        import importlib
+        module = importlib.import_module(module_path)
+        return getattr(module, class_name)
+    except (ImportError, AttributeError) as exc:
+        from src.logging import logger
+        logger.warning("Could not load platform '{}': {}", name, exc)
+        return None
diff --git a/src/automation/platforms/base.py b/src/automation/platforms/base.py
new file mode 100644
index 000000000..42c13269e
--- /dev/null
+++ b/src/automation/platforms/base.py
@@ -0,0 +1,104 @@
+"""Abstract base class for all job platform handlers."""
+from __future__ import annotations
+
+import random
+import asyncio
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from typing import Any
+
+from playwright.async_api import Page
+
+
+@dataclass
+class JobListing:
+    """A single job discovered on a platform."""
+    title: str
+    company: str
+    location: str
+    url: str
+    description: str = ""
+    platform: str = ""
+    job_id: str = ""
+    apply_method: str = ""      # "easy_apply", "external", "quick_apply", etc.
+    extra: dict = field(default_factory=dict)
+
+
+@dataclass
+class ApplyResult:
+    """Outcome of a single application attempt."""
+    success: bool = False
+    skipped: bool = False
+    reason: str = ""
+
+
+class BasePlatform(ABC):
+    """All platform handlers implement this interface."""
+
+    def __init__(self, llm=None):
+        self._llm = llm  # AIModel from llm_manager — may be None
+
+    @abstractmethod
+    async def login(
+        self,
+        page: Page,
+        credentials: dict[str, str],
+        browser_manager=None,
+    ) -> bool:
+        """Log in to the platform. Return True on success."""
+        ...
+
+    @abstractmethod
+    async def search_jobs(
+        self,
+        page: Page,
+        preferences: dict[str, Any],
+    ) -> list[JobListing]:
+        """Search for jobs matching preferences. Return a list of JobListings."""
+        ...
+
+    @abstractmethod
+    async def apply_to_job(
+        self,
+        page: Page,
+        job: JobListing | dict,
+        resume_path: str = "",
+        cover_letter_path: str = "",
+    ) -> ApplyResult:
+        """Apply to a single job. Return an ApplyResult."""
+        ...
+
+    # ------------------------------------------------------------------
+    # Shared helpers
+    # ------------------------------------------------------------------
+
+    async def _human_delay(self, lo: float = 1.0, hi: float = 3.0) -> None:
+        """Wait a random amount to appear more human."""
+        await asyncio.sleep(random.uniform(lo, hi))
+
+    async def _answer_text_field(self, page: Page, selector: str, question: str) -> None:
+        """Use LLM to answer a free-text application question."""
+        if self._llm is None:
+            return
+        try:
+            answer = self._llm.invoke(
+                f"Answer this job application question concisely (1-3 sentences): {question}"
+            )
+            await page.fill(selector, answer.strip())
+        except Exception:
+            await page.fill(selector, "Yes")
+
+    async def _answer_with_llm(self, question: str, options: list[str] | None = None) -> str:
+        """Ask the LLM for the best answer given question + optional options."""
+        if self._llm is None:
+            return options[0] if options else "Yes"
+        prompt = f"Job application question: {question}"
+        if options:
+            prompt += f"\nOptions: {', '.join(options)}"
+            prompt += "\nRespond with ONLY the best option text, nothing else."
+        else:
+            prompt += "\nAnswer concisely (1-2 sentences)."
+        try:
+            return self._llm.invoke(prompt).strip()
+        except Exception:
+            return options[0] if options else "Yes"
diff --git a/src/automation/platforms/dice.py b/src/automation/platforms/dice.py
new file mode 100644
index 000000000..50d075659
--- /dev/null
+++ b/src/automation/platforms/dice.py
@@ -0,0 +1,154 @@
+"""Dice.com job application platform handler using Playwright."""
+from __future__ import annotations
+
+import urllib.parse
+from typing import Any
+
+from playwright.async_api import Page, TimeoutError as PWTimeout
+
+from src.automation.platforms.base import BasePlatform, JobListing, ApplyResult
+from src.logging import logger
+
+
+class DicePlatform(BasePlatform):
+    """Dice job search and apply automation."""
+
+    LOGIN_URL = "https://www.dice.com/dashboard/login"
+    JOBS_BASE = "https://www.dice.com/jobs"
+
+    async def login(self, page: Page, credentials: dict, browser_manager=None) -> bool:
+        email = credentials.get("email", "")
+        password = credentials.get("password", "")
+        if not email or not password:
+            logger.warning("Dice credentials missing.")
+            return False
+
+        await page.goto(self.LOGIN_URL, wait_until="domcontentloaded", timeout=30000)
+        await self._human_delay(1, 2)
+        try:
+            await page.fill("input[type='email']", email)
+            await self._human_delay(0.5, 1.0)
+            await page.fill("input[type='password']", password)
+            await self._human_delay(0.5, 1.0)
+            await page.click("button[type='submit']")
+            await self._human_delay(3, 5)
+        except Exception as exc:
+            logger.error("Dice login error: {}", exc)
+            return False
+
+        return "dice.com" in page.url and "login" not in page.url
+
+    async def search_jobs(self, page: Page, preferences: dict[str, Any]) -> list[JobListing]:
+        positions = preferences.get("positions", [])
+        locations = preferences.get("locations", [])
+        if not positions or not locations:
+            return []
+
+        jobs: list[JobListing] = []
+        blacklisted_companies = {c.lower() for c in preferences.get("company_blacklist", [])}
+        blacklisted_titles = {t.lower() for t in preferences.get("title_blacklist", [])}
+
+        for position in positions:
+            for location in locations:
+                params = {"q": position, "location": location, "radius": "30", "radiusUnit": "mi"}
+                url = self.JOBS_BASE + "?" + urllib.parse.urlencode(params)
+                logger.info("Dice search: {} in {}", position, location)
+
+                await page.goto(url, wait_until="domcontentloaded", timeout=30000)
+                await self._human_delay(2, 4)
+
+                cards = await page.query_selector_all("dhi-search-card")
+                if not cards:
+                    cards = await page.query_selector_all("[data-testid='job-card']")
+
+                for card in cards:
+                    try:
+                        title_el = await card.query_selector("a.card-title-link")
+                        company_el = await card.query_selector("[data-cy='search-result-company-name']")
+                        location_el = await card.query_selector("[data-cy='search-result-location']")
+
+                        title = (await title_el.text_content() if title_el else "").strip()
+                        company = (await company_el.text_content() if company_el else "").strip()
+                        loc = (await location_el.text_content() if location_el else "").strip()
+                        href = await title_el.get_attribute("href") if title_el else ""
+                        link = f"https://www.dice.com{href}" if href and not href.startswith("http") else href
+
+                        if not title or not link:
+                            continue
+                        if company.lower() in blacklisted_companies:
+                            continue
+                        if any(w in title.lower() for w in blacklisted_titles):
+                            continue
+
+                        jobs.append(JobListing(
+                            title=title,
+                            company=company,
+                            location=loc,
+                            url=link,
+                            platform="dice",
+                            apply_method="apply",
+                        ))
+                    except Exception as exc:
+                        logger.debug("Dice card parse error: {}", exc)
+
+        seen: set[str] = set()
+        unique = []
+        for j in jobs:
+            if j.url not in seen:
+                seen.add(j.url)
+                unique.append(j)
+        logger.info("Dice: {} unique jobs found.", len(unique))
+        return unique
+
+    async def apply_to_job(
+        self,
+        page: Page,
+        job: JobListing | dict,
+        resume_path: str = "",
+        cover_letter_path: str = "",
+    ) -> ApplyResult:
+        url = job.get("url", "") if isinstance(job, dict) else job.url
+        try:
+            await page.goto(url, wait_until="domcontentloaded", timeout=30000)
+            await self._human_delay(2, 3)
+
+            apply_btn = await page.query_selector(
+                "apply-button-wc, button:has-text('Easy Apply'), button:has-text('Apply Now')"
+            )
+            if not apply_btn:
+                return ApplyResult(skipped=True, reason="no apply button")
+
+            await apply_btn.click()
+            await self._human_delay(2, 4)
+
+            if resume_path:
+                try:
+                    file_input = await page.query_selector("input[type='file']")
+                    if file_input:
+                        await file_input.set_input_files(resume_path)
+                        await self._human_delay(1, 2)
+                except Exception:
+                    pass
+
+            for _ in range(6):
+                await self._human_delay(1, 2)
+                submit = await page.query_selector(
+                    "button:has-text('Submit Application'), button:has-text('Submit')"
+                )
+                if submit:
+                    await submit.click()
+                    return ApplyResult(success=True)
+                cont = await page.query_selector(
+                    "button:has-text('Continue'), button:has-text('Next')"
+                )
+                if cont:
+                    await cont.click()
+                    continue
+                break
+
+            return ApplyResult(skipped=True, reason="could not complete flow")
+        except PWTimeout:
+            return ApplyResult(reason="timeout")
+        except Exception as exc:
+            logger.error("Dice apply error: {}", exc)
+            return ApplyResult(reason=str(exc))
diff --git a/src/automation/platforms/glassdoor.py b/src/automation/platforms/glassdoor.py
new file mode 100644
index 000000000..cd8e1e906
--- /dev/null
+++ b/src/automation/platforms/glassdoor.py
@@ -0,0 +1,157 @@
+"""Glassdoor Easy Apply platform handler using Playwright."""
+from __future__ import annotations
+
+import urllib.parse
+from typing import Any
+
+from playwright.async_api import Page, TimeoutError as PWTimeout
+
+from src.automation.platforms.base import BasePlatform, JobListing, ApplyResult
+from src.logging import logger
+
+
+class GlassdoorPlatform(BasePlatform):
+    """Glassdoor job search and Easy Apply automation."""
+
+    LOGIN_URL = "https://www.glassdoor.com/profile/login_input.htm"
+    JOBS_BASE = "https://www.glassdoor.com/Job/jobs.htm"
+
+    async def login(self, page: Page, credentials: dict, browser_manager=None) -> bool:
+        email = credentials.get("email", "")
+        password = credentials.get("password", "")
+        if not email or not password:
+            logger.warning("Glassdoor credentials missing.")
+            return False
+
+        await page.goto(self.LOGIN_URL, wait_until="domcontentloaded", timeout=30000)
+        await self._human_delay(1, 2)
+        try:
+            await page.fill("input[name='username']", email)
+            await self._human_delay(0.5, 1.0)
+            await page.fill("input[name='password']", password)
+            await self._human_delay(0.5, 1.0)
+            await page.click("button[type='submit']")
+            await self._human_delay(3, 5)
+        except Exception as exc:
+            logger.error("Glassdoor login error: {}", exc)
+            return False
+
+        return "glassdoor.com" in page.url and "login" not in page.url
+
+    async def search_jobs(self, page: Page, preferences: dict[str, Any]) -> list[JobListing]:
+        positions = preferences.get("positions", [])
+        locations = preferences.get("locations", [])
+        if not positions or not locations:
+            return []
+
+        jobs: list[JobListing] = []
+        blacklisted_companies = {c.lower() for c in preferences.get("company_blacklist", [])}
+        blacklisted_titles = {t.lower() for t in preferences.get("title_blacklist", [])}
+
+        for position in positions:
+            for location in locations:
+                params = {"sc.keyword": position, "locT": "C", "locId": "1", "jobType": ""}
+                url = self.JOBS_BASE + "?" + urllib.parse.urlencode(params)
+                logger.info("Glassdoor search: {} in {}", position, location)
+
+                await page.goto(url, wait_until="domcontentloaded", timeout=30000)
+                await self._human_delay(2, 4)
+
+                cards = await page.query_selector_all("li.react-job-listing")
+                for card in cards:
+                    try:
+                        title_el = await card.query_selector("[data-test='job-title']")
+                        company_el = await card.query_selector("[data-test='employer-short-name']")
+                        location_el = await card.query_selector("[data-test='emp-location']")
+                        link_el = await card.query_selector("a[data-test='job-link']")
+
+                        title = (await title_el.text_content() if title_el else "").strip()
+                        company = (await company_el.text_content() if company_el else "").strip()
+                        loc = (await location_el.text_content() if location_el else "").strip()
+                        href = await link_el.get_attribute("href") if link_el else ""
+                        link = f"https://www.glassdoor.com{href}" if href and not href.startswith("http") else href
+
+                        if not title or not link:
+                            continue
+                        if company.lower() in blacklisted_companies:
+                            continue
+                        if any(w in title.lower() for w in blacklisted_titles):
+                            continue
+
+                        jobs.append(JobListing(
+                            title=title,
+                            company=company,
+                            location=loc,
+                            url=link,
+                            platform="glassdoor",
+                            apply_method="easy_apply",
+                        ))
+                    except Exception as exc:
+                        logger.debug("Glassdoor card parse error: {}", exc)
+
+        # De-duplicate
+        seen: set[str] = set()
+        unique = []
+        for j in jobs:
+            if j.url not in seen:
+                seen.add(j.url)
+                unique.append(j)
+        logger.info("Glassdoor: {} unique jobs found.", len(unique))
+        return unique
+
+    async def apply_to_job(
+        self,
+        page: Page,
+        job: JobListing | dict,
+        resume_path: str = "",
+        cover_letter_path: str = "",
+    ) -> ApplyResult:
+        url = job.get("url", "") if isinstance(job, dict) else job.url
+        try:
+            await page.goto(url, wait_until="domcontentloaded", timeout=30000)
+            await self._human_delay(2, 3)
+
+            apply_btn = await page.query_selector(
+                "button[data-test='apply-btn'], button:has-text('Easy Apply'), button:has-text('Apply Now')"
+            )
+            if not apply_btn:
+                return ApplyResult(skipped=True, reason="no apply button")
+
+            await apply_btn.click()
+            await self._human_delay(2, 3)
+
+            # Upload resume if we have one
+            if resume_path:
+                try:
+                    file_input = await page.query_selector("input[type='file']")
+                    if file_input:
+                        await file_input.set_input_files(resume_path)
+                        await self._human_delay(1, 2)
+                except Exception:
+                    pass
+
+            # Click through up to 8 steps
+            for _ in range(8):
+                await self._human_delay(1, 2)
+                submit = await page.query_selector(
+                    "button:has-text('Submit Application'), button:has-text('Submit')"
+                )
+                if submit:
+                    await submit.click()
+                    await self._human_delay(2, 3)
+                    return ApplyResult(success=True)
+
+                cont = await page.query_selector(
+                    "button:has-text('Continue'), button:has-text('Next')"
+                )
+                if cont:
+                    await cont.click()
+                    continue
+                break
+
+            return ApplyResult(skipped=True, reason="could not complete flow")
+        except PWTimeout:
+            return ApplyResult(reason="timeout")
+        except Exception as exc:
+            logger.error("Glassdoor apply error: {}", exc)
+            return ApplyResult(reason=str(exc))
diff --git a/src/automation/platforms/indeed.py b/src/automation/platforms/indeed.py
new file mode 100644
index 000000000..880e5301a
--- /dev/null
+++ b/src/automation/platforms/indeed.py
@@ -0,0 +1,190 @@
+"""Indeed Quick Apply platform handler using Playwright."""
+from __future__ import annotations
+
+import urllib.parse
+from typing import Any
+
+from playwright.async_api import Page, TimeoutError as PWTimeout
+
+from src.automation.platforms.base import BasePlatform, JobListing, ApplyResult
+from src.logging import logger
+
+
+class IndeedPlatform(BasePlatform):
+    """Indeed job search and Quick Apply automation."""
+
+    LOGIN_URL = "https://secure.indeed.com/account/login"
+    JOBS_BASE = "https://www.indeed.com/jobs"
+
+    async def login(self, page: Page, credentials: dict, browser_manager=None) -> bool:
+        email = credentials.get("email", "")
+        password = credentials.get("password", "")
+        if not email or not password:
+            logger.warning("Indeed credentials missing.")
+            return False
+
+        await page.goto(self.LOGIN_URL, wait_until="domcontentloaded", timeout=30000)
+        await self._human_delay(1, 2)
+        try:
+            await page.fill("input[type='email']", email)
+            await self._human_delay(0.5, 1.0)
+            # Indeed uses a multi-step login
+            continue_btn = await page.query_selector("button[type='submit']")
+            if continue_btn:
+                await continue_btn.click()
+            await self._human_delay(1, 2)
+            pw_input = await page.query_selector("input[type='password']")
+            if pw_input:
+                await pw_input.fill(password)
+                await self._human_delay(0.5, 1.0)
+                submit = await page.query_selector("button[type='submit']")
+                if submit:
+                    await submit.click()
+            await self._human_delay(3, 5)
+        except Exception as exc:
+            logger.error("Indeed login error: {}", exc)
+            return False
+
+        # Verify login by checking URL or profile element
+        return "dashboard" in page.url or "indeed.com/myjobs" in page.url or \
+               await page.query_selector(".gnav-LoggedInAccountLink") is not None
+
+    async def search_jobs(self, page: Page, preferences: dict[str, Any]) -> list[JobListing]:
+        positions = preferences.get("positions", [])
+        locations = preferences.get("locations", [])
+        if not positions or not locations:
+            return []
+
+        jobs: list[JobListing] = []
+        blacklisted_companies = {c.lower() for c in preferences.get("company_blacklist", [])}
+        blacklisted_titles = {t.lower() for t in preferences.get("title_blacklist", [])}
+
+        for position in positions:
+            for location in locations:
+                params = {"q": position, "l": location}
+                url = self.JOBS_BASE + "?" + urllib.parse.urlencode(params)
+                logger.info("Indeed search: {} in {}", position, location)
+
+                for page_num in range(3):
+                    page_url = url + f"&start={page_num * 10}"
+                    await page.goto(page_url, wait_until="domcontentloaded", timeout=30000)
+                    await self._human_delay(2, 4)
+
+                    cards = await page.query_selector_all(".job_seen_beacon")
+                    if not cards:
+                        break
+
+                    for card in cards:
+                        try:
+                            title_el = await card.query_selector("h2.jobTitle a")
+                            company_el = await card.query_selector("[data-testid='company-name']")
+                            location_el = await card.query_selector("[data-testid='text-location']")
+
+                            title = (await title_el.text_content() if title_el else "").strip()
+                            company = (await company_el.text_content() if company_el else "").strip()
+                            location_text = (await location_el.text_content() if location_el else "").strip()
+                            href = await title_el.get_attribute("href") if title_el else ""
+                            link = f"https://www.indeed.com{href}" if href and href.startswith("/") else href
+
+                            if not title or not link:
+                                continue
+                            if company.lower() in blacklisted_companies:
+                                continue
+                            if any(w in title.lower() for w in blacklisted_titles):
+                                continue
+
+                            jobs.append(JobListing(
+                                title=title,
+                                company=company,
+                                location=location_text,
+                                url=link,
+                                platform="indeed",
+                                apply_method="quick_apply",
+                            ))
+                        except Exception as exc:
+                            logger.debug("Error parsing Indeed job card: {}", exc)
+                            continue
+
+        # De-duplicate
+        seen: set[str] = set()
+        unique: list[JobListing] = []
+        for j in jobs:
+            if j.url not in seen:
+                seen.add(j.url)
+                unique.append(j)
+        logger.info("Indeed: {} unique jobs found.", len(unique))
+        return unique
+
+    async def apply_to_job(
+        self,
+        page: Page,
+        job: JobListing | dict,
+        resume_path: str = "",
+        cover_letter_path: str = "",
+    ) -> ApplyResult:
+        url = job.get("url", "") if isinstance(job, dict) else job.url
+        try:
+            await page.goto(url, wait_until="domcontentloaded", timeout=30000)
+            await self._human_delay(2, 3)
+
+            # Look for "Apply Now" or "Easily Apply" button
+            apply_btn = await page.query_selector(
+                "button[id*='indeedApplyButton'], a[id*='indeedApplyButton'], "
+                "button:has-text('Apply now'), button:has-text('Easily apply')"
+            )
+            if not apply_btn:
+                return ApplyResult(skipped=True, reason="no apply button found")
+
+            await apply_btn.click()
+            await self._human_delay(2, 4)
+
+            # Indeed often opens an iframe for quick apply
+            frame = None
+            for f in page.frames:
+                if "indeed" in f.url and "apply" in f.url:
+                    frame = f
+                    break
+
+            target = frame or page
+
+            # Upload resume
+            if resume_path:
+                try:
+                    file_input = await target.query_selector("input[type='file']")
+                    if file_input:
+                        await file_input.set_input_files(resume_path)
+                        await self._human_delay(1, 2)
+                except Exception as exc:
+                    logger.debug("Indeed resume upload error: {}", exc)
+
+            # Click through steps
+            for _ in range(8):
+                await self._human_delay(1, 2)
+                # Submit button
+                submit = await target.query_selector(
+                    "button[type='submit']:has-text('Submit'), "
+                    "button:has-text('Submit your application')"
+                )
+                if submit:
+                    await submit.click()
+                    await self._human_delay(2, 3)
+                    return ApplyResult(success=True)
+
+                # Continue button
+                cont = await target.query_selector(
+                    "button[type='submit']:has-text('Continue'), "
+                    "button:has-text('Next')"
+                )
+                if cont:
+                    await cont.click()
+                    continue
+
+                break
+
+            return ApplyResult(skipped=True, reason="could not complete application flow")
+
+        except PWTimeout:
+            return ApplyResult(reason="timeout")
+        except Exception as exc:
+            logger.error("Indeed apply error: {}", exc)
+            return ApplyResult(reason=str(exc))
diff --git a/src/automation/platforms/linkedin.py b/src/automation/platforms/linkedin.py
new file mode 100644
index 000000000..44606a73c
--- /dev/null
+++ b/src/automation/platforms/linkedin.py
@@ -0,0 +1,524 @@
+"""LinkedIn Easy Apply platform handler using Playwright.
+
+Adapted from:
+- NathanDuma/LinkedIn-Easy-Apply-Bot (Selenium → Playwright port)
+- GodsScion/Auto_job_applier_linkedIn (AI form filling patterns)
+- wodsuz/EasyApplyJobsBot (multi-step form handling)
+"""
+from __future__ import annotations
+
+import asyncio
+import re
+import urllib.parse
+from typing import Any
+
+from playwright.async_api import Page, TimeoutError as PWTimeout
+
+from src.automation.platforms.base import BasePlatform, JobListing, ApplyResult
+from src.logging import logger
+
+# LinkedIn selectors (as of 2025 — may need updates if LinkedIn changes DOM)
+_SEL = {
+    "email":           "#username",
+    "password":        "#password",
+    "login_btn":       "button[type='submit']",
+    "feed":            ".feed-identity-module",
+    "jobs_list":       ".jobs-search-results__list",
+    "job_item":        ".jobs-search-results__list-item",
+    "job_title":       ".job-card-list__title",
+    "company_name":    ".job-card-container__company-name",
+    "job_location":    ".job-card-container__metadata-item",
+    "easy_apply_btn":  "button.jobs-apply-button",
+    "modal":           ".jobs-easy-apply-modal",
+    "next_btn":        "button[aria-label='Continue to next step']",
+    "review_btn":      "button[aria-label='Review your application']",
+    "submit_btn":      "button[aria-label='Submit application']",
+    "close_modal":     "button[aria-label='Dismiss']",
+    "already_applied": ".artdeco-inline-feedback--error",
+    "follow_checkbox": "label[for='follow-company-checkbox']",
+}
+
+DATE_FILTER_MAP = {
+    "24_hours": "r86400",
+    "week":     "r604800",
+    "month":    "r2592000",
+    "all_time": "",
+}
+
+EXPERIENCE_LEVEL_MAP = {
+    "internship":     "1",
+    "entry":          "2",
+    "associate":      "3",
+    "mid_senior_level": "4",
+    "director":       "5",
+    "executive":      "6",
+}
+
+JOB_TYPE_MAP = {
+    "full_time":  "F",
+    "contract":   "C",
+    "part_time":  "P",
+    "temporary":  "T",
+    "internship": "I",
+    "other":      "O",
+    "volunteer":  "V",
+}
+
+
+class LinkedInPlatform(BasePlatform):
+    """LinkedIn Easy Apply automation."""
+
+    LOGIN_URL = "https://www.linkedin.com/login"
+    JOBS_BASE = "https://www.linkedin.com/jobs/search/"
+
+    async def login(self, page: Page, credentials: dict, browser_manager=None) -> bool:
+        email = credentials.get("email", "")
+        password = credentials.get("password", "")
+        if not email or not password:
+            logger.warning("LinkedIn credentials missing.")
+            return False
+
+        # Check if already logged in via cookies
+        await page.goto("https://www.linkedin.com/feed", wait_until="domcontentloaded", timeout=30000)
+        if await self._is_logged_in(page):
+            logger.info("LinkedIn: already logged in via cookies.")
+            return True
+
+        # Navigate to login page
+        await page.goto(self.LOGIN_URL, wait_until="domcontentloaded", timeout=30000)
+        await self._human_delay(1, 2)
+
+        try:
+            await page.fill(_SEL["email"], email)
+            await self._human_delay(0.5, 1.5)
+            await page.fill(_SEL["password"], password)
+            await self._human_delay(0.5, 1.0)
+            await page.click(_SEL["login_btn"])
+            await self._human_delay(4, 7)
+        except Exception as exc:
+            logger.error("LinkedIn login form error: {}", exc)
+            return False
+
+        # Check for 2FA / security challenge
+        if "/checkpoint/" in page.url or "/challenge/" in page.url:
+            logger.warning(
+                "LinkedIn security check detected. "
+                "Please complete it manually in the browser window."
+            )
+            # Wait up to 90s for user to complete challenge
+            try:
+                await page.wait_for_url("**/feed**", timeout=90000)
+            except PWTimeout:
+                logger.error("Timed out waiting for LinkedIn security check.")
+                return False
+
+        return await self._is_logged_in(page)
+
+    async def search_jobs(self, page: Page, preferences: dict[str, Any]) -> list[JobListing]:
+        """Search LinkedIn for jobs matching work_preferences.yaml content."""
+        positions = preferences.get("positions", [])
+        locations = preferences.get("locations", [])
+        if not positions or not locations:
+            logger.warning("No positions or locations configured.")
+            return []
+
+        jobs: list[JobListing] = []
+        blacklisted_companies = {c.lower() for c in preferences.get("company_blacklist", [])}
+        blacklisted_titles = {t.lower() for t in preferences.get("title_blacklist", [])}
+
+        for position in positions:
+            for location in locations:
+                url = self._build_search_url(position, location, preferences)
+                logger.info("LinkedIn search: {} in {}", position, location)
+                page_jobs = await self._scrape_search_page(
+                    page, url, blacklisted_companies, blacklisted_titles
+                )
+                jobs.extend(page_jobs)
+
+        # De-duplicate by URL
+        seen: set[str] = set()
+        unique: list[JobListing] = []
+        for j in jobs:
+            if j.url not in seen:
+                seen.add(j.url)
+                unique.append(j)
+        logger.info("LinkedIn: {} unique jobs found.", len(unique))
+        return unique
+
+    async def apply_to_job(
+        self,
+        page: Page,
+        job: JobListing | dict,
+        resume_path: str = "",
+        cover_letter_path: str = "",
+    ) -> ApplyResult:
+        if isinstance(job, dict):
+            url = job.get("url", "")
+        else:
+            url = job.url
+
+        try:
+            await page.goto(url, wait_until="domcontentloaded", timeout=30000)
+            await self._human_delay(2, 4)
+
+            # Check if already applied
+            if await self._already_applied(page):
+                return ApplyResult(skipped=True, reason="already applied")
+
+            # Click Easy Apply button
+            try:
+                btn = await page.wait_for_selector(
+                    _SEL["easy_apply_btn"], timeout=8000, state="visible"
+                )
+            except PWTimeout:
+                return ApplyResult(skipped=True, reason="no Easy Apply button")
+
+            btn_text = (await btn.text_content() or "").strip()
+            if "easy apply" not in btn_text.lower():
+                return ApplyResult(skipped=True, reason="not an Easy Apply job")
+
+            await btn.click()
+            await self._human_delay(2, 3)
+
+            # Handle multi-step modal
+            result = await self._handle_application_modal(page, resume_path, cover_letter_path)
+            return result
+
+        except PWTimeout:
+            return ApplyResult(reason="timeout navigating to job page")
+        except Exception as exc:
+            logger.error("LinkedIn apply error for {}: {}", url, exc)
+            return ApplyResult(reason=str(exc))
+
+    # ------------------------------------------------------------------
+    # Internal helpers
+    # ------------------------------------------------------------------
+
+    async def _is_logged_in(self, page: Page) -> bool:
+        try:
+            await page.wait_for_selector(_SEL["feed"], timeout=5000)
+            return True
+        except PWTimeout:
+            pass
+        # Alternative: check URL
+        return "feed" in page.url or "mynetwork" in page.url
+
+    async def _already_applied(self, page: Page) -> bool:
+        try:
+            el = await page.query_selector(".jobs-s-apply__application-link")
+            if el:
+                text = (await el.text_content() or "").lower()
+                return "applied" in text
+        except Exception:
+            pass
+        return False
+
+    def _build_search_url(self, position: str, location: str, prefs: dict) -> str:
+        params: dict[str, str] = {
+            "keywords":  position,
+            "location":  location,
+            "f_LF":      "f_AL",   # Easy Apply only
+            "origin":    "JOB_SEARCH_PAGE_JOB_FILTER",
+        }
+
+        # Date filter
+        date = prefs.get("date", {})
+        for key, value in DATE_FILTER_MAP.items():
+            if date.get(key) and value:
+                params["f_TPR"] = value
+                break
+
+        # Experience levels
+        exp = prefs.get("experience_level", {})
+        levels = [v for k, v in EXPERIENCE_LEVEL_MAP.items() if exp.get(k)]
+        if levels:
+            params["f_E"] = ",".join(levels)
+
+        # Job types
+        jt = prefs.get("job_types", {})
+        types = [v for k, v in JOB_TYPE_MAP.items() if jt.get(k)]
+        if types:
+            params["f_JT"] = ",".join(types)
+
+        # Remote
+        remote = prefs.get("remote", False)
+        hybrid = prefs.get("hybrid", False)
+        onsite = prefs.get("onsite", False)
+        work_types = []
+        if remote:
+            work_types.append("2")
+        if hybrid:
+            work_types.append("3")
+        if onsite:
+            work_types.append("1")
+        if work_types:
+            params["f_WT"] = ",".join(work_types)
+
+        return self.JOBS_BASE + "?" + urllib.parse.urlencode(params)
+
+    async def _scrape_search_page(
+        self,
+        page: Page,
+        url: str,
+        blacklisted_companies: set[str],
+        blacklisted_titles: set[str],
+        max_pages: int = 5,
+    ) -> list[JobListing]:
+        jobs: list[JobListing] = []
+        current_url = url
+
+        for page_num in range(max_pages):
+            await page.goto(current_url, wait_until="domcontentloaded", timeout=30000)
+            await self._human_delay(2, 4)
+
+            # Scroll to load all job cards
+            try:
+                results_el = await page.query_selector(_SEL["jobs_list"])
+                if results_el:
+                    await results_el.scroll_into_view_if_needed()
+                    for _ in range(3):
+                        await page.keyboard.press("End")
+                        await asyncio.sleep(0.8)
+            except Exception:
+                pass
+
+            # Collect job tiles
+            items = await page.query_selector_all(_SEL["job_item"])
+            if not items:
+                break
+
+            for item in items:
+                try:
+                    title_el = await item.query_selector(_SEL["job_title"])
+                    company_el = await item.query_selector(_SEL["company_name"])
+                    location_el = await item.query_selector(_SEL["job_location"])
+
+                    title = (await title_el.text_content() if title_el else "").strip()
+                    company = (await company_el.text_content() if company_el else "").strip()
+                    location = (await location_el.text_content() if location_el else "").strip()
+                    link = await title_el.get_attribute("href") if title_el else ""
+                    if link:
+                        link = link.split("?")[0]  # strip tracking params
+
+                    if not title or not link:
+                        continue
+
+                    # Blacklist checks
+                    if company.lower() in blacklisted_companies:
+                        continue
+                    if any(w in title.lower() for w in blacklisted_titles):
+                        continue
+
+                    # Get description by clicking the job tile
+                    description = await self._get_job_description(page, item)
+
+                    jobs.append(JobListing(
+                        title=title,
+                        company=company,
+                        location=location,
+                        url=link,
+                        description=description,
+                        platform="linkedin",
+                        apply_method="easy_apply",
+                    ))
+                except Exception as exc:
+                    logger.debug("Error parsing job tile: {}", exc)
+                    continue
+
+            # Next page
+            try:
+                next_btn = await page.query_selector("button[aria-label='View next page']")
+                if not next_btn:
+                    break
+                is_disabled = await next_btn.get_attribute("disabled")
+                if is_disabled:
+                    break
+                await next_btn.click()
+                await self._human_delay(2, 4)
+                current_url = page.url
+            except Exception:
+                break
+
+        return jobs
+
+    async def _get_job_description(self, page: Page, item) -> str:
+        """Click a job tile and return the description text."""
+        try:
+            await item.click()
+            await self._human_delay(1, 2)
+            desc_el = await page.query_selector(".jobs-description__content")
+            if desc_el:
+                return (await desc_el.text_content() or "").strip()
+        except Exception:
+            pass
+        return ""
+
+    async def _handle_application_modal(
+        self, page: Page, resume_path: str, cover_letter_path: str
+    ) -> ApplyResult:
+        """Navigate through the Easy Apply multi-step modal and submit."""
+        step = 0
+        max_steps = 10
+
+        while step < max_steps:
+            await self._human_delay(1, 2)
+
+            # Check if modal is open
+            modal = await page.query_selector(_SEL["modal"])
+            if not modal:
+                # Modal closed — application may have submitted
+                return ApplyResult(success=True)
+
+            # Fill form fields on current step
+            await self._fill_form_fields(page, resume_path, cover_letter_path)
+            await self._human_delay(0.5, 1.5)
+
+            # Uncheck "follow company" if present
+            try:
+                follow = await page.query_selector(_SEL["follow_checkbox"])
+                if follow:
+                    await follow.click()
+            except Exception:
+                pass
+
+            # Determine which button to click
+            submit_btn = await page.query_selector(_SEL["submit_btn"])
+            if submit_btn:
+                await submit_btn.click()
+                await self._human_delay(2, 4)
+                return ApplyResult(success=True)
+
+            review_btn = await page.query_selector(_SEL["review_btn"])
+            if review_btn:
+                await review_btn.click()
+                step += 1
+                continue
+
+            next_btn = await page.query_selector(_SEL["next_btn"])
+            if next_btn:
+                await next_btn.click()
+                step += 1
+                continue
+
+            # No button found — try clicking any visible primary button
+            try:
+                primary = await page.query_selector(
+                    ".artdeco-button--primary:visible"
+                )
+                if primary:
+                    await primary.click()
+                    step += 1
+                    continue
+            except Exception:
+                pass
+
+            # Stuck — close modal and skip
+            try:
+                close = await page.query_selector(_SEL["close_modal"])
+                if close:
+                    await close.click()
+                    await self._human_delay(1, 2)
+                    discard = await page.query_selector("button[data-control-name='discard_native_overlay']")
+                    if discard:
+                        await discard.click()
+            except Exception:
+                pass
+            return ApplyResult(skipped=True, reason="stuck on step")
+
+        return ApplyResult(skipped=True, reason="exceeded max steps")
+
+    async def _fill_form_fields(
+        self, page: Page, resume_path: str, cover_letter_path: str
+    ) -> None:
+        """Auto-fill all form inputs on the current modal step."""
+
+        # Upload resume if a file input exists and we have a path
+        if resume_path:
+            try:
+                file_inputs = await page.query_selector_all("input[type='file']")
+                for fi in file_inputs:
+                    label = await fi.get_attribute("aria-label") or ""
+                    if "resume" in label.lower() or not label:
+                        await fi.set_input_files(resume_path)
+                        await self._human_delay(1, 2)
+                        break
+            except Exception as exc:
+                logger.debug("Resume upload error: {}", exc)
+
+        # Upload cover letter
+        if cover_letter_path:
+            try:
+                file_inputs = await page.query_selector_all("input[type='file']")
+                for fi in file_inputs:
+                    label = await fi.get_attribute("aria-label") or ""
+                    if "cover" in label.lower():
+                        await fi.set_input_files(cover_letter_path)
+                        await self._human_delay(1, 2)
+                        break
+            except Exception as exc:
+                logger.debug("Cover letter upload error: {}", exc)
+
+        # Fill text inputs / textareas
+        try:
+            inputs = await page.query_selector_all(
+                ".jobs-easy-apply-form-section__form-input input[type='text'],"
+                ".jobs-easy-apply-form-section__form-input input[type='number'],"
+                ".jobs-easy-apply-form-section__form-input textarea"
+            )
+            for inp in inputs:
+                value = (await inp.input_value()).strip()
+                if value:
+                    continue  # already filled
+                label_el = await inp.query_selector("xpath=../../..//label")
+                label_text = (await label_el.text_content() if label_el else "").strip()
+                answer = await self._answer_with_llm(label_text or "Please fill in")
+                tag = await inp.evaluate("el => el.tagName.toLowerCase()")
+                await inp.fill(answer[:500])
+                await self._human_delay(0.3, 0.8)
+        except Exception as exc:
+            logger.debug("Text input fill error: {}", exc)
+
+        # Handle radio buttons / checkboxes
+        try:
+            fieldsets = await page.query_selector_all(
+                ".jobs-easy-apply-form-section fieldset"
+            )
+            for fs in fieldsets:
+                legend = await fs.query_selector("legend")
+                question = (await legend.text_content() if legend else "").strip()
+                radios = await fs.query_selector_all("input[type='radio']")
+                if not radios:
+                    continue
+                options = []
+                for r in radios:
+                    lbl = await r.query_selector("xpath=following-sibling::label")
+                    options.append((await lbl.text_content() if lbl else "").strip())
+                best = await self._answer_with_llm(question, options)
+                for i, r in enumerate(radios):
+                    if options[i].lower() == best.lower():
+                        await r.click()
+                        break
+                else:
+                    await radios[0].click()  # default to first
+                await self._human_delay(0.3, 0.8)
+        except Exception as exc:
+            logger.debug("Radio/checkbox fill error: {}", exc)
+
+        # Handle dropdowns (select elements)
+        try:
+            selects = await page.query_selector_all(
+                ".jobs-easy-apply-form-section select"
+            )
+            for sel in selects:
+                value = await sel.input_value()
+                if value and value != "Select an option":
+                    continue
+                options = await sel.query_selector_all("option")
+                texts = [(await o.text_content() or "").strip() for o in options]
+                label_el = await sel.query_selector("xpath=../..//label")
+                question = (await label_el.text_content() if label_el else "").strip()
+                best = await self._answer_with_llm(question, [t for t in texts if t])
+                await sel.select_option(label=best)
+                await self._human_delay(0.3, 0.8)
+        except Exception as exc:
+            logger.debug("Dropdown fill error: {}", exc)
diff --git a/src/automation/platforms/universal.py b/src/automation/platforms/universal.py
new file mode 100644
index 000000000..41cad1eac
--- /dev/null
+++ b/src/automation/platforms/universal.py
@@ -0,0 +1,183 @@
+"""Universal AI-driven job application handler.
+
+Applies to any career page URL using LLM-guided form filling.
+Inspired by ApplyPilot's universal form filling approach.
+"""
+from __future__ import annotations
+
+import re
+from typing import Any
+
+from playwright.async_api import Page, TimeoutError as PWTimeout
+
+from src.automation.platforms.base import BasePlatform, JobListing, ApplyResult
+from src.logging import logger
+
+
+class UniversalPlatform(BasePlatform):
+    """Apply to any job page via AI-driven form detection and filling.
+
+    This platform doesn't do its own job search — it processes a list of
+    job URLs provided directly in preferences["universal_urls"].
+    """
+
+    async def login(self, page: Page, credentials: dict, browser_manager=None) -> bool:
+        # Universal platform handles no platform-wide login
+        return True
+
+    async def search_jobs(self, page: Page, preferences: dict[str, Any]) -> list[JobListing]:
+        """Return jobs from manually-specified URLs in preferences."""
+        urls = preferences.get("universal_urls", [])
+        jobs: list[JobListing] = []
+        for url in urls:
+            await page.goto(url, wait_until="domcontentloaded", timeout=30000)
+            await self._human_delay(1, 2)
+            title = await page.title()
+            jobs.append(JobListing(
+                title=title,
+                company="",
+                location="",
+                url=url,
+                platform="universal",
+                apply_method="ai_form_fill",
+            ))
+        return jobs
+
+    async def apply_to_job(
+        self,
+        page: Page,
+        job: JobListing | dict,
+        resume_path: str = "",
+        cover_letter_path: str = "",
+    ) -> ApplyResult:
+        url = job.get("url", "") if isinstance(job, dict) else job.url
+        try:
+            await page.goto(url, wait_until="domcontentloaded", timeout=30000)
+            await self._human_delay(2, 3)
+
+            # Find and click an "Apply" button
+            apply_btn = await page.query_selector(
+                "button:has-text('Apply'), a:has-text('Apply Now'), "
+                "button:has-text('Apply Now'), a:has-text('Apply')"
+            )
+            if apply_btn:
+                await apply_btn.click()
+                await self._human_delay(2, 3)
+
+            # Generic form filling loop
+            for step in range(10):
+                await self._human_delay(1, 2)
+                filled = await self._fill_all_inputs(page, resume_path, cover_letter_path)
+
+                # Try to submit
+                submit = await page.query_selector(
+                    "button[type='submit']:has-text('Submit'), "
+                    "button:has-text('Submit Application'), "
+                    "input[type='submit']"
+                )
+                if submit:
+                    await submit.click()
+                    await self._human_delay(2, 4)
+                    return ApplyResult(success=True)
+
+                # Try to advance
+                next_btn = await page.query_selector(
+                    "button:has-text('Next'), button:has-text('Continue'), "
+                    "button[type='submit']:not(:has-text('Submit'))"
+                )
+                if next_btn:
+                    await next_btn.click()
+                    continue
+
+                if not filled:
+                    break
+
+            return ApplyResult(skipped=True, reason="could not determine form flow")
+        except PWTimeout:
+            return ApplyResult(reason="timeout")
+        except Exception as exc:
+            logger.error("Universal apply error for {}: {}", url, exc)
+            return ApplyResult(reason=str(exc))
+
+    async def _fill_all_inputs(
+        self, page: Page, resume_path: str, cover_letter_path: str
+    ) -> bool:
+        """Fill all visible, unfilled inputs. Returns True if anything was filled."""
+        filled_any = False
+
+        # File inputs
+        if resume_path:
+            try:
+                for fi in await page.query_selector_all("input[type='file']"):
+                    label = (await fi.get_attribute("aria-label") or "").lower()
+                    if not label or "resume" in label or "cv" in label:
+                        await fi.set_input_files(resume_path)
+                        await self._human_delay(0.5, 1.0)
+                        filled_any = True
+                        break
+            except Exception:
+                pass
+
+        # Text inputs
+        try:
+            for inp in await page.query_selector_all(
+                "input[type='text']:visible, input[type='email']:visible, "
+                "input[type='tel']:visible, input[type='number']:visible, textarea:visible"
+            ):
+                value = (await inp.input_value()).strip()
+                if value:
+                    continue
+                label_text = await self._get_label_text(page, inp)
+                answer = await self._answer_with_llm(label_text or "Fill this field")
+                await inp.fill(answer[:300])
+                await self._human_delay(0.2, 0.5)
+                filled_any = True
+        except Exception as exc:
+            logger.debug("Universal text fill error: {}", exc)
+
+        # Select dropdowns
+        try:
+            for sel in await page.query_selector_all("select:visible"):
+                value = await sel.input_value()
+                if value:
+                    continue
+                options = [
+                    (await o.text_content() or "").strip()
+                    for o in await sel.query_selector_all("option")
+                ]
+                label_text = await self._get_label_text(page, sel)
+                best = await self._answer_with_llm(label_text or "Select", [o for o in options if o])
+                try:
+                    await sel.select_option(label=best)
+                    filled_any = True
+                except Exception:
+                    pass
+        except Exception as exc:
+            logger.debug("Universal select fill error: {}", exc)
+
+        return filled_any
+
+    @staticmethod
+    async def _get_label_text(page: Page, element) -> str:
+        """Try to find the label text for an input element."""
+        try:
+            el_id = await element.get_attribute("id")
+            if el_id:
+                label = await page.query_selector(f"label[for='{el_id}']")
+                if label:
+                    return (await label.text_content() or "").strip()
+        except Exception:
+            pass
+        try:
+            aria = await element.get_attribute("aria-label")
+            if aria:
+                return aria.strip()
+        except Exception:
+            pass
+        try:
+            placeholder = await element.get_attribute("placeholder")
+            if placeholder:
+                return placeholder.strip()
+        except Exception:
+            pass
+        return ""
diff --git a/src/automation/platforms/ziprecruiter.py b/src/automation/platforms/ziprecruiter.py
new file mode 100644
index 000000000..8c0375411
--- /dev/null
+++ b/src/automation/platforms/ziprecruiter.py
@@ -0,0 +1,148 @@
+"""ZipRecruiter 1-click Apply platform handler using Playwright."""
+from __future__ import annotations
+
+import urllib.parse
+from typing import Any
+
+from playwright.async_api import Page, TimeoutError as PWTimeout
+
+from src.automation.platforms.base import BasePlatform, JobListing, ApplyResult
+from src.logging import logger
+
+
+class ZipRecruiterPlatform(BasePlatform):
+    """ZipRecruiter job search and 1-click apply automation."""
+
+    LOGIN_URL = "https://www.ziprecruiter.com/login"
+    JOBS_BASE = "https://www.ziprecruiter.com/jobs-search"
+
+    async def login(self, page: Page, credentials: dict, browser_manager=None) -> bool:
+        email = credentials.get("email", "")
+        password = credentials.get("password", "")
+        if not email or not password:
+            logger.warning("ZipRecruiter credentials missing.")
+            return False
+
+        await page.goto(self.LOGIN_URL, wait_until="domcontentloaded", timeout=30000)
+        await self._human_delay(1, 2)
+        try:
+            await page.fill("input[name='email']", email)
+            await self._human_delay(0.5, 1.0)
+            await page.fill("input[name='password']", password)
+            await self._human_delay(0.5, 1.0)
+            await page.click("button[type='submit']")
+            await self._human_delay(3, 5)
+        except Exception as exc:
+            logger.error("ZipRecruiter login error: {}", exc)
+            return False
+
+        return "ziprecruiter.com" in page.url and "login" not in page.url
+
+    async def search_jobs(self, page: Page, preferences: dict[str, Any]) -> list[JobListing]:
+        positions = preferences.get("positions", [])
+        locations = preferences.get("locations", [])
+        if not positions or not locations:
+            return []
+
+        jobs: list[JobListing] = []
+        blacklisted_companies = {c.lower() for c in preferences.get("company_blacklist", [])}
+        blacklisted_titles = {t.lower() for t in preferences.get("title_blacklist", [])}
+
+        for position in positions:
+            for location in locations:
+                params = {"search": position, "location": location}
+                url = self.JOBS_BASE + "?" + urllib.parse.urlencode(params)
+                logger.info("ZipRecruiter search: {} in {}", position, location)
+
+                await page.goto(url, wait_until="domcontentloaded", timeout=30000)
+                await self._human_delay(2, 4)
+
+                cards = await page.query_selector_all("article.job_result")
+                for card in cards:
+                    try:
+                        title_el = await card.query_selector("h2.job_title a")
+                        company_el = await card.query_selector("a.job_company_name")
+                        location_el = await card.query_selector(".location")
+
+                        title = (await title_el.text_content() if title_el else "").strip()
+                        company = (await company_el.text_content() if company_el else "").strip()
+                        loc = (await location_el.text_content() if location_el else "").strip()
+                        href = await title_el.get_attribute("href") if title_el else ""
+                        link = f"https://www.ziprecruiter.com{href}" if href and not href.startswith("http") else href
+
+                        if not title or not link:
+                            continue
+                        if company.lower() in blacklisted_companies:
+                            continue
+                        if any(w in title.lower() for w in blacklisted_titles):
+                            continue
+
+                        jobs.append(JobListing(
+                            title=title,
+                            company=company,
+                            location=loc,
+                            url=link,
+                            platform="ziprecruiter",
+                            apply_method="1_click",
+                        ))
+                    except Exception as exc:
+                        logger.debug("ZipRecruiter card parse error: {}", exc)
+
+        seen: set[str] = set()
+        unique = []
+        for j in jobs:
+            if j.url not in seen:
+                seen.add(j.url)
+                unique.append(j)
+        logger.info("ZipRecruiter: {} unique jobs found.", len(unique))
+        return unique
+
+    async def apply_to_job(
+        self,
+        page: Page,
+        job: JobListing | dict,
+        resume_path: str = "",
+        cover_letter_path: str = "",
+    ) -> ApplyResult:
+        url = job.get("url", "") if isinstance(job, dict) else job.url
+        try:
+            await page.goto(url, wait_until="domcontentloaded", timeout=30000)
+            await self._human_delay(2, 3)
+
+            apply_btn = await page.query_selector(
+                "button.apply_button, button:has-text('1-Click Apply'), button:has-text('Apply Now')"
+            )
+            if not apply_btn:
+                return ApplyResult(skipped=True, reason="no apply button")
+
+            await apply_btn.click()
+            await self._human_delay(2, 4)
+
+            # 1-click apply may show a confirmation dialog
+            confirm = await page.query_selector(
+                "button:has-text('Confirm'), button:has-text('Submit')"
+            )
+            if confirm:
+                await confirm.click()
+                await self._human_delay(1, 2)
+                return ApplyResult(success=True)
+
+            # Multi-step flow
+            for _ in range(5):
+                await self._human_delay(1, 2)
+                submit = await page.query_selector("button:has-text('Submit')")
+                if submit:
+                    await submit.click()
+                    return ApplyResult(success=True)
+                cont = await page.query_selector("button:has-text('Continue'), button:has-text('Next')")
+                if cont:
+                    await cont.click()
+                    continue
+                break
+
+            return ApplyResult(skipped=True, reason="could not complete flow")
+        except PWTimeout:
+            return ApplyResult(reason="timeout")
+        except Exception as exc:
+            logger.error("ZipRecruiter apply error: {}", exc)
+            return ApplyResult(reason=str(exc))
diff --git a/src/web/app.py b/src/web/app.py
index db1ac1e1e..c5af28fe6 100644
--- a/src/web/app.py
+++ b/src/web/app.py
@@ -1,6 +1,7 @@
 """
-FastAPI web server for AIHawk Resume & Cover Letter Builder.
-Provides a web UI with async document generation and WebSocket progress updates.
+FastAPI web server for AIHawk Jobs Applier — unified multi-platform job application bot.
+Provides a web UI with async document generation, WebSocket progress updates,
+and an automated job application bot supporting LinkedIn, Indeed, Glassdoor, ZipRecruiter, Dice.
 """
 import asyncio
 import base64
@@ -12,16 +13,19 @@
 
 import yaml
 from fastapi import FastAPI, WebSocket, WebSocketDisconnect, HTTPException
-from fastapi.responses import HTMLResponse, Response
+from fastapi.responses import HTMLResponse, Response, StreamingResponse
 from pydantic import BaseModel
 
 from src.logging import logger
 
-app = FastAPI(title="AIHawk Resume Builder", version="1.0.0")
+app = FastAPI(title="AIHawk Jobs Applier", version="2.0.0")
 
 # In-memory job store for generated documents
 _jobs: dict = {}
 
+# Credentials file path
+CREDENTIALS_PATH = Path("data_folder/credentials.yaml")
+
 
 class GenerateRequest(BaseModel):
     """Request model for document generation."""
@@ -750,3 +754,234 @@ async def websocket_endpoint(websocket: WebSocket, job_id: str):
                 break
     finally:
         manager.disconnect(websocket, job_id)
+
+
+# =============================================================================
+# Bot Control Endpoints
+# =============================================================================
+
+class BotStartRequest(BaseModel):
+    """Request body for POST /api/bot/start."""
+    platforms: list[str] = ["linkedin"]
+    min_score: int = 7
+    max_applications: int = 50
+    headless: bool = True
+    generate_tailored_resume: bool = False
+    llm_api_key: str
+    llm_model_type: str = "openai"
+    llm_model: str = "gpt-4o-mini"
+
+
+class CredentialsUpdate(BaseModel):
+    """Per-platform login credentials."""
+    linkedin: Optional[dict] = None       # {email, password}
+    indeed: Optional[dict] = None
+    glassdoor: Optional[dict] = None
+    ziprecruiter: Optional[dict] = None
+    dice: Optional[dict] = None
+
+
+def _load_credentials() -> dict:
+    """Load credentials.yaml, return empty dict if not found."""
+    if CREDENTIALS_PATH.exists():
+        try:
+            return yaml.safe_load(CREDENTIALS_PATH.read_text()) or {}
+        except Exception:
+            return {}
+    return {}
+
+
+def _save_credentials(data: dict) -> None:
+    CREDENTIALS_PATH.parent.mkdir(parents=True, exist_ok=True)
+    CREDENTIALS_PATH.write_text(yaml.dump(data, default_flow_style=False, sort_keys=False))
+
+
+def _load_preferences() -> dict:
+    if WORK_PREFERENCES_PATH.exists():
+        try:
+            return yaml.safe_load(WORK_PREFERENCES_PATH.read_text()) or {}
+        except Exception:
+            return {}
+    return {}
+
+
+# Bot WebSocket connections store
+_bot_connections: list[WebSocket] = []
+
+
+@app.post("/api/bot/start")
+async def bot_start(request: BotStartRequest):
+    """Start the automation bot."""
+    from src.automation.bot_manager import BotManager, BotConfig
+    bot = BotManager()
+    if bot.status == "running":
+        raise HTTPException(status_code=409, detail="Bot is already running.")
+
+    credentials = _load_credentials()
+    preferences = _load_preferences()
+
+    creds_by_platform = {}
+    for platform in request.platforms:
+        creds_by_platform[platform] = credentials.get(platform, {})
+
+    config = BotConfig(
+        platforms=request.platforms,
+        credentials=creds_by_platform,
+        preferences=preferences,
+        llm_api_key=request.llm_api_key,
+        llm_model_type=request.llm_model_type,
+        llm_model=request.llm_model,
+        min_score=request.min_score,
+        max_applications=request.max_applications,
+        headless=request.headless,
+        generate_tailored_resume=request.generate_tailored_resume,
+    )
+
+    # Register a callback to push log entries to all connected bot WebSocket clients
+    async def ws_broadcast(entry: dict):
+        dead = []
+        for ws in _bot_connections:
+            try:
+                await ws.send_json({"type": "log", **entry, **bot.get_status()})
+            except Exception:
+                dead.append(ws)
+        for ws in dead:
+            if ws in _bot_connections:
+                _bot_connections.remove(ws)
+
+    bot.register_progress_callback(ws_broadcast)
+
+    session_id = await bot.start(config)
+    return {"status": "started", "session_id": session_id}
+
+
+@app.post("/api/bot/stop")
+async def bot_stop():
+    """Stop the running bot."""
+    from src.automation.bot_manager import BotManager
+    bot = BotManager()
+    await bot.stop()
+    return {"status": "stopped"}
+
+
+@app.post("/api/bot/pause")
+async def bot_pause():
+    """Pause the running bot."""
+    from src.automation.bot_manager import BotManager
+    bot = BotManager()
+    await bot.pause()
+    return {"status": "paused"}
+
+
+@app.post("/api/bot/resume")
+async def bot_resume():
+    """Resume a paused bot."""
+    from src.automation.bot_manager import BotManager
+    bot = BotManager()
+    await bot.resume()
+    return {"status": "running"}
+
+
+@app.get("/api/bot/status")
+async def bot_status():
+    """Get current bot status and stats."""
+    from src.automation.bot_manager import BotManager
+    bot = BotManager()
+    return bot.get_status()
+
+
+@app.websocket("/ws/bot")
+async def bot_websocket(websocket: WebSocket):
+    """WebSocket for real-time bot log streaming."""
+    await websocket.accept()
+    _bot_connections.append(websocket)
+    try:
+        # Send current status immediately
+        from src.automation.bot_manager import BotManager
+        bot = BotManager()
+        await websocket.send_json({"type": "status", **bot.get_status()})
+        # Keep alive — server pushes updates via ws_broadcast callback
+        while True:
+            try:
+                await websocket.receive_text()
+            except WebSocketDisconnect:
+                break
+    finally:
+        if websocket in _bot_connections:
+            _bot_connections.remove(websocket)
+
+
+# =============================================================================
+# Credentials Endpoints
+# =============================================================================
+
+@app.get("/api/credentials")
+async def get_credentials():
+    """Return saved credentials with passwords masked."""
+    creds = _load_credentials()
+    masked = {}
+    for platform, data in creds.items():
+        if isinstance(data, dict):
+            masked[platform] = {
+                k: ("***" if "password" in k.lower() or "secret" in k.lower() else v)
+                for k, v in data.items()
+            }
+    return masked
+
+
+@app.put("/api/credentials")
+async def update_credentials(body: CredentialsUpdate):
+    """Save credentials for each platform."""
+    existing = _load_credentials()
+    update_data = {
+        k: v for k, v in body.model_dump().items() if v is not None
+    }
+    existing.update(update_data)
+    try:
+        _save_credentials(existing)
+    except OSError as exc:
+        raise HTTPException(status_code=500, detail=f"Failed to save credentials: {exc}")
+    return {"status": "ok", "message": "Credentials saved."}
+
+
+# =============================================================================
+# Application History Endpoints
+# =============================================================================
+
+@app.get("/api/applications")
+async def list_applications(
+    platform: Optional[str] = None,
+    status: Optional[str] = None,
+    limit: int = 200,
+    offset: int = 0,
+):
+    """List job applications from the tracker database."""
+    from src.automation.application_tracker import ApplicationTracker
+    tracker = ApplicationTracker()
+    apps = tracker.get_applications(platform=platform, status=status, limit=limit, offset=offset)
+    stats = tracker.get_stats()
+    return {"applications": apps, "stats": stats}
+
+
+@app.get("/api/applications/{app_id}")
+async def get_application(app_id: int):
+    """Get a single application by ID."""
+    from src.automation.application_tracker import ApplicationTracker
+    tracker = ApplicationTracker()
+    app = tracker.get_application(app_id)
+    if not app:
+        raise HTTPException(status_code=404, detail="Application not found.")
+    return app
+
+
+@app.get("/api/applications/export/csv")
+async def export_applications_csv():
+    """Export all applications as CSV."""
+    from src.automation.application_tracker import ApplicationTracker
+    tracker = ApplicationTracker()
+    csv_data = tracker.export_csv()
+    return StreamingResponse(
+        iter([csv_data]),
+        media_type="text/csv",
+        headers={"Content-Disposition": "attachment; filename=applications.csv"},
+    )
diff --git a/src/web/ui.py b/src/web/ui.py
index 89fd3fbfc..def5071e9 100644
--- a/src/web/ui.py
+++ b/src/web/ui.py
@@ -15,7 +15,7 @@ def get_html() -> str:
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>AIHawk Resume Builder</title>
+    <title>AIHawk Jobs Applier</title>
     <style>
         :root {
             --primary: #2563eb;
@@ -323,7 +323,7 @@ def get_html() -> str:
 </head>
 <body>
     <div class="header">
-        <h1><span class="icon">&#128640;</span> AIHawk Resume Builder</h1>
+        <h1><span class="icon">&#128640;</span> AIHawk Jobs Applier</h1>
         <div class="header-actions">
             <span id="healthBadge" class="badge badge-warning">Checking...</span>
         </div>
@@ -336,6 +336,8 @@ def get_html() -> str:
             <button class="main-tab active" onclick="switchTab('generate')">&#9889; Generate</button>
             <button class="main-tab" onclick="switchTab('resume')">&#128221; Resume</button>
             <button class="main-tab" onclick="switchTab('settings')">&#9881; Settings</button>
+            <button class="main-tab" onclick="switchTab('bot')">&#129302; Auto Apply</button>
+            <button class="main-tab" onclick="switchTab('applications')">&#128196; Applications</button>
         </div>
 
         <!-- TAB 1: GENERATE -->
@@ -603,6 +605,233 @@ def get_html() -> str:
                 </div>
             </div>
         </div>
+
+        <!-- TAB 4: AUTO APPLY BOT -->
+        <div id="tab-bot" class="tab-panel">
+            <div class="grid">
+                <!-- Left: Configuration -->
+                <div>
+                    <!-- Platforms -->
+                    <div class="card" style="margin-bottom:20px">
+                        <div class="card-header"><h2>&#127758; Platforms</h2></div>
+                        <div class="card-body">
+                            <p style="margin-bottom:12px;color:var(--gray-500);font-size:13px">Select which job platforms to search and apply on.</p>
+                            <div style="display:flex;flex-wrap:wrap;gap:10px">
+                                <label style="display:flex;align-items:center;gap:6px;cursor:pointer"><input type="checkbox" id="plt-linkedin" checked> LinkedIn</label>
+                                <label style="display:flex;align-items:center;gap:6px;cursor:pointer"><input type="checkbox" id="plt-indeed"> Indeed</label>
+                                <label style="display:flex;align-items:center;gap:6px;cursor:pointer"><input type="checkbox" id="plt-glassdoor"> Glassdoor</label>
+                                <label style="display:flex;align-items:center;gap:6px;cursor:pointer"><input type="checkbox" id="plt-ziprecruiter"> ZipRecruiter</label>
+                                <label style="display:flex;align-items:center;gap:6px;cursor:pointer"><input type="checkbox" id="plt-dice"> Dice</label>
+                                <label style="display:flex;align-items:center;gap:6px;cursor:pointer"><input type="checkbox" id="plt-universal"> Universal (any URL)</label>
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Credentials -->
+                    <div class="card" style="margin-bottom:20px">
+                        <div class="card-header">
+                            <h2>&#128272; Platform Credentials</h2>
+                            <button class="btn btn-outline btn-sm" onclick="loadCredentials()">Load Saved</button>
+                        </div>
+                        <div class="card-body">
+                            <p style="margin-bottom:12px;color:var(--gray-500);font-size:13px">Saved to <code>data_folder/credentials.yaml</code> on your machine.</p>
+                            <div id="credentials-panels">
+                                <div class="cred-panel" id="cred-linkedin">
+                                    <strong style="font-size:13px">LinkedIn</strong>
+                                    <div class="form-row" style="margin-top:8px">
+                                        <div class="form-group"><label class="form-label">Email</label><input type="email" id="cred-linkedin-email" class="form-input" placeholder="you@email.com"></div>
+                                        <div class="form-group"><label class="form-label">Password</label><input type="password" id="cred-linkedin-password" class="form-input" placeholder="••••••••"></div>
+                                    </div>
+                                </div>
+                                <div class="cred-panel" id="cred-indeed" style="margin-top:12px;display:none">
+                                    <strong style="font-size:13px">Indeed</strong>
+                                    <div class="form-row" style="margin-top:8px">
+                                        <div class="form-group"><label class="form-label">Email</label><input type="email" id="cred-indeed-email" class="form-input" placeholder="you@email.com"></div>
+                                        <div class="form-group"><label class="form-label">Password</label><input type="password" id="cred-indeed-password" class="form-input" placeholder="••••••••"></div>
+                                    </div>
+                                </div>
+                                <div class="cred-panel" id="cred-glassdoor" style="margin-top:12px;display:none">
+                                    <strong style="font-size:13px">Glassdoor</strong>
+                                    <div class="form-row" style="margin-top:8px">
+                                        <div class="form-group"><label class="form-label">Email</label><input type="email" id="cred-glassdoor-email" class="form-input" placeholder="you@email.com"></div>
+                                        <div class="form-group"><label class="form-label">Password</label><input type="password" id="cred-glassdoor-password" class="form-input" placeholder="••••••••"></div>
+                                    </div>
+                                </div>
+                                <div class="cred-panel" id="cred-ziprecruiter" style="margin-top:12px;display:none">
+                                    <strong style="font-size:13px">ZipRecruiter</strong>
+                                    <div class="form-row" style="margin-top:8px">
+                                        <div class="form-group"><label class="form-label">Email</label><input type="email" id="cred-ziprecruiter-email" class="form-input" placeholder="you@email.com"></div>
+                                        <div class="form-group"><label class="form-label">Password</label><input type="password" id="cred-ziprecruiter-password" class="form-input" placeholder="••••••••"></div>
+                                    </div>
+                                </div>
+                                <div class="cred-panel" id="cred-dice" style="margin-top:12px;display:none">
+                                    <strong style="font-size:13px">Dice</strong>
+                                    <div class="form-row" style="margin-top:8px">
+                                        <div class="form-group"><label class="form-label">Email</label><input type="email" id="cred-dice-email" class="form-input" placeholder="you@email.com"></div>
+                                        <div class="form-group"><label class="form-label">Password</label><input type="password" id="cred-dice-password" class="form-input" placeholder="••••••••"></div>
+                                    </div>
+                                </div>
+                            </div>
+                            <div style="margin-top:12px">
+                                <button class="btn btn-primary btn-sm" onclick="saveCredentials()">&#128190; Save Credentials</button>
+                            </div>
+                            <div id="credStatus" class="status-msg"></div>
+                        </div>
+                    </div>
+
+                    <!-- Bot Settings -->
+                    <div class="card">
+                        <div class="card-header"><h2>&#9881; Bot Settings</h2></div>
+                        <div class="card-body">
+                            <div class="form-group">
+                                <label class="form-label">LLM Provider</label>
+                                <select id="bot-llm-type" class="form-input" onchange="updateBotModelOptions()">
+                                    <option value="openai">OpenAI</option>
+                                    <option value="claude">Claude (Anthropic)</option>
+                                    <option value="gemini">Google Gemini</option>
+                                    <option value="ollama">Ollama (local)</option>
+                                </select>
+                            </div>
+                            <div class="form-group">
+                                <label class="form-label">Model</label>
+                                <select id="bot-llm-model" class="form-input"></select>
+                            </div>
+                            <div class="form-group">
+                                <label class="form-label">API Key</label>
+                                <input type="password" id="bot-api-key" class="form-input" placeholder="sk-...  (not needed for Ollama)">
+                            </div>
+                            <div class="form-row">
+                                <div class="form-group">
+                                    <label class="form-label">Min Score (1-10)</label>
+                                    <input type="number" id="bot-min-score" class="form-input" value="7" min="1" max="10">
+                                </div>
+                                <div class="form-group">
+                                    <label class="form-label">Max Applications</label>
+                                    <input type="number" id="bot-max-apps" class="form-input" value="50" min="1" max="500">
+                                </div>
+                            </div>
+                            <div style="display:flex;gap:20px;margin-top:4px">
+                                <label style="display:flex;align-items:center;gap:6px;cursor:pointer">
+                                    <input type="checkbox" id="bot-headless" checked> Headless browser
+                                </label>
+                                <label style="display:flex;align-items:center;gap:6px;cursor:pointer">
+                                    <input type="checkbox" id="bot-tailored-resume"> Generate tailored resume per job
+                                </label>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <!-- Right: Live Status & Log -->
+                <div>
+                    <div class="card" style="margin-bottom:20px">
+                        <div class="card-header">
+                            <h2>&#9654; Bot Control</h2>
+                            <div class="btn-group">
+                                <button id="btn-bot-start" class="btn btn-primary" onclick="botStart()">&#9654; Start</button>
+                                <button id="btn-bot-pause" class="btn btn-outline" onclick="botPause()" disabled>&#9646;&#9646; Pause</button>
+                                <button id="btn-bot-stop" class="btn" style="background:var(--danger);color:white" onclick="botStop()" disabled>&#9632; Stop</button>
+                            </div>
+                        </div>
+                        <div class="card-body">
+                            <div id="bot-status-banner" style="padding:12px;border-radius:6px;background:var(--gray-100);margin-bottom:16px;font-size:14px">
+                                Status: <strong id="bot-status-text">Idle</strong>
+                                &nbsp;|&nbsp; Platform: <span id="bot-platform-text">—</span>
+                                &nbsp;|&nbsp; Job: <span id="bot-job-text">—</span>
+                            </div>
+                            <div style="display:flex;gap:16px;margin-bottom:16px;text-align:center">
+                                <div style="flex:1;padding:12px;background:var(--gray-50);border-radius:6px;border:1px solid var(--gray-200)">
+                                    <div style="font-size:24px;font-weight:700;color:var(--success)" id="stat-applied">0</div>
+                                    <div style="font-size:12px;color:var(--gray-500)">Applied</div>
+                                </div>
+                                <div style="flex:1;padding:12px;background:var(--gray-50);border-radius:6px;border:1px solid var(--gray-200)">
+                                    <div style="font-size:24px;font-weight:700;color:var(--warning)" id="stat-skipped">0</div>
+                                    <div style="font-size:12px;color:var(--gray-500)">Skipped</div>
+                                </div>
+                                <div style="flex:1;padding:12px;background:var(--gray-50);border-radius:6px;border:1px solid var(--gray-200)">
+                                    <div style="font-size:24px;font-weight:700;color:var(--danger)" id="stat-failed">0</div>
+                                    <div style="font-size:12px;color:var(--gray-500)">Failed</div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+
+                    <div class="card">
+                        <div class="card-header">
+                            <h2>&#128221; Live Log</h2>
+                            <button class="btn btn-outline btn-sm" onclick="clearBotLog()">Clear</button>
+                        </div>
+                        <div class="card-body" style="padding:0">
+                            <div id="bot-log" style="font-family:monospace;font-size:12px;background:#1e1e1e;color:#d4d4d4;padding:12px;height:300px;overflow-y:auto;border-radius:0 0 8px 8px">
+                                <div style="color:#888">Bot log will appear here when running...</div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- TAB 5: APPLICATIONS HISTORY -->
+        <div id="tab-applications" class="tab-panel">
+            <div class="card">
+                <div class="card-header">
+                    <h2>&#128196; Application History</h2>
+                    <div class="btn-group">
+                        <button class="btn btn-outline btn-sm" onclick="loadApplications()">&#128259; Refresh</button>
+                        <a id="btn-export-csv" href="/api/applications/export/csv" class="btn btn-outline btn-sm" download="applications.csv">&#128229; Export CSV</a>
+                    </div>
+                </div>
+                <div class="card-body" style="padding:0">
+                    <!-- Stats bar -->
+                    <div id="app-stats-bar" style="display:flex;gap:16px;padding:16px;border-bottom:1px solid var(--gray-200);flex-wrap:wrap">
+                        <div>Total: <strong id="app-stat-total">—</strong></div>
+                        <div style="color:var(--success)">Applied: <strong id="app-stat-applied">—</strong></div>
+                        <div style="color:var(--warning)">Skipped: <strong id="app-stat-skipped">—</strong></div>
+                        <div style="color:var(--danger)">Failed: <strong id="app-stat-failed">—</strong></div>
+                    </div>
+                    <!-- Filters -->
+                    <div style="display:flex;gap:12px;padding:12px 16px;border-bottom:1px solid var(--gray-200);flex-wrap:wrap">
+                        <select id="app-filter-platform" class="form-input" style="width:auto" onchange="loadApplications()">
+                            <option value="">All Platforms</option>
+                            <option value="linkedin">LinkedIn</option>
+                            <option value="indeed">Indeed</option>
+                            <option value="glassdoor">Glassdoor</option>
+                            <option value="ziprecruiter">ZipRecruiter</option>
+                            <option value="dice">Dice</option>
+                            <option value="universal">Universal</option>
+                        </select>
+                        <select id="app-filter-status" class="form-input" style="width:auto" onchange="loadApplications()">
+                            <option value="">All Statuses</option>
+                            <option value="applied">Applied</option>
+                            <option value="skipped">Skipped</option>
+                            <option value="failed">Failed</option>
+                            <option value="discovered">Discovered</option>
+                            <option value="scored">Scored</option>
+                        </select>
+                    </div>
+                    <!-- Table -->
+                    <div style="overflow-x:auto">
+                        <table id="app-table" style="width:100%;border-collapse:collapse;font-size:13px">
+                            <thead>
+                                <tr style="background:var(--gray-50);border-bottom:2px solid var(--gray-200)">
+                                    <th style="padding:10px 16px;text-align:left;font-weight:600">Platform</th>
+                                    <th style="padding:10px 16px;text-align:left;font-weight:600">Company</th>
+                                    <th style="padding:10px 16px;text-align:left;font-weight:600">Title</th>
+                                    <th style="padding:10px 16px;text-align:left;font-weight:600">Score</th>
+                                    <th style="padding:10px 16px;text-align:left;font-weight:600">Status</th>
+                                    <th style="padding:10px 16px;text-align:left;font-weight:600">Date</th>
+                                    <th style="padding:10px 16px;text-align:left;font-weight:600">Link</th>
+                                </tr>
+                            </thead>
+                            <tbody id="app-tbody">
+                                <tr><td colspan="7" style="padding:24px;text-align:center;color:var(--gray-400)">Click Refresh to load applications.</td></tr>
+                            </tbody>
+                        </table>
+                    </div>
+                </div>
+            </div>
+        </div>
+
     </div>
     <script>
         /* ========== STATE ========== */
@@ -733,10 +962,220 @@ def get_html() -> str:
             document.querySelectorAll('.tab-panel').forEach(p => p.classList.remove('active'));
             document.getElementById('tab-' + tabName).classList.add('active');
             const tabs = document.querySelectorAll('.main-tab');
-            const tabMap = ['generate', 'resume', 'settings'];
+            const tabMap = ['generate', 'resume', 'settings', 'bot', 'applications'];
             const idx = tabMap.indexOf(tabName);
             if (idx >= 0 && tabs[idx]) tabs[idx].classList.add('active');
             if (tabName === 'generate') updateResumePreview();
+            if (tabName === 'bot') updateBotModelOptions();
+            if (tabName === 'applications') loadApplications();
+        }
+
+        /* ========== PLATFORM CREDENTIAL PANEL TOGGLE ========== */
+        ['linkedin','indeed','glassdoor','ziprecruiter','dice'].forEach(p => {
+            const cb = document.getElementById('plt-' + p);
+            if (cb) cb.addEventListener('change', function() {
+                const panel = document.getElementById('cred-' + p);
+                if (panel) panel.style.display = this.checked ? 'block' : 'none';
+            });
+        });
+
+        /* ========== BOT LLM MODEL OPTIONS ========== */
+        function updateBotModelOptions() {
+            const type = document.getElementById('bot-llm-type').value;
+            const select = document.getElementById('bot-llm-model');
+            const options = modelOptions[type] || [];
+            select.innerHTML = options.map(o => `<option value="${o.value}">${o.label}</option>`).join('');
+        }
+
+        /* ========== CREDENTIALS ========== */
+        async function loadCredentials() {
+            try {
+                const res = await fetch('/api/credentials');
+                const data = await res.json();
+                ['linkedin','indeed','glassdoor','ziprecruiter','dice'].forEach(p => {
+                    const creds = data[p] || {};
+                    const emailEl = document.getElementById('cred-' + p + '-email');
+                    const passEl = document.getElementById('cred-' + p + '-password');
+                    if (emailEl && creds.email) emailEl.value = creds.email;
+                    if (passEl && creds.password) passEl.value = creds.password === '***' ? '' : creds.password;
+                });
+                showStatusMsg('credStatus', 'success', 'Credentials loaded.');
+            } catch(e) {
+                showStatusMsg('credStatus', 'error', 'Failed to load credentials: ' + e.message);
+            }
+        }
+
+        async function saveCredentials() {
+            const body = {};
+            ['linkedin','indeed','glassdoor','ziprecruiter','dice'].forEach(p => {
+                const emailEl = document.getElementById('cred-' + p + '-email');
+                const passEl = document.getElementById('cred-' + p + '-password');
+                if (emailEl && passEl && (emailEl.value || passEl.value)) {
+                    body[p] = { email: emailEl.value, password: passEl.value };
+                }
+            });
+            try {
+                const res = await fetch('/api/credentials', {
+                    method: 'PUT',
+                    headers: {'Content-Type': 'application/json'},
+                    body: JSON.stringify(body),
+                });
+                const data = await res.json();
+                if (res.ok) showStatusMsg('credStatus', 'success', 'Credentials saved.');
+                else showStatusMsg('credStatus', 'error', data.detail || 'Save failed.');
+            } catch(e) {
+                showStatusMsg('credStatus', 'error', 'Network error: ' + e.message);
+            }
+        }
+
+        /* ========== BOT CONTROL ========== */
+        let botWs = null;
+
+        function botAppendLog(msg, color) {
+            const log = document.getElementById('bot-log');
+            const div = document.createElement('div');
+            div.style.color = color || '#d4d4d4';
+            div.textContent = '[' + new Date().toLocaleTimeString() + '] ' + msg;
+            log.appendChild(div);
+            log.scrollTop = log.scrollHeight;
+        }
+
+        function clearBotLog() {
+            const log = document.getElementById('bot-log');
+            log.innerHTML = '';
+        }
+
+        function updateBotStatus(data) {
+            const stats = data.stats || {};
+            document.getElementById('bot-status-text').textContent = data.status || 'idle';
+            document.getElementById('bot-platform-text').textContent = stats.current_platform || '—';
+            document.getElementById('bot-job-text').textContent = stats.current_job || '—';
+            document.getElementById('stat-applied').textContent = stats.applied || 0;
+            document.getElementById('stat-skipped').textContent = stats.skipped || 0;
+            document.getElementById('stat-failed').textContent = stats.failed || 0;
+
+            const running = data.status === 'running';
+            const paused = data.status === 'paused';
+            const idle = data.status === 'idle';
+            document.getElementById('btn-bot-start').disabled = running || paused;
+            document.getElementById('btn-bot-pause').disabled = idle || paused;
+            document.getElementById('btn-bot-stop').disabled = idle;
+        }
+
+        function connectBotWs() {
+            if (botWs) botWs.close();
+            const proto = location.protocol === 'https:' ? 'wss:' : 'ws:';
+            botWs = new WebSocket(proto + '//' + location.host + '/ws/bot');
+            botWs.onmessage = function(e) {
+                const data = JSON.parse(e.data);
+                if (data.msg) botAppendLog(data.msg);
+                updateBotStatus(data);
+            };
+            botWs.onclose = function() {
+                setTimeout(() => { if (document.getElementById('tab-bot').classList.contains('active')) connectBotWs(); }, 3000);
+            };
+        }
+
+        async function botStart() {
+            const platforms = ['linkedin','indeed','glassdoor','ziprecruiter','dice','universal']
+                .filter(p => document.getElementById('plt-' + p) && document.getElementById('plt-' + p).checked);
+            if (!platforms.length) { alert('Select at least one platform.'); return; }
+            const apiKey = document.getElementById('bot-api-key').value.trim();
+            const llmType = document.getElementById('bot-llm-type').value;
+            if (!apiKey && llmType !== 'ollama') { alert('Please enter your LLM API key.'); return; }
+
+            const body = {
+                platforms,
+                llm_api_key: apiKey,
+                llm_model_type: llmType,
+                llm_model: document.getElementById('bot-llm-model').value,
+                min_score: parseInt(document.getElementById('bot-min-score').value) || 7,
+                max_applications: parseInt(document.getElementById('bot-max-apps').value) || 50,
+                headless: document.getElementById('bot-headless').checked,
+                generate_tailored_resume: document.getElementById('bot-tailored-resume').checked,
+            };
+            try {
+                const res = await fetch('/api/bot/start', {
+                    method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(body),
+                });
+                const data = await res.json();
+                if (res.ok) {
+                    botAppendLog('Bot started — session ' + data.session_id, '#4ec9b0');
+                    connectBotWs();
+                } else {
+                    botAppendLog('Start failed: ' + (data.detail || 'Unknown error'), '#f44747');
+                }
+            } catch(e) {
+                botAppendLog('Network error: ' + e.message, '#f44747');
+            }
+        }
+
+        async function botPause() {
+            const s = document.getElementById('btn-bot-pause');
+            if (s.textContent.includes('Pause')) {
+                await fetch('/api/bot/pause', {method:'POST'});
+                s.textContent = '▶ Resume';
+            } else {
+                await fetch('/api/bot/resume', {method:'POST'});
+                s.textContent = '⏸ Pause';
+            }
+        }
+
+        async function botStop() {
+            await fetch('/api/bot/stop', {method:'POST'});
+            botAppendLog('Stop requested...', '#ce9178');
+        }
+
+        /* ========== APPLICATIONS ========== */
+        async function loadApplications() {
+            const platform = document.getElementById('app-filter-platform').value;
+            const status = document.getElementById('app-filter-status').value;
+            let url = '/api/applications?limit=200';
+            if (platform) url += '&platform=' + encodeURIComponent(platform);
+            if (status) url += '&status=' + encodeURIComponent(status);
+            try {
+                const res = await fetch(url);
+                const data = await res.json();
+                // Update stats
+                const stats = data.stats || {};
+                document.getElementById('app-stat-total').textContent = stats.total || 0;
+                document.getElementById('app-stat-applied').textContent = stats.applied || 0;
+                document.getElementById('app-stat-skipped').textContent = stats.skipped || 0;
+                document.getElementById('app-stat-failed').textContent = stats.failed || 0;
+                // Populate table
+                const tbody = document.getElementById('app-tbody');
+                const apps = data.applications || [];
+                if (!apps.length) {
+                    tbody.innerHTML = '<tr><td colspan="7" style="padding:24px;text-align:center;color:var(--gray-400)">No applications found.</td></tr>';
+                    return;
+                }
+                const statusColors = {applied:'var(--success)',skipped:'var(--warning)',failed:'var(--danger)',discovered:'var(--gray-500)',scored:'var(--primary)'};
+                tbody.innerHTML = apps.map(a => `
+                    <tr style="border-bottom:1px solid var(--gray-100);cursor:pointer" onmouseover="this.style.background='var(--gray-50)'" onmouseout="this.style.background=''">
+                        <td style="padding:10px 16px"><span class="badge" style="background:var(--primary-light);color:var(--primary)">${a.platform || '—'}</span></td>
+                        <td style="padding:10px 16px">${escHtml(a.company || '—')}</td>
+                        <td style="padding:10px 16px">${escHtml(a.title || '—')}</td>
+                        <td style="padding:10px 16px;text-align:center">${a.score ? '<strong>' + a.score + '</strong>/10' : '—'}</td>
+                        <td style="padding:10px 16px"><span style="color:${statusColors[a.status]||'var(--gray-500)'};font-weight:600">${a.status || '—'}</span></td>
+                        <td style="padding:10px 16px;color:var(--gray-500)">${a.applied_at ? new Date(a.applied_at).toLocaleDateString() : (a.discovered_at ? new Date(a.discovered_at).toLocaleDateString() : '—')}</td>
+                        <td style="padding:10px 16px">${a.url ? '<a href="' + escHtml(a.url) + '" target="_blank" style="color:var(--primary)">Open &#8599;</a>' : '—'}</td>
+                    </tr>
+                `).join('');
+            } catch(e) {
+                console.error('Failed to load applications:', e);
+            }
+        }
+
+        function escHtml(s) {
+            return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
+        }
+
+        function showStatusMsg(id, type, msg) {
+            const el = document.getElementById(id);
+            if (!el) return;
+            el.className = 'status-msg status-' + type;
+            el.textContent = msg;
+            setTimeout(() => { el.textContent = ''; el.className = 'status-msg'; }, 5000);
         }
 
         function updateResumePreview() {