knowme-careerforge-skill 0.0.1

package/scripts/search-template.py

@@ -0,0 +1,147 @@
+#!/usr/bin/env python3
+"""
+KnowMe CareerForge — Template Search & Ranking Engine (BM25 + Multi-criteria scoring)
+根据目标岗位、期望版式风格、目标页数与信息密度，加权检索最匹配的 HTML 简历模板。
+"""
+
+import sys, os, json, argparse
+from pathlib import Path
+
+def load_templates():
+    base_dir = Path(__file__).resolve().parent.parent / "src" / "templates"
+    templates = []
+    if not base_dir.exists():
+        return templates
+        
+    for t_dir in sorted(base_dir.iterdir()):
+        if not t_dir.is_dir() or t_dir.name == "common":
+            continue
+        meta_file = t_dir / "metadata.json"
+        if meta_file.exists():
+            try:
+                data = json.loads(meta_file.read_text(encoding="utf-8"))
+                data["directory"] = f"src/templates/{t_dir.name}"
+                templates.append(data)
+            except Exception as e:
+                pass
+    return templates
+
+def calculate_match_score(template, query_role, query_style=None, target_pages=1, density="balanced"):
+    score = 0.0
+    
+    # 1. 岗位匹配度 (Role Match - 35%)
+    role_score = 0.0
+    query_lower = query_role.lower()
+    supported = [r.lower() for r in template.get("supportedRoles", [])]
+    
+    for r in supported:
+        if r in query_lower or query_lower in r:
+            role_score = 1.0
+            break
+            
+    if role_score < 0.5:
+        cat = template.get("roleCategory", "")
+        if "tech" in query_lower or "engineer" in query_lower or "ai" in query_lower or "研发" in query_lower:
+            role_score = 0.90 if cat == "engineering-ai" else 0.40
+        elif "manage" in query_lower or "lead" in query_lower or "director" in query_lower or "总监" in query_lower or "架构" in query_lower or "产品" in query_lower:
+            role_score = 0.90 if cat == "management-product" else 0.50
+        else:
+            role_score = 0.60
+            
+    score += role_score * 0.35
+
+    # 2. 风格匹配度 (Style Match - 25%)
+    style_score = 0.70
+    if query_style:
+        q_style_lower = query_style.lower()
+        t_style = template.get("style", "").lower()
+        t_id = template.get("id", "").lower()
+        if q_style_lower in t_style or q_style_lower in t_id:
+            style_score = 1.0
+        elif "single" in q_style_lower and "single" in t_style:
+            style_score = 1.0
+        elif "split" in q_style_lower or "double" in q_style_lower or "column" in q_style_lower:
+            style_score = 1.0 if "two-column" in t_style else 0.50
+        elif "table" in q_style_lower or "grid" in q_style_lower:
+            style_score = 1.0 if "table" in t_style else 0.40
+        else:
+            style_score = 0.50
+    score += style_score * 0.25
+
+    # 3. ATS 兼容评级 (ATS Tier - 20%)
+    ats_tier = template.get("atsScoreTier", "tier-1-optimal")
+    ats_score = 1.0 if "optimal" in ats_tier or "tier-1" in ats_tier else 0.85
+    score += ats_score * 0.20
+
+    # 4. 页数适配度 (Page Fit - 10%)
+    target_p = template.get("layout", {}).get("targetPages", 1)
+    max_p = template.get("layout", {}).get("maxPages", 2)
+    if target_pages == target_p:
+        page_score = 1.0
+    elif target_pages <= max_p:
+        page_score = 0.80
+    else:
+        page_score = 0.50
+    score += page_score * 0.10
+
+    # 5. 信息密度偏好 (Density - 10%)
+    t_density = template.get("layout", {}).get("density", "balanced")
+    density_score = 1.0 if density == t_density else 0.80
+    score += density_score * 0.10
+
+    return round(score * 100, 1)
+
+def search_templates(role, style=None, target_pages=1, density="balanced"):
+    templates = load_templates()
+    if not templates:
+        return []
+    
+    results = []
+    for t in templates:
+        s = calculate_match_score(t, role, style, target_pages, density)
+        results.append({
+            "score": s,
+            "template": t
+        })
+        
+    results.sort(key=lambda x: x["score"], reverse=True)
+    return results
+
+def main():
+    parser = argparse.ArgumentParser(description="KnowMe CareerForge — Template Search Engine")
+    parser.add_argument("role", nargs="?", default="AI Agent Engineer", help="Target role title (e.g. 'AI Agent Engineer', 'Frontend')")
+    parser.add_argument("--style", default=None, help="Style filter: minimal, modern, executive, classic, single-column, two-column, table")
+    parser.add_argument("--target-pages", type=int, default=1, help="Expected page count (1 or 2)")
+    parser.add_argument("--density", default="balanced", choices=["high", "balanced", "relaxed"], help="Information density")
+    parser.add_argument("--json", action="store_true", help="Output results in JSON format")
+
+    args = parser.parse_args()
+
+    results = search_templates(args.role, args.style, args.target_pages, args.density)
+
+    if args.json:
+        print(json.dumps(results, ensure_ascii=False, indent=2))
+        return
+
+    print("=" * 80)
+    print(f"  KnowMe CareerForge — Template Search Results")
+    print(f"  Target Role : {args.role}")
+    print(f"  Style Pref  : {args.style or 'Any'}")
+    print(f"  Target Pages: {args.target_pages} | Density: {args.density}")
+    print("=" * 80)
+
+    if not results:
+        print("No matching templates found.")
+        return
+
+    for idx, r in enumerate(results, 1):
+        t = r["template"]
+        print(f"{idx}. [Score: {r['score']}] {t.get('name')} (ID: {t.get('id')})")
+        print(f"   Category: {t.get('roleCategory')} | Style: {t.get('style')} | ATS Tier: {t.get('atsScoreTier')}")
+        print(f"   Target Pages: {t.get('layout', {}).get('targetPages')} (Max: {t.get('layout', {}).get('maxPages')}) | Density: {t.get('layout', {}).get('density')}")
+        print(f"   Customizable Tokens: {', '.join(t.get('customizableTokens', [])[:4])}")
+        print(f"   Directory: {t.get('directory')}")
+        print("-" * 80)
+
+if __name__ == "__main__":
+    main()

