@timurtekb/tekjobs 0.24.1

package/app/server/tailored-resume.mjs

@@ -0,0 +1,213 @@
+// A resume tailored to one posting, and the proof that it is still the same resume.
+//
+// The letter is prose and may say new sentences. The resume is a record and may not. Tailoring here means:
+// rewrite the summary for this posting, reorder and prune bullets, promote the products and skills the posting
+// cares about, tighten wording. It never adds a bullet, a title, an employer, a date or a number. The checker
+// enforces that mechanically: every bullet must trace to a line of the real resume, every figure must already
+// be there, every employer and date line must survive unchanged.
+import fs from 'node:fs';
+import * as store from './store.mjs';
+import { runLLM, runnerConfig, readVoice, letterClaims } from './cover-letter.mjs';
+import { _internals as resumeCheck } from '../../scraper/resume-sync.mjs';
+
+const EMPHASES = {
+  auto: 'Choose whichever emphasis the posting itself asks for, and commit to it.',
+  'design-systems': 'Lead with design systems: component architecture, tokens, accessibility gates, adoption across teams.',
+  'ai-product': 'Lead with AI product surfaces: retrieval, evaluation, agent tooling, making model behaviour legible.',
+};
+
+const RULES = `Hard rules, all binding. This is a factual document that the candidate will upload; a false line here is a lie on an application.
+- Keep every employer, job title, location and date range exactly as the RESUME states them. Do not add, remove, merge or reorder jobs. Do not change a single number.
+- Every bullet you write must be a rewording, tightening or straight copy of a bullet that exists in the RESUME for that same job. You may drop bullets, reorder them within a job, merge two into one, and cut words. You may not introduce a new claim, tool, outcome or responsibility. When in doubt, copy the original bullet.
+- The summary is the one part you write fresh, for this posting: two or three sentences describing the candidate in the terms this posting cares about. It describes the candidate, never the company or the team ("The Magic Team needs..." is wrong; "Design engineer who builds..." is right). No "I". No "more than a decade" opener. Facts only from the RESUME.
+- Reorder the Capabilities lines and the Selected independent products to put what this posting cares about first. Do not add capabilities the RESUME does not list.
+- No adjectives about the candidate ("strong", "passionate", "proven"). No em dashes or en dashes.
+- Output Markdown in exactly this structure and nothing else:
+
+# {Name}
+**{Title line}**
+{Location} | {phone} | {email} | {links, exactly as the RESUME's header gives them}
+
+## Summary
+{paragraph}
+
+## Experience
+### {Company} | {Title}
+{Dates} | {Location}
+- {bullet}
+
+(one ### block per job, all jobs, in the RESUME's order)
+
+## Capabilities
+- **{Group}:** {items}
+
+## Selected independent products
+### {Product} | {one-line descriptor}
+- {bullet}
+
+## Earlier experience
+{the RESUME's earlier-experience lines, unchanged}
+
+## Education
+{unchanged}`;
+
+export async function materials(id, { emphasis = 'auto', extra = '' } = {}) {
+  const job = store.getJob(id);
+  const packet = store.applicationPacket(id);
+  const { resume, profile } = store.profile();
+  if (!resume.trim()) throw Object.assign(new Error('No resume in the profile yet. Import one first (tekjobs resume <file>).'), { status: 409 });
+  const posting = job.sections.description.replace(/^>.*$/gm, '').trim();
+  const decided = ['Narrative', 'Tailored summary', 'Tailored bullets', 'Portfolio', 'Risks'].filter((f) => packet.values[f]).map((f) => `${f}: ${packet.values[f]}`).join('\n');
+  const voice = readVoice();
+  const prompt = [
+    `Tailor the candidate's resume to this posting. Same facts, same jobs, same dates, same numbers; different emphasis, order and summary.`,
+    `Emphasis: ${EMPHASES[emphasis] || EMPHASES.auto}`,
+    extra.trim() ? `The candidate also asked: ${extra.trim()}` : '',
+    RULES,
+    voice ? `=== HOW THE CANDIDATE WRITES (for the summary's register) ===\n${voice.split('## What a good letter')[0].trim()}` : '',
+    `=== POSTING ===\nCompany: ${job.company}\nTitle: ${job.title}\nLocation: ${job.location}\n\n${posting.slice(0, 8000)}`,
+    decided ? `=== WHAT HAS ALREADY BEEN DECIDED FOR THIS APPLICATION ===\n${decided}` : '',
+    `=== RESUME (the only source of facts; page markers like "Page 1" and "-- 1 of 2 --" are artifacts, drop them) ===\n${strip(resume)}`,
+    `=== PROFILE (context only; facts still come from the RESUME) ===\n${strip(profile).slice(0, 2500)}`,
+  ].filter(Boolean).join('\n\n');
+  return { id, company: job.company, title: job.title, emphasis, prompt, rules: RULES };
+}
+const strip = (md) => md.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, '').replace(/^>.*$/gm, '').trim();
+
+// ---------------- the check ----------------
+
+const STOP = new Set(['the', 'a', 'an', 'and', 'or', 'of', 'for', 'to', 'in', 'on', 'with', 'at', 'by', 'from', 'as', 'that', 'this', 'it', 'its', 'is', 'are', 'was', 'were', 'be', 'i', 'my', 'we', 'our', 'their', 'into', 'across', 'than', 'plus', 'also', 'then', 'so', 'own', 'built', 'build', 'led', 'lead', 'work', 'worked', 'team', 'teams', 'product', 'products']);
+const words = (s) => new Set(s.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, ' ').split(' ').filter((w) => w.length > 2 && !STOP.has(w)));
+/** How much of the bullet's substance appears in one source line: the share of its content words found there. */
+function bestTrace(bullet, sourceLines) {
+  const b = words(bullet);
+  if (b.size === 0) return { score: 1, line: '' };
+  let best = { score: 0, line: '' };
+  for (const line of sourceLines) {
+    const l = words(line);
+    let hit = 0; for (const w of b) if (l.has(w)) hit++;
+    const score = hit / b.size;
+    if (score > best.score) best = { score, line };
+  }
+  return best;
+}
+const TRACE_MIN = 0.6;
+
+/** Every bullet traces to the resume, every figure is already there, every job header is intact. */
+export function check(id, markdown) {
+  return checkAgainst(markdown, store.profile().resume);
+}
+export function checkAgainst(markdown, resumeText) {
+  const src = strip(resumeText);
+  const srcLines = resumeCheck.lines(src);
+  const warnings = [];
+  const out = String(markdown || '');
+  // Bullets: traceability.
+  const bullets = out.split(/\r?\n/).filter((l) => /^\s*-\s+/.test(l) && !/^\s*-\s+\*\*/.test(l)).map((l) => l.replace(/^\s*-\s+/, '').trim());
+  for (const b of bullets) {
+    const t = bestTrace(b, srcLines);
+    if (t.score < TRACE_MIN) warnings.push({ kind: 'trace', text: `Not on your resume (${Math.round(t.score * 100)}% overlap with the closest line): "${b.slice(0, 90)}"` });
+  }
+  // Figures: none new.
+  for (const c of letterClaims(out).filter((c) => !resumeCheck.stillClaimed(c, src))) warnings.push({ kind: 'claim', text: `"${c}" is not a figure your resume gives.` });
+  // Jobs: every "Company | Title" header from the source must appear, and no header may be new.
+  const srcHeads = srcLines.filter((l) => /\|/.test(l) && !/@|\d{3}\.\d{3}/.test(l) && !/^(design|engineering|ai and automation|platform)\b/i.test(l)).map((l) => l.split('|')[0].trim().toLowerCase()).filter((h) => h.length > 2);
+  const outHeads = [...out.matchAll(/^###\s+(.+?)\s*\|/gm)].map((m) => m[1].trim().toLowerCase());
+  for (const h of outHeads) if (!srcHeads.some((s) => s.startsWith(h) || h.startsWith(s))) warnings.push({ kind: 'header', text: `"${h}" is not a job or product on your resume.` });
+  // Dates: every date range in the output must exist in the source.
+  const dateRe = /\b(January|February|March|April|May|June|July|August|September|October|November|December|[A-Z][a-z]{2})\s+\d{4}\s*(?:-|–|to)\s*(?:Present|[A-Z][a-z]+\s+\d{4})/g;
+  const srcDates = new Set((src.match(dateRe) || []).map((d) => d.replace(/\s+/g, ' ')));
+  for (const d of new Set((out.match(dateRe) || []).map((d) => d.replace(/\s+/g, ' ')))) if (!srcDates.has(d)) warnings.push({ kind: 'date', text: `Date range "${d}" is not on your resume.` });
+  if (/[—–]/.test(out)) warnings.push({ kind: 'style', text: 'Contains an em or en dash.' });
+  const w = out.trim().split(/\s+/).length;
+  if (w > 900) warnings.push({ kind: 'length', text: `${w} words; the source resume is about ${src.split(/\s+/).length}. This will not fit two pages.` });
+  return { words: w, bullets: bullets.length, warnings };
+}
+
+// ---------------- storage ----------------
+
+// A note section ends at the next "## " line, and a resume is full of them. So the resume is stored with every
+// heading demoted two levels (its "## Experience" becomes "#### Experience"), which keeps it nested under the
+// note's own "## Tailored resume" heading, reads correctly in Obsidian, and comes back intact.
+export const demote = (md) => md.replace(/^(#{1,4}) /gm, '$1## ');
+export const promote = (md) => md.replace(/^#{2}(#{1,4}) /gm, '$1 ');
+
+export function saved(id) {
+  const stored = store.getSection(id, 'Tailored resume');
+  if (!stored) return null;
+  const text = promote(stored);
+  return { text, ...check(id, text) };
+}
+export function save(id, markdown, via = 'app') {
+  const clean = String(markdown || '').replace(/\r/g, '').replace(/^```(?:markdown|md)?\n|\n```\s*$/g, '').trim();
+  if (!/^#\s+\S/m.test(clean) || !/^## Experience/m.test(clean)) throw Object.assign(new Error('That does not look like a resume in the expected structure (needs a "# Name" heading and "## Experience").'), { status: 400 });
+  store.saveSection(id, 'Tailored resume', demote(clean), `Tailored ${store.isoDay()} (via ${via}). Same facts as the resume of record, reordered and re-summarised for this posting. Headings are nested under this one; the app and the print view restore them. Check the warnings, then print it.`);
+  store.saveApplicationDraft(id, { field: 'Resume variant', value: `Tailored for this posting ${store.isoDay()}; full text under "Tailored resume" in this note; print view at /api/jobs/${encodeURIComponent(id)}/resume.html` });
+  return saved(id);
+}
+
+// ---------------- the run ----------------
+
+const runs = new Map();
+export function state(id) {
+  const d = runs.get(id) || { running: false, startedAt: null, finishedAt: null, error: '', errorKind: '' };
+  return { ...d, saved: saved(id), runner: runnerConfig().command };
+}
+export function start(id, opts = {}) {
+  if (runs.get(id)?.running) return state(id);
+  store.getJob(id);
+  runs.set(id, { running: true, startedAt: new Date().toISOString(), finishedAt: null, error: '', errorKind: '' });
+  materials(id, opts).then((m) => runLLM(m.prompt, { timeoutMs: 300000 }))
+    .then((text) => { save(id, text, `app · ${runnerConfig().command}`); runs.set(id, { ...runs.get(id), running: false, finishedAt: new Date().toISOString() }); })
+    .catch((e) => runs.set(id, { ...runs.get(id), running: false, finishedAt: new Date().toISOString(), error: e.message, errorKind: e.kind || 'failed' }));
+  return state(id);
+}
+
+// ---------------- print view ----------------
+
+/** A self-contained page for "Print… → Save as PDF". Deliberately plain: one column, system-safe type, real margins. */
+export function html(id) {
+  const stored = store.getSection(id, 'Tailored resume');
+  if (!stored) throw Object.assign(new Error('No tailored resume for this job yet.'), { status: 404 });
+  const md = promote(stored);
+  const job = store.getJob(id);
+  const esc = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+  const inline = (s) => esc(s).replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>').replace(/\*(.+?)\*/g, '<em>$1</em>');
+  const lines = md.split(/\r?\n/);
+  let out = ''; let inList = false; let i = 0;
+  const closeList = () => { if (inList) { out += '</ul>'; inList = false; } };
+  while (i < lines.length) {
+    const l = lines[i];
+    if (/^\s*-\s+/.test(l)) { if (!inList) { out += '<ul>'; inList = true; } out += `<li>${inline(l.replace(/^\s*-\s+/, ''))}</li>`; i++; continue; }
+    closeList();
+    if (/^# /.test(l)) out += `<h1>${inline(l.slice(2))}</h1>`;
+    else if (/^## /.test(l)) out += `<h2>${inline(l.slice(3))}</h2>`;
+    else if (/^### /.test(l)) { const [role, ...rest] = l.slice(4).split('|'); out += `<h3><span>${inline(role.trim())}</span>${rest.length ? `<span class="t">${inline(rest.join('|').trim())}</span>` : ''}</h3>`; }
+    else if (l.trim()) out += `<p class="${i === 1 || /^\*\*.*\*\*$/.test(l.trim()) ? 'title' : ''}">${inline(l)}</p>`;
+    i++;
+  }
+  closeList();
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>${esc(job.company)} · resume</title>
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<style>
+  @page { size: Letter; margin: 0.6in 0.7in; }
+  html { font-size: 10.5pt; }
+  body { max-width: 7.6in; margin: 0 auto; padding: 24px; font-family: Inter, "Helvetica Neue", Arial, system-ui, sans-serif; color: #1a1a1a; line-height: 1.38; }
+  h1 { font-size: 20pt; margin: 0 0 2px; letter-spacing: -0.01em; }
+  .title { margin: 0 0 2px; font-weight: 600; }
+  h1 + .title + p, h1 + p { color: #444; margin: 0 0 14px; font-size: 9.5pt; }
+  h2 { font-size: 9pt; letter-spacing: 0.12em; text-transform: uppercase; color: #555; margin: 16px 0 6px; padding-bottom: 3px; border-bottom: 1px solid #ccc; }
+  h3 { display: flex; justify-content: space-between; gap: 12px; font-size: 10.5pt; margin: 10px 0 0; }
+  h3 .t { font-weight: 500; color: #333; }
+  h3 + p { margin: 0 0 4px; color: #555; font-size: 9.5pt; }
+  p { margin: 0 0 6px; }
+  ul { margin: 2px 0 6px; padding-left: 16px; }
+  li { margin: 0 0 2px; }
+  .bar { position: sticky; top: 0; display: flex; gap: 12px; align-items: center; justify-content: space-between; margin: -24px -24px 20px; padding: 10px 24px; background: #f3f8f6; border-bottom: 1px solid #dadfdd; font-size: 12px; }
+  .bar button { font: inherit; padding: 6px 12px; border: 1px solid #0f6e56; border-radius: 6px; background: #0f6e56; color: #fff; cursor: pointer; }
+  @media print { .bar { display: none; } body { padding: 0; } }
+</style></head><body>
+<div class="bar"><span>Tailored for <strong>${esc(job.company)}</strong>, ${esc(job.title)}. Print and choose "Save as PDF"; margins and page size are set.</span><button onclick="window.print()">Print / Save as PDF</button></div>
+${out}
+</body></html>`;
+}

package/cli.mjs

@@ -0,0 +1,205 @@
+#!/usr/bin/env node
+// tekjobs CLI: init a profile folder, import a resume, check onboarding, scan, serve, mcp.
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawn, spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = fileURLToPath(new URL('.', import.meta.url));
+const [cmd, ...rest] = process.argv.slice(2);
+const opt = (f) => { const i = rest.indexOf(f); return i >= 0 ? rest[i + 1] : undefined; };
+const HELP = `tekjobs — a local job-search machine
+
+  tekjobs init [dir] [--resume <file>]   create the profile folder (default ~/.tekjobs/profile), remember it, import a resume
+  tekjobs resume <file>                  import or replace the resume (PDF, DOCX, Markdown, text)
+  tekjobs resume sync [<url|file>]       refresh Profile/Resume.md from where you keep your resume (a link-shared
+                                         Google Doc, a public page, or a file); remembers the source; flags drafts
+                                         that quote claims you removed (--dry to preview)
+  tekjobs status                         what the onboarding still needs
+  tekjobs --version                      the installed version
+  tekjobs scan [--dry] [--criteria <name|file>]
+                                         fetch every board, score, write matches; --criteria scores this one run
+                                         with a named preset from Targets/Criteria/ instead of Search Criteria.md
+  tekjobs mail [--days N]                read the mailbox for application updates (confirmations, rejections,
+                                         interviews) through the local CLI's Gmail connector, read tools only;
+                                         matches them to notes; you confirm each one on the Today page
+  tekjobs add <url> [<url>...]           add postings you found yourself (LinkedIn, a newsletter, a friend);
+                                         each link is read once, scored, and written as a note unless one exists
+  tekjobs rescore --from <old.json>      apply changed scoring weights to notes that already exist (--dry to preview)
+  tekjobs rescore --stamp-only           record the current weights on every note without changing a score
+  tekjobs rescore --full [--dry]         score every note again from the note itself under the current criteria
+                                         (for location, description or seniority rule changes); notes already
+                                         at these weights are left alone
+  tekjobs schedule [--time HH:MM] [--print]
+                                         run the scan and the mail read every morning: creates the Windows task
+                                         (07:30 by default), or prints the crontab or launchd line for macOS and
+                                         Linux; --print shows the command without installing anything
+  tekjobs serve                          the app + API on http://127.0.0.1:8787
+  tekjobs mcp                            the MCP server on stdio (for Claude Code, Claude Desktop, ChatGPT, Cursor)
+
+The profile folder is resolved from TEKJOBS_PROFILE, then ~/.tekjobs/config.json, then ~/.tekjobs/profile.
+`;
+
+async function main() {
+  if (!cmd || cmd === 'help' || cmd === '--help') return console.log(HELP);
+  if (cmd === '--version' || cmd === '-v' || cmd === 'version') return console.log(JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8')).version);
+  if (cmd === 'schedule') return schedule();
+  if (cmd === 'init') {
+    const dirArg = rest.find((a) => !a.startsWith('--') && a !== opt('--resume'));
+    const dir = path.resolve(dirArg || process.env.TEKJOBS_PROFILE || path.join(process.env.USERPROFILE || process.env.HOME || '.', '.tekjobs', 'profile'));
+    process.env.TEKJOBS_PROFILE = dir;
+    const { initProfile, importResume, onboardingStatus } = await import('./scraper/profile.mjs');
+    const r = initProfile(dir);
+    console.log(`Profile folder: ${r.dir}${r.made.length ? `\n  created: ${r.made.join(', ')}` : '\n  (already existed; nothing overwritten)'}`);
+    if (opt('--resume')) { const i = await importResume(path.resolve(opt('--resume')), dir); console.log(`Resume imported: ${i.chars} characters → ${i.source}`); }
+    return printStatus(onboardingStatus(dir));
+  }
+  const { importResume, onboardingStatus } = await import('./scraper/profile.mjs');
+  const { VAULT } = await import('./scraper/config.mjs');
+  if (cmd === 'resume' && rest[0] === 'sync') {
+    const { syncResume } = await import('./scraper/resume-sync.mjs');
+    const source = rest.slice(1).find((a) => !a.startsWith('--')) || '';
+    const r = await syncResume({ source, dry: rest.includes('--dry') });
+    const show = (label, list, mark) => {
+      if (!list.length) return;
+      console.log(`\n${label} (${list.length}):`);
+      for (const l of list.slice(0, 25)) console.log(`  ${mark} ${l.length > 110 ? l.slice(0, 107) + '...' : l}`);
+      if (list.length > 25) console.log(`  ... and ${list.length - 25} more`);
+    };
+    console.log(`${r.wrote ? 'Synced' : 'Dry run, nothing written:'} ${r.kind} ${r.source} (${r.chars} characters) → ${r.note}`);
+    console.log(r.previous ? `Compared with ${r.previous}.` : 'No earlier resume note to compare with.');
+    if (r.previous && !r.removed.length && !r.added.length) console.log('No line changed.');
+    show('Removed from the resume', r.removed, '-');
+    show('Added to the resume', r.added, '+');
+    if (r.stale.length) {
+      console.log(`\nApplication packets still quoting claims the resume no longer makes (${r.stale.length}):`);
+      for (const s of r.stale) console.log(`  ${s.note}\n    ${s.quotes.map((q) => `"${q}"`).join(', ')}`);
+      console.log('Review those drafts before sending anything.');
+    } else if (r.removed.length) console.log('\nNo application packet quotes a removed claim.');
+    return;
+  }
+  if (cmd === 'resume') {
+    const file = rest[0]; if (!file) return console.error('usage: tekjobs resume <file>  |  tekjobs resume sync [<url|file>] [--dry]');
+    const i = await importResume(path.resolve(file)); console.log(`Resume imported: ${i.chars} characters → ${i.source}`);
+    return printStatus(onboardingStatus(VAULT));
+  }
+  if (cmd === 'status') return printStatus(onboardingStatus(VAULT));
+  if (cmd === 'scan') return run(process.execPath, [path.join(ROOT, 'run.mjs'), ...rest]);
+  if (cmd === 'mail') {
+    const mail = await import('./app/server/mail-check.mjs');
+    const days = opt('--days') ? Number(opt('--days')) : undefined;
+    mail.start({ sinceDays: days });
+    process.stdout.write('Reading the mailbox through the local CLI (Gmail read tools only)');
+    while (mail.items().running) { await new Promise((r) => setTimeout(r, 3000)); process.stdout.write('.'); }
+    const s = mail.items(); console.log('');
+    if (s.error) { console.error(s.error); process.exitCode = 1; return; }
+    const pending = s.items.filter((i) => i.state === 'pending');
+    console.log(`${s.items.length} application emails on file, ${pending.length} waiting for a decision. Confirm them on the Today page.`);
+    for (const i of pending.slice(0, 40)) console.log(`  ${i.date}  ${i.kind.padEnd(12)} ${i.company} — ${i.role || '(role not stated)'}  → ${i.match === 'none' ? 'no note: would create one' : `${i.match} match, ${i.noteStatus}: ${i.suggestion.action}${i.suggestion.status ? ' ' + i.suggestion.status : ''}`}`);
+    return;
+  }
+  if (cmd === 'add') {
+    const urls = rest.filter((a) => !a.startsWith('--'));
+    if (!urls.length) return console.error('usage: tekjobs add <url> [<url>...] [--dry]');
+    const { importLink } = await import('./scraper/import-link.mjs');
+    for (const u of urls) {
+      const r = await importLink(u, { dry: rest.includes('--dry') });
+      if (!r.ok) { console.log(`  x ${u}\n    ${r.error}`); continue; }
+      const head = `${String(r.score).padStart(4)}  ${r.job.company} — ${r.job.title}  [${r.job.location || 'location n/a'}]`;
+      if (r.added) console.log(`  + ${head}\n    ${r.note}${r.belowMin ? '\n    (below the scan\'s minimum score; written anyway because you asked for it)' : ''}`);
+      else if (r.dry) console.log(`  · ${head}\n    would write ${r.note}`);
+      else console.log(`  = ${head}\n    already here: ${r.reason}\n    ${r.existing}`);
+    }
+    return;
+  }
+  if (cmd === 'rescore') {
+    const { rescore, rescoreFull } = await import('./scraper/rescore.mjs');
+    const dry = rest.includes('--dry');
+    if (rest.includes('--full')) {
+      const r = rescoreFull({ dry });
+      const bar = (await import('./scraper/config.mjs')).loadCriteria().minScore || 0;
+      const crossed = r.changes.filter((c) => (c.stored >= bar) !== (c.updated >= bar));
+      console.log(`${r.changed} of ${r.considered} notes ${dry ? 'would change' : 'updated'} under weights ${r.fingerprint}; ${r.alreadyCurrent} already carried them.`);
+      console.log(`${crossed.filter((c) => c.updated >= bar).length} rise above the bar (${bar}), ${crossed.filter((c) => c.updated < bar).length} fall below it.`);
+      for (const c of r.changes.slice(0, 15)) console.log(`  ${String(c.stored).padStart(4)} -> ${String(c.updated).padStart(4)}  ${c.company} — ${c.title.trim().slice(0, 50)}${c.status && c.status !== 'new' ? `  [${c.status}]` : ''}`);
+      if (dry) console.log('\nNothing written. Run without --dry to apply.');
+      return;
+    }
+    if (rest.includes('--stamp-only')) {
+      const r = rescore({ dry, stampOnly: true });
+      console.log(`${r.changed} of ${r.total} notes ${dry ? 'would be' : ''} stamped with weights ${r.fingerprint}.`);
+      return;
+    }
+    const fromIdx = rest.indexOf('--from');
+    const fromPath = fromIdx >= 0 ? rest[fromIdx + 1] : null;
+    if (!fromPath) {
+      console.error([
+        'rescore needs the criteria your notes were scored under:',
+        '  tekjobs rescore --from <old-criteria.json> [--dry]',
+        '',
+        'A note records its score but not the weights behind it, so without the old ones this would double-apply.',
+      ].join('\n'));
+      process.exitCode = 1;
+      return;
+    }
+    const before = JSON.parse(fs.readFileSync(fromPath, 'utf8'));
+    const r = rescore({ dry, before });
+    console.log(`${r.changed} of ${r.total} notes ${dry ? 'would change' : 'updated'}.`);
+    for (const c of r.changes.sort((a, b) => Math.abs(b.delta) - Math.abs(a.delta)).slice(0, 10)) {
+      console.log(`  ${String(c.stored).padStart(4)} -> ${String(c.updated).padStart(4)} (${c.delta > 0 ? '+' : ''}${c.delta})  ${c.company} — ${c.title.trim().slice(0, 44)}`);
+    }
+    if (dry) console.log('\nNothing written. Run without --dry to apply.');
+    return;
+  }
+  if (cmd === 'serve') return run(process.execPath, [path.join(ROOT, 'app', 'server', 'index.mjs')]);
+  if (cmd === 'mcp') return run(process.execPath, [path.join(ROOT, 'app', 'server', 'mcp.mjs')]);
+  console.error(`unknown command "${cmd}"\n`); console.log(HELP); process.exit(1);
+}
+function printStatus(s) {
+  console.log(`\nOnboarding for ${s.dir}:`);
+  for (const st of s.steps) console.log(`  ${st.done ? '✓' : '·'} ${st.label}${st.done ? '' : `   → ${st.how}`}`);
+  console.log(s.complete ? '\nAll set. The daily scan takes it from here.' : '\nNext: the first unchecked line above.');
+}
+function run(bin, args) { const p = spawn(bin, args, { stdio: 'inherit', env: process.env }); p.on('close', (c) => process.exit(c ?? 0)); }
+main().catch((e) => { console.error(e.message); process.exit(1); });
+
+/**
+ * The morning task. On Windows, a Task Scheduler entry that runs run.cmd (the scan, then the mail read) daily;
+ * elsewhere, the crontab line or launchd plist that runs run.sh, printed for the person to install, because
+ * editing a crontab unasked is not this tool's place. --print shows the Windows command without running it.
+ */
+function schedule() {
+  // A task that runs from npx's cache breaks the first time the cache is cleaned. Install first.
+  if (/[\\/]_npx[\\/]/.test(ROOT)) return console.error(`This copy of tekjobs runs from npx's cache, which does not last. Install it, then schedule from there:\n  npm install -g @timurtekb/tekjobs\n  tekjobs schedule`);
+  const time = opt('--time') || '07:30';
+  if (!/^\d{2}:\d{2}$/.test(time)) return console.error('--time wants HH:MM, for example 07:30');
+  const [hh, mm] = time.split(':').map(Number);
+  const printOnly = rest.includes('--print');
+  if (process.platform === 'win32') {
+    const cmd = `schtasks /Create /F /SC DAILY /ST ${time} /TN "TekJobs Daily Scan" /TR "\\"${path.join(ROOT, 'run.cmd')}\\""`;
+    console.log(`Windows Task Scheduler entry "TekJobs Daily Scan", daily at ${time}, running run.cmd (the scan, then the mail read):\n  ${cmd}`);
+    if (printOnly) return;
+    const r = spawnSync(cmd, { shell: true, encoding: 'utf8' });
+    if (r.status === 0) console.log('Installed. See it in Task Scheduler, or remove it with: schtasks /Delete /TN "TekJobs Daily Scan" /F');
+    else console.error(`schtasks answered ${r.status}: ${(r.stderr || r.stdout || '').trim()}\nRun the command above in an elevated terminal if Windows asked for permission.`);
+    return;
+  }
+  const sh = path.join(ROOT, 'run.sh');
+  console.log(`Add one line to your crontab (crontab -e), daily at ${time}:\n  ${mm} ${hh} * * * ${sh}\n`);
+  if (process.platform === 'darwin') {
+    const plist = path.join(process.env.HOME || '~', 'Library', 'LaunchAgents', 'com.tekjobs.scan.plist');
+    console.log(`Or, on macOS, a launchd agent (it survives sleep better than cron):
+  cat > ${plist} <<'EOF'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>Label</key><string>com.tekjobs.scan</string>
+  <key>ProgramArguments</key><array><string>/bin/sh</string><string>${sh}</string></array>
+  <key>StartCalendarInterval</key><dict><key>Hour</key><integer>${hh}</integer><key>Minute</key><integer>${mm}</integer></dict>
+  <key>EnvironmentVariables</key><dict><key>PATH</key><string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string></dict>
+</dict></plist>
+EOF
+  launchctl load ${plist}`);
+  }
+  console.log('\nBoth run run.sh: the scan, then the read-only mail pass, appending to data/runs.log.');
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@timurtekb/tekjobs",
+  "version": "0.24.1",
+  "description": "A local-first job-search machine: watches hundreds of company job boards, scores every posting against your profile, and files matches into a folder of markdown notes you own. Bring your own LLM through MCP.",
+  "type": "module",
+  "license": "MIT",
+  "private": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "tekjobs": "./cli.mjs"
+  },
+  "scripts": {
+    "prepare": "husky || true",
+    "release": "semantic-release",
+    "test": "node --test \"test/**/*.test.mjs\"",
+    "init": "node cli.mjs init",
+    "status": "node cli.mjs status",
+    "scan": "node run.mjs",
+    "dry": "node run.mjs --dry",
+    "check": "node run.mjs --dry --check-slugs",
+    "serve": "node app/server/index.mjs",
+    "mcp": "node app/server/mcp.mjs",
+    "sample": "node tools/make-sample-vault.mjs"
+  },
+  "dependencies": {
+    "pdf-parse": "^2.4.5"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/npm": "^13.2.0",
+    "husky": "^9.1.7",
+    "semantic-release": "^24.2.7"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Timurtek/tekjobs.git"
+  },
+  "homepage": "https://tekjobs.timurtek.com",
+  "bugs": {
+    "url": "https://github.com/Timurtek/tekjobs/issues"
+  },
+  "keywords": [
+    "job-search",
+    "local-first",
+    "markdown",
+    "obsidian",
+    "mcp",
+    "scraper",
+    "greenhouse",
+    "lever",
+    "ashby"
+  ],
+  "files": [
+    "cli.mjs",
+    "run.mjs",
+    "run.cmd",
+    "run.sh",
+    "scraper/",
+    "app/server/",
+    "app/dist/",
+    "samples/vault/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/run.cmd

@@ -0,0 +1,10 @@
+@echo off
+rem Daily TekJobs scan. Invoked by Windows Task Scheduler (task name: TekJobs Daily Scan).
+cd /d %~dp0
+set TEKJOBS_RUN_VIA=schedule
+if not exist data mkdir data
+echo ===== %date% %time% ===== >> data\runs.log
+node run.mjs >> data\runs.log 2>&1
+rem Then the mailbox: a read-only pass through the local CLI's Gmail connector, matched to the notes for you to confirm in the app.
+echo ----- mail %date% %time% ----- >> data\runs.log
+node cli.mjs mail >> data\runs.log 2>&1