terminalhire 0.27.0 → 0.28.0

package/dist/bin/jpi-claim.js

@@ -8882,6 +8882,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 +8951,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;
@@ -9436,7 +9501,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 +9563,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 +9573,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 +9603,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 +9835,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;
@@ -10187,6 +10266,7 @@ export {
   AI_DISCLOSURE_NOTE,
   CLAIM_CONSENT_VERSION,
   backgroundEnableFailed,
+  buildAssignmentComment,
   buildSubmitBody,
   cmdRecord,
   countOpenPRsReferencingIssue,
@@ -10207,6 +10287,7 @@ export {
   resolveSubmitWorktree,
   revokeFailureAction,
   run,
+  selectCompetingPrs,
   selectPushRemote,
   startBranchFor,
   workDirFor

package/dist/bin/jpi-dispatch.js

@@ -11035,6 +11035,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 +11056,7 @@ __export(jpi_claim_exports, {
   resolveSubmitWorktree: () => resolveSubmitWorktree,
   revokeFailureAction: () => revokeFailureAction,
   run: () => run7,
+  selectCompetingPrs: () => selectCompetingPrs,
   selectPushRemote: () => selectPushRemote,
   startBranchFor: () => startBranchFor,
   workDirFor: () => workDirFor
@@ -11288,6 +11290,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 +11359,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;
@@ -11842,7 +11907,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 +11969,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 +11979,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 +12009,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 +12241,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;
@@ -12589,7 +12668,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 +12690,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"]);
   }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminalhire",
-  "version": "0.27.0",
+  "version": "0.28.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",