terminalhire 0.41.0 → 0.41.1

package/dist/bin/jpi-claim.js

@@ -26056,6 +26056,13 @@ function openInBrowser(url) {
   }
 }
 
+// bin/sanitize.js
+var CONTROL_CHARS = /[\x00-\x1f\x7f-\x9f]/g;
+function sanitizeText(s) {
+  if (s == null) return "";
+  return String(s).replace(CONTROL_CHARS, "");
+}
+
 // src/policy-acks.ts
 init_state_dir();
 import { lstatSync, readFileSync as readFileSync2, writeFileSync } from "fs";
@@ -28307,35 +28314,61 @@ async function ensureForkExists(repoFullName, ghUser) {
   if (!isFork) throw new Error(`fork ${forkFullName} created but could not be verified as a fork`);
   return forkFullName;
 }
+function shouldStatePending(claim, approvalsChecked) {
+  return Boolean(claim?.approval) && claim.approval.state === "pending" && Boolean(approvalsChecked);
+}
+function startableRow(c) {
+  const bits = [fmtClaimAmount(c), sanitizeText(c.title)];
+  if (c.repoFullName) bits.push(sanitizeText(c.repoFullName));
+  return bits.join(" \xB7 ");
+}
+async function pickStartableClaim(claims, { prompt = ask, isTTY = process.stdin.isTTY } = {}) {
+  const active = claims.listClaims({ active: true });
+  await syncFounderApprovals(claims, active);
+  const startable = claims.listClaims({ active: true }).filter((c) => c.state === "claimed");
+  if (startable.length === 0) {
+    console.log("No claims ready to start. Claim one first:  terminalhire claim <ref>");
+    return null;
+  }
+  const interactive = Boolean(isTTY);
+  console.log(`
+${startable.length} claim${startable.length === 1 ? "" : "s"} ready to start:
+`);
+  const width = String(startable.length).length;
+  startable.forEach((c, i) => {
+    console.log(`  ${String(i + 1).padStart(width)}) ${startableRow(c)}`);
+    if (!interactive) console.log(`     terminalhire claim start ${c.id}`);
+  });
+  if (!interactive) {
+    console.log("\nRun the command under the one you want to start.");
+    return null;
+  }
+  const answer = await prompt(`
+Which one? (1-${startable.length}, or q to quit) `);
+  if (answer === "" || /^q(uit)?$/i.test(answer)) return null;
+  const n = Number.parseInt(answer, 10);
+  if (!/^\d+$/.test(answer) || !Number.isInteger(n) || n < 1 || n > startable.length) {
+    console.log(`
+Nothing started \u2014 '${answer}' is not one of 1-${startable.length}.`);
+    return null;
+  }
+  return startable[n - 1].id;
+}
 async function cmdStart(id, flags = {}) {
   const claims = await Promise.resolve().then(() => (init_claims(), claims_exports));
   if (!id) {
-    let list = claims.listClaims({ active: true });
-    await syncFounderApprovals(claims, list);
-    const startable = claims.listClaims({ active: true }).filter((c) => c.state === "claimed");
-    if (startable.length === 0) {
-      console.log("No claims ready to start. Claim one first:  terminalhire claim <ref>");
-      return;
-    }
-    console.log(
-      `
-${startable.length} claim${startable.length === 1 ? "" : "s"} ready to start:
-`
-    );
-    for (const c of startable) {
-      console.log(`  ${c.title}`);
-      console.log(`    terminalhire claim start ${c.id}`);
-    }
-    console.log("\nRun the command under the one you want to start.");
-    return;
+    const picked = await pickStartableClaim(claims);
+    if (!picked) return;
+    id = picked;
   }
   let claim = claims.findClaim(id);
   if (!claim) {
     console.error(`terminalhire claim: no claim with id '${id}'.`);
     process.exit(1);
   }
+  let approvalsChecked = false;
   if (claim.approval?.state === "pending") {
-    await syncFounderApprovals(claims, [claim]);
+    ({ approvalsChecked } = await syncFounderApprovals(claims, [claim]));
     claim = claims.findClaim(id);
   }
   if (claim.worktreePath) {
@@ -28356,19 +28389,14 @@ When it's done:  terminalhire claim submit ${id}`);
   }
   if (claim.approval) {
     console.log(`
-${claim.title}`);
-    if (claim.approval.state === "pending") {
-      console.log(
-        "\n  Access is pending \u2014 this approval-only posting needs the founder to approve"
-      );
-      console.log("  your claim before any work can be delivered. No fork was attempted: founder");
-      console.log("  postings are never forked or cloned; once approved, your work slice is");
-      console.log("  delivered through terminalhire.");
-    } else {
-      console.log("\n  No fork was attempted \u2014 founder postings are never forked or cloned. Your");
-      console.log("  work slice is delivered through terminalhire, and your patch goes back the");
-      console.log("  same way.");
-    }
+${sanitizeText(claim.title)}`);
+    console.log("\n  No fork was attempted \u2014 founder postings are never forked or cloned. Your");
+    console.log("  work slice is delivered through terminalhire, and your patch goes back the");
+    console.log("  same way.");
+    if (shouldStatePending(claim, approvalsChecked)) {
+      console.log("\n  Access is pending \u2014 the founder has not approved your claim yet.");
+    }
+    printNextSteps([claim]);
     return;
   }
   if (flags.here) {
@@ -28618,10 +28646,10 @@ var CLAIM_EVENT_LABEL = {
   rejected: "the founder rejected"
 };
 var LINE_BREAKS = /\r\n|[\r\n\v\f\u0085\u2028\u2029]/;
-var CONTROL_CHARS = /[\u0000-\u001F\u007F-\u009F]/g;
+var CONTROL_CHARS2 = /[\u0000-\u001F\u007F-\u009F]/g;
 function terminalSafeLines(raw) {
   if (typeof raw !== "string" || raw === "") return [];
-  return raw.split(LINE_BREAKS).map((l) => l.replace(CONTROL_CHARS, ""));
+  return raw.split(LINE_BREAKS).map((l) => l.replace(CONTROL_CHARS2, ""));
 }
 function terminalSafeInline(raw) {
   return terminalSafeLines(raw).join(" ");
@@ -30066,6 +30094,7 @@ export {
   normalizeIntent,
   pickBodySource,
   pickExistingPr,
+  pickStartableClaim,
   printNextSteps,
   readCredentialDisposition,
   renderClaimHistory,
@@ -30081,6 +30110,7 @@ export {
   selectCompetingPrs,
   selectPushRemote,
   shouldRequestAssignment,
+  shouldStatePending,
   sliceWorkDirFor,
   stakeDecision,
   startBranchFor,

package/dist/bin/jpi-dispatch.js

@@ -30909,6 +30909,7 @@ __export(jpi_claim_exports, {
   normalizeIntent: () => normalizeIntent,
   pickBodySource: () => pickBodySource,
   pickExistingPr: () => pickExistingPr,
+  pickStartableClaim: () => pickStartableClaim,
   printNextSteps: () => printNextSteps,
   readCredentialDisposition: () => readCredentialDisposition,
   renderClaimHistory: () => renderClaimHistory,
@@ -30924,6 +30925,7 @@ __export(jpi_claim_exports, {
   selectCompetingPrs: () => selectCompetingPrs,
   selectPushRemote: () => selectPushRemote,
   shouldRequestAssignment: () => shouldRequestAssignment,
+  shouldStatePending: () => shouldStatePending,
   sliceWorkDirFor: () => sliceWorkDirFor,
   stakeDecision: () => stakeDecision,
   startBranchFor: () => startBranchFor,
@@ -32890,35 +32892,61 @@ async function ensureForkExists(repoFullName, ghUser) {
   if (!isFork) throw new Error(`fork ${forkFullName} created but could not be verified as a fork`);
   return forkFullName;
 }
+function shouldStatePending(claim, approvalsChecked) {
+  return Boolean(claim?.approval) && claim.approval.state === "pending" && Boolean(approvalsChecked);
+}
+function startableRow(c) {
+  const bits = [fmtClaimAmount(c), sanitizeText(c.title)];
+  if (c.repoFullName) bits.push(sanitizeText(c.repoFullName));
+  return bits.join(" \xB7 ");
+}
+async function pickStartableClaim(claims, { prompt: prompt5 = ask, isTTY = process.stdin.isTTY } = {}) {
+  const active = claims.listClaims({ active: true });
+  await syncFounderApprovals(claims, active);
+  const startable = claims.listClaims({ active: true }).filter((c) => c.state === "claimed");
+  if (startable.length === 0) {
+    console.log("No claims ready to start. Claim one first:  terminalhire claim <ref>");
+    return null;
+  }
+  const interactive = Boolean(isTTY);
+  console.log(`
+${startable.length} claim${startable.length === 1 ? "" : "s"} ready to start:
+`);
+  const width = String(startable.length).length;
+  startable.forEach((c, i) => {
+    console.log(`  ${String(i + 1).padStart(width)}) ${startableRow(c)}`);
+    if (!interactive) console.log(`     terminalhire claim start ${c.id}`);
+  });
+  if (!interactive) {
+    console.log("\nRun the command under the one you want to start.");
+    return null;
+  }
+  const answer = await prompt5(`
+Which one? (1-${startable.length}, or q to quit) `);
+  if (answer === "" || /^q(uit)?$/i.test(answer)) return null;
+  const n = Number.parseInt(answer, 10);
+  if (!/^\d+$/.test(answer) || !Number.isInteger(n) || n < 1 || n > startable.length) {
+    console.log(`
+Nothing started \u2014 '${answer}' is not one of 1-${startable.length}.`);
+    return null;
+  }
+  return startable[n - 1].id;
+}
 async function cmdStart(id, flags = {}) {
   const claims = await Promise.resolve().then(() => (init_claims(), claims_exports));
   if (!id) {
-    let list = claims.listClaims({ active: true });
-    await syncFounderApprovals(claims, list);
-    const startable = claims.listClaims({ active: true }).filter((c) => c.state === "claimed");
-    if (startable.length === 0) {
-      console.log("No claims ready to start. Claim one first:  terminalhire claim <ref>");
-      return;
-    }
-    console.log(
-      `
-${startable.length} claim${startable.length === 1 ? "" : "s"} ready to start:
-`
-    );
-    for (const c of startable) {
-      console.log(`  ${c.title}`);
-      console.log(`    terminalhire claim start ${c.id}`);
-    }
-    console.log("\nRun the command under the one you want to start.");
-    return;
+    const picked = await pickStartableClaim(claims);
+    if (!picked) return;
+    id = picked;
   }
   let claim = claims.findClaim(id);
   if (!claim) {
     console.error(`terminalhire claim: no claim with id '${id}'.`);
     process.exit(1);
   }
+  let approvalsChecked = false;
   if (claim.approval?.state === "pending") {
-    await syncFounderApprovals(claims, [claim]);
+    ({ approvalsChecked } = await syncFounderApprovals(claims, [claim]));
     claim = claims.findClaim(id);
   }
   if (claim.worktreePath) {
@@ -32939,19 +32967,14 @@ When it's done:  terminalhire claim submit ${id}`);
   }
   if (claim.approval) {
     console.log(`
-${claim.title}`);
-    if (claim.approval.state === "pending") {
-      console.log(
-        "\n  Access is pending \u2014 this approval-only posting needs the founder to approve"
-      );
-      console.log("  your claim before any work can be delivered. No fork was attempted: founder");
-      console.log("  postings are never forked or cloned; once approved, your work slice is");
-      console.log("  delivered through terminalhire.");
-    } else {
-      console.log("\n  No fork was attempted \u2014 founder postings are never forked or cloned. Your");
-      console.log("  work slice is delivered through terminalhire, and your patch goes back the");
-      console.log("  same way.");
-    }
+${sanitizeText(claim.title)}`);
+    console.log("\n  No fork was attempted \u2014 founder postings are never forked or cloned. Your");
+    console.log("  work slice is delivered through terminalhire, and your patch goes back the");
+    console.log("  same way.");
+    if (shouldStatePending(claim, approvalsChecked)) {
+      console.log("\n  Access is pending \u2014 the founder has not approved your claim yet.");
+    }
+    printNextSteps([claim]);
     return;
   }
   if (flags.here) {
@@ -34599,6 +34622,7 @@ var init_jpi_claim = __esm({
     "use strict";
     init_src();
     init_open_url();
+    init_sanitize();
     init_policy_acks();
     init_claims();
     init_state_dir();

package/dist/bin/jpi-mcp.js

@@ -10977,6 +10977,19 @@ var init_open_url = __esm({
   }
 });
 
+// bin/sanitize.js
+function sanitizeText(s) {
+  if (s == null) return "";
+  return String(s).replace(CONTROL_CHARS, "");
+}
+var CONTROL_CHARS;
+var init_sanitize = __esm({
+  "bin/sanitize.js"() {
+    "use strict";
+    CONTROL_CHARS = /[\x00-\x1f\x7f-\x9f]/g;
+  }
+});
+
 // src/policy-acks.ts
 var policy_acks_exports = {};
 __export(policy_acks_exports, {
@@ -26374,6 +26387,7 @@ __export(jpi_claim_exports, {
   normalizeIntent: () => normalizeIntent,
   pickBodySource: () => pickBodySource,
   pickExistingPr: () => pickExistingPr,
+  pickStartableClaim: () => pickStartableClaim,
   printNextSteps: () => printNextSteps,
   readCredentialDisposition: () => readCredentialDisposition,
   renderClaimHistory: () => renderClaimHistory,
@@ -26389,6 +26403,7 @@ __export(jpi_claim_exports, {
   selectCompetingPrs: () => selectCompetingPrs,
   selectPushRemote: () => selectPushRemote,
   shouldRequestAssignment: () => shouldRequestAssignment,
+  shouldStatePending: () => shouldStatePending,
   sliceWorkDirFor: () => sliceWorkDirFor,
   stakeDecision: () => stakeDecision,
   startBranchFor: () => startBranchFor,
@@ -28355,35 +28370,61 @@ async function ensureForkExists(repoFullName, ghUser) {
   if (!isFork) throw new Error(`fork ${forkFullName} created but could not be verified as a fork`);
   return forkFullName;
 }
+function shouldStatePending(claim, approvalsChecked) {
+  return Boolean(claim?.approval) && claim.approval.state === "pending" && Boolean(approvalsChecked);
+}
+function startableRow(c) {
+  const bits = [fmtClaimAmount(c), sanitizeText(c.title)];
+  if (c.repoFullName) bits.push(sanitizeText(c.repoFullName));
+  return bits.join(" \xB7 ");
+}
+async function pickStartableClaim(claims, { prompt = ask, isTTY = process.stdin.isTTY } = {}) {
+  const active = claims.listClaims({ active: true });
+  await syncFounderApprovals(claims, active);
+  const startable = claims.listClaims({ active: true }).filter((c) => c.state === "claimed");
+  if (startable.length === 0) {
+    console.log("No claims ready to start. Claim one first:  terminalhire claim <ref>");
+    return null;
+  }
+  const interactive = Boolean(isTTY);
+  console.log(`
+${startable.length} claim${startable.length === 1 ? "" : "s"} ready to start:
+`);
+  const width = String(startable.length).length;
+  startable.forEach((c, i) => {
+    console.log(`  ${String(i + 1).padStart(width)}) ${startableRow(c)}`);
+    if (!interactive) console.log(`     terminalhire claim start ${c.id}`);
+  });
+  if (!interactive) {
+    console.log("\nRun the command under the one you want to start.");
+    return null;
+  }
+  const answer = await prompt(`
+Which one? (1-${startable.length}, or q to quit) `);
+  if (answer === "" || /^q(uit)?$/i.test(answer)) return null;
+  const n = Number.parseInt(answer, 10);
+  if (!/^\d+$/.test(answer) || !Number.isInteger(n) || n < 1 || n > startable.length) {
+    console.log(`
+Nothing started \u2014 '${answer}' is not one of 1-${startable.length}.`);
+    return null;
+  }
+  return startable[n - 1].id;
+}
 async function cmdStart(id, flags = {}) {
   const claims = await Promise.resolve().then(() => (init_claims(), claims_exports));
   if (!id) {
-    let list = claims.listClaims({ active: true });
-    await syncFounderApprovals(claims, list);
-    const startable = claims.listClaims({ active: true }).filter((c) => c.state === "claimed");
-    if (startable.length === 0) {
-      console.log("No claims ready to start. Claim one first:  terminalhire claim <ref>");
-      return;
-    }
-    console.log(
-      `
-${startable.length} claim${startable.length === 1 ? "" : "s"} ready to start:
-`
-    );
-    for (const c of startable) {
-      console.log(`  ${c.title}`);
-      console.log(`    terminalhire claim start ${c.id}`);
-    }
-    console.log("\nRun the command under the one you want to start.");
-    return;
+    const picked = await pickStartableClaim(claims);
+    if (!picked) return;
+    id = picked;
   }
   let claim = claims.findClaim(id);
   if (!claim) {
     console.error(`terminalhire claim: no claim with id '${id}'.`);
     process.exit(1);
   }
+  let approvalsChecked = false;
   if (claim.approval?.state === "pending") {
-    await syncFounderApprovals(claims, [claim]);
+    ({ approvalsChecked } = await syncFounderApprovals(claims, [claim]));
     claim = claims.findClaim(id);
   }
   if (claim.worktreePath) {
@@ -28404,19 +28445,14 @@ When it's done:  terminalhire claim submit ${id}`);
   }
   if (claim.approval) {
     console.log(`
-${claim.title}`);
-    if (claim.approval.state === "pending") {
-      console.log(
-        "\n  Access is pending \u2014 this approval-only posting needs the founder to approve"
-      );
-      console.log("  your claim before any work can be delivered. No fork was attempted: founder");
-      console.log("  postings are never forked or cloned; once approved, your work slice is");
-      console.log("  delivered through terminalhire.");
-    } else {
-      console.log("\n  No fork was attempted \u2014 founder postings are never forked or cloned. Your");
-      console.log("  work slice is delivered through terminalhire, and your patch goes back the");
-      console.log("  same way.");
-    }
+${sanitizeText(claim.title)}`);
+    console.log("\n  No fork was attempted \u2014 founder postings are never forked or cloned. Your");
+    console.log("  work slice is delivered through terminalhire, and your patch goes back the");
+    console.log("  same way.");
+    if (shouldStatePending(claim, approvalsChecked)) {
+      console.log("\n  Access is pending \u2014 the founder has not approved your claim yet.");
+    }
+    printNextSteps([claim]);
     return;
   }
   if (flags.here) {
@@ -28654,7 +28690,7 @@ function renderRunView(run3, message) {
 }
 function terminalSafeLines(raw) {
   if (typeof raw !== "string" || raw === "") return [];
-  return raw.split(LINE_BREAKS).map((l) => l.replace(CONTROL_CHARS, ""));
+  return raw.split(LINE_BREAKS).map((l) => l.replace(CONTROL_CHARS2, ""));
 }
 function terminalSafeInline(raw) {
   return terminalSafeLines(raw).join(" ");
@@ -30058,12 +30094,13 @@ async function run() {
     process.exit(1);
   }
 }
-var TERMINALHIRE_DIR11, INDEX_CACHE_FILE2, CLAIM_PUSH_MARKER, REPO_CONTINUITY_NUDGE_MARKER, API_URL, 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, STAKE_MARKER, STANDDOWN_MARKER, OUR_MARKERS, STAKE_POST_TIMEOUT_MS, STAKE_POSTING_GRACE_MS, TAKE_BOT_REPOS, SUBMIT_ACCEPTS, REVISE_RECOVERY_STATES, PUSH_TOKEN_REFUSAL, SYNC_BACKGROUND_PUSH_ACTIVE_FIELD, ISSUE_OUTCOME_TERMINAL, RUNS_POLL_INTERVAL_MS, RUNS_POLL_ATTEMPTS, CLAIM_EVENT_LABEL, LINE_BREAKS, CONTROL_CHARS;
+var TERMINALHIRE_DIR11, INDEX_CACHE_FILE2, CLAIM_PUSH_MARKER, REPO_CONTINUITY_NUDGE_MARKER, API_URL, 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, STAKE_MARKER, STANDDOWN_MARKER, OUR_MARKERS, STAKE_POST_TIMEOUT_MS, STAKE_POSTING_GRACE_MS, TAKE_BOT_REPOS, SUBMIT_ACCEPTS, REVISE_RECOVERY_STATES, PUSH_TOKEN_REFUSAL, SYNC_BACKGROUND_PUSH_ACTIVE_FIELD, ISSUE_OUTCOME_TERMINAL, RUNS_POLL_INTERVAL_MS, RUNS_POLL_ATTEMPTS, CLAIM_EVENT_LABEL, LINE_BREAKS, CONTROL_CHARS2;
 var init_jpi_claim = __esm({
   "bin/jpi-claim.js"() {
     "use strict";
     init_src();
     init_open_url();
+    init_sanitize();
     init_policy_acks();
     init_claims();
     init_state_dir();
@@ -30126,7 +30163,7 @@ var init_jpi_claim = __esm({
       rejected: "the founder rejected"
     };
     LINE_BREAKS = /\r\n|[\r\n\v\f\u0085\u2028\u2029]/;
-    CONTROL_CHARS = /[\u0000-\u001F\u007F-\u009F]/g;
+    CONTROL_CHARS2 = /[\u0000-\u001F\u007F-\u009F]/g;
   }
 });
 

package/dist/bin/jpi-statusline.js

@@ -92,7 +92,7 @@ function render() {
     const founderOpen = founderOpenCount(entry);
     const stale = sessionStale(entry) && unread === 0 && incoming === 0;
     const segments = [];
-    if (approved > 0) segments.push(`\u2705 ${approved} approved \u2014 run: th claim list`);
+    if (approved > 0) segments.push(`\u2705 ${approved} approved \u2014 run: th claim start`);
     if (founderNeedsYou > 0) {
       segments.push(
         `\u{1F9ED} ${founderNeedsYou} claim${founderNeedsYou === 1 ? "" : "s"} await your decision \u2014 run: th bounties`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminalhire",
-  "version": "0.41.0",
+  "version": "0.41.1",
   "description": "Local-first job matching for developers — ambient job matches in the Claude Code spinner. Your profile never leaves your machine.",
   "repository": {
     "type": "git",