azdo-cli 0.2.0-008-pull-request-handling.100 → 0.2.0-008-pull-request-handling.102

package/README.md

@@ -17,6 +17,7 @@ Azure DevOps CLI focused on work item read/write workflows.
 - Set rich-text fields as markdown from inline text, file, or stdin (`set-md-field`)
 - Check branch pull request status, open PRs to `develop`, and review active comments (`pr`)
 - Persist org/project/default fields in local config (`config`)
+- List all fields of a work item (`list-fields`)
 - Store PAT in OS credential store (or use `AZDO_PAT`)
 
 ## Installation
@@ -65,6 +66,7 @@ azdo upsert --content $'---\nTitle: Improve markdown import UX\nState: New\n---'
 | `azdo upsert [id]` | Create or update a Task from markdown | `--content`, `--file`, `--json`, `--org`, `--project` |
 | `azdo get-md-field <id> <field>` | Get field as markdown | `--org`, `--project` |
 | `azdo set-md-field <id> <field> [content]` | Set markdown field | `--file`, `--json`, `--org`, `--project` |
+| `azdo list-fields <id>` | List all fields of a work item | `--json`, `--org`, `--project` |
 | `azdo pr <subcommand>` | Manage pull requests for the current branch | `status`, `open`, `comments`, `--json`, `--org`, `--project` |
 | `azdo config <subcommand>` | Manage saved settings | `set`, `get`, `list`, `unset`, `wizard`, `--json` |
 | `azdo clear-pat` | Remove stored PAT | none |
@@ -102,6 +104,16 @@ azdo assign 12345 --unassign
 azdo set-field 12345 System.Title "Updated title"
 ```
 
+### List Fields
+
+```bash
+# List all fields of a work item
+azdo list-fields 12345
+
+# JSON output
+azdo list-fields 12345 --json
+```
+
 ### Markdown Display
 
 The `get-item` command can convert HTML rich-text fields to readable markdown. Resolution order:
@@ -271,6 +283,7 @@ azdo clear-pat
 ## JSON Output
 
 These commands support `--json` for machine-readable output:
+- `list-fields`
 - `set-state`
 - `assign`
 - `set-field`

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -92,6 +92,25 @@ async function readWriteResponse(response, errorCode) {
     fields: data.fields
   };
 }
+async function getWorkItemFields(context, id, pat) {
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/workitems/${id}`
+  );
+  url.searchParams.set("api-version", "7.1");
+  url.searchParams.set("$expand", "all");
+  const response = await fetchWithErrors(url.toString(), { headers: authHeaders(pat) });
+  if (response.status === 400) {
+    const serverMessage = await readResponseMessage(response);
+    if (serverMessage) {
+      throw new Error(`BAD_REQUEST: ${serverMessage}`);
+    }
+  }
+  if (!response.ok) {
+    throw new Error(`HTTP_${response.status}`);
+  }
+  const data = await response.json();
+  return data.fields;
+}
 async function getWorkItem(context, id, pat, extraFields) {
   const url = new URL(
     `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/workitems/${id}`
@@ -1451,8 +1470,54 @@ function createUpsertCommand() {
   return command;
 }
 
-// src/commands/pr.ts
+// src/commands/list-fields.ts
 import { Command as Command10 } from "commander";
+function stringifyValue(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "object") return JSON.stringify(value);
+  return String(value);
+}
+function formatFieldList(fields) {
+  const entries = Object.entries(fields).sort(([a], [b]) => a.localeCompare(b));
+  const maxKeyLen = Math.min(
+    Math.max(...entries.map(([k]) => k.length)),
+    50
+  );
+  return entries.map(([key, value]) => {
+    const display = stringifyValue(value);
+    const truncated = display.length > 120 ? display.slice(0, 117) + "..." : display;
+    return `${key.padEnd(maxKeyLen + 2)}${truncated}`;
+  }).join("\n");
+}
+function createListFieldsCommand() {
+  const command = new Command10("list-fields");
+  command.description("List all fields of an Azure DevOps work item").argument("<id>", "work item ID").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output result as JSON").action(
+    async (idStr, options) => {
+      const id = parseWorkItemId(idStr);
+      validateOrgProjectPair(options);
+      let context;
+      try {
+        context = resolveContext(options);
+        const credential = await resolvePat();
+        const fields = await getWorkItemFields(context, id, credential.pat);
+        if (options.json) {
+          process.stdout.write(JSON.stringify({ id, fields }, null, 2) + "\n");
+        } else {
+          process.stdout.write(`Work Item ${id} \u2014 ${Object.keys(fields).length} fields
+
+`);
+          process.stdout.write(formatFieldList(fields) + "\n");
+        }
+      } catch (err) {
+        handleCommandError(err, id, context, "read");
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/pr.ts
+import { Command as Command11 } from "commander";
 
 // src/services/pr-client.ts
 function buildPullRequestsUrl(context, repo, sourceBranch, opts) {
@@ -1613,25 +1678,35 @@ function formatPullRequestBlock(pullRequest) {
 function formatThreads(prId, title, threads) {
   const lines = [`Active comments for pull request #${prId}: ${title}`];
   for (const thread of threads) {
-    lines.push("");
-    lines.push(`Thread #${thread.id} [${thread.status}] ${thread.threadContext ?? "(general)"}`);
+    lines.push("", `Thread #${thread.id} [${thread.status}] ${thread.threadContext ?? "(general)"}`);
     for (const comment of thread.comments) {
       lines.push(`  ${comment.author ?? "Unknown"}: ${comment.content}`);
     }
   }
   return lines.join("\n");
 }
+async function resolvePrCommandContext(options) {
+  const context = resolveContext(options);
+  const repo = detectRepoName();
+  const branch = getCurrentBranch();
+  const credential = await resolvePat();
+  return {
+    context,
+    repo,
+    branch,
+    pat: credential.pat
+  };
+}
 function createPrStatusCommand() {
-  const command = new Command10("status");
+  const command = new Command11("status");
   command.description("Check pull requests for the current branch").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(async (options) => {
     validateOrgProjectPair(options);
     let context;
     try {
-      context = resolveContext(options);
-      const repo = detectRepoName();
-      const branch = getCurrentBranch();
-      const credential = await resolvePat();
-      const pullRequests = await listPullRequests(context, repo, credential.pat, branch);
+      const resolved = await resolvePrCommandContext(options);
+      context = resolved.context;
+      const pullRequests = await listPullRequests(resolved.context, resolved.repo, resolved.pat, resolved.branch);
+      const { branch, repo } = resolved;
       const result = { branch, repository: repo, pullRequests };
       if (options.json) {
         process.stdout.write(`${JSON.stringify(result, null, 2)}
@@ -1652,7 +1727,7 @@ function createPrStatusCommand() {
   return command;
 }
 function createPrOpenCommand() {
-  const command = new Command10("open");
+  const command = new Command11("open");
   command.description("Open a pull request from the current branch to develop").option("--title <title>", "pull request title").option("--description <description>", "pull request description").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(async (options) => {
     validateOrgProjectPair(options);
     const title = options.title?.trim();
@@ -1665,14 +1740,19 @@ function createPrOpenCommand() {
     }
     let context;
     try {
-      context = resolveContext(options);
-      const repo = detectRepoName();
-      const branch = getCurrentBranch();
-      if (branch === "develop") {
+      const resolved = await resolvePrCommandContext(options);
+      context = resolved.context;
+      if (resolved.branch === "develop") {
         writeError("Pull request creation requires a source branch other than develop.");
       }
-      const credential = await resolvePat();
-      const result = await openPullRequest(context, repo, credential.pat, branch, title, description);
+      const result = await openPullRequest(
+        resolved.context,
+        resolved.repo,
+        resolved.pat,
+        resolved.branch,
+        title,
+        description
+      );
       if (options.json) {
         process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
@@ -1685,7 +1765,7 @@ ${result.pullRequest.url}
         return;
       }
       process.stdout.write(
-        `Active pull request already exists for ${branch} -> develop: #${result.pullRequest.id}
+        `Active pull request already exists for ${resolved.branch} -> develop: #${result.pullRequest.id}
 ${result.pullRequest.url}
 `
       );
@@ -1700,26 +1780,26 @@ ${result.pullRequest.url}
   return command;
 }
 function createPrCommentsCommand() {
-  const command = new Command10("comments");
+  const command = new Command11("comments");
   command.description("List active pull request comments for the current branch").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(async (options) => {
     validateOrgProjectPair(options);
     let context;
     try {
-      context = resolveContext(options);
-      const repo = detectRepoName();
-      const branch = getCurrentBranch();
-      const credential = await resolvePat();
-      const pullRequests = await listPullRequests(context, repo, credential.pat, branch, { status: "active" });
+      const resolved = await resolvePrCommandContext(options);
+      context = resolved.context;
+      const pullRequests = await listPullRequests(resolved.context, resolved.repo, resolved.pat, resolved.branch, {
+        status: "active"
+      });
       if (pullRequests.length === 0) {
-        writeError(`No active pull request found for branch ${branch}.`);
+        writeError(`No active pull request found for branch ${resolved.branch}.`);
       }
       if (pullRequests.length > 1) {
         const ids = pullRequests.map((pullRequest2) => `#${pullRequest2.id}`).join(", ");
-        writeError(`Multiple active pull requests found for branch ${branch}: ${ids}. Use pr status to review them.`);
+        writeError(`Multiple active pull requests found for branch ${resolved.branch}: ${ids}. Use pr status to review them.`);
       }
       const pullRequest = pullRequests[0];
-      const threads = await getPullRequestThreads(context, repo, credential.pat, pullRequest.id);
-      const result = { branch, pullRequest, threads };
+      const threads = await getPullRequestThreads(resolved.context, resolved.repo, resolved.pat, pullRequest.id);
+      const result = { branch: resolved.branch, pullRequest, threads };
       if (options.json) {
         process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
@@ -1739,7 +1819,7 @@ function createPrCommentsCommand() {
   return command;
 }
 function createPrCommand() {
-  const command = new Command10("pr");
+  const command = new Command11("pr");
   command.description("Manage Azure DevOps pull requests");
   command.addCommand(createPrStatusCommand());
   command.addCommand(createPrOpenCommand());
@@ -1748,7 +1828,7 @@ function createPrCommand() {
 }
 
 // src/index.ts
-var program = new Command11();
+var program = new Command12();
 program.name("azdo").description("Azure DevOps CLI tool").version(version, "-v, --version");
 program.addCommand(createGetItemCommand());
 program.addCommand(createClearPatCommand());
@@ -1759,6 +1839,7 @@ program.addCommand(createSetFieldCommand());
 program.addCommand(createGetMdFieldCommand());
 program.addCommand(createSetMdFieldCommand());
 program.addCommand(createUpsertCommand());
+program.addCommand(createListFieldsCommand());
 program.addCommand(createPrCommand());
 program.showHelpAfterError();
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.2.0-008-pull-request-handling.100",
+  "version": "0.2.0-008-pull-request-handling.102",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {
@@ -14,7 +14,8 @@
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
     "format": "prettier --check src/",
-    "test": "npm run build && vitest run"
+    "test": "npm run build && vitest run tests/unit",
+    "test:integration": "npm run build && vitest run tests/integration"
   },
   "repository": {
     "type": "git",