@timurtekb/tekjobs 0.24.1

package/scraper/starter/companies-table.md

@@ -0,0 +1,306 @@
+| Company | ATS | Slug | Tier | Status | Notes |
+|---|---|---|---|---|---|
+| Anthropic | greenhouse | anthropic | A | |  |
+| OpenAI | ashby | openai | A | |  |
+| Vercel | greenhouse | vercel | A | |  |
+| Linear | ashby | linear | A | |  |
+| Figma | greenhouse | figma | A | |  |
+| Notion | ashby | notion | A | |  |
+| Stripe | greenhouse | stripe | A | |  |
+| Webflow | greenhouse | webflow | A | |  |
+| Replit | ashby | replit | A | |  |
+| Cursor (Anysphere) | ashby | cursor | A | |  |
+| Perplexity | ashby | perplexity | A | |  |
+| Ramp | ashby | ramp | A | |  |
+| Mercury | greenhouse | mercury | A | |  |
+| Supabase | ashby | supabase | A | |  |
+| PostHog | ashby | posthog | A | |  |
+| Raycast | ashby | raycast | A | |  |
+| Sierra | ashby | sierra | A | |  |
+| Runway | ashby | runway | A | |  |
+| ElevenLabs | ashby | elevenlabs | A | |  |
+| Chromatic (Storybook) | ashby | chromatic | A | |  |
+| Gamma | ashby | gamma | A | |  |
+| Lovable | ashby | lovable | A | |  |
+| Tailwind Labs | ashby | tailwind | A | |  |
+| Magic Patterns | ashby | magicpatterns | A | | Design-to-code product |
+| Builder.io | greenhouse | builder | A | | Design-to-code product |
+| StackBlitz (Bolt) | greenhouse | stackblitz | A | |  |
+| Cohere | ashby | cohere | B | |  |
+| Scale AI | greenhouse | scaleai | B | |  |
+| Databricks | greenhouse | databricks | B | |  |
+| Cloudflare | greenhouse | cloudflare | B | |  |
+| Discord | greenhouse | discord | B | |  |
+| Dropbox | greenhouse | dropbox | B | |  |
+| Coinbase | greenhouse | coinbase | B | |  |
+| Brex | greenhouse | brex | B | |  |
+| Gusto | greenhouse | gusto | B | |  |
+| Plaid | ashby | plaid | B | |  |
+| Pinterest | greenhouse | pinterest | B | |  |
+| Reddit | greenhouse | reddit | B | |  |
+| Robinhood | greenhouse | robinhood | B | |  |
+| Zapier | ashby | zapier | B | |  |
+| Miro | ashby | miro | B | |  |
+| Duolingo | greenhouse | duolingo | B | |  |
+| Airbnb | greenhouse | airbnb | B | |  |
+| Sourcegraph | greenhouse | sourcegraph91 | B | |  |
+| Clerk | ashby | clerk | B | |  |
+| Mintlify | ashby | mintlify | B | |  |
+| Together AI | greenhouse | togetherai | B | |  |
+| Harvey | ashby | harvey | B | |  |
+| Glean | greenhouse | gleanwork | B | |  |
+| Writer | ashby | writer | B | |  |
+| Descript | greenhouse | descript | B | |  |
+| Airtable | greenhouse | airtable | B | |  |
+| Intercom | greenhouse | intercom | B | |  |
+| Asana | greenhouse | asana | B | |  |
+| Squarespace | greenhouse | squarespace | B | |  |
+| Netlify | greenhouse | netlify | B | |  |
+| Render | ashby | render | B | |  |
+| Railway | ashby | railway | B | |  |
+| Modal | ashby | modal | B | |  |
+| Baseten | ashby | baseten | B | |  |
+| LangChain | ashby | langchain | B | |  |
+| Neon | ashby | neon | B | |  |
+| Convex | ashby | convex-dev | B | |  |
+| Sentry | ashby | sentry | B | |  |
+| Vanta | ashby | vanta | B | |  |
+| 1Password | ashby | 1password | B | |  |
+| WorkOS | ashby | workos | B | |  |
+| Granola | ashby | granola | B | |  |
+| Cognition | ashby | cognition | B | |  |
+| Warp | ashby | warp | B | |  |
+| Zed | ashby | zed | B | |  |
+| Attio | ashby | attio | B | |  |
+| Clay | ashby | claylabs | B | |  |
+| Block | greenhouse | block | B | |  |
+| Modern Treasury | ashby | moderntreasury | B | |  |
+| Character.AI | ashby | character | B | |  |
+| Midjourney | ashby | midjourney | B | |  |
+| Resend | ashby | resend | B | |  |
+| Fal | ashby | fal-ai | B | |  |
+| Browserbase | ashby | browserbase | B | |  |
+| Decagon | ashby | decagon | B | |  |
+| Fireworks AI | ashby | fireworks | B | |  |
+| Anima | ashby | anima | B | | Design-to-code |
+| Bubble | ashby | bubble | B | |  |
+| Factory | ashby | factory | B | |  |
+| Glide | ashby | glide | B | |  |
+| Ideogram | ashby | ideogram | B | |  |
+| Krea | ashby | krea | B | |  |
+| Oura | greenhouse | oura | B | |  |
+| Patreon | ashby | patreon | B | |  |
+| Pika | ashby | pika | B | |  |
+| Sanity | ashby | sanity | B | |  |
+| Speak | ashby | speak | B | |  |
+| Storyblok | greenhouse | storyblok | B | |  |
+| Strava | ashby | strava | B | |  |
+| Substack | ashby | substack | B | |  |
+| Suno | ashby | suno | B | |  |
+| Thinking Machines | ashby | thinkingmachines | B | |  |
+| Pinecone | ashby | pinecone | C | |  |
+| Temporal | ashby | temporal | C | |  |
+| Apollo GraphQL | ashby | apollo-graphql | C | |  |
+| Instacart | greenhouse | instacart | C | |  |
+| DoorDash | greenhouse | doordashusa | C | |  |
+| Lyft | greenhouse | lyft | C | |  |
+| Roblox | greenhouse | roblox | C | |  |
+| Amplitude | greenhouse | amplitude | C | |  |
+| Mixpanel | greenhouse | mixpanel | C | |  |
+| Lattice | greenhouse | lattice | C | |  |
+| Carta | greenhouse | carta | C | |  |
+| Deel | ashby | deel | C | |  |
+| Remote.com | greenhouse | remotecom | C | |  |
+| Toast | greenhouse | toast | C | |  |
+| Contentful | greenhouse | contentful | C | |  |
+| Grafana Labs | greenhouse | grafanalabs | C | |  |
+| MongoDB | greenhouse | mongodb | C | |  |
+| LaunchDarkly | greenhouse | launchdarkly | C | |  |
+| Prisma | greenhouse | prisma | C | |  |
+| Klaviyo | greenhouse | klaviyo | C | |  |
+| Braze | greenhouse | braze | C | |  |
+| Affirm | greenhouse | affirm | C | |  |
+| Chime | greenhouse | chime | C | |  |
+| Mercor | ashby | mercor | C | |  |
+| xAI | greenhouse | xai | C | |  |
+| Mistral | lever | mistral | C | |  |
+| Assembly AI | greenhouse | assemblyai | C | |  |
+| Bland | ashby | bland | C | |  |
+| Datadog | greenhouse | datadog | C | |  |
+| Deepgram | ashby | deepgram | C | |  |
+| Elastic | greenhouse | elastic | C | |  |
+| Faire | greenhouse | faire | C | |  |
+| Galileo | greenhouse | galileo | C | |  |
+| Imbue | greenhouse | imbue | C | |  |
+| Nextdoor | greenhouse | nextdoor | C | |  |
+| Okta | greenhouse | okta | C | |  |
+| Poolside | ashby | poolside | C | |  |
+| Snowflake | ashby | snowflake | C | |  |
+| Twilio | greenhouse | twilio | C | |  |
+| Twitch | greenhouse | twitch | C | |  |
+| Udio | greenhouse | udio | C | |  |
+| Vapi | ashby | vapi | C | |  |
+| Whoop | ashby | whoop | C | |  |
+| Abridge | ashby | abridge | B | |  |
+| Alloy | greenhouse | alloy | B | |  |
+| Ambience | ashby | ambiencehealthcare | B | |  |
+| Anchorage | lever | anchorage | B | |  |
+| Anduril | greenhouse | andurilindustries | B | |  |
+| Anon | ashby | anon | B | |  |
+| Anyscale | lever | anyscale | B | |  |
+| Arcade | ashby | arcade | B | |  |
+| Arize | greenhouse | arizeai | B | |  |
+| Ashby | ashby | ashby | A | |  |
+| Atlan | ashby | atlan | B | |  |
+| Axiom | greenhouse | axiom | B | |  |
+| Benchling | ashby | benchling | B | |  |
+| BetterUp | ashby | betterup | B | |  |
+| Bitwarden | greenhouse | bitwarden | B | |  |
+| Brightwheel | ashby | brightwheel | B | |  |
+| Calendly | greenhouse | calendly | B | |  |
+| Cameo | greenhouse | cameo | B | |  |
+| Cartesia | ashby | cartesia | A | |  |
+| Cedar | ashby | cedar | B | |  |
+| Chainguard | greenhouse | chainguard | B | |  |
+| Chalk | ashby | chalk | B | |  |
+| Checkr | greenhouse | checkr | B | |  |
+| Circle | ashby | circle | B | |  |
+| ClickHouse | ashby | clickhouse | B | |  |
+| Cockroach Labs | greenhouse | cockroachlabs | B | |  |
+| Coder | ashby | coder | B | |  |
+| Coframe | ashby | coframe | A | |  |
+| Column | ashby | column | B | |  |
+| Comet | greenhouse | comet | B | |  |
+| Commure | ashby | commure | B | |  |
+| Cribl | greenhouse | cribl | B | |  |
+| Crusoe | ashby | crusoe | B | |  |
+| Current | greenhouse | current | B | |  |
+| Dandy | ashby | dandy | B | |  |
+| Dave | ashby | dave | B | |  |
+| Depot | ashby | depot | B | |  |
+| Docker | ashby | docker | A | |  |
+| Doppler | ashby | doppler | B | |  |
+| Doximity | greenhouse | doximity | B | |  |
+| Dremio | greenhouse | dremio | B | |  |
+| Dust | ashby | dust | A | |  |
+| E2B | ashby | e2b | B | |  |
+| Elicit | ashby | elicit | A | |  |
+| Ethos | greenhouse | ethoslife | B | |  |
+| Exa | ashby | exa | A | |  |
+| Fable | ashby | fable | A | |  |
+| Fandom | greenhouse | fandom | B | |  |
+| Fireblocks | greenhouse | fireblocks | B | |  |
+| Fivetran | greenhouse | fivetran | B | |  |
+| Flexport | greenhouse | flexport | B | |  |
+| Fly.io | lever | fly | B | |  |
+| Found | greenhouse | found | B | |  |
+| GitLab | greenhouse | gitlab | A | |  |
+| Headway | ashby | headway | B | |  |
+| Hex | ashby | hex | A | |  |
+| Hightouch | greenhouse | hightouch | B | |  |
+| Honeycomb | greenhouse | honeycomb | B | |  |
+| Included Health | lever | includedhealth | B | |  |
+| Inngest | ashby | inngest | B | |  |
+| Knock | greenhouse | knock | B | |  |
+| Kong | ashby | kong | B | |  |
+| Lambda | ashby | lambda | B | |  |
+| Lightdash | ashby | lightdash | B | |  |
+| Lithic | greenhouse | lithic | B | |  |
+| Luma AI | ashby | lumaai | A | |  |
+| Match | lever | matchgroup | B | |  |
+| Maven | greenhouse | mavenclinic | B | |  |
+| Maze | ashby | mazedesign | A | |  |
+| Melio | greenhouse | melio | B | |  |
+| Mem0 | ashby | mem0 | B | |  |
+| Meter | ashby | meter | B | |  |
+| Motive | greenhouse | motive | B | |  |
+| Mux | ashby | mux | B | |  |
+| Navan | greenhouse | tripactions | B | |  |
+| Numeric | ashby | numeric | B | |  |
+| Nuro | greenhouse | nuro | B | |  |
+| Omni | ashby | omni | B | |  |
+| One Medical | greenhouse | onemedical | B | |  |
+| OpenSea | ashby | opensea | B | |  |
+| Orum | ashby | orum | B | |  |
+| Oscar | greenhouse | oscar | B | |  |
+| Otter | greenhouse | otter | B | |  |
+| Outschool | greenhouse | outschool | B | |  |
+| Parloa | greenhouse | parloa | B | |  |
+| Payoneer | greenhouse | payoneer | B | |  |
+| Peloton | greenhouse | peloton | B | |  |
+| Pencil | ashby | pencil | A | |  |
+| Persona | ashby | persona | B | |  |
+| PlanetScale | greenhouse | planetscale | B | |  |
+| Pocket FM | lever | pocketfm | B | |  |
+| Public | greenhouse | public | B | |  |
+| Pylon | ashby | pylon | B | |  |
+| Quora | ashby | quora | B | |  |
+| Recharge | ashby | recharge | B | |  |
+| Relevance AI | ashby | relevanceai | B | |  |
+| Rewind | ashby | rewind | B | |  |
+| Rho | ashby | rho | B | |  |
+| Ro | lever | ro | B | |  |
+| Rubrik | greenhouse | rubrik | B | |  |
+| Rula | ashby | rula | B | |  |
+| Runpod | ashby | runpod | B | |  |
+| Samsara | greenhouse | samsara | B | |  |
+| Sardine | ashby | sardine | B | |  |
+| Scribe | ashby | scribe | B | |  |
+| Sigma Computing | greenhouse | sigmacomputing | B | |  |
+| Skydio | ashby | skydio | B | |  |
+| Snorkel | greenhouse | snorkelai | B | |  |
+| SoFi | greenhouse | sofi | B | |  |
+| Speakeasy | ashby | speakeasy | B | |  |
+| Sprig | ashby | sprig | B | |  |
+| Stack AI | ashby | stack-ai | B | |  |
+| Starburst | greenhouse | starburst | B | |  |
+| Step | greenhouse | step | B | |  |
+| Stytch | ashby | stytch | B | |  |
+| Synthesia | ashby | synthesia | A | |  |
+| Tavus | ashby | tavus | B | |  |
+| Tennr | ashby | tennr | B | |  |
+| Thumbtack | ashby | thumbtack | B | |  |
+| Tinybird | lever | tinybird | B | |  |
+| Tldraw | ashby | tldraw | A | |  |
+| Tubi | greenhouse | tubi | B | |  |
+| Udemy | greenhouse | udemy | B | |  |
+| Unify | lever | unify | B | |  |
+| Unit | ashby | unit | B | |  |
+| Upstart | greenhouse | upstart | B | |  |
+| Verkada | greenhouse | verkada | B | |  |
+| Vox Media | greenhouse | voxmedia | B | |  |
+| Wealthfront | lever | wealthfront | B | |  |
+| Zencoder | greenhouse | zencoder | B | |  |
+| Zip | ashby | zip | B | |  |
+| Zocdoc | greenhouse | zocdoc | B | |  |
+| Zscaler | greenhouse | zscaler | B | |  |
+| Zus | lever | zushealth | B | |  |
+| Adobe | workday | adobe.wd5.myworkdayjobs.com/adobe/external_experienced | A | | Spectrum design system |
+| Autodesk | workday | autodesk.wd1.myworkdayjobs.com/autodesk/Ext | B | |  |
+| Salesforce | workday | salesforce.wd12.myworkdayjobs.com/salesforce/External_Career_Site | B | | Lightning design system |
+| Slack | workday | salesforce.wd12.myworkdayjobs.com/salesforce/Slack | A | |  |
+| Workday | workday | workday.wd5.myworkdayjobs.com/workday/Workday | C | |  |
+| PayPal | workday | paypal.wd1.myworkdayjobs.com/paypal/jobs | C | |  |
+| Broadcom (VMware) | workday | broadcom.wd1.myworkdayjobs.com/broadcom/External_Career | C | |  |
+| Warner Bros. Discovery | workday | warnerbros.wd5.myworkdayjobs.com/warnerbros/global | B | | CNN design systems role seen |
+| Disney | workday | disney.wd5.myworkdayjobs.com/disney/disneycareer | B | |  |
+| Target | workday | target.wd5.myworkdayjobs.com/target/targetcareers | C | |  |
+| Capital One | workday | capitalone.wd12.myworkdayjobs.com/capitalone/Capital_One | C | |  |
+| Nvidia | workday | nvidia.wd5.myworkdayjobs.com/nvidia/NVIDIAExternalCareerSite | C | | mostly hardware titles |
+| Atlassian | atlassian | - | A | | remote-first; own careers API |
+| GitHub | github | - | A | | remote-first; own careers API |
+| Netflix | eightfold | explore.jobs.netflix.net/netflix.com | A | | top pay bands; keyword-searched |
+| Spotify | spotify | - | B | | work-from-anywhere; API lists no descriptions |
+| Amazon | amazon | - | C | | US only, keyword-searched; rarely remote |
+| Google | google | - | A | | US, keyword-searched from the careers page; no API, no posted dates; mostly on-site |
+| Apple | apple | - | A | | US, keyword-searched via the jobs.apple.com search endpoint; mostly on-site |
+| Canonical | greenhouse | canonical | C | | fully remote, pay usually under floor |
+| Mozilla | greenhouse | mozilla | B | | remote |
+| Wikimedia | greenhouse | wikimedia | C | | remote |
+| Wise | smartrecruiters | Wise | B | | fintech, design eng culture |
+| Ubisoft | smartrecruiters | Ubisoft2 | C | |  |
+| Rippling | rippling | rippling | B | | also the ATS platform |
+| Webull | rippling | webull | C | |  |
+| Malwarebytes | rippling | malwarebytes | C | |  |
+| Alfred | rippling | alfred | C | |  |
+| Consensus | rippling | consensus | C | |  |

package/scraper/starter/criteria.json

@@ -0,0 +1,56 @@
+{
+  "minScore": 45,
+  "descCap": 35,
+  "noTitleMatchPenalty": -40,
+  "titleExtraPer": 5,
+  "titleExtraCap": 10,
+  "titleTerms": {},
+  "titleExclude": [
+    "intern", "internship", "apprentice", "new grad", "recruit", "account executive", "customer success",
+    "manufacturing", "process engineer", "chemical", "biomedical", "automotive", "aerospace"
+  ],
+  "descTerms": {},
+  "seniority": {
+    "boost": { "senior": 8, "staff": 10, "lead": 10, "principal": 10, "head of": 8, "founding": 8 },
+    "penalty": { "junior": -30, "intern": -50, "entry": -25, "associate": -15, "new grad": -40 }
+  },
+  "salary": { "minAnnual": null, "stretchAnnual": null, "meetsBonus": 10, "abovePer10k": 1, "aboveCap": 8, "stretchPenalty": -8, "belowPenalty": -30 },
+  "location": {
+    "requireRemote": false,
+    "notRemotePenalty": -60,
+    "remoteBoost": 15,
+    "bayAreaBoost": 0,
+    "bayAreaTerms": [],
+    "usTerms": ["united states", "usa", "u.s.", "us-", "us ", "(us)", "us)", "north america", "americas", "remote - us", "remote us", "us remote", "anywhere"],
+    "nonUsTerms": ["london", "berlin", "paris", "amsterdam", "dublin", "europe", "emea", "uk", "united kingdom", "germany", "france", "netherlands", "spain", "portugal", "poland", "india", "bangalore", "bengaluru", "hyderabad", "singapore", "sydney", "melbourne", "australia", "toronto", "vancouver", "canada", "brazil", "são paulo", "sao paulo", "mexico city", "latam", "apac", "tokyo", "japan", "israel", "tel aviv", "stockholm", "copenhagen", "zurich", "lisbon", "warsaw", "prague", "tallinn", "riga", "riyadh", "saudi arabia", "dubai", "abu dhabi", "uae", "united arab emirates", "middle east", "korea", "seoul", "china", "shanghai", "beijing", "hong kong", "taiwan", "philippines", "vietnam", "indonesia", "nigeria", "south africa", "argentina", "colombia", "chile", "ottawa", "montreal", "waterloo"],
+    "nonUsPenalty": -45
+  },
+  "recency": { "days2": 25, "days7": 15, "days30": 5, "days90": -5, "older": -25 },
+  "openSources": {
+    "remoteok": true, "hn": true, "email": true, "adzuna": false, "usajobs": false,
+    "themuse": true, "remotive": false, "himalayas": true, "jobicy": true,
+    "workingnomads": true, "arbeitnow": false, "wwr": true,
+    "wellfound": true, "builtin": true
+  },
+  "adzuna": {
+    "_note": "Needs ADZUNA_APP_ID and ADZUNA_APP_KEY in the environment (free at developer.adzuna.com), and openSources.adzuna set to true. Searches for your top titleTerms unless queries is set. Descriptions come back as snippets, so these rows score lower than the same job from its ATS.",
+    "countries": ["us"],
+    "queries": [],
+    "maxQueries": 6,
+    "pages": 2,
+    "maxDaysOld": 30
+  },
+  "email": {
+    "_note": "Job alert emails you save into the Inbox folder of your profile, as .eml. Nothing contacts the sites; this reads files you put there. Understands LinkedIn, Indeed, Otta and Wellfound alerts, and picks up Greenhouse/Lever/Ashby/Workday links in anything else. Rows are thin — a title, a company, usually a location — so they score below the same job from an ATS.",
+    "maxFiles": 200
+  },
+  "usajobs": {
+    "_note": "Needs USAJOBS_API_KEY and USAJOBS_EMAIL in the environment (free at developer.usajobs.gov; the email is the one the key is registered to), and openSources.usajobs set to true. Every US federal posting, with full descriptions and a real application deadline. Searches your top titleTerms as position titles unless searchBy is \"keyword\" or queries is set.",
+    "queries": [],
+    "maxQueries": 6,
+    "pages": 2,
+    "datePosted": 30,
+    "searchBy": "title"
+  },
+  "maxDescriptionChars": 6000
+}

package/scraper/starter/profile.md

@@ -0,0 +1,38 @@
+---
+type: profile
+updated: {{date}}
+status: draft
+---
+# Candidate profile
+
+> Written by the onboarding interview from your resume and your answers. Edit freely; the scraper does not read this note (it reads [[Targets/Search Criteria]]), but every application draft does.
+
+## Basics
+- **Name:**
+- **Location / time zone:**
+- **Email:**
+- **Links:**
+- **Current role:**
+
+## What you are, in three sentences
+(The interview fills this in: the through-line of the career, what you are strongest at, what you want next.)
+
+## Target roles
+| Tier | Titles | Why |
+|---|---|---|
+| A | | |
+| B | | |
+
+## Constraints & preferences
+- **Work mode:** remote / hybrid / on-site, and where
+- **Employment:** full-time / contract
+- **Pay floor and stretch:**
+- **Company stage / size:**
+- **Industries to avoid:**
+- **Earliest start:**
+
+## Proof points
+(Quantified outcomes from the resume, one line each. These are what cover letters are built from.)
+
+## Documents
+- Resume source: [[Profile/Resume - Source]]

package/scraper/vault.mjs

@@ -0,0 +1,212 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { P, VAULT } from './config.mjs';
+import { weightsFingerprint } from './rescore.mjs';
+
+const today = () => new Date().toISOString().slice(0, 10);
+const yaml = (v) => JSON.stringify(v ?? '');
+const safe = (s) => (s || '').replace(/[<>:"/\\|?*\x00-\x1f]/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 70);
+// The tail of the id becomes part of the filename, so only word characters may reach it. A link id ends in a
+// URL, and a URL's trailing slash became a path separator on Windows: "Meta - … (2149585\).md" did not exist.
+const shortId = (id) => String(id).split(':').pop().replace(/[^A-Za-z0-9_-]+/g, '').slice(-8) || 'link';
+
+export function loadSeen() {
+  try { return JSON.parse(fs.readFileSync(P.seen, 'utf8')); } catch { return {}; }
+}
+export function saveSeen(seen) {
+  fs.writeFileSync(P.seen, JSON.stringify(seen, null, 2));
+}
+
+/**
+ * The Narrative line the note template used to pre-fill, before it was emptied.
+ *
+ * It named one person's positioning in every note the scraper wrote, which is wrong for anyone else's vault.
+ * Kept here because notes written before the change still carry it, and something has to be able to tell that
+ * line apart from a narrative a reader actually chose.
+ */
+export const LEGACY_NARRATIVE_DEFAULT = 'Design Engineer leads, AI work as proof (see [[Profile/Positioning]])';
+
+export function jobNotePath(job) {
+  return path.join(P.jobs, `${safe(job.company)} - ${safe(job.title)} (${shortId(job.id)}).md`);
+}
+
+export function writeJobNote(job, scored, criteria) {
+  const file = jobNotePath(job);
+  // Never overwrite a note that exists: it may carry the person's status and notes. (Guards a lost or reset seen.json.)
+  if (fs.existsSync(file)) return file;
+  const desc = (job.descriptionText || '').slice(0, criteria.maxDescriptionChars ?? 6000);
+  const truncated = (job.descriptionText || '').length > desc.length;
+  const posted = job.posted ? String(job.posted).slice(0, 10) : '';
+  const fm = [
+    '---',
+    'type: job',
+    'status: new',
+    'listing: open',
+    `company: ${yaml(job.company)}`,
+    `title: ${yaml(job.title)}`,
+    `location: ${yaml(job.location)}`,
+    `remote: ${job.remote ? 'true' : 'false'}`,
+    `source: ${job.source}`,
+    `url: ${yaml(job.url)}`,
+    `score: ${scored.score}`,
+    // Which weights produced that score, so `tekjobs rescore` can tell an adjusted note from an untouched one.
+    `weights: ${weightsFingerprint(criteria)}`,
+    `posted: ${yaml(posted)}`,
+    `found: ${today()}`,
+    `salary: ${yaml(job.salary)}`,
+    `salary_max: ${job.salaryMax || ''}`,
+    `pay_band: ${scored.payBand || 'unknown'}`,
+    `department: ${yaml(job.department)}`,
+    `job_id: ${yaml(job.id)}`,
+    // Only on notes that did not come from the scan, so a scanned note keeps the shape it always had.
+    ...(job.foundVia ? [`added_by: ${job.addedBy || 'link'}`] : []),
+    `tags: [job${scored.payBand === 'stretch' ? ', stretch' : ''}]`,
+    '---',
+  ].join('\n');
+
+  const body = `
+# ${job.title} @ ${job.company}
+
+**[Open posting](${job.url})** · ${job.location || 'location n/a'} · ${job.remote ? 'Remote' : 'On-site/Hybrid'} · score **${scored.score}**${job.salary ? ` · ${job.salary}` : ''}
+
+## Why it matched
+${scored.reasons.map((r) => `- ${r}`).join('\n')}
+
+## Status log
+- ${today()} — ${job.foundVia || 'found by scraper'} (score ${scored.score}). 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: ${job.source}${job.thread ? ` · ${job.thread}` : ''}${truncated ? ' · truncated, open the posting for the full text' : ''}
+
+${desc}
+`;
+  fs.writeFileSync(file, fm + '\n' + body);
+  return file;
+}
+
+/** Minimal frontmatter reader: --- key: value --- */
+export function readFrontmatter(file) {
+  let txt;
+  try { txt = fs.readFileSync(file, 'utf8'); } catch { return null; }
+  const m = txt.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!m) return null;
+  const fm = {};
+  for (const line of m[1].split(/\r?\n/)) {
+    const i = line.indexOf(':');
+    if (i < 0) continue;
+    const k = line.slice(0, i).trim();
+    let v = line.slice(i + 1).trim();
+    if (/^".*"$/.test(v)) { try { v = JSON.parse(v); } catch { /* keep */ } }
+    fm[k] = v;
+  }
+  fm._file = file;
+  fm._name = path.basename(file, '.md');
+  return fm;
+}
+
+export function allJobNotes() {
+  if (!fs.existsSync(P.jobs)) return [];
+  return fs.readdirSync(P.jobs).filter((f) => f.endsWith('.md')).map((f) => readFrontmatter(path.join(P.jobs, f))).filter(Boolean);
+}
+
+/** Mark notes whose listing vanished from a successfully fetched board. Only touches the `listing:` line. */
+export function markClosedListings(liveIdsByCompanyKey, seen) {
+  const closed = [];
+  for (const [id, rec] of Object.entries(seen)) {
+    if (!rec.path || !fs.existsSync(rec.path)) continue;
+    const key = rec.companyKey;
+    if (!key || !(key in liveIdsByCompanyKey)) continue; // board not fetched this run
+    if (liveIdsByCompanyKey[key].has(id)) continue;
+    const txt = fs.readFileSync(rec.path, 'utf8');
+    if (!/^listing: open$/m.test(txt)) continue;
+    fs.writeFileSync(rec.path, txt.replace(/^listing: open$/m, `listing: closed ${today()}`));
+    closed.push(rec);
+  }
+  return closed;
+}
+
+export function appendLog(lines) {
+  const file = path.join(P.logs, `${today()}.md`);
+  const header = fs.existsSync(file) ? '' : `---\ntype: log\ndate: ${today()}\n---\n# ${today()} — scraper log\n\n`;
+  fs.appendFileSync(file, header + lines.join('\n') + '\n\n');
+  return file;
+}
+
+const link = (fm) => `[[Jobs/${fm._name}|open]]`;
+const row = (cells) => `| ${cells.map((c) => String(c ?? '').replace(/\|/g, '\\|')).join(' | ')} |`;
+
+export function writeDashboard(summary) {
+  const notes = allJobNotes();
+  const byStatus = {};
+  for (const n of notes) (byStatus[n.status || 'new'] ||= []).push(n);
+  const order = ['new', 'reviewing', 'applying', 'applied', 'interviewing', 'offer', 'rejected', 'passed'];
+  const statuses = [...order.filter((s) => byStatus[s]), ...Object.keys(byStatus).filter((s) => !order.includes(s))];
+
+  const newOpen = (byStatus.new || []).filter((n) => String(n.listing).startsWith('open')).sort((a, b) => Number(b.score) - Number(a.score));
+  const active = notes.filter((n) => ['applying', 'applied', 'interviewing', 'offer'].includes(n.status));
+  const closedNew = (byStatus.new || []).filter((n) => String(n.listing).startsWith('closed'));
+
+  const out = [];
+  out.push('---', 'type: dashboard', `generated: ${new Date().toISOString()}`, '---');
+  out.push('# TekJobs — Home');
+  out.push(`> Generated by the scraper. Edits here get overwritten; write in the job notes or [[Applications/Pipeline Notes]].`);
+  out.push('');
+  out.push(`**Last run:** ${summary.when} · ${summary.companiesOk}/${summary.companiesTotal} boards fetched (${summary.companiesFailed} failed) · ${summary.totalJobs} postings scanned · **${summary.newMatches} new matches** · log: [[Logs/${today()}]]`);
+  out.push('');
+  out.push('## Needs you');
+  out.push(`- **${newOpen.length}** new matches waiting for a first look (below).`);
+  // Only while the profile is still the template: a finished profile has no open questions to nag about.
+  const profileMd = (() => { try { return fs.readFileSync(P.profile, 'utf8'); } catch { return ''; } })();
+  if (!profileMd || /^status: draft$/m.test(profileMd) || profileMd.includes('(The interview fills this in')) out.push(`- The profile is not written yet: run the onboarding interview, or fill in [[Profile/Profile]] by hand.`);
+  if (summary.companiesFailed) out.push(`- ${summary.companiesFailed} company slugs failed; see the Status column in [[Targets/Companies]].`);
+  out.push('');
+  out.push('## Pipeline');
+  out.push(row(['Status', 'Count']), row(['---', '---']));
+  for (const s of statuses) out.push(row([s, byStatus[s].length]));
+  out.push('');
+  out.push(`## New matches — top ${Math.min(40, newOpen.length)} of ${newOpen.length} by score`);
+  const bandMark = (n) => ({ floor: '✅ floor', stretch: '↗ stretch', below: '↓ below', unknown: '' })[n.pay_band || 'unknown'];
+  out.push(row(['Score', 'Company', 'Role', 'Location', 'Pay', 'Band', 'Posted', 'Note']), row(['---', '---', '---', '---', '---', '---', '---', '---']));
+  for (const n of newOpen.slice(0, 40)) out.push(row([n.score, n.company, `[${n.title}](${n.url})`, n.location, n.salary || '', bandMark(n), n.posted, link(n)]));
+  const stretch = newOpen.filter((n) => n.pay_band === 'stretch');
+  if (stretch.length) {
+    out.push('');
+    out.push(`## Stretch band — stated pay $180k to $220k (${stretch.length})`);
+    out.push('_Visible on purpose, scored slightly down. Senior-level roles that would want a negotiation to reach the floor._');
+    out.push(row(['Score', 'Company', 'Role', 'Pay', 'Note']), row(['---', '---', '---', '---', '---']));
+    for (const n of stretch.slice(0, 25)) out.push(row([n.score, n.company, `[${n.title}](${n.url})`, n.salary || '', link(n)]));
+  }
+  out.push('');
+  out.push('## Active applications');
+  if (!active.length) out.push('_None yet._');
+  else {
+    out.push(row(['Status', 'Company', 'Role', 'Found', 'Note']), row(['---', '---', '---', '---', '---']));
+    for (const n of active) out.push(row([n.status, n.company, `[${n.title}](${n.url})`, n.found, link(n)]));
+  }
+  out.push('');
+  if (closedNew.length) {
+    out.push('## Listings that closed before review');
+    for (const n of closedNew.slice(0, 20)) out.push(`- ${n.company} — ${n.title} (${n.listing}) ${link(n)}`);
+    out.push('');
+  }
+  out.push('## Map');
+  out.push('- [[Profile/Profile]] · [[Profile/Resume - Master]] · [[Profile/Positioning]]');
+  out.push('- [[Targets/Search Criteria]] · [[Targets/Companies]]');
+  out.push('- [[Templates/Cover Letter]] · [[Templates/Outreach]] · [[Automation/README]]');
+  out.push('');
+  fs.writeFileSync(P.home, out.join('\n'));
+  return { newOpen: newOpen.length, active: active.length };
+}
+
+export { VAULT };