terminalhire 0.40.3 → 0.40.5

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

@@ -90,6 +90,7 @@ var init_state_dir = __esm({
 // src/claims.ts
 var claims_exports = {};
 __export(claims_exports, {
+  CLAIM_STATES: () => CLAIM_STATES,
   PUSHED_CLAIM_FIELDS: () => PUSHED_CLAIM_FIELDS,
   acceptedPRRate: () => acceptedPRRate,
   countAwaitingFounderApproval: () => countAwaitingFounderApproval,
@@ -288,7 +289,7 @@ function acceptedPRRate(claims = readClaims()) {
   const merged = claims.filter((c) => c.state === "merged").length;
   return { merged, total, rate: total === 0 ? 0 : merged / total };
 }
-var TERMINALHIRE_DIR3, CLAIMS_FILE, LOCK_DIR, LOCK_STALE_MS, LOCK_RETRY_MS, LOCK_TIMEOUT_MS, PUSHED_CLAIM_FIELDS, TERMINAL_STATES, POLL_TRANSITIONS;
+var TERMINALHIRE_DIR3, CLAIMS_FILE, LOCK_DIR, LOCK_STALE_MS, LOCK_RETRY_MS, LOCK_TIMEOUT_MS, CLAIM_STATES, PUSHED_CLAIM_FIELDS, TERMINAL_STATES, POLL_TRANSITIONS;
 var init_claims = __esm({
   "src/claims.ts"() {
     "use strict";
@@ -299,6 +300,22 @@ var init_claims = __esm({
     LOCK_STALE_MS = Number(process.env.TERMINALHIRE_LOCK_STALE_MS) || 1e4;
     LOCK_RETRY_MS = Number(process.env.TERMINALHIRE_LOCK_RETRY_MS) || 25;
     LOCK_TIMEOUT_MS = Number(process.env.TERMINALHIRE_LOCK_TIMEOUT_MS) || 5e3;
+    CLAIM_STATES = Object.freeze([
+      "claimed",
+      // recorded, not started
+      "working",
+      // background executor running / work in progress
+      "in-review",
+      // gate ran / dev reviewing the diff
+      "ready",
+      // passed review, cleared to submit
+      "submitted",
+      // PR opened on the source platform (awaiting maintainer)
+      "merged",
+      // PR merged — accepted; counts toward the metric
+      "abandoned"
+      // released, or PR closed unmerged
+    ]);
     PUSHED_CLAIM_FIELDS = [
       "kind",
       "repoFullName",

package/dist/bin/jpi-bounties.js

@@ -10618,6 +10618,14 @@ function warnStderr(message) {
   process.stderr.write(`${message}
 `);
 }
+function makeWarnOnce() {
+  const seen = /* @__PURE__ */ new Set();
+  return (message) => {
+    if (seen.has(message)) return;
+    seen.add(message);
+    warnStderr(message);
+  };
+}
 function atomicWriteFileSync(filePath, content) {
   const dir = dirname(filePath);
   ensureStateDirForSecret(dir);
@@ -10663,11 +10671,11 @@ async function deleteKey() {
     if (e.code !== "ENOENT") throw e;
   }
 }
-async function resolveKey(filePath, opts) {
+async function resolveKey(filePath, opts, warnOnce) {
   if (opts.keyPolicy === "keychain-required") {
     const key = await tryLoadFromKeytar();
     if (!key) {
-      warnStderr(
+      warnOnce(
         `crypto-store: OS keychain unavailable \u2014 store at ${filePath} is disabled (no plaintext key file will be written)`
       );
       return null;
@@ -10677,8 +10685,9 @@ async function resolveKey(filePath, opts) {
   return loadOrCreateSharedKey();
 }
 function createEncryptedStore(filePath, opts) {
+  const warnOnce = makeWarnOnce();
   async function read() {
-    const key = await resolveKey(filePath, opts);
+    const key = await resolveKey(filePath, opts, warnOnce);
     if (!key) return opts.blank();
     if (!existsSync3(filePath)) return opts.blank();
     try {
@@ -10687,12 +10696,12 @@ function createEncryptedStore(filePath, opts) {
       const plaintext = decrypt(blob, key);
       return JSON.parse(plaintext);
     } catch {
-      warnStderr(`crypto-store: failed to decrypt ${filePath} \u2014 returning blank`);
+      warnOnce(`crypto-store: failed to decrypt ${filePath} \u2014 returning blank`);
       return opts.blank();
     }
   }
   async function write(value) {
-    const key = await resolveKey(filePath, opts);
+    const key = await resolveKey(filePath, opts, warnOnce);
     if (!key) return;
     const blob = encrypt(JSON.stringify(value), key);
     atomicWriteFileSync(filePath, JSON.stringify(blob, null, 2));
@@ -11122,6 +11131,7 @@ var init_repo_experience = __esm({
 // src/claims.ts
 var claims_exports = {};
 __export(claims_exports, {
+  CLAIM_STATES: () => CLAIM_STATES,
   PUSHED_CLAIM_FIELDS: () => PUSHED_CLAIM_FIELDS,
   acceptedPRRate: () => acceptedPRRate,
   countAwaitingFounderApproval: () => countAwaitingFounderApproval,
@@ -11320,7 +11330,7 @@ function acceptedPRRate(claims = readClaims()) {
   const merged = claims.filter((c) => c.state === "merged").length;
   return { merged, total, rate: total === 0 ? 0 : merged / total };
 }
-var TERMINALHIRE_DIR5, CLAIMS_FILE, LOCK_DIR, LOCK_STALE_MS, LOCK_RETRY_MS, LOCK_TIMEOUT_MS, PUSHED_CLAIM_FIELDS, TERMINAL_STATES, POLL_TRANSITIONS;
+var TERMINALHIRE_DIR5, CLAIMS_FILE, LOCK_DIR, LOCK_STALE_MS, LOCK_RETRY_MS, LOCK_TIMEOUT_MS, CLAIM_STATES, PUSHED_CLAIM_FIELDS, TERMINAL_STATES, POLL_TRANSITIONS;
 var init_claims = __esm({
   "src/claims.ts"() {
     "use strict";
@@ -11331,6 +11341,22 @@ var init_claims = __esm({
     LOCK_STALE_MS = Number(process.env.TERMINALHIRE_LOCK_STALE_MS) || 1e4;
     LOCK_RETRY_MS = Number(process.env.TERMINALHIRE_LOCK_RETRY_MS) || 25;
     LOCK_TIMEOUT_MS = Number(process.env.TERMINALHIRE_LOCK_TIMEOUT_MS) || 5e3;
+    CLAIM_STATES = Object.freeze([
+      "claimed",
+      // recorded, not started
+      "working",
+      // background executor running / work in progress
+      "in-review",
+      // gate ran / dev reviewing the diff
+      "ready",
+      // passed review, cleared to submit
+      "submitted",
+      // PR opened on the source platform (awaiting maintainer)
+      "merged",
+      // PR merged — accepted; counts toward the metric
+      "abandoned"
+      // released, or PR closed unmerged
+    ]);
     PUSHED_CLAIM_FIELDS = [
       "kind",
       "repoFullName",

package/dist/bin/jpi-chat.js

@@ -5478,6 +5478,14 @@ function warnStderr(message) {
   process.stderr.write(`${message}
 `);
 }
+function makeWarnOnce() {
+  const seen = /* @__PURE__ */ new Set();
+  return (message) => {
+    if (seen.has(message)) return;
+    seen.add(message);
+    warnStderr(message);
+  };
+}
 function atomicWriteFileSync(filePath, content) {
   const dir = dirname(filePath);
   ensureStateDirForSecret(dir);
@@ -5523,11 +5531,11 @@ async function deleteKey() {
     if (e.code !== "ENOENT") throw e;
   }
 }
-async function resolveKey(filePath, opts) {
+async function resolveKey(filePath, opts, warnOnce) {
   if (opts.keyPolicy === "keychain-required") {
     const key = await tryLoadFromKeytar();
     if (!key) {
-      warnStderr(
+      warnOnce(
         `crypto-store: OS keychain unavailable \u2014 store at ${filePath} is disabled (no plaintext key file will be written)`
       );
       return null;
@@ -5537,8 +5545,9 @@ async function resolveKey(filePath, opts) {
   return loadOrCreateSharedKey();
 }
 function createEncryptedStore(filePath, opts) {
+  const warnOnce = makeWarnOnce();
   async function read() {
-    const key = await resolveKey(filePath, opts);
+    const key = await resolveKey(filePath, opts, warnOnce);
     if (!key) return opts.blank();
     if (!existsSync9(filePath)) return opts.blank();
     try {
@@ -5547,12 +5556,12 @@ function createEncryptedStore(filePath, opts) {
       const plaintext = decrypt2(blob, key);
       return JSON.parse(plaintext);
     } catch {
-      warnStderr(`crypto-store: failed to decrypt ${filePath} \u2014 returning blank`);
+      warnOnce(`crypto-store: failed to decrypt ${filePath} \u2014 returning blank`);
       return opts.blank();
     }
   }
   async function write(value) {
-    const key = await resolveKey(filePath, opts);
+    const key = await resolveKey(filePath, opts, warnOnce);
     if (!key) return;
     const blob = encrypt2(JSON.stringify(value), key);
     atomicWriteFileSync(filePath, JSON.stringify(blob, null, 2));

package/dist/bin/jpi-claim.js

@@ -10431,6 +10431,7 @@ var init_state_dir = __esm({
 // src/claims.ts
 var claims_exports = {};
 __export(claims_exports, {
+  CLAIM_STATES: () => CLAIM_STATES,
   PUSHED_CLAIM_FIELDS: () => PUSHED_CLAIM_FIELDS,
   acceptedPRRate: () => acceptedPRRate,
   countAwaitingFounderApproval: () => countAwaitingFounderApproval,
@@ -10629,7 +10630,7 @@ function acceptedPRRate(claims = readClaims()) {
   const merged = claims.filter((c) => c.state === "merged").length;
   return { merged, total, rate: total === 0 ? 0 : merged / total };
 }
-var TERMINALHIRE_DIR2, CLAIMS_FILE, LOCK_DIR, LOCK_STALE_MS, LOCK_RETRY_MS, LOCK_TIMEOUT_MS, PUSHED_CLAIM_FIELDS, TERMINAL_STATES, POLL_TRANSITIONS;
+var TERMINALHIRE_DIR2, CLAIMS_FILE, LOCK_DIR, LOCK_STALE_MS, LOCK_RETRY_MS, LOCK_TIMEOUT_MS, CLAIM_STATES, PUSHED_CLAIM_FIELDS, TERMINAL_STATES, POLL_TRANSITIONS;
 var init_claims = __esm({
   "src/claims.ts"() {
     "use strict";
@@ -10640,6 +10641,22 @@ var init_claims = __esm({
     LOCK_STALE_MS = Number(process.env.TERMINALHIRE_LOCK_STALE_MS) || 1e4;
     LOCK_RETRY_MS = Number(process.env.TERMINALHIRE_LOCK_RETRY_MS) || 25;
     LOCK_TIMEOUT_MS = Number(process.env.TERMINALHIRE_LOCK_TIMEOUT_MS) || 5e3;
+    CLAIM_STATES = Object.freeze([
+      "claimed",
+      // recorded, not started
+      "working",
+      // background executor running / work in progress
+      "in-review",
+      // gate ran / dev reviewing the diff
+      "ready",
+      // passed review, cleared to submit
+      "submitted",
+      // PR opened on the source platform (awaiting maintainer)
+      "merged",
+      // PR merged — accepted; counts toward the metric
+      "abandoned"
+      // released, or PR closed unmerged
+    ]);
     PUSHED_CLAIM_FIELDS = [
       "kind",
       "repoFullName",
@@ -24814,6 +24831,14 @@ function warnStderr(message) {
   process.stderr.write(`${message}
 `);
 }
+function makeWarnOnce() {
+  const seen = /* @__PURE__ */ new Set();
+  return (message) => {
+    if (seen.has(message)) return;
+    seen.add(message);
+    warnStderr(message);
+  };
+}
 function atomicWriteFileSync(filePath, content) {
   const dir = dirname4(filePath);
   ensureStateDirForSecret(dir);
@@ -24859,11 +24884,11 @@ async function deleteKey() {
     if (e.code !== "ENOENT") throw e;
   }
 }
-async function resolveKey(filePath, opts) {
+async function resolveKey(filePath, opts, warnOnce) {
   if (opts.keyPolicy === "keychain-required") {
     const key = await tryLoadFromKeytar();
     if (!key) {
-      warnStderr(
+      warnOnce(
         `crypto-store: OS keychain unavailable \u2014 store at ${filePath} is disabled (no plaintext key file will be written)`
       );
       return null;
@@ -24873,8 +24898,9 @@ async function resolveKey(filePath, opts) {
   return loadOrCreateSharedKey();
 }
 function createEncryptedStore(filePath, opts) {
+  const warnOnce = makeWarnOnce();
   async function read() {
-    const key = await resolveKey(filePath, opts);
+    const key = await resolveKey(filePath, opts, warnOnce);
     if (!key) return opts.blank();
     if (!existsSync6(filePath)) return opts.blank();
     try {
@@ -24883,12 +24909,12 @@ function createEncryptedStore(filePath, opts) {
       const plaintext = decrypt2(blob, key);
       return JSON.parse(plaintext);
     } catch {
-      warnStderr(`crypto-store: failed to decrypt ${filePath} \u2014 returning blank`);
+      warnOnce(`crypto-store: failed to decrypt ${filePath} \u2014 returning blank`);
       return opts.blank();
     }
   }
   async function write(value) {
-    const key = await resolveKey(filePath, opts);
+    const key = await resolveKey(filePath, opts, warnOnce);
     if (!key) return;
     const blob = encrypt2(JSON.stringify(value), key);
     atomicWriteFileSync(filePath, JSON.stringify(blob, null, 2));
@@ -26705,6 +26731,38 @@ function printMetric(rate) {
   console.log(`
 \u{1F4CA} Accepted-PR rate: ${rate.merged}/${rate.total} claims merged (${pct}%)`);
 }
+var SUBMIT_ACCEPTS = Object.freeze(["working", "ready"]);
+function nextStepFor(c) {
+  const founder = Boolean(c.approval);
+  switch (c.state) {
+    case "claimed":
+      return founder ? { cmd: `terminalhire claim slice ${c.id}`, why: "collect your granted work slice" } : { cmd: `terminalhire claim start ${c.id}`, why: "fork + clone into a worktree" };
+    // NOT grouped with the two below. `cmdSubmit` accepts 'working' and 'ready'
+    // and nothing else, so pointing an 'in-review' claim at submit would hand the
+    // developer a command that exits 1 — and submit's own refusal then advises
+    // `claim start`, which a founder claim can never use either. Two dead ends in
+    // a row is worse than the silence this block replaced.
+    case "in-review":
+      return {
+        cmd: `terminalhire claim update ${c.id} ready`,
+        why: "clear the review gate \u2014 submit only accepts working/ready"
+      };
+    case "working":
+    case "ready":
+      return { cmd: `terminalhire claim submit ${c.id}`, why: "push the branch + open the PR" };
+    case "submitted":
+      return founder ? { cmd: `terminalhire claim runs ${c.id} --watch`, why: "read the CI result" } : { cmd: `terminalhire claim status ${c.id}`, why: "poll the PR merge state" };
+    default:
+      return null;
+  }
+}
+function printNextSteps(list) {
+  const steps = list.map(nextStepFor).filter(Boolean);
+  if (steps.length === 0) return;
+  const width = Math.max(...steps.map((s) => s.cmd.length));
+  console.log("\n  Next:");
+  for (const s of steps) console.log(`    ${s.cmd.padEnd(width)}   \u2014 ${s.why}`);
+}
 async function resolveBounty(arg) {
   let bountyId, title, repoFullName, issueUrl, amountUSD, source, openPRsAtDiscovery, indexNativeId;
   let founderPosting = false;
@@ -27276,6 +27334,7 @@ ${list.length} ${active ? "active " : ""}claim${list.length === 1 ? "" : "s"}:
     console.log(`    id: ${c.id}${pr}`);
   }
   printMetric(claims.acceptedPRRate());
+  printNextSteps(list);
   try {
     if (await shouldNudgeUnpushed()) {
       console.log(
@@ -27424,7 +27483,7 @@ async function cmdStatus(id) {
 }
 async function cmdUpdate(id, state, prUrl) {
   const claims = await Promise.resolve().then(() => (init_claims(), claims_exports));
-  const VALID = ["claimed", "working", "in-review", "ready", "submitted", "merged", "abandoned"];
+  const VALID = claims.CLAIM_STATES;
   if (!id || !state || !VALID.includes(state)) {
     console.error("Usage: terminalhire claim update <id> <state> [prUrl]");
     console.error("  state: " + VALID.join(" | "));
@@ -28284,7 +28343,7 @@ async function cmdSubmit(id, flags = {}) {
     console.error(`terminalhire claim: no claim with id '${id}'.`);
     process.exit(1);
   }
-  if (claim.state !== "working" && claim.state !== "ready") {
+  if (!SUBMIT_ACCEPTS.includes(claim.state)) {
     console.error(
       `terminalhire claim: ${id} is '${claim.state}'. Submit runs once work has started ('working', via 'claim start') or the review gate cleared it ('ready'). Start it first:
   terminalhire claim start ${id}`
@@ -29236,6 +29295,7 @@ async function run() {
 export {
   AI_DISCLOSURE_NOTE,
   CLAIM_CONSENT_VERSION,
+  SUBMIT_ACCEPTS,
   backgroundEnableFailed,
   buildAssignmentComment,
   buildPatchSubmission,
@@ -29261,9 +29321,11 @@ export {
   listMergedPRsReferencingIssue,
   listOpenPRsReferencingIssue,
   matchReferencingPrs,
+  nextStepFor,
   normalizeIntent,
   pickBodySource,
   pickExistingPr,
+  printNextSteps,
   renderRunView,
   renderServerRefusal,
   resolveBounty,

package/dist/bin/jpi-contribute.js

@@ -2742,6 +2742,14 @@ function warnStderr(message) {
   process.stderr.write(`${message}
 `);
 }
+function makeWarnOnce() {
+  const seen = /* @__PURE__ */ new Set();
+  return (message) => {
+    if (seen.has(message)) return;
+    seen.add(message);
+    warnStderr(message);
+  };
+}
 function atomicWriteFileSync(filePath, content) {
   const dir = dirname(filePath);
   ensureStateDirForSecret(dir);
@@ -2787,11 +2795,11 @@ async function deleteKey() {
     if (e.code !== "ENOENT") throw e;
   }
 }
-async function resolveKey(filePath, opts) {
+async function resolveKey(filePath, opts, warnOnce) {
   if (opts.keyPolicy === "keychain-required") {
     const key = await tryLoadFromKeytar();
     if (!key) {
-      warnStderr(
+      warnOnce(
         `crypto-store: OS keychain unavailable \u2014 store at ${filePath} is disabled (no plaintext key file will be written)`
       );
       return null;
@@ -2801,8 +2809,9 @@ async function resolveKey(filePath, opts) {
   return loadOrCreateSharedKey();
 }
 function createEncryptedStore(filePath, opts) {
+  const warnOnce = makeWarnOnce();
   async function read() {
-    const key = await resolveKey(filePath, opts);
+    const key = await resolveKey(filePath, opts, warnOnce);
     if (!key) return opts.blank();
     if (!existsSync4(filePath)) return opts.blank();
     try {
@@ -2811,12 +2820,12 @@ function createEncryptedStore(filePath, opts) {
       const plaintext = decrypt(blob, key);
       return JSON.parse(plaintext);
     } catch {
-      warnStderr(`crypto-store: failed to decrypt ${filePath} \u2014 returning blank`);
+      warnOnce(`crypto-store: failed to decrypt ${filePath} \u2014 returning blank`);
       return opts.blank();
     }
   }
   async function write(value) {
-    const key = await resolveKey(filePath, opts);
+    const key = await resolveKey(filePath, opts, warnOnce);
     if (!key) return;
     const blob = encrypt(JSON.stringify(value), key);
     atomicWriteFileSync(filePath, JSON.stringify(blob, null, 2));
@@ -3515,6 +3524,7 @@ var init_repo_experience = __esm({
 // src/claims.ts
 var claims_exports = {};
 __export(claims_exports, {
+  CLAIM_STATES: () => CLAIM_STATES,
   PUSHED_CLAIM_FIELDS: () => PUSHED_CLAIM_FIELDS,
   acceptedPRRate: () => acceptedPRRate,
   countAwaitingFounderApproval: () => countAwaitingFounderApproval,
@@ -3713,7 +3723,7 @@ function acceptedPRRate(claims = readClaims()) {
   const merged = claims.filter((c) => c.state === "merged").length;
   return { merged, total, rate: total === 0 ? 0 : merged / total };
 }
-var TERMINALHIRE_DIR7, CLAIMS_FILE, LOCK_DIR, LOCK_STALE_MS, LOCK_RETRY_MS, LOCK_TIMEOUT_MS, PUSHED_CLAIM_FIELDS, TERMINAL_STATES, POLL_TRANSITIONS;
+var TERMINALHIRE_DIR7, CLAIMS_FILE, LOCK_DIR, LOCK_STALE_MS, LOCK_RETRY_MS, LOCK_TIMEOUT_MS, CLAIM_STATES, PUSHED_CLAIM_FIELDS, TERMINAL_STATES, POLL_TRANSITIONS;
 var init_claims = __esm({
   "src/claims.ts"() {
     "use strict";
@@ -3724,6 +3734,22 @@ var init_claims = __esm({
     LOCK_STALE_MS = Number(process.env.TERMINALHIRE_LOCK_STALE_MS) || 1e4;
     LOCK_RETRY_MS = Number(process.env.TERMINALHIRE_LOCK_RETRY_MS) || 25;
     LOCK_TIMEOUT_MS = Number(process.env.TERMINALHIRE_LOCK_TIMEOUT_MS) || 5e3;
+    CLAIM_STATES = Object.freeze([
+      "claimed",
+      // recorded, not started
+      "working",
+      // background executor running / work in progress
+      "in-review",
+      // gate ran / dev reviewing the diff
+      "ready",
+      // passed review, cleared to submit
+      "submitted",
+      // PR opened on the source platform (awaiting maintainer)
+      "merged",
+      // PR merged — accepted; counts toward the metric
+      "abandoned"
+      // released, or PR closed unmerged
+    ]);
     PUSHED_CLAIM_FIELDS = [
       "kind",
       "repoFullName",

package/dist/bin/jpi-devs.js

@@ -10566,6 +10566,14 @@ function warnStderr(message) {
   process.stderr.write(`${message}
 `);
 }
+function makeWarnOnce() {
+  const seen = /* @__PURE__ */ new Set();
+  return (message) => {
+    if (seen.has(message)) return;
+    seen.add(message);
+    warnStderr(message);
+  };
+}
 function atomicWriteFileSync(filePath, content) {
   const dir = dirname(filePath);
   ensureStateDirForSecret(dir);
@@ -10611,11 +10619,11 @@ async function deleteKey() {
     if (e.code !== "ENOENT") throw e;
   }
 }
-async function resolveKey(filePath, opts) {
+async function resolveKey(filePath, opts, warnOnce) {
   if (opts.keyPolicy === "keychain-required") {
     const key = await tryLoadFromKeytar();
     if (!key) {
-      warnStderr(
+      warnOnce(
         `crypto-store: OS keychain unavailable \u2014 store at ${filePath} is disabled (no plaintext key file will be written)`
       );
       return null;
@@ -10625,8 +10633,9 @@ async function resolveKey(filePath, opts) {
   return loadOrCreateSharedKey();
 }
 function createEncryptedStore(filePath, opts) {
+  const warnOnce = makeWarnOnce();
   async function read() {
-    const key = await resolveKey(filePath, opts);
+    const key = await resolveKey(filePath, opts, warnOnce);
     if (!key) return opts.blank();
     if (!existsSync3(filePath)) return opts.blank();
     try {
@@ -10635,12 +10644,12 @@ function createEncryptedStore(filePath, opts) {
       const plaintext = decrypt(blob, key);
       return JSON.parse(plaintext);
     } catch {
-      warnStderr(`crypto-store: failed to decrypt ${filePath} \u2014 returning blank`);
+      warnOnce(`crypto-store: failed to decrypt ${filePath} \u2014 returning blank`);
       return opts.blank();
     }
   }
   async function write(value) {
-    const key = await resolveKey(filePath, opts);
+    const key = await resolveKey(filePath, opts, warnOnce);
     if (!key) return;
     const blob = encrypt(JSON.stringify(value), key);
     atomicWriteFileSync(filePath, JSON.stringify(blob, null, 2));