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

package/README.md

@@ -9,6 +9,7 @@ Azure DevOps CLI focused on work item read/write workflows.
 ## Features
 
 - Retrieve work items with readable output (`get-item`)
+- List work items by state, tag, assignee or title (`list-items`)
 - Update work item state, assignee, or any field (`set-state`, `assign`, `set-field`)
 - Create or update work items from markdown documents (`upsert`)
 - Read and post work item comments (`comments`)
@@ -48,6 +49,9 @@ azdo get-item 12345
 # Download images embedded in a work item's rich-text fields (opt-in)
 azdo get-item 12345 --download-images                       # saved to the system temp dir
 azdo get-item 12345 --resize-images 1024 --images-path ./img # cap width at 1024px, save as PNG
+
+# List work items (--state, --tag, --assigned-to [@me], --title-contains, --top, --json)
+azdo list-items --state Active --tag ready --json
 azdo get-md-field 12345 System.Description --download-images # same flags on get-md-field
 
 # Update state

package/dist/index.js

@@ -42,7 +42,7 @@ import {
 } from "./chunk-MHJ6OBX3.js";
 
 // src/program.ts
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -249,8 +249,9 @@ function handleCommandError(err, id, context, scope = "write", exit = true) {
     );
     writeErrorDetail(msg, "PERMISSION_DENIED");
   } else if (msg.startsWith("NOT_FOUND")) {
+    const subject = id === void 0 ? "Project or resource" : `Work item ${id}`;
     process.stderr.write(
-      `Error: Work item ${id} not found in ${context?.org}/${context?.project}.
+      `Error: ${subject} not found in ${context?.org}/${context?.project}.
 `
     );
   } else if (msg === "NETWORK_ERROR") {
@@ -988,6 +989,107 @@ async function createAttachment(context, fileName, content, cred) {
   }
   return await response.json();
 }
+var LIST_SYSTEM_FIELDS = [
+  "System.Title",
+  "System.State",
+  "System.WorkItemType",
+  "System.AssignedTo",
+  "System.Description",
+  "System.Tags",
+  "System.TeamProject"
+];
+var LIST_PROCESS_FIELDS = [
+  "Microsoft.VSTS.Common.AcceptanceCriteria",
+  "Microsoft.VSTS.TCM.ReproSteps"
+];
+var WORKITEMS_BATCH_LIMIT = 200;
+function wiqlLiteral(value) {
+  return `'${value.replaceAll("'", "''")}'`;
+}
+function buildListWiql(filter) {
+  const clauses = ["[System.TeamProject] = @project"];
+  if (filter.state) clauses.push(`[System.State] = ${wiqlLiteral(filter.state)}`);
+  if (filter.tag) clauses.push(`[System.Tags] CONTAINS ${wiqlLiteral(filter.tag)}`);
+  if (filter.assignedTo) {
+    clauses.push(
+      filter.assignedTo.toLowerCase() === "@me" ? "[System.AssignedTo] = @Me" : `[System.AssignedTo] = ${wiqlLiteral(filter.assignedTo)}`
+    );
+  }
+  if (filter.titleContains) clauses.push(`[System.Title] CONTAINS ${wiqlLiteral(filter.titleContains)}`);
+  return `SELECT [System.Id] FROM WorkItems WHERE ${clauses.join(" AND ")} ORDER BY [System.ChangedDate] DESC`;
+}
+function parseTags(raw) {
+  if (typeof raw !== "string") return [];
+  return raw.split(";").map((t) => t.trim()).filter((t) => t.length > 0);
+}
+async function runWiql(context, cred, wiql, top) {
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/wiql`
+  );
+  url.searchParams.set("api-version", "7.1");
+  url.searchParams.set("$top", String(top));
+  const response = await fetchWithErrors(url.toString(), {
+    method: "POST",
+    headers: { ...authHeaders(cred), "Content-Type": "application/json" },
+    body: JSON.stringify({ query: wiql })
+  });
+  if (response.status === 400) {
+    const serverMessage = await readResponseMessage(response);
+    if (serverMessage) throw new Error(`BAD_REQUEST: ${serverMessage}`);
+  }
+  if (!response.ok) throw httpError(response);
+  const data = await response.json();
+  return (data.workItems ?? []).map((w) => w.id);
+}
+async function postWorkItemsBatch(context, cred, ids, fields) {
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/workitemsbatch`
+  );
+  url.searchParams.set("api-version", "7.1");
+  return fetchWithErrors(url.toString(), {
+    method: "POST",
+    headers: { ...authHeaders(cred), "Content-Type": "application/json" },
+    body: JSON.stringify({ ids, fields })
+  });
+}
+async function readWorkItemsBatch(context, cred, ids) {
+  let response = await postWorkItemsBatch(context, cred, ids, [...LIST_SYSTEM_FIELDS, ...LIST_PROCESS_FIELDS]);
+  if (response.status === 400) {
+    const serverMessage = await readResponseMessage(response);
+    if (!serverMessage?.includes("TF51535")) {
+      throw serverMessage ? new Error(`BAD_REQUEST: ${serverMessage}`) : httpError(response);
+    }
+    response = await postWorkItemsBatch(context, cred, ids, LIST_SYSTEM_FIELDS);
+  }
+  if (!response.ok) throw httpError(response);
+  return (await response.json()).value ?? [];
+}
+async function queryWorkItems(context, cred, filter) {
+  const ids = await runWiql(context, cred, buildListWiql(filter), filter.top);
+  const byId = /* @__PURE__ */ new Map();
+  const chunks = [];
+  for (let i = 0; i < ids.length; i += WORKITEMS_BATCH_LIMIT) {
+    chunks.push(ids.slice(i, i + WORKITEMS_BATCH_LIMIT));
+  }
+  const batches = await Promise.all(chunks.map((chunk) => readWorkItemsBatch(context, cred, chunk)));
+  for (const batch of batches) {
+    for (const item of batch) {
+      const teamProject = item.fields["System.TeamProject"];
+      const project = typeof teamProject === "string" ? teamProject : context.project;
+      byId.set(item.id, {
+        id: item.id,
+        title: item.fields["System.Title"],
+        description: buildCombinedDescription(item.fields),
+        url: `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(project)}/_workitems/edit/${item.id}`,
+        state: item.fields["System.State"],
+        type: item.fields["System.WorkItemType"],
+        tags: parseTags(item.fields["System.Tags"]),
+        assignedTo: item.fields["System.AssignedTo"]?.displayName ?? null
+      });
+    }
+  }
+  return ids.flatMap((id) => byId.get(id) ?? []);
+}
 
 // src/services/auth.ts
 import { createInterface } from "readline";
@@ -1957,10 +2059,69 @@ function createGetItemCommand() {
   return command;
 }
 
-// src/commands/clear-pat.ts
+// src/commands/list-items.ts
 import { Command as Command2 } from "commander";
+var DEFAULT_TOP = 50;
+var MAX_TOP = 1e3;
+function parseTop(raw) {
+  if (raw === void 0) return DEFAULT_TOP;
+  const top = Number(raw);
+  if (!/^\d+$/.test(raw) || top < 1 || top > MAX_TOP) {
+    process.stderr.write(`Error: --top must be an integer between 1 and ${MAX_TOP}. Got: "${raw}"
+`);
+    process.exit(1);
+  }
+  return top;
+}
+function toJsonRow(item) {
+  return {
+    id: item.id,
+    title: item.title,
+    description: item.description ? toMarkdown(item.description) : "",
+    url: item.url,
+    state: item.state,
+    tags: item.tags,
+    assignedTo: item.assignedTo
+  };
+}
+function formatItemLine(item) {
+  const tags = item.tags.length > 0 ? `  [${item.tags.join(", ")}]` : "";
+  return `${item.id}	${item.state}	${item.assignedTo ?? "Unassigned"}	${item.title}${tags}`;
+}
+function createListItemsCommand() {
+  const command = new Command2("list-items");
+  command.description("List work items filtered by state, tag, assignee and title (one WIQL query, then batched reads of 200 items)").option("--state <state>", 'only items in this state (e.g. "Active")').option("--tag <tag>", "only items carrying this tag").option("--assigned-to <user>", "only items assigned to this user (display name, email, or @me)").option("--title-contains <text>", "only items whose title contains this text").option("--top <n>", `maximum number of items, newest change first (default ${DEFAULT_TOP}, max ${MAX_TOP})`).option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output an array of { id, title, description (markdown), url, state, tags, assignedTo }").action(async (options) => {
+    validateOrgProjectPair(options);
+    const top = parseTop(options.top);
+    let context;
+    try {
+      context = resolveContext(options);
+      const credential = await requireAuthCredential(context.org);
+      const items = await queryWorkItems(context, credential, {
+        state: options.state,
+        tag: options.tag,
+        assignedTo: options.assignedTo,
+        titleContains: options.titleContains,
+        top
+      });
+      if (options.json) {
+        process.stdout.write(JSON.stringify(items.map(toJsonRow)) + "\n");
+      } else if (items.length === 0) {
+        process.stdout.write("No work items found.\n");
+      } else {
+        process.stdout.write(items.map(formatItemLine).join("\n") + "\n");
+      }
+    } catch (err) {
+      handleCommandError(err, void 0, context, "read");
+    }
+  });
+  return command;
+}
+
+// src/commands/clear-pat.ts
+import { Command as Command3 } from "commander";
 function createClearPatCommand() {
-  const command = new Command2("clear-pat");
+  const command = new Command3("clear-pat");
   command.description("Remove a stored Azure DevOps PAT (deprecated: use `azdo auth logout`)").option("--org <name>", "Azure DevOps organization (overrides auto-detect / config)").action(async (options) => {
     process.stderr.write("`azdo clear-pat` is deprecated; use `azdo auth logout [--org <name>]` instead.\n");
     const resolved = resolveOrg({ org: options.org });
@@ -1983,7 +2144,7 @@ function createClearPatCommand() {
 }
 
 // src/commands/auth.ts
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 
 // src/services/auth-diagnostics.ts
 async function runConnectivityTest(org, cred) {
@@ -2481,7 +2642,7 @@ async function handleToken(orgFromGlobal) {
 `);
 }
 function createAuthCommand() {
-  const command = new Command3("auth");
+  const command = new Command4("auth");
   command.description(
     "Manage Azure DevOps authentication. Use `azdo auth login` for OAuth (default); the bare `azdo auth` form preserves the legacy PAT-prompt path for back-compat."
   );
@@ -2619,7 +2780,7 @@ not be resolved, 4 OS credential store unavailable. stdout stays empty on all.
 }
 
 // src/commands/config.ts
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 import { createInterface as createInterface2 } from "readline";
 
 // src/services/dpapi-copy.ts
@@ -2810,7 +2971,7 @@ function renderSettingsHelp(settings = SETTINGS) {
 var KEY_ARGUMENT_HELP = `setting key (${SETTINGS.map((s) => s.key).join(", ")})`;
 var KEY_HELP_POINTER = "\nRun `azdo config --help` for each setting's meaning, accepted values and scope.\n";
 function createConfigCommand() {
-  const config = new Command4("config");
+  const config = new Command5("config");
   config.description("Manage CLI settings");
   config.addHelpText("after", `
 ${renderSettingsHelp()}`);
@@ -2830,7 +2991,7 @@ ${renderSettingsHelp()}`);
       "Run `azdo auth diagnose` to see which credential is in use."
     ].join("\n")
   );
-  const set = new Command4("set");
+  const set = new Command5("set");
   set.description("Set a configuration value").argument("<key>", KEY_ARGUMENT_HELP).argument("<value>", "setting value").option("--org <org>", "set value in an org-scoped configuration").option("--json", "output in JSON format").option("--copy-credentials", "with credentialStore dpapi: copy Credential Manager credentials without asking").option("--no-copy-credentials", "with credentialStore dpapi: do not offer to copy Credential Manager credentials").addHelpText("after", KEY_HELP_POINTER).action((key, value, options) => {
     try {
       if (options.org) {
@@ -2864,7 +3025,7 @@ ${renderSettingsHelp()}`);
     }
     writeJson();
   });
-  const get = new Command4("get");
+  const get = new Command5("get");
   get.description("Get a configuration value").argument("<key>", KEY_ARGUMENT_HELP).option("--org <org>", "read from an org-scoped configuration").option("--json", "output in JSON format").addHelpText("after", KEY_HELP_POINTER).action((key, options) => {
     try {
       const value = options.org ? getOrgScopedValue(options.org, key) : getConfigValue(key);
@@ -2887,7 +3048,7 @@ ${renderSettingsHelp()}`);
       process.exit(1);
     }
   });
-  const list = new Command4("list");
+  const list = new Command5("list");
   list.description("List all configuration values").option("--json", "output in JSON format").action((options) => {
     const cfg = loadConfig();
     if (options.json) {
@@ -2897,7 +3058,7 @@ ${renderSettingsHelp()}`);
     }
     writeConfigList(cfg);
   });
-  const unset = new Command4("unset");
+  const unset = new Command5("unset");
   unset.description("Remove a configuration value").argument("<key>", KEY_ARGUMENT_HELP).option("--org <org>", "remove from an org-scoped configuration").option("--json", "output in JSON format").addHelpText("after", KEY_HELP_POINTER).action((key, options) => {
     try {
       if (options.org) {
@@ -2919,7 +3080,7 @@ ${renderSettingsHelp()}`);
       process.exit(1);
     }
   });
-  const wizard = new Command4("wizard");
+  const wizard = new Command5("wizard");
   wizard.description("Interactive wizard to configure all settings").action(async () => {
     if (!process.stdin.isTTY) {
       process.stderr.write(
@@ -2942,7 +3103,7 @@ ${renderSettingsHelp()}`);
     rl.close();
     process.stderr.write("Configuration complete!\n");
   });
-  const orgCopy = new Command4("org-copy");
+  const orgCopy = new Command5("org-copy");
   orgCopy.description('Copy settings from one scope to another (use "default" as source to copy top-level settings)').argument("<from>", 'source scope name or "default"').argument("<to>", "destination org name").option("--force", "overwrite existing values on collision").action((from, to, options) => {
     try {
       copyOrgScope(from, to, options.force ?? false);
@@ -2955,7 +3116,7 @@ ${renderSettingsHelp()}`);
       process.exit(1);
     }
   });
-  const orgMove = new Command4("org-move");
+  const orgMove = new Command5("org-move");
   orgMove.description("Move settings from one org scope to another").argument("<from>", "source org name").argument("<to>", "destination org name").option("--force", "overwrite existing values on collision").action((from, to, options) => {
     try {
       moveOrgScope(from, to, options.force ?? false);
@@ -2968,7 +3129,7 @@ ${renderSettingsHelp()}`);
       process.exit(1);
     }
   });
-  const orgDelete = new Command4("org-delete");
+  const orgDelete = new Command5("org-delete");
   orgDelete.description("Delete an org-scoped configuration").argument("<name>", "org name").action((name) => {
     try {
       deleteOrgScope(name);
@@ -2993,9 +3154,9 @@ ${renderSettingsHelp()}`);
 }
 
 // src/commands/set-state.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 function createSetStateCommand() {
-  const command = new Command5("set-state");
+  const command = new Command6("set-state");
   command.description("Change the state of a work item").argument("<id>", "work item ID").argument("<state>", 'target state (e.g., "Active", "Closed")').option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output result as JSON").action(
     async (idStr, state, options) => {
       const id = parseWorkItemId(idStr);
@@ -3031,9 +3192,9 @@ function createSetStateCommand() {
 }
 
 // src/commands/assign.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 function createAssignCommand() {
-  const command = new Command6("assign");
+  const command = new Command7("assign");
   command.description("Assign a work item to a user, or unassign it").argument("<id>", "work item ID").argument("[name]", "user display name or email").option("--unassign", "clear the Assigned To field").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output result as JSON").action(
     async (idStr, name, options) => {
       const id = parseWorkItemId(idStr);
@@ -3083,9 +3244,9 @@ function createAssignCommand() {
 }
 
 // src/commands/set-field.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 function createSetFieldCommand() {
-  const command = new Command7("set-field");
+  const command = new Command8("set-field");
   command.description("Set any work item field by its reference name").argument("<id>", "work item ID").argument("<field>", "field reference name (e.g., System.Title)").argument("<value>", "new value for the field").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output result as JSON").action(
     async (idStr, field, value, options) => {
       const id = parseWorkItemId(idStr);
@@ -3121,9 +3282,9 @@ function createSetFieldCommand() {
 }
 
 // src/commands/get-md-field.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 function createGetMdFieldCommand() {
-  const command = new Command8("get-md-field");
+  const command = new Command9("get-md-field");
   command.description("Get a work item field value, converting HTML to markdown").argument("<id>", "work item ID").argument("<field>", "field reference name (e.g., System.Description)").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project");
   addImageDownloadOptions(command);
   command.action(
@@ -3158,7 +3319,7 @@ function createGetMdFieldCommand() {
 
 // src/commands/set-md-field.ts
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 function fail(message) {
   process.stderr.write(`Error: ${message}
 `);
@@ -3220,7 +3381,7 @@ function formatOutput(result, options, field) {
   }
 }
 function createSetMdFieldCommand() {
-  const command = new Command9("set-md-field");
+  const command = new Command10("set-md-field");
   command.description("Set a work item field with markdown content").argument("<id>", "work item ID").argument("<field>", "field reference name (e.g., System.Description)").argument("[content]", "markdown content to set").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output result as JSON").option("--file <path>", "read markdown content from file").action(
     async (idStr, field, inlineContent, options) => {
       const id = parseWorkItemId(idStr);
@@ -3247,7 +3408,7 @@ function createSetMdFieldCommand() {
 
 // src/commands/upsert.ts
 import { existsSync as existsSync4, readFileSync as readFileSync4, unlinkSync } from "fs";
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 
 // src/services/task-document.ts
 var FIELD_ALIASES = /* @__PURE__ */ new Map([
@@ -3532,7 +3693,7 @@ function handleUpsertError(err, id, context) {
   process.exit(1);
 }
 function createUpsertCommand() {
-  const command = new Command10("upsert");
+  const command = new Command11("upsert");
   command.description("Create or update a work item from a markdown document").argument("[id]", "work item ID to update; omit to create a new work item").option("--content <markdown>", "task document content").option("--file <path>", "read task document from file").option("--type <workItemType>", "create mode work item type (defaults to Task)").option("--json", "output result as JSON").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").action(async (idStr, options) => {
     validateOrgProjectPair(options);
     const id = idStr === void 0 ? void 0 : parseWorkItemId(idStr);
@@ -3573,7 +3734,7 @@ function createUpsertCommand() {
 }
 
 // src/commands/list-fields.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 function stringifyValue(value) {
   if (value === null || value === void 0) return "";
   if (typeof value === "string") return value;
@@ -3607,7 +3768,7 @@ function formatFieldList(fields) {
   }).join("\n");
 }
 function createListFieldsCommand() {
-  const command = new Command11("list-fields");
+  const command = new Command12("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);
@@ -3635,7 +3796,7 @@ function createListFieldsCommand() {
 
 // src/commands/pr.ts
 import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 
 // src/services/pr-client.ts
 function buildPullRequestsUrl(context, repo, sourceBranch, opts) {
@@ -4763,7 +4924,7 @@ async function findStatusPullRequests(resolved, target) {
   return { branch, pullRequests };
 }
 function createPrStatusCommand() {
-  const command = new Command12("status");
+  const command = new Command13("status");
   withCommonPrOptions(configureUnwrappedHelp(command)).description("Check pull requests for the current branch, another branch, or a specific pull request").option("--pr-number <id>", STATUS_PR_NUMBER_HELP).option("--branch <name>", STATUS_BRANCH_HELP).option("--json", "output JSON").action(async (options) => {
     validateOrgProjectPair(options);
     const target = parseStatusTarget(options);
@@ -4850,7 +5011,7 @@ function resolveOpenDescription(inline, file) {
   return trimmedInline;
 }
 function createPrOpenCommand() {
-  const command = new Command12("open");
+  const command = new Command13("open");
   withCommonPrOptions(command).description("Open a pull request from the current branch to develop").option("--title <title>", "pull request title").option(
     "--description <description>",
     "pull request description; when omitted, a repository-defined pull request template is used if one exists (prepended by this text when both are present)"
@@ -5018,7 +5179,7 @@ ${updated.url ?? "\u2014"}
   }
 }
 function createPrUpdateCommand() {
-  const command = new Command12("update");
+  const command = new Command13("update");
   withCommonPrOptions(configureUnwrappedHelp(command)).alias("edit").description("Update a pull request's title and/or description").option("--pr-number <N>", PR_NUMBER_HELP).option("--title <title>", "new pull request title").option("--title-file <path>", 'read the new title from a UTF-8 file; "-" reads standard input').option(
     "--description <description>",
     'new pull request description; REPLACES the existing description literally \u2014 no repository pull request template is looked up or prepended, unlike "azdo pr open"'
@@ -5106,7 +5267,7 @@ ${updated.url ?? "\u2014"}
   }
 }
 function createPrAbandonCommand() {
-  const command = new Command12("abandon");
+  const command = new Command13("abandon");
   withCommonPrOptions(configureUnwrappedHelp(command)).alias("close").description(
     'Abandon a pull request (status: abandoned) \u2014 reversible with "azdo pr reactivate". This does NOT complete or merge the pull request; nothing is deleted and no confirmation is asked.'
   ).option("--pr-number <N>", PR_NUMBER_HELP).option("--json", "output JSON").action(async (_options, command2) => {
@@ -5115,7 +5276,7 @@ function createPrAbandonCommand() {
   return command;
 }
 function createPrReactivateCommand() {
-  const command = new Command12("reactivate");
+  const command = new Command13("reactivate");
   withCommonPrOptions(configureUnwrappedHelp(command)).description(
     "Reactivate an abandoned pull request (status: active). When --pr-number is omitted the current branch's single ABANDONED pull request is used, not the active one."
   ).option("--pr-number <N>", PR_NUMBER_HELP_ABANDONED).option("--json", "output JSON").action(async (_options, command2) => {
@@ -5221,7 +5382,7 @@ function describeEmptyThreads(pullRequestId, allThreadCount, active) {
 `;
 }
 function createPrCommentsCommand() {
-  const command = new Command12("comments");
+  const command = new Command13("comments");
   withCommonPrOptions(configureUnwrappedHelp(command)).description("List pull request comment threads for the current branch").option("--pr-number <N>", PR_NUMBER_HELP).option("--hide-resolved", "hide threads whose status is resolved / won't fix / closed / by design").option("--exclude-resolved", "alias of --hide-resolved: exclude resolved / won't fix / closed / by design threads").option("--code-related-only", "show only threads anchored to a file/line; omit general discussion threads").option("--exclude-system", "omit Azure DevOps system comments (branch updates, reviewer votes, build events)").option("--max-chars <N>", "truncate each comment body to N characters (0 = no limit, the default)").option("--thread <id>", "show only the thread with this numeric id; fails when the pull request has no such thread").option("--contains <text>", "show only threads holding a comment that contains this literal, case-sensitive substring (matched before --max-chars truncates)").option("--json", "output JSON").action(async (options) => {
     validateOrgProjectPair(options);
     const parsed = parseCommentsOptions(options);
@@ -5417,14 +5578,14 @@ async function runThreadStateChange(threadIdRaw, options, direction) {
   }
 }
 function createPrCommentResolveCommand() {
-  const command = new Command12("comment-resolve");
+  const command = new Command13("comment-resolve");
   withCommonPrOptions(configureUnwrappedHelp(command)).description("Mark a pull request comment thread as resolved").argument("<threadId>", "numeric id of the thread to resolve").option("--pr-number <N>", PR_NUMBER_HELP).option("--json", "output JSON").action(async (threadIdRaw, options) => {
     await runThreadStateChange(threadIdRaw, options, "resolve");
   });
   return command;
 }
 function createPrCommentReopenCommand() {
-  const command = new Command12("comment-reopen");
+  const command = new Command13("comment-reopen");
   withCommonPrOptions(configureUnwrappedHelp(command)).description("Reopen (set to active) a previously resolved pull request comment thread").argument("<threadId>", "numeric id of the thread to reopen").option("--pr-number <N>", PR_NUMBER_HELP).option("--json", "output JSON").action(async (threadIdRaw, options) => {
     await runThreadStateChange(threadIdRaw, options, "reopen");
   });
@@ -5476,7 +5637,7 @@ async function runCommentReply(threadIdRaw, text, options) {
   }
 }
 function buildCommentReplyCommand(name, description) {
-  const command = new Command12(name);
+  const command = new Command13(name);
   withCommonPrOptions(configureUnwrappedHelp(command)).description(description).argument("<threadId>", "numeric id of the thread to reply to").argument("[text]", "text of the reply; omit when using --file").option("--file <path>", "read the reply body from a UTF-8 file instead of the inline argument").option("--pr-number <N>", PR_NUMBER_HELP).option("--json", "output JSON").action(async (threadIdRaw, text, _options, command2) => {
     await runCommentReply(threadIdRaw, text, mergedPrOptions(command2));
   });
@@ -5578,7 +5739,7 @@ ${body}
   }
 }
 function buildCommentAddCommand(name, description) {
-  const command = new Command12(name);
+  const command = new Command13(name);
   withCommonPrOptions(configureUnwrappedHelp(command)).description(description).argument("[text]", "body of the new comment; omit when using --file").option("--file <path>", "read the comment body from a UTF-8 file instead of the inline argument").option(
     "--status <status>",
     `thread status (${CREATABLE_THREAD_STATUSES.join(" | ")}); omit for a plain, non-resolvable comment`
@@ -5728,7 +5889,7 @@ async function runCommentEdit(threadIdRaw, text, options) {
   }
 }
 function buildCommentEditCommand(name, description) {
-  const command = new Command12(name);
+  const command = new Command13(name);
   withCommonPrOptions(configureUnwrappedHelp(command)).description(description).argument("<threadId>", "numeric id of the thread holding the comment").argument("[text]", "new comment body; omit when using --file").option("--comment-id <N>", "numeric id of the comment to edit; defaults to the thread's first comment").option("--file <path>", "read the new body from a UTF-8 file instead of the inline argument").option("--dry-run", "print the replacement body plus the current/new lengths, without writing anything (--json also returns previousContent)").option("--pr-number <N>", PR_NUMBER_HELP).option("--json", "output JSON").action(async (threadIdRaw, text, _options, command2) => {
     await runCommentEdit(threadIdRaw, text, mergedPrOptions(command2));
   });
@@ -5829,7 +5990,7 @@ async function runCommentDelete(threadIdRaw, options) {
   }
 }
 function buildCommentDeleteCommand(name, description) {
-  const command = new Command12(name);
+  const command = new Command13(name);
   withCommonPrOptions(configureUnwrappedHelp(command)).description(description).argument("<threadId>", "numeric id of the thread holding the comment").option("--comment-id <N>", "numeric id of the comment to delete; may be omitted only when the thread holds a single comment").option("--dry-run", "resolve the target comment and print what would be deleted, without deleting anything").option("--pr-number <N>", PR_NUMBER_HELP).option("--json", "output JSON").action(async (threadIdRaw, _options, command2) => {
     await runCommentDelete(threadIdRaw, mergedPrOptions(command2));
   });
@@ -5895,7 +6056,7 @@ async function attachWorkItemIds(context, repo, cred, pullRequests) {
   return result;
 }
 function createPrListCommand() {
-  const command = new Command12("list");
+  const command = new Command13("list");
   withCommonPrOptions(configureUnwrappedHelp(command)).description("List pull requests in the repository, optionally filtered by source branch").option("--branch <name>", "only pull requests whose source branch is this one (with or without the refs/heads/ prefix)").option("--status <status>", `pull request status filter (${LIST_STATUS_VALUES.join(" | ")})`, "active").option("--top <N>", `maximum number of pull requests to return (default ${DEFAULT_LIST_TOP})`).option("--work-items", "also return the ids of each pull request's linked work items (one extra API call per pull request)").option("--json", "output JSON").action(async (options) => {
     validateOrgProjectPair(options);
     const parsed = parseListOptions(options);
@@ -5993,14 +6154,14 @@ async function runWorkItemLinkChange(workItemIdRaw, options, direction) {
   }
 }
 function buildWorkItemLinkCommand(name, description, direction) {
-  const command = new Command12(name);
+  const command = new Command13(name);
   withCommonPrOptions(configureUnwrappedHelp(command)).description(description).argument("<workItemId>", "numeric id of the work item").option("--pr-number <N>", PR_NUMBER_HELP).option("--json", "output JSON").action(async (workItemIdRaw, _options, command2) => {
     await runWorkItemLinkChange(workItemIdRaw, mergedPrOptions(command2), direction);
   });
   return command;
 }
 function createPrWorkItemsCommand() {
-  const command = new Command12("work-items");
+  const command = new Command13("work-items");
   command.description("Manage work items linked to a pull request");
   command.addCommand(buildWorkItemLinkCommand("link", "Link a work item to the pull request", "link"));
   command.addCommand(buildWorkItemLinkCommand("unlink", "Unlink a work item from the pull request", "unlink"));
@@ -6145,19 +6306,19 @@ async function runReviewerList(options) {
   }
 }
 function createPrReviewersCommand() {
-  const command = new Command12("reviewers");
+  const command = new Command13("reviewers");
   command.description("Manage pull request reviewers");
-  const list = new Command12("list");
+  const list = new Command13("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");
+  const add = new Command13("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));
   });
   command.addCommand(add);
-  const remove = new Command12("remove");
+  const remove = new Command13("remove");
   withCommonPrOptions(configureUnwrappedHelp(remove)).description("Remove a reviewer from the pull request").argument("<reviewer>", "reviewer email or unique name").option("--pr-number <N>", PR_NUMBER_HELP).option("--json", "output JSON").action(async (reviewer, _options, command2) => {
     await runReviewerRemove(reviewer, mergedPrOptions(command2));
   });
@@ -6165,7 +6326,7 @@ function createPrReviewersCommand() {
   return command;
 }
 function createPrCommand() {
-  const command = new Command12("pr");
+  const command = new Command13("pr");
   command.description("Manage Azure DevOps pull requests");
   command.addCommand(createPrListCommand());
   command.addCommand(createPrStatusCommand());
@@ -6186,7 +6347,7 @@ function createPrCommand() {
 }
 
 // src/commands/pipeline.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 
 // src/services/pipeline-client.ts
 var API_VERSION = "7.1";
@@ -6561,7 +6722,7 @@ function formatTable(rows, rightAlign = /* @__PURE__ */ new Set()) {
   ).join("\n");
 }
 function createPipelineListCommand() {
-  const command = new Command13("list");
+  const command = new Command14("list");
   command.description("List Azure DevOps pipeline definitions").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--filter <name>", "filter definitions by name (case-insensitive substring)").option("--json", "output JSON").action(async (options) => {
     validateOrgProjectPair(options);
     let context;
@@ -6633,7 +6794,7 @@ function parseGetRunsInputs(defIdRaw, options) {
   return { defId, limit: limit ?? 10, prNumber };
 }
 function createPipelineGetRunsCommand() {
-  const command = new Command13("get-runs");
+  const command = new Command14("get-runs");
   command.description("List recent runs for a pipeline definition (newest first)").argument("[def_id]", "pipeline definition id (optional with --commit or --pr)").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--limit <n>", "maximum number of runs to show (default 10)").option("--branch <branch>", "only show runs for this source branch").option("--commit <sha>", "only show runs that built this commit (full or abbreviated SHA)").option("--pr <number>", "only show runs for this pull request").option("--json", "output JSON").action(async (defIdRaw, options) => {
     validateOrgProjectPair(options);
     const inputs = parseGetRunsInputs(defIdRaw, options);
@@ -6688,7 +6849,7 @@ function applyWaitExitCode(result) {
   }
 }
 function createPipelineWaitCommand() {
-  const command = new Command13("wait");
+  const command = new Command14("wait");
   command.description("Wait for a pipeline run to finish; exit code reflects the result (0 success, non-zero otherwise)").argument("<run_id>", "pipeline run id").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--timeout <seconds>", "maximum seconds to wait (default 1800)").option("--poll-interval <seconds>", "seconds between status checks (default 5)").option("--json", "output JSON").action(async (runIdRaw, options) => {
     validateOrgProjectPair(options);
     const runId = parsePositiveId(runIdRaw);
@@ -6816,7 +6977,7 @@ function formatRunDetail(detail) {
   ].join("\n");
 }
 function createPipelineGetRunDetailCommand() {
-  const command = new Command13("get-run-detail");
+  const command = new Command14("get-run-detail");
   command.description("Show a detailed summary of a single pipeline run (errors, failing tests, stages)").argument("<run_id>", "pipeline run id").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(async (runIdRaw, options) => {
     validateOrgProjectPair(options);
     const runId = parsePositiveId(runIdRaw);
@@ -6949,7 +7110,7 @@ function printSingleLog(content, filters) {
 `);
 }
 function createPipelineLogsCommand() {
-  const command = new Command13("logs");
+  const command = new Command14("logs");
   command.description("List a pipeline run's logs, or print a specific log with --log-id").argument("<run_id>", "pipeline run id").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--log-id <id>", "print the content of this log id").option("--step <name>", "print the log of the step/job matching this name (case-insensitive substring)").option("--tail <n>", "with --log-id/--step, print only the last N lines").option("--grep <pattern>", "with --log-id/--step, print only lines matching this regular expression").option("--context <n>", "with --grep, also print N lines around each match (grep -C)").option("--json", "output JSON").action(async (runIdRaw, options) => {
     validateOrgProjectPair(options);
     const runId = parsePositiveId(runIdRaw);
@@ -7000,7 +7161,7 @@ function createPipelineLogsCommand() {
   return command;
 }
 function createPipelineTestsCommand() {
-  const command = new Command13("tests");
+  const command = new Command14("tests");
   command.description("Show a run's test results: summary plus failing tests by name (no log grepping needed)").argument("<run_id>", "pipeline run id").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--failed", "list only the failing tests").option("--json", "output JSON").action(async (runIdRaw, options) => {
     validateOrgProjectPair(options);
     const runId = parsePositiveId(runIdRaw);
@@ -7057,7 +7218,7 @@ function collectParameter(value, previous) {
   return previous.concat([value]);
 }
 function createPipelineStartCommand() {
-  const command = new Command13("start");
+  const command = new Command14("start");
   command.description("Queue a new run of a pipeline definition").argument("<def_id>", "pipeline definition id").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--branch <branch>", "branch to run against (default: pipeline default branch)").option("--parameter <key=value>", "template parameter (repeatable)", collectParameter, []).option("--json", "output JSON").action(async (defIdRaw, options) => {
     validateOrgProjectPair(options);
     const defId = parsePositiveId(defIdRaw);
@@ -7093,7 +7254,7 @@ ${result.webUrl ?? "\u2014"}
   return command;
 }
 function createPipelineCommand() {
-  const command = new Command13("pipeline");
+  const command = new Command14("pipeline");
   command.description("Manage Azure DevOps pipelines");
   command.addCommand(createPipelineListCommand());
   command.addCommand(createPipelineGetRunsCommand());
@@ -7106,7 +7267,7 @@ function createPipelineCommand() {
 }
 
 // src/commands/comments.ts
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 function writeError3(message) {
   process.stderr.write(`Error: ${message}
 `);
@@ -7126,7 +7287,7 @@ function formatComments(result, convertMarkdown) {
   return lines.join("\n");
 }
 function createCommentsListCommand() {
-  const command = new Command14("list");
+  const command = new Command15("list");
   command.description("List visible comments for a work item").argument("<id>", "work item ID").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").option("--markdown", "convert HTML comment bodies to markdown").action(async (idStr, options) => {
     validateOrgProjectPair(options);
     const id = parseWorkItemId(idStr);
@@ -7154,7 +7315,7 @@ function createCommentsListCommand() {
   return command;
 }
 function createCommentsAddCommand() {
-  const command = new Command14("add");
+  const command = new Command15("add");
   command.description("Add a comment to a work item").argument("<id>", "work item ID").argument("<text>", "comment text").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").option("--markdown", "post comment as markdown").action(async (idStr, text, options) => {
     validateOrgProjectPair(options);
     const id = parseWorkItemId(idStr);
@@ -7181,7 +7342,7 @@ function createCommentsAddCommand() {
   return command;
 }
 function createCommentsCommand() {
-  const command = new Command14("comments");
+  const command = new Command15("comments");
   command.description("Manage Azure DevOps work item comments");
   command.addCommand(createCommentsListCommand());
   command.addCommand(createCommentsAddCommand());
@@ -7189,12 +7350,12 @@ function createCommentsCommand() {
 }
 
 // src/commands/download-attachment.ts
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 import { writeFile as writeFile2 } from "fs/promises";
 import { existsSync as existsSync6 } from "fs";
 import { join as join3 } from "path";
 function createDownloadAttachmentCommand() {
-  const command = new Command15("download-attachment");
+  const command = new Command16("download-attachment");
   command.description("Download an attachment from an Azure DevOps work item").argument("<id>", "work item ID").argument("<filename>", "name of the attachment to download").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--output <dir>", "target directory for the downloaded file").action(
     async (idStr, filename, options) => {
       const id = parseWorkItemId(idStr);
@@ -7236,12 +7397,12 @@ function createDownloadAttachmentCommand() {
 }
 
 // src/commands/add-attachment.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 import { existsSync as existsSync7, statSync } from "fs";
 import { readFile } from "fs/promises";
 import { basename } from "path";
 function createAddAttachmentCommand() {
-  const command = new Command16("add-attachment");
+  const command = new Command17("add-attachment");
   command.description("Attach a local file to an Azure DevOps work item").argument("<id>", "work item ID").argument("<file>", "path to the local file to upload").option("--comment <text>", "optional comment to store with the attachment").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").action(
     async (idStr, file, options) => {
       const id = parseWorkItemId(idStr);
@@ -7288,12 +7449,12 @@ function createAddAttachmentCommand() {
 }
 
 // src/commands/delete-attachment.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 function formatUploadDate(iso) {
   return iso ? iso.slice(0, 10) : "unknown date";
 }
 function createDeleteAttachmentCommand() {
-  const command = new Command17("delete-attachment");
+  const command = new Command18("delete-attachment");
   command.description("Remove an attachment from an Azure DevOps work item").argument("<id>", "work item ID").argument("<filename>", "name of the attachment to remove").option("--id <attachmentId>", "attachment GUID, to disambiguate when the filename is shared by more than one attachment").option("-y, --yes", "skip the interactive confirmation prompt").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").action(
     async (idStr, filename, options) => {
       const id = parseWorkItemId(idStr);
@@ -7370,7 +7531,7 @@ function createDeleteAttachmentCommand() {
 }
 
 // src/commands/relations.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 
 // src/services/relations-client.ts
 var API_VERSION2 = "7.1";
@@ -7587,7 +7748,7 @@ function parsePositiveInt(value, label) {
   return n;
 }
 function createRelationsCommand() {
-  const relations = new Command18("relations").description("Manage work item relations");
+  const relations = new Command19("relations").description("Manage work item relations");
   addCommonOptions(
     relations.command("types").description("List all available work item relation types")
   ).action(async (opts) => {
@@ -7782,11 +7943,12 @@ async function getUpdateNotice(opts) {
 
 // src/program.ts
 function createProgram() {
-  const program2 = new Command19();
+  const program2 = new Command20();
   program2.name("azdo").description("Azure DevOps CLI tool").version(version, "-v, --version");
   program2.option("--no-update-check", "Skip the check for a newer published version");
   program2.option("--trace <filepath>", "Append redacted HTTP request/response trace to a file (owner-read-only permissions)");
   program2.addCommand(createGetItemCommand());
+  program2.addCommand(createListItemsCommand());
   program2.addCommand(createAuthCommand());
   program2.addCommand(createClearPatCommand());
   program2.addCommand(createConfigCommand());

package/package.json

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