jobless 1.4.0 → 1.6.0

package/README.md

@@ -1,82 +1,148 @@
 # jobless
 
+[![npm](https://img.shields.io/npm/v/jobless)](https://www.npmjs.com/package/jobless)
+[![npm downloads](https://img.shields.io/npm/dw/jobless)](https://www.npmjs.com/package/jobless)
+
+I got invited to interview and rejected at the same time.
+So I turned the hiring process into an npm package.
+
+They asked how I handle rejection. Apparently: semantic versioning.
+
 ```bash
 npx jobless
 ```
 
-First it rejects **you**. Then it introduces an engineer.
+```text
+✔ Congratulations! We'd love to interview you.
+✔ Unfortunately, we're moving forward with others.
 
-`jobless` is a reverse ATS. The market has been parsing humans in 400ms. This package parses you, then parses the job post, then shows [Yonas Alem](https://yonasalem.vercel.app) — senior software engineer, remote, production systems.
+ERR_HIRING_RACE_CONDITION
+Application status: yesn't
 
-## The trap
+Interview scheduled successfully.
+Candidate rejected successfully.
+All systems operational.
 
-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.
+I couldn't fix their hiring pipeline. So I shipped my own.
+```
 
-Then it breaks character:
+A hiring simulator, a reverse ATS, and an actual engineer behind the joke.
+The simulator is satire. The contradictory interview is the origin story.
 
-```
-that was not a company.
-that was the market, in your own terminal.
+## Try it. Break it. Send it to a friend.
+
+In the interactive prompt:
 
-anyway. here is an engineer who debugs silent production failures.
+- `r` — try again. Same pipeline, different disappointment.
+- `d` — reject a fictional job posting. No file needed.
+- `l` — paste a real posting; finish with an empty line.
+- `c` — copy the latest result, including the opening joke.
+- `h` — meet the engineer.
+- `q` — leave the hiring pipeline. Finally, a working exit.
+
+```bash
+npx jobless share           # a compact, anonymous result
+npx jobless share --copy    # explicitly copy it
+npx jobless tweet           # the origin story, ready to post
+npx jobless --seed=1        # another hiring incident
+npx jobless --record        # anonymous, no animation or prompt
+npx jobless --record --seed=42 --no-color
 ```
 
-Then: 17 cron jobs that died after every deploy. $100K off infra. 3B+ ETB in payment rails. Press `h` to hire.
+There are three hand-written scenarios. Seeds select a repeatable scenario;
+`r` cycles through them. No AI API, account, or subscription needed.
+
+## Reject the posting for a change
 
-Skip the theater with `npx jobless --resume`.
+```bash
+npx jobless lint --demo
+```
 
-## Lint the posting, not the human
+Meet DemoCorp: competitive salary, six interview rounds, an unpaid take-home,
+and a remote role that requires office attendance. Let it hear back from you.
 
 ```bash
 npx jobless lint posting.txt
+npx jobless lint jobs/
 pbpaste | npx jobless lint
+npx jobless lint --tweet posting.txt
+npx jobless lint --copy posting.txt
+npx jobless lint --json posting.txt
+npx jobless lint --rules
+```
+
+The score is rule-based satire, **not an objective employer rating**. It flags
+phrases; it cannot judge the full context of a role or hiring process.
+
+Errors exit with status `1`, including the intentionally bad demo. Warnings
+alone exit with `0`, unless you set `--max-warnings=0`.
+
+```bash
+npx jobless lint --fix posting.txt    # proposed unified diff only
+npx jobless lint --write posting.txt  # explicitly overwrite the file
 ```
 
-Or run `npx jobless` and press `l`.
+Review suggested rewrites: they include placeholder terms, not facts about the role.
+`--demo` cannot be combined with file paths or `--write`.
+Use `--off=rule-id` or `jobless-disable-next-line rule-id` to skip a rule.
+
+For job postings in your own repository, see
+[the example GitHub Action](examples/github-action.yml):
 
+```yaml
+- run: npx --yes jobless lint --format=github jobs/
 ```
-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" / "do more with less"
-       means-understaffed
-
-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.
+
+## There is an engineer behind this
+
+I'm [Yonas Alem](https://yonasalem.vercel.app), a senior software engineer in
+Addis Ababa, open to remote roles. I debug silent production failures.
+This one was loud enough to become a package.
+
+```bash
+npx jobless hire            # contact details; no automatic clipboard writes
+npx jobless hire --copy     # explicitly copy my email
+npx jobless work            # three case studies and experience
+npx jobless proof           # the deploy that killed 17 cron jobs
+npx jobless card            # compact contact card
+npx jobless why             # the origin story
+npx jobless rant            # five short coping mechanisms
+npx jobless --resume        # go straight to the engineer
+npx jobless --json          # machine-readable profile
+npx jobless --help          # all commands
 ```
 
-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.
+Infra and performance claims belong to my work at Mereb. Payment volume
+belongs to the products I integrated at Eaglelion, not a ledger I built.
+Production code is private; the case studies explain the work and its limits.
+
+- [Email](mailto:yonalem21@gmail.com)
+- [Portfolio](https://yonasalem.vercel.app)
+- [GitHub](https://github.com/Yonas21)
+- [LinkedIn](https://www.linkedin.com/in/yonasalem21/)
+
+## Local, with boundaries
+
+Zero runtime dependencies. Node 18+. The CLI does not apply to jobs, send email,
+scrape websites, or send telemetry. Fetching it through `npx` uses npm's network.
 
-## Hire
+The default simulator and linter use an anonymous candidate identity. They do
+not read your Git identity, username, or working directory for personalization.
+`--personalize` opts into local identity lookup for the simulator's greeting;
+it can read Git name/email and OS account details, but only shows your name.
+`--record`, `share`, and copied simulator results always omit that local identity.
+A pasted posting can still contain personal or company information: inspect
+lint output before sharing it.
 
-- 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)
+Clipboard writes happen only when requested with `c`, `copy`, or `--copy`.
+They use `pbcopy` on macOS, `clip` on Windows, or `xclip` on Linux. If copying is
+unavailable, share commands leave the text visible for manual copying.
 
-## Commands
+## Development
 
 ```bash
-npx jobless                 # reject you, then the resume
-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
-npx jobless --resume        # skip the rejection
+npm test
+node bin/jobless.js
 ```
 
-Zero dependencies. Node 18+. Local only. It does not apply to jobs or send email.
+Zero dependencies. Still dependent on someone replying.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jobless",
-  "version": "1.4.0",
-  "description": "npx jobless — first it rejects you. then it lints the job post. then you meet the engineer.",
+  "version": "1.6.0",
+  "description": "Invited to interview and rejected at the same time. A hiring race condition, reproduced in your terminal.",
   "keywords": [
     "cli",
     "npx",
@@ -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,99 +1,36 @@
-import { createInterface } from 'node:readline';
 import { readFileSync } 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 { lintResult } from './lint.js';
-import { printTrap } from './reject.js';
-import {
-  blank,
-  clear,
-  dim,
-  print,
-  showCursor,
-} from './style.js';
+import { runLintCli } from './lint-cli.js';
+import { interactive } from './interactive.js';
+import { hiringResult, printHiring, printShare, shareText } from './hiring.js';
+import { blank, dim, print, showCursor, wrap } from './style.js';
 import {
-  printHeader,
-  printHelp,
-  printHire,
-  printLandingTeaser,
-  printLintReport,
-  printLooking,
-  printMenu,
-  printRant,
-  printSignature,
-  printSkills,
-  printWho,
-  printWork,
-  toJson,
+  printCard, printHeader, printHelp, printHire, printLandingTeaser,
+  printLooking, printMenu, printProof, printRant, printRules, printSignature,
+  printSkills, printTweet, printVcf, printWho, printWhy, printWork, toJson,
 } from './screens.js';
 
-const pkg = JSON.parse(
-  readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf8'),
-);
-
+const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+const VALUE_FLAGS = new Set(['--max-warnings', '--seed', '--off', '--format', '--to']);
 const COMMANDS = {
-  who: printWho,
-  about: printWho,
-  looking: printLooking,
-  jobs: printLooking,
-  rant: printRant,
-  market: printRant,
-  work: printWork,
-  proof: printWork,
-  experience: printWork,
-  skills: printSkills,
-  hire: printHire,
-  h: printHire,
-  links: printHire,
-  contact: printHire,
-};
-
-const ask = (rl, prompt) =>
-  new Promise((resolve) => {
-    rl.question(prompt, resolve);
-  });
-
-const readStdin = async () => {
-  const chunks = [];
-  for await (const chunk of stdin) chunks.push(chunk);
-  return Buffer.concat(chunks).toString('utf8');
+  who: printWho, about: printWho, looking: printLooking, jobs: printLooking,
+  rant: printRant, market: printRant, work: printWork, experience: printWork,
+  proof: printProof, skills: printSkills, card: printCard, why: printWhy,
+  help: printHelp,
 };
-
-const readPaste = async (rl) => {
-  blank();
-  print(dim('  paste a job description. empty line to lint.'));
-  blank();
-  const lines = [];
-  while (true) {
-    const line = await ask(rl, dim('  '));
-    if (line === '') break;
-    lines.push(line);
-  }
-  return lines.join('\n');
+const aliases = {
+  q: 'quit', exit: 'quit', l: 'lint', c: 'copy', r: 'replay', d: 'demo',
+  h: 'hire', links: 'hire', contact: 'hire', vcard: 'vcf',
 };
-
 const resolveCommand = (input) => {
   const value = String(input).trim().toLowerCase();
-  if (!value) return null;
-  if (value === 'q' || value === 'quit' || value === 'exit') return 'quit';
-  if (value === 'help') return 'help';
-  if (value === 'lint' || value === 'l') return 'lint';
-  const fromMenu = menu.find((item) => item.key === value || item.command === value);
-  if (fromMenu) return fromMenu.command;
-  if (COMMANDS[value]) return value;
+  if (aliases[value]) return aliases[value];
+  const item = menu.find((entry) => entry.key === value);
+  if (item) return item.command;
+  if (COMMANDS[value] || ['quit', 'lint', 'copy', 'replay', 'demo', 'share', 'hire', 'vcf', 'tweet'].includes(value)) return value;
   return null;
 };
 
-const runCommand = (command) => {
-  const render = COMMANDS[command];
-  if (!render) return false;
-  render();
-  return true;
-};
-
 const showResume = () => {
   printHeader();
   printSignature();
@@ -101,150 +38,118 @@ const showResume = () => {
   printMenu();
 };
 
-const interactive = async ({ trap }) => {
-  if (process.stdout.isTTY) clear();
-  if (trap) {
-    await printTrap({ animate: true });
-    blank();
-  }
-  showResume();
-
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    while (true) {
-      const answer = await ask(rl, dim('  jobless> '));
-      const command = resolveCommand(answer);
-
-      if (!command) {
-        print(`  ${dim('unknown. try 1–5, l to lint, h to hire, or q.')}`);
-        continue;
-      }
-      if (command === 'help') {
-        if (process.stdout.isTTY) clear();
-        printHelp();
-        printMenu();
-        continue;
-      }
-      if (command === 'lint') {
-        const text = await readPaste(rl);
-        if (process.stdout.isTTY) clear();
-        printHeader();
-        printLintReport(lintResult(text, 'paste'));
-        printMenu();
-        continue;
-      }
-      if (command === 'quit') {
-        blank();
-        print(dim('  still jobless. still shipping.'));
-        print(dim('  yonalem21@gmail.com'));
-        blank();
-        break;
-      }
-
-      if (process.stdout.isTTY) clear();
-      printHeader();
-      runCommand(command);
-      printMenu();
-    }
-  } finally {
-    rl.close();
-    showCursor();
-  }
-};
-
 const parse = (argv) => {
   const flags = new Set();
+  const opts = {};
   const rest = [];
-  for (const arg of argv) {
-    if (arg.startsWith('-')) flags.add(arg);
-    else rest.push(arg);
-  }
-  return { flags, rest };
-};
 
-const runLintCli = async (files, { json = false } = {}) => {
-  let source = 'stdin';
-  let text = '';
+  const setOpt = (key, value) => {
+    opts[key] = opts[key] ? `${opts[key]},${value}` : value;
+  };
 
-  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;
+  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);
   }
 
-  const report = lintResult(text, source);
-  if (!report.ok) process.exitCode = 1;
-
-  if (json) {
-    print(JSON.stringify(report, null, 2));
-    return;
-  }
+  return { flags, opts, rest };
+};
 
-  printLintReport(report);
-  blank();
-  print(dim('  more: npx jobless   ·   npx jobless hire'));
+const applyColorFlags = (flags, opts) => {
+  if (flags.has('--no-color') || opts.color === 'never') process.env.NO_COLOR = '1';
 };
 
 export const run = async (argv = []) => {
   process.stdout.on('error', (error) => {
     if (error.code === 'EPIPE') process.exit(0);
   });
-
-  const { flags, rest } = parse(argv);
-  const verb = rest[0] ? rest[0].toLowerCase() : '';
-
-  if (flags.has('-h') || flags.has('--help') || verb === 'help') {
-    printHelp();
+  const { flags, opts, rest } = parse(argv);
+  applyColorFlags(flags, opts);
+  const verb = rest[0]?.toLowerCase() || '';
+  const command = resolveCommand(verb);
+  const runCommand = (name, report = null) => {
+    if (name === 'hire') printHire({ report, to: opts.to, copy: flags.has('--copy') });
+    else if (name === 'vcf') printVcf({ copy: flags.has('--copy') });
+    else if (name === 'tweet') printTweet(report);
+    else COMMANDS[name]?.();
+  };
+
+  if (flags.has('-h') || flags.has('--help') || command === 'help') return printHelp();
+  if (flags.has('-v') || flags.has('--version')) return print(pkg.version);
+  if (verb === 'rules' || flags.has('--rules')) return printRules();
+
+  if (command === 'lint' || command === 'demo') {
+    const maxRaw = opts['max-warnings'];
+    const maxWarnings = maxRaw == null || maxRaw === '' ? null : Number(maxRaw);
+    await runLintCli(rest.slice(1), {
+      format: opts.format || (flags.has('--json') ? 'json' : 'pretty'),
+      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'),
+      demo: command === 'demo' || flags.has('--demo'),
+      off: String(opts.off || '').split(',').map((id) => id.trim()).filter(Boolean),
+      maxWarnings: Number.isFinite(maxWarnings) ? maxWarnings : null,
+    });
     return;
   }
-
-  if (flags.has('-v') || flags.has('--version')) {
-    print(pkg.version);
+  if (flags.has('--json')) return print(toJson());
+  if (verb && !command) throw new Error(`Unknown command: ${verb}. Try npx jobless --help.`);
+
+  const record = flags.has('--record');
+  const seed = opts.seed ?? 0;
+  // Recording and exported results always omit local identity, even with --personalize.
+  const personalize = flags.has('--personalize') && !record;
+  if (command === 'share' || command === 'copy') {
+    printShare(shareText(hiringResult({ seed })), { copy: command === 'copy' || flags.has('--copy') });
     return;
   }
-
-  if (verb === 'lint' || verb === 'l') {
-    await runLintCli(rest.slice(1), { json: flags.has('--json') });
-    return;
-  }
-
-  if (flags.has('--json')) {
-    print(toJson());
-    return;
-  }
-
-  const skipTrap = flags.has('--resume') || flags.has('--skip-trap') || flags.has('--no-trap');
-  const command = verb ? resolveCommand(verb) : null;
-
-  if (command && command !== 'quit' && command !== 'help' && command !== 'lint') {
-    printHeader();
+  if (command === 'quit') return;
+  if (command && command !== 'replay') {
+    if (!['why', 'tweet', 'rant'].includes(command)) printHeader();
     runCommand(command);
-    blank();
-    print(dim('  more: npx jobless   ·   npx jobless hire   ·   npx jobless --help'));
     return;
   }
-
-  if (!process.stdout.isTTY) {
-    if (!skipTrap) await printTrap({ animate: false });
-    blank();
-    printHeader();
-    printSignature();
-    printHire({ copy: false });
+  const skipTrap = flags.has('--resume') || flags.has('--skip-trap') || flags.has('--no-trap');
+  if (!skipTrap) hiringResult({ seed }); // Validate before starting an interactive prompt.
+  if (record || !process.stdout.isTTY || !process.stdin.isTTY) {
+    if (skipTrap) showResume();
+    else {
+      await printHiring({ seed, personalize });
+      blank();
+      for (const line of wrap('Next: npx jobless share | npx jobless lint --demo')) print(dim(`  ${line}`));
+    }
     return;
   }
-
-  process.on('SIGINT', () => {
+  process.once('SIGINT', () => {
     showCursor();
     process.stdout.write('\n');
     process.exit(0);
   });
-
-  await interactive({ trap: !skipTrap });
+  await interactive({ trap: !skipTrap, seed, personalize, resolveCommand, runCommand, showResume });
 };

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;
+  }
+};