azdo-cli 0.11.0 → 0.13.0

package/README.md

@@ -13,10 +13,12 @@ Azure DevOps CLI focused on work item read/write workflows.
 - Create or update work items from markdown documents (`upsert`)
 - Read and post work item comments (`comments`)
 - Read/write rich-text fields as markdown (`get-md-field`, `set-md-field`)
+- Download images embedded in rich-text fields, optionally resized for LLM use (`get-item`/`get-md-field` `--download-images`, `--resize-images`)
 - Check branch pull request status, open PRs to `develop`, list PR comment threads for any PR (`--pr-number`), and resolve/reopen threads from the CLI (`pr`)
 - Persist org/project/default fields in local config (`config`)
 - List all fields of a work item (`list-fields`)
-- Authenticate per Azure DevOps organization with `azdo auth login` — OAuth (Microsoft Entra) by default, or a Personal Access Token via `--use-pat` (or the `AZDO_PAT` env var). Credentials are stored in the OS credential store. Inspect with `azdo auth status`, remove with `azdo auth logout`. See [docs/authentication.md](docs/authentication.md).
+- Authenticate per Azure DevOps organization with `azdo auth login` — OAuth (Microsoft Entra) by default, or a Personal Access Token via `--use-pat` (or the `AZDO_PAT` env var). Credentials are stored in the OS credential store. Inspect with `azdo auth status`, remove with `azdo auth logout`. Diagnose auth problems with `azdo auth diagnose`. See [docs/authentication.md](docs/authentication.md).
+- Trace all HTTP requests to a local file with `--trace <filepath>` (sensitive headers and tokens are automatically redacted).
 
 ## Installation
 
@@ -37,6 +39,11 @@ azdo config set project myproject
 # Read a work item
 azdo get-item 12345
 
+# Download images embedded in a work item's rich-text fields (opt-in)
+azdo get-item 12345 --download-images                       # saved to the system temp dir
+azdo get-item 12345 --resize-images 1024 --images-path ./img # cap width at 1024px, save as PNG
+azdo get-md-field 12345 System.Description --download-images # same flags on get-md-field
+
 # Update state
 azdo set-state 12345 "Active"
 
@@ -48,11 +55,33 @@ azdo comments list 12345
 azdo comments add 12345 "Investigating the root cause now."
 
 # PR comment threads — list, filter, target by number, resolve or reopen
-azdo pr comments                        # active-branch PR
+azdo pr comments                        # active-branch PR; code-anchored threads show file:line
 azdo pr comments --pr-number 64         # any PR by number (skips branch lookup)
-azdo pr comments --pr-number 64 --hide-resolved
+azdo pr comments --pr-number 64 --hide-resolved      # or --exclude-resolved (alias)
+azdo pr comments --code-related-only    # only file/line-anchored threads
+azdo pr status                          # PR checks (status + branch policies + pipeline builds) + code-comment counts
 azdo pr comment-resolve 17 --pr-number 64   # idempotent: exit 0 even when already resolved
 azdo pr comment-reopen 17  --pr-number 64
+
+# Reply to a PR comment thread
+azdo pr comments reply 148 "Great suggestion, I'll address it."          # human-readable output
+azdo pr comments reply 148 "Done." --pr-number 64 --json                 # JSON: { pullRequestId, threadId, commentId, content }
+azdo pr comment-reply 148 "Done."  --pr-number 64                        # flat alias, identical behaviour
+
+# Pipelines — list, inspect runs, wait (exit code = result), start
+azdo pipeline list --filter ci
+azdo pipeline get-runs 12 --branch develop --limit 1
+azdo pipeline wait 3456                     # blocks; exit 0 success / non-zero failure / 124 timeout
+azdo pipeline get-run-detail 3456           # errors, failing tests, per-stage status
+azdo pipeline start 12 --branch develop --parameter env=staging
+
+# Work item relations — types, add, remove, list
+azdo relations types                        # list all relation types (Child, Parent, Related, ...)
+azdo relations types --json                 # machine-readable JSON array
+azdo relations add child 1000 2000          # make #2000 a child of #1000 (idempotent)
+azdo relations remove child 1000 2000       # remove the child relation
+azdo relations list 1000                    # show all relations on work item #1000
+azdo relations list 1000 --json             # JSON: { workItemId, relations: [...] }
 ```
 
 ## Documentation

package/dist/{chunk-C7RAZJHV.js → chunk-XVXMDWQE.js}

@@ -65,6 +65,7 @@ var SETTINGS = [
   }
 ];
 var VALID_KEYS = SETTINGS.map((s) => s.key);
+var SCOPED_KEYS = ["project", "fields", "markdown"];
 function getConfigPath() {
   return path.join(os.homedir(), ".azdo", "config.json");
 }
@@ -88,6 +89,20 @@ function loadConfig() {
   }
 }
 function saveConfig(config) {
+  if (config.organizations) {
+    const normalised = {};
+    for (const [k, v] of Object.entries(config.organizations)) {
+      if (v && Object.keys(v).length > 0) {
+        normalised[k.toLowerCase()] = v;
+      }
+    }
+    if (Object.keys(normalised).length > 0) {
+      config = { ...config, organizations: normalised };
+    } else {
+      const { organizations: _, ...rest } = config;
+      config = rest;
+    }
+  }
   const configPath = getConfigPath();
   const dir = path.dirname(configPath);
   fs.mkdirSync(dir, { recursive: true });
@@ -126,6 +141,115 @@ function unsetConfigValue(key) {
   delete config[key];
   saveConfig(config);
 }
+function resolveScopedConfig(org) {
+  const config = loadConfig();
+  const base = {
+    project: config.project,
+    fields: config.fields,
+    markdown: config.markdown,
+    org: config.org
+  };
+  if (!org) return base;
+  const scope = config.organizations?.[org.toLowerCase()];
+  if (!scope) return base;
+  return {
+    org: config.org,
+    project: scope.project ?? config.project,
+    fields: scope.fields ?? config.fields,
+    markdown: scope.markdown ?? config.markdown
+  };
+}
+function validateScopedKey(key) {
+  if (!SCOPED_KEYS.includes(key)) {
+    throw new Error(
+      `Invalid scoped key "${key}". Valid scoped keys: ${SCOPED_KEYS.join(", ")}`
+    );
+  }
+}
+function applyValueToScope(scope, key, value) {
+  if (key === "fields") {
+    return { ...scope, fields: value.split(",").map((s) => s.trim()).filter(Boolean) };
+  }
+  if (key === "markdown") {
+    if (value !== "true" && value !== "false") {
+      throw new Error(`Invalid value "${value}" for markdown. Must be "true" or "false".`);
+    }
+    return { ...scope, markdown: value === "true" };
+  }
+  return { ...scope, [key]: value };
+}
+function setOrgScopedValue(org, key, value) {
+  validateScopedKey(key);
+  const config = loadConfig();
+  const lc = org.toLowerCase();
+  const existing = config.organizations?.[lc] ?? {};
+  const updated = applyValueToScope(existing, key, value);
+  saveConfig({
+    ...config,
+    organizations: { ...config.organizations, [lc]: updated }
+  });
+}
+function unsetOrgScopedValue(org, key) {
+  validateScopedKey(key);
+  const config = loadConfig();
+  const lc = org.toLowerCase();
+  const scope = config.organizations?.[lc];
+  if (!scope) return;
+  const { [key]: _, ...rest } = scope;
+  saveConfig({
+    ...config,
+    organizations: { ...config.organizations, [lc]: rest }
+  });
+}
+function getOrgScopedValue(org, key) {
+  validateScopedKey(key);
+  const config = loadConfig();
+  const scope = config.organizations?.[org.toLowerCase()];
+  return scope?.[key];
+}
+function readScope(config, name) {
+  if (name === "default") {
+    const { org: _o, organizations: _orgs, ...defaults } = config;
+    return defaults;
+  }
+  return config.organizations?.[name.toLowerCase()] ?? {};
+}
+function copyOrgScope(from, to, force = false) {
+  const config = loadConfig();
+  const source = readScope(config, from);
+  const toLc = to.toLowerCase();
+  const dest = config.organizations?.[toLc] ?? {};
+  if (!force) {
+    const collisions = Object.keys(source).filter(
+      (k) => dest[k] !== void 0
+    );
+    if (collisions.length > 0) {
+      throw new Error(
+        `Scope "${toLc}" already has values for: ${collisions.join(", ")}. Use --force to overwrite.`
+      );
+    }
+  }
+  saveConfig({
+    ...config,
+    organizations: {
+      ...config.organizations,
+      [toLc]: { ...dest, ...source }
+    }
+  });
+}
+function moveOrgScope(from, to, force = false) {
+  copyOrgScope(from, to, force);
+  if (from !== "default") {
+    deleteOrgScope(from);
+  }
+}
+function deleteOrgScope(name) {
+  const config = loadConfig();
+  const lc = name.toLowerCase();
+  if (!config.organizations?.[lc]) return;
+  const { [lc]: _, ...rest } = config.organizations;
+  saveConfig({ ...config, organizations: rest });
+}
 
 // src/services/oauth-config.ts
 var DEFAULT_OAUTH_CLIENT_ID = "872cd9fa-d31f-45e0-9eab-6e460a02d1f1";
@@ -864,7 +988,7 @@ async function deletePat(org) {
   }
   try {
     const { unlinkSync: unlinkSync2 } = await import("fs");
-    const { lockPath: lockPath2 } = await import("./oauth-token-refresh-PHW66RC4.js");
+    const { lockPath: lockPath2 } = await import("./oauth-token-refresh-7FQ4VAIS.js");
     unlinkSync2(lockPath2(org));
   } catch {
   }
@@ -1061,6 +1185,13 @@ export {
   getConfigValue,
   setConfigValue,
   unsetConfigValue,
+  resolveScopedConfig,
+  setOrgScopedValue,
+  unsetOrgScopedValue,
+  getOrgScopedValue,
+  copyOrgScope,
+  moveOrgScope,
+  deleteOrgScope,
   maskedDisplay,
   normalizePat,
   AZDO_RESOURCE_ID,