azdo-cli 0.2.0-develop.21 → 0.2.0-develop.41

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command4 } from "commander";
+import { Command as Command7 } from "commander";
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -37,15 +37,18 @@ function buildExtraFields(fields, requested) {
   return Object.keys(result).length > 0 ? result : null;
 }
 async function getWorkItem(context, id, pat, extraFields) {
-  let url = `https://dev.azure.com/${context.org}/${context.project}/_apis/wit/workitems/${id}?api-version=7.1`;
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/workitems/${id}`
+  );
+  url.searchParams.set("api-version", "7.1");
   if (extraFields && extraFields.length > 0) {
     const allFields = [...DEFAULT_FIELDS, ...extraFields];
-    url += `&fields=${allFields.join(",")}`;
+    url.searchParams.set("fields", allFields.join(","));
   }
   const token = Buffer.from(`:${pat}`).toString("base64");
   let response;
   try {
-    response = await fetch(url, {
+    response = await fetch(url.toString(), {
       headers: {
         Authorization: `Basic ${token}`
       }
@@ -90,6 +93,51 @@ async function getWorkItem(context, id, pat, extraFields) {
     extraFields: extraFields && extraFields.length > 0 ? buildExtraFields(data.fields, extraFields) : null
   };
 }
+async function updateWorkItem(context, id, pat, fieldName, operations) {
+  const url = new URL(
+    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/workitems/${id}`
+  );
+  url.searchParams.set("api-version", "7.1");
+  const token = Buffer.from(`:${pat}`).toString("base64");
+  let response;
+  try {
+    response = await fetch(url.toString(), {
+      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";
@@ -124,6 +172,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;
@@ -175,8 +227,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."
@@ -608,12 +663,335 @@ 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";
+function resolveContext3(options) {
+  if (options.org && options.project) {
+    return { org: options.org, project: options.project };
+  }
+  const config = loadConfig();
+  if (config.org && config.project) {
+    return { org: config.org, project: config.project };
+  }
+  let gitContext = null;
+  try {
+    gitContext = detectAzdoContext();
+  } catch {
+  }
+  const org = config.org || gitContext?.org;
+  const project = config.project || gitContext?.project;
+  if (org && project) {
+    return { org, project };
+  }
+  throw new Error(
+    'Could not determine org/project. Use --org and --project flags, work from an Azure DevOps git repo, or run "azdo config set org/project".'
+  );
+}
+function createSetFieldCommand() {
+  const command = new Command6("set-field");
+  command.description("Set any work item field by its reference name").argument("<id>", "work item ID").argument("<field>", "field reference name (e.g., System.Title)").argument("<value>", "new value for the field").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output result as JSON").action(
+    async (idStr, field, value, options) => {
+      const id = parseInt(idStr, 10);
+      if (!Number.isInteger(id) || id <= 0) {
+        process.stderr.write(
+          `Error: Work item ID must be a positive integer. Got: "${idStr}"
+`
+        );
+        process.exit(1);
+      }
+      const hasOrg = options.org !== void 0;
+      const hasProject = options.project !== void 0;
+      if (hasOrg !== hasProject) {
+        process.stderr.write(
+          "Error: --org and --project must both be provided, or both omitted.\n"
+        );
+        process.exit(1);
+      }
+      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/index.ts
-var program = new Command4();
+var program = new Command7();
 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.showHelpAfterError();
 program.parse();
 if (process.argv.length <= 2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.2.0-develop.21",
+  "version": "0.2.0-develop.41",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {