job_ops-mcp 0.3.0

package/dist/mcp/tools/batch_evaluate.js

@@ -0,0 +1,143 @@
+// batch_evaluate — api path. Rates all unrated (score_total IS NULL) jobs through the
+// configured LLM with the rubric. Strict JSON parse with PARSE_ERROR fallback: failed
+// jobs stay unrated and their score_detail records the parse_error + raw — never silent
+// zeros (study guide §4.3 gotcha).
+import { z } from 'zod';
+import { config } from '../../config.js';
+import { getDb, runInWriteLock } from '../../db.js';
+import { defineTool, okResult, errResult } from '../define.js';
+import { chatLogged, llmAvailable } from '../../core/llm.js';
+import { getMode } from '../../core/modes.js';
+import { combineNoVisa } from '../../core/reports.js';
+const ROLE_CATEGORIES = ['pm', 'ml_eng', 'data_eng', 'analytics_eng', 'swe', 'forward_deployed', 'other'];
+export const batchEvaluateTool = defineTool({
+    name: 'batch_evaluate',
+    title: 'Batch-rate unrated jobs via LLM',
+    description: 'api path. Selects unrated jobs (score_total IS NULL) matching the optional filter and rates each via the configured ' +
+        'LLM (Gemini default / DeepSeek). Returns an A-F tier distribution and any parse-error count. Never produces silent zeros.',
+    inputSchema: {
+        role_category: z.enum(ROLE_CATEGORIES).optional(),
+        company: z.string().optional().describe('Substring match on company name.'),
+        limit: z.number().int().min(1).max(500).default(50),
+        concurrency: z.number().int().min(1).max(8).default(2),
+    },
+    handler: async (args) => {
+        if (!llmAvailable()) {
+            return errResult('No LLM provider configured. Set MCP_JSA_LLM_PROVIDER=gemini and GEMINI_API_KEY, or use mode=chat on evaluate_job for the manual path.');
+        }
+        const rubric = getMode('rubric.md');
+        if (!rubric || rubric.startsWith('_missing'))
+            return errResult('modes/rubric.md missing');
+        // Pick jobs.
+        const where = ['j.score_total IS NULL', `j.status NOT IN ('rejected','discarded','skip')`];
+        const params = [];
+        if (args.role_category) {
+            where.push('j.role_category = ?');
+            params.push(args.role_category);
+        }
+        if (args.company) {
+            where.push('LOWER(COALESCE(c.name, j.company_name_raw)) LIKE ?');
+            params.push(`%${args.company.toLowerCase()}%`);
+        }
+        const rows = getDb().prepare(`
+      SELECT j.id, j.title, COALESCE(c.name, j.company_name_raw) AS company_name,
+             j.location_raw AS location, j.description
+      FROM jobs j LEFT JOIN companies c ON c.id = j.company_id
+      WHERE ${where.join(' AND ')}
+      ORDER BY datetime(j.discovered_at) DESC LIMIT ?
+    `).all(...params, args.limit);
+        if (!rows.length)
+            return okResult({ rated: 0, distribution: emptyDist(), parse_errors: 0, items: [] });
+        const distribution = emptyDist();
+        let parseErrors = 0;
+        const items = [];
+        // Bounded-concurrency loop without an extra dep.
+        const queue = rows.slice();
+        const workers = Array.from({ length: Math.min(args.concurrency, queue.length) }, async () => {
+            while (queue.length) {
+                const job = queue.shift();
+                try {
+                    const res = await rateOne(job, rubric);
+                    tierBump(distribution, res?.score_total);
+                    if (!res?.parsed)
+                        parseErrors++;
+                    items.push({ job_id: job.id, title: job.title, company: job.company_name,
+                        score_total: res?.score_total ?? null, role_category: res?.role_category ?? null,
+                        parse_ok: !!res?.parsed });
+                }
+                catch (e) {
+                    parseErrors++;
+                    items.push({ job_id: job.id, title: job.title, company: job.company_name, error: e?.message ?? String(e) });
+                }
+            }
+        });
+        await Promise.all(workers);
+        return okResult({
+            rated: items.length - parseErrors,
+            parse_errors: parseErrors,
+            distribution,
+            items: items.slice().sort((a, b) => (b.score_total ?? -1) - (a.score_total ?? -1)),
+        });
+    },
+});
+async function rateOne(job, rubric) {
+    const system = rubric +
+        '\n\n== INSTRUCTIONS ==\nScore the JD below per the rubric. Output ONLY the strict JSON object specified in "Output contract (chat mode)". No prose outside JSON.';
+    const user = `JOB title: ${job.title}\nCompany: ${job.company_name}\nLocation: ${job.location ?? ''}\n\nDESCRIPTION:\n${(job.description ?? '').slice(0, 8000)}`;
+    const call = await chatLogged('batch_evaluate', [
+        { role: 'system', content: system }, { role: 'user', content: user },
+    ], { responseFormat: 'json_object', temperature: 0.2, jobId: job.id });
+    if (!call.parseOk) {
+        // Persist parse error — keep score_total NULL so it stays in unrated bucket for retry.
+        await runInWriteLock(() => {
+            getDb().prepare(`
+        UPDATE jobs SET score_detail = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?
+      `).run(JSON.stringify({ parse_error: call.parseError, raw: call.text.slice(0, 800), mode: 'api', llm_call_id: call.id }), job.id);
+        });
+        return { parsed: null, score_total: null };
+    }
+    const p = call.parsed;
+    const resumeFit = clampInt(p.resume_fit);
+    const tasteFit = clampInt(p.taste_fit);
+    const visaFit = config.visaScoringEnabled ? clampInt(p.visa_fit) : null;
+    const score = config.visaScoringEnabled
+        ? clampInt(p.score_total ?? null)
+        : combineNoVisa(resumeFit, tasteFit);
+    await runInWriteLock(() => {
+        getDb().prepare(`
+      UPDATE jobs SET
+        score_total = ?, score_resume_fit = ?, score_taste_fit = ?, score_visa_fit = ?,
+        role_category = COALESCE(?, role_category),
+        seniority = COALESCE(?, seniority),
+        score_detail = ?, scored_at = CURRENT_TIMESTAMP, updated_at = CURRENT_TIMESTAMP
+      WHERE id = ?
+    `).run(score, resumeFit, tasteFit, visaFit, p.role_category ?? null, p.seniority ?? null, JSON.stringify({ ...p, mode: 'api', llm_call_id: call.id, visa_scoring_enabled: config.visaScoringEnabled }), job.id);
+    });
+    return { parsed: p, score_total: score, role_category: p.role_category };
+}
+function clampInt(n) {
+    if (n === null || n === undefined)
+        return null;
+    const x = Number(n);
+    if (!Number.isFinite(x))
+        return null;
+    return Math.max(0, Math.min(100, Math.round(x)));
+}
+function emptyDist() { return { A: 0, B: 0, C: 0, D: 0, F: 0, unrated: 0 }; }
+function tierBump(d, score) {
+    if (score == null) {
+        d.unrated++;
+        return;
+    }
+    if (score >= 85)
+        d.A++;
+    else if (score >= 75)
+        d.B++;
+    else if (score >= 60)
+        d.C++;
+    else if (score >= 40)
+        d.D++;
+    else
+        d.F++;
+}
+//# sourceMappingURL=batch_evaluate.js.map

package/dist/mcp/tools/batch_evaluate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch_evaluate.js","sourceRoot":"","sources":["../../../src/mcp/tools/batch_evaluate.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/evaluate_job.js

@@ -0,0 +1,181 @@
+// evaluate_job — two-step chat-mode evaluator.
+//
+// Step 1: caller passes `input` (URL or pasted JD). Server normalizes, persists a job row,
+//         returns { job_id, normalized_jd, rubric, report_format, career_packet } so the
+//         chat client can score + draft the 6-block report.
+// Step 2: caller calls evaluate_job again with the same job_id + a `report` payload + scores.
+//         Server persists the eval_report, updates job scores, returns the report link.
+//
+// api mode: requires GEMINI_API_KEY or DEEPSEEK_API_KEY. Runs both scoring + the 6-block
+// report through the LLM with the rubric/report_format as system messages. Strict JSON
+// parsing — never silent zeros (see core/llm.ts parseJsonStrict).
+import { z } from 'zod';
+import { config } from '../../config.js';
+import { adoptJobFromJD, getJob } from '../../core/jobs.js';
+import { normalizeJD } from '../../core/jd_normalize.js';
+import { saveReport } from '../../core/reports.js';
+import { getActiveCareerPacket } from '../../core/profile.js';
+import { chatLogged } from '../../core/llm.js';
+import { getMode } from '../../core/modes.js';
+import { defineTool, okResult, errResult } from '../define.js';
+const reportBlocks = {
+    archetype_detected: z.string().nullish(),
+    block_role_summary: z.string().nullish(),
+    block_cv_match: z.string().nullish(),
+    block_level: z.string().nullish(),
+    block_comp: z.string().nullish(),
+    block_personalize: z.string().nullish(),
+    block_interview: z.string().nullish(),
+    block_legitimacy: z.string().nullish(),
+    keywords: z.array(z.string()).nullish(),
+};
+const scores = {
+    resume_fit: z.number().int().min(0).max(100).optional(),
+    taste_fit: z.number().int().min(0).max(100).optional(),
+    visa_fit: z.number().int().min(0).max(100).optional(),
+    score_total: z.number().int().min(0).max(100).optional(),
+    reasoning: z.string().optional(),
+    concerns: z.string().nullish(),
+    role_category: z.string().optional(),
+    seniority: z.string().optional(),
+};
+export const evaluateJobTool = defineTool({
+    name: 'evaluate_job',
+    title: 'Evaluate a job',
+    description: 'Two-step JD evaluator. Step 1: pass `input` (URL or pasted JD) to get rubric + normalized JD. ' +
+        'Step 2: pass `job_id` + `report` + `scores` to persist the 6-block report and return its localhost link. ' +
+        'mode="api" runs both steps server-side via the configured LLM.',
+    inputSchema: {
+        input: z.string().min(1).optional()
+            .describe('A URL OR pasted JD text. Required on step 1.'),
+        job_id: z.string().optional()
+            .describe('Reuse an existing job row instead of adopting a new one. Set this on step 2.'),
+        mode: z.enum(['chat', 'api']).default('chat'),
+        title: z.string().optional().describe('Optional title override.'),
+        company: z.string().optional().describe('Optional company override.'),
+        location: z.string().optional(),
+        report: z.object(reportBlocks).optional()
+            .describe('Filled by chat on step 2 — the 6-block A–F (+G) markdown blocks.'),
+        scores: z.object(scores).strict().optional()
+            .describe('Filled by chat on step 2 — strict JSON scores per modes/rubric.md.'),
+    },
+    handler: async (args) => {
+        const mode = args.mode ?? 'chat';
+        const isFinalize = !!(args.report || args.scores);
+        // ── Step 2 (chat OR api) — finalize ────────────────────────────────────
+        if (isFinalize) {
+            if (!args.job_id)
+                return errResult('Finalize call requires job_id from the step-1 response.');
+            const job = getJob(args.job_id);
+            if (!job)
+                return errResult(`No job with id ${args.job_id}`);
+            const saved = await saveReport({
+                job_id: job.id,
+                mode,
+                raw_input: job.description ?? '',
+                blocks: normalizeBlocks(args.report),
+                scores: args.scores ?? {},
+            });
+            return okResult({
+                step: 'finalized',
+                job_id: job.id,
+                report_id: saved.id,
+                report_url: saved.url,
+                tracker_url: `${config.baseUrl}/`,
+            });
+        }
+        // ── Step 1 ──────────────────────────────────────────────────────────────
+        if (!args.input)
+            return errResult('First call requires `input` (URL or pasted JD).');
+        const jd = await normalizeJD(args.input);
+        const adopted = await adoptJobFromJD({
+            jd, title: args.title, company: args.company, location: args.location,
+        });
+        if (mode === 'chat') {
+            return okResult({
+                step: 'prepared',
+                job_id: adopted.id,
+                job_created: adopted.created,
+                normalized_jd: {
+                    source: jd.source,
+                    source_url: jd.source_url,
+                    title_guess: jd.title_guess,
+                    company_guess: jd.company_guess,
+                    char_count: jd.text.length,
+                    text: jd.text,
+                },
+                instructions: 'Read the three resources below, score the JD per modes/rubric.md (STRICT JSON), ' +
+                    'draft the 6-block A–F (+G) report per modes/report_format.md, then CALL evaluate_job ' +
+                    'AGAIN with { job_id, report, scores } to persist and get the report link.',
+                rubric: getMode('rubric.md'),
+                report_format: getMode('report_format.md'),
+                career_packet: getActiveCareerPacket()?.content ?? '_no active career packet_',
+            });
+        }
+        // ── Step 1 (api mode) — run scoring + report inline ─────────────────────
+        try {
+            const packet = getActiveCareerPacket()?.content ?? '';
+            const userMsg = `== JOB (title=${jd.title_guess ?? ''}, company=${jd.company_guess ?? ''}) ==\n${jd.text}`;
+            const scoringSystem = getMode('rubric.md') +
+                '\n\n== INSTRUCTIONS ==\n' +
+                'Score the JD below per the rubric. Output ONLY the strict JSON object specified in ' +
+                '"Output contract (chat mode)". No prose outside JSON.';
+            const blocksSystem = getMode('report_format.md') +
+                '\n\n== CAREER PACKET ==\n' + packet +
+                '\n\n== INSTRUCTIONS ==\n' +
+                'Draft the 6-block A–F (+G optional) report. Output STRICT JSON only with keys: ' +
+                'archetype_detected, block_role_summary, block_cv_match, block_level, block_comp, ' +
+                'block_personalize, block_interview, block_legitimacy, keywords (array of strings).';
+            // Scoring + blocks are independent given the same JD — run in parallel.
+            const [scoreCall, blocksCall] = await Promise.all([
+                chatLogged('evaluate_job.api.scores', [
+                    { role: 'system', content: scoringSystem }, { role: 'user', content: userMsg },
+                ], { responseFormat: 'json_object', temperature: 0.2, jobId: adopted.id }),
+                chatLogged('evaluate_job.api.blocks', [
+                    { role: 'system', content: blocksSystem }, { role: 'user', content: userMsg },
+                ], { responseFormat: 'json_object', temperature: 0.3, maxTokens: 6000, jobId: adopted.id }),
+            ]);
+            const scoreData = (scoreCall.parsed ?? null);
+            // Save — even on parse failure, persist what we have. NEVER silent zeros.
+            const saved = await saveReport({
+                job_id: adopted.id, mode: 'api',
+                raw_input: jd.text,
+                blocks: normalizeBlocks(blocksCall.parsed),
+                // Only attach scores if parsing succeeded — else leave NULL.
+                scores: scoreCall.parseOk && scoreData ? scoreData : undefined,
+            });
+            return okResult({
+                step: 'finalized',
+                mode: 'api',
+                job_id: adopted.id,
+                report_id: saved.id,
+                report_url: saved.url,
+                scoring_parse_ok: scoreCall.parseOk,
+                blocks_parse_ok: blocksCall.parseOk,
+                scoring_parse_error: scoreCall.parseError ?? null,
+                blocks_parse_error: blocksCall.parseError ?? null,
+                tracker_url: `${config.baseUrl}/`,
+            });
+        }
+        catch (e) {
+            return errResult(`api-mode evaluate_job failed: ${e?.message ?? String(e)}`);
+        }
+    },
+});
+// Single shape converter — used by both the chat-finalize and api paths so the keys-list
+// stays one source of truth and only ReportBlocks knows what the report shape is.
+function normalizeBlocks(raw) {
+    const r = raw ?? {};
+    return {
+        archetype_detected: r.archetype_detected ?? null,
+        block_role_summary: r.block_role_summary ?? null,
+        block_cv_match: r.block_cv_match ?? null,
+        block_level: r.block_level ?? null,
+        block_comp: r.block_comp ?? null,
+        block_personalize: r.block_personalize ?? null,
+        block_interview: r.block_interview ?? null,
+        block_legitimacy: r.block_legitimacy ?? null,
+        keywords: Array.isArray(r.keywords) ? r.keywords : null,
+    };
+}
+//# sourceMappingURL=evaluate_job.js.map

package/dist/mcp/tools/evaluate_job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate_job.js","sourceRoot":"","sources":["../../../src/mcp/tools/evaluate_job.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,2FAA2F;AAC3F,yFAAyF;AACzF,4DAA4D;AAC5D,8FAA8F;AAC9F,wFAAwF;AACxF,EAAE;AACF,yFAAyF;AACzF,uFAAuF;AACvF,kEAAkE;AAElE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAqB,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE/D,MAAM,YAAY,GAAG;IACnB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACxC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACxC,cAAc,EAAM,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACxC,WAAW,EAAS,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACxC,UAAU,EAAU,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACxC,iBAAiB,EAAG,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACxC,eAAe,EAAK,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACxC,gBAAgB,EAAI,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACxC,QAAQ,EAAY,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;CAClD,CAAC;AAEF,MAAM,MAAM,GAAG;IACb,UAAU,EAAK,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC1D,SAAS,EAAM,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC1D,QAAQ,EAAO,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC1D,WAAW,EAAI,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC1D,SAAS,EAAM,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAO,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAM,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACxC,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,gGAAgG;QAChG,2GAA2G;QAC3G,gEAAgE;IAClE,WAAW,EAAE;QACX,KAAK,EAAK,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;aACzB,QAAQ,CAAC,8CAA8C,CAAC;QACrE,MAAM,EAAI,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAClB,QAAQ,CAAC,8EAA8E,CAAC;QACrG,IAAI,EAAM,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACjD,KAAK,EAAK,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QACpE,OAAO,EAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACtE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,MAAM,EAAI,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;aAC9B,QAAQ,CAAC,kEAAkE,CAAC;QACzF,MAAM,EAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aACjC,QAAQ,CAAC,oEAAoE,CAAC;KAC5F;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC;QACjC,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;QAElD,0EAA0E;QAC1E,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAC,yDAAyD,CAAC,CAAC;YAC9F,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,GAAG;gBAAE,OAAO,SAAS,CAAC,kBAAkB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC;gBAC7B,MAAM,EAAE,GAAG,CAAC,EAAE;gBACd,IAAI;gBACJ,SAAS,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;gBAChC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC;gBACpC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;aAC1B,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;gBACd,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,GAAG,CAAC,EAAE;gBACd,SAAS,EAAE,KAAK,CAAC,EAAE;gBACnB,UAAU,EAAE,KAAK,CAAC,GAAG;gBACrB,WAAW,EAAE,GAAG,MAAM,CAAC,OAAO,GAAG;aAClC,CAAC,CAAC;QACL,CAAC;QAED,2EAA2E;QAC3E,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC,iDAAiD,CAAC,CAAC;QAErF,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC;YACnC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACtE,CAAC,CAAC;QAEH,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,OAAO,QAAQ,CAAC;gBACd,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,OAAO,CAAC,EAAE;gBAClB,WAAW,EAAE,OAAO,CAAC,OAAO;gBAC5B,aAAa,EAAE;oBACb,MAAM,EAAS,EAAE,CAAC,MAAM;oBACxB,UAAU,EAAK,EAAE,CAAC,UAAU;oBAC5B,WAAW,EAAI,EAAE,CAAC,WAAW;oBAC7B,aAAa,EAAE,EAAE,CAAC,aAAa;oBAC/B,UAAU,EAAK,EAAE,CAAC,IAAI,CAAC,MAAM;oBAC7B,IAAI,EAAW,EAAE,CAAC,IAAI;iBACvB;gBACD,YAAY,EACV,kFAAkF;oBAClF,uFAAuF;oBACvF,2EAA2E;gBAC7E,MAAM,EAAS,OAAO,CAAC,WAAW,CAAC;gBACnC,aAAa,EAAE,OAAO,CAAC,kBAAkB,CAAC;gBAC1C,aAAa,EAAE,qBAAqB,EAAE,EAAE,OAAO,IAAI,2BAA2B;aAC/E,CAAC,CAAC;QACL,CAAC;QAED,2EAA2E;QAC3E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,qBAAqB,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC;YACtD,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC,WAAW,IAAI,EAAE,aAAa,EAAE,CAAC,aAAa,IAAI,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC;YAE3G,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;gBACxC,0BAA0B;gBAC1B,qFAAqF;gBACrF,uDAAuD,CAAC;YAC1D,MAAM,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC;gBAC9C,2BAA2B,GAAG,MAAM;gBACpC,0BAA0B;gBAC1B,iFAAiF;gBACjF,mFAAmF;gBACnF,oFAAoF,CAAC;YAEvF,wEAAwE;YACxE,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChD,UAAU,CAAC,yBAAyB,EAAE;oBACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE;iBAC/E,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;gBAC1E,UAAU,CAAC,yBAAyB,EAAE;oBACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE;iBAC9E,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;aAC5F,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,CAAQ,CAAC;YAEpD,0EAA0E;YAC1E,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC;gBAC7B,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK;gBAC/B,SAAS,EAAE,EAAE,CAAC,IAAI;gBAClB,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC;gBAC1C,6DAA6D;gBAC7D,MAAM,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;aAC/D,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC;gBACd,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,OAAO,CAAC,EAAE;gBAClB,SAAS,EAAE,KAAK,CAAC,EAAE;gBACnB,UAAU,EAAE,KAAK,CAAC,GAAG;gBACrB,gBAAgB,EAAE,SAAS,CAAC,OAAO;gBACnC,eAAe,EAAG,UAAU,CAAC,OAAO;gBACpC,mBAAmB,EAAE,SAAS,CAAC,UAAU,IAAI,IAAI;gBACjD,kBAAkB,EAAG,UAAU,CAAC,UAAU,IAAI,IAAI;gBAClD,WAAW,EAAE,GAAG,MAAM,CAAC,OAAO,GAAG;aAClC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC,iCAAiC,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,yFAAyF;AACzF,kFAAkF;AAClF,SAAS,eAAe,CAAC,GAAQ;IAC/B,MAAM,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;IACpB,OAAO;QACL,kBAAkB,EAAE,CAAC,CAAC,kBAAkB,IAAI,IAAI;QAChD,kBAAkB,EAAE,CAAC,CAAC,kBAAkB,IAAI,IAAI;QAChD,cAAc,EAAM,CAAC,CAAC,cAAc,IAAQ,IAAI;QAChD,WAAW,EAAS,CAAC,CAAC,WAAW,IAAW,IAAI;QAChD,UAAU,EAAU,CAAC,CAAC,UAAU,IAAY,IAAI;QAChD,iBAAiB,EAAG,CAAC,CAAC,iBAAiB,IAAK,IAAI;QAChD,eAAe,EAAK,CAAC,CAAC,eAAe,IAAO,IAAI;QAChD,gBAAgB,EAAI,CAAC,CAAC,gBAAgB,IAAM,IAAI;QAChD,QAAQ,EAAY,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;KAClE,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/generate_materials.js

@@ -0,0 +1,126 @@
+// generate_materials — picks subsets from career_packet per JD using tailoring_rules.md.
+// Writes tailored_bullets + cover_letter_draft to applications. chat-mode default;
+// api-mode runs the LLM with strict-JSON parse. The brief: "never invent claims not in
+// career_packet" — we enforce this by re-checking the LLM output against the packet for
+// any concrete metrics it cites (best-effort; the chat is the final guard).
+import { z } from 'zod';
+import { randomUUID } from 'node:crypto';
+import { getDb, runInWriteLock } from '../../db.js';
+import { defineTool, okResult, errResult } from '../define.js';
+import { chatLogged } from '../../core/llm.js';
+import { getActiveCareerPacket } from '../../core/profile.js';
+import { scanForVisaLeakage } from '../../core/outreach_safety.js';
+import { getMode } from '../../core/modes.js';
+// `experience_bullets` is a map keyed by employer/role slug — the slugs come from the
+// user's own career_packet, so the renderer doesn't bake in any specific employer name.
+const materialsShape = z.object({
+    tagline: z.string().optional(),
+    experience_bullets: z.record(z.string(), z.array(z.string())).optional(),
+    projects_section: z.string().optional(),
+    skills_section: z.string().optional(),
+    cover_letter_body: z.string().optional(),
+    tailoring_notes: z.string().optional(),
+});
+export const generateMaterialsTool = defineTool({
+    name: 'generate_materials',
+    title: 'Generate tailored resume bullets + cover letter',
+    description: 'Picks bullets / tagline / cover from the active career_packet per the JD via tailoring_rules. ' +
+        'chat-mode default returns context for the chat to draft. api-mode calls the LLM, validates against ' +
+        'the visa rail, and writes tailored_bullets + cover_letter_draft to the application row.',
+    inputSchema: {
+        job_id: z.string().min(1),
+        mode: z.enum(['chat', 'api']).default('chat'),
+        materials: materialsShape.optional()
+            .describe('Provide on a second chat-mode call to persist what the chat drafted.'),
+    },
+    handler: async (args) => {
+        const db = getDb();
+        const job = db.prepare(`
+      SELECT j.*, COALESCE(c.name, j.company_name_raw) AS company_name
+      FROM jobs j LEFT JOIN companies c ON c.id = j.company_id WHERE j.id = ?
+    `).get(args.job_id);
+        if (!job)
+            return errResult(`No job ${args.job_id}`);
+        if (args.mode === 'chat' && args.materials) {
+            const result = await persistMaterials(args.job_id, args.materials);
+            return okResult(result);
+        }
+        if (args.mode === 'chat') {
+            return okResult({
+                instructions: 'Read modes/tailoring_rules.md and modes/career_packet.md. Pick subsets per JD. Output STRICT JSON ' +
+                    'matching the contract in tailoring_rules.md. NEVER invent metrics not in the packet. NEVER mention ' +
+                    'visa / OPT / sponsorship in any bullet or in the cover letter. Then call generate_materials AGAIN with `materials` to persist.',
+                job: { id: job.id, title: job.title, company: job.company_name, location: job.location_raw,
+                    role_category: job.role_category, seniority: job.seniority,
+                    description: job.description, requirements: job.requirements },
+                tailoring_rules: getMode('tailoring_rules.md'),
+                career_packet: getActiveCareerPacket()?.content ?? '',
+            });
+        }
+        // api mode
+        try {
+            const system = getMode('tailoring_rules.md') +
+                '\n\n== CAREER PACKET (AUTHORITATIVE — never invent claims outside this) ==\n' +
+                (getActiveCareerPacket()?.content ?? '') +
+                '\n\n== INSTRUCTIONS ==\nOutput STRICT JSON only. NO LaTeX in cover_letter_body. NO visa / OPT / sponsorship mentions.';
+            const user = JSON.stringify({
+                title: job.title, company: job.company_name, location: job.location_raw,
+                role_category: job.role_category, seniority: job.seniority,
+                description: (job.description ?? '').slice(0, 10_000),
+                requirements: job.requirements ?? null,
+            });
+            const call = await chatLogged('generate_materials.api', [
+                { role: 'system', content: system }, { role: 'user', content: user },
+            ], { responseFormat: 'json_object', temperature: 0.4, maxTokens: 6000, jobId: job.id });
+            if (!call.parseOk)
+                return errResult(`LLM produced unparseable output: ${call.parseError}`);
+            const m = call.parsed;
+            const result = await persistMaterials(args.job_id, m);
+            return okResult({ ...result, parse_ok: true });
+        }
+        catch (e) {
+            return errResult(`api generate_materials failed: ${e?.message ?? String(e)}`);
+        }
+    },
+});
+async function persistMaterials(job_id, m) {
+    // Final visa rail across all generated text.
+    const blob = JSON.stringify(m ?? {});
+    const leaks = scanForVisaLeakage(blob);
+    if (leaks.length) {
+        throw new Error(`materials failed visa rail: ${JSON.stringify(leaks)} — not persisted`);
+    }
+    return runInWriteLock(() => {
+        const db = getDb();
+        const existing = db.prepare(`SELECT id, materials_v FROM applications WHERE job_id = ?`).get(job_id);
+        const tailored = JSON.stringify({
+            tagline: m.tagline ?? null,
+            experience_bullets: m.experience_bullets ?? null,
+            projects_section: m.projects_section ?? null,
+            skills_section: m.skills_section ?? null,
+        });
+        if (existing) {
+            const newV = existing.materials_v + 1;
+            db.prepare(`
+        UPDATE applications SET
+          tailored_bullets = ?, cover_letter_draft = ?, tailoring_notes = ?,
+          materials_v = ?, status = 'materials_drafted', last_status_change_at = CURRENT_TIMESTAMP,
+          updated_at = CURRENT_TIMESTAMP,
+          resume_tex = NULL, cover_letter_tex = NULL  -- mark for re-render
+        WHERE id = ?
+      `).run(tailored, m.cover_letter_body ?? null, m.tailoring_notes ?? null, newV, existing.id);
+            // Mirror status onto jobs row.
+            db.prepare(`UPDATE jobs SET status = 'materials_drafted', materials_generated_at = CURRENT_TIMESTAMP, updated_at = CURRENT_TIMESTAMP WHERE id = ?`).run(job_id);
+            return { application_id: existing.id, job_id, materials_v: newV, status: 'materials_drafted' };
+        }
+        const appId = randomUUID();
+        db.prepare(`
+      INSERT INTO applications (
+        id, job_id, status, tailored_bullets, cover_letter_draft, tailoring_notes, materials_v
+      ) VALUES (?, ?, 'materials_drafted', ?, ?, ?, 1)
+    `).run(appId, job_id, tailored, m.cover_letter_body ?? null, m.tailoring_notes ?? null);
+        db.prepare(`UPDATE jobs SET status = 'materials_drafted', materials_generated_at = CURRENT_TIMESTAMP, updated_at = CURRENT_TIMESTAMP WHERE id = ?`).run(job_id);
+        return { application_id: appId, job_id, materials_v: 1, status: 'materials_drafted' };
+    });
+}
+//# sourceMappingURL=generate_materials.js.map

