knowme-careerforge-skill 0.0.1

package/agents/claude/knowme-careerforge.md

@@ -0,0 +1,16 @@
+---
+description: An agent-native skill for self-discovery, career positioning, and tailored resume engineering.
+globs: ["workspace/*", "src/**/*"]
+---
+
+# KnowMe CareerForge — Claude Code Skill
+
+Know Yourself. Define Your Direction. Forge Your Opportunity.
+
+When activated, follow the 6-stage workflow:
+1. **Know Me**: Extract candidate facts, classify into L1~L3 evidence.
+2. **Define**: Establish target role, seniority, and Core Value Proposition.
+3. **Understand**: Analyze target JD via `python3 scripts/analyze-jd.py`.
+4. **Position**: Perform gap analysis, map evidence, design Resume Strategy.
+5. **CareerForge**: Search template (`python3 scripts/search-template.py`), instantiate `workspace/resume.html`, calibrate CSS tokens.
+6. **Review & Dual QA**: Run `python3 scripts/validate-resume.py`, self-heal overflow, render `workspace/resume.pdf` via `npx ts-node scripts/render-pdf.ts`.

package/agents/codex/knowme-careerforge.yaml

@@ -0,0 +1,15 @@
+name: knowme-careerforge
+description: An agent-native skill for self-discovery, career positioning, and tailored resume engineering.
+version: 1.0.0
+entrypoint: SKILL.md
+tools:
+  - name: search-template
+    command: python3 scripts/search-template.py
+  - name: analyze-jd
+    command: python3 scripts/analyze-jd.py
+  - name: instantiate-resume
+    command: python3 scripts/instantiate-resume.py
+  - name: validate-resume
+    command: python3 scripts/validate-resume.py
+  - name: render-pdf
+    command: npx ts-node scripts/render-pdf.ts

package/agents/cursor/knowme-careerforge.mdc

@@ -0,0 +1,12 @@
+---
+description: KnowMe CareerForge — Agent-native career positioning and resume engineering
+globs: ["workspace/*", "src/**/*"]
+---
+
+# KnowMe CareerForge MDC Rules
+
+1. Enforce Evidence-First discipline: Never hallucinate ungrounded claims (L1~L3 only).
+2. Edit exclusively in `workspace/resume.html` intermediate working canvas.
+3. Use `python3 scripts/search-template.py` to pick the optimal template.
+4. Use `python3 scripts/instantiate-resume.py` to generate the self-contained canvas.
+5. Validate using `python3 scripts/validate-resume.py` before rendering PDF.

package/agents/gemini/knowme-careerforge.json

@@ -0,0 +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).",
+  "entrypoint": "SKILL.md"
+}

package/agents/opencode/skill.yaml

@@ -0,0 +1,11 @@
+name: knowme-careerforge
+displayName: KnowMe CareerForge
+description: An agent-native skill for self-discovery, career positioning, and tailored resume engineering.
+version: 1.0.0
+schema: 1.0
+entrypoint: SKILL.md
+tags:
+  - career
+  - resume-engineering
+  - ats-friendly
+  - html-canvas

package/agents/windsurf/knowme-careerforge.rules

@@ -0,0 +1,10 @@
+# KnowMe CareerForge — Windsurf Rules
+# Trigger: Career discovery, resume tailoring, JD analysis
+
+When user requests resume tailoring or career analysis:
+1. Extract candidate facts and tag with Evidence Level (L1~L3).
+2. Analyze target JD requirements using scripts/analyze-jd.py.
+3. Recommend best template using scripts/search-template.py.
+4. Instantiate workspace/resume.html and calibrate CSS variables.
+5. Run scripts/validate-resume.py to check DOM fit and ATS compatibility.
+6. Export final PDF using scripts/render-pdf.ts.

package/bin/knowme.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * KnowMe CareerForge CLI Executable Entrypoint
+ * Standalone zero-dependency executable for npx knowme-careerforge / npm global install.
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+const distEntry = path.join(__dirname, '..', 'dist', 'cli', 'src', 'index.js');
+const srcEntry = path.join(__dirname, '..', 'cli', 'src', 'index.ts');
+
+if (fs.existsSync(distEntry)) {
+  const cli = require(distEntry);
+  if (typeof cli.main === 'function') {
+    cli.main();
+  }
+} else if (fs.existsSync(srcEntry)) {
+  try {
+    require('ts-node/register');
+    const cli = require(srcEntry);
+    if (typeof cli.main === 'function') {
+      cli.main();
+    }
+  } catch (e) {
+    console.error('[!] Precompiled CLI not found. Please run "npm run build" first.');
+    process.exit(1);
+  }
+} else {
+  console.error('[!] KnowMe CLI entrypoint not found.');
+  process.exit(1);
+}

package/dist/cli/src/commands/init.d.ts

@@ -0,0 +1,10 @@
+/**
+ * KnowMe CareerForge CLI — Init Command
+ * 一键将 Skill 注入并配置至指定 AI Agent 平台环境。
+ */
+export interface InitOptions {
+    platform?: string;
+    all?: boolean;
+    projectDir?: string;
+}
+export declare function runInit(options: InitOptions): void;

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

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * KnowMe CareerForge CLI — Init Command
+ * 一键将 Skill 注入并配置至指定 AI Agent 平台环境。
+ */
+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.runInit = runInit;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const SUPPORTED_PLATFORMS = ['claude', 'codex', 'cursor', 'windsurf', 'gemini', 'opencode'];
+function findPackageRoot(startDir) {
+    let curr = startDir;
+    for (let i = 0; i < 6; i++) {
+        if (fs.existsSync(path.join(curr, 'src', 'templates')) && fs.existsSync(path.join(curr, 'SKILL.md'))) {
+            return curr;
+        }
+        curr = path.dirname(curr);
+    }
+    return path.resolve(startDir, '../../..');
+}
+function runInit(options) {
+    const rootDir = findPackageRoot(__dirname);
+    const projectDir = options.projectDir ? path.resolve(options.projectDir) : process.cwd();
+    const homeDir = os.homedir();
+    const targetPlatforms = options.all
+        ? SUPPORTED_PLATFORMS
+        : options.platform
+            ? [options.platform.toLowerCase()]
+            : ['cursor'];
+    console.log('==============================================================');
+    console.log('  KnowMe CareerForge CLI — Skill Initializer');
+    console.log(`  Source Skill  : ${rootDir}`);
+    console.log(`  Target Project: ${projectDir}`);
+    console.log(`  Platforms     : ${targetPlatforms.join(', ')}`);
+    console.log('==============================================================');
+    for (const plat of targetPlatforms) {
+        try {
+            switch (plat) {
+                case 'claude': {
+                    const claudeDir = path.join(homeDir, '.claude', 'skills', 'knowme-careerforge');
+                    fs.mkdirSync(claudeDir, { recursive: true });
+                    const skillMd = fs.readFileSync(path.join(rootDir, 'SKILL.md'), 'utf-8');
+                    fs.writeFileSync(path.join(claudeDir, 'SKILL.md'), skillMd, 'utf-8');
+                    console.log(`[✓] Claude Code Skill configured -> ${claudeDir}`);
+                    break;
+                }
+                case 'codex': {
+                    const codexDir = path.join(homeDir, '.codex', 'skills', 'knowme-careerforge');
+                    fs.mkdirSync(codexDir, { recursive: true });
+                    const skillMd = fs.readFileSync(path.join(rootDir, 'SKILL.md'), 'utf-8');
+                    fs.writeFileSync(path.join(codexDir, 'SKILL.md'), skillMd, 'utf-8');
+                    console.log(`[✓] Codex Native Skill configured -> ${codexDir}`);
+                    break;
+                }
+                case 'cursor': {
+                    const cursorRulesDir = path.join(projectDir, '.cursor', 'rules');
+                    fs.mkdirSync(cursorRulesDir, { recursive: true });
+                    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');
+                    console.log(`[✓] Cursor MDC Rule configured -> ${path.join(cursorRulesDir, 'knowme-careerforge.mdc')}`);
+                    break;
+                }
+                case 'windsurf': {
+                    const windsurfRulePath = path.join(projectDir, '.windsurfrules');
+                    const ruleContent = fs.readFileSync(path.join(rootDir, 'agents', 'windsurf', 'knowme-careerforge.rules'), 'utf-8');
+                    fs.appendFileSync(windsurfRulePath, `\n\n${ruleContent}`, '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');
+                    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 });
+                    const skillYaml = fs.readFileSync(path.join(rootDir, 'agents', 'opencode', 'skill.yaml'), 'utf-8');
+                    fs.writeFileSync(path.join(opencodeDir, 'skill.yaml'), skillYaml, 'utf-8');
+                    console.log(`[✓] OpenCode Skill configured -> ${opencodeDir}`);
+                    break;
+                }
+                default:
+                    console.log(`[!] Unknown platform: ${plat}. Supported: ${SUPPORTED_PLATFORMS.join(', ')}`);
+            }
+        }
+        catch (err) {
+            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!');
+}

package/dist/cli/src/commands/list.d.ts

@@ -0,0 +1,5 @@
+/**
+ * KnowMe CareerForge CLI — List Command
+ * 列出本地知识库中所有可用岗位技能画像、核心模板与布局样式。
+ */
+export declare function runList(): void;

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

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * KnowMe CareerForge CLI — List Command
+ * 列出本地知识库中所有可用岗位技能画像、核心模板与布局样式。
+ */
+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.runList = runList;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function getRootDir() {
+    let curr = __dirname;
+    for (let i = 0; i < 6; i++) {
+        if (fs.existsSync(path.join(curr, 'src', 'templates')) && fs.existsSync(path.join(curr, 'SKILL.md'))) {
+            return curr;
+        }
+        curr = path.dirname(curr);
+    }
+    return path.resolve(__dirname, '../../..');
+}
+function runList() {
+    const rootDir = getRootDir();
+    const rolesDir = path.join(rootDir, 'src', 'knowledge', 'roles');
+    const templatesDir = path.join(rootDir, 'src', 'templates');
+    console.log('==============================================================');
+    console.log('  KnowMe CareerForge — Available Roles & Templates Inventory');
+    console.log(`  Package Root: ${rootDir}`);
+    console.log('==============================================================');
+    // 1. 列出岗位画像
+    console.log('\n[1. Structured Role Knowledge Profiles]:');
+    if (fs.existsSync(rolesDir)) {
+        const roleFiles = fs.readdirSync(rolesDir).filter(f => f.endsWith('.json'));
+        for (const rf of roleFiles) {
+            try {
+                const data = JSON.parse(fs.readFileSync(path.join(rolesDir, rf), 'utf-8'));
+                console.log(`  • [${data.id}] ${data.name} (${data.category})`);
+                console.log(`    Must-have: ${(data.mustHaveSkills || []).slice(0, 4).join(', ')}`);
+            }
+            catch { }
+        }
+    }
+    // 2. 列出核心模板
+    console.log('\n[2. Core HTML Resume Templates]:');
+    if (fs.existsSync(templatesDir)) {
+        const tDirs = fs.readdirSync(templatesDir).filter(d => d !== 'common');
+        for (const td of tDirs) {
+            const metaPath = path.join(templatesDir, td, 'metadata.json');
+            if (fs.existsSync(metaPath)) {
+                try {
+                    const meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+                    console.log(`  • [${meta.id}] ${meta.name} (Style: ${meta.style})`);
+                    console.log(`    Target: ${meta.layout?.targetPages} page(s) | ATS: ${meta.atsScoreTier} | Tone: ${meta.visualStyle?.tone}`);
+                    console.log(`    Tokens: ${(meta.customizableTokens || []).slice(0, 3).join(', ')}`);
+                }
+                catch { }
+            }
+        }
+    }
+    console.log('\n==============================================================');
+}

package/dist/cli/src/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env ts-node
+/**
+ * KnowMe CareerForge CLI — Main Entry Point
+ */
+export declare function showHelp(): void;
+export declare function main(): void;

package/dist/cli/src/index.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env ts-node
+"use strict";
+/**
+ * KnowMe CareerForge CLI — Main Entry Point
+ */
+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.showHelp = showHelp;
+exports.main = main;
+const child_process = __importStar(require("child_process"));
+const path = __importStar(require("path"));
+const init_1 = require("./commands/init");
+const list_1 = require("./commands/list");
+function findPackageRoot(startDir) {
+    let curr = startDir;
+    for (let i = 0; i < 6; i++) {
+        if (require('fs').existsSync(path.join(curr, 'src', 'templates')) && require('fs').existsSync(path.join(curr, 'SKILL.md'))) {
+            return curr;
+        }
+        curr = path.dirname(curr);
+    }
+    return path.resolve(startDir, '../../..');
+}
+function showHelp() {
+    console.log(`
+======================================================================
+  KnowMe CareerForge CLI — Know Yourself. Define Your Direction.
+======================================================================
+
+Usage:
+  knowme <command> [options]
+
+Commands:
+  init          Install and configure Skill for AI Agent platforms (cursor, claude, codex, windsurf, gemini, opencode)
+  list          Display all available role profiles and HTML templates
+  search <role> Search and rank templates for a specific role (e.g. knowme search "AI Agent Engineer")
+  validate      Validate working canvas HTML layout & ATS compliance
+  gallery       Build & refresh static HTML template gallery
+  test          Run full automated test suite
+  help          Show this help message
+
+Options (for init):
+  --ai, -a <platform>   Target platform (claude, codex, cursor, windsurf, gemini, opencode)
+  --all                 Install to all supported platforms
+  --project, -p <dir>   Target project directory (default: current directory)
+
+Examples:
+  npx knowme-careerforge init --ai cursor
+  npx knowme-careerforge init --ai claude
+  npx knowme-careerforge init --all
+  npx knowme-careerforge list
+  npx knowme-careerforge search "Senior Frontend Architect"
+  npx knowme-careerforge validate
+`);
+}
+function main() {
+    const args = process.argv.slice(2);
+    const command = args[0] || 'help';
+    const rootDir = findPackageRoot(__dirname);
+    switch (command) {
+        case 'init': {
+            let platform = 'cursor';
+            let all = false;
+            let projectDir = process.cwd();
+            for (let i = 1; i < args.length; i++) {
+                if (args[i] === '--ai' || args[i] === '-a') {
+                    platform = args[i + 1] || 'cursor';
+                    i++;
+                }
+                else if (args[i] === '--all') {
+                    all = true;
+                }
+                else if (args[i] === '--project' || args[i] === '-p') {
+                    projectDir = args[i + 1] || process.cwd();
+                    i++;
+                }
+            }
+            (0, init_1.runInit)({ platform, all, projectDir });
+            break;
+        }
+        case 'list':
+            (0, list_1.runList)();
+            break;
+        case 'search': {
+            const role = args[1] || 'AI Agent Engineer';
+            const scriptPath = path.join(rootDir, 'scripts', 'search-template.py');
+            const passArgs = args.slice(1);
+            child_process.spawnSync('python3', [scriptPath, ...passArgs], { stdio: 'inherit' });
+            break;
+        }
+        case 'validate': {
+            const scriptPath = path.join(rootDir, 'scripts', 'validate-resume.py');
+            const passArgs = args.slice(1);
+            child_process.spawnSync('python3', [scriptPath, ...passArgs], { stdio: 'inherit' });
+            break;
+        }
+        case 'gallery': {
+            const scriptPath = path.join(rootDir, 'scripts', 'build-gallery.py');
+            child_process.spawnSync('python3', [scriptPath], { stdio: 'inherit' });
+            break;
+        }
+        case 'test': {
+            const scriptPath = path.join(rootDir, 'scripts', 'run-all-tests.py');
+            child_process.spawnSync('python3', [scriptPath], { stdio: 'inherit' });
+            break;
+        }
+        case 'help':
+        case '--help':
+        case '-h':
+        default:
+            showHelp();
+            break;
+    }
+}
+if (require.main === module) {
+    main();
+}

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

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

package/dist/scripts/render-pdf.js

@@ -0,0 +1,105 @@
+#!/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"));
+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' });
+    // 确保所有 Web 字体准备就绪
+    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++;
+        }
+    }
+    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();
+}

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

@@ -0,0 +1,23 @@
+#!/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: {
+        phone: string | null;
+        email: 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 {};