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

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command3 } 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 {
@@ -61,7 +86,8 @@ 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: extraFields && extraFields.length > 0 ? buildExtraFields(data.fields, extraFields) : null
   };
 }
 
@@ -175,7 +201,11 @@ function parseAzdoRemote(url) {
   for (const pattern of patterns) {
     const match = url.match(pattern);
     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,12 +218,97 @@ 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;
 }
 
+// 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;
@@ -224,6 +339,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) {
@@ -240,7 +361,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) {
@@ -263,10 +384,29 @@ function createGetItemCommand() {
         if (options.org && options.project) {
           context = { org: options.org, project: options.project };
         } else {
-          context = detectAzdoContext();
+          const config = loadConfig();
+          if (config.org && config.project) {
+            context = { org: config.org, project: config.project };
+          } else {
+            let gitContext = null;
+            try {
+              gitContext = detectAzdoContext();
+            } catch {
+            }
+            const org = config.org || gitContext?.org;
+            const project = config.project || gitContext?.project;
+            if (org && project) {
+              context = { org, project };
+            } else {
+              throw new Error(
+                'Could not determine org/project. Use --org and --project flags, work from an Azure DevOps git repo, or run "azdo config set org/project".'
+              );
+            }
+          }
         }
         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) {
@@ -319,11 +459,161 @@ function createClearPatCommand() {
   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 Command3();
+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-develop.14",
+  "version": "0.2.0-develop.21",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {