resuml 1.21.0 → 3.0.0

package/dist/index.js

@@ -1,30 +1,98 @@
 #!/usr/bin/env node
-import {
-  loadResumeFiles
-} from "./chunk-4ZOTZUAW.js";
 import {
   KNOWN_THEMES,
+  __export,
+  analyzeAts,
   generateResumeYaml,
   getInstalledVersion,
-  isThemeInstalled
-} from "./chunk-JP7UCR3P.js";
-import {
-  analyzeAts,
+  getRubricEntry,
+  isThemeInstalled,
+  listRubricMarkdown,
+  loadConfig,
+  loadTheme,
   processResumeData
-} from "./chunk-KRJMZ2RQ.js";
-import {
-  __export,
-  loadTheme
-} from "./chunk-ZLA7NFYP.js";
+} from "./chunk-R4MD5YMV.js";
 
 // src/index.ts
 import { Command } from "commander";
-import path5 from "path";
-import fs7 from "fs";
+import path6 from "path";
+import fs9 from "fs";
 import { fileURLToPath } from "url";
 
 // src/commands/validate.ts
-import fs from "fs";
+import fs3 from "fs";
+
+// src/utils/loadResume.ts
+import fs2 from "fs/promises";
+import YAML from "yaml";
+
+// src/utils/fileUtils.ts
+import fs from "fs/promises";
+import path from "path";
+import { glob } from "glob";
+async function findInputFiles(inputPath) {
+  if (!inputPath) {
+    return [];
+  }
+  if (inputPath.includes("*")) {
+    try {
+      const matchedFiles = await glob(inputPath);
+      if (matchedFiles.length === 0) {
+        throw new Error(`No files found matching pattern: ${inputPath}`);
+      }
+      return matchedFiles;
+    } catch (err) {
+      throw new Error(`Error matching files: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  try {
+    const stat = await fs.stat(inputPath);
+    if (stat.isFile()) {
+      return [inputPath];
+    } else if (stat.isDirectory()) {
+      const pattern = path.join(inputPath, "*.{yaml,yml}");
+      try {
+        const yamlFiles = await glob(pattern);
+        if (yamlFiles.length === 0) {
+          throw new Error(`No YAML files found in directory: ${inputPath}`);
+        }
+        return yamlFiles;
+      } catch (_) {
+        throw new Error(`No YAML files found in directory: ${inputPath}`);
+      }
+    }
+  } catch (e) {
+    if (e instanceof Error && e.message.includes("ENOENT")) {
+      throw new Error("Input path not found");
+    }
+    throw e;
+  }
+  return [];
+}
+
+// src/utils/loadResume.ts
+async function loadResumeFiles(inputPath) {
+  const files = await findInputFiles(inputPath);
+  if (files.length === 0) {
+    throw new Error("No resume files found");
+  }
+  const yamlContents = [];
+  for (const file of files) {
+    try {
+      const content = await fs2.readFile(file, "utf-8");
+      const parsed = YAML.parse(content);
+      if (parsed && typeof parsed === "object") {
+        yamlContents.push(content);
+      }
+    } catch (error) {
+      throw new Error(`Failed to parse ${file}: ${error.message}`);
+    }
+  }
+  if (yamlContents.length === 0) {
+    throw new Error("No valid data found in any of the input files");
+  }
+  return { files, yamlContents };
+}
 
 // src/utils/errorHandler.ts
 function handleCommandError(error, command, debug = false) {
@@ -36,8 +104,8 @@ function handleCommandError(error, command, debug = false) {
     if (debug) {
       console.error("\nValidation failed with the following errors:");
       errors.forEach((err, index) => {
-        const path6 = err.instancePath || "root";
-        console.error(`${index + 1}. Path: ${path6}`);
+        const path7 = err.instancePath || "root";
+        console.error(`${index + 1}. Path: ${path7}`);
         console.error(`   Error: ${err.message || "Unknown validation error"}`);
         if (err.params) {
           console.error(`   Params: ${JSON.stringify(err.params)}`);
@@ -47,8 +115,8 @@ function handleCommandError(error, command, debug = false) {
       console.error("\nSome validation errors were found:");
       const maxErrors = 5;
       errors.slice(0, maxErrors).forEach((err, index) => {
-        const path6 = err.instancePath || "root";
-        console.error(`${index + 1}. Field: ${path6}`);
+        const path7 = err.instancePath || "root";
+        console.error(`${index + 1}. Field: ${path7}`);
         console.error(`   Error: ${err.message || "Unknown validation error"}`);
       });
       if (errors.length > maxErrors) {
@@ -64,97 +132,85 @@ function handleCommandError(error, command, debug = false) {
 }
 
 // src/commands/validate.ts
-function formatAtsReport(result, debug, chalk6) {
-  const scoreColor = result.score >= 75 ? chalk6.green : result.score >= 60 ? chalk6.yellow : chalk6.red;
+function formatAtsReport(result, debug, chalk7) {
+  const scoreColor = result.score >= 75 ? chalk7.green : result.score >= 60 ? chalk7.yellow : chalk7.red;
   console.log("");
-  console.log(chalk6.bold("\u2550\u2550\u2550 ATS Analysis Report \u2550\u2550\u2550"));
+  console.log(chalk7.bold("=== ATS Analysis Report ==="));
   console.log("");
-  console.log(`  Score: ${scoreColor(chalk6.bold(`${result.score}/100`))} (${result.rating.replace("-", " ")})`);
+  console.log(
+    `  Score: ${scoreColor(chalk7.bold(`${result.score}/100`))} (${result.rating.replace("-", " ")})`
+  );
   console.log(`  ${result.summary}`);
   console.log("");
-  const categories = {};
-  for (const check of result.checks) {
-    const list = categories[check.category];
-    if (!list) {
-      categories[check.category] = [check];
-    } else {
-      list.push(check);
-    }
-  }
-  const categoryLabels = {
-    contact: "Contact Information",
-    content: "Content Quality",
-    structure: "Resume Structure",
-    keywords: "Keywords"
+  const tierLabels = {
+    parsing: "Parsing",
+    recruiter: "Recruiter",
+    match: "JD Match"
   };
-  for (const [cat, checks] of Object.entries(categories)) {
-    const label = categoryLabels[cat] || cat;
-    console.log(chalk6.bold(`  ${label}`));
-    for (const check of checks) {
-      if (!debug && check.passed) continue;
-      const icon = check.passed ? chalk6.green("\u2713") : chalk6.red("\u2717");
-      const scoreText = chalk6.dim(`[${check.score}]`);
+  for (const [tierName, tier] of Object.entries(result.tiers)) {
+    const label = tierLabels[tierName] ?? tierName;
+    console.log(chalk7.bold(`  ${label} (${tier.score}/100, grade ${tier.grade})`));
+    for (const check of tier.checks) {
+      if (!debug && (check.status === "pass" || check.status === "skipped")) continue;
+      const icon = check.status === "pass" ? chalk7.green("v") : check.status === "skipped" ? chalk7.dim("-") : check.status === "warn" ? chalk7.yellow("!") : chalk7.red("x");
+      const scoreText = chalk7.dim(`[${check.score}]`);
       console.log(`    ${icon} ${check.message} ${scoreText}`);
-      if (!check.passed && check.suggestion) {
-        console.log(chalk6.dim(`      \u2192 ${check.suggestion}`));
+      for (const hint of check.hints) {
+        console.log(chalk7.dim(`      -> ${hint}`));
       }
     }
     console.log("");
   }
-  if (result.keywords) {
-    console.log(chalk6.bold("  Job Description Match"));
-    const kw = result.keywords;
-    const matchColor = kw.matchPercentage >= 70 ? chalk6.green : kw.matchPercentage >= 50 ? chalk6.yellow : chalk6.red;
-    console.log(`    Match: ${matchColor(`${kw.matchPercentage}%`)} (${kw.matched.length}/${kw.matched.length + kw.missing.length} keywords)`);
-    if (kw.matched.length > 0) {
-      console.log(chalk6.green(`    \u2713 Matched: ${kw.matched.join(", ")}`));
-    }
-    if (kw.missing.length > 0) {
-      console.log(chalk6.red(`    \u2717 Missing: ${kw.missing.join(", ")}`));
-      console.log(chalk6.dim("      \u2192 Consider incorporating these keywords into your resume where relevant."));
+  if (result.knockouts.length > 0) {
+    console.log(chalk7.bold("  Knockout Signals"));
+    for (const k of result.knockouts) {
+      console.log(chalk7.red(`    ! ${k.signal}: ${k.evidence}`));
+      console.log(chalk7.dim(`      -> ${k.recommendation}`));
     }
     console.log("");
   }
-  console.log(chalk6.dim("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550"));
+  console.log(chalk7.dim("==========================="));
 }
 async function validateAction(options) {
-  const chalk6 = (await import("chalk")).default;
-  console.log(chalk6.blue("Starting resuml validate..."));
+  const chalk7 = (await import("chalk")).default;
+  console.log(chalk7.blue("Starting resuml validate..."));
   try {
     const inputPath = options.resume;
     const { yamlContents } = await loadResumeFiles(inputPath);
-    console.log(chalk6.blue("Validating resume data..."));
+    console.log(chalk7.blue("Validating resume data..."));
     let resumeData;
     try {
       resumeData = await processResumeData(yamlContents);
-      console.log(chalk6.green("\u2713 Resume data is valid against the schema!"));
+      console.log(chalk7.green("\u2713 Resume data is valid against the schema!"));
     } catch (error) {
       handleCommandError(error, "validate", options.debug);
       return;
     }
     if (options.ats) {
-      console.log(chalk6.blue("Running ATS analysis..."));
+      console.log(chalk7.blue("Running ATS analysis..."));
       let jobDescription;
       if (options.jd) {
         try {
-          jobDescription = fs.readFileSync(options.jd, "utf8");
+          jobDescription = fs3.readFileSync(options.jd, "utf8");
         } catch {
-          console.error(chalk6.red(`Failed to read job description file: ${options.jd}`));
+          console.error(chalk7.red(`Failed to read job description file: ${options.jd}`));
           return;
         }
       }
+      const cfg = loadConfig(options.config ? { configPath: options.config } : {});
       const result = analyzeAts(resumeData, {
-        language: "en",
-        jobDescription
+        language: cfg.locale,
+        jobDescription,
+        config: cfg
       });
       if (options.format === "json") {
         console.log(JSON.stringify(result, null, 2));
       } else {
-        formatAtsReport(result, !!options.debug, chalk6);
+        formatAtsReport(result, !!options.debug, chalk7);
       }
       const threshold = options.atsThreshold ? parseInt(options.atsThreshold, 10) : void 0;
       if (threshold !== void 0 && result.score < threshold) {
-        console.error(chalk6.red(`
+        console.error(chalk7.red(`
 ATS score ${result.score} is below threshold ${threshold}.`));
         process.exit(1);
       }
@@ -165,27 +221,27 @@ ATS score ${result.score} is below threshold ${threshold}.`));
 }
 
 // src/commands/tojson.ts
-import fs2 from "fs";
+import fs4 from "fs";
 async function toJsonAction(options) {
-  const chalk6 = (await import("chalk")).default;
-  console.log(chalk6.blue("Starting resuml tojson..."));
+  const chalk7 = (await import("chalk")).default;
+  console.log(chalk7.blue("Starting resuml tojson..."));
   try {
     const inputPath = options.resume;
     const { yamlContents } = await loadResumeFiles(inputPath);
-    console.log(chalk6.blue("Processing and validating data..."));
+    console.log(chalk7.blue("Processing and validating data..."));
     const resumeData = await processResumeData(yamlContents);
-    console.log(chalk6.green("Processing and validation successful!"));
+    console.log(chalk7.green("Processing and validation successful!"));
     const jsonOutput = JSON.stringify(resumeData, null, 2);
-    fs2.writeFileSync(options.output, jsonOutput, "utf8");
-    console.log(chalk6.green(`Successfully wrote output to ${options.output}`));
+    fs4.writeFileSync(options.output, jsonOutput, "utf8");
+    console.log(chalk7.green(`Successfully wrote output to ${options.output}`));
   } catch (error) {
     handleCommandError(error, "tojson", options.debug);
   }
 }
 
 // src/commands/render.ts
-import fs3 from "fs";
-import path from "path";
+import fs5 from "fs";
+import path2 from "path";
 import chalk from "chalk";
 async function renderAction(options) {
   if (!options.theme) {
@@ -225,12 +281,12 @@ async function renderAction(options) {
         }
       });
       await browser.close();
-      fs3.writeFileSync(outputPath, pdfBuffer);
+      fs5.writeFileSync(outputPath, pdfBuffer);
       console.log(chalk.green(`Successfully wrote PDF output to ${outputPath}`));
     } else {
       console.log(chalk.blue(`Writing HTML output to ${outputPath}...`));
-      fs3.mkdirSync(path.dirname(outputPath), { recursive: true });
-      fs3.writeFileSync(outputPath, htmlOutput, "utf8");
+      fs5.mkdirSync(path2.dirname(outputPath), { recursive: true });
+      fs5.writeFileSync(outputPath, htmlOutput, "utf8");
       console.log(chalk.green(`Successfully wrote HTML output to ${outputPath}`));
     }
   } catch (error) {
@@ -239,8 +295,8 @@ async function renderAction(options) {
 }
 
 // src/commands/dev.ts
-import fs4 from "fs";
-import path2 from "path";
+import fs6 from "fs";
+import path3 from "path";
 import chalk2 from "chalk";
 async function devAction(options) {
   if (!options.theme) {
@@ -258,11 +314,11 @@ async function devAction(options) {
     await renderResume(options);
     console.log(chalk2.green(`\u{1F680} Development server running at http://localhost:${port}`));
     console.log(chalk2.blue("Watching for file changes..."));
-    if (fs4.existsSync(inputPath) && fs4.statSync(inputPath).isDirectory()) {
+    if (fs6.existsSync(inputPath) && fs6.statSync(inputPath).isDirectory()) {
       watchDirectory(inputPath, () => {
         void renderResume(options);
       });
-    } else if (fs4.existsSync(inputPath)) {
+    } else if (fs6.existsSync(inputPath)) {
       watchFile(inputPath, () => {
         void renderResume(options);
       });
@@ -285,16 +341,16 @@ async function renderResume(options) {
     const htmlOutput = await theme.render(resumeData, {
       locale: options.language
     });
-    const outputPath = path2.join(process.cwd(), ".resuml-dev", "index.html");
-    fs4.mkdirSync(path2.dirname(outputPath), { recursive: true });
-    fs4.writeFileSync(outputPath, htmlOutput, "utf8");
+    const outputPath = path3.join(process.cwd(), ".resuml-dev", "index.html");
+    fs6.mkdirSync(path3.dirname(outputPath), { recursive: true });
+    fs6.writeFileSync(outputPath, htmlOutput, "utf8");
     console.log(chalk2.green("\u2705 Resume updated!"));
   } catch (error) {
     console.error(chalk2.red("\u274C Error rendering resume:"), error.message);
   }
 }
 function watchDirectory(dirPath, callback) {
-  fs4.watch(dirPath, { recursive: true }, (_eventType, filename) => {
+  fs6.watch(dirPath, { recursive: true }, (_eventType, filename) => {
     if (filename && (filename.endsWith(".yaml") || filename.endsWith(".yml"))) {
       console.log(chalk2.blue(`\u{1F4C1} File changed: ${filename}`));
       callback();
@@ -302,9 +358,9 @@ function watchDirectory(dirPath, callback) {
   });
 }
 function watchFile(filePath, callback) {
-  fs4.watch(filePath, (eventType) => {
+  fs6.watch(filePath, (eventType) => {
     if (eventType === "change") {
-      console.log(chalk2.blue(`\u{1F4C4} File changed: ${path2.basename(filePath)}`));
+      console.log(chalk2.blue(`\u{1F4C4} File changed: ${path3.basename(filePath)}`));
       callback();
     }
   });
@@ -316,9 +372,9 @@ async function startDevServer(port) {
     const parsedUrl = url.parse(req.url || "", true);
     const pathname = parsedUrl.pathname || "/";
     if (pathname === "/" || pathname === "/index.html") {
-      const htmlPath = path2.join(process.cwd(), ".resuml-dev", "index.html");
-      if (fs4.existsSync(htmlPath)) {
-        const html = fs4.readFileSync(htmlPath, "utf8");
+      const htmlPath = path3.join(process.cwd(), ".resuml-dev", "index.html");
+      if (fs6.existsSync(htmlPath)) {
+        const html = fs6.readFileSync(htmlPath, "utf8");
         const liveReloadScript = `
           <script>
             setInterval(() => {
@@ -351,8 +407,8 @@ async function startDevServer(port) {
 }
 
 // src/commands/init.ts
-import fs5 from "fs";
-import path3 from "path";
+import fs7 from "fs";
+import path4 from "path";
 import readline from "readline";
 import chalk3 from "chalk";
 function createReadlineInterface() {
@@ -371,10 +427,10 @@ function ask(rl, question, defaultValue) {
 }
 async function initAction(options) {
   const outputPath = options.output || "resume.yaml";
-  const fullPath = path3.resolve(outputPath);
+  const fullPath = path4.resolve(outputPath);
   const rl = createReadlineInterface();
   try {
-    if (fs5.existsSync(fullPath)) {
+    if (fs7.existsSync(fullPath)) {
       const overwrite = await ask(
         rl,
         `${chalk3.yellow("\u26A0")}  ${outputPath} already exists. Overwrite? (y/N)`,
@@ -389,23 +445,45 @@ async function initAction(options) {
     const name = await ask(rl, "Your full name", "John Doe");
     const email = await ask(rl, "Email address", "john@example.com");
     const label = await ask(rl, "Professional title/label", "Software Engineer");
-    const yaml = generateResumeYaml(name, email, label);
-    fs5.mkdirSync(path3.dirname(fullPath), { recursive: true });
-    fs5.writeFileSync(fullPath, yaml, "utf8");
+    const yaml2 = generateResumeYaml(name, email, label);
+    fs7.mkdirSync(path4.dirname(fullPath), { recursive: true });
+    fs7.writeFileSync(fullPath, yaml2, "utf8");
+    const configPath = path4.join(path4.dirname(fullPath), "resuml.config.yaml");
+    const template = `# resuml ATS configuration
+# Override defaults; everything is optional.
+# Run \`resuml ats config --print\` to see the merged effective config.
+ats:
+  weights:
+    tiers:
+      parsing: 30
+      match: 50
+      recruiter: 20
+  thresholds:
+    seniorYoeCutoff: 10
+  disable: []
+`;
+    try {
+      fs7.writeFileSync(configPath, template, { encoding: "utf8", flag: "wx" });
+      console.log(chalk3.green(`Created resuml.config.yaml`));
+    } catch (err) {
+      if (err.code !== "EEXIST") throw err;
+    }
     console.log(chalk3.green(`
 \u2705 Created ${outputPath}`));
     console.log(chalk3.blue("\nNext steps:"));
     console.log(`  1. Edit ${outputPath} to fill in your details`);
     console.log("  2. Run " + chalk3.cyan("resuml validate --resume " + outputPath));
-    console.log("  3. Run " + chalk3.cyan("resuml render --resume " + outputPath + " --theme stackoverflow"));
+    console.log(
+      "  3. Run " + chalk3.cyan("resuml render --resume " + outputPath + " --theme stackoverflow")
+    );
   } finally {
     rl.close();
   }
 }
 
 // src/commands/pdf.ts
-import fs6 from "fs";
-import path4 from "path";
+import fs8 from "fs";
+import path5 from "path";
 import chalk4 from "chalk";
 async function loadPlaywright() {
   try {
@@ -460,14 +538,46 @@ async function pdfAction(options) {
     try {
       const page = await browser.newPage();
       await page.setContent(htmlOutput, { waitUntil: "networkidle" });
+      const bodyText = await page.evaluate(() => document.body.innerText || "");
+      const bodyWords = bodyText.trim().split(/\s+/).filter(Boolean).length;
+      const resumeContentParts = [];
+      if (resumeData.basics?.summary) resumeContentParts.push(resumeData.basics.summary);
+      for (const w of resumeData.work || []) {
+        if (w.summary) resumeContentParts.push(w.summary);
+        resumeContentParts.push(...w.highlights || []);
+      }
+      for (const p of resumeData.projects || []) {
+        if (p.description) resumeContentParts.push(p.description);
+        resumeContentParts.push(...p.highlights || []);
+      }
+      for (const s of resumeData.skills || []) {
+        if (s.name) resumeContentParts.push(s.name);
+        resumeContentParts.push(...s.keywords || []);
+      }
+      const resumeWords = resumeContentParts.join(" ").split(/\s+/).filter(Boolean).length;
+      if (resumeWords > 0 && bodyWords < resumeWords * 0.7) {
+        console.warn(
+          chalk4.yellow(
+            `pdf-text-extractable: rendered text ${bodyWords} words vs resume ${resumeWords} (under 70%). Theme may use image-based glyphs.`
+          )
+        );
+      }
       const pdfBuffer = await page.pdf({
         format,
         margin,
         printBackground: true,
         preferCSSPageSize: true
       });
-      fs6.mkdirSync(path4.dirname(path4.resolve(outputPath)), { recursive: true });
-      fs6.writeFileSync(outputPath, pdfBuffer);
+      fs8.mkdirSync(path5.dirname(path5.resolve(outputPath)), { recursive: true });
+      fs8.writeFileSync(outputPath, pdfBuffer);
+      const sizeMb = pdfBuffer.length / (1024 * 1024);
+      if (sizeMb > 2.5) {
+        console.warn(
+          chalk4.yellow(
+            `pdf-size-under-2.5mb: PDF is ${sizeMb.toFixed(2)} MB (Greenhouse limit 2.5 MB).`
+          )
+        );
+      }
       console.log(chalk4.green(`\u2705 Successfully generated ${outputPath}`));
     } finally {
       await browser.close();
@@ -487,7 +597,9 @@ function listThemes() {
   console.log(
     `  ${"Status".padEnd(10)}${"Name".padEnd(nameWidth)}${"Package".padEnd(pkgWidth)}Description`
   );
-  console.log(`  ${"\u2500".repeat(10)}${"\u2500".repeat(nameWidth)}${"\u2500".repeat(pkgWidth)}${"\u2500".repeat(30)}`);
+  console.log(
+    `  ${"\u2500".repeat(10)}${"\u2500".repeat(nameWidth)}${"\u2500".repeat(pkgWidth)}${"\u2500".repeat(30)}`
+  );
   for (const theme of KNOWN_THEMES) {
     const installed = isThemeInstalled(theme.pkg);
     const version = installed ? getInstalledVersion(theme.pkg) : null;
@@ -514,14 +626,18 @@ function installTheme(name) {
     execSync(`npm install ${pkg}`, { stdio: "inherit" });
     console.log(chalk5.green(`
 \u2705 Successfully installed ${pkg}`));
-    console.log(chalk5.blue(`
+    console.log(
+      chalk5.blue(`
 Use it with: ${chalk5.cyan(`resuml render --theme ${known?.name || name}`)}
-`));
+`)
+    );
   } catch {
     console.error(chalk5.red(`
 \u274C Failed to install ${pkg}`));
-    console.error(chalk5.yellow(`Make sure the package exists: https://www.npmjs.com/package/${pkg}
-`));
+    console.error(
+      chalk5.yellow(`Make sure the package exists: https://www.npmjs.com/package/${pkg}
+`)
+    );
   }
 }
 function themesAction(options) {
@@ -538,6 +654,32 @@ async function mcpAction() {
   await startMcpServer();
 }
 
+// src/commands/ats.ts
+import yaml from "yaml";
+import chalk6 from "chalk";
+function atsExplain(id) {
+  if (!id) {
+    console.log(listRubricMarkdown());
+    return;
+  }
+  const entry = getRubricEntry(id);
+  if (!entry) {
+    console.error(chalk6.red(`Unknown rubric id: ${id}`));
+    process.exit(1);
+    return;
+  }
+  console.log(chalk6.bold(entry.id));
+  console.log(`  Tier:        ${entry.tier}`);
+  console.log(`  Weight:      ${entry.weight}`);
+  console.log(`  Evidence:    ${entry.evidenceLevel}`);
+  console.log(`  Description: ${entry.description}`);
+  if (entry.source) console.log(`  Source:      ${entry.source}`);
+}
+function atsConfigPrint(opts) {
+  const cfg = loadConfig(opts.config ? { configPath: opts.config } : {});
+  console.log(yaml.stringify({ ats: cfg }));
+}
+
 // src/utils/themeRender.ts
 var themeRender_exports = {};
 __export(themeRender_exports, {
@@ -591,12 +733,12 @@ function injectCss(html, css) {
 }
 
 // src/index.ts
-var currentDir = path5.dirname(fileURLToPath(import.meta.url));
+var currentDir = path6.dirname(fileURLToPath(import.meta.url));
 function getCliVersion() {
-  const packageJsonPath = path5.resolve(currentDir, "../package.json");
-  if (fs7.existsSync(packageJsonPath)) {
+  const packageJsonPath = path6.resolve(currentDir, "../package.json");
+  if (fs9.existsSync(packageJsonPath)) {
     try {
-      const packageJson = JSON.parse(fs7.readFileSync(packageJsonPath, "utf8"));
+      const packageJson = JSON.parse(fs9.readFileSync(packageJsonPath, "utf8"));
       return packageJson.version ?? "0.0.0";
     } catch {
       return "0.0.0";
@@ -606,7 +748,10 @@ function getCliVersion() {
 }
 var program = new Command();
 program.name("resuml").description("CLI tool for managing resuml resume files.").version(getCliVersion());
-program.command("validate").description("Validates resume data against the schema.").option("-r, --resume <path>", "Input YAML file, directory, or glob pattern.").option("--debug", "Show detailed validation errors.").option("--ats", "Run ATS (Applicant Tracking System) compatibility analysis.").option("--jd <path>", "Path to a job description file for keyword matching (requires --ats).").option("--ats-threshold <score>", "Minimum ATS score (0-100). Exit with code 1 if below threshold.").option("--format <type>", "Output format for ATS results (text or json).", "text").action(validateAction);
+program.command("validate").description("Validates resume data against the schema.").option("-r, --resume <path>", "Input YAML file, directory, or glob pattern.").option("--debug", "Show detailed validation errors.").option("--ats", "Run ATS (Applicant Tracking System) compatibility analysis.").option("--jd <path>", "Path to a job description file for keyword matching (requires --ats).").option(
+  "--ats-threshold <score>",
+  "Minimum ATS score (0-100). Exit with code 1 if below threshold."
+).option("--format <type>", "Output format for ATS results (text or json).", "text").option("--config <path>", "Path to resuml.config.yaml (default: ./resuml.config.yaml).").action(validateAction);
 program.command("tojson").description("Converts YAML resume data to JSON format.").option("-r, --resume <path>", "Input YAML file, directory, or glob pattern.").option("-o, --output <file>", "Output JSON file path.", "resume.json").option("--debug", "Show detailed validation and processing information.").action(toJsonAction);
 program.command("render").description("Renders the resume data using a specified theme.").option("-r, --resume <path>", "Input YAML file, directory, or glob pattern.").option("-t, --theme <name>", "Theme name (e.g., stackoverflow, react).").option("-o, --output <file>", "Output file path.").option("--format <type>", "Output format (html or pdf).", "html").option("--language <code>", "Language code for localization.", "en").option("--debug", "Show detailed validation and processing information.").action(renderAction);
 program.command("dev").description("Start development server with hot-reload.").option("-r, --resume <path>", "Input YAML file, directory, or glob pattern.").option("-t, --theme <name>", "Theme name (e.g., stackoverflow, react).").option("--port <number>", "Port for development server.", "3000").option("--language <code>", "Language code for localization.", "en").option("--debug", "Show detailed validation and processing information.").action(devAction);
@@ -614,6 +759,13 @@ program.command("init").description("Scaffold a starter resume.yaml file with al
 program.command("pdf").description("Export resume as PDF using Playwright.").option("-r, --resume <path>", "Input YAML file, directory, or glob pattern.").option("-t, --theme <name>", "Theme name (e.g., stackoverflow, react).").option("-o, --output <file>", "Output PDF file path.", "resume.pdf").option("--language <code>", "Language code for localization.", "en").option("--format <size>", "Page format: A4 or Letter.", "A4").option("--margin <values>", 'Page margins (e.g., "10mm" or "10mm,15mm,10mm,15mm").').option("--debug", "Show detailed validation and processing information.").action(pdfAction);
 program.command("themes").description("List available JSON Resume themes and install them.").option("--install <name>", "Install a theme by name (e.g., stackoverflow, elegant).").action(themesAction);
 program.command("mcp").description("Start MCP server for AI agent integration (stdio transport).").action(mcpAction);
+var ats = program.command("ats").description("ATS rubric utilities.");
+ats.command("explain [id]").description("Print rubric entry for a check id, or full rubric if id omitted.").action((id) => {
+  atsExplain(id);
+});
+ats.command("config").description("Print the effective merged ATS config.").option("--print", "Print the merged config (default action).").option("--config <path>", "Path to resuml.config.yaml.").action((opts) => {
+  atsConfigPrint(opts);
+});
 if (process.env["NODE_ENV"] !== "test") {
   void (async () => {
     try {