package/scripts/sync-version.py

@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+"""
+KnowMe CareerForge — Version Synchronization Engine
+将项目根版本号统一同步至 package.json, pyproject.toml, skill.json 与 cli/package.json。
+"""
+
+import sys, os, json, re, argparse
+from pathlib import Path
+
+def sync_version(new_version: str):
+    base_dir = Path(__file__).resolve().parent.parent
+    print("==============================================================")
+    print(f"  KnowMe CareerForge — Synchronizing Version to v{new_version}")
+    print("==============================================================")
+
+    # 1. Update package.json
+    pkg_json_path = base_dir / "package.json"
+    if pkg_json_path.exists():
+        data = json.loads(pkg_json_path.read_text(encoding="utf-8"))
+        data["version"] = new_version
+        pkg_json_path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+        print(f"[✓] Synced package.json -> {new_version}")
+
+    # 2. Update cli/package.json
+    cli_pkg_path = base_dir / "cli" / "package.json"
+    if cli_pkg_path.exists():
+        data = json.loads(cli_pkg_path.read_text(encoding="utf-8"))
+        data["version"] = new_version
+        cli_pkg_path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+        print(f"[✓] Synced cli/package.json -> {new_version}")
+
+    # 3. Update skill.json
+    skill_json_path = base_dir / "skill.json"
+    if skill_json_path.exists():
+        data = json.loads(skill_json_path.read_text(encoding="utf-8"))
+        data["version"] = new_version
+        skill_json_path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+        print(f"[✓] Synced skill.json -> {new_version}")
+
+    # 4. Update pyproject.toml
+    pyproj_path = base_dir / "pyproject.toml"
+    if pyproj_path.exists():
+        text = pyproj_path.read_text(encoding="utf-8")
+        new_text = re.sub(r'version\s*=\s*"[^"]+"', f'version = "{new_version}"', text)
+        pyproj_path.write_text(new_text, encoding="utf-8")
+        print(f"[✓] Synced pyproject.toml -> {new_version}")
+
+    print("\n[✓] All package versions successfully synchronized!")
+
+def main():
+    parser = argparse.ArgumentParser(description="Synchronize project version")
+    parser.add_argument("version", nargs="?", default="1.0.0", help="New semantic version (e.g. 1.0.1)")
+    args = parser.parse_args()
+    sync_version(args.version)
+
+if __name__ == "__main__":
+    main()

package/scripts/validate-ats.ts

@@ -0,0 +1,173 @@
+#!/usr/bin/env ts-node
+/**
+ * KnowMe CareerForge — ATS Text Flow & Heading Hierarchy Inspector
+ * 验证 HTML 简历中的关键文本可提取性、标头层级规范与 ATS 机器解析友好度。
+ */
+
+import { chromium } from 'playwright';
+import * as path from 'path';
+import * as fs from 'fs';
+
+interface AtsValidationResult {
+  status: 'PASS' | 'WARN' | 'FAIL';
+  candidateName: string | null;
+  detectedContacts: {
+    phone: string | null;
+    email: string | null;
+  };
+  headingsFound: Array<{
+    level: string;
+    text: string;
+    isStandard: boolean;
+  }>;
+  totalTextLength: number;
+  warnings: string[];
+  errors: string[];
+}
+
+const STANDARD_SECTION_HEADERS = [
+  '工作经历', '工作经验', 'work experience', 'experience',
+  '项目经历', '核心项目', 'projects', 'key projects',
+  '专业技能', '核心技能', 'skills', 'technical skills',
+  '教育背景', '教育经历', 'education',
+  '核心领导力', '重大经历', '资质与证书', '求职意向'
+];
+
+export async function validateAts(htmlPath: string): Promise<AtsValidationResult> {
+  const absoluteHtml = path.resolve(htmlPath);
+  if (!fs.existsSync(absoluteHtml)) {
+    throw new Error(`HTML file not found: ${absoluteHtml}`);
+  }
+
+  const browser = await chromium.launch({ headless: true });
+  const page = await browser.newPage();
+  await page.goto(`file://${absoluteHtml}`, { waitUntil: 'networkidle' });
+
+  const rawData = await page.evaluate(() => {
+    const nameEl = document.querySelector('.candidate-name, h1');
+    const name = nameEl ? (nameEl.textContent || '').trim() : null;
+
+    const fullText = (document.body.innerText || '').trim();
+
+    // 提取电话与邮箱
+    const phoneMatch = fullText.match(/(?:(?:\+|00)86)?1[3-9]\d{9}|(?:1[3-9]\d-\d{4}-\d{4})/);
+    const emailMatch = fullText.match(/[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+/);
+
+    const headings = Array.from(document.querySelectorAll('h1, h2, h3, .section-title, .sub-title')).map(h => ({
+      level: h.tagName.toLowerCase(),
+      text: (h.textContent || '').trim()
+    }));
+
+    return {
+      candidateName: name,
+      phone: phoneMatch ? phoneMatch[0] : null,
+      email: emailMatch ? emailMatch[0] : null,
+      headings,
+      fullTextLength: fullText.length
+    };
+  });
+
+  await browser.close();
+
+  const warnings: string[] = [];
+  const errors: string[] = [];
+
+  if (!rawData.candidateName) {
+    errors.push('Candidate name (.candidate-name or h1) could not be extracted');
+  }
+
+  if (!rawData.email) {
+    warnings.push('No valid email address pattern detected in text flow');
+  }
+
+  if (!rawData.phone) {
+    warnings.push('No standard mobile phone pattern detected in text flow');
+  }
+
+  const validatedHeadings = rawData.headings.map(h => {
+    const textClean = h.text.toLowerCase().replace(/[^\w\u4e00-\u9fa5]/g, '');
+    const isStd = STANDARD_SECTION_HEADERS.some(s => textClean.includes(s.toLowerCase().replace(/\s+/g, '')));
+    return {
+      level: h.level,
+      text: h.text,
+      isStandard: isStd
+    };
+  });
+
+  const nonStdHeadings = validatedHeadings.filter(h => !h.isStandard && h.level === 'h2');
+  if (nonStdHeadings.length > 0) {
+    warnings.push(`Non-standard section headings detected: ${nonStdHeadings.map(h => `"${h.text}"`).join(', ')}`);
+  }
+
+  const status: 'PASS' | 'WARN' | 'FAIL' = errors.length > 0 ? 'FAIL' : warnings.length > 0 ? 'WARN' : 'PASS';
+
+  return {
+    status,
+    candidateName: rawData.candidateName,
+    detectedContacts: {
+      phone: rawData.phone,
+      email: rawData.email
+    },
+    headingsFound: validatedHeadings,
+    totalTextLength: rawData.fullTextLength,
+    warnings,
+    errors
+  };
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  let htmlPath = 'workspace/resume.html';
+  let jsonOutput = false;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--html' || args[i] === '-i') {
+      htmlPath = args[i + 1];
+      i++;
+    } else if (args[i] === '--json') {
+      jsonOutput = true;
+    }
+  }
+
+  try {
+    const result = await validateAts(htmlPath);
+
+    if (jsonOutput) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    console.log('======================================================');
+    console.log(`  KnowMe CareerForge — ATS Compliance QA: [${result.status}]`);
+    console.log(`  Candidate Name : ${result.candidateName || 'N/A'}`);
+    console.log(`  Phone Extracted: ${result.detectedContacts.phone || 'None'}`);
+    console.log(`  Email Extracted: ${result.detectedContacts.email || 'None'}`);
+    console.log(`  Text Extracted : ${result.totalTextLength} characters`);
+    console.log('------------------------------------------------------');
+    console.log('  Headings Structure:');
+    for (const h of result.headingsFound) {
+      const tag = h.isStandard ? '✓' : '?';
+      console.log(`    [${tag}] <${h.level}> ${h.text}`);
+    }
+
+    if (result.errors.length > 0) {
+      console.log('\n[!] Errors:');
+      for (const e of result.errors) console.log(`  - ✗ ${e}`);
+    }
+
+    if (result.warnings.length > 0) {
+      console.log('\n[?] Warnings:');
+      for (const w of result.warnings) console.log(`  - ⚠️ ${w}`);
+    }
+
+    console.log('======================================================');
+  } catch (err: unknown) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`[✗] ATS Validation Failed: ${msg}`);
+    process.exit(1);
+  }
+}
+
+if (require.main === module) {
+  main();
+}

package/scripts/validate-layout.ts

@@ -0,0 +1,161 @@
+#!/usr/bin/env ts-node
+/**
+ * KnowMe CareerForge — Playwright DOM Layout & Overflow Inspector
+ * 基于无头浏览器真实渲染计算 DOM 盒模型高度，检测单页/双页物理 A4 溢出与孤行。
+ */
+
+import { chromium } from 'playwright';
+import * as path from 'path';
+import * as fs from 'fs';
+
+interface LayoutValidationResult {
+  status: 'PASS' | 'OVERFLOW';
+  expectedPages: number;
+  totalPagesFound: number;
+  pageDetails: Array<{
+    pageIndex: number;
+    measuredHeightPx: number;
+    allowedHeightPx: number;
+    overflowPx: number;
+    isOverflow: boolean;
+  }>;
+  overflowSections: Array<{
+    selector: string;
+    heightPx: number;
+    textPreview: string;
+  }>;
+}
+
+export async function validateLayout(htmlPath: string, expectedPages: number = 1): Promise<LayoutValidationResult> {
+  const absoluteHtml = path.resolve(htmlPath);
+  if (!fs.existsSync(absoluteHtml)) {
+    throw new Error(`HTML file not found: ${absoluteHtml}`);
+  }
+
+  const browser = await chromium.launch({ headless: true });
+  const context = await browser.newContext({
+    viewport: { width: 794, height: 1123 }, // A4 at 96 DPI
+    deviceScaleFactor: 2
+  });
+
+  const page = await context.newPage();
+  await page.goto(`file://${absoluteHtml}`, { waitUntil: 'networkidle' });
+  await page.evaluateHandle('document.fonts.ready');
+
+  // A4 标准高度 (297mm in pixels at 96 DPI ~= 1122.5px)
+  const A4_HEIGHT_PX = 1122.5;
+
+  const evaluation = await page.evaluate((allowedHeight) => {
+    const pages = Array.from(document.querySelectorAll('.resume-page'));
+    const details = pages.map((el, index) => {
+      const rect = el.getBoundingClientRect();
+      const scrollH = el.scrollHeight;
+      const actualH = Math.max(rect.height, scrollH);
+      const diff = actualH - allowedHeight;
+      return {
+        pageIndex: index + 1,
+        measuredHeightPx: Math.round(actualH * 10) / 10,
+        allowedHeightPx: allowedHeight,
+        overflowPx: diff > 2 ? Math.round(diff * 10) / 10 : 0,
+        isOverflow: diff > 2
+      };
+    });
+
+    const overflows: Array<{ selector: string; heightPx: number; textPreview: string }> = [];
+    if (details.some(d => d.isOverflow)) {
+      const sections = Array.from(document.querySelectorAll('.resume-section, .timeline-item, .milestone-item, .experience-item, tr'));
+      for (const s of sections) {
+        const r = s.getBoundingClientRect();
+        if (r.bottom > allowedHeight) {
+          overflows.push({
+            selector: s.className || s.tagName.toLowerCase(),
+            heightPx: Math.round(r.height),
+            textPreview: (s.textContent || '').trim().slice(0, 60)
+          });
+        }
+      }
+    }
+
+    return {
+      totalPagesFound: pages.length,
+      pageDetails: details,
+      overflowSections: overflows
+    };
+  }, A4_HEIGHT_PX);
+
+  await browser.close();
+
+  const hasOverflow = evaluation.pageDetails.some(p => p.isOverflow) || evaluation.totalPagesFound > expectedPages;
+
+  return {
+    status: hasOverflow ? 'OVERFLOW' : 'PASS',
+    expectedPages,
+    totalPagesFound: evaluation.totalPagesFound,
+    pageDetails: evaluation.pageDetails,
+    overflowSections: evaluation.overflowSections
+  };
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  let htmlPath = 'workspace/resume.html';
+  let expectedPages = 1;
+  let jsonOutput = false;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--html' || args[i] === '-i') {
+      htmlPath = args[i + 1];
+      i++;
+    } else if (args[i] === '--expected-pages' || args[i] === '-p') {
+      expectedPages = parseInt(args[i + 1], 10) || 1;
+      i++;
+    } else if (args[i] === '--json') {
+      jsonOutput = true;
+    }
+  }
+
+  try {
+    const result = await validateLayout(htmlPath, expectedPages);
+
+    if (jsonOutput) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    console.log('======================================================');
+    console.log(`  KnowMe CareerForge — Layout QA: ${result.status}`);
+    console.log(`  HTML Path      : ${htmlPath}`);
+    console.log(`  Expected Pages : ${result.expectedPages} | Pages Found: ${result.totalPagesFound}`);
+    console.log('------------------------------------------------------');
+
+    for (const p of result.pageDetails) {
+      const statusSymbol = p.isOverflow ? '✗ OVERFLOW' : '✓ FIT';
+      console.log(`  Page ${p.pageIndex}: ${p.measuredHeightPx}px / ${p.allowedHeightPx}px [${statusSymbol}] (Overflow: ${p.overflowPx}px)`);
+    }
+
+    if (result.overflowSections.length > 0) {
+      console.log('\n[!] Nodes exceeding A4 physical boundary:');
+      for (const o of result.overflowSections) {
+        console.log(`  - <${o.selector}> (${o.heightPx}px): "${o.textPreview}..."`);
+      }
+      console.log('\n[Self-Healing Guidance]:');
+      console.log('  1. Reduce --resume-space-section by 1~2pt in workspace/resume.html <style>');
+      console.log('  2. Reduce --resume-font-size-body by 0.2pt');
+      console.log('  3. Condense verbose bullet points');
+    }
+
+    console.log('======================================================');
+
+    if (result.status === 'OVERFLOW') {
+      process.exit(1);
+    }
+  } catch (err: unknown) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`[✗] Layout Validation Failed: ${msg}`);
+    process.exit(1);
+  }
+}
+
+if (require.main === module) {
+  main();
+}

