azdo-cli 0.5.0 → 0.6.0

package/README.md

@@ -174,8 +174,11 @@ azdo pr comments
 `azdo pr status`
 
 - Lists pull requests for the current branch
+- Includes Azure DevOps pull request checks under each returned pull request
+- Prints `Checks: none reported by Azure DevOps` when a pull request has no returned checks
+- Shows `Detail: ...` lines for failed or errored checks when Azure DevOps provides description text
 - Prints `No pull requests found for branch <branch>.` when no PRs exist
-- Supports `--json` for machine-readable output
+- Supports `--json` for machine-readable output, including a `checks` array per pull request
 
 `azdo pr open`
 

package/dist/index.js

@@ -1672,6 +1672,13 @@ function buildPullRequestsUrl(context, repo, sourceBranch, opts) {
   }
   return url;
 }
+function buildPullRequestStatusesUrl(context, repo, prId) {
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/git/repositories/${encodeURIComponent(repo)}/pullRequests/${prId}/statuses`
+  );
+  url.searchParams.set("api-version", "7.1");
+  return url;
+}
 function mapPullRequest(repo, pullRequest) {
   return {
     id: pullRequest.pullRequestId,
@@ -1684,6 +1691,35 @@ function mapPullRequest(repo, pullRequest) {
     url: pullRequest._links.web.href
   };
 }
+function mapPullRequestCheckName(status) {
+  const genre = status.context?.genre?.trim();
+  const name = status.context?.name?.trim();
+  if (genre && name) {
+    return `${genre}/${name}`;
+  }
+  if (name) {
+    return name;
+  }
+  if (genre) {
+    return genre;
+  }
+  return `Status #${status.id}`;
+}
+function mapPullRequestCheck(status) {
+  if (status.state === "notApplicable" || status.state === "notSet") {
+    return null;
+  }
+  return {
+    id: status.id,
+    state: status.state,
+    name: mapPullRequestCheckName(status),
+    description: status.description ?? null,
+    targetUrl: status.targetUrl ?? null,
+    createdBy: status.createdBy?.displayName ?? null,
+    createdAt: status.creationDate ?? null,
+    updatedAt: status.updatedDate ?? null
+  };
+}
 function mapComment(comment) {
   const content = comment.content?.trim();
   if (comment.isDeleted || !content) {
@@ -1725,6 +1761,14 @@ async function listPullRequests(context, repo, pat, sourceBranch, opts) {
   const data = await readJsonResponse(response);
   return data.value.map((pullRequest) => mapPullRequest(repo, pullRequest));
 }
+async function getPullRequestChecks(context, repo, pat, prId) {
+  const response = await fetchWithErrors(
+    buildPullRequestStatusesUrl(context, repo, prId).toString(),
+    { headers: authHeaders(pat) }
+  );
+  const data = await readJsonResponse(response);
+  return data.value.map(mapPullRequestCheck).filter((check) => check !== null);
+}
 async function openPullRequest(context, repo, pat, sourceBranch, title, description) {
   const existing = await listPullRequests(context, repo, pat, sourceBranch, {
     status: "active",
@@ -1806,11 +1850,25 @@ function handlePrCommandError(err, context, mode = "read") {
   }
   writeError(error.message);
 }
+function formatPullRequestChecks(checks) {
+  if (checks.length === 0) {
+    return ["Checks: none reported by Azure DevOps"];
+  }
+  const lines = ["Checks:"];
+  for (const check of checks) {
+    lines.push(`- [${check.state}] ${check.name}`);
+    if ((check.state === "failed" || check.state === "error") && check.description) {
+      lines.push(`  Detail: ${check.description}`);
+    }
+  }
+  return lines;
+}
 function formatPullRequestBlock(pullRequest) {
   return [
     `#${pullRequest.id} [${pullRequest.status}] ${pullRequest.title}`,
     `${formatBranchName(pullRequest.sourceRefName)} -> ${formatBranchName(pullRequest.targetRefName)}`,
-    pullRequest.url
+    pullRequest.url,
+    ...formatPullRequestChecks(pullRequest.checks)
   ].join("\n");
 }
 function formatThreads(prId, title, threads) {
@@ -1844,19 +1902,25 @@ function createPrStatusCommand() {
       const resolved = await resolvePrCommandContext(options);
       context = resolved.context;
       const pullRequests = await listPullRequests(resolved.context, resolved.repo, resolved.pat, resolved.branch);
+      const pullRequestsWithChecks = await Promise.all(
+        pullRequests.map(async (pullRequest) => ({
+          ...pullRequest,
+          checks: await getPullRequestChecks(resolved.context, resolved.repo, resolved.pat, pullRequest.id)
+        }))
+      );
       const { branch, repo } = resolved;
-      const result = { branch, repository: repo, pullRequests };
+      const result = { branch, repository: repo, pullRequests: pullRequestsWithChecks };
       if (options.json) {
         process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
         return;
       }
-      if (pullRequests.length === 0) {
+      if (pullRequestsWithChecks.length === 0) {
         process.stdout.write(`No pull requests found for branch ${branch}.
 `);
         return;
       }
-      process.stdout.write(`${pullRequests.map(formatPullRequestBlock).join("\n\n")}
+      process.stdout.write(`${pullRequestsWithChecks.map(formatPullRequestBlock).join("\n\n")}
 `);
     } catch (err) {
       handlePrCommandError(err, context, "read");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {