@pranavraut033/ats-checker 1.3.2 → 1.4.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { A as ATSProfile, S as SkillAliases, K as KeywordRegistry, L as LLMConfig, J as JSONSchema, a as LLMResult, b as LLMBudget, c as AnalyzeResumeInput, d as ATSAnalysisResult } from './scoring-BCShrnki.mjs';
-export { s as ATSBreakdown, k as ATSConfig, j as ATSRule, e as ATSWeights, w as AnalyzeResumeInputV2, f as KeywordCategory, h as KeywordDensityConfig, g as KeywordEntry, t as KeywordWeight, u as LLMClient, v as LLMFeatures, x as LLMUsageStats, N as NormalizedWeights, o as ParsedAchievement, P as ParsedDateRange, n as ParsedExperienceEntry, r as ParsedJobDescription, p as ParsedLanguage, q as ParsedResume, R as ResolvedATSConfig, m as ResumeSection, l as RuleContext, i as SectionPenaltyConfig } from './scoring-BCShrnki.mjs';
+import { A as ATSProfile, S as SkillAliases, K as KeywordRegistry, L as LLMConfig, J as JSONSchema, a as LLMResult, b as LLMBudget, c as AnalyzeResumeInput, d as ATSAnalysisResult } from './scoring-pZZR3soa.mjs';
+export { t as ATSBreakdown, k as ATSConfig, j as ATSRule, e as ATSWeights, x as AnalyzeResumeInputV2, f as KeywordCategory, h as KeywordDensityConfig, g as KeywordEntry, u as KeywordWeight, v as LLMClient, w as LLMFeatures, y as LLMUsageStats, N as NormalizedWeights, o as ParsedAchievement, P as ParsedDateRange, n as ParsedExperienceEntry, s as ParsedJobDescription, p as ParsedLanguage, q as ParsedResume, R as ResolvedATSConfig, m as ResumeSection, l as RuleContext, i as SectionPenaltyConfig, r as SkillExperienceRequirement } from './scoring-pZZR3soa.mjs';
 
 declare const defaultKeywordRegistry: KeywordRegistry;
 declare const defaultSkillAliases: SkillAliases;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as ATSProfile, S as SkillAliases, K as KeywordRegistry, L as LLMConfig, J as JSONSchema, a as LLMResult, b as LLMBudget, c as AnalyzeResumeInput, d as ATSAnalysisResult } from './scoring-BCShrnki.js';
-export { s as ATSBreakdown, k as ATSConfig, j as ATSRule, e as ATSWeights, w as AnalyzeResumeInputV2, f as KeywordCategory, h as KeywordDensityConfig, g as KeywordEntry, t as KeywordWeight, u as LLMClient, v as LLMFeatures, x as LLMUsageStats, N as NormalizedWeights, o as ParsedAchievement, P as ParsedDateRange, n as ParsedExperienceEntry, r as ParsedJobDescription, p as ParsedLanguage, q as ParsedResume, R as ResolvedATSConfig, m as ResumeSection, l as RuleContext, i as SectionPenaltyConfig } from './scoring-BCShrnki.js';
+import { A as ATSProfile, S as SkillAliases, K as KeywordRegistry, L as LLMConfig, J as JSONSchema, a as LLMResult, b as LLMBudget, c as AnalyzeResumeInput, d as ATSAnalysisResult } from './scoring-pZZR3soa.js';
+export { t as ATSBreakdown, k as ATSConfig, j as ATSRule, e as ATSWeights, x as AnalyzeResumeInputV2, f as KeywordCategory, h as KeywordDensityConfig, g as KeywordEntry, u as KeywordWeight, v as LLMClient, w as LLMFeatures, y as LLMUsageStats, N as NormalizedWeights, o as ParsedAchievement, P as ParsedDateRange, n as ParsedExperienceEntry, s as ParsedJobDescription, p as ParsedLanguage, q as ParsedResume, R as ResolvedATSConfig, m as ResumeSection, l as RuleContext, i as SectionPenaltyConfig, r as SkillExperienceRequirement } from './scoring-pZZR3soa.js';
 
 declare const defaultKeywordRegistry: KeywordRegistry;
 declare const defaultSkillAliases: SkillAliases;

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { clamp, mergeKeywordRegistries, defaultKeywordRegistry, softwareEngineerProfile, buildCategoryIndex, deriveSkillAliases, normalizeWhitespace, splitLines, normalizeSkills, tokenize, unique, containsTableLikeStructure, normalizeForComparison, STOP_WORDS, normalizeSkill, countFrequencies, escapeRegExp } from './chunk-ZJ5E4H7Z.mjs';
-export { defaultKeywordRegistry, defaultProfiles, defaultSkillAliases } from './chunk-ZJ5E4H7Z.mjs';
+import { ROLE_NOUNS, unique, clamp, mergeKeywordRegistries, defaultKeywordRegistry, softwareEngineerProfile, buildCategoryIndex, deriveSkillAliases, normalizeWhitespace, splitLines, normalizeSkills, tokenize, containsTableLikeStructure, normalizeForComparison, STOP_WORDS, normalizeSkill, countFrequencies, escapeRegExp } from './chunk-IY7OVF6Z.mjs';
+export { defaultKeywordRegistry, defaultProfiles, defaultSkillAliases } from './chunk-IY7OVF6Z.mjs';
 
 // src/utils/languages.ts
 var KNOWN_LANGUAGES = [
@@ -159,8 +159,9 @@ function extractPreferredSkills(lines) {
   }
   return preferred;
 }
+var ROLE_NOUN_RE = new RegExp(`(${ROLE_NOUNS.join("|")})`, "gi");
 function extractRoleKeywords(text) {
-  const roleMatches = text.match(/(engineer|developer|manager|scientist|analyst|designer|architect|director|consultant|lead|vp)/gi) ?? [];
+  const roleMatches = text.match(ROLE_NOUN_RE) ?? [];
   const fallback = roleMatches.length === 0 ? [text.split(/\n/)[0] ?? ""] : [];
   return unique(tokenize([...roleMatches, ...fallback].join(" ")));
 }
@@ -191,6 +192,32 @@ function isLanguageRequired(lang, jobDescription) {
     return LANG_SECTION_RE.test(line) || LANG_REQUIREMENT_HINT_RE.test(line);
   });
 }
+var YEARS_BEFORE_SKILL_RE = /(\d{1,2})\+?\s*years?\s*(?:of|in|with)?\s*((?:[a-z0-9][a-z0-9.#+\-/]*\s*){1,4})/gi;
+var SKILL_BEFORE_YEARS_RE = /((?:[a-z0-9][a-z0-9.#+\-/]*[\s,]*){1,4})\(?(\d{1,2})\+?\s*years?\)?/gi;
+function extractSkillExperienceRequirements(lines, skillVocab, aliases) {
+  const requirements = /* @__PURE__ */ new Map();
+  const record = (rawWord, years) => {
+    if (!Number.isFinite(years) || years <= 0 || years > 60) return;
+    const canonical = normalizeSkill(rawWord, aliases);
+    if (!skillVocab.has(rawWord.toLowerCase()) && !skillVocab.has(canonical)) return;
+    const existing = requirements.get(canonical);
+    if (existing === void 0 || years > existing) {
+      requirements.set(canonical, years);
+    }
+  };
+  for (const line of lines) {
+    for (const re of [YEARS_BEFORE_SKILL_RE, SKILL_BEFORE_YEARS_RE]) {
+      re.lastIndex = 0;
+      let match;
+      while (match = re.exec(line)) {
+        const years = Number.parseInt(re === YEARS_BEFORE_SKILL_RE ? match[1] : match[2], 10);
+        const candidateWords = tokenize(re === YEARS_BEFORE_SKILL_RE ? match[2] : match[1]);
+        for (const word of candidateWords) record(word, years);
+      }
+    }
+  }
+  return [...requirements.entries()].map(([skill, years]) => ({ skill, years })).sort((a, b) => a.skill.localeCompare(b.skill));
+}
 function extractDegreeLevels(text) {
   const found = /* @__PURE__ */ new Set();
   for (const [pattern, canonical] of DEGREE_VARIANTS) {
@@ -221,6 +248,11 @@ function parseJobDescription(jobDescription, config) {
   const bodyTokens = tokenize(normalizedText).filter(isSkillLike);
   const roleKeywords = extractRoleKeywords(jobDescription);
   const keywords = unique([...requiredSkills, ...preferredSkills, ...roleKeywords, ...bodyTokens]);
+  const skillExperienceRequirements = extractSkillExperienceRequirements(
+    lines,
+    skillVocab,
+    config.skillAliases
+  );
   return {
     raw: jobDescription,
     normalizedText,
@@ -229,6 +261,7 @@ function parseJobDescription(jobDescription, config) {
     roleKeywords,
     keywords,
     minExperienceYears: extractMinExperience(jobDescription),
+    skillExperienceRequirements,
     educationRequirements: extractDegreeLevels(jobDescription),
     keywordSurfaceForms: collectKeywordSurfaceForms(jobDescription, config.skillAliases),
     // A language only counts as required if its mention carries a requirement/level cue
@@ -425,6 +458,10 @@ var STRONG_VERBS = [
   "increased"
 ];
 var WEAK_VERBS = ["worked", "helped", "performed", "responsible", "assisted", "participated", "involved"];
+var TITLE_SENIORITY_PREFIXES = ["senior", "lead", "principal", "staff", "vp", "director"];
+var TITLE_MODIFIER_WORDS = ["software", "full\\s*stack", "frontend", "backend"];
+var TITLE_PREFIX_WORDS = unique([...TITLE_SENIORITY_PREFIXES, ...TITLE_MODIFIER_WORDS, ...ROLE_NOUNS]);
+var TITLE_RE = new RegExp(`^(${TITLE_PREFIX_WORDS.join("|")})[^,(-]*`, "i");
 var METRIC_RE = /\d|%|\$|\bk\+|\bm\+/i;
 function classifyAchievement(line) {
   const lower = line.toLowerCase();
@@ -502,21 +539,26 @@ function parseExperience(sectionContent, referenceDate) {
   const achievements = [];
   for (const line of lines) {
     const range = parseDateRange(line, referenceDate);
+    const titleMatch = line.match(TITLE_RE);
+    const title = titleMatch ? titleMatch[0].trim() : void 0;
     if (range) {
-      const previous = entries[entries.length - 1];
-      if (previous && !previous.dates) {
-        previous.dates = range;
+      if (title) {
+        jobTitles.push(title.toLowerCase());
+        entries.push({ title, dates: range, description: line });
       } else {
-        entries.push({ dates: range });
+        const previous = entries[entries.length - 1];
+        if (previous && !previous.dates) {
+          previous.dates = range;
+        } else {
+          entries.push({ dates: range });
+        }
       }
       if (range.durationInMonths) {
         rangesInMonths.push(range.durationInMonths);
       }
       continue;
     }
-    const titleMatch = line.match(/^(Senior|Lead|Principal|Staff|VP|Director|Consultant|Architect|Software|Full\s*Stack|Frontend|Backend|Engineer|Developer|Manager|Analyst)[^,-]*/i);
-    if (titleMatch) {
-      const title = titleMatch[0].trim();
+    if (title) {
       jobTitles.push(title.toLowerCase());
       const entry = { title, description: line };
       entries.push(entry);
@@ -538,6 +580,14 @@ function parseEducation(sectionContent) {
 function collectKeywords(text) {
   return unique(tokenize(text));
 }
+var EMAIL_RE = /[a-z0-9._%+-]+@[a-z0-9.-]+\.[a-z]{2,}/i;
+var PHONE_RE = /\+?\(?\d{1,4}\)?(?:[\s.-]?\d{2,4}){2,4}/;
+function extractContact(text) {
+  const email = text.match(EMAIL_RE)?.[0];
+  const phone = text.match(PHONE_RE)?.[0]?.trim();
+  if (!email && !phone) return void 0;
+  return { email, phone };
+}
 function parseResume(resumeText, config) {
   const normalizedText = normalizeWhitespace(resumeText);
   const { sections, detected } = extractSections(resumeText);
@@ -573,6 +623,12 @@ function parseResume(resumeText, config) {
       warnings.push(`${section} section not detected`);
     }
   }
+  const contact = extractContact(resumeText);
+  if (!contact?.email) {
+    warnings.push(
+      "No email address detected \u2014 most ATS require a parseable contact email"
+    );
+  }
   return {
     raw: resumeText,
     normalizedText,
@@ -588,6 +644,7 @@ function parseResume(resumeText, config) {
     totalExperienceYears,
     keywords: collectKeywords(normalizedText),
     languages: parseLanguageMentions(resumeText),
+    contact,
     warnings
   };
 }
@@ -637,6 +694,11 @@ var RuleEngine = class {
       totalPenalty += 5;
       warnings.push("Few recognizable sections found (penalty 5)");
     }
+    if (!input.resume.contact?.email) {
+      const penalty = this.config.sectionPenalties.missingContact;
+      totalPenalty += penalty;
+      warnings.push(`Missing contact email (penalty ${penalty})`);
+    }
     return { totalPenalty, warnings };
   }
   evaluate(input) {
@@ -708,8 +770,9 @@ function scoreExperience(resume, job, config) {
   const yearCoverage = clamp(resume.totalExperienceYears / requiredYears, 0, 2);
   const yearsComponent = clamp(yearCoverage, 0, 1) * EXPERIENCE_YEARS_WEIGHT;
   const jobRoleSet = new Set(job.roleKeywords.map((value) => value.toLowerCase()));
-  const titleMatches = resume.jobTitles.filter((title) => jobRoleSet.has(title.toLowerCase()));
-  const titleCoverage = jobRoleSet.size === 0 ? 1 : titleMatches.length / jobRoleSet.size;
+  const resumeTitleTokens = new Set(resume.jobTitles.flatMap((t) => tokenize(t)));
+  const matchedRoles = job.roleKeywords.filter((rk) => resumeTitleTokens.has(rk.toLowerCase()));
+  const titleCoverage = jobRoleSet.size === 0 ? 1 : matchedRoles.length / jobRoleSet.size;
   const roleComponent = clamp(titleCoverage, 0, 1) * EXPERIENCE_ROLE_WEIGHT;
   const score = clamp((yearsComponent + roleComponent) * 100, 0, 100);
   const missingYears = Math.max(requiredYears - resume.totalExperienceYears, 0);
@@ -785,6 +848,17 @@ function scoreKeywords(resume, job, config) {
     keywordWeights
   };
 }
+function computeSkillExperienceGaps(resume, job, config) {
+  if (job.skillExperienceRequirements.length === 0) return [];
+  const resumeSkills = new Set(normalizeSkills(resume.skills, config.skillAliases));
+  const gaps = [];
+  for (const { skill, years } of job.skillExperienceRequirements) {
+    if (resumeSkills.has(skill) && resume.totalExperienceYears < years) {
+      gaps.push({ skill, requiredYears: years, resumeYears: resume.totalExperienceYears });
+    }
+  }
+  return gaps.sort((a, b) => a.skill.localeCompare(b.skill));
+}
 function scoreEducation(resume, job) {
   if (job.educationRequirements.length === 0) {
     return 100;
@@ -818,6 +892,7 @@ function calculateScore(resume, job, config) {
     resume.languages,
     job.requiredLanguages
   );
+  const skillExperienceGaps = computeSkillExperienceGaps(resume, job, config);
   return {
     score: clamp(Number(weightedScore.toFixed(2)), 0, 100),
     breakdown,
@@ -831,6 +906,7 @@ function calculateScore(resume, job, config) {
     achievementStrength,
     matchedLanguages,
     missingLanguages,
+    skillExperienceGaps,
     suggestions: [],
     warnings: [],
     // detectedSections / parsedExperienceYears / experienceGap / experienceEntries: filled by index.ts
@@ -859,7 +935,10 @@ var DEFAULT_SECTION_PENALTIES = {
   missingSummary: 4,
   missingExperience: 10,
   missingSkills: 8,
-  missingEducation: 6
+  missingEducation: 6,
+  // Warning-only by default — see determinism note in the contact/parseability plan step;
+  // callers who want it to actually move the score can override via config.sectionPenalties.
+  missingContact: 0
 };
 function normalizeWeights(weights) {
   const total = weights.skills + weights.experience + weights.keywords + weights.education;
@@ -980,6 +1059,16 @@ var SuggestionEngine = class {
         "Your resume may use a multi-column layout. Export as a single-column PDF or paste plain text \u2014 most ATS systems and this parser work best with a linear layout."
       );
     }
+    if (!input.resume.contact?.email) {
+      suggestions.push(
+        "Add a clearly formatted email address near the top of your resume so ATS and recruiters can contact you."
+      );
+    }
+    for (const gap of input.score.skillExperienceGaps) {
+      suggestions.push(
+        `The role asks for ${gap.requiredYears}+ years of ${gap.skill}; make that duration explicit in your experience section.`
+      );
+    }
     return { suggestions, warnings };
   }
 };
@@ -1145,7 +1234,8 @@ No explanations. No markdown. No additional text.`;
       });
       const timeoutPromise = new Promise((_, reject) => {
         const id = globalThis.setTimeout(() => reject(new Error(`LLM call timeout after ${this.timeoutMs}ms`)), this.timeoutMs);
-        void clientPromise.finally(() => globalThis.clearTimeout(id));
+        void clientPromise.finally(() => globalThis.clearTimeout(id)).catch(() => {
+        });
       });
       void timeoutPromise.catch(() => {
       });
@@ -1643,6 +1733,7 @@ function analyzeResume(input) {
     achievementStrength: scoring.achievementStrength,
     matchedLanguages: scoring.matchedLanguages,
     missingLanguages: scoring.missingLanguages,
+    skillExperienceGaps: scoring.skillExperienceGaps,
     experienceGap: scoring.experienceGap,
     detectedSections: parsedResume.detectedSections,
     parsedExperienceYears: parsedResume.totalExperienceYears,
@@ -1714,6 +1805,7 @@ async function analyzeResumeAsync(input) {
     achievementStrength: scoring.achievementStrength,
     matchedLanguages: scoring.matchedLanguages,
     missingLanguages: scoring.missingLanguages,
+    skillExperienceGaps: scoring.skillExperienceGaps,
     experienceGap: scoring.experienceGap,
     detectedSections: parsedResume.detectedSections,
     parsedExperienceYears: parsedResume.totalExperienceYears,