knowme-careerforge-skill 0.0.2 → 0.0.6

package/scripts/validation/validate-ats.ts

@@ -1,177 +1,9 @@
 #!/usr/bin/env ts-node
-/**
- * KnowMe CareerForge — ATS Text Flow & Heading Hierarchy Inspector
- * 验证 HTML 简历中的关键文本可提取性、标头层级规范与 ATS 机器解析友好度。
- */
+/** Basic text availability is part of the same final-PDF acceptance gate. */
+import engine = require('../rendering/engine-loader');
+import type { EngineOptions, EngineResult } from '../rendering/browser-engine';
 
-import { chromium } from 'playwright';
-import * as path from 'path';
-import * as fs from 'fs';
-
-interface AtsValidationResult {
-  status: 'PASS' | 'WARN' | 'FAIL';
-  candidateName: string | null;
-  detectedContacts: {
-    email: string | null;
-    phone: 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') || document.querySelector('h1');
-    const candidateName = nameEl ? nameEl.textContent?.trim() || null : null;
-
-    const bodyText = document.body.innerText || '';
-    const emailMatch = bodyText.match(/[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+/);
-    const phoneMatch = bodyText.match(/1[3-9]\d{9}|\+?\d{1,4}[-\s]?\d{7,11}/);
-
-    const headings = Array.from(document.querySelectorAll('h1, h2, h3, h4')).map(h => ({
-      level: h.tagName.toLowerCase(),
-      text: h.textContent?.replace(/[\s\n]+/g, ' ').trim() || ''
-    }));
-
-    return {
-      candidateName,
-      email: emailMatch ? emailMatch[0] : null,
-      phone: phoneMatch ? phoneMatch[0] : null,
-      headings,
-      totalTextLength: bodyText.trim().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();
-    const isStandard = STANDARD_SECTION_HEADERS.some(sh => textClean.includes(sh.toLowerCase()));
-    return {
-      ...h,
-      isStandard
-    };
-  });
-
-  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: {
-      email: rawData.email,
-      phone: rawData.phone
-    },
-    headingsFound: validatedHeadings,
-    totalTextLength: rawData.totalTextLength,
-    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;
-    } else if (!args[i].startsWith('-')) {
-      htmlPath = args[i];
-    }
-  }
-
-  try {
-    const result = await validateAts(htmlPath);
-
-    if (jsonOutput) {
-      console.log(JSON.stringify(result, null, 2));
-      process.exit(result.status === 'FAIL' ? 1 : 0);
-    }
-
-    console.log('======================================================');
-    console.log(`  KnowMe CareerForge — ATS Compliance QA: [${result.status}]`);
-    console.log(`  Candidate Name : ${result.candidateName || 'NOT FOUND'}`);
-    console.log(`  Phone Extracted: ${result.detectedContacts.phone || 'NOT DETECTED'}`);
-    console.log(`  Email Extracted: ${result.detectedContacts.email || 'NOT DETECTED'}`);
-    console.log(`  Text Extracted : ${result.totalTextLength} characters`);
-    console.log('------------------------------------------------------');
-    console.log('  Headings Structure:');
-    for (const h of result.headingsFound) {
-      const mark = h.isStandard ? '[✓]' : '[?]';
-      console.log(`    ${mark} <${h.level}> ${h.text}`);
-    }
-
-    if (result.warnings.length > 0) {
-      console.log('\n[!] Warnings:');
-      for (const w of result.warnings) {
-        console.log(`  - ⚠️  ${w}`);
-      }
-    }
-
-    if (result.errors.length > 0) {
-      console.log('\n[✗] Errors:');
-      for (const e of result.errors) {
-        console.log(`  - ✗ ${e}`);
-      }
-    }
-
-    console.log('======================================================');
-    process.exit(result.status === 'FAIL' ? 1 : 0);
-  } catch (err: unknown) {
-    const errorMsg = err instanceof Error ? err.message : String(err);
-    console.error(`[✗] ATS Validation Failed: ${errorMsg}`);
-    process.exit(1);
-  }
-}
-
-if (require.main === module) {
-  main();
+export function validateAts(htmlPath: string, expectedPages = 1, options: EngineOptions = {}): Promise<EngineResult> {
+  return engine.run(htmlPath, { ...options, expectedPages });
 }
+if (require.main === module) engine.cli();

package/scripts/validation/validate-layout.ts

@@ -1,162 +1,8 @@
 #!/usr/bin/env ts-node
-/**
- * KnowMe CareerForge — Playwright DOM Layout & Overflow Inspector
- * 基于无头浏览器真实渲染计算 DOM 盒模型高度，检测单页/双页物理 A4 溢出与孤行。
- */
+import engine = require('../rendering/engine-loader');
+import type { EngineOptions, EngineResult } from '../rendering/browser-engine';
 
-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;
-    actualHeightPx: number;
-    allowedHeightPx: number;
-    isOverflow: boolean;
-    overflowDeltaPx: number;
-  }>;
-  overflowSections: Array<{
-    selector: string;
-    bottomPx: number;
-    overflowByPx: number;
-  }>;
-}
-
-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: 1
-  });
-
-  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((p, idx) => {
-      const rect = p.getBoundingClientRect();
-      const actualHeight = Math.ceil(rect.height);
-      const isOverflow = actualHeight > allowedHeight + 2; // 2px 浮点容差
-      return {
-        pageIndex: idx + 1,
-        actualHeightPx: actualHeight,
-        allowedHeightPx: allowedHeight,
-        isOverflow,
-        overflowDeltaPx: isOverflow ? Math.ceil(actualHeight - allowedHeight) : 0
-      };
-    });
-
-    const overflowSections: Array<{ selector: string; bottomPx: number; overflowByPx: number }> = [];
-    if (details.some(d => d.isOverflow)) {
-      const items = Array.from(document.querySelectorAll('.experience-item, .project-item, .skills-content, .resume-section'));
-      for (const item of items) {
-        const rect = item.getBoundingClientRect();
-        if (rect.bottom > allowedHeight) {
-          overflowSections.push({
-            selector: item.className ? `.${item.className.split(' ').join('.')}` : item.tagName.toLowerCase(),
-            bottomPx: Math.ceil(rect.bottom),
-            overflowByPx: Math.ceil(rect.bottom - allowedHeight)
-          });
-        }
-      }
-    }
-
-    return {
-      totalPagesFound: pages.length || 1,
-      pageDetails: details.length ? details : [{
-        pageIndex: 1,
-        actualHeightPx: Math.ceil(document.body.getBoundingClientRect().height),
-        allowedHeightPx: allowedHeight,
-        isOverflow: document.body.getBoundingClientRect().height > allowedHeight + 2,
-        overflowDeltaPx: Math.max(0, Math.ceil(document.body.getBoundingClientRect().height - allowedHeight))
-      }],
-      overflowSections
-    };
-  }, 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;
-    } else if (!args[i].startsWith('-')) {
-      htmlPath = args[i];
-    }
-  }
-
-  try {
-    const result = await validateLayout(htmlPath, expectedPages);
-
-    if (jsonOutput) {
-      console.log(JSON.stringify(result, null, 2));
-      process.exit(result.status === 'PASS' ? 0 : 1);
-    }
-
-    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 fitText = p.isOverflow ? `[✗ OVERFLOW by ${p.overflowDeltaPx}px]` : `[✓ FIT] (Overflow: ${p.overflowDeltaPx}px)`;
-      console.log(`  Page ${p.pageIndex}: ${p.actualHeightPx}px / ${p.allowedHeightPx}px ${fitText}`);
-    }
-
-    if (result.overflowSections.length > 0) {
-      console.log('\n[!] Offending Overflow Elements:');
-      for (const el of result.overflowSections.slice(0, 3)) {
-        console.log(`  - Element "${el.selector}" exceeds A4 baseline by ${el.overflowByPx}px (Bottom: ${el.bottomPx}px)`);
-      }
-      console.log('\n💡 Recommendation: Reduce --resume-space-section by 1~2pt or reduce --resume-font-size-body by 0.2pt in <style>.');
-    }
-
-    console.log('======================================================');
-    process.exit(result.status === 'PASS' ? 0 : 1);
-  } catch (err: unknown) {
-    const errorMsg = err instanceof Error ? err.message : String(err);
-    console.error(`[✗] Layout Validation Failed: ${errorMsg}`);
-    process.exit(1);
-  }
-}
-
-if (require.main === module) {
-  main();
+export function validateLayout(htmlPath: string, expectedPages = 1, options: EngineOptions = {}): Promise<EngineResult> {
+  return engine.run(htmlPath, { ...options, expectedPages });
 }
+if (require.main === module) engine.cli();

package/scripts/validation/validate-resume.py

@@ -1,148 +1,37 @@
 #!/usr/bin/env python3
-"""
-KnowMe CareerForge — Resume Validation Engine (Layout, Schema & ATS Compliance)
-验证 HTML 工作区简历的语义结构、Design Tokens 完整度与单页/双页排版合规性。
-"""
-
-import sys, os, json, argparse, re
+"""Validate print DOM and an actual temporary PDF through the shared engine."""
+import argparse
+import json
+import sys
 from pathlib import Path
 
-def get_project_root() -> Path:
-    curr = Path(__file__).resolve().parent
-    for _ in range(5):
-        if (curr / "SKILL.md").exists() or (curr / "package.json").exists():
-            return curr
-        curr = curr.parent
-    return Path.cwd()
-
-def validate_resume_html(html_path: str, expected_pages: int = 1) -> dict:
-    p = Path(html_path)
-    if not p.exists():
-        root = get_project_root()
-        alt = root / html_path
-        if alt.exists():
-            p = alt
-        else:
-            return {
-                "status": "FAIL",
-                "file": str(p),
-                "errors": [f"File not found: {html_path}"],
-                "warnings": [],
-                "checks": {}
-            }
-
-    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",
-        "--resume-space-section",
-        "--resume-color-primary"
-    ]
-    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"
+sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "rendering"))
+from browser_engine import run, exit_code
 
