docs/product-audit.md

Pulse CV Product Audit

What existed before the pivot

• A working public web app with resume + JD intake.
• Server-side LinkedIn scraping and JD cleanup.
• Provider support for Hugging Face, Gemini, and LM Studio.
• Deterministic scoring had already replaced pure LLM scoring.
• A public UI already existed and was deployable to Hugging Face Space and GitHub Pages.

What was conceptually broken

• The product still behaved like an ATS score checker.
• Flat keyword matching remained too visible in the UX and API.
• Output mixed extracted facts, inferred facts, and AI wording.
• Critical Gaps still surfaced noisy tokens rather than typed requirements.
• server.ts concentrated scraping, normalization, matching, scoring, and provider work in one file.

What was worth preserving

• LinkedIn extraction improvements.
• Public deployment stack.
• File upload and pasted-text intake.
• Server-side provider abstraction.
• Existing multilingual baseline.

What needed replacement

• Flat keyword-first result model.
• Primary score-led UX.
• Missing recruiter-grade explainability.
• Missing evidence map.
• Missing JD quality review.
• Missing typed requirement schema and domain pack.