terminalhire 0.30.2 → 0.33.0

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

@@ -45,9 +45,9 @@ var init_keytar = __esm({
   }
 });
 
-// node-file:/Users/ericgang/job-placement-inline/node_modules/keytar/build/Release/keytar.node
+// node-file:/Users/ericgang/job-placement-inline/.claude/worktrees/agent-a0bc554500876cd51/node_modules/keytar/build/Release/keytar.node
 var require_keytar = __commonJS({
-  "node-file:/Users/ericgang/job-placement-inline/node_modules/keytar/build/Release/keytar.node"(exports, module) {
+  "node-file:/Users/ericgang/job-placement-inline/.claude/worktrees/agent-a0bc554500876cd51/node_modules/keytar/build/Release/keytar.node"(exports, module) {
     "use strict";
     init_keytar();
     try {

package/dist/bin/jpi-bounties.js

@@ -2026,7 +2026,7 @@ function match(fp, jobs, limit = 5, now = Date.now(), opts = {}) {
       reason: buildReason(details)
     };
   });
-  return scored.filter((r) => r !== null && r.score >= MIN_SCORE).sort((a, b) => {
+  return scored.filter((r) => r !== null && r.score >= (opts.minScore ?? MIN_SCORE)).sort((a, b) => {
     const byScore = b.score - a.score;
     if (Math.abs(byScore) > TIEBREAK_EPS) return byScore;
     const byAcceptance = (b.acceptance?.count ?? 0) - (a.acceptance?.count ?? 0);
@@ -8062,9 +8062,9 @@ var init_keytar = __esm({
   }
 });
 
-// node-file:/Users/ericgang/job-placement-inline/node_modules/keytar/build/Release/keytar.node
+// node-file:/Users/ericgang/job-placement-inline/.claude/worktrees/agent-a0bc554500876cd51/node_modules/keytar/build/Release/keytar.node
 var require_keytar = __commonJS({
-  "node-file:/Users/ericgang/job-placement-inline/node_modules/keytar/build/Release/keytar.node"(exports, module) {
+  "node-file:/Users/ericgang/job-placement-inline/.claude/worktrees/agent-a0bc554500876cd51/node_modules/keytar/build/Release/keytar.node"(exports, module) {
     "use strict";
     init_keytar();
     try {
@@ -8353,11 +8353,134 @@ var init_profile = __esm({
   }
 });
 
-// bin/jpi-bounties.js
-init_src();
-import { readFileSync as readFileSync4 } from "fs";
+// src/claims.ts
+var claims_exports = {};
+__export(claims_exports, {
+  PUSHED_CLAIM_FIELDS: () => PUSHED_CLAIM_FIELDS,
+  acceptedPRRate: () => acceptedPRRate,
+  findClaim: () => findClaim,
+  listClaims: () => listClaims,
+  readClaims: () => readClaims,
+  recordClaim: () => recordClaim,
+  removeClaim: () => removeClaim,
+  toPushedClaim: () => toPushedClaim,
+  updateClaim: () => updateClaim
+});
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3, renameSync as renameSync2, existsSync as existsSync2 } from "fs";
 import { join as join4 } from "path";
 import { homedir as homedir3 } from "os";
+function toPushedClaim(claim) {
+  return {
+    kind: claim.kind,
+    repoFullName: claim.repoFullName,
+    state: claim.state,
+    prUrl: claim.prUrl,
+    merged: claim.state === "merged",
+    claimedAt: claim.claimedAt,
+    updatedAt: claim.updatedAt
+  };
+}
+function nowISO() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function normalizeClaim(c) {
+  return { ...c, kind: c.kind ?? "bounty", policy: c.policy ?? null };
+}
+function readClaims() {
+  try {
+    if (!existsSync2(CLAIMS_FILE)) return [];
+    const data = JSON.parse(readFileSync4(CLAIMS_FILE, "utf8"));
+    const claims = Array.isArray(data?.claims) ? data.claims : [];
+    return claims.map(normalizeClaim);
+  } catch {
+    return [];
+  }
+}
+function writeClaims(claims) {
+  mkdirSync3(TERMINALHIRE_DIR3, { recursive: true });
+  const tmp = `${CLAIMS_FILE}.tmp`;
+  const payload = { claims };
+  writeFileSync3(tmp, JSON.stringify(payload, null, 2), "utf8");
+  renameSync2(tmp, CLAIMS_FILE);
+}
+function findClaim(id) {
+  return readClaims().find((c) => c.id === id) ?? null;
+}
+function listClaims(opts = {}) {
+  const claims = readClaims();
+  if (!opts.active) return claims;
+  return claims.filter((c) => !TERMINAL_STATES.has(c.state));
+}
+function recordClaim(rec) {
+  const claims = readClaims();
+  if (claims.some((c) => c.id === rec.id)) {
+    throw new Error(
+      `claim already exists for '${rec.id}' \u2014 run 'terminalhire claim status ${rec.id}' or 'terminalhire claim release ${rec.id}'`
+    );
+  }
+  const ts = nowISO();
+  const claim = {
+    ...rec,
+    // Defensive default (mirrors normalizeClaim's `kind ?? 'bounty'` pattern):
+    // a caller written before `policy` existed, or a plain-JS caller that skips
+    // it, still produces a valid record instead of `policy: undefined`.
+    policy: rec.policy ?? null,
+    state: "claimed",
+    worktreePath: null,
+    branch: null,
+    prUrl: null,
+    review: null,
+    claimedAt: ts,
+    updatedAt: ts
+  };
+  claims.push(claim);
+  writeClaims(claims);
+  return claim;
+}
+function updateClaim(id, patch) {
+  const claims = readClaims();
+  const idx = claims.findIndex((c) => c.id === id);
+  if (idx === -1) return null;
+  claims[idx] = { ...claims[idx], ...patch, updatedAt: nowISO() };
+  writeClaims(claims);
+  return claims[idx];
+}
+function removeClaim(id) {
+  const claims = readClaims();
+  const next = claims.filter((c) => c.id !== id);
+  if (next.length === claims.length) return false;
+  writeClaims(next);
+  return true;
+}
+function acceptedPRRate(claims = readClaims()) {
+  const total = claims.length;
+  const merged = claims.filter((c) => c.state === "merged").length;
+  return { merged, total, rate: total === 0 ? 0 : merged / total };
+}
+var TERMINALHIRE_DIR3, CLAIMS_FILE, PUSHED_CLAIM_FIELDS, TERMINAL_STATES;
+var init_claims = __esm({
+  "src/claims.ts"() {
+    "use strict";
+    TERMINALHIRE_DIR3 = process.env.TERMINALHIRE_DIR || join4(homedir3(), ".terminalhire");
+    CLAIMS_FILE = join4(TERMINALHIRE_DIR3, "claims.json");
+    PUSHED_CLAIM_FIELDS = [
+      "kind",
+      "repoFullName",
+      "state",
+      "prUrl",
+      "merged",
+      "claimedAt",
+      "updatedAt"
+    ];
+    TERMINAL_STATES = /* @__PURE__ */ new Set(["merged", "abandoned"]);
+  }
+});
+
+// bin/jpi-bounties.js
+init_src();
+import { readFileSync as readFileSync5 } from "fs";
+import { join as join5 } from "path";
+import { homedir as homedir4 } from "os";
 import { createInterface } from "readline";
 
 // bin/cache-store.js
@@ -8422,8 +8545,8 @@ function linkTitle(title, url) {
 }
 
 // bin/jpi-bounties.js
-var TERMINALHIRE_DIR3 = process.env.TERMINALHIRE_DIR || join4(homedir3(), ".terminalhire");
-var INDEX_CACHE_FILE2 = join4(TERMINALHIRE_DIR3, "index-cache.json");
+var TERMINALHIRE_DIR4 = process.env.TERMINALHIRE_DIR || join5(homedir4(), ".terminalhire");
+var INDEX_CACHE_FILE2 = join5(TERMINALHIRE_DIR4, "index-cache.json");
 var INDEX_TTL_MS = 15 * 60 * 1e3;
 var API_URL = process.env["TERMINALHIRE_API_URL"] ?? process.env["JPI_API_URL"] ?? "https://terminalhire.com";
 var RANK_MODE = process.env["TERMINALHIRE_BOUNTY_RANK"] ?? "winnability";
@@ -8436,7 +8559,7 @@ var SHOW_ALL = args.includes("--all");
 var WINNABLE_ONLY = args.includes("--winnable");
 function readIndexCache() {
   try {
-    const entry = JSON.parse(readFileSync4(INDEX_CACHE_FILE2, "utf8"));
+    const entry = JSON.parse(readFileSync5(INDEX_CACHE_FILE2, "utf8"));
     if (Date.now() - entry.ts < INDEX_TTL_MS) return entry.index;
     return null;
   } catch {
@@ -8468,22 +8591,26 @@ function formatAmount(b) {
   return b.amountUSD != null ? "$" + b.amountUSD.toLocaleString() : "$\u2014";
 }
 var EFFORT_LABEL = { small: "small (~\xBD day)", medium: "medium (~1 day)", large: "large (multi-day)" };
-function printBounty(i, job, score, reason, matchedTags) {
+function printBounty(i, job, score, reason, matchedTags, claimedIds = /* @__PURE__ */ new Set()) {
   const b = job.bounty ?? {};
   const stars = b.repoStars != null ? ` \xB7 ${b.repoStars}\u2605` : "";
   const effort = b.estimatedEffort ? ` \xB7 ${EFFORT_LABEL[b.estimatedEffort]}` : "";
   const scoreStr = score > 0 ? ` \xB7 match ${Math.round(score * 100)}%` : "";
   const prs = b.competingOpenPRs;
   const contend = prs != null && prs > 0 ? ` \xB7 \u26A0 ${prs} PR${prs === 1 ? "" : "s"} in flight` : "";
+  const claimed = claimedIds.has(job.id);
+  const badge = claimed ? " \xB7 \u25CF claimed by you" : "";
   const ref = opportunityShortToken(job.id);
   console.log(`
 ${i + 1}. ${linkTitle(job.title, job.url)} [${ref}]`);
-  console.log(`   ${formatAmount(b)}${effort} \xB7 ${sanitizeText(b.repoFullName ?? job.company)}${stars}${scoreStr}${contend}`);
+  console.log(`   ${formatAmount(b)}${effort} \xB7 ${sanitizeText(b.repoFullName ?? job.company)}${stars}${scoreStr}${contend}${badge}`);
   if (reason) console.log(`   ${reason}`);
   if (matchedTags && matchedTags.length) console.log(`   Tags matched: ${matchedTags.slice(0, 5).join(", ")}`);
   console.log(`   id: ${job.id}`);
   console.log(`   Claim: ${sanitizeText(b.claimUrl ?? job.url)}`);
-  console.log(`   \u2192 terminalhire claim ${ref}`);
+  console.log(
+    claimed ? `   \u2192 claimed by you \u2014 terminalhire claim status ${job.id}` : `   \u2192 terminalhire claim ${ref}`
+  );
 }
 function rankBounties(bounties, { rankMode = "winnability", scoreOf = () => 0 } = {}) {
   const legacy = rankMode === "legacy";
@@ -8561,6 +8688,12 @@ async function run() {
     if (result.status !== "ok") return;
     const { bounties, ranked, matchedCount } = result;
     const shown = SHOW_ALL ? bounties : bounties.slice(0, LIMIT);
+    let claimedIds = /* @__PURE__ */ new Set();
+    try {
+      const { listClaims: listClaims2 } = await Promise.resolve().then(() => (init_claims(), claims_exports));
+      claimedIds = new Set(listClaims2({ active: true }).map((c) => c.id));
+    } catch {
+    }
     console.log(
       `
 \u26A1 ${bounties.length} bount${bounties.length === 1 ? "y" : "ies"} you could knock out` + (matchedCount ? ` \u2014 ${matchedCount} matched to your profile` : "") + ` (local rank \u2014 no data sent)
@@ -8568,7 +8701,7 @@ async function run() {
     );
     for (let i = 0; i < shown.length; i++) {
       const r = ranked.get(shown[i].id);
-      printBounty(i, shown[i], r?.score ?? 0, r?.reason, r?.matchedTags);
+      printBounty(i, shown[i], r?.score ?? 0, r?.reason, r?.matchedTags, claimedIds);
     }
     if (!SHOW_ALL && bounties.length > shown.length) {
       console.log(`
@@ -8595,6 +8728,7 @@ export {
   classifyEmptyStatus,
   filterPaidVisibility,
   getBounties,
+  printBounty,
   rankBounties,
   run
 };

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

@@ -4043,9 +4043,9 @@ var init_keytar = __esm({
   }
 });
 
-// node-file:/Users/ericgang/job-placement-inline/node_modules/keytar/build/Release/keytar.node
+// node-file:/Users/ericgang/job-placement-inline/.claude/worktrees/agent-a0bc554500876cd51/node_modules/keytar/build/Release/keytar.node
 var require_keytar = __commonJS({
-  "node-file:/Users/ericgang/job-placement-inline/node_modules/keytar/build/Release/keytar.node"(exports, module) {
+  "node-file:/Users/ericgang/job-placement-inline/.claude/worktrees/agent-a0bc554500876cd51/node_modules/keytar/build/Release/keytar.node"(exports, module) {
     "use strict";
     init_keytar();
     try {

package/dist/bin/jpi-chat.js

@@ -4071,9 +4071,9 @@ var init_keytar = __esm({
   }
 });
 
-// node-file:/Users/ericgang/job-placement-inline/node_modules/keytar/build/Release/keytar.node
+// node-file:/Users/ericgang/job-placement-inline/.claude/worktrees/agent-a0bc554500876cd51/node_modules/keytar/build/Release/keytar.node
 var require_keytar = __commonJS({
-  "node-file:/Users/ericgang/job-placement-inline/node_modules/keytar/build/Release/keytar.node"(exports, module) {
+  "node-file:/Users/ericgang/job-placement-inline/.claude/worktrees/agent-a0bc554500876cd51/node_modules/keytar/build/Release/keytar.node"(exports, module) {
     "use strict";
     init_keytar();
     try {

package/dist/bin/jpi-claim.js

@@ -2026,7 +2026,7 @@ function match(fp, jobs, limit = 5, now = Date.now(), opts = {}) {
       reason: buildReason(details)
     };
   });
-  return scored.filter((r) => r !== null && r.score >= MIN_SCORE).sort((a, b) => {
+  return scored.filter((r) => r !== null && r.score >= (opts.minScore ?? MIN_SCORE)).sort((a, b) => {
     const byScore = b.score - a.score;
     if (Math.abs(byScore) > TIEBREAK_EPS) return byScore;
     const byAcceptance = (b.acceptance?.count ?? 0) - (a.acceptance?.count ?? 0);
@@ -8185,9 +8185,9 @@ var init_keytar = __esm({
   }
 });
 
-// node-file:/Users/ericgang/job-placement-inline/node_modules/keytar/build/Release/keytar.node
+// node-file:/Users/ericgang/job-placement-inline/.claude/worktrees/agent-a0bc554500876cd51/node_modules/keytar/build/Release/keytar.node
 var require_keytar = __commonJS({
-  "node-file:/Users/ericgang/job-placement-inline/node_modules/keytar/build/Release/keytar.node"(exports, module) {
+  "node-file:/Users/ericgang/job-placement-inline/.claude/worktrees/agent-a0bc554500876cd51/node_modules/keytar/build/Release/keytar.node"(exports, module) {
     "use strict";
     init_keytar();
     try {
@@ -8239,6 +8239,8 @@ var require_keytar2 = __commonJS({
 // src/repo-policy.ts
 var repo_policy_exports = {};
 __export(repo_policy_exports, {
+  POLICY_RULESET_VERSION: () => POLICY_RULESET_VERSION,
+  auditContent: () => auditContent,
   checkRepoPolicy: () => checkRepoPolicy
 });
 async function fetchContentsFile(fetchImpl, repoFullName, path) {
@@ -8260,23 +8262,50 @@ async function fetchContentsFile(fetchImpl, repoFullName, path) {
     return { ok: false, missing: false, content: null };
   }
 }
-function findHits(file, content) {
-  const lines = content.split("\n");
+function classifyLine(line) {
+  if (PROHIBITED_PATTERNS.some((re) => re.test(line))) return "prohibited";
+  if (DISCLOSURE_PATTERNS.some((re) => re.test(line))) return "disclosure-required";
+  if (AI_SIGNAL_PATTERNS.some((p) => p.re.test(line))) return "ai-mentioned";
+  return null;
+}
+function sanitizeExcerpt(text) {
+  return text.replace(/[\x00-\x08\x0B-\x1F\x7F-\x9F]/g, "");
+}
+function excerptAround(lines, i) {
+  const start = Math.max(0, i - 2);
+  const end = Math.min(lines.length, i + 3);
+  return sanitizeExcerpt(lines.slice(start, end).join("\n"));
+}
+function auditContent(files) {
   const hits = [];
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    if (!AI_SIGNAL_PATTERNS.some((p) => p.re.test(line))) continue;
-    const start = Math.max(0, i - 2);
-    const end = Math.min(lines.length, i + 3);
-    hits.push({ file, excerpt: lines.slice(start, end).join("\n") });
+  const requirements = [];
+  const seenKinds = /* @__PURE__ */ new Set();
+  for (const { file, content } of files) {
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const rule = classifyLine(lines[i]);
+      if (rule) hits.push({ file, excerpt: excerptAround(lines, i), rule });
+      for (const { kind, re } of REQUIREMENT_PATTERNS) {
+        if (seenKinds.has(kind) || !re.test(lines[i])) continue;
+        seenKinds.add(kind);
+        requirements.push({ kind, file, excerpt: excerptAround(lines, i) });
+      }
+    }
   }
-  return hits;
+  let verdict = "clean";
+  for (const h of hits) {
+    if (verdict === "clean" || VERDICT_SEVERITY[h.rule] > VERDICT_SEVERITY[verdict]) {
+      verdict = h.rule;
+    }
+  }
+  const assignment = seenKinds.has("take-bot") ? "take-bot" : seenKinds.has("assignment-required") ? "required" : "none";
+  return { hits, requirements, verdict, assignment };
 }
 async function checkRepoPolicy(repoFullName, opts = {}) {
   const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
   let requestsUsed = 0;
   let hadError = false;
-  const hits = [];
+  const files = [];
   outer: for (const group of CANDIDATE_GROUPS) {
     for (const path of group) {
       if (requestsUsed >= MAX_REQUESTS) break outer;
@@ -8287,21 +8316,27 @@ async function checkRepoPolicy(repoFullName, opts = {}) {
         continue;
       }
       if (outcome.missing) continue;
-      if (outcome.content) hits.push(...findHits(path, outcome.content));
+      if (outcome.content) files.push({ file: path, content: outcome.content });
       break;
     }
   }
-  if (hits.length > 0) return { status: "flagged", hits };
-  if (hadError) return { status: "unavailable", hits: [] };
-  return { status: "clean", hits: [] };
+  const { hits, requirements, verdict, assignment } = auditContent(files);
+  if (hits.length > 0) {
+    return { status: "flagged", verdict, hits, requirements, assignment, rulesetVersion: POLICY_RULESET_VERSION };
+  }
+  if (hadError) {
+    return { status: "unavailable", verdict: "unavailable", hits: [], requirements, assignment, rulesetVersion: POLICY_RULESET_VERSION };
+  }
+  return { status: "clean", verdict: "clean", hits: [], requirements, assignment, rulesetVersion: POLICY_RULESET_VERSION };
 }
-var GH_API, GH_HEADERS, MAX_REQUESTS, AI_SIGNAL_PATTERNS, CANDIDATE_GROUPS;
+var GH_API, GH_HEADERS, MAX_REQUESTS, POLICY_RULESET_VERSION, AI_SIGNAL_PATTERNS, AI_TERM, PROHIBITED_PATTERNS, DISCLOSURE_PATTERNS, REQUIREMENT_PATTERNS, CANDIDATE_GROUPS, VERDICT_SEVERITY;
 var init_repo_policy = __esm({
   "src/repo-policy.ts"() {
     "use strict";
     GH_API = "https://api.github.com";
     GH_HEADERS = { "User-Agent": "terminalhire-claim", Accept: "application/vnd.github+json" };
     MAX_REQUESTS = 4;
+    POLICY_RULESET_VERSION = 2;
     AI_SIGNAL_PATTERNS = [
       { label: "AI", re: /\bAI\b/i },
       { label: "artificial intelligence", re: /artificial intelligence/i },
@@ -8313,11 +8348,47 @@ var init_repo_policy = __esm({
       { label: "generative", re: /\bgenerative\b/i },
       { label: "machine-generated", re: /machine[\s-]generated/i }
     ];
+    AI_TERM = "(?:ai|llms?|generative(?:\\s+ai)?|artificial intelligence|language models?|copilot|chatgpt|claude|machine[\\s-]generated)";
+    PROHIBITED_PATTERNS = [
+      new RegExp(`prohibit\\w*[^.\\n]{0,60}\\b${AI_TERM}`, "i"),
+      /did not write the code yourself/i,
+      new RegExp(`(?:not|never|don'?t|won'?t)\\s+accept\\w*[^.\\n]{0,60}\\b${AI_TERM}`, "i"),
+      new RegExp(`\\bno\\s+${AI_TERM}[^.\\n]{0,40}\\b(?:prs?|pull requests?|contributions?|code|patch(?:es)?|commits?|submissions?)\\b`, "i"),
+      new RegExp(
+        `\\b${AI_TERM}[^.\\n]{0,60}\\b(?:is|are|will be)\\s+(?:\\w+\\s+)?(?:not accepted|not allowed|banned|rejected|removed|closed|reverted|prohibited|forbidden)`,
+        "i"
+      )
+    ];
+    DISCLOSURE_PATTERNS = [
+      new RegExp(`disclos\\w+[^.\\n]{0,60}\\b${AI_TERM}`, "i"),
+      new RegExp(`\\b${AI_TERM}[^.\\n]{0,60}disclos`, "i"),
+      new RegExp(`\\b${AI_TERM}[\\s-]assist\\w*[^.\\n]{0,60}\\b(?:must|should|required?)\\b`, "i"),
+      // PR-template checkbox, e.g. "- [ ] I used AI tools and have reviewed the output"
+      new RegExp(`\\[ \\][^\\n]{0,80}\\b${AI_TERM}`, "i")
+    ];
+    REQUIREMENT_PATTERNS = [
+      // `/take` bot first: its docs usually also say "assign", and the bot is the
+      // more specific expectation (post exactly `/take`, not a prose request).
+      { kind: "take-bot", re: /(?:^|[\s`"'(])\/take\b/m },
+      { kind: "assignment-required", re: /(?:request|ask|wait)[^.\n]{0,40}\bassign/i },
+      { kind: "assignment-required", re: /\bassigned before\b/i },
+      { kind: "assignment-required", re: /\bself[\s-]assign/i },
+      { kind: "assignment-required", re: /do not (?:open|submit)[^.\n]{0,40}\b(?:prs?|pull requests?)\b/i },
+      { kind: "cla-required", re: /\bCLA\b/ },
+      { kind: "cla-required", re: /contributor licen[cs]e agreement/i },
+      { kind: "discussion-first", re: /open an issue (?:first|before)/i },
+      { kind: "discussion-first", re: /discuss\w*[^.\n]{0,40}\bbefore\b/i }
+    ];
     CANDIDATE_GROUPS = [
       ["CONTRIBUTING.md", ".github/CONTRIBUTING.md", "docs/CONTRIBUTING.md"],
-      [".github/PULL_REQUEST_TEMPLATE.md", "PULL_REQUEST_TEMPLATE.md"],
-      ["AGENTS.md"]
+      ["AGENTS.md", "AGENTS.MD"],
+      [".github/PULL_REQUEST_TEMPLATE.md", "PULL_REQUEST_TEMPLATE.md"]
     ];
+    VERDICT_SEVERITY = {
+      "ai-mentioned": 1,
+      "disclosure-required": 2,
+      prohibited: 3
+    };
   }
 });
 
@@ -9010,17 +9081,38 @@ function buildSubmitBody(issueNumber, opts = {}) {
   return `${closesLine}${main}${AI_DISCLOSURE_NOTE}`;
 }
 function printPolicySection(policy) {
-  if (policy.status === "flagged") {
+  const verdict = policy.verdict ?? (policy.status === "flagged" ? "ai-mentioned" : policy.status);
+  if (verdict === "prohibited") {
+    console.log("\n  POLICY: \u2717 this repo PROHIBITS AI-generated contributions \u2014 READ BEFORE CLAIMING:");
+  } else if (verdict === "disclosure-required") {
+    console.log("\n  POLICY: \u26A0 this repo requires disclosing AI assistance \u2014 READ BEFORE WORKING:");
+  } else if (verdict === "ai-mentioned") {
     console.log("\n  POLICY: \u26A0 possible AI-assistance policy language found \u2014 READ BEFORE WORKING:");
-    for (const hit of policy.hits) {
-      console.log(`    [${hit.file}]`);
-      for (const line of hit.excerpt.split("\n")) console.log(`      ${line}`);
-    }
   } else if (policy.status === "unavailable") {
     console.log("\n  POLICY: could not read this repo's CONTRIBUTING/PR-template/AGENTS docs (rate-limited or unreachable) \u2014 read them yourself before working.");
   } else {
     console.log("  policy: no AI-assistance policy language detected in CONTRIBUTING/PR-template/AGENTS docs");
   }
+  for (const hit of policy.hits ?? []) {
+    console.log(`    [${hit.file}]`);
+    for (const line of hit.excerpt.split("\n")) console.log(`      ${line}`);
+  }
+  const requirements = policy.requirements ?? [];
+  if (requirements.length > 0) {
+    console.log("\n  REQUIREMENTS: this repo sets contribution expectations \u2014 in its own words:");
+    for (const req of requirements) {
+      console.log(`    ${req.kind} [${req.file}]`);
+      for (const line of req.excerpt.split("\n")) console.log(`      ${line}`);
+    }
+  }
+  const assignment = policy.assignment ?? "none";
+  if (assignment === "take-bot") {
+    console.log("  assignment: repo self-assigns via a /take comment \u2014 `claim start` will post `/take` on the issue");
+  } else if (assignment === "required") {
+    console.log("  assignment: repo expects you to request assignment \u2014 `claim start` will post a request comment on the issue");
+  } else {
+    console.log("  assignment: no assignment expectation found in repo docs \u2014 `claim start` will not comment (pass --assign to request anyway)");
+  }
 }
 var pExecFile = promisify2(execFile2);
 async function sh(cmd, args, opts = {}) {
@@ -9291,9 +9383,9 @@ async function fetchIssue(repoFullName, issueNumber) {
 }
 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!
+function buildAssignmentComment(repoFullName, opts = {}) {
+  const usesTakeBot = TAKE_BOT_REPOS.has(repoFullName.toLowerCase()) || Boolean(opts.takeBot);
+  const body = usesTakeBot ? "/take" : `Hi! I'd like to work on this issue. Could you assign it to me? Thanks!
 
 ${ASSIGNMENT_MARKER}`;
   return { usesTakeBot, body };
@@ -9314,6 +9406,11 @@ async function hasPriorAssignmentRequest(repoFullName, issueNumber, login) {
     return false;
   }
 }
+function shouldRequestAssignment(claim, flags = {}) {
+  const expectation = claim && claim.policy ? claim.policy.assignment : void 0;
+  const post = Boolean(flags.assign) || expectation === void 0 || expectation === "required" || expectation === "take-bot";
+  return { post, takeBot: expectation === "take-bot" };
+}
 async function requestIssueAssignment(claim, flags = {}, ghUser) {
   if (flags["no-assign"]) {
     console.log("  (--no-assign \u2014 skipping the assignment request; request it manually before working)");
@@ -9322,6 +9419,11 @@ async function requestIssueAssignment(claim, flags = {}, ghUser) {
   const parsed = parseGitHubUrl(claim.issueUrl);
   if (!parsed) return;
   const { repoFullName, number } = parsed;
+  const expectation = shouldRequestAssignment(claim, flags);
+  if (!expectation.post) {
+    console.log("  (no assignment expectation found in repo docs \u2014 pass --assign to request assignment anyway)");
+    return;
+  }
   let login = ghUser;
   if (!login) {
     try {
@@ -9336,11 +9438,21 @@ async function requestIssueAssignment(claim, flags = {}, ghUser) {
     console.log(`  \u2713 Already assigned to @${login} on ${repoFullName}#${number}.`);
     return;
   }
-  const { usesTakeBot, body } = buildAssignmentComment(repoFullName);
+  const { usesTakeBot, body } = buildAssignmentComment(repoFullName, { takeBot: expectation.takeBot });
   if (!usesTakeBot && await hasPriorAssignmentRequest(repoFullName, number, login)) {
     console.log(`  \u2713 Assignment already requested on ${repoFullName}#${number}.`);
     return;
   }
+  if (process.stdin.isTTY) {
+    console.log(`
+  About to comment on ${repoFullName}#${number} as @${login}:`);
+    for (const line of body.split("\n")) console.log(`    ${line}`);
+    const go = await confirm("  Post it? (y/N) ");
+    if (!go) {
+      console.log("  (skipped \u2014 request assignment manually before working)");
+      return;
+    }
+  }
   try {
     await sh("gh", ["issue", "comment", String(number), "--repo", repoFullName, "--body", body]);
     console.log(
@@ -9473,7 +9585,7 @@ function fmtContestedWarning(b) {
 async function cmdRecord(arg, flags = {}) {
   const claims = await Promise.resolve().then(() => (init_claims(), claims_exports));
   if (!arg) {
-    console.error("Usage: terminalhire claim record <bountyId|issueUrl> [--ack-policy] [--ack-contested]");
+    console.error("Usage: terminalhire claim record <bountyId|issueUrl> [--ack-policy] [--ack-policy-prohibited] [--ack-contested]");
     console.error("  Run `terminalhire bounties` first to populate the local index cache,");
     console.error("  then pass the id shown in its output \u2014 or pass a GitHub issue URL directly.");
     process.exit(1);
@@ -9511,8 +9623,25 @@ ${contestedWarning}`);
   const policy = await checkRepoPolicy2(b.repoFullName);
   printPolicySection(policy);
   let ackedAt = null;
-  if (policy.status === "flagged" || policy.status === "unavailable") {
-    const reason = policy.status === "flagged" ? "This repo may prohibit AI-generated contributions" : "This repo's contribution policy could not be checked";
+  if (policy.verdict === "prohibited") {
+    let acked = Boolean(flags["ack-policy-prohibited"]);
+    if (!acked && process.stdin.isTTY) {
+      acked = await confirm(
+        "\n  This repo PROHIBITS AI-generated contributions \u2014 continuing means everything you submit must be hand-written by you. Continue? (y/N) "
+      );
+    }
+    if (!acked) {
+      console.error(
+        `
+terminalhire claim: refusing to record \u2014 ${b.repoFullName} prohibits AI-generated contributions.
+  Read the excerpts above. If you will hand-write the work yourself, re-run with
+  --ack-policy-prohibited (or confirm interactively). --ack-policy is not enough here.`
+      );
+      process.exit(1);
+    }
+    ackedAt = (/* @__PURE__ */ new Date()).toISOString();
+  } else if (policy.status === "flagged" || policy.status === "unavailable") {
+    const reason = policy.status === "flagged" ? "This repo has AI-assistance policy language" : "This repo's contribution policy could not be checked";
     let acked = Boolean(flags["ack-policy"]);
     if (!acked && process.stdin.isTTY) {
       acked = await confirm(`
@@ -9542,7 +9671,18 @@ terminalhire claim: refusing to record \u2014 read ${b.repoFullName}'s contribut
       amountUSD: b.amountUSD,
       openPRsAtClaim: b.openPRs,
       kind,
-      policy: { status: policy.status, ackedAt }
+      // Persist the full audit verdict (not just the coarse status) so `claim
+      // start` can drive the assignment decision from it and `claim audit` can
+      // show what ruleset the dev acknowledged. Excerpts are NOT persisted —
+      // the record stores the conclusion; the docs stay the source of truth.
+      policy: {
+        status: policy.status,
+        verdict: policy.verdict,
+        assignment: policy.assignment,
+        requirements: (policy.requirements ?? []).map((r) => r.kind),
+        rulesetVersion: policy.rulesetVersion,
+        ackedAt
+      }
     });
   } catch (err) {
     console.error(`terminalhire claim: ${err.message ?? err}`);
@@ -9604,7 +9744,14 @@ async function cmdPreview(arg, { json } = {}) {
         openPRs: b.openPRs,
         assignees: b.assignees,
         contested: isContested(b),
-        policy: { status: policy.status, hits: policy.hits }
+        policy: {
+          status: policy.status,
+          verdict: policy.verdict,
+          assignment: policy.assignment,
+          rulesetVersion: policy.rulesetVersion,
+          hits: policy.hits,
+          requirements: policy.requirements
+        }
       }) + "\n"
     );
     return;
@@ -10736,6 +10883,7 @@ export {
   run,
   selectCompetingPrs,
   selectPushRemote,
+  shouldRequestAssignment,
   startBranchFor,
   workDirFor
 };