@timurtekb/tekjobs 0.32.1 → 0.34.0

package/app/dist/index.html

@@ -8,8 +8,8 @@
     <link rel="icon" href="/brand/tekjobs-avatar-192.png" type="image/png" sizes="192x192" />
     <link rel="apple-touch-icon" href="/brand/tekjobs-avatar-192.png" />
     <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:wght@500;600&family=Hanken+Grotesk:wght@400;500;600&family=Azeret+Mono:wght@400;500&display=swap" data-zengin="fonts" />
-    <script type="module" crossorigin src="/assets/index-DsZ1UCTf.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CbvdnTFY.css">
+    <script type="module" crossorigin src="/assets/index-Dt4Ynnmg.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CR3ppGJT.css">
   </head>
   <body>
     <div id="root"></div>

package/app/server/index.mjs

@@ -69,6 +69,8 @@ const routes = [
   ['GET', /^\/api\/profile\/summary$/, () => store.profileSummary()],
   ['GET', /^\/api\/companies$/, () => store.companies()],
   ['GET', /^\/api\/feeds$/, () => store.feeds()],
+  ['GET', /^\/api\/companies\/find$/, (_, q) => store.findBoard({ slug: q.get('slug') || '', ats: q.get('ats') || '', name: q.get('name') || '' })],
+  ['POST', /^\/api\/companies\/move$/, async (_, __, req) => { const b = await readBody(req); return store.moveBoard({ name: b.name || '', slug: b.slug, from: b.from || '', to: b.to }); }],
   ['POST', /^\/api\/companies$/, async (_, __, req) => store.addCompany(await readBody(req))],
   ['POST', /^\/api\/jobs\/import$/, async (_, __, req) => { const b = await readBody(req); return store.importLinks(b.urls ?? b.url); }],
   ['POST', /^\/api\/jobs\/([^/]+)\/reveal$/, (m) => store.revealJob(decodeURIComponent(m[1]))],

package/app/server/mail-check.mjs

@@ -105,7 +105,7 @@ export function reconcile(mails, notes) {
     const best = exact || (otherRole ? null : byRank[0] || null);
     const match = exact ? 'exact' : otherRole ? 'company-other-role' : best ? 'company' : 'none';
     return {
-      id: m.messageId, ...m, match,
+      id: m.messageId, ...m, match, link: gmailLink(m.messageId),
       noteId: best ? best.id : '', noteTitle: best ? best.title : '', noteStatus: best ? best.status : '',
       candidates: byRank.slice(0, 6).map((n) => ({ id: n.id, title: n.title, status: n.status })),
       suggestion: suggestionFor(m.kind, best ? best.status : '', m.date),
@@ -136,7 +136,7 @@ export function groupItems(items) {
       company: rep.company, role: rep.role || sorted.find((m) => m.role)?.role || '',
       kind: rep.kind, kinds: [...new Set(sorted.map((m) => m.kind))], date: sorted.map((m) => m.date).sort().pop() || '',
       first: sorted.map((m) => m.date).filter(Boolean).sort()[0] || '',
-      gist: rep.gist, subject: rep.subject, from: rep.from,
+      gist: rep.gist, subject: rep.subject, from: rep.from, link: rep.link,
       person: rep.person || sorted.find((m) => m.person)?.person || null,
       match: rep.match, noteId: rep.noteId, noteTitle: rep.noteTitle, noteStatus: rep.noteStatus, candidates: rep.candidates, suggestion: rep.suggestion,
     };
@@ -147,7 +147,8 @@ export function groupItems(items) {
 const run = { running: false, startedAt: null, finishedAt: null, error: '', errorKind: '', sinceDays: null, lastOutput: '' };
 export function items() {
   const d = load();
-  const all = d.items || [];
+  // Items written before the link existed get it here; the id is the Gmail message id.
+  const all = (d.items || []).map((i) => (i.link ? i : { ...i, link: gmailLink(i.id) }));
   return { ...run, runner: runnerConfig().command, lastRun: d.lastRun, lastSinceDays: d.sinceDays, items: all, groups: groupItems(all) };
 }
 export function start({ sinceDays } = {}) {

package/app/server/mcp.mjs

@@ -55,6 +55,7 @@ export const TOOLS = [
   { name: 'import_resume', description: 'Import a resume file from a local path (PDF, DOCX, Markdown, text): copies it into Profile/ and extracts its text for the interview.', inputSchema: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] } },
   { name: 'add_job', description: 'Add postings the person found themselves, from links (LinkedIn job pages, a company careers page, a Greenhouse/Lever/Ashby posting). Each link is read once, scored with the current criteria, and written as a job note unless the scan already has it or a note with the same company and title exists. A LinkedIn link is opened as a signed-out visitor; if it names the company\'s own apply page on a known board, that page is imported and the LinkedIn link is recorded as where it was seen. Returns one result per link. Up to 25 links.', inputSchema: { type: 'object', properties: { urls: { type: 'array', items: { type: 'string' } } }, required: ['urls'] } },
   { name: 'attach_posting', description: 'Attach the real posting to a note that was created without one (from an application email or a pasted link with thin data). Reads the posting through its board when the link is Greenhouse/Lever/Ashby (including company pages with ?gh_jid= or ?ashby_jid=), replaces the note\'s posting facts, score, reasons and description, and keeps the status, notes, packet and drafts. The note name does not change.', inputSchema: { type: 'object', properties: { id: { type: 'string' }, url: { type: 'string' } }, required: ['id', 'url'] } },
+  { name: 'find_board', description: 'A board on the watchlist answers 404: ask every platform the scan can read for the same slug and report which answer with jobs, best first. With apply=true, move the watchlist row to the best one (its status clears and the next scan reads it there). Companies usually keep their slug when they change tracker; when nothing answers, the slug changed too and the careers page says the new one.', inputSchema: { type: 'object', properties: { slug: { type: 'string' }, ats: { type: 'string', description: 'the platform that failed, left out of the probe' }, name: { type: 'string' }, apply: { type: 'boolean' } }, required: ['slug'] } },
   { name: 'add_company', description: 'Append a board to the watchlist. ats is the platform (greenhouse, lever, ashby, workday, rippling, smartrecruiters, workable, bamboohr, breezy, personio, teamtailor, eightfold, atlassian, github, spotify, amazon); slug is the board token.', inputSchema: { type: 'object', properties: { name: { type: 'string' }, ats: { type: 'string' }, slug: { type: 'string' }, tier: { type: 'string' }, notes: { type: 'string' } }, required: ['name', 'ats', 'slug'] } },
 ];
 
@@ -93,6 +94,7 @@ export async function call(name, a = {}) {
     case 'set_criteria': return store.setCriteria(a.raw);
     case 'list_companies': return store.companies();
     case 'list_feeds': return store.feeds();
+    case 'find_board': { const r = await store.findBoard(a); if (a.apply && r.found[0]) return { ...r, moved: await store.moveBoard({ name: a.name || '', slug: a.slug, from: a.ats || '', to: r.found[0].ats }) }; return r; }
     case 'add_company': return store.addCompany(a);
     case 'add_job': return store.importLinks(a.urls);
     case 'attach_posting': return store.attachPosting(a.id, a.url);

package/app/server/store.mjs

@@ -969,6 +969,18 @@ export async function importLinks(urls) {
   return out;
 }
 
+/** Where a board went: every platform that answers for the slug, the failed one left out. */
+export async function findBoard({ slug, ats = '', name = '' }) {
+  if (!slug) throw Object.assign(new Error('slug is required'), { status: 400 });
+  const { probeBoard } = await import('../../scraper/find-board.mjs');
+  return probeBoard(slug, { name: name || slug, except: ats });
+}
+/** Move a watchlist row to the platform that answers; the next scan reads it there. */
+export async function moveBoard({ name = '', slug, from = '', to }) {
+  const { moveCompany } = await import('../../scraper/find-board.mjs');
+  const r = moveCompany({ name, slug, from, to });
+  return { ...r, companies: companies() };
+}
 export function addCompany({ name, ats, slug, tier = 'B', notes = '' }) {
   if (!name || !ats || !slug) throw Object.assign(new Error('name, ats and slug are required'), { status: 400 });
   if (loadCompanies().some((c) => c.ats === ats.toLowerCase() && c.slug === slug)) throw Object.assign(new Error('that board is already in the table'), { status: 409 });

package/cli.mjs

@@ -41,6 +41,7 @@ const HELP = `tekjobs — a local job-search machine
   tekjobs up [--dev] [--port N]          start the API (and with --dev, Vite) detached: they stay up until \`down\`
   tekjobs down                           stop what \`up\` started
   tekjobs ps                             what \`up\` has running
+  tekjobs board <slug> [--from ats] [--move]  where a failed board answers now; --move rewrites the watchlist row
   tekjobs serve                          the app + API on http://127.0.0.1:8787, in this terminal
   tekjobs mcp                            the MCP server on stdio (Claude Code, Codex, Cursor, Claude Desktop)
 
@@ -171,6 +172,15 @@ async function main() {
     if (!s.dry) console.log(`  Index: ${s.indexPath}. Job notes now show who you know at each company.`);
     return;
   }
+  if (cmd === 'board') {
+    const slug = rest.find((x) => !x.startsWith('--') && x !== opt('--from'));
+    if (!slug) return console.error('Usage: tekjobs board <slug> [--from <ats that failed>] [--move]');
+    const { probeBoard, moveCompany } = await import('./scraper/find-board.mjs');
+    const r = await probeBoard(slug, { except: opt('--from') || '' });
+    console.log(r.note);
+    if (rest.includes('--move') && r.found[0]) { const m = moveCompany({ slug, from: opt('--from') || '', to: r.found[0].ats }); console.log(m.moved ? `Moved ${m.row.name} to ${m.row.ats}; the next scan reads it there.` : `${m.row.name} already reads from ${m.row.ats}.`); }
+    return;
+  }
   if (cmd === 'up') return up();
   if (cmd === 'down') return down();
   if (cmd === 'ps') return ps();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timurtekb/tekjobs",
-  "version": "0.32.1",
+  "version": "0.34.0",
   "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",

package/scraper/find-board.mjs

@@ -0,0 +1,51 @@
+// Where did a board go? A company that answers 404 on the platform the watchlist names has usually moved its
+// careers page to another tracker, often keeping the same slug (Amplitude, Hightouch and Outschool all went
+// from Greenhouse to Ashby). This asks every platform the scan can read, with the same slug, and reports the
+// ones that answer with jobs; `moveCompany` rewrites the row when the person says so.
+import fs from 'node:fs';
+import { P, loadCompanies } from './config.mjs';
+import { fetchCompany } from './sources.mjs';
+
+/** Platforms a slug alone identifies. Workday needs host/tenant/site; the career APIs are not per-company boards. */
+export const PROBE_ATS = ['greenhouse', 'ashby', 'lever', 'workable', 'smartrecruiters', 'rippling', 'bamboohr', 'breezy', 'personio', 'teamtailor', 'eightfold'];
+const ANY_TITLE = { titleTerms: {}, titleExclude: [] };
+
+/**
+ * Every platform that answers for this slug, best first (most jobs). `except` is the platform that already
+ * failed, left out. `fetch` is the board fetcher, injectable so a test needs no network.
+ */
+export async function probeBoard(slug, { name = slug, except = '', fetch = fetchCompany, platforms = PROBE_ATS } = {}) {
+  const tried = platforms.filter((p) => p !== except);
+  const results = await Promise.all(tried.map(async (ats) => {
+    try {
+      const r = await fetch({ name, ats, slug }, ANY_TITLE);
+      return { ats, ok: !!r.ok, jobs: r.ok ? (r.jobs || []).length : 0, error: r.ok ? '' : String(r.error || '') };
+    } catch (e) { return { ats, ok: false, jobs: 0, error: e.message }; }
+  }));
+  const found = results.filter((r) => r.ok && r.jobs > 0).sort((a, b) => b.jobs - a.jobs);
+  return { slug, except, tried, found, note: found.length ? `Answers on ${found.map((f) => `${f.ats} (${f.jobs} job${f.jobs === 1 ? '' : 's'})`).join(', ')}.` : `No platform answers for "${slug}". The company may have renamed its board; look at its careers page for the new slug.` };
+}
+
+/** Rewrite one watchlist row's platform in place; the status cell is cleared for the scan, the move is noted. */
+export function moveCompany({ name, slug, from, to }, { today = new Date().toISOString().slice(0, 10) } = {}) {
+  if (!slug || !to) throw Object.assign(new Error('slug and to are required'), { status: 400 });
+  const row = loadCompanies().find((c) => c.slug === slug && (!from || c.ats === from) && (!name || c.name === name));
+  if (!row) throw Object.assign(new Error(`No row for ${from ? from + ':' : ''}${slug} on the watchlist`), { status: 404 });
+  if (row.ats === to) return { moved: false, row };
+  const md = fs.readFileSync(P.companies, 'utf8');
+  let moved = false;
+  const out = md.split(/\r?\n/).map((line) => {
+    if (moved || !line.trim().startsWith('|')) return line;
+    const cells = line.split('|').slice(1, -1).map((c) => c.trim());
+    if (cells.length < 3 || cells[0] !== row.name || cells[1].toLowerCase() !== row.ats || cells[2] !== row.slug) return line;
+    while (cells.length < 6) cells.push('');
+    cells[1] = to;
+    cells[4] = '';
+    cells[5] = [cells[5], `moved from ${row.ats} ${today}`].filter(Boolean).join('; ');
+    moved = true;
+    return `| ${cells.join(' | ')} |`;
+  });
+  if (!moved) throw Object.assign(new Error(`Could not find the row for ${row.name} in ${P.companies}`), { status: 500 });
+  fs.writeFileSync(P.companies, out.join('\n'));
+  return { moved: true, row: { ...row, ats: to, status: '', notes: [row.notes, `moved from ${row.ats} ${today}`].filter(Boolean).join('; ') } };
+}

package/scraper/starter/companies-table.md

@@ -105,7 +105,7 @@
 | DoorDash | greenhouse | doordashusa | C | |  |
 | Lyft | greenhouse | lyft | C | |  |
 | Roblox | greenhouse | roblox | C | |  |
-| Amplitude | greenhouse | amplitude | C | |  |
+| Amplitude | ashby | amplitude | C | | moved to ashby 2026-10-07 |
 | Mixpanel | greenhouse | mixpanel | C | |  |
 | Lattice | greenhouse | lattice | C | |  |
 | Carta | greenhouse | carta | C | |  |
@@ -197,7 +197,7 @@
 | GitLab | greenhouse | gitlab | A | |  |
 | Headway | ashby | headway | B | |  |
 | Hex | ashby | hex | A | |  |
-| Hightouch | greenhouse | hightouch | B | |  |
+| Hightouch | ashby | hightouch | B | | moved to ashby 2026-10-07 |
 | Honeycomb | greenhouse | honeycomb | B | |  |
 | Included Health | lever | includedhealth | B | |  |
 | Inngest | ashby | inngest | B | |  |
@@ -224,7 +224,7 @@
 | Orum | ashby | orum | B | |  |
 | Oscar | greenhouse | oscar | B | |  |
 | Otter | greenhouse | otter | B | |  |
-| Outschool | greenhouse | outschool | B | |  |
+| Outschool | ashby | outschool | B | | moved to ashby 2026-10-07 |
 | Parloa | greenhouse | parloa | B | |  |
 | Payoneer | greenhouse | payoneer | B | |  |
 | Peloton | greenhouse | peloton | B | |  |