jobless 1.3.0 → 1.4.0

package/README.md

@@ -35,18 +35,29 @@ pbpaste | npx jobless lint
 Or run `npx jobless` and press `l`.
 
 ```
-error  salary described as competitive, with no number
+error  salary described as competitive / attractive / market-rate, with no number
        no-fake-salary
 error  too many interview rounds
        max-rounds
-warn   "fast-paced" / "wear many hats"
+warn   "fast-paced" / "wear many hats" / "do more with less"
        means-understaffed
 
-REJECTED   2 errors  1 warning
-reason     failed the human compiler
+FROM     you <you@laptop>
+TO       Hiring <no-reply@not-a-human.com>
+SUBJECT  Your opening for this role
+
+Thank you for your interest in my labor. After careful consideration of your job description, I will not be moving forward.
+
+RESULT    REJECTED
+reason    salary described as competitive / attractive / market-rate, with no number
+also      too many interview rounds
+next      we will keep your posting on file. we will not.
+
+that was not a recruiter.
+that was you, finally answering.
 ```
 
-Same idea as ESLint. The file is a job description. The company has to pass.
+Same idea as ESLint. The file is a job description. Errors fail the process (`exit 1`). Warnings hold it for review. `npx jobless lint --json` prints the findings and the letter.
 
 ## Hire
 
@@ -60,7 +71,8 @@ Same idea as ESLint. The file is a job description. The company has to pass.
 
 ```bash
 npx jobless                 # reject you, then the resume
-npx jobless lint file.txt   # lint a job post
+npx jobless lint file.txt   # lint a job post (exit 1 on errors)
+npx jobless lint --json     # findings + rejection letter
 npx jobless work            # proof
 npx jobless hire            # email + links
 npx jobless rant            # the market

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jobless",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "npx jobless — first it rejects you. then it lints the job post. then you meet the engineer.",
   "keywords": [
     "cli",

package/src/cli.js

@@ -5,7 +5,7 @@ import { fileURLToPath } from 'node:url';
 import { stdin } from 'node:process';
 
 import { menu } from './data.js';
-import { lintJobPost } from './lint.js';
+import { lintResult } from './lint.js';
 import { printTrap } from './reject.js';
 import {
   blank,
@@ -129,7 +129,7 @@ const interactive = async ({ trap }) => {
         const text = await readPaste(rl);
         if (process.stdout.isTTY) clear();
         printHeader();
-        printLintReport(lintJobPost(text), 'paste');
+        printLintReport(lintResult(text, 'paste'));
         printMenu();
         continue;
       }
@@ -162,7 +162,7 @@ const parse = (argv) => {
   return { flags, rest };
 };
 
-const runLintCli = async (files) => {
+const runLintCli = async (files, { json = false } = {}) => {
   let source = 'stdin';
   let text = '';
 
@@ -179,7 +179,15 @@ const runLintCli = async (files) => {
     return;
   }
 
-  printLintReport(lintJobPost(text), source);
+  const report = lintResult(text, source);
+  if (!report.ok) process.exitCode = 1;
+
+  if (json) {
+    print(JSON.stringify(report, null, 2));
+    return;
+  }
+
+  printLintReport(report);
   blank();
   print(dim('  more: npx jobless   ·   npx jobless hire'));
 };
@@ -202,13 +210,13 @@ export const run = async (argv = []) => {
     return;
   }
 
-  if (flags.has('--json')) {
-    print(toJson());
+  if (verb === 'lint' || verb === 'l') {
+    await runLintCli(rest.slice(1), { json: flags.has('--json') });
     return;
   }
 
-  if (verb === 'lint' || verb === 'l') {
-    await runLintCli(rest.slice(1));
+  if (flags.has('--json')) {
+    print(toJson());
     return;
   }
 

package/src/lint.js

@@ -1,3 +1,5 @@
+import { detectIdentity } from './identity.js';
+
 const hasMoney = (text) =>
   /\$|€|£|\bUSD\b|\bEUR\b|\bGBP\b|\b\d{2,3}\s?k\b|\b\d{1,3}(,\d{3})+\b/i.test(text);
 
@@ -101,3 +103,45 @@ export const summarizeLint = (findings) => {
   const warnings = findings.filter((item) => item.level === 'warn').length;
   return { errors, warnings };
 };
+
+export const postingMeta = (text) => {
+  const roleMatch = String(text || '').match(
+    /\b(?:senior|staff|principal|lead|junior|entry[- ]level)?[ \t]*(?:full[- ]stack|frontend|backend|software|platform)?[ \t]*(?:engineer|developer|designer)\b/i,
+  );
+  const atMatch = String(text || '').match(
+    /\b(?:at|@|join)[ \t]+([A-Z][A-Za-z0-9&.'\-]{1,32}(?:[ \t]+[A-Z][A-Za-z0-9&.'\-]{1,20}){0,2})/,
+  );
+  return {
+    role: roleMatch ? roleMatch[0].replace(/\s+/g, ' ').trim() : 'this role',
+    company: atMatch ? atMatch[1].trim() : 'Hiring',
+  };
+};
+
+export const lintResult = (raw, source = 'stdin') => {
+  const { text, findings } = lintJobPost(raw);
+  const { errors, warnings } = summarizeLint(findings);
+  const identity = detectIdentity();
+  const meta = postingMeta(text);
+  const errorReasons = findings.filter((item) => item.level === 'error').map((item) => item.message);
+  const warnReasons = findings.filter((item) => item.level === 'warn').map((item) => item.message);
+  const reasons = (errorReasons.length ? errorReasons : warnReasons).slice(0, 2);
+
+  return {
+    source,
+    ok: errors === 0,
+    errors,
+    warnings,
+    findings,
+    meta,
+    letter:
+      findings.length === 0
+        ? null
+        : {
+            from: `${identity.name} <${identity.email}>`,
+            to: `${meta.company} <no-reply@not-a-human.com>`,
+            subject: `Your opening for ${meta.role}`,
+            result: errors > 0 ? 'REJECTED' : 'HELD FOR REVIEW',
+            reasons,
+          },
+  };
+};

package/src/reject.js

@@ -11,6 +11,7 @@ import {
   showCursor,
   sleep,
   wrap,
+  yellow,
 } from './style.js';
 
 const BOOT = [
@@ -99,3 +100,33 @@ export const printTrap = async ({ animate = true } = {}) => {
   blank();
   print(`  ${dim('anyway. here is an engineer who debugs silent production failures.')}`);
 };
+
+export const printCompanyReject = (letter) => {
+  if (!letter) return;
+
+  blank();
+  print(
+    box([
+      dim(`FROM     ${letter.from}`),
+      dim(`TO       ${letter.to}`),
+      dim(`SUBJECT  ${letter.subject}`),
+      '',
+      ...wrap(
+        letter.result === 'REJECTED'
+          ? 'Thank you for your interest in my labor. After careful consideration of your job description, I will not be moving forward.'
+          : 'Thank you for your interest in my labor. Your posting has been held for review. Fix the warnings and resubmit.',
+        inner(),
+      ),
+      '',
+      `${bold(red('RESULT'))}    ${bold(letter.result === 'REJECTED' ? red(letter.result) : yellow(letter.result))}`,
+      `${dim('reason')}    ${letter.reasons[0] || 'failed the human compiler'}`,
+      ...(letter.reasons[1] ? [`${dim('also')}      ${letter.reasons[1]}`] : []),
+      `${dim('elapsed')}   0.40s`,
+      `${dim('next')}      we will keep your posting on file. we will not.`,
+    ]),
+  );
+
+  blank();
+  print(`  ${dim('that was not a recruiter.')}`);
+  print(`  ${dim('that was you, finally answering.')}`);
+};

package/src/screens.js

@@ -1,5 +1,7 @@
 import { execFileSync } from 'node:child_process';
 
+import { printCompanyReject } from './reject.js';
+
 import {
   about,
   experience,
@@ -136,10 +138,8 @@ export const printRant = () => {
   print(`  ${dim('If you want the work, press')} ${bold('1')}${dim('. If you want to hire, press')} ${bold(green('h'))}${dim('.')}`);
 };
 
-export const printLintReport = (result, source = 'stdin') => {
-  const { findings } = result;
-  const errors = findings.filter((item) => item.level === 'error');
-  const warnings = findings.filter((item) => item.level === 'warn');
+export const printLintReport = (report) => {
+  const { findings, source, errors, warnings, letter, ok } = report;
 
   blank();
   section('JOBLESS LINT');
@@ -147,11 +147,11 @@ export const printLintReport = (result, source = 'stdin') => {
   print(`  ${dim(source)}`);
   blank();
 
-  if (!findings.length) {
+  if (ok && !findings.length) {
     print(`  ${green('clean')}  this posting might be a real job.`);
     blank();
     print(`  ${dim('If you still want the engineer who wrote the linter:')} ${bold(green('h'))}`);
-    return { errors: 0, warnings: 0 };
+    return report;
   }
 
   for (const finding of findings) {
@@ -161,11 +161,12 @@ export const printLintReport = (result, source = 'stdin') => {
     blank();
   }
 
-  const fail = errors.length > 0;
-  print(`  ${fail ? bold(red('REJECTED')) : yellow('WARNING')}   ${errors.length} error${errors.length === 1 ? '' : 's'}  ${warnings.length} warning${warnings.length === 1 ? '' : 's'}`);
-  print(`  ${dim('reason')}     failed the human compiler`);
-  print(`  ${dim('next')}       send this report back. or hire the person who wrote it.`);
-  return { errors: errors.length, warnings: warnings.length };
+  printCompanyReject(letter);
+  blank();
+  print(
+    `  ${errors} error${errors === 1 ? '' : 's'}  ${warnings} warning${warnings === 1 ? '' : 's'}  ${dim('·')}  ${dim('hire the person who wrote the compiler:')} ${bold(green('h'))}`,
+  );
+  return report;
 };
 
 export const printWork = () => {
@@ -246,6 +247,7 @@ export const printHelp = () => {
   blank();
   print(`  ${bold('npx jobless')}              reject you, then the resume`);
   print(`  ${bold('npx jobless lint [file]')}  lint a job posting`);
+  print(`  ${bold('npx jobless lint --json')}  findings + rejection letter`);
   print(`  ${bold('npx jobless work')}         proof of work`);
   print(`  ${bold('npx jobless hire')}         email + links`);
   print(`  ${bold('npx jobless who')}          bio`);
@@ -253,7 +255,7 @@ export const printHelp = () => {
   print(`  ${bold('npx jobless skills')}       stack`);
   print(`  ${bold('npx jobless rant')}         the market`);
   print(`  ${bold('npx jobless --resume')}     skip the rejection`);
-  print(`  ${bold('npx jobless --json')}       machine readable`);
+  print(`  ${bold('npx jobless --json')}       machine readable resume`);
   blank();
   print(`  ${dim('In the prompt:')} ${bold(green('h'))} ${dim('hires,')} ${bold('l')} ${dim('lints a posting,')} ${bold('q')} ${dim('quits.')}`);
   print(`  ${dim(profile.website)}`);