azdo-cli 0.22.0-develop.790 → 0.22.0-develop.793

package/README.md

@@ -123,6 +123,8 @@ azdo pr work-items unlink 1234 --pr-number 64
 azdo pr reviewers add jane@example.com --pr-number 64             # optional by default
 azdo pr reviewers add jane@example.com --pr-number 64 --required  # required (or promotes in place)
 azdo pr reviewers remove jane@example.com --pr-number 64
+azdo pr reviewers list --pr-number 64                             # who must review, and how each voted
+azdo pr reviewers list --pr-number 64 --json                      # { pullRequestId, reviewers: [{ id, uniqueName, isRequired, vote, voteState, ... }] }
 
 # Any pr subcommand can target another repository
 azdo pr comments --repo other-repo --pr-number 12

package/dist/index.js

@@ -4261,13 +4261,34 @@ function buildPullRequestReviewerUrl(context, repo, prId, reviewerId) {
   url.searchParams.set("api-version", "7.1");
   return url;
 }
+function reviewerVoteState(vote) {
+  switch (vote) {
+    case 10:
+      return "approved";
+    case 5:
+      return "approved-with-suggestions";
+    case 0:
+      return "no-vote";
+    case -5:
+      return "waiting-for-author";
+    case -10:
+      return "rejected";
+    case 15:
+      return "bypassed";
+    default:
+      return "unknown";
+  }
+}
 function mapReviewer(data) {
+  const vote = data.vote ?? 0;
   return {
     id: data.id,
     displayName: data.displayName ?? null,
     uniqueName: data.uniqueName ?? null,
     isRequired: data.isRequired ?? false,
-    vote: data.vote ?? 0
+    vote,
+    voteState: reviewerVoteState(vote),
+    hasDeclined: data.hasDeclined ?? false
   };
 }
 async function getPullRequestReviewers(context, repo, cred, prId) {
@@ -6087,9 +6108,50 @@ async function runReviewerRemove(reviewer, options) {
     handlePrCommandError(err, context, "write");
   }
 }
+function formatReviewerLine(reviewer) {
+  const name = reviewer.displayName ?? reviewer.uniqueName ?? reviewer.id;
+  const unique = reviewer.uniqueName && reviewer.uniqueName !== name ? ` <${reviewer.uniqueName}>` : "";
+  const kind = reviewer.isRequired ? "required" : "optional";
+  const declined = reviewer.hasDeclined ? ", declined" : "";
+  return `${name}${unique} \u2014 ${reviewer.voteState} (${kind}${declined})`;
+}
+async function runReviewerList(options) {
+  let context;
+  try {
+    const target = await resolvePullRequestTarget(options, {
+      onContextResolved: (resolved) => {
+        context = resolved;
+      }
+    });
+    if (target === null) {
+      return;
+    }
+    const reviewers = await getPullRequestReviewers(target.context, target.repo, target.pat, target.pullRequest.id);
+    const result = { pullRequestId: target.pullRequest.id, reviewers };
+    if (options.json) {
+      process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+      return;
+    }
+    if (reviewers.length === 0) {
+      process.stdout.write(`No reviewers on pull request #${target.pullRequest.id}.
+`);
+      return;
+    }
+    process.stdout.write(`${reviewers.map(formatReviewerLine).join("\n")}
+`);
+  } catch (err) {
+    handlePrCommandError(err, context, "read");
+  }
+}
 function createPrReviewersCommand() {
   const command = new Command12("reviewers");
   command.description("Manage pull request reviewers");
+  const list = new Command12("list");
+  withCommonPrOptions(configureUnwrappedHelp(list)).description("List the pull request reviewers with their votes (approved, waiting-for-author, \u2026) and required flag").option("--pr-number <N>", PR_NUMBER_HELP).option("--json", "output JSON").action(async (_options, command2) => {
+    await runReviewerList(mergedPrOptions(command2));
+  });
+  command.addCommand(list);
   const add = new Command12("add");
   withCommonPrOptions(configureUnwrappedHelp(add)).description("Add a reviewer to the pull request (optional by default)").argument("<reviewer>", "reviewer email or unique name").option("--required", "mark the reviewer as required instead of optional").option("--pr-number <N>", PR_NUMBER_HELP).option("--json", "output JSON").action(async (reviewer, _options, command2) => {
     await runReviewerAdd(reviewer, mergedPrOptions(command2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.22.0-develop.790",
+  "version": "0.22.0-develop.793",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {