azdo-cli 0.2.0-develop.14 → 0.2.0-develop.141

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command3 } from "commander";
+import { Command as Command12 } from "commander";
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -15,22 +15,138 @@ var version = pkg.version;
 import { Command } from "commander";
 
 // src/services/azdo-client.ts
-async function getWorkItem(context, id, pat) {
-  const url = `https://dev.azure.com/${context.org}/${context.project}/_apis/wit/workitems/${id}?api-version=7.1`;
+var DEFAULT_FIELDS = [
+  "System.Title",
+  "System.State",
+  "System.WorkItemType",
+  "System.AssignedTo",
+  "System.Description",
+  "Microsoft.VSTS.Common.AcceptanceCriteria",
+  "Microsoft.VSTS.TCM.ReproSteps",
+  "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, {
-      headers: {
-        Authorization: `Basic ${token}`
-      }
-    });
+    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");
+  if (response.status === 404) {
+    let detail = "";
+    try {
+      const body = await response.text();
+      detail = ` | url=${url} | body=${body}`;
+    } catch {
+    }
+    throw new Error(`NOT_FOUND${detail}`);
+  }
+  return response;
+}
+async function readResponseMessage(response) {
+  try {
+    const body = await response.json();
+    if (typeof body.message === "string" && body.message.trim() !== "") {
+      return body.message.trim();
+    }
+  } catch {
+  }
+  return null;
+}
+function normalizeFieldList(fields) {
+  return Array.from(new Set(fields.map((f) => f.trim()).filter((f) => f.length > 0)));
+}
+function stringifyFieldValue(value) {
+  if (typeof value === "object" && value !== null) {
+    return JSON.stringify(value);
+  }
+  return String(value);
+}
+function buildExtraFields(fields, requested) {
+  const result = {};
+  for (const name of requested) {
+    let val = fields[name];
+    let resolvedName = name;
+    if (val === void 0) {
+      const nameSuffix = name.split(".").pop().toLowerCase();
+      const match = Object.keys(fields).find(
+        (k) => k.split(".").pop().toLowerCase() === nameSuffix
+      );
+      if (match !== void 0) {
+        val = fields[match];
+        resolvedName = match;
+      }
+    }
+    if (val !== void 0 && val !== null) {
+      result[resolvedName] = stringifyFieldValue(val);
+    }
+  }
+  return Object.keys(result).length > 0 ? result : null;
+}
+function writeHeaders(pat) {
+  return {
+    ...authHeaders(pat),
+    "Content-Type": "application/json-patch+json"
+  };
+}
+async function readWriteResponse(response, errorCode) {
+  if (response.status === 400) {
+    const serverMessage = await readResponseMessage(response) ?? "Unknown error";
+    throw new Error(`${errorCode}: ${serverMessage}`);
+  }
+  if (!response.ok) {
+    throw new Error(`HTTP_${response.status}`);
+  }
+  const data = await response.json();
+  return {
+    id: data.id,
+    rev: data.rev,
+    fields: data.fields
+  };
+}
+async function getWorkItemFields(context, id, pat) {
+  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");
+  url.searchParams.set("$expand", "all");
+  const response = await fetchWithErrors(url.toString(), { headers: authHeaders(pat) });
+  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}`);
+  }
+  const data = await response.json();
+  return data.fields;
+}
+async function getWorkItem(context, id, pat, extraFields) {
+  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(","));
+  }
+  const response = await fetchWithErrors(url.toString(), { headers: authHeaders(pat) });
+  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}`);
   }
@@ -47,7 +163,7 @@ async function getWorkItem(context, id, pat) {
   }
   let combinedDescription = null;
   if (descriptionParts.length === 1) {
-    combinedDescription = descriptionParts[0].value;
+    combinedDescription = descriptionParts.at(0)?.value ?? null;
   } else if (descriptionParts.length > 1) {
     combinedDescription = descriptionParts.map((p) => `<h3>${p.label}</h3>${p.value}`).join("");
   }
@@ -61,9 +177,70 @@ async function getWorkItem(context, id, pat) {
     description: combinedDescription,
     areaPath: data.fields["System.AreaPath"],
     iterationPath: data.fields["System.IterationPath"],
-    url: data._links.html.href
+    url: data._links.html.href,
+    extraFields: normalizedExtraFields.length > 0 ? buildExtraFields(data.fields, normalizedExtraFields) : null
+  };
+}
+async function getWorkItemFieldValue(context, id, pat, fieldName) {
+  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");
+  url.searchParams.set("fields", fieldName);
+  const response = await fetchWithErrors(url.toString(), { headers: authHeaders(pat) });
+  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}`);
+  }
+  const data = await response.json();
+  const value = data.fields[fieldName];
+  if (value === void 0 || value === null || value === "") {
+    return null;
+  }
+  return stringifyFieldValue(value);
+}
+async function updateWorkItem(context, id, pat, fieldName, operations) {
+  const result = await applyWorkItemPatch(context, id, pat, operations);
+  const title = result.fields["System.Title"];
+  const lastOp = operations.at(-1);
+  const fieldValue = lastOp?.value ?? null;
+  return {
+    id: result.id,
+    rev: result.rev,
+    title: typeof title === "string" ? title : "",
+    fieldName,
+    fieldValue
   };
 }
+async function createWorkItem(context, workItemType, pat, operations) {
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/workitems/$${encodeURIComponent(workItemType)}`
+  );
+  url.searchParams.set("api-version", "7.1");
+  const response = await fetchWithErrors(url.toString(), {
+    method: "POST",
+    headers: writeHeaders(pat),
+    body: JSON.stringify(operations)
+  });
+  return readWriteResponse(response, "CREATE_REJECTED");
+}
+async function applyWorkItemPatch(context, id, pat, 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: writeHeaders(pat),
+    body: JSON.stringify(operations)
+  });
+  return readWriteResponse(response, "UPDATE_REJECTED");
+}
 
 // src/services/auth.ts
 import { createInterface } from "readline";
@@ -98,6 +275,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;
@@ -149,8 +330,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."
@@ -161,21 +345,25 @@ async function resolvePat() {
 import { execSync } from "child_process";
 var patterns = [
   // HTTPS (current): https://dev.azure.com/{org}/{project}/_git/{repo}
-  /^https?:\/\/dev\.azure\.com\/([^/]+)\/([^/]+)\/_git\/.+$/,
+  /^https?:\/\/dev\.azure\.com\/([^/]+)\/([^/]+)\/_git\/([^/]+)$/,
   // HTTPS (legacy + DefaultCollection): https://{org}.visualstudio.com/DefaultCollection/{project}/_git/{repo}
-  /^https?:\/\/([^.]+)\.visualstudio\.com\/DefaultCollection\/([^/]+)\/_git\/.+$/,
+  /^https?:\/\/([^.]+)\.visualstudio\.com\/DefaultCollection\/([^/]+)\/_git\/([^/]+)$/,
   // HTTPS (legacy): https://{org}.visualstudio.com/{project}/_git/{repo}
-  /^https?:\/\/([^.]+)\.visualstudio\.com\/([^/]+)\/_git\/.+$/,
+  /^https?:\/\/([^.]+)\.visualstudio\.com\/([^/]+)\/_git\/([^/]+)$/,
   // SSH (current): git@ssh.dev.azure.com:v3/{org}/{project}/{repo}
-  /^git@ssh\.dev\.azure\.com:v3\/([^/]+)\/([^/]+)\/.+$/,
+  /^git@ssh\.dev\.azure\.com:v3\/([^/]+)\/([^/]+)\/([^/]+)$/,
   // SSH (legacy): {org}@vs-ssh.visualstudio.com:v3/{org}/{project}/{repo}
-  /^[^@]+@vs-ssh\.visualstudio\.com:v3\/([^/]+)\/([^/]+)\/.+$/
+  /^[^@]+@vs-ssh\.visualstudio\.com:v3\/([^/]+)\/([^/]+)\/([^/]+)$/
 ];
 function parseAzdoRemote(url) {
   for (const pattern of patterns) {
-    const match = url.match(pattern);
+    const match = pattern.exec(url);
     if (match) {
-      return { org: match[1], project: match[2] };
+      const project = match[2];
+      if (/^DefaultCollection$/i.test(project)) {
+        return { org: match[1], project: "" };
+      }
+      return { org: match[1], project };
     }
   }
   return null;
@@ -188,116 +376,388 @@ function detectAzdoContext() {
     throw new Error("Not in a git repository. Provide --org and --project explicitly.");
   }
   const context = parseAzdoRemote(remoteUrl);
-  if (!context) {
+  if (!context || !context.org && !context.project) {
     throw new Error('Git remote "origin" is not an Azure DevOps URL. Provide --org and --project explicitly.');
   }
   return context;
 }
+function parseRepoName(url) {
+  for (const pattern of patterns) {
+    const match = pattern.exec(url);
+    if (match) {
+      return match[3];
+    }
+  }
+  return null;
+}
+function detectRepoName() {
+  let remoteUrl;
+  try {
+    remoteUrl = execSync("git remote get-url origin", { encoding: "utf-8" }).trim();
+  } catch {
+    throw new Error('Not in a git repository. Check that git remote "origin" exists and try again.');
+  }
+  const repo = parseRepoName(remoteUrl);
+  if (!repo) {
+    throw new Error('Git remote "origin" is not an Azure DevOps URL. Check that origin points to Azure DevOps and try again.');
+  }
+  return repo;
+}
+function getCurrentBranch() {
+  const branch = execSync("git rev-parse --abbrev-ref HEAD", { encoding: "utf-8" }).trim();
+  if (branch === "HEAD") {
+    throw new Error("Not on a named branch. Check out a named branch and try again.");
+  }
+  return branch;
+}
+
+// src/services/config-store.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
+var SETTINGS = [
+  {
+    key: "org",
+    description: "Azure DevOps organization name",
+    type: "string",
+    example: "mycompany",
+    required: true
+  },
+  {
+    key: "project",
+    description: "Azure DevOps project name",
+    type: "string",
+    example: "MyProject",
+    required: true
+  },
+  {
+    key: "fields",
+    description: "Extra work item fields to include (comma-separated reference names)",
+    type: "string[]",
+    example: "System.Tags,Custom.Priority",
+    required: false
+  },
+  {
+    key: "markdown",
+    description: "Convert rich text fields to markdown on display",
+    type: "boolean",
+    example: "true",
+    required: false
+  }
+];
+var VALID_KEYS = SETTINGS.map((s) => s.key);
+function getConfigPath() {
+  return path.join(os.homedir(), ".azdo", "config.json");
+}
+function loadConfig() {
+  const configPath = getConfigPath();
+  let raw;
+  try {
+    raw = fs.readFileSync(configPath, "utf-8");
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      return {};
+    }
+    throw err;
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    process.stderr.write(`Warning: Config file ${configPath} contains invalid JSON. Using defaults.
+`);
+    return {};
+  }
+}
+function saveConfig(config) {
+  const configPath = getConfigPath();
+  const dir = path.dirname(configPath);
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+}
+function validateKey(key) {
+  if (!VALID_KEYS.includes(key)) {
+    throw new Error(`Unknown setting key "${key}". Valid keys: ${VALID_KEYS.join(", ")}`);
+  }
+}
+function getConfigValue(key) {
+  validateKey(key);
+  const config = loadConfig();
+  return config[key];
+}
+function setConfigValue(key, value) {
+  validateKey(key);
+  const config = loadConfig();
+  if (value === "") {
+    delete config[key];
+  } else if (key === "markdown") {
+    if (value !== "true" && value !== "false") {
+      throw new Error(`Invalid value "${value}" for markdown. Must be "true" or "false".`);
+    }
+    config.markdown = value === "true";
+  } else if (key === "fields") {
+    config.fields = value.split(",").map((s) => s.trim());
+  } else {
+    config[key] = value;
+  }
+  saveConfig(config);
+}
+function unsetConfigValue(key) {
+  validateKey(key);
+  const config = loadConfig();
+  delete config[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/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/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 validateSource(options) {
+  const hasContent = options.content !== void 0;
+  const hasFile = options.file !== void 0;
+  if (hasContent === hasFile) {
+    process.stderr.write("Error: provide exactly one of --content or --file\n");
+    process.exit(1);
+  }
+}
+function formatCreateError(err) {
+  const error = err instanceof Error ? err : new Error(String(err));
+  const message = error.message.startsWith("CREATE_REJECTED:") ? error.message.replace("CREATE_REJECTED:", "").trim() : error.message;
+  const requiredMatches = [...message.matchAll(/field ['"]([^'"]+)['"]/gi)];
+  if (requiredMatches.length > 0) {
+    const fields = Array.from(new Set(requiredMatches.map((match) => match[1])));
+    return `Create rejected: ${message} (fields: ${fields.join(", ")})`;
+  }
+  return `Create rejected: ${message}`;
+}
+function handleCommandError(err, id, context, scope = "write", exit = true) {
+  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.startsWith("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("BAD_REQUEST:")) {
+    const serverMsg = msg.replace("BAD_REQUEST: ", "");
+    process.stderr.write(`Error: Request rejected: ${serverMsg}
+`);
+  } else if (msg.startsWith("CREATE_REJECTED:")) {
+    process.stderr.write(`Error: ${formatCreateError(error)}
+`);
+  } 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}
+`);
+  }
+  if (exit) {
+    process.exit(1);
+  } else {
+    process.exitCode = 1;
+  }
+}
 
 // src/commands/get-item.ts
+function parseRequestedFields(raw) {
+  if (raw === void 0) return void 0;
+  const source = Array.isArray(raw) ? raw : [raw];
+  const tokens = source.flatMap((entry) => entry.split(/[,\s]+/)).map((field) => field.trim()).filter((field) => field.length > 0);
+  if (tokens.length === 0) return void 0;
+  return Array.from(new Set(tokens));
+}
 function stripHtml(html) {
   let text = html;
-  text = text.replace(/<h[1-6][^>]*>(.*?)<\/h[1-6]>/gi, "\n--- $1 ---\n");
-  text = text.replace(/<br\s*\/?>/gi, "\n");
-  text = text.replace(/<\/?(p|div)>/gi, "\n");
-  text = text.replace(/<li>/gi, "\n");
-  text = text.replace(/<[^>]*>/g, "");
-  text = text.replace(/&amp;/g, "&");
-  text = text.replace(/&lt;/g, "<");
-  text = text.replace(/&gt;/g, ">");
-  text = text.replace(/&quot;/g, '"');
-  text = text.replace(/&#39;/g, "'");
-  text = text.replace(/&nbsp;/g, " ");
-  text = text.replace(/\n{3,}/g, "\n\n");
+  text = text.replaceAll(/<h[1-6][^>]*>(.*?)<\/h[1-6]>/gi, "\n--- $1 ---\n");
+  text = text.replaceAll(/<br\s*\/?>/gi, "\n");
+  text = text.replaceAll(/<\/?(p|div)>/gi, "\n");
+  text = text.replaceAll(/<li>/gi, "\n");
+  text = text.replaceAll(/<[^>]*>/g, "");
+  text = text.replaceAll("&amp;", "&");
+  text = text.replaceAll("&lt;", "<");
+  text = text.replaceAll("&gt;", ">");
+  text = text.replaceAll("&quot;", '"');
+  text = text.replaceAll("&#39;", "'");
+  text = text.replaceAll("&nbsp;", " ");
+  text = text.replaceAll(/\n{3,}/g, "\n\n");
   return text.trim();
 }
-function formatWorkItem(workItem, short) {
-  const lines = [];
+function convertRichText(html, markdown) {
+  if (!html) return "";
+  return markdown ? toMarkdown(html) : stripHtml(html);
+}
+function formatExtraFields(extraFields, markdown) {
+  return Object.entries(extraFields).map(([refName, value]) => {
+    const fieldLabel = refName.includes(".") ? refName.split(".").pop() : refName;
+    const displayValue = markdown ? toMarkdown(value) : value;
+    return `${fieldLabel.padEnd(13)}${displayValue}`;
+  });
+}
+function summarizeDescription(text, label) {
+  const descLines = text.split("\n").filter((l) => l.trim() !== "");
+  const firstThree = descLines.slice(0, 3);
+  const suffix = descLines.length > 3 ? "\n..." : "";
+  return [`${label("Description:")}${firstThree.join("\n")}${suffix}`];
+}
+function formatWorkItem(workItem, short, markdown = false) {
   const label = (name) => name.padEnd(13);
-  lines.push(`${label("ID:")}${workItem.id}`);
-  lines.push(`${label("Type:")}${workItem.type}`);
-  lines.push(`${label("Title:")}${workItem.title}`);
-  lines.push(`${label("State:")}${workItem.state}`);
-  lines.push(`${label("Assigned To:")}${workItem.assignedTo ?? "Unassigned"}`);
+  const lines = [
+    `${label("ID:")}${workItem.id}`,
+    `${label("Type:")}${workItem.type}`,
+    `${label("Title:")}${workItem.title}`,
+    `${label("State:")}${workItem.state}`,
+    `${label("Assigned To:")}${workItem.assignedTo ?? "Unassigned"}`
+  ];
   if (!short) {
-    lines.push(`${label("Area:")}${workItem.areaPath}`);
-    lines.push(`${label("Iteration:")}${workItem.iterationPath}`);
+    lines.push(
+      `${label("Area:")}${workItem.areaPath}`,
+      `${label("Iteration:")}${workItem.iterationPath}`
+    );
   }
   lines.push(`${label("URL:")}${workItem.url}`);
+  if (workItem.extraFields) {
+    lines.push(...formatExtraFields(workItem.extraFields, markdown));
+  }
   lines.push("");
-  const descriptionText = workItem.description ? stripHtml(workItem.description) : "";
+  const descriptionText = convertRichText(workItem.description, markdown);
   if (short) {
-    const descLines = descriptionText.split("\n").filter((l) => l.trim() !== "");
-    const firstThree = descLines.slice(0, 3);
-    const truncated = descLines.length > 3;
-    const descSummary = firstThree.join("\n") + (truncated ? "\n..." : "");
-    lines.push(`${label("Description:")}${descSummary}`);
+    lines.push(...summarizeDescription(descriptionText, label));
   } else {
-    lines.push("Description:");
-    lines.push(descriptionText);
+    lines.push("Description:", descriptionText);
   }
   return lines.join("\n");
 }
 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").action(
+  command.description("Retrieve an Azure DevOps work item by ID").argument("<id>", "work item ID").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--short", "show abbreviated output").option("--fields <fields>", "comma-separated additional field reference names").option("--markdown", "convert rich text fields to markdown").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 {
-          context = detectAzdoContext();
-        }
+        context = resolveContext(options);
         const credential = await resolvePat();
-        const workItem = await getWorkItem(context, id, credential.pat);
-        const output = formatWorkItem(workItem, options.short ?? false);
+        const fieldsList = options.fields === void 0 ? parseRequestedFields(loadConfig().fields) : parseRequestedFields(options.fields);
+        const workItem = await getWorkItem(context, id, credential.pat, fieldsList);
+        const markdownEnabled = options.markdown ?? loadConfig().markdown ?? false;
+        const output = formatWorkItem(workItem, options.short ?? false, markdownEnabled);
         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", false);
       }
     }
   );
@@ -319,11 +779,1121 @@ function createClearPatCommand() {
   return command;
 }
 
+// src/commands/config.ts
+import { Command as Command3 } from "commander";
+import { createInterface as createInterface2 } from "readline";
+function formatConfigValue(value, unsetFallback = "") {
+  if (value === void 0) {
+    return unsetFallback;
+  }
+  return Array.isArray(value) ? value.join(",") : value;
+}
+function writeConfigList(cfg) {
+  const keyWidth = 10;
+  const valueWidth = 30;
+  for (const setting of SETTINGS) {
+    const raw = cfg[setting.key];
+    const value = formatConfigValue(raw, "(not set)");
+    const marker = raw === void 0 && setting.required ? " *" : "";
+    process.stdout.write(
+      `${setting.key.padEnd(keyWidth)}${String(value).padEnd(valueWidth)}${setting.description}${marker}
+`
+    );
+  }
+  const hasUnset = SETTINGS.some((s) => s.required && cfg[s.key] === void 0);
+  if (hasUnset) {
+    process.stdout.write(
+      '\n* = required but not configured. Run "azdo config wizard" to set up.\n'
+    );
+  }
+}
+function createAsk(rl) {
+  return (prompt) => new Promise((resolve2) => rl.question(prompt, resolve2));
+}
+async function promptForSetting(cfg, setting, ask) {
+  const currentDisplay = String(formatConfigValue(cfg[setting.key], ""));
+  const requiredTag = setting.required ? " (required)" : " (optional)";
+  process.stderr.write(`${setting.description}${requiredTag}
+`);
+  if (setting.example) {
+    process.stderr.write(`  Example: ${setting.example}
+`);
+  }
+  const defaultHint = currentDisplay ? ` [${currentDisplay}]` : "";
+  const answer = await ask(`  ${setting.key}${defaultHint}: `);
+  const trimmed = answer.trim();
+  if (trimmed) {
+    setConfigValue(setting.key, trimmed);
+    process.stderr.write(`  -> Set "${setting.key}" to "${trimmed}"
+
+`);
+    return;
+  }
+  if (currentDisplay) {
+    process.stderr.write(`  -> Kept "${setting.key}" as "${currentDisplay}"
+
+`);
+    return;
+  }
+  process.stderr.write(`  -> Skipped "${setting.key}"
+
+`);
+}
+function createConfigCommand() {
+  const config = new Command3("config");
+  config.description("Manage CLI settings");
+  const set = new Command3("set");
+  set.description("Set a configuration value").argument("<key>", "setting key (org, project, fields)").argument("<value>", "setting value").option("--json", "output in JSON format").action((key, value, options) => {
+    try {
+      setConfigValue(key, value);
+      if (options.json) {
+        const output = { key, value };
+        if (key === "fields") {
+          output.value = value.split(",").map((s) => s.trim());
+        }
+        process.stdout.write(JSON.stringify(output) + "\n");
+      } else {
+        process.stdout.write(`Set "${key}" to "${value}"
+`);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`Error: ${message}
+`);
+      process.exit(1);
+    }
+  });
+  const get = new Command3("get");
+  get.description("Get a configuration value").argument("<key>", "setting key (org, project, fields)").option("--json", "output in JSON format").action((key, options) => {
+    try {
+      const value = getConfigValue(key);
+      if (options.json) {
+        process.stdout.write(
+          JSON.stringify({ key, value: value ?? null }) + "\n"
+        );
+      } else if (value === void 0) {
+        process.stdout.write(`Setting "${key}" is not configured.
+`);
+      } else if (Array.isArray(value)) {
+        process.stdout.write(value.join(",") + "\n");
+      } else {
+        process.stdout.write(value + "\n");
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`Error: ${message}
+`);
+      process.exit(1);
+    }
+  });
+  const list = new Command3("list");
+  list.description("List all configuration values").option("--json", "output in JSON format").action((options) => {
+    const cfg = loadConfig();
+    if (options.json) {
+      process.stdout.write(JSON.stringify(cfg) + "\n");
+      return;
+    }
+    writeConfigList(cfg);
+  });
+  const unset = new Command3("unset");
+  unset.description("Remove a configuration value").argument("<key>", "setting key (org, project, fields)").option("--json", "output in JSON format").action((key, options) => {
+    try {
+      unsetConfigValue(key);
+      if (options.json) {
+        process.stdout.write(JSON.stringify({ key, unset: true }) + "\n");
+      } else {
+        process.stdout.write(`Unset "${key}"
+`);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`Error: ${message}
+`);
+      process.exit(1);
+    }
+  });
+  const wizard = new Command3("wizard");
+  wizard.description("Interactive wizard to configure all settings").action(async () => {
+    if (!process.stdin.isTTY) {
+      process.stderr.write(
+        "Error: Wizard requires an interactive terminal.\n"
+      );
+      process.exit(1);
+    }
+    const cfg = loadConfig();
+    const rl = createInterface2({
+      input: process.stdin,
+      output: process.stderr
+    });
+    const ask = createAsk(rl);
+    process.stderr.write("Azure DevOps CLI - Configuration Wizard\n");
+    process.stderr.write("=======================================\n\n");
+    for (const setting of SETTINGS) {
+      await promptForSetting(cfg, setting, ask);
+    }
+    rl.close();
+    process.stderr.write("Configuration complete!\n");
+  });
+  config.addCommand(set);
+  config.addCommand(get);
+  config.addCommand(list);
+  config.addCommand(unset);
+  config.addCommand(wizard);
+  return config;
+}
+
+// src/commands/set-state.ts
+import { Command as Command4 } from "commander";
+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 = parseWorkItemId(idStr);
+      validateOrgProjectPair(options);
+      let context;
+      try {
+        context = resolveContext(options);
+        const credential = await resolvePat();
+        const operations = [
+          { op: "add", path: "/fields/System.State", value: state }
+        ];
+        const result = await updateWorkItem(context, id, credential.pat, "System.State", operations);
+        if (options.json) {
+          process.stdout.write(
+            JSON.stringify({
+              id: result.id,
+              rev: result.rev,
+              title: result.title,
+              field: result.fieldName,
+              value: result.fieldValue
+            }) + "\n"
+          );
+        } else {
+          process.stdout.write(`Updated work item ${result.id}: State -> ${state}
+`);
+        }
+      } catch (err) {
+        handleCommandError(err, id, context, "write");
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/assign.ts
+import { Command as Command5 } from "commander";
+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 = parseWorkItemId(idStr);
+      if (!name && !options.unassign) {
+        process.stderr.write(
+          "Error: Either provide a user name or use --unassign.\n"
+        );
+        process.exit(1);
+      }
+      if (name && options.unassign) {
+        process.stderr.write(
+          "Error: Cannot provide both a user name and --unassign.\n"
+        );
+        process.exit(1);
+      }
+      validateOrgProjectPair(options);
+      let context;
+      try {
+        context = resolveContext(options);
+        const credential = await resolvePat();
+        const value = options.unassign ? "" : name;
+        const operations = [
+          { op: "add", path: "/fields/System.AssignedTo", value }
+        ];
+        const result = await updateWorkItem(context, id, credential.pat, "System.AssignedTo", operations);
+        if (options.json) {
+          process.stdout.write(
+            JSON.stringify({
+              id: result.id,
+              rev: result.rev,
+              title: result.title,
+              field: result.fieldName,
+              value: result.fieldValue
+            }) + "\n"
+          );
+        } else {
+          const displayValue = options.unassign ? "(unassigned)" : name;
+          process.stdout.write(`Updated work item ${result.id}: Assigned To -> ${displayValue}
+`);
+        }
+      } catch (err) {
+        handleCommandError(err, id, context, "write");
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/set-field.ts
+import { Command as Command6 } from "commander";
+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 = parseWorkItemId(idStr);
+      validateOrgProjectPair(options);
+      let context;
+      try {
+        context = resolveContext(options);
+        const credential = await resolvePat();
+        const operations = [
+          { op: "add", path: `/fields/${field}`, value }
+        ];
+        const result = await updateWorkItem(context, id, credential.pat, field, operations);
+        if (options.json) {
+          process.stdout.write(
+            JSON.stringify({
+              id: result.id,
+              rev: result.rev,
+              title: result.title,
+              field: result.fieldName,
+              value: result.fieldValue
+            }) + "\n"
+          );
+        } else {
+          process.stdout.write(`Updated work item ${result.id}: ${field} -> ${value}
+`);
+        }
+      } catch (err) {
+        handleCommandError(err, id, context, "write");
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/get-md-field.ts
+import { Command as Command7 } from "commander";
+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.stdout.write(toMarkdown(value) + "\n");
+        }
+      } 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");
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/upsert.ts
+import { existsSync as existsSync2, readFileSync as readFileSync3, unlinkSync } from "fs";
+import { Command as Command9 } from "commander";
+
+// src/services/task-document.ts
+var FIELD_ALIASES = /* @__PURE__ */ new Map([
+  ["title", "System.Title"],
+  ["assignedto", "System.AssignedTo"],
+  ["assigned to", "System.AssignedTo"],
+  ["state", "System.State"],
+  ["description", "System.Description"],
+  ["acceptancecriteria", "Microsoft.VSTS.Common.AcceptanceCriteria"],
+  ["acceptance criteria", "Microsoft.VSTS.Common.AcceptanceCriteria"],
+  ["tags", "System.Tags"],
+  ["priority", "Microsoft.VSTS.Common.Priority"]
+]);
+var RICH_TEXT_FIELDS = /* @__PURE__ */ new Set([
+  "System.Description",
+  "Microsoft.VSTS.Common.AcceptanceCriteria"
+]);
+var REFERENCE_NAME_PATTERN = /^[A-Z][A-Za-z0-9]*(\.[A-Za-z0-9]+)+$/;
+function normalizeAlias(name) {
+  return name.trim().replaceAll(/\s+/g, " ").toLowerCase();
+}
+function parseScalarValue(rawValue, fieldName) {
+  if (rawValue === void 0) {
+    throw new Error(`Malformed YAML front matter: missing value for "${fieldName}"`);
+  }
+  const trimmed = rawValue.trim();
+  if (trimmed === "" || trimmed === "null" || trimmed === "~") {
+    return null;
+  }
+  if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
+    return trimmed.slice(1, -1);
+  }
+  if (/^[[{]|^[>|]-?$/.test(trimmed)) {
+    throw new Error(`Malformed YAML front matter: unsupported value for "${fieldName}"`);
+  }
+  return trimmed;
+}
+function parseFrontMatter(content) {
+  if (!content.startsWith("---")) {
+    return { frontMatter: "", remainder: content };
+  }
+  const frontMatterPattern = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/;
+  const match = frontMatterPattern.exec(content);
+  if (!match) {
+    throw new Error('Malformed YAML front matter: missing closing "---"');
+  }
+  return {
+    frontMatter: match[1],
+    remainder: content.slice(match[0].length)
+  };
+}
+function assertKnownField(name, kind) {
+  const resolved = resolveFieldName(name);
+  if (!resolved) {
+    const prefix = kind === "rich-text" ? "Unknown rich-text field" : "Unknown field";
+    throw new Error(`${prefix}: ${name}`);
+  }
+  if (kind === "rich-text" && !RICH_TEXT_FIELDS.has(resolved)) {
+    throw new Error(`Unknown rich-text field: ${name}`);
+  }
+  return resolved;
+}
+function pushField(fields, seen, refName, value, kind) {
+  if (seen.has(refName)) {
+    throw new Error(`Duplicate field: ${refName}`);
+  }
+  seen.add(refName);
+  fields.push({
+    refName,
+    value,
+    op: value === null ? "clear" : "set",
+    kind
+  });
+}
+function parseScalarFields(frontMatter, fields, seen) {
+  if (frontMatter.trim() === "") {
+    return;
+  }
+  for (const rawLine of frontMatter.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (line === "") {
+      continue;
+    }
+    const separatorIndex = rawLine.indexOf(":");
+    if (separatorIndex <= 0) {
+      throw new Error(`Malformed YAML front matter: ${rawLine.trim()}`);
+    }
+    const rawName = rawLine.slice(0, separatorIndex).trim();
+    const rawValue = rawLine.slice(separatorIndex + 1);
+    const refName = assertKnownField(rawName, "scalar");
+    const value = parseScalarValue(rawValue, rawName);
+    pushField(fields, seen, refName, value, "scalar");
+  }
+}
+function parseRichTextSections(content, fields, seen) {
+  const normalizedContent = content.replaceAll("\r\n", "\n");
+  const lines = normalizedContent.split("\n");
+  const headings = [];
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index];
+    if (!line.startsWith("##")) {
+      continue;
+    }
+    const headingBody = line.slice(2);
+    if (headingBody.trim() === "" || !headingBody.startsWith(" ") && !headingBody.startsWith("	")) {
+      continue;
+    }
+    headings.push({
+      lineIndex: index,
+      rawName: headingBody.trim()
+    });
+  }
+  if (headings.length === 0) {
+    return;
+  }
+  for (let index = 0; index < headings[0].lineIndex; index += 1) {
+    if (lines[index].trim() !== "") {
+      throw new Error("Unexpected content before the first markdown heading section");
+    }
+  }
+  for (let index = 0; index < headings.length; index += 1) {
+    const { lineIndex, rawName } = headings[index];
+    const refName = assertKnownField(rawName, "rich-text");
+    const bodyStart = lineIndex + 1;
+    const bodyEnd = index + 1 < headings.length ? headings[index + 1].lineIndex : lines.length;
+    const rawBody = lines.slice(bodyStart, bodyEnd).join("\n");
+    const value = rawBody.trim() === "" ? null : rawBody.trimEnd();
+    pushField(fields, seen, refName, value, "rich-text");
+  }
+}
+function resolveFieldName(name) {
+  const trimmed = name.trim();
+  if (trimmed === "") {
+    return null;
+  }
+  const alias = FIELD_ALIASES.get(normalizeAlias(trimmed));
+  if (alias) {
+    return alias;
+  }
+  return REFERENCE_NAME_PATTERN.test(trimmed) ? trimmed : null;
+}
+function parseTaskDocument(content) {
+  const { frontMatter, remainder } = parseFrontMatter(content);
+  const fields = [];
+  const seen = /* @__PURE__ */ new Set();
+  parseScalarFields(frontMatter, fields, seen);
+  parseRichTextSections(remainder, fields, seen);
+  return { fields };
+}
+
+// src/commands/upsert.ts
+function fail2(message) {
+  process.stderr.write(`Error: ${message}
+`);
+  process.exit(1);
+}
+function loadSourceContent(options) {
+  validateSource(options);
+  if (options.content !== void 0) {
+    return { content: options.content };
+  }
+  const filePath = options.file;
+  if (!existsSync2(filePath)) {
+    fail2(`File not found: ${filePath}`);
+  }
+  try {
+    return {
+      content: readFileSync3(filePath, "utf-8"),
+      sourceFile: filePath
+    };
+  } catch {
+    fail2(`Cannot read file: ${filePath}`);
+  }
+}
+function toPatchOperations(fields, action) {
+  const operations = [];
+  for (const field of fields) {
+    if (field.op === "clear") {
+      if (action === "updated") {
+        operations.push({ op: "remove", path: `/fields/${field.refName}` });
+      }
+      continue;
+    }
+    operations.push({ op: "add", path: `/fields/${field.refName}`, value: field.value ?? "" });
+    if (field.kind === "rich-text") {
+      operations.push({
+        op: "add",
+        path: `/multilineFieldsFormat/${field.refName}`,
+        value: "Markdown"
+      });
+    }
+  }
+  return operations;
+}
+function buildAppliedFields(fields) {
+  const applied = {};
+  for (const field of fields) {
+    applied[field.refName] = field.value;
+  }
+  return applied;
+}
+function ensureTitleForCreate(fields) {
+  const titleField = fields.find((field) => field.refName === "System.Title");
+  if (!titleField || titleField.op === "clear" || titleField.value === null || titleField.value.trim() === "") {
+    fail2("Title is required when creating a work item.");
+  }
+}
+function writeSuccess(result, options) {
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(result)}
+`);
+    return;
+  }
+  const verb = result.action === "created" ? "Created" : "Updated";
+  const fields = Object.keys(result.fields).join(", ");
+  const suffix = fields ? ` (${fields})` : "";
+  process.stdout.write(`${verb} ${result.workItemType} #${result.id}${suffix}
+`);
+}
+function cleanupSourceFile(sourceFile) {
+  if (!sourceFile) {
+    return;
+  }
+  try {
+    unlinkSync(sourceFile);
+  } catch {
+    process.stderr.write(`Warning: upsert succeeded but could not delete source file: ${sourceFile}
+`);
+  }
+}
+function resolveCreateType(id, options) {
+  if (options.type === void 0) {
+    return "Task";
+  }
+  if (id !== void 0) {
+    fail2("--type can only be used when creating a work item.");
+  }
+  const trimmedType = options.type.trim();
+  if (trimmedType === "") {
+    fail2("--type must be a non-empty work item type.");
+  }
+  return trimmedType;
+}
+function buildUpsertResult(action, writeResult, fields, fallbackWorkItemType) {
+  const appliedFields = buildAppliedFields(fields);
+  const workItemType = writeResult.fields["System.WorkItemType"];
+  return {
+    action,
+    id: writeResult.id,
+    workItemType: typeof workItemType === "string" && workItemType.trim() !== "" ? workItemType : fallbackWorkItemType,
+    fields: appliedFields
+  };
+}
+function isUpdateWriteError(err) {
+  return err.message === "AUTH_FAILED" || err.message === "PERMISSION_DENIED" || err.message.startsWith("NOT_FOUND") || err.message === "NETWORK_ERROR" || err.message.startsWith("BAD_REQUEST:") || err.message.startsWith("UPDATE_REJECTED:");
+}
+function isCreateWriteError(err) {
+  return err.message === "AUTH_FAILED" || err.message === "PERMISSION_DENIED" || err.message === "NETWORK_ERROR" || err.message.startsWith("BAD_REQUEST:") || err.message.startsWith("HTTP_");
+}
+function handleUpsertError(err, id, context) {
+  if (!(err instanceof Error)) {
+    process.stderr.write(`Error: ${String(err)}
+`);
+    process.exit(1);
+  }
+  if (id === void 0 && err.message.startsWith("CREATE_REJECTED:")) {
+    process.stderr.write(`Error: ${formatCreateError(err)}
+`);
+    process.exit(1);
+  }
+  if (id !== void 0 && isUpdateWriteError(err)) {
+    handleCommandError(err, id, context, "write");
+    return;
+  }
+  if (id === void 0 && isCreateWriteError(err)) {
+    handleCommandError(err, 0, context, "write");
+    return;
+  }
+  process.stderr.write(`Error: ${err.message}
+`);
+  process.exit(1);
+}
+function createUpsertCommand() {
+  const command = new Command9("upsert");
+  command.description("Create or update a work item from a markdown document").argument("[id]", "work item ID to update; omit to create a new work item").option("--content <markdown>", "task document content").option("--file <path>", "read task document from file").option("--type <workItemType>", "create mode work item type (defaults to Task)").option("--json", "output result as JSON").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").action(async (idStr, options) => {
+    validateOrgProjectPair(options);
+    const id = idStr === void 0 ? void 0 : parseWorkItemId(idStr);
+    const { content, sourceFile } = loadSourceContent(options);
+    const createType = resolveCreateType(id, options);
+    let context;
+    try {
+      context = resolveContext(options);
+      const document = parseTaskDocument(content);
+      const action = id === void 0 ? "created" : "updated";
+      if (action === "created") {
+        ensureTitleForCreate(document.fields);
+      }
+      const operations = toPatchOperations(document.fields, action);
+      const credential = await resolvePat();
+      let writeResult;
+      if (action === "created") {
+        writeResult = await createWorkItem(context, createType, credential.pat, operations);
+      } else {
+        if (id === void 0) {
+          fail2("Work item ID is required for updates.");
+        }
+        writeResult = await applyWorkItemPatch(context, id, credential.pat, operations);
+      }
+      const result = buildUpsertResult(
+        action,
+        writeResult,
+        document.fields,
+        action === "created" ? createType : "Work item"
+      );
+      writeSuccess(result, options);
+      cleanupSourceFile(sourceFile);
+    } catch (err) {
+      handleUpsertError(err, id, context);
+    }
+  });
+  return command;
+}
+
+// src/commands/list-fields.ts
+import { Command as Command10 } from "commander";
+function stringifyValue(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "object") return JSON.stringify(value);
+  return String(value);
+}
+function formatRichValue(raw) {
+  const md = htmlToMarkdown(raw);
+  const lines = md.split("\n").filter((l) => l.trim() !== "");
+  const preview = lines.slice(0, 5);
+  const suffix = lines.length > 5 ? `
+  \u2026 (${lines.length - 5} more lines)` : "";
+  return preview.join("\n  ") + suffix;
+}
+function formatFieldList(fields) {
+  const entries = Object.entries(fields).sort(([a], [b]) => a.localeCompare(b));
+  const maxKeyLen = Math.min(
+    Math.max(...entries.map(([k]) => k.length)),
+    50
+  );
+  return entries.map(([key, value]) => {
+    const raw = stringifyValue(value);
+    if (raw === "") return `${key.padEnd(maxKeyLen + 2)}(empty)`;
+    if (typeof value === "string" && isHtml(value)) {
+      const preview = formatRichValue(value);
+      return `${key.padEnd(maxKeyLen + 2)}[rich text]
+  ${preview}`;
+    }
+    return `${key.padEnd(maxKeyLen + 2)}${raw}`;
+  }).join("\n");
+}
+function createListFieldsCommand() {
+  const command = new Command10("list-fields");
+  command.description("List all fields of an Azure DevOps work item").argument("<id>", "work item ID").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output result as JSON").action(
+    async (idStr, options) => {
+      const id = parseWorkItemId(idStr);
+      validateOrgProjectPair(options);
+      let context;
+      try {
+        context = resolveContext(options);
+        const credential = await resolvePat();
+        const fields = await getWorkItemFields(context, id, credential.pat);
+        if (options.json) {
+          process.stdout.write(JSON.stringify({ id, fields }, null, 2) + "\n");
+        } else {
+          process.stdout.write(`Work Item ${id} \u2014 ${Object.keys(fields).length} fields
+
+`);
+          process.stdout.write(formatFieldList(fields) + "\n");
+        }
+      } catch (err) {
+        handleCommandError(err, id, context, "read");
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/pr.ts
+import { Command as Command11 } from "commander";
+
+// src/services/pr-client.ts
+function buildPullRequestsUrl(context, repo, sourceBranch, opts) {
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/git/repositories/${encodeURIComponent(repo)}/pullrequests`
+  );
+  url.searchParams.set("api-version", "7.1");
+  url.searchParams.set("searchCriteria.sourceRefName", `refs/heads/${sourceBranch}`);
+  if (opts?.status) {
+    url.searchParams.set("searchCriteria.status", opts.status);
+  }
+  if (opts?.targetBranch) {
+    url.searchParams.set("searchCriteria.targetRefName", `refs/heads/${opts.targetBranch}`);
+  }
+  return url;
+}
+function mapPullRequest(repo, pullRequest) {
+  return {
+    id: pullRequest.pullRequestId,
+    title: pullRequest.title,
+    repository: repo,
+    sourceRefName: pullRequest.sourceRefName,
+    targetRefName: pullRequest.targetRefName,
+    status: pullRequest.status,
+    createdBy: pullRequest.createdBy?.displayName ?? null,
+    url: pullRequest._links.web.href
+  };
+}
+function mapComment(comment) {
+  const content = comment.content?.trim();
+  if (comment.isDeleted || !content) {
+    return null;
+  }
+  return {
+    id: comment.id,
+    author: comment.author?.displayName ?? null,
+    content,
+    publishedAt: comment.publishedDate ?? null
+  };
+}
+function mapThread(thread) {
+  if (thread.status !== "active" && thread.status !== "pending") {
+    return null;
+  }
+  const comments = thread.comments.map(mapComment).filter((comment) => comment !== null);
+  if (comments.length === 0) {
+    return null;
+  }
+  return {
+    id: thread.id,
+    status: thread.status,
+    threadContext: thread.threadContext?.filePath ?? null,
+    comments
+  };
+}
+async function readJsonResponse(response) {
+  if (!response.ok) {
+    throw new Error(`HTTP_${response.status}`);
+  }
+  return response.json();
+}
+async function listPullRequests(context, repo, pat, sourceBranch, opts) {
+  const response = await fetchWithErrors(
+    buildPullRequestsUrl(context, repo, sourceBranch, opts).toString(),
+    { headers: authHeaders(pat) }
+  );
+  const data = await readJsonResponse(response);
+  return data.value.map((pullRequest) => mapPullRequest(repo, pullRequest));
+}
+async function openPullRequest(context, repo, pat, sourceBranch, title, description) {
+  const existing = await listPullRequests(context, repo, pat, sourceBranch, {
+    status: "active",
+    targetBranch: "develop"
+  });
+  if (existing.length === 1) {
+    return {
+      branch: sourceBranch,
+      targetBranch: "develop",
+      created: false,
+      pullRequest: existing[0]
+    };
+  }
+  if (existing.length > 1) {
+    throw new Error(`AMBIGUOUS_PRS:${existing.map((pullRequest) => pullRequest.id).join(",")}`);
+  }
+  const payload = {
+    sourceRefName: `refs/heads/${sourceBranch}`,
+    targetRefName: "refs/heads/develop",
+    title,
+    description
+  };
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/git/repositories/${encodeURIComponent(repo)}/pullrequests`
+  );
+  url.searchParams.set("api-version", "7.1");
+  const response = await fetchWithErrors(url.toString(), {
+    method: "POST",
+    headers: {
+      ...authHeaders(pat),
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(payload)
+  });
+  const data = await readJsonResponse(response);
+  return {
+    branch: sourceBranch,
+    targetBranch: "develop",
+    created: true,
+    pullRequest: mapPullRequest(repo, data)
+  };
+}
+async function getPullRequestThreads(context, repo, pat, prId) {
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/git/repositories/${encodeURIComponent(repo)}/pullRequests/${prId}/threads`
+  );
+  url.searchParams.set("api-version", "7.1");
+  const response = await fetchWithErrors(url.toString(), { headers: authHeaders(pat) });
+  const data = await readJsonResponse(response);
+  return data.value.map(mapThread).filter((thread) => thread !== null);
+}
+
+// src/commands/pr.ts
+function formatBranchName(refName) {
+  return refName.startsWith("refs/heads/") ? refName.slice("refs/heads/".length) : refName;
+}
+function writeError(message) {
+  process.stderr.write(`Error: ${message}
+`);
+  process.exit(1);
+}
+function handlePrCommandError(err, context, mode = "read") {
+  const error = err instanceof Error ? err : new Error(String(err));
+  if (error.message === "AUTH_FAILED") {
+    const scopeLabel = mode === "write" ? "Code (Read & Write)" : "Code (Read)";
+    writeError(`Authentication failed. Check that your PAT is valid and has the "${scopeLabel}" scope.`);
+  }
+  if (error.message === "PERMISSION_DENIED") {
+    writeError(`Access denied. Your PAT may lack ${mode} permissions for project "${context?.project}".`);
+  }
+  if (error.message === "NETWORK_ERROR") {
+    writeError("Could not connect to Azure DevOps. Check your network connection.");
+  }
+  if (error.message.startsWith("NOT_FOUND")) {
+    writeError(`Azure DevOps repository not found in ${context?.org}/${context?.project}.`);
+  }
+  if (error.message.startsWith("HTTP_")) {
+    writeError(`Azure DevOps request failed with ${error.message}.`);
+  }
+  writeError(error.message);
+}
+function formatPullRequestBlock(pullRequest) {
+  return [
+    `#${pullRequest.id} [${pullRequest.status}] ${pullRequest.title}`,
+    `${formatBranchName(pullRequest.sourceRefName)} -> ${formatBranchName(pullRequest.targetRefName)}`,
+    pullRequest.url
+  ].join("\n");
+}
+function formatThreads(prId, title, threads) {
+  const lines = [`Active comments for pull request #${prId}: ${title}`];
+  for (const thread of threads) {
+    lines.push("", `Thread #${thread.id} [${thread.status}] ${thread.threadContext ?? "(general)"}`);
+    for (const comment of thread.comments) {
+      lines.push(`  ${comment.author ?? "Unknown"}: ${comment.content}`);
+    }
+  }
+  return lines.join("\n");
+}
+async function resolvePrCommandContext(options) {
+  const context = resolveContext(options);
+  const repo = detectRepoName();
+  const branch = getCurrentBranch();
+  const credential = await resolvePat();
+  return {
+    context,
+    repo,
+    branch,
+    pat: credential.pat
+  };
+}
+function createPrStatusCommand() {
+  const command = new Command11("status");
+  command.description("Check pull requests for the current branch").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(async (options) => {
+    validateOrgProjectPair(options);
+    let context;
+    try {
+      const resolved = await resolvePrCommandContext(options);
+      context = resolved.context;
+      const pullRequests = await listPullRequests(resolved.context, resolved.repo, resolved.pat, resolved.branch);
+      const { branch, repo } = resolved;
+      const result = { branch, repository: repo, pullRequests };
+      if (options.json) {
+        process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+        return;
+      }
+      if (pullRequests.length === 0) {
+        process.stdout.write(`No pull requests found for branch ${branch}.
+`);
+        return;
+      }
+      process.stdout.write(`${pullRequests.map(formatPullRequestBlock).join("\n\n")}
+`);
+    } catch (err) {
+      handlePrCommandError(err, context, "read");
+    }
+  });
+  return command;
+}
+function createPrOpenCommand() {
+  const command = new Command11("open");
+  command.description("Open a pull request from the current branch to develop").option("--title <title>", "pull request title").option("--description <description>", "pull request description").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(async (options) => {
+    validateOrgProjectPair(options);
+    const title = options.title?.trim();
+    if (!title) {
+      writeError("--title is required for pull request creation.");
+    }
+    const description = options.description?.trim();
+    if (!description) {
+      writeError("--description is required for pull request creation.");
+    }
+    let context;
+    try {
+      const resolved = await resolvePrCommandContext(options);
+      context = resolved.context;
+      if (resolved.branch === "develop") {
+        writeError("Pull request creation requires a source branch other than develop.");
+      }
+      const result = await openPullRequest(
+        resolved.context,
+        resolved.repo,
+        resolved.pat,
+        resolved.branch,
+        title,
+        description
+      );
+      if (options.json) {
+        process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+        return;
+      }
+      if (result.created) {
+        process.stdout.write(`Created pull request #${result.pullRequest.id}: ${result.pullRequest.title}
+${result.pullRequest.url}
+`);
+        return;
+      }
+      process.stdout.write(
+        `Active pull request already exists for ${resolved.branch} -> develop: #${result.pullRequest.id}
+${result.pullRequest.url}
+`
+      );
+    } catch (err) {
+      if (err instanceof Error && err.message.startsWith("AMBIGUOUS_PRS:")) {
+        const ids = err.message.replace("AMBIGUOUS_PRS:", "").split(",").map((id) => `#${id}`).join(", ");
+        writeError(`Multiple active pull requests already exist for this branch targeting develop: ${ids}. Use pr status to review them.`);
+      }
+      handlePrCommandError(err, context, "write");
+    }
+  });
+  return command;
+}
+function createPrCommentsCommand() {
+  const command = new Command11("comments");
+  command.description("List active pull request comments for the current branch").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(async (options) => {
+    validateOrgProjectPair(options);
+    let context;
+    try {
+      const resolved = await resolvePrCommandContext(options);
+      context = resolved.context;
+      const pullRequests = await listPullRequests(resolved.context, resolved.repo, resolved.pat, resolved.branch, {
+        status: "active"
+      });
+      if (pullRequests.length === 0) {
+        writeError(`No active pull request found for branch ${resolved.branch}.`);
+      }
+      if (pullRequests.length > 1) {
+        const ids = pullRequests.map((pullRequest2) => `#${pullRequest2.id}`).join(", ");
+        writeError(`Multiple active pull requests found for branch ${resolved.branch}: ${ids}. Use pr status to review them.`);
+      }
+      const pullRequest = pullRequests[0];
+      const threads = await getPullRequestThreads(resolved.context, resolved.repo, resolved.pat, pullRequest.id);
+      const result = { branch: resolved.branch, pullRequest, threads };
+      if (options.json) {
+        process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+        return;
+      }
+      if (threads.length === 0) {
+        process.stdout.write(`Pull request #${pullRequest.id} has no active comments.
+`);
+        return;
+      }
+      process.stdout.write(`${formatThreads(pullRequest.id, pullRequest.title, threads)}
+`);
+    } catch (err) {
+      handlePrCommandError(err, context, "read");
+    }
+  });
+  return command;
+}
+function createPrCommand() {
+  const command = new Command11("pr");
+  command.description("Manage Azure DevOps pull requests");
+  command.addCommand(createPrStatusCommand());
+  command.addCommand(createPrOpenCommand());
+  command.addCommand(createPrCommentsCommand());
+  return command;
+}
+
 // src/index.ts
-var program = new Command3();
+var program = new Command12();
 program.name("azdo").description("Azure DevOps CLI tool").version(version, "-v, --version");
 program.addCommand(createGetItemCommand());
 program.addCommand(createClearPatCommand());
+program.addCommand(createConfigCommand());
+program.addCommand(createSetStateCommand());
+program.addCommand(createAssignCommand());
+program.addCommand(createSetFieldCommand());
+program.addCommand(createGetMdFieldCommand());
+program.addCommand(createSetMdFieldCommand());
+program.addCommand(createUpsertCommand());
+program.addCommand(createListFieldsCommand());
+program.addCommand(createPrCommand());
 program.showHelpAfterError();
 program.parse();
 if (process.argv.length <= 2) {