terminalhire 0.1.1 → 0.2.2

package/dist/bin/spinner.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+
+// bin/spinner.js
+import {
+  readFileSync,
+  writeFileSync,
+  existsSync,
+  mkdirSync,
+  renameSync
+} from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+var TH_DIR = process.env["TERMINALHIRE_DIR"] || join(homedir(), ".terminalhire");
+var CLAUDE_SETTINGS = process.env["TERMINALHIRE_CLAUDE_SETTINGS"] || join(homedir(), ".claude", "settings.json");
+var CONFIG_FILE = join(TH_DIR, "config.json");
+var SPINNER_STATE_FILE = join(TH_DIR, "spinner-state.json");
+var SPINNER_DEFAULTS = { enabled: false, mode: "append", max: 6, frequency: "sometimes" };
+function readJson(path, fallback) {
+  try {
+    return existsSync(path) ? JSON.parse(readFileSync(path, "utf8")) : fallback;
+  } catch {
+    return fallback;
+  }
+}
+function atomicWriteJson(path, obj) {
+  mkdirSync(dirname(path), { recursive: true });
+  const tmp = `${path}.tmp-${process.pid}`;
+  writeFileSync(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_FILE, {});
+  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;
+}
+var VERB_INTROS = ["Matched:", "You\u2019d fit:", "Worth a look:", "On your radar:", "Fits your stack:"];
+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 = 8) {
+  const base = String(baseUrl || "https://terminalhire.com").replace(/\/+$/, "");
+  const out = [];
+  const seenRole = /* @__PURE__ */ new Set();
+  const perCompany = /* @__PURE__ */ new Map();
+  const COMPANY_CAP = 2;
+  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 companyRaw = String(m.company).trim().replace(/\s+/g, " ");
+    const titleRaw = String(m.title).trim().replace(/\s+/g, " ");
+    const roleKey = `${titleRaw.toLowerCase()}@${companyRaw.toLowerCase()}`;
+    const coKey = companyRaw.toLowerCase();
+    if (seenRole.has(roleKey)) continue;
+    if ((perCompany.get(coKey) || 0) >= COMPANY_CAP) continue;
+    seenRole.add(roleKey);
+    perCompany.set(coKey, (perCompany.get(coKey) || 0) + 1);
+    let title = titleRaw;
+    if (title.length > 34) title = title.slice(0, 33).trimEnd() + "\u2026";
+    const company = titleCase(companyRaw);
+    const pct = Math.max(1, Math.min(99, Math.round((Number(m.score) || 0) * 100)));
+    const token = Buffer.from(String(m.id)).toString("base64url");
+    const url = `${base}/j/${token}`;
+    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 };
+}
+export {
+  SPINNER_DEFAULTS,
+  applySpinnerTips,
+  applySpinnerVerbs,
+  buildContextVerbs,
+  buildSpinnerPool,
+  buildTips,
+  clearSpinnerTips,
+  clearSpinnerVerbs,
+  ctaVerb,
+  formatVerbs,
+  rankBySessionTags,
+  readSpinnerConfig
+};

package/dist/src/profile.js

@@ -387,6 +387,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 } = await import("fs");
   try {
@@ -416,8 +436,11 @@ export {
   accumulateGitHubTags,
   accumulateSession,
   accumulateTags,
+  addSavedJob,
   deleteProfile,
+  listSavedJobs,
   profileToFingerprint,
   readProfile,
+  removeSavedJob,
   writeProfile
 };

package/install.js

@@ -33,7 +33,7 @@ import {
 } from 'node:fs';
 import { homedir } from 'node:os';
 import { join, resolve, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { createInterface } from 'node:readline';
 import { spawnSync } from 'node:child_process';
 
@@ -49,6 +49,33 @@ const SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
 const SETTINGS_DIR = dirname(SETTINGS_PATH);
 const TERMINALHIRE_DIR = join(homedir(), '.terminalhire');
 const WRAPPER_PATH = join(TERMINALHIRE_DIR, 'statusline-wrapper.sh');
+const CONFIG_FILE = join(TERMINALHIRE_DIR, 'config.json');
+
+// Resolve the spinner module (dist preferred; bin fallback for the dev workspace).
+async function loadSpinnerModule() {
+  const candidates = [
+    resolve(join(__dirname, 'dist', 'bin', 'spinner.js')),
+    resolve(join(__dirname, 'bin', 'spinner.js')),
+  ];
+  for (const c of candidates) {
+    if (existsSync(c)) {
+      try { return await import(pathToFileURL(c).href); } catch { /* try next */ }
+    }
+  }
+  return null;
+}
+
+// Shallow-merge a patch into ~/.terminalhire/config.json.
+function patchConfig(patch) {
+  let cfg = {};
+  try {
+    if (existsSync(CONFIG_FILE)) cfg = JSON.parse(readFileSync(CONFIG_FILE, 'utf8'));
+  } catch {
+    cfg = {};
+  }
+  mkdirSync(TERMINALHIRE_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify({ ...cfg, ...patch }, null, 2) + '\n', 'utf8');
+}
 
 // The existing statusLine command on the user's machine that we must preserve
 const KNOWN_EXISTING_STATUSLINE = 'bash /Users/ericgang/.claude/statusline-command.sh';
@@ -120,10 +147,26 @@ function isOurEntry(statusLine) {
   return false;
 }
 
+/**
+ * Normalize a statusLine value that may be a string or an object
+ * (e.g. {type:"command", command:"..."} from Claude Code's settings).
+ * Returns the shell command string, or null if the value is unusable.
+ */
+function extractCommand(statusLine) {
+  if (!statusLine) return null;
+  if (typeof statusLine === 'string') return statusLine;
+  // Object form: {type: "command", command: "..."}
+  if (typeof statusLine === 'object' && typeof statusLine.command === 'string') {
+    return statusLine.command;
+  }
+  return null;
+}
+
 /**
  * Build the chaining wrapper shell script.
  * Both the existing command and the terminalhire nudge receive the SAME stdin JSON.
  * Output: existing command's output first, then terminalhire's output.
+ * existingCmd MUST be a plain string (call extractCommand first).
  */
 function buildWrapper(existingCmd) {
   return `#!/usr/bin/env bash
@@ -190,6 +233,15 @@ async function install() {
   console.log('  4. Nudge frequency: configurable via `terminalhire config --nudge`.');
   console.log('     Default: once per session. Options: always | every:N.');
   console.log('');
+  console.log('  5. SPINNER JOB SURFACE (enabled by this install):');
+  console.log('     While Claude is working, the spinner line shows your top LOCAL job');
+  console.log('     matches, e.g.  Senior Backend Engineer @ Stripe · 82% …');
+  console.log('     The "tip" line below it shows a ⌘-clickable link to open the listing');
+  console.log('     (a terminalhire.com/j/… redirect — clicks are logged anonymously, no');
+  console.log('     profile data). Uses official `spinnerVerbs`/`spinnerTipsOverride` settings');
+  console.log('     (no patching, Rule 7). Computed locally, zero egress — only public job text.');
+  console.log('     Turn it off any time:  terminalhire spinner --off');
+  console.log('');
   console.log('YOUR LOCAL PROFILE (~/.terminalhire/profile.enc):');
   console.log('  • Encrypted at rest with AES-256-GCM (Node built-in crypto).');
   console.log('  • Key stored at ~/.terminalhire/key (0600) or OS keychain if keytar is installed.');
@@ -219,7 +271,8 @@ async function install() {
   console.log('');
 
   const settings = readSettings();
-  const currentStatusLine = settings.statusLine;
+  // Normalize: settings.statusLine may be a string or an object {type,command}
+  const currentStatusLine = extractCommand(settings.statusLine);
 
   // Already installed?
   if (isOurEntry(currentStatusLine)) {
@@ -257,7 +310,9 @@ async function install() {
   const backupPath = backupSettings();
 
   if (installStrategy === 'direct') {
-    settings.statusLine = buildDirectEntry(BIN_PATH);
+    // Claude Code requires statusLine as an object { type, command } — NOT a bare
+    // string (a string fails schema validation and makes Claude skip ALL settings).
+    settings.statusLine = { type: 'command', command: buildDirectEntry(BIN_PATH) };
     writeSettings(settings);
     console.log('  Set statusLine in ~/.claude/settings.json');
     console.log(`    → node ${BIN_PATH}`);
@@ -269,7 +324,8 @@ async function install() {
     chmodSync(WRAPPER_PATH, 0o755);
     console.log(`  Created wrapper: ${WRAPPER_PATH}`);
 
-    settings.statusLine = `bash ${WRAPPER_PATH}`;
+    // Object form { type, command } — a bare string breaks Claude Code's settings schema.
+    settings.statusLine = { type: 'command', command: `bash ${WRAPPER_PATH}` };
     writeSettings(settings);
     console.log('  Updated statusLine in ~/.claude/settings.json');
     console.log(`    → bash ${WRAPPER_PATH}`);
@@ -280,6 +336,29 @@ async function install() {
     console.log(`  Backup: ${backupPath}`);
   }
 
+  // Enable the spinner job surface as part of this single consented install
+  // (Rule 10, amended: install IS the opt-in). Best-effort — never blocks install.
+  try {
+    patchConfig({ spinner: { enabled: true, mode: 'replace', max: 6 } });
+    const spinnerMod = await loadSpinnerModule();
+    if (spinnerMod) {
+      let topMatches = [];
+      try {
+        const cache = JSON.parse(readFileSync(join(TERMINALHIRE_DIR, 'index-cache.json'), 'utf8'));
+        if (Array.isArray(cache.topMatches)) topMatches = cache.topMatches;
+      } catch { /* no cache yet — monitor will populate it */ }
+      const verbs = spinnerMod.buildSpinnerPool(topMatches, 6);
+      if (verbs.length > 0) spinnerMod.applySpinnerVerbs(verbs, 'replace');
+      console.log(
+        '  Spinner job surface: ENABLED' +
+        (verbs.length
+          ? ` (${verbs.length} match${verbs.length === 1 ? '' : 'es'} live now)`
+          : ' (matches appear after the first background refresh)')
+      );
+      console.log('    Turn off any time: terminalhire spinner --off');
+    }
+  } catch { /* spinner is best-effort; never block the install */ }
+
   console.log('');
   console.log('Done. Restart Claude Code to activate the status bar nudge.');
   console.log('');
@@ -359,6 +438,19 @@ async function uninstall() {
     } catch { /* ignore */ }
   }
 
+  // Remove the spinner job verbs we injected (preserving any the user set themselves).
+  try {
+    patchConfig({ spinner: { enabled: false } });
+    const spinnerMod = await loadSpinnerModule();
+    if (spinnerMod) {
+      const res = spinnerMod.clearSpinnerVerbs();
+      console.log(
+        '  Removed spinner job verbs' +
+        (res && res.keptUserVerbs ? ` (kept ${res.keptUserVerbs} of your own)` : '') + '.'
+      );
+    }
+  } catch { /* best-effort */ }
+
   console.log('');
   console.log('  Your profile is untouched. To also delete it:');
   console.log('    terminalhire profile --delete');

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "terminalhire",
-  "version": "0.1.1",
-  "description": "Local-first job matching for developers — Claude Code statusLine integration",
+  "version": "0.2.2",
+  "description": "Local-first job matching for developers — Claude Code statusLine nudge and ambient spinner job surface",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/staqsIO/terminalhire.git"
+  },
+  "homepage": "https://terminalhire.com",
+  "bugs": {
+    "url": "https://github.com/staqsIO/terminalhire/issues"
+  },
   "type": "module",
   "engines": {
     "node": ">=18"
@@ -19,6 +27,7 @@
   ],
   "scripts": {
     "build": "tsup",
+    "bundle:plugin": "npm run build && rm -rf ../../plugins/terminalhire/dist && cp -R dist ../../plugins/terminalhire/dist && cp package.json ../../plugins/terminalhire/dist/package.json",
     "prepublishOnly": "npm run build",
     "install-hook": "node install.js",
     "postinstall": "node ./postinstall.js"
@@ -33,7 +42,8 @@
     "claude",
     "claude-code",
     "job-matching",
-    "local-first"
+    "local-first",
+    "spinner"
   ],
   "author": "staqs",
   "license": "MIT",