azdo-cli 0.5.0-013-comments-markdown.174 → 0.5.0-014-work-item-attachments.182

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -166,17 +166,33 @@ async function getWorkItemFields(context, id, pat) {
   const data = await response.json();
   return data.fields;
 }
-async function getWorkItem(context, id, pat, extraFields) {
+function extractAttachments(relations) {
+  if (!relations) return null;
+  const attachments = relations.filter((r) => r.rel === "AttachedFile").map((r) => ({
+    name: r.attributes.name ?? "unknown",
+    size: r.attributes.resourceSize ?? 0,
+    url: r.url
+  }));
+  return attachments.length > 0 ? attachments : null;
+}
+function buildWorkItemUrl(context, id, options = {}) {
   const url = new URL(
     `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/workitems/${id}`
   );
   url.searchParams.set("api-version", "7.1");
-  const normalizedExtraFields = extraFields ? normalizeFieldList(extraFields) : [];
-  if (normalizedExtraFields.length > 0) {
-    const allFields = normalizeFieldList([...DEFAULT_FIELDS, ...normalizedExtraFields]);
-    url.searchParams.set("fields", allFields.join(","));
+  if (options.includeRelations) {
+    url.searchParams.set("$expand", "relations");
   }
-  const response = await fetchWithErrors(url.toString(), { headers: authHeaders(pat) });
+  if (options.fields && options.fields.length > 0) {
+    url.searchParams.set("fields", options.fields.join(","));
+  }
+  return url;
+}
+async function fetchWorkItemResponse(context, id, pat, options = {}) {
+  const response = await fetchWithErrors(
+    buildWorkItemUrl(context, id, options).toString(),
+    { headers: authHeaders(pat) }
+  );
   if (response.status === 400) {
     const serverMessage = await readResponseMessage(response);
     if (serverMessage) {
@@ -186,7 +202,14 @@ async function getWorkItem(context, id, pat, extraFields) {
   if (!response.ok) {
     throw new Error(`HTTP_${response.status}`);
   }
-  const data = await response.json();
+  return await response.json();
+}
+async function getWorkItem(context, id, pat, extraFields) {
+  const normalizedExtraFields = extraFields ? normalizeFieldList(extraFields) : [];
+  const data = normalizedExtraFields.length > 0 ? await fetchWorkItemResponse(context, id, pat, {
+    fields: normalizeFieldList([...DEFAULT_FIELDS, ...normalizedExtraFields])
+  }) : await fetchWorkItemResponse(context, id, pat, { includeRelations: true });
+  const relationsData = normalizedExtraFields.length > 0 ? await fetchWorkItemResponse(context, id, pat, { includeRelations: true }) : data;
   const descriptionParts = [];
   if (data.fields["System.Description"]) {
     descriptionParts.push({ label: "Description", value: data.fields["System.Description"] });
@@ -214,7 +237,8 @@ async function getWorkItem(context, id, pat, extraFields) {
     areaPath: data.fields["System.AreaPath"],
     iterationPath: data.fields["System.IterationPath"],
     url: data._links.html.href,
-    extraFields: normalizedExtraFields.length > 0 ? buildExtraFields(data.fields, normalizedExtraFields) : null
+    extraFields: normalizedExtraFields.length > 0 ? buildExtraFields(data.fields, normalizedExtraFields) : null,
+    attachments: extractAttachments(relationsData.relations)
   };
 }
 async function getWorkItemFieldValue(context, id, pat, fieldName) {
@@ -328,6 +352,13 @@ async function applyWorkItemPatch(context, id, pat, operations) {
   });
   return readWriteResponse(response, "UPDATE_REJECTED");
 }
+async function downloadAttachment(url, pat) {
+  const response = await fetchWithErrors(url, { headers: authHeaders(pat) });
+  if (!response.ok) {
+    throw new Error(`HTTP_${response.status}`);
+  }
+  return response.arrayBuffer();
+}
 
 // src/services/auth.ts
 import { createInterface } from "readline";
@@ -857,6 +888,23 @@ function summarizeDescription(text, label, markdown) {
   }
   return [`${label("Description:")}${content}`];
 }
+function formatFileSize(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  const kb = bytes / 1024;
+  if (kb < 1024) return `${kb.toFixed(1)} KB`;
+  const mb = kb / 1024;
+  return `${mb.toFixed(1)} MB`;
+}
+function formatAttachments(attachments, short) {
+  if (short) {
+    return [`Attachments: ${attachments.length}`];
+  }
+  const lines = ["", "Attachments:"];
+  for (const att of attachments) {
+    lines.push(`  ${att.name} (${formatFileSize(att.size)})`);
+  }
+  return lines;
+}
 function formatWorkItem(workItem, short, markdown = false) {
   const label = (name) => name.padEnd(13);
   const lines = [
@@ -883,6 +931,9 @@ function formatWorkItem(workItem, short, markdown = false) {
   } else {
     lines.push("Description:", descriptionText);
   }
+  if (workItem.attachments) {
+    lines.push(...formatAttachments(workItem.attachments, short));
+  }
   return lines.join("\n");
 }
 function createGetItemCommand() {
@@ -2171,8 +2222,55 @@ function createCommentsCommand() {
   return command;
 }
 
+// src/commands/download-attachment.ts
+import { Command as Command13 } from "commander";
+import { writeFile } from "fs/promises";
+import { existsSync as existsSync4 } from "fs";
+import { join as join2 } from "path";
+function createDownloadAttachmentCommand() {
+  const command = new Command13("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);
+      validateOrgProjectPair(options);
+      let context;
+      try {
+        context = resolveContext(options);
+        const credential = await resolvePat();
+        const outputDir = options.output ?? ".";
+        if (!existsSync4(outputDir)) {
+          process.stderr.write(`Error: Output directory "${outputDir}" does not exist.
+`);
+          process.exit(1);
+        }
+        const workItem = await getWorkItem(context, id, credential.pat);
+        const attachment = workItem.attachments?.find(
+          (a) => a.name === filename
+        );
+        if (!attachment) {
+          process.stderr.write(
+            `Error: Attachment "${filename}" not found on work item ${id}.
+`
+          );
+          process.exit(1);
+        }
+        const data = await downloadAttachment(attachment.url, credential.pat);
+        const outputPath = join2(outputDir, filename);
+        await writeFile(outputPath, Buffer.from(data));
+        process.stdout.write(
+          `Downloaded "${filename}" (${formatFileSize(attachment.size)}) to ${outputPath}
+`
+        );
+      } catch (err) {
+        handleCommandError(err, id, context, "read", false);
+      }
+    }
+  );
+  return command;
+}
+
 // src/index.ts
-var program = new Command13();
+var program = new Command14();
 program.name("azdo").description("Azure DevOps CLI tool").version(version, "-v, --version");
 program.addCommand(createGetItemCommand());
 program.addCommand(createClearPatCommand());
@@ -2186,6 +2284,7 @@ program.addCommand(createUpsertCommand());
 program.addCommand(createListFieldsCommand());
 program.addCommand(createPrCommand());
 program.addCommand(createCommentsCommand());
+program.addCommand(createDownloadAttachmentCommand());
 program.showHelpAfterError();
 program.parse();
 if (process.argv.length <= 2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.5.0-013-comments-markdown.174",
+  "version": "0.5.0-014-work-item-attachments.182",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {
@@ -14,7 +14,8 @@
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
     "format": "prettier --check src/",
-    "test": "npm run build && vitest run tests/unit",
+    "test": "npm run build && vitest run tests/unit tests/integration",
+    "test:unit": "npm run build && vitest run tests/unit",
     "test:integration": "npm run build && vitest run tests/integration",
     "test:integration:full": "bash scripts/setup-keyring.sh && npm run test:integration"
   },