@juicedresume/mcp 0.3.1 → 0.4.0

package/dist/index.js

@@ -974,8 +974,67 @@ var SKILLS = [
 ];
 var SKILL_INDEX = /* @__PURE__ */ new Map();
 for (const s of SKILLS) SKILL_INDEX.set(s.name.toLowerCase(), s);
+var SKILL_ALIASES = {
+  js: "JavaScript",
+  ecmascript: "JavaScript",
+  ts: "TypeScript",
+  "react.js": "React",
+  reactjs: "React",
+  "vue.js": "Vue",
+  vuejs: "Vue",
+  "next.js": "Next.js",
+  next: "Next.js",
+  nextjs: "Next.js",
+  "node.js": "Node.js",
+  node: "Node.js",
+  nodejs: "Node.js",
+  k8s: "Kubernetes",
+  postgres: "PostgreSQL",
+  psql: "PostgreSQL",
+  golang: "Go",
+  py: "Python",
+  "c sharp": "C#",
+  csharp: "C#",
+  "c plus plus": "C++",
+  cpp: "C++",
+  tf: "Terraform",
+  gha: "GitHub Actions",
+  "rest api": "REST APIs",
+  rest: "REST APIs",
+  restful: "REST APIs",
+  "objective c": "Objective-C",
+  "spring-boot": "Spring Boot",
+  "tailwind": "Tailwind CSS",
+  tailwindcss: "Tailwind CSS",
+  gcp: "GCP",
+  "google cloud": "GCP",
+  "google cloud platform": "GCP",
+  aws: "AWS",
+  "amazon web services": "AWS",
+  sklearn: "scikit-learn",
+  "scikit learn": "scikit-learn",
+  hf: "Hugging Face",
+  huggingface: "Hugging Face",
+  pytorch: "PyTorch",
+  tensorflow: "TensorFlow",
+  "power-bi": "Power BI",
+  powerbi: "Power BI"
+};
+function normalizeSkill(s) {
+  const key = s.toLowerCase().trim();
+  if (SKILL_INDEX.has(key)) return SKILL_INDEX.get(key).name;
+  const stripped = key.replace(/\.js$/, "");
+  if (SKILL_ALIASES[key]) return SKILL_ALIASES[key];
+  if (SKILL_ALIASES[stripped]) return SKILL_ALIASES[stripped];
+  if (SKILL_INDEX.has(stripped)) return SKILL_INDEX.get(stripped).name;
+  return s.trim();
+}
 function lookupSkill(s) {
-  return SKILL_INDEX.get(s.toLowerCase().trim());
+  const key = s.toLowerCase().trim();
+  const direct = SKILL_INDEX.get(key);
+  if (direct) return direct;
+  const canonical = normalizeSkill(s).toLowerCase();
+  return SKILL_INDEX.get(canonical);
 }
 function searchSkills(query, limit = 12) {
   const q = query.toLowerCase().trim();
@@ -1344,6 +1403,9 @@ var STOPWORDS = /* @__PURE__ */ new Set([
   "day",
   "days"
 ]);
+function escapeRe(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function tokens(s) {
   return s.toLowerCase().replace(/[^a-z0-9+./# -]/g, " ").split(/\s+/).filter((w) => w && w.length > 1 && !STOPWORDS.has(w));
 }
@@ -1353,22 +1415,49 @@ function bigrams(toks) {
   return out;
 }
 function resumeText(resume) {
-  const parts = [];
-  parts.push(resume.personal.title);
+  const parts = [resume.personal.title];
   for (const sec of resume.sections) {
+    if (sec.visible === false) continue;
     for (const it of sec.items) {
-      parts.push(it.body || "");
-      parts.push(it.description || "");
-      parts.push(it.skills || "");
-      parts.push(it.jobTitle || it.degree || it.name || it.title || "");
-      parts.push(it.employer || it.school || it.publisher || it.institution || "");
+      if (it.visible === false) continue;
+      parts.push(
+        it.body || "",
+        it.description || "",
+        it.skills || "",
+        it.category || "",
+        it.jobTitle || "",
+        it.degree || "",
+        it.field || "",
+        it.name || "",
+        it.title || "",
+        it.role || "",
+        it.employer || "",
+        it.school || "",
+        it.publisher || "",
+        it.institution || "",
+        it.issuer || "",
+        it.location || ""
+      );
     }
   }
   return parts.join(" ").replace(/<[^>]+>/g, " ");
 }
 function tailorToJob(resume, jdText) {
   const jdToks = tokens(jdText);
-  const resumeToks = new Set(tokens(resumeText(resume)));
+  const resumeFullText = resumeText(resume).toLowerCase();
+  const resumeToks = new Set(tokens(resumeFullText));
+  const resumeNorm = new Set([...resumeToks].map((t) => normalizeSkill(t).toLowerCase()));
+  function matchKind(keyword) {
+    const k = keyword.toLowerCase();
+    if (k.includes(" ")) {
+      return new RegExp(`\\b${escapeRe(k)}\\b`).test(resumeFullText) ? "exact" : "none";
+    }
+    if (resumeToks.has(k)) return "exact";
+    const canon = normalizeSkill(keyword).toLowerCase();
+    if (resumeNorm.has(canon)) return "variant";
+    if (canon.includes(" ") && new RegExp(`\\b${escapeRe(canon)}\\b`).test(resumeFullText)) return "variant";
+    return "none";
+  }
   const jdGrams = /* @__PURE__ */ new Set([...jdToks, ...bigrams(jdToks)]);
   const skillNames = new Map(SKILLS.map((s) => [s.name.toLowerCase(), s]));
   const freq = /* @__PURE__ */ new Map();
@@ -1384,17 +1473,32 @@ function tailorToJob(resume, jdText) {
   for (const [k, c] of sortedNonSkill) jdSkills.set(k, { importance: c });
   const matched = [];
   const missing = [];
+  const kindMult = (kind) => kind === "hard" ? 2 : kind === "soft" ? 1.3 : 1;
+  const VARIANT_CREDIT = 0.6;
   for (const [k, meta] of jdSkills) {
-    const lower = k.toLowerCase();
-    if (resumeToks.has(lower) || [...resumeToks].some((t) => t.includes(lower))) {
-      matched.push({ keyword: k, kind: meta.kind, count: meta.importance });
+    const w = meta.importance * kindMult(meta.kind);
+    const kind = matchKind(k);
+    if (kind === "exact") {
+      matched.push({ keyword: k, kind: meta.kind, count: w });
+    } else if (kind === "variant") {
+      matched.push({
+        keyword: k,
+        kind: meta.kind,
+        count: w * VARIANT_CREDIT,
+        partial: true,
+        note: `You use a variant of "${k}". ATS keyword search is usually exact-match, so add the exact term "${k}" too.`
+      });
     } else {
-      missing.push({ keyword: k, kind: meta.kind, importance: meta.importance });
+      missing.push({ keyword: k, kind: meta.kind, importance: w });
     }
   }
   const matchedWeight = matched.reduce((a, m) => a + m.count, 0);
   const totalWeight = matchedWeight + missing.reduce((a, m) => a + m.importance, 0);
-  const score = totalWeight === 0 ? 0 : Math.round(matchedWeight / totalWeight * 100);
+  const score = totalWeight === 0 ? 0 : Math.min(95, Math.round(matchedWeight / totalWeight * 100));
+  const titleToks = tokens(resume.personal.title || "");
+  const jdTokSet = new Set(jdToks);
+  const titleHits = titleToks.filter((t) => jdTokSet.has(t)).length;
+  const titleMatch = titleToks.length === 0 ? 0 : Math.round(titleHits / titleToks.length * 100);
   missing.sort((a, b) => b.importance - a.importance);
   matched.sort((a, b) => b.count - a.count);
   return {
@@ -1402,15 +1506,78 @@ function tailorToJob(resume, jdText) {
     matched,
     missing,
     jdSkills: jdSkills.size,
-    resumeSkills: resumeToks.size
+    resumeSkills: resumeToks.size,
+    titleMatch,
+    flags: jdKnockoutFlags(resume, jdText)
   };
 }
+function tailorMMYYYY(d) {
+  if (!d) return null;
+  const m = d.match(/^(\d{1,2})\/(\d{4})$/);
+  if (m) return parseInt(m[2], 10) * 12 + parseInt(m[1], 10);
+  const mn = d.match(/^([A-Za-z]+)\s+(\d{4})$/);
+  if (mn) {
+    const months = ["jan", "feb", "mar", "apr", "may", "jun", "jul", "aug", "sep", "oct", "nov", "dec"];
+    const i = months.findIndex((x) => mn[1].toLowerCase().startsWith(x));
+    if (i >= 0) return parseInt(mn[2], 10) * 12 + (i + 1);
+  }
+  const y = d.match(/^(\d{4})$/);
+  if (y) return parseInt(y[1], 10) * 12;
+  return null;
+}
+function resumeYears(resume) {
+  const exp = resume.sections.find((s) => s.type === "experience");
+  if (!exp) return 0;
+  const now = (/* @__PURE__ */ new Date()).getFullYear() * 12 + ((/* @__PURE__ */ new Date()).getMonth() + 1);
+  let months = 0;
+  for (const it of exp.items || []) {
+    if (it.visible === false) continue;
+    const s = tailorMMYYYY(it.startDate || "");
+    const e = it.current ? now : tailorMMYYYY(it.endDate || "");
+    if (s && e && e >= s) months += e - s;
+  }
+  return Math.round(months / 12 * 10) / 10;
+}
+function jdKnockoutFlags(resume, jdText) {
+  const flags = [];
+  const degreeRequired = /\b(bachelor|master|b\.?s\.?|m\.?s\.?|b\.?a\.?|ph\.?d|mba|degree)\b[^.\n]{0,40}\b(required|require|must|minimum|mandatory)\b/i.test(jdText) || /\b(required|must have|minimum|mandatory)\b[^.\n]{0,40}\b(bachelor|master|degree|b\.?s\.?|m\.?s\.?|ph\.?d|diploma)\b/i.test(jdText);
+  if (degreeRequired) {
+    const eduSec = resume.sections.find((s) => s.type === "education");
+    const hasDegree = (eduSec?.items || []).some((it) => it.visible !== false && String(it.degree || "").trim());
+    if (!hasDegree) {
+      flags.push({
+        id: "K4.missing-required-degree",
+        severity: "risk",
+        title: "This job states a degree requirement",
+        detail: "The description asks for a specific degree, and no completed degree is listed on your resume. A stated degree requirement is often a hard knockout filter.",
+        suggestion: "Add your degree in the Education section, or if you have equivalent experience, be ready to address the gap in a cover note.",
+        requirement: "degree"
+      });
+    }
+  }
+  const yoe = [...jdText.matchAll(/(\d{1,2})\s*\+?\s*(?:to|-|–|—)?\s*\d{0,2}\s*years?(?:['’]?s?)?\s*(?:of\s+)?(?:experience|exp\b)/gi)].map((m) => parseInt(m[1], 10)).filter((n) => n >= 1 && n <= 20);
+  if (yoe.length) {
+    const required = Math.min(...yoe);
+    const have = resumeYears(resume);
+    if (have + 0.5 < required) {
+      flags.push({
+        id: "K5.yoe-below-requirement",
+        severity: "risk",
+        title: `Asks for ${required}+ years; your resume shows about ${have}`,
+        detail: "Years of experience is one of the most common automated and recruiter filters. A year or more below the stated minimum is a frequent screen-out.",
+        suggestion: "Make sure every relevant role has dates so your full tenure is counted, and include earlier or concurrent experience if it applies.",
+        requirement: `${required}+ years`
+      });
+    }
+  }
+  return flags;
+}
 
 // ../../packages/scoring/src/v2-additions.ts
 function stripHtml(s) {
   return (s || "").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
 }
-function passSoft(id, label, score, message, suggestion) {
+function passSoft(id, label, score, message, suggestion, weight) {
   const s = Math.max(0, Math.min(1, score));
   return {
     id,
@@ -1419,12 +1586,10 @@ function passSoft(id, label, score, message, suggestion) {
     status: s >= 0.85 ? "pass" : s >= 0.55 ? "warn" : "fail",
     message,
     suggestion: suggestion ?? null,
-    severity: "soft"
+    severity: "soft",
+    weight: weight ?? 1
   };
 }
-function hardCheck(id, label, score, message, suggestion) {
-  return { ...passSoft(id, label, score, message, suggestion), severity: "hard" };
-}
 function firstBulletStrongest(resume) {
   const exp = resume.sections.find((s) => s.type === "experience");
   if (!exp?.items?.length) return null;
@@ -1447,42 +1612,8 @@ function firstBulletStrongest(resume) {
       "Lead bullet of recent role is strongest",
       score,
       topQuantified && topLength >= avgOtherLength ? "Top bullet of your most-recent role is quantified and substantive \u2014 recruiter eye lands here first." : "Your strongest bullet should be FIRST in your most-recent role (recruiters skim top-down).",
-      "Reorder bullets in your most-recent experience so the most quantified / highest-impact bullet is first."
-    )
-  };
-}
-function dateFormatConsistency(resume) {
-  const exp = resume.sections.find((s) => s.type === "experience");
-  const edu = resume.sections.find((s) => s.type === "education");
-  const dates = [];
-  [...exp?.items || [], ...edu?.items || []].forEach((it) => {
-    if (it.startDate) dates.push(it.startDate);
-    if (it.endDate && !it.current) dates.push(it.endDate);
-  });
-  if (dates.length < 2) return null;
-  const MM_YYYY = /^\d{1,2}\/\d{4}$/;
-  const MMM_YYYY = /^[A-Za-z]+\s+\d{4}$/;
-  const YYYY = /^\d{4}$/;
-  const ABBREV = /['']\d{2}|\d{1,2}\/\d{2}|\b[A-Z][a-z]{2}'\d{2}\b/;
-  const formats = /* @__PURE__ */ new Set();
-  for (const d of dates) {
-    if (ABBREV.test(d)) formats.add("abbrev");
-    else if (MM_YYYY.test(d)) formats.add("mm/yyyy");
-    else if (MMM_YYYY.test(d)) formats.add("month-yyyy");
-    else if (YYYY.test(d)) formats.add("yyyy");
-    else formats.add("other");
-  }
-  const hasAbbrev = formats.has("abbrev");
-  const inconsistent = formats.size > 1;
-  const score = hasAbbrev ? 0.2 : inconsistent ? 0.55 : 1;
-  return {
-    dim: "style",
-    check: passSoft(
-      "C9.date-format",
-      "Date format is consistent",
-      score,
-      hasAbbrev ? "Date abbreviations like '21 or Jan'24 break ATS years-of-experience calculation." : inconsistent ? `You're mixing date formats (${[...formats].join(", ")}). Pick one and apply consistently.` : "Dates are formatted consistently \u2014 ATS parses them cleanly.",
-      "Use MM/YYYY (06/2024) or Month YYYY (June 2024) \u2014 consistently across every entry."
+      "Reorder bullets in your most-recent experience so the most quantified / highest-impact bullet is first.",
+      0.5
     )
   };
 }
@@ -1515,19 +1646,6 @@ function dobAgePenalty(resume) {
     )
   };
 }
-function singleColumnHard(resume) {
-  const twoCol = isMultiColumnTemplate(resume.styling?.template);
-  return {
-    dim: "ats",
-    check: hardCheck(
-      "AT12.single-column-hard",
-      "Single-column layout (ATS-critical)",
-      twoCol ? 0 : 1,
-      twoCol ? "Two-column / sidebar template \u2014 a top cause of ATS parse failure. Workday can concatenate columns into gibberish. (The ATS-PDF export is always single-column, but the visual PDF is not.)" : "Single-column layout \u2014 every ATS parses this cleanly.",
-      "Switch to a single-column template (Jake, Harvard, Classic) in the Templates tab. Multi-column is a top score-destroyer in ATS systems."
-    )
-  };
-}
 function threeLocationsRule(resume) {
   const summary = resume.sections.find((s) => s.type === "summary");
   const skills = resume.sections.find((s) => s.type === "skills");
@@ -1556,42 +1674,12 @@ function threeLocationsRule(resume) {
     )
   };
 }
-function bulletLengthSweetSpot(resume) {
-  const exp = resume.sections.find((s) => s.type === "experience");
-  if (!exp?.items?.length) return null;
-  const bullets = [];
-  for (const it of exp.items) {
-    const html = it.description || "";
-    const lis = html.match(/<li[^>]*>([\s\S]*?)<\/li>/gi) || [];
-    for (const li of lis) bullets.push(stripHtml(li));
-  }
-  if (bullets.length === 0) return null;
-  let inRange = 0;
-  for (const b of bullets) {
-    const w = b.split(/\s+/).filter(Boolean).length;
-    if (w >= 12 && w <= 25) inRange++;
-  }
-  const ratio = inRange / bullets.length;
-  return {
-    dim: "brevity",
-    check: passSoft(
-      "B5.sweet-spot",
-      "Bullets in 12\u201325 word range",
-      ratio,
-      `${Math.round(ratio * 100)}% of your bullets fall in the 12\u201325 word sweet spot.`,
-      "Aim for bullets between 12 and 25 words \u2014 short enough for the 6-second recruiter scan, long enough to convey impact + metric."
-    )
-  };
-}
 function additionalChecks(resume) {
   return [
     firstBulletStrongest(resume),
-    dateFormatConsistency(resume),
     targetTitle(resume),
     dobAgePenalty(resume),
-    singleColumnHard(resume),
-    threeLocationsRule(resume),
-    bulletLengthSweetSpot(resume)
+    threeLocationsRule(resume)
   ].filter((x) => x !== null);
 }
 
@@ -2119,6 +2207,11 @@ function impactChecks(resume, b) {
   const scaleSignals = E.filter((x) => SCALE_RE.test(x.text));
   const timeBoundRe = /\b(within|in|over)\s+\d+\s*(weeks?|months?|quarters?|years?|days?)\b|\bq[1-4]\s?'?\d{2,4}\b/i;
   const timeBound = E.filter((x) => timeBoundRe.test(x.text));
+  const quantifiedEarly = quantified.filter((x) => {
+    const head = x.text.split(/\s+/).slice(0, 8).join(" ");
+    return QUANT_RE.test(head);
+  });
+  const earlyRatio = quantified.length ? quantifiedEarly.length / quantified.length : 0;
   return [
     mk(
       "A1.quantification",
@@ -2126,15 +2219,20 @@ function impactChecks(resume, b) {
       qRatio >= 0.6 ? 1 : qRatio >= 0.4 ? 0.7 : qRatio / 0.4,
       `${quantified.length} of ${total} experience bullets include numbers, %, $, or counts (${Math.round(qRatio * 100)}%).`,
       nonQ.slice(0, 6).map((x) => x.id),
-      qRatio < 0.6 ? "Add concrete metrics: % change, $ amount, users, time saved." : void 0
+      qRatio < 0.6 ? "Add concrete metrics: % change, $ amount, users, time saved." : void 0,
+      void 0,
+      3
     ),
     mk(
       "A2.metric-diversity",
       "Variety of metric types",
-      Math.min(1, metricTypes.size / 3),
+      // Bonus signal: absence is neutral (0.8), presence lifts toward 1.
+      metricTypes.size === 0 ? 0.8 : Math.min(1, 0.8 + metricTypes.size * 0.1),
       metricTypes.size === 0 ? "No metric types detected (%, $, time, counts, ratios)." : `Uses ${metricTypes.size} metric type(s): ${[...metricTypes].join(", ")}.`,
       [],
-      metricTypes.size < 3 ? "Mix metric flavors: a % gain, a $ saving, and a scale number tells a richer story than three %s." : void 0
+      metricTypes.size < 3 ? "Mix metric flavors: a % gain, a $ saving, and a scale number tells a richer story than three %s." : void 0,
+      void 0,
+      0.5
     ),
     mk(
       "A3.xyz-bullets",
@@ -2142,7 +2240,9 @@ function impactChecks(resume, b) {
       Math.min(1, xyz.length / Math.max(1, total * 0.4)),
       `${xyz.length} of ${total} bullets read as "Accomplished X (measured by Y) by doing Z."`,
       [],
-      xyz.length / total < 0.4 ? "Reframe bullets as Action + Measurable Outcome + Method ('Cut LLM cost 35% by redesigning the prompt+cache layer')." : void 0
+      xyz.length / total < 0.4 ? "Reframe bullets as Action + Measurable Outcome + Method ('Cut LLM cost 35% by redesigning the prompt+cache layer')." : void 0,
+      void 0,
+      2
     ),
     mk(
       "A4.responsibility",
@@ -2158,7 +2258,9 @@ function impactChecks(resume, b) {
       strongStart.length / total,
       `${strongStart.length} of ${total} bullets open with a strong verb (Led, Built, Drove, \u2026).`,
       E.filter((x) => !STRONG_VERBS.has(norm(firstWord(x.text)))).slice(0, 5).map((x) => x.id),
-      strongStart.length / total < 0.85 ? "Replace soft openers with strong past-tense verbs." : void 0
+      strongStart.length / total < 0.85 ? "Replace soft openers with strong past-tense verbs." : void 0,
+      void 0,
+      2
     ),
     mk(
       "A6.weak-verbs",
@@ -2179,18 +2281,34 @@ function impactChecks(resume, b) {
     mk(
       "A8.scale-signals",
       "Mentions team size, budget, or org scale",
-      scaleSignals.length === 0 ? 0 : Math.min(1, scaleSignals.length / 2),
-      scaleSignals.length === 0 ? "No team/budget/scale signals detected." : `${scaleSignals.length} bullet(s) reference team size, budget, or organisation scale.`,
+      // Bonus signal: absence is neutral, presence lifts the score.
+      scaleSignals.length === 0 ? 0.8 : Math.min(1, 0.8 + scaleSignals.length * 0.1),
+      scaleSignals.length === 0 ? "No team/budget/scale signals detected. A nice-to-have, not a deduction." : `${scaleSignals.length} bullet(s) reference team size, budget, or organisation scale.`,
       [],
-      scaleSignals.length === 0 ? "Add scale: 'Led a team of 6', 'Owned a $2M budget', '60+ engineers depend on this service.'" : void 0
+      scaleSignals.length === 0 ? "Optional boost. Add scale: 'Led a team of 6', 'Owned a $2M budget', '60+ engineers depend on this service.'" : void 0,
+      void 0,
+      0.5
     ),
     mk(
       "A9.time-bound",
       "Time-bound impact statements",
-      timeBound.length === 0 ? 0 : Math.min(1, timeBound.length / 2),
-      timeBound.length === 0 ? "No time-bound results ('within 6 months', 'in 2 quarters')." : `${timeBound.length} bullet(s) include a timeframe.`,
+      // Bonus signal: absence is neutral, presence lifts the score.
+      timeBound.length === 0 ? 0.8 : Math.min(1, 0.8 + timeBound.length * 0.1),
+      timeBound.length === 0 ? "No time-bound results yet. A nice-to-have, not a deduction." : `${timeBound.length} bullet(s) include a timeframe.`,
+      [],
+      timeBound.length === 0 ? "Optional boost. Anchor results in time: 'within 6 months', 'in 12 weeks', 'over Q3 2025'." : void 0,
+      void 0,
+      0.5
+    ),
+    mk(
+      "A10.metric-position",
+      "Metrics appear early in the bullet",
+      quantified.length === 0 ? 0.8 : earlyRatio,
+      quantified.length === 0 ? "No quantified bullets yet to position." : `${quantifiedEarly.length} of ${quantified.length} quantified bullets lead with the number.`,
       [],
-      timeBound.length === 0 ? "Anchor results in time: 'within 6 months', 'in 12 weeks', 'over Q3 2025'." : void 0
+      quantified.length && earlyRatio < 0.6 ? "Move the number toward the front: 'Cut costs 35% by\u2026' scans faster than a metric buried at the end." : void 0,
+      void 0,
+      1
     )
   ];
 }
@@ -2222,7 +2340,7 @@ function brevityChecks(resume, b) {
     return r.bullets > 5;
   });
   const pages = Math.max(1, Math.ceil(totalWords / 450));
-  const targetPages = experienceYears(resume) >= 10 ? 2 : 1;
+  const targetPages = experienceYears(resume) < 5 ? 1 : 2;
   const lengthOK = pages <= targetPages;
   return [
     mk(
@@ -2255,7 +2373,7 @@ function brevityChecks(resume, b) {
     mk(
       "B4.page-length",
       `Resume length fits ${targetPages} page${targetPages > 1 ? "s" : ""}`,
-      lengthOK ? 1 : Math.max(0, 1 - (pages - targetPages) * 0.5),
+      lengthOK ? 1 : Math.max(0, 1 - (pages - targetPages) * 0.35),
       `Estimated ${pages} page${pages > 1 ? "s" : ""} (${totalWords} words total).`,
       [],
       !lengthOK ? `Cut ~${(pages - targetPages) * 450} words to fit ${targetPages} page${targetPages > 1 ? "s" : ""}.` : void 0
@@ -2353,7 +2471,9 @@ function styleChecks(resume, b) {
       passive.length / total <= 0.15 ? 1 : 1 - (passive.length / total - 0.15) * 2,
       `${passive.length} of ${total} bullets read as passive voice (${Math.round(passive.length / total * 100)}%).`,
       passive.slice(0, 5).map((x) => x.id),
-      passive.length / total > 0.15 ? "Flip subject/object: 'The project was led by me' \u2192 'Led the project.'" : void 0
+      passive.length / total > 0.15 ? "Flip subject/object: 'The project was led by me' \u2192 'Led the project.'" : void 0,
+      void 0,
+      1.5
     ),
     mk(
       "C3.tense-consistency",
@@ -2393,7 +2513,9 @@ function styleChecks(resume, b) {
       periodConsistent ? 1 : 0.5,
       periodConsistent ? "All bullets agree on whether they end with a period." : `Mixed: ${endsWithPeriod} end with a period, ${endsWithout} don't.`,
       [],
-      !periodConsistent ? "Pick one rule for the whole resume." : void 0
+      !periodConsistent ? "Pick one rule for the whole resume." : void 0,
+      void 0,
+      0.4
     ),
     mk(
       "C8.punctuation-chars",
@@ -2401,7 +2523,9 @@ function styleChecks(resume, b) {
       punctConsistent ? 1 : 0.5,
       punctConsistent ? "Punctuation glyphs are consistent." : "Mixes smart quotes/em-dashes with ASCII equivalents.",
       [],
-      !punctConsistent ? 'Pick either smart quotes (\u201C\u201D) or straight quotes (") consistently.' : void 0
+      !punctConsistent ? 'Pick either smart quotes (\u201C\u201D) or straight quotes (") consistently.' : void 0,
+      void 0,
+      0.4
     ),
     mk(
       "C9.capitalization",
@@ -2409,7 +2533,9 @@ function styleChecks(resume, b) {
       capConsistent ? 1 : 0.5,
       capConsistent ? "Every bullet starts with the same case." : `${startsCap} of ${total} bullets start with a capital letter.`,
       [],
-      !capConsistent ? "Capitalize the first letter of every bullet." : void 0
+      !capConsistent ? "Capitalize the first letter of every bullet." : void 0,
+      void 0,
+      0.4
     ),
     mk(
       "C10.acronym-density",
@@ -2464,6 +2590,20 @@ function structureChecks(resume, b) {
   }
   const expRev = expSec ? rev(expSec.items || []) : true;
   const eduRev = eduSec ? rev(eduSec.items || []) : true;
+  const nowMonths = (/* @__PURE__ */ new Date()).getFullYear() * 12 + ((/* @__PURE__ */ new Date()).getMonth() + 1);
+  let maxGapMonths = 0;
+  if (expSec) {
+    const ranges = (expSec.items || []).map((it) => ({
+      start: parseMMYYYY(it.startDate || ""),
+      end: it.current ? nowMonths : parseMMYYYY(it.endDate || it.startDate || "")
+    })).filter((r) => r.start && r.end);
+    ranges.sort((a, b2) => b2.start - a.start);
+    for (let i = 0; i < ranges.length - 1; i++) {
+      const gap = ranges[i].start - ranges[i + 1].end;
+      if (gap > maxGapMonths) maxGapMonths = gap;
+    }
+  }
+  const gapOK = maxGapMonths <= 6;
   function isCanonical(type, title) {
     const t = title.toLowerCase().trim();
     const list = ATS_SECTION_LABELS[type] || [];
@@ -2533,6 +2673,16 @@ function structureChecks(resume, b) {
       expRev && eduRev ? "Both sections are reverse-chronological." : `${!expRev ? "Experience" : ""}${!expRev && !eduRev ? " & " : ""}${!eduRev ? "Education" : ""} out of order.`,
       [],
       !expRev || !eduRev ? "List most recent first." : void 0
+    ),
+    mk(
+      "D9.employment-gaps",
+      "No large unexplained employment gaps",
+      gapOK ? 1 : 0.7,
+      gapOK ? "No employment gap over 6 months between roles." : `A gap of about ${maxGapMonths} months sits between two roles. Some employers screen for gaps over 6 months.`,
+      [],
+      gapOK ? void 0 : "A gap over 6 months is fine, but consider a one-line note (contract work, study, caregiving) or a brief bridging entry so it does not read as unexplained.",
+      void 0,
+      0.5
     )
   ];
 }
@@ -2542,12 +2692,16 @@ function atsChecks(resume, b) {
   const allText = b.bullets.map((x) => x.text).join(" ");
   const isSingleCol = !isMultiColumnTemplate(s.template);
   const isSafeFont = SAFE_FONTS.has(s.fontHeading) && SAFE_FONTS.has(s.fontBody);
-  const fontSizeOK = s.fontSize >= 9.5 && s.fontSize <= 12;
+  const fontSizeIdeal = s.fontSize >= 10 && s.fontSize <= 12;
+  const fontSizeAcceptable = s.fontSize >= 9.5 && s.fontSize <= 12.5;
   const safeBullet = SAFE_BULLET_GLYPHS.has(s.bulletGlyph === "disc" ? "\u2022" : s.bulletGlyph === "dash" ? "-" : "");
   const emailOK = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(p.email);
   const phoneOK = !p.phone || /(\+?\d[\d\s().-]{6,})/.test(p.phone);
   const hasLinkedIn = !!(p.linkedin && /linkedin\.com\/in\//i.test(p.linkedin));
   const locationOK = !!p.location && /,/.test(p.location);
+  const nameOK = !!(p.fullName && p.fullName.trim().length >= 2);
+  const hasPhone = !!(p.phone && /(\+?\d[\d\s().-]{6,})/.test(p.phone));
+  const contactParseable = nameOK && (emailOK || hasPhone);
   const allDates = [];
   for (const sec of resume.sections) for (const it of sec.items || []) {
     if (it.startDate) allDates.push(it.startDate);
@@ -2575,19 +2729,33 @@ function atsChecks(resume, b) {
   return [
     mk(
       "E1.single-column",
-      "Single-column layout (ATS-critical)",
-      isSingleCol ? 1 : 0,
-      isSingleCol ? "Layout is single-column." : "Multi-column layout \u2014 many ATS parsers scramble reading order.",
+      "Single-column layout (ATS-friendly)",
+      // Proportional soft penalty, not an auto-fail. Modern parsers handle
+      // columns (Textkernel reports ~90% correct column extraction vs ~97%
+      // single-column), but ~1 in 10 still scrambles reading order and columns
+      // cost human skimmability. A single, evidence-scaled ding — the overall
+      // score also takes a small proportional multi-column haircut (see below).
+      // ~0.85 reflects the real ~90% correct column-extraction rate reported by
+      // Textkernel, so the within-dimension ding stays light; the small overall
+      // multi-column haircut in scoreResume carries the actual score effect
+      // (we deliberately don't double-penalize with a 0.55 here).
+      isSingleCol ? 1 : 0.85,
+      isSingleCol ? "Single-column layout. Every ATS parses this cleanly." : "Multi-column template. Modern parsers handle columns about 90% of the time, but a minority scramble reading order, and columns are harder for a recruiter to skim.",
       [],
-      !isSingleCol ? "Pick a single-column template (e.g. Jake, Harvard, Classic) in the Templates tab." : void 0,
-      !isSingleCol ? "hard" : "soft"
+      !isSingleCol ? "Exporting via the ATS PDF button always outputs a single-column, parse-clean file, so you can keep this template on screen and still submit a safe PDF. Or switch to a single-column template (Jake, Harvard, Classic) for a single source." : void 0,
+      "soft"
     ),
     mk(
-      "E2.contact-in-body",
-      "Contact info rendered in body, not header/footer",
-      1,
-      "Contact info is rendered in the document body in this app.",
-      []
+      "E2.contact-parseable",
+      "Name + contact details are parseable",
+      // Hard dependency: parsers build the candidate record from a name plus at
+      // least one of email/phone (Daxtra: without one of these the parse fails).
+      contactParseable ? 1 : 0,
+      contactParseable ? "Full name and at least one contact channel (email or phone) are present." : !nameOK ? "No full name detected. Parsers need a name plus an email or phone to create a candidate record." : "No email or phone detected. Most parsers reject a record that has neither.",
+      [],
+      !contactParseable ? "Add your full name and at least one of email or phone. Without these, many ATS drop the whole resume." : void 0,
+      contactParseable ? "soft" : "hard",
+      2
     ),
     mk(
       "E3.email-valid",
@@ -2620,7 +2788,9 @@ function atsChecks(resume, b) {
       hasLinkedIn ? 1 : 0,
       hasLinkedIn ? "LinkedIn URL detected." : "LinkedIn URL missing or non-canonical.",
       [],
-      !hasLinkedIn ? "Add a linkedin.com/in/your-handle URL." : void 0
+      !hasLinkedIn ? "Add a linkedin.com/in/your-handle URL. Resumes with one see materially higher recruiter response." : void 0,
+      void 0,
+      1.5
     ),
     mk(
       "E7.date-format",
@@ -2644,7 +2814,9 @@ function atsChecks(resume, b) {
       safeBullet ? 1 : 0.6,
       safeBullet ? "Bullet glyph is ATS-safe." : `Bullet glyph '${s.bulletGlyph}' may not survive every ATS parser.`,
       [],
-      !safeBullet ? "Switch bullet glyph to disc, dash, or square (Customize \u2192 Layout \u2192 bullet glyph)." : void 0
+      !safeBullet ? "Switch bullet glyph to disc, dash, or square (Customize \u2192 Layout \u2192 bullet glyph)." : void 0,
+      void 0,
+      0.5
     ),
     mk(
       "E10.font-safe",
@@ -2652,15 +2824,19 @@ function atsChecks(resume, b) {
       isSafeFont ? 1 : 0.5,
       isSafeFont ? "Fonts are ATS-safe." : `Heading '${s.fontHeading}' or body '${s.fontBody}' may not be embedded by some PDF renderers.`,
       [],
-      !isSafeFont ? "Use Arial, Calibri, Helvetica, Garamond, or one of the safe defaults." : void 0
+      !isSafeFont ? "Use Arial, Calibri, Helvetica, Garamond, or one of the safe defaults." : void 0,
+      void 0,
+      0.5
     ),
     mk(
       "E11.font-size",
       "Body font size 10\u201312pt",
-      fontSizeOK ? 1 : 0.5,
-      fontSizeOK ? `Font size ${s.fontSize}pt is in range.` : `Font size ${s.fontSize}pt is outside the 10\u201312pt range.`,
+      fontSizeIdeal ? 1 : fontSizeAcceptable ? 0.75 : 0.5,
+      fontSizeIdeal ? `Font size ${s.fontSize}pt is in the ideal 10\u201312pt band.` : fontSizeAcceptable ? `Font size ${s.fontSize}pt is readable but outside the ideal 10\u201312pt band.` : `Font size ${s.fontSize}pt is outside the readable 9.5\u201312.5pt range.`,
       [],
-      !fontSizeOK ? "Set body size to 10\u201312pt." : void 0
+      !fontSizeIdeal ? "Set body size to 10\u201312pt for the best balance of density and legibility." : void 0,
+      void 0,
+      0.5
     ),
     mk(
       "E12.no-killer-chars",
@@ -2685,7 +2861,7 @@ function skillsChecks(resume, b) {
     if (t.length < 3) continue;
     counts.set(t, (counts.get(t) || 0) + 1);
   }
-  const stuffed = [...counts.entries()].filter(([k, v]) => v > 6 && /^[a-z]+$/.test(k) && !["with", "from", "into", "over", "under", "across", "by", "to", "for", "the", "and", "of", "on", "in"].includes(k));
+  const stuffed = [...counts.entries()].filter(([k, v]) => v > 8 && /^[a-z]+$/.test(k) && !["with", "from", "into", "over", "under", "across", "by", "to", "for", "the", "and", "of", "on", "in", "a", "an", "that", "this", "was", "were", "are", "have", "has"].includes(k));
   const allText = b.bullets.map((x) => x.text).join(" ");
   const acronyms = [...new Set(Array.from(allText.matchAll(/\b([A-Z]{2,5})\b/g)).map((m) => m[1]))].slice(0, 5);
   const expanded = acronyms.filter((a) => new RegExp(`\\b${a}\\s*\\(`).test(allText));
@@ -2720,7 +2896,7 @@ function skillsChecks(resume, b) {
       stuffed.length === 0 ? 1 : 1 - Math.min(1, stuffed.length / 3),
       stuffed.length === 0 ? "No token over-repeated." : `Over-repeated: ${stuffed.slice(0, 4).map(([k, v]) => `${k}\xD7${v}`).join(", ")}.`,
       [],
-      stuffed.length ? "Diversify language \u2014 repeating a keyword more than 5\xD7 looks like stuffing." : void 0
+      stuffed.length ? "Diversify your language. Repeating the same keyword more than 8 times reads as stuffing, and frequency past the first mention does not help ATS ranking anyway." : void 0
     ),
     mk(
       "F5.acronym-expansion",
@@ -2728,7 +2904,9 @@ function skillsChecks(resume, b) {
       acronyms.length === 0 ? 1 : expanded.length / acronyms.length,
       acronyms.length === 0 ? "No acronyms detected." : `${expanded.length} of ${acronyms.length} top acronyms have an inline expansion.`,
       [],
-      acronyms.length > 0 && expanded.length < acronyms.length ? `Expand at least once: e.g. '${acronyms[0]} (\u2026)'.` : void 0
+      acronyms.length > 0 && expanded.length < acronyms.length ? `Expand at least once: e.g. '${acronyms[0]} (\u2026)'. Recruiter search is exact-match, so 'ML (Machine Learning)' catches both queries.` : void 0,
+      void 0,
+      0.5
     )
   ];
 }
@@ -2743,6 +2921,10 @@ function polishChecks(resume, b) {
   const linkedinGeneric = p.linkedin && /\/in\/[a-z0-9]{8,}-[a-z0-9]{4,}/i.test(p.linkedin) && !/[a-zA-Z]/.test(p.linkedin.split("/in/")[1]?.split(/[-?#]/)[0] || "");
   const hasCustomWebsite = !!p.website && !/(linkedin\.com|github\.com|facebook\.com|twitter\.com|x\.com)/i.test(p.website);
   const hasHeadline = !!p.title;
+  const rawHtml = resume.sections.flatMap((sec) => (sec.items || []).flatMap((it) => [it.description, it.body].filter(Boolean))).join(" ");
+  const HIDDEN_STYLE_RE = /color\s*:\s*(#fff(fff)?|#ffffff|white|rgba?\(\s*255\s*,\s*255\s*,\s*255)|font-size\s*:\s*0|opacity\s*:\s*0|visibility\s*:\s*hidden|display\s*:\s*none/i;
+  const PROMPT_INJECT_RE = /\b(ignore (all )?(the )?previous|as an ai|you are an ai|rate (this|the|me|my) (resume|candidate|application) (highly|as|a perfect|10)|you must (rate|score|recommend)|system prompt|disregard (the )?instructions|hiring manager must)\b/i;
+  const hasHiddenText = HIDDEN_STYLE_RE.test(rawHtml) || PROMPT_INJECT_RE.test(stripHtml2(rawHtml).toLowerCase());
   return [
     mk(
       "G1.no-placeholders",
@@ -2787,14 +2969,28 @@ function polishChecks(resume, b) {
     mk(
       "G6.custom-portfolio",
       "Custom portfolio or personal site (nice-to-have)",
-      hasCustomWebsite ? 1 : 0.6,
-      hasCustomWebsite ? "Custom site present." : "No personal site listed.",
+      hasCustomWebsite ? 1 : 0.9,
+      hasCustomWebsite ? "Custom site present." : "No personal site listed. Optional, not a deduction.",
+      [],
+      hasCustomWebsite ? void 0 : "A custom domain (yourname.dev) lifts a senior resume \u2014 optional.",
+      void 0,
+      0.5
+    ),
+    mk(
+      "G8.hidden-text",
+      "No hidden text or keyword tricks",
+      hasHiddenText ? 0 : 1,
+      hasHiddenText ? "Hidden or invisible text (white-on-white, zero-size) or an AI-instruction string was detected. ATS convert your file to plain text, so these become visible and read as gaming the system." : "No hidden text or prompt-injection tricks detected.",
       [],
-      hasCustomWebsite ? void 0 : "A custom domain (yourname.dev) lifts a senior resume \u2014 optional."
+      hasHiddenText ? "Remove any white/invisible text, zero-size fonts, or 'rate me highly'-style instructions. They backfire once the ATS strips formatting." : void 0,
+      // Hard severity: hidden text / prompt-injection is the one trick that
+      // genuinely backfires, so a positive detection caps the overall score.
+      "hard",
+      2
     )
   ];
 }
-function mk(id, label, score, message, evidence, suggestion, severity) {
+function mk(id, label, score, message, evidence, suggestion, severity, weight) {
   const s = Math.max(0, Math.min(1, score));
   return {
     id,
@@ -2804,7 +3000,8 @@ function mk(id, label, score, message, evidence, suggestion, severity) {
     message,
     evidence: evidence ?? [],
     suggestion: suggestion ?? null,
-    severity: severity || "soft"
+    severity: severity || "soft",
+    weight: weight ?? 1
   };
 }
 function parseMMYYYY(d) {
@@ -2832,11 +3029,62 @@ function experienceYears(resume) {
   }
   return Math.floor(months / 12);
 }
+function computeFlags(resume) {
+  const flags = [];
+  const p = resume.personal;
+  const emailOK = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(p.email);
+  const hasPhone = !!(p.phone && /(\+?\d[\d\s().-]{6,})/.test(p.phone));
+  const nameOK = !!(p.fullName && p.fullName.trim().length >= 2);
+  if (!(nameOK && (emailOK || hasPhone))) {
+    flags.push({
+      id: "K1.contact-unparseable",
+      severity: "block",
+      title: "Contact details can't be parsed",
+      detail: !nameOK ? "No full name is set. ATS build the candidate record from a name plus an email or phone, so without a name the whole resume can be dropped." : "No valid email or phone is set. Most parsers reject a record that has neither.",
+      suggestion: "Add your full name and at least one of a valid email or phone."
+    });
+  }
+  const expSec = resume.sections.find((s) => s.type === "experience");
+  const expItems = (expSec?.items || []).filter((it) => it.visible !== false);
+  const datelessRoles = expItems.filter((it) => !parseMMYYYY(it.startDate || ""));
+  if (expItems.length > 0 && datelessRoles.length > 0) {
+    flags.push({
+      id: "K2.role-without-dates",
+      severity: "risk",
+      title: `${datelessRoles.length} role${datelessRoles.length === 1 ? "" : "s"} missing dates`,
+      detail: "A role with no start date can't be ordered or counted toward years of experience by a parser, and years-of-experience filters are a top recruiter screen.",
+      suggestion: "Add a start and end date (MM/YYYY or Month YYYY) to every role."
+    });
+  }
+  const nowMonths = (/* @__PURE__ */ new Date()).getFullYear() * 12 + ((/* @__PURE__ */ new Date()).getMonth() + 1);
+  const ranges = expItems.map((it) => ({ start: parseMMYYYY(it.startDate || ""), end: it.current ? nowMonths : parseMMYYYY(it.endDate || it.startDate || "") })).filter((r) => r.start && r.end);
+  ranges.sort((a, b) => b.start - a.start);
+  let maxGap = 0;
+  for (let i = 0; i < ranges.length - 1; i++) {
+    const gap = ranges[i].start - ranges[i + 1].end;
+    if (gap > maxGap) maxGap = gap;
+  }
+  if (maxGap > 6) {
+    flags.push({
+      id: "K3.employment-gap",
+      severity: "risk",
+      title: `About a ${maxGap}-month employment gap`,
+      detail: "Some employers screen for gaps over 6 months. A gap is legitimate, but an unexplained one lowers callback odds.",
+      suggestion: "Add a one-line note (contract, study, caregiving) or a short bridging entry so the gap does not read as unexplained."
+    });
+  }
+  return flags;
+}
 function aggregate(checks, weight) {
   if (!checks.length) return { score: 0, weighted: 0 };
-  const sum = checks.reduce((a, c) => a + c.score, 0);
-  const score = Math.round(sum / checks.length * 100);
-  return { score, weighted: sum / checks.length * weight };
+  let wsum = 0, wtot = 0;
+  for (const c of checks) {
+    const w = c.weight ?? 1;
+    wsum += c.score * w;
+    wtot += w;
+  }
+  const mean = wtot ? wsum / wtot : 0;
+  return { score: Math.round(mean * 100), weighted: mean * weight };
 }
 var WEIGHTS = {
   impact: 22,
@@ -2856,7 +3104,7 @@ var LABELS = {
   skills: "Skills & Keywords",
   polish: "Completeness & Polish"
 };
-function scoreResume(resume) {
+function scoreResume(resume, opts) {
   const b = gather(resume);
   const dims = [
     { dim: "impact", checks: impactChecks(resume, b) },
@@ -2886,12 +3134,30 @@ function scoreResume(resume) {
     };
   });
   let overall = Math.round(weightedSum / totalWeight * 100);
+  if (isMultiColumnTemplate(resume.styling.template)) {
+    overall = Math.round(overall * 0.93);
+  }
   const hardFail = dimensions.some((d) => d.checks.some((c) => c.severity === "hard" && c.status === "fail"));
   if (hardFail) overall = Math.min(overall, 60);
+  const parseFindings = opts?.parseFindings ?? [];
+  const parseHard = parseFindings.some((f) => f.severity === "hard");
+  const parseSoftCount = parseFindings.filter((f) => f.severity === "soft").length;
+  if (parseHard) overall = Math.min(overall, 55);
+  if (parseSoftCount) overall = Math.max(0, overall - Math.min(12, parseSoftCount * 4));
+  const flags = [
+    ...computeFlags(resume),
+    ...parseFindings.map((f) => ({
+      id: f.id,
+      severity: f.severity === "hard" ? "block" : "risk",
+      title: f.title,
+      detail: f.detail,
+      suggestion: f.suggestion ?? null
+    }))
+  ];
   const sortedDims = [...dimensions].sort((a, b2) => a.score - b2.score);
   const worst = sortedDims[0];
   const best = sortedDims[sortedDims.length - 1];
-  const allFails = dimensions.flatMap((d) => d.checks.map((c) => ({ ...c, dim: d.dimension, dimLabel: d.label, weight: d.weight }))).filter((c) => c.suggestion && c.status !== "pass").sort((a, b2) => a.score - b2.score);
+  const allFails = dimensions.flatMap((d) => d.checks.map((c) => ({ ...c, dim: d.dimension, dimLabel: d.label, weight: d.weight }))).filter((c) => c.suggestion && c.status !== "pass").sort((a, b2) => (1 - b2.score) * b2.weight - (1 - a.score) * a.weight);
   const priorities = allFails.slice(0, 5);
   return {
     overall,
@@ -2900,6 +3166,7 @@ function scoreResume(resume) {
     summary: `Strongest: ${best.label} (${best.score}). Focus area: ${worst.label} (${worst.score}).`,
     priorities,
     hardFails: dimensions.flatMap((d) => d.checks.filter((c) => c.severity === "hard" && c.status === "fail").map((c) => ({ ...c, dim: d.dimension }))),
+    flags,
     stats: {
       totalBullets: b.bullets.length,
       experienceBullets: b.expBullets.length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juicedresume/mcp",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Model Context Protocol server for JuicedResume — score, tailor, and edit your resume from any MCP client (Claude Code, Claude Desktop, Cursor).",
   "keywords": [
     "mcp",