terminalhire 0.18.1 → 0.19.0

package/README.md

@@ -1,6 +1,6 @@
-# terminalhire — local-first job matching for developers
+# terminalhire — your code is your résumé
 
-Pull curated job matches from a broad public pool. Matching runs entirely on your device. Your profile never leaves your machine.
+Local-first job + bounty matching, and a verifiable **Proof of Work** credential earned from PRs that maintainers who aren't you merged into established repos — checkable on GitHub, impossible to self-report. Matching runs entirely on your device. Your profile never leaves your machine.
 
 **Domain:** [terminalhire.com](https://terminalhire.com)
 
@@ -47,6 +47,7 @@ terminalhire jobs --all         # show all matches above zero score
 
 terminalhire bounties           # day-sized paid tasks you can knock out today
 terminalhire bounties --priced  # only bounties with a known $ amount
+terminalhire contribute         # credential-building issues matched to your stack — merges grow your Proof of Work
 
 terminalhire claim record <id|issueUrl>  # claim a bounty locally + print the executor brief
 terminalhire claim list --active         # list your active claims + accepted-PR rate
@@ -56,6 +57,11 @@ terminalhire trajectory         # trajectory from your local Claude Code corpus
 terminalhire trajectory --export  # write a derived score + Markdown to ~/.terminalhire/
 terminalhire trajectory --inward  # also show private rework/recovery (never exported)
 
+terminalhire devs               # opted-in peers & founders, matched 100% locally
+terminalhire intro <login>      # request a double-opt-in intro (typed-yes consent)
+terminalhire inbox              # unread chats, connections & pending intros in one place
+terminalhire mcp --print-config # read-only MCP server config for VS Code/Cursor/Codex/Zed/JetBrains
+
 terminalhire profile --show     # inspect your encrypted local profile (incl. GitHub fields)
 terminalhire profile --edit     # set displayName, contactEmail, prefs
 terminalhire profile --delete   # wipe profile and encryption key from disk

package/dist/bin/jpi-bounties.js

@@ -391,6 +391,11 @@ ${body}`;
   for (const tok of tokens) {
     const r = resolveToken(tok);
     if (!r) continue;
+    const synGate = AMBIGUOUS_SYNONYM[tok] ?? AMBIGUOUS_SYNONYM[tok.replace(/^[.\-+#]+|[.\-+#]+$/g, "")];
+    if (synGate && r.id === synGate.id) {
+      if (synGate.cue.test(text)) ids.add(r.id);
+      continue;
+    }
     if (NON_EXTRACTABLE.has(r.id)) continue;
     if (SYNONYM_ONLY.has(r.id) && !r.viaSynonym) continue;
     const cue = AMBIGUOUS[r.id];
@@ -408,7 +413,7 @@ ${body}`;
 function coreTagsFromTitle(title) {
   return extractSkillTags(title, "").filter((t) => !SOFT_DOMAIN.has(t));
 }
-var SOFT_DOMAIN, SYNONYM_ONLY, NON_EXTRACTABLE, AMBIGUOUS, ENG_INTENT, NON_ENG_TITLE;
+var SOFT_DOMAIN, SYNONYM_ONLY, NON_EXTRACTABLE, AMBIGUOUS, AMBIGUOUS_SYNONYM, ENG_INTENT, NON_ENG_TITLE;
 var init_extract = __esm({
   "../../packages/core/src/vocab/extract.ts"() {
     "use strict";
@@ -445,6 +450,16 @@ var init_extract = __esm({
       r: /\b(rstudio|tidyverse|ggplot|shiny|dplyr|cran|r-lang|rlang)\b/i,
       ml: /\b(machine[\s-]?learning|pytorch|tensorflow|scikit|sklearn|keras|neural|model training|deep[\s-]?learning|numpy|pandas|ml\s+(?:engineer|platform|researcher|infrastructure)|(?:ml|ai)\s+research)\b/i
     };
+    AMBIGUOUS_SYNONYM = {
+      // "prompt" is the LLM skill only in AI context. In raw JD prose it is "prompt
+      // delivery / response / payment / communication / attention". Accept only with
+      // the explicit "prompt engineering" phrase OR an LLM/AI ecosystem cue; the cue
+      // deliberately excludes the bare word "prompt(s)" itself so it can't self-satisfy.
+      prompt: {
+        id: "prompt-engineering",
+        cue: /\bprompt[\s-]?engineer(?:ing|s)?\b|\b(llms?|gpt-?[0-9o]*|claude|gemini|llama|mistral|openai|anthropic|langchain|llama[\s-]?index|rag|retrieval[\s-]?augmented|embeddings?|fine[\s-]?tun(?:e|ed|ing)|vector[\s-]?(?:db|database|store)|agentic|ai agents?|chatbots?|generative ai|gen[\s-]?ai|genai|few[\s-]?shot|zero[\s-]?shot)\b/i
+      }
+    };
     ENG_INTENT = /\b(engineer|engineering|developer|dev\b|swe|sde|programmer|architect|full[\s-]?stack|front[\s-]?end|back[\s-]?end|devops|sre|software|coding|codebase|technical staff|tech(?:nical)? lead)\b/i;
     NON_ENG_TITLE = /\b(account executive|account manager|sales (?:rep|representative|development|manager|lead)|sdr|bdr|recruiter|recruiting|talent|marketing|administrative|business partner|billing coordinator|operations (?:administrator|coordinator)|customer success|project finance|controller|bookkeeper|graphic|brand)\b/i;
   }
@@ -1166,9 +1181,26 @@ function harmonicMean(a, b) {
   if (a <= 0 || b <= 0) return 0;
   return 2 * a * b / (a + b);
 }
+function mergeSoftCoverage(covMap, softTags, cap) {
+  for (const st of softTags) {
+    const w = Math.max(0, Math.min(1, st.weight)) * cap;
+    for (const [tag, hit] of expandWeighted([st.tag])) {
+      const scaled = hit.weight * w;
+      const existing = covMap.get(tag);
+      if (!existing || scaled > existing.weight) {
+        covMap.set(tag, {
+          weight: existing ? Math.max(existing.weight, scaled) : scaled,
+          via: existing?.via ?? st.tag
+        });
+      }
+    }
+  }
+  return covMap;
+}
 function match(fp, jobs, limit = 5, now = Date.now(), opts = {}) {
   const idfOf = backgroundIdf;
   const expanded = expandWeighted(fp.skillTags);
+  const covMap = opts.softTags && opts.softTags.length > 0 ? mergeSoftCoverage(new Map(expanded), opts.softTags, INTEREST_CAP) : expanded;
   const maxDevScore = fp.skillTags.reduce((acc, t) => acc + idfOf(t), 0);
   const candidates = jobs.filter((j) => passesFilters(fp, j));
   const scored = candidates.map((job) => {
@@ -1179,12 +1211,13 @@ function match(fp, jobs, limit = 5, now = Date.now(), opts = {}) {
     for (const tag of job.tags) {
       const w = idfOf(tag);
       jobMaxScore += w;
-      const hit = expanded.get(tag);
-      if (hit) {
-        const credit = Math.pow(hit.weight, SHARPEN);
-        jobMatchScore += w * credit;
-        details.push({ tag, weight: hit.weight, via: hit.via });
-        if (credit > (devCovByTag.get(hit.via) ?? 0)) devCovByTag.set(hit.via, credit);
+      const covHit = covMap.get(tag);
+      if (covHit) jobMatchScore += w * Math.pow(covHit.weight, SHARPEN);
+      const fpHit = expanded.get(tag);
+      if (fpHit) {
+        const credit = Math.pow(fpHit.weight, SHARPEN);
+        details.push({ tag, weight: fpHit.weight, via: fpHit.via });
+        if (credit > (devCovByTag.get(fpHit.via) ?? 0)) devCovByTag.set(fpHit.via, credit);
       }
     }
     let devScore = 0;
@@ -1222,7 +1255,7 @@ function match(fp, jobs, limit = 5, now = Date.now(), opts = {}) {
     return byScore;
   }).slice(0, limit);
 }
-var MIN_SCORE, TIEBREAK_EPS, SHARPEN, CORE_MISS_PENALTY, SENIORITY_RANK, SENIORITY_PATTERNS, ENG_TITLE, UNKNOWN_RECENCY;
+var MIN_SCORE, TIEBREAK_EPS, SHARPEN, CORE_MISS_PENALTY, INTEREST_CAP, SENIORITY_RANK, SENIORITY_PATTERNS, ENG_TITLE, UNKNOWN_RECENCY;
 var init_matcher = __esm({
   "../../packages/core/src/matcher.ts"() {
     "use strict";
@@ -1232,6 +1265,7 @@ var init_matcher = __esm({
     TIEBREAK_EPS = 5e-3;
     SHARPEN = 1.6;
     CORE_MISS_PENALTY = 0.4;
+    INTEREST_CAP = 0.6;
     SENIORITY_RANK = {
       junior: 0,
       mid: 1,
@@ -1249,6 +1283,54 @@ var init_matcher = __esm({
   }
 });
 
+// ../../packages/core/src/rerank.ts
+function jaccardSim(a, b) {
+  if (a.size === 0 && b.size === 0) return 1;
+  let inter = 0;
+  for (const x of a) if (b.has(x)) inter++;
+  const union = a.size + b.size - inter;
+  return union === 0 ? 1 : inter / union;
+}
+function tagDissimilarity(a, b) {
+  return 1 - jaccardSim(new Set(a.job.tags ?? []), new Set(b.job.tags ?? []));
+}
+function mmrRerank(results, opts = {}) {
+  const lambda = opts.lambda ?? 0.7;
+  const k = opts.k ?? 8;
+  const simOf = opts.simOf ?? tagDissimilarity;
+  if (results.length < 2 || k < 2) return results.slice();
+  let maxScore = 0;
+  for (const r of results) if (r.score > maxScore) maxScore = r.score;
+  const relNorm = (r) => maxScore > 0 ? r.score / maxScore : 0;
+  const remaining = results.slice();
+  const selected = [];
+  const window = Math.min(k, remaining.length);
+  for (let pos = 0; pos < window; pos++) {
+    let bestIdx = 0;
+    let bestObj = -Infinity;
+    for (let i = 0; i < remaining.length; i++) {
+      const cand = remaining[i];
+      let minDissim = selected.length === 0 ? 0 : Infinity;
+      for (const s of selected) {
+        const d = simOf(cand, s);
+        if (d < minDissim) minDissim = d;
+      }
+      const obj = lambda * relNorm(cand) + (1 - lambda) * minDissim;
+      if (obj > bestObj) {
+        bestObj = obj;
+        bestIdx = i;
+      }
+    }
+    selected.push(remaining.splice(bestIdx, 1)[0]);
+  }
+  return [...selected, ...remaining];
+}
+var init_rerank = __esm({
+  "../../packages/core/src/rerank.ts"() {
+    "use strict";
+  }
+});
+
 // ../../packages/core/src/feeds/http.ts
 function fetchWithTimeout(input, init, timeoutMs = FEED_FETCH_TIMEOUT_MS) {
   return fetch(input, { ...init, signal: AbortSignal.timeout(timeoutMs) });
@@ -2660,6 +2742,55 @@ var init_feeds = __esm({
   }
 });
 
+// ../../packages/core/src/feeds/contribution-classify.ts
+function hasStrongCodeSignal(title, body, labels) {
+  if (labels.some((l) => CODE_LABEL_RE.test(l))) return true;
+  const text = `${title}
+${body}`;
+  if (CODE_TERM_RE.test(text)) return true;
+  if (CODE_EXCEPTION_RE.test(text)) return true;
+  if (CODE_FENCE_RE.test(body)) return true;
+  if (FILE_PATH_RE.test(text)) return true;
+  return false;
+}
+function hasContentSignal(title, body, labels) {
+  if (labels.some((l) => CONTENT_LABEL_RE.test(l))) return true;
+  const text = `${title}
+${body}`;
+  if (CONTENT_ADD_RE.test(text)) return true;
+  if (ADD_TO_CORPUS_RE.test(text)) return true;
+  if (TRANSLATE_RE.test(text)) return true;
+  if (TYPO_RE.test(text)) return true;
+  return false;
+}
+function classifyContributionKind(input) {
+  const title = input.title ?? "";
+  const body = input.body ?? "";
+  const labels = input.labels ?? [];
+  if (hasStrongCodeSignal(title, body, labels)) return "code";
+  if (hasContentSignal(title, body, labels)) return "content";
+  return "ambiguous";
+}
+function looksLikeContentTask(input) {
+  return classifyContributionKind(input) === "content";
+}
+var CONTENT_LABEL_RE, CODE_LABEL_RE, CODE_TERM_RE, CODE_EXCEPTION_RE, CODE_FENCE_RE, FILE_PATH_RE, CONTENT_ADD_RE, ADD_TO_CORPUS_RE, TRANSLATE_RE, TYPO_RE;
+var init_contribution_classify = __esm({
+  "../../packages/core/src/feeds/contribution-classify.ts"() {
+    "use strict";
+    CONTENT_LABEL_RE = /\b(content|copy|copywriting|wording|translation|translations|i18n|l10n|localization|localisation|data|dataset|documentation|docs)\b/i;
+    CODE_LABEL_RE = /\b(bug|bugfix|fix|enhancement|feature|refactor|refactoring|test|tests|testing|performance|perf|security|api|backend|frontend|typescript|javascript|golang|rust|python|build|ci)\b/i;
+    CODE_TERM_RE = /\b(bug|crash|crashes|crashing|exception|stack\s?trace|stacktrace|null\s?pointer|npe|segfault|refactor|implement|endpoint|api|component|function|method|class|module|compile|compiler|build\s+(?:error|fail)|runtime|regression|unit\s+test|integration\s+test|test\s+coverage|typecheck|lint|dependency|dependencies|import|async|await|race\s+condition|memory\s+leak|deadlock|parser|serialize|deserialize|schema|migration|websocket|http|json|sql|cli|sdk)\b/i;
+    CODE_EXCEPTION_RE = /exception|stacktrace|segfault|traceback/i;
+    CODE_FENCE_RE = /```|(?:^|\n)\s{4,}\S/;
+    FILE_PATH_RE = /\b[\w./-]+\.(?:ts|tsx|js|jsx|mjs|cjs|py|rb|go|rs|java|kt|scala|c|cc|cpp|cxx|h|hpp|cs|php|swift|m|mm|sh|bash|zsh|sql|graphql|proto|css|scss|sass|less|vue|svelte|toml|ini|gradle|dockerfile)\b/i;
+    CONTENT_ADD_RE = /\badd(?:ing|s)?\s+(?:\w+\s+){0,4}?(?:proverbs?|words?|phrases?|sayings?|quotes?|quotations?|translations?|entry|entries|definitions?|terms?|idioms?|synonyms?|antonyms?|acronyms?|abbreviations?)\b/i;
+    ADD_TO_CORPUS_RE = /\badd\b[\s\S]*?\bto\s+(?:the\s+)?(?:word\s?list|dictionary|glossary|phrasebook)\b/i;
+    TRANSLATE_RE = /\b(?:translate|translating|translation|localize|localise|localization|localisation)\b/i;
+    TYPO_RE = /\bfix(?:ing)?\s+(?:a\s+|the\s+|some\s+)?typos?\b/i;
+  }
+});
+
 // ../../packages/core/src/feeds/contributions.ts
 function authHeaders2() {
   const token = process.env["GITHUB_TOKEN"] ?? process.env["GH_TOKEN"];
@@ -2716,11 +2847,11 @@ async function contributorCount(client, fullName) {
   }
 }
 async function openPRIssueRefs(client, fullName) {
-  const refs = /* @__PURE__ */ new Set();
   const prs = await client.json(
     `/repos/${fullName}/pulls?state=open&per_page=100`
   );
-  if (!Array.isArray(prs)) return refs;
+  if (!Array.isArray(prs)) return null;
+  const refs = /* @__PURE__ */ new Set();
   for (const pr of prs) {
     for (const m of `${pr.title ?? ""}
 ${pr.body ?? ""}`.matchAll(/#(\d+)\b/g)) {
@@ -2765,8 +2896,7 @@ async function aggregateContributions(opts = {}) {
     return n;
   }
   async function repoPRRefs(fullName) {
-    const hit = prRefsCache.get(fullName);
-    if (hit !== void 0) return hit;
+    if (prRefsCache.has(fullName)) return prRefsCache.get(fullName) ?? null;
     const refs = await openPRIssueRefs(client, fullName);
     prRefsCache.set(fullName, refs);
     return refs;
@@ -2798,10 +2928,12 @@ async function aggregateContributions(opts = {}) {
       continue;
     }
     if (repo.disabled) continue;
-    const prRefs = await repoPRRefs(fullName);
-    if (prRefs.has(issue.number)) continue;
     const body = issue.body ? decodeEntities(issue.body) : "";
     const labels = labelNames2(issue.labels);
+    if (looksLikeContentTask({ title, body, labels })) continue;
+    const prRefs = await repoPRRefs(fullName);
+    if (prRefs && prRefs.has(issue.number)) continue;
+    const openPRsAtDiscovery = prRefs ? 0 : void 0;
     const tags = normalize(
       tokenize4([title, repo.language ?? "", labels.join(" "), body.slice(0, 2e3)].join(" "))
     );
@@ -2827,7 +2959,14 @@ async function aggregateContributions(opts = {}) {
         issueNumber: issue.number,
         labels,
         issueUrl: issue.html_url,
-        issueBody: body.slice(0, 1e3) || void 0
+        issueBody: body.slice(0, 1e3) || void 0,
+        // Provably 0 open PRs at discovery ONLY when the open-PR check actually
+        // ran and returned a verified-empty/non-matching set (`openPRsAtDiscovery
+        // === 0`). When the check FAILED (rate-limit/error → `prRefs === null`)
+        // this is `undefined`, NOT a fabricated 0 — the claim path then falls
+        // through to a live re-count / honest "unknown" (jpi-claim.js:242-260)
+        // instead of persisting an unverified "0 open PRs" as fact.
+        openPRsAtDiscovery
       },
       raw: issue
     });
@@ -2842,6 +2981,7 @@ var init_contributions = __esm({
     init_entities();
     init_bounty_gate();
     init_contribution_gate();
+    init_contribution_classify();
     init_github_bounties();
     init_http();
     GITHUB_API2 = "https://api.github.com";
@@ -6179,7 +6319,7 @@ function funnelCounts(map) {
   for (const key of Object.keys(map)) {
     const rec = map[key];
     if (rec.clicked === true) counts.clicked++;
-    if (rec.status) counts[rec.status]++;
+    if (rec.status && Object.prototype.hasOwnProperty.call(counts, rec.status)) counts[rec.status]++;
   }
   return counts;
 }
@@ -6496,6 +6636,7 @@ __export(src_exports, {
   GRAPH: () => GRAPH,
   GREENHOUSE_SLUGS_BY_TIER: () => GREENHOUSE_SLUGS_BY_TIER,
   IDF_BACKGROUND: () => IDF_BACKGROUND,
+  INTEREST_CAP: () => INTEREST_CAP,
   INTRO_ACCEPTED_TTL_MS: () => INTRO_ACCEPTED_TTL_MS,
   INTRO_ALLOWED_FIELDS: () => INTRO_ALLOWED_FIELDS,
   INTRO_PENDING_TTL_MS: () => INTRO_PENDING_TTL_MS,
@@ -6565,6 +6706,7 @@ __export(src_exports, {
   loadPartnerRoles: () => loadPartnerRoles,
   looksLikeEngRole: () => looksLikeEngRole,
   match: () => match,
+  mmrRerank: () => mmrRerank,
   normalize: () => normalize,
   opire: () => opire,
   opportunityShortToken: () => opportunityShortToken,
@@ -6580,6 +6722,7 @@ __export(src_exports, {
   sameLogin: () => sameLogin,
   setStatus: () => setStatus,
   signalLabel: () => signalLabel,
+  tagDissimilarity: () => tagDissimilarity,
   tokenize: () => tokenize,
   validateGraph: () => validateGraph,
   validateIntroPayload: () => validateIntroPayload,
@@ -6593,6 +6736,7 @@ var init_src = __esm({
     init_types();
     init_vocabulary();
     init_matcher();
+    init_rerank();
     init_feeds();
     init_indexer();
     init_partners();

package/dist/bin/jpi-chat-read.js

@@ -482,6 +482,13 @@ var init_matcher = __esm({
   }
 });
 
+// ../../packages/core/src/rerank.ts
+var init_rerank = __esm({
+  "../../packages/core/src/rerank.ts"() {
+    "use strict";
+  }
+});
+
 // ../../packages/core/src/feeds/http.ts
 var init_http = __esm({
   "../../packages/core/src/feeds/http.ts"() {
@@ -736,6 +743,13 @@ var init_feeds = __esm({
   }
 });
 
+// ../../packages/core/src/feeds/contribution-classify.ts
+var init_contribution_classify = __esm({
+  "../../packages/core/src/feeds/contribution-classify.ts"() {
+    "use strict";
+  }
+});
+
 // ../../packages/core/src/feeds/contributions.ts
 var init_contributions = __esm({
   "../../packages/core/src/feeds/contributions.ts"() {
@@ -744,6 +758,7 @@ var init_contributions = __esm({
     init_entities();
     init_bounty_gate();
     init_contribution_gate();
+    init_contribution_classify();
     init_github_bounties();
     init_http();
   }
@@ -3912,6 +3927,7 @@ var init_src = __esm({
     init_types();
     init_vocabulary();
     init_matcher();
+    init_rerank();
     init_feeds();
     init_indexer();
     init_partners();
@@ -4389,7 +4405,8 @@ var init_config = __esm({
       inboundNudgeMuted: false,
       inboundNudgeDisclosed: false,
       contributeEnabled: false,
-      contributePrompted: false
+      contributePrompted: false,
+      betaOptIn: false
     };
   }
 });

package/dist/bin/jpi-chat.js

@@ -499,6 +499,13 @@ var init_matcher = __esm({
   }
 });
 
+// ../../packages/core/src/rerank.ts
+var init_rerank = __esm({
+  "../../packages/core/src/rerank.ts"() {
+    "use strict";
+  }
+});
+
 // ../../packages/core/src/feeds/http.ts
 var init_http = __esm({
   "../../packages/core/src/feeds/http.ts"() {
@@ -753,6 +760,13 @@ var init_feeds = __esm({
   }
 });
 
+// ../../packages/core/src/feeds/contribution-classify.ts
+var init_contribution_classify = __esm({
+  "../../packages/core/src/feeds/contribution-classify.ts"() {
+    "use strict";
+  }
+});
+
 // ../../packages/core/src/feeds/contributions.ts
 var init_contributions = __esm({
   "../../packages/core/src/feeds/contributions.ts"() {
@@ -761,6 +775,7 @@ var init_contributions = __esm({
     init_entities();
     init_bounty_gate();
     init_contribution_gate();
+    init_contribution_classify();
     init_github_bounties();
     init_http();
   }
@@ -3940,6 +3955,7 @@ var init_src = __esm({
     init_types();
     init_vocabulary();
     init_matcher();
+    init_rerank();
     init_feeds();
     init_indexer();
     init_partners();
@@ -4417,7 +4433,8 @@ var init_config = __esm({
       inboundNudgeMuted: false,
       inboundNudgeDisclosed: false,
       contributeEnabled: false,
-      contributePrompted: false
+      contributePrompted: false,
+      betaOptIn: false
     };
   }
 });