knowme-careerforge-skill 0.0.1 → 0.0.2

package/dist/cli/src/index.js

@@ -63,26 +63,32 @@ 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
+  forge                 One-shot resume engineering pipeline (repo mining -> canvas -> QA -> PDF)
+  extract               Extract candidate evidence & facts from codebase/Git repo
+  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
+  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)
+Options (for forge):
+  --repo, -r <dir>      Target repository path (default: .)
+  --role <title>        Target role title
+  --jd <file|text>      Target job description
+  --template, -t <id>   Template ID (minimal, modern, executive, classic)
+  --name <name>         Candidate name override
+  --output, -o <path>   Output PDF path (default: workspace/resume.pdf)
+  --quiet, -q           Quiet execution (compact JSON output)
 
 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
+  knowme forge --repo . --role "AI Agent Engineer" --template modern
+  knowme extract --repo . --output workspace/evidence-master.json
+  knowme render workspace/resume.html workspace/resume.pdf
+  knowme init --ai codex
+  knowme init --all
 `);
 }
 function main() {
@@ -90,6 +96,36 @@ function main() {
     const command = args[0] || 'help';
     const rootDir = findPackageRoot(__dirname);
     switch (command) {
+        case 'forge': {
+            let scriptPath = path.join(rootDir, 'scripts', 'pipeline', 'forge.py');
+            if (!require('fs').existsSync(scriptPath))
+                scriptPath = path.join(rootDir, 'scripts', 'forge.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);
+            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);
+            break;
+        }
+        case 'render': {
+            let scriptPath = path.join(rootDir, 'scripts', 'rendering', 'render-pdf.py');
+            if (!require('fs').existsSync(scriptPath))
+                scriptPath = path.join(rootDir, 'scripts', 'render-pdf.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);
+            break;
+        }
         case 'init': {
             let platform = 'cursor';
             let all = false;
@@ -114,25 +150,32 @@ function main() {
             (0, list_1.runList)();
             break;
         case 'search': {
-            const role = args[1] || 'AI Agent Engineer';
-            const scriptPath = path.join(rootDir, 'scripts', 'search-template.py');
+            let scriptPath = path.join(rootDir, 'scripts', 'template', 'search-template.py');
+            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' });
             break;
         }
         case 'validate': {
-            const scriptPath = path.join(rootDir, 'scripts', 'validate-resume.py');
+            let scriptPath = path.join(rootDir, 'scripts', 'validation', 'validate-resume.py');
+            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' });
             break;
         }
         case 'gallery': {
-            const scriptPath = path.join(rootDir, 'scripts', 'build-gallery.py');
+            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' });
             break;
         }
         case 'test': {
-            const scriptPath = path.join(rootDir, 'scripts', 'run-all-tests.py');
+            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' });
             break;
         }

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

@@ -1,11 +1,2 @@
 #!/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

@@ -1,9 +1,5 @@
 #!/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);
@@ -38,68 +34,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderResumePdf = renderResumePdf;
-const playwright_1 = require("playwright");
+/** Forwarding shim for scripts/rendering/render-pdf.ts */
 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();
-}
+const child_process = __importStar(require("child_process"));
+const target = path.join(__dirname, 'rendering', 'render-pdf.ts');
+const proc = child_process.spawnSync('ts-node', [target, ...process.argv.slice(2)], { stdio: 'inherit' });
+process.exit(proc.status || 0);

package/dist/scripts/rendering/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/rendering/render-pdf.js

@@ -0,0 +1,109 @@
+#!/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' });
+    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();
+}

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

@@ -1,23 +1,2 @@
 #!/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 {};

package/dist/scripts/validate-ats.js

@@ -1,9 +1,5 @@
 #!/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);
@@ -38,132 +34,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateAts = validateAts;
-const playwright_1 = require("playwright");
+/** Forwarding shim for scripts/validation/validate-ats.ts */
 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, h1');
-        const name = nameEl ? (nameEl.textContent || '').trim() : null;
-        const fullText = (document.body.innerText || '').trim();
-        // 提取电话与邮箱
-        const phoneMatch = fullText.match(/(?:(?:\+|00)86)?1[3-9]\d{9}|(?:1[3-9]\d-\d{4}-\d{4})/);
-        const emailMatch = fullText.match(/[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+/);
-        const headings = Array.from(document.querySelectorAll('h1, h2, h3, .section-title, .sub-title')).map(h => ({
-            level: h.tagName.toLowerCase(),
-            text: (h.textContent || '').trim()
-        }));
-        return {
-            candidateName: name,
-            phone: phoneMatch ? phoneMatch[0] : null,
-            email: emailMatch ? emailMatch[0] : null,
-            headings,
-            fullTextLength: fullText.length
-        };
-    });
-    await browser.close();
-    const warnings = [];
-    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().replace(/[^\w\u4e00-\u9fa5]/g, '');
-        const isStd = STANDARD_SECTION_HEADERS.some(s => textClean.includes(s.toLowerCase().replace(/\s+/g, '')));
-        return {
-            level: h.level,
-            text: h.text,
-            isStandard: isStd
-        };
-    });
-    const nonStdHeadings = validatedHeadings.filter(h => !h.isStandard && h.level === 'h2');
-    if (nonStdHeadings.length > 0) {
-        warnings.push(`Non-standard section headings detected: ${nonStdHeadings.map(h => `"${h.text}"`).join(', ')}`);
-    }
-    const status = errors.length > 0 ? 'FAIL' : warnings.length > 0 ? 'WARN' : 'PASS';
-    return {
-        status,
-        candidateName: rawData.candidateName,
-        detectedContacts: {
-            phone: rawData.phone,
-            email: rawData.email
-        },
-        headingsFound: validatedHeadings,
-        totalTextLength: rawData.fullTextLength,
-        warnings,
-        errors
-    };
-}
-async function main() {
-    const args = process.argv.slice(2);
-    let htmlPath = 'workspace/resume.html';
-    let jsonOutput = false;
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === '--html' || args[i] === '-i') {
-            htmlPath = args[i + 1];
-            i++;
-        }
-        else if (args[i] === '--json') {
-            jsonOutput = true;
-        }
-    }
-    try {
-        const result = await validateAts(htmlPath);
-        if (jsonOutput) {
-            console.log(JSON.stringify(result, null, 2));
-            return;
-        }
-        console.log('======================================================');
-        console.log(`  KnowMe CareerForge — ATS Compliance QA: [${result.status}]`);
-        console.log(`  Candidate Name : ${result.candidateName || 'N/A'}`);
-        console.log(`  Phone Extracted: ${result.detectedContacts.phone || 'None'}`);
-        console.log(`  Email Extracted: ${result.detectedContacts.email || 'None'}`);
-        console.log(`  Text Extracted : ${result.totalTextLength} characters`);
-        console.log('------------------------------------------------------');
-        console.log('  Headings Structure:');
-        for (const h of result.headingsFound) {
-            const tag = h.isStandard ? '✓' : '?';
-            console.log(`    [${tag}] <${h.level}> ${h.text}`);
-        }
-        if (result.errors.length > 0) {
-            console.log('\n[!] Errors:');
-            for (const e of result.errors)
-                console.log(`  - ✗ ${e}`);
-        }
-        if (result.warnings.length > 0) {
-            console.log('\n[?] Warnings:');
-            for (const w of result.warnings)
-                console.log(`  - ⚠️ ${w}`);
-        }
-        console.log('======================================================');
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        console.error(`[✗] ATS Validation Failed: ${msg}`);
-        process.exit(1);
-    }
-}
-if (require.main === module) {
-    main();
-}
+const child_process = __importStar(require("child_process"));
+const target = path.join(__dirname, 'validation', 'validate-ats.ts');
+const proc = child_process.spawnSync('ts-node', [target, ...process.argv.slice(2)], { stdio: 'inherit' });
+process.exit(proc.status || 0);

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

@@ -1,24 +1,2 @@
 #!/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;
-        measuredHeightPx: number;
-        allowedHeightPx: number;
-        overflowPx: number;
-        isOverflow: boolean;
-    }>;
-    overflowSections: Array<{
-        selector: string;
-        heightPx: number;
-        textPreview: string;
-    }>;
-}
-export declare function validateLayout(htmlPath: string, expectedPages?: number): Promise<LayoutValidationResult>;
 export {};