knowme-careerforge-skill 0.0.4 → 0.0.6

package/dist/cli/src/index.js

@@ -58,11 +58,11 @@ function getVersion(rootDir) {
         const pkgJson = path.join(rootDir, 'package.json');
         if (require('fs').existsSync(pkgJson)) {
             const data = JSON.parse(require('fs').readFileSync(pkgJson, 'utf-8'));
-            return data.version || '0.0.4';
+            return data.version || '0.0.6';
         }
     }
     catch { }
-    return '0.0.4';
+    return '0.0.6';
 }
 function showHelp() {
     console.log(`
@@ -74,8 +74,7 @@ Usage:
   knowme <command> [options]
 
 Commands:
-  forge                 One-shot resume engineering pipeline (repo mining -> canvas -> QA -> PDF)
-  extract               Extract candidate evidence & facts from codebase/Git repo
+  forge                 Isolated user facts -> variant -> canvas -> verified PDF
   render                Multi-strategy deterministic A4 PDF export
   init                  Install and configure Skill for AI Agent platforms (cursor, claude, codex, windsurf, gemini, opencode)
   list                  Display all available role profiles and HTML templates
@@ -86,17 +85,19 @@ Commands:
   help                  Show this help message
 
 Options (for forge):
-  --repo, -r <dir>      Target repository path (default: .)
+  --profile-json <file> User/Agent prepared facts or Master document
+  --workspace <dir>    Parent for isolated run directories (default: workspace/runs)
+  --draft              Create a draft canvas without PDF delivery
   --role <title>        Target role title
   --jd <file|text>      Target job description
-  --template, -t <id>   Template ID (minimal, modern, executive, classic)
+  --template, -t <id>   Template ID (minimal, modern, executive, classic, academic-research, international-flow, creative-tech, compact-dense, startup-generalist, data-analyst)
   --name <name>         Candidate name override
-  --output, -o <path>   Output PDF path (default: workspace/resume.pdf)
+  --output, -o <path>   Optional verified PDF copy (default: isolated run)
+  --font-preset <name>  system or arial-unicode (requires local Arial Unicode MS)
+  --auto-heal           Enable heuristic token auto-healing to eliminate A4 height overflow
   --quiet, -q           Quiet execution (compact JSON output)
-
 Examples:
-  knowme forge --repo . --role "AI Agent Engineer" --template modern
-  knowme extract --repo . --output workspace/evidence-master.json
+  knowme forge --profile-json candidate.json --role "AI Agent Engineer" --template modern
   knowme render workspace/resume.html workspace/resume.pdf
   knowme init --ai codex
   knowme init --all
@@ -118,13 +119,8 @@ function main() {
             break;
         }
         case 'extract': {
-            let scriptPath = path.join(rootDir, 'scripts', 'evidence', 'extract-evidence.py');
-            if (!require('fs').existsSync(scriptPath))
-                scriptPath = path.join(rootDir, 'scripts', 'extract-evidence.py');
-            const passArgs = args.slice(1);
-            const proc = child_process.spawnSync('python3', [scriptPath, ...passArgs], { stdio: 'inherit' });
-            if (proc.status !== 0)
-                process.exit(proc.status || 1);
+            console.error('Repository-to-resume extraction is not supported. Use user-provided facts with forge --profile-json.');
+            process.exitCode = 1;
             break;
         }
         case 'render': {
@@ -165,7 +161,9 @@ function main() {
             if (!require('fs').existsSync(scriptPath))
                 scriptPath = path.join(rootDir, 'scripts', 'search-template.py');
             const passArgs = args.slice(1);
-            child_process.spawnSync('python3', [scriptPath, ...passArgs], { stdio: 'inherit' });
+            const proc = child_process.spawnSync('python3', [scriptPath, ...passArgs], { stdio: 'inherit' });
+            if (proc.status !== 0)
+                process.exit(proc.status || 1);
             break;
         }
         case 'validate': {
@@ -173,21 +171,27 @@ function main() {
             if (!require('fs').existsSync(scriptPath))
                 scriptPath = path.join(rootDir, 'scripts', 'validate-resume.py');
             const passArgs = args.slice(1);
-            child_process.spawnSync('python3', [scriptPath, ...passArgs], { stdio: 'inherit' });
+            const proc = child_process.spawnSync('python3', [scriptPath, ...passArgs], { stdio: 'inherit' });
+            if (proc.status !== 0)
+                process.exit(proc.status || 1);
             break;
         }
         case 'gallery': {
             let scriptPath = path.join(rootDir, 'scripts', 'build', 'build-gallery.py');
             if (!require('fs').existsSync(scriptPath))
                 scriptPath = path.join(rootDir, 'scripts', 'build-gallery.py');
-            child_process.spawnSync('python3', [scriptPath], { stdio: 'inherit' });
+            const proc = child_process.spawnSync('python3', [scriptPath], { stdio: 'inherit' });
+            if (proc.status !== 0)
+                process.exit(proc.status || 1);
             break;
         }
         case 'test': {
             let scriptPath = path.join(rootDir, 'scripts', 'build', 'run-all-tests.py');
             if (!require('fs').existsSync(scriptPath))
                 scriptPath = path.join(rootDir, 'scripts', 'run-all-tests.py');
-            child_process.spawnSync('python3', [scriptPath], { stdio: 'inherit' });
+            const proc = child_process.spawnSync('python3', [scriptPath], { stdio: 'inherit' });
+            if (proc.status !== 0)
+                process.exit(proc.status || 1);
             break;
         }
         case '--version':

package/dist/scripts/rendering/engine-loader.d.ts

@@ -0,0 +1,2 @@
+declare const engine: typeof import('./browser-engine');
+export = engine;

package/dist/scripts/rendering/engine-loader.js

@@ -0,0 +1,46 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// tsc does not copy JS. Resolve the shipped source engine from source or dist.
+let root = __dirname;
+while (!fs.existsSync(path.join(root, 'package.json'))) {
+    const parent = path.dirname(root);
+    if (parent === root)
+        throw new Error('Cannot locate browser engine project root');
+    root = parent;
+}
+const engine = require(path.join(root, 'scripts/rendering/browser-engine.js'));
+module.exports = engine;

package/dist/scripts/rendering/render-pdf.d.ts

@@ -1,11 +1,6 @@
 #!/usr/bin/env ts-node
-/**
- * KnowMe CareerForge — Playwright Deterministic PDF Renderer
- * 加载自包含 HTML 中间工作区，等待字体及样式准备就绪，输出标准像素级 A4 PDF。
- */
-interface RenderOptions {
+import type { EngineOptions, EngineResult } from './browser-engine';
+export declare function renderResumePdf(options: EngineOptions & {
     inputHtml: string;
     outputPdf: string;
-}
-export declare function renderResumePdf(options: RenderOptions): Promise<void>;
-export {};
+}): Promise<EngineResult>;

package/dist/scripts/rendering/render-pdf.js

@@ -1,109 +1,13 @@
 #!/usr/bin/env ts-node
 "use strict";
-/**
- * KnowMe CareerForge — Playwright Deterministic PDF Renderer
- * 加载自包含 HTML 中间工作区，等待字体及样式准备就绪，输出标准像素级 A4 PDF。
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderResumePdf = renderResumePdf;
-const playwright_1 = require("playwright");
-const path = __importStar(require("path"));
-const fs = __importStar(require("fs"));
+const engine = require("./engine-loader");
 async function renderResumePdf(options) {
-    const absoluteHtml = path.resolve(options.inputHtml);
-    const absolutePdf = path.resolve(options.outputPdf);
-    if (!fs.existsSync(absoluteHtml)) {
-        throw new Error(`Input HTML file does not exist: ${absoluteHtml}`);
-    }
-    const outputDir = path.dirname(absolutePdf);
-    if (!fs.existsSync(outputDir)) {
-        fs.mkdirSync(outputDir, { recursive: true });
-    }
-    console.log('======================================================');
-    console.log('  KnowMe CareerForge — Playwright PDF Renderer');
-    console.log(`  Source Canvas : ${absoluteHtml}`);
-    console.log(`  Target PDF    : ${absolutePdf}`);
-    console.log('======================================================');
-    const browser = await playwright_1.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');
-    await page.pdf({
-        path: absolutePdf,
-        format: 'A4',
-        printBackground: true,
-        preferCSSPageSize: true,
-        margin: { top: '0px', right: '0px', bottom: '0px', left: '0px' }
-    });
-    await browser.close();
-    console.log(`[✓] Deterministic PDF Rendered Successfully -> ${absolutePdf}`);
-}
-async function main() {
-    const args = process.argv.slice(2);
-    let inputHtml = 'workspace/resume.html';
-    let outputPdf = 'workspace/resume.pdf';
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === '--input' || args[i] === '-i') {
-            inputHtml = args[i + 1];
-            i++;
-        }
-        else if (args[i] === '--output' || args[i] === '-o') {
-            outputPdf = args[i + 1];
-            i++;
-        }
-        else if (!args[i].startsWith('-')) {
-            if (i === 0)
-                inputHtml = args[i];
-            else if (i === 1)
-                outputPdf = args[i];
-        }
-    }
-    try {
-        await renderResumePdf({ inputHtml, outputPdf });
-    }
-    catch (err) {
-        const errorMsg = err instanceof Error ? err.message : String(err);
-        console.error(`[✗] PDF Rendering Failed: ${errorMsg}`);
-        process.exit(1);
-    }
-}
-if (require.main === module) {
-    main();
+    const result = await engine.run(options.inputHtml, options);
+    if (result.status !== 'PASS')
+        throw new Error(JSON.stringify(result));
+    return result;
 }
+if (require.main === module)
+    engine.cli(process.argv.slice(2), { outputPdf: 'workspace/resume.pdf' });

package/dist/scripts/rendering/runtime.d.ts

@@ -0,0 +1,9 @@
+export interface PrintInspection {
+    status: 'PASS' | 'FAIL' | 'UNVERIFIED';
+    errors: string[];
+    warnings?: string[];
+    pdfPages?: number;
+    actualHeightPx?: number;
+    measurementSource?: string;
+}
+export declare function inspectPrint(htmlPath: string, expectedPages?: number, outputPdf?: string): PrintInspection;

package/dist/scripts/rendering/runtime.js

@@ -0,0 +1,63 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inspectPrint = inspectPrint;
+/** Typed bridge used by legacy TypeScript entry points and their compiled output. */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+function inspectPrint(htmlPath, expectedPages = 1, outputPdf) {
+    let root = __dirname;
+    while (!fs.existsSync(path.join(root, 'SKILL.md'))) {
+        const parent = path.dirname(root);
+        if (parent === root)
+            throw new Error('Skill root not found');
+        root = parent;
+    }
+    const args = [path.join(root, 'scripts/rendering/browser-engine.js'), path.resolve(htmlPath), '--expected-pages', String(expectedPages)];
+    if (outputPdf)
+        args.push('--output', path.resolve(outputPdf));
+    const result = (0, child_process_1.spawnSync)(process.execPath, args, { encoding: 'utf8', timeout: 120000 });
+    if (result.error)
+        throw result.error;
+    const parsed = JSON.parse(result.stdout);
+    if (!parsed || typeof parsed !== 'object' || !('status' in parsed) || !('errors' in parsed) || !Array.isArray(parsed.errors))
+        throw new Error('Invalid print inspection result');
+    if (parsed.status !== 'PASS' && parsed.status !== 'FAIL' && parsed.status !== 'UNVERIFIED')
+        throw new Error('Invalid print status');
+    if (result.status !== 0 && parsed.status === 'PASS')
+        throw new Error('Print engine exited unsuccessfully');
+    return parsed;
+}

package/dist/scripts/validation/validate-ats.d.ts

@@ -1,23 +1,3 @@
 #!/usr/bin/env ts-node
-/**
- * KnowMe CareerForge — ATS Text Flow & Heading Hierarchy Inspector
- * 验证 HTML 简历中的关键文本可提取性、标头层级规范与 ATS 机器解析友好度。
- */
-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[];
-}
-export declare function validateAts(htmlPath: string): Promise<AtsValidationResult>;
-export {};
+import type { EngineOptions, EngineResult } from '../rendering/browser-engine';
+export declare function validateAts(htmlPath: string, expectedPages?: number, options?: EngineOptions): Promise<EngineResult>;

package/dist/scripts/validation/validate-ats.js

@@ -1,173 +1,11 @@
 #!/usr/bin/env ts-node
 "use strict";
-/**
- * KnowMe CareerForge — ATS Text Flow & Heading Hierarchy Inspector
- * 验证 HTML 简历中的关键文本可提取性、标头层级规范与 ATS 机器解析友好度。
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateAts = validateAts;
-const playwright_1 = require("playwright");
-const path = __importStar(require("path"));
-const fs = __importStar(require("fs"));
-const STANDARD_SECTION_HEADERS = [
-    '工作经历', '工作经验', 'work experience', 'experience',
-    '项目经历', '核心项目', 'projects', 'key projects',
-    '专业技能', '核心技能', 'skills', 'technical skills',
-    '教育背景', '教育经历', 'education',
-    '核心领导力', '重大经历', '资质与证书', '求职意向'
-];
-async function validateAts(htmlPath) {
-    const absoluteHtml = path.resolve(htmlPath);
-    if (!fs.existsSync(absoluteHtml)) {
-        throw new Error(`HTML file not found: ${absoluteHtml}`);
-    }
-    const browser = await playwright_1.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 = [];
-    const errors = [];
-    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 = 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) {
-        const errorMsg = err instanceof Error ? err.message : String(err);
-        console.error(`[✗] ATS Validation Failed: ${errorMsg}`);
-        process.exit(1);
-    }
-}
-if (require.main === module) {
-    main();
+/** Basic text availability is part of the same final-PDF acceptance gate. */
+const engine = require("../rendering/engine-loader");
+function validateAts(htmlPath, expectedPages = 1, options = {}) {
+    return engine.run(htmlPath, { ...options, expectedPages });
 }
+if (require.main === module)
+    engine.cli();

package/dist/scripts/validation/validate-layout.d.ts

@@ -1,24 +1,3 @@
 #!/usr/bin/env ts-node
-/**
- * KnowMe CareerForge — Playwright DOM Layout & Overflow Inspector
- * 基于无头浏览器真实渲染计算 DOM 盒模型高度，检测单页/双页物理 A4 溢出与孤行。
- */
-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 declare function validateLayout(htmlPath: string, expectedPages?: number): Promise<LayoutValidationResult>;
-export {};
+import type { EngineOptions, EngineResult } from '../rendering/browser-engine';
+export declare function validateLayout(htmlPath: string, expectedPages?: number, options?: EngineOptions): Promise<EngineResult>;