@getkrafter/resume-toolkit 1.0.4 → 1.1.0

package/dist/bin/cli.js

@@ -1,4 +1,61 @@
 #!/usr/bin/env node
 import { startServer } from '../mcp/server.js';
-startServer();
+import { scoreResume } from '../lib/resume-scorer.js';
+import { scoreATS } from '../lib/ats-scorer.js';
+const args = process.argv.slice(2);
+const command = args[0];
+if (command === 'score') {
+    const resumeFile = getFlag(args, '--resume');
+    const jdFile = getFlag(args, '--jd');
+    if (!resumeFile) {
+        console.error('Usage: resume-toolkit score --resume <file> [--jd <file>]');
+        process.exit(1);
+    }
+    const fs = await import('node:fs');
+    const resumeText = fs.readFileSync(resumeFile, 'utf-8');
+    const jdText = jdFile ? fs.readFileSync(jdFile, 'utf-8') : undefined;
+    const resumeData = parseRawText(resumeText);
+    const result = scoreResume(resumeData, jdText);
+    console.log(JSON.stringify(result, null, 2));
+}
+else if (command === 'ats') {
+    const resumeFile = getFlag(args, '--resume');
+    const jdFile = getFlag(args, '--jd');
+    if (!resumeFile || !jdFile) {
+        console.error('Usage: resume-toolkit ats --resume <file> --jd <file>');
+        process.exit(1);
+    }
+    const fs = await import('node:fs');
+    const resumeText = fs.readFileSync(resumeFile, 'utf-8');
+    const jdText = fs.readFileSync(jdFile, 'utf-8');
+    const result = scoreATS(resumeText, jdText);
+    console.log(JSON.stringify(result, null, 2));
+}
+else {
+    // Default: start MCP server
+    startServer();
+}
+function getFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
+}
+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 (/^\s*[-*•]\s+/.test(line) || /^\s*\d+[.)]\s+/.test(line)) {
+            bullets.push(trimmed.replace(/^[-*•]\s+/, '').replace(/^\d+[.)]\s+/, ''));
+        }
+        else if (trimmed.length < 50 &&
+            (trimmed === trimmed.toUpperCase() || /^[A-Z][a-z]/.test(trimmed)) &&
+            !/^\s*[-*•]|\d+[.)]/.test(trimmed)) {
+            sections.push(trimmed.toLowerCase());
+        }
+    }
+    return { rawText: text, bullets, sections };
+}
 //# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getkrafter/resume-toolkit",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "Deterministic resume scoring, ATS keyword matching, and AI-powered resume tailoring",
   "type": "module",
   "exports": {

package/skills/score/SKILL.md

@@ -69,9 +69,11 @@ You do NOT need to do this manually. The `score_resume` MCP tool handles parsing
 
 ---
 
-## Step 5 — Call the Scoring Tool
+## Step 5 — Score the Resume
 
-**Standard path** (pasted text or file):
+Choose the method that matches your environment:
+
+**Option A — MCP tools available** (user has the MCP server configured):
 
 Call the `score_resume` MCP tool:
 ```json
@@ -81,9 +83,7 @@ Call the `score_resume` MCP tool:
 }
 ```
 
-**Krafter path** (user selected a Krafter resume):
-
-Call the `score_krafter_resume` MCP tool:
+Or for Krafter resumes, call `score_krafter_resume`:
 ```json
 {
   "id": "<the resume ID from list_resumes>",
@@ -91,6 +91,22 @@ Call the `score_krafter_resume` MCP tool:
 }
 ```
 
+**Option B — CLI** (no MCP server needed):
+
+1. Write the resume text to a temp file (e.g., `/tmp/resume.txt`).
+2. If a JD was provided, write it to another temp file (e.g., `/tmp/jd.txt`).
+3. Run:
+
+```bash
+# Without JD:
+npx @getkrafter/resume-toolkit score --resume /tmp/resume.txt
+
+# With JD:
+npx @getkrafter/resume-toolkit score --resume /tmp/resume.txt --jd /tmp/jd.txt
+```
+
+The output is a JSON `ResumeScore` object. Parse it and present results per Step 6.
+
 ---
 
 ## Step 6 — Present the Results

package/skills/tailor/SKILL.md

@@ -56,27 +56,31 @@ transformation internally via `toResumeData`.
 
 ### Step 4 -- Run Scoring Tools
 
-Run **both** scoring tools to get the full picture:
+Run **both** scoring tools to get the full picture. Choose the method that matches your environment:
 
-**For pasted/file resumes:**
+**Option A — MCP tools available** (user has the MCP server configured):
 
-1. `score_ats` with `{ resumeText, jdText }` -- returns `ATSResult` with:
-   - `score` (0-100)
-   - `matched` keywords (array)
-   - `missing` keywords (array)
-   - `details.bigramsMatched`, `details.unigramsMatched`, `details.bigramsMissing`, `details.unigramsMissing`
+For pasted/file resumes:
+1. `score_ats` with `{ resumeText, jdText }` -- returns `ATSResult` with `score`, `matched`, `missing`, and `details` breakdown.
+2. `score_resume` with `{ resumeText, jdText }` -- returns `ResumeScore` with `total`, `mode`, `breakdown`, `ats`, and `flags`.
 
-2. `score_resume` with `{ resumeText, jdText }` -- returns `ResumeScore` with:
-   - `total` (0-100)
-   - `mode` ("with-jd")
-   - `breakdown` per dimension (quantification, verbStrength, ats, bulletStructure, sectionCompleteness)
-   - `ats` (embedded ATSResult)
-   - `flags` (diagnostic messages)
+For Krafter resumes:
+1. `score_krafter_resume` with `{ id, jdText }` -- returns the full `ResumeScore` including the embedded `ATSResult`.
 
-**For Krafter resumes:**
+**Option B — CLI** (no MCP server needed):
 
-1. `score_krafter_resume` with `{ id, jdText }` -- returns the full `ResumeScore` including the embedded `ATSResult`.
-2. Optionally also call `score_ats` directly if you need the standalone ATS breakdown.
+1. Write the resume text to `/tmp/resume.txt` and the JD to `/tmp/jd.txt`.
+2. Run both commands:
+
+```bash
+# Full score with ATS:
+npx @getkrafter/resume-toolkit score --resume /tmp/resume.txt --jd /tmp/jd.txt
+
+# Standalone ATS analysis:
+npx @getkrafter/resume-toolkit ats --resume /tmp/resume.txt --jd /tmp/jd.txt
+```
+
+Parse the JSON output from each command and continue to Step 5.
 
 ### Step 5 -- Gap Analysis