azdo-cli 0.10.1 → 0.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +30 -4
- package/dist/chunk-XVXMDWQE.js +1218 -0
- package/dist/index.js +2766 -657
- package/dist/oauth-token-refresh-7FQ4VAIS.js +15 -0
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -13,10 +13,11 @@ Azure DevOps CLI focused on work item read/write workflows.
|
|
|
13
13
|
- Create or update work items from markdown documents (`upsert`)
|
|
14
14
|
- Read and post work item comments (`comments`)
|
|
15
15
|
- Read/write rich-text fields as markdown (`get-md-field`, `set-md-field`)
|
|
16
|
+
- Download images embedded in rich-text fields, optionally resized for LLM use (`get-item`/`get-md-field` `--download-images`, `--resize-images`)
|
|
16
17
|
- 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`)
|
|
17
18
|
- Persist org/project/default fields in local config (`config`)
|
|
18
19
|
- List all fields of a work item (`list-fields`)
|
|
19
|
-
-
|
|
20
|
+
- 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).
|
|
20
21
|
|
|
21
22
|
## Installation
|
|
22
23
|
|
|
@@ -27,6 +28,9 @@ npm install -g azdo-cli
|
|
|
27
28
|
## Quick Start
|
|
28
29
|
|
|
29
30
|
```bash
|
|
31
|
+
# Sign in to an organization (OAuth by default; add --use-pat for a PAT)
|
|
32
|
+
azdo auth login --org myorg
|
|
33
|
+
|
|
30
34
|
# Configure defaults once
|
|
31
35
|
azdo config set org myorg
|
|
32
36
|
azdo config set project myproject
|
|
@@ -34,6 +38,11 @@ azdo config set project myproject
|
|
|
34
38
|
# Read a work item
|
|
35
39
|
azdo get-item 12345
|
|
36
40
|
|
|
41
|
+
# Download images embedded in a work item's rich-text fields (opt-in)
|
|
42
|
+
azdo get-item 12345 --download-images # saved to the system temp dir
|
|
43
|
+
azdo get-item 12345 --resize-images 1024 --images-path ./img # cap width at 1024px, save as PNG
|
|
44
|
+
azdo get-md-field 12345 System.Description --download-images # same flags on get-md-field
|
|
45
|
+
|
|
37
46
|
# Update state
|
|
38
47
|
azdo set-state 12345 "Active"
|
|
39
48
|
|
|
@@ -45,18 +54,35 @@ azdo comments list 12345
|
|
|
45
54
|
azdo comments add 12345 "Investigating the root cause now."
|
|
46
55
|
|
|
47
56
|
# PR comment threads — list, filter, target by number, resolve or reopen
|
|
48
|
-
azdo pr comments # active-branch PR
|
|
57
|
+
azdo pr comments # active-branch PR; code-anchored threads show file:line
|
|
49
58
|
azdo pr comments --pr-number 64 # any PR by number (skips branch lookup)
|
|
50
|
-
azdo pr comments --pr-number 64 --hide-resolved
|
|
59
|
+
azdo pr comments --pr-number 64 --hide-resolved # or --exclude-resolved (alias)
|
|
60
|
+
azdo pr comments --code-related-only # only file/line-anchored threads
|
|
61
|
+
azdo pr status # PR checks (status + branch policies + pipeline builds) + code-comment counts
|
|
51
62
|
azdo pr comment-resolve 17 --pr-number 64 # idempotent: exit 0 even when already resolved
|
|
52
63
|
azdo pr comment-reopen 17 --pr-number 64
|
|
64
|
+
|
|
65
|
+
# Pipelines — list, inspect runs, wait (exit code = result), start
|
|
66
|
+
azdo pipeline list --filter ci
|
|
67
|
+
azdo pipeline get-runs 12 --branch develop --limit 1
|
|
68
|
+
azdo pipeline wait 3456 # blocks; exit 0 success / non-zero failure / 124 timeout
|
|
69
|
+
azdo pipeline get-run-detail 3456 # errors, failing tests, per-stage status
|
|
70
|
+
azdo pipeline start 12 --branch develop --parameter env=staging
|
|
71
|
+
|
|
72
|
+
# Work item relations — types, add, remove, list
|
|
73
|
+
azdo relations types # list all relation types (Child, Parent, Related, ...)
|
|
74
|
+
azdo relations types --json # machine-readable JSON array
|
|
75
|
+
azdo relations add child 1000 2000 # make #2000 a child of #1000 (idempotent)
|
|
76
|
+
azdo relations remove child 1000 2000 # remove the child relation
|
|
77
|
+
azdo relations list 1000 # show all relations on work item #1000
|
|
78
|
+
azdo relations list 1000 --json # JSON: { workItemId, relations: [...] }
|
|
53
79
|
```
|
|
54
80
|
|
|
55
81
|
## Documentation
|
|
56
82
|
|
|
57
83
|
| Topic | File |
|
|
58
84
|
|-------|------|
|
|
59
|
-
| Authentication & PAT
|
|
85
|
+
| Authentication (OAuth & PAT) | [docs/authentication.md](docs/authentication.md) |
|
|
60
86
|
| Linux credential store setup | [docs/linux-credential-store.md](docs/linux-credential-store.md) |
|
|
61
87
|
| Full command reference | [docs/commands.md](docs/commands.md) |
|
|
62
88
|
| Development setup | [docs/development.md](docs/development.md) |
|