@getkrafter/resume-toolkit 1.0.1

package/dist/lib/resume-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-scorer.d.ts","sourceRoot":"","sources":["../../src/lib/resume-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAIX,QAAQ,EACT,MAAM,YAAY,CAAC;AAwDpB;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAK7D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CASpD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAa3D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAY9D;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAiBnE;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,UAAU,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,CAkHb"}

package/dist/lib/resume-scorer.js

@@ -0,0 +1,236 @@
+import { stem, tokenize, STOP_WORDS, VERB_TIERS } from './text-utils.js';
+import { scoreATS } from './ats-scorer.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Weights when a job description is provided. */
+const WEIGHTS_WITH_JD = {
+    quantification: 0.25,
+    verbStrength: 0.2,
+    ats: 0.3,
+    bulletStructure: 0.15,
+    sectionCompleteness: 0.1,
+};
+/** Required resume sections, each worth 20 points. */
+const REQUIRED_SECTIONS = ['experience', 'education', 'skills'];
+/** Recommended resume sections, each worth ~13.33 points. */
+const RECOMMENDED_SECTIONS = ['summary', 'projects', 'certifications'];
+const REQUIRED_SECTION_POINTS = 20;
+const RECOMMENDED_SECTION_POINTS = 100 / 3 - 13; // ~13.33
+// More precise: 40 / 3 = 13.333...
+const RECOMMENDED_POINTS = 40 / 3;
+// ---------------------------------------------------------------------------
+// Pre-computed stemmed verb tiers for fast lookup
+// ---------------------------------------------------------------------------
+/**
+ * Maps a stemmed verb to its tier number.
+ * Built once at module load time from VERB_TIERS.
+ */
+const STEMMED_VERB_MAP = buildStemmedVerbMap();
+function buildStemmedVerbMap() {
+    const map = new Map();
+    for (const verb of VERB_TIERS.tier1) {
+        map.set(stem(verb), 1);
+    }
+    for (const verb of VERB_TIERS.tier2) {
+        map.set(stem(verb), 2);
+    }
+    for (const verb of VERB_TIERS.tier3) {
+        map.set(stem(verb), 3);
+    }
+    return map;
+}
+// ---------------------------------------------------------------------------
+// Sub-scorers
+// ---------------------------------------------------------------------------
+/**
+ * Fraction of bullets that contain at least one number or metric.
+ * Returns 0-100. Returns 0 for empty bullets array.
+ */
+export function scoreQuantification(bullets) {
+    if (bullets.length === 0)
+        return 0;
+    const withNumbers = bullets.filter((b) => /\d+/.test(b)).length;
+    return (withNumbers / bullets.length) * 100;
+}
+/**
+ * Determine the verb tier for a bullet based on its first non-stop-word token.
+ *
+ * Tokenizes the bullet, skips stop words, takes the first meaningful token,
+ * stems it, and looks it up in the pre-computed stemmed verb map.
+ *
+ * Returns 1 (strong), 2 (solid), 3 (weak), or null (unrecognized).
+ */
+export function getVerbTier(bullet) {
+    const tokens = tokenize(bullet);
+    // Find the first non-stop-word token
+    const firstMeaningful = tokens.find((t) => !STOP_WORDS.has(t));
+    if (!firstMeaningful)
+        return null;
+    const stemmed = stem(firstMeaningful);
+    return STEMMED_VERB_MAP.get(stemmed) ?? null;
+}
+/**
+ * Average verb tier quality across bullets.
+ * Scoring: tier1=100, tier2=60, tier3=20, null=40.
+ * Returns 0-100. Returns 0 for empty bullets array.
+ */
+export function scoreVerbStrength(bullets) {
+    if (bullets.length === 0)
+        return 0;
+    const tierScores = { 1: 100, 2: 60, 3: 20 };
+    const unrecognizedScore = 40;
+    let total = 0;
+    for (const bullet of bullets) {
+        const tier = getVerbTier(bullet);
+        total += tier !== null ? tierScores[tier] : unrecognizedScore;
+    }
+    return total / bullets.length;
+}
+/**
+ * Fraction of "strong" bullets. A bullet is strong if it:
+ * - Starts with a recognized verb (tier 1, 2, or 3)
+ * - Contains a number (`/\d+/`)
+ * - Has 8+ words
+ *
+ * Returns 0-100. Returns 0 for empty bullets array.
+ */
+export function scoreBulletStructure(bullets) {
+    if (bullets.length === 0)
+        return 0;
+    const strong = bullets.filter((bullet) => {
+        const tier = getVerbTier(bullet);
+        const hasVerb = tier !== null;
+        const hasNumber = /\d+/.test(bullet);
+        const wordCount = tokenize(bullet).length;
+        return hasVerb && hasNumber && wordCount >= 8;
+    }).length;
+    return (strong / bullets.length) * 100;
+}
+/**
+ * Presence of expected resume sections.
+ *
+ * Required sections ("experience", "education", "skills") are worth 20 points each.
+ * Recommended sections ("summary", "projects", "certifications") are worth ~13.33 points each.
+ * Match by substring: a section name includes the keyword.
+ * Capped at 100.
+ */
+export function scoreSectionCompleteness(sections) {
+    const lowerSections = sections.map((s) => s.toLowerCase());
+    let score = 0;
+    for (const required of REQUIRED_SECTIONS) {
+        if (lowerSections.some((s) => s.includes(required))) {
+            score += REQUIRED_SECTION_POINTS;
+        }
+    }
+    for (const recommended of RECOMMENDED_SECTIONS) {
+        if (lowerSections.some((s) => s.includes(recommended))) {
+            score += RECOMMENDED_POINTS;
+        }
+    }
+    return Math.min(Math.round(score * 100) / 100, 100);
+}
+// ---------------------------------------------------------------------------
+// Main scorer
+// ---------------------------------------------------------------------------
+/**
+ * Score a resume across five dimensions: quantification, verb strength,
+ * ATS keyword match, bullet structure, and section completeness.
+ *
+ * When a job description is provided, the ATS dimension is active and
+ * carries 30% weight. Without a JD, the ATS weight is redistributed
+ * proportionally across the other four dimensions.
+ *
+ * @param resumeData - Parsed resume data (raw text, bullets, sections)
+ * @param jdText     - Optional job description text for ATS matching
+ * @returns A `ResumeScore` with total (0-100), mode, breakdown, ATS result, and flags.
+ */
+export function scoreResume(resumeData, jdText) {
+    const { rawText, bullets, sections } = resumeData;
+    const flags = [];
+    // --- Determine mode ---
+    const hasJd = Boolean(jdText);
+    const mode = hasJd ? 'with-jd' : 'without-jd';
+    if (!hasJd) {
+        flags.push('No job description provided — ATS score excluded, weights redistributed.');
+    }
+    // --- Check for empty / short resume ---
+    if (!rawText || rawText.trim().length === 0) {
+        flags.push('Resume appears empty');
+    }
+    else {
+        const wordCount = tokenize(rawText).length;
+        if (wordCount < 50) {
+            flags.push('Resume is unusually short');
+        }
+    }
+    // --- Compute raw scores ---
+    const quantScore = scoreQuantification(bullets);
+    const verbScore = scoreVerbStrength(bullets);
+    const structScore = scoreBulletStructure(bullets);
+    const sectionScore = scoreSectionCompleteness(sections);
+    const atsResult = hasJd
+        ? scoreATS(rawText, jdText)
+        : null;
+    const atsScore = atsResult?.score ?? 0;
+    // --- Build weights ---
+    const weights = { ...WEIGHTS_WITH_JD };
+    if (!hasJd) {
+        // Redistribute ATS weight proportionally across the other 4 dimensions
+        const nonAtsTotal = 1 - weights['ats'];
+        weights['ats'] = 0;
+        for (const key of Object.keys(weights)) {
+            if (key !== 'ats') {
+                weights[key] = WEIGHTS_WITH_JD[key] / nonAtsTotal;
+            }
+        }
+    }
+    // --- Build breakdown ---
+    const scores = {
+        quantification: quantScore,
+        verbStrength: verbScore,
+        ats: atsScore,
+        bulletStructure: structScore,
+        sectionCompleteness: sectionScore,
+    };
+    const breakdown = {};
+    let total = 0;
+    for (const key of Object.keys(weights)) {
+        const score = scores[key];
+        const weight = weights[key];
+        const weightedScore = Math.round(score * weight * 100) / 100;
+        breakdown[key] = { score, weight, weightedScore };
+        total += weightedScore;
+    }
+    // Round total to reasonable precision
+    total = Math.round(total * 100) / 100;
+    // --- Generate diagnostic flags ---
+    if (quantScore < 40) {
+        flags.push('Fewer than 40% of bullets contain measurable results. Add numbers, percentages, or metrics.');
+    }
+    if (verbScore < 40) {
+        flags.push('Action verb quality is low. Replace weak/passive openers with strong action verbs.');
+    }
+    if (structScore < 40) {
+        flags.push('Most bullets lack the verb -> action -> outcome structure.');
+    }
+    // Check for summary/profile section
+    const lowerSections = sections.map((s) => s.toLowerCase());
+    const hasSummaryOrProfile = lowerSections.some((s) => s.includes('summary') || s.includes('profile'));
+    if (!hasSummaryOrProfile) {
+        flags.push('No summary/profile section found.');
+    }
+    // Flag low ATS score with top 5 missing terms
+    if (atsResult && atsResult.score < 50) {
+        const top5missing = atsResult.missing.slice(0, 5);
+        flags.push(`Low ATS match (${atsResult.score}%). Key missing terms: ${top5missing.join(', ')}`);
+    }
+    return {
+        total,
+        mode,
+        breakdown,
+        ats: atsResult,
+        flags,
+    };
+}
+//# sourceMappingURL=resume-scorer.js.map

package/dist/lib/resume-scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-scorer.js","sourceRoot":"","sources":["../../src/lib/resume-scorer.ts"],"names":[],"mappings":"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"}

package/dist/lib/resume-transformer.d.ts

@@ -0,0 +1,13 @@
+import type { ResumeData } from './types.js';
+/**
+ * Converts a structured Krafter resume object into the flat `ResumeData` format
+ * used for scoring, ATS matching, and other analysis.
+ *
+ * The function is fully defensive -- it never throws on malformed input.
+ * Missing or unexpected fields are silently skipped.
+ *
+ * @param resume - A Krafter resume object (the shape returned by `getResume()`)
+ * @returns A flattened `ResumeData` with `rawText`, `bullets`, and `sections`
+ */
+export declare function toResumeData(resume: Record<string, unknown>): ResumeData;
+//# sourceMappingURL=resume-transformer.d.ts.map

package/dist/lib/resume-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-transformer.d.ts","sourceRoot":"","sources":["../../src/lib/resume-transformer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAwC7C;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CA0ExE"}

package/dist/lib/resume-transformer.js

@@ -0,0 +1,113 @@
+/**
+ * Strips all HTML tags from a string, collapses whitespace, and trims.
+ */
+function stripHtml(html) {
+    return html
+        .replace(/<[^>]*>/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Extracts the text content of each `<li>` element from an HTML string.
+ * Inner HTML tags are stripped from the extracted content.
+ */
+function extractBullets(html) {
+    const bullets = [];
+    const liRegex = /<li[^>]*>([\s\S]*?)<\/li>/gi;
+    let match;
+    while ((match = liRegex.exec(html)) !== null) {
+        const cleaned = stripHtml(match[1]);
+        if (cleaned) {
+            bullets.push(cleaned);
+        }
+    }
+    return bullets;
+}
+/**
+ * Safely reads a string property from an unknown object.
+ * Returns an empty string if the property is missing or not a string.
+ */
+function getString(obj, key) {
+    const value = obj[key];
+    return typeof value === 'string' ? value : '';
+}
+/**
+ * Converts a structured Krafter resume object into the flat `ResumeData` format
+ * used for scoring, ATS matching, and other analysis.
+ *
+ * The function is fully defensive -- it never throws on malformed input.
+ * Missing or unexpected fields are silently skipped.
+ *
+ * @param resume - A Krafter resume object (the shape returned by `getResume()`)
+ * @returns A flattened `ResumeData` with `rawText`, `bullets`, and `sections`
+ */
+export function toResumeData(resume) {
+    const textParts = [];
+    const allBullets = [];
+    const sectionNames = [];
+    // --- Personal fields ---
+    const personalFields = ['firstName', 'lastName', 'jobTitle', 'professionalSummary'];
+    for (const field of personalFields) {
+        const value = getString(resume, field);
+        if (value) {
+            textParts.push(stripHtml(value));
+        }
+    }
+    // --- Sections ---
+    const sections = resume['sections'];
+    if (Array.isArray(sections)) {
+        for (const section of sections) {
+            if (section == null || typeof section !== 'object')
+                continue;
+            const sec = section;
+            // Section name
+            const sectionName = getString(sec, 'name');
+            if (sectionName) {
+                sectionNames.push(sectionName.toLowerCase());
+                textParts.push(sectionName);
+            }
+            // Items within the section
+            const items = sec['items'];
+            if (!Array.isArray(items))
+                continue;
+            for (const item of items) {
+                if (item == null || typeof item !== 'object')
+                    continue;
+                const it = item;
+                // Structured fields: title, subtitle, dates
+                const title = getString(it, 'title');
+                const subtitle = getString(it, 'subtitle');
+                const startDate = getString(it, 'startDate');
+                const endDate = getString(it, 'endDate');
+                if (title)
+                    textParts.push(title);
+                if (subtitle)
+                    textParts.push(subtitle);
+                if (startDate)
+                    textParts.push(startDate);
+                if (endDate)
+                    textParts.push(endDate);
+                // Skill-style items (name only)
+                const itemName = getString(it, 'name');
+                if (itemName)
+                    textParts.push(itemName);
+                // Description (HTML with potential bullet points)
+                const description = getString(it, 'description');
+                if (description) {
+                    // Extract bullets from <li> elements
+                    const bullets = extractBullets(description);
+                    allBullets.push(...bullets);
+                    // Add stripped description to rawText
+                    textParts.push(stripHtml(description));
+                }
+            }
+        }
+    }
+    const rawText = textParts.filter(Boolean).join(' ').replace(/\s+/g, ' ').trim();
+    return {
+        rawText,
+        bullets: allBullets,
+        sections: sectionNames,
+    };
+}
+//# sourceMappingURL=resume-transformer.js.map

package/dist/lib/resume-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-transformer.js","sourceRoot":"","sources":["../../src/lib/resume-transformer.ts"],"names":[],"mappings":"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"}

package/dist/lib/text-utils.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Comprehensive English stop words (~179 words) that carry little semantic
+ * meaning and should be filtered out during term extraction.
+ */
+export declare const STOP_WORDS: Set<string>;
+/**
+ * Resume-domain synonym map. Multi-word phrases and framework names are
+ * normalised to their canonical short forms. Keys are sorted by length
+ * descending at module load time so that longer phrases match first
+ * (e.g. "amazon web services" before "amazon").
+ */
+export declare const SYNONYMS: Record<string, string>;
+/**
+ * Action verb tiers for resume bullet quality assessment.
+ *
+ * - tier1: strong leadership / impact verbs
+ * - tier2: solid, active verbs
+ * - tier3: weak, passive, or vague verbs
+ */
+export declare const VERB_TIERS: {
+    tier1: string[];
+    tier2: string[];
+    tier3: string[];
+};
+/**
+ * Stem a single word using the Porter Stemmer, with overrides for known
+ * problem words. Input is lowercased before stemming.
+ */
+export declare function stem(word: string): string;
+/**
+ * Tokenize text into an array of lowercase word tokens.
+ * Returns an empty array for empty / whitespace-only input.
+ */
+export declare function tokenize(text: string): string[];
+/**
+ * Normalise text for matching: lowercase, trim, collapse whitespace,
+ * and apply synonym replacement. Synonyms are applied as whole-word
+ * replacements on the lowercased string before any tokenization.
+ *
+ * Multi-word synonyms are matched via simple `includes` + `replaceAll`,
+ * while single-word synonyms use regex word-boundary matching. Keys are
+ * processed longest-first to prevent partial matches.
+ */
+export declare function normalise(text: string): string;
+/**
+ * Extract a set of search terms from text. The pipeline:
+ *
+ * 1. Normalise (lowercase + synonyms)
+ * 2. Tokenize
+ * 3. Filter out stop words
+ * 4. Build stemmed unigrams from the filtered list
+ * 5. Build raw bigrams from adjacent pairs in the filtered list
+ *
+ * Returns a Set containing both stemmed unigrams and raw bigrams.
+ */
+export declare function extractTerms(text: string): Set<string>;
+//# sourceMappingURL=text-utils.d.ts.map

package/dist/lib/text-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.d.ts","sourceRoot":"","sources":["../../src/lib/text-utils.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,GAAG,CAAC,MAAM,CAkDjC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA4B3C,CAAC;AAUF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CA+C3E,CAAC;AAuCF;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAezC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAI/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuB9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAoBtD"}