azdo-cli 0.2.0-002-get-item-command.10 → 0.2.0-003-cli-settings.17

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command2 } from "commander";
+import { Command as Command4 } from "commander";
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -15,8 +15,33 @@ 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 buildExtraFields(fields, requested) {
+  const result = {};
+  for (const name of requested) {
+    const val = fields[name];
+    if (val !== void 0 && val !== null) {
+      result[name] = String(val);
+    }
+  }
+  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`;
+  if (extraFields && extraFields.length > 0) {
+    const allFields = [...DEFAULT_FIELDS, ...extraFields];
+    url += `&fields=${allFields.join(",")}`;
+  }
   const token = Buffer.from(`:${pat}`).toString("base64");
   let response;
   try {
@@ -35,6 +60,22 @@ async function getWorkItem(context, id, pat) {
     throw new Error(`HTTP_${response.status}`);
   }
   const data = await response.json();
+  const descriptionParts = [];
+  if (data.fields["System.Description"]) {
+    descriptionParts.push({ label: "Description", value: data.fields["System.Description"] });
+  }
+  if (data.fields["Microsoft.VSTS.Common.AcceptanceCriteria"]) {
+    descriptionParts.push({ label: "Acceptance Criteria", value: data.fields["Microsoft.VSTS.Common.AcceptanceCriteria"] });
+  }
+  if (data.fields["Microsoft.VSTS.TCM.ReproSteps"]) {
+    descriptionParts.push({ label: "Repro Steps", value: data.fields["Microsoft.VSTS.TCM.ReproSteps"] });
+  }
+  let combinedDescription = null;
+  if (descriptionParts.length === 1) {
+    combinedDescription = descriptionParts[0].value;
+  } else if (descriptionParts.length > 1) {
+    combinedDescription = descriptionParts.map((p) => `<h3>${p.label}</h3>${p.value}`).join("");
+  }
   return {
     id: data.id,
     rev: data.rev,
@@ -42,10 +83,11 @@ async function getWorkItem(context, id, pat) {
     state: data.fields["System.State"],
     type: data.fields["System.WorkItemType"],
     assignedTo: data.fields["System.AssignedTo"]?.displayName ?? null,
-    description: data.fields["System.Description"] ?? null,
+    description: combinedDescription,
     areaPath: data.fields["System.AreaPath"],
     iterationPath: data.fields["System.IterationPath"],
-    url: data._links.html.href
+    url: data._links.html.href,
+    extraFields: extraFields && extraFields.length > 0 ? buildExtraFields(data.fields, extraFields) : null
   };
 }
 
@@ -71,6 +113,15 @@ async function storePat(pat) {
   } catch {
   }
 }
+async function deletePat() {
+  try {
+    const entry = new Entry(SERVICE, ACCOUNT);
+    entry.deletePassword();
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 // src/services/auth.ts
 async function promptForPat() {
@@ -107,7 +158,7 @@ async function promptForPat() {
         }
       } else {
         pat += ch;
-        process.stderr.write("*");
+        process.stderr.write("*".repeat(ch.length));
       }
     };
     process.stdin.on("data", onData);
@@ -169,9 +220,95 @@ function detectAzdoContext() {
   return context;
 }
 
+// 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
+  }
+];
+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: org, project, fields`);
+  }
+}
+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 === "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/commands/get-item.ts
 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");
@@ -198,6 +335,12 @@ function formatWorkItem(workItem, short) {
     lines.push(`${label("Iteration:")}${workItem.iterationPath}`);
   }
   lines.push(`${label("URL:")}${workItem.url}`);
+  if (workItem.extraFields) {
+    for (const [refName, value] of Object.entries(workItem.extraFields)) {
+      const fieldLabel = refName.includes(".") ? refName.split(".").pop() : refName;
+      lines.push(`${fieldLabel.padEnd(13)}${value}`);
+    }
+  }
   lines.push("");
   const descriptionText = workItem.description ? stripHtml(workItem.description) : "";
   if (short) {
@@ -214,7 +357,7 @@ function formatWorkItem(workItem, short) {
 }
 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").action(
     async (idStr, options) => {
       const id = parseInt(idStr, 10);
       if (!Number.isInteger(id) || id <= 0) {
@@ -237,10 +380,22 @@ function createGetItemCommand() {
         if (options.org && options.project) {
           context = { org: options.org, project: options.project };
         } else {
-          context = detectAzdoContext();
+          try {
+            context = detectAzdoContext();
+          } catch {
+            const config = loadConfig();
+            if (config.org && config.project) {
+              context = { org: config.org, project: config.project };
+            } else {
+              throw new Error(
+                'Could not determine org/project. Use --org and --project flags, work from an Azure DevOps git repo, or run "azdo config set org/project".'
+              );
+            }
+          }
         }
         const credential = await resolvePat();
-        const workItem = await getWorkItem(context, id, credential.pat);
+        const fieldsList = options.fields ? options.fields.split(",").map((f) => f.trim()) : loadConfig().fields;
+        const workItem = await getWorkItem(context, id, credential.pat, fieldsList);
         const output = formatWorkItem(workItem, options.short ?? false);
         process.stdout.write(output + "\n");
       } catch (err) {
@@ -278,10 +433,176 @@ function createGetItemCommand() {
   return command;
 }
 
+// src/commands/clear-pat.ts
+import { Command as Command2 } from "commander";
+function createClearPatCommand() {
+  const command = new Command2("clear-pat");
+  command.description("Remove the stored Azure DevOps PAT from the credential store").action(async () => {
+    const deleted = await deletePat();
+    if (deleted) {
+      process.stdout.write("PAT removed from credential store.\n");
+    } else {
+      process.stdout.write("No stored PAT found.\n");
+    }
+  });
+  return command;
+}
+
+// src/commands/config.ts
+import { Command as Command3 } from "commander";
+import { createInterface as createInterface2 } from "readline";
+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");
+    } else {
+      const keyWidth = 10;
+      const valueWidth = 30;
+      for (const setting of SETTINGS) {
+        const raw = cfg[setting.key];
+        const value = raw === void 0 ? "(not set)" : Array.isArray(raw) ? raw.join(",") : raw;
+        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'
+        );
+      }
+    }
+  });
+  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 = (prompt) => new Promise((resolve2) => rl.question(prompt, resolve2));
+    process.stderr.write("Azure DevOps CLI - Configuration Wizard\n");
+    process.stderr.write("=======================================\n\n");
+    for (const setting of SETTINGS) {
+      const current = cfg[setting.key];
+      const currentDisplay = current === void 0 ? "" : Array.isArray(current) ? current.join(",") : current;
+      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}"
+
+`);
+      } else if (currentDisplay) {
+        process.stderr.write(`  -> Kept "${setting.key}" as "${currentDisplay}"
+
+`);
+      } else {
+        process.stderr.write(`  -> Skipped "${setting.key}"
+
+`);
+      }
+    }
+    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/index.ts
-var program = new Command2();
+var program = new Command4();
 program.name("azdo").description("Azure DevOps CLI tool").version(version, "-v, --version");
 program.addCommand(createGetItemCommand());
+program.addCommand(createClearPatCommand());
+program.addCommand(createConfigCommand());
 program.showHelpAfterError();
 program.parse();
 if (process.argv.length <= 2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.2.0-002-get-item-command.10",
+  "version": "0.2.0-003-cli-settings.17",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {