jobless 1.3.0 → 1.5.0

package/README.md

@@ -1,5 +1,8 @@
 # jobless
 
+[![jobless](https://img.shields.io/badge/npx-jobless-b91c1c)](https://www.npmjs.com/package/jobless)
+[![npm](https://img.shields.io/npm/dw/jobless?label=npm%20downloads)](https://www.npmjs.com/package/jobless)
+
 ```bash
 npx jobless
 ```
@@ -10,61 +13,82 @@ First it rejects **you**. Then it introduces an engineer.
 
 ## The trap
 
-You run the command. It pretends to be Greenhouse. It reads a couple of harmless local hints (git name, email, laptop user). It writes a rejection letter addressed to you.
-
-Then it breaks character:
-
-```
-that was not a company.
-that was the market, in your own terminal.
-
-anyway. here is an engineer who debugs silent production failures.
-```
+You run the command. It pretends to be Greenhouse, Lever, Ashby, or Workday. It reads a couple of harmless local hints (git name, email, laptop user). It writes a rejection letter addressed to you, with a fake ATS score and a pile of applicants.
 
-Then: 17 cron jobs that died after every deploy. $100K off infra. 3B+ ETB in payment rails. Press `h` to hire.
+Then it breaks character and offers `l` — paste the posting that just rejected you — or `h` to hire.
 
-Skip the theater with `npx jobless --resume`.
+Skip the theater with `npx jobless --resume`. Record it with `--seed=42` and `--no-color`.
 
 ## Lint the posting, not the human
 
 ```bash
 npx jobless lint posting.txt
+npx jobless lint jobs/
 pbpaste | npx jobless lint
+npx jobless lint --fix posting.txt
+npx jobless lint --format=github jobs/
+npx jobless lint --tweet posting.txt
+npx jobless lint --rules
 ```
 
-Or run `npx jobless` and press `l`.
+Or run `npx jobless` and press `l`. `c` copies the last rejection letter.
 
 ```
-error  salary described as competitive, with no number
-       no-fake-salary
 error  too many interview rounds
        max-rounds
-warn   "fast-paced" / "wear many hats"
-       means-understaffed
+       L3  Six interview rounds.
+
+RESULT    REJECTED
+28/100
+FIT  overlap  Senior  ·  Remote
+```
+
+Errors fail the process (`exit 1`). `--fix` prints a unified diff and does not write files unless you pass `--write`. `--format=github` emits `::error` annotations. `jobless-disable-next-line no-fake-salary` skips a line.
+
+### GitHub Action
 
-REJECTED   2 errors  1 warning
-reason     failed the human compiler
+Copy [`examples/github-action.yml`](examples/github-action.yml):
+
+```yaml
+- run: npx --yes jobless lint --format=github jobs/
 ```
 
-Same idea as ESLint. The file is a job description. The company has to pass.
+### GitHub profile README
+
+```markdown
+[![npx jobless](https://img.shields.io/badge/npx-jobless-b91c1c)](https://www.npmjs.com/package/jobless)
+```
+
+```bash
+npx jobless
+```
 
 ## Hire
 
+The numbers have owners. Infra and performance: Mereb. Payment volume: client rails at Eaglelion, not the ledger. `npx jobless work` is three case studies. `npx jobless proof` is the 17-cron write-up. Production code is private; the walkthrough is the interview.
+
 - Email: [yonalem21@gmail.com](mailto:yonalem21@gmail.com?subject=npx%20jobless%20%E2%80%94%20Yonas%20Alem)
 - Site: [yonasalem.vercel.app](https://yonasalem.vercel.app)
 - GitHub: [github.com/Yonas21](https://github.com/Yonas21)
 - LinkedIn: [linkedin.com/in/yonasalem21](https://www.linkedin.com/in/yonasalem21/)
 - Source: [github.com/Yonas21/jobless](https://github.com/Yonas21/jobless)
 
+`npx jobless card` is the one-screen version. `npx jobless proof` is the 17-cron write-up. `npx jobless vcf` is a vCard. `npx jobless why` is twelve lines. `npx jobless hire --to=manager` or `--to=recruiter`. `npx jobless tweet` is 280 characters with no punchline.
+
 ## Commands
 
 ```bash
 npx jobless                 # reject you, then the resume
-npx jobless lint file.txt   # lint a job post
-npx jobless work            # proof
+npx jobless lint file.txt   # lint a job post (exit 1 on errors)
+npx jobless lint jobs/      # lint a directory of postings
+npx jobless lint --fix      # unified diff (dry-run)
+npx jobless lint --json     # findings + rejection letter
+npx jobless work            # three case studies
 npx jobless hire            # email + links
 npx jobless rant            # the market
 npx jobless --resume        # skip the rejection
 ```
 
+Post the command, not the punchline: `npx jobless`
+
 Zero dependencies. Node 18+. Local only. It does not apply to jobs or send email.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jobless",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "npx jobless — first it rejects you. then it lints the job post. then you meet the engineer.",
   "keywords": [
     "cli",
@@ -47,6 +47,7 @@
     "work": "node bin/jobless.js work",
     "rant": "node bin/jobless.js rant",
     "hire": "node bin/jobless.js hire",
-    "lint": "node bin/jobless.js lint"
+    "lint": "node bin/jobless.js lint",
+    "test": "node test/lint.test.js"
   }
 }

package/src/cli.js

@@ -1,20 +1,25 @@
 import { createInterface } from 'node:readline';
-import { readFileSync } from 'node:fs';
+import { readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { stdin } from 'node:process';
 
 import { menu } from './data.js';
-import { lintJobPost } from './lint.js';
-import { printTrap } from './reject.js';
+import { unifiedDiff } from './diff.js';
+import { fixJobPost, githubAnnotations, lintResult } from './lint.js';
+import { letterText, printTrap } from './reject.js';
 import {
   blank,
   clear,
   dim,
+  green,
   print,
   showCursor,
 } from './style.js';
 import {
+  copyLetter,
+  printCard,
+  printFix,
   printHeader,
   printHelp,
   printHire,
@@ -22,10 +27,15 @@ import {
   printLintReport,
   printLooking,
   printMenu,
+  printProof,
   printRant,
+  printRules,
   printSignature,
   printSkills,
+  printTweet,
+  printVcf,
   printWho,
+  printWhy,
   printWork,
   toJson,
 } from './screens.js';
@@ -34,6 +44,9 @@ const pkg = JSON.parse(
   readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf8'),
 );
 
+let lastReport = null;
+let lastTo = '';
+
 const COMMANDS = {
   who: printWho,
   about: printWho,
@@ -42,15 +55,21 @@ const COMMANDS = {
   rant: printRant,
   market: printRant,
   work: printWork,
-  proof: printWork,
+  proof: printProof,
   experience: printWork,
   skills: printSkills,
-  hire: printHire,
-  h: printHire,
-  links: printHire,
-  contact: printHire,
+  hire: () => printHire({ report: lastReport, to: lastTo }),
+  h: () => printHire({ report: lastReport, to: lastTo }),
+  links: () => printHire({ report: lastReport, to: lastTo }),
+  contact: () => printHire({ report: lastReport, to: lastTo }),
+  card: printCard,
+  tweet: () => printTweet(lastReport),
+  why: printWhy,
+  vcf: printVcf,
 };
 
+const VALUE_FLAGS = new Set(['--max-warnings', '--seed', '--off', '--format', '--to']);
+
 const ask = (rl, prompt) =>
   new Promise((resolve) => {
     rl.question(prompt, resolve);
@@ -81,6 +100,12 @@ const resolveCommand = (input) => {
   if (value === 'q' || value === 'quit' || value === 'exit') return 'quit';
   if (value === 'help') return 'help';
   if (value === 'lint' || value === 'l') return 'lint';
+  if (value === 'c' || value === 'copy') return 'copy';
+  if (value === 'tweet') return 'tweet';
+  if (value === 'card') return 'card';
+  if (value === 'proof') return 'proof';
+  if (value === 'why') return 'why';
+  if (value === 'vcf' || value === 'vcard') return 'vcf';
   const fromMenu = menu.find((item) => item.key === value || item.command === value);
   if (fromMenu) return fromMenu.command;
   if (COMMANDS[value]) return value;
@@ -101,10 +126,173 @@ const showResume = () => {
   printMenu();
 };
 
-const interactive = async ({ trap }) => {
+const parse = (argv) => {
+  const flags = new Set();
+  const opts = {};
+  const rest = [];
+
+  const setOpt = (key, value) => {
+    opts[key] = opts[key] ? `${opts[key]},${value}` : value;
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--') {
+      rest.push(...argv.slice(i + 1));
+      break;
+    }
+    if (arg.startsWith('--') && arg.includes('=')) {
+      const eq = arg.indexOf('=');
+      const key = arg.slice(2, eq);
+      flags.add(`--${key}`);
+      setOpt(key, arg.slice(eq + 1));
+      continue;
+    }
+    if (VALUE_FLAGS.has(arg)) {
+      flags.add(arg);
+      const next = argv[i + 1];
+      if (next && !next.startsWith('-')) {
+        setOpt(arg.slice(2), next);
+        i += 1;
+      } else if (arg === '--max-warnings') {
+        setOpt('max-warnings', '0');
+      }
+      continue;
+    }
+    if (arg.startsWith('-')) {
+      flags.add(arg);
+      continue;
+    }
+    rest.push(arg);
+  }
+
+  return { flags, opts, rest };
+};
+
+const applyColorFlags = (flags, opts) => {
+  if (flags.has('--no-color') || opts.color === 'never') process.env.NO_COLOR = '1';
+};
+
+const POSTING_RE = /\.(md|txt|markdown)$/i;
+
+const walkPostings = (dir, acc = []) => {
+  for (const name of readdirSync(dir).sort()) {
+    if (name.startsWith('.')) continue;
+    const path = join(dir, name);
+    let st;
+    try {
+      st = statSync(path);
+    } catch {
+      continue;
+    }
+    if (st.isDirectory()) walkPostings(path, acc);
+    else if (POSTING_RE.test(name)) acc.push(path);
+  }
+  return acc;
+};
+
+const collectPostings = (paths) => {
+  const files = [];
+  for (const path of paths) {
+    const st = statSync(path);
+    if (st.isDirectory()) walkPostings(path, files);
+    else files.push(path);
+  }
+  return files;
+};
+
+const resolveFormat = (flags, opts) => {
+  if (opts.format) return opts.format;
+  if (flags.has('--json')) return 'json';
+  return 'pretty';
+};
+
+const lintOne = (text, source, { off, fix, write }) => {
+  const report = lintResult(text, source, { off });
+  if (fix || write) {
+    const fixed = fixJobPost(text, { off });
+    report.fix = {
+      applied: fixed.applied,
+      text: fixed.text,
+      path: source,
+      before: text,
+      diff: unifiedDiff(text, fixed.text, source === 'stdin' || source === 'paste' ? 'posting.txt' : source),
+    };
+    if (write && source !== 'stdin' && source !== 'paste' && fixed.applied.length) {
+      writeFileSync(source, fixed.text);
+      report.fix.wrote = true;
+    }
+  }
+  return report;
+};
+
+const runLintCli = async (files, options) => {
+  const { format = 'pretty', fix = false, write = false, copy = false, quiet = false, off = [], maxWarnings, tweet = false } = options;
+
+  const inputs = [];
+  if (files[0]) {
+    const paths = collectPostings(files);
+    if (!paths.length) {
+      print(dim(`  no .md/.txt postings under ${files.join(', ')}`));
+      process.exitCode = 1;
+      return;
+    }
+    for (const path of paths) {
+      inputs.push({ source: path, text: readFileSync(path, 'utf8') });
+    }
+  } else if (!stdin.isTTY) {
+    inputs.push({ source: 'stdin', text: await readStdin() });
+  } else {
+    printHelp();
+    blank();
+    print(dim('  lint needs a file, a directory, a pipe, or an interactive paste: npx jobless lint jobs/'));
+    process.exitCode = 1;
+    return;
+  }
+
+  const reports = inputs.map((input) => lintOne(input.text, input.source, { off, fix: fix || write, write }));
+  lastReport = reports.at(-1);
+
+  let failed = false;
+  for (const report of reports) {
+    if (!report.ok) failed = true;
+    if (maxWarnings != null && report.warnings > maxWarnings) failed = true;
+  }
+  if (failed) process.exitCode = 1;
+
+  if (format === 'json') {
+    print(JSON.stringify(reports.length === 1 ? reports[0] : { reports }, null, 2));
+    if (copy && lastReport?.letter) copyLetter(lastReport.letter);
+    return;
+  }
+
+  if (format === 'github') {
+    const body = reports.map((report) => githubAnnotations(report)).filter(Boolean).join('\n');
+    if (body) print(body);
+    return;
+  }
+
+  for (const [index, report] of reports.entries()) {
+    if (index) blank();
+    const copied = copy && report.letter ? copyLetter(report.letter) : false;
+    printLintReport(report, { quiet, copied });
+    if (report.fix?.applied.length) printFix(report.fix);
+    if (report.fix?.wrote) print(`  ${green('wrote')} ${report.source}`);
+  }
+
+  if (tweet) {
+    blank();
+    printTweet(lastReport);
+  }
+
+  blank();
+  print(dim('  more: npx jobless   ·   npx jobless hire'));
+};
+
+const interactive = async ({ trap, seed }) => {
   if (process.stdout.isTTY) clear();
   if (trap) {
-    await printTrap({ animate: true });
+    await printTrap({ animate: true, seed });
     blank();
   }
   showResume();
@@ -116,7 +304,7 @@ const interactive = async ({ trap }) => {
       const command = resolveCommand(answer);
 
       if (!command) {
-        print(`  ${dim('unknown. try 1–5, l to lint, h to hire, or q.')}`);
+        print(`  ${dim('unknown. try 1–5, l to lint, c to copy, h to hire, or q.')}`);
         continue;
       }
       if (command === 'help') {
@@ -125,11 +313,21 @@ const interactive = async ({ trap }) => {
         printMenu();
         continue;
       }
+      if (command === 'copy') {
+        if (!lastReport?.letter) {
+          print(`  ${dim('nothing to copy. lint a posting first (l).')}`);
+          continue;
+        }
+        if (copyLetter(lastReport.letter)) print(`  ${green('copied')} rejection letter`);
+        else print(letterText(lastReport.letter));
+        continue;
+      }
       if (command === 'lint') {
         const text = await readPaste(rl);
         if (process.stdout.isTTY) clear();
         printHeader();
-        printLintReport(lintJobPost(text), 'paste');
+        lastReport = lintResult(text, 'paste');
+        printLintReport(lastReport);
         printMenu();
         continue;
       }
@@ -152,44 +350,14 @@ const interactive = async ({ trap }) => {
   }
 };
 
-const parse = (argv) => {
-  const flags = new Set();
-  const rest = [];
-  for (const arg of argv) {
-    if (arg.startsWith('-')) flags.add(arg);
-    else rest.push(arg);
-  }
-  return { flags, rest };
-};
-
-const runLintCli = async (files) => {
-  let source = 'stdin';
-  let text = '';
-
-  if (files[0]) {
-    source = files[0];
-    text = readFileSync(files[0], 'utf8');
-  } else if (!stdin.isTTY) {
-    text = await readStdin();
-  } else {
-    printHelp();
-    blank();
-    print(dim('  lint needs a file, a pipe, or an interactive paste: npx jobless lint posting.txt'));
-    process.exitCode = 1;
-    return;
-  }
-
-  printLintReport(lintJobPost(text), source);
-  blank();
-  print(dim('  more: npx jobless   ·   npx jobless hire'));
-};
-
 export const run = async (argv = []) => {
   process.stdout.on('error', (error) => {
     if (error.code === 'EPIPE') process.exit(0);
   });
 
-  const { flags, rest } = parse(argv);
+  const { flags, opts, rest } = parse(argv);
+  applyColorFlags(flags, opts);
+
   const verb = rest[0] ? rest[0].toLowerCase() : '';
 
   if (flags.has('-h') || flags.has('--help') || verb === 'help') {
@@ -202,20 +370,66 @@ export const run = async (argv = []) => {
     return;
   }
 
-  if (flags.has('--json')) {
-    print(toJson());
+  if (verb === 'rules' || flags.has('--rules')) {
+    printRules();
     return;
   }
 
   if (verb === 'lint' || verb === 'l') {
-    await runLintCli(rest.slice(1));
+    const maxRaw = opts['max-warnings'];
+    const maxWarnings = maxRaw == null || maxRaw === '' ? null : Number(maxRaw);
+    await runLintCli(rest.slice(1), {
+      format: resolveFormat(flags, opts),
+      fix: flags.has('--fix') || flags.has('--diff') || flags.has('--write'),
+      write: flags.has('--write'),
+      copy: flags.has('--copy'),
+      quiet: flags.has('--quiet'),
+      tweet: flags.has('--tweet'),
+      off: String(opts.off || '')
+        .split(',')
+        .map((id) => id.trim())
+        .filter(Boolean),
+      maxWarnings: Number.isFinite(maxWarnings) ? maxWarnings : null,
+    });
+    return;
+  }
+
+  if (verb === 'tweet') {
+    printTweet(lastReport);
+    return;
+  }
+
+  if (verb === 'why') {
+    printHeader();
+    printWhy();
+    return;
+  }
+
+  if (verb === 'vcf' || verb === 'vcard') {
+    printHeader();
+    printVcf();
+    return;
+  }
+
+  lastTo = opts.to || '';
+  if ((verb === 'hire' || verb === 'h') && lastTo) {
+    printHeader();
+    printHire({ report: lastReport, to: lastTo, copy: process.stdout.isTTY });
+    blank();
+    print(dim('  more: npx jobless   ·   npx jobless --help'));
+    return;
+  }
+
+  if (flags.has('--json')) {
+    print(toJson());
     return;
   }
 
   const skipTrap = flags.has('--resume') || flags.has('--skip-trap') || flags.has('--no-trap');
+  const seed = opts.seed;
   const command = verb ? resolveCommand(verb) : null;
 
-  if (command && command !== 'quit' && command !== 'help' && command !== 'lint') {
+  if (command && command !== 'quit' && command !== 'help' && command !== 'lint' && command !== 'copy') {
     printHeader();
     runCommand(command);
     blank();
@@ -224,11 +438,11 @@ export const run = async (argv = []) => {
   }
 
   if (!process.stdout.isTTY) {
-    if (!skipTrap) await printTrap({ animate: false });
+    if (!skipTrap) await printTrap({ animate: false, seed });
     blank();
     printHeader();
     printSignature();
-    printHire({ copy: false });
+    printHire({ copy: false, report: lastReport });
     return;
   }
 
@@ -238,5 +452,5 @@ export const run = async (argv = []) => {
     process.exit(0);
   });
 
-  await interactive({ trap: !skipTrap });
+  await interactive({ trap: !skipTrap, seed });
 };

package/src/clip.js

@@ -0,0 +1,18 @@
+import { execFileSync } from 'node:child_process';
+
+export const copyToClipboard = (text) => {
+  try {
+    if (process.platform === 'darwin') {
+      execFileSync('pbcopy', { input: text });
+      return true;
+    }
+    if (process.platform === 'win32') {
+      execFileSync('clip', { input: text, windowsHide: true });
+      return true;
+    }
+    execFileSync('xclip', ['-selection', 'clipboard'], { input: text });
+    return true;
+  } catch {
+    return false;
+  }
+};