refactor

Author: Joan-Angelo Enrile

.claude-plugin/marketplace.json

@@ -0,0 +1,26 @@
+{
+  "name": "ado-cli-skill",
+  "owner": {
+    "name": "yutamago"
+  },
+  "metadata": {
+    "description": "AI Agent plugin marketplace for the Azure DevOps CLI",
+    "version": "1.0.0",
+    "homepage": "https://github.com/yutamago/ado-cli"
+  },
+  "plugins": [
+    {
+      "name": "azure-devops",
+      "source": "./plugins/azure-devops",
+      "description": "Skills for interacting with Azure DevOps via the ado CLI — issues, pull requests, pipeline runs, search, and repositories.",
+      "version": "1.0.0",
+      "author": {
+        "name": "yutamago",
+        "url": "https://github.com/yutamago"
+      },
+      "category": "workflow",
+      "homepage": "https://github.com/yutamago/ado-cli",
+      "keywords": ["azure-devops", "azd", "work-items", "pull-requests", "pipelines", "ci-cd"]
+    }
+  ]
+}

.claude/settings.local.json

@@ -6,7 +6,9 @@
       "Bash(npm install:*)",
       "Bash(node dist/index.js --help)",
       "WebFetch(domain:github.com)",
-      "Bash(npm run:*)"
+      "Bash(npm run:*)",
+      "Bash(find /home/angelo/workspaces/oss_ws/azd-skill/src -name \"*.ts\" -type f -exec wc -l {} +)"
     ]
-  }
+  },
+  "enabledPlugins": {}
 }

CLAUDE.md

@@ -36,70 +36,6 @@ src/
   errors/index.ts        # AzdError, AuthError, NotFoundError, ConfigError
 ```
 
-## Commands Reference
-
-### Auth
-| Command | Description |
-|---|---|
-| `azd auth login` | OAuth browser login (default); device-code for headless/CI |
-| `azd auth logout` | Remove stored credentials |
-| `azd auth status` | Show org, auth type, username, default project |
-
-### Issues (Work Items)
-| Command | Description |
-|---|---|
-| `azd issue list` | List work items (`--state`, `--assignee`, `--tag`, `--type`, `--web`) |
-| `azd issue view <id>` | Work item details (`--comments`, `--web`) |
-| `azd issue create` | Create work item (`--type`, `--title`, `--description`, `--assignee`, `--tags`) |
-| `azd issue edit <id>` | Update work item fields |
-| `azd issue close <id>` | Set state to Closed/Resolved |
-| `azd issue reopen <id>` | Set state back to Active |
-| `azd issue comment <id>` | Add comment (`--body` or `$EDITOR`) |
-| `azd issue status` | Show items assigned to / created by you |
-| `azd issue develop <id>` | Create branch linked to work item |
-
-### Pull Requests
-| Command | Description |
-|---|---|
-| `azd pr list` | List PRs (`--state`, `--author`, `--repo`, `--web`) |
-| `azd pr view <pr>` | PR details (`--comments`, `--web`) |
-| `azd pr comment <pr>` | Add comment (`--body` or `$EDITOR`) |
-| `azd pr diff <pr>` | Unified diff (`--color`, `--exclude`, `--name-only`, `--patch`, `--web`) |
-| `azd pr create` | Create PR (`--title`, `--body`, `--draft`, `--source-branch`, `--target-branch`) |
-| `azd pr review <pr>` | Approve/reject (`--approve`, `--reject`, `--comment`) |
-
-### Pipeline Runs
-| Command | Description |
-|---|---|
-| `azd run list` | List recent runs (`--status`, `--branch`, `--limit`, `--web`) |
-| `azd run view <run-id>` | Run details (`--web`) |
-| `azd run watch <run-id>` | Stream live status until completion |
-| `azd run cancel <run-id>` | Cancel an in-progress run |
-| `azd run rerun <run-id>` | Re-queue a completed/failed run |
-| `azd run download <run-id>` | Download build artifacts |
-| `azd run delete <run-id>` | Delete pipeline run record |
-
-### Search
-| Command | Description |
-|---|---|
-| `azd search issues <query>` | Search work items via WIQL |
-| `azd search code <query>` | Search code via Azure Search REST API (`--repo`, `--limit`) |
-| `azd search commits <query>` | Search commits (client-side filter) |
-| `azd search prs <query>` | Search PRs (client-side filter) |
-| `azd search repos <query>` | List/filter repositories |
-| `azd search projects <query>` | List/filter Azure DevOps projects |
-
-### Repo
-| Command | Description |
-|---|---|
-| `azd repo list` | List repositories |
-| `azd repo clone <repo>` | Clone a repository |
-
-### Other
-| Command | Description |
-|---|---|
-| `azd completion` | Generate shell completion script (bash/zsh/fish/powershell) |
-
 ## Authentication Architecture
 
 Credential resolution order in `src/api/client.ts`:
@@ -137,7 +73,7 @@ Git remote formats supported:
 
 ## Keeping the Plugin Reference Up to Date
 
-`plugins/azd/skills/azd-cli/reference.md` is the authoritative CLI reference used by the azd plugin skill.
+`plugins/azd/skills/azd-cli/reference.md` is the authoritative CLI reference used by the ado plugin skill.
 
 **Update it whenever you:**
 - Add, rename, or remove a command or subcommand

README.md

@@ -1,24 +1,30 @@
-# azd-cli
-
-Azure DevOps CLI for agents — mirrors [GitHub CLI](https://cli.github.com/) (`gh`) conventions.
+# ado-cli
+An Azure DevOps CLI, mimicking the known and loved Github CLI syntax.
 
 ## Installation
 
 ```bash
-npm install -g azd-cli
+npm install -g ado-cli
 ```
 
 **Prerequisites:** Node.js 18 or later, an Azure DevOps account.
 
----
+
+### Installing the Plugin in your AI Agent
+
+```bash
+copilot plugin marketplace add https://github.com/yutamago/ado-cli.git
+claude  plugin marketplace add https://github.com/yutamago/ado-cli.git
+```
+
 
 ## Authentication
 
 ```bash
-azd auth login           # Browser OAuth (default)
-azd auth login --device  # Device-code flow for headless/CI environments
-azd auth status          # Show current auth state
-azd auth logout          # Remove stored credentials
+ado auth login           # Browser OAuth (default)
+ado auth login --device  # Device-code flow for headless/CI environments
+ado auth status          # Show current auth state
+ado auth logout          # Remove stored credentials
 ```
 
 After login you will be prompted to select a default organization and project. These can also be set via environment variables:
@@ -30,82 +36,80 @@ AZURE_DEVOPS_PROJECT=my-project
 
 For CI pipelines, set `SYSTEM_ACCESSTOKEN` (Azure Pipelines built-in) or `AZURE_DEVOPS_TOKEN` (PAT) — no login step required.
 
----
 
 ## Commands
 
 ### Issues (Work Items)
 
 ```bash
-azd issue list                                         # List work items
-azd issue list --state Active --assignee @me
-azd issue view <id>                                    # Work item details
-azd issue view <id> --comments
-azd issue create --title "Bug report" --type Bug
-azd issue edit <id> --state Resolved
-azd issue close <id>
-azd issue reopen <id>
-azd issue comment <id> --body "LGTM"
-azd issue status                                       # Items assigned to / created by you
-azd issue develop <id>                                 # Create a branch linked to the work item
+ado issue list                                         # List work items
+ado issue list --state Active --assignee @me
+ado issue view <id>                                    # Work item details
+ado issue view <id> --comments
+ado issue create --title "Bug report" --type Bug
+ado issue edit <id> --state Resolved
+ado issue close <id>
+ado issue reopen <id>
+ado issue comment <id> --body "LGTM"
+ado issue status                                       # Items assigned to / created by you
+ado issue develop <id>                                 # Create a branch linked to the work item
 ```
 
 ### Pull Requests
 
 ```bash
-azd pr list
-azd pr list --state abandoned --author @me
-azd pr view <pr>
-azd pr view <pr> --comments
-azd pr diff <pr>
-azd pr diff <pr> --name-only
-azd pr comment <pr> --body "Looks good"
-azd pr create --title "My PR" --draft
-azd pr review <pr> --approve
-azd pr review <pr> --reject --comment "Needs changes"
+ado pr list
+ado pr list --state abandoned --author @me
+ado pr view <pr>
+ado pr view <pr> --comments
+ado pr diff <pr>
+ado pr diff <pr> --name-only
+ado pr comment <pr> --body "Looks good"
+ado pr create --title "My PR" --draft
+ado pr review <pr> --approve
+ado pr review <pr> --reject --comment "Needs changes"
 ```
 
 ### Pipeline Runs
 
 ```bash
-azd run list
-azd run list --status failed --branch main
-azd run view <run-id>
-azd run watch <run-id>
-azd run cancel <run-id>
-azd run rerun <run-id>
-azd run download <run-id>
-azd run delete <run-id>
+ado run list
+ado run list --status failed --branch main
+ado run view <run-id>
+ado run watch <run-id>
+ado run cancel <run-id>
+ado run rerun <run-id>
+ado run download <run-id>
+ado run delete <run-id>
 ```
 
 ### Search
 
 ```bash
-azd search issues "memory leak"
-azd search code "TodoController" --repo my-repo
-azd search commits "fix auth"
-azd search prs "login"
-azd search repos "api"
-azd search projects "platform"
+ado search issues "memory leak"
+ado search code "TodoController" --repo my-repo
+ado search commits "fix auth"
+ado search prs "login"
+ado search repos "api"
+ado search projects "platform"
 ```
 
 ### Repositories
 
 ```bash
-azd repo list
-azd repo clone <repo>
+ado repo list
+ado repo clone <repo>
 ```
 
 ### Shell Completions
 
 ```bash
-azd completion bash        >> ~/.bashrc
-azd completion zsh         >> ~/.zshrc
-azd completion fish        > ~/.config/fish/completions/azd.fish
-azd completion powershell  >> $PROFILE
+ado completion bash        >> ~/.bashrc
+ado completion zsh         >> ~/.zshrc
+ado completion fish        > ~/.config/fish/completions/azd.fish
+ado completion powershell  >> $PROFILE
 ```
 
----
 
 ## Output Modes
 
@@ -118,7 +122,6 @@ azd completion powershell  >> $PROFILE
 
 Non-TTY output is optimized for agent consumption (GitHub Copilot, Claude, etc.).
 
----
 
 ## Configuration
 
@@ -135,7 +138,6 @@ Supported remote URL formats:
 - `https://{org}.visualstudio.com/{project}/_git/{repo}`
 - `git@ssh.dev.azure.com:v3/{org}/{project}/{repo}`
 
----
 
 ## License
 

TODO.md

@@ -5,45 +5,45 @@
 - [x] Foundation modules (errors, config, auth/store)
 - [x] API client factory (azure-devops-node-api, PAT auth)
 - [x] Output module (TTY/non-TTY, table/detail/json)
-- [x] `azd auth login` — PAT-based auth with keytar + file fallback
-- [x] `azd issue list` — list work items with state/assignee/tag/type filters
-- [x] `azd issue view <id>` — work item detail view with optional comments
-- [x] `azd pr list` — list PRs with state/author/repo filters
-- [x] `azd pr view <pr>` — PR detail with optional comment threads
-- [x] `azd pr comment <pr>` — add comment (--body or $EDITOR)
-- [x] `azd pr diff <pr>` — real unified diff with `--color`, `--exclude`, `--name-only`, `--patch`, `--web` flags matching `gh pr diff`
+- [x] `ado auth login` — PAT-based auth with keytar + file fallback
+- [x] `ado issue list` — list work items with state/assignee/tag/type filters
+- [x] `ado issue view <id>` — work item detail view with optional comments
+- [x] `ado pr list` — list PRs with state/author/repo filters
+- [x] `ado pr view <pr>` — PR detail with optional comment threads
+- [x] `ado pr comment <pr>` — add comment (--body or $EDITOR)
+- [x] `ado pr diff <pr>` — real unified diff with `--color`, `--exclude`, `--name-only`, `--patch`, `--web` flags matching `gh pr diff`
 - [x] OAuth browser login as default auth (MSAL `acquireTokenInteractive`); device code flow for headless/CI
 - [x] DEP0169 deprecation warning suppression (upstream: azure-devops-node-api#664, fix: PR#662)
-- [x] `azd search issues <query>` — search work items via WIQL
-- [x] `azd search code <query>` — search code via Azure Search REST API
-- [x] `azd search commits <query>` — search commits (client-side filter)
-- [x] `azd search prs <query>` — search PRs (client-side filter)
-- [x] `azd search repos <query>` — list/filter repositories
-- [x] `azd auth status` — show current auth state
-- [x] `azd auth logout` — remove stored credentials
+- [x] `ado search issues <query>` — search work items via WIQL
+- [x] `ado search code <query>` — search code via Azure Search REST API
+- [x] `ado search commits <query>` — search commits (client-side filter)
+- [x] `ado search prs <query>` — search PRs (client-side filter)
+- [x] `ado search repos <query>` — list/filter repositories
+- [x] `ado auth status` — show current auth state
+- [x] `ado auth logout` — remove stored credentials
 - [x] After login: numbered list project selector (TTY) / plain stdin line-read (non-TTY, AI agent compatible)
-- [x] `azd issue create` — create a new work item (type, title, description, assignee, tags)
-- [x] `azd issue edit <id>` — update title, description, state, assignee, tags on an existing work item
-- [x] `azd issue close <id>` — set work item state to Closed/Resolved
-- [x] `azd issue reopen <id>` — set work item state back to Active
-- [x] `azd issue comment <id>` — add a comment to a work item (mirrors `azd pr comment`)
-- [x] `azd issue status` — show work items assigned to you / created by you
-- [x] `azd issue list --web` / `azd issue view --web` — open in browser
-- [x] `azd issue develop <id>` — create a branch linked to a work item (`GitApi.updateRefs` + `WorkItemTrackingApi.updateWorkItem` with ArtifactLink relation)
-- [x] `azd pr create` — create a pull request
-- [x] `azd pr review` — approve/reject a PR
-- [x] `azd pr list --web` / `azd pr view --web` — open in browser
-- [x] `azd search projects <query>` — list/filter Azure DevOps projects (`CoreApi.getProjects` + client-side filter)
-- [x] `azd repo list` — list repositories
-- [x] `azd repo clone` — clone a repository
-- [x] `azd run list` — list recent pipeline runs (`BuildApi.getBuilds`)
-- [x] `azd run view <run-id>` — show details of a specific run; `--web` to open in browser
-- [x] `azd run watch <run-id>` — stream live status until run completes
-- [x] `azd run cancel <run-id>` — cancel an in-progress run (`BuildApi.updateBuild` status=Cancelling)
-- [x] `azd run rerun <run-id>` — re-queue a completed/failed run (`BuildApi.updateBuild` retry=true)
-- [x] `azd run download <run-id>` — download build artifacts (`BuildApi.getArtifacts`)
-- [x] `azd run delete <run-id>` — delete a pipeline run record
-- [x] `azd completion` — generate shell completion scripts (bash/zsh/fish/powershell)
+- [x] `ado issue create` — create a new work item (type, title, description, assignee, tags)
+- [x] `ado issue edit <id>` — update title, description, state, assignee, tags on an existing work item
+- [x] `ado issue close <id>` — set work item state to Closed/Resolved
+- [x] `ado issue reopen <id>` — set work item state back to Active
+- [x] `ado issue comment <id>` — add a comment to a work item (mirrors `ado pr comment`)
+- [x] `ado issue status` — show work items assigned to you / created by you
+- [x] `ado issue list --web` / `ado issue view --web` — open in browser
+- [x] `ado issue develop <id>` — create a branch linked to a work item (`GitApi.updateRefs` + `WorkItemTrackingApi.updateWorkItem` with ArtifactLink relation)
+- [x] `ado pr create` — create a pull request
+- [x] `ado pr review` — approve/reject a PR
+- [x] `ado pr list --web` / `ado pr view --web` — open in browser
+- [x] `ado search projects <query>` — list/filter Azure DevOps projects (`CoreApi.getProjects` + client-side filter)
+- [x] `ado repo list` — list repositories
+- [x] `ado repo clone` — clone a repository
+- [x] `ado run list` — list recent pipeline runs (`BuildApi.getBuilds`)
+- [x] `ado run view <run-id>` — show details of a specific run; `--web` to open in browser
+- [x] `ado run watch <run-id>` — stream live status until run completes
+- [x] `ado run cancel <run-id>` — cancel an in-progress run (`BuildApi.updateBuild` status=Cancelling)
+- [x] `ado run rerun <run-id>` — re-queue a completed/failed run (`BuildApi.updateBuild` retry=true)
+- [x] `ado run download <run-id>` — download build artifacts (`BuildApi.getArtifacts`)
+- [x] `ado run delete <run-id>` — delete a pipeline run record
+- [x] `ado completion` — generate shell completion scripts (bash/zsh/fish/powershell)
 - [x] `--web` / `-w` flag audit — added to: `issue list`, `issue view`, `pr list`, `pr view`, `run list`, `run view`
 
 ## Backlog