azdo-cli 0.2.0-003-cli-settings.19 → 0.2.0-005-md-field-commands.25

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command4 } from "commander";
+import { Command as Command9 } from "commander";
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -90,6 +90,74 @@ async function getWorkItem(context, id, pat, extraFields) {
     extraFields: extraFields && extraFields.length > 0 ? buildExtraFields(data.fields, extraFields) : null
   };
 }
+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 token = Buffer.from(`:${pat}`).toString("base64");
+  let response;
+  try {
+    response = await fetch(url, {
+      headers: {
+        Authorization: `Basic ${token}`
+      }
+    });
+  } 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.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 String(value);
+}
+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");
+  }
+  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 === 400) {
+    let serverMessage = "Unknown error";
+    try {
+      const body = await response.json();
+      if (body.message) serverMessage = body.message;
+    } catch {
+    }
+    throw new Error(`UPDATE_REJECTED: ${serverMessage}`);
+  }
+  if (!response.ok) {
+    throw new Error(`HTTP_${response.status}`);
+  }
+  const data = await response.json();
+  const lastOp = operations[operations.length - 1];
+  const fieldValue = lastOp.value ?? null;
+  return {
+    id: data.id,
+    rev: data.rev,
+    title: data.fields["System.Title"],
+    fieldName,
+    fieldValue
+  };
+}
 
 // src/services/auth.ts
 import { createInterface } from "readline";
@@ -608,12 +676,549 @@ function createConfigCommand() {
   return config;
 }
 
+// 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);
+      }
+      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) {
+        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);
+      }
+    }
+  );
+  return command;
+}
+
+// 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);
+      }
+      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);
+      }
+      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);
+      }
+      let context;
+      try {
+        context = resolveContext2(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) {
+        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);
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/set-field.ts
+import { Command as Command6 } from "commander";
+
+// src/services/context.ts
+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".'
+  );
+}
+
+// src/commands/set-field.ts
+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);
+      }
+      let context;
+      try {
+        context = resolveContext3(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) {
+        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);
+      }
+    }
+  );
+  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 = /<\/?(p|br|div|span|strong|em|b|i|u|a|ul|ol|li|h[1-6]|table|tr|td|th|img|pre|code)\b/i;
+function isHtml(content) {
+  return HTML_TAG_REGEX.test(content);
+}
+
+// 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 = 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);
+      }
+      let context;
+      try {
+        context = resolveContext3(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) {
+        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 === "PERMISSION_DENIED") {
+          process.stderr.write(
+            `Error: Access denied. Your PAT may lack read 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 {
+          process.stderr.write(`Error: ${msg}
+`);
+        }
+        process.exit(1);
+      }
+    }
+  );
+  return command;
+}
+
+// src/commands/set-md-field.ts
+import { existsSync, readFileSync as readFileSync2 } from "fs";
+import { Command as Command8 } from "commander";
+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 = 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);
+      }
+      if (inlineContent && options.file) {
+        process.stderr.write(
+          "Error: Cannot specify both inline content and --file.\n"
+        );
+        process.exit(1);
+      }
+      let content;
+      if (options.file) {
+        if (!existsSync(options.file)) {
+          process.stderr.write(`Error: File not found: ${options.file}
+`);
+          process.exit(1);
+        }
+        try {
+          content = readFileSync2(options.file, "utf-8");
+        } catch {
+          process.stderr.write(`Error: Cannot read file: ${options.file}
+`);
+          process.exit(1);
+        }
+      } else if (inlineContent) {
+        content = inlineContent;
+      } else if (!process.stdin.isTTY) {
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+          chunks.push(chunk);
+        }
+        const stdinContent = Buffer.concat(chunks).toString("utf-8").trimEnd();
+        if (!stdinContent) {
+          process.stderr.write(
+            "Error: No content provided via stdin. Pipe markdown content or use inline content or --file.\n"
+          );
+          process.exit(1);
+        }
+        content = stdinContent;
+      } else {
+        process.stderr.write(
+          "Error: No content provided. Pass markdown content as the third argument, use --file, or pipe via stdin.\n"
+        );
+        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);
+      }
+      let context;
+      try {
+        context = resolveContext3(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);
+        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
+`);
+        }
+      } 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);
+      }
+    }
+  );
+  return command;
+}
+
 // src/index.ts
-var program = new Command4();
+var program = new Command9();
 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.showHelpAfterError();
 program.parse();
 if (process.argv.length <= 2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.2.0-003-cli-settings.19",
+  "version": "0.2.0-005-md-field-commands.25",
   "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",