jobless 1.3.0 → 1.5.0

package/src/data.js

@@ -15,31 +15,96 @@ export const profile = {
   resume: 'https://yonasalem.vercel.app/assets/resume.pdf',
 };
 
-export const hireMailto = `mailto:${profile.email}?subject=${encodeURIComponent(
-  'npx jobless — Yonas Alem',
-)}&body=${encodeURIComponent('I ran npx jobless. I want to talk about a role.\n')}`;
+export const hireSubjects = {
+  recruiter: 'npx jobless — recruiter intro for a role',
+  manager: 'npx jobless — hiring manager, skip the form',
+  default: 'npx jobless — Yonas Alem',
+};
+
+export const mailtoFor = ({ report, to } = {}) => {
+  const subject = hireSubjects[to] || hireSubjects.default;
+  let body = 'I ran npx jobless. I want to talk about a role.\n';
+  if (report?.letter) {
+    body += `\nI linted a posting.\nRESULT: ${report.letter.result} (${report.score}/100)\n`;
+    body += report.letter.reasons.map((reason) => `- ${reason}`).join('\n');
+    body += '\n';
+  }
+  if (report?.fit?.matched?.length) {
+    body += `\nOverlap: ${report.fit.matched.join(', ')}\n`;
+  }
+  return `mailto:${profile.email}?subject=${encodeURIComponent(subject)}&body=${encodeURIComponent(body)}`;
+};
+
+export const hireMailto = mailtoFor();
+
+export const vcard = () =>
+  [
+    'BEGIN:VCARD',
+    'VERSION:3.0',
+    `FN:${profile.name}`,
+    'N:Alem;Yonas;;;',
+    `TITLE:${profile.title}`,
+    `EMAIL;TYPE=INTERNET,PREF:${profile.email}`,
+    `TEL;TYPE=CELL:${profile.phone.replace(/\s+/g, '')}`,
+    `ADR;TYPE=WORK:;;${profile.location};;;;`,
+    `URL:${profile.website}`,
+    `URL:${profile.github}`,
+    `URL:${profile.linkedin}`,
+    `NOTE:${signature.lines.at(-1)}`,
+    'END:VCARD',
+    '',
+  ].join('\n');
 
 export const stats = [
   { value: '5+', label: 'years in production' },
-  { value: '35%', label: 'infra cost cut' },
-  { value: '~30%', label: 'performance gain' },
-  { value: '3B+', label: 'ETB payment volume' },
+  { value: '~35%', label: 'infra cut (Mereb)' },
+  { value: '~30%', label: 'perf gain (Mereb)' },
+  { value: '3B+', label: 'ETB on rails I integrated' },
+];
+
+export const claims = [
+  {
+    value: '~35% / ~$100K a year',
+    label: 'infra cost',
+    who: 'Senior Software Engineer, Mereb Technologies',
+    method:
+      'Database, caching, and resource optimization on a production gaming platform. An engineering estimate, not a finance-signed audit.',
+  },
+  {
+    value: '~30%',
+    label: 'platform performance',
+    who: 'Senior Software Engineer, Mereb Technologies',
+    method: 'Indexing, read/write separation, caching, pagination, transactional operations, redesigned status-checking.',
+  },
+  {
+    value: '2 hours → under 30 minutes',
+    label: 'reports on ~1M-row datasets',
+    who: 'Senior Software Engineer, Mereb Technologies',
+    method: 'Moved aggregation off ad-hoc application paths onto the database.',
+  },
+  {
+    value: '3B+ ETB / 100K+ downloads',
+    label: 'payment volume on products I integrated',
+    who: 'Frontend Developer, Eaglelion — client payment workflows, not the bank and not the ledger',
+    method:
+      'Mastercard, Visa, Telebirr, and bank APIs: states, callbacks, failures, retries, verification, SOAP→REST. The products handled the volume. I built the client rails.',
+  },
 ];
 
 export const signature = {
   title: 'The deploy that killed 17 cron jobs',
   lines: [
-    'Recurring Amazon sync jobs silently stopped after every deploy.',
-    'Traced it through BullMQ, ioredis, the Node process lifecycle, and the Railway scheduler.',
-    'Then added explicit shutdown handling across 17 cron processes.',
+    'After every deploy, recurring Amazon sync jobs died quietly. Dashboards looked fine until the data was a day old.',
+    'Traced it through BullMQ job state, ioredis connections, Node process shutdown, and the Railway scheduler.',
+    'Then added explicit shutdown handling across 17 cron processes so a deploy could not leave work stranded.',
     'I debug silent production failures. That is the job.',
   ],
 };
 
 export const about = [
-  'I build and fix production systems across payments, gaming, ecommerce, advertising, and government services — from PostgreSQL and backend services through React, AWS, and the last mile of production debugging.',
-  'I have cut infrastructure spend by about 35% (roughly $100K a year), improved platform performance around 30%, and integrated payment rails that have handled more than 3 billion ETB in transaction volume.',
-  'Day to day I work across the stack: schema design, APIs, React frontends, AWS infrastructure, and the kind of debugging that starts with a silent failure and ends with a safer system.',
+  'I am a senior full-stack engineer in Addis Ababa. I work in Node.js, PostgreSQL, and React, usually on systems where a silent failure costs real money.',
+  'The numbers have owners. Infra and performance: Mereb, as senior engineer on a real-money gaming platform. Payment volume: Eaglelion, as the frontend engineer who integrated the client rails — not the bank.',
+  'Production code lives in private employer repos. The case studies in `work` are the public record. I will walk through the systems on a call. Remote from Ethiopia, EAT (UTC+3).',
 ];
 
 export const lookingFor = {
@@ -90,9 +155,9 @@ export const experience = [
     place: 'Remote',
     points: [
       'Amazon seller analytics: marketplace analytics, FBA, finance, PPC, and inventory.',
-      'Traced recurring sync jobs that silently died after every deploy; added explicit shutdown handling across 17 cron processes.',
-      'Integrated Amazon SP-API and Ads auth end to end: OAuth, LWA, encrypted credentials.',
-      'Extended the platform to UK and EU marketplaces with VAT-aware margins.',
+      'Diagnosed sync jobs that died after every deploy; shutdown handling across 17 cron processes. See `proof`.',
+      'Amazon SP-API and Ads auth end to end: OAuth, LWA, encrypted credentials.',
+      'UK and EU marketplaces with VAT-aware margins. Moved expensive aggregations into SQL.',
     ],
     stack: ['Node.js', 'PostgreSQL', 'BullMQ', 'Redis', 'React', 'Amazon SP-API'],
   },
@@ -102,11 +167,10 @@ export const experience = [
     dates: 'Apr 2022 – Nov 2025',
     place: 'Addis Ababa',
     points: [
-      'Owned a real-money gaming platform: loyalty, payouts, fraud, reporting, infra.',
-      'Improved platform performance ~30% with indexing, caching, and read/write separation.',
-      'Cut infrastructure cost ~35%, about $100K a year.',
-      'Dropped report generation on ~1M-row datasets from 2 hours to under 30 minutes.',
-      'Mentored 3 junior engineers.',
+      'Owned the production gaming platform end to end in these domains: loyalty, payouts, fraud, reporting — not the whole company.',
+      '~30% platform performance: indexing, read/write separation, caching, pagination, redesigned status-checking.',
+      '~35% infra cost, about $100K a year: database, cache, and resource optimization. Engineering estimate.',
+      'Reports on ~1M-row datasets: 2 hours to under 30 minutes. Mentored 3 juniors on APIs, debugging, and design.',
     ],
     stack: ['PostgreSQL', 'gRPC', 'PHP', 'React', 'AWS', 'Datadog'],
   },
@@ -114,72 +178,155 @@ export const experience = [
     role: 'Full Stack Developer (Contract)',
     company: 'Affiliate.com',
     dates: 'Feb 2023 – Aug 2023',
-    place: 'Remote',
+    place: 'Remote · alongside Mereb',
     points: [
       'Migrated a legacy PHP API to Node.js and tRPC without breaking the React UI.',
-      'Cut report generation time ~40% by moving it onto Google Cloud Storage.',
-      'Rebuilt validation in Zod and reached ~85% test coverage on migrated code.',
+      'Reimplemented legacy SQL in Prisma while both platforms ran in parallel.',
+      'Cut report generation ~40% by moving it onto Google Cloud Storage. ~85% coverage on migrated code.',
     ],
     stack: ['Node.js', 'tRPC', 'Prisma', 'React', 'Zod', 'GCS'],
   },
+  {
+    role: 'Backend Engineer (Contract)',
+    company: 'Autobridge Systems',
+    dates: 'Contract',
+    place: 'Addis Ababa · government constituent platform',
+    points: [
+      'Backend for complaints, document approvals, and internal communication, with access control and encryption.',
+      'Traced multi-minute email-record loads to missing indexes. Those operations improved more than 10x.',
+    ],
+    stack: ['PostgreSQL', 'Node.js', 'Encryption'],
+  },
   {
     role: 'Frontend Developer',
     company: 'Eaglelion Systems Technology',
     dates: 'Feb 2021 – Apr 2022',
     place: 'Addis Ababa',
     points: [
-      'Integrated Mastercard, Visa, Telebirr, and bank APIs into products with 100K+ downloads.',
-      'Payment workflows across 3B+ ETB in transaction volume: callbacks, retries, reconciliation.',
-      'Raised GTmetrix from 45 to 97 and cut page load ~25%.',
+      'Client payment workflows on products with 100K+ downloads that have handled 3B+ ETB. I integrated the rails, not the ledger.',
+      'Mastercard, Visa, Telebirr, bank APIs: states, callbacks, failures, retries, verification. SOAP→REST against incomplete docs.',
+      'GTmetrix 45 → 97. Page load ~25% faster: code splitting, lazy loading, assets.',
     ],
     stack: ['React', 'Next.js', 'Tailwind', 'Payment APIs'],
   },
 ];
 
-export const work = [
+export const cases = [
   {
-    title: 'Amazon seller analytics platform',
+    id: 'crons',
+    title: 'The deploy that killed 17 cron jobs',
     company: 'TPK Synergy Limited',
-    blurb: 'Production reliability, Amazon integrations, and the data path behind the dashboard.',
+    role: 'Senior Full Stack Engineer',
+    kind: 'Reliability · private production',
+    problem:
+      'After every deploy, recurring Amazon sync jobs died quietly. Dashboards looked fine until the data was a day old.',
+    trace: [
+      'BullMQ job state — work marked active, then gone',
+      'ioredis connections closing with the Node process',
+      'Node shutdown: no drain, no SIGTERM handler that waited',
+      'Railway scheduler: the next tick assumed the last run had finished',
+    ],
+    change: 'Explicit shutdown handling across 17 cron processes so a deploy could not leave work stranded.',
+    result: 'Sync jobs survive deploys instead of going silent until a seller notices bad numbers.',
+    still:
+      'A worker that exits without draining still looks healthy on the dashboard. The failure mode is silence, not a page. That is what I watch for.',
+    undo: 'I would put a queue-depth and last-success timestamp on the dashboard the same week. Shutdown handling without a visible lag is how the next silent failure hides.',
+    ask: [
+      'What did SIGTERM actually do before the patch?',
+      'How did you know it was 17 processes, not one flaky job?',
+      'What still pages you, and what still does not?',
+    ],
+    stack: ['Node.js', 'BullMQ', 'Redis', 'Railway'],
   },
   {
-    title: 'Real-money gaming platform',
+    id: 'reports',
+    title: 'Reports that used to take two hours',
     company: 'Mereb Technologies',
-    blurb: 'Loyalty, payouts, fraud, reporting, and the infrastructure underneath it.',
-  },
-  {
-    title: 'Government constituent platform',
-    company: 'Autobridge Systems',
-    blurb: 'Complaints, document approvals, access control, encryption, 10x faster email ingest.',
-  },
-  {
-    title: 'Upplai',
-    company: 'AI resume platform',
-    blurb: 'Resume generation and ATS feedback with OpenAI and Gemini, plus per-resume cost tracking.',
+    role: 'Senior Software Engineer',
+    kind: 'Performance · private production',
+    problem: 'Reporting on about a million records ran for two hours and blocked people who needed the numbers.',
+    trace: [
+      'Ad-hoc application paths doing aggregation the database should do',
+      'Missing indexes, no read replica, cache that did not cover the hot report',
+      'Status-checking that polled work already in flight',
+    ],
+    change:
+      'Indexing, read/write separation, caching, and a redesigned status-checking flow so the database did the aggregation.',
+    result:
+      'Same reports, under 30 minutes. Platform performance up about 30%. Infra cost down about 35% (~$100K/year, engineering estimate).',
+    still: 'I cannot show the queries here. They are in a private repo. I will walk through them on a call.',
+    undo: 'I would have split the hottest report into an async job on day one instead of waiting until it was a two-hour meeting blocker.',
+    ask: [
+      'Which index moved the needle, and how did you measure it?',
+      'What did you refuse to cache?',
+      'Where does the 30% / $100K estimate come from?',
+    ],
+    stack: ['PostgreSQL', 'PHP', 'Redis', 'AWS'],
   },
   {
+    id: 'nedaj',
     title: 'Nedaj payments',
-    company: 'Eaglelion',
-    blurb: 'Fuel-purchase payments for 100K+ downloads: Mastercard, Visa, Telebirr, bank APIs.',
+    company: 'Eaglelion Systems Technology',
+    role: 'Frontend Developer',
+    kind: 'Shipped product · client rails',
+    problem:
+      'A fuel-purchase app had to talk to Mastercard, Visa, Telebirr, and commercial banks, with incomplete provider docs and a SOAP past.',
+    trace: [
+      'I built the client payment workflows: states, callbacks, failures, retries, verification',
+      'Not the acquiring bank, not the ledger, not the 3B ETB as a personal metric — the products handled that volume',
+      'SOAP replaced with REST against docs that did not match production',
+    ],
+    change: 'Reliable payment states on a product with 100K+ downloads. Live on Google Play.',
+    result: 'Payment rails that hold up in production. GTmetrix 45 → 97 on the web surface.',
+    still: 'Provider callbacks still fail in ways the docs do not mention. Retries and verification are the job.',
+    undo: 'I would have treated provider docs as hostile from the first week and recorded every callback mismatch in one log, not in Slack.',
+    ask: [
+      'What did you own on the client, and what did you not own?',
+      'How did a failed Telebirr callback become a user-visible state?',
+      'Why is 3B ETB not your personal metric?',
+    ],
+    stack: ['React', 'Next.js', 'REST', 'Payment APIs'],
+    url: 'https://play.google.com/store/apps/details?id=com.eaglelionsystems.nedaj',
   },
 ];
 
+export const work = cases;
+
+export const mentorship = {
+  where: 'Mereb Technologies',
+  who: '3 junior engineers',
+  on: ['API development', 'debugging', 'code quality', 'system design'],
+  still: 'They can speak to the reviews. I will not invent a quote for them. Ask me who, and I will name the work.',
+};
+
 export const skills = [
-  { name: 'Languages', items: ['TypeScript', 'JavaScript', 'Go', 'Python', 'PHP', 'SQL'] },
-  { name: 'Backend', items: ['Node.js', 'Express', 'FastAPI', 'Prisma', 'gRPC', 'tRPC', 'REST', 'BullMQ'] },
-  { name: 'Data', items: ['PostgreSQL', 'MySQL', 'MongoDB', 'Redis'] },
-  { name: 'Frontend', items: ['React', 'Next.js', 'Tailwind CSS', 'Material UI'] },
-  { name: 'Cloud', items: ['AWS', 'Docker', 'Kubernetes', 'Nginx', 'GitHub Actions', 'Datadog'] },
-  { name: 'Integrations', items: ['Amazon SP-API', 'Mastercard', 'Visa', 'Telebirr', 'OAuth 2.0', 'OpenAI'] },
+  {
+    name: 'Dangerous at',
+    note: 'I will own this in production',
+    items: ['Node.js', 'PostgreSQL', 'TypeScript / JavaScript', 'Redis / BullMQ', 'React / Next.js', 'AWS'],
+  },
+  {
+    name: 'Used in production',
+    note: 'I have shipped it. I am not the expert in the room.',
+    items: ['PHP', 'gRPC', 'Prisma', 'tRPC', 'Docker', 'Datadog', 'SQL', 'Tailwind CSS'],
+  },
+  {
+    name: 'Not the job',
+    note: 'I will say so in the first screen',
+    items: ['Rust', 'native iOS / Android', 'Kubernetes as a daily driver'],
+  },
 ];
 
 export const quotes = [
-  { name: 'Dan Warner', role: 'AppLand Inc', text: 'Yonas did a great job! I would work with him again on a larger project.' },
-  { name: 'Muly Oved', role: '', text: 'Excellent freelancer, dedicated, hard worker, was joy to work with.' },
   {
     name: 'Mekidem Getaneh',
-    role: '',
-    text: 'He goes above and beyond for solving a problem and to find optimal solutions.',
+    role: 'Engineering colleague · ~1 year',
+    text: 'I have worked with Yonas for almost a year. He goes above and beyond for solving a problem and to find optimal solutions.',
+  },
+  {
+    name: 'Kalvin',
+    role: 'Client · data analytics frontend',
+    text: 'Exceptional expertise and creativity, with attention to detail, responsiveness to feedback, and proactive communication.',
   },
 ];
 

package/src/diff.js

@@ -0,0 +1,103 @@
+export const diffLines = (before, after) => {
+  const a = String(before).split('\n');
+  const b = String(after).split('\n');
+  const n = a.length;
+  const m = b.length;
+  const dp = Array.from({ length: n + 1 }, () => Array(m + 1).fill(0));
+
+  for (let i = n - 1; i >= 0; i -= 1) {
+    for (let j = m - 1; j >= 0; j -= 1) {
+      dp[i][j] = a[i] === b[j] ? dp[i + 1][j + 1] + 1 : Math.max(dp[i + 1][j], dp[i][j + 1]);
+    }
+  }
+
+  const ops = [];
+  let i = 0;
+  let j = 0;
+  while (i < n && j < m) {
+    if (a[i] === b[j]) {
+      ops.push({ type: 'eq', line: a[i] });
+      i += 1;
+      j += 1;
+    } else if (dp[i + 1][j] >= dp[i][j + 1]) {
+      ops.push({ type: 'del', line: a[i] });
+      i += 1;
+    } else {
+      ops.push({ type: 'add', line: b[j] });
+      j += 1;
+    }
+  }
+  while (i < n) {
+    ops.push({ type: 'del', line: a[i] });
+    i += 1;
+  }
+  while (j < m) {
+    ops.push({ type: 'add', line: b[j] });
+    j += 1;
+  }
+  return ops;
+};
+
+export const unifiedDiff = (before, after, path = 'posting.txt') => {
+  const ops = diffLines(before, after);
+  if (!ops.some((op) => op.type !== 'eq')) return '';
+
+  const lines = [`--- a/${path}`, `+++ b/${path}`];
+  let oldLine = 1;
+  let newLine = 1;
+  let idx = 0;
+
+  while (idx < ops.length) {
+    while (idx < ops.length && ops[idx].type === 'eq') {
+      oldLine += 1;
+      newLine += 1;
+      idx += 1;
+    }
+    if (idx >= ops.length) break;
+
+    let start = idx;
+    let cursor = idx;
+    let trailingEq = 0;
+    while (cursor < ops.length) {
+      if (ops[cursor].type === 'eq') {
+        trailingEq += 1;
+        if (trailingEq > 2) break;
+      } else {
+        trailingEq = 0;
+      }
+      cursor += 1;
+    }
+    if (trailingEq > 2) cursor -= trailingEq - 2;
+
+    const hunk = ops.slice(Math.max(0, start - 2), cursor);
+    const pre = Math.min(2, start);
+    const hunkOldStart = oldLine - pre;
+    const hunkNewStart = newLine - pre;
+    let oldCount = 0;
+    let newCount = 0;
+    const body = [];
+    for (const op of hunk) {
+      if (op.type === 'eq') {
+        body.push(` ${op.line}`);
+        oldCount += 1;
+        newCount += 1;
+      } else if (op.type === 'del') {
+        body.push(`-${op.line}`);
+        oldCount += 1;
+      } else {
+        body.push(`+${op.line}`);
+        newCount += 1;
+      }
+    }
+    lines.push(`@@ -${Math.max(hunkOldStart, 1)},${oldCount} +${Math.max(hunkNewStart, 1)},${newCount} @@`);
+    lines.push(...body);
+
+    for (const op of ops.slice(start, cursor)) {
+      if (op.type === 'eq' || op.type === 'del') oldLine += 1;
+      if (op.type === 'eq' || op.type === 'add') newLine += 1;
+    }
+    idx = cursor;
+  }
+
+  return lines.join('\n');
+};

package/src/fit.js

@@ -0,0 +1,41 @@
+export const FIT_SIGNALS = [
+  { id: 'node', label: 'Node.js', have: true, core: true, test: /node\.?js|\bjavascript\b|\btypescript\b|\bexpress\b/i },
+  { id: 'postgres', label: 'PostgreSQL', have: true, core: true, test: /\bpostgres(ql)?\b|\bprisma\b/i },
+  { id: 'aws', label: 'AWS', have: true, core: true, test: /\baws\b|amazon web services/i },
+  { id: 'react', label: 'React', have: true, core: true, test: /\breact\b|\bnext\.js\b/i },
+  { id: 'remote', label: 'Remote', have: true, core: false, test: /\bremote\b/i },
+  { id: 'senior', label: 'Senior', have: true, core: false, test: /\b(senior|staff|principal)\b/i },
+  { id: 'payments', label: 'Payments (client rails)', have: true, core: true, test: /\b(payment|fintech|mastercard|visa)\b/i },
+  { id: 'production', label: 'Production', have: true, core: true, test: /\b(production|on-call|incident|uptime)\b/i },
+  { id: 'redis', label: 'Redis / queues', have: true, core: true, test: /\b(redis|bullmq|queue)\b/i },
+  { id: 'docker', label: 'Docker', have: true, core: false, test: /\bdocker\b/i },
+  { id: 'php', label: 'PHP', have: true, core: false, test: /\bphp\b/i },
+  { id: 'go', label: 'Go', have: false, core: false, test: /\bgolang\b|\bgo developer\b|\bgo engineer\b/i },
+  { id: 'kubernetes', label: 'Kubernetes', have: false, core: false, test: /\bkubernetes\b|\bk8s\b/i },
+  { id: 'rust', label: 'Rust', have: false, core: false, test: /\brust\b/i },
+  { id: 'mobile', label: 'iOS/Android native', have: false, core: false, test: /\b(swift|kotlin|android native|ios native)\b/i },
+];
+
+export const fitAgainst = (text) => {
+  const hay = String(text || '');
+  const asked = FIT_SIGNALS.filter((signal) => signal.test.test(hay));
+  const matched = asked.filter((signal) => signal.have);
+  const missed = asked.filter((signal) => !signal.have);
+  const extra = FIT_SIGNALS.filter((signal) => signal.core && signal.have && !asked.includes(signal)).slice(0, 3);
+  const denom = matched.length + missed.length;
+  const score = denom === 0 ? null : Math.round((matched.length / denom) * 100);
+
+  return {
+    score,
+    matched: matched.map((signal) => signal.label),
+    missed: missed.map((signal) => signal.label),
+    extra: extra.map((signal) => signal.label),
+  };
+};
+
+export const tweetFromReport = (report) => {
+  if (report && typeof report.score === 'number') {
+    return `this posting scored ${report.score}/100\nnpx jobless lint`;
+  }
+  return 'npx jobless';
+};