terminalhire 0.1.1 → 0.2.0

package/dist/bin/jpi-dispatch.js

@@ -1289,9 +1289,12 @@ __export(profile_exports, {
   accumulateGitHubTags: () => accumulateGitHubTags,
   accumulateSession: () => accumulateSession,
   accumulateTags: () => accumulateTags,
+  addSavedJob: () => addSavedJob,
   deleteProfile: () => deleteProfile,
+  listSavedJobs: () => listSavedJobs,
   profileToFingerprint: () => profileToFingerprint,
   readProfile: () => readProfile,
+  removeSavedJob: () => removeSavedJob,
   writeProfile: () => writeProfile
 });
 import {
@@ -1437,6 +1440,26 @@ function accumulateGitHubTags(profile, tags) {
     false
   );
 }
+async function listSavedJobs() {
+  const profile = await readProfile();
+  return profile.savedJobs ?? [];
+}
+async function addSavedJob(job) {
+  const profile = await readProfile();
+  const existing = profile.savedJobs ?? [];
+  const filtered = existing.filter((j) => j.id !== job.id);
+  profile.savedJobs = [...filtered, { ...job, savedAt: (/* @__PURE__ */ new Date()).toISOString() }];
+  await writeProfile(profile);
+}
+async function removeSavedJob(id) {
+  const profile = await readProfile();
+  const existing = profile.savedJobs ?? [];
+  const filtered = existing.filter((j) => j.id !== id);
+  if (filtered.length === existing.length) return false;
+  profile.savedJobs = filtered;
+  await writeProfile(profile);
+  return true;
+}
 async function deleteProfile() {
   const { rmSync: rmSync2 } = await import("fs");
   try {
@@ -1529,12 +1552,12 @@ async function runLogin() {
     let ghProfile;
     if (process.env["TERMINALHIRE_GITHUB_MOCK"] === "1" || process.env["TERMINALHIRE_GITHUB_MOCK"] === "1" || process.env["JPI_GITHUB_MOCK"] === "1") {
       const { createRequire: createRequire2 } = await import("module");
-      const { fileURLToPath: fileURLToPath5 } = await import("url");
-      const { join: join9, dirname: dirname2 } = await import("path");
-      const __dirname4 = fileURLToPath5(new URL(".", import.meta.url));
-      const fixturePath = join9(__dirname4, "../../fixtures/github-sample.json");
-      const { readFileSync: readFileSync8 } = await import("fs");
-      ghProfile = JSON.parse(readFileSync8(fixturePath, "utf8"));
+      const { fileURLToPath: fileURLToPath7 } = await import("url");
+      const { join: join13, dirname: dirname3 } = await import("path");
+      const __dirname6 = fileURLToPath7(new URL(".", import.meta.url));
+      const fixturePath = join13(__dirname6, "../../fixtures/github-sample.json");
+      const { readFileSync: readFileSync12 } = await import("fs");
+      ghProfile = JSON.parse(readFileSync12(fixturePath, "utf8"));
     } else {
       ghProfile = await fetchGitHubProfile2(login, token);
     }
@@ -1710,14 +1733,24 @@ function formatComp(job) {
   if (job.compMin) return `$${Math.round(job.compMin / 1e3)}k+`;
   return "";
 }
+function linkTitle(title, url) {
+  const isTTY = process.stdout.isTTY;
+  const noColor = process.env["NO_COLOR"] !== void 0;
+  if (isTTY && !noColor && url) {
+    return `\x1B]8;;${url}\x1B\\${title}\x1B]8;;\x1B\\`;
+  }
+  return url ? `${title} (${url})` : title;
+}
 function printResult(i, result) {
   const { job, score, matchedTags, reason } = result;
   const comp = formatComp(job);
   const remote = job.remote ? "remote" : job.location ?? "onsite";
   const compStr = comp ? ` \xB7 ${comp}` : "";
   const mode = job.applyMode === "buyer-lead" ? " [COASTAL LEAD]" : "";
+  const titleStr = linkTitle(job.title, job.url);
   console.log(`
-${i + 1}. ${job.title} \u2014 ${job.company}${mode}`);
+${i + 1}. ${titleStr} \u2014 ${job.company}${mode}`);
+  console.log(`   id: ${job.id}`);
   console.log(`   ${remote}${compStr} \xB7 ${job.roleType} \xB7 score: ${formatScore(score)}`);
   console.log(`   ${reason}`);
   console.log(`   Tags matched: ${matchedTags.slice(0, 5).join(", ")}`);
@@ -2275,19 +2308,454 @@ var init_jpi_config = __esm({
   }
 });
 
+// bin/spinner.js
+var spinner_exports = {};
+__export(spinner_exports, {
+  SPINNER_DEFAULTS: () => SPINNER_DEFAULTS,
+  applySpinnerTips: () => applySpinnerTips,
+  applySpinnerVerbs: () => applySpinnerVerbs,
+  buildContextVerbs: () => buildContextVerbs,
+  buildSpinnerPool: () => buildSpinnerPool,
+  buildTips: () => buildTips,
+  clearSpinnerTips: () => clearSpinnerTips,
+  clearSpinnerVerbs: () => clearSpinnerVerbs,
+  ctaVerb: () => ctaVerb,
+  formatVerbs: () => formatVerbs,
+  rankBySessionTags: () => rankBySessionTags,
+  readSpinnerConfig: () => readSpinnerConfig
+});
+import {
+  readFileSync as readFileSync7,
+  writeFileSync as writeFileSync5,
+  existsSync as existsSync5,
+  mkdirSync as mkdirSync5,
+  renameSync
+} from "fs";
+import { join as join7, dirname } from "path";
+import { homedir as homedir5 } from "os";
+function readJson(path, fallback) {
+  try {
+    return existsSync5(path) ? JSON.parse(readFileSync7(path, "utf8")) : fallback;
+  } catch {
+    return fallback;
+  }
+}
+function atomicWriteJson(path, obj) {
+  mkdirSync5(dirname(path), { recursive: true });
+  const tmp = `${path}.tmp-${process.pid}`;
+  writeFileSync5(tmp, JSON.stringify(obj, null, 2) + "\n", "utf8");
+  renameSync(tmp, path);
+}
+function titleCase(s) {
+  return String(s || "").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function readSpinnerConfig() {
+  const cfg = readJson(CONFIG_FILE2, {});
+  const spinner = cfg && typeof cfg.spinner === "object" ? cfg.spinner : {};
+  const merged = { ...SPINNER_DEFAULTS, ...spinner };
+  if (merged.mode !== "append" && merged.mode !== "replace") merged.mode = SPINNER_DEFAULTS.mode;
+  merged.max = Math.max(1, Math.min(12, Number(merged.max) || SPINNER_DEFAULTS.max));
+  merged.enabled = merged.enabled === true;
+  if (!["always", "sometimes", "rare"].includes(merged.frequency)) {
+    merged.frequency = SPINNER_DEFAULTS.frequency;
+  }
+  return merged;
+}
+function ctaVerb() {
+  return "\u2605 jobs that fit you \xB7 run: terminalhire jobs";
+}
+function formatVerbs(topMatches, max = 6) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const m of Array.isArray(topMatches) ? topMatches : []) {
+    if (!m || !m.title || !m.company) continue;
+    let title = String(m.title).trim().replace(/\s+/g, " ");
+    if (title.length > 32) title = title.slice(0, 31).trimEnd() + "\u2026";
+    const company = titleCase(String(m.company).trim().replace(/\s+/g, " "));
+    const pct = Math.max(1, Math.min(99, Math.round((Number(m.score) || 0) * 100)));
+    const key = `${title.toLowerCase()}@${company.toLowerCase()}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    const intro = VERB_INTROS[out.length % VERB_INTROS.length];
+    out.push(`${intro} ${title} @ ${company} \xB7 ${pct}% match`);
+    if (out.length >= max) break;
+  }
+  return out;
+}
+function rankBySessionTags(topMatches, sessionTags) {
+  const tags = Array.isArray(sessionTags) ? sessionTags.filter(Boolean) : [];
+  if (tags.length === 0 || !Array.isArray(topMatches)) return topMatches;
+  const normalized = tags.map((t) => String(t).toLowerCase().trim());
+  return topMatches.map((m, originalIndex) => {
+    const haystack = `${String(m.title || "").toLowerCase()} ${String(m.company || "").toLowerCase()}`;
+    const hits = normalized.reduce((n, tag) => n + (haystack.includes(tag) ? 1 : 0), 0);
+    return { m, hits, originalIndex };
+  }).sort((a, b) => b.hits - a.hits || a.originalIndex - b.originalIndex).map(({ m }) => m);
+}
+function verbCountForFrequency(frequency, max) {
+  switch (frequency) {
+    case "always":
+      return max;
+    case "rare":
+      return 1;
+    case "sometimes":
+    default:
+      return 2;
+  }
+}
+function buildContextVerbs(topMatches, sessionTags) {
+  const sess = (Array.isArray(sessionTags) ? sessionTags : []).map((t) => String(t).toLowerCase().trim()).filter(Boolean);
+  const roleTags = /* @__PURE__ */ new Set();
+  for (const m of Array.isArray(topMatches) ? topMatches : []) {
+    const mt = m && Array.isArray(m.matchedTags) ? m.matchedTags : [];
+    for (const t of mt) roleTags.add(String(t).toLowerCase().trim());
+  }
+  const overlap = [];
+  for (const t of sess) {
+    if (roleTags.has(t) && !overlap.includes(t)) overlap.push(t);
+  }
+  if (overlap.length >= 2) {
+    const a = titleCase(overlap[0]);
+    const b = titleCase(overlap[1]);
+    return [`\u2726 Fits your ${a} + ${b} work`, `\u2726 A role matching what you're building`];
+  }
+  if (overlap.length === 1) {
+    const a = titleCase(overlap[0]);
+    return [`\u2726 A role matching your ${a} work`, `\u2726 Your ${a} work \u2014 link in the tip below`];
+  }
+  return [`\u2726 A role that fits your work`, `\u2726 Job match for you \u2014 link in the tip below`];
+}
+function buildSpinnerPool(topMatches, max = 6, opts = {}) {
+  const { sessionTags, frequency = "always" } = opts;
+  const ranked = rankBySessionTags(topMatches, sessionTags);
+  if (!Array.isArray(ranked) || ranked.length === 0) return [];
+  const headers = buildContextVerbs(ranked, sessionTags);
+  const cap = Math.max(1, verbCountForFrequency(frequency, headers.length));
+  return [...headers.slice(0, cap), ctaVerb()];
+}
+function readState() {
+  return readJson(SPINNER_STATE_FILE, { verbs: [], mode: "replace" });
+}
+function applySpinnerVerbs(ourVerbs, mode = "replace") {
+  const verbs = (Array.isArray(ourVerbs) ? ourVerbs : []).filter(Boolean);
+  if (verbs.length === 0) return clearSpinnerVerbs();
+  const settings = readJson(CLAUDE_SETTINGS, {}) || {};
+  const existing = settings.spinnerVerbs && typeof settings.spinnerVerbs === "object" ? settings.spinnerVerbs : null;
+  const prevOurs = new Set(readState().verbs || []);
+  const userVerbs = existing && Array.isArray(existing.verbs) ? existing.verbs.filter((v) => !prevOurs.has(v)) : [];
+  const newVerbs = [...verbs, ...userVerbs];
+  settings.spinnerVerbs = { mode: mode === "append" ? "append" : "replace", verbs: newVerbs };
+  atomicWriteJson(CLAUDE_SETTINGS, settings);
+  const st = readState();
+  atomicWriteJson(SPINNER_STATE_FILE, { ...st, verbs, mode, ts: Date.now() });
+  return { applied: verbs.length, total: newVerbs.length };
+}
+function clearSpinnerVerbs() {
+  const settings = readJson(CLAUDE_SETTINGS, null);
+  const prevOurs = new Set(readState().verbs || []);
+  let keptUserVerbs = 0;
+  if (settings && settings.spinnerVerbs && Array.isArray(settings.spinnerVerbs.verbs)) {
+    const userVerbs = settings.spinnerVerbs.verbs.filter((v) => !prevOurs.has(v));
+    keptUserVerbs = userVerbs.length;
+    if (userVerbs.length > 0) {
+      settings.spinnerVerbs = {
+        mode: settings.spinnerVerbs.mode === "append" ? "append" : "replace",
+        verbs: userVerbs
+      };
+    } else {
+      delete settings.spinnerVerbs;
+    }
+    atomicWriteJson(CLAUDE_SETTINGS, settings);
+  }
+  try {
+    const st = readState();
+    atomicWriteJson(SPINNER_STATE_FILE, { ...st, verbs: [], mode: st.mode || "replace", ts: Date.now() });
+  } catch {
+  }
+  return { cleared: true, keptUserVerbs };
+}
+function buildTips(topMatches, baseUrl, max = 3) {
+  const base = String(baseUrl || "https://terminalhire.com").replace(/\/+$/, "");
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const m of Array.isArray(topMatches) ? topMatches : []) {
+    if (!m || !m.title || !m.company || !m.id) continue;
+    const idx = String(m.id).indexOf(":");
+    if (idx <= 0) continue;
+    const source = String(m.id).slice(0, idx);
+    const ext = String(m.id).slice(idx + 1);
+    if (!source || !ext) continue;
+    const key = `${source}/${ext}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    let title = String(m.title).trim().replace(/\s+/g, " ");
+    if (title.length > 34) title = title.slice(0, 33).trimEnd() + "\u2026";
+    const company = titleCase(String(m.company).trim().replace(/\s+/g, " "));
+    const pct = Math.max(1, Math.min(99, Math.round((Number(m.score) || 0) * 100)));
+    const url = `${base}/j/${source}/${encodeURIComponent(ext)}`;
+    out.push(`\u2197 ${title} @ ${company} \xB7 ${pct}% \u2014 ${url}`);
+    if (out.length >= max) break;
+  }
+  return out;
+}
+function applySpinnerTips(ourTips) {
+  const tips = (Array.isArray(ourTips) ? ourTips : []).filter(Boolean);
+  if (tips.length === 0) return clearSpinnerTips();
+  const settings = readJson(CLAUDE_SETTINGS, {}) || {};
+  const existing = settings.spinnerTipsOverride && Array.isArray(settings.spinnerTipsOverride.tips) ? settings.spinnerTipsOverride.tips : [];
+  const prevOurs = new Set(readState().tips || []);
+  const userTips = existing.filter((t) => !prevOurs.has(t));
+  settings.spinnerTipsEnabled = true;
+  settings.spinnerTipsOverride = { excludeDefault: true, tips: [...tips, ...userTips] };
+  atomicWriteJson(CLAUDE_SETTINGS, settings);
+  const st = readState();
+  atomicWriteJson(SPINNER_STATE_FILE, { ...st, tips, ts: Date.now() });
+  return { applied: tips.length };
+}
+function clearSpinnerTips() {
+  const settings = readJson(CLAUDE_SETTINGS, null);
+  const prevOurs = new Set(readState().tips || []);
+  if (settings && settings.spinnerTipsOverride && Array.isArray(settings.spinnerTipsOverride.tips)) {
+    const userTips = settings.spinnerTipsOverride.tips.filter((t) => !prevOurs.has(t));
+    if (userTips.length > 0) {
+      settings.spinnerTipsOverride = {
+        excludeDefault: settings.spinnerTipsOverride.excludeDefault === true,
+        tips: userTips
+      };
+    } else {
+      delete settings.spinnerTipsOverride;
+      delete settings.spinnerTipsEnabled;
+    }
+    atomicWriteJson(CLAUDE_SETTINGS, settings);
+  }
+  try {
+    const st = readState();
+    atomicWriteJson(SPINNER_STATE_FILE, { ...st, tips: [], ts: Date.now() });
+  } catch {
+  }
+  return { cleared: true };
+}
+var TH_DIR, CLAUDE_SETTINGS, CONFIG_FILE2, SPINNER_STATE_FILE, SPINNER_DEFAULTS, VERB_INTROS;
+var init_spinner = __esm({
+  "bin/spinner.js"() {
+    "use strict";
+    TH_DIR = process.env["TERMINALHIRE_DIR"] || join7(homedir5(), ".terminalhire");
+    CLAUDE_SETTINGS = process.env["TERMINALHIRE_CLAUDE_SETTINGS"] || join7(homedir5(), ".claude", "settings.json");
+    CONFIG_FILE2 = join7(TH_DIR, "config.json");
+    SPINNER_STATE_FILE = join7(TH_DIR, "spinner-state.json");
+    SPINNER_DEFAULTS = { enabled: false, mode: "append", max: 6, frequency: "sometimes" };
+    VERB_INTROS = ["Matched:", "You\u2019d fit:", "Worth a look:", "On your radar:", "Fits your stack:"];
+  }
+});
+
+// bin/jpi-spinner.js
+var jpi_spinner_exports = {};
+__export(jpi_spinner_exports, {
+  run: () => run6
+});
+import {
+  readFileSync as readFileSync8,
+  writeFileSync as writeFileSync6,
+  copyFileSync,
+  existsSync as existsSync6,
+  mkdirSync as mkdirSync6
+} from "fs";
+import { join as join8 } from "path";
+import { homedir as homedir6 } from "os";
+import { createInterface as createInterface3 } from "readline";
+function readConfig2() {
+  try {
+    return existsSync6(CONFIG_FILE3) ? JSON.parse(readFileSync8(CONFIG_FILE3, "utf8")) : {};
+  } catch {
+    return {};
+  }
+}
+function writeConfig2(patch) {
+  mkdirSync6(TH_DIR2, { recursive: true });
+  const merged = { ...readConfig2(), ...patch };
+  writeFileSync6(CONFIG_FILE3, JSON.stringify(merged, null, 2) + "\n", "utf8");
+}
+function backupSettings() {
+  if (!existsSync6(SETTINGS_PATH)) return null;
+  const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const backupPath = `${SETTINGS_PATH}.terminalhire-backup-${ts}`;
+  copyFileSync(SETTINGS_PATH, backupPath);
+  return backupPath;
+}
+function ask(question) {
+  const rl = createInterface3({ input: process.stdin, output: process.stdout });
+  return new Promise((res) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      res(answer.trim().toLowerCase());
+    });
+  });
+}
+function readTopMatches() {
+  try {
+    const c = JSON.parse(readFileSync8(CACHE_FILE, "utf8"));
+    return Array.isArray(c.topMatches) ? c.topMatches : [];
+  } catch {
+    return [];
+  }
+}
+async function run6() {
+  const args2 = process.argv.slice(2).filter((a) => a !== "spinner");
+  const has = (f) => args2.includes(f);
+  const val = (f) => {
+    const i = args2.indexOf(f);
+    return i >= 0 ? args2[i + 1] : void 0;
+  };
+  if (has("--show") || args2.length === 0) {
+    const sc = readSpinnerConfig();
+    console.log("");
+    console.log("terminalhire spinner \u2014 job matches in the Claude Code spinner line");
+    console.log("");
+    console.log(`  enabled:   ${sc.enabled}`);
+    console.log(`  mode:      ${sc.mode}   (replace = only job matches; append = mixed with Claude defaults)`);
+    console.log(`  max:       ${sc.max}    (max job verbs that rotate)`);
+    console.log(`  frequency: ${sc.frequency}   (always = up to max; sometimes = up to 2; rare = 1 per cycle)`);
+    console.log("");
+    console.log("  terminalhire spinner --on                      enable (asks consent, backs up settings.json)");
+    console.log("  terminalhire spinner --off                     disable + restore your original spinner");
+    console.log("  terminalhire spinner --mode append             mix job verbs with Claude's defaults");
+    console.log("  terminalhire spinner --mode replace            show only job matches");
+    console.log("  terminalhire spinner --max N                   cap how many job verbs rotate (1\u201312)");
+    console.log("  terminalhire spinner --frequency always        surface up to max role verbs every cycle");
+    console.log("  terminalhire spinner --frequency sometimes     surface up to 2 role verbs (default)");
+    console.log("  terminalhire spinner --frequency rare          surface 1 role verb per cycle (quietest)");
+    console.log("");
+    return;
+  }
+  if (has("--off")) {
+    const res = clearSpinnerVerbs();
+    clearSpinnerTips();
+    writeConfig2({ spinner: { ...readSpinnerConfig(), enabled: false } });
+    console.log("");
+    console.log("  Spinner job verbs removed.");
+    if (res.keptUserVerbs > 0) {
+      console.log(`  Preserved ${res.keptUserVerbs} spinner verb(s) you set yourself.`);
+    } else {
+      console.log("  Your original spinner is restored.");
+    }
+    console.log("  Re-enable any time: terminalhire spinner --on");
+    console.log("");
+    return;
+  }
+  if ((has("--mode") || has("--max") || has("--frequency")) && !has("--on")) {
+    const cur = readSpinnerConfig();
+    const next = { ...cur };
+    const m = val("--mode");
+    if (m) {
+      if (m !== "append" && m !== "replace") {
+        console.error('Error: --mode must be "append" or "replace".');
+        process.exit(1);
+      }
+      next.mode = m;
+    }
+    const mx = val("--max");
+    if (mx) {
+      const n = parseInt(mx, 10);
+      if (!(n >= 1 && n <= 12)) {
+        console.error("Error: --max must be a number 1\u201312.");
+        process.exit(1);
+      }
+      next.max = n;
+    }
+    const freq = val("--frequency");
+    if (freq) {
+      if (!["always", "sometimes", "rare"].includes(freq)) {
+        console.error('Error: --frequency must be "always", "sometimes", or "rare".');
+        process.exit(1);
+      }
+      next.frequency = freq;
+    }
+    writeConfig2({ spinner: next });
+    console.log(`  spinner config updated: mode=${next.mode} max=${next.max} frequency=${next.frequency} enabled=${next.enabled}`);
+    if (next.enabled) {
+      const verbs = buildSpinnerPool(readTopMatches(), next.max, { frequency: next.frequency });
+      if (verbs.length) applySpinnerVerbs(verbs, next.mode);
+      else clearSpinnerVerbs();
+    }
+    return;
+  }
+  if (has("--on")) {
+    const mode = val("--mode") === "replace" ? "replace" : "append";
+    const maxRaw = parseInt(val("--max"), 10);
+    const max = maxRaw >= 1 && maxRaw <= 12 ? maxRaw : 6;
+    const freqRaw = val("--frequency");
+    const frequency = ["always", "sometimes", "rare"].includes(freqRaw) ? freqRaw : "sometimes";
+    console.log("");
+    console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+    console.log("\u2502   terminalhire \u2014 enable the spinner job surface                  \u2502");
+    console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+    console.log("");
+    console.log("WHAT THIS CHANGES:");
+    console.log('  \u2022 Adds a "spinnerVerbs" key to ~/.claude/settings.json \u2014 the official,');
+    console.log("    documented Claude Code setting. No patching, no binary changes (Rule 7).");
+    console.log("  \u2022 While Claude works, the spinner line shows your TOP LOCAL JOB MATCHES,");
+    console.log("    e.g.  Senior Backend Engineer @ Stripe \xB7 82% \u2026");
+    console.log("  \u2022 The tip line below shows a \u2318-clickable terminalhire.com/j/\u2026 link to open");
+    console.log("    the listing (clicks logged anonymously, no profile data).");
+    console.log(`  \u2022 mode=${mode}  (replace = only job matches; append = mixed with defaults)`);
+    console.log(`  \u2022 frequency=${frequency}  (always = every cycle; sometimes = up to 2 verbs; rare = 1 verb)`);
+    console.log("  \u2022 Matches are computed LOCALLY and refreshed in the background.");
+    console.log("    ZERO egress \u2014 your profile never leaves the machine; only public job");
+    console.log("    text appears on YOUR screen.");
+    console.log("  \u2022 Any spinner verbs you already set are preserved, never clobbered.");
+    console.log("");
+    console.log("FULLY REVERSIBLE:");
+    console.log("  terminalhire spinner --off    removes job verbs, restores your spinner");
+    console.log("  (a timestamped backup of settings.json is taken now)");
+    console.log("");
+    const answer = await ask('Enable the spinner job surface? Type "yes" to continue: ');
+    if (answer !== "yes") {
+      console.log("\nAborted \u2014 nothing changed.");
+      process.exit(0);
+    }
+    const backup = backupSettings();
+    writeConfig2({ spinner: { enabled: true, mode, max, frequency } });
+    const verbs = buildSpinnerPool(readTopMatches(), max, { frequency });
+    if (verbs.length) applySpinnerVerbs(verbs, mode);
+    console.log("");
+    if (backup) console.log(`  Backed up settings to: ${backup}`);
+    console.log(`  Enabled. ${verbs.length} job verb(s) live now; refreshes in the background.`);
+    if (verbs.length === 0) {
+      console.log("  (No matches cached yet \u2014 run `terminalhire refresh` or wait for the monitor.)");
+    }
+    console.log("  Claude Code picks up settings.json changes automatically.");
+    console.log("  Turn off any time: terminalhire spinner --off");
+    console.log("");
+    return;
+  }
+  console.error("Usage: terminalhire spinner --on | --off | --show | --mode <append|replace> | --max N | --frequency <always|sometimes|rare>");
+  process.exit(1);
+}
+var TH_DIR2, CONFIG_FILE3, SETTINGS_PATH, CACHE_FILE;
+var init_jpi_spinner = __esm({
+  "bin/jpi-spinner.js"() {
+    "use strict";
+    init_spinner();
+    TH_DIR2 = process.env["TERMINALHIRE_DIR"] || join8(homedir6(), ".terminalhire");
+    CONFIG_FILE3 = join8(TH_DIR2, "config.json");
+    SETTINGS_PATH = process.env["TERMINALHIRE_CLAUDE_SETTINGS"] || join8(homedir6(), ".claude", "settings.json");
+    CACHE_FILE = join8(TH_DIR2, "index-cache.json");
+  }
+});
+
 // bin/jpi-init.js
 var jpi_init_exports = {};
 __export(jpi_init_exports, {
-  run: () => run6
+  run: () => run7
 });
-import { existsSync as existsSync5 } from "fs";
-import { join as join7, resolve } from "path";
+import { existsSync as existsSync7 } from "fs";
+import { join as join9, resolve } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
-import { createInterface as createInterface3 } from "readline";
+import { createInterface as createInterface4 } from "readline";
 import { spawnSync, spawn } from "child_process";
-import { homedir as homedir5 } from "os";
-function ask(question) {
-  const rl = createInterface3({ input: process.stdin, output: process.stdout });
+import { homedir as homedir7 } from "os";
+function ask2(question) {
+  const rl = createInterface4({ input: process.stdin, output: process.stdout });
   return new Promise((resolve2) => {
     rl.question(question, (answer) => {
       rl.close();
@@ -2296,18 +2764,18 @@ function ask(question) {
   });
 }
 function resolveScript(name) {
-  const distPath = resolve(join7(__dirname2, "..", "..", "dist", "bin", `${name}.js`));
-  const legacyPath = resolve(join7(__dirname2, `${name}.js`));
-  return existsSync5(distPath) ? distPath : legacyPath;
+  const distPath = resolve(join9(__dirname2, "..", "..", "dist", "bin", `${name}.js`));
+  const legacyPath = resolve(join9(__dirname2, `${name}.js`));
+  return existsSync7(distPath) ? distPath : legacyPath;
 }
 function resolveInstallJs() {
-  const fromDist = resolve(join7(__dirname2, "..", "..", "install.js"));
-  const fromBin = resolve(join7(__dirname2, "..", "install.js"));
-  if (existsSync5(fromDist)) return fromDist;
-  if (existsSync5(fromBin)) return fromBin;
+  const fromDist = resolve(join9(__dirname2, "..", "..", "install.js"));
+  const fromBin = resolve(join9(__dirname2, "..", "install.js"));
+  if (existsSync7(fromDist)) return fromDist;
+  if (existsSync7(fromBin)) return fromBin;
   return fromBin;
 }
-async function run6() {
+async function run7() {
   console.log("");
   console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
   console.log("\u2502           terminalhire init \u2014 one-command onboarding            \u2502");
@@ -2329,7 +2797,7 @@ async function run6() {
   console.log("  GitHub data enriches your local profile. Nothing leaves your machine");
   console.log("  until you explicitly consent to a specific lead.");
   console.log("");
-  const githubAnswer = await ask("Sign in with GitHub now? [Y/n] (Enter = yes, n = stay local): ");
+  const githubAnswer = await ask2("Sign in with GitHub now? [Y/n] (Enter = yes, n = stay local): ");
   const doGitHub = githubAnswer === "" || githubAnswer === "y" || githubAnswer === "yes";
   if (doGitHub) {
     console.log("");
@@ -2407,21 +2875,244 @@ var init_jpi_init = __esm({
   }
 });
 
-// bin/jpi-dispatch.js
+// bin/jpi-refresh.js
+var jpi_refresh_exports = {};
+__export(jpi_refresh_exports, {
+  run: () => run8
+});
+import { readFileSync as readFileSync9, writeFileSync as writeFileSync7, existsSync as existsSync8, mkdirSync as mkdirSync7 } from "fs";
+import { join as join10 } from "path";
+import { homedir as homedir8 } from "os";
 import { fileURLToPath as fileURLToPath4 } from "url";
-import { join as join8, dirname } from "path";
-import { existsSync as existsSync6, readFileSync as readFileSync7 } from "fs";
+async function run8() {
+  try {
+    let index;
+    try {
+      const res = await fetch(`${API_URL2}/api/index`, {
+        signal: AbortSignal.timeout(15e3),
+        headers: { "Accept": "application/json" }
+      });
+      if (!res.ok) {
+        process.stderr.write(`terminalhire refresh: index fetch failed (HTTP ${res.status})
+`);
+        process.exit(1);
+      }
+      index = await res.json();
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`terminalhire refresh: fetch error \u2014 ${msg}
+`);
+      process.exit(1);
+    }
+    const jobs = index?.jobs ?? [];
+    let matchCount = 0;
+    let topMatches = [];
+    try {
+      const { readProfile: readProfile2, profileToFingerprint: profileToFingerprint2 } = await Promise.resolve().then(() => (init_profile(), profile_exports));
+      const { match: match2 } = await Promise.resolve().then(() => (init_src(), src_exports));
+      const profile = await readProfile2();
+      if (profile.skillTags.length > 0 && jobs.length > 0) {
+        const fp = profileToFingerprint2(profile);
+        const results = match2(fp, jobs, jobs.length);
+        matchCount = results.length;
+        topMatches = results.slice(0, 8).map((r) => ({
+          id: r.job.id,
+          title: r.job.title,
+          company: r.job.company,
+          score: r.score,
+          remote: r.job.remote,
+          matchedTags: r.matchedTags
+        }));
+      }
+    } catch {
+    }
+    mkdirSync7(TERMINALHIRE_DIR5, { recursive: true });
+    const cacheEntry = {
+      ts: Date.now(),
+      index,
+      matchCount,
+      topMatches
+    };
+    writeFileSync7(INDEX_CACHE_FILE2, JSON.stringify(cacheEntry), "utf8");
+    try {
+      const {
+        readSpinnerConfig: readSpinnerConfig2,
+        buildSpinnerPool: buildSpinnerPool2,
+        applySpinnerVerbs: applySpinnerVerbs2,
+        clearSpinnerVerbs: clearSpinnerVerbs2,
+        buildTips: buildTips2,
+        applySpinnerTips: applySpinnerTips2,
+        clearSpinnerTips: clearSpinnerTips2,
+        rankBySessionTags: rankBySessionTags2
+      } = await Promise.resolve().then(() => (init_spinner(), spinner_exports));
+      const sc = readSpinnerConfig2();
+      if (sc.enabled) {
+        let sessionTags;
+        try {
+          const { extractFingerprint: extractFingerprint2 } = await Promise.resolve().then(() => (init_signal(), signal_exports));
+          const fp = extractFingerprint2(process.cwd());
+          if (Array.isArray(fp.skillTags) && fp.skillTags.length > 0) {
+            sessionTags = fp.skillTags;
+          }
+        } catch {
+        }
+        const ranked = rankBySessionTags2(topMatches, sessionTags);
+        const verbs = buildSpinnerPool2(ranked, sc.max, { sessionTags, frequency: sc.frequency });
+        if (verbs.length > 0) applySpinnerVerbs2(verbs, sc.mode);
+        else clearSpinnerVerbs2();
+        const tips = buildTips2(ranked, API_URL2, 3);
+        if (tips.length > 0) applySpinnerTips2(tips);
+        else clearSpinnerTips2();
+      } else {
+        clearSpinnerVerbs2();
+        clearSpinnerTips2();
+      }
+    } catch {
+    }
+    process.exit(0);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`terminalhire refresh: unexpected error \u2014 ${msg}
+`);
+    process.exit(1);
+  }
+}
+var __dirname3, TERMINALHIRE_DIR5, INDEX_CACHE_FILE2, API_URL2;
+var init_jpi_refresh = __esm({
+  "bin/jpi-refresh.js"() {
+    "use strict";
+    __dirname3 = fileURLToPath4(new URL(".", import.meta.url));
+    TERMINALHIRE_DIR5 = join10(homedir8(), ".terminalhire");
+    INDEX_CACHE_FILE2 = join10(TERMINALHIRE_DIR5, "index-cache.json");
+    API_URL2 = process.env["TERMINALHIRE_API_URL"] ?? process.env["JPI_API_URL"] ?? "https://terminalhire.com";
+  }
+});
+
+// bin/jpi-save.js
+var jpi_save_exports = {};
+__export(jpi_save_exports, {
+  run: () => run9
+});
+import { readFileSync as readFileSync10, existsSync as existsSync9 } from "fs";
+import { join as join11 } from "path";
+import { homedir as homedir9 } from "os";
+import { fileURLToPath as fileURLToPath5 } from "url";
+function findJobInCache(jobId) {
+  try {
+    if (!existsSync9(INDEX_CACHE_FILE3)) return null;
+    const raw = readFileSync10(INDEX_CACHE_FILE3, "utf8");
+    const entry = JSON.parse(raw);
+    const jobs = entry?.index?.jobs ?? [];
+    return jobs.find((j) => j.id === jobId) ?? null;
+  } catch {
+    return null;
+  }
+}
+async function cmdSave(jobId) {
+  if (!jobId) {
+    console.error("Usage: terminalhire save <jobId>");
+    console.error("  jobId is shown in `terminalhire jobs` output (e.g. greenhouse:abc123)");
+    process.exit(1);
+  }
+  const { addSavedJob: addSavedJob2 } = await Promise.resolve().then(() => (init_profile(), profile_exports));
+  const job = findJobInCache(jobId);
+  if (!job) {
+    console.error(`terminalhire save: job '${jobId}' not found in local index cache.`);
+    console.error("  Run `terminalhire jobs` first to populate the cache.");
+    process.exit(1);
+  }
+  await addSavedJob2({
+    id: job.id,
+    title: job.title,
+    company: job.company,
+    url: job.url,
+    source: job.source,
+    savedAt: (/* @__PURE__ */ new Date()).toISOString()
+    // overwritten by addSavedJob, but required by type
+  });
+  console.log(`Saved: ${job.title} \u2014 ${job.company}`);
+  console.log(`  id: ${job.id}`);
+  console.log(`  url: ${job.url}`);
+  console.log("  Stored locally in encrypted profile. Run `terminalhire saved` to list.");
+}
+async function cmdSaved() {
+  const { listSavedJobs: listSavedJobs2 } = await Promise.resolve().then(() => (init_profile(), profile_exports));
+  const jobs = await listSavedJobs2();
+  if (jobs.length === 0) {
+    console.log("No saved jobs. Use `terminalhire save <jobId>` to save a role.");
+    return;
+  }
+  console.log(`
+${jobs.length} saved job${jobs.length === 1 ? "" : "s"}:
+`);
+  for (const j of jobs) {
+    const date = new Date(j.savedAt).toLocaleDateString();
+    console.log(`  ${j.id}`);
+    console.log(`    ${j.title} \u2014 ${j.company}`);
+    console.log(`    ${j.url}`);
+    console.log(`    Saved: ${date}`);
+    console.log("");
+  }
+  console.log("To remove: terminalhire unsave <jobId>");
+}
+async function cmdUnsave(jobId) {
+  if (!jobId) {
+    console.error("Usage: terminalhire unsave <jobId>");
+    process.exit(1);
+  }
+  const { removeSavedJob: removeSavedJob2 } = await Promise.resolve().then(() => (init_profile(), profile_exports));
+  const removed = await removeSavedJob2(jobId);
+  if (removed) {
+    console.log(`Removed saved job: ${jobId}`);
+  } else {
+    console.error(`terminalhire unsave: job '${jobId}' was not in your saved list.`);
+    process.exit(1);
+  }
+}
+async function run9() {
+  const verb = process.argv[2];
+  const jobId = process.argv[3];
+  try {
+    if (verb === "save") {
+      await cmdSave(jobId);
+    } else if (verb === "saved") {
+      await cmdSaved();
+    } else if (verb === "unsave") {
+      await cmdUnsave(jobId);
+    } else {
+      console.error(`terminalhire: unknown save verb '${verb}'. Expected: save | saved | unsave`);
+      process.exit(1);
+    }
+  } catch (err) {
+    console.error("terminalhire save error:", err.message ?? err);
+    process.exit(1);
+  }
+}
+var __dirname4, TERMINALHIRE_DIR6, INDEX_CACHE_FILE3;
+var init_jpi_save = __esm({
+  "bin/jpi-save.js"() {
+    "use strict";
+    __dirname4 = fileURLToPath5(new URL(".", import.meta.url));
+    TERMINALHIRE_DIR6 = join11(homedir9(), ".terminalhire");
+    INDEX_CACHE_FILE3 = join11(TERMINALHIRE_DIR6, "index-cache.json");
+  }
+});
+
+// bin/jpi-dispatch.js
+import { fileURLToPath as fileURLToPath6 } from "url";
+import { join as join12, dirname as dirname2 } from "path";
+import { existsSync as existsSync10, readFileSync as readFileSync11 } from "fs";
 import { createRequire } from "module";
-var __dirname3 = fileURLToPath4(new URL(".", import.meta.url));
+var __dirname5 = fileURLToPath6(new URL(".", import.meta.url));
 function readPackageVersion() {
   try {
     const candidates = [
-      join8(__dirname3, "..", "..", "package.json"),
-      join8(__dirname3, "..", "package.json")
+      join12(__dirname5, "..", "..", "package.json"),
+      join12(__dirname5, "..", "package.json")
     ];
     for (const p of candidates) {
-      if (existsSync6(p)) {
-        const pkg = JSON.parse(readFileSync7(p, "utf8"));
+      if (existsSync10(p)) {
+        const pkg = JSON.parse(readFileSync11(p, "utf8"));
         if (pkg.version) return pkg.version;
       }
     }
@@ -2432,7 +3123,7 @@ function readPackageVersion() {
 var firstArg = process.argv[2];
 if (!firstArg && !process.stdin.isTTY) {
   const { default: childProcess } = await import("child_process");
-  const nudgeScript = join8(__dirname3, "jpi.js");
+  const nudgeScript = join12(__dirname5, "jpi.js");
   const child = childProcess.spawnSync(process.execPath, [nudgeScript], {
     stdio: ["inherit", "inherit", "inherit"]
   });
@@ -2456,6 +3147,13 @@ if (!firstArg || firstArg === "help" || firstArg === "--help" || firstArg === "-
   console.log("  terminalhire config --nudge always          Nudge every statusLine render");
   console.log("  terminalhire config --nudge every:N         Nudge every Nth render");
   console.log("  terminalhire config --show                  Print current config");
+  console.log("  terminalhire spinner --show                 Job matches in the spinner line while Claude works");
+  console.log("  terminalhire spinner --off                  Turn the spinner job surface off (restores your spinner)");
+  console.log("  terminalhire spinner --mode append|replace  Mix with Claude defaults, or show only matches");
+  console.log("  terminalhire refresh                        Fetch index + match locally, update cache (non-interactive)");
+  console.log("  terminalhire save <jobId>                   Save a job locally (id shown in `jobs` output)");
+  console.log("  terminalhire saved                          List all locally-saved jobs");
+  console.log("  terminalhire unsave <jobId>                 Remove a saved job");
   console.log("");
   console.log("Install / uninstall the Claude Code statusLine nudge:");
   console.log("  terminalhire init               (preferred \u2014 full guided onboarding)");
@@ -2499,10 +3197,25 @@ if (firstArg === "config") {
   await mod.run();
   process.exit(0);
 }
+if (firstArg === "spinner") {
+  const mod = await Promise.resolve().then(() => (init_jpi_spinner(), jpi_spinner_exports));
+  await mod.run();
+  process.exit(0);
+}
 if (firstArg === "init") {
   const mod = await Promise.resolve().then(() => (init_jpi_init(), jpi_init_exports));
   await mod.run();
   process.exit(0);
 }
+if (firstArg === "refresh") {
+  const mod = await Promise.resolve().then(() => (init_jpi_refresh(), jpi_refresh_exports));
+  await mod.run();
+  process.exit(0);
+}
+if (firstArg === "save" || firstArg === "saved" || firstArg === "unsave") {
+  const mod = await Promise.resolve().then(() => (init_jpi_save(), jpi_save_exports));
+  await mod.run();
+  process.exit(0);
+}
 console.error(`terminalhire: unknown command '${firstArg}'. Run 'terminalhire help' for usage.`);
 process.exit(1);