@getkrafter/resume-toolkit 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Muhammad Kasim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,155 @@
+# @getkrafter/resume-toolkit
+
+Deterministic resume scoring, ATS keyword matching, and AI-powered resume tailoring. Works as an MCP server, a scoring library, and AI skills for Claude Code, Cursor, and Windsurf.
+
+**Same input always produces the same score.** The AI handles parsing and explanation — the scoring is pure math.
+
+## Quick Start — Skills (no account needed)
+
+### Claude Code
+
+```bash
+/install-skill @getkrafter/resume-toolkit
+```
+
+Then use `/score` or `/tailor` in any conversation.
+
+### Cursor
+
+Add to Settings → Remote Rule:
+
+```
+https://github.com/getkrafter/resume-toolkit/blob/master/skills/score/SKILL.md
+https://github.com/getkrafter/resume-toolkit/blob/master/skills/tailor/SKILL.md
+```
+
+Or copy the `skills/` directory to `.cursor/skills/` in your project.
+
+### Windsurf
+
+Copy the `skills/` directory to `.windsurf/skills/` or `.agents/skills/` in your project.
+
+## Quick Start — MCP Server
+
+### Without API key (scoring tools only)
+
+```json
+{
+  "mcpServers": {
+    "krafter": {
+      "command": "npx",
+      "args": ["@getkrafter/resume-toolkit"]
+    }
+  }
+}
+```
+
+### With API key (scoring + Krafter CRUD)
+
+```json
+{
+  "mcpServers": {
+    "krafter": {
+      "command": "npx",
+      "args": ["@getkrafter/resume-toolkit"],
+      "env": {
+        "KRAFTER_API_KEY": "sk-your-key-here"
+      }
+    }
+  }
+}
+```
+
+Generate an API key at [krafter.app](https://krafter.app) → Settings → AI Integrations.
+
+## Library Usage
+
+```bash
+npm install @getkrafter/resume-toolkit
+```
+
+```typescript
+import { scoreResume, scoreATS, toResumeData } from '@getkrafter/resume-toolkit';
+
+// Score a resume
+const result = scoreResume(
+  { rawText: '...', bullets: ['...'], sections: ['experience', 'skills'] },
+  'Job description text...' // optional
+);
+
+console.log(result.total);     // 0-100
+console.log(result.mode);      // 'with-jd' or 'without-jd'
+console.log(result.breakdown); // per-dimension scores
+console.log(result.flags);     // diagnostic messages
+
+// ATS keyword match only
+const ats = scoreATS(resumeText, jdText);
+console.log(ats?.matched);  // keywords found
+console.log(ats?.missing);  // keywords missing
+
+// Convert Krafter resume object to scoreable format
+const resumeData = toResumeData(krafterResumeObject);
+```
+
+## MCP Tools
+
+### Public (no auth)
+
+| Tool | Description |
+|---|---|
+| `score_resume` | Full quality score (0-100) across 5 dimensions with breakdown and flags |
+| `score_ats` | ATS keyword match with bigram/unigram analysis |
+
+### Krafter (API key required)
+
+| Tool | Description |
+|---|---|
+| `score_krafter_resume` | Fetch resume from Krafter → score in one call |
+| `get_resume` | Fetch a resume by ID |
+| `list_resumes` | List all your resumes |
+| `create_resume` | Create a new resume |
+| `update_resume` | Update an existing resume |
+| `delete_resume` | Delete a resume |
+| `duplicate_resume` | Clone a resume |
+| `update_settings` | Update visual settings |
+| `update_section` | Update a specific section |
+| `list_templates` | List available templates |
+| `get_resume_schema` | Get the resume data schema |
+
+## Skills
+
+| Skill | Description |
+|---|---|
+| `/score` | Guided resume scoring — paste or provide a resume, optionally add a JD, get a detailed score breakdown with actionable advice |
+| `/tailor` | Gap analysis against a JD — identifies missing keywords, suggests truth-preserving rewrites with before/after format |
+
+## Scoring Dimensions
+
+| Dimension | Weight (with JD) | What it measures |
+|---|---|---|
+| Quantification | 25% | Fraction of bullets with numbers/metrics |
+| Verb Strength | 20% | Quality of action verbs (tier1 > tier2 > tier3) |
+| ATS Match | 30% | Keyword overlap with job description |
+| Bullet Structure | 15% | Verb + number + detail pattern |
+| Section Completeness | 10% | Presence of expected resume sections |
+
+When no JD is provided, the 30% ATS weight redistributes proportionally across the other dimensions.
+
+## Contributing
+
+```bash
+git clone https://github.com/getkrafter/resume-toolkit.git
+cd resume-toolkit
+npm install
+npm test        # run tests
+npm run build   # compile TypeScript
+```
+
+Commits follow [Conventional Commits](https://www.conventionalcommits.org/):
+- `feat: ...` → minor version bump
+- `fix: ...` → patch version bump
+- `feat!: ...` → major version bump
+
+## License
+
+MIT

package/dist/bin/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":""}

package/dist/bin/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { startServer } from '../mcp/server.js';
+startServer();
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,WAAW,EAAE,CAAC"}

package/dist/krafter/client.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Thin HTTP client wrapping Krafter's `/api/mcp` tool-call endpoint.
+ *
+ * Every public method delegates to {@link callTool} which handles
+ * authentication, timeout, and error mapping so callers get
+ * strongly-typed errors they can pattern-match on.
+ */
+export declare class KrafterClient {
+    private apiKey;
+    private baseUrl;
+    private schemaCache;
+    constructor(apiKey: string, baseUrl?: string);
+    /** Fetch a single resume by id. */
+    getResume(id: string): Promise<unknown>;
+    /** List all resumes for the authenticated user. */
+    listResumes(): Promise<unknown>;
+    /** Create a new resume. */
+    createResume(data: unknown): Promise<unknown>;
+    /** Update an existing resume. */
+    updateResume(id: string, data: unknown): Promise<unknown>;
+    /** Delete a resume. */
+    deleteResume(id: string): Promise<unknown>;
+    /** Duplicate a resume. */
+    duplicateResume(id: string): Promise<unknown>;
+    /** Update resume settings (template, colors, etc.). */
+    updateSettings(id: string, settings: unknown): Promise<unknown>;
+    /** Update a specific resume section (experience, education, etc.). */
+    updateSection(id: string, type: string, items: unknown[]): Promise<unknown>;
+    /** List available templates. */
+    listTemplates(): Promise<unknown>;
+    /**
+     * Fetch the resume JSON schema.
+     *
+     * The schema is cached after the first successful call because it
+     * doesn't change during a client's lifetime.
+     */
+    getResumeSchema(): Promise<unknown>;
+    /**
+     * Execute a single tool call against the Krafter MCP endpoint.
+     *
+     * Handles:
+     * - Bearer authentication
+     * - 10-second timeout via AbortSignal
+     * - HTTP status → typed error mapping
+     * - Network / timeout errors → KrafterNetworkError
+     */
+    private callTool;
+    /**
+     * Map an HTTP error status code to the appropriate typed error.
+     * Always throws — the return type is `never`.
+     */
+    private throwForStatus;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/krafter/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/krafter/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAwB;gBAE/B,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAS5C,mCAAmC;IAC7B,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7C,mDAAmD;IAC7C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC,2BAA2B;IACrB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD,iCAAiC;IAC3B,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D,uBAAuB;IACjB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD,0BAA0B;IACpB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD,uDAAuD;IACjD,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrE,sEAAsE;IAChE,aAAa,CACjB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EAAE,GACf,OAAO,CAAC,OAAO,CAAC;IAInB,gCAAgC;IAC1B,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAIvC;;;;;OAKG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAczC;;;;;;;;OAQG;YACW,QAAQ;IA8BtB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAiBvB"}

package/dist/krafter/client.js

@@ -0,0 +1,130 @@
+/**
+ * Thin HTTP client wrapping Krafter's `/api/mcp` tool-call endpoint.
+ *
+ * Every public method delegates to {@link callTool} which handles
+ * authentication, timeout, and error mapping so callers get
+ * strongly-typed errors they can pattern-match on.
+ */
+import { KrafterAuthError, KrafterNetworkError, KrafterNotFoundError, KrafterRateLimitError, KrafterServerError, } from './errors.js';
+/** Default request timeout in milliseconds. */
+const REQUEST_TIMEOUT_MS = 10_000;
+export class KrafterClient {
+    apiKey;
+    baseUrl;
+    schemaCache = null;
+    constructor(apiKey, baseUrl) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl ?? 'https://krafter.app';
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    /** Fetch a single resume by id. */
+    async getResume(id) {
+        return this.callTool('get_resume', { id });
+    }
+    /** List all resumes for the authenticated user. */
+    async listResumes() {
+        return this.callTool('list_resumes', {});
+    }
+    /** Create a new resume. */
+    async createResume(data) {
+        return this.callTool('create_resume', { data });
+    }
+    /** Update an existing resume. */
+    async updateResume(id, data) {
+        return this.callTool('update_resume', { id, data });
+    }
+    /** Delete a resume. */
+    async deleteResume(id) {
+        return this.callTool('delete_resume', { id });
+    }
+    /** Duplicate a resume. */
+    async duplicateResume(id) {
+        return this.callTool('duplicate_resume', { id });
+    }
+    /** Update resume settings (template, colors, etc.). */
+    async updateSettings(id, settings) {
+        return this.callTool('update_settings', { id, settings });
+    }
+    /** Update a specific resume section (experience, education, etc.). */
+    async updateSection(id, type, items) {
+        return this.callTool('update_section', { id, type, items });
+    }
+    /** List available templates. */
+    async listTemplates() {
+        return this.callTool('list_templates', {});
+    }
+    /**
+     * Fetch the resume JSON schema.
+     *
+     * The schema is cached after the first successful call because it
+     * doesn't change during a client's lifetime.
+     */
+    async getResumeSchema() {
+        if (this.schemaCache !== null) {
+            return this.schemaCache;
+        }
+        const schema = await this.callTool('get_resume_schema', {});
+        this.schemaCache = schema;
+        return schema;
+    }
+    // ---------------------------------------------------------------------------
+    // Internals
+    // ---------------------------------------------------------------------------
+    /**
+     * Execute a single tool call against the Krafter MCP endpoint.
+     *
+     * Handles:
+     * - Bearer authentication
+     * - 10-second timeout via AbortSignal
+     * - HTTP status → typed error mapping
+     * - Network / timeout errors → KrafterNetworkError
+     */
+    async callTool(tool, args) {
+        const url = `${this.baseUrl}/api/mcp`;
+        let response;
+        try {
+            response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ tool, args }),
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+        }
+        catch {
+            // Network failures and AbortError (timeout) both land here.
+            throw new KrafterNetworkError();
+        }
+        if (!response.ok) {
+            this.throwForStatus(response.status);
+        }
+        const json = (await response.json());
+        return json.result;
+    }
+    /**
+     * Map an HTTP error status code to the appropriate typed error.
+     * Always throws — the return type is `never`.
+     */
+    throwForStatus(status) {
+        switch (status) {
+            case 401:
+                throw new KrafterAuthError();
+            case 404:
+                throw new KrafterNotFoundError();
+            case 429:
+                throw new KrafterRateLimitError();
+            default:
+                // Treat any 5xx (or unexpected status) as a server error.
+                if (status >= 500) {
+                    throw new KrafterServerError();
+                }
+                // Fallback for unexpected 4xx codes we don't have a class for.
+                throw new KrafterServerError();
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/krafter/client.js.map

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

package/dist/krafter/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Typed error classes for the Krafter HTTP client.
+ *
+ * Each error maps to a specific HTTP failure mode so callers can
+ * pattern-match on the class (instanceof) or inspect `statusCode`.
+ */
+export declare class KrafterError extends Error {
+    statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
+export declare class KrafterAuthError extends KrafterError {
+    constructor();
+}
+export declare class KrafterNotFoundError extends KrafterError {
+    constructor();
+}
+export declare class KrafterServerError extends KrafterError {
+    constructor();
+}
+export declare class KrafterRateLimitError extends KrafterError {
+    constructor();
+}
+export declare class KrafterNetworkError extends KrafterError {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/krafter/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/krafter/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,YAAa,SAAQ,KAAK;IAG5B,UAAU,CAAC,EAAE,MAAM;gBAD1B,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA;CAK7B;AAED,qBAAa,gBAAiB,SAAQ,YAAY;;CAQjD;AAED,qBAAa,oBAAqB,SAAQ,YAAY;;CAKrD;AAED,qBAAa,kBAAmB,SAAQ,YAAY;;CAKnD;AAED,qBAAa,qBAAsB,SAAQ,YAAY;;CAKtD;AAED,qBAAa,mBAAoB,SAAQ,YAAY;;CAKpD"}

package/dist/krafter/errors.js

@@ -0,0 +1,45 @@
+/**
+ * Typed error classes for the Krafter HTTP client.
+ *
+ * Each error maps to a specific HTTP failure mode so callers can
+ * pattern-match on the class (instanceof) or inspect `statusCode`.
+ */
+export class KrafterError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'KrafterError';
+    }
+}
+export class KrafterAuthError extends KrafterError {
+    constructor() {
+        super('Invalid API key. Generate one at krafter.app → Settings → AI Integrations.', 401);
+        this.name = 'KrafterAuthError';
+    }
+}
+export class KrafterNotFoundError extends KrafterError {
+    constructor() {
+        super('Resume not found. It may have been deleted.', 404);
+        this.name = 'KrafterNotFoundError';
+    }
+}
+export class KrafterServerError extends KrafterError {
+    constructor() {
+        super('Krafter service error. Try again shortly.', 500);
+        this.name = 'KrafterServerError';
+    }
+}
+export class KrafterRateLimitError extends KrafterError {
+    constructor() {
+        super('Too many requests. Please wait a moment.', 429);
+        this.name = 'KrafterRateLimitError';
+    }
+}
+export class KrafterNetworkError extends KrafterError {
+    constructor() {
+        super('Unable to reach Krafter. Check your connection or try again.');
+        this.name = 'KrafterNetworkError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/krafter/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/krafter/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAG5B;IAFT,YACE,OAAe,EACR,UAAmB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,eAAU,GAAV,UAAU,CAAS;QAG1B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChD;QACE,KAAK,CACH,4EAA4E,EAC5E,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD;QACE,KAAK,CAAC,6CAA6C,EAAE,GAAG,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD;QACE,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IACrD;QACE,KAAK,CAAC,0CAA0C,EAAE,GAAG,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnD;QACE,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/lib/ats-scorer.d.ts

@@ -0,0 +1,12 @@
+import type { ATSResult } from './types.js';
+/**
+ * Score a resume against a job description for ATS keyword match.
+ *
+ * Uses bigram + stemmed unigram matching with weighted scoring:
+ * - Bigram match = 1.5 points
+ * - Unigram match = 1.0 point
+ *
+ * Returns null if jdText is falsy (no JD provided).
+ */
+export declare function scoreATS(resumeText: string, jdText: string): ATSResult | null;
+//# sourceMappingURL=ats-scorer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ats-scorer.d.ts","sourceRoot":"","sources":["../../src/lib/ats-scorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAiF7E"}

package/dist/lib/ats-scorer.js

@@ -0,0 +1,83 @@
+import { stem, extractTerms } from './text-utils.js';
+/**
+ * Score a resume against a job description for ATS keyword match.
+ *
+ * Uses bigram + stemmed unigram matching with weighted scoring:
+ * - Bigram match = 1.5 points
+ * - Unigram match = 1.0 point
+ *
+ * Returns null if jdText is falsy (no JD provided).
+ */
+export function scoreATS(resumeText, jdText) {
+    if (!jdText)
+        return null;
+    const resumeTerms = extractTerms(resumeText);
+    const jdTerms = extractTerms(jdText);
+    // Separate JD terms into bigrams and unigrams
+    const jdBigrams = [];
+    const jdUnigrams = [];
+    for (const term of jdTerms) {
+        if (term.includes(' ')) {
+            jdBigrams.push(term);
+        }
+        else {
+            jdUnigrams.push(term);
+        }
+    }
+    // Match bigrams
+    const bigramsMatched = [];
+    const bigramsMissing = [];
+    for (const bigram of jdBigrams) {
+        if (resumeTerms.has(bigram)) {
+            bigramsMatched.push(bigram);
+        }
+        else {
+            // Fallback: check if both unigrams in the bigram match individually
+            const parts = bigram.split(' ');
+            const bothMatch = parts.every((part) => resumeTerms.has(stem(part)));
+            if (bothMatch) {
+                bigramsMatched.push(bigram);
+            }
+            else {
+                bigramsMissing.push(bigram);
+            }
+        }
+    }
+    // Match unigrams (stemmed)
+    const unigramsMatched = [];
+    const unigramsMissing = [];
+    // Track which stemmed resume unigrams we have for unigram matching
+    const resumeUnigrams = new Set();
+    for (const term of resumeTerms) {
+        if (!term.includes(' ')) {
+            resumeUnigrams.add(term);
+        }
+    }
+    for (const unigram of jdUnigrams) {
+        if (resumeUnigrams.has(unigram)) {
+            unigramsMatched.push(unigram);
+        }
+        else {
+            unigramsMissing.push(unigram);
+        }
+    }
+    // Weighted scoring: bigram = 1.5, unigram = 1.0
+    const totalPoints = jdBigrams.length * 1.5 + jdUnigrams.length * 1.0;
+    const earnedPoints = bigramsMatched.length * 1.5 + unigramsMatched.length * 1.0;
+    const score = totalPoints === 0 ? 0 : Math.round((earnedPoints / totalPoints) * 100);
+    // Build human-readable matched/missing lists
+    const matched = [...bigramsMatched, ...unigramsMatched];
+    const missing = [...bigramsMissing, ...unigramsMissing];
+    return {
+        score,
+        matched,
+        missing,
+        details: {
+            bigramsMatched,
+            unigramsMatched,
+            bigramsMissing,
+            unigramsMissing,
+        },
+    };
+}
+//# sourceMappingURL=ats-scorer.js.map

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

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

package/dist/lib/index.d.ts

@@ -0,0 +1,6 @@
+export { scoreATS } from './ats-scorer.js';
+export { scoreResume, getVerbTier } from './resume-scorer.js';
+export { toResumeData } from './resume-transformer.js';
+export type { ResumeData, ATSResult, ResumeScore, ScoreDimension, ScoreMode, VerbTier, } from './types.js';
+export { stem, tokenize, normalise, extractTerms } from './text-utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,cAAc,EACd,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/lib/index.js

@@ -0,0 +1,8 @@
+// Stable public API — covered by semver guarantees
+export { scoreATS } from './ats-scorer.js';
+export { scoreResume, getVerbTier } from './resume-scorer.js';
+export { toResumeData } from './resume-transformer.js';
+// Internal utilities — NOT part of the stable API, may change in minor versions
+// Exported for advanced consumers who accept the risk
+export { stem, tokenize, normalise, extractTerms } from './text-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAUvD,gFAAgF;AAChF,sDAAsD;AACtD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,62 @@
+/**
+ * Resume scoring engine.
+ *
+ * Provides a deterministic, multi-dimensional resume score composed of
+ * five sub-scorers: quantification, verb strength, bullet structure,
+ * section completeness, and ATS keyword matching.
+ *
+ * Main export: `scoreResume(resumeData, jdText?)` returns a `ResumeScore`.
+ */
+import type { ResumeData, ResumeScore, VerbTier } from './types.js';
+/**
+ * Fraction of bullets that contain at least one number or metric.
+ * Returns 0-100. Returns 0 for empty bullets array.
+ */
+export declare function scoreQuantification(bullets: string[]): number;
+/**
+ * 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 declare function getVerbTier(bullet: string): VerbTier;
+/**
+ * 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 declare function scoreVerbStrength(bullets: string[]): number;
+/**
+ * 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 declare function scoreBulletStructure(bullets: string[]): number;
+/**
+ * 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 declare function scoreSectionCompleteness(sections: string[]): number;
+/**
+ * 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 declare function scoreResume(resumeData: ResumeData, jdText?: string): ResumeScore;
+//# sourceMappingURL=resume-scorer.d.ts.map