azdo-cli 0.5.0-010-work-item-comments.149 → 0.5.0-develop.148

package/README.md

@@ -13,7 +13,6 @@ Azure DevOps CLI focused on work item read/write workflows.
 - Assign and unassign work items (`assign`)
 - Set any work item field by reference name (`set-field`)
 - Create or update work items from markdown documents (`upsert`)
-- Read and post work item comments (`comments`)
 - Read rich-text fields as markdown (`get-md-field`)
 - Set rich-text fields as markdown from inline text, file, or stdin (`set-md-field`)
 - Check branch pull request status, open PRs to `develop`, and review active comments (`pr`)
@@ -68,10 +67,6 @@ azdo set-state 12345 "Active"
 
 # 4) Create or update a work item from markdown
 azdo upsert --type "User Story" --content $'---\nTitle: Improve markdown import UX\nState: New\n---'
-
-# 5) Review work item discussion and post an update
-azdo comments list 12345
-azdo comments add 12345 "Investigating the root cause now."
 ```
 
 ## Command Cheat Sheet
@@ -83,7 +78,6 @@ azdo comments add 12345 "Investigating the root cause now."
 | `azdo assign <id> [name]` | Assign or unassign owner | `--unassign`, `--json`, `--org`, `--project` |
 | `azdo set-field <id> <field> <value>` | Update any field | `--json`, `--org`, `--project` |
 | `azdo upsert [id]` | Create or update a work item from markdown | `--content`, `--file`, `--type`, `--json`, `--org`, `--project` |
-| `azdo comments <subcommand>` | Read or add work item comments | `list`, `add`, `--json`, `--org`, `--project` |
 | `azdo get-md-field <id> <field>` | Get field as markdown | `--org`, `--project` |
 | `azdo set-md-field <id> <field> [content]` | Set markdown field | `--file`, `--json`, `--org`, `--project` |
 | `azdo list-fields <id>` | List all fields of a work item | `--json`, `--org`, `--project` |
@@ -193,38 +187,6 @@ azdo pr comments
 - Prints `Pull request #<id> has no active comments.` when the PR has no active comment threads
 - Fails instead of guessing when no active PR or multiple active PRs exist
 
-### Work Item Comment Commands
-
-The `comments` command group works on a specific work item ID. It requires a PAT with `Work Items (read)` scope for listing comments and `Work Items (Read & Write)` to add a new comment.
-
-```bash
-# Read the visible comment history for a work item
-azdo comments list 12345
-
-# Read the same history as JSON
-azdo comments list 12345 --json
-
-# Post a progress update
-azdo comments add 12345 "Investigation complete. Working on the fix next."
-
-# Post the update and return JSON
-azdo comments add 12345 "Queued validation run." --json
-```
-
-`azdo comments list`
-
-- Resolves the target work item directly from the provided ID
-- Retrieves the full visible comment history and follows Azure DevOps pagination internally
-- Prints comments newest first with comment ID, author, timestamp, and body text
-- Prints `Work item #<id> has no comments.` when the work item has no visible comments
-
-`azdo comments add`
-
-- Requires a non-empty `<text>` positional argument
-- Preserves the supplied comment text as the submitted body
-- Prints `Added comment #<commentId> to work item #<id>` on success
-- Fails locally before any API call when the text is empty or whitespace-only
-
 ## azdo upsert
 
 `azdo upsert` accepts a single markdown work-item document and either creates a new Azure DevOps work item or updates an existing one. Omit `[id]` to create; pass `[id]` to update that work item in place. Create mode defaults to `Task`, and `--type <work item type>` lets you create `Bug`, `User Story`, `Feature`, `Epic`, and other Azure DevOps work item types.
@@ -350,7 +312,6 @@ These commands support `--json` for machine-readable output:
 - `set-field`
 - `set-md-field`
 - `upsert`
-- `comments list|add`
 - `pr status|open|comments`
 - `config set|get|list|unset`
 

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command13 } from "commander";
+import { Command as Command12 } from "commander";
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -96,42 +96,6 @@ function writeHeaders(pat) {
     "Content-Type": "application/json-patch+json"
   };
 }
-function buildWorkItemCommentsListUrl(context, id, continuationToken) {
-  const url = new URL(
-    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/workItems/${id}/comments`
-  );
-  url.searchParams.set("api-version", "7.1-preview.4");
-  url.searchParams.set("order", "desc");
-  if (continuationToken) {
-    url.searchParams.set("continuationToken", continuationToken);
-  }
-  return url;
-}
-function buildWorkItemCommentsUrl(context, id) {
-  const url = new URL(
-    `https://dev.azure.com/${encodeURIComponent(context.org)}/${encodeURIComponent(context.project)}/_apis/wit/workItems/${id}/comments`
-  );
-  url.searchParams.set("api-version", "7.1-preview.4");
-  return url;
-}
-function mapWorkItemComment(comment, fallbackWorkItemId) {
-  return {
-    id: comment.id ?? comment.commentId ?? 0,
-    workItemId: comment.workItemId ?? fallbackWorkItemId,
-    text: typeof comment.text === "string" ? comment.text : "",
-    author: comment.createdBy?.displayName ?? null,
-    createdAt: comment.createdDate ?? null,
-    modifiedAt: comment.modifiedDate ?? null,
-    isDeleted: comment.isDeleted === true
-  };
-}
-function readContinuationToken(response, data) {
-  if (typeof data.continuationToken === "string" && data.continuationToken.trim() !== "") {
-    return data.continuationToken;
-  }
-  const headerToken = response.headers?.get("x-ms-continuationtoken") ?? response.headers?.get("continuationtoken") ?? null;
-  return headerToken && headerToken.trim() !== "" ? headerToken : null;
-}
 async function readWriteResponse(response, errorCode) {
   if (response.status === 400) {
     const serverMessage = await readResponseMessage(response) ?? "Unknown error";
@@ -240,55 +204,6 @@ async function getWorkItemFieldValue(context, id, pat, fieldName) {
   }
   return stringifyFieldValue(value);
 }
-async function listWorkItemComments(context, id, pat) {
-  const comments = [];
-  let continuationToken = null;
-  do {
-    const response = await fetchWithErrors(
-      buildWorkItemCommentsListUrl(context, id, continuationToken ?? void 0).toString(),
-      { headers: authHeaders(pat) }
-    );
-    if (!response.ok) {
-      throw new Error(`HTTP_${response.status}`);
-    }
-    const data = await response.json();
-    comments.push(
-      ...(data.comments ?? []).map((comment) => mapWorkItemComment(comment, id)).filter((comment) => !comment.isDeleted)
-    );
-    continuationToken = readContinuationToken(response, data);
-  } while (continuationToken !== null);
-  return {
-    workItemId: id,
-    count: comments.length,
-    comments
-  };
-}
-async function addWorkItemComment(context, id, pat, text) {
-  const response = await fetchWithErrors(buildWorkItemCommentsUrl(context, id).toString(), {
-    method: "POST",
-    headers: {
-      ...authHeaders(pat),
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({ text })
-  });
-  if (response.status === 400) {
-    const serverMessage = await readResponseMessage(response) ?? "Unknown error";
-    throw new Error(`BAD_REQUEST: ${serverMessage}`);
-  }
-  if (!response.ok) {
-    throw new Error(`HTTP_${response.status}`);
-  }
-  const data = await response.json();
-  return {
-    workItemId: data.workItemId ?? id,
-    commentId: data.commentId ?? data.id ?? 0,
-    text: typeof data.text === "string" ? data.text : text,
-    author: data.createdBy?.displayName ?? null,
-    createdAt: data.createdDate ?? null,
-    url: data.url ?? null
-  };
-}
 async function updateWorkItem(context, id, pat, fieldName, operations) {
   const result = await applyWorkItemPatch(context, id, pat, operations);
   const title = result.fields["System.Title"];
@@ -1965,89 +1880,8 @@ function createPrCommand() {
   return command;
 }
 
-// src/commands/comments.ts
-import { Command as Command12 } from "commander";
-function writeError2(message) {
-  process.stderr.write(`Error: ${message}
-`);
-  process.exit(1);
-}
-function formatCommentHeader(comment) {
-  const author = comment.author ?? "Unknown";
-  const timestamp = comment.modifiedAt ?? comment.createdAt ?? "Unknown time";
-  return `Comment #${comment.id} by ${author} at ${timestamp}`;
-}
-function formatComments(result) {
-  const lines = [`Comments for work item #${result.workItemId}`];
-  for (const comment of result.comments) {
-    lines.push("", formatCommentHeader(comment), comment.text);
-  }
-  return lines.join("\n");
-}
-function createCommentsListCommand() {
-  const command = new Command12("list");
-  command.description("List visible comments for a work item").argument("<id>", "work item ID").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(async (idStr, options) => {
-    validateOrgProjectPair(options);
-    const id = parseWorkItemId(idStr);
-    let context;
-    try {
-      context = resolveContext(options);
-      const credential = await resolvePat();
-      const result = await listWorkItemComments(context, id, credential.pat);
-      if (options.json) {
-        process.stdout.write(`${JSON.stringify(result, null, 2)}
-`);
-        return;
-      }
-      if (result.comments.length === 0) {
-        process.stdout.write(`Work item #${id} has no comments.
-`);
-        return;
-      }
-      process.stdout.write(`${formatComments(result)}
-`);
-    } catch (err) {
-      handleCommandError(err, id, context, "read");
-    }
-  });
-  return command;
-}
-function createCommentsAddCommand() {
-  const command = new Command12("add");
-  command.description("Add a comment to a work item").argument("<id>", "work item ID").argument("<text>", "comment text").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").option("--json", "output JSON").action(async (idStr, text, options) => {
-    validateOrgProjectPair(options);
-    const id = parseWorkItemId(idStr);
-    if (text.trim() === "") {
-      writeError2("Comment text must be a non-empty string.");
-    }
-    let context;
-    try {
-      context = resolveContext(options);
-      const credential = await resolvePat();
-      const result = await addWorkItemComment(context, id, credential.pat, text);
-      if (options.json) {
-        process.stdout.write(`${JSON.stringify(result, null, 2)}
-`);
-        return;
-      }
-      process.stdout.write(`Added comment #${result.commentId} to work item #${result.workItemId}
-`);
-    } catch (err) {
-      handleCommandError(err, id, context, "write");
-    }
-  });
-  return command;
-}
-function createCommentsCommand() {
-  const command = new Command12("comments");
-  command.description("Manage Azure DevOps work item comments");
-  command.addCommand(createCommentsListCommand());
-  command.addCommand(createCommentsAddCommand());
-  return command;
-}
-
 // src/index.ts
-var program = new Command13();
+var program = new Command12();
 program.name("azdo").description("Azure DevOps CLI tool").version(version, "-v, --version");
 program.addCommand(createGetItemCommand());
 program.addCommand(createClearPatCommand());
@@ -2060,7 +1894,6 @@ program.addCommand(createSetMdFieldCommand());
 program.addCommand(createUpsertCommand());
 program.addCommand(createListFieldsCommand());
 program.addCommand(createPrCommand());
-program.addCommand(createCommentsCommand());
 program.showHelpAfterError();
 program.parse();
 if (process.argv.length <= 2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.5.0-010-work-item-comments.149",
+  "version": "0.5.0-develop.148",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {