azdo-cli 0.21.0 → 0.22.0-ci-harden-workflow.876

package/dist/index.js

@@ -39,10 +39,10 @@ import {
   tokenResponseToCredential,
   unsetConfigValue,
   unsetOrgScopedValue
-} from "./chunk-W4EVKARR.js";
+} 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";
@@ -143,6 +143,7 @@ function getActiveTraceWriter() {
 }
 
 // src/services/command-helpers.ts
+import { existsSync, readFileSync as readFileSync2 } from "fs";
 var EXIT_CREDENTIAL_STORE_UNAVAILABLE = 4;
 function reportCredentialStoreUnavailable(err) {
   if (!(err instanceof CredentialStoreUnavailableError)) return false;
@@ -249,8 +250,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") {
@@ -278,11 +280,29 @@ function handleCommandError(err, id, context, scope = "write", exit = true) {
     process.exitCode = 1;
   }
 }
+var STDIN_PATH = "-";
+function readTextSource(file) {
+  if (file === STDIN_PATH) {
+    try {
+      return readFileSync2(0, "utf-8");
+    } catch {
+      throw new Error("Cannot read standard input.");
+    }
+  }
+  if (!existsSync(file)) {
+    throw new Error(`File not found: ${file}`);
+  }
+  try {
+    return readFileSync2(file, "utf-8");
+  } catch {
+    throw new Error(`Cannot read file: ${file}`);
+  }
+}
 
 // src/services/image-download.ts
 import { Jimp } from "jimp";
 import { writeFile } from "fs/promises";
-import { existsSync } from "fs";
+import { existsSync as existsSync2 } from "fs";
 import { tmpdir } from "os";
 import { join } from "path";
 var ATTACHMENT_GUID_RE = /_apis\/wit\/attachments\/([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})/;
@@ -365,7 +385,7 @@ function resolveImageDownloadOptions(flags) {
     maxWidth = parsed;
   }
   const outputDir = flags.imagesPath ?? tmpdir();
-  if (flags.imagesPath !== void 0 && !existsSync(outputDir)) {
+  if (flags.imagesPath !== void 0 && !existsSync2(outputDir)) {
     throw new Error(`Images path "${outputDir}" does not exist.`);
   }
   return { enabled, maxWidth, outputDir };
@@ -455,6 +475,9 @@ var DEFAULT_FIELDS = [
   "System.State",
   "System.WorkItemType",
   "System.AssignedTo",
+  "System.CreatedBy",
+  "System.CreatedDate",
+  "System.Tags",
   "System.Description",
   "Microsoft.VSTS.Common.AcceptanceCriteria",
   "Microsoft.VSTS.TCM.ReproSteps",
@@ -667,12 +690,19 @@ function buildWorkItemCommentsUrl(context, id) {
   url.searchParams.set("api-version", "7.1-preview.4");
   return url;
 }
+function buildWorkItemCommentUrl(context, id, commentId) {
+  const url = buildWorkItemCommentsUrl(context, id);
+  url.pathname = `${url.pathname}/${commentId}`;
+  return url;
+}
 function mapWorkItemComment(comment, fallbackWorkItemId) {
   return {
     id: comment.id ?? comment.commentId ?? 0,
     workItemId: comment.workItemId ?? fallbackWorkItemId,
     text: typeof comment.text === "string" ? comment.text : "",
     author: comment.createdBy?.displayName ?? null,
+    authorUniqueName: comment.createdBy?.uniqueName ?? null,
+    authorId: comment.createdBy?.id ?? null,
     createdAt: comment.createdDate ?? null,
     modifiedAt: comment.modifiedDate ?? null,
     isDeleted: comment.isDeleted === true
@@ -782,6 +812,30 @@ async function getOrgFieldNames(context, cred) {
   const data = await response.json();
   return (data.value ?? []).map((f) => f.referenceName);
 }
+function toIdentity(ref) {
+  if (!ref) return null;
+  return {
+    displayName: ref.displayName ?? null,
+    uniqueName: ref.uniqueName ?? null,
+    id: ref.id ?? null
+  };
+}
+var PULL_REQUEST_ARTIFACT = /^vstfs:\/\/\/Git\/PullRequestId\/(.+)$/i;
+function mapRelations(relations) {
+  return (relations ?? []).map((r) => {
+    const entry = { rel: r.rel, name: r.attributes?.name ?? null, url: r.url };
+    const workItemMatch = /\/workItems\/(\d+)$/i.exec(r.url);
+    if (workItemMatch) entry.workItemId = Number(workItemMatch[1]);
+    const prMatch = PULL_REQUEST_ARTIFACT.exec(r.url);
+    if (prMatch) {
+      const [projectId, repositoryId, prId] = prMatch[1].split(/%2F|\//i);
+      if (projectId && repositoryId && /^\d+$/.test(prId ?? "")) {
+        entry.pullRequest = { id: Number(prId), repositoryId, projectId };
+      }
+    }
+    return entry;
+  });
+}
 function buildCombinedDescription(fields) {
   const parts = [];
   if (fields["System.Description"]) {
@@ -837,6 +891,11 @@ async function getWorkItem(context, id, cred, extraFields) {
     state: data.fields["System.State"],
     type: data.fields["System.WorkItemType"],
     assignedTo: data.fields["System.AssignedTo"]?.displayName ?? null,
+    assignedToIdentity: toIdentity(data.fields["System.AssignedTo"]),
+    createdBy: toIdentity(data.fields["System.CreatedBy"]),
+    createdDate: data.fields["System.CreatedDate"] ?? null,
+    tags: parseTags(data.fields["System.Tags"]),
+    relations: mapRelations(relationsData.relations),
     description: buildCombinedDescription(data.fields),
     areaPath: data.fields["System.AreaPath"],
     iterationPath: data.fields["System.IterationPath"],
@@ -891,16 +950,11 @@ async function listWorkItemComments(context, id, cred) {
     comments
   };
 }
-async function addWorkItemComment(context, id, cred, text, format = "html") {
-  const url = buildWorkItemCommentsUrl(context, id);
-  url.searchParams.set("format", format);
+async function sendCommentRequest(url, cred, method, body) {
   const response = await fetchWithErrors(url.toString(), {
-    method: "POST",
-    headers: {
-      ...authHeaders(cred),
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({ text })
+    method,
+    headers: body === void 0 ? authHeaders(cred) : { ...authHeaders(cred), "Content-Type": "application/json" },
+    body: body === void 0 ? void 0 : JSON.stringify(body)
   });
   if (response.status === 400) {
     const serverMessage = await readResponseMessage(response) ?? "Unknown error";
@@ -909,16 +963,54 @@ async function addWorkItemComment(context, id, cred, text, format = "html") {
   if (!response.ok) {
     throw httpError(response);
   }
+  return response;
+}
+async function writeCommentText(url, cred, method, text, format, fallback) {
+  url.searchParams.set("format", format);
+  const response = await sendCommentRequest(url, cred, method, { text });
   const data = await response.json();
   return {
-    workItemId: data.workItemId ?? id,
-    commentId: data.commentId ?? data.id ?? 0,
+    workItemId: data.workItemId ?? fallback.workItemId,
+    commentId: data.commentId ?? data.id ?? fallback.commentId,
     text: typeof data.text === "string" ? data.text : text,
     author: data.createdBy?.displayName ?? null,
+    authorUniqueName: data.createdBy?.uniqueName ?? null,
+    authorId: data.createdBy?.id ?? null,
     createdAt: data.createdDate ?? null,
+    modifiedAt: data.modifiedDate ?? null,
     url: data.url ?? null
   };
 }
+async function addWorkItemComment(context, id, cred, text, format = "html") {
+  const written = await writeCommentText(
+    buildWorkItemCommentsUrl(context, id),
+    cred,
+    "POST",
+    text,
+    format,
+    { workItemId: id, commentId: 0 }
+  );
+  return {
+    workItemId: written.workItemId,
+    commentId: written.commentId,
+    text: written.text,
+    author: written.author,
+    authorUniqueName: written.authorUniqueName,
+    authorId: written.authorId,
+    createdAt: written.createdAt,
+    url: written.url
+  };
+}
+async function updateWorkItemComment(context, id, commentId, cred, text, format = "html") {
+  return writeCommentText(buildWorkItemCommentUrl(context, id, commentId), cred, "PATCH", text, format, {
+    workItemId: id,
+    commentId
+  });
+}
+async function deleteWorkItemComment(context, id, commentId, cred) {
+  await sendCommentRequest(buildWorkItemCommentUrl(context, id, commentId), cred, "DELETE");
+  return { workItemId: id, commentId, deleted: true };
+}
 async function updateWorkItem(context, id, cred, fieldName, operations) {
   const result = await applyWorkItemPatch(context, id, cred, operations);
   const title = result.fields["System.Title"];
@@ -988,10 +1080,111 @@ 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";
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
 import { dirname as dirname2, join as join2 } from "path";
 
 // src/services/oauth-device-code.ts
@@ -1161,8 +1354,8 @@ async function promptForPat() {
   });
 }
 function patFromEnvFile(envFile) {
-  if (!existsSync2(envFile)) return null;
-  const contents = readFileSync2(envFile, "utf8");
+  if (!existsSync3(envFile)) return null;
+  const contents = readFileSync3(envFile, "utf8");
   for (const line of contents.split("\n")) {
     const match = line.match(/^AZDO_PAT\s*=([^\n\r]+)$/);
     if (match === null) continue;
@@ -1846,6 +2039,20 @@ function convertRichText(html, markdown) {
   if (!html) return "";
   return markdown ? toMarkdown(html) : stripHtml(html);
 }
+function toJsonDocument(workItem) {
+  return {
+    id: workItem.id,
+    title: workItem.title,
+    description: workItem.description ? toMarkdown(workItem.description) : "",
+    state: workItem.state,
+    tags: workItem.tags ?? [],
+    assignedTo: workItem.assignedToIdentity ?? null,
+    createdBy: workItem.createdBy ?? null,
+    createdDate: workItem.createdDate ?? null,
+    url: workItem.url,
+    relations: workItem.relations ?? []
+  };
+}
 function formatMarkdownField(fieldLabel, value) {
   if (value.includes("\n")) {
     return `${fieldLabel}:
@@ -1923,13 +2130,17 @@ function formatWorkItem(workItem, short, markdown = false) {
 }
 function createGetItemCommand() {
   const command = new Command("get-item");
-  command.description("Retrieve an Azure DevOps work item by ID").argument("<id>", "work item ID").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--short", "show abbreviated output").option("--fields <fields>", "comma-separated additional field reference names").option("--markdown", "convert rich text fields to markdown");
+  command.description("Retrieve an Azure DevOps work item by ID").argument("<id>", "work item ID").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--short", "show abbreviated output").option("--fields <fields>", "comma-separated additional field reference names").option("--markdown", "convert rich text fields to markdown").option("--json", "output { id, title, description (markdown), state, tags, assignedTo, createdBy, createdDate, url, relations } (assignedTo/createdBy: { displayName, uniqueName, id }; relations include pull requests)");
   addImageDownloadOptions(command);
   command.action(
     async (idStr, options) => {
       const id = parseWorkItemId(idStr);
       validateOrgProjectPair(options);
       const imageOptions = resolveImageDownloadOptionsOrExit(options);
+      if (options.json && (imageOptions.enabled || options.downloadImages || options.resizeImages !== void 0 || options.imagesPath !== void 0)) {
+        process.stderr.write("Error: --json cannot be combined with image download options.\n");
+        process.exit(1);
+      }
       let context;
       try {
         context = resolveContext(options);
@@ -1937,6 +2148,10 @@ function createGetItemCommand() {
         const scopedCfg = resolveScopedConfig(context.org);
         const fieldsList = options.fields === void 0 ? parseRequestedFields(scopedCfg.fields) : parseRequestedFields(options.fields);
         const workItem = await getWorkItem(context, id, credential, fieldsList);
+        if (options.json) {
+          process.stdout.write(JSON.stringify(toJsonDocument(workItem)) + "\n");
+          return;
+        }
         const markdownEnabled = options.markdown ?? scopedCfg.markdown ?? false;
         const output = formatWorkItem(workItem, options.short ?? false, markdownEnabled);
         process.stdout.write(output + "\n");
@@ -1957,10 +2172,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 +2257,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 +2755,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 +2893,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
@@ -2777,9 +3051,43 @@ async function promptForSetting(cfg, setting, ask) {
 
 `);
 }
+var SETTING_TYPE_LABEL = {
+  string: "string",
+  "string[]": "comma-separated list",
+  boolean: "true | false"
+};
+function describeSettingValues(setting) {
+  if (!setting.values) return `type: ${SETTING_TYPE_LABEL[setting.type]}`;
+  const list = setting.values.map((v) => v.note ? `${v.value} (${v.note})` : v.value).join(", ");
+  return `values: ${list}`;
+}
+function renderSettingsHelp(settings = SETTINGS) {
+  const keyWidth = Math.max(...settings.map((s) => s.key.length)) + 3;
+  const indent = " ".repeat(2 + keyWidth);
+  const lines = ["Settings (azdo config set <key> <value>):", ""];
+  for (const setting of settings) {
+    const facts = [
+      describeSettingValues(setting),
+      `scope: ${setting.scoped ? "global, or per organization with --org <org>" : "global only"}`,
+      ...setting.required ? ["required"] : [],
+      ...setting.env ? [`env: ${setting.env} overrides the stored value`] : [],
+      `example: azdo config set ${setting.key} ${setting.example}`
+    ];
+    lines.push(
+      `  ${setting.key.padEnd(keyWidth)}${setting.description}`,
+      ...facts.map((fact) => `${indent}${fact}`),
+      ""
+    );
+  }
+  return lines.join("\n").trimEnd();
+}
+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()}`);
   config.addHelpText(
     "after",
     [
@@ -2796,8 +3104,8 @@ function createConfigCommand() {
       "Run `azdo auth diagnose` to see which credential is in use."
     ].join("\n")
   );
-  const set = new Command4("set");
-  set.description("Set a configuration value").argument("<key>", "setting key (org, project, fields, markdown, credentialStore)").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").action((key, value, options) => {
+  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) {
         setOrgScopedValue(options.org, key, value);
@@ -2830,8 +3138,8 @@ function createConfigCommand() {
     }
     writeJson();
   });
-  const get = new Command4("get");
-  get.description("Get a configuration value").argument("<key>", "setting key (org, project, fields, markdown, credentialStore)").option("--org <org>", "read from an org-scoped configuration").option("--json", "output in JSON format").action((key, options) => {
+  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);
       if (options.json) {
@@ -2853,7 +3161,7 @@ function createConfigCommand() {
       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) {
@@ -2863,8 +3171,8 @@ function createConfigCommand() {
     }
     writeConfigList(cfg);
   });
-  const unset = new Command4("unset");
-  unset.description("Remove a configuration value").argument("<key>", "setting key (org, project, fields, markdown, credentialStore)").option("--org <org>", "remove from an org-scoped configuration").option("--json", "output in JSON format").action((key, options) => {
+  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) {
         unsetOrgScopedValue(options.org, key);
@@ -2885,7 +3193,7 @@ function createConfigCommand() {
       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(
@@ -2908,7 +3216,7 @@ function createConfigCommand() {
     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);
@@ -2921,7 +3229,7 @@ function createConfigCommand() {
       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);
@@ -2934,7 +3242,7 @@ function createConfigCommand() {
       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);
@@ -2959,9 +3267,9 @@ function createConfigCommand() {
 }
 
 // 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);
@@ -2997,9 +3305,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);
@@ -3049,9 +3357,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);
@@ -3087,9 +3395,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(
@@ -3123,8 +3431,8 @@ function createGetMdFieldCommand() {
 }
 
 // src/commands/set-md-field.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
-import { Command as Command9 } from "commander";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
+import { Command as Command10 } from "commander";
 function fail(message) {
   process.stderr.write(`Error: ${message}
 `);
@@ -3143,11 +3451,11 @@ function resolveContent(inlineContent, options) {
   return null;
 }
 function readFileContent(filePath) {
-  if (!existsSync3(filePath)) {
+  if (!existsSync4(filePath)) {
     fail(`File not found: ${filePath}`);
   }
   try {
-    return readFileSync3(filePath, "utf-8");
+    return readFileSync4(filePath, "utf-8");
   } catch {
     fail(`Cannot read file: ${filePath}`);
   }
@@ -3186,7 +3494,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);
@@ -3212,8 +3520,8 @@ function createSetMdFieldCommand() {
 }
 
 // src/commands/upsert.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4, unlinkSync } from "fs";
-import { Command as Command10 } from "commander";
+import { existsSync as existsSync5, readFileSync as readFileSync5, unlinkSync } from "fs";
+import { Command as Command11 } from "commander";
 
 // src/services/task-document.ts
 var FIELD_ALIASES = /* @__PURE__ */ new Map([
@@ -3376,12 +3684,12 @@ function loadSourceContent(options) {
     return { content: options.content };
   }
   const filePath = options.file;
-  if (!existsSync4(filePath)) {
+  if (!existsSync5(filePath)) {
     fail2(`File not found: ${filePath}`);
   }
   try {
     return {
-      content: readFileSync4(filePath, "utf-8"),
+      content: readFileSync5(filePath, "utf-8"),
       sourceFile: filePath
     };
   } catch {
@@ -3498,7 +3806,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);
@@ -3539,7 +3847,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;
@@ -3573,7 +3881,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);
@@ -3600,8 +3908,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) {
@@ -3670,7 +3977,12 @@ function mapPullRequest(context, repo, pullRequest) {
     url: pullRequest._links?.web?.href ?? buildPullRequestWebUrl(context, repo, pullRequest.pullRequestId),
     description: pullRequest.description?.trim() || null,
     createdByUniqueName: pullRequest.createdBy?.uniqueName ?? null,
-    createdById: pullRequest.createdBy?.id ?? null
+    createdById: pullRequest.createdBy?.id ?? null,
+    isDraft: pullRequest.isDraft ?? false,
+    creationDate: pullRequest.creationDate ?? null,
+    closedDate: pullRequest.closedDate ?? null,
+    reviewers: (pullRequest.reviewers ?? []).map(mapReviewer),
+    labels: (pullRequest.labels ?? []).filter((label) => label.active !== false).map((label) => label.name)
   };
 }
 function mapPullRequestCheckName(status2) {
@@ -3769,6 +4081,8 @@ function mapComment(comment) {
   return {
     id: comment.id,
     author: comment.author?.displayName ?? null,
+    authorUniqueName: comment.author?.uniqueName ?? null,
+    authorId: comment.author?.id ?? null,
     content,
     publishedAt: comment.publishedDate ?? null,
     commentType: comment.commentType ?? null
@@ -3850,6 +4164,15 @@ async function listRepositoryPullRequests(context, repo, cred, opts) {
   const data = await readJsonResponse(response);
   return data.value.map((pullRequest) => mapPullRequest(context, repo, pullRequest));
 }
+async function getPullRequestWorkItemIds(context, repo, cred, prId) {
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/git/repositories/${encodeURIComponent(repo)}/pullRequests/${prId}/workitems`
+  );
+  url.searchParams.set("api-version", "7.1");
+  const response = await fetchWithErrors(url.toString(), { headers: authHeaders(cred) });
+  const data = await readJsonResponse(response);
+  return data.value.map((ref) => Number.parseInt(ref.id, 10)).filter((id) => Number.isInteger(id) && id > 0).sort((a, b) => a - b);
+}
 async function getPullRequestChecks(context, repo, cred, prId) {
   const response = await fetchWithErrors(
     buildPullRequestStatusesUrl(context, repo, prId).toString(),
@@ -3921,43 +4244,26 @@ function formatContributions(composed) {
 function describeDescriptionBudget(composed) {
   return `description: ${composed.providedChars} provided + ${composed.separatorChars} separator + ${composed.templateChars} template = ${composed.totalChars} characters (client limit ${MAX_PR_DESCRIPTION_CHARS})`;
 }
-async function openPullRequest(context, repo, cred, sourceBranch, title, description) {
-  const existing = await listPullRequests(context, repo, cred, sourceBranch, {
-    status: "active",
-    targetBranch: "develop"
-  });
-  if (existing.length === 1) {
-    return {
-      branch: sourceBranch,
-      targetBranch: "develop",
-      created: false,
-      pullRequest: existing[0]
-    };
-  }
-  if (existing.length > 1) {
-    throw new Error(`AMBIGUOUS_PRS:${existing.map((pullRequest) => pullRequest.id).join(",")}`);
-  }
-  const repository = await getRepository(context, repo, cred);
-  const defaultBranch = repository.defaultBranch ? repository.defaultBranch.replace(/^refs\/heads\//, "") : "develop";
-  const template = await resolvePullRequestTemplate(context, repo, cred, defaultBranch, "develop");
-  const composed = composeDescription(description, template);
-  if (composed === null) {
-    throw new Error("DESCRIPTION_REQUIRED");
-  }
-  if (composed.totalChars > MAX_PR_DESCRIPTION_CHARS) {
-    throw new Error(`DESCRIPTION_TOO_LONG: ${formatDescriptionOverflow(composed)}`);
-  }
+function buildOpenPayload(sourceBranch, targetBranch, title, description, options) {
   const payload = {
     sourceRefName: `refs/heads/${sourceBranch}`,
-    targetRefName: "refs/heads/develop",
+    targetRefName: `refs/heads/${targetBranch}`,
     title,
-    description: composed.text
+    description
   };
+  if (options.isDraft) {
+    payload.isDraft = true;
+  }
+  if (options.labels && options.labels.length > 0) {
+    payload.labels = options.labels.map((name) => ({ name }));
+  }
+  return payload;
+}
+async function createPullRequest(context, repo, cred, payload, composed) {
   const url = new URL(
     `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/git/repositories/${encodeURIComponent(repo)}/pullrequests`
   );
   url.searchParams.set("api-version", "7.1");
-  let data;
   try {
     const response = await fetchWithErrors(url.toString(), {
       method: "POST",
@@ -3967,19 +4273,69 @@ async function openPullRequest(context, repo, cred, sourceBranch, title, descrip
       },
       body: JSON.stringify(payload)
     });
-    data = await readJsonResponse(response);
+    return await readJsonResponse(response);
   } catch (err) {
     if (err instanceof Error && err.message.startsWith("HTTP_400")) {
       throw new Error(`${err.message} | ${describeDescriptionBudget(composed)}`, { cause: err });
     }
     throw err;
   }
-  return {
+}
+function linkWorkItems(context, repo, cred, prId, workItemIds) {
+  return Promise.all(
+    workItemIds.map(
+      (id) => linkWorkItemToPullRequest(context, repo, cred, prId, id).then(
+        () => ({ id, linked: true }),
+        (err) => ({ id, linked: false, error: err instanceof Error ? err.message : String(err) })
+      )
+    )
+  );
+}
+async function openPullRequest(context, repo, cred, sourceBranch, title, description, options = {}) {
+  const targetBranch = options.targetBranch ?? "develop";
+  const existing = await listPullRequests(context, repo, cred, sourceBranch, {
+    status: "active",
+    targetBranch
+  });
+  if (existing.length === 1) {
+    return {
+      branch: sourceBranch,
+      targetBranch,
+      created: false,
+      pullRequest: existing[0]
+    };
+  }
+  if (existing.length > 1) {
+    throw new Error(`AMBIGUOUS_PRS:${existing.map((pullRequest2) => pullRequest2.id).join(",")}`);
+  }
+  const repository = await getRepository(context, repo, cred);
+  const defaultBranch = repository.defaultBranch ? repository.defaultBranch.replace(/^refs\/heads\//, "") : "develop";
+  const template = await resolvePullRequestTemplate(context, repo, cred, defaultBranch, targetBranch);
+  const composed = composeDescription(description, template);
+  if (composed === null) {
+    throw new Error("DESCRIPTION_REQUIRED");
+  }
+  if (composed.totalChars > MAX_PR_DESCRIPTION_CHARS) {
+    throw new Error(`DESCRIPTION_TOO_LONG: ${formatDescriptionOverflow(composed)}`);
+  }
+  const data = await createPullRequest(
+    context,
+    repo,
+    cred,
+    buildOpenPayload(sourceBranch, targetBranch, title, composed.text, options),
+    composed
+  );
+  const pullRequest = mapPullRequest(context, repo, data);
+  const result = {
     branch: sourceBranch,
-    targetBranch: "develop",
+    targetBranch,
     created: true,
-    pullRequest: mapPullRequest(context, repo, data)
+    pullRequest
   };
+  if (options.workItemIds && options.workItemIds.length > 0) {
+    result.workItems = await linkWorkItems(context, repo, cred, pullRequest.id, options.workItemIds);
+  }
+  return result;
 }
 async function updatePullRequest(context, repo, cred, prId, fields) {
   if (fields.description !== void 0 && fields.description.length > MAX_PR_DESCRIPTION_CHARS) {
@@ -4067,10 +4423,25 @@ async function updateThreadComment(context, repo, cred, prId, threadId, commentI
   return {
     id: data.id,
     author: data.author?.displayName ?? null,
+    authorUniqueName: data.author?.uniqueName ?? null,
+    authorId: data.author?.id ?? null,
     content: data.content ?? content,
     publishedAt: data.publishedDate ?? null
   };
 }
+async function deleteThreadComment(context, repo, cred, prId, threadId, commentId) {
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/git/repositories/${encodeURIComponent(repo)}/pullRequests/${prId}/threads/${threadId}/comments/${commentId}`
+  );
+  url.searchParams.set("api-version", "7.1");
+  const response = await fetchWithErrors(url.toString(), {
+    method: "DELETE",
+    headers: authHeaders(cred)
+  });
+  if (!response.ok) {
+    throw httpError(response);
+  }
+}
 async function postThreadComment(context, repo, cred, prId, threadId, content) {
   const response = await fetchWithErrors(buildThreadCommentUrl(context, repo, prId, threadId).toString(), {
     method: "POST",
@@ -4084,6 +4455,8 @@ async function postThreadComment(context, repo, cred, prId, threadId, content) {
   return {
     id: data.id,
     author: data.author?.displayName ?? null,
+    authorUniqueName: data.author?.uniqueName ?? null,
+    authorId: data.author?.id ?? null,
     content: data.content ?? content,
     publishedAt: data.publishedDate ?? null
   };
@@ -4200,13 +4573,34 @@ function buildPullRequestReviewerUrl(context, repo, prId, reviewerId) {
   url.searchParams.set("api-version", "7.1");
   return url;
 }
+function reviewerVoteState(vote) {
+  switch (vote) {
+    case 10:
+      return "approved";
+    case 5:
+      return "approved-with-suggestions";
+    case 0:
+      return "no-vote";
+    case -5:
+      return "waiting-for-author";
+    case -10:
+      return "rejected";
+    case 15:
+      return "bypassed";
+    default:
+      return "unknown";
+  }
+}
 function mapReviewer(data) {
+  const vote = data.vote ?? 0;
   return {
     id: data.id,
     displayName: data.displayName ?? null,
     uniqueName: data.uniqueName ?? null,
     isRequired: data.isRequired ?? false,
-    vote: data.vote ?? 0
+    vote,
+    voteState: reviewerVoteState(vote),
+    hasDeclined: data.hasDeclined ?? false
   };
 }
 async function getPullRequestReviewers(context, repo, cred, prId) {
@@ -4258,11 +4652,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");
@@ -4305,10 +4699,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;
@@ -4334,7 +4728,7 @@ function parsePositivePrNumber(raw) {
     return null;
   }
   const n = Number.parseInt(raw, 10);
-  return Number.isFinite(n) && n > 0 ? n : null;
+  return Number.isSafeInteger(n) && n > 0 ? n : null;
 }
 function prNumberHelp(branchStatus = "active") {
   const matched = branchStatus === "abandoned" ? "abandoned" : "open";
@@ -4372,24 +4766,11 @@ function writeContractError(line) {
   process.exitCode = 1;
 }
 var EMPTY_BODY_ERROR = "Comment text must not be empty. Pass the text inline or use --file <path>.";
-var STDIN_PATH = "-";
-function readTextSource(file) {
-  if (file === STDIN_PATH) {
-    try {
-      return readFileSync5(0, "utf-8");
-    } catch {
-      writeError("Cannot read standard input.");
-      return null;
-    }
-  }
-  if (!existsSync5(file)) {
-    writeError(`File not found: ${file}`);
-    return null;
-  }
+function readTextSource2(file) {
   try {
-    return readFileSync5(file, "utf-8");
-  } catch {
-    writeError(`Cannot read file: ${file}`);
+    return readTextSource(file);
+  } catch (err) {
+    writeError(err.message);
     return null;
   }
 }
@@ -4400,7 +4781,7 @@ function resolveCommentBody(inline, file, emptyMessage = EMPTY_BODY_ERROR) {
   }
   let body;
   if (file !== void 0) {
-    const read = readTextSource(file);
+    const read = readTextSource2(file);
     if (read === null) {
       return null;
     }
@@ -4430,7 +4811,7 @@ function resolveOptionalTextInput(inline, file, flag) {
   const emptyMessage = `${label} must not be empty. Pass the text inline or use --${flag}-file <path>.`;
   let value;
   if (file !== void 0) {
-    const read = readTextSource(file);
+    const read = readTextSource2(file);
     if (read === null) {
       return null;
     }
@@ -4644,24 +5025,67 @@ async function resolvePrCommandContext(options, resolveOpts = {}) {
     pat: credential
   };
 }
-function createPrStatusCommand() {
-  const command = new Command12("status");
-  withCommonPrOptions(command).description("Check pull requests for the current branch").option("--json", "output JSON").action(async (options) => {
-    validateOrgProjectPair(options);
-    let context;
-    try {
-      const resolved = await resolvePrCommandContext(options);
-      context = resolved.context;
-      const branch = resolved.branch;
-      const pullRequests = await listPullRequests(resolved.context, resolved.repo, resolved.pat, branch);
-      let projectId = null;
-      try {
-        projectId = await resolveProjectId(resolved.context, resolved.pat);
-      } catch {
-        projectId = null;
-      }
-      const pullRequestsWithChecks = await Promise.all(
-        pullRequests.map(
+var STATUS_PR_NUMBER_HELP = "show only the pull request with this numeric id, instead of the current branch's pull requests; mutually exclusive with --branch";
+var STATUS_BRANCH_HELP = "show the pull requests whose source branch is this one (with or without the refs/heads/ prefix), instead of the current branch's; no checkout needed. Mutually exclusive with --pr-number";
+function parseStatusTarget(options) {
+  if (options.prNumber !== void 0 && options.branch !== void 0) {
+    writeError("Cannot specify both --pr-number and --branch.");
+    return null;
+  }
+  if (options.branch !== void 0) {
+    const branch = options.branch.trim().replace(/^refs\/heads\//, "");
+    if (branch === "") {
+      writeError("--branch must not be empty.");
+      return null;
+    }
+    return { kind: "branch", branch };
+  }
+  const prId = parseTargetPrNumber(options);
+  if (prId === "invalid") {
+    return null;
+  }
+  return prId === "none" ? { kind: "current" } : { kind: "pr", prId };
+}
+async function findStatusPullRequests(resolved, target) {
+  if (target.kind === "pr") {
+    const pullRequest = await fetchTargetById(resolved, target.prId);
+    return pullRequest === null ? null : { branch: formatBranchName(pullRequest.sourceRefName), pullRequests: [pullRequest] };
+  }
+  const branch = target.kind === "branch" ? target.branch : resolved.branch;
+  const pullRequests = await listPullRequests(resolved.context, resolved.repo, resolved.pat, branch);
+  if (target.kind === "branch" && pullRequests.length === 0) {
+    writeError(
+      `No pull requests found for branch ${branch} in ${resolved.context.org}/${resolved.context.project}/${resolved.repo}.`
+    );
+    return null;
+  }
+  return { branch, pullRequests };
+}
+function createPrStatusCommand() {
+  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);
+    if (target === null) {
+      return;
+    }
+    let context;
+    try {
+      const resolved = await resolvePrCommandContext(options, { requireBranch: target.kind === "current" });
+      context = resolved.context;
+      const found = await findStatusPullRequests(resolved, target);
+      if (found === null) {
+        return;
+      }
+      const { branch, pullRequests } = found;
+      let projectId = null;
+      try {
+        projectId = await resolveProjectId(resolved.context, resolved.pat);
+      } catch {
+        projectId = null;
+      }
+      const pullRequestsWithChecks = await Promise.all(
+        pullRequests.map(
           async (pullRequest) => buildPullRequestStatusEntry(resolved.context, resolved.repo, resolved.pat, pullRequest, projectId)
         )
       );
@@ -4684,11 +5108,11 @@ function createPrStatusCommand() {
   });
   return command;
 }
-function handlePrOpenError(err, context) {
+function handlePrOpenError(err, context, targetBranch = "develop") {
   const message = err instanceof Error ? err.message : "";
   if (message.startsWith("AMBIGUOUS_PRS:")) {
     const ids = message.replace("AMBIGUOUS_PRS:", "").split(",").map((id) => `#${id}`).join(", ");
-    writeError(`Multiple active pull requests already exist for this branch targeting develop: ${ids}. Use pr status to review them.`);
+    writeError(`Multiple active pull requests already exist for this branch targeting ${targetBranch}: ${ids}. Use pr status to review them.`);
     return;
   }
   if (message === "DESCRIPTION_REQUIRED") {
@@ -4701,13 +5125,54 @@ function handlePrOpenError(err, context) {
   }
   handlePrCommandError(err, context, "write");
 }
+function collectOption(value, previous) {
+  return [...previous, value];
+}
+function stripHeadsPrefix(branch) {
+  return branch.trim().replace(/^refs\/heads\//, "");
+}
+function resolveOpenOptions(options) {
+  const targetBranch = options.target === void 0 ? "develop" : stripHeadsPrefix(options.target);
+  const source = options.source === void 0 ? void 0 : stripHeadsPrefix(options.source);
+  if (!targetBranch) {
+    writeError("--target must not be empty.");
+    return null;
+  }
+  if (source !== void 0 && !source) {
+    writeError("--source must not be empty.");
+    return null;
+  }
+  const workItemIds = [];
+  for (const raw of options.workItem ?? []) {
+    const id = Number(raw.trim());
+    if (!/^\d+$/.test(raw.trim()) || !Number.isSafeInteger(id) || id <= 0) {
+      writeError(`--work-item must be a positive integer, got "${raw}".`);
+      return null;
+    }
+    if (!workItemIds.includes(id)) {
+      workItemIds.push(id);
+    }
+  }
+  const labels = [];
+  for (const raw of options.label ?? []) {
+    const name = raw.trim();
+    if (!name) {
+      writeError("--label must not be empty.");
+      return null;
+    }
+    if (!labels.includes(name)) {
+      labels.push(name);
+    }
+  }
+  return { targetBranch, source, isDraft: options.draft === true, labels, workItemIds };
+}
 function resolveOpenDescription(inline, file) {
   if (inline !== void 0 && file !== void 0) {
     writeError("Cannot specify both --description and --description-file.");
     return null;
   }
   if (file !== void 0) {
-    const fromFile = readTextSource(file);
+    const fromFile = readTextSource2(file);
     if (fromFile === null) {
       return null;
     }
@@ -4725,14 +5190,19 @@ function resolveOpenDescription(inline, file) {
   return trimmedInline;
 }
 function createPrOpenCommand() {
-  const command = new Command12("open");
-  withCommonPrOptions(command).description("Open a pull request from the current branch to develop").option("--title <title>", "pull request title").option(
+  const command = new Command13("open");
+  withCommonPrOptions(command).description("Open a pull request (default: 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)"
   ).option(
     "--description-file <path>",
     'read the description from a UTF-8 file instead of --description; "-" reads standard input'
-  ).option("--json", "output JSON").action(async (options) => {
+  ).option("--target <branch>", "target branch (default: develop); refs/heads/ prefix accepted").option("--source <branch>", "source branch (default: the current branch); no local checkout needed").option("--draft", "open the pull request as a draft").option(
+    "--work-item <id>",
+    "link a work item to the pull request (positive integer; repeatable)",
+    collectOption,
+    []
+  ).option("--label <label>", "add a label to the pull request (repeatable)", collectOption, []).option("--json", "output JSON; adds top-level id and url next to pullRequest").action(async (options) => {
     validateOrgProjectPair(options);
     const title = options.title?.trim();
     if (!title) {
@@ -4743,45 +5213,71 @@ function createPrOpenCommand() {
     if (description === null) {
       return;
     }
+    const openOptions = resolveOpenOptions(options);
+    if (openOptions === null) {
+      return;
+    }
     let context;
     try {
-      const resolved = await resolvePrCommandContext(options);
-      context = resolved.context;
-      if (resolved.branch === "develop") {
-        writeError("Pull request creation requires a source branch other than develop.");
+      const openBranch = openOptions.source ?? getCurrentBranch();
+      const target = openOptions.targetBranch;
+      if (openBranch === target) {
+        writeError(
+          target === "develop" ? "Pull request creation requires a source branch other than develop." : `Pull request creation requires a source branch other than the target branch (${target}).`
+        );
         return;
       }
-      const openBranch = resolved.branch;
+      const resolved = await resolvePrCommandContext(options, { requireBranch: false });
+      context = resolved.context;
       const result = await openPullRequest(
         resolved.context,
         resolved.repo,
         resolved.pat,
         openBranch,
         title,
-        description
+        description,
+        openOptions
       );
       if (options.json) {
-        process.stdout.write(`${JSON.stringify(result, null, 2)}
+        const output = { ...result, id: result.pullRequest.id, url: result.pullRequest.url };
+        process.stdout.write(`${JSON.stringify(output, null, 2)}
 `);
+        reportWorkItemLinkFailures(result);
         return;
       }
       if (result.created) {
         process.stdout.write(`Created pull request #${result.pullRequest.id}: ${result.pullRequest.title}
 ${result.pullRequest.url ?? "\u2014"}
 `);
+        reportWorkItemLinkFailures(result);
         return;
       }
       process.stdout.write(
-        `Active pull request already exists for ${resolved.branch} -> develop: #${result.pullRequest.id}
+        `Active pull request already exists for ${openBranch} -> ${result.targetBranch}: #${result.pullRequest.id}
 ${result.pullRequest.url ?? "\u2014"}
 `
       );
+      if (openOptions.isDraft || openOptions.labels?.length || openOptions.workItemIds?.length) {
+        const hint = openOptions.workItemIds?.length ? " Use pr work-items link to link a work item." : "";
+        process.stdout.write(
+          `--draft, --label and --work-item were not applied; the existing pull request was left unchanged.${hint}
+`
+        );
+      }
     } catch (err) {
-      handlePrOpenError(err, context);
+      handlePrOpenError(err, context, openOptions.targetBranch);
     }
   });
   return command;
 }
+function reportWorkItemLinkFailures(result) {
+  const failed = (result.workItems ?? []).filter((item) => !item.linked);
+  if (failed.length === 0) return;
+  const detail = failed.map((item) => `#${item.id} (${item.error ?? "unknown error"})`).join(", ");
+  writeError(
+    `Pull request #${result.pullRequest.id} was created but could not be linked to work item ${detail}. Retry with: azdo pr work-items link <id> --pr-number ${result.pullRequest.id}`
+  );
+}
 function handlePrUpdateError(err, context) {
   const message = err instanceof Error ? err.message : "";
   if (message.startsWith("DESCRIPTION_TOO_LONG: ")) {
@@ -4893,7 +5389,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"'
@@ -4981,7 +5477,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) => {
@@ -4990,7 +5486,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) => {
@@ -5096,7 +5592,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);
@@ -5152,6 +5648,7 @@ function createPrCommentsCommand() {
   command.addCommand(createPrCommentsReplyCommand());
   command.addCommand(createPrCommentsAddCommand());
   command.addCommand(createPrCommentsEditCommand());
+  command.addCommand(createPrCommentsDeleteCommand());
   return command;
 }
 function parseTargetPrNumber(options) {
@@ -5291,14 +5788,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");
   });
@@ -5350,7 +5847,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));
   });
@@ -5452,7 +5949,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`
@@ -5470,7 +5967,26 @@ function createPrCommentAddCommand() {
     'Post a new comment thread on the pull request overview (alias of "azdo pr comments add")'
   );
 }
-async function fetchThreadForEdit(target) {
+function parseExplicitCommentId(options) {
+  if (options.commentId === void 0) {
+    return null;
+  }
+  const parsed = parsePositivePrNumber(options.commentId);
+  if (parsed === null) {
+    writeError(`Invalid --comment-id "${options.commentId}"; expected a positive integer.`);
+    return "invalid";
+  }
+  return parsed;
+}
+function findCommentInThread(thread, commentId, target) {
+  const match = thread.comments.find((comment) => comment.id === commentId);
+  if (match === void 0) {
+    writeError(`Comment #${commentId} not found in thread #${target.threadId} on pull request #${target.pullRequest.id}.`, EXIT_NOT_FOUND);
+    return null;
+  }
+  return match;
+}
+async function fetchTargetThread(target) {
   try {
     return await getPullRequestThread(
       target.context,
@@ -5489,12 +6005,7 @@ async function fetchThreadForEdit(target) {
 }
 function selectEditableComment(thread, explicitCommentId, target) {
   if (explicitCommentId !== null) {
-    const match = thread.comments.find((comment) => comment.id === explicitCommentId);
-    if (match === void 0) {
-      writeError(`Comment #${explicitCommentId} not found in thread #${target.threadId} on pull request #${target.pullRequest.id}.`, EXIT_NOT_FOUND);
-      return null;
-    }
-    return match;
+    return findCommentInThread(thread, explicitCommentId, target);
   }
   const first = [...thread.comments].sort((a, b) => a.id - b.id)[0];
   if (first === void 0) {
@@ -5529,13 +6040,9 @@ async function runCommentEdit(threadIdRaw, text, options) {
     if (body === null) {
       return;
     }
-    let explicitCommentId = null;
-    if (options.commentId !== void 0) {
-      explicitCommentId = parsePositivePrNumber(options.commentId);
-      if (explicitCommentId === null) {
-        writeError(`Invalid --comment-id "${options.commentId}"; expected a positive integer.`);
-        return;
-      }
+    const explicitCommentId = parseExplicitCommentId(options);
+    if (explicitCommentId === "invalid") {
+      return;
     }
     const target = await resolveThreadTarget(threadIdRaw, options, {
       onContextResolved: (resolved) => {
@@ -5545,7 +6052,7 @@ async function runCommentEdit(threadIdRaw, text, options) {
     if (target === null) {
       return;
     }
-    const thread = await fetchThreadForEdit(target);
+    const thread = await fetchTargetThread(target);
     if (thread === null) {
       return;
     }
@@ -5592,7 +6099,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));
   });
@@ -5607,44 +6114,176 @@ function createPrCommentEditCommand() {
     'Edit an existing pull request comment in place (alias of "azdo pr comments edit")'
   );
 }
+function selectDeletableComment(thread, explicitCommentId, target) {
+  if (explicitCommentId !== null) {
+    return findCommentInThread(thread, explicitCommentId, target);
+  }
+  const comments = [...thread.comments].sort((a, b) => a.id - b.id);
+  if (comments.length === 1) {
+    return comments[0];
+  }
+  if (comments.length === 0) {
+    writeError(`Thread #${target.threadId} on pull request #${target.pullRequest.id} has no comment to delete.`, EXIT_NOT_FOUND);
+    return null;
+  }
+  const candidates = comments.map((comment) => `#${comment.id} (${comment.author ?? "Unknown"})`).join(", ");
+  writeError(
+    `Thread #${target.threadId} on pull request #${target.pullRequest.id} holds ${comments.length} comments; pass --comment-id to choose one: ${candidates}.`
+  );
+  return null;
+}
+function reportDeleteResult(result, json, comment) {
+  if (json) {
+    process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+    return;
+  }
+  if (result.dryRun) {
+    process.stdout.write(
+      `Dry run: would delete comment #${result.commentId} by ${comment.author ?? "Unknown"} (${comment.content.length} chars) from thread #${result.threadId} on pull request #${result.pullRequestId}.
+`
+    );
+    return;
+  }
+  process.stdout.write(
+    `Comment #${result.commentId} deleted from thread #${result.threadId} on pull request #${result.pullRequestId}.
+`
+  );
+}
+async function runCommentDelete(threadIdRaw, options) {
+  let context;
+  try {
+    const explicitCommentId = parseExplicitCommentId(options);
+    if (explicitCommentId === "invalid") {
+      return;
+    }
+    const target = await resolveThreadTarget(threadIdRaw, options, {
+      onContextResolved: (resolved) => {
+        context = resolved;
+      }
+    });
+    if (target === null) {
+      return;
+    }
+    const thread = await fetchTargetThread(target);
+    if (thread === null) {
+      return;
+    }
+    const comment = selectDeletableComment(thread, explicitCommentId, target);
+    if (comment === null) {
+      return;
+    }
+    const dryRun = options.dryRun === true;
+    if (!dryRun) {
+      await deleteThreadComment(
+        target.context,
+        target.repo,
+        target.pat,
+        target.pullRequest.id,
+        target.threadId,
+        comment.id
+      );
+    }
+    reportDeleteResult(
+      {
+        pullRequestId: target.pullRequest.id,
+        threadId: target.threadId,
+        commentId: comment.id,
+        deleted: !dryRun,
+        dryRun
+      },
+      options.json === true,
+      comment
+    );
+  } catch (err) {
+    handlePrCommandError(err, context, "write");
+  }
+}
+function buildCommentDeleteCommand(name, description) {
+  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));
+  });
+  return command;
+}
+function createPrCommentsDeleteCommand() {
+  return buildCommentDeleteCommand("delete", "Delete a pull request comment (no confirmation prompt; irreversible)");
+}
+function createPrCommentDeleteCommand() {
+  return buildCommentDeleteCommand(
+    "comment-delete",
+    'Delete a pull request comment (alias of "azdo pr comments delete"; no confirmation prompt; irreversible)'
+  );
+}
 var LIST_STATUS_VALUES = ["active", "completed", "abandoned", "all"];
 var DEFAULT_LIST_TOP = 25;
+var WORK_ITEM_LOOKUP_CONCURRENCY = 5;
 function formatPullRequestListEntry(pullRequest) {
-  return [
-    `#${pullRequest.id} [${pullRequest.status}] ${pullRequest.title}`,
+  const state = pullRequest.isDraft ? `${pullRequest.status}, draft` : pullRequest.status;
+  const lines = [
+    `#${pullRequest.id} [${state}] ${pullRequest.title}`,
     `  ${formatBranchName(pullRequest.sourceRefName)} -> ${formatBranchName(pullRequest.targetRefName)}`,
-    `  Author: ${pullRequest.createdBy ?? "Unknown"}`,
-    `  ${pullRequest.url ?? "\u2014"}`
-  ].join("\n");
+    `  Author: ${pullRequest.createdBy ?? "Unknown"}`
+  ];
+  if ("workItemIds" in pullRequest) {
+    const ids = pullRequest.workItemIds.map((id) => `#${id}`).join(", ");
+    lines.push(`  Work items: ${ids || "none"}`);
+  }
+  lines.push(`  ${pullRequest.url ?? "\u2014"}`);
+  return lines.join("\n");
+}
+function parseListOptions(options) {
+  const status2 = options.status ?? "active";
+  if (!LIST_STATUS_VALUES.includes(status2)) {
+    writeError(`Invalid --status "${status2}"; expected one of ${LIST_STATUS_VALUES.join(", ")}.`);
+    return null;
+  }
+  let top = DEFAULT_LIST_TOP;
+  if (options.top !== void 0) {
+    const parsed = parsePositivePrNumber(options.top);
+    if (parsed === null) {
+      writeError(`Invalid --top "${options.top}"; expected a positive integer.`);
+      return null;
+    }
+    top = parsed;
+  }
+  const branch = options.branch?.trim().replace(/^refs\/heads\//, "") || null;
+  return { status: status2, top, branch };
+}
+async function attachWorkItemIds(context, repo, cred, pullRequests) {
+  const result = new Array(pullRequests.length);
+  let next = 0;
+  const worker = async () => {
+    while (next < pullRequests.length) {
+      const index = next;
+      next += 1;
+      const pullRequest = pullRequests[index];
+      const workItemIds = await getPullRequestWorkItemIds(context, repo, cred, pullRequest.id);
+      result[index] = { ...pullRequest, workItemIds };
+    }
+  };
+  await Promise.all(Array.from({ length: Math.min(WORK_ITEM_LOOKUP_CONCURRENCY, pullRequests.length) }, worker));
+  return result;
 }
 function createPrListCommand() {
-  const command = new Command12("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("--json", "output JSON").action(async (options) => {
+  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 status2 = options.status ?? "active";
-    if (!LIST_STATUS_VALUES.includes(status2)) {
-      writeError(`Invalid --status "${status2}"; expected one of ${LIST_STATUS_VALUES.join(", ")}.`);
+    const parsed = parseListOptions(options);
+    if (parsed === null) {
       return;
     }
-    let top = DEFAULT_LIST_TOP;
-    if (options.top !== void 0) {
-      const parsed = parsePositivePrNumber(options.top);
-      if (parsed === null) {
-        writeError(`Invalid --top "${options.top}"; expected a positive integer.`);
-        return;
-      }
-      top = parsed;
-    }
-    const branch = options.branch?.trim().replace(/^refs\/heads\//, "") || null;
+    const { status: status2, top, branch } = parsed;
     let context;
     try {
       const resolved = await resolvePrCommandContext(options, { requireBranch: false });
       context = resolved.context;
-      const pullRequests = await listRepositoryPullRequests(resolved.context, resolved.repo, resolved.pat, {
+      const listed = await listRepositoryPullRequests(resolved.context, resolved.repo, resolved.pat, {
         sourceBranch: branch ?? void 0,
         status: status2,
         top
       });
+      const pullRequests = options.workItems ? await attachWorkItemIds(resolved.context, resolved.repo, resolved.pat, listed) : listed;
       const result = {
         repository: resolved.repo,
         branch,
@@ -5725,14 +6364,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"));
@@ -5840,15 +6479,56 @@ async function runReviewerRemove(reviewer, options) {
     handlePrCommandError(err, context, "write");
   }
 }
+function formatReviewerLine(reviewer) {
+  const name = reviewer.displayName ?? reviewer.uniqueName ?? reviewer.id;
+  const unique = reviewer.uniqueName && reviewer.uniqueName !== name ? ` <${reviewer.uniqueName}>` : "";
+  const kind = reviewer.isRequired ? "required" : "optional";
+  const declined = reviewer.hasDeclined ? ", declined" : "";
+  return `${name}${unique} \u2014 ${reviewer.voteState} (${kind}${declined})`;
+}
+async function runReviewerList(options) {
+  let context;
+  try {
+    const target = await resolvePullRequestTarget(options, {
+      onContextResolved: (resolved) => {
+        context = resolved;
+      }
+    });
+    if (target === null) {
+      return;
+    }
+    const reviewers = await getPullRequestReviewers(target.context, target.repo, target.pat, target.pullRequest.id);
+    const result = { pullRequestId: target.pullRequest.id, reviewers };
+    if (options.json) {
+      process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+      return;
+    }
+    if (reviewers.length === 0) {
+      process.stdout.write(`No reviewers on pull request #${target.pullRequest.id}.
+`);
+      return;
+    }
+    process.stdout.write(`${reviewers.map(formatReviewerLine).join("\n")}
+`);
+  } catch (err) {
+    handlePrCommandError(err, context, "read");
+  }
+}
 function createPrReviewersCommand() {
-  const command = new Command12("reviewers");
+  const command = new Command13("reviewers");
   command.description("Manage pull request reviewers");
-  const add = new Command12("add");
+  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 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));
   });
@@ -5856,7 +6536,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());
@@ -5872,11 +6552,13 @@ function createPrCommand() {
   command.addCommand(createPrWorkItemsCommand());
   command.addCommand(createPrReviewersCommand());
   command.addCommand(createPrCommentEditCommand());
+  command.addCommand(createPrCommentDeleteCommand());
   return command;
 }
 
 // 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";
@@ -6000,6 +6682,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`)
@@ -6011,14 +6696,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 = {
@@ -6038,7 +6729,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`));
@@ -6147,16 +6838,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) {
@@ -6169,6 +6862,122 @@ 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
+    };
+  });
+}
+var INITIAL_BUFFER_BYTES = 8 * 1024 * 1024;
+async function collectBody(body, declared, onProgress, initialBytes = INITIAL_BUFFER_BYTES) {
+  const hint = Number.isSafeInteger(declared) && declared > 0 ? declared : Infinity;
+  let buffer = new Uint8Array(Math.min(hint, initialBytes));
+  let received = 0;
+  for await (const chunk of body) {
+    const needed = received + chunk.length;
+    if (needed > buffer.length) {
+      let capacity = Math.max(buffer.length * 2, needed);
+      if (hint >= needed) capacity = Math.min(capacity, hint);
+      const grown = new Uint8Array(capacity);
+      grown.set(buffer.subarray(0, received));
+      buffer = grown;
+    }
+    buffer.set(chunk, received);
+    received = needed;
+    onProgress?.(received);
+  }
+  return buffer.subarray(0, received);
+}
+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 declared = Number.parseInt(response.headers.get("content-length") ?? "", 10);
+  return collectBody(response.body, declared, onProgress);
+}
+
+// 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;
@@ -6251,7 +7060,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;
@@ -6323,7 +7132,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);
@@ -6378,7 +7187,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);
@@ -6505,19 +7314,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)}
@@ -6526,10 +7342,8 @@ function createPipelineGetRunDetailCommand() {
       }
       process.stdout.write(`${formatRunDetail(detail)}
 `);
-    } catch (err) {
-      handlePipelineError(err, context);
-    }
-  });
+    })
+  );
   return command;
 }
 function grepWithContext(lines, grep, context) {
@@ -6552,17 +7366,37 @@ function grepWithContext(lines, grep, context) {
   }
   return selected;
 }
-function filterLogLines(content, grep, tail, context) {
+var PROGRESS_BAR = /(?<![\d.])\d+(?:\.\d+)? [KMGT]?i?B \/ \d+(?:\.\d+)? [KMGT]?i?B \[/g;
+var LOG_TIMESTAMP = /^\d{4}-\d{2}-\d{2}T[\d:.]+Z /;
+function collapseGluedBars(line) {
+  const starts = [...line.matchAll(PROGRESS_BAR)].map((m) => m.index ?? 0);
+  if (starts.length < 2) return line;
+  const prefix = LOG_TIMESTAMP.exec(line)?.[0] ?? "";
+  return prefix + line.slice(starts.at(-1));
+}
+function collapseProgress(line) {
+  let end = line.length;
+  while (end > 0 && line[end - 1] === "\r") end--;
+  return collapseGluedBars(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) {
@@ -6571,9 +7405,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) {
@@ -6582,6 +7421,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;
@@ -6593,7 +7434,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();
@@ -6605,7 +7452,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;
   }
@@ -6627,8 +7474,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")}
 `);
@@ -6639,8 +7486,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 progress-bar redraws (carriage-return or glued into one line) to their final state").option("--json", "output JSON").action(async (runIdRaw, options) => {
     validateOrgProjectPair(options);
     const runId = parsePositiveId(runIdRaw);
     if (runId === null) {
@@ -6679,7 +7526,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]))}
 `);
@@ -6689,8 +7538,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);
@@ -6747,7 +7692,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);
@@ -6783,20 +7728,42 @@ ${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";
+async function runCommentWrite(options, target, request, humanLine) {
+  let context;
+  try {
+    context = resolveContext(options);
+    const credential = await requireAuthCredential(context.org);
+    const result = await request(context, credential);
+    process.stdout.write(options.json ? `${JSON.stringify(result, null, 2)}
+` : `${humanLine(result)}
+`);
+  } catch (err) {
+    if (target.commentId === void 0) {
+      handleCommandError(err, target.id, context, "write");
+    } else {
+      handleCommentWriteError(err, target.id, target.commentId, context);
+    }
+  }
+}
+function commentFormat(options) {
+  return options.markdown === true ? "markdown" : "html";
+}
 function writeError3(message) {
   process.stderr.write(`Error: ${message}
 `);
@@ -6816,7 +7783,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);
@@ -6844,47 +7811,101 @@ 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);
     if (text.trim() === "") {
       writeError3("Comment text must be a non-empty string.");
     }
-    let context;
+    await runCommentWrite(
+      options,
+      { id },
+      (context, credential) => addWorkItemComment(context, id, credential, text, commentFormat(options)),
+      (result) => `Added comment #${result.commentId} to work item #${result.workItemId}`
+    );
+  });
+  return command;
+}
+function parseCommentId(value) {
+  if (!/^\d+$/.test(value) || Number(value) < 1) {
+    writeError3(`Invalid comment ID "${value}". Expected a positive integer.`);
+  }
+  return Number(value);
+}
+function resolveEditText(inline, file) {
+  if (inline !== void 0 && file !== void 0) {
+    writeError3("Cannot specify both inline text and --file.");
+  }
+  let body = inline;
+  if (file !== void 0) {
     try {
-      context = resolveContext(options);
-      const credential = await requireAuthCredential(context.org);
-      const format = options.markdown === true ? "markdown" : "html";
-      const result = await addWorkItemComment(context, id, credential, text, format);
-      if (options.json) {
-        process.stdout.write(`${JSON.stringify(result, null, 2)}
-`);
-        return;
-      }
-      process.stdout.write(`Added comment #${result.commentId} to work item #${result.workItemId}
-`);
+      body = readTextSource(file);
     } catch (err) {
-      handleCommandError(err, id, context, "write");
+      writeError3(err.message);
     }
+  }
+  if (body === void 0 || body.trim() === "") {
+    writeError3("Comment text must be a non-empty string. Pass the text inline or use --file <path>.");
+  }
+  return body;
+}
+function handleCommentWriteError(err, id, commentId, context) {
+  if (err instanceof Error && err.message.startsWith("NOT_FOUND")) {
+    writeError3(
+      `Comment ${commentId} not found on work item ${id} in ${context?.org}/${context?.project}.`
+    );
+  }
+  handleCommandError(err, id, context, "write");
+}
+function createCommentsEditCommand() {
+  const command = new Command15("edit");
+  command.description("Edit an existing comment on a work item").argument("<id>", "work item ID").argument("<commentId>", "comment ID").argument("[text]", "new comment text (or use --file)").option("--file <path>", 'read the new comment text from a file ("-" for stdin)').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, commentIdStr, text, options) => {
+    validateOrgProjectPair(options);
+    const id = parseWorkItemId(idStr);
+    const commentId = parseCommentId(commentIdStr);
+    const body = resolveEditText(text, options.file);
+    await runCommentWrite(
+      options,
+      { id, commentId },
+      (context, credential) => updateWorkItemComment(context, id, commentId, credential, body, commentFormat(options)),
+      (result) => `Updated comment #${result.commentId} on work item #${result.workItemId}`
+    );
+  });
+  return command;
+}
+function createCommentsDeleteCommand() {
+  const command = new Command15("delete");
+  command.description("Delete a comment from a work item (no confirmation prompt)").argument("<id>", "work item ID").argument("<commentId>", "comment ID").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(async (idStr, commentIdStr, options) => {
+    validateOrgProjectPair(options);
+    const id = parseWorkItemId(idStr);
+    const commentId = parseCommentId(commentIdStr);
+    await runCommentWrite(
+      options,
+      { id, commentId },
+      (context, credential) => deleteWorkItemComment(context, id, commentId, credential),
+      (result) => `Deleted comment #${result.commentId} from work item #${result.workItemId}`
+    );
   });
   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());
+  command.addCommand(createCommentsEditCommand());
+  command.addCommand(createCommentsDeleteCommand());
   return command;
 }
 
 // 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);
@@ -6894,7 +7915,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);
@@ -6926,17 +7947,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);
@@ -6978,12 +7999,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);
@@ -7060,7 +8081,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";
@@ -7277,7 +8298,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) => {
@@ -7356,7 +8377,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;
@@ -7374,7 +8395,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 {
@@ -7386,7 +8407,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 {
   }
@@ -7472,11 +8493,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());