azdo-cli 0.18.0-develop.649 → 0.18.0-develop.675

package/README.md

@@ -12,6 +12,7 @@ Azure DevOps CLI focused on work item read/write workflows.
 - Update work item state, assignee, or any field (`set-state`, `assign`, `set-field`)
 - Create or update work items from markdown documents (`upsert`)
 - Read and post work item comments (`comments`)
+- Attach a local file to a work item, or remove a named attachment (`add-attachment`, `delete-attachment`)
 - Read/write rich-text fields as markdown (`get-md-field`, `set-md-field`)
 - Download images embedded in rich-text fields, optionally resized for LLM use (`get-item`/`get-md-field` `--download-images`, `--resize-images`)
 - Check branch pull request status, open PRs to `develop` (optionally pre-filled from a repository-defined template), list PR comment threads for any PR (`--pr-number`), resolve/reopen threads, link/unlink work items, and add/remove required or optional reviewers — all from the CLI (`pr`)
@@ -54,6 +55,12 @@ azdo upsert --type "User Story" --content $'---\nTitle: Improve markdown import
 azdo comments list 12345
 azdo comments add 12345 "Investigating the root cause now."
 
+# Attach a local file to a work item, or remove one
+azdo add-attachment 12345 ./screenshot.png --comment "Repro captured on staging"
+azdo delete-attachment 12345 screenshot.png              # prompts for confirmation
+azdo delete-attachment 12345 screenshot.png --yes         # skip the prompt (scripting)
+azdo delete-attachment 12345 screenshot.png --id <guid>   # disambiguate when the name is shared
+
 # Find a pull request — one API call, any branch
 azdo pr list                            # active PRs in the repository
 azdo pr list --branch feature/x --json  # id, title, source/target, author, url, description

package/dist/index.js

@@ -38,7 +38,7 @@ import {
 } from "./chunk-TY5KENBQ.js";
 
 // src/index.ts
-import { Command as Command17 } from "commander";
+import { Command as Command19 } from "commander";
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -123,6 +123,176 @@ function getActiveTraceWriter() {
   return activeWriter;
 }
 
+// src/services/image-download.ts
+import { Jimp } from "jimp";
+import { writeFile } from "fs/promises";
+import { existsSync } 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})/;
+function extractAttachmentGuid(url) {
+  const match = ATTACHMENT_GUID_RE.exec(url);
+  return match ? match[1].toLowerCase() : null;
+}
+function isAzureDevOpsAttachmentHost(hostname) {
+  const host = hostname.toLowerCase();
+  return host === "dev.azure.com" || host.endsWith(".dev.azure.com") || host.endsWith(".visualstudio.com");
+}
+function decodeHtmlEntities(value) {
+  return value.replaceAll("&quot;", '"').replaceAll("&#39;", "'").replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&amp;", "&");
+}
+function parseAttachmentReference(rawUrl, sourceField) {
+  const url = decodeHtmlEntities(rawUrl.trim());
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return null;
+  }
+  if (parsed.protocol !== "https:" || !isAzureDevOpsAttachmentHost(parsed.hostname)) {
+    return null;
+  }
+  const guid = extractAttachmentGuid(parsed.pathname);
+  if (!guid) return null;
+  let suggestedExtension = ".png";
+  const fileName = parsed.searchParams.get("fileName");
+  if (fileName?.includes(".")) {
+    suggestedExtension = fileName.slice(fileName.lastIndexOf(".")).toLowerCase();
+  }
+  return { url, sourceField, guid, suggestedExtension };
+}
+function extractImageReferences(content, sourceField) {
+  if (!content) return [];
+  const references = [];
+  const seen = /* @__PURE__ */ new Set();
+  const add = (rawUrl) => {
+    const reference = parseAttachmentReference(rawUrl, sourceField);
+    if (reference && !seen.has(reference.guid)) {
+      seen.add(reference.guid);
+      references.push(reference);
+    }
+  };
+  const imgRegex = /<img\b[^>]*?\ssrc\s*=\s*["']([^"']+)["']/gi;
+  let match;
+  while ((match = imgRegex.exec(content)) !== null) {
+    add(match[1]);
+  }
+  const markdownRegex = /!\[[^\]]*\]\(\s*([^)\s]+)/g;
+  while ((match = markdownRegex.exec(content)) !== null) {
+    add(match[1]);
+  }
+  return references;
+}
+function addImageDownloadOptions(command) {
+  return command.option("--download-images", "download images embedded in rich-text fields to local files").option("--resize-images <pixels>", "max image width in px; downloads and resizes embedded images to PNG (implies --download-images)").option("--images-path <dir>", "destination directory for downloaded images (default: system temp dir)");
+}
+function resolveImageDownloadOptionsOrExit(flags) {
+  try {
+    return resolveImageDownloadOptions(flags);
+  } catch (err) {
+    process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
+}
+function resolveImageDownloadOptions(flags) {
+  const wantsResize = flags.resizeImages !== void 0;
+  const enabled = Boolean(flags.downloadImages) || wantsResize;
+  let maxWidth;
+  if (wantsResize) {
+    const parsed = Number(flags.resizeImages);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+      throw new Error(
+        `Invalid --resize-images value "${flags.resizeImages}": must be a positive integer (max width in pixels).`
+      );
+    }
+    maxWidth = parsed;
+  }
+  const outputDir = flags.imagesPath ?? tmpdir();
+  if (flags.imagesPath !== void 0 && !existsSync(outputDir)) {
+    throw new Error(`Images path "${outputDir}" does not exist.`);
+  }
+  return { enabled, maxWidth, outputDir };
+}
+function buildImageFileName(workItemId, index, reference, resizing) {
+  const ext = resizing ? ".png" : reference.suggestedExtension;
+  return `wi-${workItemId}-${index}${ext}`;
+}
+async function processImageBytes(bytes, maxWidth) {
+  if (maxWidth === void 0) {
+    return { buffer: Buffer.from(bytes), resized: false, format: "original" };
+  }
+  const image = await Jimp.read(Buffer.from(bytes));
+  let resized = false;
+  if (image.bitmap.width > maxWidth) {
+    image.resize({ w: maxWidth });
+    resized = true;
+  }
+  const buffer = await image.getBuffer("image/png");
+  return { buffer, resized, format: "png" };
+}
+async function downloadImagesFromFields(fields, args, credential) {
+  const { workItemId, options } = args;
+  const resizing = options.maxWidth !== void 0;
+  const seen = /* @__PURE__ */ new Set();
+  const references = [];
+  for (const field of fields) {
+    for (const reference of extractImageReferences(field.content, field.field)) {
+      if (!seen.has(reference.guid)) {
+        seen.add(reference.guid);
+        references.push(reference);
+      }
+    }
+  }
+  const results = [];
+  let index = 0;
+  for (const reference of references) {
+    index += 1;
+    try {
+      const bytes = await downloadAttachment(reference.url, credential);
+      const processed = await processImageBytes(bytes, options.maxWidth);
+      const fileName = buildImageFileName(workItemId, index, reference, resizing);
+      const outputPath = join(options.outputDir, fileName);
+      await writeFile(outputPath, processed.buffer);
+      results.push({
+        reference,
+        path: outputPath,
+        resized: processed.resized,
+        format: resizing ? "png" : reference.suggestedExtension.replace(/^\./, "")
+      });
+    } catch (err) {
+      results.push({
+        reference,
+        resized: false,
+        format: reference.suggestedExtension.replace(/^\./, ""),
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  return results;
+}
+async function runImageDownload(fields, args, credential) {
+  const results = await downloadImagesFromFields(fields, args, credential);
+  process.stdout.write(formatImageSummary(results) + "\n");
+  for (const result of results) {
+    if (result.error) {
+      process.stderr.write(`Failed to download image ${result.reference.url}: ${result.error}
+`);
+    }
+  }
+}
+function formatImageSummary(results) {
+  if (results.length === 0) {
+    return "Images: no images found in rich-text fields";
+  }
+  const saved = results.filter((r) => r.path);
+  const lines = [`Images: ${saved.length} downloaded`];
+  for (const result of saved) {
+    lines.push(`  ${result.path}`);
+  }
+  return lines.join("\n");
+}
+
 // src/services/azdo-client.ts
 var DEFAULT_FIELDS = [
   "System.Title",
@@ -325,12 +495,25 @@ async function getWorkItemFields(context, id, cred) {
 function extractAttachments(relations) {
   if (!relations) return null;
   const attachments = relations.filter((r) => r.rel === "AttachedFile").map((r) => ({
+    id: extractAttachmentGuid(r.url) ?? "",
     name: r.attributes.name ?? "unknown",
     size: r.attributes.resourceSize ?? 0,
     url: r.url
   }));
   return attachments.length > 0 ? attachments : null;
 }
+async function findAttachmentRelations(context, id, cred, filename) {
+  const data = await fetchWorkItemResponse(context, id, cred, { includeRelations: true });
+  const relations = data.relations ?? [];
+  return relations.map((r, index) => ({ r, index })).filter(({ r }) => r.rel === "AttachedFile" && r.attributes.name === filename).map(({ r, index }) => ({
+    index,
+    id: extractAttachmentGuid(r.url) ?? "",
+    name: r.attributes.name ?? filename,
+    size: r.attributes.resourceSize ?? 0,
+    uploadedDate: r.attributes.resourceCreatedDate ?? r.attributes.resourceModifiedDate,
+    url: r.url
+  }));
+}
 function buildWorkItemUrl(context, id, options = {}) {
   const url = new URL(
     `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/workitems/${id}`
@@ -513,7 +696,7 @@ async function updateWorkItem(context, id, cred, fieldName, operations) {
   const result = await applyWorkItemPatch(context, id, cred, operations);
   const title = result.fields["System.Title"];
   const lastOp = operations.at(-1);
-  const fieldValue = lastOp?.value ?? null;
+  const fieldValue = typeof lastOp?.value === "string" ? lastOp.value : null;
   return {
     id: result.id,
     rev: result.rev,
@@ -553,11 +736,36 @@ async function downloadAttachment(url, cred) {
   }
   return response.arrayBuffer();
 }
+async function createAttachment(context, fileName, content, cred) {
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/attachments`
+  );
+  url.searchParams.set("fileName", fileName);
+  url.searchParams.set("api-version", "7.1");
+  const response = await fetchWithErrors(url.toString(), {
+    method: "POST",
+    headers: {
+      ...authHeaders(cred),
+      "Content-Type": "application/octet-stream"
+    },
+    body: new Uint8Array(content)
+  });
+  if (response.status === 400) {
+    const serverMessage = await readResponseMessage(response);
+    if (serverMessage) {
+      throw new Error(`BAD_REQUEST: ${serverMessage}`);
+    }
+  }
+  if (!response.ok) {
+    throw new Error(`HTTP_${response.status}`);
+  }
+  return await response.json();
+}
 
 // src/services/auth.ts
 import { createInterface } from "readline";
-import { existsSync, readFileSync as readFileSync2 } from "fs";
-import { dirname as dirname2, join } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { dirname as dirname2, join as join2 } from "path";
 
 // src/services/oauth-device-code.ts
 var DeviceCodeFlowError = class extends Error {
@@ -728,8 +936,8 @@ async function promptForPat() {
 function findDotEnvPat(startDir = process.cwd()) {
   let current = startDir;
   while (true) {
-    const envFile = join(current, ".env");
-    if (existsSync(envFile)) {
+    const envFile = join2(current, ".env");
+    if (existsSync2(envFile)) {
       const contents = readFileSync2(envFile, "utf8");
       for (const line of contents.split("\n")) {
         const match = line.match(/^AZDO_PAT\s*=([^\n\r]+)$/);
@@ -1339,6 +1547,24 @@ function toMarkdown(content) {
 }
 
 // src/services/command-helpers.ts
+async function promptYesNo(prompt) {
+  if (!process.stdin.isTTY) return true;
+  process.stderr.write(prompt);
+  return await new Promise((resolve2) => {
+    process.stdin.setEncoding("utf8");
+    let answered = false;
+    const handler = (data) => {
+      if (answered) return;
+      answered = true;
+      process.stdin.removeListener("data", handler);
+      process.stdin.pause();
+      const trimmed = data.trim().toLowerCase();
+      resolve2(trimmed === "y" || trimmed === "yes");
+    };
+    process.stdin.resume();
+    process.stdin.on("data", handler);
+  });
+}
 function parseWorkItemId(idStr) {
   const id = Number.parseInt(idStr, 10);
   if (!Number.isInteger(id) || id <= 0) {
@@ -1423,173 +1649,6 @@ function handleCommandError(err, id, context, scope = "write", exit = true) {
   }
 }
 
-// src/services/image-download.ts
-import { Jimp } from "jimp";
-import { writeFile } from "fs/promises";
-import { existsSync as existsSync2 } from "fs";
-import { tmpdir } from "os";
-import { join as join2 } 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})/;
-function isAzureDevOpsAttachmentHost(hostname) {
-  const host = hostname.toLowerCase();
-  return host === "dev.azure.com" || host.endsWith(".dev.azure.com") || host.endsWith(".visualstudio.com");
-}
-function decodeHtmlEntities(value) {
-  return value.replaceAll("&quot;", '"').replaceAll("&#39;", "'").replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&amp;", "&");
-}
-function parseAttachmentReference(rawUrl, sourceField) {
-  const url = decodeHtmlEntities(rawUrl.trim());
-  let parsed;
-  try {
-    parsed = new URL(url);
-  } catch {
-    return null;
-  }
-  if (parsed.protocol !== "https:" || !isAzureDevOpsAttachmentHost(parsed.hostname)) {
-    return null;
-  }
-  const match = ATTACHMENT_GUID_RE.exec(parsed.pathname);
-  if (!match) return null;
-  const guid = match[1].toLowerCase();
-  let suggestedExtension = ".png";
-  const fileName = parsed.searchParams.get("fileName");
-  if (fileName?.includes(".")) {
-    suggestedExtension = fileName.slice(fileName.lastIndexOf(".")).toLowerCase();
-  }
-  return { url, sourceField, guid, suggestedExtension };
-}
-function extractImageReferences(content, sourceField) {
-  if (!content) return [];
-  const references = [];
-  const seen = /* @__PURE__ */ new Set();
-  const add = (rawUrl) => {
-    const reference = parseAttachmentReference(rawUrl, sourceField);
-    if (reference && !seen.has(reference.guid)) {
-      seen.add(reference.guid);
-      references.push(reference);
-    }
-  };
-  const imgRegex = /<img\b[^>]*?\ssrc\s*=\s*["']([^"']+)["']/gi;
-  let match;
-  while ((match = imgRegex.exec(content)) !== null) {
-    add(match[1]);
-  }
-  const markdownRegex = /!\[[^\]]*\]\(\s*([^)\s]+)/g;
-  while ((match = markdownRegex.exec(content)) !== null) {
-    add(match[1]);
-  }
-  return references;
-}
-function addImageDownloadOptions(command) {
-  return command.option("--download-images", "download images embedded in rich-text fields to local files").option("--resize-images <pixels>", "max image width in px; downloads and resizes embedded images to PNG (implies --download-images)").option("--images-path <dir>", "destination directory for downloaded images (default: system temp dir)");
-}
-function resolveImageDownloadOptionsOrExit(flags) {
-  try {
-    return resolveImageDownloadOptions(flags);
-  } catch (err) {
-    process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-}
-function resolveImageDownloadOptions(flags) {
-  const wantsResize = flags.resizeImages !== void 0;
-  const enabled = Boolean(flags.downloadImages) || wantsResize;
-  let maxWidth;
-  if (wantsResize) {
-    const parsed = Number(flags.resizeImages);
-    if (!Number.isInteger(parsed) || parsed <= 0) {
-      throw new Error(
-        `Invalid --resize-images value "${flags.resizeImages}": must be a positive integer (max width in pixels).`
-      );
-    }
-    maxWidth = parsed;
-  }
-  const outputDir = flags.imagesPath ?? tmpdir();
-  if (flags.imagesPath !== void 0 && !existsSync2(outputDir)) {
-    throw new Error(`Images path "${outputDir}" does not exist.`);
-  }
-  return { enabled, maxWidth, outputDir };
-}
-function buildImageFileName(workItemId, index, reference, resizing) {
-  const ext = resizing ? ".png" : reference.suggestedExtension;
-  return `wi-${workItemId}-${index}${ext}`;
-}
-async function processImageBytes(bytes, maxWidth) {
-  if (maxWidth === void 0) {
-    return { buffer: Buffer.from(bytes), resized: false, format: "original" };
-  }
-  const image = await Jimp.read(Buffer.from(bytes));
-  let resized = false;
-  if (image.bitmap.width > maxWidth) {
-    image.resize({ w: maxWidth });
-    resized = true;
-  }
-  const buffer = await image.getBuffer("image/png");
-  return { buffer, resized, format: "png" };
-}
-async function downloadImagesFromFields(fields, args, credential) {
-  const { workItemId, options } = args;
-  const resizing = options.maxWidth !== void 0;
-  const seen = /* @__PURE__ */ new Set();
-  const references = [];
-  for (const field of fields) {
-    for (const reference of extractImageReferences(field.content, field.field)) {
-      if (!seen.has(reference.guid)) {
-        seen.add(reference.guid);
-        references.push(reference);
-      }
-    }
-  }
-  const results = [];
-  let index = 0;
-  for (const reference of references) {
-    index += 1;
-    try {
-      const bytes = await downloadAttachment(reference.url, credential);
-      const processed = await processImageBytes(bytes, options.maxWidth);
-      const fileName = buildImageFileName(workItemId, index, reference, resizing);
-      const outputPath = join2(options.outputDir, fileName);
-      await writeFile(outputPath, processed.buffer);
-      results.push({
-        reference,
-        path: outputPath,
-        resized: processed.resized,
-        format: resizing ? "png" : reference.suggestedExtension.replace(/^\./, "")
-      });
-    } catch (err) {
-      results.push({
-        reference,
-        resized: false,
-        format: reference.suggestedExtension.replace(/^\./, ""),
-        error: err instanceof Error ? err.message : String(err)
-      });
-    }
-  }
-  return results;
-}
-async function runImageDownload(fields, args, credential) {
-  const results = await downloadImagesFromFields(fields, args, credential);
-  process.stdout.write(formatImageSummary(results) + "\n");
-  for (const result of results) {
-    if (result.error) {
-      process.stderr.write(`Failed to download image ${result.reference.url}: ${result.error}
-`);
-    }
-  }
-}
-function formatImageSummary(results) {
-  if (results.length === 0) {
-    return "Images: no images found in rich-text fields";
-  }
-  const saved = results.filter((r) => r.path);
-  const lines = [`Images: ${saved.length} downloaded`];
-  for (const result of saved) {
-    lines.push(`  ${result.path}`);
-  }
-  return lines.join("\n");
-}
-
 // src/commands/get-item.ts
 function parseRequestedFields(raw) {
   if (raw === void 0) return void 0;
@@ -1885,24 +1944,6 @@ async function readStdinToString() {
   }
   return Buffer.concat(chunks).toString("utf8");
 }
-async function promptYesNo(prompt) {
-  if (!process.stdin.isTTY) return true;
-  process.stderr.write(prompt);
-  return await new Promise((resolve2) => {
-    process.stdin.setEncoding("utf8");
-    let answered = false;
-    const handler = (data) => {
-      if (answered) return;
-      answered = true;
-      process.stdin.removeListener("data", handler);
-      process.stdin.pause();
-      const trimmed = data.trim().toLowerCase();
-      resolve2(trimmed === "y" || trimmed === "yes");
-    };
-    process.stdin.resume();
-    process.stdin.on("data", handler);
-  });
-}
 async function confirmOverwrite(org) {
   return promptYesNo(`A PAT is already stored for org ${org}. Overwrite? [y/N] `);
 }
@@ -6085,8 +6126,142 @@ function createDownloadAttachmentCommand() {
   return command;
 }
 
-// src/commands/relations.ts
+// src/commands/add-attachment.ts
 import { Command as Command16 } from "commander";
+import { existsSync as existsSync7, statSync } from "fs";
+import { readFile } from "fs/promises";
+import { basename } from "path";
+function createAddAttachmentCommand() {
+  const command = new Command16("add-attachment");
+  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)) {
+        process.stderr.write(`Error: File not found: ${file}
+`);
+        process.exit(1);
+      }
+      if (!statSync(file).isFile()) {
+        process.stderr.write(`Error: "${file}" is not a regular file.
+`);
+        process.exit(1);
+      }
+      let context;
+      try {
+        const filename = basename(file);
+        const content = await readFile(file);
+        context = resolveContext(options);
+        const credential = await requireAuthCredential(context.org);
+        await getWorkItem(context, id, credential);
+        const attachment = await createAttachment(context, filename, content, credential);
+        await applyWorkItemPatch(context, id, credential, [
+          {
+            op: "add",
+            path: "/relations/-",
+            value: {
+              rel: "AttachedFile",
+              url: attachment.url,
+              ...options.comment ? { attributes: { comment: options.comment } } : {}
+            }
+          }
+        ]);
+        process.stdout.write(
+          `Attached "${filename}" (${formatFileSize(content.length)}) to work item ${id} [id: ${attachment.id}]
+`
+        );
+      } catch (err) {
+        handleCommandError(err, id, context, "write");
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/delete-attachment.ts
+import { Command as Command17 } from "commander";
+function formatUploadDate(iso) {
+  return iso ? iso.slice(0, 10) : "unknown date";
+}
+function createDeleteAttachmentCommand() {
+  const command = new Command17("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);
+      validateOrgProjectPair(options);
+      let context;
+      try {
+        context = resolveContext(options);
+        const credential = await requireAuthCredential(context.org);
+        const matches = await findAttachmentRelations(context, id, credential, filename);
+        if (matches.length === 0) {
+          process.stderr.write(`Error: Attachment "${filename}" not found on work item ${id}.
+`);
+          process.exitCode = 1;
+          return;
+        }
+        let target;
+        if (options.id) {
+          const wantedId = options.id.toLowerCase();
+          const narrowed = matches.find((match) => match.id === wantedId);
+          if (!narrowed) {
+            process.stderr.write(
+              `Error: No attachment named "${filename}" with id ${options.id} found on work item ${id}.
+`
+            );
+            process.exitCode = 1;
+            return;
+          }
+          target = narrowed;
+        } else if (matches.length > 1) {
+          process.stderr.write(
+            `Error: multiple attachments named "${filename}" on work item ${id}:
+`
+          );
+          for (const match of matches) {
+            process.stderr.write(
+              `  ${match.id}  ${formatFileSize(match.size)}  ${formatUploadDate(match.uploadedDate)}
+`
+            );
+          }
+          process.stderr.write("Re-run with --id <guid> to remove a specific one.\n");
+          process.exitCode = 1;
+          return;
+        } else {
+          target = matches[0];
+        }
+        let confirmed = options.yes === true;
+        if (!confirmed) {
+          if (!process.stdin.isTTY) {
+            process.stderr.write(
+              "Error: confirmation required. Re-run with --yes to skip the prompt in a non-interactive shell.\n"
+            );
+            process.exitCode = 1;
+            return;
+          }
+          confirmed = await promptYesNo(`Remove "${filename}" from work item ${id}? [y/N] `);
+        }
+        if (!confirmed) {
+          process.stderr.write("Aborted: attachment not removed.\n");
+          process.exitCode = 1;
+          return;
+        }
+        await applyWorkItemPatch(context, id, credential, [
+          { op: "test", path: `/relations/${target.index}/url`, value: target.url },
+          { op: "remove", path: `/relations/${target.index}` }
+        ]);
+        process.stdout.write(`Removed "${filename}" (id: ${target.id}) from work item ${id}
+`);
+      } catch (err) {
+        handleCommandError(err, id, context, "write");
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/relations.ts
+import { Command as Command18 } from "commander";
 
 // src/services/relations-client.ts
 var API_VERSION2 = "7.1";
@@ -6301,7 +6476,7 @@ function parsePositiveInt(value, label) {
   return n;
 }
 function createRelationsCommand() {
-  const relations = new Command16("relations").description("Manage work item relations");
+  const relations = new Command18("relations").description("Manage work item relations");
   addCommonOptions(
     relations.command("types").description("List all available work item relation types")
   ).action(async (opts) => {
@@ -6491,7 +6666,7 @@ function exitOnEpipe(err) {
 }
 process.stdout.on("error", exitOnEpipe);
 process.stderr.on("error", exitOnEpipe);
-var program = new Command17();
+var program = new Command19();
 program.name("azdo").description("Azure DevOps CLI tool").version(version, "-v, --version");
 program.option("--no-update-check", "Skip the check for a newer published version");
 program.option("--trace <filepath>", "Append redacted HTTP request/response trace to a file (owner-read-only permissions)");
@@ -6510,6 +6685,8 @@ program.addCommand(createPrCommand());
 program.addCommand(createPipelineCommand());
 program.addCommand(createCommentsCommand());
 program.addCommand(createDownloadAttachmentCommand());
+program.addCommand(createAddAttachmentCommand());
+program.addCommand(createDeleteAttachmentCommand());
 program.addCommand(createRelationsCommand());
 program.showHelpAfterError();
 program.hook("preAction", () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.18.0-develop.649",
+  "version": "0.18.0-develop.675",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {