@getkrafter/resume-toolkit 1.0.1

package/dist/mcp/tools/krafter.js

@@ -0,0 +1,228 @@
+/**
+ * MCP tool handlers for Krafter resume CRUD and scoring.
+ *
+ * Defines 11 tools that wrap {@link KrafterClient} methods with MCP-formatted
+ * error handling. The `score_krafter_resume` tool chains three operations:
+ * fetch resume -> transform to ResumeData -> score.
+ *
+ * All tools return standard MCP {@link CallToolResult} objects. On error,
+ * the result includes `isError: true` with the error message as text content.
+ */
+import { z } from 'zod';
+import { KrafterError } from '../../krafter/errors.js';
+import { toResumeData } from '../../lib/resume-transformer.js';
+import { scoreResume } from '../../lib/resume-scorer.js';
+// ---------------------------------------------------------------------------
+// Error handling
+// ---------------------------------------------------------------------------
+/**
+ * Wrap a handler function with MCP-compatible error handling.
+ *
+ * If the handler throws a {@link KrafterError} (or subclass), the error
+ * message is returned as an MCP error result (`isError: true`). Unexpected
+ * errors are caught the same way so the MCP transport never sees a raw
+ * exception.
+ */
+function withErrorHandling(fn) {
+    return async (args) => {
+        try {
+            return await fn(args);
+        }
+        catch (error) {
+            const message = error instanceof KrafterError
+                ? error.message
+                : error instanceof Error
+                    ? error.message
+                    : 'An unexpected error occurred.';
+            return {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            };
+        }
+    };
+}
+/**
+ * Build a standard success result wrapping the given data as JSON text.
+ */
+function ok(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data) }],
+    };
+}
+// ---------------------------------------------------------------------------
+// Tool descriptions
+// ---------------------------------------------------------------------------
+const DESCRIPTIONS = {
+    get_resume: 'Fetch a single Krafter resume by ID. Returns the full resume object as JSON.',
+    list_resumes: 'List all resumes for the authenticated Krafter user.',
+    create_resume: 'Create a new resume in Krafter. Accepts a data object with resume fields.',
+    update_resume: 'Update an existing Krafter resume. Accepts the resume ID and a data object with fields to update.',
+    delete_resume: 'Delete a Krafter resume by ID.',
+    duplicate_resume: 'Duplicate an existing Krafter resume. Returns the new resume.',
+    update_settings: 'Update resume settings (template, colors, font, etc.). Accepts resume ID and a settings object.',
+    update_section: 'Update a specific resume section (experience, education, skills, etc.). Accepts resume ID, section type, and items array.',
+    list_templates: 'List all available Krafter resume templates.',
+    get_resume_schema: 'Fetch the Krafter resume JSON schema. Useful for understanding the resume data structure.',
+    score_krafter_resume: 'Score a Krafter resume for quality across 5 dimensions (0-100). Fetches the resume by ID, ' +
+        'converts it to scoring format, and runs the deterministic scorer. Optionally accepts a job ' +
+        'description for ATS keyword matching. Returns total score, mode, breakdown per dimension, and diagnostic flags.',
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * 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 function getKrafterTools(client) {
+    return [
+        // -----------------------------------------------------------------
+        // get_resume
+        // -----------------------------------------------------------------
+        {
+            name: 'get_resume',
+            description: DESCRIPTIONS.get_resume,
+            inputSchema: z.object({ id: z.string() }),
+            handler: withErrorHandling(async (args) => {
+                const resume = await client.getResume(args.id);
+                return ok(resume);
+            }),
+        },
+        // -----------------------------------------------------------------
+        // list_resumes
+        // -----------------------------------------------------------------
+        {
+            name: 'list_resumes',
+            description: DESCRIPTIONS.list_resumes,
+            inputSchema: z.object({}),
+            handler: withErrorHandling(async () => {
+                const resumes = await client.listResumes();
+                return ok(resumes);
+            }),
+        },
+        // -----------------------------------------------------------------
+        // create_resume
+        // -----------------------------------------------------------------
+        {
+            name: 'create_resume',
+            description: DESCRIPTIONS.create_resume,
+            inputSchema: z.object({ data: z.record(z.unknown()) }),
+            handler: withErrorHandling(async (args) => {
+                const result = await client.createResume(args.data);
+                return ok(result);
+            }),
+        },
+        // -----------------------------------------------------------------
+        // update_resume
+        // -----------------------------------------------------------------
+        {
+            name: 'update_resume',
+            description: DESCRIPTIONS.update_resume,
+            inputSchema: z.object({ id: z.string(), data: z.record(z.unknown()) }),
+            handler: withErrorHandling(async (args) => {
+                const result = await client.updateResume(args.id, args.data);
+                return ok(result);
+            }),
+        },
+        // -----------------------------------------------------------------
+        // delete_resume
+        // -----------------------------------------------------------------
+        {
+            name: 'delete_resume',
+            description: DESCRIPTIONS.delete_resume,
+            inputSchema: z.object({ id: z.string() }),
+            handler: withErrorHandling(async (args) => {
+                const result = await client.deleteResume(args.id);
+                return ok(result);
+            }),
+        },
+        // -----------------------------------------------------------------
+        // duplicate_resume
+        // -----------------------------------------------------------------
+        {
+            name: 'duplicate_resume',
+            description: DESCRIPTIONS.duplicate_resume,
+            inputSchema: z.object({ id: z.string() }),
+            handler: withErrorHandling(async (args) => {
+                const result = await client.duplicateResume(args.id);
+                return ok(result);
+            }),
+        },
+        // -----------------------------------------------------------------
+        // update_settings
+        // -----------------------------------------------------------------
+        {
+            name: 'update_settings',
+            description: DESCRIPTIONS.update_settings,
+            inputSchema: z.object({ id: z.string(), settings: z.record(z.unknown()) }),
+            handler: withErrorHandling(async (args) => {
+                const result = await client.updateSettings(args.id, args.settings);
+                return ok(result);
+            }),
+        },
+        // -----------------------------------------------------------------
+        // update_section
+        // -----------------------------------------------------------------
+        {
+            name: 'update_section',
+            description: DESCRIPTIONS.update_section,
+            inputSchema: z.object({
+                id: z.string(),
+                type: z.string(),
+                items: z.array(z.unknown()),
+            }),
+            handler: withErrorHandling(async (args) => {
+                const result = await client.updateSection(args.id, args.type, args.items);
+                return ok(result);
+            }),
+        },
+        // -----------------------------------------------------------------
+        // list_templates
+        // -----------------------------------------------------------------
+        {
+            name: 'list_templates',
+            description: DESCRIPTIONS.list_templates,
+            inputSchema: z.object({}),
+            handler: withErrorHandling(async () => {
+                const templates = await client.listTemplates();
+                return ok(templates);
+            }),
+        },
+        // -----------------------------------------------------------------
+        // get_resume_schema
+        // -----------------------------------------------------------------
+        {
+            name: 'get_resume_schema',
+            description: DESCRIPTIONS.get_resume_schema,
+            inputSchema: z.object({}),
+            handler: withErrorHandling(async () => {
+                const schema = await client.getResumeSchema();
+                return ok(schema);
+            }),
+        },
+        // -----------------------------------------------------------------
+        // score_krafter_resume
+        // -----------------------------------------------------------------
+        {
+            name: 'score_krafter_resume',
+            description: DESCRIPTIONS.score_krafter_resume,
+            inputSchema: z.object({
+                id: z.string(),
+                jdText: z.string().optional(),
+            }),
+            handler: withErrorHandling(async (args) => {
+                const resume = await client.getResume(args.id);
+                const resumeData = toResumeData(resume);
+                const score = scoreResume(resumeData, args.jdText);
+                return ok(score);
+            }),
+        },
+    ];
+}
+//# sourceMappingURL=krafter.js.map

package/dist/mcp/tools/krafter.js.map

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

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

@@ -0,0 +1,46 @@
+/**
+ * MCP tool handlers for resume scoring.
+ *
+ * Defines two tools:
+ *   - score_resume: Full multi-dimensional resume quality score (0-100)
+ *   - score_ats: Focused ATS keyword-match score against a job description
+ *
+ * Each tool accepts raw text input, parses it into the internal ResumeData
+ * format, and delegates to the deterministic scoring engine.
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { ResumeData } from '../../lib/types.js';
+/**
+ * Descriptor for a scoring tool: its name, description, Zod input schema,
+ * and async handler function that returns a standard MCP CallToolResult.
+ */
+export interface ScoringTool {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<any>;
+    handler: (args: any) => Promise<CallToolResult>;
+}
+/**
+ * Parse raw pasted resume text into the internal {@link ResumeData} format.
+ *
+ * Detection strategy:
+ * 1. Split into lines.
+ * 2. Lines matching {@link BULLET_RE} are extracted as bullets (marker stripped).
+ * 3. Short, non-bullet lines that are ALL CAPS or Title Case are treated as
+ *    section headings.
+ * 4. Lines that are neither bullets nor headings are ignored (they may be
+ *    paragraph text, contact info, etc.).
+ *
+ * @param text - Raw resume text, typically pasted by the user.
+ * @returns A {@link ResumeData} object with rawText, bullets, and sections.
+ */
+export declare function parseRawText(text: string): ResumeData;
+/**
+ * Build and return the array of scoring tool descriptors.
+ *
+ * Each tool's handler accepts parsed arguments and returns a standard
+ * MCP result with a single text content block containing JSON.
+ */
+export declare function getScoringTools(): ScoringTool[];
+//# sourceMappingURL=scoring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQrD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACjD;AA6BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAwBrD;AAiBD;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,WAAW,EAAE,CAuD/C"}

package/dist/mcp/tools/scoring.js

@@ -0,0 +1,135 @@
+/**
+ * MCP tool handlers for resume scoring.
+ *
+ * Defines two tools:
+ *   - score_resume: Full multi-dimensional resume quality score (0-100)
+ *   - score_ats: Focused ATS keyword-match score against a job description
+ *
+ * Each tool accepts raw text input, parses it into the internal ResumeData
+ * format, and delegates to the deterministic scoring engine.
+ */
+import { z } from 'zod';
+import { scoreResume } from '../../lib/resume-scorer.js';
+import { scoreATS } from '../../lib/ats-scorer.js';
+// ---------------------------------------------------------------------------
+// Bullet / section detection patterns
+// ---------------------------------------------------------------------------
+/**
+ * Matches lines that start with common bullet markers:
+ *   - dash (-)
+ *   - bullet character (bullet)
+ *   - asterisk (*)
+ *   - numbered list (1., 2., etc.)
+ *
+ * Allows optional leading whitespace.
+ */
+const BULLET_RE = /^\s*(?:[-\u2022*]|\d+[.)]\s)/;
+/**
+ * Matches lines that look like section headings:
+ *   - ALL CAPS words (2+ chars, possibly with spaces)
+ *   - Title Case lines that are short (under 50 chars) and not bullet-like
+ */
+const HEADING_ALLCAPS_RE = /^[A-Z][A-Z &/]+$/;
+const HEADING_TITLECASE_RE = /^[A-Z][a-z]+(?:\s+[A-Z][a-z]+)*$/;
+// ---------------------------------------------------------------------------
+// parseRawText
+// ---------------------------------------------------------------------------
+/**
+ * Parse raw pasted resume text into the internal {@link ResumeData} format.
+ *
+ * Detection strategy:
+ * 1. Split into lines.
+ * 2. Lines matching {@link BULLET_RE} are extracted as bullets (marker stripped).
+ * 3. Short, non-bullet lines that are ALL CAPS or Title Case are treated as
+ *    section headings.
+ * 4. Lines that are neither bullets nor headings are ignored (they may be
+ *    paragraph text, contact info, etc.).
+ *
+ * @param text - Raw resume text, typically pasted by the user.
+ * @returns A {@link ResumeData} object with rawText, bullets, and sections.
+ */
+export function parseRawText(text) {
+    const lines = text.split('\n');
+    const bullets = [];
+    const sections = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        if (BULLET_RE.test(trimmed)) {
+            // Strip the bullet marker to get the pure bullet text
+            const bulletText = trimmed.replace(/^\s*(?:[-\u2022*]|\d+[.)]\s?)\s*/, '').trim();
+            if (bulletText) {
+                bullets.push(bulletText);
+            }
+        }
+        else if (trimmed.length < 50 &&
+            (HEADING_ALLCAPS_RE.test(trimmed) || HEADING_TITLECASE_RE.test(trimmed))) {
+            sections.push(trimmed);
+        }
+    }
+    return { rawText: text, bullets, sections };
+}
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+const SCORE_RESUME_DESCRIPTION = 'Score a resume for quality across 5 dimensions (0-100). Deterministic — same input always produces the same score. ' +
+    'The result includes: total score, mode (with-jd or without-jd), breakdown per dimension ' +
+    '(quantification, verb strength, ATS match, bullet structure, section completeness), and diagnostic flags. ' +
+    'Your role: explain what each dimension means for THIS resume, give specific actionable suggestions for low-scoring dimensions, ' +
+    'highlight top 5 missing keywords if ATS match is low, and frame the score constructively.';
+const SCORE_ATS_DESCRIPTION = 'Score resume-to-job-description keyword match (0-100). Returns matched keywords, missing keywords, ' +
+    'and bigram/unigram breakdown. Use this for focused ATS analysis without the full resume quality score.';
+/**
+ * Build and return the array of scoring tool descriptors.
+ *
+ * Each tool's handler accepts parsed arguments and returns a standard
+ * MCP result with a single text content block containing JSON.
+ */
+export function getScoringTools() {
+    // -----------------------------------------------------------------------
+    // Tool 1: score_resume
+    // -----------------------------------------------------------------------
+    const scoreResumeSchema = z.object({
+        resumeText: z.string(),
+        jdText: z.string().optional(),
+    });
+    const scoreResumeHandler = async (args) => {
+        const resumeData = parseRawText(args.resumeText);
+        const result = scoreResume(resumeData, args.jdText);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+        };
+    };
+    // -----------------------------------------------------------------------
+    // Tool 2: score_ats
+    // -----------------------------------------------------------------------
+    const scoreAtsSchema = z.object({
+        resumeText: z.string(),
+        jdText: z.string(),
+    });
+    const scoreAtsHandler = async (args) => {
+        const result = scoreATS(args.resumeText, args.jdText);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+        };
+    };
+    // -----------------------------------------------------------------------
+    // Return tool array
+    // -----------------------------------------------------------------------
+    return [
+        {
+            name: 'score_resume',
+            description: SCORE_RESUME_DESCRIPTION,
+            inputSchema: scoreResumeSchema,
+            handler: scoreResumeHandler,
+        },
+        {
+            name: 'score_ats',
+            description: SCORE_ATS_DESCRIPTION,
+            inputSchema: scoreAtsSchema,
+            handler: scoreAtsHandler,
+        },
+    ];
+}
+//# sourceMappingURL=scoring.js.map

package/dist/mcp/tools/scoring.js.map

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

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@getkrafter/resume-toolkit",
+  "version": "1.0.1",
+  "description": "Deterministic resume scoring, ATS keyword matching, and AI-powered resume tailoring",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/lib/index.js",
+      "types": "./dist/lib/index.d.ts"
+    }
+  },
+  "bin": {
+    "resume-toolkit": "dist/bin/cli.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "resume",
+    "ats",
+    "scoring",
+    "mcp",
+    "ai",
+    "skills",
+    "tailoring"
+  ],
+  "author": "Muhammad Kasim",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/getkrafter/resume-toolkit.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "natural": "^8.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.0.0",
+    "@commitlint/config-conventional": "^19.0.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.6",
+    "@semantic-release/npm": "^13.1.5",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "husky": "^9.0.0",
+    "semantic-release": "^25.0.3",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}