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

package/README.md

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

package/dist/index.js

@@ -4501,11 +4501,11 @@ function branchTemplateSegments(branch) {
   }
   return segments;
 }
-async function fetchRepositoryItemContent(context, repo, cred, path3, branch) {
+async function fetchRepositoryItemContent(context, repo, cred, path5, branch) {
   const url = new URL(
     `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/git/repositories/${encodeURIComponent(repo)}/items`
   );
-  url.searchParams.set("path", path3);
+  url.searchParams.set("path", path5);
   url.searchParams.set("versionDescriptor.version", branch);
   url.searchParams.set("versionDescriptor.versionType", "branch");
   url.searchParams.set("includeContent", "true");
@@ -4548,10 +4548,10 @@ function defaultTemplateCandidates() {
   return paths;
 }
 async function firstMatchingTemplate(context, repo, cred, defaultBranch, candidates, kind) {
-  for (const path3 of candidates) {
-    const content = await fetchRepositoryItemContent(context, repo, cred, path3, defaultBranch);
+  for (const path5 of candidates) {
+    const content = await fetchRepositoryItemContent(context, repo, cred, path5, defaultBranch);
     if (content !== null) {
-      return { path: path3, content, kind };
+      return { path: path5, content, kind };
     }
   }
   return null;
@@ -6348,6 +6348,7 @@ function createPrCommand() {
 
 // src/commands/pipeline.ts
 import { Command as Command14 } from "commander";
+import path3 from "path";
 
 // src/services/pipeline-client.ts
 var API_VERSION = "7.1";
@@ -6471,6 +6472,9 @@ async function getBuildStatus(context, cred, buildId) {
   const build = await getBuild(context, cred, buildId);
   return { state: mapBuildState(build.status), result: mapRunResult(build.result) };
 }
+function recordErrors(record) {
+  return (record.issues ?? []).filter((issue) => issue.type === "error" && issue.message).map((issue) => ({ message: issue.message ?? "", source: record.name ?? null }));
+}
 async function getBuildTimeline(context, cred, buildId) {
   const url = withApiVersion(
     new URL(`${orgProjectBase(context)}/_apis/build/builds/${buildId}/timeline`)
@@ -6482,14 +6486,20 @@ async function getBuildTimeline(context, cred, buildId) {
   const stages = [];
   const jobs = [];
   const logSteps = /* @__PURE__ */ new Map();
+  const logRecords = /* @__PURE__ */ new Map();
+  const namesById = /* @__PURE__ */ new Map();
   for (const record of records) {
-    for (const issue of record.issues ?? []) {
-      if (issue.type === "error" && issue.message) {
-        errors.push({ message: issue.message, source: record.name ?? null });
-      }
-    }
+    if (record.id && record.name) namesById.set(record.id, record.name);
+  }
+  for (const record of records) {
+    errors.push(...recordErrors(record));
     if (record.name && record.log?.id !== void 0) {
       logSteps.set(record.log.id, record.name);
+      logRecords.set(record.log.id, {
+        name: record.name,
+        type: record.type ?? null,
+        parent: record.parentId && namesById.get(record.parentId) || null
+      });
     }
     if (!record.name) continue;
     const status2 = {
@@ -6509,7 +6519,7 @@ async function getBuildTimeline(context, cred, buildId) {
     if (b.startTime === void 0) return -1;
     return a.startTime < b.startTime ? -1 : 1;
   });
-  return { errors, stages, jobs: jobs.map((j) => j.status), logSteps };
+  return { errors, stages, jobs: jobs.map((j) => j.status), logSteps, logRecords };
 }
 async function listTestRuns(context, cred, buildId) {
   const url = withApiVersion(new URL(`${orgProjectBase(context)}/_apis/test/runs`));
@@ -6618,16 +6628,18 @@ async function getRunLogs(context, cred, buildId) {
   );
   const response = await fetchWithErrors(url.toString(), { headers: authHeaders(cred) });
   const data = await readJsonResponse2(response);
-  let logSteps = /* @__PURE__ */ new Map();
+  let logRecords = /* @__PURE__ */ new Map();
   try {
-    logSteps = (await getBuildTimeline(context, cred, buildId)).logSteps;
+    logRecords = (await getBuildTimeline(context, cred, buildId)).logRecords;
   } catch {
   }
   return data.value.map((log) => ({
     id: log.id,
     createdOn: log.createdOn ?? null,
     lineCount: log.lineCount ?? null,
-    step: logSteps.get(log.id) ?? null
+    step: logRecords.get(log.id)?.name ?? null,
+    type: logRecords.get(log.id)?.type ?? null,
+    parent: logRecords.get(log.id)?.parent ?? null
   }));
 }
 async function getRunLog(context, cred, buildId, logId) {
@@ -6640,6 +6652,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;
@@ -6976,19 +7104,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 Command14("get-run-detail");
-  command.description("Show a detailed summary of a single pipeline run (errors, failing tests, stages)").argument("<run_id>", "pipeline run id").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(async (runIdRaw, options) => {
-    validateOrgProjectPair(options);
-    const runId = parsePositiveId(runIdRaw);
-    if (runId === null) {
-      writeError2(`Invalid run id "${runIdRaw}"; expected a positive integer.`);
-      return;
-    }
-    let context;
-    try {
-      const resolved = await resolvePipelineContext(options);
-      context = resolved.context;
+  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)}
@@ -6997,10 +7132,8 @@ function createPipelineGetRunDetailCommand() {
       }
       process.stdout.write(`${formatRunDetail(detail)}
 `);
-    } catch (err) {
-      handlePipelineError(err, context);
-    }
-  });
+    })
+  );
   return command;
 }
 function grepWithContext(lines, grep, context) {
@@ -7023,17 +7156,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) {
@@ -7042,9 +7195,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) {
@@ -7053,6 +7211,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;
@@ -7064,7 +7224,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();
@@ -7076,7 +7242,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;
   }
@@ -7098,8 +7264,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")}
 `);
@@ -7111,7 +7277,7 @@ function printSingleLog(content, filters) {
 }
 function createPipelineLogsCommand() {
   const command = new Command14("logs");
-  command.description("List a pipeline run's logs, or print a specific log with --log-id").argument("<run_id>", "pipeline run id").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--log-id <id>", "print the content of this log id").option("--step <name>", "print the log of the step/job matching this name (case-insensitive substring)").option("--tail <n>", "with --log-id/--step, print only the last N lines").option("--grep <pattern>", "with --log-id/--step, print only lines matching this regular expression").option("--context <n>", "with --grep, also print N lines around each match (grep -C)").option("--json", "output JSON").action(async (runIdRaw, options) => {
+  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) {
@@ -7150,7 +7316,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]))}
 `);
@@ -7160,6 +7328,102 @@ 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 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) => {
@@ -7261,6 +7525,8 @@ function createPipelineCommand() {
   command.addCommand(createPipelineWaitCommand());
   command.addCommand(createPipelineGetRunDetailCommand());
   command.addCommand(createPipelineLogsCommand());
+  command.addCommand(createPipelineArtifactsCommand());
+  command.addCommand(createPipelineArtifactDownloadCommand());
   command.addCommand(createPipelineTestsCommand());
   command.addCommand(createPipelineStartCommand());
   return command;
@@ -7352,7 +7618,7 @@ function createCommentsCommand() {
 // src/commands/download-attachment.ts
 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 Command16("download-attachment");
@@ -7365,7 +7631,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);
@@ -7398,7 +7664,7 @@ function createDownloadAttachmentCommand() {
 
 // src/commands/add-attachment.ts
 import { Command as Command17 } from "commander";
-import { existsSync as existsSync7, statSync } from "fs";
+import { existsSync as existsSync8, statSync } from "fs";
 import { readFile } from "fs/promises";
 import { basename } from "path";
 function createAddAttachmentCommand() {
@@ -7407,7 +7673,7 @@ function createAddAttachmentCommand() {
     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);
@@ -7827,7 +8093,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;
@@ -7845,7 +8111,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 {
@@ -7857,7 +8123,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 {
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.22.0-develop.798",
+  "version": "0.22.0-develop.822",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {
@@ -28,6 +28,7 @@
     "@napi-rs/keyring": "^1.3.0",
     "@primno/dpapi": "^2.0.1",
     "commander": "^14.0.3",
+    "fflate": "^0.8.3",
     "jimp": "^1.6.1",
     "node-html-markdown": "^2.0.0"
   },