career-workspace-ambujsystems

<div align="center">

<!-- Animated Header Banner -->
<img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=10,12,14,16,18&height=220&section=header&text=CoverCraft%20Workspace&fontSize=42&fontColor=ffffff&fontAlignY=35&desc=Evidence-Grounded%20Career%20Workspace%20•%20Claim-Validation%20Engine%20•%20Real-Time%20Company%20Intelligence&descSize=15&descAlignY=55&animation=fadeIn" width="100%"/>

<br/>

<a href="https://git.io/typing-svg"><img src="https://readme-typing-svg.demolab.com?font=Fira+Code&weight=600&size=20&pause=1000&color=6EE7B7&background=00000000&center=true&vCenter=true&repeat=true&width=750&height=70&lines=Evidence-Grounded+Generation+%E2%80%A2+Claim+Validation;Tavily+8-Page+Crawl+%2B+Jina+AI+Reader+Markdown+Extractor;Third-Party+%26+Payroll+Detection+via+Verbatim+JD+Quotes;Anthropic+MCP+Server+%2B+Next.js+16+Multi-Stage+Docker" alt="Typing SVG" /></a>

<br/>

[![Live Production Demo](https://img.shields.io/badge/LIVE_PRODUCTION-Visit_App-059669?style=for-the-badge&logoColor=white)](https://career-workspace-ambujsystems.vercel.app/)
[![Interactive System Docs](https://img.shields.io/badge/INTERACTIVE_DOCS-System_Architecture-2563EB?style=for-the-badge)](https://career-workspace-ambujsystems.vercel.app/docs)
[![GitHub Release](https://img.shields.io/github/v/release/Ambuj123-lab/career-workspace-ambujsystems?color=10b981&label=Release&style=for-the-badge&logo=github)](https://github.com/Ambuj123-lab/career-workspace-ambujsystems/releases/latest)
[![Uptime SLA 99.998%](https://badge.uptimerobot.com/sla/18a544b11fc4799a468704cc7acccedb.svg?theme=dark)](https://stats.uptimerobot.com/4tYmSQnuBE?utm_source=status_badge&utm_medium=referral)
[![Product Hunt](https://img.shields.io/badge/Product_Hunt-Live_Launch-FF6154?style=for-the-badge&logo=producthunt&logoColor=white)](https://www.producthunt.com/products/covercraft-ai-3)
[![Featured on UptimeRobot](https://img.shields.io/badge/FEATURED_IN-UptimeRobot_Official_Blog-047857?style=for-the-badge&logo=uptimerobot&logoColor=3BD671)](https://uptimerobot.com/blog/community-spotlight-ambuj-kumar-tripathi/)
[![Glama MCP Score](https://glama.ai/mcp/servers/Ambuj123-lab/career-workspace-ambujsystems/badges/score.svg)](https://glama.ai/mcp/servers/Ambuj123-lab/career-workspace-ambujsystems)
[![M8ven Verified](https://m8ven.ai/badge/mcp/ambuj123-lab/career-workspace-ambujsystems?variant=verified)](https://m8ven.ai/mcp/ambuj123-lab/career-workspace-ambujsystems)
[![Smithery Verified MCP](https://img.shields.io/badge/SMITHERY_MCP-VERIFIED_8_TOOLS-FF6000?style=for-the-badge&logoColor=white)](https://smithery.ai/servers/ambujonly761/covercraft-mcp)
[![Author Portfolio](https://img.shields.io/badge/PORTFOLIO-Ambuj_Tripathi-8B5CF6?style=for-the-badge)](https://ambuj-ai-portfolio.vercel.app/)

<br/>

[![Next.js 16](https://img.shields.io/badge/Next.js-16.1.6-black?style=flat-square&logo=next.js)](https://nextjs.org/)
[![React 19](https://img.shields.io/badge/React-19.0.0-61DAFB?style=flat-square&logo=react)](https://react.dev/)
[![Google Gemini API](https://img.shields.io/badge/Gemini_API-3.5_Flash_Lite-4285F4?style=flat-square&logo=google)](https://ai.google.dev/)
[![Multi-Provider Fallback](https://img.shields.io/badge/Fallback-OpenRouter_Nemotron_550B-7C3AED?style=flat-square)](https://openrouter.ai/)
[![Tavily AI Search](https://img.shields.io/badge/Tavily_AI-8--Page_Web_Crawl-0ea5e9?style=flat-square)](https://tavily.com/)
[![Jina AI Reader](https://img.shields.io/badge/Jina_AI-Markdown_Extractor-blueviolet?style=flat-square)](https://jina.ai/)
[![MongoDB Atlas](https://img.shields.io/badge/MongoDB-Atlas_Telemetry-47A248?style=flat-square&logo=mongodb)](https://www.mongodb.com/atlas)
[![Langfuse Observability](https://img.shields.io/badge/Langfuse-LLM_Observability-black?style=flat-square&logo=langfuse)](https://langfuse.com/)
[![GitHub MCP Proofer](https://img.shields.io/badge/GitHub_MCP-Commit_Auditor-181717?style=flat-square&logo=github)](https://github.com/)
[![Docker](https://img.shields.io/badge/Docker-Multi--Stage_120MB-2496ED?style=flat-square&logo=docker)](https://docker.com)
[![Vercel Edge](https://img.shields.io/badge/Vercel-Serverless_Edge-000000?style=flat-square&logo=vercel)](https://vercel.com)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)

</div>

---

## 🎯 The Engineering Philosophy

### ❌ The "Toy AI Generator" Fallacy
99% of cover letter tools on the internet are simple prompt wrappers that cause immediate disqualification during technical recruiter screens:
- **Hallucinated Metrics:** They invent fake quantitative claims (*"Increased revenue by 43% using Docker"* when the candidate only listed Docker under skills).
- **Fluff & Sycophancy:** They inject generic, embarrassing praise (*"I have long admired your revolutionary, industry-defining synergy"*).
- **Zero Company Grounding:** They have no real-time awareness of recent engineering pivots, active tech stacks, or corporate subsidiaries.
- **Hidden Third-Party Traps:** They fail to detect when a job posting is a third-party staffing/payroll agency disguised as a direct employer.

### ✅ The CoverCraft Architecture: Verifiable Evidence Graph
**CoverCraft is not a template filler. It is an Evidence-Grounded Career Workspace & Claim-Validation Engine designed for senior engineers and discerning hiring teams.**

```
Candidate Resume (PDF)          Job Description (JD)           Live Web (Tavily + Jina AI)
        │                               │                                 │
        ▼                               ▼                                 ▼
┌──────────────────┐           ┌──────────────────┐             ┌────────────────────┐
│ Deterministic    │           │ Deterministic    │             │ 8-Page Multi-Board │
│ Text & Evidence  │           │ Fallback Regex   │             │ Crawl & Markdown   │
│ Extraction Layer │           │ & Vendor Auditor │             │ Deep Extraction    │
└─────────┬────────┘           └────────┬─────────┘             └─────────┬──────────┘
          │                             │                                 │
          └─────────────────────────────┼─────────────────────────────────┘
                                        │
                                        ▼
                        ┌─────────────────────────────────┐
                        │   Human-in-the-Loop Gateway     │
                        │   (Source Approval & Selection) │
                        └───────────────┬─────────────────┘
                                        │
                                        ▼
                        ┌─────────────────────────────────┐
                        │   Evidence-Grounded Generator   │
                        │   • Strict Verbatim Anchors     │
                        │   • Evidence-Grounded Claim Validation │
                        │   • Citation Footnotes [1], [2] │
                        └───────────────┬─────────────────┘
                                        │
                                        ▼
                        ┌─────────────────────────────────┐
                        │   Interview-Defensible Output   │
                        │   (Every claim backed by facts) │
                        └─────────────────────────────────┘
```

---

## ⚡ Core Architectural Pillars

### 1. Multi-Source Real-Time Intelligence & Deep Markdown Crawling
- **Tavily 8-Page Authoritative Crawl:** Queries live enterprise footprints targeting `careers`, `linkedin`, `naukri`, and `ambitionbox`.
- **Jina AI Reader (`r.jina.ai`) Deep Scraping:** Strips HTML clutter, popups, and cookie walls, returning clean, high-fidelity markdown with an exponential timeout fallback.
- **Three-Tier Domain Classifier:** Categorizes incoming intelligence into **Company Official**, **Job Portals & Reviews**, and **External Engineering News**.

### 2. Deterministic Fallback Regex & 4-Tier Company Intelligence
When LLM JSON structures are delayed or partially populated, a deterministic regex pipeline extracts ground truth directly from raw JD tokens:
- **📋 Job Context Sub-Tab (Default):** Extracts Role, Work Model (Remote / Hybrid / On-Site), Experience Band, and Disclosed Salary Status.
- **⚠️ Third-Party / Staffing Detection:** Flags staffing vendors, C2H (Contract-to-Hire), and payroll intermediaries with **verbatim quotes** directly extracted from the JD.
- **🏢 Company Identity Sub-Tab:** Verifies whether the firm is a Direct Employer, Services Vendor, GCC (Global Capability Center), or Product Company. Missing fields strictly report `"Not verified from available sources"`.
- **⚡ Hiring Signals Sub-Tab:** Isolates technology focuses, active initiatives, and recent hiring surges with cited references `[1]`, `[2]`.
- **🔗 Sources Coverage Sub-Tab:** Displays full URL citations and scrape statuses.

### 3. Evidence-Grounded Generation, UX & Claim Validation Policy
- **Evidence-Grounded Synthesizer:** System instructions enforce that **every single achievement claim** in the cover letter must map directly to a verified bullet in the candidate's resume.
- **Interactive In-Line Evidence Markers with Clean Submission Export:** On-screen interactive badges (`[Resume Anchor]` & `[Source Citation]`) allow candidates to hover and verify exact source quotes with a live `[Evidence Markers: ON/OFF]` toggle. When candidates click **Copy to Clipboard** or **Download Markdown/PDF**, internal citation tags are **automatically stripped** to deliver 100% clean, submission-ready letters for recruiters.
- **Adversarial Overclaim Red-Teamer (Veracity Audit Gate):** Scans generated text against candidate resume verbs to catch senior inflation (e.g., resume states "assisted team with Kubernetes rollout" vs draft stating "spearheaded enterprise migration"). The engine automatically softens unverified verbs to authentic baseline evidence and records an audit log.
- **L