@juicedresume/mcp 0.3.1 → 0.3.2

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));
 }
@@ -1368,7 +1430,20 @@ function resumeText(resume) {
 }
 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 resumeHas(keyword) {
+    const k = keyword.toLowerCase();
+    if (k.includes(" ")) {
+      return new RegExp(`\\b${escapeRe(k)}\\b`).test(resumeFullText);
+    }
+    if (resumeToks.has(k)) return true;
+    const canon = normalizeSkill(keyword).toLowerCase();
+    if (resumeNorm.has(canon)) return true;
+    if (canon.includes(" ") && new RegExp(`\\b${escapeRe(canon)}\\b`).test(resumeFullText)) return true;
+    return false;
+  }
   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 +1459,22 @@ 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;
   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);
+    if (resumeHas(k)) {
+      matched.push({ keyword: k, kind: meta.kind, count: w });
     } 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,7 +1482,8 @@ function tailorToJob(resume, jdText) {
     matched,
     missing,
     jdSkills: jdSkills.size,
-    resumeSkills: resumeToks.size
+    resumeSkills: resumeToks.size,
+    titleMatch
   };
 }
 
@@ -1410,7 +1491,7 @@ function tailorToJob(resume, jdText) {
 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 +1500,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,7 +1526,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."
+      "Reorder bullets in your most-recent experience so the most quantified / highest-impact bullet is first.",
+      0.5
     )
   };
 }
@@ -1515,19 +1595,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 +1623,13 @@ 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 +2157,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 +2169,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 +2190,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 +2208,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 +2231,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 ? "Anchor results in time: 'within 6 months', 'in 12 weeks', 'over Q3 2025'." : void 0
+      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.`,
+      [],
+      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 +2290,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 +2323,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 +2421,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 +2463,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 +2473,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 +2483,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 +2540,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 +2623,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
     )
   ];
 }
@@ -2548,6 +2648,9 @@ function atsChecks(resume, b) {
   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 +2678,29 @@ 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).
+      isSingleCol ? 1 : 0.55,
+      isSingleCol ? "Single-column layout \u2014 every ATS parses this cleanly." : "Multi-column template. Modern parsers usually handle columns, but a minority still scramble reading order, and columns are harder for a recruiter to skim. Single-column is the zero-risk choice.",
       [],
-      !isSingleCol ? "Pick a single-column template (e.g. Jake, Harvard, Classic) in the Templates tab." : void 0,
-      !isSingleCol ? "hard" : "soft"
+      !isSingleCol ? "For maximum ATS safety, switch to a single-column template (Jake, Harvard, Classic) in the Templates tab. Not required, but it removes all parse risk." : 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 +2733,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 +2759,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,7 +2769,9 @@ 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",
@@ -2660,7 +2779,9 @@ function atsChecks(resume, b) {
       fontSizeOK ? 1 : 0.5,
       fontSizeOK ? `Font size ${s.fontSize}pt is in range.` : `Font size ${s.fontSize}pt is outside the 10\u201312pt range.`,
       [],
-      !fontSizeOK ? "Set body size to 10\u201312pt." : void 0
+      !fontSizeOK ? "Set body size to 10\u201312pt." : void 0,
+      void 0,
+      0.5
     ),
     mk(
       "E12.no-killer-chars",
@@ -2685,7 +2806,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));
@@ -2728,7 +2849,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 +2866,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 +2914,26 @@ 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."
+      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.",
+      [],
+      hasHiddenText ? "Remove any white/invisible text, zero-size fonts, or 'rate me highly'-style instructions. They backfire once the ATS strips formatting." : void 0,
+      void 0,
+      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 +2943,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) {
@@ -2834,9 +2974,14 @@ function experienceYears(resume) {
 }
 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,
@@ -2886,12 +3031,15 @@ 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 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,

package/package.json

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