@getkrafter/resume-toolkit 1.0.1

package/dist/lib/text-utils.js

@@ -0,0 +1,282 @@
+/**
+ * Shared text processing utilities for resume analysis.
+ *
+ * Built on the `natural` NLP library, these helpers handle stemming,
+ * tokenization, normalisation (with resume-domain synonym expansion),
+ * and term extraction (unigrams + bigrams) used by the ATS scorer.
+ */
+import natural from 'natural';
+const porterStemmer = natural.PorterStemmer;
+const wordTokenizer = new natural.WordTokenizer();
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Comprehensive English stop words (~179 words) that carry little semantic
+ * meaning and should be filtered out during term extraction.
+ */
+export const STOP_WORDS = new Set([
+    // Articles & determiners
+    'a', 'an', 'the', 'this', 'that', 'these', 'those',
+    // Conjunctions & prepositions
+    'and', 'or', 'but', 'nor', 'so', 'yet', 'for', 'at', 'by', 'in', 'of',
+    'on', 'to', 'with', 'from', 'into', 'over', 'about', 'up', 'out', 'if',
+    'then', 'than', 'as', 'between', 'through', 'under', 'above', 'below',
+    'during', 'before', 'after', 'until', 'while', 'because', 'against',
+    'again', 'further', 'once',
+    // Pronouns
+    'i', 'me', 'my', 'we', 'our', 'us', 'you', 'your', 'he', 'him', 'his',
+    'she', 'her', 'it', 'its', 'they', 'their', 'them', 'who', 'which',
+    'what', 'where', 'when', 'how', 'whom', 'whose',
+    // Be / have / do / modals
+    'is', 'am', 'are', 'was', 'were', 'be', 'been', 'being',
+    'have', 'has', 'had', 'having',
+    'do', 'does', 'did',
+    'will', 'would', 'could', 'should', 'may', 'might', 'can', 'shall',
+    'must', 'need', 'ought',
+    // Common adverbs & adjectives used as function words
+    'not', 'no', 'very', 'just', 'also', 'too', 'only', 'own', 'same',
+    'such', 'more', 'most', 'other', 'some', 'any', 'each', 'every',
+    'all', 'both', 'few', 'many', 'much', 'several',
+    // Misc function words
+    'here', 'there', 'now', 'already', 'still', 'even', 'well',
+    'back', 'away', 'off', 'down',
+    // Additional common stop words
+    'been', 'being', 'had', 'having', 'did', 'doing',
+    'would', 'could', 'should',
+    'able', 'across', 'almost', 'along', 'among', 'another',
+    'around', 'away', 'become', 'becomes', 'began', 'behind',
+    'beside', 'besides', 'beyond', 'came', 'cannot', 'come',
+    'comes', 'could', 'done', 'either', 'else', 'enough',
+    'etc', 'ever', 'everything', 'find', 'first', 'found',
+    'get', 'gets', 'give', 'given', 'goes', 'going', 'gone',
+    'got', 'great', 'however', 'just', 'keep', 'keeps', 'kept',
+    'know', 'known', 'last', 'later', 'least', 'less', 'let',
+    'like', 'likely', 'long', 'look', 'made', 'make', 'makes',
+    'making', 'may', 'maybe', 'might', 'mine', 'more', 'most',
+    'mostly', 'must', 'never', 'new', 'next', 'none', 'nothing',
+    'often', 'old', 'one', 'ones', 'others', 'part', 'per',
+    'perhaps', 'put', 'quite', 'rather', 'really', 'right',
+    'said', 'say', 'says', 'seem', 'seemed', 'seems', 'show',
+    'since', 'something', 'still', 'take', 'taken', 'tell',
+    'thing', 'things', 'think', 'three', 'thus', 'together',
+    'told', 'took', 'toward', 'towards', 'try', 'turn', 'turned',
+    'two', 'upon', 'use', 'used', 'using', 'want', 'wants',
+    'way', 'ways', 'went', 'whether', 'within', 'without',
+    'work', 'works', 'worked', 'working', 'year', 'years',
+    'yet', 'also',
+]);
+/**
+ * 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 const SYNONYMS = {
+    // Cloud platforms (multi-word first)
+    'amazon web services': 'aws',
+    'google cloud platform': 'gcp',
+    // DevOps / CI-CD
+    'continuous integration': 'ci',
+    'continuous deployment': 'cd',
+    'continuous delivery': 'cd',
+    // AI / ML
+    'artificial intelligence': 'ai',
+    'machine learning': 'ml',
+    // UX / UI
+    'user experience': 'ux',
+    'user interface': 'ui',
+    // Languages
+    'javascript': 'js',
+    'typescript': 'ts',
+    // Frameworks (dot-notation and concatenated forms)
+    'react.js': 'react',
+    'reactjs': 'react',
+    'node.js': 'node',
+    'nodejs': 'node',
+    'vue.js': 'vue',
+    'vuejs': 'vue',
+    'next.js': 'next',
+    'nextjs': 'next',
+    // Container orchestration
+    'kubernetes': 'k8s',
+};
+/**
+ * Pre-sorted synonym keys (longest first) so multi-word synonyms are
+ * matched before their sub-strings.
+ */
+const SORTED_SYNONYM_KEYS = Object.keys(SYNONYMS).sort((a, b) => b.length - a.length);
+/**
+ * Action verb tiers for resume bullet quality assessment.
+ *
+ * - tier1: strong leadership / impact verbs
+ * - tier2: solid, active verbs
+ * - tier3: weak, passive, or vague verbs
+ */
+export const VERB_TIERS = {
+    tier1: [
+        'spearheaded',
+        'orchestrated',
+        'pioneered',
+        'transformed',
+        'revolutionized',
+        'architected',
+        'championed',
+        'negotiated',
+        'overhauled',
+        'launched',
+    ],
+    tier2: [
+        'managed',
+        'developed',
+        'implemented',
+        'designed',
+        'created',
+        'built',
+        'led',
+        'established',
+        'delivered',
+        'improved',
+        'optimized',
+        'reduced',
+        'increased',
+        'automated',
+        'streamlined',
+        'coordinated',
+        'directed',
+        'executed',
+        'analyzed',
+        'resolved',
+    ],
+    tier3: [
+        'helped',
+        'assisted',
+        'participated',
+        'contributed',
+        'supported',
+        'worked',
+        'responsible',
+        'involved',
+        'utilized',
+        'handled',
+    ],
+};
+// ---------------------------------------------------------------------------
+// Stem overrides — fixes for known Porter Stemmer issues
+// ---------------------------------------------------------------------------
+/**
+ * Words where the standard Porter Stemmer produces an incorrect or
+ * unhelpful result. Map from lowercase input to desired stem.
+ */
+const STEM_OVERRIDES = {
+    // Porter strips trailing 's' from '-sis' words yielding '-si'
+    'analysis': 'analysis',
+    'basis': 'basis',
+    'diagnosis': 'diagnosis',
+    'synthesis': 'synthesis',
+    'thesis': 'thesis',
+    'hypothesis': 'hypothesis',
+    'parenthesis': 'parenthesis',
+    'emphasis': 'emphasis',
+    // Keep common tech acronyms intact
+    'aws': 'aws',
+    'gcp': 'gcp',
+    'api': 'api',
+    'apis': 'api',
+    'css': 'css',
+    'sql': 'sql',
+    'html': 'html',
+    'url': 'url',
+    'urls': 'url',
+    // Ensure kubernetes and k8s stem to the same canonical form
+    'kubernetes': 'k8s',
+    'k8s': 'k8s',
+};
+// ---------------------------------------------------------------------------
+// Public functions
+// ---------------------------------------------------------------------------
+/**
+ * Stem a single word using the Porter Stemmer, with overrides for known
+ * problem words. Input is lowercased before stemming.
+ */
+export function stem(word) {
+    const lower = word.toLowerCase();
+    // Check overrides first
+    if (STEM_OVERRIDES[lower] !== undefined) {
+        return STEM_OVERRIDES[lower];
+    }
+    // Short words (<=3 chars) are unlikely to benefit from stemming and
+    // risk being mangled (e.g. "aws" -> "aw").
+    if (lower.length <= 3) {
+        return lower;
+    }
+    return porterStemmer.stem(lower);
+}
+/**
+ * Tokenize text into an array of lowercase word tokens.
+ * Returns an empty array for empty / whitespace-only input.
+ */
+export function tokenize(text) {
+    const lower = text.toLowerCase();
+    const tokens = wordTokenizer.tokenize(lower);
+    return tokens ?? [];
+}
+/**
+ * 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 function normalise(text) {
+    // Lowercase, trim, collapse whitespace
+    let result = text.toLowerCase().trim().replace(/\s+/g, ' ');
+    // Apply synonyms longest-first
+    for (const key of SORTED_SYNONYM_KEYS) {
+        const value = SYNONYMS[key];
+        if (key.includes(' ')) {
+            // Multi-word synonym: simple string replacement
+            result = result.replaceAll(key, value);
+        }
+        else {
+            // Single-word synonym: word-boundary regex to avoid partial matches.
+            // Escape dots in keys like "react.js" for regex safety.
+            const escaped = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const regex = new RegExp(`\\b${escaped}\\b`, 'g');
+            result = result.replace(regex, value);
+        }
+    }
+    // Re-collapse whitespace in case synonym replacement left gaps
+    result = result.trim().replace(/\s+/g, ' ');
+    return result;
+}
+/**
+ * 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 function extractTerms(text) {
+    const normalised = normalise(text);
+    const tokens = tokenize(normalised);
+    // Filter stop words
+    const filtered = tokens.filter((t) => !STOP_WORDS.has(t));
+    const terms = new Set();
+    // Add stemmed unigrams
+    for (const token of filtered) {
+        terms.add(stem(token));
+    }
+    // Add raw bigrams from adjacent filtered tokens
+    for (let i = 0; i < filtered.length - 1; i++) {
+        terms.add(`${filtered[i]} ${filtered[i + 1]}`);
+    }
+    return terms;
+}
+//# sourceMappingURL=text-utils.js.map

package/dist/lib/text-utils.js.map

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

package/dist/lib/types.d.ts

@@ -0,0 +1,31 @@
+export interface ResumeData {
+    rawText: string;
+    bullets: string[];
+    sections: string[];
+}
+export interface ATSResult {
+    score: number;
+    matched: string[];
+    missing: string[];
+    details: {
+        bigramsMatched: string[];
+        unigramsMatched: string[];
+        bigramsMissing: string[];
+        unigramsMissing: string[];
+    };
+}
+export interface ScoreDimension {
+    score: number;
+    weight: number;
+    weightedScore: number;
+}
+export type ScoreMode = 'with-jd' | 'without-jd';
+export interface ResumeScore {
+    total: number;
+    mode: ScoreMode;
+    breakdown: Record<string, ScoreDimension>;
+    ats: ATSResult | null;
+    flags: string[];
+}
+export type VerbTier = 1 | 2 | 3 | null;
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC"}

package/dist/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":""}

package/dist/mcp/server.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MCP server for the Krafter Resume Toolkit.
+ *
+ * Creates a Model Context Protocol server exposing resume scoring tools
+ * over stdio transport. The server registers all scoring tools at startup
+ * and is designed to be extended with additional tool categories (e.g.
+ * Krafter integration tools) in future tasks.
+ *
+ * Usage:
+ *   import { startServer } from './server.js';
+ *   await startServer();
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Create and configure the MCP server with all available tools.
+ *
+ * Scoring tools (score_resume, score_ats) are always registered.
+ * Additional tool categories (e.g. Krafter tools) will be registered
+ * conditionally in future tasks.
+ *
+ * @returns A configured {@link McpServer} instance ready to connect.
+ */
+export declare function createServer(): McpServer;
+/**
+ * Start the MCP server with stdio transport.
+ *
+ * This connects the server to stdin/stdout for communication with
+ * MCP clients (e.g. Claude Desktop, IDE extensions).
+ */
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;;;;;;;GAQG;AACH,wBAAgB,YAAY,IAAI,SAAS,CA0CxC;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD"}

