@timurtekb/tekjobs 0.24.1

package/run.mjs

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+// TekJobs runner. Usage: node run.mjs [--dry] [--min N] [--floor N] [--only slug] [--retry-failed] [--criteria <preset name | file>] [--no-remoteok] [--no-hn] [--check-slugs]
+import fs from 'node:fs';
+import path from 'node:path';
+import { ensureDirs, loadCriteria, loadCompanies, writeCompanyStatuses, criteriaPresetFile, P } from './scraper/config.mjs';
+import { fetchCompany, fetchRemoteOK, fetchHNWhoIsHiring, htmlToText } from './scraper/sources.mjs';
+import { scoreJob, parseSalary } from './scraper/score.mjs';
+import { loadSeen, saveSeen, writeJobNote, markClosedListings, appendLog, writeDashboard, readFrontmatter } from './scraper/vault.mjs';
+import { weightsFingerprint } from './scraper/rescore.mjs';
+import { loadHealth, saveHealth, record, healthState } from './scraper/health.mjs';
+
+const args = process.argv.slice(2);
+const flag = (f) => args.includes(f);
+const opt = (f) => { const i = args.indexOf(f); return i >= 0 ? args[i + 1] : undefined; };
+const DRY = flag('--dry');
+const ONLY = opt('--only');
+// Only the boards whose latest attempt failed, and no feeds: the Sources page's Retry button.
+const RETRY = flag('--retry-failed');
+
+async function pool(items, n, fn) {
+  const out = new Array(items.length);
+  let i = 0;
+  await Promise.all(Array.from({ length: n }, async () => {
+    while (i < items.length) { const k = i++; out[k] = await fn(items[k], k); }
+  }));
+  return out;
+}
+
+const t0 = Date.now();
+ensureDirs();
+// Which criteria this run scores with: the active note, or a named preset / any criteria file for this run only.
+let criteriaFile = P.criteria, criteriaName = 'Search Criteria';
+if (opt('--criteria')) {
+  const want = opt('--criteria');
+  criteriaFile = fs.existsSync(want) ? path.resolve(want) : criteriaPresetFile(want);
+  if (!fs.existsSync(criteriaFile)) { console.error(`No criteria preset or file "${want}" (looked in ${P.criteriaDir}).`); process.exit(1); }
+  criteriaName = path.basename(criteriaFile, '.md');
+}
+const criteria = loadCriteria(criteriaFile);
+const criteriaLabel = `${criteriaName} (${weightsFingerprint(criteria)})`;
+if (opt('--min')) criteria.minScore = Number(opt('--min'));
+if (opt('--floor')) { criteria.salary = { ...(criteria.salary || {}), minAnnual: Number(opt('--floor')) }; console.log(`  pay floor overridden: $${criteria.salary.minAnnual}`); }
+let companies = loadCompanies();
+if (ONLY) companies = companies.filter((c) => c.slug === ONLY || c.name.toLowerCase() === ONLY.toLowerCase());
+const health = loadHealth();
+if (RETRY) {
+  companies = companies.filter((c) => healthState(health.boards[`${c.ats}:${c.slug}`], c.status) === 'failed');
+  if (companies.length === 0) { console.log('No failed boards to retry.'); process.exit(0); }
+}
+console.log(`TekJobs run ${new Date().toISOString()}${DRY ? ' (dry)' : ''} — ${companies.length} companies, minScore ${criteria.minScore}, criteria ${criteriaLabel}`);
+
+// 1. Fetch company boards
+const statusBySlug = {};
+const liveIdsByCompanyKey = {};
+const failed = [];
+// Workday boards are slow (search + per-job detail); run them last so the fast boards finish first.
+companies.sort((a, b) => (a.ats === 'workday') - (b.ats === 'workday'));
+const results = await pool(companies, 8, async (c) => {
+  const key = `${c.ats}:${c.slug}`;
+  const r = await fetchCompany(c, criteria);
+  health.boards[key] = record(health.boards[key], r);
+  if (!r.ok) {
+    statusBySlug[key] = `bad-slug (${r.error})`;
+    failed.push({ ...c, error: r.error });
+    process.stdout.write(`  x ${c.name} [${key}] ${r.error}\n`);
+    return [];
+  }
+  statusBySlug[key] = r.emptyBoard ? 'ok · 0 jobs (slug?)' : r.scanned != null ? `ok · ${r.jobs.length} of ${r.scanned} searched` : `ok · ${r.jobs.length}`;
+  liveIdsByCompanyKey[key] = new Set(r.jobs.map((j) => j.id));
+  for (const j of r.jobs) { j.companyKey = key; j.tier = c.tier; }
+  return r.jobs;
+});
+let jobs = results.flat();
+
+// 2. Open sources (no slug). RemoteOK and HN are always on unless flagged; the rest toggle via criteria.openSources.
+const extras = [];
+const open = criteria.openSources || {};
+if (!ONLY && !RETRY) {
+  const { OPEN_SOURCES } = await import('./scraper/sources-extra.mjs');
+  const tasks = [];
+  if (!flag('--no-remoteok') && open.remoteok !== false) tasks.push(['RemoteOK', fetchRemoteOK]);
+  if (!flag('--no-hn') && open.hn !== false) tasks.push(['HN Who is hiring', fetchHNWhoIsHiring]);
+  // A source marked defaultOn (TekJobs' own postings) runs unless the criteria say `false`; the rest are opt-in.
+  for (const [key, def] of Object.entries(OPEN_SOURCES)) if (def.defaultOn ? open[key] !== false : open[key]) tasks.push([def.label, def.fn]);
+  // Open-source fetchers are handed the criteria. Most ignore it; the ones that read the profile (Adzuna
+  // searches for its own titleTerms) need it, and the rest destructure their own options, so an extra
+  // argument is harmless.
+  // The inbox folder is a path, not a preference, so it is passed alongside the criteria rather than
+  // written into a file the person edits by hand.
+  const withPaths = { ...criteria, _inbox: P.inbox };
+  const results = await pool(tasks, 4, async ([label, fn]) => [label, await fn(withPaths)]);
+  for (const [label, r] of results) {
+    extras.push([label, r]);
+    health.feeds[label] = record(health.feeds[label], r);
+    if (r.ok) { for (const j of r.jobs) j.companyKey = `open:${label}`; jobs.push(...r.jobs); liveIdsByCompanyKey[`open:${label}`] = new Set(r.jobs.map((j) => j.id)); }
+    else console.log(`  x ${label} ${r.error}`);
+  }
+}
+if (flag('--check-slugs')) {
+  console.table(Object.entries(statusBySlug).map(([k, v]) => ({ board: k, status: v })));
+  if (!DRY) writeCompanyStatuses(statusBySlug);
+  process.exit(0);
+}
+
+// 2b. Dedupe. The same opening shows up per-location on some boards (Rippling, Greenhouse multi-city) and again on
+// aggregators. Key on company + title; keep the ATS copy over the aggregator copy; merge locations of the rest.
+// Sources whose copy of a posting is thinner than the ATS's, and so loses when both are present: the
+// aggregators, Adzuna (snippet descriptions) and anything imported from an alert email (a title and
+// little else). USAJOBS is not one of them — it is the authority for the jobs it carries.
+const AGG = new Set(['themuse', 'remotive', 'himalayas', 'jobicy', 'workingnomads', 'arbeitnow', 'wwr', 'remoteok', 'hn', 'adzuna', 'wellfound', 'builtin']);
+const isThin = (j) => AGG.has(j.source) || String(j.source).startsWith('email:');
+{
+  const norm = (s) => (s || '').toLowerCase().replace(/\(.*?\)|\[.*?\]/g, '').replace(/[^a-z0-9]+/g, ' ').trim();
+  const byKey = new Map();
+  const ordered = [...jobs].sort((a, b) => (isThin(a) - isThin(b)));
+  for (const j of ordered) {
+    const key = `${norm(j.company)}|${norm(j.title)}`;
+    const keep = byKey.get(key);
+    if (!keep) { byKey.set(key, j); continue; }
+    if (keep.source === j.source && j.location && !keep.location.includes(j.location)) keep.location = `${keep.location}; ${j.location}`.slice(0, 300);
+    if (!keep.salary && j.salary) { keep.salary = j.salary; }
+    if (!keep.remote && j.remote) keep.remote = true;
+    keep.dupes = (keep.dupes || 0) + 1;
+    // Some boards repeat the same posting id once per location; never drop the id the kept note points at.
+    if (j.id !== keep.id && j.companyKey && liveIdsByCompanyKey[j.companyKey]) liveIdsByCompanyKey[j.companyKey].delete(j.id);
+  }
+  const before = jobs.length;
+  jobs = [...byKey.values()];
+  console.log(`  dedupe: ${before} → ${jobs.length}`);
+}
+
+// 3. Score
+for (const j of jobs) {
+  j.descriptionText = htmlToText(j.descriptionHtml || '');
+  const range = parseSalary(`${j.salary || ''}\n${j.descriptionText}`);
+  if (range) { j.salaryMin = range.min; j.salaryMax = range.max; if (!j.salary) j.salary = `$${Math.round(range.min / 1000)}k–$${Math.round(range.max / 1000)}k`; }
+  j.scored = scoreJob(j, criteria);
+}
+const scored = jobs.filter((j) => !j.scored.excluded).sort((a, b) => b.scored.score - a.scored.score);
+const matches = scored.filter((j) => j.scored.score >= criteria.minScore);
+
+// 4. Write new matches to the vault
+const seen = loadSeen();
+const fresh = matches.filter((j) => !seen[j.id]);
+const written = [];
+for (const j of fresh) {
+  if (DRY) { written.push({ job: j, file: '(dry)' }); continue; }
+  const file = writeJobNote(j, j.scored, criteria);
+  seen[j.id] = { path: file, firstSeen: new Date().toISOString(), company: j.company, title: j.title, companyKey: j.companyKey || j.source, score: j.scored.score };
+  written.push({ job: j, file });
+}
+let closed = [];
+if (!DRY) {
+  closed = markClosedListings(liveIdsByCompanyKey, seen);
+  saveSeen(seen);
+  writeCompanyStatuses(statusBySlug);
+}
+
+// Source health is diagnostic, so it is written on dry runs too.
+saveHealth(health);
+
+// 5. Debug snapshot: everything scored, so near-misses can be reviewed and criteria tuned
+fs.writeFileSync(P.lastRun, JSON.stringify({
+  when: new Date().toISOString(), minScore: criteria.minScore, failed,
+  jobs: scored.slice(0, 800).map((j) => ({ score: j.scored.score, company: j.company, title: j.title, location: j.location, remote: !!j.remote, salary: j.salary || '', salaryMin: j.salaryMin || null, salaryMax: j.salaryMax || null, payBand: j.scored.payBand, posted: j.posted, url: j.url, source: j.source, reasons: j.scored.reasons, isNew: !seen[j.id] || fresh.includes(j) })),
+}, null, 2));
+
+// 6. Log + dashboard
+const summary = {
+  when: new Date().toISOString().replace('T', ' ').slice(0, 16) + ' UTC',
+  companiesTotal: companies.length,
+  companiesOk: companies.length - failed.length,
+  companiesFailed: failed.length,
+  totalJobs: jobs.length,
+  newMatches: written.length,
+};
+const logLines = [
+  `## Run ${summary.when}${DRY ? ' (dry)' : ''}`,
+  `- Boards: ${summary.companiesOk}/${summary.companiesTotal} ok · postings scanned: ${summary.totalJobs} · scored ≥ ${criteria.minScore}: ${matches.length} · **new: ${written.length}** · closed: ${closed.length} · ${((Date.now() - t0) / 1000).toFixed(1)}s`,
+  `- Criteria: ${criteriaLabel}`,
+  // Who started it: the morning task (run.cmd / run.sh), the app, an agent over MCP, or someone at the CLI.
+  `- Via: ${process.env.TEKJOBS_RUN_VIA || 'cli'}`,
+  ...extras.map(([n, r]) => `- ${n}: ${r.ok ? `${r.jobs.length} postings${r.thread ? ` (${r.thread})` : ''}` : `failed: ${r.error}`}`),
+  ...(failed.length ? [`- Failed slugs: ${failed.map((f) => `${f.name} (${f.ats}:${f.slug} — ${f.error})`).join('; ')}`] : []),
+  ...(written.length ? ['', '### New matches', ...written.map(({ job }) => `- **${job.scored.score}** ${job.company} — [${job.title}](${job.url}) · ${job.location || 'n/a'}`)] : []),
+  ...(closed.length ? ['', '### Closed since last run', ...closed.map((c) => `- ${c.company} — ${c.title}`)] : []),
+];
+if (!DRY) {
+  appendLog(logLines);
+  writeDashboard(summary);
+}
+console.log(logLines.join('\n'));
+// The top of the list, with where each one stands. Ranking ignores status on purpose (the score is about the
+// posting), but a person reading the log should not be shown a job they already applied to as if it were news.
+const statusOf = (j) => { const p = seen[j.id]?.path; if (!p) return 'new'; const fm = readFrontmatter(p); return fm?.status || 'new'; };
+const top = scored.map((j) => ({ j, status: statusOf(j) }));
+const stillOpen = top.filter((t) => !['applied', 'interviewing', 'offer', 'rejected', 'passed'].includes(t.status));
+console.log(`\nTop 15 still open (not yet applied or passed):`);
+for (const { j, status } of stillOpen.slice(0, 15)) console.log(`  ${String(j.scored.score).padStart(4)}  ${status === 'new' ? '' : `[${status}] `}${j.company} — ${j.title}  [${j.location}]`);
+const done = top.slice(0, 30).filter((t) => ['applied', 'interviewing', 'offer', 'passed', 'rejected'].includes(t.status));
+if (done.length) console.log(`  (${done.length} of the top 30 already ${done.map((t) => t.status).filter((s, i, a) => a.indexOf(s) === i).join('/')}: ${done.map((t) => t.j.company).join(', ')})`);

package/run.sh

@@ -0,0 +1,12 @@
+#!/bin/sh
+# Daily TekJobs scan for cron and launchd: the scan, then the read-only mail pass. `tekjobs schedule` prints
+# the one line that calls this at 07:30; run.cmd is the Windows twin.
+cd "$(dirname "$0")" || exit 1
+export TEKJOBS_RUN_VIA=schedule
+mkdir -p data
+{
+  echo "===== $(date) ====="
+  node run.mjs
+  echo "----- mail $(date) -----"
+  node cli.mjs mail
+} >> data/runs.log 2>&1

package/samples/vault/Jobs/Basalt Systems - Senior Design Engineer, Growth (1010).md

@@ -0,0 +1,56 @@
+---
+type: job
+status: rejected
+listing: open
+company: "Basalt Systems"
+title: "Senior Design Engineer, Growth"
+location: "Remote US"
+remote: true
+source: ashby
+url: "https://jobs.example.com/basalt/senior-design-engineer-growth"
+score: 114
+weights: 3e895160
+posted: "2026-08-29"
+found: 2026-08-30
+salary: "$180k–$220k"
+salary_max: 220000
+pay_band: floor
+department: "Growth"
+job_id: "as:basalt:1010"
+tags: [job]
+---
+
+# Senior Design Engineer, Growth @ Basalt Systems
+
+**[Open posting](https://jobs.example.com/basalt/senior-design-engineer-growth)** · Remote US · Remote · score **114** · $180k–$220k
+
+## Why it matched
+- title +40: design engineer
+- seniority +8 (senior)
+- description +14: design system, react, typescript
+- remote +15
+- pay range tops out at $220k, at or above floor (+10, +2 for 20k above)
+- posted 1d ago (+25)
+
+## Status log
+- 2026-08-30 — found by scraper (score 114). Set `status:` above to `reviewing`, `applying`, `applied`, `interviewing`, `offer`, `rejected`, or `passed`.
+- 2026-09-01 — new → **reviewing** (via app)
+- 2026-09-03 — reviewing → **applying** (via app)
+- 2026-09-05 — applying → **applied** (via app)
+- 2026-09-17 — applied → **rejected** (via app)
+
+## Notes
+- 2026-09-17 (app): Form rejection after twelve days. No reason given.
+
+## Application
+- **Narrative:**
+- **Resume variant:**
+- **Cover letter:**
+- **Applied on:**
+- **Contact / referral:**
+- **Follow-up due:**
+
+## Job description
+> Source: ashby
+
+Basalt Systems sells infrastructure monitoring. The growth team builds onboarding, pricing and the signup flow, and wants a design engineer who ships polished interface fast in React and TypeScript on our design system. Remote in the US.

package/samples/vault/Jobs/Brightline Studio - Design Engineer (1005).md

@@ -0,0 +1,51 @@
+---
+type: job
+status: new
+listing: open
+company: "Brightline Studio"
+title: "Design Engineer"
+location: "Remote · United States"
+remote: true
+source: lever
+url: "https://jobs.example.com/brightline/design-engineer"
+score: 95
+weights: 3e895160
+posted: "2026-09-22"
+found: 2026-09-22
+salary: "$160k–$195k"
+salary_max: 195000
+pay_band: stretch
+department: "Studio"
+job_id: "le:brightline:1005"
+tags: [job, stretch]
+---
+
+# Design Engineer @ Brightline Studio
+
+**[Open posting](https://jobs.example.com/brightline/design-engineer)** · Remote · United States · Remote · score **95** · $160k–$195k
+
+## Why it matched
+- title +40: design engineer
+- description +23: react, typescript, storybook, figma, accessibility, component library
+- remote +15
+- pay range tops out at $195k, stretch band (-8)
+- posted 0d ago (+25)
+
+## Status log
+- 2026-09-22 — found by scraper (score 95). Set `status:` above to `reviewing`, `applying`, `applied`, `interviewing`, `offer`, `rejected`, or `passed`.
+
+## Notes
+
+
+## Application
+- **Narrative:**
+- **Resume variant:**
+- **Cover letter:**
+- **Applied on:**
+- **Contact / referral:**
+- **Follow-up due:**
+
+## Job description
+> Source: lever
+
+Brightline is a 40-person product studio. You would be our first design engineer: build the component library our client work starts from, in React and TypeScript with Storybook, and set the accessibility bar for every project. Figma fluency matters; you will work in the file as much as in the editor. Remote in the US.

package/samples/vault/Jobs/Copperleaf - Principal Design Engineer (1006).md

@@ -0,0 +1,53 @@
+---
+type: job
+status: reviewing
+listing: open
+company: "Copperleaf"
+title: "Principal Design Engineer"
+location: "Remote - US"
+remote: true
+source: greenhouse
+url: "https://jobs.example.com/copperleaf/principal-design-engineer"
+score: 134
+weights: 3e895160
+posted: "2026-09-19"
+found: 2026-09-20
+salary: "$240k–$290k"
+salary_max: 290000
+pay_band: floor
+department: "Design Systems"
+job_id: "gr:copperleaf:1006"
+tags: [job]
+---
+
+# Principal Design Engineer @ Copperleaf
+
+**[Open posting](https://jobs.example.com/copperleaf/principal-design-engineer)** · Remote - US · Remote · score **134** · $240k–$290k
+
+## Why it matched
+- title +40: design engineer
+- seniority +10 (principal)
+- description +26: design system, design systems, react, typescript, tokens, wcag
+- remote +15
+- pay range tops out at $290k, at or above floor (+10, +8 for 90k above)
+- posted 1d ago (+25)
+
+## Status log
+- 2026-09-20 — found by scraper (score 134). Set `status:` above to `reviewing`, `applying`, `applied`, `interviewing`, `offer`, `rejected`, or `passed`.
+- 2026-09-20 — new → **reviewing** (via app)
+
+## Notes
+
+
+## Application
+- **Narrative:**
+- **Resume variant:**
+- **Cover letter:**
+- **Applied on:**
+- **Contact / referral:**
+- **Follow-up due:**
+
+## Job description
+> Source: greenhouse
+
+Copperleaf makes accounting software for small firms; 300,000 businesses use it. The design systems team is five engineers and two designers; the principal role sets technical direction for the system across web and the embedded views in our desktop app. React, TypeScript, tokens, theming for white-label partners, WCAG 2.1 AA across the board. Remote in the US.

package/samples/vault/Jobs/Example Studio - Senior Design Engineer (1013).md

@@ -0,0 +1,52 @@
+---
+type: job
+status: new
+listing: open
+company: "Example Studio"
+title: "Senior Design Engineer"
+location: "Remote · United States"
+remote: true
+source: tekjobs
+url: "https://tekjobs.timurtek.com/jobs/example-tekjobs"
+score: 130
+weights: 3e895160
+posted: "2026-09-23"
+found: 2026-09-23
+salary: "$180k–$240k"
+salary_max: 240000
+pay_band: floor
+department: "Product Design"
+job_id: "tj:tekjobs:1013"
+tags: [job]
+---
+
+# Senior Design Engineer @ Example Studio
+
+**[Open posting](https://tekjobs.timurtek.com/jobs/example-tekjobs)** · Remote · United States · Remote · score **130** · $180k–$240k
+
+## Why it matched
+- title +40: design engineer
+- seniority +8 (senior)
+- description +28: design system, react, typescript, storybook, figma, accessibility, tokens
+- remote +15
+- pay range tops out at $240k, at or above floor (+10, +4 for 40k above)
+- posted 0d ago (+25)
+
+## Status log
+- 2026-09-23 — found by scraper (score 130). Set `status:` above to `reviewing`, `applying`, `applied`, `interviewing`, `offer`, `rejected`, or `passed`.
+
+## Notes
+
+
+## Application
+- **Narrative:**
+- **Resume variant:**
+- **Cover letter:**
+- **Applied on:**
+- **Contact / referral:**
+- **Follow-up due:**
+
+## Job description
+> Source: tekjobs
+
+Example Studio is a fictional company whose posting exists to show what an employer posting on TekJobs looks like on the board. The role owns the product surface end to end: the React front end, the design system the team ships on, and the accessibility bar. TypeScript, Storybook, Figma tokens. Remote in the United States.

package/samples/vault/Jobs/Fjord Analytics - Staff Frontend Engineer, Platform (1003).md

@@ -0,0 +1,58 @@
+---
+type: job
+status: applied
+listing: open
+company: "Fjord Analytics"
+title: "Staff Frontend Engineer, Platform"
+location: "Remote, United States"
+remote: true
+source: greenhouse
+url: "https://jobs.example.com/fjord/staff-frontend-engineer-platform"
+score: 111
+weights: 3e895160
+posted: "2026-09-14"
+found: 2026-09-15
+salary: "$220k–$270k"
+salary_max: 270000
+pay_band: floor
+department: "Platform"
+job_id: "gr:fjord:1003"
+tags: [job]
+---
+
+# Staff Frontend Engineer, Platform @ Fjord Analytics
+
+**[Open posting](https://jobs.example.com/fjord/staff-frontend-engineer-platform)** · Remote, United States · Remote · score **111** · $220k–$270k
+
+## Why it matched
+- title +15: frontend engineer
+- seniority +10 (staff)
+- description +29: design system, react, typescript, storybook, accessibility, tokens, component library
+- remote +15
+- pay range tops out at $270k, at or above floor (+10, +7 for 70k above)
+- posted 1d ago (+25)
+
+## Status log
+- 2026-09-15 — found by scraper (score 111). Set `status:` above to `reviewing`, `applying`, `applied`, `interviewing`, `offer`, `rejected`, or `passed`.
+- 2026-09-16 — new → **reviewing** (via app)
+- 2026-09-17 — reviewing → **applying** (via app)
+- 2026-09-19 — applying → **applied** (via app)
+
+## Notes
+
+
+## Application
+- **Narrative:**
+- **Resume variant:**
+- **Cover letter:**
+- **Applied on:** 2026-09-19
+- **Contact / referral:**
+- **Follow-up due:** 2026-09-26
+
+## People
+- [[People/Lee Example (Fjord Analytics)|Lee Example]] · referral · lee@example.com · submitted the internal referral
+
+## Job description
+> Source: greenhouse
+
+Fjord Analytics is a data platform for mid-size retailers. The platform team owns the web application shell, the build, the design system and the component library that eleven feature teams use. You would lead the component library: React, TypeScript, tokens, Storybook, performance budgets. Experience taking a system through an accessibility audit is a strong signal. Remote in the US.

package/samples/vault/Jobs/Halcyon Robotics - Senior UX Engineer (1004).md

@@ -0,0 +1,52 @@
+---
+type: job
+status: new
+listing: open
+company: "Halcyon Robotics"
+title: "Senior UX Engineer"
+location: "Remote (United States) · Boston, MA"
+remote: true
+source: ashby
+url: "https://jobs.example.com/halcyon/senior-ux-engineer"
+score: 106
+weights: 3e895160
+posted: "2026-09-08"
+found: 2026-09-09
+salary: "$180k–$215k"
+salary_max: 215000
+pay_band: floor
+department: "Product"
+job_id: "as:halcyon:1004"
+tags: [job]
+---
+
+# Senior UX Engineer @ Halcyon Robotics
+
+**[Open posting](https://jobs.example.com/halcyon/senior-ux-engineer)** · Remote (United States) · Boston, MA · Remote · score **106** · $180k–$215k
+
+## Why it matched
+- title +25: ux engineer
+- seniority +8 (senior)
+- description +21: design system, react, typescript, storybook, figma
+- remote +15
+- pay range tops out at $215k, at or above floor (+10, +2 for 15k above)
+- posted 1d ago (+25)
+
+## Status log
+- 2026-09-09 — found by scraper (score 106). Set `status:` above to `reviewing`, `applying`, `applied`, `interviewing`, `offer`, `rejected`, or `passed`.
+
+## Notes
+
+
+## Application
+- **Narrative:**
+- **Resume variant:**
+- **Cover letter:**
+- **Applied on:**
+- **Contact / referral:**
+- **Follow-up due:**
+
+## Job description
+> Source: ashby
+
+Halcyon builds fleet software for warehouse robots. The UX engineering team sits between design and the product engineers and owns the design system and prototyping. React, TypeScript, Figma, Storybook. Remote in the US, with a Boston office.

package/samples/vault/Jobs/Lumen Health - Design Systems Engineer (1002).md

@@ -0,0 +1,51 @@
+---
+type: job
+status: new
+listing: open
+company: "Lumen Health"
+title: "Design Systems Engineer"
+location: "Remote US · Denver, CO"
+remote: true
+source: lever
+url: "https://jobs.example.com/lumen/design-systems-engineer"
+score: 109
+weights: 3e895160
+posted: "2026-09-11"
+found: 2026-09-12
+salary: "$175k–$205k"
+salary_max: 205000
+pay_band: floor
+department: "Engineering"
+job_id: "le:lumen:1002"
+tags: [job]
+---
+
+# Design Systems Engineer @ Lumen Health
+
+**[Open posting](https://jobs.example.com/lumen/design-systems-engineer)** · Remote US · Denver, CO · Remote · score **109** · $175k–$205k
+
+## Why it matched
+- title +35: design systems, design system
+- description +23: react, typescript, storybook, accessibility, tokens, component library
+- remote +15
+- pay range tops out at $205k, at or above floor (+10, +1 for 5k above)
+- posted 1d ago (+25)
+
+## Status log
+- 2026-09-12 — found by scraper (score 109). Set `status:` above to `reviewing`, `applying`, `applied`, `interviewing`, `offer`, `rejected`, or `passed`.
+
+## Notes
+
+
+## Application
+- **Narrative:**
+- **Resume variant:**
+- **Cover letter:**
+- **Applied on:**
+- **Contact / referral:**
+- **Follow-up due:**
+
+## Job description
+> Source: lever
+
+Lumen Health runs a patient portal used by 900 clinics. We are rebuilding the front end on a shared component library and need an engineer who has done this before: tokens, theming, accessibility, documentation in Storybook. TypeScript and React; some Angular remains and you would help retire it. Remote in the US or Denver.

package/samples/vault/Jobs/Meridian Pay - Staff Design Engineer (1009).md

@@ -0,0 +1,67 @@
+---
+type: job
+status: interviewing
+listing: open
+company: "Meridian Pay"
+title: "Staff Design Engineer"
+location: "Remote, United States"
+remote: true
+source: greenhouse
+url: "https://jobs.example.com/meridian/staff-design-engineer"
+score: 137
+weights: 3e895160
+posted: "2026-09-02"
+found: 2026-09-03
+salary: "$225k–$275k"
+salary_max: 275000
+pay_band: floor
+department: "Platform"
+job_id: "gr:meridian:1009"
+tags: [job]
+---
+
+# Staff Design Engineer @ Meridian Pay
+
+**[Open posting](https://jobs.example.com/meridian/staff-design-engineer)** · Remote, United States · Remote · score **137** · $225k–$275k
+
+## Why it matched
+- title +40: design engineer
+- seniority +10 (staff)
+- description +29: design system, react, typescript, storybook, accessibility, tokens, component library
+- remote +15
+- pay range tops out at $275k, at or above floor (+10, +8 for 75k above)
+- posted 1d ago (+25)
+
+## Status log
+- 2026-09-03 — found by scraper (score 137). Set `status:` above to `reviewing`, `applying`, `applied`, `interviewing`, `offer`, `rejected`, or `passed`.
+- 2026-09-04 — new → **reviewing** (via app)
+- 2026-09-06 — reviewing → **applying** (via app)
+- 2026-09-11 — applying → **applied** (via app)
+- 2026-09-18 — applied → **interviewing** (via app)
+
+## Notes
+- 2026-09-18 (app): Recruiter screen with Priya went well; technical interview with the platform lead scheduled for next week. She asked for the Storybook link.
+
+## Application
+- **Narrative:** Design engineer; the Acme system numbers lead (62 components, 12 teams, defects down a third).
+- **Resume variant:** Design Engineer (Staff)
+- **Cover letter:** Drafted 2026-09-11, 107 words. Full text under "Cover letter" in this note.
+- **Applied on:** 2026-09-11
+- **Contact / referral:**
+- **Follow-up due:** 2026-09-18
+- **Tailored summary:** Design engineer with eight years on design systems; led the Acme Finance system from 4 to 62 components across 12 teams, including white-label theming for partner banks.
+- **Tailored bullets:** System architecture and tokens · white-label theming · the ESM migration (1.9 MB to 640 kB) · the WCAG 2.1 AA audit with zero blockers
+- **Risks:** No payroll domain experience; say so, and point at fintech at Acme.
+
+## Cover letter
+> Drafted 2026-09-11 (via app), 107 words. A draft: read it, edit it, send it yourself.
+
+Hello. Your posting says Meridian Pay's design system serves six product teams and the white-label theming your partners depend on. At Acme Finance I took the system from 4 components to 62, used by 12 teams, with partner theming built on the same tokens; UI defect reports fell by a third in the year after. The part I would bring first is the token pipeline, because a system that themes for partners lives or dies on it. In the first month I would inventory the two legacy apps against the system and write down what they still need, since that list is the migration plan. Jordan Example.
+
+## People
+- [[People/Priya Example (Meridian Pay)|Priya Example]] · recruiter · priya@meridian.example.com · reached out after the application
+
+## Job description
+> Source: greenhouse
+
+Meridian Pay processes payroll for 30,000 companies. The platform team owns the design system used by six product teams and the white-label theming our partners depend on. You would lead the system: architecture, tokens, the component library in React and TypeScript, Storybook, accessibility, and the migration of the last two legacy apps. Remote in the US.