package/dist/mcp/tools/generate_materials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate_materials.js","sourceRoot":"","sources":["../../../src/mcp/tools/generate_materials.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/get_report.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { config } from '../../config.js';
+import { getLatestReport } from '../../core/reports.js';
+import { defineTool, okResult, errResult } from '../define.js';
+export const getReportTool = defineTool({
+    name: 'get_report',
+    title: 'Get the latest eval report for a job',
+    description: 'Returns the localhost HTML report link and metadata for the latest eval_report row for a job_id.',
+    inputSchema: { job_id: z.string().min(1) },
+    handler: async (args) => {
+        const row = getLatestReport(args.job_id);
+        if (!row)
+            return errResult(`No eval report for job ${args.job_id}. Run evaluate_job first.`);
+        return okResult({
+            job_id: args.job_id,
+            report_id: row.id,
+            archetype_detected: row.archetype_detected,
+            keywords: row.keywords,
+            url: `${config.baseUrl}/files/${row.html_path}`,
+            created_at: row.created_at,
+        });
+    },
+});
+//# sourceMappingURL=get_report.js.map

package/dist/mcp/tools/get_report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_report.js","sourceRoot":"","sources":["../../../src/mcp/tools/get_report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE/D,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,sCAAsC;IAC7C,WAAW,EAAE,kGAAkG;IAC/G,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;IAC1C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC,0BAA0B,IAAI,CAAC,MAAM,2BAA2B,CAAC,CAAC;QAC7F,OAAO,QAAQ,CAAC;YACd,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,GAAG,CAAC,EAAE;YACjB,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YAC1C,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,SAAS,EAAE;YAC/C,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}