JobMate — Evidence-Grounded AI Career Intelligence Engine

---

🌟 Executive Overview

JobMate is an evidence-grounded AI career intelligence engine built to solve the core defect of modern AI resume generators: unsubstantiated claims and hallucinated metrics.

Rather than using generic LLM prompt wrappers that invent fake companies, metrics, or technologies, JobMate enforces 100% Evidence Grounding through:

1. pgvector PostgreSQL Vector Store & Hybrid Retrieval: Combines dense embeddings (text-embedding-3-small), BM25 lexical search, and skill taxonomy boosting with live Supabase RLS isolation.
2. Multi-Agent StateGraph Pipeline: 6-node state graph orchestrating JD analysis, semantic retrieval, strategic planning, Google XYZ synthesis, adversarial guardrail verification, and heuristic ATS auditing with active reflection loops.
3. Deterministic Claim Provenance: Every generated accomplishment bullet links back to verified evidence IDs with exact repository, line number, or candidate record attribution.
4. Real Multi-Language AST Code Intelligence: Official TypeScript Compiler API and structural syntax-tree parsers for 6 core languages (TypeScript, JavaScript, Python, Java, Go, Rust) extracting functions, classes, React components, hooks, HTTP route handlers (Next.js, Express, FastAPI, Flask, Spring, Gin, Actix), database/ORM calls (Supabase, Postgres, Prisma, Drizzle, SQLAlchemy, SpringData, GORM, SQLx), and test suites (Vitest, Jest, Pytest, JUnit, GoTest, RustTest) with exact line/column ranges.
5. Deterministic Single-Column LaTeX Compiler: Emits compilable .tex source compliant with glyphtounicode, titlesec, and enterprise ATS parsers (Overleaf & pdflatex compatible).

---

🧠 System Architecture

                         JOBMATE

                           USER
                            │
                            ▼
                    JOB DESCRIPTION
                            │
                            ▼
                     JD ANALYZER
                            │
                            ▼
                    REQUIREMENT GRAPH
                            │
                            ▼
              ┌─────────────────────────┐
              │   CANDIDATE EVIDENCE    │
              │                         │
              │ Multi-Language AST (L4) │
              │ GitHub Commits & PR(L5) │
              │ CI/CD & Tests (L6)      │
              │ Manifest Dependencies(L3│
              │ Verified Experience (L1)│
              └────────────┬────────────┘
                           │
                           ▼
                  EMBEDDING GENERATION
              (openai/text-embedding-3-small)
                           │
                           ▼
                    SUPABASE PGVECTOR
                 (candidate_evidence HNSW)
                           │
                    ┌──────┴──────┐
                    ▼             ▼
                 VECTOR          BM25
                 SEARCH          SEARCH
                    │             │
                    └──────┬──────┘
                           ▼
                     HYBRID RANKING
                 (Dense + Sparse + Skill)
                           │
                           ▼
                  STRUCTURED RERANKER
             (LLM-Based Evidence Reranker)
                           │
                           ▼
                   RESUME PLANNER
                           │
                           ▼
                GROUNDED GENERATOR
              (Google XYZ Bullet Synthesizer)
                           │
                           ▼
                  CLAIM PROVENANCE
             (Per-bullet Evidence Attribution)
                           │
                           ▼
                    CRITIC / VERIFY
                           │
                     ┌─────┴─────┐
                     │           │
                   FAIL         PASS
                     │           │
                     ▼           ▼
                 REFLECTION    ATS AUDIT
                     │           │
                     └─────┐ ┌───┘
                           ▼ ▼
                     FINAL RESUME
                           │
                           ▼
                    LATEX COMPILER

---

💻 Real AST Code Intelligence (6 Languages)

JobMate performs structural syntax-tree code intelligence across 6 core enterprise languages:

Language	AST Engine	Structural Symbols	Frameworks & APIs	Database / ORM	Test Frameworks
TypeScript	TypeScript Compiler API (ts.createSourceFile)	Functions, Classes, Interfaces, Types, React Components, Custom Hooks	Next.js, TanStack Start, Express, Hono, React	Supabase, Prisma, Drizzle, Postgres	Vitest, Jest
JavaScript	TypeScript JS Parser (ts.ScriptKind.JS)	Functions, Classes, Express Route Handlers, Arrow Functions	Express, Fastify, Hono	Supabase, Postgres, MongoDB	Vitest, Jest
Python	Structural Syntax Tokenizer & AST Walker	def, async def, class, Decorators	FastAPI, Flask, Django	SQLAlchemy, Postgres, Tortoise	Pytest, Unittest
Java	Structural Syntax Tree & Annotation Parser	Classes, Interfaces, Methods, Spring Annotations (@RestController, @GetMapping)	Spring Boot, Spring MVC	Spring Data JPA, Hibernate, JDBC	JUnit 5, Mockito
Go	Structural Syntax Tree & Receiver Parser	Structs, Interfaces, Receiver Methods, Capitalized Exports	Gin, net/http, Echo	GORM, database/sql, pgx	Go testing (Test*)
Rust	Structural Syntax Tree & Macro Parser	Structs, Enums, Traits, impl blocks, Async fn	Actix Web, Axum, Tokio	SQLx, Diesel

---

This is the beginning of the README. Read the rest at the original. Read the full README ↗