@thanaen/ado-cli 0.3.0 → 0.4.0

package/README.md

@@ -72,8 +72,8 @@ ado smoke
 - `workitem-comment-update <id> <commentId> --text="..." [--file=path]`
 - `prs [status] [top] [repo]`
 - `pr-get <id> [repo]`
-- `pr-create --title=... --source=... --target=... [--description=...] [--repo=...] [--work-items=123,456]`
-- `pr-update <id> [--title=...] [--description=...] [--repo=...] [--work-items=123,456]`
+- `pr-create --title=... --source=... --target=... [--description=...] [--repo=...] [--work-items=123,456] [--tags=tag-a,tag-b]`
+- `pr-update <id> [--title=...] [--description=...] [--repo=...] [--work-items=123,456] [--tags=tag-a,tag-b]`
 - `pr-cherry-pick <id> --target=... [--topic=branch-name] [--repo=...]`
 - `pr-approve <id> [repo]`
 - `pr-autocomplete <id> [repo]`

package/dist/cli.js

@@ -57273,6 +57273,12 @@ function parseWorkItemIds(rawValue) {
   const ids = rawValue.split(",").map((part) => Number(part.trim())).filter((id) => Number.isFinite(id) && id > 0);
   return [...new Set(ids)];
 }
+function parsePrTags(rawValue) {
+  if (!rawValue)
+    return [];
+  const tags = rawValue.split(",").map((part) => part.trim()).filter((tag) => tag.length > 0);
+  return [...new Set(tags)];
+}
 function buildPullRequestArtifactUrl(pr) {
   const projectId = pr?.repository?.project?.id;
   const repoId = pr?.repository?.id;
@@ -57458,6 +57464,40 @@ async function cmdSmoke(config) {
     console.log("Pull request: none found");
   }
 }
+async function cmdStatus() {
+  const localConfig = loadLocalConfig();
+  const fileConfig = loadFileConfig();
+  const pat = process.env.DEVOPS_PAT ?? localConfig.pat ?? fileConfig.pat;
+  if (!pat) {
+    console.error("Not ready: DEVOPS_PAT is not set");
+    process.exit(1);
+  }
+  const collectionUrl = process.env.ADO_COLLECTION_URL ?? localConfig.collectionUrl ?? fileConfig.collectionUrl ?? "";
+  const project = process.env.ADO_PROJECT ?? localConfig.project ?? fileConfig.project ?? "";
+  const repo = process.env.ADO_REPO ?? localConfig.repo ?? fileConfig.repo ?? "";
+  const hasPlaceholder = (v) => v.includes("<your-");
+  if (!collectionUrl || hasPlaceholder(collectionUrl)) {
+    console.error("Not ready: ADO_COLLECTION_URL is not configured");
+    process.exit(1);
+  }
+  if (!project || hasPlaceholder(project)) {
+    console.error("Not ready: ADO_PROJECT is not configured");
+    process.exit(1);
+  }
+  if (!repo || hasPlaceholder(repo)) {
+    console.error("Not ready: ADO_REPO is not configured");
+    process.exit(1);
+  }
+  try {
+    const config = getConfig();
+    const witApi = await config.connection.getWorkItemTrackingApi();
+    await witApi.queryByWiql({ query: "SELECT [System.Id] FROM WorkItems ORDER BY [System.ChangedDate] DESC" }, { project: config.project }, undefined, 1);
+    console.log("Ready");
+  } catch (err) {
+    console.error(`Not ready: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+}
 async function cmdRepos(config) {
   const gitApi = await config.connection.getGitApi();
   const repos = await gitApi.getRepositories(config.project);
@@ -57765,6 +57805,24 @@ async function linkWorkItemsToPr(config, _repo, pr, workItemIds) {
     console.log(`Linked work item #${workItemId} to PR #${pr?.pullRequestId}`);
   }
 }
+async function addTagsToPr(config, repoName, pullRequestId, tags) {
+  if (tags.length === 0)
+    return;
+  const gitApi = await config.connection.getGitApi();
+  const repository = await gitApi.getRepository(repoName, config.project);
+  const repositoryId = repository?.id;
+  if (!repositoryId) {
+    throw new Error(`Repository "${repoName}" not found.`);
+  }
+  const existing = await gitApi.getPullRequestLabels(repositoryId, pullRequestId, config.project);
+  const existingTags = new Set(existing.map((label) => label.name).filter(Boolean));
+  for (const tag of tags) {
+    if (existingTags.has(tag))
+      continue;
+    await gitApi.createPullRequestLabel({ name: tag }, repositoryId, pullRequestId, config.project);
+    console.log(`Added tag "${tag}" to PR #${pullRequestId}`);
+  }
+}
 async function cmdPrCreate(config, args) {
   const kv = Object.fromEntries(args.map((arg) => {
     const [k, ...rest] = arg.split("=");
@@ -57776,8 +57834,9 @@ async function cmdPrCreate(config, args) {
   const description = kv.description ?? "";
   const repo = pickRepo(config, kv.repo);
   const workItemIds = parseWorkItemIds(kv["work-items"]);
+  const tags = parsePrTags(kv.tags);
   if (!title || !source || !target) {
-    console.error("Usage: pr-create --title=... --source=feature/x --target=develop [--description=...] [--repo=...] [--work-items=123,456]");
+    console.error("Usage: pr-create --title=... --source=feature/x --target=develop [--description=...] [--repo=...] [--work-items=123,456] [--tags=tag-a,tag-b]");
     process.exit(1);
   }
   const gitApi = await config.connection.getGitApi();
@@ -57792,11 +57851,14 @@ async function cmdPrCreate(config, args) {
     const createdPr = await gitApi.getPullRequestById(created.pullRequestId, config.project);
     await linkWorkItemsToPr(config, repo, createdPr, workItemIds);
   }
+  if (created.pullRequestId && tags.length > 0) {
+    await addTagsToPr(config, repo, created.pullRequestId, tags);
+  }
 }
 async function cmdPrUpdate(config, idRaw, args) {
   const id = Number(idRaw);
   if (!Number.isFinite(id)) {
-    console.error("Usage: pr-update <id> [--title=...] [--description=...] [--repo=...] [--work-items=123,456]");
+    console.error("Usage: pr-update <id> [--title=...] [--description=...] [--repo=...] [--work-items=123,456] [--tags=tag-a,tag-b]");
     process.exit(1);
   }
   const kv = Object.fromEntries(args.map((arg) => {
@@ -57806,12 +57868,13 @@ async function cmdPrUpdate(config, idRaw, args) {
   const repo = pickRepo(config, kv.repo);
   const body = {};
   const workItemIds = parseWorkItemIds(kv["work-items"]);
+  const tags = parsePrTags(kv.tags);
   if (kv.title !== undefined)
     body.title = kv.title;
   if (kv.description !== undefined)
     body.description = kv.description;
-  if (Object.keys(body).length === 0 && workItemIds.length === 0) {
-    console.error("Usage: pr-update <id> [--title=...] [--description=...] [--repo=...] [--work-items=123,456]");
+  if (Object.keys(body).length === 0 && workItemIds.length === 0 && tags.length === 0) {
+    console.error("Usage: pr-update <id> [--title=...] [--description=...] [--repo=...] [--work-items=123,456] [--tags=tag-a,tag-b]");
     process.exit(1);
   }
   const gitApi = await config.connection.getGitApi();
@@ -57825,6 +57888,9 @@ async function cmdPrUpdate(config, idRaw, args) {
   if (workItemIds.length > 0) {
     await linkWorkItemsToPr(config, repo, updated, workItemIds);
   }
+  if (tags.length > 0) {
+    await addTagsToPr(config, repo, id, tags);
+  }
 }
 async function cmdPrCherryPick(config, args) {
   const usage = "Usage: pr-cherry-pick <id> --target=main [--topic=branch-name] [--repo=...]";
@@ -57957,6 +58023,7 @@ Commands:
   -v, --version
   init [--local]
   config
+  status
   smoke
   repos
   branches [repo]
@@ -57967,8 +58034,8 @@ Commands:
   workitem-comment-update <id> <commentId> --text="..." [--file=path]
   prs [status] [top] [repo]
   pr-get <id> [repo]
-  pr-create --title=... --source=... --target=... [--description=...] [--repo=...] [--work-items=123,456]
-  pr-update <id> [--title=...] [--description=...] [--repo=...] [--work-items=123,456]
+  pr-create --title=... --source=... --target=... [--description=...] [--repo=...] [--work-items=123,456] [--tags=tag-a,tag-b]
+  pr-update <id> [--title=...] [--description=...] [--repo=...] [--work-items=123,456] [--tags=tag-a,tag-b]
   pr-cherry-pick <id> --target=... [--topic=branch-name] [--repo=...]
   pr-approve <id> [repo]
   pr-autocomplete <id> [repo]
@@ -57998,6 +58065,10 @@ async function main() {
     cmdConfig();
     return;
   }
+  if (command === "status") {
+    await cmdStatus();
+    return;
+  }
   const config = getConfig();
   switch (command) {
     case "smoke":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thanaen/ado-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Lightweight Azure DevOps CLI for repos, work items, pull requests, and builds",
   "repository": {
     "type": "git",

package/skills/ado-workflows/SKILL.md

@@ -9,13 +9,8 @@ Use the `ado` CLI instead of ad-hoc curl commands.
 
 ## Preflight
 
-1. Verify auth is available:
-   - `test -n "$DEVOPS_PAT" && echo OK || echo MISSING`
-2. Verify connectivity:
-   - `ado smoke`
-   - If needed, run an independent host check (outside the CLI) to distinguish network issues from ADO config issues.
-
-If auth is missing, stop and ask for `DEVOPS_PAT`.
+Run `ado status` before any other command. It checks token, configuration, and connectivity in one step.
+If it reports an issue, guide the user to run `ado init` (or `ado init --local` for per-project setup) to configure the CLI.
 
 ## Core commands
 
@@ -33,8 +28,8 @@ If auth is missing, stop and ask for `DEVOPS_PAT`.
 - Update an existing comment on a work item: `ado workitem-comment-update <id> <commentId> --text="..."`
 - List PRs: `ado prs active 10 "MyRepo"`
 - Get PR: `ado pr-get <id> "MyRepo"`
-- Create PR: `ado pr-create --title="..." --source="feature/x" --target="develop" --description="..." --repo="MyRepo" --work-items=123,456`
-- Update PR: `ado pr-update <id> --title="..." --description="..." --repo="MyRepo" --work-items=123,456`
+- Create PR: `ado pr-create --title="..." --source="feature/x" --target="develop" --description="..." --repo="MyRepo" --work-items=123,456 --tags=backend,release-1`
+- Update PR: `ado pr-update <id> --title="..." --description="..." --repo="MyRepo" --work-items=123,456 --tags=backend,release-1`
 - Cherry-pick PR onto another branch: `ado pr-cherry-pick <id> --target="main" --topic="cherry-pick-branch" --repo="MyRepo"`
 - Approve PR: `ado pr-approve <id> "MyRepo"`
 - Enable auto-complete: `ado pr-autocomplete <id> "MyRepo"`