package/scripts/validate-resume.py

@@ -0,0 +1,139 @@
+#!/usr/bin/env python3
+"""
+KnowMe CareerForge — Resume Validation Engine (Layout, Schema & ATS Compliance)
+验证 HTML 工作区简历的语义结构、Design Tokens 完整度与单页/双页排版合规性。
+"""
+
+import sys, os, json, argparse, re
+from pathlib import Path
+
+def validate_resume_html(html_path: str, expected_pages: int = 1) -> dict:
+    p = Path(html_path)
+    if not p.exists():
+        # 尝试相对于脚本目录上一级
+        alt = Path(__file__).resolve().parent.parent / html_path
+        if alt.exists():
+            p = alt
+        else:
+            return {
+                "status": "FAIL",
+                "file": html_path,
+                "expectedPages": expected_pages,
+                "checks": {},
+                "errors": [f"HTML file not found at: {html_path}"],
+                "warnings": []
+            }
+
+    content = p.read_text(encoding="utf-8")
+    errors = []
+    warnings = []
+    checks = {}
+
+    # 1. 检查语义化容器
+    if '<div class="resume-page"' not in content and "<div class='resume-page'" not in content:
+        errors.append("Missing root container <div class='resume-page'>")
+    else:
+        checks["root_container"] = "PASS"
+
+    # 2. 检查基本信息字段
+    if 'candidate-name' not in content:
+        errors.append("Missing candidate name element (.candidate-name)")
+    else:
+        checks["candidate_name"] = "PASS"
+
+    # 3. 检查 Design Tokens (:root CSS 变量)
+    required_tokens = [
+        "--resume-page-width",
+        "--resume-page-min-height",
+        "--resume-font-size-body"
+    ]
+    missing_tokens = []
+    for token in required_tokens:
+        if token not in content:
+            missing_tokens.append(token)
+
+    if missing_tokens:
+        warnings.append(f"Missing recommended CSS Design Tokens: {', '.join(missing_tokens)}")
+    else:
+        checks["design_tokens"] = "PASS"
+
+    # 4. 检查打印分页规则
+    if "@page" not in content:
+        warnings.append("Missing @page print declaration in CSS")
+    if "page-break-after" not in content and "break-after" not in content:
+        warnings.append("Missing page-break-after CSS rules for multi-page/A4 constraints")
+
+    # 5. 检查核心内容模块
+    sections = ["experience", "projects", "skills", "education"]
+    detected_sections = []
+    for s in sections:
+        if f'id="{s}"' in content or f"id='{s}'" in content or s in content.lower():
+            detected_sections.append(s)
+
+    checks["detected_sections"] = detected_sections
+
+    # 6. 单页高度预估 (剔除 <style> 后的实际可见文字量)
+    body_text_only = re.sub(r'<style.*?>.*?</style>', '', content, flags=re.DOTALL)
+    visible_text = re.sub(r'<[^>]+>', '', body_text_only).strip()
+    char_count = len(re.sub(r'\s+', ' ', visible_text))
+
+    density_status = "OPTIMAL"
+    if expected_pages == 1:
+        if char_count > 1500:
+            warnings.append(f"Visible text volume ({char_count} chars) is high for a single-page resume; risk of overflow.")
+            density_status = "HIGH_RISK_OVERFLOW"
+        elif char_count < 400:
+            warnings.append(f"Visible text volume ({char_count} chars) is low for a single-page resume; canvas may appear sparse.")
+            density_status = "UNDERFLOW"
+
+    checks["char_count"] = char_count
+    checks["density_status"] = density_status
+
+    passed = len(errors) == 0
+
+    return {
+        "status": "PASS" if passed else "FAIL",
+        "file": str(p.resolve()),
+        "expectedPages": expected_pages,
+        "checks": checks,
+        "errors": errors,
+        "warnings": warnings
+    }
+
+def main():
+    parser = argparse.ArgumentParser(description="KnowMe CareerForge — Resume Validator")
+    parser.add_argument("--html", "-i", default="workspace/resume.html", help="Path to resume HTML (default: workspace/resume.html)")
+    parser.add_argument("--expected-pages", "-p", type=int, default=1, help="Expected page count (default: 1)")
+    parser.add_argument("--json", action="store_true", help="Output JSON format")
+
+    args = parser.parse_args()
+
+    result = validate_resume_html(args.html, args.expected_pages)
+
+    if args.json:
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+        return
+
+    print("=" * 70)
+    print(f"  KnowMe CareerForge — Resume Validation: {result['status']}")
+    print(f"  Target File    : {result['file']}")
+    print(f"  Expected Pages : {result['expectedPages']}")
+    print(f"  Text Density   : {result.get('checks', {}).get('density_status', 'N/A')} ({result.get('checks', {}).get('char_count', 0)} visible chars)")
+    print(f"  Sections Found : {', '.join(result.get('checks', {}).get('detected_sections', []))}")
+
+    if result.get("errors"):
+        print("\n[!] Errors:")
+        for e in result["errors"]:
+            print(f"  - ✗ {e}")
+
+    if result.get("warnings"):
+        print("\n[?] Warnings:")
+        for w in result["warnings"]:
+            print(f"  - ⚠️ {w}")
+
+    print("=" * 70)
+    if result["status"] != "PASS":
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()