terminalhire 0.29.0 → 0.30.0

package/dist/bin/jpi-bounties.js

@@ -1706,7 +1706,152 @@ async function fetchPRScoringFacts(prUrl, token, signal, governor) {
     fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
-var TRACTION_TOP_N, MAINTAINER_ENRICH_MAX, CANDIDATE_PR_PAGE, MAX_ENRICH_PRS, OPEN_PR_PAGE, TRANSIENT_META_ERROR, RESUME_DECAY_HALF_LIFE_MS, RESUME_MIN_SCORE, RECEPTIVITY_RECENCY_DAYS, RECEPTIVITY_RECENCY_FLOOR, GITHUB_GRAPHQL_URL;
+function isLifecycleBot(actor) {
+  if (!actor) return false;
+  if (actor.type === "Bot") return true;
+  const login = String(actor.login ?? "");
+  if (/\[bot\]$/i.test(login)) return true;
+  return LIFECYCLE_BOT_LOGINS.has(login.toLowerCase());
+}
+async function fetchPRLifecycle(prUrl, token, signal, governor) {
+  const ref = parseGitHubRef(prUrl);
+  if (!ref || ref.kind !== "pull") return null;
+  const { owner, repo, number } = ref;
+  const sig = signal ?? AbortSignal.timeout(1e4);
+  const gov = makeScoringGovernor(governor);
+  if (gov.tripped() || gov.budgetExhausted()) return null;
+  let pr;
+  try {
+    pr = await ghFetch(`/repos/${owner}/${repo}/pulls/${number}`, token, sig);
+  } catch {
+    return null;
+  }
+  const authorId = pr.user?.id ?? null;
+  const events = [];
+  const complete = { reviews: false, comments: false, commits: false };
+  if (pr.created_at) {
+    events.push({
+      event_type: "pr_opened",
+      source_id: `pr-${number}`,
+      actor_id: authorId ?? 0,
+      actor_assoc: "",
+      is_author: true,
+      is_bot: false,
+      occurred_at: pr.created_at
+    });
+  }
+  if (!gov.tripped() && !gov.budgetExhausted()) {
+    try {
+      const reviews = await ghFetch(
+        `/repos/${owner}/${repo}/pulls/${number}/reviews?per_page=100`,
+        token,
+        sig
+      );
+      for (const r of reviews) {
+        if (r.state === "PENDING" || !r.submitted_at) continue;
+        const aid = r.user?.id ?? 0;
+        events.push({
+          event_type: "review_submitted",
+          source_id: `review-${r.id}`,
+          actor_id: aid,
+          actor_assoc: r.author_association ?? "",
+          is_author: authorId != null && aid === authorId,
+          is_bot: isLifecycleBot(r.user),
+          occurred_at: r.submitted_at
+        });
+      }
+      complete.reviews = true;
+    } catch {
+      complete.reviews = false;
+    }
+  }
+  if (!gov.tripped() && !gov.budgetExhausted()) {
+    try {
+      const comments = await ghFetch(
+        `/repos/${owner}/${repo}/issues/${number}/comments?per_page=100`,
+        token,
+        sig
+      );
+      for (const c of comments) {
+        if (!c.created_at) continue;
+        const aid = c.user?.id ?? 0;
+        events.push({
+          event_type: "issue_comment",
+          source_id: `comment-${c.id}`,
+          actor_id: aid,
+          actor_assoc: c.author_association ?? "",
+          is_author: authorId != null && aid === authorId,
+          is_bot: isLifecycleBot(c.user),
+          occurred_at: c.created_at
+        });
+      }
+      complete.comments = true;
+    } catch {
+      complete.comments = false;
+    }
+  }
+  if (!gov.tripped() && !gov.budgetExhausted()) {
+    try {
+      const commits = await ghFetch(
+        `/repos/${owner}/${repo}/pulls/${number}/commits?per_page=100`,
+        token,
+        sig
+      );
+      for (const cm of commits) {
+        const when = cm.commit?.author?.date ?? null;
+        if (!when) continue;
+        const aid = cm.author?.id ?? authorId ?? 0;
+        events.push({
+          event_type: "commit_pushed",
+          source_id: `commit-${cm.sha}`,
+          actor_id: aid,
+          actor_assoc: "",
+          is_author: authorId != null && aid === authorId,
+          is_bot: isLifecycleBot(cm.author),
+          occurred_at: when
+        });
+      }
+      complete.commits = true;
+    } catch {
+      complete.commits = false;
+    }
+  }
+  if (pr.merged && pr.merged_at) {
+    events.push({
+      event_type: "pr_merged",
+      source_id: `merged-${number}`,
+      actor_id: pr.merged_by?.id ?? 0,
+      actor_assoc: "",
+      is_author: authorId != null && pr.merged_by?.id === authorId,
+      // A bot merger (mergify[bot], a merge queue, etc.) must NOT count as an
+      // independent human counterparty. Classify it like every other actor (§4b V4).
+      is_bot: isLifecycleBot(pr.merged_by),
+      occurred_at: pr.merged_at
+    });
+  } else if (pr.state === "closed" && pr.closed_at) {
+    events.push({
+      event_type: "pr_closed_unmerged",
+      source_id: `closed-${number}`,
+      actor_id: 0,
+      actor_assoc: "",
+      is_author: false,
+      is_bot: false,
+      occurred_at: pr.closed_at
+    });
+  }
+  return {
+    prNumber: number,
+    prUrl: pr.html_url,
+    openedAt: pr.created_at ?? null,
+    merged: pr.merged === true,
+    mergedAt: pr.merged_at ?? null,
+    closedUnmergedAt: !pr.merged && pr.state === "closed" ? pr.closed_at ?? null : null,
+    authorId,
+    events,
+    complete
+  };
+}
+var TRACTION_TOP_N, MAINTAINER_ENRICH_MAX, CANDIDATE_PR_PAGE, MAX_ENRICH_PRS, OPEN_PR_PAGE, TRANSIENT_META_ERROR, RESUME_DECAY_HALF_LIFE_MS, RESUME_MIN_SCORE, RECEPTIVITY_RECENCY_DAYS, RECEPTIVITY_RECENCY_FLOOR, GITHUB_GRAPHQL_URL, LIFECYCLE_BOT_LOGINS;
 var init_github = __esm({
   "../../packages/core/src/github.ts"() {
     "use strict";
@@ -1726,6 +1871,20 @@ var init_github = __esm({
     RECEPTIVITY_RECENCY_DAYS = 180;
     RECEPTIVITY_RECENCY_FLOOR = 0.1;
     GITHUB_GRAPHQL_URL = "https://api.github.com/graphql";
+    LIFECYCLE_BOT_LOGINS = /* @__PURE__ */ new Set([
+      "mergify",
+      "mergify[bot]",
+      "bors",
+      "bors[bot]",
+      "kodiakhq",
+      "kodiakhq[bot]",
+      "dependabot",
+      "dependabot[bot]",
+      "renovate",
+      "renovate[bot]",
+      "github-actions",
+      "github-actions[bot]"
+    ]);
   }
 });
 
@@ -7807,6 +7966,7 @@ __export(src_exports, {
   fetchGitHubProfile: () => fetchGitHubProfile,
   fetchOpenExternalPRs: () => fetchOpenExternalPRs,
   fetchOwnedRepoTraction: () => fetchOwnedRepoTraction,
+  fetchPRLifecycle: () => fetchPRLifecycle,
   fetchPRScoringFacts: () => fetchPRScoringFacts,
   fetchRepoRecency: () => fetchRepoRecency,
   fetchRepoReceptivity: () => fetchRepoReceptivity,

package/dist/bin/jpi-claim.js

@@ -1706,7 +1706,152 @@ async function fetchPRScoringFacts(prUrl, token, signal, governor) {
     fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
-var TRACTION_TOP_N, MAINTAINER_ENRICH_MAX, CANDIDATE_PR_PAGE, MAX_ENRICH_PRS, OPEN_PR_PAGE, TRANSIENT_META_ERROR, RESUME_DECAY_HALF_LIFE_MS, RESUME_MIN_SCORE, RECEPTIVITY_RECENCY_DAYS, RECEPTIVITY_RECENCY_FLOOR, GITHUB_GRAPHQL_URL;
+function isLifecycleBot(actor) {
+  if (!actor) return false;
+  if (actor.type === "Bot") return true;
+  const login = String(actor.login ?? "");
+  if (/\[bot\]$/i.test(login)) return true;
+  return LIFECYCLE_BOT_LOGINS.has(login.toLowerCase());
+}
+async function fetchPRLifecycle(prUrl, token, signal, governor) {
+  const ref = parseGitHubRef(prUrl);
+  if (!ref || ref.kind !== "pull") return null;
+  const { owner, repo, number } = ref;
+  const sig = signal ?? AbortSignal.timeout(1e4);
+  const gov = makeScoringGovernor(governor);
+  if (gov.tripped() || gov.budgetExhausted()) return null;
+  let pr;
+  try {
+    pr = await ghFetch(`/repos/${owner}/${repo}/pulls/${number}`, token, sig);
+  } catch {
+    return null;
+  }
+  const authorId = pr.user?.id ?? null;
+  const events = [];
+  const complete = { reviews: false, comments: false, commits: false };
+  if (pr.created_at) {
+    events.push({
+      event_type: "pr_opened",
+      source_id: `pr-${number}`,
+      actor_id: authorId ?? 0,
+      actor_assoc: "",
+      is_author: true,
+      is_bot: false,
+      occurred_at: pr.created_at
+    });
+  }
+  if (!gov.tripped() && !gov.budgetExhausted()) {
+    try {
+      const reviews = await ghFetch(
+        `/repos/${owner}/${repo}/pulls/${number}/reviews?per_page=100`,
+        token,
+        sig
+      );
+      for (const r of reviews) {
+        if (r.state === "PENDING" || !r.submitted_at) continue;
+        const aid = r.user?.id ?? 0;
+        events.push({
+          event_type: "review_submitted",
+          source_id: `review-${r.id}`,
+          actor_id: aid,
+          actor_assoc: r.author_association ?? "",
+          is_author: authorId != null && aid === authorId,
+          is_bot: isLifecycleBot(r.user),
+          occurred_at: r.submitted_at
+        });
+      }
+      complete.reviews = true;
+    } catch {
+      complete.reviews = false;
+    }
+  }
+  if (!gov.tripped() && !gov.budgetExhausted()) {
+    try {
+      const comments = await ghFetch(
+        `/repos/${owner}/${repo}/issues/${number}/comments?per_page=100`,
+        token,
+        sig
+      );
+      for (const c of comments) {
+        if (!c.created_at) continue;
+        const aid = c.user?.id ?? 0;
+        events.push({
+          event_type: "issue_comment",
+          source_id: `comment-${c.id}`,
+          actor_id: aid,
+          actor_assoc: c.author_association ?? "",
+          is_author: authorId != null && aid === authorId,
+          is_bot: isLifecycleBot(c.user),
+          occurred_at: c.created_at
+        });
+      }
+      complete.comments = true;
+    } catch {
+      complete.comments = false;
+    }
+  }
+  if (!gov.tripped() && !gov.budgetExhausted()) {
+    try {
+      const commits = await ghFetch(
+        `/repos/${owner}/${repo}/pulls/${number}/commits?per_page=100`,
+        token,
+        sig
+      );
+      for (const cm of commits) {
+        const when = cm.commit?.author?.date ?? null;
+        if (!when) continue;
+        const aid = cm.author?.id ?? authorId ?? 0;
+        events.push({
+          event_type: "commit_pushed",
+          source_id: `commit-${cm.sha}`,
+          actor_id: aid,
+          actor_assoc: "",
+          is_author: authorId != null && aid === authorId,
+          is_bot: isLifecycleBot(cm.author),
+          occurred_at: when
+        });
+      }
+      complete.commits = true;
+    } catch {
+      complete.commits = false;
+    }
+  }
+  if (pr.merged && pr.merged_at) {
+    events.push({
+      event_type: "pr_merged",
+      source_id: `merged-${number}`,
+      actor_id: pr.merged_by?.id ?? 0,
+      actor_assoc: "",
+      is_author: authorId != null && pr.merged_by?.id === authorId,
+      // A bot merger (mergify[bot], a merge queue, etc.) must NOT count as an
+      // independent human counterparty. Classify it like every other actor (§4b V4).
+      is_bot: isLifecycleBot(pr.merged_by),
+      occurred_at: pr.merged_at
+    });
+  } else if (pr.state === "closed" && pr.closed_at) {
+    events.push({
+      event_type: "pr_closed_unmerged",
+      source_id: `closed-${number}`,
+      actor_id: 0,
+      actor_assoc: "",
+      is_author: false,
+      is_bot: false,
+      occurred_at: pr.closed_at
+    });
+  }
+  return {
+    prNumber: number,
+    prUrl: pr.html_url,
+    openedAt: pr.created_at ?? null,
+    merged: pr.merged === true,
+    mergedAt: pr.merged_at ?? null,
+    closedUnmergedAt: !pr.merged && pr.state === "closed" ? pr.closed_at ?? null : null,
+    authorId,
+    events,
+    complete
+  };
+}
+var TRACTION_TOP_N, MAINTAINER_ENRICH_MAX, CANDIDATE_PR_PAGE, MAX_ENRICH_PRS, OPEN_PR_PAGE, TRANSIENT_META_ERROR, RESUME_DECAY_HALF_LIFE_MS, RESUME_MIN_SCORE, RECEPTIVITY_RECENCY_DAYS, RECEPTIVITY_RECENCY_FLOOR, GITHUB_GRAPHQL_URL, LIFECYCLE_BOT_LOGINS;
 var init_github = __esm({
   "../../packages/core/src/github.ts"() {
     "use strict";
@@ -1726,6 +1871,20 @@ var init_github = __esm({
     RECEPTIVITY_RECENCY_DAYS = 180;
     RECEPTIVITY_RECENCY_FLOOR = 0.1;
     GITHUB_GRAPHQL_URL = "https://api.github.com/graphql";
+    LIFECYCLE_BOT_LOGINS = /* @__PURE__ */ new Set([
+      "mergify",
+      "mergify[bot]",
+      "bors",
+      "bors[bot]",
+      "kodiakhq",
+      "kodiakhq[bot]",
+      "dependabot",
+      "dependabot[bot]",
+      "renovate",
+      "renovate[bot]",
+      "github-actions",
+      "github-actions[bot]"
+    ]);
   }
 });
 
@@ -7807,6 +7966,7 @@ __export(src_exports, {
   fetchGitHubProfile: () => fetchGitHubProfile,
   fetchOpenExternalPRs: () => fetchOpenExternalPRs,
   fetchOwnedRepoTraction: () => fetchOwnedRepoTraction,
+  fetchPRLifecycle: () => fetchPRLifecycle,
   fetchPRScoringFacts: () => fetchPRScoringFacts,
   fetchRepoRecency: () => fetchRepoRecency,
   fetchRepoReceptivity: () => fetchRepoReceptivity,
@@ -8523,13 +8683,153 @@ var init_profile = __esm({
   }
 });
 
+// src/reputation/identity.ts
+var identity_exports = {};
+__export(identity_exports, {
+  resolveCallerIdentity: () => resolveCallerIdentity
+});
+import { execFile } from "child_process";
+import { promisify } from "util";
+async function resolveCallerIdentity() {
+  try {
+    const { stdout } = await execFileAsync("gh", ["api", "user"], { timeout: 1e4 });
+    const u = JSON.parse(stdout);
+    if (typeof u.id === "number" && typeof u.login === "string" && u.login.length > 0) {
+      return { id: u.id, login: u.login };
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+var execFileAsync;
+var init_identity = __esm({
+  "src/reputation/identity.ts"() {
+    "use strict";
+    execFileAsync = promisify(execFile);
+  }
+});
+
+// src/reputation/fetch.ts
+var fetch_exports = {};
+__export(fetch_exports, {
+  gatherAudit: () => gatherAudit
+});
+async function gatherAudit(prUrl, token) {
+  const signal = AbortSignal.timeout(2e4);
+  const governor = makeScoringGovernor();
+  const [lifecycle, facts] = await Promise.all([
+    fetchPRLifecycle(prUrl, token, signal, governor),
+    fetchPRScoringFacts(prUrl, token, signal, governor)
+  ]);
+  return { lifecycle, facts };
+}
+var init_fetch = __esm({
+  "src/reputation/fetch.ts"() {
+    "use strict";
+    init_src();
+  }
+});
+
+// src/reputation/audit.ts
+var audit_exports = {};
+__export(audit_exports, {
+  buildAuditView: () => buildAuditView
+});
+function roleOf(e) {
+  if (e.is_bot) return "bot";
+  if (e.is_author) return "you";
+  const a = String(e.actor_assoc || "").toUpperCase();
+  if (MAINTAINER_ASSOC.has(a)) return "maintainer";
+  if (a === "CONTRIBUTOR") return "contributor";
+  if (a === "NONE") return "outside";
+  return "unknown";
+}
+function isMaintainerResponse(e) {
+  return !e.is_author && !e.is_bot && MAINTAINER_ASSOC.has(String(e.actor_assoc || "").toUpperCase());
+}
+function byTime(a, b) {
+  if (a.occurred_at < b.occurred_at) return -1;
+  if (a.occurred_at > b.occurred_at) return 1;
+  if (a.source_id < b.source_id) return -1;
+  if (a.source_id > b.source_id) return 1;
+  return 0;
+}
+function hoursBetween(a, b) {
+  if (!a || !b) return null;
+  const ta = Date.parse(a);
+  const tb = Date.parse(b);
+  if (Number.isNaN(ta) || Number.isNaN(tb)) return null;
+  return Math.round((tb - ta) / 36e5 * 10) / 10;
+}
+function buildAuditView(lifecycle, facts) {
+  const events = [...lifecycle.events].sort(byTime);
+  const counterpartyIds = /* @__PURE__ */ new Set();
+  for (const e of events) {
+    if (!e.is_author && !e.is_bot && e.actor_id !== 0) counterpartyIds.add(e.actor_id);
+  }
+  const firstResponse = events.find(isMaintainerResponse) ?? null;
+  const firstResponseAt = firstResponse?.occurred_at ?? null;
+  const maintainerReviews = events.filter(
+    (e) => e.event_type === "review_submitted" && isMaintainerResponse(e)
+  ).length;
+  const iterationsAfterFirstResponse = firstResponseAt ? events.filter(
+    (e) => e.event_type === "commit_pushed" && e.is_author && e.occurred_at > firstResponseAt
+  ).length : 0;
+  const outcome = lifecycle.merged ? "merged" : lifecycle.closedUnmergedAt ? "closed_unmerged" : "open";
+  const signals = {
+    distinctCounterparties: counterpartyIds.size,
+    maintainerReviews,
+    iterationsAfterFirstResponse,
+    hoursToFirstResponse: hoursBetween(lifecycle.openedAt, firstResponseAt),
+    hoursToMerge: hoursBetween(lifecycle.openedAt, lifecycle.mergedAt)
+  };
+  const timeline = events.map((e) => ({
+    at: e.occurred_at,
+    event: e.event_type,
+    role: roleOf(e)
+  }));
+  const notes = [];
+  if (!lifecycle.complete.reviews) notes.push("Review data incomplete \u2014 review counts may undercount.");
+  if (!lifecycle.complete.comments) notes.push("Comment data incomplete \u2014 response detection may be partial.");
+  if (!lifecycle.complete.commits) notes.push("Commit data incomplete \u2014 iteration count may undercount.");
+  if (lifecycle.authorId == null) notes.push("PR author identity unavailable \u2014 author/counterparty split may be imprecise.");
+  return {
+    repo: facts?.repo ?? "",
+    prNumber: lifecycle.prNumber,
+    prUrl: lifecycle.prUrl,
+    openedAt: lifecycle.openedAt,
+    outcome,
+    mergedAt: lifecycle.mergedAt,
+    closedUnmergedAt: lifecycle.closedUnmergedAt,
+    mergedByLogin: facts?.mergedByLogin ?? null,
+    signals,
+    timeline,
+    completeness: { ...lifecycle.complete },
+    notes,
+    limitations: [...AUDIT_LIMITATIONS]
+  };
+}
+var MAINTAINER_ASSOC, AUDIT_LIMITATIONS;
+var init_audit = __esm({
+  "src/reputation/audit.ts"() {
+    "use strict";
+    MAINTAINER_ASSOC = /* @__PURE__ */ new Set(["OWNER", "MEMBER", "COLLABORATOR"]);
+    AUDIT_LIMITATIONS = [
+      "Post-merge bug/revert rate \u2014 longitudinal; it only shows up after the merge this audit stops at.",
+      "Downstream adoption / real-world impact \u2014 a repo-level, slow signal not visible in one PR timeline.",
+      "Reviewer satisfaction and collaboration quality \u2014 not observable from public timeline events."
+    ];
+  }
+});
+
 // bin/jpi-claim.js
 init_src();
 import { readFileSync as readFileSync7, writeFileSync as writeFileSync6, mkdirSync as mkdirSync6, existsSync as existsSync6, rmSync as rmSync3 } from "fs";
 import { join as join7 } from "path";
 import { homedir as homedir6, hostname as osHostname } from "os";
-import { execFile } from "child_process";
-import { promisify } from "util";
+import { execFile as execFile2 } from "child_process";
+import { promisify as promisify2 } from "util";
 import { createInterface } from "readline";
 
 // src/open-url.js
@@ -8722,7 +9022,7 @@ function printPolicySection(policy) {
     console.log("  policy: no AI-assistance policy language detected in CONTRIBUTING/PR-template/AGENTS docs");
   }
 }
-var pExecFile = promisify(execFile);
+var pExecFile = promisify2(execFile2);
 async function sh(cmd, args, opts = {}) {
   const { stdout } = await pExecFile(cmd, args, { ...opts, shell: false, maxBuffer: 16 * 1024 * 1024 });
   return String(stdout).trim();
@@ -10253,6 +10553,100 @@ async function cmdRevoke() {
   console.log("\n  \u2713 Pushed claims deleted and local marker cleared.\n");
   console.log("  Background updates (if any) have been stopped.\n");
 }
+function renderAudit(view) {
+  const roleLabel = {
+    you: "you",
+    maintainer: "maintainer",
+    contributor: "contributor",
+    outside: "outside",
+    bot: "bot",
+    unknown: "\u2014"
+  };
+  const eventLabel = {
+    pr_opened: "opened PR",
+    review_submitted: "reviewed",
+    issue_comment: "commented",
+    commit_pushed: "pushed commit",
+    pr_merged: "merged",
+    pr_closed_unmerged: "closed (unmerged)"
+  };
+  const outcomeLabel = {
+    merged: "\u2714 merged",
+    closed_unmerged: "\u2715 closed without merge",
+    open: "\u2026 still open"
+  };
+  const hrs = (h) => h == null ? "\u2014" : `${h}h`;
+  console.log(`
+  Audit \u2014 ${view.repo || "repo"} #${view.prNumber}`);
+  console.log(`  ${view.prUrl}`);
+  console.log(`  Outcome: ${outcomeLabel[view.outcome] ?? view.outcome}` + (view.mergedByLogin ? `  (merged by @${view.mergedByLogin})` : ""));
+  console.log("\n  Engagement (raw counts \u2014 not a score):");
+  console.log(`    Independent counterparties engaged : ${view.signals.distinctCounterparties}`);
+  console.log(`    Maintainer reviews                 : ${view.signals.maintainerReviews}`);
+  console.log(`    Your commits after first response  : ${view.signals.iterationsAfterFirstResponse}`);
+  console.log(`    Time to first maintainer response  : ${hrs(view.signals.hoursToFirstResponse)}`);
+  console.log(`    Time to merge                      : ${hrs(view.signals.hoursToMerge)}`);
+  console.log("\n  Timeline:");
+  if (view.timeline.length === 0) {
+    console.log("    (no events captured)");
+  } else {
+    for (const e of view.timeline) {
+      console.log(`    ${e.at}  ${roleLabel[e.role] ?? e.role} ${eventLabel[e.event] ?? e.event}`);
+    }
+  }
+  if (view.notes.length > 0) {
+    console.log("\n  Notes:");
+    for (const n of view.notes) console.log(`    \u26A0 ${n}`);
+  }
+  console.log("\n  What this does NOT measure:");
+  for (const l of view.limitations || []) console.log(`    \xB7 ${l}`);
+  console.log("");
+}
+async function cmdAudit(id, flags = {}) {
+  if (!id) {
+    console.error("terminalhire claim audit: needs a claim id. Try `terminalhire claim list`.");
+    process.exit(1);
+  }
+  const claims = await Promise.resolve().then(() => (init_claims(), claims_exports));
+  const claim = claims.findClaim(id);
+  if (!claim) {
+    console.error(`No claim with id '${id}'.`);
+    process.exit(1);
+  }
+  if (!claim.prUrl) {
+    console.log(`Claim '${id}' has no submitted PR yet \u2014 nothing to audit. Submit first: terminalhire claim submit ${id}`);
+    return;
+  }
+  const { resolveCallerIdentity: resolveCallerIdentity2 } = await Promise.resolve().then(() => (init_identity(), identity_exports));
+  const identity = await resolveCallerIdentity2();
+  if (!identity) {
+    console.error("terminalhire claim audit: could not verify your GitHub identity (`gh api user`). Run `gh auth login` and retry.");
+    process.exit(1);
+  }
+  let token;
+  try {
+    token = await sh("gh", ["auth", "token"]);
+  } catch {
+    token = void 0;
+  }
+  const { gatherAudit: gatherAudit2 } = await Promise.resolve().then(() => (init_fetch(), fetch_exports));
+  const { lifecycle, facts } = await gatherAudit2(claim.prUrl, token || void 0);
+  if (!lifecycle) {
+    console.error(`terminalhire claim audit: could not fetch the PR lifecycle for ${claim.prUrl} (private, deleted, rate-limited, or not a PR).`);
+    process.exit(1);
+  }
+  if (lifecycle.authorId !== identity.id) {
+    console.error(`terminalhire claim audit: PR ${claim.prUrl} was not authored by you (@${identity.login}); the audit only covers your own PRs.`);
+    process.exit(1);
+  }
+  const { buildAuditView: buildAuditView2 } = await Promise.resolve().then(() => (init_audit(), audit_exports));
+  const view = buildAuditView2(lifecycle, facts);
+  if (flags.json) {
+    console.log(JSON.stringify(view, null, 2));
+    return;
+  }
+  renderAudit(view);
+}
 async function run() {
   const verb = process.argv[2];
   const rawArgs = process.argv.slice(3).map((a) => a === "-y" ? "--yes" : a);
@@ -10303,8 +10697,11 @@ async function run() {
       case "release":
         await cmdRelease(positional[0]);
         break;
+      case "audit":
+        await cmdAudit(positional[0], flags);
+        break;
       default:
-        console.error(`terminalhire claim: unknown verb '${verb ?? ""}'. Expected: preview | record | start | attach | list | status | update | submit | release`);
+        console.error(`terminalhire claim: unknown verb '${verb ?? ""}'. Expected: preview | record | start | attach | list | status | update | submit | audit | release`);
         process.exit(1);
     }
   } catch (err) {