knowme-careerforge-skill 0.0.4 → 0.0.7

package/agents/codex/knowme-careerforge.yaml

@@ -1,24 +1,6 @@
 name: knowme-careerforge
 description: An agent-native skill for self-discovery, career positioning, and tailored resume engineering.
-version: 0.0.4
+version: 0.0.7
 entrypoint: SKILL.md
-tools:
-  - name: forge
-    command: python3 scripts/pipeline/forge.py
-  - name: extract-evidence
-    command: python3 scripts/evidence/extract-evidence.py
-  - name: search-template
-    command: python3 scripts/template/search-template.py
-  - name: analyze-jd
-    command: python3 scripts/evidence/analyze-jd.py
-  - name: instantiate-resume
-    command: python3 scripts/template/instantiate-resume.py
-  - name: validate-resume
-    command: python3 scripts/validation/validate-resume.py
-  - name: render-pdf
-    command: python3 scripts/rendering/render-pdf.py
 rules:
-  - "Execute tools silently in background with --quiet (DO NOT print raw HTML, full CSS, or scripts in chat)."
-  - "Use workspace/resume.html as the sole Intermediate Working Canvas."
-  - "Deliver final concise summary and path to workspace/resume.pdf."
-  - "Reference AGENT.md, ARCHITECTURE.md, and references/01~06 for complete specifications."
+  - "Read SKILL.md at the installed skill root and follow it as the single runtime workflow. Resolve its scripts and references from that directory, not the candidate workspace. Load supporting references only when the current step needs them. Do not load AGENT.md or architecture documents to make a resume."

package/agents/cursor/knowme-careerforge.mdc

@@ -1,17 +1,8 @@
 ---
-description: KnowMe CareerForge — Agent-native career positioning and resume engineering
-globs: ["workspace/*", "src/**/*", "scripts/**/*", "references/*"]
+description: Resume drafting and verified delivery from user-provided facts
+alwaysApply: false
 ---
 
-# KnowMe CareerForge MDC Rules (Cursor)
+# KnowMe CareerForge
 
-When activated for career positioning, resume tailoring, or repo-to-resume analysis:
-
-1. **Evidence-First Invariant**: Enforce strict L1~L3 evidence classification (see `references/01-evidence-mining.md`). Never hallucinate ungrounded revenue metrics, fake degrees, or false tenures.
-2. **Repo-to-Resume Extraction**: Extract codebase facts using `python3 scripts/evidence/extract-evidence.py --repo .` or execute the one-shot pipeline `python3 scripts/pipeline/forge.py`.
-3. **Target Alignment & JD Parsing**: Analyze target Job Descriptions using `python3 scripts/evidence/analyze-jd.py` (see `references/03-jd-analysis.md`).
-4. **Template Search**: Match template via `python3 scripts/template/search-template.py "<Target Role>"` (see `references/04-template-selection.md`).
-5. **HTML Canvas Editing**: Edit exclusively in `workspace/resume.html` Intermediate Working Canvas (`scripts/template/instantiate-resume.py`). Calibrate CSS variables (`--resume-*`) in `:root` (see `references/05-html-canvas-tokens.md`).
-6. **Dual QA & Deterministic PDF**: Validate layout height ($297\text{mm} \le 1122.5\text{px}$) and ATS via `python3 scripts/validation/validate-resume.py`. Export final vector PDF via `python3 scripts/rendering/render-pdf.py`.
-7. **Quiet Execution Protocol**: Execute all tools silently with `--quiet`. Never output raw HTML/CSS into the chat. Deliver concise value proposition and direct output file paths.
-8. **Authoritative Guide**: Refer to root `AGENT.md` for Vercel-inspired editorial standards and `ARCHITECTURE.md` for system design.
+Read SKILL.md at the installed skill root and follow it as the single runtime workflow. Resolve its scripts and references from that directory, not the candidate workspace. Load supporting references only when the current step needs them. Do not load AGENT.md or architecture documents to make a resume.

package/agents/gemini/knowme-careerforge.json

@@ -1,6 +1,6 @@
 {
   "name": "knowme-careerforge",
   "description": "An agent-native skill for self-discovery, career positioning, and tailored resume engineering.",
-  "instructions": "Execute the 6-stage KnowMe CareerForge workflow: Know Me (L1~L3 evidence) -> Define -> Understand (JD signals) -> Position -> Forge (HTML canvas & tokens) -> Review (Dual QA & PDF export).",
+  "instructions": "Read SKILL.md at the installed skill root and follow it as the single runtime workflow. Resolve its scripts and references from that directory, not the candidate workspace. Load supporting references only when the current step needs them. Do not load AGENT.md or architecture documents to make a resume.",
   "entrypoint": "SKILL.md"
 }

package/agents/opencode/skill.yaml

@@ -1,7 +1,7 @@
 name: knowme-careerforge
 displayName: KnowMe CareerForge
 description: An agent-native skill for self-discovery, career positioning, and tailored resume engineering.
-version: 0.0.4
+version: 0.0.7
 schema: 1.0
 entrypoint: SKILL.md
 tags:

package/agents/windsurf/knowme-careerforge.rules

@@ -1,13 +1,3 @@
-# KnowMe CareerForge — Windsurf Rules
-# Trigger: Career discovery, resume tailoring, JD analysis, repo-to-resume
+# KnowMe CareerForge
 
-When user requests resume tailoring, project analysis, or career positioning:
-1. **Evidence Mining**: Extract candidate facts using `python3 scripts/evidence/extract-evidence.py --repo .` or execute one-shot `python3 scripts/pipeline/forge.py`.
-2. **Anti-Hallucination Gate**: Tag all experience items with Evidence Level (L1~L3 only, see `references/01-evidence-mining.md`).
-3. **JD & Signal Analysis**: Analyze target JD requirements using `python3 scripts/evidence/analyze-jd.py` (see `references/03-jd-analysis.md`).
-4. **Template Search**: Recommend best template using `python3 scripts/template/search-template.py` (see `references/04-template-selection.md`).
-5. **Canvas Instantiation**: Instantiate `workspace/resume.html` using `python3 scripts/template/instantiate-resume.py` and calibrate CSS design tokens (see `references/05-html-canvas-tokens.md`).
-6. **Dual QA Verification**: Validate DOM fit ($297\text{mm} \le 1122.5\text{px}$) and ATS compatibility using `python3 scripts/validation/validate-resume.py`.
-7. **Deterministic PDF Export**: Export final vector PDF using `python3 scripts/rendering/render-pdf.py` (see `references/06-qa-and-rendering.md`).
-8. **Quiet Delivery**: Execute silently in background (`--quiet`); deliver concise value proposition and direct output file paths (`workspace/resume.pdf`).
-9. **Authoritative Guide**: Refer to root `AGENT.md` for editorial standards and `ARCHITECTURE.md` for system architecture.
+Read SKILL.md at the installed skill root and follow it as the single runtime workflow. Resolve its scripts and references from that directory, not the candidate workspace. Load supporting references only when the current step needs them. Do not load AGENT.md or architecture documents to make a resume.

package/dist/cli/src/commands/init.js

@@ -70,6 +70,25 @@ function copyDirRecursive(src, dest) {
         }
     }
 }
+function copyRuntimeBundle(rootDir, destination) {
+    fs.mkdirSync(destination, { recursive: true });
+    for (const directory of ['scripts', 'src', 'references']) {
+        copyDirRecursive(path.join(rootDir, directory), path.join(destination, directory));
+    }
+    for (const file of ['SKILL.md', 'skill.json', 'package.json']) {
+        fs.copyFileSync(path.join(rootDir, file), path.join(destination, file));
+    }
+    // npm archives omit package-lock.json; source checkouts can retain a locked install.
+    const lock = path.join(rootDir, 'package-lock.json');
+    const installedLock = path.join(destination, 'package-lock.json');
+    if (fs.existsSync(lock))
+        fs.copyFileSync(lock, installedLock);
+    else
+        fs.rmSync(installedLock, { force: true });
+    console.log(`Runtime files copied -> ${destination}`);
+    console.log(`Prepare dependencies in that directory: npm ${fs.existsSync(lock) ? 'ci' : 'install'} --omit=dev`);
+    console.log('Then run: node scripts/rendering/browser-engine.js --check-runtime');
+}
 function runInit(options) {
     const rootDir = findPackageRoot(__dirname);
     const projectDir = options.projectDir ? path.resolve(options.projectDir) : process.cwd();
@@ -85,82 +104,82 @@ function runInit(options) {
     console.log(`  Target Project: ${projectDir}`);
     console.log(`  Platforms     : ${targetPlatforms.join(', ')}`);
     console.log('==============================================================');
+    let failures = 0;
     for (const plat of targetPlatforms) {
         try {
             switch (plat) {
                 case 'claude': {
                     const claudeDir = path.join(homeDir, '.claude', 'skills', 'knowme-careerforge');
-                    fs.mkdirSync(claudeDir, { recursive: true });
-                    copyDirRecursive(path.join(rootDir, 'scripts'), path.join(claudeDir, 'scripts'));
-                    copyDirRecursive(path.join(rootDir, 'src'), path.join(claudeDir, 'src'));
-                    copyDirRecursive(path.join(rootDir, 'references'), path.join(claudeDir, 'references'));
-                    fs.copyFileSync(path.join(rootDir, 'SKILL.md'), path.join(claudeDir, 'SKILL.md'));
-                    fs.copyFileSync(path.join(rootDir, 'AGENT.md'), path.join(claudeDir, 'AGENT.md'));
-                    fs.copyFileSync(path.join(rootDir, 'ARCHITECTURE.md'), path.join(claudeDir, 'ARCHITECTURE.md'));
-                    fs.copyFileSync(path.join(rootDir, 'skill.json'), path.join(claudeDir, 'skill.json'));
-                    console.log(`[✓] Claude Code Skill fully bundled -> ${claudeDir}`);
+                    copyRuntimeBundle(rootDir, claudeDir);
+                    console.log(`[✓] Claude Code Skill files installed -> ${claudeDir}`);
                     break;
                 }
                 case 'codex': {
                     const codexDir = path.join(homeDir, '.codex', 'skills', 'knowme-careerforge');
-                    fs.mkdirSync(codexDir, { recursive: true });
-                    copyDirRecursive(path.join(rootDir, 'scripts'), path.join(codexDir, 'scripts'));
-                    copyDirRecursive(path.join(rootDir, 'src'), path.join(codexDir, 'src'));
-                    copyDirRecursive(path.join(rootDir, 'references'), path.join(codexDir, 'references'));
-                    fs.copyFileSync(path.join(rootDir, 'SKILL.md'), path.join(codexDir, 'SKILL.md'));
-                    fs.copyFileSync(path.join(rootDir, 'AGENT.md'), path.join(codexDir, 'AGENT.md'));
-                    fs.copyFileSync(path.join(rootDir, 'ARCHITECTURE.md'), path.join(codexDir, 'ARCHITECTURE.md'));
-                    fs.copyFileSync(path.join(rootDir, 'skill.json'), path.join(codexDir, 'skill.json'));
+                    copyRuntimeBundle(rootDir, codexDir);
                     if (fs.existsSync(path.join(rootDir, 'agents', 'codex', 'knowme-careerforge.yaml'))) {
                         fs.copyFileSync(path.join(rootDir, 'agents', 'codex', 'knowme-careerforge.yaml'), path.join(codexDir, 'skill.yaml'));
                     }
-                    console.log(`[✓] Codex Native Skill fully bundled -> ${codexDir}`);
+                    console.log(`[✓] Codex Native Skill files installed -> ${codexDir}`);
                     break;
                 }
                 case 'cursor': {
                     const cursorRulesDir = path.join(projectDir, '.cursor', 'rules');
                     fs.mkdirSync(cursorRulesDir, { recursive: true });
+                    const runtimeDir = path.join(projectDir, '.knowme', 'skills', 'knowme-careerforge');
+                    copyRuntimeBundle(rootDir, runtimeDir);
                     const mdcContent = fs.readFileSync(path.join(rootDir, 'agents', 'cursor', 'knowme-careerforge.mdc'), 'utf-8');
-                    fs.writeFileSync(path.join(cursorRulesDir, 'knowme-careerforge.mdc'), mdcContent, 'utf-8');
+                    fs.writeFileSync(path.join(cursorRulesDir, 'knowme-careerforge.mdc'), mdcContent + `\nRuntime entry: ${JSON.stringify(path.join(runtimeDir, 'SKILL.md'))}\n`, 'utf-8');
                     console.log(`[✓] Cursor MDC Rule configured -> ${path.join(cursorRulesDir, 'knowme-careerforge.mdc')}`);
                     break;
                 }
                 case 'windsurf': {
                     const windsurfRulePath = path.join(projectDir, '.windsurfrules');
+                    const runtimeDir = path.join(projectDir, '.knowme', 'skills', 'knowme-careerforge');
+                    copyRuntimeBundle(rootDir, runtimeDir);
                     const ruleContent = fs.readFileSync(path.join(rootDir, 'agents', 'windsurf', 'knowme-careerforge.rules'), 'utf-8');
-                    fs.appendFileSync(windsurfRulePath, `\n\n${ruleContent}`, 'utf-8');
+                    const begin = '<!-- knowme-careerforge:start -->';
+                    const end = '<!-- knowme-careerforge:end -->';
+                    const previous = fs.existsSync(windsurfRulePath) ? fs.readFileSync(windsurfRulePath, 'utf-8') : '';
+                    const block = `${begin}\n${ruleContent}\nRuntime entry: ${JSON.stringify(path.join(runtimeDir, 'SKILL.md'))}\n${end}`;
+                    const managed = /<!-- knowme-careerforge:start -->[\s\S]*?<!-- knowme-careerforge:end -->/;
+                    fs.writeFileSync(windsurfRulePath, managed.test(previous) ? previous.replace(managed, () => block) : previous + `\n\n${block}\n`, 'utf-8');
                     console.log(`[✓] Windsurf Rule configured -> ${windsurfRulePath}`);
                     break;
                 }
                 case 'gemini': {
                     const geminiDir = path.join(homeDir, '.gemini', 'skills');
                     fs.mkdirSync(geminiDir, { recursive: true });
-                    const geminiJson = fs.readFileSync(path.join(rootDir, 'agents', 'gemini', 'knowme-careerforge.json'), 'utf-8');
-                    fs.writeFileSync(path.join(geminiDir, 'knowme-careerforge.json'), geminiJson, 'utf-8');
+                    const runtimeDir = path.join(geminiDir, 'knowme-careerforge');
+                    copyRuntimeBundle(rootDir, runtimeDir);
+                    const geminiConfig = JSON.parse(fs.readFileSync(path.join(rootDir, 'agents', 'gemini', 'knowme-careerforge.json'), 'utf-8'));
+                    geminiConfig.entrypoint = path.join(runtimeDir, 'SKILL.md');
+                    fs.writeFileSync(path.join(geminiDir, 'knowme-careerforge.json'), JSON.stringify(geminiConfig, null, 2) + '\n', 'utf-8');
                     console.log(`[✓] Gemini CLI Skill configured -> ${path.join(geminiDir, 'knowme-careerforge.json')}`);
                     break;
                 }
                 case 'opencode': {
                     const opencodeDir = path.join(projectDir, '.opencode', 'skills', 'knowme-careerforge');
-                    fs.mkdirSync(opencodeDir, { recursive: true });
-                    copyDirRecursive(path.join(rootDir, 'scripts'), path.join(opencodeDir, 'scripts'));
-                    copyDirRecursive(path.join(rootDir, 'src'), path.join(opencodeDir, 'src'));
-                    copyDirRecursive(path.join(rootDir, 'references'), path.join(opencodeDir, 'references'));
-                    fs.copyFileSync(path.join(rootDir, 'SKILL.md'), path.join(opencodeDir, 'SKILL.md'));
-                    fs.copyFileSync(path.join(rootDir, 'AGENT.md'), path.join(opencodeDir, 'AGENT.md'));
-                    fs.copyFileSync(path.join(rootDir, 'ARCHITECTURE.md'), path.join(opencodeDir, 'ARCHITECTURE.md'));
-                    fs.copyFileSync(path.join(rootDir, 'skill.json'), path.join(opencodeDir, 'skill.json'));
-                    console.log(`[✓] OpenCode Skill fully bundled -> ${opencodeDir}`);
+                    copyRuntimeBundle(rootDir, opencodeDir);
+                    console.log(`[✓] OpenCode Skill files installed -> ${opencodeDir}`);
                     break;
                 }
                 default:
+                    failures += 1;
                     console.log(`[!] Unknown platform: ${plat}. Supported: ${SUPPORTED_PLATFORMS.join(', ')}`);
             }
         }
         catch (err) {
+            failures += 1;
             const msg = err instanceof Error ? err.message : String(err);
             console.error(`[✗] Failed to initialize ${plat}: ${msg}`);
         }
     }
-    console.log('\n[✓] Skill setup complete. You can now use knowme-careerforge in your agent workflows!');
+    if (failures) {
+        process.exitCode = 1;
+        console.error(`[✗] ${failures} platform setup(s) failed.`);
+    }
+    else {
+        console.log('Configuration and runtime files installed. Prepare dependencies and check runtime before generating PDFs; host discovery must be verified separately.');
+    }
 }

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.7';
         }
     }
     catch { }
-    return '0.0.4';
+    return '0.0.7';
 }
 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>;