terminalhire 0.27.0 → 0.29.0

package/dist/bin/claim-push-bg.js

@@ -285,6 +285,7 @@ function decrypt(blob, key) {
 var TERMINALHIRE_DIR3 = process.env.TERMINALHIRE_DIR || join3(homedir3(), ".terminalhire");
 var CLAIM_PUSH_AUTO_MARKER = join3(TERMINALHIRE_DIR3, "claim-push-auto.json");
 var CLAIM_PUSH_TOKEN_FILE = join3(TERMINALHIRE_DIR3, "claim-push-token.enc");
+var CLAIM_PUSH_MANUAL_MARKER = join3(TERMINALHIRE_DIR3, "claim-push.json");
 var CLAIM_SYNC_BASE = "https://terminalhire.com";
 var AUTO_CONSENT_VERSION = 2;
 var AUTO_PUSH_THROTTLE_MS = 24 * 60 * 60 * 1e3;
@@ -352,6 +353,43 @@ function backgroundPushGate(params) {
   }
   return { push: true, reason: "ok" };
 }
+function unpushedNudgeGate(params) {
+  const {
+    autoMarkerExists,
+    tokenFileExists,
+    manualMarkerExists,
+    lastSnapshotHash,
+    currentHash,
+    claimCount
+  } = params;
+  if (autoMarkerExists && tokenFileExists) return false;
+  if (!manualMarkerExists) return false;
+  if (!(claimCount > 0)) return false;
+  return lastSnapshotHash !== currentHash;
+}
+async function shouldNudgeUnpushed() {
+  try {
+    const { listClaims: listClaims2, toPushedClaim: toPushedClaim2 } = await Promise.resolve().then(() => (init_claims(), claims_exports));
+    const pushed = listClaims2().map((c) => toPushedClaim2(c));
+    const currentHash = computeSnapshotHash(pushed);
+    let manual = null;
+    try {
+      manual = existsSync3(CLAIM_PUSH_MANUAL_MARKER) ? JSON.parse(readFileSync3(CLAIM_PUSH_MANUAL_MARKER, "utf8")) : null;
+    } catch {
+      manual = null;
+    }
+    return unpushedNudgeGate({
+      autoMarkerExists: existsSync3(CLAIM_PUSH_AUTO_MARKER),
+      tokenFileExists: existsSync3(CLAIM_PUSH_TOKEN_FILE),
+      manualMarkerExists: !!manual,
+      lastSnapshotHash: manual?.lastSnapshotHash ?? null,
+      currentHash,
+      claimCount: pushed.length
+    });
+  } catch {
+    return false;
+  }
+}
 async function runBackgroundClaimPush({ now = Date.now() } = {}) {
   try {
     if (!existsSync3(CLAIM_PUSH_AUTO_MARKER) || !existsSync3(CLAIM_PUSH_TOKEN_FILE)) return;
@@ -396,6 +434,7 @@ export {
   AUTO_CONSENT_VERSION,
   AUTO_PUSH_THROTTLE_MS,
   CLAIM_PUSH_AUTO_MARKER,
+  CLAIM_PUSH_MANUAL_MARKER,
   CLAIM_PUSH_TOKEN_FILE,
   backgroundPushGate,
   clearAutoMarker,
@@ -404,6 +443,8 @@ export {
   readAutoMarker,
   readPushTokenEnc,
   runBackgroundClaimPush,
+  shouldNudgeUnpushed,
+  unpushedNudgeGate,
   writeAutoMarker,
   writePushTokenEnc
 };

package/dist/bin/jpi-claim.js

@@ -8616,6 +8616,7 @@ function encrypt(plaintext, key) {
 var TERMINALHIRE_DIR3 = process.env.TERMINALHIRE_DIR || join4(homedir3(), ".terminalhire");
 var CLAIM_PUSH_AUTO_MARKER = join4(TERMINALHIRE_DIR3, "claim-push-auto.json");
 var CLAIM_PUSH_TOKEN_FILE = join4(TERMINALHIRE_DIR3, "claim-push-token.enc");
+var CLAIM_PUSH_MANUAL_MARKER = join4(TERMINALHIRE_DIR3, "claim-push.json");
 var AUTO_CONSENT_VERSION = 2;
 var AUTO_PUSH_THROTTLE_MS = 24 * 60 * 60 * 1e3;
 async function writePushTokenEnc(rawToken) {
@@ -8643,6 +8644,43 @@ function clearAutoMarker() {
 function computeSnapshotHash(pushed) {
   return createHash3("sha256").update(JSON.stringify(pushed)).digest("hex");
 }
+function unpushedNudgeGate(params) {
+  const {
+    autoMarkerExists,
+    tokenFileExists,
+    manualMarkerExists,
+    lastSnapshotHash,
+    currentHash,
+    claimCount
+  } = params;
+  if (autoMarkerExists && tokenFileExists) return false;
+  if (!manualMarkerExists) return false;
+  if (!(claimCount > 0)) return false;
+  return lastSnapshotHash !== currentHash;
+}
+async function shouldNudgeUnpushed() {
+  try {
+    const { listClaims: listClaims2, toPushedClaim: toPushedClaim2 } = await Promise.resolve().then(() => (init_claims(), claims_exports));
+    const pushed = listClaims2().map((c) => toPushedClaim2(c));
+    const currentHash = computeSnapshotHash(pushed);
+    let manual = null;
+    try {
+      manual = existsSync3(CLAIM_PUSH_MANUAL_MARKER) ? JSON.parse(readFileSync4(CLAIM_PUSH_MANUAL_MARKER, "utf8")) : null;
+    } catch {
+      manual = null;
+    }
+    return unpushedNudgeGate({
+      autoMarkerExists: existsSync3(CLAIM_PUSH_AUTO_MARKER),
+      tokenFileExists: existsSync3(CLAIM_PUSH_TOKEN_FILE),
+      manualMarkerExists: !!manual,
+      lastSnapshotHash: manual?.lastSnapshotHash ?? null,
+      currentHash,
+      claimCount: pushed.length
+    });
+  } catch {
+    return false;
+  }
+}
 
 // bin/jpi-claim.js
 var TERMINALHIRE_DIR6 = process.env.TERMINALHIRE_DIR || join7(homedir6(), ".terminalhire");
@@ -8882,6 +8920,10 @@ ${p.body ?? ""}`)) {
   }
   return matched;
 }
+function selectCompetingPrs(prs, selfLogin) {
+  if (!Array.isArray(prs)) return [];
+  return prs.filter((pr) => pr && pr.author !== selfLogin);
+}
 async function listOpenPRsReferencingIssue(repoFullName, issueNumber) {
   try {
     const res = await fetch(`${GH_API2}/repos/${repoFullName}/pulls?state=open&per_page=100`, {
@@ -8947,6 +8989,67 @@ async function fetchIssue(repoFullName, issueNumber) {
     return null;
   }
 }
+var ASSIGNMENT_MARKER = "<!-- terminalhire:assignment-request -->";
+var TAKE_BOT_REPOS = /* @__PURE__ */ new Set(["paradedb/paradedb"]);
+function buildAssignmentComment(repoFullName) {
+  const usesTakeBot = TAKE_BOT_REPOS.has(repoFullName.toLowerCase());
+  const body = usesTakeBot ? "/take" : `I'd like to work on this \u2014 could I be assigned? Thanks!
+
+${ASSIGNMENT_MARKER}`;
+  return { usesTakeBot, body };
+}
+async function hasPriorAssignmentRequest(repoFullName, issueNumber, login) {
+  try {
+    const res = await fetch(
+      `${GH_API2}/repos/${repoFullName}/issues/${issueNumber}/comments?per_page=100&sort=created&direction=desc`,
+      { headers: GH_HEADERS2, signal: AbortSignal.timeout(1e4) }
+    );
+    if (!res.ok) return false;
+    const comments = await res.json();
+    if (!Array.isArray(comments)) return false;
+    return comments.some(
+      (c) => c && c.user && c.user.login === login && typeof c.body === "string" && c.body.includes(ASSIGNMENT_MARKER)
+    );
+  } catch {
+    return false;
+  }
+}
+async function requestIssueAssignment(claim, flags = {}, ghUser) {
+  if (flags["no-assign"]) {
+    console.log("  (--no-assign \u2014 skipping the assignment request; request it manually before working)");
+    return;
+  }
+  const parsed = parseGitHubUrl(claim.issueUrl);
+  if (!parsed) return;
+  const { repoFullName, number } = parsed;
+  let login = ghUser;
+  if (!login) {
+    try {
+      login = await sh("gh", ["api", "user", "-q", ".login"]);
+    } catch {
+      console.log("  (assignment not requested: 'gh' not authenticated \u2014 comment on the issue manually before working)");
+      return;
+    }
+  }
+  const issue = await fetchIssue(repoFullName, number);
+  if (issue && issue.assignees.includes(login)) {
+    console.log(`  \u2713 Already assigned to @${login} on ${repoFullName}#${number}.`);
+    return;
+  }
+  const { usesTakeBot, body } = buildAssignmentComment(repoFullName);
+  if (!usesTakeBot && await hasPriorAssignmentRequest(repoFullName, number, login)) {
+    console.log(`  \u2713 Assignment already requested on ${repoFullName}#${number}.`);
+    return;
+  }
+  try {
+    await sh("gh", ["issue", "comment", String(number), "--repo", repoFullName, "--body", body]);
+    console.log(
+      usesTakeBot ? `  \u2713 Requested assignment via /take on ${repoFullName}#${number}.` : `  \u2713 Requested assignment on ${repoFullName}#${number}.`
+    );
+  } catch (err) {
+    console.log(`  (could not post the assignment request: ${err.stderr || err.message || err} \u2014 do it manually before working)`);
+  }
+}
 async function pollPR(prUrl) {
   const p = parseGitHubUrl(prUrl);
   if (!p) return null;
@@ -9237,6 +9340,12 @@ ${list.length} ${active ? "active " : ""}claim${list.length === 1 ? "" : "s"}:
     console.log(`    id: ${c.id}${pr}`);
   }
   printMetric(claims.acceptedPRRate());
+  try {
+    if (await shouldNudgeUnpushed()) {
+      console.log("\n  \u26A0 new claims not yet on your dashboard \u2014 run: terminalhire claim --push --keep-updated");
+    }
+  } catch {
+  }
 }
 async function cmdStatus(id) {
   const claims = await Promise.resolve().then(() => (init_claims(), claims_exports));
@@ -9436,7 +9545,7 @@ When it's done:  terminalhire claim submit ${id}`);
     }
   }
   if (flags.here) {
-    await cmdStartHere(claims, claim);
+    await cmdStartHere(claims, claim, flags);
     return;
   }
   let ghUser;
@@ -9498,6 +9607,7 @@ terminalhire claim: not started \u2014 starting forks ${claim.repoFullName} to y
   await sh("git", ["-C", destDir, "checkout", "-b", branch]);
   const toplevel = await sh("git", ["-C", destDir, "rev-parse", "--show-toplevel"]);
   claims.updateClaim(id, { worktreePath: toplevel, branch, state: "working" });
+  await requestIssueAssignment(claim, flags, ghUser);
   console.log(`
 \u2713 Started: ${claim.title}`);
   console.log(`  fork:   ${forkFullName}`);
@@ -9507,7 +9617,7 @@ terminalhire claim: not started \u2014 starting forks ${claim.repoFullName} to y
   console.log("\n  When the work is done (the only step that pushes + opens the PR):");
   console.log(`    terminalhire claim submit ${id}`);
 }
-async function cmdStartHere(claims, claim) {
+async function cmdStartHere(claims, claim, flags = {}) {
   let toplevel;
   try {
     toplevel = await sh("git", ["-C", process.cwd(), "rev-parse", "--show-toplevel"]);
@@ -9537,6 +9647,7 @@ async function cmdStartHere(claims, claim) {
   const branch = startBranchFor(claim.repoFullName, issueNumber);
   await sh("git", ["-C", toplevel, "checkout", "-b", branch]);
   claims.updateClaim(claim.id, { worktreePath: toplevel, branch, state: "working" });
+  await requestIssueAssignment(claim, flags);
   console.log(`
 \u2713 Started here: ${claim.title}`);
   console.log(`  worktree: ${toplevel}`);
@@ -9768,10 +9879,22 @@ async function cmdSubmit(id, flags = {}) {
     const issueNo = (parseGitHubUrl(claim.issueUrl) || {}).number;
     const contention = issueNo ? await listOpenPRsReferencingIssue(claim.repoFullName, issueNo) : null;
     if (contention && contention.total > 0) {
-      console.log(`  \u26A0 contention: ${contention.total} open PR(s) already reference this issue:`);
       const nowMs = Date.now();
+      console.log(`  \u26A0 contention: ${contention.total} open PR(s) already reference this issue:`);
       for (const pr of contention.prs) console.log(fmtContentionPr(pr, nowMs, false));
       console.log(CONTENTION_HINT);
+      const competing = selectCompetingPrs(contention.prs, ghUser);
+      if (competing.length > 0 && !flags["force-competing"]) {
+        console.error(
+          `
+terminalhire claim: refusing to submit \u2014 ${competing.length} open PR(s) by someone else already address ${claim.repoFullName}#${issueNo}:`
+        );
+        for (const pr of competing) console.error(fmtContentionPr(pr, nowMs, false));
+        console.error(
+          "\n  Opening a competing PR reads as low-effort duplication and burns maintainer goodwill.\n  Stand down, or add value on the existing PR instead (a review, a test, a comment).\n  If you are certain yours should still go up, re-run with --force-competing."
+        );
+        process.exit(1);
+      }
     }
   }
   let ok;
@@ -10039,7 +10162,13 @@ async function cmdPush({ keepUpdated = false } = {}) {
     pushToken = body?.pushToken || null;
   } catch {
   }
-  writeClaimPushMarker({ consentedAt, login, deleteToken });
+  writeClaimPushMarker({
+    consentedAt,
+    login,
+    deleteToken,
+    lastPushedAt: consentedAt,
+    lastSnapshotHash: computeSnapshotHash(pushed)
+  });
   if (autoConsent && pushToken) {
     try {
       await writePushTokenEnc(pushToken);
@@ -10187,6 +10316,7 @@ export {
   AI_DISCLOSURE_NOTE,
   CLAIM_CONSENT_VERSION,
   backgroundEnableFailed,
+  buildAssignmentComment,
   buildSubmitBody,
   cmdRecord,
   countOpenPRsReferencingIssue,
@@ -10207,6 +10337,7 @@ export {
   resolveSubmitWorktree,
   revokeFailureAction,
   run,
+  selectCompetingPrs,
   selectPushRemote,
   startBranchFor,
   workDirFor

package/dist/bin/jpi-dispatch.js

@@ -10811,6 +10811,7 @@ __export(claim_push_bg_exports, {
   AUTO_CONSENT_VERSION: () => AUTO_CONSENT_VERSION,
   AUTO_PUSH_THROTTLE_MS: () => AUTO_PUSH_THROTTLE_MS,
   CLAIM_PUSH_AUTO_MARKER: () => CLAIM_PUSH_AUTO_MARKER,
+  CLAIM_PUSH_MANUAL_MARKER: () => CLAIM_PUSH_MANUAL_MARKER,
   CLAIM_PUSH_TOKEN_FILE: () => CLAIM_PUSH_TOKEN_FILE,
   backgroundPushGate: () => backgroundPushGate,
   clearAutoMarker: () => clearAutoMarker,
@@ -10819,6 +10820,8 @@ __export(claim_push_bg_exports, {
   readAutoMarker: () => readAutoMarker,
   readPushTokenEnc: () => readPushTokenEnc,
   runBackgroundClaimPush: () => runBackgroundClaimPush,
+  shouldNudgeUnpushed: () => shouldNudgeUnpushed,
+  unpushedNudgeGate: () => unpushedNudgeGate,
   writeAutoMarker: () => writeAutoMarker,
   writePushTokenEnc: () => writePushTokenEnc
 });
@@ -10890,6 +10893,43 @@ function backgroundPushGate(params) {
   }
   return { push: true, reason: "ok" };
 }
+function unpushedNudgeGate(params) {
+  const {
+    autoMarkerExists,
+    tokenFileExists,
+    manualMarkerExists,
+    lastSnapshotHash,
+    currentHash,
+    claimCount
+  } = params;
+  if (autoMarkerExists && tokenFileExists) return false;
+  if (!manualMarkerExists) return false;
+  if (!(claimCount > 0)) return false;
+  return lastSnapshotHash !== currentHash;
+}
+async function shouldNudgeUnpushed() {
+  try {
+    const { listClaims: listClaims2, toPushedClaim: toPushedClaim2 } = await Promise.resolve().then(() => (init_claims(), claims_exports));
+    const pushed = listClaims2().map((c) => toPushedClaim2(c));
+    const currentHash = computeSnapshotHash(pushed);
+    let manual = null;
+    try {
+      manual = existsSync9(CLAIM_PUSH_MANUAL_MARKER) ? JSON.parse(readFileSync16(CLAIM_PUSH_MANUAL_MARKER, "utf8")) : null;
+    } catch {
+      manual = null;
+    }
+    return unpushedNudgeGate({
+      autoMarkerExists: existsSync9(CLAIM_PUSH_AUTO_MARKER),
+      tokenFileExists: existsSync9(CLAIM_PUSH_TOKEN_FILE),
+      manualMarkerExists: !!manual,
+      lastSnapshotHash: manual?.lastSnapshotHash ?? null,
+      currentHash,
+      claimCount: pushed.length
+    });
+  } catch {
+    return false;
+  }
+}
 async function runBackgroundClaimPush({ now = Date.now() } = {}) {
   try {
     if (!existsSync9(CLAIM_PUSH_AUTO_MARKER) || !existsSync9(CLAIM_PUSH_TOKEN_FILE)) return;
@@ -10930,7 +10970,7 @@ async function runBackgroundClaimPush({ now = Date.now() } = {}) {
   } catch {
   }
 }
-var TERMINALHIRE_DIR12, CLAIM_PUSH_AUTO_MARKER, CLAIM_PUSH_TOKEN_FILE, CLAIM_SYNC_BASE, AUTO_CONSENT_VERSION, AUTO_PUSH_THROTTLE_MS;
+var TERMINALHIRE_DIR12, CLAIM_PUSH_AUTO_MARKER, CLAIM_PUSH_TOKEN_FILE, CLAIM_PUSH_MANUAL_MARKER, CLAIM_SYNC_BASE, AUTO_CONSENT_VERSION, AUTO_PUSH_THROTTLE_MS;
 var init_claim_push_bg = __esm({
   "bin/claim-push-bg.js"() {
     "use strict";
@@ -10938,6 +10978,7 @@ var init_claim_push_bg = __esm({
     TERMINALHIRE_DIR12 = process.env.TERMINALHIRE_DIR || join16(homedir14(), ".terminalhire");
     CLAIM_PUSH_AUTO_MARKER = join16(TERMINALHIRE_DIR12, "claim-push-auto.json");
     CLAIM_PUSH_TOKEN_FILE = join16(TERMINALHIRE_DIR12, "claim-push-token.enc");
+    CLAIM_PUSH_MANUAL_MARKER = join16(TERMINALHIRE_DIR12, "claim-push.json");
     CLAIM_SYNC_BASE = "https://terminalhire.com";
     AUTO_CONSENT_VERSION = 2;
     AUTO_PUSH_THROTTLE_MS = 24 * 60 * 60 * 1e3;
@@ -11035,6 +11076,7 @@ __export(jpi_claim_exports, {
   AI_DISCLOSURE_NOTE: () => AI_DISCLOSURE_NOTE,
   CLAIM_CONSENT_VERSION: () => CLAIM_CONSENT_VERSION,
   backgroundEnableFailed: () => backgroundEnableFailed,
+  buildAssignmentComment: () => buildAssignmentComment,
   buildSubmitBody: () => buildSubmitBody,
   cmdRecord: () => cmdRecord,
   countOpenPRsReferencingIssue: () => countOpenPRsReferencingIssue,
@@ -11055,6 +11097,7 @@ __export(jpi_claim_exports, {
   resolveSubmitWorktree: () => resolveSubmitWorktree,
   revokeFailureAction: () => revokeFailureAction,
   run: () => run7,
+  selectCompetingPrs: () => selectCompetingPrs,
   selectPushRemote: () => selectPushRemote,
   startBranchFor: () => startBranchFor,
   workDirFor: () => workDirFor
@@ -11288,6 +11331,10 @@ ${p.body ?? ""}`)) {
   }
   return matched;
 }
+function selectCompetingPrs(prs, selfLogin) {
+  if (!Array.isArray(prs)) return [];
+  return prs.filter((pr) => pr && pr.author !== selfLogin);
+}
 async function listOpenPRsReferencingIssue(repoFullName, issueNumber) {
   try {
     const res = await fetch(`${GH_API2}/repos/${repoFullName}/pulls?state=open&per_page=100`, {
@@ -11353,6 +11400,65 @@ async function fetchIssue(repoFullName, issueNumber) {
     return null;
   }
 }
+function buildAssignmentComment(repoFullName) {
+  const usesTakeBot = TAKE_BOT_REPOS.has(repoFullName.toLowerCase());
+  const body = usesTakeBot ? "/take" : `I'd like to work on this \u2014 could I be assigned? Thanks!
+
+${ASSIGNMENT_MARKER}`;
+  return { usesTakeBot, body };
+}
+async function hasPriorAssignmentRequest(repoFullName, issueNumber, login) {
+  try {
+    const res = await fetch(
+      `${GH_API2}/repos/${repoFullName}/issues/${issueNumber}/comments?per_page=100&sort=created&direction=desc`,
+      { headers: GH_HEADERS2, signal: AbortSignal.timeout(1e4) }
+    );
+    if (!res.ok) return false;
+    const comments = await res.json();
+    if (!Array.isArray(comments)) return false;
+    return comments.some(
+      (c) => c && c.user && c.user.login === login && typeof c.body === "string" && c.body.includes(ASSIGNMENT_MARKER)
+    );
+  } catch {
+    return false;
+  }
+}
+async function requestIssueAssignment(claim, flags = {}, ghUser) {
+  if (flags["no-assign"]) {
+    console.log("  (--no-assign \u2014 skipping the assignment request; request it manually before working)");
+    return;
+  }
+  const parsed = parseGitHubUrl(claim.issueUrl);
+  if (!parsed) return;
+  const { repoFullName, number: number3 } = parsed;
+  let login = ghUser;
+  if (!login) {
+    try {
+      login = await sh("gh", ["api", "user", "-q", ".login"]);
+    } catch {
+      console.log("  (assignment not requested: 'gh' not authenticated \u2014 comment on the issue manually before working)");
+      return;
+    }
+  }
+  const issue2 = await fetchIssue(repoFullName, number3);
+  if (issue2 && issue2.assignees.includes(login)) {
+    console.log(`  \u2713 Already assigned to @${login} on ${repoFullName}#${number3}.`);
+    return;
+  }
+  const { usesTakeBot, body } = buildAssignmentComment(repoFullName);
+  if (!usesTakeBot && await hasPriorAssignmentRequest(repoFullName, number3, login)) {
+    console.log(`  \u2713 Assignment already requested on ${repoFullName}#${number3}.`);
+    return;
+  }
+  try {
+    await sh("gh", ["issue", "comment", String(number3), "--repo", repoFullName, "--body", body]);
+    console.log(
+      usesTakeBot ? `  \u2713 Requested assignment via /take on ${repoFullName}#${number3}.` : `  \u2713 Requested assignment on ${repoFullName}#${number3}.`
+    );
+  } catch (err) {
+    console.log(`  (could not post the assignment request: ${err.stderr || err.message || err} \u2014 do it manually before working)`);
+  }
+}
 async function pollPR(prUrl) {
   const p = parseGitHubUrl(prUrl);
   if (!p) return null;
@@ -11643,6 +11749,12 @@ ${list.length} ${active ? "active " : ""}claim${list.length === 1 ? "" : "s"}:
     console.log(`    id: ${c.id}${pr}`);
   }
   printMetric(claims.acceptedPRRate());
+  try {
+    if (await shouldNudgeUnpushed()) {
+      console.log("\n  \u26A0 new claims not yet on your dashboard \u2014 run: terminalhire claim --push --keep-updated");
+    }
+  } catch {
+  }
 }
 async function cmdStatus(id) {
   const claims = await Promise.resolve().then(() => (init_claims(), claims_exports));
@@ -11842,7 +11954,7 @@ When it's done:  terminalhire claim submit ${id}`);
     }
   }
   if (flags.here) {
-    await cmdStartHere(claims, claim);
+    await cmdStartHere(claims, claim, flags);
     return;
   }
   let ghUser;
@@ -11904,6 +12016,7 @@ terminalhire claim: not started \u2014 starting forks ${claim.repoFullName} to y
   await sh("git", ["-C", destDir, "checkout", "-b", branch]);
   const toplevel = await sh("git", ["-C", destDir, "rev-parse", "--show-toplevel"]);
   claims.updateClaim(id, { worktreePath: toplevel, branch, state: "working" });
+  await requestIssueAssignment(claim, flags, ghUser);
   console.log(`
 \u2713 Started: ${claim.title}`);
   console.log(`  fork:   ${forkFullName}`);
@@ -11913,7 +12026,7 @@ terminalhire claim: not started \u2014 starting forks ${claim.repoFullName} to y
   console.log("\n  When the work is done (the only step that pushes + opens the PR):");
   console.log(`    terminalhire claim submit ${id}`);
 }
-async function cmdStartHere(claims, claim) {
+async function cmdStartHere(claims, claim, flags = {}) {
   let toplevel;
   try {
     toplevel = await sh("git", ["-C", process.cwd(), "rev-parse", "--show-toplevel"]);
@@ -11943,6 +12056,7 @@ async function cmdStartHere(claims, claim) {
   const branch = startBranchFor(claim.repoFullName, issueNumber);
   await sh("git", ["-C", toplevel, "checkout", "-b", branch]);
   claims.updateClaim(claim.id, { worktreePath: toplevel, branch, state: "working" });
+  await requestIssueAssignment(claim, flags);
   console.log(`
 \u2713 Started here: ${claim.title}`);
   console.log(`  worktree: ${toplevel}`);
@@ -12174,10 +12288,22 @@ async function cmdSubmit(id, flags = {}) {
     const issueNo = (parseGitHubUrl(claim.issueUrl) || {}).number;
     const contention = issueNo ? await listOpenPRsReferencingIssue(claim.repoFullName, issueNo) : null;
     if (contention && contention.total > 0) {
-      console.log(`  \u26A0 contention: ${contention.total} open PR(s) already reference this issue:`);
       const nowMs = Date.now();
+      console.log(`  \u26A0 contention: ${contention.total} open PR(s) already reference this issue:`);
       for (const pr of contention.prs) console.log(fmtContentionPr(pr, nowMs, false));
       console.log(CONTENTION_HINT);
+      const competing = selectCompetingPrs(contention.prs, ghUser);
+      if (competing.length > 0 && !flags["force-competing"]) {
+        console.error(
+          `
+terminalhire claim: refusing to submit \u2014 ${competing.length} open PR(s) by someone else already address ${claim.repoFullName}#${issueNo}:`
+        );
+        for (const pr of competing) console.error(fmtContentionPr(pr, nowMs, false));
+        console.error(
+          "\n  Opening a competing PR reads as low-effort duplication and burns maintainer goodwill.\n  Stand down, or add value on the existing PR instead (a review, a test, a comment).\n  If you are certain yours should still go up, re-run with --force-competing."
+        );
+        process.exit(1);
+      }
     }
   }
   let ok;
@@ -12445,7 +12571,13 @@ async function cmdPush({ keepUpdated = false } = {}) {
     pushToken = body?.pushToken || null;
   } catch {
   }
-  writeClaimPushMarker({ consentedAt, login, deleteToken });
+  writeClaimPushMarker({
+    consentedAt,
+    login,
+    deleteToken,
+    lastPushedAt: consentedAt,
+    lastSnapshotHash: computeSnapshotHash(pushed)
+  });
   if (autoConsent && pushToken) {
     try {
       await writePushTokenEnc(pushToken);
@@ -12589,7 +12721,7 @@ async function run7() {
     process.exit(1);
   }
 }
-var TERMINALHIRE_DIR13, INDEX_CACHE_FILE5, CLAIM_PUSH_MARKER, API_URL6, CLAIM_SYNC_BASE2, CLAIM_CONSENT_VERSION, CLAIM_POLL_INTERVAL_MS, CLAIM_POLL_TIMEOUT_MS, GH_API2, GH_HEADERS2, CONTENTION_HINT, AI_DISCLOSURE_NOTE, pExecFile, VALUE_FLAGS;
+var TERMINALHIRE_DIR13, INDEX_CACHE_FILE5, CLAIM_PUSH_MARKER, API_URL6, CLAIM_SYNC_BASE2, CLAIM_CONSENT_VERSION, CLAIM_POLL_INTERVAL_MS, CLAIM_POLL_TIMEOUT_MS, GH_API2, GH_HEADERS2, CONTENTION_HINT, AI_DISCLOSURE_NOTE, pExecFile, VALUE_FLAGS, ASSIGNMENT_MARKER, TAKE_BOT_REPOS;
 var init_jpi_claim = __esm({
   "bin/jpi-claim.js"() {
     "use strict";
@@ -12611,6 +12743,8 @@ var init_jpi_claim = __esm({
     AI_DISCLOSURE_NOTE = "---\nThis contribution was developed with AI assistance via [terminalhire](https://terminalhire.com). The author has reviewed the change and takes responsibility for its content.";
     pExecFile = promisify(execFile);
     VALUE_FLAGS = /* @__PURE__ */ new Set(["worktree", "branch", "body-file", "title"]);
+    ASSIGNMENT_MARKER = "<!-- terminalhire:assignment-request -->";
+    TAKE_BOT_REPOS = /* @__PURE__ */ new Set(["paradedb/paradedb"]);
   }
 });
 
@@ -41110,6 +41244,9 @@ function buildContributeNudgeLine(contributeNudge) {
 function buildSessionStaleLine(sessionStale) {
   return sessionStale === true ? "\u26A0 terminalhire: linked session expired \u2014 run: terminalhire login" : null;
 }
+function buildUnpushedClaimsLine(unpushedClaims) {
+  return unpushedClaims === true ? "\u26A0 new claims not yet on your dashboard \u2014 run: terminalhire claim --push --keep-updated" : null;
+}
 function buildSpinnerPool(topMatches, max = 6, opts = {}) {
   const {
     sessionTags,
@@ -41118,16 +41255,19 @@ function buildSpinnerPool(topMatches, max = 6, opts = {}) {
     incomingPending,
     sessionStale,
     contributeNudge,
+    unpushedClaims,
     seenHistory
   } = opts;
   const staleLine = buildSessionStaleLine(sessionStale);
   const withStale = (pool2) => staleLine ? [staleLine, ...pool2] : pool2;
   const introLine = buildIncomingIntroLine(incomingPending);
   const contributeLine = buildContributeNudgeLine(contributeNudge);
+  const unpushedLine = buildUnpushedClaimsLine(unpushedClaims);
   const ranked = filterFreshMatches(rankBySessionTags(topMatches, sessionTags), seenHistory);
   if (!Array.isArray(ranked) || ranked.length === 0) {
     if (introLine) return withStale([introLine]);
     if (contributeLine) return withStale([contributeLine]);
+    if (unpushedLine) return withStale([unpushedLine]);
     const peerLine = buildPeerLine(topPeers);
     return withStale(peerLine ? [peerLine] : []);
   }
@@ -41137,6 +41277,7 @@ function buildSpinnerPool(topMatches, max = 6, opts = {}) {
   const pool = [...headers.slice(0, cap), ctaVerb()];
   if (introLine) pool.push(introLine);
   if (contributeLine) pool.push(contributeLine);
+  if (unpushedLine) pool.push(unpushedLine);
   return withStale(pool);
 }
 var init_spinner_verbs = __esm({
@@ -41276,6 +41417,7 @@ function renderRefreshSurface(topMatches, sc, opts = {}) {
     incomingPending: opts.incomingPending,
     sessionStale: opts.sessionStale,
     contributeNudge: opts.contributeNudge,
+    unpushedClaims: opts.unpushedClaims,
     seenHistory
   });
   if (verbs.length > 0) applySpinnerVerbs(verbs, sc.mode);
@@ -41315,6 +41457,7 @@ __export(spinner_exports, {
   buildSpinnerPool: () => buildSpinnerPool,
   buildTips: () => buildTips,
   buildTipsDetailed: () => buildTipsDetailed,
+  buildUnpushedClaimsLine: () => buildUnpushedClaimsLine,
   clearSpinnerTips: () => clearSpinnerTips,
   clearSpinnerVerbs: () => clearSpinnerVerbs,
   ctaVerb: () => ctaVerb,
@@ -41339,6 +41482,7 @@ var init_spinner = __esm({
     init_spinner_verbs();
     init_spinner_verbs();
     init_spinner_verbs();
+    init_spinner_verbs();
     init_spinner_select();
     init_spinner_select();
     init_spinner_select();
@@ -42501,6 +42645,12 @@ async function run22() {
       topMatches = filterFreshMatches2(topMatches, seenHistory);
     } catch {
     }
+    let unpushedClaims = false;
+    try {
+      const { shouldNudgeUnpushed: shouldNudgeUnpushed2 } = await Promise.resolve().then(() => (init_claim_push_bg(), claim_push_bg_exports));
+      unpushedClaims = await shouldNudgeUnpushed2();
+    } catch {
+    }
     const cacheEntry = {
       index,
       matchCount,
@@ -42509,6 +42659,7 @@ async function run22() {
       incomingPending,
       unreadChat,
       sessionStale,
+      unpushedClaims,
       // In-process-only despite being persisted: the render pass receives it as
       // a function argument below. A future cache READER must not gate on this
       // field without re-checking isContributeEnabled/isContributePrompted at
@@ -42547,6 +42698,7 @@ async function run22() {
         incomingPending,
         sessionStale,
         contributeNudge,
+        unpushedClaims,
         baseUrl: API_URL8,
         seenHistory,
         widen,

package/dist/bin/jpi-refresh.js

@@ -9045,6 +9045,9 @@ function buildContributeNudgeLine(contributeNudge) {
 function buildSessionStaleLine(sessionStale) {
   return sessionStale === true ? "\u26A0 terminalhire: linked session expired \u2014 run: terminalhire login" : null;
 }
+function buildUnpushedClaimsLine(unpushedClaims) {
+  return unpushedClaims === true ? "\u26A0 new claims not yet on your dashboard \u2014 run: terminalhire claim --push --keep-updated" : null;
+}
 function buildSpinnerPool(topMatches, max = 6, opts = {}) {
   const {
     sessionTags,
@@ -9053,16 +9056,19 @@ function buildSpinnerPool(topMatches, max = 6, opts = {}) {
     incomingPending,
     sessionStale,
     contributeNudge,
+    unpushedClaims,
     seenHistory
   } = opts;
   const staleLine = buildSessionStaleLine(sessionStale);
   const withStale = (pool2) => staleLine ? [staleLine, ...pool2] : pool2;
   const introLine = buildIncomingIntroLine(incomingPending);
   const contributeLine = buildContributeNudgeLine(contributeNudge);
+  const unpushedLine = buildUnpushedClaimsLine(unpushedClaims);
   const ranked = filterFreshMatches(rankBySessionTags(topMatches, sessionTags), seenHistory);
   if (!Array.isArray(ranked) || ranked.length === 0) {
     if (introLine) return withStale([introLine]);
     if (contributeLine) return withStale([contributeLine]);
+    if (unpushedLine) return withStale([unpushedLine]);
     const peerLine = buildPeerLine(topPeers);
     return withStale(peerLine ? [peerLine] : []);
   }
@@ -9072,6 +9078,7 @@ function buildSpinnerPool(topMatches, max = 6, opts = {}) {
   const pool = [...headers.slice(0, cap), ctaVerb()];
   if (introLine) pool.push(introLine);
   if (contributeLine) pool.push(contributeLine);
+  if (unpushedLine) pool.push(unpushedLine);
   return withStale(pool);
 }
 var init_spinner_verbs = __esm({
@@ -9211,6 +9218,7 @@ function renderRefreshSurface(topMatches, sc, opts = {}) {
     incomingPending: opts.incomingPending,
     sessionStale: opts.sessionStale,
     contributeNudge: opts.contributeNudge,
+    unpushedClaims: opts.unpushedClaims,
     seenHistory
   });
   if (verbs.length > 0) applySpinnerVerbs(verbs, sc.mode);
@@ -9250,6 +9258,7 @@ __export(spinner_exports, {
   buildSpinnerPool: () => buildSpinnerPool,
   buildTips: () => buildTips,
   buildTipsDetailed: () => buildTipsDetailed,
+  buildUnpushedClaimsLine: () => buildUnpushedClaimsLine,
   clearSpinnerTips: () => clearSpinnerTips,
   clearSpinnerVerbs: () => clearSpinnerVerbs,
   ctaVerb: () => ctaVerb,
@@ -9274,6 +9283,7 @@ var init_spinner = __esm({
     init_spinner_verbs();
     init_spinner_verbs();
     init_spinner_verbs();
+    init_spinner_verbs();
     init_spinner_select();
     init_spinner_select();
     init_spinner_select();
@@ -9288,137 +9298,6 @@ var init_spinner = __esm({
   }
 });
 
-// bin/version-nudge.js
-var version_nudge_exports = {};
-__export(version_nudge_exports, {
-  buildStaleNudge: () => buildStaleNudge,
-  cachedStaleNudge: () => cachedStaleNudge,
-  compareVersions: () => compareVersions,
-  emitInteractiveNudge: () => emitInteractiveNudge,
-  parseVersion: () => parseVersion,
-  readLatestVersionFromCache: () => readLatestVersionFromCache,
-  readLocalVersion: () => readLocalVersion,
-  recordNag: () => recordNag,
-  shouldNag: () => shouldNag
-});
-import { readFileSync as readFileSync11, writeFileSync as writeFileSync9, mkdirSync as mkdirSync9, existsSync as existsSync6 } from "fs";
-import { join as join12 } from "path";
-import { homedir as homedir9 } from "os";
-import { fileURLToPath as fileURLToPath2 } from "url";
-function stateDir() {
-  return process.env.TERMINALHIRE_DIR || join12(homedir9(), ".terminalhire");
-}
-function indexCacheFile() {
-  return join12(stateDir(), "index-cache.json");
-}
-function nudgeStateFile() {
-  return join12(stateDir(), "version-nudge.json");
-}
-function parseVersion(v) {
-  if (typeof v !== "string") return null;
-  const m = v.trim().replace(/^v/, "").match(/^(\d+)\.(\d+)\.(\d+)/);
-  if (!m) return null;
-  return [Number(m[1]), Number(m[2]), Number(m[3])];
-}
-function compareVersions(a, b) {
-  const pa = parseVersion(a);
-  const pb = parseVersion(b);
-  if (!pa || !pb) return null;
-  for (let i = 0; i < 3; i++) {
-    if (pa[i] < pb[i]) return -1;
-    if (pa[i] > pb[i]) return 1;
-  }
-  return 0;
-}
-function buildStaleNudge(local, latest) {
-  if (compareVersions(local, latest) !== -1) return null;
-  return `your terminalhire CLI is behind (${local} \u2192 ${latest}) \u2014 npm i -g terminalhire@latest`;
-}
-function readLocalVersion() {
-  try {
-    const candidates = [
-      join12(__dirname, "..", "..", "package.json"),
-      join12(__dirname, "..", "package.json")
-    ];
-    for (const p of candidates) {
-      if (existsSync6(p)) {
-        const pkg = JSON.parse(readFileSync11(p, "utf8"));
-        if (pkg.version) return pkg.version;
-      }
-    }
-  } catch {
-  }
-  return null;
-}
-function readLatestVersionFromCache() {
-  try {
-    const cache = JSON.parse(readFileSync11(indexCacheFile(), "utf8"));
-    const v = cache?.index?.cliVersion;
-    return typeof v === "string" ? v : null;
-  } catch {
-    return null;
-  }
-}
-function cachedStaleNudge(localVersion) {
-  const local = localVersion ?? readLocalVersion();
-  if (!local) return null;
-  return buildStaleNudge(local, readLatestVersionFromCache());
-}
-function shouldNag(now = Date.now()) {
-  try {
-    const state = JSON.parse(readFileSync11(nudgeStateFile(), "utf8"));
-    const last = state?.lastNaggedAt;
-    if (typeof last !== "number" || !Number.isFinite(last)) return true;
-    return now - last >= NAG_INTERVAL_MS;
-  } catch {
-    return true;
-  }
-}
-function recordNag(now = Date.now()) {
-  try {
-    mkdirSync9(stateDir(), { recursive: true });
-    writeFileSync9(nudgeStateFile(), JSON.stringify({ lastNaggedAt: now }) + "\n", "utf8");
-  } catch {
-  }
-}
-function emitInteractiveNudge({ now = Date.now(), stream = process.stderr, localVersion } = {}) {
-  try {
-    const nudge = cachedStaleNudge(localVersion);
-    if (!nudge) return false;
-    if (!shouldNag(now)) return false;
-    stream.write(`${nudge}
-`);
-    recordNag(now);
-    return true;
-  } catch {
-    return false;
-  }
-}
-var __dirname, NAG_INTERVAL_MS;
-var init_version_nudge = __esm({
-  "bin/version-nudge.js"() {
-    "use strict";
-    __dirname = fileURLToPath2(new URL(".", import.meta.url));
-    NAG_INTERVAL_MS = 24 * 60 * 60 * 1e3;
-  }
-});
-
-// bin/beta-nudge.js
-var beta_nudge_exports = {};
-__export(beta_nudge_exports, {
-  buildBetaNudge: () => buildBetaNudge
-});
-function buildBetaNudge(betaOpen, betaOptIn) {
-  if (betaOpen !== true) return null;
-  if (betaOptIn === true) return null;
-  return "\u{1F9EA} Beta's open \u2014 run `terminalhire beta` to join as a Founding Contributor";
-}
-var init_beta_nudge = __esm({
-  "bin/beta-nudge.js"() {
-    "use strict";
-  }
-});
-
 // src/github-auth.ts
 import {
   createCipheriv as createCipheriv2,
@@ -9426,14 +9305,14 @@ import {
   randomBytes as randomBytes4
 } from "crypto";
 import {
-  readFileSync as readFileSync12,
-  writeFileSync as writeFileSync10,
-  mkdirSync as mkdirSync10,
-  existsSync as existsSync7,
+  readFileSync as readFileSync11,
+  writeFileSync as writeFileSync9,
+  mkdirSync as mkdirSync9,
+  existsSync as existsSync6,
   rmSync as rmSync2
 } from "fs";
-import { join as join13 } from "path";
-import { homedir as homedir10 } from "os";
+import { join as join12 } from "path";
+import { homedir as homedir9 } from "os";
 async function loadKey2() {
   try {
     const kt = await Promise.resolve().then(() => __toESM(require_keytar2(), 1));
@@ -9444,12 +9323,12 @@ async function loadKey2() {
     return key2;
   } catch {
   }
-  mkdirSync10(TERMINALHIRE_DIR6, { recursive: true });
-  if (existsSync7(KEY_FILE2)) {
-    return Buffer.from(readFileSync12(KEY_FILE2, "utf8").trim(), "hex");
+  mkdirSync9(TERMINALHIRE_DIR6, { recursive: true });
+  if (existsSync6(KEY_FILE2)) {
+    return Buffer.from(readFileSync11(KEY_FILE2, "utf8").trim(), "hex");
   }
   const key = randomBytes4(KEY_BYTES2);
-  writeFileSync10(KEY_FILE2, key.toString("hex"), { mode: 384, encoding: "utf8" });
+  writeFileSync9(KEY_FILE2, key.toString("hex"), { mode: 384, encoding: "utf8" });
   return key;
 }
 function encrypt2(plaintext, key) {
@@ -9472,9 +9351,9 @@ var TERMINALHIRE_DIR6, TOKEN_FILE, KEY_FILE2, ALGO2, KEY_BYTES2, IV_BYTES2;
 var init_github_auth = __esm({
   "src/github-auth.ts"() {
     "use strict";
-    TERMINALHIRE_DIR6 = join13(homedir10(), ".terminalhire");
-    TOKEN_FILE = join13(TERMINALHIRE_DIR6, "github-token.enc");
-    KEY_FILE2 = join13(TERMINALHIRE_DIR6, "key");
+    TERMINALHIRE_DIR6 = join12(homedir9(), ".terminalhire");
+    TOKEN_FILE = join12(TERMINALHIRE_DIR6, "github-token.enc");
+    KEY_FILE2 = join12(TERMINALHIRE_DIR6, "key");
     ALGO2 = "aes-256-gcm";
     KEY_BYTES2 = 32;
     IV_BYTES2 = 12;
@@ -9494,9 +9373,9 @@ __export(claims_exports, {
   toPushedClaim: () => toPushedClaim,
   updateClaim: () => updateClaim
 });
-import { readFileSync as readFileSync13, writeFileSync as writeFileSync11, mkdirSync as mkdirSync11, renameSync as renameSync6, existsSync as existsSync8 } from "fs";
-import { join as join14 } from "path";
-import { homedir as homedir11 } from "os";
+import { readFileSync as readFileSync12, writeFileSync as writeFileSync10, mkdirSync as mkdirSync10, renameSync as renameSync6, existsSync as existsSync7 } from "fs";
+import { join as join13 } from "path";
+import { homedir as homedir10 } from "os";
 function toPushedClaim(claim) {
   return {
     kind: claim.kind,
@@ -9516,8 +9395,8 @@ function normalizeClaim(c) {
 }
 function readClaims() {
   try {
-    if (!existsSync8(CLAIMS_FILE)) return [];
-    const data = JSON.parse(readFileSync13(CLAIMS_FILE, "utf8"));
+    if (!existsSync7(CLAIMS_FILE)) return [];
+    const data = JSON.parse(readFileSync12(CLAIMS_FILE, "utf8"));
     const claims = Array.isArray(data?.claims) ? data.claims : [];
     return claims.map(normalizeClaim);
   } catch {
@@ -9525,10 +9404,10 @@ function readClaims() {
   }
 }
 function writeClaims(claims) {
-  mkdirSync11(TERMINALHIRE_DIR7, { recursive: true });
+  mkdirSync10(TERMINALHIRE_DIR7, { recursive: true });
   const tmp = `${CLAIMS_FILE}.tmp`;
   const payload = { claims };
-  writeFileSync11(tmp, JSON.stringify(payload, null, 2), "utf8");
+  writeFileSync10(tmp, JSON.stringify(payload, null, 2), "utf8");
   renameSync6(tmp, CLAIMS_FILE);
 }
 function findClaim(id) {
@@ -9589,8 +9468,8 @@ var TERMINALHIRE_DIR7, CLAIMS_FILE, PUSHED_CLAIM_FIELDS, TERMINAL_STATES;
 var init_claims = __esm({
   "src/claims.ts"() {
     "use strict";
-    TERMINALHIRE_DIR7 = process.env.TERMINALHIRE_DIR || join14(homedir11(), ".terminalhire");
-    CLAIMS_FILE = join14(TERMINALHIRE_DIR7, "claims.json");
+    TERMINALHIRE_DIR7 = process.env.TERMINALHIRE_DIR || join13(homedir10(), ".terminalhire");
+    CLAIMS_FILE = join13(TERMINALHIRE_DIR7, "claims.json");
     PUSHED_CLAIM_FIELDS = [
       "kind",
       "repoFullName",
@@ -9610,6 +9489,7 @@ __export(claim_push_bg_exports, {
   AUTO_CONSENT_VERSION: () => AUTO_CONSENT_VERSION,
   AUTO_PUSH_THROTTLE_MS: () => AUTO_PUSH_THROTTLE_MS,
   CLAIM_PUSH_AUTO_MARKER: () => CLAIM_PUSH_AUTO_MARKER,
+  CLAIM_PUSH_MANUAL_MARKER: () => CLAIM_PUSH_MANUAL_MARKER,
   CLAIM_PUSH_TOKEN_FILE: () => CLAIM_PUSH_TOKEN_FILE,
   backgroundPushGate: () => backgroundPushGate,
   clearAutoMarker: () => clearAutoMarker,
@@ -9618,24 +9498,26 @@ __export(claim_push_bg_exports, {
   readAutoMarker: () => readAutoMarker,
   readPushTokenEnc: () => readPushTokenEnc,
   runBackgroundClaimPush: () => runBackgroundClaimPush,
+  shouldNudgeUnpushed: () => shouldNudgeUnpushed,
+  unpushedNudgeGate: () => unpushedNudgeGate,
   writeAutoMarker: () => writeAutoMarker,
   writePushTokenEnc: () => writePushTokenEnc
 });
 import { createHash as createHash3 } from "crypto";
-import { readFileSync as readFileSync14, writeFileSync as writeFileSync12, mkdirSync as mkdirSync12, existsSync as existsSync9, rmSync as rmSync3 } from "fs";
-import { join as join15 } from "path";
-import { homedir as homedir12 } from "os";
+import { readFileSync as readFileSync13, writeFileSync as writeFileSync11, mkdirSync as mkdirSync11, existsSync as existsSync8, rmSync as rmSync3 } from "fs";
+import { join as join14 } from "path";
+import { homedir as homedir11 } from "os";
 async function writePushTokenEnc(rawToken) {
-  mkdirSync12(TERMINALHIRE_DIR8, { recursive: true });
+  mkdirSync11(TERMINALHIRE_DIR8, { recursive: true });
   const key = await loadKey2();
   const blob = encrypt2(rawToken, key);
-  writeFileSync12(CLAIM_PUSH_TOKEN_FILE, JSON.stringify(blob, null, 2), { encoding: "utf8" });
+  writeFileSync11(CLAIM_PUSH_TOKEN_FILE, JSON.stringify(blob, null, 2), { encoding: "utf8" });
 }
 async function readPushTokenEnc() {
-  if (!existsSync9(CLAIM_PUSH_TOKEN_FILE)) return void 0;
+  if (!existsSync8(CLAIM_PUSH_TOKEN_FILE)) return void 0;
   try {
     const key = await loadKey2();
-    const blob = JSON.parse(readFileSync14(CLAIM_PUSH_TOKEN_FILE, "utf8"));
+    const blob = JSON.parse(readFileSync13(CLAIM_PUSH_TOKEN_FILE, "utf8"));
     return decrypt2(blob, key);
   } catch {
     return void 0;
@@ -9649,14 +9531,14 @@ function clearPushTokenEnc() {
 }
 function readAutoMarker() {
   try {
-    return existsSync9(CLAIM_PUSH_AUTO_MARKER) ? JSON.parse(readFileSync14(CLAIM_PUSH_AUTO_MARKER, "utf8")) : null;
+    return existsSync8(CLAIM_PUSH_AUTO_MARKER) ? JSON.parse(readFileSync13(CLAIM_PUSH_AUTO_MARKER, "utf8")) : null;
   } catch {
     return null;
   }
 }
 function writeAutoMarker(marker) {
-  mkdirSync12(TERMINALHIRE_DIR8, { recursive: true });
-  writeFileSync12(CLAIM_PUSH_AUTO_MARKER, JSON.stringify(marker, null, 2) + "\n", "utf8");
+  mkdirSync11(TERMINALHIRE_DIR8, { recursive: true });
+  writeFileSync11(CLAIM_PUSH_AUTO_MARKER, JSON.stringify(marker, null, 2) + "\n", "utf8");
 }
 function clearAutoMarker() {
   try {
@@ -9689,9 +9571,46 @@ function backgroundPushGate(params) {
   }
   return { push: true, reason: "ok" };
 }
+function unpushedNudgeGate(params) {
+  const {
+    autoMarkerExists,
+    tokenFileExists,
+    manualMarkerExists,
+    lastSnapshotHash,
+    currentHash,
+    claimCount
+  } = params;
+  if (autoMarkerExists && tokenFileExists) return false;
+  if (!manualMarkerExists) return false;
+  if (!(claimCount > 0)) return false;
+  return lastSnapshotHash !== currentHash;
+}
+async function shouldNudgeUnpushed() {
+  try {
+    const { listClaims: listClaims2, toPushedClaim: toPushedClaim2 } = await Promise.resolve().then(() => (init_claims(), claims_exports));
+    const pushed = listClaims2().map((c) => toPushedClaim2(c));
+    const currentHash = computeSnapshotHash(pushed);
+    let manual = null;
+    try {
+      manual = existsSync8(CLAIM_PUSH_MANUAL_MARKER) ? JSON.parse(readFileSync13(CLAIM_PUSH_MANUAL_MARKER, "utf8")) : null;
+    } catch {
+      manual = null;
+    }
+    return unpushedNudgeGate({
+      autoMarkerExists: existsSync8(CLAIM_PUSH_AUTO_MARKER),
+      tokenFileExists: existsSync8(CLAIM_PUSH_TOKEN_FILE),
+      manualMarkerExists: !!manual,
+      lastSnapshotHash: manual?.lastSnapshotHash ?? null,
+      currentHash,
+      claimCount: pushed.length
+    });
+  } catch {
+    return false;
+  }
+}
 async function runBackgroundClaimPush({ now = Date.now() } = {}) {
   try {
-    if (!existsSync9(CLAIM_PUSH_AUTO_MARKER) || !existsSync9(CLAIM_PUSH_TOKEN_FILE)) return;
+    if (!existsSync8(CLAIM_PUSH_AUTO_MARKER) || !existsSync8(CLAIM_PUSH_TOKEN_FILE)) return;
     const marker = readAutoMarker();
     if (!marker || !marker.autoConsentedAt) return;
     const { listClaims: listClaims2, toPushedClaim: toPushedClaim2, PUSHED_CLAIM_FIELDS: PUSHED_CLAIM_FIELDS2 } = await Promise.resolve().then(() => (init_claims(), claims_exports));
@@ -9729,20 +9648,152 @@ async function runBackgroundClaimPush({ now = Date.now() } = {}) {
   } catch {
   }
 }
-var TERMINALHIRE_DIR8, CLAIM_PUSH_AUTO_MARKER, CLAIM_PUSH_TOKEN_FILE, CLAIM_SYNC_BASE, AUTO_CONSENT_VERSION, AUTO_PUSH_THROTTLE_MS;
+var TERMINALHIRE_DIR8, CLAIM_PUSH_AUTO_MARKER, CLAIM_PUSH_TOKEN_FILE, CLAIM_PUSH_MANUAL_MARKER, CLAIM_SYNC_BASE, AUTO_CONSENT_VERSION, AUTO_PUSH_THROTTLE_MS;
 var init_claim_push_bg = __esm({
   "bin/claim-push-bg.js"() {
     "use strict";
     init_github_auth();
-    TERMINALHIRE_DIR8 = process.env.TERMINALHIRE_DIR || join15(homedir12(), ".terminalhire");
-    CLAIM_PUSH_AUTO_MARKER = join15(TERMINALHIRE_DIR8, "claim-push-auto.json");
-    CLAIM_PUSH_TOKEN_FILE = join15(TERMINALHIRE_DIR8, "claim-push-token.enc");
+    TERMINALHIRE_DIR8 = process.env.TERMINALHIRE_DIR || join14(homedir11(), ".terminalhire");
+    CLAIM_PUSH_AUTO_MARKER = join14(TERMINALHIRE_DIR8, "claim-push-auto.json");
+    CLAIM_PUSH_TOKEN_FILE = join14(TERMINALHIRE_DIR8, "claim-push-token.enc");
+    CLAIM_PUSH_MANUAL_MARKER = join14(TERMINALHIRE_DIR8, "claim-push.json");
     CLAIM_SYNC_BASE = "https://terminalhire.com";
     AUTO_CONSENT_VERSION = 2;
     AUTO_PUSH_THROTTLE_MS = 24 * 60 * 60 * 1e3;
   }
 });
 
+// bin/version-nudge.js
+var version_nudge_exports = {};
+__export(version_nudge_exports, {
+  buildStaleNudge: () => buildStaleNudge,
+  cachedStaleNudge: () => cachedStaleNudge,
+  compareVersions: () => compareVersions,
+  emitInteractiveNudge: () => emitInteractiveNudge,
+  parseVersion: () => parseVersion,
+  readLatestVersionFromCache: () => readLatestVersionFromCache,
+  readLocalVersion: () => readLocalVersion,
+  recordNag: () => recordNag,
+  shouldNag: () => shouldNag
+});
+import { readFileSync as readFileSync14, writeFileSync as writeFileSync12, mkdirSync as mkdirSync12, existsSync as existsSync9 } from "fs";
+import { join as join15 } from "path";
+import { homedir as homedir12 } from "os";
+import { fileURLToPath as fileURLToPath2 } from "url";
+function stateDir() {
+  return process.env.TERMINALHIRE_DIR || join15(homedir12(), ".terminalhire");
+}
+function indexCacheFile() {
+  return join15(stateDir(), "index-cache.json");
+}
+function nudgeStateFile() {
+  return join15(stateDir(), "version-nudge.json");
+}
+function parseVersion(v) {
+  if (typeof v !== "string") return null;
+  const m = v.trim().replace(/^v/, "").match(/^(\d+)\.(\d+)\.(\d+)/);
+  if (!m) return null;
+  return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+function compareVersions(a, b) {
+  const pa = parseVersion(a);
+  const pb = parseVersion(b);
+  if (!pa || !pb) return null;
+  for (let i = 0; i < 3; i++) {
+    if (pa[i] < pb[i]) return -1;
+    if (pa[i] > pb[i]) return 1;
+  }
+  return 0;
+}
+function buildStaleNudge(local, latest) {
+  if (compareVersions(local, latest) !== -1) return null;
+  return `your terminalhire CLI is behind (${local} \u2192 ${latest}) \u2014 npm i -g terminalhire@latest`;
+}
+function readLocalVersion() {
+  try {
+    const candidates = [
+      join15(__dirname, "..", "..", "package.json"),
+      join15(__dirname, "..", "package.json")
+    ];
+    for (const p of candidates) {
+      if (existsSync9(p)) {
+        const pkg = JSON.parse(readFileSync14(p, "utf8"));
+        if (pkg.version) return pkg.version;
+      }
+    }
+  } catch {
+  }
+  return null;
+}
+function readLatestVersionFromCache() {
+  try {
+    const cache = JSON.parse(readFileSync14(indexCacheFile(), "utf8"));
+    const v = cache?.index?.cliVersion;
+    return typeof v === "string" ? v : null;
+  } catch {
+    return null;
+  }
+}
+function cachedStaleNudge(localVersion) {
+  const local = localVersion ?? readLocalVersion();
+  if (!local) return null;
+  return buildStaleNudge(local, readLatestVersionFromCache());
+}
+function shouldNag(now = Date.now()) {
+  try {
+    const state = JSON.parse(readFileSync14(nudgeStateFile(), "utf8"));
+    const last = state?.lastNaggedAt;
+    if (typeof last !== "number" || !Number.isFinite(last)) return true;
+    return now - last >= NAG_INTERVAL_MS;
+  } catch {
+    return true;
+  }
+}
+function recordNag(now = Date.now()) {
+  try {
+    mkdirSync12(stateDir(), { recursive: true });
+    writeFileSync12(nudgeStateFile(), JSON.stringify({ lastNaggedAt: now }) + "\n", "utf8");
+  } catch {
+  }
+}
+function emitInteractiveNudge({ now = Date.now(), stream = process.stderr, localVersion } = {}) {
+  try {
+    const nudge = cachedStaleNudge(localVersion);
+    if (!nudge) return false;
+    if (!shouldNag(now)) return false;
+    stream.write(`${nudge}
+`);
+    recordNag(now);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var __dirname, NAG_INTERVAL_MS;
+var init_version_nudge = __esm({
+  "bin/version-nudge.js"() {
+    "use strict";
+    __dirname = fileURLToPath2(new URL(".", import.meta.url));
+    NAG_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+  }
+});
+
+// bin/beta-nudge.js
+var beta_nudge_exports = {};
+__export(beta_nudge_exports, {
+  buildBetaNudge: () => buildBetaNudge
+});
+function buildBetaNudge(betaOpen, betaOptIn) {
+  if (betaOpen !== true) return null;
+  if (betaOptIn === true) return null;
+  return "\u{1F9EA} Beta's open \u2014 run `terminalhire beta` to join as a Founding Contributor";
+}
+var init_beta_nudge = __esm({
+  "bin/beta-nudge.js"() {
+    "use strict";
+  }
+});
+
 // bin/jpi-refresh.js
 import { fileURLToPath as fileURLToPath3 } from "url";
 
@@ -10218,6 +10269,12 @@ async function run() {
       topMatches = filterFreshMatches2(topMatches, seenHistory);
     } catch {
     }
+    let unpushedClaims = false;
+    try {
+      const { shouldNudgeUnpushed: shouldNudgeUnpushed2 } = await Promise.resolve().then(() => (init_claim_push_bg(), claim_push_bg_exports));
+      unpushedClaims = await shouldNudgeUnpushed2();
+    } catch {
+    }
     const cacheEntry = {
       index,
       matchCount,
@@ -10226,6 +10283,7 @@ async function run() {
       incomingPending,
       unreadChat,
       sessionStale,
+      unpushedClaims,
       // In-process-only despite being persisted: the render pass receives it as
       // a function argument below. A future cache READER must not gate on this
       // field without re-checking isContributeEnabled/isContributePrompted at
@@ -10264,6 +10322,7 @@ async function run() {
         incomingPending,
         sessionStale,
         contributeNudge,
+        unpushedClaims,
         baseUrl: API_URL2,
         seenHistory,
         widen,

package/dist/bin/jpi-spinner.js

@@ -249,6 +249,9 @@ function buildContributeNudgeLine(contributeNudge) {
 function buildSessionStaleLine(sessionStale) {
   return sessionStale === true ? "\u26A0 terminalhire: linked session expired \u2014 run: terminalhire login" : null;
 }
+function buildUnpushedClaimsLine(unpushedClaims) {
+  return unpushedClaims === true ? "\u26A0 new claims not yet on your dashboard \u2014 run: terminalhire claim --push --keep-updated" : null;
+}
 function buildSpinnerPool(topMatches, max = 6, opts = {}) {
   const {
     sessionTags,
@@ -257,16 +260,19 @@ function buildSpinnerPool(topMatches, max = 6, opts = {}) {
     incomingPending,
     sessionStale,
     contributeNudge,
+    unpushedClaims,
     seenHistory
   } = opts;
   const staleLine = buildSessionStaleLine(sessionStale);
   const withStale = (pool2) => staleLine ? [staleLine, ...pool2] : pool2;
   const introLine = buildIncomingIntroLine(incomingPending);
   const contributeLine = buildContributeNudgeLine(contributeNudge);
+  const unpushedLine = buildUnpushedClaimsLine(unpushedClaims);
   const ranked = filterFreshMatches(rankBySessionTags(topMatches, sessionTags), seenHistory);
   if (!Array.isArray(ranked) || ranked.length === 0) {
     if (introLine) return withStale([introLine]);
     if (contributeLine) return withStale([contributeLine]);
+    if (unpushedLine) return withStale([unpushedLine]);
     const peerLine = buildPeerLine(topPeers);
     return withStale(peerLine ? [peerLine] : []);
   }
@@ -276,6 +282,7 @@ function buildSpinnerPool(topMatches, max = 6, opts = {}) {
   const pool = [...headers.slice(0, cap), ctaVerb()];
   if (introLine) pool.push(introLine);
   if (contributeLine) pool.push(contributeLine);
+  if (unpushedLine) pool.push(unpushedLine);
   return withStale(pool);
 }
 

package/dist/bin/spinner.js

@@ -346,6 +346,9 @@ function buildContributeNudgeLine(contributeNudge) {
 function buildSessionStaleLine(sessionStale) {
   return sessionStale === true ? "\u26A0 terminalhire: linked session expired \u2014 run: terminalhire login" : null;
 }
+function buildUnpushedClaimsLine(unpushedClaims) {
+  return unpushedClaims === true ? "\u26A0 new claims not yet on your dashboard \u2014 run: terminalhire claim --push --keep-updated" : null;
+}
 function buildSpinnerPool(topMatches, max = 6, opts = {}) {
   const {
     sessionTags,
@@ -354,16 +357,19 @@ function buildSpinnerPool(topMatches, max = 6, opts = {}) {
     incomingPending,
     sessionStale,
     contributeNudge,
+    unpushedClaims,
     seenHistory
   } = opts;
   const staleLine = buildSessionStaleLine(sessionStale);
   const withStale = (pool2) => staleLine ? [staleLine, ...pool2] : pool2;
   const introLine = buildIncomingIntroLine(incomingPending);
   const contributeLine = buildContributeNudgeLine(contributeNudge);
+  const unpushedLine = buildUnpushedClaimsLine(unpushedClaims);
   const ranked = filterFreshMatches(rankBySessionTags(topMatches, sessionTags), seenHistory);
   if (!Array.isArray(ranked) || ranked.length === 0) {
     if (introLine) return withStale([introLine]);
     if (contributeLine) return withStale([contributeLine]);
+    if (unpushedLine) return withStale([unpushedLine]);
     const peerLine = buildPeerLine(topPeers);
     return withStale(peerLine ? [peerLine] : []);
   }
@@ -373,6 +379,7 @@ function buildSpinnerPool(topMatches, max = 6, opts = {}) {
   const pool = [...headers.slice(0, cap), ctaVerb()];
   if (introLine) pool.push(introLine);
   if (contributeLine) pool.push(contributeLine);
+  if (unpushedLine) pool.push(unpushedLine);
   return withStale(pool);
 }
 
@@ -1057,6 +1064,7 @@ function renderRefreshSurface(topMatches, sc, opts = {}) {
     incomingPending: opts.incomingPending,
     sessionStale: opts.sessionStale,
     contributeNudge: opts.contributeNudge,
+    unpushedClaims: opts.unpushedClaims,
     seenHistory
   });
   if (verbs.length > 0) applySpinnerVerbs(verbs, sc.mode);
@@ -1083,6 +1091,7 @@ export {
   buildSpinnerPool,
   buildTips,
   buildTipsDetailed,
+  buildUnpushedClaimsLine,
   clearSpinnerTips,
   clearSpinnerVerbs,
   ctaVerb,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminalhire",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "Local-first job matching for developers — ambient job matches in the Claude Code spinner. Matching runs on your machine; your profile never leaves it.",
   "repository": {
     "type": "git",