-    # 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)
+def validate_resume_html(html_path, expected_pages=1, auto_heal=False):
+    return run(html_path, expected_pages=expected_pages, auto_heal=auto_heal)
 
-    checks["detected_sections"] = detected_sections
 
-    # 6. 单页高度预估 (可见文字量)
-    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))
+def auto_heal_resume(html_path, max_pages=1):
+    result = validate_resume_html(html_path, max_pages, True)
+    return {**result.get("checks", {}).get("auto_heal", {}),
+            "healed": result["status"] == "PASS", "status": result["status"],
+            "errors": result["errors"]}
 
-    density_status = "OPTIMAL"
-    if expected_pages == 1:
-        if char_count > 1600:
-            warnings.append(f"High text density for 1 page: {char_count} chars (recommend trimming or reducing spacing tokens)")
-            density_status = "OVERFLOW_RISK"
-        elif char_count < 300:
-            warnings.append(f"Low content volume for 1 page: {char_count} chars")
-            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,
-        "errors": errors,
-        "warnings": warnings,
-        "checks": checks
-    }
 
 def main():
-    parser = argparse.ArgumentParser(description="KnowMe CareerForge — Resume Validator")
-    parser.add_argument("path", nargs="?", default="workspace/resume.html", help="Path to resume.html")
-    parser.add_argument("--html", help="Path to resume.html (named)")
-    parser.add_argument("--expected-pages", "-p", type=int, default=1, help="Expected target pages (1 or 2)")
-    parser.add_argument("--json", action="store_true", help="Output JSON result")
-
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("path", nargs="?", default="workspace/resume.html")
+    parser.add_argument("--html")
+    parser.add_argument("--expected-pages", "-p", type=int, default=1)
+    parser.add_argument("--auto-heal", action="store_true")
+    parser.add_argument("--json", action="store_true")
     args = parser.parse_args()
-    target_html = args.html or args.path
-    result = validate_resume_html(target_html, expected_pages=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}")
+    result = validate_resume_html(args.html or args.path, args.expected_pages, args.auto_heal)
+    print(json.dumps(result, ensure_ascii=False))
+    return exit_code(result)
 
-    print("=" * 70)
-    if result["status"] != "PASS":
-        sys.exit(1)
 
 if __name__ == "__main__":
-    main()
+    raise SystemExit(main())

package/skill.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/skill.json",
   "name": "knowme-careerforge",
   "displayName": "KnowMe CareerForge",
-  "version": "0.0.2",
+  "version": "0.0.6",
   "description": "An agent-native skill for self-discovery, career positioning, and tailored resume engineering. Know yourself. Define your direction. Forge your opportunity.",
   "author": "Miles <https://github.com/Max-Samson>",
   "license": "MIT",