package/dist/mcp/server.js

@@ -0,0 +1,70 @@
+/**
+ * MCP server for the Krafter Resume Toolkit.
+ *
+ * Creates a Model Context Protocol server exposing resume scoring tools
+ * over stdio transport. The server registers all scoring tools at startup
+ * and is designed to be extended with additional tool categories (e.g.
+ * Krafter integration tools) in future tasks.
+ *
+ * Usage:
+ *   import { startServer } from './server.js';
+ *   await startServer();
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { KrafterClient } from '../krafter/client.js';
+import { getScoringTools } from './tools/scoring.js';
+import { getKrafterTools } from './tools/krafter.js';
+/**
+ * Create and configure the MCP server with all available tools.
+ *
+ * Scoring tools (score_resume, score_ats) are always registered.
+ * Additional tool categories (e.g. Krafter tools) will be registered
+ * conditionally in future tasks.
+ *
+ * @returns A configured {@link McpServer} instance ready to connect.
+ */
+export function createServer() {
+    const server = new McpServer({
+        name: 'krafter-toolkit',
+        version: '1.0.0',
+    });
+    // Register scoring tools (always available).
+    // Uses the non-deprecated registerTool API which accepts a config object
+    // with an inputSchema (a Zod shape or full schema).
+    for (const tool of getScoringTools()) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema.shape,
+        }, async (args) => {
+            return tool.handler(args);
+        });
+    }
+    // Register Krafter tools when an API key is configured.
+    const apiKey = process.env['KRAFTER_API_KEY'];
+    if (apiKey) {
+        const baseUrl = process.env['KRAFTER_API_URL'];
+        const client = new KrafterClient(apiKey, baseUrl);
+        for (const tool of getKrafterTools(client)) {
+            server.registerTool(tool.name, {
+                description: tool.description,
+                inputSchema: tool.inputSchema.shape,
+            }, async (args) => {
+                return tool.handler(args);
+            });
+        }
+    }
+    return server;
+}
+/**
+ * Start the MCP server with stdio transport.
+ *
+ * This connects the server to stdin/stdout for communication with
+ * MCP clients (e.g. Claude Desktop, IDE extensions).
+ */
+export async function startServer() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,6CAA6C;IAC7C,yEAAyE;IACzE,oDAAoD;IACpD,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK;SACpC,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;YACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CACF,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC9C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;gBACE,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK;aACpC,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;gBACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/mcp/tools/krafter.d.ts

@@ -0,0 +1,14 @@
+import type { KrafterClient } from '../../krafter/client.js';
+import type { ScoringTool } from './scoring.js';
+/**
+ * Build and return the array of Krafter tool descriptors.
+ *
+ * Each tool wraps a {@link KrafterClient} method with MCP-formatted
+ * error handling. The tools use the same {@link ScoringTool} interface
+ * as the scoring tools so they can be registered uniformly.
+ *
+ * @param client - A configured {@link KrafterClient} instance.
+ * @returns An array of tool descriptors ready for MCP server registration.
+ */
+export declare function getKrafterTools(client: KrafterClient): ScoringTool[];
+//# sourceMappingURL=krafter.d.ts.map

package/dist/mcp/tools/krafter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"krafter.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/krafter.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAgFhD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,EAAE,CAkKpE"}