azdo-cli 0.2.0-008-pull-request-handling.101 → 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) {
@@ -1633,7 +1698,7 @@ async function resolvePrCommandContext(options) {
   };
 }
 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;
@@ -1662,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();
@@ -1715,7 +1780,7 @@ ${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;
@@ -1754,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());
@@ -1763,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());
@@ -1774,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.101",
+  "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",