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

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
@@ -135,6 +139,9 @@ azdo pipeline get-runs 12 --branch develop --limit 1
 azdo pipeline wait 3456                     # blocks; exit 0 success / non-zero failure / 124 timeout
 azdo pipeline get-run-detail 3456           # errors, failing tests, per-stage status
 azdo pipeline start 12 --branch develop --parameter env=staging
+azdo pipeline artifacts 3456                # list a run's build artifacts (name, type, size)
+azdo pipeline artifact-download 3456 reports --path ./out   # extract into ./out (--all for every artifact, --force to overwrite)
+azdo pipeline logs 3456 --step "Trivy" --head 50 --no-progress   # also --tail/--grep; --no-progress drops CR redraws
 
 # Work item relations — types, add, remove, list
 azdo relations types                        # list all relation types (Child, Parent, Related, ...)

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) {
@@ -4340,11 +4501,11 @@ function branchTemplateSegments(branch) {
   }
   return segments;
 }
-async function fetchRepositoryItemContent(context, repo, cred, path3, branch) {
+async function fetchRepositoryItemContent(context, repo, cred, path5, branch) {
   const url = new URL(
     `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/git/repositories/${encodeURIComponent(repo)}/items`
   );
-  url.searchParams.set("path", path3);
+  url.searchParams.set("path", path5);
   url.searchParams.set("versionDescriptor.version", branch);
   url.searchParams.set("versionDescriptor.versionType", "branch");
   url.searchParams.set("includeContent", "true");
@@ -4387,10 +4548,10 @@ function defaultTemplateCandidates() {
   return paths;
 }
 async function firstMatchingTemplate(context, repo, cred, defaultBranch, candidates, kind) {
-  for (const path3 of candidates) {
-    const content = await fetchRepositoryItemContent(context, repo, cred, path3, defaultBranch);
+  for (const path5 of candidates) {
+    const content = await fetchRepositoryItemContent(context, repo, cred, path5, defaultBranch);
     if (content !== null) {
-      return { path: path3, content, kind };
+      return { path: path5, content, kind };
     }
   }
   return null;
@@ -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,8 @@ function createPrCommand() {
 }
 
 // src/commands/pipeline.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
+import path3 from "path";
 
 // src/services/pipeline-client.ts
 var API_VERSION = "7.1";
@@ -6310,6 +6472,9 @@ async function getBuildStatus(context, cred, buildId) {
   const build = await getBuild(context, cred, buildId);
   return { state: mapBuildState(build.status), result: mapRunResult(build.result) };
 }
+function recordErrors(record) {
+  return (record.issues ?? []).filter((issue) => issue.type === "error" && issue.message).map((issue) => ({ message: issue.message ?? "", source: record.name ?? null }));
+}
 async function getBuildTimeline(context, cred, buildId) {
   const url = withApiVersion(
     new URL(`${orgProjectBase(context)}/_apis/build/builds/${buildId}/timeline`)
@@ -6321,14 +6486,20 @@ async function getBuildTimeline(context, cred, buildId) {
   const stages = [];
   const jobs = [];
   const logSteps = /* @__PURE__ */ new Map();
+  const logRecords = /* @__PURE__ */ new Map();
+  const namesById = /* @__PURE__ */ new Map();
   for (const record of records) {
-    for (const issue of record.issues ?? []) {
-      if (issue.type === "error" && issue.message) {
-        errors.push({ message: issue.message, source: record.name ?? null });
-      }
-    }
+    if (record.id && record.name) namesById.set(record.id, record.name);
+  }
+  for (const record of records) {
+    errors.push(...recordErrors(record));
     if (record.name && record.log?.id !== void 0) {
       logSteps.set(record.log.id, record.name);
+      logRecords.set(record.log.id, {
+        name: record.name,
+        type: record.type ?? null,
+        parent: record.parentId && namesById.get(record.parentId) || null
+      });
     }
     if (!record.name) continue;
     const status2 = {
@@ -6348,7 +6519,7 @@ async function getBuildTimeline(context, cred, buildId) {
     if (b.startTime === void 0) return -1;
     return a.startTime < b.startTime ? -1 : 1;
   });
-  return { errors, stages, jobs: jobs.map((j) => j.status), logSteps };
+  return { errors, stages, jobs: jobs.map((j) => j.status), logSteps, logRecords };
 }
 async function listTestRuns(context, cred, buildId) {
   const url = withApiVersion(new URL(`${orgProjectBase(context)}/_apis/test/runs`));
@@ -6457,16 +6628,18 @@ async function getRunLogs(context, cred, buildId) {
   );
   const response = await fetchWithErrors(url.toString(), { headers: authHeaders(cred) });
   const data = await readJsonResponse2(response);
-  let logSteps = /* @__PURE__ */ new Map();
+  let logRecords = /* @__PURE__ */ new Map();
   try {
-    logSteps = (await getBuildTimeline(context, cred, buildId)).logSteps;
+    logRecords = (await getBuildTimeline(context, cred, buildId)).logRecords;
   } catch {
   }
   return data.value.map((log) => ({
     id: log.id,
     createdOn: log.createdOn ?? null,
     lineCount: log.lineCount ?? null,
-    step: logSteps.get(log.id) ?? null
+    step: logRecords.get(log.id)?.name ?? null,
+    type: logRecords.get(log.id)?.type ?? null,
+    parent: logRecords.get(log.id)?.parent ?? null
   }));
 }
 async function getRunLog(context, cred, buildId, logId) {
@@ -6479,6 +6652,108 @@ async function getRunLog(context, cred, buildId, logId) {
   }
   return response.text();
 }
+async function listBuildArtifacts(context, cred, buildId) {
+  const url = withApiVersion(
+    new URL(`${orgProjectBase(context)}/_apis/build/builds/${buildId}/artifacts`)
+  );
+  const response = await fetchWithErrors(url.toString(), { headers: authHeaders(cred) });
+  const data = await readJsonResponse2(response);
+  return data.value.map((artifact) => {
+    const size = Number.parseInt(artifact.resource?.properties?.artifactsize ?? "", 10);
+    return {
+      id: artifact.id,
+      name: artifact.name,
+      type: artifact.resource?.type ?? null,
+      sizeBytes: Number.isFinite(size) ? size : null,
+      downloadUrl: artifact.resource?.downloadUrl ?? null
+    };
+  });
+}
+async function downloadArtifactZip(cred, artifact, onProgress) {
+  if (!artifact.downloadUrl) {
+    throw new Error(`Artifact "${artifact.name}" (${artifact.type ?? "unknown type"}) has no download URL.`);
+  }
+  const url = new URL(artifact.downloadUrl);
+  url.searchParams.set("$format", "zip");
+  const response = await fetchWithErrors(url.toString(), { headers: authHeaders(cred) });
+  if (!response.ok) {
+    throw httpError(response);
+  }
+  if (!response.body) {
+    return new Uint8Array(await response.arrayBuffer());
+  }
+  const chunks = [];
+  let received = 0;
+  for await (const chunk of response.body) {
+    chunks.push(chunk);
+    received += chunk.length;
+    onProgress?.(received);
+  }
+  return Buffer.concat(chunks);
+}
+
+// src/services/artifact-extract.ts
+import { existsSync as existsSync6, lstatSync, mkdirSync, realpathSync, writeFileSync } from "fs";
+import path2 from "path";
+import { unzipSync } from "fflate";
+function entryTarget(entry, artifactName) {
+  const normalized = entry.replaceAll("\\", "/");
+  if (normalized.endsWith("/")) return null;
+  const prefix = `${artifactName}/`;
+  const relative = normalized.startsWith(prefix) ? normalized.slice(prefix.length) : normalized;
+  const segments = relative.split("/");
+  if (relative.startsWith("/") || /^[A-Za-z]:/.test(relative) || segments.includes("..")) {
+    throw new Error(`Refusing to extract "${entry}": path escapes the destination folder.`);
+  }
+  return relative;
+}
+function assertNoSymlinkEscape(root, relative) {
+  let current = root;
+  for (const segment of relative.split("/")) {
+    current = path2.join(current, segment);
+    let isLink;
+    try {
+      isLink = lstatSync(current).isSymbolicLink();
+    } catch {
+      return;
+    }
+    if (isLink) {
+      throw new Error(`Refusing to extract through symbolic link "${current}".`);
+    }
+  }
+}
+function extractArtifactZip(zip, destination, options) {
+  const entries = unzipSync(zip);
+  const targets = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const [entry, data] of Object.entries(entries)) {
+    const relative = entryTarget(entry, options.artifactName);
+    if (relative === null) continue;
+    const key = path2.posix.normalize(relative);
+    if (seen.has(key)) {
+      throw new Error(`Refusing to extract: several archive entries resolve to "${key}".`);
+    }
+    seen.add(key);
+    targets.push({ relative: key, data });
+  }
+  if (!options.force) {
+    const existing = targets.find((t) => existsSync6(path2.join(destination, t.relative)));
+    if (existing) {
+      throw new Error(
+        `"${path2.join(destination, existing.relative)}" already exists. Use --force to overwrite.`
+      );
+    }
+  }
+  mkdirSync(destination, { recursive: true });
+  const root = realpathSync(destination);
+  for (const { relative } of targets) assertNoSymlinkEscape(root, relative);
+  for (const { relative, data } of targets) {
+    const file = path2.join(root, relative);
+    mkdirSync(path2.dirname(file), { recursive: true });
+    writeFileSync(file, data);
+  }
+  return targets.map((t) => t.relative);
+}
 
 // src/commands/pipeline.ts
 var EXIT_FAILED = 1;
@@ -6561,7 +6836,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 +6908,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 +6963,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);
@@ -6815,19 +7090,26 @@ function formatRunDetail(detail) {
     ...testRows(detail)
   ].join("\n");
 }
+async function withRunContext(runIdRaw, options, body) {
+  validateOrgProjectPair(options);
+  const runId = parsePositiveId(runIdRaw);
+  if (runId === null) {
+    writeError2(`Invalid run id "${runIdRaw}"; expected a positive integer.`);
+    return;
+  }
+  let context;
+  try {
+    const resolved = await resolvePipelineContext(options);
+    context = resolved.context;
+    await body(runId, resolved);
+  } catch (err) {
+    handlePipelineError(err, context);
+  }
+}
 function createPipelineGetRunDetailCommand() {
-  const command = new Command13("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);
-    if (runId === null) {
-      writeError2(`Invalid run id "${runIdRaw}"; expected a positive integer.`);
-      return;
-    }
-    let context;
-    try {
-      const resolved = await resolvePipelineContext(options);
-      context = resolved.context;
+  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(
+    (runIdRaw, options) => withRunContext(runIdRaw, options, async (runId, resolved) => {
       const detail = await getRunDetail(resolved.context, resolved.cred, runId);
       if (options.json) {
         process.stdout.write(`${JSON.stringify(detail, null, 2)}
@@ -6836,10 +7118,8 @@ function createPipelineGetRunDetailCommand() {
       }
       process.stdout.write(`${formatRunDetail(detail)}
 `);
-    } catch (err) {
-      handlePipelineError(err, context);
-    }
-  });
+    })
+  );
   return command;
 }
 function grepWithContext(lines, grep, context) {
@@ -6862,17 +7142,29 @@ function grepWithContext(lines, grep, context) {
   }
   return selected;
 }
-function filterLogLines(content, grep, tail, context) {
+function collapseProgress(line) {
+  let end = line.length;
+  while (end > 0 && line[end - 1] === "\r") end--;
+  return line.slice(line.lastIndexOf("\r", end - 1) + 1, end);
+}
+function filterLogLines(content, filters) {
+  const { grep, tail, head, contextLines: context } = filters;
   let lines = content.split("\n");
   if (lines.at(-1) === "") {
     lines.pop();
   }
+  if (filters.noProgress) {
+    lines = lines.map(collapseProgress);
+  }
   if (grep) {
     lines = context > 0 ? grepWithContext(lines, grep, context) : lines.filter((line) => grep.test(line));
   }
   if (tail !== void 0 && lines.length > tail) {
     lines = lines.slice(-tail);
   }
+  if (head !== void 0 && lines.length > head) {
+    lines = lines.slice(0, head);
+  }
   return lines;
 }
 function parseLogFilters(options) {
@@ -6881,9 +7173,14 @@ function parseLogFilters(options) {
     return null;
   }
   const selectsSingleLog = options.logId !== void 0 || options.step !== void 0;
-  const slices = options.tail !== void 0 || options.grep !== void 0 || options.context !== void 0;
+  const noProgress = options.progress === false;
+  const slices = options.tail !== void 0 || options.head !== void 0 || options.grep !== void 0 || options.context !== void 0 || noProgress;
   if (slices && !selectsSingleLog) {
-    writeError2("--tail, --grep, and --context require --log-id or --step.");
+    writeError2("--tail, --head, --grep, --context, and --no-progress require --log-id or --step.");
+    return null;
+  }
+  if (options.head !== void 0 && options.tail !== void 0) {
+    writeError2("Use either --head or --tail, not both.");
     return null;
   }
   if (options.context !== void 0 && options.grep === void 0) {
@@ -6892,6 +7189,8 @@ function parseLogFilters(options) {
   }
   const tail = parseOptionalCount(options.tail, "--tail");
   if (tail === null) return null;
+  const head = parseOptionalCount(options.head, "--head");
+  if (head === null) return null;
   const contextLines = parseOptionalCount(options.context, "--context");
   if (contextLines === null) return null;
   let grep;
@@ -6903,7 +7202,13 @@ function parseLogFilters(options) {
       return null;
     }
   }
-  return { tail, contextLines: contextLines ?? 0, grep };
+  return { tail, head, noProgress, contextLines: contextLines ?? 0, grep };
+}
+function describeLog(log) {
+  const kind = log.type ?? "";
+  const where = log.parent ? ` in ${log.parent}` : "";
+  const detail = `${kind}${where}`.trim();
+  return detail ? `${log.step} [${detail}]` : String(log.step);
 }
 function chooseStepLog(logs, step, runId) {
   const needle = step.toLowerCase();
@@ -6915,7 +7220,7 @@ function chooseStepLog(logs, step, runId) {
     return null;
   }
   if (chosen.length > 1) {
-    const candidates = chosen.map((l) => `${l.id} (${l.step})`).join(", ");
+    const candidates = chosen.map((l) => `${l.id} (${describeLog(l)})`).join(", ");
     writeError2(`Step "${step}" matches multiple logs: ${candidates}. Be more specific or use --log-id.`);
     return null;
   }
@@ -6937,8 +7242,8 @@ async function resolveRequestedLogId(resolved, runId, options) {
   return chooseStepLog(allLogs, options.step, runId);
 }
 function printSingleLog(content, filters) {
-  if (filters.grep !== void 0 || filters.tail !== void 0) {
-    const lines = filterLogLines(content, filters.grep, filters.tail, filters.contextLines);
+  if (filters.grep !== void 0 || filters.tail !== void 0 || filters.head !== void 0 || filters.noProgress) {
+    const lines = filterLogLines(content, filters);
     if (lines.length > 0) {
       process.stdout.write(`${lines.join("\n")}
 `);
@@ -6949,8 +7254,8 @@ function printSingleLog(content, filters) {
 `);
 }
 function createPipelineLogsCommand() {
-  const command = new Command13("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) => {
+  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("--head <n>", "with --log-id/--step, print only the first 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("--no-progress", "with --log-id/--step, collapse carriage-return progress redraws to their final state").option("--json", "output JSON").action(async (runIdRaw, options) => {
     validateOrgProjectPair(options);
     const runId = parsePositiveId(runIdRaw);
     if (runId === null) {
@@ -6989,7 +7294,9 @@ function createPipelineLogsCommand() {
         String(l.id),
         l.createdOn ?? "\u2014",
         l.lineCount == null ? "" : `${l.lineCount} lines`,
-        l.step ?? ""
+        l.type ?? "",
+        l.step ?? "",
+        l.parent ? `(in ${l.parent})` : ""
       ]);
       process.stdout.write(`${formatTable(rows, /* @__PURE__ */ new Set([0]))}
 `);
@@ -6999,8 +7306,104 @@ function createPipelineLogsCommand() {
   });
   return command;
 }
+function formatSize(bytes) {
+  if (bytes === null) return "";
+  if (bytes < 1024) return `${bytes} B`;
+  const units = ["KB", "MB", "GB", "TB"];
+  let value = bytes / 1024;
+  let unit = 0;
+  while (value >= 1024 && unit < units.length - 1) {
+    value /= 1024;
+    unit++;
+  }
+  return `${value.toFixed(1)} ${units[unit]}`;
+}
+function createPipelineArtifactsCommand() {
+  const command = new Command14("artifacts");
+  command.description("List the build artifacts published by a pipeline run").argument("<run_id>", "pipeline run id").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(
+    (runIdRaw, options) => withRunContext(runIdRaw, options, async (runId, resolved) => {
+      const artifacts = await listBuildArtifacts(resolved.context, resolved.cred, runId);
+      if (options.json) {
+        process.stdout.write(`${JSON.stringify(artifacts, null, 2)}
+`);
+        return;
+      }
+      if (artifacts.length === 0) {
+        process.stdout.write(`No artifacts found for run ${runId}.
+`);
+        return;
+      }
+      const rows = artifacts.map((a) => [a.name, a.type ?? "", formatSize(a.sizeBytes)]);
+      process.stdout.write(`${formatTable(rows)}
+`);
+    })
+  );
+  return command;
+}
+function selectArtifacts(artifacts, name, all, runId) {
+  const available = artifacts.map((a) => a.name).join(", ") || "(none)";
+  if (all) return artifacts;
+  if (name === void 0) {
+    writeError2(`Give an artifact name or --all. Available artifacts in run ${runId}: ${available}.`);
+    return null;
+  }
+  const match = artifacts.find((a) => a.name === name);
+  if (!match) {
+    writeError2(`Run ${runId} has no artifact "${name}". Available artifacts: ${available}.`);
+    return null;
+  }
+  return [match];
+}
+function createPipelineArtifactDownloadCommand() {
+  const command = new Command14("artifact-download");
+  command.description("Download a run's artifact (or --all) and extract it into a folder; no zip is left behind").argument("<run_id>", "pipeline run id").argument("[name]", "artifact name (see `pipeline artifacts`)").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--path <dir>", "destination folder (default ./<name>; with --all, <dir>/<name> per artifact)").option("--all", "download every artifact of the run").option("--force", "overwrite files that already exist").option("--progress", "print byte-progress lines on stderr").option("--json", "output JSON").action(async (runIdRaw, name, options) => {
+    validateOrgProjectPair(options);
+    const runId = parsePositiveId(runIdRaw);
+    if (runId === null) {
+      writeError2(`Invalid run id "${runIdRaw}"; expected a positive integer.`);
+      return;
+    }
+    if (options.all && name !== void 0) {
+      writeError2("Use either an artifact name or --all, not both.");
+      return;
+    }
+    let context;
+    try {
+      const resolved = await resolvePipelineContext(options);
+      context = resolved.context;
+      const artifacts = await listBuildArtifacts(resolved.context, resolved.cred, runId);
+      const selected = selectArtifacts(artifacts, name, options.all === true, runId);
+      if (selected === null) return;
+      const results = await Promise.all(
+        selected.map(async (artifact) => {
+          const destination = path3.resolve(
+            options.all ? path3.join(options.path ?? ".", artifact.name) : options.path ?? artifact.name
+          );
+          const onProgress = options.progress ? (bytes) => process.stderr.write(`${artifact.name}: ${bytes} bytes
+`) : void 0;
+          const zip = await downloadArtifactZip(resolved.cred, artifact, onProgress);
+          const files = extractArtifactZip(zip, destination, {
+            artifactName: artifact.name,
+            force: options.force === true
+          });
+          return { name: artifact.name, path: destination, files: files.length };
+        })
+      );
+      if (options.json) {
+        process.stdout.write(`${JSON.stringify(results, null, 2)}
+`);
+        return;
+      }
+      process.stdout.write(`${results.map((r) => r.path).join("\n")}
+`);
+    } catch (err) {
+      handlePipelineError(err, context);
+    }
+  });
+  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 +7460,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,20 +7496,22 @@ ${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());
   command.addCommand(createPipelineWaitCommand());
   command.addCommand(createPipelineGetRunDetailCommand());
   command.addCommand(createPipelineLogsCommand());
+  command.addCommand(createPipelineArtifactsCommand());
+  command.addCommand(createPipelineArtifactDownloadCommand());
   command.addCommand(createPipelineTestsCommand());
   command.addCommand(createPipelineStartCommand());
   return command;
 }
 
 // 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 +7531,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 +7559,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 +7586,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 +7594,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 { existsSync as existsSync7 } 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);
@@ -7204,7 +7609,7 @@ function createDownloadAttachmentCommand() {
         context = resolveContext(options);
         const credential = await requireAuthCredential(context.org);
         const outputDir = options.output ?? ".";
-        if (!existsSync6(outputDir)) {
+        if (!existsSync7(outputDir)) {
           process.stderr.write(`Error: Output directory "${outputDir}" does not exist.
 `);
           process.exit(1);
@@ -7236,17 +7641,17 @@ function createDownloadAttachmentCommand() {
 }
 
 // src/commands/add-attachment.ts
-import { Command as Command16 } from "commander";
-import { existsSync as existsSync7, statSync } from "fs";
+import { Command as Command17 } from "commander";
+import { existsSync as existsSync8, 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);
       validateOrgProjectPair(options);
-      if (!existsSync7(file)) {
+      if (!existsSync8(file)) {
         process.stderr.write(`Error: File not found: ${file}
 `);
         process.exit(1);
@@ -7288,12 +7693,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 +7775,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 +7992,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) => {
@@ -7666,7 +8071,7 @@ function createRelationsCommand() {
 
 // src/services/update-check.ts
 import fs2 from "fs";
-import path2 from "path";
+import path4 from "path";
 import os from "os";
 var THROTTLE_MS = 10 * 60 * 1e3;
 var FETCH_TIMEOUT_MS = 1500;
@@ -7684,7 +8089,7 @@ function skipsUpdateCheck(commandPath) {
   return UPDATE_CHECK_EXEMPT_COMMANDS.has(withoutRoot.join(" "));
 }
 function getCachePath() {
-  return path2.join(os.homedir(), ".azdo", "update-check.json");
+  return path4.join(os.homedir(), ".azdo", "update-check.json");
 }
 function defaultReadCache() {
   try {
@@ -7696,7 +8101,7 @@ function defaultReadCache() {
 function defaultWriteCache(data) {
   try {
     const cachePath = getCachePath();
-    fs2.mkdirSync(path2.dirname(cachePath), { recursive: true });
+    fs2.mkdirSync(path4.dirname(cachePath), { recursive: true });
     fs2.writeFileSync(cachePath, data);
   } catch {
   }
@@ -7782,11 +8187,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.807",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {
@@ -28,6 +28,7 @@
     "@napi-rs/keyring": "^1.3.0",
     "@primno/dpapi": "^2.0.1",
     "commander": "^14.0.3",
+    "fflate": "^0.8.3",
     "jimp": "^1.6.1",
     "node-html-markdown": "^2.0.0"
   },