azdo-cli 0.2.0-develop.24 → 0.2.0-develop.47

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command7 } from "commander";
+import { Command as Command9 } from "commander";
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -26,6 +26,22 @@ var DEFAULT_FIELDS = [
   "System.AreaPath",
   "System.IterationPath"
 ];
+function authHeaders(pat) {
+  const token = Buffer.from(`:${pat}`).toString("base64");
+  return { Authorization: `Basic ${token}` };
+}
+async function fetchWithErrors(url, init) {
+  let response;
+  try {
+    response = await fetch(url, init);
+  } catch {
+    throw new Error("NETWORK_ERROR");
+  }
+  if (response.status === 401) throw new Error("AUTH_FAILED");
+  if (response.status === 403) throw new Error("PERMISSION_DENIED");
+  if (response.status === 404) throw new Error("NOT_FOUND");
+  return response;
+}
 function buildExtraFields(fields, requested) {
   const result = {};
   for (const name of requested) {
@@ -37,25 +53,15 @@ function buildExtraFields(fields, requested) {
   return Object.keys(result).length > 0 ? result : null;
 }
 async function getWorkItem(context, id, pat, extraFields) {
-  let url = `https://dev.azure.com/${context.org}/${context.project}/_apis/wit/workitems/${id}?api-version=7.1`;
+  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");
   if (extraFields && extraFields.length > 0) {
     const allFields = [...DEFAULT_FIELDS, ...extraFields];
-    url += `&fields=${allFields.join(",")}`;
-  }
-  const token = Buffer.from(`:${pat}`).toString("base64");
-  let response;
-  try {
-    response = await fetch(url, {
-      headers: {
-        Authorization: `Basic ${token}`
-      }
-    });
-  } catch {
-    throw new Error("NETWORK_ERROR");
+    url.searchParams.set("fields", allFields.join(","));
   }
-  if (response.status === 401) throw new Error("AUTH_FAILED");
-  if (response.status === 403) throw new Error("PERMISSION_DENIED");
-  if (response.status === 404) throw new Error("NOT_FOUND");
+  const response = await fetchWithErrors(url.toString(), { headers: authHeaders(pat) });
   if (!response.ok) {
     throw new Error(`HTTP_${response.status}`);
   }
@@ -90,25 +96,32 @@ async function getWorkItem(context, id, pat, extraFields) {
     extraFields: extraFields && extraFields.length > 0 ? buildExtraFields(data.fields, extraFields) : null
   };
 }
-async function updateWorkItem(context, id, pat, fieldName, operations) {
-  const url = `https://dev.azure.com/${context.org}/${context.project}/_apis/wit/workitems/${id}?api-version=7.1`;
-  const token = Buffer.from(`:${pat}`).toString("base64");
-  let response;
-  try {
-    response = await fetch(url, {
-      method: "PATCH",
-      headers: {
-        Authorization: `Basic ${token}`,
-        "Content-Type": "application/json-patch+json"
-      },
-      body: JSON.stringify(operations)
-    });
-  } catch {
-    throw new Error("NETWORK_ERROR");
+async function getWorkItemFieldValue(context, id, pat, fieldName) {
+  const url = `https://dev.azure.com/${context.org}/${context.project}/_apis/wit/workitems/${id}?api-version=7.1&fields=${fieldName}`;
+  const response = await fetchWithErrors(url, { headers: authHeaders(pat) });
+  if (!response.ok) {
+    throw new Error(`HTTP_${response.status}`);
   }
-  if (response.status === 401) throw new Error("AUTH_FAILED");
-  if (response.status === 403) throw new Error("PERMISSION_DENIED");
-  if (response.status === 404) throw new Error("NOT_FOUND");
+  const data = await response.json();
+  const value = data.fields[fieldName];
+  if (value === void 0 || value === null || value === "") {
+    return null;
+  }
+  return typeof value === "object" ? JSON.stringify(value) : `${value}`;
+}
+async function updateWorkItem(context, id, pat, fieldName, operations) {
+  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 response = await fetchWithErrors(url.toString(), {
+    method: "PATCH",
+    headers: {
+      ...authHeaders(pat),
+      "Content-Type": "application/json-patch+json"
+    },
+    body: JSON.stringify(operations)
+  });
   if (response.status === 400) {
     let serverMessage = "Unknown error";
     try {
@@ -166,6 +179,10 @@ async function deletePat() {
 }
 
 // src/services/auth.ts
+function normalizePat(rawPat) {
+  const trimmedPat = rawPat.trim();
+  return trimmedPat.length > 0 ? trimmedPat : null;
+}
 async function promptForPat() {
   if (!process.stdin.isTTY) {
     return null;
@@ -217,8 +234,11 @@ async function resolvePat() {
   }
   const promptedPat = await promptForPat();
   if (promptedPat !== null) {
-    await storePat(promptedPat);
-    return { pat: promptedPat, source: "prompt" };
+    const normalizedPat = normalizePat(promptedPat);
+    if (normalizedPat !== null) {
+      await storePat(normalizedPat);
+      return { pat: normalizedPat, source: "prompt" };
+    }
   }
   throw new Error(
     "Authentication cancelled. Set AZDO_PAT environment variable or run again to enter a PAT."
@@ -351,6 +371,86 @@ function unsetConfigValue(key) {
   saveConfig(config);
 }
 
+// src/services/context.ts
+function resolveContext(options) {
+  if (options.org && options.project) {
+    return { org: options.org, project: options.project };
+  }
+  const config = loadConfig();
+  if (config.org && config.project) {
+    return { org: config.org, project: config.project };
+  }
+  let gitContext = null;
+  try {
+    gitContext = detectAzdoContext();
+  } catch {
+  }
+  const org = config.org || gitContext?.org;
+  const project = config.project || gitContext?.project;
+  if (org && project) {
+    return { org, project };
+  }
+  throw new Error(
+    'Could not determine org/project. Use --org and --project flags, work from an Azure DevOps git repo, or run "azdo config set org/project".'
+  );
+}
+
+// src/services/command-helpers.ts
+function parseWorkItemId(idStr) {
+  const id = Number.parseInt(idStr, 10);
+  if (!Number.isInteger(id) || id <= 0) {
+    process.stderr.write(
+      `Error: Work item ID must be a positive integer. Got: "${idStr}"
+`
+    );
+    process.exit(1);
+  }
+  return id;
+}
+function validateOrgProjectPair(options) {
+  const hasOrg = options.org !== void 0;
+  const hasProject = options.project !== void 0;
+  if (hasOrg !== hasProject) {
+    process.stderr.write(
+      "Error: --org and --project must both be provided, or both omitted.\n"
+    );
+    process.exit(1);
+  }
+}
+function handleCommandError(err, id, context, scope = "write") {
+  const error = err instanceof Error ? err : new Error(String(err));
+  const msg = error.message;
+  const scopeLabel = scope === "read" ? "Work Items (read)" : "Work Items (Read & Write)";
+  if (msg === "AUTH_FAILED") {
+    process.stderr.write(
+      `Error: Authentication failed. Check that your PAT is valid and has the "${scopeLabel}" scope.
+`
+    );
+  } else if (msg === "PERMISSION_DENIED") {
+    process.stderr.write(
+      `Error: Access denied. Your PAT may lack ${scope} permissions for project "${context?.project}".
+`
+    );
+  } else if (msg === "NOT_FOUND") {
+    process.stderr.write(
+      `Error: Work item ${id} not found in ${context?.org}/${context?.project}.
+`
+    );
+  } else if (msg === "NETWORK_ERROR") {
+    process.stderr.write(
+      "Error: Could not connect to Azure DevOps. Check your network connection.\n"
+    );
+  } else if (msg.startsWith("UPDATE_REJECTED:")) {
+    const serverMsg = msg.replace("UPDATE_REJECTED: ", "");
+    process.stderr.write(`Error: Update rejected: ${serverMsg}
+`);
+  } else {
+    process.stderr.write(`Error: ${msg}
+`);
+  }
+  process.exit(1);
+}
+
 // src/commands/get-item.ts
 function stripHtml(html) {
   let text = html;
@@ -405,81 +505,18 @@ 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").action(
     async (idStr, options) => {
-      const id = parseInt(idStr, 10);
-      if (!Number.isInteger(id) || id <= 0) {
-        process.stderr.write(
-          `Error: Work item ID must be a positive integer. Got: "${idStr}"
-`
-        );
-        process.exit(1);
-      }
-      const hasOrg = options.org !== void 0;
-      const hasProject = options.project !== void 0;
-      if (hasOrg !== hasProject) {
-        process.stderr.write(
-          "Error: --org and --project must both be provided, or both omitted.\n"
-        );
-        process.exit(1);
-      }
+      const id = parseWorkItemId(idStr);
+      validateOrgProjectPair(options);
       let context;
       try {
-        if (options.org && options.project) {
-          context = { org: options.org, project: options.project };
-        } else {
-          const config = loadConfig();
-          if (config.org && config.project) {
-            context = { org: config.org, project: config.project };
-          } else {
-            let gitContext = null;
-            try {
-              gitContext = detectAzdoContext();
-            } catch {
-            }
-            const org = config.org || gitContext?.org;
-            const project = config.project || gitContext?.project;
-            if (org && project) {
-              context = { org, project };
-            } else {
-              throw new Error(
-                'Could not determine org/project. Use --org and --project flags, work from an Azure DevOps git repo, or run "azdo config set org/project".'
-              );
-            }
-          }
-        }
+        context = resolveContext(options);
         const credential = await resolvePat();
         const fieldsList = options.fields ? options.fields.split(",").map((f) => f.trim()) : loadConfig().fields;
         const workItem = await getWorkItem(context, id, credential.pat, fieldsList);
         const output = formatWorkItem(workItem, options.short ?? false);
         process.stdout.write(output + "\n");
       } catch (err) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        const msg = error.message;
-        if (msg === "AUTH_FAILED") {
-          process.stderr.write(
-            'Error: Authentication failed. Check that your PAT is valid and has the "Work Items (read)" scope.\n'
-          );
-        } else if (msg === "NOT_FOUND") {
-          process.stderr.write(
-            `Error: Work item ${id} not found in ${context.org}/${context.project}.
-`
-          );
-        } else if (msg === "PERMISSION_DENIED") {
-          process.stderr.write(
-            `Error: Access denied. Your PAT may lack permissions for project "${context.project}".
-`
-          );
-        } else if (msg === "NETWORK_ERROR") {
-          process.stderr.write(
-            "Error: Could not connect to Azure DevOps. Check your network connection.\n"
-          );
-        } else if (msg.includes("Not in a git repository") || msg.includes("is not an Azure DevOps URL") || msg.includes("Authentication cancelled")) {
-          process.stderr.write(`Error: ${msg}
-`);
-        } else {
-          process.stderr.write(`Error: ${msg}
-`);
-        }
-        process.exit(1);
+        handleCommandError(err, id, context, "read");
       }
     }
   );
@@ -652,48 +689,12 @@ function createConfigCommand() {
 
 // src/commands/set-state.ts
 import { Command as Command4 } from "commander";
-function resolveContext(options) {
-  if (options.org && options.project) {
-    return { org: options.org, project: options.project };
-  }
-  const config = loadConfig();
-  if (config.org && config.project) {
-    return { org: config.org, project: config.project };
-  }
-  let gitContext = null;
-  try {
-    gitContext = detectAzdoContext();
-  } catch {
-  }
-  const org = config.org || gitContext?.org;
-  const project = config.project || gitContext?.project;
-  if (org && project) {
-    return { org, project };
-  }
-  throw new Error(
-    'Could not determine org/project. Use --org and --project flags, work from an Azure DevOps git repo, or run "azdo config set org/project".'
-  );
-}
 function createSetStateCommand() {
   const command = new Command4("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 = parseInt(idStr, 10);
-      if (!Number.isInteger(id) || id <= 0) {
-        process.stderr.write(
-          `Error: Work item ID must be a positive integer. Got: "${idStr}"
-`
-        );
-        process.exit(1);
-      }
-      const hasOrg = options.org !== void 0;
-      const hasProject = options.project !== void 0;
-      if (hasOrg !== hasProject) {
-        process.stderr.write(
-          "Error: --org and --project must both be provided, or both omitted.\n"
-        );
-        process.exit(1);
-      }
+      const id = parseWorkItemId(idStr);
+      validateOrgProjectPair(options);
       let context;
       try {
         context = resolveContext(options);
@@ -717,35 +718,7 @@ function createSetStateCommand() {
 `);
         }
       } catch (err) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        const msg = error.message;
-        if (msg === "AUTH_FAILED") {
-          process.stderr.write(
-            'Error: Authentication failed. Check that your PAT is valid and has the "Work Items (Read & Write)" scope.\n'
-          );
-        } else if (msg === "PERMISSION_DENIED") {
-          process.stderr.write(
-            `Error: Access denied. Your PAT may lack write permissions for project "${context.project}".
-`
-          );
-        } else if (msg === "NOT_FOUND") {
-          process.stderr.write(
-            `Error: Work item ${id} not found in ${context.org}/${context.project}.
-`
-          );
-        } else if (msg.startsWith("UPDATE_REJECTED:")) {
-          const serverMsg = msg.replace("UPDATE_REJECTED: ", "");
-          process.stderr.write(`Error: Update rejected: ${serverMsg}
-`);
-        } else if (msg === "NETWORK_ERROR") {
-          process.stderr.write(
-            "Error: Could not connect to Azure DevOps. Check your network connection.\n"
-          );
-        } else {
-          process.stderr.write(`Error: ${msg}
-`);
-        }
-        process.exit(1);
+        handleCommandError(err, id, context, "write");
       }
     }
   );
@@ -754,40 +727,11 @@ function createSetStateCommand() {
 
 // src/commands/assign.ts
 import { Command as Command5 } from "commander";
-function resolveContext2(options) {
-  if (options.org && options.project) {
-    return { org: options.org, project: options.project };
-  }
-  const config = loadConfig();
-  if (config.org && config.project) {
-    return { org: config.org, project: config.project };
-  }
-  let gitContext = null;
-  try {
-    gitContext = detectAzdoContext();
-  } catch {
-  }
-  const org = config.org || gitContext?.org;
-  const project = config.project || gitContext?.project;
-  if (org && project) {
-    return { org, project };
-  }
-  throw new Error(
-    'Could not determine org/project. Use --org and --project flags, work from an Azure DevOps git repo, or run "azdo config set org/project".'
-  );
-}
 function createAssignCommand() {
   const command = new Command5("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 = parseInt(idStr, 10);
-      if (!Number.isInteger(id) || id <= 0) {
-        process.stderr.write(
-          `Error: Work item ID must be a positive integer. Got: "${idStr}"
-`
-        );
-        process.exit(1);
-      }
+      const id = parseWorkItemId(idStr);
       if (!name && !options.unassign) {
         process.stderr.write(
           "Error: Either provide a user name or use --unassign.\n"
@@ -800,17 +744,10 @@ function createAssignCommand() {
         );
         process.exit(1);
       }
-      const hasOrg = options.org !== void 0;
-      const hasProject = options.project !== void 0;
-      if (hasOrg !== hasProject) {
-        process.stderr.write(
-          "Error: --org and --project must both be provided, or both omitted.\n"
-        );
-        process.exit(1);
-      }
+      validateOrgProjectPair(options);
       let context;
       try {
-        context = resolveContext2(options);
+        context = resolveContext(options);
         const credential = await resolvePat();
         const value = options.unassign ? "" : name;
         const operations = [
@@ -833,35 +770,7 @@ function createAssignCommand() {
 `);
         }
       } catch (err) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        const msg = error.message;
-        if (msg === "AUTH_FAILED") {
-          process.stderr.write(
-            'Error: Authentication failed. Check that your PAT is valid and has the "Work Items (Read & Write)" scope.\n'
-          );
-        } else if (msg === "PERMISSION_DENIED") {
-          process.stderr.write(
-            `Error: Access denied. Your PAT may lack write permissions for project "${context.project}".
-`
-          );
-        } else if (msg === "NOT_FOUND") {
-          process.stderr.write(
-            `Error: Work item ${id} not found in ${context.org}/${context.project}.
-`
-          );
-        } else if (msg.startsWith("UPDATE_REJECTED:")) {
-          const serverMsg = msg.replace("UPDATE_REJECTED: ", "");
-          process.stderr.write(`Error: Update rejected: ${serverMsg}
-`);
-        } else if (msg === "NETWORK_ERROR") {
-          process.stderr.write(
-            "Error: Could not connect to Azure DevOps. Check your network connection.\n"
-          );
-        } else {
-          process.stderr.write(`Error: ${msg}
-`);
-        }
-        process.exit(1);
+        handleCommandError(err, id, context, "write");
       }
     }
   );
@@ -870,51 +779,15 @@ function createAssignCommand() {
 
 // src/commands/set-field.ts
 import { Command as Command6 } from "commander";
-function resolveContext3(options) {
-  if (options.org && options.project) {
-    return { org: options.org, project: options.project };
-  }
-  const config = loadConfig();
-  if (config.org && config.project) {
-    return { org: config.org, project: config.project };
-  }
-  let gitContext = null;
-  try {
-    gitContext = detectAzdoContext();
-  } catch {
-  }
-  const org = config.org || gitContext?.org;
-  const project = config.project || gitContext?.project;
-  if (org && project) {
-    return { org, project };
-  }
-  throw new Error(
-    'Could not determine org/project. Use --org and --project flags, work from an Azure DevOps git repo, or run "azdo config set org/project".'
-  );
-}
 function createSetFieldCommand() {
   const command = new Command6("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 = parseInt(idStr, 10);
-      if (!Number.isInteger(id) || id <= 0) {
-        process.stderr.write(
-          `Error: Work item ID must be a positive integer. Got: "${idStr}"
-`
-        );
-        process.exit(1);
-      }
-      const hasOrg = options.org !== void 0;
-      const hasProject = options.project !== void 0;
-      if (hasOrg !== hasProject) {
-        process.stderr.write(
-          "Error: --org and --project must both be provided, or both omitted.\n"
-        );
-        process.exit(1);
-      }
+      const id = parseWorkItemId(idStr);
+      validateOrgProjectPair(options);
       let context;
       try {
-        context = resolveContext3(options);
+        context = resolveContext(options);
         const credential = await resolvePat();
         const operations = [
           { op: "add", path: `/fields/${field}`, value }
@@ -935,35 +808,178 @@ function createSetFieldCommand() {
 `);
         }
       } catch (err) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        const msg = error.message;
-        if (msg === "AUTH_FAILED") {
-          process.stderr.write(
-            'Error: Authentication failed. Check that your PAT is valid and has the "Work Items (Read & Write)" scope.\n'
-          );
-        } else if (msg === "PERMISSION_DENIED") {
-          process.stderr.write(
-            `Error: Access denied. Your PAT may lack write permissions for project "${context.project}".
-`
-          );
-        } else if (msg === "NOT_FOUND") {
-          process.stderr.write(
-            `Error: Work item ${id} not found in ${context.org}/${context.project}.
-`
-          );
-        } else if (msg.startsWith("UPDATE_REJECTED:")) {
-          const serverMsg = msg.replace("UPDATE_REJECTED: ", "");
-          process.stderr.write(`Error: Update rejected: ${serverMsg}
-`);
-        } else if (msg === "NETWORK_ERROR") {
-          process.stderr.write(
-            "Error: Could not connect to Azure DevOps. Check your network connection.\n"
-          );
+        handleCommandError(err, id, context, "write");
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/get-md-field.ts
+import { Command as Command7 } from "commander";
+
+// src/services/md-convert.ts
+import { NodeHtmlMarkdown } from "node-html-markdown";
+
+// src/services/html-detect.ts
+var HTML_TAG_REGEX = /<\/?([a-z][a-z0-9]*)\b/gi;
+var HTML_TAGS = /* @__PURE__ */ new Set([
+  "p",
+  "br",
+  "div",
+  "span",
+  "strong",
+  "em",
+  "b",
+  "i",
+  "u",
+  "a",
+  "ul",
+  "ol",
+  "li",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "table",
+  "tr",
+  "td",
+  "th",
+  "img",
+  "pre",
+  "code"
+]);
+function isHtml(content) {
+  let match;
+  HTML_TAG_REGEX.lastIndex = 0;
+  while ((match = HTML_TAG_REGEX.exec(content)) !== null) {
+    if (HTML_TAGS.has(match[1].toLowerCase())) {
+      return true;
+    }
+  }
+  return false;
+}
+
+// src/services/md-convert.ts
+function htmlToMarkdown(html) {
+  return NodeHtmlMarkdown.translate(html);
+}
+function toMarkdown(content) {
+  if (isHtml(content)) {
+    return htmlToMarkdown(content);
+  }
+  return content;
+}
+
+// src/commands/get-md-field.ts
+function createGetMdFieldCommand() {
+  const command = new Command7("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").action(
+    async (idStr, field, options) => {
+      const id = parseWorkItemId(idStr);
+      validateOrgProjectPair(options);
+      let context;
+      try {
+        context = resolveContext(options);
+        const credential = await resolvePat();
+        const value = await getWorkItemFieldValue(context, id, credential.pat, field);
+        if (value === null) {
+          process.stdout.write("\n");
         } else {
-          process.stderr.write(`Error: ${msg}
-`);
+          process.stdout.write(toMarkdown(value) + "\n");
         }
-        process.exit(1);
+      } catch (err) {
+        handleCommandError(err, id, context, "read");
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/set-md-field.ts
+import { existsSync, readFileSync as readFileSync2 } from "fs";
+import { Command as Command8 } from "commander";
+function fail(message) {
+  process.stderr.write(`Error: ${message}
+`);
+  process.exit(1);
+}
+function resolveContent(inlineContent, options) {
+  if (inlineContent && options.file) {
+    fail("Cannot specify both inline content and --file.");
+  }
+  if (options.file) {
+    return readFileContent(options.file);
+  }
+  if (inlineContent) {
+    return inlineContent;
+  }
+  return null;
+}
+function readFileContent(filePath) {
+  if (!existsSync(filePath)) {
+    fail(`File not found: ${filePath}`);
+  }
+  try {
+    return readFileSync2(filePath, "utf-8");
+  } catch {
+    fail(`Cannot read file: ${filePath}`);
+  }
+}
+async function readStdinContent() {
+  if (process.stdin.isTTY) {
+    fail(
+      "No content provided. Pass markdown content as the third argument, use --file, or pipe via stdin."
+    );
+  }
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  const stdinContent = Buffer.concat(chunks).toString("utf-8").trimEnd();
+  if (!stdinContent) {
+    fail(
+      "No content provided via stdin. Pipe markdown content or use inline content or --file."
+    );
+  }
+  return stdinContent;
+}
+function formatOutput(result, options, field) {
+  if (options.json) {
+    process.stdout.write(
+      JSON.stringify({
+        id: result.id,
+        rev: result.rev,
+        field: result.fieldName,
+        value: result.fieldValue
+      }) + "\n"
+    );
+  } else {
+    process.stdout.write(`Updated work item ${result.id}: ${field} set with markdown content
+`);
+  }
+}
+function createSetMdFieldCommand() {
+  const command = new Command8("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);
+      validateOrgProjectPair(options);
+      const content = resolveContent(inlineContent, options) ?? await readStdinContent();
+      let context;
+      try {
+        context = resolveContext(options);
+        const credential = await resolvePat();
+        const operations = [
+          { op: "add", path: `/fields/${field}`, value: content },
+          { op: "add", path: `/multilineFieldsFormat/${field}`, value: "Markdown" }
+        ];
+        const result = await updateWorkItem(context, id, credential.pat, field, operations);
+        formatOutput(result, options, field);
+      } catch (err) {
+        handleCommandError(err, id, context, "write");
       }
     }
   );
@@ -971,7 +987,7 @@ function createSetFieldCommand() {
 }
 
 // src/index.ts
-var program = new Command7();
+var program = new Command9();
 program.name("azdo").description("Azure DevOps CLI tool").version(version, "-v, --version");
 program.addCommand(createGetItemCommand());
 program.addCommand(createClearPatCommand());
@@ -979,6 +995,8 @@ program.addCommand(createConfigCommand());
 program.addCommand(createSetStateCommand());
 program.addCommand(createAssignCommand());
 program.addCommand(createSetFieldCommand());
+program.addCommand(createGetMdFieldCommand());
+program.addCommand(createSetMdFieldCommand());
 program.showHelpAfterError();
 program.parse();
 if (process.argv.length <= 2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.2.0-develop.24",
+  "version": "0.2.0-develop.47",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {
@@ -23,7 +23,8 @@
   "license": "MIT",
   "dependencies": {
     "@napi-rs/keyring": "^1.2.0",
-    "commander": "^14.0.3"
+    "commander": "^14.0.3",
+    "node-html-markdown": "^2.0.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",